Skip to content

docs(changelog): back-fill Unreleased section for everything merged since v1.24.3 #295

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
qnbs merged 2 commits into from
Jul 30, 2026
+25 −0
Merged

docs(changelog): back-fill Unreleased section for everything merged since v1.24.3 #295

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
48776f6
docs(changelog): document WS-1 doc-metrics gate fix in Unreleased
qnbs Jul 30, 2026
d9388ad
docs(changelog): document PR #294's CLAUDE.md merge-discipline codifi…
qnbs Jul 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,31 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

### Fixed

- **Doc-drift gate (`scripts/check-doc-metrics.mjs`) had a blind spot for still-open checklist
bullets inside dated/historical sections**: `stripHistoricalSections()` blanked every line in a
historical section indiscriminately, including a genuinely still-open `- ⬜` bullet — exactly how
a stale "Tag `v1.24.2`" bullet escaped the gate in a same-day doc edit (`dc14bc0`). `OPEN_BULLET`
now gets the same "always present-tense, never stripped" treatment `DONE_BULLET` already had for
the opposite polarity. `scanForDrift()` also gains a new check: a surviving open bullet
mentioning tag/release/publish (including inflected forms — "Tagging"/"Releasing"/"Publishing")
of a version `<=` the latest git tag is now flagged as drift. (#293)

### Docs

- **`CLAUDE.md` codifies three merge-discipline lessons** learned during the PROMPT-WSS-v1.24.x
recovery sprint: never commit directly to `main` (always branch + PR, even for a single-file
change); wait for the **full** CI suite — including non-required/advisory jobs like E2E,
Storybook, Lighthouse, and Visual Regression — to go green before merging, not just the
branch-protection-required checks; and group related small workstreams into the fewest
reviewable PRs by natural/documented boundaries rather than one PR per tiny item, while keeping
one commit per logical concern. Also adds a "Known merge-gate quirks" section distinguishing
GitHub's real pending-check block from this repo's own stricter wait-for-pass policy and the
mergeable-state cache-lag symptom, plus documents the stacked-PR auto-close-on-squash-merge
side effect and its recovery steps; and strengthens the CodeAnt Correction Loop policy to
explicitly cover CodeRabbit's collapsed nitpick and outside-diff-range comment sections. (#294)

## [1.24.3] — 2026-07-30

> Worker-generation consolidation sprint: the v1/WorkerBus-v2 duplication [ADR-0014](docs/adr/0014-worker-generation-duplication.md)
Expand Down
Loading