Files
bchanot fa41bc2e5b chore(memory): noisy-rewrite BDR-080, LRN-080 promoted to rule line
/prune-memory step D (recall feedback 2026-11-12): BDR-080 title and
lesson narrowed to the V1-1 DEV recette; LRN-080 status implemented,
promoted to rule line .claude/rules/database.md (the rule itself is a
separate /feat in this repo).
2026-11-13 11:52:44 +01:00

97 KiB
Raw Permalink Blame History

format, type, entry_prefix, schema, rules
format type entry_prefix schema rules
2 decisions_registry BDR
id date title decision why alternatives status supersedes
BDR-XXX YYYY-MM-DD string (<= 80 chars) string (what was chosen) string (motivation, context) list of strings (what was rejected + why)
proposed | accepted | deprecated | superseded
BDR-XXX (optional)
Append-only. Never rewrite past entries - add a new one with status superseded if needed.
One entry per non-trivial choice. Trivial = reversible in under 10 min with no cross-file impact.
Capture why more carefully than what - the what rots, the why lasts.
Entries in English, caveman format (BDR-009)
drop articles + filler, fragments OK, technical terms exact.

Decisions Registry

Format: BDR-XXX | Date | Title | Rationale | Alternatives | Status


BDR-001 — React SPA exception for tool app (2026-05-18)

Tool is practitioner-only, no public indexing needed → SPA valid per CLAUDE.md rule. Alt: Next.js SSR rejected — no server, static deploy only. Status: closed.


BDR-002 — SVG inline via DOMParser, not img/object (2026-05-18)

Inline SVG = full CSS control, pointer-events, data-* access. img/object = sandboxed, no DOM access, no click delegation. Status: closed.


BDR-003 — PDF attachment via native pdf-lib attach() (2026-05-18)

Native EmbeddedFiles (afRelationship:Data) = proper PDF spec, survives re-save in Acrobat. Alt: custom metadata → rejected (non-standard, stripped by some viewers). Status: closed.


BDR-004 — Runtime identity via window.APP_CONFIG (2026-05-18)

Build-time VITE_APP_* → baked into bundle; runtime injection via entrypoint.sh → no rebuild needed for brand changes. Order: runtime > build-time > defaults. Status: closed.


BDR-005 — Vertebra picker: region tabs + chip grid (2026-05-18)

≥40px touch targets, multi-select, per-region toggle. Alt: flat list → too long for 54 total vertebrae. Status: closed.


BDR-006 — Drag-reorder: up/down buttons, not DnD (2026-05-18)

DnD on mobile unreliable; ↑/↓ buttons accessible + simple. Status: closed.


BDR-007 — pnpm 11 used instead of pnpm 9 (2026-05-18)

pnpm@9 not available on host; corepack resolved 11.1.3. Package.json engine constraint set to >=9 for Docker (Docker uses corepack latest). Status: closed — deviation accepted.


BDR-008 — PDF page layout — branded heading pattern (2026-05-19)

Each PDF page leads with bold-uppercase accent eyebrow (size 9), Times 22 title, 2pt × 48pt accent rule under title. Section labels follow same eyebrow style (uppercase bold accent) above their values. Observation severity rendered as filled color-coded pill (sage / amber / red) next to the obs number. Alts: plain text titles only — rejected (overlapped header rule + read unstyled). Status: closed.


BDR-009 — Findings JSON keeps snake_case in TS, observation snapshot uses camelCase (2026-05-20)

JSON catalog fields (name_fr/name_en/description_fr/requires_vet_referral/...) stay snake_case in TS types/Zod schema — no transform layer. Domain-expert authored, reads natural in JSON, zero remap cost. Observation Finding snapshot uses camelCase (labelFrSnapshot/labelEnSnapshot/requiresVetReferral) per app convention. Alt: Zod transform to camelCase everywhere — rejected (extra layer, hides JSON shape, no real upside for a static catalog). Status: closed.


BDR-010 — Observation findings snapshot labels at selection time (2026-05-20)

Finding stores labelFrSnapshot + labelEnSnapshot copied from leaf at click time. Exported reports remain readable years later even if catalog renames/restructures leaves. Path[] still carried for future re-link/migration. Alt: lookup labels on render via path — rejected (breaks already-exported PDFs if catalog edits). Status: closed.


BDR-011 — v1 PDF import — hard-fail with version-specific FR message (2026-05-20)

