Skip to content

feat(kaizen): doctor reports pending migrations; breaking releases must declare theirs (4.4.0) - #45

Merged
Lingelo merged 1 commit into
mainfrom
ccr-8ab01603-apdrcp
Oct 21, 2026
Merged

Lingelo merged 1 commit into
mainfrom
ccr-8ab01603-apdrcp

Conversation

@Lingelo

@Lingelo Lingelo commented Oct 21, 2026

Copy link
Copy Markdown
Owner

Summary

S2 of docs/plans/2026-10-21-0700-feat-kaizen-upgrade-plan.md (S1 = #44, kaizen upgrade).

  • doctor check upgrade (U2, R5, AE4): "3 Kaizen migration(s) pending (profile-names, kaizen-ops, hook-lookup)", with how many must be done by hand, fix node "$K" upgrade; ok when nothing is pending; no check outside a Kaizen repo. doctor imports upgrade.mjs — the one load-time reference back to doctor (a migration title) is now plain text, every import order checked.
  • Relayed by help, work and setup through the conventions' guard rails: show the list, offer upgrade --apply before touching versioned files, give the manual steps; setup check runs upgrade. Guides help, setup and the CLI reference updated.
  • Contract (U3, R6, AE5): from 4.3.0 on, a CHANGELOG release with a Breaking or Deprecated section must register a migration with that since or a reason in NO_MIGRATION (new export, empty); a fixture proves the failure and both ways to lift it.
  • Kaizen 4.4.0, CHANGELOG, CLAUDE.md, plan DoD.

Test plan

  • node --test plugins/kaizen/tests/*.test.mjs plugins/kaizen-ops/tests/*.test.mjs → 221 pass, 0 fail
  • AE4: doctor warns with count and ids, ok after --apply, counts manual ones, absent outside Kaizen
  • AE5: real CHANGELOG passes; fixture with an undeclared breaking 9.9.0 fails; a migration or an exemption lifts it
  • Evals help-route help-incident setup-check setup-install setup-audit → 5/5 (skills and conventions changed)
  • plan check ✔
  • CI: 6 jobs (Ubuntu/macOS/Windows × Node 18/22)

Generated by Claude Code

…st declare theirs (4.4.0)

S2 of the upgrade plan. doctor gains an `upgrade` check (count, ids, how many by
hand, `node "$K" upgrade` as the fix), relayed by help, work and setup through
the conventions' guard rails; setup check runs upgrade. A contract requires
every CHANGELOG release from 4.3.0 on with a Breaking or Deprecated section to
register a migration for that version or a NO_MIGRATION reason.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_012iZk6aQ3fhJy4jrZhfWtaf
@Lingelo
Lingelo merged commit 47255f1 into main Oct 21, 2026
6 checks passed
Lingelo pushed a commit that referenced this pull request Oct 21, 2026
Lingelo added a commit that referenced this pull request Oct 21, 2026
docs(plans): upgrade plan done — S2 merged in #45
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.

2 participants