From 1c14e31db99efa12fa97b148c12978c325a3f459 Mon Sep 17 00:00:00 2001 From: bchanot Date: Thu, 29 Oct 2026 13:30:14 +0100 Subject: [PATCH] chore(contract): phase 1 controller proofs + GATE 0 evidence --- .../contracts/2026-10-28-context-diet-1944.md | 27 ++++++++++++------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/.claude/tasks/contracts/2026-10-28-context-diet-1944.md b/.claude/tasks/contracts/2026-10-28-context-diet-1944.md index 41f7eb3..afa7cc7 100644 --- a/.claude/tasks/contracts/2026-10-28-context-diet-1944.md +++ b/.claude/tasks/contracts/2026-10-28-context-diet-1944.md @@ -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 `/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 matches ''` 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 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].