Brummel
176821c2e7
The 3020-line docs/DESIGN.md is replaced by the design/ ledger:
design/INDEX.md (sole addressable spine, typed Contracts+Models tables,
polymorphic links — prose file OR authoritative source //!), 14
design/contracts/*.md test-linked invariants + 3 source-link-only
contracts (mangling/env-construction/qualified-xref, no prose file —
code is SoT), 5 design/models/*.md whitepapers, and
docs/journals/2026-05-19-design-decision-records.md (the
relitigation-guard archive — every why/rejected/does-not-do/rollback/
empirical ### moved out at ###-granularity). Clean cut: git rm
docs/DESIGN.md, no stub.
RED-first crates/ailang-core/tests/design_index_pin.rs — the 4-clause
anti-regrowth spine (DESIGN.md-gone / every-INDEX-link-resolves /
every-contract-names-a-resolvable-ratifier /
contracts-carry-no-decision-record-prose) — demonstrably RED before,
GREEN after. Build-atomic by task ordering: design_schema_drift.rs's
include_str! (the only compile-time consumer) retargeted to
design/contracts/data-model.md BEFORE the deletion; its
## Data model/## Pipeline slicer dropped (a simplification the split
enables). 2 NoInstance diagnostics + 2 lockstep E2Es retargeted to
design/contracts/{float-semantics,typeclasses}.md. ~12 agent reading
lists + 5 SKILL bodies + CLAUDE.md + skills/README.md + ~25
code/C/.ail/spec comment xrefs retargeted; OQ7 dangling 'Iter 13b'
cite deleted (no forward target — a pointer would be fiction).
honesty-rule.md rewritten so the rule names the new home
(rationale->journals), resolving the recon-found internal
contradiction; the two docs_honesty_pin.rs:70,72 pinned phrases kept
verbatim+contiguous.
Boss-verified independently: cargo test --workspace 646 passed /
0 failed; design_index_pin 4/4; acceptance grep CLEAN of live
DESIGN.md refs (residuals = only the spec-mandated clause-4
deletion-enforcer). 2 DONE_WITH_CONCERNS routed to the mandatory
milestone-close audit: (a) str-abi.md:23 '(iter str-concat,
2026-05-13)' provenance stamp trips advisory architect_sweeps Sweep-1
— Boss-confirmed byte-identical to DESIGN.md@deeffb1:2062-2065, a
faithfully-migrated PRE-EXISTING anchor (regexes verbatim, only path
retargeted), NOT split-introduced — RATIFY-or-tidy at audit; (b) a
now stale-direction intra-prose 'see Str ABI below' cross-ref in
float-semantics.md — audit-adjudication candidate. Plan defect noted:
Task 9 Step 4's verbatim acceptance grep used a ^./ anchor not
matching the system's grep -rIn output; substance re-verified CLEAN.
Spec grounding-check PASS x2. Journals INDEX + decision-records
pointer appended (Boss-only).
65 lines
2.7 KiB
Bash
Executable File
65 lines
2.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# bench/architect_sweeps.sh
|
|
#
|
|
# Run the five honesty/anchor sweep-invariant greps against the
|
|
# design/ prose set (design/contracts + design/models); the spine is
|
|
# design/INDEX.md. Output: matched lines, prefixed by sweep name.
|
|
# Exit 0 if all five sweeps are clean, 1 if any anchor was found,
|
|
# 2 if the spine (design/INDEX.md) is not found. Sweeps 1-4 are the
|
|
# history-anchor invariants; Sweep 5 is the docs-honesty-lint
|
|
# Wunschdenken / post-mortem invariant.
|
|
#
|
|
# Companion to skills/audit/agents/ailang-architect.md "What you check
|
|
# / design/ history-anchor regrowth". See JOURNAL 2026-05-10
|
|
# ("Milestone close: design-md-consolidation") for the rationale of
|
|
# each sweep regex; the regexes here are copied verbatim from JOURNAL
|
|
# entries 12487 (Sweep 1), 12619 (Sweep 2), 12718-12720 (Sweep 3),
|
|
# and 12840 (Sweep 4).
|
|
#
|
|
# A non-zero exit is advisory, not authoritative: the architect agent
|
|
# reviews each match and decides whether it is a legitimate quote
|
|
# (e.g. a JOURNAL citation inside a block-quote) or fresh drift.
|
|
|
|
set -u
|
|
INDEX="design/INDEX.md"
|
|
DESIGN_GLOB="design/contracts design/models"
|
|
HITS=0
|
|
|
|
if [[ ! -f "$INDEX" ]]; then
|
|
echo "architect_sweeps: $INDEX not found (run from repo root)" >&2
|
|
exit 2
|
|
fi
|
|
|
|
run_sweep() {
|
|
local name="$1"
|
|
local pattern="$2"
|
|
local matches
|
|
matches=$(grep -rnE "$pattern" $DESIGN_GLOB || true)
|
|
if [[ -n "$matches" ]]; then
|
|
echo "=== Sweep: $name ==="
|
|
echo "$matches"
|
|
echo
|
|
HITS=1
|
|
fi
|
|
}
|
|
|
|
run_sweep "1 (history anchors)" \
|
|
'Iter [0-9]+[a-z]?(\.[0-9]+)?|Family [0-9]+|^[^/]*2026-[0-9]{2}-[0-9]{2}|\*\*Status: |pre-[0-9]+[a-z]?|[0-9]+[a-z]? sketch|21\.g'
|
|
|
|
run_sweep "2 (REVERTED + migration)" \
|
|
'REVERTED|preserved for the audit trail|Migration plan|[Oo]riginally framed|original rationale|empirically-grounded version|A future (iter|iteration|milestone|Prelude) may|A future iter that|a (later|future) iter(ation)? \(deferred\)|Concrete design deferred'
|
|
|
|
run_sweep "3 (schema SoT)" \
|
|
'^\s*(struct |enum |pub (struct|enum|fn))|whenever the two disagree|ast\.rs is the source of truth'
|
|
|
|
run_sweep "4 (workflow + stale cross-references)" \
|
|
'agents/README\.md|ailang-docwriter|Recently lifted|see the JOURNAL queue|later the same day|Sharpened later|closure conversion in JOURNAL'
|
|
|
|
run_sweep "5 (honesty: wunschdenken + non-citation post-mortem)" \
|
|
'on the path to|may land in a future|ships in a future iter|[Ww]ill back `Show|[Ww]ill eventually (be|support|back)|[Ii]f/?when [a-z]+ (arrives|lands)|[Aa]n earlier draft of this|previously all diagnostics were|[Ww]hat did change in 20|were retired 20[0-9]{2}-|retired in iter [a-z]|originally listed|\bwas deferred\b|foundation for [a-z]'
|
|
|
|
if [[ $HITS -eq 0 ]]; then
|
|
echo "All five sweeps clean."
|
|
fi
|
|
exit $HITS
|