Skip to content

docs: refresh roadmap after v5.3.3 review cycle#22

Open
flyingrobots wants to merge 1 commit intomainfrom
docs/backlog-review-followups
Open

docs: refresh roadmap after v5.3.3 review cycle#22
flyingrobots wants to merge 1 commit intomainfrom
docs/backlog-review-followups

Conversation

@flyingrobots
Copy link
Member

@flyingrobots flyingrobots commented Mar 17, 2026

Summary

  • mark v5.3.3 and M17 Ledger as shipped in STATUS.md and ROADMAP.md
  • move the future sequence forward to M18 and remove M17 from open milestones
  • add follow-up backlog items from the last review cycle, including actionlint, workflow update automation, Docker hardening regressions, JSDoc/review-bot policy, and PR thread-resolution workflow

Validation

  • npx prettier --check STATUS.md ROADMAP.md
  • pre-push hook: eslint + full Node unit suite

Summary by CodeRabbit

  • Documentation
    • Updated roadmap and status documentation to reflect the v5.3.3 release with M17 Ledger milestone completion.
    • Added detailed M18 Relay milestone information and planned deliverables for the upcoming v5.4.0 release.
    • Restructured release history tables, dependency sequences, and planned release timeline for improved clarity and better navigation through project milestones.

@coderabbitai
Copy link

coderabbitai bot commented Mar 17, 2026

📝 Walkthrough

Walkthrough

Updates ROADMAP.md and STATUS.md to reflect v5.3.3 (M17 Ledger) as the current release and establishes M18 Relay as the next milestone. Restructures tables, updates sequences, and revises narrative descriptions throughout both documents.

Changes

Cohort / File(s) Summary
Documentation Updates
ROADMAP.md, STATUS.md
Both files updated to reflect v5.3.3 release with M17 Ledger shipped; replaced M17 with M18 Relay in open milestones; restructured shipped/planned tables; updated release dates (2026-03-17) and dependency sequences; revised milestone narratives and added new M18 deliverables (CI checks, dependency automation, regression coverage, review-bot policy).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 Hop, hop, the roadmap now gleams,
v5.3.3 ships with Ledger's dreams,
M18 Relay waits in line,
Tables reordered, milestones align,
Our future path, oh how it shines!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately and concisely summarizes the main purpose of the changeset: updating roadmap documentation after completing the v5.3.3 review cycle, which aligns with advancing milestones and adding follow-up items.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/backlog-review-followups
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
ROADMAP.md (1)

128-130: 🛠️ Refactor suggestion | 🟠 Major

Consider adding acceptance criteria for the technical follow-up items.

The current acceptance section only covers JSONL contract tests for the core agent CLI. The new technical deliverables (actionlint CI, workflow automation, Docker regression coverage) lack explicit acceptance criteria. Consider adding criteria such as:

  • actionlint runs clean in CI and fails on workflow issues
  • GitHub Actions dependency updates execute successfully on schedule
  • Docker regression tests verify unprivileged execution and Deno Node binary availability

This would clarify the "done" definition for these items.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@ROADMAP.md` around lines 128 - 130, Add explicit acceptance criteria for the
technical follow-ups in the Acceptance section: append bullets for "actionlint
CI" (e.g., actionlint runs clean in CI and fails the build on workflow issues),
"workflow automation" (e.g., scheduled GitHub Actions dependency update workflow
runs successfully and creates PRs on schedule), and "Docker regression coverage"
(e.g., regression tests confirm unprivileged container execution and
presence/compatibility of Deno/Node binaries and reproducible artifacts).
Reference these items by name (actionlint CI, GitHub Actions dependency updates,
Docker regression tests) so the done definition is unambiguous.
🧹 Nitpick comments (1)
ROADMAP.md (1)

79-79: Consider clarifying the maintenance release grouping.

The notation M17 Ledger + v5.3.1/v5.3.2/v5.3.3 maintenance could be read as either "M17 plus three maintenance releases" or "M17 (which is v5.3.3) plus the earlier maintenance releases." Since the Shipped Summary shows v5.3.1/v5.3.2 as standalone maintenance and v5.3.3 as M17, you might consider M17 Ledger (v5.3.3) + v5.3.1/v5.3.2 maintenance for precision.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@ROADMAP.md` at line 79, Update the ambiguous release notation line "M17
Ledger + v5.3.1/v5.3.2/v5.3.3 maintenance ✅" to explicitly show M17 corresponds
to v5.3.3 by changing it to "M17 Ledger (v5.3.3) + v5.3.1/v5.3.2 maintenance ✅";
locate and edit the exact string in the ROADMAP entry so the shipped summary
matches the clarified grouping.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In `@ROADMAP.md`:
- Around line 128-130: Add explicit acceptance criteria for the technical
follow-ups in the Acceptance section: append bullets for "actionlint CI" (e.g.,
actionlint runs clean in CI and fails the build on workflow issues), "workflow
automation" (e.g., scheduled GitHub Actions dependency update workflow runs
successfully and creates PRs on schedule), and "Docker regression coverage"
(e.g., regression tests confirm unprivileged container execution and
presence/compatibility of Deno/Node binaries and reproducible artifacts).
Reference these items by name (actionlint CI, GitHub Actions dependency updates,
Docker regression tests) so the done definition is unambiguous.

---

Nitpick comments:
In `@ROADMAP.md`:
- Line 79: Update the ambiguous release notation line "M17 Ledger +
v5.3.1/v5.3.2/v5.3.3 maintenance ✅" to explicitly show M17 corresponds to v5.3.3
by changing it to "M17 Ledger (v5.3.3) + v5.3.1/v5.3.2 maintenance ✅"; locate
and edit the exact string in the ROADMAP entry so the shipped summary matches
the clarified grouping.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7044ce90-46e9-4a76-bc63-081a131aa6d1

📥 Commits

Reviewing files that changed from the base of the PR and between bedba6a and 939c9ac.

📒 Files selected for processing (2)
  • ROADMAP.md
  • STATUS.md

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant