147 KiB
TODO — Osteo Report MVP
Actionable
Status (2026-05-21): catalog v2.0 + full 26-zone horse coverage in place — B4 polish + ship gate next
Domain pivot bundle (B0 schema, B1 report v2, B2 UI/PDF, B3 i18n) shipped on
feat/findings-tree-v2. Catalog upgraded v1.2→v2.0 by domain expert: 26 zones
(was 3), 792 nodes, 612 leaves, 41 vet-referral leaves. Zero code change needed
— schema was forward-compat since B0 (BDR-016, LRN-020).
154/154 tests green, lint 0, typecheck clean, vite build OK.
DONE since 2026-05-21 (main +41 commits — the frozen Status block above is the 2026-05-21 snapshot)
Current main @ 4991c10: 174/174 tests green (30 files), lint 0, typecheck clean, vite build OK.
feat/findings-tree-v2 merged (FindingsTreePicker tracked in HEAD); all work below landed on main. No git tags yet (see CHANGELOG version note).
Laterality + bilaterality
- LateralSideSchema (left/right) + Bone.lateral; data-anno-lateral parsed from SVG (
e0abb1e,db50c67) - LateralityPicker modal + zone-click integration; side in zone badges + PDF labels (
20d60b9,5a19ae1,3323d4e,773b002) - Bilateral zones: separate findings picker per side (
c853c68,0c170bd)
Editors
- SVG anatomy editor at /svg-editor — vanilla JS tool wrapped in React (
ea81d8c, BDR-017) - Standalone public/pathology-editor.html JSON tree editor (
9cca51c, BDR-020/021/022) - Tabbed welcome screen with project SVG picker (
2273602) - /editors listing page + footer links + locale-aware zone hover tooltip (
5e24c2f,569e571)
Branding + UI
- Global footer: copyright + "Powered by ZenQuality" + "Paws in Harmony" logo, site + PDF (
caac149,3a67da7,d9cf2fa,33a7f47) - Unified AppHeader (logo brand + tagline) across routes (
1f30280) - Responsive mobile — full phone/tablet adaptation (
a73d8da) - Project renamed Zoosteo → Faunosteo across the codebase (
2d6ed80)
Infra
- Docker: no-cache header for species assets (
53f62f7) - pathology-editor.html prod 404 fixed — served from public/ so it ships to dist (
2803cf7, LRN-029) - gitflow socle + pre-commit hook adopted (
4991c10)
Tour + fixes 2026-07-12 (branch chore/tour-2026-07-12 — UNMERGED, review pending)
- /tour sweep: CVE deps patched (pnpm audit 0), SVG import sanitized, container non-root (BREAKING: PORT >=1024), nginx:1.31-alpine pin, dead code −93 lines (canvg dropped), docs synced. Report: .claude/audits/TOUR.md
- Post-tour fixes: aria-labels i18n (B-1/B-2), EN PDF title prefix (B-4), SvgEditor placeholders (B-5), species labelEn (B-6), draft restore (B-3, TDD), entrypoint escaping (SEC-9), PDF decompression cap (SEC-8, TDD), dead BoneState + 22 unused PNGs (CLN-6/7). 180/180 tests.
SaaS migration (plan: docs/development/IMPLEMENTATION_PLAN.md)
-
Step 0 — preparation docs in docs/development/ (2026-10-08, validated)
-
Step 1 — characterisation tests: 7 files / 91 cases, 2 golden fixtures, docs/development/CHARACTERIZATION_REPORT.md; 271/271, typecheck, lint, build green (2026-10-08, branch feature/step-01-characterisation-tests, awaiting validation)
-
Step 2 — monorepo workspace: apps/app via git mv (144 files), root scripts, Node 24 + pnpm 10.13.1 pins, Dockerfile node:24 + filtered build, CI .gitea/workflows/ci.yml, WORKSPACE.md; 271/271, typecheck, lint, build green from root (2026-10-08, branch feature/step-02-monorepo-workspace, uncommitted, awaiting validation)
-
Step 3 — Supabase foundation (2026-10-08, feature/step-03-supabase-foundation merged into develop
7ea0b1f, USER VALIDATED 2026-10-08; real stack verified: start/reset, pgTAP 81/81, gen types diff, REST script — BLK-006 resolved)- 3.0 context: plan Step 3, BACKEND_ARCHITECTURE §2-§9, business §4.1/§17/§29; Docker socket denied to user → PGlite harness as executable proof, pgTAP kept for
supabase test db - 3.1 supabase/config.toml (CLI pinned as root devDependency) +
supabase/seed.sql(local users only) - 3.2 migration 0001 foundation: schemas private/audit, set_updated_at, audit.audit_logs append-only, private.log_event
- 3.3 migration 0002 profiles: table, auth.users trigger, protected columns trigger, RLS own row (+ staff read), grants
- 3.4 migration 0003 platform roles: enum platform_role (owner/admin/moderator/support), profile_roles, private.is_platform_* helpers, grant/revoke RPC with audit, RLS
- 3.5 pgTAP tests supabase/tests/*.sql (schema, profiles RLS allow+deny, roles allow+deny, audit append-only)
- 3.6 packages/supabase: PGlite harness (auth shim + migrations) + vitest RLS suite (allow+deny), database.types.ts (generator format) + schema↔types consistency test, browser client factory
- 3.7 app integration: env.ts supabaseUrl/anonKey, lib/supabase.ts lazy client (null when unconfigured), entrypoint.sh + .env.example + compose; no UI change; tests
- 3.8 CI: supabase job (start, db reset, test db, gen types diff); check job runs PGlite suite via pnpm -r
- 3.9 docs: docs/development/SUPABASE.md (start/reset/test/types/bootstrap owner), CLAUDE.md folder map + scopes, README pointer
- 3.10 verify: typecheck, test:run 278 app + 13 supabase (81 pgTAP), lint 0, build OK; BDR-026..029, LRN-035/036, BLK-006, EVAL-006
- 3.0 context: plan Step 3, BACKEND_ARCHITECTURE §2-§9, business §4.1/§17/§29; Docker socket denied to user → PGlite harness as executable proof, pgTAP kept for
-
Step 4 — canonical anatomical sheet model (2026-10-08, feature/step-04-anatomical-sheet-model merged into develop, USER VALIDATED 2026-10-09; 7 business decisions → BDR-033, spec §5). Scope re-split: model + validation + persistence + tests here; legacy importer → official equine DRAFT + import report = next step (user: no full import yet, draft verified before publication). Spec: docs/development/ANATOMICAL_SHEET_MODEL.md
- 4.0 context + spec: business §2.6–2.9/§7/§16/§17.3/§23, OPEN_QUESTIONS C1/C2/C8/C9/Q3/Q5/Q9, audit 07; ANATOMICAL_SHEET_MODEL.md written
- 4.1 packages/domain: AnatomicalSheetDocumentSchema (strict, localized {fr,en}, views tree, annotations union, finding tree with category kind), validateSheetDocument (integrity issues), assertPublishable, createEmptySheetDocument; fixture horse-slice; tests per rule + id-stability
- 4.2 migration 20261008110000_anatomical_sheets: species (seed equine), enums, sheets/versions/assets, triggers (one draft, published immutable, delete preconditions, species match), helpers can_edit/can_use_sheet, sheet_document_issues, lifecycle RPCs (create/draft/publish/deprecate/delete/fork/archive/restore/delete sheet/register asset), privileges + RLS
- 4.3 pgTAP 005_anatomical_sheets.sql: schema/privileges, lifecycle allowed path, immutability, fork provenance, deletion preconditions, denied paths (other user, anon, direct writes, official), invalid document refused at publish
- 4.4 packages/supabase: database.types.ts regenerated (real stack), schema-types test extended (tables, enums list, functions); index.ts row aliases; publishSheetVersion service (domain validation before RPC) + test
- 4.5 docs: SUPABASE.md layout/tests, CLAUDE.md folder map + conventions + scopes, packages/README, IMPLEMENTATION_PLAN Step 4 adjustment note, CHANGELOG
- 4.6 verify: pnpm check green (61+17+278), db:reset + db:test 210/210 real stack, types in sync; verifier ECARTS(5) + security BLOCK(1) → all fixed (BLK-007 hardening migration, visibility RPC, +32 pgTAP, doc sync); BDR-030..032, LRN-038..040, EVAL-008
-
Step 4b — equine import (2026-10-09, branch feature/step-04b-equine-import): legacy SVGs + catalog → official equine sheet as DRAFT, import report for business review, no publication
- 4b.0 kind rename observation→consultation_reason (BDR-033 #5); decisions in spec §5 + memory
- 4b.1 packages/anatomy: legacy importer (SVG walker via @xmldom/xmldom, catalog mapper, deterministic ids, legacy-id-map, import report with anomalies incl. ssb-dysfunctions), CLI
pnpm import:equinewriting supabase/seed/anatomical-sheets/equine/v1/{document.json,legacy-id-map.json,IMPORT-REPORT.md,assets/,equine_v1.sql}; tests: counts preserved (27 ann / 26 mapped / 792 nodes / 612 leaves / 41 vet), determinism, Zod + 0 integrity errors, golden artifacts - 4b.2 migration 20261009100000 sheet asset storage: bucket anatomical-sheet-assets (private), object read policy through the sheet (published refs or editor), no API writes; shim storage tables; pgTAP
- 4b.3 seed: equine_v1.sql idempotent (platform-owned official sheet, private, draft v1, 2 asset rows, fixed ids) in config sql_paths + PGlite harness applies supabase/seed/**; pgTAP 006: draft present, not publishable by non-admin, sheet_document_issues empty, assets match; upload script for the SVG bytes (service key from env, user/operator runs)
- 4b.4 real stack: db reset + db test + types check + assets upload + REST read check; docs (SUPABASE.md, ANATOMICAL_SHEET_MODEL.md §6 import, CLAUDE.md, plan note, CHANGELOG)
- 4b.5 verify: pnpm check green (61+30+20+278), real stack 256/256, types in sync, docker build OK, Storage API 400→200 after confirmation (alice/anon 400); verifier ECARTS(4) + security MEDIUM (hash claim) → fixed (uploaded_at + confirm RPC, authored labels, seeds-listed test, Dockerfile manifests); EVAL-009
-
Step 4b VALIDATED by user 2026-10-09 → finished into develop. Draft stays private, never auto-published.
-
Step 4c VALIDATED by user 2026-10-10 → finished into develop; draft stays private, never auto-published — equine sheet audit, correction, enrichment (2026-10-09, branch feature/step-04c-equine-curation). User brief: research-backed audit of SVG annotations + findings catalog, corrections by confidence level (A demonstrated / B supported, flagged / C uncertain, question for the osteopath), traceable changeset (id, before, after, nature, rationale, references, level, needs confirmation), reproducible baseline of the 4b import, no publication, no design redesign (propose first).
- 4c.0 Docker naming convention
faunosteo_(compose container/project names; Supabase CLI names fixedsupabase_<svc>_<project_id>→ documented limit). Docs + memory (BDR). - 4c.1 domain schema v2: document
referencesregistry + nodereference_ids,review_statuson nodes and annotations,count_rangeon vertebral regions; rulesfinding.reference.missing,region.count_range.invalid; tests; migration extending the schema CHECK + SQL issues; types regen; pgTAP. - 4c.2 packages/anatomy curation layer: changeset schema (Zod, JSON data), applier (set / rename / add / remove / move / cite / annotation ops), before-values captured by the applier, CHANGELOG + REVIEW-REPORT generators, diff v1 → draft; seed dir restructure:
legacy-import/(baseline, generated) +draft/(curated working revision, seeded); cleaned SVG asset (legacy markers stripped), head view = view_box crop of the single asset. - 4c.3 research (parallel agents, WebSearch): axial skeleton + vertebral variation; skull/sutures/SBS/TMJ/hyoid; appendicular nomenclature NAV/Barone; osteopathic terminology + French legal scope + vet red flags; catalog analyzer pass. Output: findings with verifiable references, classified A/B/C.
- 4c.4 content changes: sphenoid zone restructured (SSB tree duplicated under sphenoid), terminology (lésion → dysfonction, NAV names, FR grammar), 62 EN descriptions + EN disclaimer, vet flags audit, references registry + citations, additions (carpus…), SVG point moves (B, before/after renders), Cd range 15–21.
- 4c.5 reports: REVIEW-REPORT.md for the osteopath (10 sections, questions ranked), CHANGELOG table, before/after review SVGs (draft/review/, PNG renders by operator), quantitative before/after.
- 4c follow-up (open, not blocking Step 5): 11 questions for the osteopath (draft/REVIEW-REPORT.md §10) → next changeset; legal scope text to re-read on consolidated Légifrance articles before publication; BLK-008 data migration v1→v2 before real data; user action
.env.exampleCOMPOSE_PROJECT_NAME=faunosteo (DEPLOY.md) - 4c.6 verify (root check 68+21+100+278, PGlite + real stack 267/267, types, docker build, Storage e2e; verifier ×3 → fixes, security PASS; EVAL-010): pnpm check, PGlite + real stack pgTAP, types, docker build, golden tests; gates verifier + security; docs (spec §6/§7, SUPABASE.md, CLAUDE.md, plan Step 4c, CHANGELOG); memory (BDR/LRN/EVAL/journal). Stop for user validation.
- 4c.0 Docker naming convention
-
Step 5 — application on the canonical sheet (analysis validated 2026-10-10; implemented on feature/step-05-app-on-canonical-sheet; USER VALIDATED 2026-10-10, all paths OK; finished into develop 2026-10-10; D5 orphan findings documented as UX follow-up)
- 5.0 freeze: golden v2 PDFs + expected v3 docs; CHARACTERIZATION_REPORT refreshed
- 5.1 pipeline: report-migration-map.json (annotations, views, findingPaths 442/136/≤34), app-main.svg + app-head.svg review renders, category colours changeset (D1)
- 5.2 packages/domain: Report v3 (annotationId+viewId, free region codes, severity codes D8, sheet ref, unresolved findings, localAnnotations []), migrateReportV2ToV3, tests on fixtures + 612 leaves
- 5.3 app foundation: bundledSheetProvider (Vite alias @sheets), sheetIndex, sanitiser, renderAnnotationLayer (legacy look), AnatomyCanvas/DetailModal on views (head = crop)
- 5.4 zoneInteraction service + reducers, store split + sessionStoragePersistence (v2 migration on load), pickers/cards on sheetIndex (D6 ranges, D7 title), EditorRoute < 300 lines
- 5.5 PDF shim + attachment v3 + v2 import (gate D3)
- 5.6 delete legacy (registry, species/*, zoneMatch, spineZones, svgConvention, D4 tools), SVG convention doc replaced, CLAUDE.md map, CHANGELOG, plan note, memory
- 5.7 visual before/after (cmp renders), root check + docker + real stack green; verifier ×3 (gaps closed), security PASS (LOW fixed); EVAL-011. Manual FR/EN flow = user validation
- 5.8 per-leaf migration (user ask 2026-10-10, during manual validation): every legacy leaf (612 = 442 identical, 141 moved, 29 removed) as a v2 finding → migrated → resolved to a draft leaf (anatomy, map file) and through sheetIndex.nodeAt + PDF roundtrip (app); the 27 legacy annotations as zones on their views
- 5.9 archive check tool
pnpm report:compare <pdf|dir>...: v2 attachment vs migrated v3 side by side, unresolved flagged (removed vs unknown),--fullopt-in for names/free text, control chars escaped, --diff of two PDFs, --summary; attachment.ts split read/parse (additive, D3); docs PDF-FORMAT/CLAUDE/README - 5.10 final controls on the last lot: stale root script scaffold:species removed; verifier ×3 (2→1→CONFORME) + security ×2 PASS on criteria 16-18; EVAL-012
- 5.11 user validation defect: findings picker text blurry on screen → permanent
will-changeon the list dropped (hotfix1f0b710, regression test); PDF never affected - 5.12 follow-up (not Step 5): equine sheet anatomical enrichment with the osteopath + future sheet editor (Step 17); the 28 draft annotations (carpus added, points moved) are NOT a final catalog
-
Step 6 — autonomous PDF archives (analysis validated by user 2026-10-11 with D7 branding archived, D8 snapshot kept + explicit rebase, D13 messages → Part II contract + BDR-039; implementation on feature/step-06-pdf-archives, one executor per phase)
- 6.0 analysis: 3 analyzers (pipeline, model, app/tests) + size measurements (envelope 172 KB raw / 51 KB stored for 3 obs, 228 / 54 worst case) + 3 plan-challengers → plan rewritten
- 6.1 Phase 0 freeze (
8b86b92: 39 goldens, demo fixture, bare v3 PDF, T12/T13; 206 app tests) with current code: demo report fixture, migrated-v2-with-unresolved builder, G3 bare v3 PDF, G1 text goldens (logos absent + present), G2 structural facts/placements/links, T12 HomeRoute + T13 EditorRoute characterisation - 6.2 Phase 1 domain (
cdc0943: 154 domain tests, snapshot 171 KB raw on the fixture): sheet-index moved, archive/snapshot (buildSheetSnapshot, assertSnapshot, caps), archive/envelope (schema v1, layered readArchiveDocument, SnapshotRejection), report/rebase (rebaseReportOnSheet), bundle carries asset sha + status/name, tests - 6.3 Phase 2 anatomy (
6940926: composeViewSvg + highlightLayer, 130 anatomy tests): render/compose.ts promoted from curation/app-review.ts, highlight on the layer tree, review drawing golden unchanged - 6.4 Phase 3 packages/pdf (
c179560: 53 engine tests, 36 goldens exact, resvg raster, demo envelope 55 KB / 136 KB stored): scaffold (no DOM lib, restricted globals, vitest node, Dockerfile, CI, README), svg/sanitize allowlist + horse.svg zero-removal, render moved, Branding/Rasterizer/exportedAt/safeText/dict, exportReportArchive (T3 both logo modes), readReportArchive (filename-first, layered, attachment_stripped; T4-T6, T8), T1/T7/T9/T10 resvg/T11, xmldom bundle size ≤ 50 KB gz - 6.5 Phase 4 app (
9bd5173: 222 app tests, archive kept in session, rebase + alerts, legacy PDF modules removed, xmldom ≈ 31 KB gz in the main chunk): browserRasterizer, branding.ts, export/import on the engine, rebase on import + draft restore, 2 new messages, old render/attachment/highlight code + pdf.* keys removed, report:compare on engine API, T2/T14/T15, suite migrated 1:1 - 6.6 Phase 5 docs + gates (docs synced; verifier ECARTS(31 oracle/scope) → CONFORME 13/13; security BLOCK(1) → 4 fix loops → PASS; 656 tests, build, docker ×4 green)
- 6.8 user manual tests round 1 (2026-10-11): logos and picker text confirmed OK by the user after branding bundled (
293a6e0) and the investigation; restore-rebase alert (e8f1734); STEP 6 VALIDATED BY USER 2026-10-11 - 6.9 closure decisions (BDR-040): re-export-archive button REFUSED for good; import headlines full/partial (
62b8a43); BLK-009 byte-scan reader + no object streams (60ee712), fresh security audit + verifier; gate before external users kept in PDF_IMPORT_HARDENING.md §5 - 6.10 finish into develop, release/0.2.0 prepped (Milestone A) — tag/merge to main on the user's go; Step 7 NOT started (UX/design discussion first)
- 6.7 follow-ups recorded for Step 13: catalog asset cap aligned with the archive cap (2 MiB), allowlist sanitiser at upload, app canvas sanitiser (EVAL-011)
- 5 follow-up: allowlist SVG sanitiser before Storage-served assets (Step 13); orphan findings UX (D5) at the report UX step; report:compare residuals (ZodError reason genericised, v3 lines computed once, long template lines); 16 MiB attachment cap without direct test
-
Step 7 — identity: auth, profile, roles, /app shell (started 2026-10-11, branch feature/step-07-identity-app-shell; USER VALIDATED 2026-10-12, all screens and flows OK, no UI correction; mockups now versioned at docs/design/faunosteo-etape7-maquettes-validees.png; finished into develop). Scope decisions: professional fields = additive migration on profiles (practice_name, professional_title, siret free text, verification = later domain); MFA = documented gap (TOTP disabled in config, no has_mfa helper, no admin table); no TanStack Query (zustand store suffices); legacy routes untouched and unauthenticated; /app visible from Home only when Supabase is configured
- 7.0 plan + branch + ctx7 cache (supabase-js auth, config.toml providers)
- 7.1 config: appConfig.authProviders (APP_AUTH_PROVIDERS / VITE_AUTH_PROVIDERS, google|apple), entrypoint + env.example + DEPLOY table; config.toml: TOTP enroll/verify on, [auth.external.google|apple] via env(), redirect URLs; packages/supabase: auth service wrappers (typed errors), profile read/update service
- 7.2 migration 20261011100000_profiles_professional: practice_name, professional_title, siret (+ CHECKs, column grants); pgTAP 009; database.types regenerated (real stack) + schema-types map
- 7.3 app state: authStore (status loading|signed_out|signed_in, session, user, profile, roles), bootstrap on getSession + onAuthStateChange, profile fetch, roles fetch; locale sync (profile.locale → localeStore on sign-in, localeStore → profiles.locale while signed in); AuthProvider in App
- 7.4 auth screens: /login (email+password, OAuth buttons per authProviders, links), /signup (display name, email, password ×2, policy hints, "check your inbox" state), /forgot-password, /reset-password (PASSWORD_RECOVERY → new password), /auth/callback (code exchange → /app); AuthLayout (brand, cream card); not-configured state
- 7.5 /app shell: RequireAuth guard (redirect /login?next=), AppLayout (desktop sidebar: dashboard, account, local tool link, logout; mobile top bar + drawer), /app dashboard (welcome, profile completeness card, local tool card, no fake stats)
- 7.6 /app/account: personal (display, first, last, phone), professional (title, practice, siret), preferences (locale, timezone), security (change password, logout, MFA gap note), roles badge read-only
- 7.7 Home coexistence: "Mon espace / Se connecter" entry on the header when configured; characterisation tests T12 unchanged with default config
- 7.8 tests: config, authStore (fake client), locale sync, forms, guards, shell, dashboard, account; i18n parity; pgTAP 009 (PGlite + real stack 280/280); root check + docker build green; headless e2e vs local stack 20/20 (signup via Mailpit, recovery, logout, mobile)
- 7.9 docs (IDENTITY.md, SUPABASE.md, CLAUDE.md, CHANGELOG, plan note); memory BDR-041, LRN-047, EVAL-015, journal; gates: verifier ECARTS(2) → open-redirect fix + contract CHECK → CONFORME 16/16; security PASS (MEDIUM fixed, 3 LOW closed, TOTP enforcement = documented gap). User validated 2026-10-12; user action still open:
.env.example+=APP_AUTH_PROVIDERS=(file edit denied here) - 7.10 follow-ups kept by the user (2026-10-12), each owned by a later step: MFA mandatory before any sensitive admin feature (has_mfa helper + enrolment UI, IDENTITY.md §4; first admin screen); professional verification distinct from the SIRET format check (Step 9, BDR-072); real tests of Google and Apple once the provider ids exist (config.toml env(), APP_AUTH_PROVIDERS); integration of the report tool into the signed-in /app space (Step 14 gating); mockup elements not built yet listed in docs/design/README.md (bell, avatar photo → Step 8, stat tiles, tabs, mobile tab bar)
-
Step 8 = Rust R1 — files foundation + Supabase Storage + avatar (GO 2026-10-13: R0 validated, D1–D9 validated with D1 = Rust worker, D3 = top-bar avatar + name linking to Mon compte; branch feature/step-08-files-foundation, cut from the R0 tip because
gitflow finishof R0 was refused by the harness classifier: the owner runs it). Analysis: docs/development/STEP8_FILES_ANALYSIS.md; contract-level spec written first in docs/development/STORAGE.md. Out: SVG upload (Step 13), other buckets' flows, PDF/anatomy ports, webhooks, CI/CD, VPS deploy, release 0.2.0- 8.0 analysis: facts (existing bucket + policy pattern, sanitiser, edge runtime off, CSP, deploy), design (assets table authority, server-built keys, quarantine prefix, worker
faunosteo_workerwith sharp + pdf sanitiser, storage.objects policies through assets, Storage API signing under RLS, sweeper/reconcile, backups file volume + restic, managed migration by rows), 10 security answers, scope, tests, risks, D1–D8 - 8.1 migration 20261013100000_files_foundation:
asset_status,assets(lease token added for stale-task refusal), 7 buckets (avatars open: 5 MiB, jpeg/png/webp; 6 closed; sheet bucket untouched),private.can_read_avatar_object/can_upload_avatar_object, storage.objects SELECT + INSERT policies,private.object_purge_queue+ status/delete triggers (48 h final key of a deleted row, 1 h quarantine and rejected),private.storage_ceiling(), RPCs begin_avatar_upload / confirm_asset_upload / remove_avatar (authenticated), claim_avatar_jobs / complete_avatar_job / reject_avatar_job / mark_quarantine_purged / claim_purges / ack_purge / claim_quarantine_leftovers / expire_pending_uploads (service_role), closed error messages (P0001), explicit revokes, column grants - 8.2 pgTAP 010: allowed + denied twins for every RPC and policy, the 8 scenarios of the owner's brief (cross-user read, cross-user replace/delete, anon, quarantine never readable, final key never uploadable, superseded/removed row never completes, stale lease refused, late bytes inert), purge queue contents and grace, policy census (one bucket literal per policy, 2/1/0 per bucket, total pinned), audit rows; 001 census += the two predicates; shim adjustments if needed; real stack
db:reset+db:test;db:types+ schema-types map - 8.3 crates/worker R1 (fork A):
config(env, no secret printed),log(JSON lines, field allowlist, child stderr escaped and truncated),backendtrait +http(ureq 3, rustls + ring, PostgREST rpc + Storage object endpoints, 30 s timeouts, 5 MiB download cap, strict key validation before any URL),decodertrait overSpawner,job(claim → download → decode → PUT clean → complete → DELETE quarantine → mark purged; refusals → reject;Broken→ alert + stop; complete refused → nothing deleted, the queue owns the object),sweep(claim_purges/ack, quarantine leftovers, expire pending),watchdog(per-stage deadlines, exit on overrun),runloop +run --check; unit tests on a fake backend + fake decoder; seccomp derivation re-run (the parent gained TLS/HTTP code, the child must stay at the traced set); JWT exp logged at start - 8.4 packages/supabase
assets.ts(fork B): beginAvatarUpload, uploadToQuarantine, confirmAssetUpload, removeAvatar, fetchOwnAvatarState, downloadAvatar, closedAssetFailurekinds (P0001 messages → kinds; storage errors → network/unknown); tests on a stub client - 8.5 app (fork B):
account/avatarTransport.ts(magic-byte sniff jpeg/png/webp, never SVG, createImageBitmap → canvas ≤ 1024 → JPEG 0.9, ≤ 5 MiB after transport),AvatarSectionin Mon compte (circle photo/monogram, Modifier la photo, preview + Enregistrer/Annuler, processing with 1 s polling ≤ 30 s, rejection message per code, Supprimer with Dialog confirmation, in-flight row on mount), authStoreavatarUrlblob (download under RLS, revoked on change/sign-out),UserBadgephoto, top bar avatar + name → /app/account (D3), i18n FR/EN parity, component + store tests,impeccable detect - 8.6 integration: docker-compose
workerservice under profileworker(read-only, cap_drop ALL, no-new-privileges, mem 512m, cpus 1, pids 64, external Supabase network),.env.workervariables documented (file not editable here), real-stack e2epnpm --filter @faunosteo/supabase test:e2e(worker container against the local stack: Alice flow clean + download 200, replace, remove, Bob 400, anon 400, quarantine 400, late signed-upload bytes swept, purge after grace via clock shift) - 8.7 docs: STORAGE.md final (model, keys, statuses, worker operations, purge/grace, reconciliation query, backup ordering + invariant, managed migration runbook), DEPLOY.md (worker service, env file, network, CSP connect-src), SUPABASE.md (worker in dev, buckets), RUST.md §3 (R1 loop), WORKSPACE.md, TEST_STRATEGY.md, IDENTITY.md §5 avatar steps, docs/design/README.md (avatar built), CLAUDE.md, CHANGELOG; CI yml untouched beyond a comment (no runner)
- 8.8 verify:
pnpm check:all×4, PGlite + real stack pgTAP (140 / 420), types unchanged, worker image + sandbox tests, e2e ×7, Chromium smoke 18/18, verifier CONFORME (pass 2), security PASS after 5 passes (BLOCK on my ceiling join fixed: bytes-present ceiling + 64 MiB per-account budget); BDR-048, LRN-051, EVAL-019, journal. OPEN: owner manual validation; owner runsgitflow finishfor feature/rust-r0-foundation then, after validation, for this branch;.env.workerto create by hand (DEPLOY.md); residual LOWs documented in STORAGE.md §2.1 (colluding-account ceiling fill, search-domain on native glibc runs, ceiling race) - 8.9 owner validation 2026-10-13: 10/10 manual + graphic → R0 (
5cfb6f1) and R1 (f5865f0) finished into develop; identity + environments + LAN rule → BDR-049
- 8.0 analysis: facts (existing bucket + policy pattern, sanitiser, edge runtime off, CSP, deploy), design (assets table authority, server-built keys, quarantine prefix, worker
-
chore/dev-lan-access (2026-10-13, owner validated computer + phone, merged): DEV origin centralised (
scripts/dev-env.sh,pnpm supabasewrapper,pnpm devon the LAN, config.toml env()), ENVIRONMENTS.md; automated 26/26 at http://192.168.1.100 (computer + phone viewports, URL audit); UFW rules applied by the owner, refusals verified from another device (54322/54323/54324 closed, 54321 open); Mailpit via gateway :54325 (basic auth); 10-step path validated by the owner on computer and phone -
Rust by default (rule adopted 2026-10-12, BDR-043; orientation + 10 principles VALIDATED by the owner 2026-10-12, BDR-044; study
docs/development/RUST_ARCHITECTURE_REVIEW.mdrev 2 + Annex A decision table + Annex B R0 scope on chore/step-08-files-analysis; AWAITING the owner's validation of decisions D-R1..D-R14 (D-R6 withdrawn); R0 and Step 8 NOT started until then). Roadmap (each phase: oracles frozen with the old code, consumer-driven deletion, rollback row, gates):- R0 foundation (GO 2026-10-12, BDR-045; branch feature/rust-r0-foundation; Annex B; owner constraints: builds reproducible in Docker, no Rust on the VPS, live deployment untouched, frontend never loads the module, no R1):
- R0.1 toolchain:
docker/rust-builder.Dockerfile(rust:1.99.0-bookworm + wasm target + wasm-bindgen-cli 0.2.129 + cargo-deny 0.20.2 + rustfmt/clippy),docker/rust-run.sh(named volumes faunosteo_cargo_registry / faunosteo_rust_target),docker/rust-check.sh,docker/wasm-build.sh(CLI/crate version lock), root scripts rust:builder / rust:check / wasm:build / worker:test / worker:image - R0.2 workspace: Cargo.toml (3 members, pinned deps, lints unwrap/expect/disallowed_methods, dev deps optimised), rust-toolchain.toml 1.99.0, rustfmt/clippy/deny config, .cargo/config.toml (wasm stack 1 MiB, TS_RS_EXPORT_DIR), Cargo.lock, .gitignore/.dockerignore (target, pkg)
- R0.3 crates/core: js_number + JsPrettyFormatter (JSON.stringify semantics), report contract types (SheetRef, ReportZone, Vertebra, LateralSide, Unresolved) with optional-absent / nullable-null, facade
call(op, json)with closed kinds; 12 cargo tests + ts-rs export (4 types committed under packages/core-wasm/types) - R0.4 crates/wasm: facade (core_version, call, panic_for_test, recurse_for_test); build 224,713 B raw / 85 KB gzip (float_roundtrip on), instantiate ≈ 3 ms in Node
- R0.5 crates/worker: plain main,
decodechild (env check → rlimits AS 512 MiB / CPU 10 s soft, 12 s hard → seccomp allowlist TSYNC kill) → image decode with Limits → orientation → resize_to_fill 512 → libwebp-sys lossy; parentSpawner(env_clear, 512 KiB output cap, deadline, signal classification) +webp_check(RIFF allowlist, dims, no metadata);run --check,version; test-hooks (fixtures, violate, flood, alloc, spin, print-allowlist); Dockerfile alpine musl → test stage (sandbox tests + strace derivation) → distroless/static:nonroot - R0.6 packages/core-wasm: loader (lazy, Node bytes), generated types, vitest proofs (facade, serialisation byte-equal with JSON.stringify on 4 real documents + number cases + Zod readers, panic/stack traps, size budget) skipped with a notice when pkg/ is absent
- R0.7 proofs recorded with numbers in RUST.md §5: panic=abort traps + stack-trap instance unusable + fresh instance via cache-busting import; serde_json
float_roundtripfinding (byte parity on 4 real documents + number corpus, Zod readers); musl static + libwebp 1.6.0 (image 8.7 MB, read-only, caps dropped); seccomp allowlist derived by strace on the release binary = 7 syscalls + 7 abort path, 13/13 sandbox tests; CSP: refused withscript-src 'self', OK with'wasm-unsafe-eval'(Chrome 156, nginx 1.31,docker/csp-proof/); wasm 224,713 B raw / 85 KB gzip / ≈ 3 ms; runner cache NOT measurable here (pending on the forge, §5.7) - R0.8 CI: job
rust(builder image, fmt/clippy/test/deny, types drift, wasm build),checkbuilds the wasm then runs the Node pipeline,dockerbuilds the worker test stage + runtime started read-only/cap-drop, nightly advisories, manualrelease-imageshardened after the security audit (typed input via env, advisories gate, ephemeral buildx builder, env secrets + per-job DOCKER_CONFIG + logout, main/develop only, pinned checkout; no deploy) - R0.9 docs: RUST.md, DEPLOY.md (prepared digest deploy + CSP note, live procedure untouched), WORKSPACE.md, packages/README.md, CLAUDE.md (stack, map, commands, workflow), TEST_STRATEGY.md, CHANGELOG
- R0 follow-ups from the security audits (R1 unless stated): base images and the buildkit engine image by digest (Step 27); verification decode of the child's output in a second sandboxed child; R1 treats Signalled/Timeout/OutputOverflow as rejections (content never alerts) and logs the child's stderr escaped only; negative tests for tkill(self, SIGTERM) and tgkill; iCCP fixture with image data so the allocation budget is seen firing; WebP structure residuals (duplicate ALPH, ALPH + VP8L, VP8X flags); dedicated release runner label that never runs PR jobs (Step 27);
actions/*@v4in ci.yml pinned by commit (Step 27); drop--features proofsfrom docker/wasm-build.sh at R2 - R0.10 gates: root
pnpm check777 tests green (existing suites untouched); verifier ×3 (CONFORME in substance, oracle fixes only); security ×3 (HIGH shell injection + 6 MEDIUM fixed; 3 MEDIUM introduced by the first fixes fixed; 2 MEDIUM of pass 3 fixed by the secret-less gates job); memory BDR-046, LRN-049, EVAL-017, journal. STOPPED for owner validation (2026-10-13); R1 not started - R0 owner points: review the worker's SAFETY comments (rewritten 2026-10-13 as technical invariants, the
[gated]approval-looking markers removed); decide the registry (forge Gitea registry recommended) and set REGISTRY/REGISTRY_USER/REGISTRY_TOKEN secrets before the firstrelease-imagesrun; first run on the forge records the runner numbers (RUST.md §5.7) and validates the workflow syntax (job-level env, GITHUB_ENV path) - R0.11 native toolchain correction (owner brief 2026-10-13, delivered 2026-10-13, awaiting the owner's final validation: Ubuntu dev server native Rust, Docker for services/isolation/images, VPS separate, no CI active):
- R0.11.1 host audit: rustup 1.29.1 already user-level (~/.cargo, ~/.rustup), 1.99.0 auto-installed from rust-toolchain.toml, gcc/libc6-dev/pkg-config/libssl-dev/strace present, no sudo, no package needed
- R0.11.2 install (user-level,
--locked, 100 s, registry cache warm): wasm32-unknown-unknown on 1.99.0, wasm-bindgen-cli 0.2.129, cargo-deny 0.20.2 - R0.11.3 scripts:
scripts/rust-check.sh+scripts/wasm-build.sh(moved from docker/, PATH guardscripts/rust-env.sh),scripts/check-all.shpre-merge gate; rootrust:check/wasm:buildnative,rust:check:docker/wasm:build:dockerthrough the builder,check:all; worker unit tests in the native check (sandbox tests stay feature-gated in Docker) - R0.11.4 worker: SAFETY comments rewritten as verifiable technical invariants (no
[gated]approval marker), stride with checked arithmetic - R0.11.5 CI files kept, header states prepared / never executed (no runner, no secrets), script paths updated
- R0.11.6 verification (native rust-check 32 s warm, cold workspace build 31.5 s; wasm 224 777 B native vs 224 713 B builder, path strings; 14 proofs;
pnpm check:all1 min 59 s green: 777 Node tests, 16 sandbox tests, allowlist covers the trace, worker read-only run --check): native versions; cargo fmt/clippy/test/build/deny; wasm native + core-wasm proofs; Docker builder, docker check, docker wasm, worker:test, worker:image run --check, app image;pnpm check; numbers compared with R0 (RUST.md §5) - R0.11.7 docs: RUST.md §1/§4/§6, CLAUDE.md, README verifying, DEPLOY.md, WORKSPACE.md, TEST_STRATEGY.md, CHANGELOG, review Annex C addendum
- R0.11.8 gates: verifier ECARTS(2 doc prose) → CONFORME 11/11; security PASS ×2 (1 MEDIUM + 6 LOW then 1 MEDIUM + 2 LOW, fixed: advisories warn-only stage, fail-closed porcelain drift gate with --untracked-files=all, PATH guard append/absolute, literal rm, prctl c_ulong args); BDR-047, LRN-050, EVAL-018, journal
- R0.11 follow-ups for the CI/CD step (owner): ci.yml push/PR triggers stay live, so registering a runner starts PR builds at once (keep, or switch to workflow_dispatch until then);
actions/*@v4mutable tags (Step 27); advisories cadence while no nightly runs (cargo deny check advisoriesis warn-only in check:all);--remap-path-prefixif native and builder wasm must match byte for byte
- R0.1 toolchain:
- R1 = Step 8 worker in Rust (delivered 2026-10-13 on feature/step-08-files-foundation, see Step 8 block; awaiting owner validation): decode child dispatched before any thread, empty env, RLIMIT_AS/CPU, traced seccomp allowlist,
image+moxcms+libwebp-sysin the child, parent RIFF-header check only, 512 KiB output cap, per-stage deadlines, service key - R2 domain core (before Step 9; OWNER VALIDATED 10/10 2026-10-14, L1 closed, merged into develop
c3f28d8, worktrees cleaned): sheet/report/archive contracts,SheetHandle+SheetIndexData, reducers, Finding builder, vertebra selection, publish gate; wasm facade (JSON strings, ts-rs types, poison + reinstantiate, lazy init); app switched; 3 envelopes frozen first; N-1 reader test; draft quarantine; conformance fixtures + generated pgTAP;packages/domainfrozen for engine/pipeline- plan + contract:
.claude/tasks/plans/2026-10-13-rust-r2-domain-core.md(rev 2 after 3 challenges, 45 findings folded); branchfeature/rust-r2-domain-core; owner wording of the 4 new strings validated 2026-10-13 - R2.0 freeze: 3 archive envelopes (demo, v2full, v2unresolved; FR, no logos, fixed time) + verbatim N-1 Zod copy (
packages/core-wasm/tests/n-1) (3114d67); Zod output oracles of the reference documents (crates/core/tests/oracles) - R2.0b characterisation frozen from the TS: 84 report/archive cases + 765 Zod verdicts (fork B), 49 editor cases (fork C), 26 conformance fixtures (fork A), horse-slice JSON
- R2.1 Rust contracts (
ee07008): byte-equal to Zod output on draft + legacy sheets, demo report; the 3 frozen envelopes round-trip byte-equal - R2.2 Rust rules (
0c47d0f,21906c4): integrity rules, check, create, index data, read/migrate (612 leaves), rebase, snapshot, layered read, session restore/import; pgTAP 011 generated (PGlite 12/12, real 446/446) - R2.3 editor rules (
3639c87) + facade ops (6c0533c) - R2.4 runtime (
343d6f4): lazy, poison, offline recovery, per-generation handles, cap 3, retry, pkg/pkg-proofs, BUILD_STAMP; browser-checked dev + build; measurements (794dfd9) - R2.5 app switch (
74fcb37) + publish gate fail-closed (6891f9e); app 313/313 on the real core (fork D adapted 17 files, 24 new tests, found 2 src bugs fixed) - R2.6 image + serving (
7be94d4): wasm stage, gzip_static 372 KB served, CSP proof on the image 15/15 (Chromium only; no Firefox/WebKit build here), check:all green 2 min 17 s - R2.7 docs (
8e8c58e: RUST.md §8, CLAUDE.md, WORKSPACE, TEST_STRATEGY, packages/README, DEPLOY, CHANGELOG), verifier 12/12 + floor ECARTS(2) (deleted tests, owner micro-gate), security PASS ×2 (follow-upse49009e), memory BDR-050 LRN-054 BLK-010 EVAL-020; STOP (no merge) - R2 owner points (2026-10-14): manual LAN validation 10/10 + graphics accepted; L1 decided (refusal + quarantine, BDR-051); 2 deleted test files approved (coverage proven); worktree cleanup authorised after checks; merge go after L1
- R2 closure (owner brief 2026-10-14)
- L1.1 core:
parse_jsonnever rewrites; refusal classified (JsonReadError::LoneSurrogate, strict hex scan, on failure only); kindlone_surrogatefrom parse_input, sheet.check, draft.restore, archive.import (20d03cf) - L1.2 app: quarantine on
lone_surrogate,ImportError('lone_surrogate')+home.import.error_lone_surrogateFR/EN (detailed wording), publish gate →invalid_shape(da8a037); deadisCoreBuiltremoved (5020954) - L1.3 tests: js scanner/parse, session draft/archive/import + normal text, facade kind, characterisation L1 + Zod verdict = explicit refusal (oracles untouched, loader spells escapes out), store quarantine verbatim, editor action refused report unchanged, import kind, real-module call, gate
- L1.4 checks: rust:check, stale-module refusal shown, wasm:build, Node 915, PGlite 12 files, real stack 446/446, types no drift, check:all green; verifier CONFORME 13/13, security PASS (6 LOW)
- L1.5 docs (RUST.md 8.6/8.7, PDF-FORMAT, CHANGELOG) + memory BDR-051, LRN-055, EVAL-021, journal
- L1.1 core:
- R2 follow-ups: Firefox/WebKit CSP run (no browser build here; owner's manual LAN run covers its browsers), import in a Web Worker + PDF import hardening gate (R4, PDF_IMPORT_HARDENING.md §5), React error boundary (not decided), base images by digest (Step 27), wording of the storage-full degraded notice, CSP refuses the footer's external credit logo (RUST.md 8.8), no CI/CD runner on the forge (workflows prepared, never executed), rustls 0.23.45 advisories RUSTSEC-2026-0346/0347/0348 (worker; not applicable: no brotli, built-in session cache, no ECH) →
cargo update -p rustls≥ 0.23.46 + worker:test + e2e:avatar, unreadable session archive under full storage removed by a later reset (security LOW, decision needed),supabase/.temp/cli-latesttracked by mistake (untrack + ignore), wasm-bindgen boundary invariant (JSON.stringify callers only, RUST.md 8.7)
- plan + contract:
- R2 maintenance (owner brief 2026-10-14, branch bugfix/r2-maintenance, merged into develop after gates; owner authorised the merge in the brief)
- A rustls 0.23.45 → 0.23.46 (RUSTSEC-2026-0346..0349; rust:check, worker:test, worker:image, e2e:avatar 5/5 on the new image; TLS path itself not exercised: local stack is HTTP) (
f99b4a5) - C
supabase/.temp/cli-latestuntracked, local copy kept (1312b36) - B session texts never overwritten after a failed set-aside (owner UI choice: resolution panel + save-failure banner) (
e34b7f2,a37c50b,c97b0e7): occupied slot refused, pair set-aside with rollback,heldrestore result, mirror on report change only, guarded new/import, discard + open-adapted behind confirmation, banner (draft or archive write refused); 27 new tests (app 346) - gates: verifier 11/11 (floor false positive on
cli-latest, clarified) + residual fixed; security PASS, 4 LOW fixed (archive refusal banner, download URL kept 30 s, header wording, comment); check:all green 1 min 29 s - follow-ups: UI for set-aside (quarantined) texts (owner: later); PDF export revokes its object URL at once (WebKit may cancel the download); "New report" replaces a readable draft without asking (unchanged, owner to decide if wanted);
writeCachedPractitionerthrows on a full localStorage before the report is created (no data loss)
- A rustls 0.23.45 → 0.23.46 (RUSTSEC-2026-0346..0349; rust:check, worker:test, worker:image, e2e:avatar 5/5 on the new image; TLS path itself not exercised: local stack is HTTP) (
- R3 anatomy core — validated by owner LAN acceptance 2026-10-17, merged into develop
8df964b(owner go 2026-10-14; branch feature/rust-r3-anatomy-core; plan.claude/tasks/plans/2026-10-14-rust-r3-anatomy-core.mdrev 2 after 3 challenges, 32 findings): prescan + tree + allowlist sanitiser + reference budget + serialiser + layer + canvas/highlight composition incrates/core; app canvas onview.canvas; denylist deleted- R3.0 freeze O1 canvas (
47c5f49), O2 layer (969b872), O3 highlight (d1aa35e), O4/O5 sanitiser corpus (b440a2f,e316821), O6 Chromium references (scratchpad, 30/30 stable); roxmltree recursion measured (overflow < 3,000 levels on 1 MiB) → prescan (5f53aaa) - R3.0b ANNOTATION-RENDERING.md to the code (
4e01710) - R3.1 svg prescan caps + tree + sanitiser + refs + number + serialiser (cargo O4/O5 green, mutation-checked) (
a7b3d7a,85c2183) - R3.2 layer (O2 exact) + compose (O1/O3 tree-equal) + op view.canvas + per-asset outcome + wasm thresholds (44 cases, no trap, ≤ 30.6 ms, ≤ 10.1 MiB) + SheetSession poison rule (
67d9af3,1ec9316,842797b,43a370a) - R3.3 app switch: canvas on view.canvas, denylist + anatomy dependency removed, hostile bundled sheet test (
09a6cf7); app 352 - R3.4 Chromium 156: live DOM = O1 (main, head), 30/30 screenshots pixel-identical, timings vs develop baseline (editor 503 vs 476 ms, detail 143 vs 125 ms at CPU ×4), 50 cycles heap +0.72 MiB nodes +0; CSP proof on the image ALL PASS; owner LAN run pending
- R3.5 docs (RUST.md §9, CLAUDE.md, CHANGELOG, PDF_IMPORT_HARDENING, packages/README) (
d6b5edb) - R3.6 gates: verifier CONFORME 11/11 ×2; security PASS ×3 (MEDIUM prescan closer desync + 3 LOW fixed: href/url( Unicode spaces, root painting attrs); check:all green 1 min 56 s; Chromium final 30/30 identical, DOM = O1
- R3 owner validation 2026-10-17 (LAN: functional + graphical all passed) → gitflow finish
8df964b, check:all green on develop; R4 not started (awaiting owner) - R3 owner decisions 2026-10-15: unnamed trigger names per language (
6882c6d, contractd8e9bd3); canvas engine failure (retry) vs view failure (no retry) (c0a5c8c) - R3 owner follow-up 2026-10-15: retry kept for
internal; after the 3 recoveries a clear final state (core.stopped) in the canvas and the action alerts, no retry (BDR-054) - R3 owner-requested audit of
0279953(2026-10-15/16): not satisfactory (unsaved draft promise, 4 dead retries, recovery dead end) → fixed6371523(BDR-055, BLK-011); verifier CONFORME 12/12, security PASS; residuals in BLK-011 - R3 final checks 2026-10-17 (owner brief 2026-10-16): rescue copy importable from Home, trapping draft held (no reload loop), replace confirmation, guard app-wide →
9bd9aca(BDR-056, BLK-012); verifier CONFORME 10/10, security PASS, check:all green; residuals in BLK-012 - R3 follow-ups kept by the owner (2026-10-15): worker TLS exercised against a real HTTPS endpoint before the deployment that needs it; roxmltree limits + SVG prescan (pin the iterative release when published); Firefox/WebKit check; SVG references across drawings scoped per view before community uploads (Step 13); WASM size margin (396 of 600 KB) before R4; TypeScript PDF sanitiser still present until R4
- R3.0 freeze O1 canvas (
- R4 pdf core (CLOSED 2026-10-21: owner J1 + J2 on computer, Android and real iPhone declared passed, R4.12 validated, merged into develop; RUST.md §10.15): reader (Web Worker, BLK-009 browser measurements) + writer (
pdf-writer, Std14 AFM, draw log; lines/rects/colours golden frozen with the TS engine first, D-R2) +report-comparetool;packages/pdfdeleted; N-1 scanner reads R4 PDFs- R4.0 plan (owner go 2026-10-17, arbitrations A1-A13):
.claude/tasks/plans/2026-10-17-rust-r4-pdf-core.mdrev 2 after 3 challengers (correctness 6 major, robustness 10 major, simplicity 3 major; none fatal) on chore/rust-r4-plan; Playwright Firefox 157 installed + proven, WebKit 27.2 downloaded (owner:sudo apt-get install libevent-2.1-7t64 libmanette-0.2-0); validated by the owner 2026-10-18 with conditions (plan §A.6, BDR-057) - R3 closed checked 2026-10-18 (
8df964bon develop, branch gone); chore/rust-r4-plan finished into developae17097(owner signal 2026-10-18) - Safari PDF download fix (bugfix/pdf-download-webkit,
2b8000e+ docs + CHANGELOG in owner wording): owner iPhone run 2026-10-18 all OK (several views, warnings alert, prompt open > 30 s); check green (1015 tests, typecheck, lint, build); mergedfcff92b - cut feature/rust-r4-pdf-core from develop
66909b6(after fcff92b; owner go 2026-10-18); WebKit libs installed by owner 2026-10-18, Playwright WebKit 27.2 runs workers + wasm - R4.1 freeze (O1-O13, ledger, browser harness, TS baselines)
- R4.1a O11 frozen TS scanner copy + O13 synthetic reports L (60×2), CAP (500×2)
- R4.1b writer oracles: O1 draw logs (12), O2 R3 PDFs (12 + real raster + store path), O3 pre-R2 envelope PDFs
- R4.1c text, AFM, dates, PNG oracles (O4, O5, O6)
- R4.1d reader oracles: O7 outcomes + inputs as bytes, O8 differential (full R3 path), O9 inflate (Node)
- R4.1e browser harness (scripts/browser, Chromium + Firefox + WebKit, 4 GiB RSS watchdog): O9 browser verdicts, O12 TS baselines (export demo/L/CAP, import O2 + hostile)
- R4.1f O10 report:compare outputs, test ledger (crates/core/tests/pdf/LEDGER.tsv), freeze record (RUST.md §10 draft, fixtures README)
- R4.2 reader (cargo + wasm, differential, OD-3 thresholds confirmed with owner before R4.3); owner go 2026-10-18 (R4.1 validated: fixtures kept, gitleaks exception accepted if narrow, decoy-first kept in register + risk explained before R4.3, headless accepted; stop at end of R4.2, budgets = whole browser, same perimeters as TS when a gain is claimed)
- R4.2a
crates/core/src/pdf/read/{scan,strings,stamp}.rs: scan.ts port (header, typed dicts, stream bounds, Filespec names, /Keywords stamp, decodePdfString; JS regex semantics explicit); cargo tests on O7 findEmbeddedFiles / hasArchiveStamp / decodePdfString rows (155 inputs incl. semantics rows) - R4.2b
pdf/read/inflate.rs(miniz_oxide, zlib framing, DecompressionStream verdicts): cargo tests on O9 (26 rows) + O7 flate inputs; Node verdict pinned, browsers agree (inflate.browsers.json) - R4.2c
pdf/json_js.rs:{probe after BOM/whitespace, depth 64 + value-count pre-scan (OD-3 budget hook), lossy UTF-8 + one BOM (TextDecoder parity), overflow → null rewrite, lone-surrogate-neutralised probe through parse_json, versioned check; unit tests + text parity cases - R4.2d
pdf/read/probe.rslocate_attachment (shared 16 MiB budget,breakon oversized, cancelled inflation not charged),pdf/import.rs(read → session::import_archive), oppdf.import+SheetHandle.importPdf(bytes)on the wasm facade, ts-rsPdfImportKind; cargo tests on O7 locate/readAttachedDocument/readReportArchive rows, O8 differential (51), Node tests through the wasm build on O2/O3/O8/hostile - R4.2e (Node part done: cap 400,000 = 10 × CAP envelope 39,652 values, rescue copy guarded, 1 GiB ceiling proven; browser run pending) OD-3: measurement harness (fresh wasm instance per case, time, linear memory; Node) on the hostile classes (16 MiB token-dense attachment, 16 MiB rescue copy, 50 MiB file, 16 MiB inflation, 32 candidates) + browser harness (worker page, content-process RSS, same perimeter as the TS import baseline); value budget = 10 × largest legitimate archive;
--max-memory; W1 module size; thresholds table for the owner - R4.2e follow-ups for R4.3: worker holds the File ArrayBuffer and its linear copy together (50 MiB file: WebKit content peak 324 MiB vs 76 TS) → release the buffer after the glue copy or read in chunks; after-GC residue 11.7 MiB first import (one-time, +1.9 then −0.2 on repeats) → owner decides the §B.3 criterion;
scripts/browser/lib/import-inputs.mjsshortcut: copy of import-baseline's listing, fold into one module when import-baseline is retired (R4.8) - R4.2f (done 2026-10-18; RUST.md §10.3 + §10.4; STOP for the owner before R4.3) record: RUST.md §10.3 (reader, parity, budgets, thresholds, residual risks), decoy-first (OD-4) risk explanation + proof it blocks no legitimate Faunosteo document, ledger
portedtargets exist, suites green (rust:check, wasm:build, check); STOP for the owner before R4.3
- R4.2a
- R4.3 import worker + rescue copy (B.1.5, OD-1 applied, browser proof per slice from here); owner go 2026-10-18 (BDR-058): switch gated on large-file memory fix + leak series
- R4.3a bytes API:
PdfBytessink (reserve ≤ 50 MiB, push chunks) +SheetHandle.import_pdf_bytes/restore_draft_bytes(strict UTF-8, one BOM, OD-3 guard) so the worker streamsfile.stream()into linear memory, one copy, no JS ArrayBuffer of the file, no JSON wrapping of the copy; Node + browser re-measure of 20–50 MiB files on 3 engines (same perimeter as R4.2e) - R4.3b worker + client (
apps/app/src/core/worker/): protocol v1 (B.1.5 items 1–7), controller module-level, timers (start, task 20 s paused when hidden), settle-once, terminate always, failure classification (worker_unavailable / crashed / timeout / read), compiled Module posted, static glue, prefetch after editor load; vitest in-process via spawn seam; noerrorevent masked - R4.3c HomeRoute on the controller (routing on first KiB + size pre-checks unchanged), rescue copy through the worker, B.1.8 messages (OD-5), hydrateImport from the core output; route tests per throwable and phase, settle-once, result after timeout, error after result, unmount, second pick, main runtime untouched; message test over O2/O3/O8/hostile; 612 leaves through the worker; v2/v3 imports preserved
- R4.3d browser proofs on the production build (SHEET_BUNDLE=draft dist, serve.mjs CSP): import-baseline on the app (3 engines) vs TS baseline; CSP with and without 'wasm-unsafe-eval'; leak series per owner §2 (init cost apart, ≥ 5 imports + idle, ≤ 10 MiB recurring, GC fluctuations repeated); peaks kept; WebKit repetition on dense documents (error events captured)
- R4.3e (done 2026-10-18; two WebKit points for the owner: 50 MiB file 145 MiB vs TS 76, leak series not demonstrable headless) record RUST.md §10.5, DEPLOY note (worker CSP, Firefox 114 line per OD-1), PDF_IMPORT_HARDENING §5 results, J1 procedure; announce "TEST FONCTIONNEL DISPONIBLE" with the 7-point checkpoint (BDR-058)
- R4.3a bytes API:
- J1 owner checkpoint (plan A.4)
- R4.4 layout → draw log (owner go 2026-10-18, BDR-060; stop before R4.5)
- R4.4a
pdf/write/{text,afm_data,dates}.rs: safe_text (O4 ranges), js_upper (O4 runs/special), js_trim/whitespace, measure = units × (size/1000) with WX||250 + KPX over WinAnsi bytes (O5 tables generated by scripts/r4-afm-data.mjs), wrap_lines (JS \s+), format_date fr/en (O6 grid, years 0-99 → 19xx per A3); cargo tests on O4 measure groups, wrapLines, safeText, upper, O5 widths, O6 - R4.4b
pdf/write/{mod,input,draw_log,layout/{header,footer,observation,conclusion}}.rs: ExportInput (ts-rs) checks (branding/labels, assert_snapshot + read_svg per asset, sheet mismatch, caps), rasters by key + PNG dims (IHDR only; gate at R4.5), DrawLog ops at full precision in TS call order (footers after all pages), links, embeds, warnings; cargo O1 12 logs exact, step6 text/images goldens (24) derived - R4.4c (done 2026-10-18, STOP before R4.5) record RUST.md §10.6 (modules, parity, declared differences, performance), ledger targets, suites green, STOP before R4.5
- R4.4a
- R4.5 serialiser (pdf-writer, self-check, from_envelope) (owner go 2026-10-18, BDR-061; stop before R4.6)
- R4.5a
pdf/write/content.rs: pdf-lib operator sequences for text/image/line/rectangle +numberToString(O4 cases, exponent quirks);pdf/write/png.rs: branding PNG gate (pngIssueport) + UPNG-rule decode to RGBA8 (O6 108 cases: gate verdicts + plane digests), alpha plane only when an alpha < 255; caps before allocation - R4.5b
pdf/write/serialize.rson pdf-writer: catalog, pages, 3 Type1 WinAnsi fonts, image XObjects (DeviceRGB + DeviceGray SMask Decode [0 1]), Link annots (Border [0 0 0], URI hex ASCII), Info (Producer/Creator Faunosteo, Title/Author/Subject/Keywords UTF-16BE hex, dates literal), attachment (EmbeddedFile Flate + Params, Filespec, Names, AF), classic xref;export.rs(checks → layout → serialise),self_check.rs(re-read with R4 reader, attachment == envelope),from_envelope.rs; errorsself_check_failed - R4.5c cargo O2: 12 R3 PDFs + real raster + store path: streams equal after B3 name resolution (lopdf dev-dep), image planes equal, links equal, Info equal but Producer/Creator, attachment bytes equal (store-path: D-R11 order only); goldens/r4/pdf.*.sha256 of the R4 outputs; export-side security cases (PNG budget 28, SVG hostile, URL injection, size E2, reexport)
- R4.5d external checks:
qpdf --checkclean,pdfdetach -listosteo-report.json,pdftoppm -r 150R3 vs R4 0 px (12 + real raster), O11 frozen scanner + N-1 Zod copy read every R4 PDF, stripped R4 PDF → attachment_stripped; TS reader (packages/pdf) reads R4 PDFs; R4 PDF → Rust import → same report (no data loss) - R4.5e wasm: proofs export
export_pdf_for_test(input JSON + rasters) → wasm digests == native digests; module size with the writer linked (W1 ≤ 600 KB gzip); Node timings/allocations on demo, L, CAP vs TS baseline (same files) - R4.5f (done 2026-10-18; STOP before R4.6) record RUST.md §10.7, ledger targets, suites green; STOP before R4.6
- R4.5a
- R4.6 app export (owner go 2026-10-19; session in main instance per OD-2; stop before R4.7)
- R4.6a core
pdf/write/session.rsExportSession(B.1.4 state machine:new→ branding batch → observation k batches → done;add_rasterdecodes + writes the image object on arrival, PNG and planes dropped;raster_failed→ warning; closed kindsunknown_keyduplicate_keyout_of_order);views.rs(raster_size_ofon O4,compose_highlightper (observation, view), branding SVG requests);objects.rsstreams into one buffer (catalog/pages written at the end, B2: R4 digests re-frozen once, declared); layout split (branding / observation / finish) over anImageSink;export_pdf(input, &Rasters)= a driver over the session (one code path); decode failure of a view →view_raster_failed(TSembedPngthrow), notself_check_failed - R4.6b cargo: O1/O4/O6 and O2 suites green on the session; view SVG = TS
renderHighlightedViewtext (compose oracle), raster sizes = O4; state-machine refusals; warnings order (rejection order then view order); memory: linear high-water on demo/L/CAP via the proofs build vs PDF size - R4.6c facade:
ExportSessionwasm-bindgen struct (new(input),next()→ExportStepJSON,add_raster(key, bytes),raster_failed(key),finish()→ bytes,warnings()), ts-rsExportInputRasterRequestExportStepExportWarningExportErrorKind;CoreRuntimesession wrapper (generation-bound,invoke,freein finally); proofs export kept for the digests - R4.6d app:
apps/app/src/pdf/labels.ts(verbatim frompackages/pdf/src/i18n),export.tson the session (snapshot, branding,new Date(),nextloop,browserRasterizerunderPromise.all,raster_failedin rejection order thenadd_rasterin request order,finish, free); EditorRoute alerts unchanged;exportReportToPdfkeeps its signature;@faunosteo/pdfleavesapps/app/src(tests keep it until R4.8) - R4.6e app suites: pdf.goldens (Step 6 text/images/links via the app path, Rust output), pdf.roundtrip, pdf.export.app (re-export via core), EditorRoute.export, coreStopped/coreFailures mocks; app-path bytes = R4 digests (stub rasters, FIXED_EXPORTED_AT); 612 leaves exported + re-imported on Rust; export Rust → import Rust, → TS reader, → N-1 (O11 + Zod): no loss
- R4.6f browsers (scripts/browser): Rust vs TS composed-view rasters pixel-identical (Chromium, Firefox, WebKit); E3/E4 harness demo/L/CAP, same data, TS vs Rust: total, raster, serialise, linear memory, JS heap, RSS; release proof on success / raster error / cancel (unmount) / recovery (trap mid-session); W1 shipped module with the writer linked (gzip -9; report > 550 KB)
- R4.6g docs: RUST.md §10.8 (buffers ownership and lifetimes, allocations, release proofs, E3/E4 tables, W1, deviations: catalog at the end, decode at arrival, logo batch order), DEPLOY.md if the module size line moves, fixtures README, ledger rows (pdf.goldens, pdf.roundtrip targets filled), memory (BDR, LRN, journal)
- R4.6h (done 2026-10-19; STOP before R4.7) owner recette procedure (visual + functional on the owner's devices: FR/EN, logos, annotations, real rasters, links, L on the phone), report, STOP before R4.7
- R4.6a core
- R4.7 report-compare in Rust (owner go 2026-10-19, R4.6 accepted provisionally; stop before R4.8)
- R4.7a core
pdf/compare/{mod,lines,run}.rsbehind featurecli(= pdf-read + pdf-write):escon the V8[\p{Cc}\p{Cf}\u2028\u2029]table (SAFE_TEXT_DROPPED),Comparison(header, v3 and migrated observation lines, footer, normalized, counts),render_comparison/render_summary/diff_lines,parse_args,run(sheet, argv, &dyn Files)→ stdout, stderr, exit code; closed failure wording (A.3):report document invalid: <core detail>for the Zod dumps,attachment refused: lone UTF-16 surrogate escape at byte Nfor the kept surrogates,report version null cannot be readfor an overflow read as null;as_stron Severity, SeverityV2, LateralSide, SnapshotRejection - R4.7b
src/bin/report_compare.rs(featurecli, the only std::fs file): seed sheet fromsupabase/seed/anatomical-sheets/equine/draft(ref, document, map; no asset), arguments relative toINIT_CWD, folders expanded, size pre-check, exit code;scripts/report-compare.sh(rust-env + cargo run --release --features cli) behind the rootreport:compare; rust-check feature lists widened tocli - R4.7c cargo
tests/pdf_compare.rs: the 230 O10 invocations in-process (158 undeclared rows exact: stdout, stderr, exit; 72 declared rows against the Rust wording per A.3 class), scenario PDF digests =inputs, the 11 scenario cases named for the ledger, one spawn of the real binary (usage, INIT_CWD, output = in-process); ledger rows 135–145 targets filled,scripts/r4-ledger.mjsregenerated - R4.7d (done 2026-10-19; STOP before R4.8) docs: RUST.md §10.9 (binary, parity 158/72, A.3 lines as printed, timing), CLAUDE.md (command, map), fixtures README if touched, memory journal; rust-check + pnpm check green; report, STOP before R4.8
- R4.7a core
- R4.8 deletions + docs + ledger census (owner go 2026-10-19, R4.7 validated; stop before R4.9)
- R4.8a test read-back without pdf-lib and without the TS engine:
tests/helpers/pdfFile.ts(reader of the writer's own files: objects, dicts, Flate streams via zlib, pages in order, Info, annots, XObject sizes),pdfRead.tson it,goldens.ts(readLinkson it;snapshotViewfrom the session's request SVGs captured at the rasteriser;recordDrawingdropped),tests/helpers/pdfImport.ts(importReportFromPdf= the module'sSheetHandle.import_pdf+ the worker'spdfImportOf;importAttachment=sheet.ops.importArchive),@faunosteo/core-wasm/n-1exports the frozen O11 scanner (readAttachmentBytes); suites rewritten: pdf.goldens (2×1 PNG decode read from the XObject), pdf.roundtrip (foreign PDFs = the r4/read fixtures), archive.envelopes + n-1.reader (N-1 scanner), migration.leaves, goldenReports, helpers/sheet (labels from@/pdf/labels), core-wasm pdf-export.session (request SVG vs the frozen R3 compose oracle) - R4.8b deletions after the consumer audit (grep census per package):
packages/pdf/**(engine, tests, R3/R4 oracle generators, helpers),apps/app/src/pdf/import.ts,apps/app/scripts/compare-reports.ts+compare/*,tests/unit/{scripts.compare,pdf.import,pdf.export.app,r4.compare-oracles,r4.tolerance-oracles,r4.writer-oracles}.test.ts,tests/helpers/r4-draw.ts(what survives moves),packages/core-wasm/tests/pdf-export.ts-engine.test.ts; deps:@faunosteo/pdf(app, core-wasm),pdf-lib+tsx+ appreport:comparescript (app), Dockerfile COPY line;pnpm install→ lockfile without pdf-lib, @pdf-lib/*, @resvg/resvg-js;@xmldom/xmldomonly under packages/anatomy (R5);packages/anatomyrender untouched - R4.8c ledger:
scripts/r4-ledger.mjsreads the frozen 301 cases from the committed TSV (no vitest run of deleted suites), re-derives dispositions (deleted suites →deletedwith their cargo / vitest target, N-1 switch noted, read-back notes), census: every cargo target incargo test --list, every vitest target in the live report, counts = 301; TSV regenerated - R4.8d non-regression proofs (owner §3): grep census test (no
@faunosteo/pdf,pdf-lib,@faunosteo/domainimport under apps/app/src, packages/core-wasm/src; the import worker path, the export session path and the rootreport:comparescript named by a test), wasm:build, rust-check, pnpm check, pnpm check:all (app image, worker test + image), N-1 reader suites, O2/O3/O7/O8 fixtures still read, 612 leaves, rescue copies and quarantine suites - R4.8e (done 2026-10-19; STOP before R4.9) docs: RUST.md §10.10 (deleted files and packages, dependencies removed, Rust-only features, TS still legitimate with reasons, tests, risks, R5 prerequisites), CLAUDE.md (stack table, map, PDF conventions, workflow lines), DEPLOY.md (module size, rollback), PDF-FORMAT, PDF_IMPORT_HARDENING §5, TEST_STRATEGY, WORKSPACE, packages/README, fixtures README, CHANGELOG (Unreleased), README; memory (BDR, journal); report, STOP before R4.9
- R4.8a test read-back without pdf-lib and without the TS engine:
- R4.9 final verification, independent audits, J1/J2 recettes (owner go 2026-10-20, R4.8 validated; no merge, no R5, stop at the checkpoint)
- R4.9a memory bench (owner §3: the Chromium 10 MiB reserve of R4.6 is NOT closed by R4.8):
scripts/browser/r4-memory-bench.mjson the series machinery, one editor tab, demo + L, ≥ 6 exports after the init export, reproducible; five readings told apart per step: (1) wasm linear memory (WebAssembly.Memorycaptured at instantiation), (2) content-process RSS (watchdog), (3) live canvases / images / bitmaps / blobs / object URLs (FinalizationRegistry counters + createObjectURL/revoke ledger; Chromium heap-snapshot class census), (4) transient peak during the export (RSS sampler), (5) retained after the exports: settled, after the 30 sdownloadBlobrevocation window, after leaving the editor (Home) + GC; three engines; results JSON + table in RUST.md §10.11; cause / severity / fix proposed if a durable retention is confirmed, nothing declared resolved without a measure - R4.9b import security classification (owner §4): every open point of PDF_IMPORT_HARDENING §5 and of BDR-058 / BDR-059 / BDR-063 in one table: fixed with proof / accepted temporarily with justification / blocking before merge / before public exposure or upload activation; written in PDF_IMPORT_HARDENING.md §6, hostile refusals kept, no silent change of user data
- R4.9c J1 + J2 recettes refreshed (owner §5):
R4_J1.md/R4_J2.mdon the R4.8 state (export on the core, no TS engine), device list per plan OD-6 verbatim (computer: Chrome + Firefox; iPhone: Safari iOS; low-end Android: its browser), kits regenerated (r4-j1-kit,r4-j2-kit) and checked,pnpm report:comparestep in J2, results templates NON TESTÉ untouched; announce TEST FONCTIONNEL J1 DISPONIBLE + TEST FONCTIONNEL ET GRAPHIQUE J2 DISPONIBLE; no human test declared done - R4.9d full checks:
pnpm check:all, PGlite suite, wasm size line (519,795 B gzip accepted; budget 600 KB / report 550 KB kept, proofs test unchanged), oracles + goldens diff vs R4.1 freeze = empty - R4.9e independent audits (owner §6): contract
.claude/tasks/contracts/2026-10-20-rust-r4-final-1000.md(owner §2 list as criteria), fresh verifier + fresh security audit in parallel; real anomalies fixed minimally with regression tests + targeted re-audit; oracles/goldens unchanged - R4.9f docs + memory: RUST.md §10.11 (bench, classification, audits, checks, residuals), CHANGELOG, TODO; BDR / EVAL / journal; commits on
feature/rust-r4-pdf-core(hooks push) - R4.9 results (2026-10-20): bench = linear flat, objects/URLs released, Chromium growth = browser raster path (control identical, plateau), BDR-065; §6 20 rows; recettes re-issued + kits; check:all green 49b812b; verifier CONFORME 16/16 (pass 3); security PASS after BLOCK(1) gitleaks marker (owner) + host bind fix ×3 re-gates; EVAL-025, LRN-065
- R4.9g checkpoint report (owner §9: verifier, security, checks, memory + reading, residual risks, real merge blockers, J1/J2 instructions, git state) → STOP; merge and R5 only on the owner's explicit signal (delivered 2026-10-20)
- R4.9a memory bench (owner §3: the Chromium 10 MiB reserve of R4.6 is NOT closed by R4.8):
- R4.10 J1/J2 anomalies (owner 2026-10-21: J1.7 FAIL Brave + Firefox, J2.3 FAIL; no merge, no R5, no release, no faunosteo.com)
- R4.10a results recorded as declared: J1.1-J1.6, J1.8-J1.13 PASS declared (no per-browser split given: cells stay NON TESTÉ per device, declared status in a note), J1.7 FAIL Brave + Firefox, J2.3 FAIL, others PASS declared; Safari iOS NON TESTÉ; Brave noted as outside the OD-6 list
- R4.10b anomaly A diagnosis: headless repro (Chromium, Firefox, WebKit; emulated offline): Chromium refuses the worker chunk offline = serve.mjs sends no Cache-Control on /assets/ while nginx sends
public, max-age=31536000, immutable→ recette surface defect; picker freeze not reproduced headless (native dialog) → discriminating protocol for the owner - R4.10c fix A: serve.mjs mirrors nginx.conf cache headers (/assets/ immutable); regression harness
scripts/browser/r4-offline-import.mjs(J1.7 offline on the 3 engines + header check) - R4.10d anomaly B diagnosis: editor export always embeds the bundled branding (Step 6 rule, unchanged since
66909b6); archived branding reused only byexport_from_envelope(cargo); J2.3 expectation wrong (R4.6 wording) → owner decision, no code change - R4.10e gates: verifier CONFORME 7/7; security PASS, 2 LOW applied (immutable by resolved folder, harness child cleanup) + targeted re-gate; mini-recette
R4_MINI_RECETTE.md; LRN-066; commits 63034e1..baebb98 - R4.10f owner decisions (2026-10-21): J2.3 option 1 (editor export keeps the application's current branding; the archive keeps its data for a faithful reproduction); J1.7 stays open (cache fix accepted, picker freeze unexplained, Ctrl+O = a clue not a proof, network-share hypothesis not confirmed); Safari iOS pending (real device, no simulator for memory); gitleaks marker authorised again; R4.8 deletion trace to verify; ZenQuality footer logo to diagnose
- R4.10g J2.3 docs per option 1: R4_J2.md expected result (logos of the application's current branding, the archive's
nullslots not reused), R4_J2_RESULTS.md (declared cell = acceptable under the rule, subject to the logos matching the expected branding), RUST.md §10.12 decision line, mini-recette J2.3 line; no engine, golden or oracle change - R4.10h
.gitleaks.toml: the exact[gated 2026-10-18]marker in the one allowlist description, scope unchanged - R4.10i R4.8 deletion trace: 23 test files deleted by
0dc1ba2(one commit, nothing else on the branch); 22 traced case by case in LEDGER.tsv (ported / replaced / deleted with a target), the glue'spdf-export.ts-engine.test.tstraced in RUST.md §10.10 and R4.8b; approval = contract 2026-10-20 header (« Je valide officiellement R4.8 … les remplacements de tests sont approuvés ») + BDR-064; RUST.md §10.11 says 21 → corrected to 23; no new deletion - R4.10j ZenQuality footer logo (
dcc7940: 12/12 CSP passes no violation, offline 6/6, app 429 tests): diagnosis (hotlink sincecaac1492026-05-21; the DEPLOY.md CSP is the VPS reverse proxy's, docker/nginx.conf carries none; faunosteo.com today sends no CSP header; the PDF uses the bundledzenquality-logo-fr.png, unaffected; seen by the R2 and R4 CSP proofs as the known violation, never a J1/J2 item) → fix: the exact remote file bundled undersrc/assets/brand/, Footer?urlimport like the partner logo (same pixels, no branding change);components.Footertest (no external image source);r4-app-csp.mjsdrops the known-host exception (any violation is a problem); build:preview + r4-app-csp + r4-offline-import re-run; CSP unchanged - R4.10k (verifier 8/8 MET, one formal scope gap: the contract file itself; security PASS, 3 LOW, protocol-relative test regex fixed
1877c4b) (owner 2026-10-21 rectification recorded: J1.7 PASS with picker-delay reserve, M1/M2 PASS ~60 s, M3-M6 NON TESTÉ, cause unclaimed, no app change) gates: verifier on the contract, security gate on the diff; docs (RUST.md §10.12, CHANGELOG), memory; report → STOP: owner's M1-M5 + Safari before any R4 close; no merge, no R5, no release, no deploy - R4.10n final gates: check:all green
8943bf3, verifier CONFORME 12/12, security PASS (2 LOW) → STOP, wait Safari iOS + merge signal - R4.10l owner verdict recorded (BDR-066: J1.7 PASS w/ reserve, M3 complementary non-blocking, J2.3 option 1 final, logo + CSP hardening validated, gitleaks marker valid with delegated writing, 23 deletions authorized, Safari iOS real device only); contract FILE SCOPE amended (contract itself, memory, redactions) + criteria 9-12; report paths redacted, harness distDir repo-relative; check:all + gitleaks/semgrep/cargo deny/pnpm audit run; verifier re-dispatch = orchestrator
- R4.11 dependency maintenance (verifier CONFORME 12/12 pass 2, security PASS; checkpoint delivered, waiting owner signal) before the R4 merge (owner 2026-10-21: three advisories; minimal updates, separate commits; stop on any large migration)
- R4.11a analysis: rustls-webpki 0.103.15 and webpki-roots 1.0.9 reach the tree through ureq 3.4.2 → rustls 0.23.46 (worker only, its TLS client to Supabase; no other crate); fixes 0.103.16 / 1.0.10 published, not yanked, same minor; react-router 7.15.1 through react-router-dom ^7.1.1 (app only): 5 advisories, 4 not reachable (RSC, SSR hydration, server-side route matching; the app is a BrowserRouter SPA with no loader, action or server), 1 reachable in principle (GHSA-wrjc-x8rr-h8h6 backslash open redirect through
<Link>/useNavigate) but the only untrusted destination isnext, rebuilt bysafeNextPathfrom a parsed URL against a sentinel origin; latest 7.x = 7.18.4 (2026-09-15), patch-level changelog, no API change for the app - R4.11b (
7a7b71c)cargo update -p rustls-webpki -p webpki-roots(Cargo.lock only) - R4.11c (
c9dab63) react-router-dom ^7.18.4 (apps/app/package.json + lockfile) - R4.11d (
a604c07) worker TLS test: an in-process rustls server with a self-signed certificate (rcgen, dev-dependency) must be refused byHttpBackend(certificate validation active); honest limit: proves validation, not the emSign distrust itself - R4.11g owner decisions on the Context7 review (2026-10-21): D1 distroless debian13 now, D3 safeNextPath now, D6 DEPLOY http2 now; D2 outline-hidden + D5 MotionConfig reducedMotion → accessibility chantier (not in R4); D4 config chores → maintenance backlog (below); no major upgrade
- R4.11a analysis: rustls-webpki 0.103.15 and webpki-roots 1.0.9 reach the tree through ureq 3.4.2 → rustls 0.23.46 (worker only, its TLS client to Supabase; no other crate); fixes 0.103.16 / 1.0.10 published, not yanked, same minor; react-router 7.15.1 through react-router-dom ^7.1.1 (app only): 5 advisories, 4 not reachable (RSC, SSR hydration, server-side route matching; the app is a BrowserRouter SPA with no loader, action or server), 1 reachable in principle (GHSA-wrjc-x8rr-h8h6 backslash open redirect through
- R4.12 pre-merge fixes D1 / D3 / D6 (one commit each; owner 2026-10-21; then STOP at the pre-merge checkpoint; owner validated 2026-10-21)
- R4.12a (
51a5a80) D3safeNextPath: the returned value is resolved again against the sentinel origin and must stay same-origin and not start with//(dot segments/..//,/%2e%2e//,/..\\, tab inside..), else fallback; tests: dot segments, double slashes, backslashes, schemes, encodings, valid destinations unchanged; consumer test through LoginRoute (MemoryRouter) withnext=/..//evil.test→ /app - R4.12b (49b1849; e2e:avatar 5/5 on the new image) D1 worker runtime
gcr.io/distroless/static-debian13:nonroot(provenance: GoogleContainerTools distroless, cosign-signed; same user 65532, no shell, static); worker:test, worker:imagerun --check, sandbox tests; Dockerfile only - R4.12c (60faac8; nginx 1.24 rejects
http2 on: both forms documented, nginx -t on 1.24 and 1.31) D6 DEPLOY.md:listen 443 ssl http2;→listen 443 ssl;+http2 on;(nginx ≥ 1.25.1 noted); nothing else in the runbook - R4.12d (verifier CONFORME 9/9; security PASS, fuzz 218 inputs 0 escape, 3 LOW; check:all green 18:55:30) gates: check:all on the final state, pnpm audit --prod, cargo deny, worker tests, navigation suites, goldens/oracles unchanged; contract + fresh verifier + security gate; RUST.md §10.14, CHANGELOG, memory → STOP pre-merge checkpoint
- R4.12a (
- R4.13 close (owner 2026-10-21 « Validation finale de R4 et autorisation de fusion »): recette results consolidated as declared (iPhone Safari iOS J1 + J2 PASS as a whole, missing details listed not invented; J1.7 PASS w/ reserve; J2.3 PASS under the approved rule; M3 NON TESTÉ), RUST.md §10.15 (residual risks table, deadlines), PDF_IMPORT_HARDENING.md §7 (items 3/19 unblocked, 5/6/7/9/20 still open), CHANGELOG headers; final checks on
22bbfb4: check:all green 22:15:50, audit --prod clean, gitleaks 111 commits clean (tree: git-ignored.env.workeronly), no local path / personal id, merge-tree clean, goldens/oracles/digests untouched, 51 deletions all in 0dc1ba2; thengitflow finish→ develop (no-ff), branch deleted. Not done: release 0.2.0, deploy, DNS, R5, D2/D4/D5
- R4.0 plan (owner go 2026-10-17, arbitrations A1-A13):
- accessibility chantier (owner 2026-10-21, after R4, needs a visual recette): D2
focus-visible:outline-none→outline-hiddenin the 13 files listed in.claude/audits/CONTEXT7-2026-10-21.md(keyboard focus, forced-colors, graphic coherence); D5<MotionConfig reducedMotion="user">at the root (Dialog scale, ObservationCard height animations, transitions) - maintenance backlog (owner D4, accepted in principle, not scheduled): apps/app/vitest.config.ts dead
coverageblock (no @vitest/coverage-v8); tests/setup.ts →@testing-library/jest-dom/vitest; eslint.config.jstseslint.config→defineConfig; ui/Input, Select, TextareaforwardRef→ ref prop (React 19); authStore.ts:95-97 stale deadlock comment; no major upgrade (react-router 8, zod 4, TS 7, vite 8 + vitest 4, ESLint 10, PGlite 0.5 stay out) (.claude/audits/CONTEXT7-2026-10-21.md: distroless debian13, Tailwind outline-hidden, safeNextPath dot segments, dead coverage block, jest-dom entry, tseslint defineConfig, forwardRef, DEPLOY http2, reduced motion) → nothing changed until decided- R4.11e checks (rust-check, deny advisories ok, audit --prod clean, app 429, check:all green 17:27:54, goldens untouched, criterion 11 generic; gates dispatched): rust-check,
cargo deny check advisoriesclean,pnpm audit --prodclean, app suite (routing, auth, redirects), check:all (images, sandbox), goldens and oracles unchanged (git status), contract + fresh verifier + targeted security gate; contract criterion 11 regex made generic (owner §6) - R4.11f docs (RUST.md §10.13, CHANGELOG, contract 1700): RUST.md §10.13 table (advisory, old, new, audit, residual), CHANGELOG, DEPLOY if the TLS note changes; memory; checkpoint table → wait for the owner's signal
- R4.10m (closed by R4.11: rustls-webpki 0.103.16 + webpki-roots 1.0.10 in
7a7b71c, react-router-dom 7.18.4 in c9dab63;pnpm audit --prodclean at the close; the full audit's 54 advisories are dev tooling only, 26 on the pinned pnpm itself) security reserves found by the R4.10l checks, pre-existing, not fixed (dependency upgrades = owner decision, outside R4.10 scope): RUSTSEC-2026-0382 rustls-webpki 0.103.15 + RUSTSEC-2026-0381 webpki-roots 1.0.9 (worker → ureq;cargo update -p rustls-webpki -p webpki-roots; advisories warn-only in check:all, release gate blocks);pnpm audit --prod5 (react-router <7.18.2: 2 high, 3 moderate; several RSC/framework-mode only, open-redirect GHSA-wrjc-x8rr-h8h6 applies to<Link>/useNavigate); full audit 57 incl. 2 critical tinypool (vitest, dev only); gitleaks history 561 commits clean, working tree 1 jwt in git-ignored.env.worker(never committed) - owner actions: J1 + J2 on the OD-6 devices (done 2026-10-21, iPhone included); still owner-side: delete the UFW 4173 rule after the recette sessions (
sudo ufw status numbered,sudo ufw delete <n>) - owner action (non-blocking):
packages/pdf/node_modulesleftover (13 pnpm symlinks, 6 bin shims, 1 vitest cache file, 0 tracked or useful files) →rm -rf packages/pdf/node_modules && rmdir packages/pdf(the recursive delete was refused to Claude by the permission layer) - outside R4 (owner 2026-10-17, non-blocking): worker container ignores SIGTERM (Docker kill after 10 s; chore, e.g.
init: true); README test counter stale (367 vs 1,015)
- R4.11e checks (rust-check, deny advisories ok, audit --prod clean, app 429, check:all green 17:27:54, goldens untouched, criterion 11 generic; gates dispatched): rust-check,
- R5 curation pipeline + importer + upload tool (merged into develop 2026-10-25,
9ba2a25, owner « Autorisation définitive de fusion R5 »; follow-ups below stay open) (plan.claude/tasks/plans/2026-10-22-rust-r5-pipeline-core.md, branchfeature/rust-r5-pipeline-corefrom 9c0117a; owner 2026-10-22: R5.1 authorised, stop before any Rust pipeline code and before anydocumentSha256change; no merge without validation, no deletion of packages/anatomy or domain, no golden or historical change, no 0.2.0, no deploy, no SaaS feature):packages/anatomy+packages/domaindeleted at the end, docs map; all before Step 13- R5.1 freeze + D-R5 study (2026-10-22): inventory
.claude/audits/R5_PIPELINE_INVENTORY.md, census.claude/audits/R5_DOCUMENT_SHA256_CENSUS.md, oraclescrates/core/tests/oracles/r5/{pipeline,ids,fingerprints}.json(generatorpackages/anatomy/tests/r5.pipeline-oracles.test.ts,MAKE_R5_ORACLES=1), study scriptsscripts/r5-fingerprints.mjs+packages/supabase/scripts/r5-jsonb-fingerprint.mjs, RUST.md §11, anatomy 137/137, domain 262; F1 found: corejs_numberrounds exact ties upward (JS: to even;zmijmatches), 1 legacy value, invisible on the draft, R2 contract test self-referential → checkpoint, STOP - owner decisions (2026-10-22, BDR-068): D-R5 = B
sha256-rfc8785-validated-v1(applied at R5.6 only), aliases from trusted frozen documents only, F1 go, byte-exact by default + declared differences, historical SVG bytes kept,.prettierignoreon Rust-written paths + reproducible check,ureqpreferred at R5.5; stop after R5.2 - R5.1b F1 fix (
aed6b1e):zmijdigits; V8 oracleoracles/r5/numbers.json44,322 rows (1,552 mismatches before, 0 after); 840.1692504882812 test;zod_oraclechecks oracle bytes vs core compact print (red on old printer); consumers audited R2-R4: rust:check + wasm + check green, no oracle/golden/digest moved - R5.2 legacy importer in Rust (feature
curation,crates/core/src/curation/**, 3,187 lines) +import-equine --check | --out: legacy-import/ 4 texts + 2 SVG byte-exact, pipeline.json legacy parts equal, raw report = pre-Prettier digest, determinism, 10 synthetic TS cases (2 byte-exact, 8 refused alike), format probes (968 JSON, 10 tables, slugs, uuids, Number, Math.round, key order); declared differences RUST.md §11.10; contract.claude/tasks/contracts/2026-10-22-rust-r5-f1-importer.md→ checkpoint, STOP before R5.3 - R5.3 changeset applier, migration map, stats, seed SQL (CLOSED 2026-10-23 on
c6e0d85: fresh verifier CONFORME 13/13 after 6 final rounds, security PASS LOW only, check:all green; owner go 2026-10-22 « Validation R5.1b / R5.2 et autorisation R5.3 »:pnpm r5:import-equine --check | --out <dest>names the Rust binary,pnpm import:equinekept; no fingerprint switch;horse.svgfrozen bytes read, never re-cleaned; R5.4 files (review SVGs, CHANGELOG, REVIEW-REPORT) out of scope; stop at the checkpoint)- R5.3a
crates/core/src/curation/draft/{schema,targets,fields,ops,rename,apply}.rs: changeset + references files parsed strictly (Zod shape order on re-emit,prioritydefault, level C question, duplicate ids), target grammar, settable fields, the six ops on the plain JSON document (serde_json::Value, insertion order), rename propagation, review rule (touched items →to_confirm, identity through a transient marker key), shape + integrity gate through the R2 core (AnatomicalSheetDocument+validate_sheet_document) - R5.3b
draft/{migration_map,stats,seed,pipeline}.rs: replay of rename/remove/move records over the 792 legacy paths, re-homing, stats;documentStats(17 fields, JS key order);renderDraftSeedSqlbyte-exact;build_equine_draft(CHG-000 from the frozenhorse.svgbytes and the head view box) +render_draft_artifacts(document, assets, sheet-ref with sha256 of the document bytes, migration map, seed SQL) - R5.3c
import-equine: both folders (<dest>/legacy-import,<dest>/draft),--checkcompares the produced files and lists the R5.4 files as pending (not counted),--outrefuses a non-empty folder, a symlink, a file, an empty path;scripts/import-equine.sh+ root scriptr5:import-equine - R5.3d proofs (draft 5 files byte-exact, 12/12
--check, 46 changes + 825 records + stats equal, 612 leaves 442/141/29, 58 synthetic cases: 9 byte-exact + 49 refused alike + 5 references files, rust:check green):tests/curation_draft.rs(draft files byte-exact vs committed,pipeline.jsondraft section: 46 changes, 825 records, stats, migration stats, assets, issues; determinism; 612-leaf walk through the core's migration on the produced map); TS generatorr5.curation-synthetic-oracles.test.ts→oracles/r5/curation-synthetic.json(mini sheet: every op kind, positions, subtree scopes, review rule B/C, renames with cascades, re-homing, refusals) run by the Rust suite;pnpm rust:check,pnpm check:all - R5.3e (security PASS 6 LOW / 3 fixed; verifier 4 passes, last C1-C12 met + C13 docs fixed after; check:all green 00:10:03) gates: security auditor (diff), independent verifier on the contract
.claude/tasks/contracts/2026-10-22-rust-r5-draft.md; docs RUST.md §11.12-11.13, CHANGELOG, CLAUDE.md commands; memory → checkpoint report, STOP before R5.4 - R5.3g final rounds 1-6 (verifier + security + check:all each): NUL field segments, depth/segment/value bounds, exclusive --out writes, shape family, JSON.parse normalisation, non-list/non-object children, proto segments, seed identity guard, reads confined to the seed; all fixed or declared (RUST.md §11.12-11.13)
- R5.3f owner 2026-10-23: Object.prototype member characterised (safe, accepted, test), migration-map debt kept + characterisation test, refusal reasons compared by stage; final fresh verifier + security on the R5.3 state
- R5.3a
- debt (owner 2026-10-23, after R5): migration map replays cascade records by their op (
applyRecord/apply_record): a view, zone, region, category or cited-reference rename corrupts the map; fix both sides as a declared change before any changeset uses such a rename (RUST.md §11.12) - OWNER DECISION (found 2026-10-23 by the R5.3 final verifier): serde derives of the R2 contracts read a struct from an array and a unit enum from a one-key map, where Zod refused; likely reachable by the gated readers of imported PDFs (
archive/read.rs,report/read.rs,pdf/import.rs); probe the readers, then a per-file go for a strict deserialisation (RUST.md §11.13) - chore (pre-existing, security gates R5.3):
clippy.tomldisallowed list missesfs::create_dir*,OpenOptions::open,read_dir,canonicalize,remove_*,env::current_dir,env::args_os,process::Command; extend so the core's no-I/O rule is enforced, not only observed - R5.4 review overlays + app drawings, CHANGELOG + REVIEW-REPORT, --check over the whole draft (owner go 2026-10-23, conditional on the R5.3 final checks: met on c6e0d85; contract
.claude/tasks/contracts/2026-10-23-rust-r5-review.md; stop at the checkpoint, no R5.5)- R5.4a
draft/{labels,changelog,review_report}.rs+stats::stat_rows: CHANGELOG and REVIEW-REPORT raw text = ledger pre-Prettier digests, formatted text byte-exact (report_guard::format_report: allowlist guard +markdown::format_markdownalignment); compactValue on UTF-16 units - R5.4b
draft/{overlay,app_review}.rson the core tree (read_svg, frozen horse.svg, prolog kept verbatim): review overlays and app drawings; bytes vs xmldom where reproducible, parsed trees otherwise; the R3 trigger-name decision declared for app-main - R5.4c
render_draft_artifactscomplete (TS order);import-equine --checkcovers the 12 draft files with explicit criteria (bytes; declared tree rule), PENDING list andshortcut:removed; fails on any missing or unauthorised difference - R5.4d proofs:
tests/curation_review.rs(the 6 files, ledger digests, determinism); TS generatorr5.review-synthetic-oracles.test.ts→oracles/r5/review-synthetic.json(changelog raw + formatted, review report, overlays, app drawings on mini-sheet cases: Unicode, pipes, newlines, long values, emoji refused, every status); R5.3 LOW carry-over (destination identity, cite membership, unreadable-seed message, stale comment, doc nits) - R5.4e gates: 14 rounds;
c4e717dsecurity PASS (LOW only) + check:all green 16:41:34;eb667ad(docs only over it) fresh verifier 9/9 clauses MET, ECARTS = 13 FLOOR hits on audit prose (owner Clarification); docs RUST.md §11.14-11.15, CHANGELOG, CLAUDE.md; memory LRN-074, LRN-075, EVAL-029 → checkpoint delivered, STOP before R5.5 (R5.4 closes on owner validation)
- R5.4a
- R5.5
upload-sheet-assetsbin + runbook (CLOSED 2026-10-24 by the owner: real local stackpnpm e2e:sheet-assetsPASS 11/11, run by the owner by hand; owner go 2026-10-23 « Validation R5.4 et autorisation conditionnelle R5.5 »; local stack only; no production, no deploy; stop at the checkpoint, no R5.6)- R5.5-0 R5.4 closing adjustments: FLOOR clarification (contract +
scripts/floor-clarification-check.sh, 19 audit-prose hits requalified, 1 STUB in evals.md:205 outside scope, reported), 4 MiB cap onchanges.json/references.json(coreMAX_CURATION_FILE_BYTES, bin bounded read; 222 KB + 17 KB committed, parse of a 3.98 MB changeset peaks +39 MB),tests/curation_caps.rs(cap, margin, stable ids of any species), serde R2 tolerance probe (characterisation only, nothing changed) - R5.5-1 core module
curation::upload(pure, no I/O): manifest parse + entry rules, destination rule, key derivation, per-entry plan from observed states, closed error kinds - R5.5-2 bin
upload-sheet-assets(featureupload, ureq):--checkread-only and write mode, destination verified (loopback or the DEV host, http, explicit port) then handshake (private bucket) before any transfer, existing objects verified by sha256 never overwritten, confirm only after the object is verified, bounded retries, secrets never printed - R5.5-3 scripts:
assets:uploadpoints at the Rust bin (scripts/upload-sheet-assets.sh), TS script kept until R5.7 census; runbook SUPABASE.md §3.1, RUST.md §11.16 - R5.5-4 tests (real-stack e2e NOT run by Claude: permission layer refused; owner runs
pnpm e2e:sheet-assets): unit (core), bin tests against a stub HTTP server (refusals, partial failure, resume, network errors), local Supabase run (upload, rerun, anon refused, wrong key, tamper);pnpm rust:check,pnpm check:all,r5:import-equine --check - R5.5-5 gates (round 1: verifier ECARTS(4) + security PASS 1 MEDIUM 9 LOW, fixed; round 2
fad85c0: verifier C1-C13 MET, check:all green 21:47:11, security PASS 5 LOW declared RUST.md §11.16): fresh security audit, fresh verifier on the contract.claude/tasks/contracts/2026-10-23-rust-r5-upload.md; memory; checkpoint report (9 points), STOP
- R5.5-0 R5.4 closing adjustments: FLOOR clarification (contract +
- R5.5 closing corrections (owner 2026-10-24 « Clôture R5.5, corrections ciblées et préparation R5.6 »; contract
.claude/tasks/contracts/2026-10-24-rust-r5-5-closing.md)- LOW:
Protocolfinal, DEV address own unicast (broadcast refused), tests - serde:
check_v3_shapeatread_report_documentv3 +parse_envelope(sheet, practitioner, severity), test turned around confirm_sheet_asset_uploadcharacterised (no SQL change), DEV keys + 54321 documented (ENVIRONMENTS.md §3.6)- R5.6 plan
.claude/tasks/plans/2026-10-24-rust-r5-6-fingerprint-switch.md(4 decisions open) - gates: round 1 check:all 03:39:24, security PASS (2 MEDIUM, 6 LOW), verifier ECARTS(2) → positional-parent bypass fixed (
1ec9e1b); round 2 check:all 03:51:55, verifier K3/K4 behaviour MET, 2 formal gaps → contract Clarification (owner to confirm) → checkpoint, STOP (no R5.6 without signal)
- LOW:
- R5.6 preparation (owner 2026-10-24 « arbitrage D-R5.6 »; nothing active)
domain/sheet/fingerprint.rs+sheet_fingerprinttests (RFC, V8, Node differential, draft 12d7…, registry, census 123/124 alias)- switch patch
.claude/tasks/plans/r5-6-switch.patch(5-consumer wiring rehearsed green rust:check + check:all 14:32:05; whole patch: 4 curation tests fail on current seed, +3 on switched seed, RUST.md §11.19), files restored - gates on
3b9a395: check:all 14:41:00, security PASS (M1 snapshot stamp → owner, M2 block strictness partly fixed), verifier ECARTS(2) (report-compare build in patch fixed, false "rehearsed green" corrected) → checkpoint, STOP (switch on signal)
- R5.6 rehearsal (owner 2026-10-24 « corrections préalables à la bascule »; contract
.claude/tasks/contracts/2026-10-25-rust-r5-6-rehearsal.md; isolated worktree, branch inactive)- M1 option 1 (input.rs), directional equivalence + fingerprint_verified, v0/v1 load rules, report-compare status, generator order
- original contexts (O7, O10, R2 Zod, R5.1 ledger, TS golden, app goldens) + separate post-switch tests; rust:check + check:all 00:56:22 green on switched state
- gates: security PASS (1 MEDIUM, 6 LOW), verifier ECARTS(3) = export grants alias without fingerprint_verified (fix needs snapshot_rules.rs, outside scope) → checkpoint, STOP, owner decision
- R5.6 M1 correction + full rehearsal (owner 2026-10-25; snapshot_rules.rs authorised): recognises_historical_stamp, null block refused, warnings allowed, depth 128; fresh worktree r56final: rust:check + check:all 01:53:59 green; security PASS (LOW); verifier CONFORME 8/8 → checkpoint, STOP (activation on signal)
- R5.6 D-R5 switch ACTIVE (owner go 2026-10-25, commit
9e87016): seed sheet-ref 03e7f6ab + migration map 0e991bc2 only, --check 0 diff, rust:check + check:all green, security PASS LOW, verifier ECARTS(1)=S7 wording → Clarification; BDR-070; rollback not transparent for post-switch reports (settle before user release) → checkpoint, STOP, no merge, no R5.7 - R5.7 consumer census, domain fixtures moved, packages deleted, xmldom + prettier out of the lockfile, docs, ledger;
pnpm check:all; merge only on the owner's signal (owner go 2026-10-25 « Validation R5.6 et autorisation R5.7 »: rollback limit accepted on the branch, no intermediate release; plan.claude/tasks/plans/2026-10-25-rust-r5-7-cleanup.md, contract.claude/tasks/contracts/2026-10-25-rust-r5-7-cleanup.md; stop at the checkpoint, no merge)- R5.7a census + matrices (LEDGER 407: 256 ported, 149 replaced, 2 deleted, 0 gap; FILES 112), 15 anatomy + 1 domain uncovered contracts ported first (+19 Rust tests, curation_leaves.rs new)
- R5.7b
report-v2.*.json→crates/core/tests/fixtures/(sha256 kept), Rust readers repointed - R5.7c deletion (anatomy, domain, TS upload script, legacy scripts, Dockerfile lines, lockfile by
pnpm install) - R5.7d census tests (r4 xmldom inverted + non-vacuity, R5 census, ESLint ban)
- R5.7e historical reproducibility documented and rehearsed (
59521dc: git status clean, 144+262;756b7ef: 2 files, 144+263) in a detached worktree - R5.7f docs (CLAUDE.md, WORKSPACE, packages/README, README, RUST.md §11.23, CHANGELOG, sheet model, SUPABASE, TEST_STRATEGY, PDF-FORMAT)
- R5.7g checks (frozen install, rust:check, check:all green 03:58:13, --check 0 diff, TS 943→546, Rust 364→383) + fresh security + fresh verifier → checkpoint, STOP
- R5.7h owner validated R5.7 2026-10-25 (« dernière vérification pré-fusion »); C6 Clarification (tsx = vite optional peer, accepted); census refuses
#[ignore]targets (cd69f0e); pre-merge rerun on27bf59c: frozen install + dedupe ok, check:all green 13:41:41, --check 0 diff, report:compare ok, security PASS, verifier CONFORME 10/10 (.claude/audits/2026-10-25-rust-r5-7-premerge.md) → STOP, merge--no-ffinto develop only on the owner's signal - later maintenance (owner accepted temporarily 2026-10-25, LOW, security final): census regex still accepts
#[ignore]before#[test]or#[cfg_attr(…, ignore)](no mandatory target affected); fix = inspect the whole attribute block abovefn <test>( - before any release or public exposure (owner 2026-10-25, not blocking develop):
pnpm audit57 advisories, all pre-existing on develop; treat or qualify each one, keeping its published severity apart from Faunosteo's actual exposure. Priority: zod 3.25.76 GHSA-mrhx-c7xc-m3w5 (oversized constrained collections; fixed 4.6.6 = major): first map every path that feeds untrusted data to Zod and its size guards, then plan the zod 4 migration as its own chore. Others: tinypool/vitest, vite 7.3.6 dev server (LAN), happy-dom, pnpm 10.13.1, brace-expansion, js-yaml, nanoid, postcss, source-map-js - if a new anatomical changeset lands: owner decision on a new baseline for the Rust tests pinning the real draft (46 changes, 825 records, 612 fates, fingerprints); oracles never regenerated to hide a divergence
- owner action (non-blocking):
packages/{anatomy,domain}/node_modulesleftovers (git-ignored pnpm symlinks; recursive delete refused to Claude) →rm -r packages/anatomy/node_modules packages/domain/node_modules && rmdir packages/anatomy packages/domain
- R5.1 freeze + D-R5 study (2026-10-22): inventory
- DEV hardening (owner 2026-10-24, risk accepted temporarily, not scheduled): Supabase on CLI demo keys + 54321 LAN-open (rootless, UFW allow incoming, no 54321 rule) → own JWT secret/signing keys via env() or narrower 54321 rule before any untrusted device or user (ENVIRONMENTS.md §3.6); never these keys in production;
confirm_sheet_asset_uploadobject check before public exposure - separate chore (D-R7): form constraints module + PGlite
pg_constraint/config.toml parity test
- R0 foundation (GO 2026-10-12, BDR-045; branch feature/rust-r0-foundation; Annex B; owner constraints: builds reproducible in Docker, no Rust on the VPS, live deployment untouched, frontend never loads the module, no R1):
-
Release 0.2.0 (branch release/0.2.0 = Steps 3–6, version.txt + package versions 0.2.0, CHANGELOG [0.2.0] 2026-10-11): deploy-trigger check done 2026-10-12 (CI = branches main/develop only, no tag trigger, no deploy job, docker job builds
faunosteo:cilocally; hooks push only; DEPLOY.md deploy = manual on the VPS). Default 0.2.0 build carries NO sheet (SHEET_BUNDLE=none) → the live local tool must not be redeployed from main without--build-arg SHEET_BUNDLE=draft. Finish via /release-candidate (finish + tag span, tag push on explicit go); CHANGELOG back-merge conflict expected (Unreleased Step 7 above [0.2.0]). Awaiting the user's go.
Product roadmap V1 (owner 2026-10-25 « Validation de l'inventaire et cadrage P0 / V1-1 »)
Order (BDR-071): P0 docs + decisions → V1-1 clients and animals → V1-2 sheets served from Supabase → V1-3 cloud bilans + history → V1-4 stored PDF + authorised sharing → V1-5 cross-cutting mobile + a11y pass (a11y and security apply at every step). C4/C5/C6 and the V1-1 business decisions ratified 2026-10-25 (BDR-073). No migration, component, API, dependency or table before the owner validates the V1-1 technical design at the preparation checkpoint; no merge into main or develop without the owner's go, no release/0.2.0 change, no deploy, no Supabase DEV change; equine draft stays unpublished.
- P0 docs realignment (docs only; branch
chore/p0-doc-realignmentcreated by the owner off develop, the working-tree edits carried over; merge into develop on the owner's go only)- census of stale text in active docs (worker Node / Edge Functions, step numbers, roles, Step 13 "published", deleted tools, OPEN_QUESTIONS statuses)
- IMPLEMENTATION_PLAN: roadmap V1 section, step statuses, D-R9 in Steps 8/15/19/21/23/24/26, Step 13 DoD draft-only, deleted tools, Step 22 D-R8
- BACKEND_ARCHITECTURE §1/§5/§6/§7/§9, DOMAIN_MAP §1/§6/§7/§12/§18, design README owners, snapshot notices (FRONTEND_ARCHITECTURE, MIGRATION_STRATEGY, REPOSITORY_MIGRATION_MAP, TEST_STRATEGY), PDF_IMPORT_HARDENING step numbers, README DEV origin, CLAUDE.md roadmap line
- OPEN_QUESTIONS: status per item with the deciding BDR / D-R, C4/C5/C6 owner hypotheses, real conflicts listed for arbitration
- owner arbitration 2026-10-25: README separates public 0.1.0 / develop / DEV-only / planned; CHANGELOG Unreleased note (nothing deployed, 0.2.0 section on its branch); DEPLOY status notice (historical, unverified, would-break, security prerequisites) + CSP examples marked not production-ready (fixes stay RR-5); OPEN_QUESTIONS conflicts 1-4 resolved (curation-only path until Step 17 confirmed); BDR-071, BDR-072 (BDR-041 step number), EVAL-034
- commit on the branch, push
- merged into develop 2026-10-25 (no-ff
dae74e0, owner go); V1-1 waits for ratification of contract §9
- V1-1 functional contract
docs/development/V1-1_OWNERS_ANIMALS.md(no code); correction: inventory criterion 4 (validation in crates/core) contradicted D-R7 → form constraints TS + SQL CHECK + parity test (EVAL-034)- owner orientations D1-D9, D16, C4-C6 integrated as proposals (§9.1, SQL / permission impact marked); sub-choices D4a, D6a, D6b, D7a, D9a (§9.2); D10-D15, D17 kept open (§9.3); legal basis, client information, retention framed before public exposure (§9.4)
- owner ratification 2026-10-25 (brief « V1-1 : ratification des décisions métier et préparation de l'implémentation », BDR-073): D1-D9a, C4-C6, D16, D15 principle, naming
- V1-1 clients and animals: branch
feature/v1-1-clients-animals(gitflow start off develop5502617, pushed); contractdocs/development/V1-1_OWNERS_ANIMALS.md(§3 nomenclature, §8 SQL, §9 RLS/RPC, §10 D15, §11 UI, §12 tests, §13 decisions). Each step = commits on this branch; owner validates after V1-1.1 and after the first UI step; merge into develop only on the owner's go. Gates every step:pnpm typecheck && pnpm test:run && pnpm lint; SQL steps alsopnpm db:reset && pnpm db:test,pnpm db:types:check; UI steps through the design toolchain (Build UI) followingdocs/design/.- V1-1.0 preparation (docs only): branch checks (develop = origin/develop
5502617, tree clean, P0 merged dae74e0; two stale R5.6 rehearsal worktrees in an old session scratchpad hold edits, left untouched); contract statuses approved; nomenclature; SQL schema M1-M4; helpers, RLS, RPCs, failures, definer statement; D15 thresholds; journeys, forms, a11y; pgTAP/e2e/Playwright plan; decisions N1-N9, D10-D14, D17, U1-U3; BDR-073; OPEN_QUESTIONS C4/C5/C6/Q6; plan Step 10/12 notes; DOMAIN_MAP, CLAUDE.md, README, TEST_STRATEGY citations; 3 fresh plan challengers (correctness, robustness, simplicity: CONCERNS, findings integrated: search keys, phone search, GoTrue admin path, correlation header cap, idempotent creates, locks, identical errors, backfill function, behavioural parity, Chromium-only V1-1, beforeunload guard, derived values, 6 steps / 3 migrations) - CHECKPOINT: owner validated the contract architecture + N1-N9 2026-10-25 (brief « Validation du contrat V1-1 et autorisation de V1-1.1 Workspaces »); D10-D14, D17, U1-U3 stay contract-level until their UI steps; only V1-1.1 authorised
- V1-1.1 Workspaces foundation (owner brief 2026-10-25; isolated test DB only, DEV stack untouched, stop at checkpoint)
- contract: N1-N9 as decided (N4 voiding instead of deletion, N6 budget per workspace + concurrency rule, N7 effective-privilege wording, N9 metadata list), M1 as-built notes
- M1
20261025100000_workspaces.sql: enums, tables, deferred personal-holder invariant,ensure_personal_workspace+ trigger + backfill, helpers,log_eventcorrelation cap + NOT VALID CHECK, grants (service_role included), RLS - pgTAP
012_workspaces.sql+001_schema.sqlcensus; schema-types map; config test (enable_confirmations, schemas) - isolated real stack in the scratchpad (own network, loopback ports only): migrations from zero, pgTAP, GoTrue sign-up + confirmation, PostgREST role probes, concurrency + idempotence, seed accounts
- types regenerated from the isolated DB;
pnpm typecheck && pnpm test:run && pnpm lint - docs: SUPABASE.md §3.3 (+ DEV procedure), BACKEND_ARCHITECTURE §4.1/§4.2, TEST_STRATEGY counts, IMPLEMENTATION_PLAN note, CLAUDE.md; BDR-074, journal
- fresh verifier + security audit on M1;
pnpm rust:check,pnpm check:all; commits pushed; checkpoint report (owner validated V1-1.1 2026-10-25, brief « Validation V1-1.1 et autorisation V1-1.2 Données clients ») - Deviation from the line below:
packages/supabase/src/workspaces.tsdeferred to V1-1.2 (no consumer before the clients access layer; brief authorises M1 + tests) - Objective: every account has exactly one personal workspace, readable by itself only, with the helpers every later table uses; audit rows no longer sized by the caller
- Depends: checkpoint
- Files:
supabase/migrations/<ts>_workspaces.sql;supabase/tests/012_workspaces.sql;supabase/tests/001_schema.sql(tables, RLS, privileges, helper census);packages/supabase/src/database.types.ts(regenerated);packages/supabase/src/workspaces.ts(fetchPersonalWorkspace) +src/index.ts;packages/supabase/tests/db/schema-types.test.ts; config test (enable_confirmations = true);docs/development/SUPABASE.md - Migration M1: enums
workspace_kind,workspace_member_role;workspaces,workspace_members;private.caller_workspace_ids,private.writable_workspace_ids, triggerprivate.create_personal_workspaceafter insert on profiles,private.backfill_personal_workspaces()called once;private.log_eventredefined (same signature,x-correlation-idkept only if^[A-Za-z0-9-]{1,64}$) + NOT VALID CHECK; revoke all (public, anon, authenticated, service_role) + column grants; RLS - Tests: trigger; backfill function on a profile inserted with the trigger disabled (idempotent); one personal workspace per account; A/B isolation; unconfirmed, deactivated, platform staff, anon, service_role see nothing; empty account deletion removes its workspace; oversized/malformed correlation header stored null; helper census (prosecdef, search_path, ACL); PGlite + real stack
- Acceptance: gates green; every account of
seed.sqlhas one workspace + holder row afterpnpm db:reset - Security: no platform-role branch; no
using (true); helperssearch_path = '', EXECUTE only where evaluated; email confirmation checked in SQL;log_eventcallers unchanged - Stop if:
auth.usersjoin behaves differently on PGlite and the real stack; the profiles trigger interferes withhandle_new_auth_useror sign-up; an existing policy would need editing beyond thelog_eventredefinition
- V1-1.2 Clients data (owner brief 2026-10-25; isolated stack only; DEV untouched; stop at checkpoint before V1-1.3)
- M1 closure: types re-checked with the official generator against an isolated DB holding M1 (diff 0); sandbox tool committed (
scripts/db-sandbox.sh,pnpm db:sandbox: rootless, loopback, own ports, no volume, generated secrets outside Git, fresh + upgrade, officialsupabase test db/gen typesvia--db-url); owner DEV procedure for M1 (target, history, backup incl. auth, restore check,db:testnon-destructive check) rehearsed on the sandbox; LRN-080/081 - M2
<ts>_clients.sql: unaccent,private.fold_text,client_kind,clients(+create_request_digestfor divergent replays), budget table +private.consume_write_budget(UTC fixed hour/day windows, row lock, last lock taken), RPCs create/update/set_archived/search, N9 audit policy, grants, RLS - pgTAP 013; harness loads unaccent;
field-limits.ts+ behavioural parity test; types; census - sandbox suite (vitest, real GoTrue/PostgREST sessions): M1 regression, clients HTTP, concurrency (creates, replay, divergent replay, stale revision, archive/restore race, budget limits, no deadlock), 20 000-client search timing
- docs: contract (budget, divergent replay, search_clients without current_animal_count until M3), SUPABASE.md, TEST_STRATEGY, BDR-075, journal
- fresh verifier + security audit (PASS; ECARTS closed); sandbox hardened; rust:check, check:all green; checkpoint
- Deviation: access layer
clients.ts+ workspace read move to V1-1.5 (first consumer; brief §6 scope lists no access layer) - Objective: clients created, edited, archived, restored and searched through RPCs with the D15 guards, isolated per workspace, proven on the real stack
- Depends: V1-1.1; N2, N3, N6, N9 decided
- Files:
supabase/migrations/<ts>_clients.sql;supabase/tests/013_clients.sql;packages/supabase/tests/db/harness.ts(loadunaccent);packages/supabase/src/field-limits.ts+tests/db/field-limits.test.ts(behavioural parity, code points);packages/supabase/src/clients.ts(accessors, closed failure kinds) + unit tests;packages/supabase/tests/e2e/clients-animals.e2e.ts(seed and teardown through the existing psql helper),scripts/clients-animals-e2e.sh, root script (name to confirm); types regenerated - Migration M2:
unaccentinextensions;private.fold_text;private.consume_write_budget(p_workspace_id)(N6: per workspace, UTC hour/day windows, budget row lock taken last; contract §9.3, §10); enumclient_kind;clients(name_key,search_key,phone_digits,create_request_id);create_client,update_client,set_client_archived,search_clients; N9 condition onaudit_logs_select_admin; grants; RLS - Tests: contract §12.1 rows for clients (whole-error identity, no lock outside the workspace, archived before conflict, replayed request id, caps, budgets, audit without values, search accents/case/backslash/phone formats/keyset); parity test; e2e cross-account + service key refused + GoTrue admin delete; search time on 20 000 clients recorded
- Acceptance: gates green; e2e green on the local stack; measurement written in the contract
- Security: constraint and parse errors caught inside RPCs; text parameters parsed in the body; search through POST; definer census
- Stop if:
unaccentcannot load on PGlite or the CLI stack; the measurement is above 100 ms p95 (index decision for the owner); a CHECK cannot be mirrored in TypeScript
- M1 closure: types re-checked with the official generator against an isolated DB holding M1 (diff 0); sandbox tool committed (
- V1-1.3 UI foundations (owner brief 2026-10-25 « Validation V1-1.2 et autorisation V1-1.3 Socle UI »; no M3, no client/animal screen, DEV untouched, stop at checkpoint)
- V1-1.2 closure: db:sandbox final check (fresh, upgrade, types, argv scan, negative cases, DEV fingerprint); defect
upbad args started containers → fixed57922e0, rerun green - owner choices 2026-10-25: e2e backend = isolated stack (Playwright routes Supabase calls to
pnpm db:sandbox); scriptspnpm e2e:ui(no backend) +pnpm e2e:shell(sandbox); MobileDrawer on the same modal mechanism; check:all runs e2e:ui when the pinned Chromium is installed, else an explicit SKIPPED line ModalDialogprimitive on native<dialog>+showModal()(platform inertness, Escape via keydown/cancel → onClose, consumer decides, opener restore + nearest-container fallback, scroll lock CSS);Dialogon it (aria-labelledby title, optionaldescription→ aria-describedby); confirmation consumers pass their message as description;MobileDraweron it (closes at lg)- unit tests (happy-dom: wiring only): Escape/cancel/close/backdrop → onClose, never self-close, name + description, restore + fallback; existing suites green
- Playwright + axe dev deps pinned (license, transitive census), Chromium download (no sudo); configs
e2e/playwright.{ui,shell}.config.ts, Vite on 127.0.0.1 dedicated ports, request allowlist (anything else aborted and fails the test) - e2e:ui: harness page
e2e/harness/dialog.html(dev server only, not in the build): open, initial focus, Tab/Shift+Tab, containment, Escape allowed/refused (twice), close button, restore, opener gone, background inert + no scroll, name/description, long content, 375 px, no horizontal overflow, axe FR/EN; local tool dialogs (disclaimer, edit infos) desktop + 375 - e2e🐚 fictitious account through the sandbox admin API, clean avatar seeded; login → dashboard, drawer at 375 (containment, Escape, restore), avatar remove dialog (name, description, Escape, confirm → opener gone → fallback), FR/EN, axe, request URLs free of fixture values
- defect found by the shell suite: the photo confirmation closed before the removal, focus fell on the page once the button vanished → confirmation open until settled, deferred restore, sr-only file input out of the tab order (
8371aa0); mutation-checked with a slowed RPC - Deviation: contract §12.5 said DEV origin; suites run on loopback servers against the isolated stack (owner choice); TODO line "users through the admin API, DEV origin, service key from env" superseded
- check:all stage; docs (contract D13/D14 final + D11 note, TEST_STRATEGY, browser tests doc, SUPABASE §5.1 e2e-shell, CLAUDE.md map + commands); D11 three-way comparison
- gates: typecheck, test:run, lint, e2e:ui, e2e:shell, rust:check, check:all; fresh verifier + security audit; commits pushed; checkpoint report (verifier CONFORME 8/8, security PASS, check:all green 23:41:29; refused URLs masked after audit LOW)
- Objective: real-browser harness and accessible dialogs before the first screens
- Depends: D13, D14 approved
- Files:
apps/app/package.json+pnpm-lock.yaml(@playwright/test,@axe-core/playwright, dev only);apps/app/playwright.config.ts(Chromium desktop + 375×667);apps/app/e2e/(fixtures: users through the admin API, DEV origin, service key from env never committed);apps/app/src/components/ui/Dialog.tsx(inert+ restore to opener) + tests; root script (name to confirm) - Migration: none
- Tests: Dialog containment, Escape, focus restore; editor dialogs unchanged; Playwright smoke (login → dashboard) with axe and the request-URL check
- Acceptance: smoke green; axe 0 serious/critical on the smoke screens, or pre-existing violations listed under RR-7
- Security: dependencies named with purpose; lockfile reviewed; no secret in fixtures or reports
- Stop if: the Chromium download is refused or fails (owner decides); a fix outside V1-1 scope would be needed for axe
- V1-1.2 closure: db:sandbox final check (fresh, upgrade, types, argv scan, negative cases, DEV fingerprint); defect
- V1-1.4 Animals and relations data (owner brief 2026-10-26 « Validation V1-1.3 et autorisation V1-1.4 Animaux et relations »; isolated stack only; DEV untouched; no screen; stop at checkpoint before V1-1.5)
- V1-1.3 closure: owner validated (CONFORME 8/8, security PASS, check:all green)
- V1-1.3 follow-ups asked by the brief §2 (test code only): axe KNOWN exceptions scoped to their route and node html so a new screen never inherits them; check:all prints an explicit PASSED / SKIPPED (env missing) / NOT RUN line per browser suite, failure stays a stop
- M3
20261026100000_animals_relations.sql: species rows (8 + other) + table comment;animal_sex,animal_relation_role;animals(+create_request_digest),animal_client_relations(composite FKs, partial unique index current = not ended and not voided, digest);private.latest_record_date(timestamptz)(tomorrow UTC, testable); RPCscreate_animal(optional initial relation, 2 audited writes),update_animal,set_animal_archived,create_animal_client_relation,end_animal_client_relation,update_animal_client_relation,void_animal_client_relation; readssearch_animals,list_client_animals(cursorsort_key= current/former prefix + name_key),client_archive_preview;search_clientsdropped and recreated withcurrent_animal_count; lock order workspace → animal → relation → client → budget; caps 20 000 animals, 20 current / 200 total per animal, 100 000 per workspace (every row counts toward the totals, voided and ended included); grants, RLS - pgTAP
014_animals_relations.sql(258); 013 alias list for the new search column; schema-types map; field-limits (animal name, breed, species detail, birth year, date floor) + parity test - db-sandbox
up upgrade <version> [<then>]so the three migration states run (+ an M1+M2 base → M3): fresh; pre-M1 → M1..M3; pre-M1 → M1 (backfill) → M2+M3 - sandbox suite
animals.sandbox.ts(18): per-role HTTP, identical refusals, concurrency (replays, divergent replay, identical relations race, end/void race, caps under concurrency, shared budget clients+animals, relation create vs client archive, mixed burst no deadlock), D9a via GoTrue admin delete - types regenerated from the sandbox; gates (typecheck, test:run, lint, db:sandbox test-db/test/types --check in 3 states, e2e suites, import:equine --check, rust:check, check:all)
- mutations of M3: 14, all caught (M6 voided-only count and M9 foreign client lock only after the tests were strengthened)
- fresh verifier CONFORME 11/11 + security audit PASS (0 HIGH)
- docs: contract §8.3 as built, SUPABASE.md §3.3 DEV procedure to M3 (not run) + §3.5, TEST_STRATEGY, CLAUDE.md, plan note, backend table
- BDR-077, LRN-083/084, EVAL-039, journal; commits pushed; checkpoint report
- Deviation: access layer
{animals,relations}.tsmoves to the UI steps (first consumer), asclients.tsdid at V1-1.2 - Objective: animals with the ten species rows and the D6b birth model, relations with history, never across workspaces
- Depends: V1-1.2; N1, N4, N5, N8 decided
- Files:
supabase/migrations/<ts>_animals_relations.sql;supabase/tests/014_animals_relations.sql;field-limits.ts+ parity test;packages/supabase/src/{animals,relations}.ts; e2e extended; types regenerated - Migration M3: species rows (9 +
other), table comment; enumsanimal_sex,animal_relation_role;animals,animal_client_relations(composite FKs, partial unique index, request ids);create_animal(optional initial relation),update_animal,set_animal_archived,search_animals, relation create/end/update/void (N4:voided_at,void_animal_client_relation, never delete);list_client_animals,client_archive_preview; grants; RLS - Tests: five birth states;
species_detailiffother; inactive species; dates incl. 31 December UTC; cross-workspace refused by RPC (42501) and by FK; duplicates and the concurrent race; successive relations; archived interactions (§7.1) under locks; caps per animal and per workspace; derived values; D9a (account with records cannot be deleted, empty one is); report, sheet and editor species ids unaffected - Acceptance: gates green; e2e green; local tool and PDF unchanged
- Security: same whole error for every foreign id; FK proof independent of the RPC; animal-then-client lock order
- Stop if: N1, N4, N5 or N8 undecided; any change needed in report, sheet or editor code; the D9a guard blocks a flow the owner did not foresee
- V1-1.5 Clients UI (owner brief 2026-10-26 « Validation V1-1.4 et autorisation V1-1.5 Interface Clients »; isolated stack only; no animal screen; stop at checkpoint before V1-1.6)
- V1-1.4 closure: owner validated (CONFORME 11/11, security PASS); species_filter + replay order accepted
- owner choices 2026-10-26: U1 « Afficher plus » (keyset, page of 25 + 1 probe); U2 « Archivés » toggle; client page animals = read-only list (list_client_animals, no link, no add); « premier animal » section deferred to V1-1.6
- access layer
packages/supabase/src/{workspaces,clients,species,records}.ts: personal workspace read, client reads/RPCs with explicit columns, keyset cursors, closed RecordFailure kinds (contract §9.4 + network, session_expired), Zod-checked RPC results; unit tests + real-PostgREST sandbox test of the same functions - authStore: personal workspace state (loading / ready / inactive / unconfirmed / missing / error) loaded with the account; identity change clears profile, roles, avatar, workspace at once and drops late responses of a previous user
- app: routes /app/clients, /new, /:clientId, /:clientId/edit behind a workspace gate (remount per workspace); list (debounced search, toggle, « Afficher plus », states); detail (contact links, archived read-only, animals read-only, archive dialog with preview, restore); form (D-R7 schema on field-limits, phone entry rule, ISO country list via Intl.DisplayNames, request id per intent, conflict shows saved values, archived refusal); leave guard (beforeunload + in-app link clicks in the shell + Cancel; browser back not interceptable, documented); nav entry after Tableau de bord (mockup order); FR/EN
- unit tests (schema, phone rule, countries, access mapping, store identity change, routes states, archive dialog, conflict, guard) + Playwright
e2e/shell/clients.spec.tson the sandbox (journeys, two accounts, pagination, keyboard, FR/EN, 375, axe without inherited exceptions, conflict, retry idempotence, error states, URLs free of fixture values) - gates (typecheck, test:run, lint, build, e2e:ui, e2e:shell, db:sandbox test-db/test/types --check, import:equine --check, rust:check, check:all), impeccable detect, fresh verifier + security audit
- docs: contract §11.7 as built, FRONTEND_ARCHITECTURE, BROWSER_TESTS, SUPABASE §3.3 note, design README, CLAUDE.md map; BDR, EVAL, journal; commits pushed; checkpoint
- gate fixes: shell HTML report removed (kept typed passwords), ready workspace kept during re-read, not-found heading focus; security PASS, verifier CONFORME 11/11 (round 3); check:all green 02:15:51
- Deviation: leave guard extended from Cancel to every in-app link; search term not kept on back navigation; phones shown E.164
- Pending owner: M1-M3 on DEV (SUPABASE.md §3.3) before the LAN check; D11 decision before V1-1.6
- Objective: list and search, create, edit, detail, archive and restore clients, FR/EN, phone and computer, keyboard
- Depends: V1-1.2, V1-1.3, V1-1.4 (client page lists animals); D11, U1, U2
- Files:
apps/app/src/app/App.tsx(routes);apps/app/src/app/routes/app/clients/*;apps/app/src/clients/{validation,useClientForm}.ts;apps/app/src/components/clients/*;SidebarNav.tsx,MobileDrawer.tsx;apps/app/src/i18n/{fr,en}.ts; tests;apps/app/e2e/clients.spec.ts - Migration: none
- Tests: schemas per rule (i18n keys, code points, email pattern, phone conversion); country select from
Intl.DisplayNames; list states; archive with preview and dialog; conflict keeping typed values; beforeunload + cancel guard; not-found for unknown and forbidden ids; Playwright client journeys + keyboard-only + cross-account + request URLs + axe - Acceptance: gates + Playwright green; owner check on phone and computer over the LAN
- Security: only
packages/supabasereaches the API; explicit column lists; no text filter in GET URLs; failures phrased by closed kinds - Stop if: the mockup lacks a pattern the screens need (propose, ask, never invent a direction); a visible choice not covered by §11
- V1-1.6 Animals and relations UI, navigation and closure — VALIDATED by the owner 2026-10-26 (brief « Validation finale V1-1 et préparation de la recette DEV »; owner brief 2026-10-26 « Validation V1-1.5 et autorisation V1-1.6 Interface Animaux et clôture »; isolated stack only; DEV untouched; stop at checkpoint before merge, V1-2 and DEV)
- V1-1.5 closure: owner validated (CONFORME 11/11, security PASS, check:all green); reserves accepted for V1-1 (search not kept on back, E.164 display, back/forward not guarded), kept in product follow-up
- owner decisions 2026-10-26: D11 drawer only for V1-1 (no tab bar, mockup kept as later UX subject); first animal from the client page (« Ajouter un animal » → /app/animals/new, client passed in navigation state, never the URL; one atomic create_animal); no relation role preselected; relation add as an in-page panel (no modal form), end / dates / void as ModalDialog confirmations; U3 date fills and locks the year; D12 tiles not in the brief's scope → not built, reported
- access layer: records.ts +
duplicate_relation,already_ended;animals.ts(search POST with probe row and species_filter, read by id with explicit columns and uuid gate, create with optional initial relation, update, archive);relations.ts(an animal's relations by one select with the client embedded, voided left out, explicit columns; create, end, dates, void); unit tests + real-PostgREST sandbox suite - app foundations: one RequireWorkspace above clients and animals; species labels loaded once per workspace mount (context, dropped on account change); local-date helper; « Animaux » nav entry after Clients; i18n FR/EN
- animal form: schema on field-limits (D-R7: name, species from the active rows, detail iff other, sex required with no default, breed, birth year/date U3, start date), optional initial client (picker on search_clients, role required once a client is chosen, start date), request id per intent, conflict with stored values, leave guard; create and edit routes
- animal list: debounced POST search, species filter, archived toggle, « Afficher plus », current owners or « Propriétaire non renseigné », states
- animal page: identity, species, sex, breed, birth with its precision, status; relations current / former (voided never shown), client links and
tel:; add panel, end (optional date), dates, void (erroneous entry, final) dialogs pending until settled; archive / restore; archived read-only; same « introuvable » for unknown / foreign / malformed ids - client page: animals as links grouped per animal with their roles, « Ajouter un animal » (pre-associated), « Associer un animal existant » panel (search_animals), none on an archived client
- unit tests (schema, birth, other, sex, relation fields, access mapping, screens: states, idempotent retry, conflict, archive, relations, counts, session) + Playwright
e2e/shell/animals.spec.ts(brief §17 items 1-24, FR/EN, desktop + 375, axe, URLs free of fixture values) - gates (typecheck, test:run, lint, build, e2e:ui, e2e:shell, db:sandbox test-db/test/types --check, import:equine --check, rust:check, check:all), counter-checks, impeccable detect, fresh verifier + security audit
- local gates: typecheck, lint, test:run (60 + 127 + 566), e2e:shell 82, db:sandbox test-db 919 / types match / test 61, import:equine --check 0 diff, check:all green 17:19:26 (rust:check, build, e2e:ui PASSED), impeccable detect 0; counter-checks 12 unit + 2 browser all caught
- fresh verifier + security audit: security PASS (MEDIUM pre-existing sandbox literal password, LOWs); verifier ECARTS (client journey late replay → dropLateReplays) → ECARTS (pgTAP 014 #237 uuid read as date → test fixed) → CONFORME 12/12
- Found:
Carddroppedaria-labelledbysince Step 7 (V1-1.5 section cards unnamed), fixed; Button takesref - Moved to the DEV integration checkpoint below: M1-M3 on DEV, browser acceptance, merge go; the rehearsal dump is no longer on disk (checked 2026-10-26)
- Follow-up at merge: CHANGELOG Unreleased entry for V1-1 (the section describes develop only)
- docs: contract §11.8 as built + D11 + closure inventory, SUPABASE.md §3.3 DEV procedure reviewed, FRONTEND_ARCHITECTURE, BROWSER_TESTS, TEST_STRATEGY, design README (tab bar not reproduced), CLAUDE.md; BDR, EVAL, journal; commits pushed; checkpoint (brief §23, 23 points)
- Objective: animal screens, relation panels on both pages, journeys 1 to 7, D11 navigation, D12 tiles, Definition of Done (contract §12.6)
- Depends: V1-1.5; U3, D11, D12
- Files:
apps/app/src/app/routes/app/animals/*;apps/app/src/animals/*;apps/app/src/components/{animals,relations}/*;AppLayout.tsx,DashboardRoute.tsx; i18n; tests;apps/app/e2e/{animals,relations}.spec.ts;docs/design/README.md,CLAUDE.md, contract "as built",SUPABASE.md, CHANGELOG Unreleased - Migration: none
- Tests: birth input states; « Autre »; « Propriétaire non renseigné »; two-call creation resumed after a failure; end, correct, remove a relation; archived animal frozen; tiles from live counts; Playwright journeys 1-7 + axe; full suites
- Acceptance:
pnpm check:all;pnpm db:reset && pnpm db:test; fresh verifier + security gates; owner LAN check → merge only on the owner's go - Security: as V1-1.5; final RPC surface census for RR-4; guardrails on the new tables
- Stop if: any gate red; any finding HIGH/CRITICAL; as V1-1.5
- V1-1 DEV integration checkpoint (owner brief 2026-10-26 « Validation finale V1-1 et préparation de la recette DEV »; Claude reads DEV only; backup, migration, acceptance and merge are owner actions; no new feature, no migration, no merge)
- git: branch = origin
9f585e9, clean; develop5502617, main605ee7c, release/0.2.0f8d9425= origin; branch adds exactly M1-M3 - read-only DEV preflight (session forced read-only): 9 applied + M1-M3 pending, nothing remote-only, no linked project, no V1-1 object present, types drift = 24 names added 0 removed, 6 accounts = 6 profiles, storage 2 objects / 11 volume files, purge queue 13 due
- scripts read: supabase.sh / dev-env.sh (local CLI, no remote), CLI 2.120.0
test dbcreates + drops pgtap,supabase statusprints keys, e2e:avatar writes beyond its fixture (temp account, bob sign-in, purge-queue drain) - SUPABASE.md §3.3 corrected: read-only helpers, counts + md5 fingerprints, Storage bytes tar, restore check on the sandbox (not the DEV server), post-migration SQL, test effects, failure handling, restore effects; browser acceptance aligned on the brief §11 (19 lines); restore comparison rehearsed on the sandbox (identical, 26 privilege refusals)
- owner brief 2026-10-26 « V1-1.7 validation du préflight »: preflight accepted, owner runs backup + M1-M3. 26 restore errors classified = pg_restore errors, NOT negative tests (25 ACL on Supabase-managed objects + COPY vault.secrets, lossless only with vault empty); §3.3 now checks pg_restore exit (1) + full message/command set, vault count (step 2), migration up + db:test exit, pgtap after db:test, object query for failure; acceptance lines 9 (no duplicate current relation) and 17 (session change, same browser)
- owner brief « dernière correction de la validation des sauvegardes »: 26 vs 28 = report double count (log has 26); rehearsal 2 on sandbox (156 MB, 4 variants, real exit codes):
--no-ownerexit 1 / 26 errors,--no-aclexit 1 + app grants lost,--exit-on-errorexit 1 at COPY, filtered TOC +--single-transaction --exit-on-errorexit 0, 28 rows + 15 privilege lines identical; §3.3 step 2 adds privs.sql + managed.sql (vault 0, D default ACL), step 3b = filtered list (D + 8 entries, DEV D=21 → 29), doc block replayed verbatim exit 0; DEV + sandbox unchanged; LRN-091 - steps 0-3b run by Claude on the owner's authorization (2026-10-27): preflight = 2026-10-26, vault 0, D 21; dump + Storage tar in
~/faunosteo-backups(600, dump sha256); restore check run 1 exit 1 (rolesupabase_functions_adminmissing in the sandbox), owner option A (NOLOGIN role, sandbox only), run 2 exit 0, 28 + 15 lines identical; LRN-092 - step 4 run by Claude on the owner's authorization:
migration upexit 0, exactly M1-M3; post.sql, counts deltas, types check all as expected; DEV data unchanged pnpm db:teston DEV: run 1 exit 1 (919 planned, 915 run, 914 passed: 007 storage collision, 010 13 due purge entries; 012-014 passed; DEV unchanged, pgtap absent after)- 007 + 010 made independent of the base's data (007: seed key only, confirmation cleared in-tx, 20 assertions; 010: section 0 leases the base's queued work in-tx, leftovers by fixture prefix, 141); sandbox A clean + B DEV-like and latent conditions: old FAIL reproduced, new PASS 921; 11 mutations detected on A and B (same set as the old suites); LRN-093
- rerun on DEV on the owner's go (2026-10-27): exit 0, 14 suites, 921 assertions, 83 integrity lines identical before/after, pgtap absent after
- owner: browser acceptance on DEV (2026-10-27): 19 lines FR detailed, EN validated as a whole + 4 lines at 375 px recorded, isolation A/B/owner; RESP-01 closed (fixed
a70166e, owner counter-check 6 PASS); AVATAR-01 class A, non-blocking (DEV worker stays stopped, Alice'suploadedrow kept) - post-acceptance fixes (owner brief « corrections post-recette RESP-01 et diagnostic AVATAR-01»; no DEV write, no worker on DEV, no migration, no merge)
- RESP-01: owner's global overflow = browser zoom (owner's manual DEV measures, no zoom: /app and /app/clients 375 + 320 no overflow); real defect shown on the sandbox: dashboard grid has no explicit column below md, its implicit
autotrack takes the cards' min-content, the account card's e-mail never truncates → overflow from ~31 chars at 320 px, 44 chars overflow 320-430 px. Fix: explicit one-column track, e-mail wraps instead of being cut - RESP-01 tests: e2e:shell responsive sweep 320/360/375/390/430 + desktop, FR/EN, long content (dashboard, client list/new/edit/page, animal list/new/edit/page, archive dialogs, drawer), e-mail fully visible
- AVATAR-01: read-only DEV (clean photo kept, attempt
uploaded0 attempts + quarantine object, superseded onedeleted, worker stopped 10 days) = STORAGE.md §4 step 4 by design; isolated repro on the sandbox: worker stopped → 30 s → message + rowuploaded; worker on the sandbox network →clean; classified A (expected without a worker; side finding pre-V1-1: a full reload does not resume the waiting row); open until the owner decides how DEV runs the worker - gates: check:all, fresh verifier, security audit; docs (recette registry, SUPABASE.md acceptance note), registries; commit + push. Done: check:all exit 0 (cargo 1548 passed / 3 ignored, vitest 566 + 127 + 60, e2e:ui 26), e2e:shell sandbox 86 passed, responsive 4/4 after the fixture domain fix; verifier CONFORME 8/8; security PASS (2 LOW: fixture domain applied, pre-existing uuid interpolation noted); LRN-094. Next: owner counter-check of the dashboard at 375 px on DEV
- RESP-01: owner's global overflow = browser zoom (owner's manual DEV measures, no zoom: /app and /app/clients 375 + 320 no overflow); real defect shown on the sandbox: dashboard grid has no explicit column below md, its implicit
- after the owner's results: fixes if any (branch, gates, fresh verifier + security), CHANGELOG Unreleased, TODO closure, final report; merge only on the owner's explicit go
- Owner cleanup (optional): rehearsal leftovers
/tmp/claude-1000/-home-bchanot-Documents-faunosteo/8d6890e5-060c-431d-b99f-545f2e315333/scratchpad/rehearsal/(3 small files, fictitious data); the backup folder~/faunosteo-backupsis kept until the acceptance is validated
- git: branch = origin
- V1-1.0 preparation (docs only): branch checks (develop = origin/develop
- AVATAR-02 (ticket, out of V1-1; not created in Gitea: no Gitea CLI or token on this machine,
ghis GitHub only) « Reprendre le suivi d'une photo en attente après rechargement de la page »- Context: avatar processing is asynchronous (STORAGE.md §4): begin → quarantine upload → confirm (
uploaded) → worker →clean/rejected; the page polls its own row 1 s, 30 s at most - Repro (isolated stack only): upload a photo, leave the row
uploaded(worker stopped), full page reload before processing - Observed: AvatarSection mounts before the auth store has read the rows (
avatarnull) → phase idle, old photo shown, « Modifier » / « Supprimer » enabled, no polling; a new save supersedes the waiting row (deleted). An in-app return resumes. Pre-V1-1 (Step 8 / R1 mount logic) - Expected: once the rows arrive, find the active waiting asset, resume its polling, show a coherent state; never create a second upload nor replace the first by the resume itself
- Cases: worker stopped (long-processing message, honest wording), processing finished during the reload (
cleanshown, no stale message),rejected(message per code),deleted/ superseded, read errors per the closed AssetFailure kinds; own rows only (RLS unchanged) - Tests: unit (store arrives after mount), e2e:shell on the sandbox with the worker stopped and running (gateway + worker on the sandbox network, as the AVATAR-01 repro); never DEV
- Limits: frontend only; no Storage contract, RPC, RLS, worker or migration change without owner approval
- Context: avatar processing is asynchronous (STORAGE.md §4): begin → quarantine upload → confirm (
- Code debt (not P0, no change on the doc branch):
docker/nginx.confstill haslocation /species/(public/species deleted at Step 5); remove with its ownchore/orbugfix/branch
Release readiness track (owner 2026-10-25, distinct from the functional roadmap; nothing here authorises a release or exposure)
Inventory: .claude/audits/2026-10-25-functional-inventory.md. Each item: treat or qualify before any release or public exposure; not fixed now unless an active critical flaw is shown.
- RR-1 npm advisories (57, pre-existing; published severity kept apart from Faunosteo exposure). Zod 3.25.76 GHSA-mrhx-c7xc-m3w5 first: Zod parses only forms, the practitioner cache and one RPC result, no collection schema found; untrusted files go through the Rust core caps (PDF 50 MiB / 16 MiB attachment, depth 64, 400k values; sessionStorage value budget). Plan zod 4 as its own chore; drop zod from core-wasm
dependenciesif only its tests use it - RR-2 fingerprint rollback limit (BDR-070, RUST.md §11.22): choose before a user release: ship the switch with the release, or ship the alias registry in any build that can be rolled back to
- RR-3 RLS/SQL before exposure:
confirm_sheet_asset_uploadchecks no object size/existence (R5.5 L5); guardrails WARNspecies_select_active; SB-RLS-LIVE manual check; verification gate onset_sheet_visibility(BDR-033, Step 9); PDF_IMPORT_HARDENING §6 items 12, 15, 18 + device items 5, 6, 7, 9, 20; MFA (has_mfa(), enrolment, admin enforcement) - RR-4 API trust boundaries: direct export API trusted for what it declares (RUST.md §11.22),
export_from_envelopeL6, RPC surface review (authenticated 17, service_role 9, anon 0), worker service key readable by the docker group (DEPLOY.md) - RR-5 production configuration: CSP example in DEPLOY.md lacks
'wasm-unsafe-eval'and the Supabaseconnect-src; compose publishes 8080 on all interfaces while DEPLOY says 127.0.0.1 (rootful Docker bypasses UFW); stale no-backend DEPLOY sections; Q2 hosting; production SMTP, FR auth email templates, captcha, OAuth ids; DEV hardening (demo keys, 54321 on LAN) - RR-6 dependencies and images: base images by tag only (pin digests), cosign, workflow actions by tag, CI never run (BDR-047), release-images never executed
- RR-7 accessibility: WCAG target to set; dialog focus trap/restore (done V1-1.3, native modal dialog), close button 24 px, canvas zones keyboard-unreachable, axe test (done V1-1.3: e2e:ui, e2e:shell), D2/D5 Context7 items (RUST.md §10.14). Pre-existing serious axe findings let through by exact node in
apps/app/e2e/support/browser.tsKNOWN_VIOLATIONS: LanguageSwitcher label-in-name (« FR » shown, « Passer en français » announced), top bar account link label-in-name (display name shown, « Mon compte » announced), DashboardRoutedlwith a status row lacking dt/dd. Seen outside the scanned states: ObservationCard headernested-interactive+ label-in-name (editor with an observation); moderate: duplicatemainlandmarks (App + routes), no h1 on Home - RR-8 mobile and end-to-end: real-browser e2e for sign-up, login, account, avatar, full editor flow, export, locale, mobile drawer (TEST_STRATEGY §1
apps/app/e2e); per-check device results (J1/J2 recorded as a whole) - RR-9 release 0.2.0 fate (Steps 3–6 on TS engines, 341 commits behind develop): ship, supersede, or rebase; sheet bundle default
none - RR-11 sandbox-only e2e follow-ups (bugfix/avatar-e2e-sandbox-only 2026-11-02, BLK-013, LRN-095; audit
.claude/audits/2026-11-02-avatar-e2e-sandbox-only.md):- V1-2 → develop merge:
scripts/db-sandbox.shconflicts (header, function block, dispatcher, sed range) → take V1-2's file whole,git diff <V1-2 tip> -- scripts/db-sandbox.shempty; keep every protection (constants unconditional,/dev/tcpprobe,docker portcheck, 600 worker env file); V1-2 adoptsnoRedirectFetchin the avatar suite (d3dfd03); doc lines reworded on develop → keep V1-2's text; registry IDs BLK-013 / LRN-095 collide with V1-2's numbering → renumber at integration - old checkouts still hold the DEV scripts (
scripts/avatar-e2e.sh, oldsheet-assets-e2e.sh): main checkout/home/bchanot/Documents/faunosteo(feature/v1-1-clients-animals, merged) and worktreeold-958228a;pnpm e2e:avatarthere targets DEV; agents never run them; owner decides (move main checkout to develop,gitflow.sh delete, worktree removal) - V1-2 session: rebuild
faunosteo_worker:dev(pnpm worker:image, the tag now holds develop's build d841660a) andpnpm db:sandbox up freshbefore its next sandbox run - residual LOW: every docker call follows
DOCKER_HOST/ context;worker_envread by the EXIT trap before assignment (worker_env=beforetrap); literal password of the two throwawayup upgradeaccounts (db-sandbox.sh:182-184); gateway container less hardened than the worker (no--cap-drop ALL/--read-only/ limits); shared container names across worktrees (a concurrent run is killed, fails closed);NODE_USE_ENV_PROXYproxy path (unset in every proof)
- V1-2 → develop merge:
- RR-10 census tools maintenance (LOW
#[ignore]positions) and controlled oracle evolution on a new anatomical changeset
Phase A — DONE (kept for reference)
- Scaffold (deps, configs, Docker, schemas, stubs)
- Lib: id, dates, assert
- Anatomy: parseSvgBones, loadSvg, svgToPng raster
- Zustand store: full action set (initReport, hydrateReport, observation CRUD, conclusion/recommendations/nextAppointment setters, identity setters)
- sessionStorage draft mirror + localStorage practitioner cache (restore path was missing until
f58a49f2026-07-12 — refresh now keeps the session) - UI primitives: Button, Card, Dialog, Input, Label, Select, Textarea, Badge, Chip
- Canvas: AnatomyCanvas (data-state highlighting, async-mount safe), DetailModal
- Observation chain: ObservationList, ObservationCard, PathologyPicker (flat — REMOVED, replaced by FindingsTreePicker B2), VertebraPicker, SeveritySelector, FreeTextPathologyInput
- Report forms + edit-infos dialog + home nav
- Routes: Home, NewReport, Editor (split layout + dialog), NotFound
- PDF pipeline: fonts, header, observationPage (2-col SVG grid), conclusionPage, attachment.ts, export, import
- Docker: Dockerfile, compose, entrypoint.sh runtime env, nginx SPA fallback
- Brand identity via env (ConfigProvider)
- Tests: 100/100 pass
- Pathology JSON sample dropped at
src/domain/species/equine/pathologies.json(schema v1.1, 3 zones: sphenoid/ssb/atm — placeholder before full-body)
Phase B — V1 REFACTOR (hierarchical findings + i18n)
B0. Domain model — Findings tree (DONE 2026-05-20)
- Schema:
src/domain/schema/findings.ts—FindingNodeSchema(recursive viaz.lazy),ZoneFindingsSchema,SpeciesFindingsSchema,SourceRefSchema - Loader:
src/domain/species/equine/pathologies.tsparses the JSON viaSpeciesFindingsSchema.parse(data)at boot (fail-fast) - Species manifest:
findings: FindingsLoaderreplacespathologiesinSpeciesManifest - JSON fix:
species.idset to"equine"to match registry - Tests:
tests/unit/species.equineFindings.test.ts(5 cases) replaces deletedspecies.equinePathologies.test.ts
B1. Report schema v2 — observation findings (DONE 2026-05-20)
ObservationSchemacarriesfindings: Finding[]+freeTextFindings: string[]; oldpathologyIds/freeTextPathologiesremovedReportSchema.versionliteral bumped1→2- Store
emptyObservation+initReportupdated to the v2 shape - PDF import surfaces a distinct French-language
IncompatibleReportVersionErrormessage on v1 attachments (detected before Zod parse) - Schema + store + PDF tests updated;
pathology.tsschema + test deleted
B2. UI — Findings tree picker (DONE 2026-05-20)
src/components/observation/FindingsTreePicker.tsx(breadcrumb, drill-down, leaf toggle, retour button, vet-referral ⚠ badge, description_fr surfacing)scope_disclaimermodal shown once per session viaosteo:disclaimer-shownsessionStorage flagObservationCardmigrated — one picker per zone with a catalog entry, singleFreeTextFindingInputbelowPathologyPicker+FreeTextPathologyInput+ their tests deleted;FreeTextFindingInputrenamed equivalent kepttests/unit/components.FindingsTreePicker.test.tsxcovers navigation, leaf select, vet-referral flag, retour, deselect
B3. i18n FR/EN — site + PDF (DONE 2026-05-20)
- Locale state:
src/state/localeStore.tsZustand'fr' | 'en', persistedosteo:locale - i18n dicts:
src/i18n/{fr,en}.ts(~90 keys each, parity-tested),index.ts,useT.tshook - Language switcher:
src/components/brand/LanguageSwitcher.tsxsegmented FR | EN toggle, integrated in ReportHeader + HomeRoute + NewReportRoute headers - Findings rendering: FindingsTreePicker + ObservationCard read
name_fr/name_enper locale; finding snapshots already dual (BDR-010) - PDF render:
exportReportToPdf(report, { locale })explicit option; static labels via dict snapshot;formatDate(iso, locale)replacesformatDateFr; finding leaf labels vialabelFr/EnSnapshot - PDF import error i18n: typed ImportError(kind + foundVersion); UI resolves message via dict (BDR-015) — caught by review (EVAL-002)
- Out of scope (per design):
description_fr+scope_disclaimerstay FR-only — vet-expert authoring needed for EN copy - Tests: localeStore (3), useT (3), dict parity (2), LanguageSwitcher (2), formatDate FR+EN (7), PDF roundtrip per locale (3). 154/154 green.
B4. PDF observationPage updates
- Render
findingsinstead ofpathologyIds(per-zone sections "CONSTATS — " + "CONSTATS LIBRES", joined·segmented) - Show vet-referral icon (⚠) next to flagged findings (observationPage.ts:407)
scope_disclaimerfooter on each obs page or first page only — decide- Update
LRN-009-style layout still applies (text-area reservation kept)
B5. Stub cleanup (DONE 2026-05-20)
ZoneTooltip.tsxdeleted (unused stub)Toast.tsxdeleted (unused stub — re-introduce later if notifications needed)- CLAUDE.md folder map updated —
ObservationEditor/Toast/ZoneTooltipremoved,FindingsTreePicker/FreeTextFindingInput/findings.tsadded
Phase C — V1 SHIP gate
- Author full
horse.json(placeholder → v2.0, 26 zones, 792 nodes, 612 leaves — done 2026-05-21) - Fix SVG case
data-anno-name-fr="hyoïde"→"Hyoïde"inpublic/species/equine/Horse_head.svg(done by user 2026-05-21; 26 JSON names ≡ 26 SVG names strict) - PDF QA manual pass: full flow → export → re-import roundtrip
- Fonts embed, JSON attached, multi-SVG grid OK, locale FR + EN exports
- Docker build + compose up smoke test (VPS cold build validated — BLK-005, 990c8e7; local smoke not separately logged)
- env-var brand identity verified (tour 2026-07-12: docker run APP_BRAND_NAME=TourCheck → env.js correct, non-root; hostile-quotes case covered by
0214ae1) - README finalize (install, dev, Docker, env vars, locale, MIT)
- CHANGELOG 0.1.0 entry
- docs/PATHOLOGIES-FORMAT.md — schema doc + authoring guide (initial shipped
70f21cc2026-05-20; refreshed for v2.0 boolean-only contract 2026-05-21 — scope section, 5 taxonomy patterns, structural rules, breaking-change notice, horse stats, changelog v1.0→v2.0) - Scaleway VPS deploy (TLS + live faunosteo.com —
2803cf7fixed prod 404). CI build/push/deploy UNVERIFIED — no .github/workflows or Gitea CI in repo.
Phase D — POST-V1 (not in MVP scope)
- Capacitor wrap (iOS + Android)
- Accounts + cloud sync (Supabase or self-host)
- Multi-praticien (move localStorage cache to server profile)
- RDV booking + push reminders
- Other species (dog, cat, cow, goat, pig, chicken JSONs)
- Pathology DB community contributions
Memory cross-refs
- BDR-001..BDR-022 — decisions registry
- LRN-001..LRN-031 — learnings registry
- BLK-001..BLK-005 — blockers (all resolved)
Apply when implementing B-phase:
- LRN-004 (data-anno-special opaque to parser) — zone IDs in JSON must match SVG
data-anno-id - LRN-009 (pre-rasterize → reserve → grid) — keep applied in PDF observationPage
- LRN-010 (gate DOM-mutate on async-mount) — relevant for any new SVG-mutating effect
Estimated effort
| Phase | Hours |
|---|---|
| B0. Findings schema + loader + tests | 3 |
| B1. ReportSchema v2 + store + PDF import | 3 |
| B2. FindingsTreePicker + disclaimer + integration | 6 |
| B3. i18n FR/EN site + PDF | 5 |
| B4. PDF observationPage update | 2 |
| B5. Stub cleanup | 0.5 |
| C. Full horse.json authoring (user) | external |
| C. QA + docs + deploy | 4 |
| Total dev | ~23h |