importReportFromPdf detects data.version !== 2 BEFORE strict Zod parse, throws IncompatibleReportVersionError, wrapped into ImportError with explicit "v{n}, incompatible avec v2, réexportez..." message. No retro-compat shim (no prod PDFs in the wild). Alt: silent generic ImportError — rejected (user can't tell why import failed). Alt: v1→v2 migration adapter — rejected (no install base to justify cost). Status: closed.


BDR-012 — Species auto-discovery via Vite import.meta.glob (2026-05-20)

src/domain/species/registry.ts uses import.meta.glob('./*/index.ts', { eager: true }) and registers every module that default-exports a SpeciesManifest. Drop-folder onboarding: scaffold writes index.ts with export default <id>, no registry edit needed. Duplicate id → warn + first wins. Missing default export → silently skipped. Alt rejected: hardcoded SPECIES_REGISTRY map — forced edits in two places, broke "single source of truth" per species folder. Alt rejected: explicit registerSpecies() runtime helper — extra import boilerplate per species, no compile-time check that registration runs. Status: closed.


BDR-013 — SVG↔JSON zone bridge via fuzzy FR/EN label match (2026-05-20)

SVG data-anno-id values stay opaque generator strings (point-mpb..., zone-...). JSON catalog keys are stable human zone names (sphenoid, atm). Bridge runs at observation render: matchZoneFindings normalizes both sides (lowercase + NFD-strip accents + alphanum-only) and scores EN-exact → FR-exact → substring → Levenshtein within max(2, floor(maxLen*0.25)) tolerance. EN first because no accent normalization edge cases. Alt rejected: rename SVG data-anno-id to JSON keys — couples opaque SVG generator output to human-meaningful catalog, brittle across SVG re-exports. Alt rejected: add new data-anno-finding-zone attribute on every hitbox — forces SVG edit per species, double-source for the same info already in name_fr/en. Status: closed.


BDR-014 — PDF locale = render preference, not Report schema field (2026-05-20)

exportReportToPdf takes explicit { locale } option read from localeStore at call site. Locale lives outside Report — never persisted in schema. Rationale: Finding snapshots already carry labelFrSnapshot+labelEnSnapshot (per BDR-010), so render-time locale picks the correct snapshot; no schema bump needed; re-imported PDF can be re-exported in either locale without data migration; embedded JSON byte-identical between locale variants of the same Report. Alt rejected: store locale field on Report schema — would force v3 bump, complicate re-export ergonomics, duplicate state already in store. Alt rejected: default locale to 'fr' in export — caller is route layer, has store, easy to pass; explicit arg makes tests + API surface clean. Status: closed.


BDR-015 — Typed ImportError discriminant (kind + foundVersion) over localized messages (2026-05-20)

ImportError carries kind: 'invalid_pdf' | 'incompatible_version' | 'no_attachment' + optional foundVersion. Message field collapses to internal sentinel. UI layer (HomeRoute) resolves user-facing string via i18n dict using err.kind, with {version} template substitution. Rationale: review caught hardcoded FR in pdf/import.ts + pdf/attachment.ts leaking to EN UI; original "throw with localized message" coupled domain layer to one locale; typed discriminant moves message authoring to the UI layer where i18n lives. Alt rejected: keep FR messages, translate via err.message string match — brittle (any rewording breaks the lookup), spreads i18n knowledge into the catch site. Alt rejected: pass t() into domain layer — wrong direction; domain should not know about React hooks or current locale. Status: closed.


BDR-016 — pathologies.json v2.0 — boolean source of truth, generic vet description_fr purged (2026-05-21)

Catalog bumped v1.2→v2.0. requires_vet_referral: true boolean = sole source of truth for vet flag. Generic "orienter vers vétérinaire" descriptions purged on 25 leaves where boolean alone sufficed. description_fr kept on 16 leaves carrying differential cue (cause neuro/sinusale/ligamentaire/rotulienne/etc.). Horse coverage extended placeholder 3 zones → full 26 zones (9 head + 17 body), 792 nodes, 612 leaves, 41 vet-referral leaves. Schema_version "2.0". Why: v1.2 had textual fallback (description_fr.includes('vétérinaire')) + boolean coexisting → redundant + ambiguous. v2.0 collapses to one signal. How to apply: Any new species JSON authored at v2.0 — boolean on vet leaves only, description_fr only when it adds clinical differential beyond "see vet". Consumers MUST use boolean check, never textual scan. Alt rejected: keep dual signal — wastes maintainer attention, drift risk between text and boolean. Status: closed.


BDR-017 — SVG editor: vanilla JS wrap over React rewrite (2026-05-22)

editor.html = ~1630-line standalone SVG annotation tool (DOM manipulation, drag/drop, polygon editing, zoom, categories, export). Integrated into React app via useRef + useEffect mounting all vanilla JS logic into container refs. Only CSS restyled to Faunosteo tokens. Alt rejected: full React rewrite (convert all state to Zustand/useState, all DOM ops to React) — massive effort ~10x, high risk of subtle behavior differences in drag/polygon/zoom interactions. Status: closed.


BDR-020 — Pathology editor: standalone HTML, not React route (2026-05-22)

pathology-editor.html = standalone tool at project root, same pattern as SVG editor integration. Vanilla JS/CSS, no build step, no deps. Decoupled from React app entirely — zero imports from src/. Why: tool for domain experts editing JSON, not practitioners using main app. No shared state needed. Standalone = deployable anywhere, no Vite required. Alt rejected: React route with Zustand store — unnecessary coupling, heavier DX for a JSON editing tool. Status: closed.


BDR-021 — Port zoneMatch.ts inline into pathology editor (2026-05-22)

Fuzzy matching logic (normalizeLabel, levenshtein, scorePair, matchZone) duplicated inline in pathology-editor.html rather than imported from src/lib/zoneMatch.ts. Why: standalone HTML cannot import TS modules. Keeping identical algorithm ensures matching consistency between main app and editor. Alt rejected: extract to shared .js file — adds dependency management for a tool that should be zero-dep. Status: closed.


BDR-018 — Vertebra picker confirm — target region replaces, other regions union (2026-05-27)

VertebraPicker anchored on clicked spine zone but lets user switch region tabs. On confirm, distributeVertebraeToZones spreads picks across one spine zone per region. Target region (clicked zone) = REPLACE (picker seeded with its full set → unchecking deselects). Other regions = UNION with any pre-existing zone (picker didn't display them → side-tab pick must be purely additive, never wipe). Region with no SVG spine zone → fold verts back onto target (nothing lost). Why: picking verts in a non-target tab must behave as if that zone was also clicked — highlight + findings picker both flow from observation.zones. Replace-everywhere would silently wipe a cervical zone selected earlier when reopening lumbar picker. Alt rejected: seed picker with full-spine union of all zones → forces handling deselection-to-zero per region (remove zone + orphan its findings); bigger scope, destructive. Additive-only matches user request. Alt rejected: keep dumping all verts on clicked zone (old bug) — other zones never highlight, no findings picker. Status: SUPERSEDED by BDR-019 (same session) — additive-union model dropped once picker shows full spine.


BDR-019 — Vertebra picker = unified full-spine editor, authoritative confirm (2026-05-27)

User asked picker to SHOW selections from all regions when switching tabs. Once it displays + edits every region, additive-union confirm (BDR-018) breaks: unchecking a side-tab vert can't stick (union re-adds from existing zone). So model flipped to unified + authoritative. Seed: collectSpineVertebrae(zones, bones, clickedBoneId) = union of all spine-zone verts, clicked zone first. Confirm: syncSpineZones(zones, verts, bones) — per region: REPLACE existing zone verts (deselect sticks); PRUNE spine zone whose region → 0; SPAWN zone for newly picked region. Non-spine zones + order preserved. targetIndex dropped — each vertebra carries its own region, no anchor needed. Tab: clicking zone ALWAYS opens its region — initialRegion now beats initial[0].region in VertebraPicker (was reverse). Updated the test that asserted old precedence. Why: picker as whole-spine editor is the only coherent model when all regions visible + editable; partial/additive semantics contradict what user sees. Known wart (accepted): pruning a region orphans its findings (findings keyed by tree zoneId, not boneId; sync works in boneId space). Parity with existing ✕ remove-zone button — neither cleans findings. Follow-up if needed. Confined to spine: picker only opens for special==='vertebral-precision'; sync/collect/find all gate on it; non-spine zones pass through. Tests cover. Alt rejected: keep additive (BDR-018) + only change seeding — deselection in non-clicked tab silently fails. Status: closed.


BDR-022 — Keep pathology-editor standalone — asymmetry vs svg-editor intentional (2026-06-13)

After 404 fix (moved pathology-editor.html root→public/, LRN-029), considered unifying it with svg-editor pattern (React route, vanilla wrapped in useEffect, BDR-017). Rejected. Two editors differ by COUPLING, not accident:

  • svg-editor REUSES app internals (getAllSpecies registry, useLocaleStore+getDict, AppHeader) → React route earns its keep (BDR-017).
  • pathology-editor = zero src/ imports by design (BDR-020/021): own inline i18n (76 keys), own zoneMatch copy. Isolated on purpose. Why keep standalone: editor PRODUCES the prod pathologies.json the live app reads (fetches /species/equine/{pathologies.json,Horse.svg,Horse_head.svg} — same bytes as app). Tool touching prod data = minimal-change zone. Wrapping ~1700 lines of imperative DOM in a useEffect to chase cosmetic parity risks the JSON export path for no functional gain. The svg-editor wrap (1832-line useEffect) is the WORSE of the two patterns, not the target to copy. Alt rejected: pathology→React route (BDR-017 style) — propagates the dubious pattern over 1700 lines, regression risk on drag/tree-edit/SVG-sanitize/fuzzy-match. Alt rejected: both→standalone public/ (de-wrap svg) — cleaner unification but svg now coupled to species registry + locale store; de-wrapping costs + loses language sync. Status: closed.

BDR-023 — Monorepo: apps/app + pnpm workspace, packages extracted on demand only (2026-10-08)

App moved to apps/app (@faunosteo/app, git mv, 144 pure renames). Root package.json delegates (pnpm -r). packages/ = README only; a package is created when it has a clear owner + real code (plan Steps 3/4/6). apps/public-web, apps/worker, supabase/ created by the step needing them. Why: root one-word commands, Docker filtered build, lockfile v9 already workspace-capable; moving later (after packages + 2nd app) costs more. Empty packages = config to maintain for nothing. Alt rejected: app kept at root beside apps/public-web (special-cased configs); single Next.js app (rewrite, SSR useless behind auth). Status: closed (user validated 2026-10-08).


BDR-024 — Node 24 LTS + pnpm 10.13.1 pinned, engine-strict (2026-10-08)

Node 24 (.nvmrc, .node-version, engines >=22.12 <25, Dockerfile node:24-alpine, CI). pnpm 10.13.1 via packageManager + root devDependency (scripts find node_modules/.bin/pnpm under corepack or any install) + engines <11. .npmrc engine-strict=true. Why: Node 20 EOL 2026-04-30; dev host on 24; all checks ran on 24. pnpm 11 needs Node ≥22.13 and rewrites lockfile; 10.13.1 = Dockerfile-validated pin (BLK-005). Lockfile rewritten by 10.13.1 (libc fields from earlier pnpm 11 dropped) → coherent with pin. Alt rejected: keep Node 20 (EOL); global pnpm (user rule: no global install). Risk: Docker build on node:24 not run locally (no daemon) → CI docker job / manual build before deploy. Status: closed.


BDR-025 — Design records live in docs/history/superpowers, not docs/superpowers (2026-10-08)

gitflow lib purges docs/superpowers/{specs,plans} at every finish (BDR-065, fixed path list). Step 1 finish deleted 9 design docs (8f217d8). Restored from history under docs/history/superpowers/ (not purged); refs updated (CLAUDE.md, migration map, plan). Audit docs keep old path (frozen). Alt rejected: revert in place → purged again next finish; editing the lib list → global change for one repo. Status: closed.


BDR-026 — platform_role enum = owner/admin/moderator/support only; professional statuses excluded (2026-10-08)

Business arch §4.1 lumps 7 values in profile_roles.role (practitioner/student/professor + 4 platform). User rule: never confuse platform roles with professional statuses. Table name kept profile_roles (plan + helper names unchanged), enum platform_role 4 values. practitioner/student/professor → verification outcome (identity step); cabinet roles → organization_members. Hierarchy for checks: owner ⊇ admin ⊇ moderator; support separate (§17.3). Deactivated profile (active=false) → all helpers false. Alt rejected: 7-value enum per arch doc → self-declared "practitioner" row readable as verified status. Status: closed (user instruction), name profile_roles open to rename if user prefers platform_roles.


BDR-027 — Role writes RPC-only + audited; column-level GRANT protects profiles.active / phone_verified_at (2026-10-08)

No INSERT/UPDATE/DELETE policy on profile_roles; only grant_platform_role / revoke_platform_role (security definer, actor = auth.uid(), self-target refused, owner any role / admin moderator+support) → private.assign/withdraw_platform_role → private.log_event. Bootstrap first owner: assign_platform_role(null, uid, 'owner') from privileged SQL. Last active owner cannot be revoked. profiles: grant update (display_name, first_name, last_name, phone, locale, timezone) instead of a protect-columns trigger → active, phone_verified_at raise 42501 for API role, server functions untouched. Alt rejected: BEFORE UPDATE trigger checking auth.uid() → blocks future server RPC acting for the caller; column grants declarative, visible in has_column_privilege. Status: closed.


BDR-028 — pgTAP single source of SQL tests; PGlite runner in vitest beside supabase test db (2026-10-08)

Docker socket denied to user on dev host (BLK-006). PGlite 0.3.16 (PG17 WASM) ships pgtap extension → packages/supabase/tests/db/ applies supabase-shim.sql (API roles, auth.users, auth.uid(), Supabase default privileges) + migrations, runs every supabase/tests/*.sql, fails on not ok / plan mismatch. Same files run by supabase test db on real stack (CI supabase job). Shim replicates permissive default privileges so a missing revoke fails. Alt rejected: TS-only RLS tests (duplicate harness, drift); waiting for Docker (no executed proof). Status: closed.


BDR-029 — database.types.ts hand-written in supabase gen types format + schema↔types test (2026-10-08)

CLI gen needs running stack. File written in generator format (Row/Insert/Update/Relationships/Functions/Enums/Constants). schema-types.test.ts: compile-time exhaustiveness (every Row column listed, every Args key listed) + runtime diff vs information_schema / pg_enum / pg_proc in PGlite; also pins RLS-on + no using(true) for every future public table. CI db:types:check diffs against real generator once Docker available; first real run may reformat (PostgrestVersion string) → regenerate + commit. Status: closed; column scalar types (uuid→string…) reviewed by hand, not executed.


BDR-030 — Step 4 split: model + persistence now, importer → official equine DRAFT next (2026-10-08)

User brief: no full equine import yet; first official horse sheet = draft, business content verified before publication. Plan Step 4 bundled model + importer. Split: Step 4 = packages/domain document + validation + migration + pgTAP + docs; Step 4b = legacy importer → draft + IMPORT-REPORT, publish on user go. packages/anatomy created at 4b. Alt rejected: importer in same step → publishes seed v1 immutable before expert review (contradicts brief). Status: closed (plan note added under Step 4).


BDR-031 — Canonical sheet document shape (schema_version 1) (2026-10-08)

Labels { fr, en } objects (one LocalizedText, new locale = optional key) instead of name_fr/name_en pairs. Strict Zod objects (unknown key rejected). Structural records explicit null; finding tree nodes lean on input, .default() fills description/sources/children/requires_vet_referral (612 leaves). Views = tree (parent_view_id), detail svg_asset_id nullable = crop parent via view_box (C9). Annotation discriminated union point|zone|detail_trigger; laterality 4 values explicit (unpaired/bilateral/left/right); spine = vertebral_region_code → ordered vertebral_config.regions with free codes (C1/Q3); findings link = inline finding_zone_id (no separate map, no label matching); finding categories carry kind dysfunction|observation|anamnesis|custom; node ids unique among siblings so (zone, path[]) addressing survives Step 5. Two tiers: shape (Zod, every save) vs integrity (validateSheetDocument, 17 coded rules, publish gate). Alt rejected: name_fr/name_en flat (BDR-009 catalog style) → no locale extension; annotation_finding_map array → extra structure for a 1:N field; UUIDs as in-document ids → unreadable, legacy paths re-keyed. Status: closed; category kind observation vs report Observation collision (C7) flagged to user.


BDR-032 — Sheet persistence: trigger-enforced immutability, SQL publish re-check, content-addressed assets (2026-10-08)

Tables species / anatomical_sheets / _versions / _assets. Published immutable via BEFORE UPDATE trigger (every role incl. owner; only published→deprecated with stamps); deprecated frozen; BEFORE DELETE trigger = preconditions (never published, never current, never base of active fork; reports join later) → no session flags, RPC just deletes. One draft per sheet (partial unique index, C8). Document↔row: CHECK content->'schema_version' = to_jsonb(document_schema_version), trigger species match. private.sheet_document_issues(jsonb) re-checks the non-recursive error rules at publish + unknown asset ids → defense in depth, same codes as TS (BACKEND_ARCH "SQL doesn't re-implement Zod" kept for shape). Assets content-addressed (sha256, unique per sheet), Storage path <sha256>.svg by convention, fork = metadata copy + remap_document_assets. Draft autosave = column-level UPDATE (content, change_note) policy on own draft (unaudited by design); identity (name/slug/description) column policy; visibility via audited set_sheet_visibility RPC and draft deletion via delete_sheet_version after gate review (sharing + deletion = sensitive state); last_version_number counter (no number reuse); content ≤ 2 MiB, byte_size ≤ 20 MiB, reason ≤ 500; require_actor refuses deactivated profiles; authz before lookup (unknown id = same 42501); fork copies only referenced assets. can_use_sheet = active ∧ (public ∨ editor) until grants/follows. Official sheet = creator null + is_official, platform admins edit. Alt rejected: session-flag delete bypass (hacky); Zod-equivalent validation only in TS (browser not a boundary); per-sheet asset storage copy on fork (needs worker job). Status: closed; names (anatomical_sheet_assets, storage layout, official ownership) listed for user confirmation.


BDR-033 — User decisions on the Step 4 open points (sheets: follow, verification, versions, official, naming, server validation, erasure) (2026-10-09)

User validated Step 4 and ruled: (1) public read by visibility, USE of a community sheet requires following its author, official sheets exempt → can_use_sheet + follow at community step; (2) private drafts for anyone, community publication only for authorised + verified accounts, student/professor keep own rules → gate in publish/set_visibility at verification step; (3) new publication = current, no auto-deprecation (current behaviour); (4) official sheets platform-owned, admin-run (current model); (5) finding kind observation → consultation_reason (done, packages/domain); (6) server-side validation mandatory for publication, frontend never a boundary → Zod shape check server-side before community step; (7) account deletion handles dependencies/transfer explicitly, nothing may block erasure forever → retention step anonymises authorship via a system path. Scope guard from user: implement along the planned steps, keep 4b (equine import) free of community/account features. Status: closed (recorded in ANATOMICAL_SHEET_MODEL.md §5).


BDR-034 — Equine import = generated seed, draft only; assets content-addressed in a private bucket read through the sheet (2026-10-09)

Importer (packages/anatomy, one-off, deterministic) emits supabase/seed/anatomical-sheets/equine/v1: document.json, legacy-id-map.json, assets.json + SVG copies, IMPORT-REPORT.md (FR, for the osteopath), equine_v1.sql (idempotent: official platform-owned sheet faunosteo-cheval private + 2 asset rows + draft v1 via private.insert_sheet_draft(null,…)). Golden test = committed artifacts equal a fresh run. Ids: annotation = catalog zone key on exact FR+EN match (26/26), views main/head, trigger head-trigger, asset/sheet uuids derived from sha256 (uuid v5-like). No medical correction: ssb-dysfunctions kept + anomaly; only degraded slugs normalised and declared; 12 anomalies to validate, 6 informative. Seed listed in config sql_paths (every env) and applied by the PGlite harness (seed/**, never seed.sql). Storage: bucket anatomical-sheet-assets private, <sha256>.svg, SELECT policy via private.can_read_sheet_asset_object (published reference of usable sheet, or editor), no API writes, operator upload script with service key from env. Alt rejected: data migration for the sheet (immutable file for a draft meant to be edited); TS seeding via PostgREST (needs service key in a committed path); fuzzy zoneMatch at import (26/26 exact, strict equality + report suffices). Status: closed; publication of v1 = explicit user decision after report review.


BDR-035 — Docker resources prefixed faunosteo_ (multi-SaaS VPS) (2026-10-09)

User rule: every Faunosteo Docker resource (container, network, volume, image, future worker/self-hosted Supabase) named faunosteo_* when configurable → cohabitation on one VPS without collision. Applied: compose name: faunosteo + container_name: faunosteo_app (was faunosteo-web, stateless, no volume → rename safe). Supabase CLI hard-codes supabase_<svc>_<project_id> → suffix faunosteo, documented limit, no wrapper. Rule for future persistent volumes: keep volume name across renames. Alt rejected: wrapping supabase start to rename containers (fragile, breaks CLI status/stop). Status: closed (DEPLOY.md "Docker resource naming", SUPABASE.md §3, CLAUDE.md).


BDR-036 — Sheet document schema v2 + curation changeset as data (Step 4c) (2026-10-10)

Schema v2: document references registry (id, type, citation, url|doi), reference_ids + review_status (inherited|reviewed|to_confirm) on finding nodes/categories/annotations, count_range on vertebral regions; rules reference.id.duplicate, finding.reference.missing, region.count_range.invalid on TS + SQL (jsonpath ** descent); CHECK document_schema_version = 2. Curation = authored JSON changeset (curation/changes.json: CHG-nnn, level A|B|C, kind, FR/EN title, rationale, reference_ids, priority, question required for C; ops set/rename/add/remove/move/cite over string targets) applied by a deterministic pipeline to the 4b baseline → draft/ (document, one cleaned SVG, head view = view_box crop, CHANGELOG with before/after per elementary edit, 10-section REVIEW-REPORT, review/annotations-<view>.svg before/after drawings, converging seed). Legacy baseline kept generated under legacy-import/, v1/ removed. Nothing publishes. Alt rejected: editing document.json by hand (no traceability, golden test); TS code per change (reviewers read data, not code); per-node inline sources (792 copies → registry + ids); PNG renders in git (operator artifact, renderer-dependent). Status: closed; content awaits professional review (REVIEW-REPORT §10, 9 questions).


BDR-037 — Step 4c validated: reference draft, review semantics, migration rule (2026-10-10)

User decisions: curated equine draft = reference draft of the app until published (no publication without professional review); technical integrity ≠ medical validation (inherited / reviewed / to_confirm stay visible, REVIEW-REPORT the hand-off doc for the osteopath, 11 open questions → next changeset); future schema changes = incremental non-destructive migrations (BLK-008); legal scope text re-read on consolidated Légifrance texts before publication; head view preserved as crop, per-view assets still possible. Docker faunosteo_ rule permanent; .env.example change documented in DEPLOY.md (file denied to Claude). SaaS development continues without waiting for medical validation. Status: closed.


BDR-038 — Step 5: app on the canonical sheet — bundled sheet, layer renderer, Report v3, migration map (2026-10-10)

Sheet source: SheetProvider interface; Step 5 implementation = Vite virtual module virtual:faunosteo-sheet built from the seed draft (vite/sheet-bundle.ts), mode SHEET_BUNDLE=draft|none, default draft for dev server, none for builds/CI/Docker (--build-arg SHEET_BUNDLE=draft = explicit preview) → unvalidated draft never ships by accident (D2). Markers: pure renderer @faunosteo/anatomy/render (element tree, no DOM) reproduces legacy look (hitbox r + twin r−12, opacities 0.65/0.5, spine 0.3, trigger 0.06 dashed); colours = document data (categories[].color, additive annotations[].color for the head shades, schema_version stays 2 for additive optional fields); same renderer feeds draft/review/app-<view>.svg for visual checks. Report v3 in packages/domain: (annotationId, viewId) zones with label snapshots, (findingZoneId, path) findings, severity codes, sheet {sheetId, versionId|null, documentSha256}, unresolved: true for what migration cannot place, localAnnotations: [] reserved. Migration map generated by the pipeline from applier records (replay renames/moves/removals + unique re-homing): 792 nodes → 571/180/7/34. Interaction = pure service + reducers (BDR-019 kept); store = v3 + persistence adapter (v2 draft migrated on restore). D4 applied: registry, matchers, SVG parser, editors, pathology-editor, public species assets deleted; legacy sources moved to supabase/seed/.../legacy-sources/ (importer input). Alt rejected: copying the draft into apps/app (duplication, drift); runtime fetch of /sheets/*.json (still public, no gain); UUID annotation ids (BDR-031); converting v3→v2 for attachments (lossy); per-view colour table in the app (horse knowledge in generic code). Status: closed; awaiting user validation of Step 5.


BDR-039 — Step 6: autonomous PDF archives — lean-document snapshot, envelope v1, archived branding + labels, explicit rebase (2026-10-11)

User-validated design (docs/development/STEP6_PDF_ARCHIVE_ANALYSIS.md Part II). Attachment = envelope v1 {format, envelopeVersion, exportedAt, locale, report v3, sheetSnapshot, branding, labels} in one osteo-report.json, SVG inline as text. Snapshot = {status, ref, document, assets} where document = valid lean AnatomicalSheetDocument (all views/annotations/categories/regions, finding zones kept by id, trees pruned to used paths with ancestor labels, references emptied) → reuses sheet index, layer renderer, 21 integrity rules; no dedicated schema. Branding (logos base64/svg, credits, URLs) + label dict (fr+en) archived so future logo/wording changes never alter a re-render (user D7 adjustment). Engine packages/pdf: explicit inputs {report, sheet, branding, labels, locale, rasterizer, exportedAt}, no DOM lib, xmldom composition promoted from curation app-review, Rasterizer adapter (browser Image/canvas; resvg devDep for tests), per-view/per-logo degradation, export-side validation (caps, integrity, sheet invariant). Read = layered: report first (v3/v2 existing dispatch), envelope metadata tolerant, snapshot strict → snapshotRejected enum, report never lost; attachment_stripped via Info.Keywords stamp. Session: imported archive kept immutable (osteo:archive), working copy rebased explicitly on the loaded sheet (rebaseReportOnSheet, unresolved flags + labels from archived snapshot) (user D8 adjustment); re-export of the kept archive = technical support only, UX submitted after step. No CLI, no page change, no original v2 JSON re-embedded. Alt rejected: dedicated SheetSnapshotSchema (rewrites lookups, loses integrity rules); separate embedded files per asset (first-EmbeddedFile reader, stripping risk); pruning views/annotations (saves ~0 KB, breaks trigger titles); snapshot discarded on import (user: keep for faithful re-read); crypto hash check of assets (self-referential; sha copied from catalog manifest as provenance pointer instead). Status: closed (Step 6 validated by user 2026-10-11; D8 finalised in BDR-040).


BDR-040 — Step 6 closure: no "re-export the original archive" button, visible rebase, BLK-009 gate (2026-10-11)

User decisions after manual validation (logos and picker text confirmed OK on their side; Step 6 VALIDATED). (1) Re-export of the imported archive from the UI REFUSED permanently: the practitioner already holds the original PDF; no second button, no dedicated UX flow. Keep the archived snapshot, its integrity and the autonomy tests (engine exportFromEnvelope stays as the proof + future server use); the UI exports only the open working report. Do not propose this feature again. (2) Rebase on draft restore shown to the user (editor.draft_rebased) approved; import messages approved on principle with an explicit "full restoration" vs "partial recovery" headline. (3) BLK-009 treated now: byte-scan attachment extraction without pdf-lib load on import + export without object streams; remaining risks (worker/server import, pdf-lib replacement, read caps) stay an explicit BLOCKER gate before any external user import; never declared solved by passing tests alone. Alt rejected: a re-export action on the home screen after import (same objection); a toast system for import feedback (no component, alert pattern kept). Status: closed.

BDR-041 — Step 7 scope: zustand auth store (no TanStack), professional fields on profiles, MFA = documented gap, config-driven OAuth buttons, local tool stays open (2026-10-11)

Step 7 brief (UX validated by user with external mockups, not versioned). Choices: (1) no TanStack Query: one profile read/update per section, zustand authStore + localeSync enough; query layer deferred to the first list screens. (2) practice_name, professional_title, siret added to profiles as declared free text (CHECKs, column grants), verification stays the Professional Verification domain (Step 11). (3) MFA: foundations had TOTP disabled, no has_mfa(), no admin table → TOTP enabled server-side, enforcement + enrolment UI documented as gap (IDENTITY.md §4), Security section shows a note, no fake UI. (4) OAuth buttons listed by APP_AUTH_PROVIDERS / VITE_AUTH_PROVIDERS; config.toml providers read env() ids, enabled = false until ids exist; platform_invitations not written. (5) Local tool routes untouched + unauthenticated (LocalToolShell, catch-all), Home header entry only when Supabase configured; /app guard sends to /login?next= with same-origin check. (6) Account locale wins over device locale once per sign-in; switches while signed in persist to profiles.locale. Alt rejected: TanStack now (YAGNI); MFA enrolment screen (unvalidated UI, nothing to protect); /register naming (/signup kept); nested <a><button> for card CTAs (ButtonLink instead). Status: active, awaiting user validation of the step.

BDR-042 — Step 7 validated; validated mockups versioned as permanent design reference; Home without sidebar accepted (2026-10-12)

User validated every Step 7 screen and flow (login, signup, recovery, dashboard, account, sidebar + drawer, logout, FR/EN, responsive), no UI correction. Decisions: (1) the mockup file the user produced (docs/design/faunosteo-etape7-maquettes-validees.png, 7 views) is the permanent graphic reference for the SaaS shell; docs/design/README.md lists what it shows beyond Step 7 with the owning step (Bilans/Clients/Animaux/Agenda/Fiches entries, stat tiles, bell, avatar photo → Step 8, Mon compte tabs, mobile tab bar) so no screen invents them early; a redesign needs a new validated file there. (2) Local-tool Home (/) shows no sidebar when signed in, only "Mon espace": accepted until the tool is integrated into /app (Step 14). (3) Password rule in the mockup (8 chars) does NOT override the server policy (12 + classes). (4) Follow-ups kept in TODO 7.10: MFA before sensitive admin features, professional verification ≠ SIRET format, real OAuth tests once ids exist, tool integration into /app. Status: closed; Step 7 finished into develop.

BDR-043 — Rust by default: permanent language rule + target architecture (study awaiting validation) (2026-10-12)

Owner rule: Rust preferred wherever equivalent or better; "already TS", "more work", "no perf gain" never reasons for C. Kept: React/TS UI + DOM + stores + vendor glue, Tailwind, SQL + RLS, Supabase Auth/Storage, Vite tooling. Study docs/development/RUST_ARCHITECTURE_REVIEW.md rev 2 (61 challenger findings folded). Classification: A = domain contracts/rules, sheet handle + index data, reducers, data-building component rules, publish gate, layer renderer + compose, one SVG sanitiser, PDF reader + writer, CLI tools, curation pipeline + importer, upload script, Step 8 worker, every future backend/rule mirror; B = none; C = React render glue + display helpers, Zustand/storage adapters, supabase-js session + error shapes (no Rust GoTrue PKCE client), UI form schemas + dictionaries, clock/crypto/Intl screen dates, browser rasteriser (DOM), Vite tooling, SQL/RLS, public web (Astro, global rule). Target: 3 crates (core feature-gated lib + tool bins, wasm facade, worker bin), JSON strings across the boundary + ts-rs types (no serde-wasm-bindgen: writes absent optionals as null), SheetHandle built once, closed error kinds, ids/time injected, panic=abort handled TS-side (poison + reinstantiate), lazy init + core_unavailable, reader in terminated Web Worker. Worker: Rust binary, decode child = same binary dispatched before any thread, empty env, RLIMIT_AS/CPU, traced seccomp allowlist (Landlock dropped: redundant), pure-Rust decoders (image/zune-jpeg/png/image-webp) + moxcms ICC, lossy WebP via libwebp-sys ≥ 1.6 in the child only, parent parses RIFF header only (never decodes), 512 KiB output cap, per-stage deadlines; service key kept (dedicated role = Step 27 option). Roadmap: R0 workspace + worker image inside Step 8, R1 = Step 8 worker, R2 domain core before Step 9, R3 anatomy, R4 pdf reader + writer (Std14 AFM metrics, draw-log golden frozen first), R5 pipeline + importer + tools, all before Step 13; TTF fonts separate later change. Deploy prerequisites: CSP 'wasm-unsafe-eval', gzip wasm, images built in CI pulled by digest (VPS 1 GB never compiles), N-1 reader test, draft quarantine. Alt rejected: single core crate without features (worker would carry pdf deps) → features chosen; 6 crates (rev 1) → too many; resvg in browser (949 KB gz, visual change); wasm-pack (one maintainer, CLI lock); Edge Functions (limits, hand deploy); Prettier-chained sheet identity (hash only compared at runtime → one-time rebase accepted); parent re-decode of child output (breaks keyless-decoder invariant). Status: active, awaiting owner validation of the study + 13 decisions D-R1..D-R14 (D-R6 withdrawn); nothing implemented; release 0.2.0 untouched.

BDR-044 — Rust orientation validated by the owner; detailed decisions D-R1..D-R14 pending (2026-10-12)

Owner validated the study's orientation + 10 principles: Rust worker at Step 8; Cargo workspace; native + WASM libs; progressive anatomy migration; PDF migration under complete compatibility proofs; React + PostgreSQL/Supabase kept; testable increments with rollback; no premature deletion of TS still used; fully dockerised, production builds outside the small VPS; WASM vs production CSP proven before activation. Requests: expanded decision table (Annex A), R0 scope with build tools reproducible in Docker and no Rust on the VPS (Annex B), serde/WASM/panic/musl hypotheses verified experimentally when they condition a choice (R0 proofs as permanent tests). Release 0.2.0 still waiting. R0 and Step 8 implementation NOT started until the 13 decisions are validated. Status: active; awaiting D-R1..D-R14 validation.

BDR-045 — Rust review rev 2 validated with amendments; R0 go (2026-10-12)

Owner validated D-R1/2/3/7/8/10/11/12/14 as recommended. Amended: D-R4 libwebp C only in the isolated child, parent validates result + limits before use, linked libwebp version known/controlled, no new unmanaged risk; D-R5 fingerprint → canonical JSON (RFC 8785 JCS or strictly defined alternative) independent of formatter, explicit compat with old fingerprints/archives, existing fingerprints untouched, decision prepared for R5; D-R9 Edge Functions → Rust services, shared code but distinct processes (worker vs HTTP endpoints), same image + subcommands, least privilege per service, Supabase Auth keeps OAuth; D-R13 CSP 'wasm-unsafe-eval' proven experimentally without widening JS permissions, reproducible Docker builds in CI, digest images + rollback prepared, no auto-deploy, no image publication without workflow + validation, VPS never compiles Rust. R0 go per Annex B (7 proofs for real, unverified hypotheses tested, blockers reported not assumed); R1 NOT started without a go; release 0.2.0 pending; live deployment untouched. Status: closed (owner, 2026-10-12); R0 in progress on feature/rust-r0-foundation.

BDR-046 — R0 implementation choices (Rust foundation) (2026-10-13)

Choices made while building R0 (feature/rust-r0-foundation), within the validated review: (1) toolchain arbiter = Docker builder image (docker/rust-builder.Dockerfile, rust:1.99.0-bookworm + wasm target + wasm-bindgen-cli 0.2.129 + cargo-deny 0.20.2 + rustfmt/clippy baked in: official images ship rustup's minimal profile), docker/rust-run.sh with named volumes faunosteo_cargo_registry / faunosteo_rust_target; no rustup on the host, never on the VPS. (2) serde_json features preserve_order + float_roundtrip (default parser one ULP off, found by the proof). (3) Boundary = JSON strings + ts-rs types committed under packages/core-wasm/types with a CI drift check (no serde-wasm-bindgen/tsify). (4) Fresh wasm instance = cache-busting dynamic import of the glue (ESM cache returns the same instance otherwise); R2 must do the same in the browser or use a Worker per instance. (5) Worker: RLIMIT_CPU soft N / hard N+2 (soft = hard → SIGKILL first); seccomp allowlist = the 7 traced syscalls (read write mmap munmap mremap exit_group getrandom) + 7 abort-path ones, derived by strace in the Dockerfile test stage and compared on every build; dependencies optimised in the dev profile (4096² decode under the 10 s CPU cap); test hooks behind a cargo feature never in release; parent parses the RIFF container only (D-R4 amendment). (6) App Dockerfile, docker/nginx.conf, compose untouched at R0 (deviation from Annex B's "wasm stage built in CI": no consumer before R2, owner said live deployment untouched); CI check job builds the wasm itself (no artifact action dependency on the Gitea runner). (7) cargo-deny allow-wildcard-paths = true (a versionless path dep reads as a wildcard) and the core path dep declared per crate (workspace-inherited path dep hits a cargo-deny bug). (8) CSP proof committed as docker/csp-proof/ (playwright-core outside the repo, documented). Alt rejected: rustup on the dev host (owner: builds reproducible in Docker); wasm-pack; artifact upload/download between CI jobs (unverified on the forge); Landlock + NPROC/FSIZE/NOFILE (redundant under the allowlist, challenge finding). Status: closed (R0 delivered, awaiting owner validation; R1 not started).

BDR-047 — Native Rust toolchain primary on the Ubuntu dev server; Docker builder = reproducible alternative; no CI active (2026-10-13)

Owner brief after R0 delivery: dev machine = self-hosted Ubuntu native (not WSL, not VPS), Docker rootless. Decision: daily Rust = native user-level rustup (channel from rust-toolchain.toml, wasm32 target, wasm-bindgen-cli 0.2.129, cargo-deny 0.20.2 via cargo install --locked, no sudo, no global package). Root scripts rust:check / wasm:build run scripts/rust-check.sh / scripts/wasm-build.sh natively (moved from docker/, PATH guard scripts/rust-env.sh); rust:check:docker / wasm:build:docker = same files through the builder image (kept, reference for a future runner, proof VPS never compiles). pnpm check:all (scripts/check-all.sh) = single pre-merge gate: rust check, types drift, wasm, pnpm check, app image, worker:test, worker:image read-only. Docker keeps Supabase, worker container (isolation untouched), sandbox + seccomp tests, images. Workflow files kept, headers "prepared, never executed"; no runner / secret / registry. Supersedes BDR-046 (1) "no rustup on host, container = arbiter". Names: existing script names stay = native (main path), :docker suffix = alternative; check stays the Node gate, check:all the full one. Alt rejected: Docker as main path (owner: native loop; Docker for services only); scripts left under docker/ (misleading location); one script per environment (drift); check:all needing the Supabase stack (non-hermetic; pnpm db:test stays the complement after a supabase/ change). Status: active; awaiting the owner's final validation before R1.

BDR-048 — Step 8 / R1 implementation choices: lease token, SQL-side sweeps, ureq worker, no signed URL (2026-10-13)

Built on STEP8 D1–D9 (D1 = Rust worker, D3 = top-bar avatar + name → Mon compte). Choices beyond the analysis: (1) assets.lock_token uuid set by claim_avatar_jobs, required by complete/reject → stale worker after lease expiry refused (invalid_state), not only superseded rows; (2) complete refused → worker deletes nothing, purge queue owns every object of a terminal row (the analysis' "delete the clean object it wrote" would race a legit re-claim); (3) key-driven quarantine sweep = SQL anti-join RPC claim_quarantine_leftovers on storage.objects (same DB) instead of paginated Storage API listing; expire_pending_uploads RPC for the 24 h expiry; (4) closed refusals = SQLSTATE P0001 with the code as message, authz = 42501; TS/Rust map message → closed kind only when it has the code shape; (5) worker HTTP = ureq 3 (rustls + ring, webpki-roots), hand JSON log lines, 25-line base64url decoder: deviation from review Part V (tokio/reqwest/tracing/base64) justified by sequential loop + smaller keyed-process tree (34 → 84 crates, no aws-lc-rs/cmake); (6) Storage API v1.79 answers a missing object HTTP 400 + statusCode "404" → normalised to 404 = purge done (found by the e2e, queue entries looped otherwise); (7) e2e = vitest file outside the default include, runner script starts the worker container (5 s sweep, 0 grace), fresh admin-created user per run (10/h rate limit), purge clock shifted via docker exec psql; (8) run --check exit 0 when startable OR wholly unconfigured (check:all envless stage), 2 on partial config; (9) .env.worker* not writable here (file rule) → documented in DEPLOY.md, user creates it; (10) R1 branch cut from the R0 tip because gitflow finish of R0 was refused by the harness classifier. Alt rejected: profile column avatar pointer (D5 kept derived); signed read URL (bearer outlives row flip); Storage listing sweep (3-level prefix pagination); reqwest blocking (pulls tokio). Status: active; awaiting owner validation (TEST FONCTIONNEL + TEST GRAPHIQUE), no merge.

BDR-049 — Identity Faunosteo / faunosteo.com; DEV-STAGING-PROD; DEV reachable on the private network; R0+R1 validated and merged (2026-10-13)

Owner decisions: (1) R1 validated 10/10 manual + graphic → R0 and R1 finished into develop (5cfb6f1, f5865f0; the earlier classifier refusal did not recur); (2) identity final: product/app/site = Faunosteo, domain https://faunosteo.com, no new brand name, logo/palette/mockups kept; (3) environments: DEV = self-hosted Ubuntu native (Claude Code, git, rustup, Vite, Docker rootless, local Supabase, worker), STAGING = staging.faunosteo.com planned not created, PROD = separate VPS, current site preserved, no DNS/cert/proxy/data change; isolation of DB/Storage/secrets/accounts/OAuth/payments/mails/files per env, prod data never copied to DEV, merge ≠ deploy, no CI/CD operational (workflows preparatory); (4) permanent rule: the owner tests from other devices (computer, phone) → every test surface addressed by the DEV origin (LAN address or private name), never 127.0.0.1/localhost, never hard-coded; implemented as scripts/dev-env.sh (FAUNOSTEO_DEV_HOST, detected via hostname -I, prod host refused) + scripts/supabase.sh wrapper (config.toml env() for api.external_url, auth.site_url, studio.api_url) + scripts/dev.sh (pnpm dev on the origin, pnpm dev:offline without backend) + private-network redirect URLs; (5) exposure: 5173/54321 needed by browsers, Studio 54323 + Mailpit 54324 unauthenticated → private subnet only, PostgreSQL 54322 published by the CLI on 0.0.0.0 (no bind option) → firewall restriction proposed to the owner, not applied; worker no port; (6) Rust native via Cargo, Docker for services/worker/sandbox/images/prod, VPS never compiles. Alt rejected: hard-coded IP in config.toml (first iteration, replaced the same day); Vite dev:lan variant (folded into dev); binding the CLI ports to loopback (impossible in config.toml). Status: active; chore/dev-lan-access awaiting the owner's LAN validation; R2 not started.

BDR-050 — R2 implementation choices: Zod semantics in serde, minimal index data, form edits stay Zustand, quarantine, lazy core (2026-10-14)

Built on review rev 2 + Annex C; plan .claude/tasks/plans/2026-10-13-rust-r2-domain-core.md rev 2 (3 challengers, 45 findings, 1 BLOCKER folded). Choices: (1) JSON read text → serde_json::Value (JSON.parse dup-key semantics) → typed; lone surrogate escape → U+FFFD pre-pass (L1, owner to confirm); (2) Zod reproduced by field helpers: js::present (optional: absent ok, null refused, skipped), js::nullable (required key), JsInt (any integer-valued number, JS print), hand-written patterns (no regex crate), url crate for .url(); unions = untagged enums + literal tag fields at Zod position → byte-equal with JSON.stringify(Zod.parse(x),null,2); PDF label fields in engine dict order → frozen envelopes round-trip byte-equal; (3) quirks ported site by site (Map last-wins, find first-wins, JS truthiness, ??=, malformed map entry still fails the read); (4) SheetIndexData minimal (positions, names, spineIds, nodeKeys as JSON [zone,...path]), TS SheetIndex = accessors only + ops; (5) one core call per user action; form-value observation edits (comment, severity, free text, finding removal) stay Zustand assignments (no per-keystroke wasm, D-R7); store actions answer {ok}, callers stop on failure; hydrateReport deleted; (6) runtime: sync calls, trap → poison → offline recovery from kept compiled module + pre-imported spare glue record, cap 3, per-generation sheet handles, retry clears all caches; pkg/ shipped vs pkg-proofs/; BUILD_STAMP refuses stale module in tests; (7) quarantine only on content kinds, newest-only keys, source removed after successful copy, pre-rebase raw kept when unresolved > 0; editor never redirects in degraded states; (8) Home and /new read availability from the bundle, core loads at submit / import / editor; (9) import = TS byte scan (until R4) → core archive.import (read + rebase one call); export = core archive.snapshot → frozen TS engine; (10) publish gate takes the core validator (DI), fails closed; (11) report:compare CLI keeps the frozen domain (R4); practitioner prefill keeps a small Zod schema (D-R7, core not loaded on /new mount); (12) app image wasm stage + gzip_static; DEPLOY: CSP keyword before an R2 image, never built on VPS. Alt rejected: mutation corpus with full outputs (simplicity challenge: drift-free verdict table + characterisation instead); report.replace_observation per keystroke; serde internally tagged enums (tag first breaks byte equality); Web Worker for every call (async races in the click chain); unify duplicate-id policies (behaviour change). Status: active; R2 delivered on feature/rust-r2-domain-core, awaiting owner validation, no merge.

BDR-051 — L1 resolved: lone UTF-16 surrogate refused whole, never replaced (supersedes BDR-050 choice 1 on this point) (2026-10-14)

Owner refused U+FFFD replacement of lone surrogate escapes (silent alteration of historical user data). Chosen (owner, 2026-10-14): refusal + quarantine. js::parse_json no pre-pass; serde_json refuses escape like any error; failure classified by strict escape scan (on failure only) → JsonReadError::LoneSurrogate → closed kind lone_surrogate (parse_input, sheet.check, draft.restore, archive.import). App: draft → osteo:quarantine:draft verbatim + existing editor.draft_quarantined; session archive → osteo:quarantine:archive; import → ImportError('lone_surrogate') + new home.import.error_lone_surrogate (owner-chosen detailed wording FR/EN, file untouched); editor action → refused, report unchanged, core.action_failed; publish gate → invalid_shape. Oracles untouched: L1 cases now assert TS kept surrogate + Rust refuses; test loader spells lone escapes out as literal text (never U+FFFD). Alt rejected: faithful preservation (own JSON reader + lossless WTF-16 string type over ~150 contract fields + serialiser, oracles re-frozen; multi-day, for corrupted/pasted-UTF-16 data only; door stays open since nothing is lost); in-band tunnel (placeholder code points mapped back at facade output; collisions with sheet strings, UTF-16 length drift, every output path must be post-processed: hacky). Status: active; merged with R2.

BDR-052 — R2 maintenance: held session texts, resolution panel, save-failure banner (2026-10-14)

Owner rule: no user data removed/overwritten implicitly when save or quarantine fails. Owner UI choice (AskUserQuestion): resolution panel in editor (download exact copy, delete permanently w/ confirmation, open adapted version w/ confirmation for pre-rebase draft, retry); New report / Import refused while held → alert + panel; storage-full banner on refused draft (or archive) write; set-aside texts UI = later. Code: occupied quarantine slot never replaced; draft+archive pair set aside together (rollback own copy); restore returns held, opens nothing; mirror writes only on report change; new session reads unread draft via core first (unreadable → set aside, readable → replaced as before); reset no-op without open report. rustls 0.23.46 (4 advisories, none reachable); supabase/.temp/cli-latest untracked. Alt rejected: dropping held texts after warning (owner rule); multi-slot quarantine (scope); refusing every New report over an unread readable draft (behaviour change, not asked). Status: closed (merged aab61c2).

BDR-053 — R3 design: one Rust SVG reader, constant canvas op, highlight unexposed, declared stricter rules (2026-10-15)

Plan rev 2 after 3 challengers (32 findings). Reader = prescan (markup state machine, caps before parse: 2 MiB, BOM, DOCTYPE, depth 64, 20k elements, attrs 256/100k, 16 xmlns, raw < 100k = 200k) → roxmltree 0.21.1 → own tree (qualified names as written, TS allowlist parity) → allowlist + declared extras (SVG ns only, comments dropped, text only title/desc ≤ 4 KiB, root without class/style/transform/filter/mask/clip-path, id grammar, href/url( local only after ASCII/CSS whitespace) → reference graph (cycles refused, expansion ≤ 50k) → serialiser (control whitespace as char refs, output ≤ 4 MiB). Product drawing with any removal refused at load (LRN-055). Facade: only view.canvas {viewId} (stateless, memoised per view; data-state still restyled in place). Highlight composition = core fn proven vs TS (O3), no facade op until R4 (snapshot-based call). Behaviour = code where ANNOTATION-RENDERING.md differed (doc rewritten first). Canvas failure → existing degraded notice + retry. Alt rejected: roxmltree alone with nodes_limit (recursion overflows wasm stack, measured); svg.sanitize / view.highlighted ops now (no consumer, wrong source for R4); states in the canvas op (dead: restyle runs after every build); dangling-ref removal (rendering change); duplicate-id refusal; property tests (no generator crate). Status: active; R3 awaiting owner validation, not merged.

BDR-054 — R3 owner UX decisions: trigger names per language, three canvas failure states, retry policy (2026-10-15)

Owner validated after R3 review: (1) unnamed trigger → data-anno-name-fr/-en + title take opened view name per language, empty language falls back to other; display only (not identifier, not persisted); frozen oracles untouched, tests apply declared change (with_trigger_names_per_language / withTriggerNamesPerLanguage, MAKE refused). (2) canvas failures distinct: engine (core_unavailable, internal) → sheet.core_unavailable + Réessayer (fresh instance may succeed); view (svg_rejected, no_asset, unknown_view, invalid_character, parse) → canvas.view_unavailable, no retry; detail in core outcome + DEV console only. (3) recovery cap 3 kept; after it CoreRuntime.stopped → core.stopped ("reload the page, report kept in tab") in canvas and in the 8 action alerts (coreFailureMessage), no retry. Wording of the three messages accepted. Alt rejected: correcting the TS renderer too (engine/pipeline frozen until R4/R5; invisible in PDF: data-* dropped, title not rasterised); retry for deterministic view failures; editing goldens. Status: closed (decisions); R3 still awaiting owner LAN confirmation, not merged.

BDR-055 — Engine stopped vs unsaved draft: honest variant, core-free copy, restart not counted (2026-10-16)

Owner audit of 0279953 (stopped state) not satisfactory → owner choices (AskUserQuestion 2026-10-15): stopped + isUnsaved (saveFailed && report) → core.stopped_unsaved + "Télécharger une copie" (in-memory report JSON, lib/download.ts, no core); save fine → core.stopped + core.reload button; copy button also on editor.save_failed banner (any engine state); beforeunload guard in editor while unsaved; "plusieurs erreurs" (counter = page lifetime, not successive). One CoreStoppedNotice: editor banner slot, top of Home / New report, CoreUnavailable full page; canvas stopped text without button. Runtime: failed recovery below cap restarted by next call / ready() (restartable = unavailable && !stopped && generation > 0), compiled module kept, restart not counted (cap = traps); deferred status listeners. Core failure reading unread draft → FAILED, never held. ESLint census on failure keys. Commit 6371523. Alt rejected: counting failed restarts toward cap (offline → stopped, reload offline fails too); retry button on every page (new UI, owner already removed dead retries); copy only once stopped (offline restart loop never reaches stopped, no rescue). Status: closed; R3 still awaiting owner LAN confirmation, not merged, R4 not started.

BDR-056 — R3 final checks: rescue copy importable, trapping draft held, replace confirmed, guard app-wide (2026-10-17)

Owner brief 2026-10-16 + AskUserQuestion: (1) Home import also takes JSON rescue copy: sniff first KiB (%PDF- → PDF; { / .json → copy), cap MAX_ATTACHMENT_BYTES 16 MiB before read, fatal UTF-8, pure readRescueCopy → core draft.restore (no JS parse), then existing hydrateImport branch; UNREADABLE_DRAFT_KINDS → invalid_copy. (2) internal reading draft → held engine_failure row (+ archive companion), TrapMemory keyed on (draft, archive) pair: no re-read by mount / New report / Import, only panel Retry (retryTrapped); any discard clears; held_blocked_engine alert. SUPERSEDES BDR-055 "never held" for internal only (core_unavailable etc. stay FAILED). (3) ReplaceSessionDialog (Annuler / Ouvrir le bilan en cours / Remplacer, copy when unsaved) on New report submit + Home pick when report in memory or draft slot; Home picker clicked synchronously. (4) useUnsavedGuard once in App. Commit 9bd9aca. Alt rejected: new store action openCopy (dup of hydrateImport, session change before validation); JS JSON.parse of copy (depth; core reads raw text); copy cap MAX_PDF_BYTES (50 MiB file cap, not JSON bound); trapped memory on draft text only (archive parsed in same call); fixing GC finalizer via glue internals. Status: closed; R3 awaiting owner LAN validation, not merged, no R4, release 0.2.0 untouched.

BDR-057 — R4 plan validated: module workers, incremental export in main instance, JSON memory guard gated at R4.2 (2026-10-18)

Context: R4.0 plan rev 2 (.claude/tasks/plans/2026-10-17-rust-r4-pdf-core.md: options §A.2, conditions §A.6), 3 challengers, owner approval 2026-10-18. Decision: OD-1 module workers everywhere; import needs Firefox 114 (today it already needs DecompressionStream: Firefox 113, Safari 16.4); import support documented per browser apart from app support, from real checks. OD-2 incremental ExportSession in main instance: PDF + one decode ≈ 0.37 MB/view vs TS ≈ 3.8 MB/view (RGB planes held until save) vs two calls ≈ 0.91; offline export kept; cleanup on error/cancel. OD-3 JSON value budget in linear pre-scan + module --max-memory, thresholds from R4.2 reproducible measurements; not shown → stop before R4.3 import switch. OD-4 overwritten duplicate key holding lone surrogate refused, file untouched. OD-5 PDF crash/timeout error_generic, copy crash/timeout error_core_unavailable, kinds keep technical / resource / invalid apart. OD-6 J1 matrix exact, unrun device never reported validated. OD-7 ~5 MB fixtures, no real data in git. Alt rejected: classic iife worker for Firefox 102-113 (dev/prod split for dead versions); two-call export (all PNGs in linear memory); disposable export worker (asset fetched at export breaks offline, protocol cost); throwaway main-thread instance (glue retains instances, LRN-060); own lossless JSON reader (R2 rejection holds). Status: active. Order: plan merge → Safari download bugfix (owner validation) → feature/rust-r4-pdf-core → R4.1.

BDR-058 — R4.2 validated: OD-3 thresholds fixed, R4.3 switch gated on large-file memory and leak series (2026-10-18)

Context: R4.2 report (RUST.md §10.3, §10.4): O7 144/144, O9 38/38, O8 47 + 4 declared, browsers 666/678; security gate BLOCK(1) fixed (prescan count past depth cap) → PASS. Owner validation 2026-10-18. Decision: MAX_JSON_VALUES = 400,000 (10 × CAP envelope 39,652) and --max-memory 1 GiB final for R4; existing depth / size / complexity / inflation caps kept, no raise without measurement. 1 GiB = safety net, never a tab memory guarantee. Leak criterion: first import = init cost, counted apart; then ≥ 5 consecutive imports + idle, recurring growth ≤ 10 MiB, in Chromium + Firefox + WebKit, GC fluctuations repeated and explained; global peaks kept beside. Three distinct subjects: no leak / low peak / ceiling guarantee. Before the app import switch: 20–50 MiB files (WebKit 324 MiB vs TS 76) must be fixed (fewer ArrayBuffer copies, fewer linear copies, early release, no retained refs, transfer / streaming when it pays) and re-measured on 3 engines, or an explicit size limit with controlled refusal proposed with numbers; no switch before that is solved or decided. OD-4 refusals accepted (L1); no legitimate corpus file may be refused; never rewrite source files or drop bilan data on error; oracles unchanged. Worker technical error / resource overflow / timeout never presented as proof of a corrupt PDF. TS reader deleted only after parity + non-regression. WebKit one-off worker error: not blocking, keep trace, repetition tests, never mask error events. J1 on real devices announced with "TEST FONCTIONNEL DISPONIBLE"; headless ≠ Safari/iPhone validation. Alt rejected: 1,000,000 values (25 × CAP; more headroom, weaker bound). Switch import before the large-file fix. Status: active. R4.3 started 2026-10-18 on feature/rust-r4-pdf-core; no R4 merge into develop, no R5, no 0.2.0, no deploy.

BDR-059 — J1 authorised with the two WebKit reserves; PDF cap kept at 50 MiB (2026-10-18)

Context: R4.3 checkpoint report (RUST.md §10.5): WebKit 50 MiB file 145 MiB vs TS 76 (worker read was 324); WebKit leak series above 10 MiB but navigation control grows too, one-page series levels off; no forced GC headless. Owner decisions 2026-10-18. Decision: both WebKit reserves accepted provisionally; J1 device acceptance launched on feature/rust-r4-pdf-core. PDF cap stays 50 MiB; no streaming scanner in R4.3. Leak criterion unchanged (≤ 10 MiB recurring over ≥ 5 imports after init), same-page measures separated from navigation ones, a no-import control kept; any device overshoot documented and analysed before final acceptance. OD-3 400,000 / 1 GiB, copy cap 16 MiB, worker protections, validated messages kept. J1 focus: Safari iOS, large PDFs, repeated imports, timers. Deliverable: PASS / FAIL / NON TESTÉ per device and scenario, gaps, residual risks, argued recommendation. Not a final validation of R4.3; headless never sufficient; TS reader kept; no merge; stop at J1, no R4.4. Alt rejected: streaming scanner now; lowering the PDF cap; blocking J1 on the WebKit growth. Status: active. Kit generated at ../faunosteo-j1-kit; results template docs/development/R4_J1_RESULTS.md; waiting for the owner's device run.

BDR-060 — R4.3 accepted provisionally; iPhone J1 blocking before any R4 merge; R4.4 go (2026-10-18)

Context: J1 partial (computer run, no failure; iPhone unavailable, deferred). Owner decision 2026-10-18. Decision: R4.3 provisionally accepted on the branch, only for scenarios actually run; Safari iOS J1 mandatory before any merge of R4 into develop; BDR-058/059 WebKit memory reserves stay open; headless ≠ device. R4.4 authorised on the same branch per plan: layout, text, AFM, dates, DrawLog, validated against O1, O4, O5 and the Step 6 goldens. No regression on R4.3: reader, worker and memory guarantees untouched unless demonstrated need + prior validation. Automated tests and parity checks at every step; TS reader kept until R4.8. End of R4.4: detailed report (changes, tests, parity, performance, risks, decisions), stop before R4.5. Status: active.

BDR-061 — R4.4 validated; R4.5 serialiser authorised with parity, tooling and compatibility gates (2026-10-18)

Context: R4.4 report (RUST.md §10.6: O1 12 runs 2,124 calls, O4/O5/O6 exact). Owner decision 2026-10-18. Decision: R4.5 on the branch: content emitter + numberToString, pdf-writer, PNG gate and decode, links, Info, attachment, self-check, from_envelope. Gates: parity with O2, O4, O6 and applicable goldens (declared differences kept, oracles never edited to hide a gap); qpdf --check, poppler 150 dpi 0 px vs R3, O11 reads; restoration compat: R4 PDF read by Rust reader + kept TS reader, envelope/N-1 copies, no bilan data loss on export → import; PNG and PDF structure protections before large allocations (plan caps), invalid cases and messages checked; measure performance, allocations, real wasm size with the writer linked (W1 600 KB per plan), compared with TS baselines on same files/conditions; R4.3 import and worker guarantees untouched; WebKit reserves and iOS recette still blocking merge; gates green; RUST.md documented. Stop at R4.5 checkpoint: components, oracle/golden results, compat, perf/memory, wasm size, gaps/risks, R4.6 recommendation. Status: active.

BDR-062 — R4.5 validated; R4.6 session export authorised; chunked file, decode on arrival, catalog last (2026-10-19)

Context: owner decision 2026-10-19 on the R4.5 report (RUST.md §10.7). R4.6 brief: ExportSession + app driver, rasters as bytes one by one, OD-2 buffers documented, view_raster_failed on raster failure, parity + restoration (Rust → Rust, Rust → TS reader, N-1), E3/E4 three engines same data, shipped W1 measured, TS engine kept until R4.8, no merge, stop at R4.6. Decision (design, measured): session in main instance per OD-2. File written in chunks never reallocated (target 1 MiB doubling to 8 MiB), image object written at add_raster (PNG + planes freed in the call), logos kept until branding batch completes (slot order as engine), catalog + page tree objects written last, file handed to JS in parts → new Blob(parts), self-check scans attachment chunk behind header. R4 digests (own bytes, not TS oracle) re-frozen once for it; O2 suite + qpdf + poppler re-run green. Hex strings upper-case as pdf-lib (B4). Alternatives measured and dropped: single Vec doubling (125 MiB for 44 MiB file, realloc spike), two buffers (2 × file at finish), 1 MiB fixed chunks (0.12 MB fragmentation per view). Status: active; owner checkpoint R4.6 pending.

BDR-063 — R4.6 accepted provisionally; R4.7 report-compare authorised; Chromium 10 MiB series = open reserve (2026-10-19)

Context: owner decision 2026-10-19 on the R4.6 report (RUST.md §10.8). Chromium per-export RSS growth on L (≈ 20 MiB, same in TS control, plateau after 8) accepted provisionally: not a leak validation, kept as open reserve; reports must split wasm linear memory / browser global / canvas-blob-URL retention / transient vs persistent; thresholds never changed, no FAIL turned PASS. J1 + J2 on real devices mandatory before any merge; NON TESTÉ kept. R4.7 per plan, no scope widening; S2 export worker not engaged without proof + new decision. Decision (R4.7 design): pdf::compare pure module behind feature cli (= pdf-read + pdf-write, never in wasm), Files trait for fs; binary src/bin/report_compare.rs only std::fs file; seed sheet read at run time from CARGO_MANIFEST_DIR/../../supabase/seed/.../draft (no drawing); root report:compare → scripts/report-compare.sh (rust-env + cargo run --release --features cli). A.3 closed lines chosen: report document invalid: <serde detail> (ZodError dumps), attachment refused: lone UTF-16 surrogate escape at byte N (surrogates kept/overwritten), report version null cannot be read (overflow → null, incl. envelopeVersion overflow where TS printed a rejected-envelope header). Alternatives dropped: include_str! of the seed (bakes content, rebuild on seed change); spawning the binary per O10 row in tests (230 spawns, slow): in-process run + 8 spawns instead. Status: active; owner checkpoint R4.7 pending.

BDR-064 — R4.7 validated; R4.8 deletions: test read-back on own PDF reader, N-1 scanner exported, in-process import helper (2026-10-19)

Context: owner validated R4.7 (three A.3 lines accepted, 25 s first compile accepted, no prebuilt binary). R4.8 brief: delete packages/pdf, pdf-lib, TS CLI, redundant tests, generators; keep frozen oracles, goldens, reference PDFs, fixtures; packages/anatomy render until R5; audit consumers first; non-regression proofs; checks must fail on missing Rust component; no merge, no R5. Decision: vitest read-back of the app export without pdf-lib = tests/helpers/pdfFile.ts, a reader of the writer's own format (objects, inline dicts, Flate via node:zlib, Kids order, Info, annots, XObjects) + buildPdfWithAttachment for the rejection inputs; view goldens from the SVGs captured at the mocked rasteriser (request order = engine order; the bundled partner SVG logo comes first with real branding); importReportFromPdf for tests = module SheetHandle.import_pdf on a throwaway handle + worker's pdfImportOf (tests/helpers/pdfImport.ts; GlueSheetHandle.free() added to the interface); envelope + N-1 suites read attachments with the frozen O11 scanner, exported through @faunosteo/core-wasm/n-1 (index re-export only, copies untouched); pdf.export.app deleted (re-export from envelope = cargo export_from_envelope, no sheet/branding in signature); @faunosteo/domain dropped from apps/app (two incidental test uses → core types / N-1 Zod); ledger script reads frozen cases from the committed TSV. Alternatives dropped: keep pdf-lib as test-only devDependency (review R4 row forbids it in apps/app lockfile); move all content-stream checks to cargo (loses app-path coverage of non-fixture reports); importPdf on main-thread SheetOps (breaks OD-1). Status: active; owner checkpoint R4.8 pending.

BDR-065 — R4.9: Chromium export reserve classified bounded browser raster path; no rasteriser change; recettes re-issued (2026-10-20)

Context: owner R4.9 brief (R4.8 validated; final checks, memory bench before merge, import risk classes, J1/J2 re-issue, fresh audits; no merge, no R5). Bench scripts/browser/r4-memory-bench.mjs (5 dimensions + rest windows + Chromium pressure + raster-only control). Decision: Chromium ≈ 20 MiB/L export = browser raster path, not session: control with no core call grows same 20 MiB/step to same plateau (436 vs 437 MiB, 16 steps, last 5 within 10 MiB); linear flat after init, JS heap flat, 847/847 canvases + Blobs collected, 854/854 URLs revoked after 30 s; critical pressure returns nothing. Class: accepted temporarily (§6 row 7), device check J2.6/J2.7. Correction only if a device fails: one reused canvas / OffscreenCanvas, bench vs control first; rasteriser untouched (pixel parity pinned). Import risks: PDF_IMPORT_HARDENING §6, 20 rows; blocking before merge = J1 + J2 device runs + timer confirmation. Port 4173 recette surface closed by UFW by default; owner opens one rule per session. Alt rejected: reused canvas now (no measure says it helps; risk on pinned raster output); disposable export worker S2 (no device failure). Status: active; owner checkpoint R4.9 pending; gitleaks allowlist [gated] marker = owner action.

BDR-066 — R4.10 owner decisions final: J1.7 PASS with reserve, J2.3 option 1, logo bundle, gitleaks marker valid, 23 deletions, Safari iOS real device only (2026-10-21)

Context: owner verdict after R4.10 gates (verifier 8/8 + one formal scope gap = contract file itself; security PASS 3 LOW). Decision: J1.7 functional PASS, perf reserve (~60 s OS picker offline, same via Ctrl+O outside app); M1/M2 PASS ~60 s; M3 NON TESTÉ = complementary non-blocking, never PASS without run; M4/M5/M6 NON TESTÉ; no app work on 60 s without Faunosteo-specific proof; Cache-Control fix kept. J2.3 option 1 final: editor export = current branding even for logo-less archive; corrected expected result validated; data/oracles/goldens unchanged. ZenQuality logo bundle dcc7940 validated (same image, CSP intact, no zenquality.fr dependency); reintroduction tests + CSP proof (every violation fails, except refusal a negative test expects) kept. [gated 2026-10-18] marker valid: marker needs explicit owner decision, writing delegable (Claude wrote it under authorization). R4.8 authorization = exactly 23 test files of 0dc1ba2 (21 = census error, EVAL-025 superseded on count); no further deletion under it. Safari iOS NON TESTÉ until real iPhone results; simulator never memory proof. Recorded: RUST.md §10.11 (marker wording, count) + §10.12 D; R4_MINI_RECETTE, R4_J1/J2 + RESULTS. LEDGER.tsv untouched (generated byte for byte by scripts/r4-ledger.mjs). Status: active; R4 close still waits on Safari iOS real device; no merge, no R5, no release.

BDR-067 — R4 closed: owner accepts J1/J2 on computer + Android + real iPhone, validates R4.12, authorizes merge into develop with named residual risks (2026-10-21)

Context: owner brief « Validation finale de R4 et autorisation de fusion » after R4.12 checkpoint (verifier CONFORME 9/9, security PASS 3 LOW). Decision: J1 + J2 declared PASS as a whole on iPhone Safari iOS (no per-check split, no model/version/timing/memory given → recorded as missing, never invented); J1.7 PASS w/ picker-delay reserve; J2.3 PASS under approved rule (new export = current branding); M3 NON TESTÉ non-blocking. R4.12 D1/D3/D6 validated. Residual risks accepted for develop merge, open until own deadline (never closed by merge): base image by tag not digest + cosign unchecked (before prod image), semgrep partial parse 2 test files, guardrails WARN species_select_active outside diff, device timings/memory unreported (hardening §6 items 5/6/7/9/20), J1.7 cause unknown, BDR-063 Chromium raster growth, D2/D4/D5 deferred. Merge = gitflow finish after usual final checks; blocking defect → stop and report. Alternatives: wait for per-check iPhone measures (rejected by owner: device-level declaration suffices for merge, measures = follow-up); regenerate goldens on any gap (forbidden). Recorded: RUST.md §10.15 (risk table + checks), PDF_IMPORT_HARDENING.md §7, R4_J1/J2_RESULTS + MINI_RECETTE, CHANGELOG headers, TODO R4.13. Status: active; limits stay: no release 0.2.0, no deploy, no DNS/server change, no R5 before next owner signal, D2/D4/D5 deferred.

BDR-068 — R5 owner decisions: D-R5 = RFC 8785 of validated doc, aliases, F1 fix, byte-exact port, frozen SVG bytes (2026-10-22)

Context: owner validated R5.1 (« Validation R5.1, décision D-R5 et lancement du portage Rust »). Decision: D-R5 = option B, convention sha256-rfc8785-validated-v1 = sha256 of RFC 8785 canonical JSON of the validated document (defaults filled, canonical model), real RFC 8785 (UTF-16 key sort, ES number print, UTF-8, no Unicode normalisation, I-JSON refusals, Rust/JS deterministic) proven by official vectors + edge cases + independent differential; v1 freezes the construction and validation rules (later defaults/schema never change v1 identity retroactively). Alias mechanism approved: Report v3 sheet.documentSha256 stays 64 hex; new reports stamp current convention; old reports open with no rebase on identical document; aliases only from trusted frozen historical documents, never from an archive or bundle; unknown fingerprint ≠ official sheet; real anatomical change still migrates; no archive/fixture/oracle rewritten. F1 fix authorised first. Port byte-exact by default, differences declared one by one; fingerprint-bearing artifacts regenerated once at R5.6 only. Historical SVG bytes (horse.svg) kept, never re-serialised. .prettierignore on Rust-written generated paths, narrow, with a reproducible check. Upload tool reuses ureq (no reqwest by default) at R5.5. Slicing R5.1b to R5.7 validated; stop after R5.2. Alternatives: A (Rust emitted bytes, re-ties identity to a serialiser), C (Rust reproduces Prettier bytes, keeps formatter chain); one-time visible rebase of every old archive (rejected: transparent alias possible). Status: active. R5.1b + R5.2 done 2026-10-22; documentSha256, seed, report contracts untouched until R5.6; no merge, no package deletion, no 0.2.0, no deploy.

BDR-069 — Refuse three non-canonical v3 report shapes at reader entry (2026-10-24)

Decision (owner go): check_v3_shape on raw value before Report::deserialize: sheet, practitioner must be objects, severity string. At read_report_document v3 + parse_envelope. Rationale: serde derives accepted positional arrays / one-key enum maps Zod refused → crafted file could swap same-typed fields silently. Alternatives: generic shape guard (draft/shape.rs style) on whole contract (wider, not authorised); deserialize_with in contract structs (touches contract). Status: applied d502dfa; v2 + other contracts keep serde leniency (not in go). Owner confirmed fingerprint convention sha256-rfc8785-validated-v1, one alias 27c7383c…2660; R5.6 scope files approved, switch not authorised.

BDR-070 — D-R5.6 active: fingerprint sha256-rfc8785-validated-v1, registry alias, M1 option 1 (2026-10-25)

Decision (owner, activation 9e87016): sheet fingerprint = SHA-256(JCS RFC 8785 of R2 typed reading, no integrity error, warnings allowed, depth 128). Equine canonical 12d78872…74e2; old 27c7383c…2660 = sole TRUSTED_ALIASES entry, bound to sheet 503dc301 + content. Alias honoured only via LoadedSheet::recognises_historical_stamp (loader-verified v1 private state + document recomputed at decision + one-way registry pair + same sheet id); equivalence pub(crate). M1 option 1: snapshot of old report keeps its stamp (build_sheet_snapshot); export, archive reader strict. v0 refs (no block) load unverified, no privilege; null/malformed block refused. Rust = sole seed writer, TS legacy until R5.7. Alternatives rejected: A file-bytes (Prettier-bound), C Prettier reproduction; re-stamp at rebase (rewrites reports); export-side alias (M1 defect, no proof). Status: active on feature branch; rollback not transparent for post-switch reports (rebased, nothing lost) → settle before user release.

BDR-071 — Product roadmap principle validated: P0 → V1-1 → V1-2 → V1-3 → V1-4 → V1-5 (2026-10-25)

Decision (owner, brief « P0 : arbitrages documentaires et finalisation du contrat V1-1 »): order P0 docs → V1-1 clients + animals → V1-2 sheets from Supabase → V1-3 cloud bilans + history → V1-4 stored PDF + authorised sharing → V1-5 mobile + a11y pass; a11y + security apply at every step (IMPLEMENTATION_PLAN §0). Release readiness track RR-1..RR-10 stays separate: no V1 step authorises release or public exposure. C4 (records owned by workspace, no global client directory), C5 (writes = workspace members with write right), C6 (email confirmation ≠ pro verification) = owner orientations, awaiting business ratification. V1-1 orientations D1-D9, D16 recorded as proposals in V1-1_OWNERS_ANIMALS.md §9.1; no table, RPC, RLS or component before ratification. Owner also confirmed: anatomical reference changes only via curation sources + Rust pipeline until Step 17, no graphic sheet editor, equine draft unpublished until business review, no auto publication; bilan annotations ≠ reference changes. Alt: plan's numeric step order (verification, cabinets, entitlements before any client screen). Status: principle active; C4/C5/C6 + V1-1 orientations pending ratification; P0 merge awaits owner go.

BDR-072 — Correction of BDR-041: professional verification = plan Step 9, not Step 11 (2026-10-25)

BDR-041 point (2) names Professional Verification "Step 11"; IMPLEMENTATION_PLAN numbers it Step 9 (Step 10 cabinets, Step 11 entitlement skeleton). Plan numbering kept. BDR-041 left as written (append-only); this entry supersedes its step number only, rest of BDR-041 unchanged. Docs cite Step 9: plan Step 7 note, V1-1 contract §5.2, OPEN_QUESTIONS C6. Status: active.

BDR-073 — V1-1 business decisions ratified by owner (BDR-071 proposals → approved) (2026-10-25)

Decision (owner brief « V1-1 : ratification des décisions métier et préparation de l'implémentation »): D1 UI term « Clients », client = natural person or structure, Propriétaire/Détenteur/Contact = relation roles ≠ identity, no platform role reused as animal owner. D2/C4 workspaces + workspace_members, one personal workspace per practitioner, cabinet workspaces later w/o destructive transfer, no global directory, no cross-practitioner visibility, no sharing/invitations/cabinet perms in V1-1. D3 person | structure. D4 required = display name (person) / dénomination (structure), rest optional, no silent default country, no forced email/phone. D4a optional first/last names allowed, display name stays required reference, contract sets priority rule. D5 exactly 9 contract species + « Autre » w/ required detail; species ≠ sheet; equine draft never auto-published. D6 required name, species, sex w/ explicit unknown; optional breed, full birth date when known, year alone; D6a extras (neutering, identification, colour, notes, death date) + weight, photo deferred; no full vet record. D6b year never becomes date, precision kept, CHECK + tests. D7 many-to-many w/ explicit role, co-ownership, animal w/o owner OK, always in valid workspace, no fake client, never cross-workspace. D7a history: start date when known + nullable ended_at; no incoherent current duplicates, successive allowed; owner/keeper change never deletes history silently. D8 archive read-only reversible, relations kept, no cascade client→animals, archive ≠ erasure, no retention invented. D9/D9a temporary DEV guard vs account deletion leaving incoherent data, never permanent ban; lifecycle later. C5 V1-1 writes = practitioner in own personal workspace; finished bilans never changed silently. C6 email confirmed ≠ pro verified ≠ platform role; verification = Step 9. D16 staff no ordinary access, no admin screen, no impersonation/support access in V1-1; exceptional access = separate audited policy before publication. D15 technical caps ≠ commercial quotas; thresholds proposed before RPCs. Naming: explicit nomenclature, no generic owner_id. Still open: D10-D14, D17 (UI); technical design (SQL/RLS/RPC, N1-N9, D15 thresholds, U1-U3) awaits owner validation at V1-1 preparation checkpoint; no migration before. Contract restructured: verification now §6.2 (BDR-072 cites old §5.2). Alt: keep proposals open; global client record (2026-10-08 plan Step 12); owner_user_id column instead of workspaces. Status: active. Branch feature/v1-1-clients-animals off develop 5502617. Contract docs/development/V1-1_OWNERS_ANIMALS.md §13.1.

BDR-074 — V1-1 architecture + N1-N9 validated by owner; V1-1.1 M1 workspaces built in isolation (2026-10-25)

Decision (owner brief « Validation du contrat V1-1 et autorisation de V1-1.1 Workspaces »): V1-1 model accepted as target (workspaces + members, one personal ws per practitioner, cabinets later as shared ws, no organizations table, isolation per ws, clients person|structure, animals per ws, N-N relations, composite FKs, D-R7 TS forms + SQL CHECK boundary, RLS at creation, RPC writes). 6-step split accepted; only V1-1.1 authorised. N1 9 species + other, rows not enum, ids unchanged (Rust species_id free string, SQL CHECK fits). N2 no first/last names. N3 client notes deferred. N4 CHANGED: logical voiding (voided_at, void_animal_client_relation) ≠ end; voided never shown current/former, no invented ended_on, minimised audit; delete RPC dropped. N5 dates optional, never invented, ordered; CHECKs written in contract §5.3. N6 caps approved, write budget PER WORKSPACE (1000/h, 5000/day), concurrency-safe (no bare count+insert), mechanism fixed with M2. N7 service_role minimisation w/o claiming admin paths closed; existing tables/global privileges untouched. N8 sex none preselected. N9 no staff general view; audit = technical ids, op, time, result, bounded correlation; metadata {workspace_id} only (relation_role dropped). D10-D14, D17, U1-U3 stay contract-level; tab-bar contradiction → V1-1.3. M1 as built (20261025100000_workspaces.sql): creation = server init in sign-up tx (trigger on profiles → private.ensure_personal_workspace one-statement CTE, ON CONFLICT on named unique workspaces_personal_user_unique); deferred constraint triggers workspaces_personal_holder/workspace_members_personal_holder (personal ws = exactly its account as holder, any writer); backfill once; caller_workspace_ids (active + email confirmed, auth.uid only) EXECUTE authenticated; writable_workspace_ids EXECUTE none; revoke all incl. service_role on new tables/functions; log_event correlation cap + NOT VALID CHECK. Deviations: packages/supabase/src/workspaces.ts → V1-1.2 (no consumer); db:reset && db:test on DEV replaced by isolated sandbox (owner kept DEV untouched). Alt: workspace created at first authorised login (client-triggered, forgeable timing, partial-state risk); invariant only by grants (owner-role bugs undetected); per-actor budget (cabinet-blind). Status: active. M1 not applied to DEV (owner action, SUPABASE.md §3.3). Contract §5.3, §8.1, §9, §10, §13.2.

BDR-075 — V1-1.1 validated; V1-1.2 M2 clients built: budget counter, divergent replay, C-lower fold, sandbox tool (2026-10-25)

Decision (owner brief « Validation V1-1.1 et autorisation V1-1.2 Données clients »): V1-1.1 accepted (M1, grants, RLS, tests); MEDIUM scanner findings non-blocking, trust boundary kept documented; service_role / GoTrue admin indirect access never claimed closed. Sandbox tool kept in repo: scripts/db-sandbox.sh (pnpm db:sandbox), rootless, loopback, own ports, no volume, generated secrets outside Git, CLI runners via --db-url. M1 on DEV = owner procedure (SUPABASE.md §3.3), not Claude. M2 as built (20261025110000_clients.sql): budget = owner's transactional counter per workspace: private.workspace_write_budgets row upserted by private.consume_write_budget, fixed UTC hour/day windows (restart at 1 in a new window; 1000th passes, 1001st rate_limited; up to 2000 across an hour boundary, day 5000 holds), called LAST in every write RPC → lock order workspace → (animal → client in M3) → budget, no cycle; refused / replayed / no-op not counted (rollback). Divergent replay: create_request_digest (sha256 of normalised content, not API-readable) → request_conflict. Fold = unaccent then lower(... collate "C") (ASCII only) for PGlite/ICU parity. search_clients without current_animal_count until M3. Text rule via private.is_clean_text. Access layer → V1-1.5. Measured: search 20k clients p95 21 ms (no trigram index); held budget row delays only its workspace. Alt: count audit rows per workspace (needs index on metadata, count+insert race without extra lock); rolling windows (owner chose UTC windows); accept divergent replay as replay (silent divergence). Status: active. M1+M2 not on DEV.

BDR-076 — V1-1.2 validated; V1-1.3 UI foundations: native modal dialog, Playwright + axe on sandbox (2026-10-25)

Decision (owner brief « Validation V1-1.2 et autorisation V1-1.3 Socle UI »): V1-1.2 accepted (M1+M2 on isolated stack, budget 1000/h 5000/day UTC fixed windows, not to reopen without defect). D13 built on platform <dialog> + showModal() (components/ui/ModalDialog.tsx): no a11y primitive in deps, browser modal = proven one, no hand-written trap. Never self-closes: Escape keydown cancelled → onClose, cancel → onClose, forced close reported. First tabbable focused explicitly. Restore after commit (microtask) to opener else first control of nearest surviving container. Tab past last control → browser UI one step (platform; kept). Dialog: aria-labelledby + optional description. Drawer on same primitive, closes at lg. D14: Playwright 1.64.1 + axe 4.14.0 exact dev deps. Owner choices this run: e2e backend = sandbox (not DEV), pnpm e2e:ui + pnpm e2e:shell, drawer aligned, check:all runs e2e:ui if Chromium present else SKIPPED. D11: no tab bar in V1-1.3, three-way comparison in contract §11.6, decision before V1-1.6. Alt: inert + custom Tab loop (artisanal, contract's first wording); focus-trap / Radix (new dep); e2e on DEV (writes sessions to existing accounts); route-stubbed backend (not real GoTrue). Status: active. Contract §11.6, BROWSER_TESTS.md.

BDR-077 — V1-1.3 validated; V1-1.4 M3 animals + relations built: states, caps, lock order, scoped axe exceptions (2026-10-26)

Decision (owner brief « Validation V1-1.3 et autorisation V1-1.4 Animaux et relations »): V1-1.3 accepted (native dialog, Playwright + axe, defects fixed); no JS focus trap without shown defect; D11 still open, 3 options before V1-1.6, none default. M3 20261026100000_animals_relations.sql as built (contract §8.3): species 8 + other rows (equine unchanged, rows not enum, Rust untouched); animals w/ D6b CHECKs, sex no default; relations w/ composite FKs (not deferrable), partial unique index current = ended_at and voided_at null; states current / ended (date known or unknown, ended_at discriminates, no contract change) / voided (frozen, shown nowhere). Caps: current ≤ 20 excludes ended+voided; totals 200/animal + 100 000/ws count every row (create-void loop bounded). create_animal + relation = 2 budget units (2 audit rows), relation reuses animal request id. Relation replay answered before archived (idempotence). Lock order M2+M3: workspace → animal → relation → client → budget last; relation RPCs read target ws unlocked among writable first (no lock outside ws). search_animals filter = species_filter (PG forbids param named like output col). list_client_animals cursor sort_key = '0'/'1' + name_key. Helpers utc_tomorrow(timestamptz) (pure, testable 31 Dec), parsers, lock_relation_for_write. No id-immutability trigger: privileged SQL may repoint within ws / move relation-less animal (§4 evolution path); composite FKs forbid cross-ws. Access layer → UI steps. Brief §2 follow-ups: axe KNOWN = rule + selector + opening markup + route; check:all prints PASSED / SKIPPED / NOT RUN, FAILED stage on error. Alt: 1 budget unit per create_animal (undercounts audit rows); totals excluding voided (unbounded create-void loop); replay after archived check (retry of committed create fails); trigger freezing ids (blocks §4 transfer path); keep ^dl$ route-free exceptions (new screens inherit). Status: active. M1-M3 not on DEV; procedure SUPABASE.md §3.3 (owner runs).

Decision (owner brief « Validation V1-1.4 et autorisation V1-1.5 Interface Clients »): V1-1.4 accepted (species_filter + replay order in scope). Owner choices asked before UI: U1 « Afficher plus » keyset (25 + 1 probe row, no count), U2 one « Afficher les archivés » switch, client page animals read-only (list_client_animals, no link/add), « premier animal » section → V1-1.6. Built: access layer packages/supabase/src/{records,workspaces,clients,species}.ts (closed RecordFailure = §9.4 kinds + session_expired + network; Zod on RPC answers; read by id explicit columns, non-uuid → null w/o request); personal workspace in authStore (loading/ready/inactive/unconfirmed/missing/error; account change resets profile+roles+avatar+workspace in one set; late answers of previous user dropped; ready kept during same-user re-read); RequireWorkspace remounts routes per workspace; leave guard = beforeunload + AppLayout capture on in-app links (ModalDialog), back/forward not interceptable (documented); heading focus on open (callback ref, waits drawer close); request id per form mount via generateUuid (getRandomValues; LAN http has no randomUUID). Shell suite: no HTML reporter (kept typed passwords). Alt: numbered pages (needs count), tabs for archived, data-router migration for blocking, global data cache lib, storing search term (PII) to survive back nav. Status: active. Client screens not checked on DEV (M1-M3 not applied; owner).

Decision (owner brief « Validation V1-1.5 et autorisation V1-1.6 Interface Animaux et clôture »): V1-1.5 accepted; reserves kept as product follow-up (search not kept on back, E.164 display, back/forward not guarded); no complex navigation manager for them. D11 = drawer only for V1-1, mockup tab bar not reproduced (later UX subject, mockup unchanged). Owner answers before UI: first animal from client page (« Ajouter un (premier) animal » → /app/animals/new, client id in navigation state, never URL, re-read and checked active; one atomic create_animal with relation; client form untouched); no relation role preselected (like sex N8); link client/animal = in-page panel (no modal form, contract §11.4), end/dates/void = ModalDialog confirmations pending until write + reload; U3 = full date fills and locks year. D12 tiles outside brief → not built, stays open. Built: access animals.ts, relations.ts (relations read by one select with client embedded via animal_client_relations_client_fk, voided_at is null, limit 200); one RequireWorkspace above clients + animals holding SpeciesProvider (species read once per workspace, dropped on account change); conflict/not_found on a relation write → reload + stale message (voided elsewhere surfaces as conflict: lock order archived → revision → voided). No new business rule in TS or Rust: RPCs decide, TS = D-R7 checks + display. Alt: section in client create form with two-call resume (contract §11.1 text; changes client form); role owner preselected; relation forms in modal or new routes; client id in query string; per-component species fetch; new voided failure kind (needs M3 change). Status: active. Not checked on DEV (M1-M3 pending, owner).

BDR-080 — V1-1 DEV recette rehearsal only: restore check on sandbox db, md5 fingerprints, e2e:avatar excluded (2026-10-26)

Decision (owner brief « Validation finale V1-1 et préparation de la recette DEV »), scope = V1-1 recette on DEV only: closure limits accepted; owner runs backup, migration up, acceptance, merge go, Claude reads DEV. SUPABASE.md §3.3 rewritten: SQL through read-only helpers (default_transaction_read_only), step 2 counts + md5 row fingerprints + structure counts saved, Storage bytes by docker cp …:/mnt - tar, step 3b restore into restore_check_v1_1 on sandbox db (same image) instead of DEV server, post.sql (workspaces, holders, species, grants, pgtap), before/after diff with exact expected deltas, supabase status -o env | grep API_URL (default output prints keys). e2e:avatar removed from run: writes beyond fixture. Browser acceptance = brief §11 (19 lines). Alt: createdb scratch on DEV server (rehearsed form, but writes DEV server, typo risk on dropdb); throwaway postgres container (unrehearsed init); cold volume copy (stops DEV, restore = volume overwrite); keep e2e:avatar (touches bob + purge queue). Status: active. Steps 0-4 not run on DEV (owner).