diff --git a/.claude/tasks/contracts/2026-10-21-rust-r4-anomalies-1000.md b/.claude/tasks/contracts/2026-10-21-rust-r4-anomalies-1000.md new file mode 100644 index 00000000..1ddd36ff --- /dev/null +++ b/.claude/tasks/contracts/2026-10-21-rust-r4-anomalies-1000.md @@ -0,0 +1,107 @@ +# CONTRACT — rust-r4-anomalies (R4.10) +- date: 2026-10-21 | flow: verify (R4.10 gates) | branch: feature/rust-r4-pdf-core +- status: active +- base: 4509313 (R4.9 tip); diff under review: 4509313..HEAD; run every CHECK from the repository root +- harness env: `PLAYWRIGHT_NODE_MODULES=/home/bchanot/.local/lib/node_modules/gsd-pi/node_modules`; build in apps/app/dist (`pnpm build:preview`) + +## REQUEST (verbatim — IMMUTABLE) +FAUNOSTEO — Précisions définitives J1/J2 et diagnostic des anomalies + +Je complète mes résultats de recette R4. + +Navigateurs réellement utilisés + +- Chrome sur ordinateur. +- Firefox sur ordinateur. +- Brave sur ordinateur. +- Android avec son navigateur. + +Safari sur iPhone n'a pas encore été testé. + +La répartition exacte des 27 contrôles par navigateur n'a pas été fournie ; ne marque pas automatiquement chaque cellule PASS. + +Anomalie A — J1.7, import hors ligne + +FAIL confirmé sur Brave et Firefox. + +Surface concernée : build de production local, port 4173, avec CSP de production. + +Scénario : une fois hors ligne, cliquer sur « Importer » n'ouvre pas le sélecteur de fichiers et le navigateur devient impraticable. + +Résultat attendu : le parcours prévu par J1.7 doit permettre d'importer un PDF de référence hors ligne après chargement préalable de l'application et du moteur. + +Diagnostique précisément : + +- Le déclenchement du sélecteur de fichiers. +- La navigation dans l'application après perte de connexion. +- Les éventuelles attentes réseau bloquantes. +- Le chargement et le cache du worker et du module WASM. +- Les erreurs JavaScript et les éventuelles restrictions CSP. +- Les différences Brave/Firefox et les conditions exactes de reproduction. + +Distingue un défaut applicatif d'une limitation réelle et documentée du navigateur. Ne conclus pas à une cause sans preuve. + +Corrige le problème si le diagnostic confirme un défaut de Faunosteo. + +Anomalie B — J2.3, export sans logos + +FAIL confirmé pour le comportement observé. + +Après import de "1-reference/r3-demo.fr.nologos.pdf", le PDF exporté affiche encore des logos graphiques dans l'en-tête et le pied de page. + +La procédure J2.3 prévoit un nom de site et des crédits sous forme de texte, sans ces logos. + +Vérifie notamment : + +- Le contenu exact du PDF de référence. +- Le branding effectivement stocké dans l'archive. +- Le branding ajouté par l'application. +- La réutilisation éventuelle de données d'une session précédente. +- Les règles historiques de fallback sans logos. +- Les oracles PDF et les contrats du cœur Rust. + +Ne modifie ni les goldens, ni les règles métier, ni l'attendu de recette simplement pour faire passer le test. + +Présente-moi le diagnostic si une décision de comportement produit est nécessaire. + +Résultats à consigner + +J1.1 à J1.6 : PASS déclarés. +J1.7 : FAIL sur Brave et Firefox. +J1.8 à J1.13 : PASS déclarés, J1.12 en quelques secondes sans mesure précise. + +J2.1 et J2.2 : PASS déclarés. +J2.3 : FAIL confirmé, logos graphiques en en-tête et pied de page. +J2.4 à J2.14 : PASS déclarés. + +Conserve NON TESTÉ pour Safari iOS et pour toute combinaison appareil/test non explicitement confirmée. + +Suite + +Réalise un diagnostic ciblé, puis les corrections nécessaires avec tests de non-régression et audit adapté. + +Si les modifications sont limitées, prépare une mini-recette permettant de revalider uniquement les parcours touchés ainsi que leurs dépendances fonctionnelles. + +Ne fusionne pas R4 dans develop. + +Ne commence pas R5. + +Ne touche ni à la release 0.2.0 ni à faunosteo.com. + +Présente-moi tes conclusions et les instructions de revalidation avant toute clôture définitive de R4. + +## CRITERIA +1. Results recorded as declared, nothing inferred: in `docs/development/R4_J1_RESULTS.md` J1.7 is FAIL in the Firefox and Brave cells and in the declared column; every other J1 row is `PASS déclaré` in the declared column only (J1.12 with « quelques secondes », no measure); in `R4_J2_RESULTS.md` J2.3 is FAIL and J2.1-J2.2, J2.4-J2.14 `PASS déclaré` in the declared column; every device cell other than J1.7 Firefox / Brave is `NON TESTÉ` (or `not applicable` as before for J2.11 / J2.14 phones); Safari iOS NON TESTÉ everywhere. + CHECK: `git diff 4509313 -- docs/development/R4_J1_RESULTS.md docs/development/R4_J2_RESULTS.md` +2. Anomaly A, cause shown with proof: `scripts/browser/serve.mjs` sends exactly `docker/nginx.conf`'s Cache-Control values (`no-store, no-cache, must-revalidate` on /env.js, `public, max-age=31536000, immutable` on /assets/ files) and nothing else in its behaviour changes (bind address checks, CSP, mounts, 404 and SPA fallback, report-uri). + CHECK: `git diff 4509313 -- scripts/browser/serve.mjs`; `grep -n Cache-Control docker/nginx.conf` +3. Regression harness: `scripts/browser/r4-offline-import.mjs` runs J1.7 (online import, network cut by Playwright offline mode and by killing the server, « Accueil », pick through « Remplacer ») on the three engines, checks the headers, exits 1 when a Chromium or Firefox row does not open the editor or any row has a page error or no answer; the committed results file shows 6 runs with empty `problems`. + CHECK: `PLAYWRIGHT_NODE_MODULES=/home/bchanot/.local/lib/node_modules/gsd-pi/node_modules node scripts/browser/r4-offline-import.mjs --out /tmp/r4-offline-verify.json; echo exit=$?` → exit=0 +4. Anomaly A, unproven part stated as unproven: RUST.md §10.12 does not claim the cause of the frozen file picker; it states it was not reproduced and gives a discriminating step; the WebKit headless limit is stated as such, Safari iOS unknown. + CHECK: `sed -n '/### 10.12/,$p' docs/development/RUST.md` +5. Anomaly B diagnosis with no behaviour change: no file under `apps/`, `crates/`, `packages/`, `supabase/`, goldens or oracles changed; the §10.12 claims hold: the nologos reference's archive has the four logo slots null, `apps/app/src/pdf/export.ts` passes `loadBranding()` (bundled logos) at HEAD and at 66909b6, the archived branding reaches the writer only via `export_from_envelope`; an owner decision is requested; `R4_J2.md` J2.3 expected result unchanged. + CHECK: `git diff --stat 4509313 -- apps crates packages supabase docs/development/R4_J2.md docs/development/R4_J1.md` → empty; `git show 66909b6:apps/app/src/pdf/export.ts | grep -n loadBranding`; `grep -rn "export_from_envelope\|exportFromEnvelope" apps crates/core/src | head` +6. Mini-recette `docs/development/R4_MINI_RECETTE.md` re-runs only J1.7 and its dependencies (J1.1, J1.13), with the discriminating step, setup (build, UFW 4173 open then deleted, serve), what to report; J2.3 explicitly waits for the decision. + CHECK: `cat docs/development/R4_MINI_RECETTE.md` +7. Scope and style: no merge, develop unchanged at 66909b6; no em-dash in the new or changed user-facing docs; prettier clean on the changed scripts. + CHECK: `git rev-parse --short develop`; `git diff 4509313 -- docs | grep '^+' | grep -c '—'` → 0; `node_modules/.bin/prettier --check scripts/browser/serve.mjs scripts/browser/r4-offline-import.mjs`