Files
faunosteo/.claude/tasks/contracts/2026-11-01-v1-2-3-closure.md

3.1 KiB

Contract: V1-2.3 closure adjustments (brief « Validation V1-2.3 (M6) et derniers ajustements »)

Owner brief 2026-11-01 on 26e4b1b: V1-2.3 VERIFIED technically, three closure adjustments before V1-2.4. Branch feature/v1-2-anatomical-sheets. Sandbox only; DEV (containers supabase_*_faunosteo, its queues, purges, secrets, accounts) untouched; no merge; no worker on DEV; no production, no release; then prepare V1-2.4 along the existing plan (scope only) and STOP.

Criteria

  • C1 Retry by effective cause. Definitive at the first occurrence (round verification_failed, outcome unavailable, its code, never claimed again): verification.worker.resource_limit when the cause is intrinsic to the frozen input or the contract caps (frame refused, input over the child cap, output over its cap, CPU budget SIGXCPU, memory budget SIGABRT, seccomp SIGSYS) and verification.worker.verdict_refused. Transient, retried after 2, 5, 10, 20 s up to five attempts: timeout (wall clock), unavailable (transport, Storage, broken child, and a child killed from outside: SIGKILL or any signal not listed above), lease_expired (immediate, the lease being the wait). Business and integrity verdicts stay definitive. Kept: five attempts, lease 10 min, not_before, no blocking wait, idempotence, stale protections, dead-lease recovery; RPC names, arguments and answers unchanged; user-facing outcome and codes unchanged. SQL holds the code policy, the worker maps cause to code. pgTAP and worker tests for each class; sandbox case for a definitive closure at attempt 1 with the real worker; docs (§6.4, §6.5, STORAGE.md §3.6, RUST.md §13) state the final policy and its effect on the codes.
  • C2 pnpm db:sandbox avatar-e2e (approved, port 57800): published on 127.0.0.1 only; an occupied port fails explicitly before anything starts; the suite refuses (fails, never silently passes) any target other than the sandbox gateway and database container; guards of Q1 kept.
  • C3 pnpm e2e:avatar becomes an alias of pnpm db:sandbox avatar-e2e; scripts/avatar-e2e.sh (DEV) removed; avatar tests kept; no missing variable, wrong argument or inherited setting can reach DEV; every reference in scripts, workspace and live docs updated (history kept as history).
  • C4 The sandbox no longer depends on the DEV seed password: the seeded accounts of the sandbox get a per-session random secret (600 file outside Git, never on argv or in logs) after seeding; the sandbox tests use it; supabase/seed.sql and every DEV account and secret untouched.
  • C5 The two tracked misclassifications keep their characterising tests, open, not declared fixed. The four historical test reductions found by the floor guard are recorded with scope and justification; any one hiding a missing security coverage is reported before V1-2.4.
  • C6 Gates: verify-e2e, avatar-e2e, e2e:shell, sandbox test-db / types --check / test, pnpm check:all, worker sandbox tests (seccomp, budgets) on the final code; independent review targeted on the retry policy and command isolation; fresh verifier.
  • C7 V1-2.4 prepared, not started: exact scope from the V1-2 contract plan, for the owner.