Files
AILang/docs/journals/2026-05-18-iter-embedding-abi-m2.tidy.md
T
Brummel a80d495ab3 iter embedding-abi-m2.tidy: '## Embedding ABI (M1)' -> '## Embedding ABI' lockstep rename (M2 audit doc-honesty fix)
Resolves the M2 milestone-close audit's only actionable drift item
(architect [medium] DESIGN.md:2266 stale (M1) header vs its now-M2
present-tense body + coupled [low] :2354 xref). Current-state-mirror:
the section describes the current embedding ABI (M1+M2), so the
milestone tag is internal history, not current state.

5 live-coupling sites renamed in lockstep, 3 files:
- docs/DESIGN.md:2266 header '## Embedding ABI (M1)' -> '## Embedding ABI'
- docs/DESIGN.md:2354 schema-block xref 'see §"Embedding ABI"'
- docs_honesty_pin.rs:134 test comment + :136 assert-message
- crates/ailang-core/specs/form_a.md:89 live forward-xref (Boss-added
  5th site: plan-recon-undercount countermeasure surfaced a live
  dangling-xref the architect's 3-site scope missed; folded in on
  the merits — a half-rename contradicts the tidy's own thesis)

docs_honesty_pin.rs:135 asserted substring (the rename-immune
DESIGN.md body sentence) byte-verbatim untouched. Committed
append-only history NOT falsified (Boss-verified diff = 3 content
files + journal + stats only). Pins green before AND after
(docs_honesty_pin 5/0, design_schema_drift 8/0). Zero
language/checker/codegen/schema change.
2026-05-18 17:52:10 +02:00

2.4 KiB

iter embedding-abi-m2.tidy — lockstep section rename Embedding ABI (M1)Embedding ABI

Date: 2026-05-18 Started from: d1241b12c7 Status: DONE Tasks completed: 1 of 1

Summary

Audit-driven docs-honesty tidy (no parent spec; source: docs/journals/2026-05-18-audit-embedding-abi-m2.md, the M2 milestone-close audit). The DESIGN.md section ## Embedding ABI (M1) had a stale (M1) qualifier — its body now describes the post-M2 ctx ABI present-tense, so the qualifier contradicts the current-state-mirror discipline. Renamed the header and moved all four live coupled references in lockstep so no pointer dangles at the vanished (M1) title. Pure docs/test-string tidy: zero language / checker / codegen / schema change; ail check/run byte-unchanged by construction. The docs_honesty_pin.rs:135 asserted substring is rename-immune (no section-name token, matched file-wide via d.contains) and was left byte-verbatim untouched; the pin staying green before AND after empirically confirms the rename did not perturb it.

Per-task notes

  • iter embedding-abi-m2.tidy.1: lockstep rename across 5 live-coupling sites in 3 files — docs/DESIGN.md:2266 (section header) + docs/DESIGN.md:2354 (schema-block xref comment) + crates/ailang-core/tests/docs_honesty_pin.rs:134 (test comment) + :136 (assert-message) + crates/ailang-core/specs/form_a.md:89 (compiled-in forward-xref). Each site: one-line in-place (M1)-token deletion, no reflow. Step-1 baseline grep showed exactly the 5 sites present (:135 correctly absent — no (M1) token); Step-6 grep returned zero (exit 1). docs_honesty_pin 5 passed and design_schema_drift 8 passed both before and after. Footprint gated at exactly 3 files, 5 insertions / 5 deletions — no docs/journals/**, docs/specs/**, docs/plans/**, bench/orchestrator-stats/** touched (committed append-only history retains Embedding ABI (M1) as correct record of the name at the time; renaming it would falsify the record).

Concerns

(none)

Known debt

(none)

Files touched

  • docs/DESIGN.md (header :2266, schema-block xref :2354)
  • crates/ailang-core/tests/docs_honesty_pin.rs (comment :134, assert-message :136; :135 untouched)
  • crates/ailang-core/specs/form_a.md (forward-xref :89)

Stats

bench/orchestrator-stats/2026-05-18-iter-embedding-abi-m2.tidy.json