Skip to content

Commit 4b5fc9c

Browse files
derek73claude
andcommitted
docs: review round on the watched-shapes arc and the checklist record
Five sentences the design-docs reviewer's second pass found false or narrower than the code, none of them structural. decisions.md: the supersession pointer in the recorded-shapes arc said the exit code "reads only one" of the two shape-comparison halves; it reads a contest row's mismatch on either tier and a watched row's where its default-order entry is contract tier -- measured, `선생님` corrupted at 2.0.0 exits 1 -- and the reason the comparison runs once per roster is that one call could not tell the two apart. The corpus-tier arc's forward pointer said a watched row fails "on a contract default-order entry"; the tier is the first-loaded entry's where a name has no default-order entry, so the sentence now says so. AGENTS.md: #503 is closed by this branch's merge, not on a date the record can know; the 2.1.0 watched-row count is stated as an invariant with its live expression rather than as a standing digit; and the cost sentence now points at the bullet that actually carries the timing recompute (the rule-order arc's Declined bullet), which the #497 finding it cited says it does not restate. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
1 parent 07a2690 commit 4b5fc9c

2 files changed

Lines changed: 12 additions & 8 deletions

File tree

AGENTS.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -113,18 +113,22 @@ uv run sphinx-build -b html docs dist/docs
113113
# b=${f##*expected_since_}; b=${b%.toml}
114114
# uv run python tools/differential/compare.py --baseline "$b" > "/tmp/gate-$b.txt"; echo "$b exit $?"
115115
# done
116-
# #503 (filed 2026-09-03, closed 2026-09-05): this step enumerated three
116+
# #503 (filed 2026-09-03, fixed on the branch 2026-09-05, closed by its
117+
# merge): this step enumerated three
117118
# commands against four ledgers, so `--baseline 2.1.0` got no dormancy,
118119
# over-declaration or recorded-shape check from any releaser, the shape
119120
# gap "latent" only while that ledger's roster sections were empty; the
120-
# bundle that closed it ARMED it first -- 31 watched rows now sit in
121-
# expected_since_2.1.0.toml's _WATCHED_DIFFS section -- and the loop
122-
# above is the fix it chose.
121+
# bundle that closed it ARMED it first -- rows now sit in
122+
# expected_since_2.1.0.toml's _WATCHED_DIFFS section (31 on the day;
123+
# `len(compare._WATCHED_DIFFS['expected_since_2.1.0.toml'])` is the
124+
# live figure) -- and the loop above is the fix it chose.
123125
# Cost is not the obstacle and no fix may be argued from it: measured
124126
# 2026-09-03, a whole run is under a second at every baseline and all
125127
# four back to back are about two seconds (0.43s at 1.4.0, 0.56s at
126-
# 2.2.0, 1.97s for the four; decisions.md's 2026-09-03 #497 timing
127-
# finding carries the recompute and retires every cost argument in
128+
# 2.2.0, 1.97s for the four; the recompute lives ONCE, in decisions.md's
129+
# rule-order arc under the Declined bullet on precise per-name contest
130+
# detection, and the 2026-09-03 #497 timing finding points there and
131+
# retires every cost argument in
128132
# this repo's differential prose).
129133
# The classified summary each run prints is the source for the release
130134
# notes' behavior claims, including the count of changed names that are

0 commit comments

Comments
 (0)