audit docs-honesty-lint: milestone close — CLEAN, carry-on, no ratify

Architect clean (one [medium] advisory Sweep-5 self-match wart filed
as P3, not a fix iteration). Bench causally exonerated: HEAD vs
5bb7211/de66eb7 — all 5 firing bench binaries cmp-byte-identical, ail
sha256 identical at all 3 commits; the check.py firings are the two
tracked-P2 environmental classes (*.bump_s anchor staleness; *.max_us
-n5 tail-jitter, 4th on a zero-runtime-change milestone), NOT this
milestone — NO baseline ratify (Iron Law forbids ratifying noise).
compile_check 0/24, cross_lang 0/25 EXIT 0. No fieldtest (zero
authoring-surface change). docs-honesty-lint CLOSED: roadmap [~]->[x],
WhatsNew appended, INDEX line added.
This commit is contained in:
2026-05-18 12:40:57 +02:00
parent e50b400d4b
commit 3fb184417d
4 changed files with 184 additions and 18 deletions
+42 -18
View File
@@ -96,25 +96,36 @@ work progresses.
`docs/specs/2026-05-18-fieldtest-loop-recur.md`; principles entry
`docs/specs/2026-05-17-llm-surface-discipline.md` §6.2.
- [~] **\[milestone\]** DESIGN.md / docs honesty lint — spec'd +
approved 2026-05-18 (`aff25cd`), open as P0 in-flight; dependency
(Remove `mut`/`var`/`assign`) closed 2026-05-18; next `planner`.
Sweep the canonical docs so they mirror ONLY the actual current
state, present-tense. Single iteration (mirror effect-doc-honesty):
a two-pronged tense+modality discriminator codified present-tense
as a DESIGN.md meta-subsection (Approach A); procedural enumeration
= discriminator applied to the full `architect_sweeps.sh` + new
Sweep 5 output (not a frozen list — the sweep already surfaces
post-mortem sites the architect waved through as legitimate
quotes); anti-regrowth = enumerated `docs_honesty_pin.rs` (hard
cargo-test gate, incl. protected-exception present-anchors against
over-correction) + Sweep 5 + `ailang-architect.md` "DESIGN.md
honesty drift" bullet (advisory standing forward check). No
language/checker/codegen/runtime change.
- [x] **\[milestone\]** DESIGN.md / docs honesty lint — CLOSED
2026-05-18. `docs/DESIGN.md` + `docs/PROSE_ROUNDTRIP.md` now mirror
ONLY the current state, present-tense: 14 DESIGN.md corrections
(Wunschdenken stated-as-fact + non-citation post-mortem/doc-
archaeology stripped) + the PROSE tool-use/MCP paragraph; genuine
forward intent (LLM tool-use/MCP/LSP) relocated to P3. The
two-pronged tense+modality discriminator is codified present-tense
as a DESIGN.md `### What this document is …` meta-subsection
(Approach A) the architect cites. Anti-regrowth two ways: a
wrap-robust enumerated absent/present pin
`crates/ailang-core/tests/docs_honesty_pin.rs` (a `norm()`
whitespace-collapse helper structurally discharges the recurring
grep/contains line-wrap failure family — strictly better than the
effect-doc-honesty "keep-on-one-line" precedent) + wrap-robust
advisory Sweep 5 in `architect_sweeps.sh` (contiguous-fragment
regex) with full sweep-count lockstep + a new `ailang-architect.md`
"DESIGN.md honesty drift" bullet. Procedural enumeration vindicated:
the Task-4 Step-14 catch-all caught a genuine soft-wrapped extra FIX
(Form-B prose-projection bullet) a frozen list + the spec's
illustrative regex would both have missed. Single iter
(`aff25cd`/`de66eb7`/`7580d43`); milestone-close `audit` CLEAN
(architect clean, one `[medium]` advisory Sweep-5 self-match wart →
P3 below; bench causally exonerated — HEAD vs `5bb7211`/`de66eb7`
bench binaries `cmp`-byte-identical, NO ratify); no fieldtest (zero
authoring-surface change). Stays here briefly for context; remove
once stale (full record in `docs/journals/INDEX.md`).
- context: `docs/specs/2026-05-18-docs-honesty-lint.md`
(grounding-check PASS 10/10); 2026-05-18 user directive;
reserved-vs-vapour precedent
`docs/journals/2026-05-16-iter-effect-doc-honesty.md`
(grounding-check PASS 10/10);
`docs/journals/2026-05-18-iter-docs-honesty-lint.1.md`;
`docs/journals/2026-05-18-audit-docs-honesty-lint.md`
## P1 — Next
@@ -660,3 +671,16 @@ work progresses.
by the docs-honesty-lint milestone (forward intent does not live in
the canonical docs).
- context: `docs/specs/2026-05-18-docs-honesty-lint.md`
- [ ] **\[todo\]** Sweep 5 self-match anchor-exclusion — `bench/architect_sweeps.sh`
Sweep 5's regex matches the DESIGN.md discriminator subsection's own
forbidden-phrasing catalogue (L62 `"planned / will back / on the
path to / if-when X arrives"`) forever, so the script inherits a
guaranteed self-referential EXIT 1 the architect must re-adjudicate
by hand each run. Not a new failure mode (Sweeps 1-4 already retain
legitimate date-anchors; non-zero is advisory-by-design per the
script header) — minor signal-erosion only. Optional fix: a
negative-lookbehind / line-range exclusion so the rule's own example
list is not a hit. P3 — may be cut; the architect adjudicates the
single known self-match trivially today.
- context: `docs/journals/2026-05-18-audit-docs-honesty-lint.md`
(architect `[medium]` advisory wart, carry-on)