chore(contract): phase 1 controller proofs + GATE 0 evidence
This commit is contained in:
1 parent
ce7d426fc7
commit
1c14e31db9
1 file changed
+17
-10
@@ -21,55 +21,62 @@ Q: `autoMemoryEnabled: false` also drops the analyzer's `memory: project` sectio
|
||||
1. settings.json carries `"autoMemoryEnabled": false`.
|
||||
CHECK: jq -e '.autoMemoryEnabled == false' settings.json >/dev/null && echo AUTOMEM-OFF
|
||||
EXPECT: AUTOMEM-OFF
|
||||
EVIDENCE: pending
|
||||
EVIDENCE: MET exit=0 marker-found :: AUTOMEM-OFF
|
||||
2. robin_petier's registry holds exactly one new entry for the LAN dev server rule, written by `lib/memory.sh -C ~/Documents/robin_petier add`, on a `chore/*` branch of that repo, with the text the user approved; no other project's `.claude/memory/` changes.
|
||||
3. doctor warns when any `~/.claude/projects/*/memory/` dir holds a file, names how many dirs, and stays silent when all are empty (flip-tested in a suite with a temp HOME).
|
||||
[gated 2026-10-29] amended: doctor prints a warn line naming the count when a dir holds a file, a pass line otherwise; the proof is the function-level suite (lib/tests/doctor-automem.test.sh) including a call through a temp HOME; doctor also checks the `~/.claude/rules` symlink and that settings.json `autoMemoryEnabled` is false.
|
||||
4. CLAUDE.global.md has no `## Design work` heading; rules/web-building.md ends with the section `## Design work — full toolchain (tiered by scope)`, body identical to the CLAUDE.global.md section at develop 017a28b (internal pointers excepted, listed in the plan); web-building.md `paths:` unchanged.
|
||||
CHECK: bash .claude/tasks/contracts/c1-design-moved.sh
|
||||
EXPECT: DESIGN-MOVED
|
||||
EVIDENCE: pending
|
||||
EVIDENCE: MET exit=0 marker-found :: DESIGN-MOVED
|
||||
5. hooks/design-toolchain-reminder.sh prints a one-liner that names `~/.claude/rules/web-building.md` and the heading fragment `full toolchain`, and no longer says "already in context"; its suite asserts the exact new line.
|
||||
6. The design hook stays quiet on a prompt starting with `<agent-message` even when it carries UI tokens (new D-test), and still fires on F1-F10.
|
||||
7. lib/tests/design-toolchain-reminder.test.sh runs every hook call under a temp HOME: a suite run leaves ~/.claude/logs/design-toolchain-fires.log unchanged.
|
||||
CHECK: L="$HOME/.claude/logs/design-toolchain-fires.log"; a=$(wc -l < "$L"); bash lib/tests/design-toolchain-reminder.test.sh >/dev/null 2>&1 || exit 1; b=$(wc -l < "$L"); [ "$a" = "$b" ] && echo LOG-UNTOUCHED
|
||||
EXPECT: LOG-UNTOUCHED
|
||||
EVIDENCE: pending
|
||||
EVIDENCE: MET exit=0 marker-found :: LOG-UNTOUCHED
|
||||
8. [gated 2026-10-29] amended: `## graphify` keeps the threshold rule plus ONE reminder clause (`graphify query` before raw grep, `graphify update .` after code edits; sub-agents never see the banner); the full usage body moves as below. Original: CLAUDE.global.md `## graphify` keeps only the threshold rule; the usage body (query/path/explain, wiki/GRAPH_REPORT, `graphify update .`) is printed by hooks/session-start.sh only when the repo root holds `graphify-out/graph.json`; a suite proves present-with-graph and absent-without (flip).
|
||||
9. lib/architecture-defaults.md exists and holds the "Public websites — never SPA" text and the "Default language — Rust" text (wording identical to their sources at 017a28b, pointers excepted) plus the Web APIs rule or a pointer to rules/rest-api.md § Versioning; CLAUDE.global.md has no `## Public websites` and no `## Web APIs` heading and holds one always-on line naming Rust default, never SPA, `/api/v1` and the lib path; rules/default-language.md no longer exists.
|
||||
CHECK: bash .claude/tasks/contracts/c1-arch-moved.sh
|
||||
EXPECT: ARCH-MOVED
|
||||
EVIDENCE: pending
|
||||
EVIDENCE: MET exit=0 marker-found :: ARCH-MOVED
|
||||
10. Readers name the lib: skills/init-project/SKILL.md, skills/ship-feature/SKILL.md (STEP 1), skills/onboard/SKILL.md, agents/interviewer.md, agents/scaffolder.md, skills/audit-delta/SKILL.md; no tracked file under skills/ agents/ lib/ hooks/ rules/ templates/ nor CLAUDE.global.md cites `default-language.md`.
|
||||
CHECK: bash .claude/tasks/contracts/c1-readers.sh
|
||||
EXPECT: READERS-OK
|
||||
EVIDENCE: pending
|
||||
EVIDENCE: MET exit=0 marker-found :: READERS-OK
|
||||
11. rules/rest-api.md `## Versioning` carries the full versioning rule (text of CLAUDE.global.md § Web APIs at 017a28b), no "Not repeated here"; lib/project-archetypes/rest-api-node.md cites rules/rest-api.md instead of CLAUDE.md "Web APIs — always versioned".
|
||||
12. rules/supabase.md and rules/cloud-functions.md exist with the clarified one-line JSON `paths:` and the bullets of secure-by-default.md §4 / §6 at 017a28b, wording identical; secure-by-default.md keeps the `## 4. Supabase` and `## 6. Cloud functions` headings with one line each naming the critical rule and the path rule.
|
||||
CHECK: bash .claude/tasks/contracts/c1-supabase-functions.sh
|
||||
EXPECT: SB-CF-MOVED
|
||||
EVIDENCE: pending
|
||||
EVIDENCE: MET exit=0 marker-found :: SB-CF-MOVED
|
||||
13. A make-test suite parses every rules/*.md frontmatter (one-line JSON `paths:` or none) and locks the always-on set to exactly writing-style.md + secure-by-default.md; positive control: a multi-line `paths:` fixture and an extra always-on fixture both fail it.
|
||||
14. lib/project-rules.sh header comment states the observed engine matching (trailing `/**` dropped, a pattern matches at any depth, hidden dirs included, evidence: InstructionsLoaded `globs: ["rules"]` on `.claude/rules/*.md`) instead of "the engine's matcher skips" dotfiles; code behaviour unchanged.
|
||||
15. Load proof (controller, journaled): one fresh headless session per moved path rule, each prompt naming the Read tool on a real file, logs `path_glob_match` for rules/supabase.md (faunosteo), rules/cloud-functions.md (game, supabase/functions), rules/web-building.md (a UI file); and `bash lib/project-rules.sh -C <project> matches '<glob>'` per new glob in the project that holds it (a glob that matches nowhere is named in the journal).
|
||||
16. Every tracked agents/*.md `description:` (the 4 vendored impeccable-* excepted) is ≤ the length settled at the plan gate; agent names, files and `model:` lines unchanged.
|
||||
CHECK: bash .claude/tasks/contracts/c1-agent-desc.sh
|
||||
EXPECT: AGENT-DESC-OK
|
||||
EVIDENCE: pending
|
||||
EVIDENCE: MET exit=0 marker-found :: AGENT-DESC-OK (23 agents)
|
||||
17. Citers patched in the same branch: CLAUDE.global.md Skill routing (Design / UI line, Higgsfield line), lib/design-gate.md, agents/seo-analyzer.md, .claude/rules/rules-maintenance.md (always-on exception list and the "always-on doctrine stays in CLAUDE.global.md" sentence), hooks/session-start.sh comments citing BDR-031 / the moved sections; doctrine-citers census green.
|
||||
18. CLAUDE.global.md is ≤ 320 lines (the session banner density warning goes away).
|
||||
CHECK: n=$(wc -l < CLAUDE.global.md); [ "$n" -le 320 ] && echo GLOBAL-UNDER-320
|
||||
EXPECT: GLOBAL-UNDER-320
|
||||
EVIDENCE: pending
|
||||
EVIDENCE: MET exit=0 marker-found :: GLOBAL-UNDER-320
|
||||
19. `/context` after (controller, `claude -p "/context"` at repo root, journaled with the baseline 2026-10-28: total 30.5k, Memory files 9.6k with user CLAUDE.md 7.4k / default-language 409 / secure-by-default 1.2k, Custom agents 2.6k, System prompt 4.4k): Memory files and Custom agents both lower, rules/default-language.md absent from the Memory files table.
|
||||
20. make test all green and shellcheck clean.
|
||||
CHECK: make test 2>&1 | tail -1
|
||||
EXPECT: all suites green
|
||||
EVIDENCE: pending
|
||||
EVIDENCE: MET exit=0 marker-found :: all suites green
|
||||
21. shellcheck clean on the health stack.
|
||||
CHECK: shellcheck *.sh hooks/*.sh lib/*.sh && echo SHELLCHECK-CLEAN
|
||||
EXPECT: SHELLCHECK-CLEAN
|
||||
EVIDENCE: pending
|
||||
EVIDENCE: MET exit=0 marker-found :: SHELLCHECK-CLEAN
|
||||
|
||||
## FILE SCOPE
|
||||
CLAUDE.global.md, settings.json, rules/web-building.md, rules/rest-api.md, rules/secure-by-default.md, rules/default-language.md (deleted), rules/supabase.md (new), rules/cloud-functions.md (new), lib/architecture-defaults.md (new), hooks/design-toolchain-reminder.sh, lib/tests/design-toolchain-reminder.test.sh, hooks/session-start.sh, lib/graphify-gate.sh (only if the graph-present branch needs it), a session-start graphify suite (new), doctor.sh + one lib/doctor-*.sh + its suite (new), lib/tests/ user-rules suite (new) + fixtures, lib/tests/graphify-gate.test.sh (the session-start graphify checks live there) [gated 2026-10-29], lib/tests/effort-routing.test.sh (one lock retargeted) [gated 2026-10-29], lib/tests/doctrine-citers.test.sh (census extension) [gated 2026-10-29], skills/guardrails/SKILL.md (citer) [gated 2026-10-29], .claude/tasks/contracts/2026-10-28-context-diet-1944.md + c1-*.sh [gated 2026-10-29], .claude/tasks/TODO.md [gated 2026-10-29], lib/project-rules.sh (comment only), agents/*.md (23 tracked, `description:` only), skills/init-project/SKILL.md, skills/ship-feature/SKILL.md, skills/onboard/SKILL.md, skills/audit-delta/SKILL.md, agents/interviewer.md, agents/scaffolder.md, agents/seo-analyzer.md, lib/design-gate.md, lib/project-archetypes/rest-api-node.md, .claude/rules/rules-maintenance.md, .claude/tasks/contracts/c1-*.sh (oracles), robin_petier `.claude/memory/` (one entry, its own chore/* branch), docs at STEP 8.
|
||||
|
||||
## PROOF — controller, 2026-10-29
|
||||
- c2 (robin_petier): `chore/memory-lan-server` started by `gitflow.sh start`, `memory.sh -C ~/Documents/robin_petier add decision --status accepted` → BDR-075 (v1 registry, stderr note), memory commit d16cd6e via memory-commit.sh rc 0, pushed; `git -C ~/Documents/{faunosteo,game} status --short` empty. Critical projects: faunosteo's only auto memory (dev-host-no-docker-access) already lives in its blockers.md (docker.sock BLK, resolved 2026-10-08); game's auto-memory dir is empty; jeux-deploy's (remote-git-ops) dropped by the pass-A answer (contradicts the gitflow delete doctrine). Nothing of faunosteo/game is lost.
|
||||
- c15 static: `project-rules.sh -C <proj> matches`: faunosteo `**/supabase/**` → packages/supabase, `**/*supabase*.*` → apps/app/src/lib/supabase.ts; game `**/supabase/**` → supabase, `**/*supabase*.*` → apps/web/src/progress/supabase.ts, `**/functions/**` → supabase/functions; robin_petier and zenquality: all five globs match nothing (no Supabase text loads there); `**/serverless.*` and `**/firebase.json` match nowhere in the four projects.
|
||||
- c15 load (`~/.claude/logs/instructions-loaded.jsonl`, headless `claude -p` naming the Read tool): 2026-10-29T12:14:26Z faunosteo `supabase.md` User path_glob_match on packages/supabase/package.json (globs logged `**/supabase,**/*supabase*.*`), `web-building.md` User on apps/app/e2e/harness/dialog.tsx; 12:14:36Z game `cloud-functions.md` + `supabase.md` User on supabase/functions/_shared/core.mjs (globs `**/functions,…`). Both repos clean after.
|
||||
- c19 `/context` after (repo root, headless): total 30.5k → 26.2k; Memory files 9.6k → 8.0k (user CLAUDE.md 7.4k → 6.3k, secure-by-default 1.2k → 985, default-language row gone); System prompt 4.4k → 3.7k (auto-memory section); Custom agents 2.6k → 2.1k. MCP server instructions 2.4k → 945 is NOT this branch (claude.ai connector set changed between the runs): own gain ≈ −2.8k.
|
||||
- analyzer `memory: project`: dropped by `autoMemoryEnabled: false` (control `--settings '{"autoMemoryEnabled": true}'` → section present); dirs empty; user kept false [gated 2026-10-29].
|
||||
Reference in new issue
Block a user