Skip to content

docs: update CHANGELOG and file new backlog items#59

Merged
flyingrobots merged 1 commit intomainfrom
chore/changelog-and-backlog
Apr 5, 2026
Merged

docs: update CHANGELOG and file new backlog items#59
flyingrobots merged 1 commit intomainfrom
chore/changelog-and-backlog

Conversation

@flyingrobots
Copy link
Copy Markdown
Owner

@flyingrobots flyingrobots commented Apr 5, 2026

Summary

  • CHANGELOG updated with all work from the METHOD adoption session (invariants, legends, bearing, triage, doctor fix, rg→grep fix)
  • 4 new backlog items filed for follow-up work:
    • task:backlog-doc-sweep — 29 quests need METHOD-style docs
    • task:seed-scripts-cleanup — decide fate of one-shot seed scripts
    • task:campaign-to-legend-migration — migrate campaign edges to legends
    • task:cycle-entity — make cycle:* first-class (the first real FLOW cycle)

Test plan

  • Build passes
  • Lint passes
  • No code changes, only CHANGELOG.md

Summary by CodeRabbit

  • New Features

    • Introduced new graph-navigation primitives with queryable content attachments for enhanced exploration.
    • Expanded ontology with 6 new schema prefixes and 3 new edge types.
  • Improvements

    • Streamlined backlog triage operations with significantly reduced active items.
    • Enhanced diagnostic efficiency by narrowing validation scope.
  • Chores

    • Fixed CI reliability issue in diagnostic testing.

CHANGELOG: document invariants, legends, bearing, backlog triage,
doctor fix, and rg→grep test fix under [Unreleased].

New backlog items filed:
  - task:backlog-doc-sweep (29 description-less quests need docs)
  - task:seed-scripts-cleanup (retire or keep one-shot scripts)
  - task:campaign-to-legend-migration (campaign→legend edge migration)
  - task:cycle-entity (cycle:* as first-class graph entity)
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 5, 2026

📝 Walkthrough

Walkthrough

CHANGELOG.md documents new graph-ontology primitives including 9 invariants, 5 legends, and 3 edge types; operational backlog triage reduction from 158 to 53 quests; diagnostic-control-flow restriction in Doctor service to PLANNED/READY/IN_PROGRESS states; and CI reliability improvements in diagnostic logging tests.

Changes

Cohort / File(s) Summary
Changelog documentation
CHANGELOG.md
Records new graph-ontology primitives (9 invariants, 5 legends, 6 schema prefixes, 3 edge types), backlog triage operational improvements (158→53 quests), Doctor service diagnostic-control-flow changes (restricts checks to PLANNED/READY/IN_PROGRESS, reducing diagnostics 55→3), and CI reliability fix (rg→grep in diagnostic logging test).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐇 Whiskers twitching with delight,
New invariants shine so bright,
Legends guard with protects true,
Backlog trimmed from old to new!
Doctor rests more peacefully,
CI runs most reliably! 🌟

🚥 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 partially describes the changes: it mentions updating CHANGELOG and filing backlog items, which aligns with the PR objectives, but the title is somewhat vague about what specific work was recorded in the changelog.
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 chore/changelog-and-backlog

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
Copy Markdown

