chore(memory): R4.10 contract
This commit is contained in:
1 parent
868aa3d001
commit
654fd9dccd
1 file changed
+107
@@ -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`
|
||||
Reference in new issue
Block a user