Roadmap to v1.0.0

[yancya]

Goal

A stable 1.0.0: no silent data corruption anywhere in dump/parse, a refinement-free public API, exact typed round-trip, and documentation that matches reality.

Why now

Edge-case probing (2026-07-10) found real bugs beyond the known hygiene items: the NoNextError path infinitely recurses into SystemStackError, negative integers destroy data on round-trip, and malformed input returns corrupt arrays (nils, silent empties) instead of raising.

Milestones

Milestone	Theme	Issues
v0.2.1	Hygiene	#1
v0.3.0	Robustness — fix known bugs, define error handling	#2, #3, #4
v0.4.0	API expansion — module functions, typed parse	#5, #6
v1.0.0	Docs & stable release	#7

Dependency order

• Add gemspec metadata and CHANGELOG; update README to the tag-based release flow #1, Fix SystemStackError when Array#to_s raises NoNextError #2, Raise a clear ParseError on malformed input in String#to_a #3 are independent — any order, parallelizable
• Negative integers corrupt the round-trip: dump then parse loses data #4 depends on Raise a clear ParseError on malformed input in String#to_a #3 (uses ParseError)
• Add refinement-free module API: RangePpoiString.dump / RangePpoiString.parse #5 depends on Fix SystemStackError when Array#to_s raises NoNextError #2 + Raise a clear ParseError on malformed input in String#to_a #3 + Negative integers corrupt the round-trip: dump then parse loses data #4 (moves the corrected logic)
• Typed parse: RangePpoiString.parse(str, type: Integer) for a true round-trip #6 depends on Add refinement-free module API: RangePpoiString.dump / RangePpoiString.parse #5 (kwarg lands on the module API)
• v1.0.0 release prep: API docs, README overhaul, semver commitment #7 depends on everything above

Task list

• Add gemspec metadata and CHANGELOG; update README to the tag-based release flow #1
• Fix SystemStackError when Array#to_s raises NoNextError #2
• Raise a clear ParseError on malformed input in String#to_a #3
• Negative integers corrupt the round-trip: dump then parse loses data #4
• Add refinement-free module API: RangePpoiString.dump / RangePpoiString.parse #5
• Typed parse: RangePpoiString.parse(str, type: Integer) for a true round-trip #6
• v1.0.0 release prep: API docs, README overhaul, semver commitment #7 — code/tests for Add gemspec metadata and CHANGELOG; update README to the tag-based release flow #1–Typed parse: RangePpoiString.parse(str, type: Integer) for a true round-trip #6 are merged to master, but no version has actually been released yet (no vX.Y.Z tag pushed, gem still at 0.2.0 on rubygems.org). v1.0.0 release prep: API docs, README overhaul, semver commitment #7's own acceptance criteria requires pushing the v1.0.0 tag (a deploy/publish action), and its prerequisite of releasing 0.3.0/0.4.0 first also requires tag pushes. Both are on hold for a human GO — see comment on v1.0.0 release prep: API docs, README overhaul, semver commitment #7.

Each issue is scoped to be completable in a single agent session and carries its own prerequisites, acceptance criteria, and verification commands. Releases 0.3.0 / 0.4.0 / 1.0.0 each ship by pushing a v* tag (Trusted Publisher workflow); tag pushes are human-GO gated.