@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.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CHANGELOG.md`:
- Line 17: Update the CHANGELOG description to accurately reflect the differing
filters used by the two Doctor scans: state that the "readiness" scan excludes
BACKLOG, GRAVEYARD, DONE and therefore checks PLANNED, READY, IN_PROGRESS and
BLOCKED, while the "governed-completion" scan excludes only BACKLOG and
GRAVEYARD and therefore checks PLANNED, READY, IN_PROGRESS, BLOCKED and DONE;
reference the two checks by their names ("readiness checks" and
"governed-completion checks") and list the exact statuses (PLANNED, READY,
IN_PROGRESS, BLOCKED, DONE) so the changelog aligns with the actual code logic.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 28349a49-26db-46d1-adc5-42b7dc931eb4

📥 Commits

Reviewing files that changed from the base of the PR and between f89b65e and 41f7eb5.

📒 Files selected for processing (1)
  • CHANGELOG.md

Comment thread CHANGELOG.md
### Changed

- **Backlog triaged from 158 open quests to 53** — 11 quests sealed as already completed, ~88 graveyarded with full "WHAT IT WAS" intent reconstructions, 24 stubs merged into 6 consolidated cycle-worthy items, 18 rethought (12 graveyarded, 1 reset, 5 reframed with new titles and descriptions reflecting METHOD adoption).
- **Doctor no longer flags BACKLOG, GRAVEYARD, or DONE quests for readiness and governed-completion gaps** — these scans now only check PLANNED/READY/IN_PROGRESS quests, eliminating 52 false diagnostics from graveyarded and sealed work. Doctor diagnostics went from 55 to 3 (all legitimate PLANNED quest work).
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Incomplete description of Doctor filtering behavior.

The CHANGELOG states both checks "only check PLANNED/READY/IN_PROGRESS quests", but the actual code filters are different:

  • Readiness checks (context snippet 1, line 970): exclude BACKLOG, GRAVEYARD, DONE → checks PLANNED, READY, IN_PROGRESS, BLOCKED (missing BLOCKED in the description)
  • Governed-completion checks (context snippet 2, line 1116-1117): exclude BACKLOG, GRAVEYARD only → checks PLANNED, READY, IN_PROGRESS, BLOCKED, DONE (incorrectly excludes DONE and BLOCKED in the description)

The two checks have different filter logic but are described identically.

📝 Suggested fix for accuracy
-**Doctor no longer flags BACKLOG, GRAVEYARD, or DONE quests for readiness and governed-completion gaps** — these scans now only check PLANNED/READY/IN_PROGRESS quests, eliminating 52 false diagnostics from graveyarded and sealed work. Doctor diagnostics went from 55 to 3 (all legitimate PLANNED quest work).
+**Doctor no longer flags BACKLOG and GRAVEYARD quests for readiness and governed-completion gaps** — readiness scans now check PLANNED/READY/IN_PROGRESS/BLOCKED quests (excluding DONE), while governed-completion scans check PLANNED/READY/IN_PROGRESS/BLOCKED/DONE quests. This change eliminated 52 false diagnostics from graveyarded and backlog work. Doctor diagnostics went from 55 to 3 (all legitimate PLANNED quest work).
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- **Doctor no longer flags BACKLOG, GRAVEYARD, or DONE quests for readiness and governed-completion gaps**these scans now only check PLANNED/READY/IN_PROGRESS quests, eliminating 52 false diagnostics from graveyarded and sealed work. Doctor diagnostics went from 55 to 3 (all legitimate PLANNED quest work).
- **Doctor no longer flags BACKLOG and GRAVEYARD quests for readiness and governed-completion gaps**readiness scans now check PLANNED/READY/IN_PROGRESS/BLOCKED quests (excluding DONE), while governed-completion scans check PLANNED/READY/IN_PROGRESS/BLOCKED/DONE quests. This change eliminated 52 false diagnostics from graveyarded and backlog work. Doctor diagnostics went from 55 to 3 (all legitimate PLANNED quest work).
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CHANGELOG.md` at line 17, Update the CHANGELOG description to accurately
reflect the differing filters used by the two Doctor scans: state that the
"readiness" scan excludes BACKLOG, GRAVEYARD, DONE and therefore checks PLANNED,
READY, IN_PROGRESS and BLOCKED, while the "governed-completion" scan excludes
only BACKLOG and GRAVEYARD and therefore checks PLANNED, READY, IN_PROGRESS,
BLOCKED and DONE; reference the two checks by their names ("readiness checks"
and "governed-completion checks") and list the exact statuses (PLANNED, READY,
IN_PROGRESS, BLOCKED, DONE) so the changelog aligns with the actual code logic.

@flyingrobots flyingrobots merged commit b4dc672 into main Apr 5, 2026
9 checks passed
@flyingrobots flyingrobots deleted the chore/changelog-and-backlog branch April 5, 2026 09:48
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