From 23884a6448dd6123349d4bc2eba1e4f35079e00a Mon Sep 17 00:00:00 2001 From: sim Date: Thu, 13 Aug 2026 03:13:34 -0400 Subject: [PATCH] docs(#3309): add changeset fragments for the breaking changes Three user-visible changes disclosed per CONTRIBUTING.md's changeset convention: --repair no longer auto-applies DESTRUCTIVE remedies (Changed), W021/W017 split into W026/W027 for their previously- conflated second subjects (Changed), and --backfill alone now actually works (Fixed, a latent-bug fix). pr:0 placeholder, backfilled once the PR number is known. --- .changeset/fierce-eagles-roam.md | 5 +++++ .changeset/gallant-otters-fly.md | 5 +++++ .changeset/happy-jaguars-roar.md | 5 +++++ 3 files changed, 15 insertions(+) create mode 100644 .changeset/fierce-eagles-roam.md create mode 100644 .changeset/gallant-otters-fly.md create mode 100644 .changeset/happy-jaguars-roar.md diff --git a/.changeset/fierce-eagles-roam.md b/.changeset/fierce-eagles-roam.md new file mode 100644 index 000000000..84a9a192c --- /dev/null +++ b/.changeset/fierce-eagles-roam.md @@ -0,0 +1,5 @@ +--- +type: Fixed +pr: 0 +--- +**`validate health --backfill` now works without also passing `--repair`** — previously it silently did nothing unless `--repair` was also set, due to an unreachable internal gate. diff --git a/.changeset/gallant-otters-fly.md b/.changeset/gallant-otters-fly.md new file mode 100644 index 000000000..69af1f431 --- /dev/null +++ b/.changeset/gallant-otters-fly.md @@ -0,0 +1,5 @@ +--- +type: Changed +pr: 0 +--- +**`validate health` splits two previously-conflated warning codes into their own codes** — W021 now covers only the phase-id-convention mismatch it originally meant; the STATE-vs-ROADMAP milestone-complete mismatch it used to also report moves to the new W026. Likewise W017 now covers only orphan worktrees; the stale-worktree case moves to the new W027. diff --git a/.changeset/happy-jaguars-roar.md b/.changeset/happy-jaguars-roar.md new file mode 100644 index 000000000..9add7c2c1 --- /dev/null +++ b/.changeset/happy-jaguars-roar.md @@ -0,0 +1,5 @@ +--- +type: Changed +pr: 0 +--- +**`validate health --repair` no longer resets config.json or regenerates STATE.md automatically** — these two repairs are destructive (they lose custom settings or session history), so they're now reported with their fix described but never auto-applied; run the suggested command yourself to apply them.