From 48776f64e7db6616eba9f0b68f737722e02e01f1 Mon Sep 17 00:00:00 2001
From: qnbs <155236708+qnbs@users.noreply.github.com>
Date: Thu, 30 Jul 2026 10:19:40 +0200
Subject: [PATCH 1/2] docs(changelog): document WS-1 doc-metrics gate fix in
 Unreleased

PR #293 merged into main after the v1.24.3 release but the Unreleased
section stayed empty -- back-fill it so the changelog reflects what's
actually shipped on main, not just the last tagged release.
---
 CHANGELOG.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index fbdcd28b..ec872f2c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,17 @@ 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)
+
 ## [1.24.3] — 2026-07-30
 
 > Worker-generation consolidation sprint: the v1/WorkerBus-v2 duplication [ADR-0014](docs/adr/0014-worker-generation-duplication.md)

From d9388adcf592c17e50f98828d79f138f7633ac4a Mon Sep 17 00:00:00 2001
From: qnbs <155236708+qnbs@users.noreply.github.com>
Date: Thu, 30 Jul 2026 10:29:23 +0200
Subject: [PATCH 2/2] docs(changelog): document PR #294's CLAUDE.md
 merge-discipline codification

Second Unreleased entry for what's landed on main since v1.24.3 -- keeps
the changelog a complete record of main, not just the last tagged release.
---
 CHANGELOG.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ec872f2c..87dafd0d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -18,6 +18,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   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)