diff --git a/.claude/tasks/TODO.md b/.claude/tasks/TODO.md index 41b053e0..d1a5ba25 100644 --- a/.claude/tasks/TODO.md +++ b/.claude/tasks/TODO.md @@ -269,7 +269,13 @@ feat/findings-tree-v2 merged (FindingsTreePicker tracked in HEAD); all work belo - [x] R4.9e independent audits (owner §6): contract `.claude/tasks/contracts/2026-10-20-rust-r4-final-1000.md` (owner §2 list as criteria), fresh verifier + fresh security audit in parallel; real anomalies fixed minimally with regression tests + targeted re-audit; oracles/goldens unchanged - [x] R4.9f docs + memory: RUST.md §10.11 (bench, classification, audits, checks, residuals), CHANGELOG, TODO; BDR / EVAL / journal; commits on `feature/rust-r4-pdf-core` (hooks push) - [x] R4.9 results (2026-10-20): bench = linear flat, objects/URLs released, Chromium growth = browser raster path (control identical, plateau), BDR-065; §6 20 rows; recettes re-issued + kits; check:all green 49b812b; verifier CONFORME 16/16 (pass 3); security PASS after BLOCK(1) gitleaks marker (owner) + host bind fix ×3 re-gates; EVAL-025, LRN-065 - - [ ] R4.9g checkpoint report (owner §9: verifier, security, checks, memory + reading, residual risks, real merge blockers, J1/J2 instructions, git state) → STOP; merge and R5 only on the owner's explicit signal + - [x] R4.9g checkpoint report (owner §9: verifier, security, checks, memory + reading, residual risks, real merge blockers, J1/J2 instructions, git state) → STOP; merge and R5 only on the owner's explicit signal (delivered 2026-10-20) + - [ ] R4.10 J1/J2 anomalies (owner 2026-10-21: J1.7 FAIL Brave + Firefox, J2.3 FAIL; no merge, no R5, no release, no faunosteo.com) + - [ ] R4.10a results recorded as declared: J1.1-J1.6, J1.8-J1.13 PASS declared (no per-browser split given: cells stay NON TESTÉ per device, declared status in a note), J1.7 FAIL Brave + Firefox, J2.3 FAIL, others PASS declared; Safari iOS NON TESTÉ; Brave noted as outside the OD-6 list + - [ ] R4.10b anomaly A diagnosis: headless repro (Chromium, Firefox, WebKit; emulated offline): Chromium refuses the worker chunk offline = serve.mjs sends no Cache-Control on /assets/ while nginx sends `public, max-age=31536000, immutable` → recette surface defect; picker freeze not reproduced headless (native dialog) → discriminating protocol for the owner + - [ ] R4.10c fix A: serve.mjs mirrors nginx.conf cache headers (/assets/ immutable); regression harness `scripts/browser/r4-offline-import.mjs` (J1.7 offline on the 3 engines + header check) + - [ ] R4.10d anomaly B diagnosis: editor export always embeds the bundled branding (Step 6 rule, unchanged since 66909b6); archived branding reused only by `export_from_envelope` (cargo); J2.3 expectation wrong (R4.6 wording) → owner decision, no code change + - [ ] R4.10e gates: verifier + security on the diff; mini-recette doc; memory; commits - [ ] owner actions: add `[gated 2026-10-18]` to `.gitleaks.toml` allowlist description (security BLOCK); `[gated]` clarification for the 21 R4.8-deleted test files if wanted (verifier floor); open UFW 4173 for the recette session; J1 + J2 on the OD-6 devices - [ ] owner action (non-blocking): `packages/pdf/node_modules` leftover (13 pnpm symlinks, 6 bin shims, 1 vitest cache file, 0 tracked or useful files) → `rm -rf packages/pdf/node_modules && rmdir packages/pdf` (the recursive delete was refused to Claude by the permission layer) - [ ] outside R4 (owner 2026-10-17, non-blocking): worker container ignores SIGTERM (Docker kill after 10 s; chore, e.g. `init: true`); README test counter stale (367 vs 1,015) diff --git a/docs/development/R4_J1_RESULTS.md b/docs/development/R4_J1_RESULTS.md index a13d9901..d9ef59f6 100644 --- a/docs/development/R4_J1_RESULTS.md +++ b/docs/development/R4_J1_RESULTS.md @@ -14,30 +14,41 @@ stays `NON TESTÉ` and blocks the final acceptance of R4.3 (plan §A.4, OD-6: a device not run is never reported validated). The J1.8 / J1.12 timings and the J1.9 / J1.10 memory observations on the computer are pending too; every cell below stays `NON TESTÉ` until the owner confirms it, nothing is inferred. +Status 2026-10-21 (R4.10): the owner ran the recette on the computer with +Chrome, Firefox and Brave, and on Android with its browser; Safari iOS not +run. The result per check was declared without the split per browser: it +sits in the last column. A device cell is filled only where the owner +named the browser (J1.7). Brave is outside the OD-6 list, reported as run. | Device, browser, version | Surface (1 dev / 2 prod CSP) | Date | |---|---|---| | (to be confirmed by the owner) | | 2026-10-18 | -| Check | Computer, Chrome / Firefox (version?) | iPhone, Safari iOS (deferred) | Android (not run) | -|---|---|---|---| -| J1.1 reference PDFs open the editor | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.2 hostile folder: message per file | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.3 rescue copies | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.4 engine unavailable (`--csp without`) | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.5 engine recovered | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.6 interrupted import | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.7 offline import | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.8 L export (≈ 42 MB) opens, time to the editor | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.9 six L imports in a row, tab alive | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.10 twenty picks of `values-1m.pdf` | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.11 rescue copy under and over the cap | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.12 timings (demo, L) | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J1.13 bilan in progress kept after a refused import | NON TESTÉ | NON TESTÉ | NON TESTÉ | +| Check | Computer, Chrome | Computer, Firefox | Computer, Brave (outside OD-6) | iPhone, Safari iOS (not run) | Android, its browser | Declared 2026-10-21, no browser split | +|---|---|---|---|---|---|---| +| J1.1 reference PDFs open the editor | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J1.2 hostile folder: message per file | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J1.3 rescue copies | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J1.4 engine unavailable (`--csp without`) | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J1.5 engine recovered | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J1.6 interrupted import | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J1.7 offline import | NON TESTÉ | FAIL | FAIL | NON TESTÉ | NON TESTÉ | FAIL | +| J1.8 L export (≈ 42 MB) opens, time to the editor | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J1.9 six L imports in a row, tab alive | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J1.10 twenty picks of `values-1m.pdf` | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J1.11 rescue copy under and over the cap | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J1.12 timings (demo, L) | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré, « quelques secondes », no measure | +| J1.13 bilan in progress kept after a refused import | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | Notes (FAIL, incidents, timings, memory warnings, reloads): -- +- J1.7 FAIL on Brave and Firefox (owner, 2026-10-21): surface 2 (production + build, port 4173, production CSP); offline, « Importer » does not open the + file picker and the browser becomes unusable. Diagnosis and fix: RUST.md + §10.12; the mini-recette `R4_MINI_RECETTE.md` runs it again. +- J1.12: « quelques secondes » from the pick to the editor, no measure; the + 20 s timer is neither confirmed nor moved by it (the §B.3 rule needs the + timings). Recommendation (filled after the run): accept R4.3 as is / accept with follow-ups / do not accept, and why. diff --git a/docs/development/R4_J2_RESULTS.md b/docs/development/R4_J2_RESULTS.md index bdfac650..fee39753 100644 --- a/docs/development/R4_J2_RESULTS.md +++ b/docs/development/R4_J2_RESULTS.md @@ -6,31 +6,40 @@ timing and memory event. A device or browser not run stays `NON TESTÉ`; the headless runs of RUST.md §10.8 and §10.11 never fill a cell. Re-issued at R4.9 (2026-10-20) on the R4.8 build with J2.12 to J2.14 added; nothing below was run by Claude. +Status 2026-10-21 (R4.10): the owner ran the recette on the computer with +Chrome, Firefox and Brave, and on Android with its browser; Safari iOS not +run. The result per check was declared without the split per browser: it +sits in the last column. Every device cell stays `NON TESTÉ`. Brave is +outside the OD-6 list, reported as run. | Device, browser, version | Surface (1 dev / 2 prod CSP) | Date | |---|---|---| | (to be given by the owner) | | | -| Check | Computer, Chrome / Firefox | iPhone, Safari iOS | Android | -|---|---|---|---| -| J2.1 FR export identical to the imported demo | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.2 EN export | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.3 export without logos | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.4 links open the three sites | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.5 real rasters crisp at 400 % | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.6 L export on the phone (E4), time, tab alive | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.7 six demo exports in a row | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.8 round trip of an exported file | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.9 interrupted export | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.10 engine unavailable then recovered | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.11 CAP export (computer only) | NON TESTÉ | not applicable | not applicable | -| J2.12 views and markers of an observation | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.13 attachment listed, properties Faunosteo | NON TESTÉ | NON TESTÉ | NON TESTÉ | -| J2.14 `pnpm report:compare` (computer only) | NON TESTÉ | not applicable | not applicable | +| Check | Computer, Chrome | Computer, Firefox | Computer, Brave (outside OD-6) | iPhone, Safari iOS (not run) | Android, its browser | Declared 2026-10-21, no browser split | +|---|---|---|---|---|---|---| +| J2.1 FR export identical to the imported demo | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.2 EN export | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.3 export without logos | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | FAIL | +| J2.4 links open the three sites | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.5 real rasters crisp at 400 % | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.6 L export on the phone (E4), time, tab alive | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.7 six demo exports in a row | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.8 round trip of an exported file | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.9 interrupted export | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.10 engine unavailable then recovered | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.11 CAP export (computer only) | NON TESTÉ | NON TESTÉ | NON TESTÉ | not applicable | not applicable | PASS déclaré | +| J2.12 views and markers of an observation | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.13 attachment listed, properties Faunosteo | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | NON TESTÉ | PASS déclaré | +| J2.14 `pnpm report:compare` (computer only) | NON TESTÉ | NON TESTÉ | NON TESTÉ | not applicable | not applicable | PASS déclaré | Notes (FAIL, incidents, timings, memory warnings, reloads): -- +- J2.3 FAIL (owner, 2026-10-21): after importing `r3-demo.fr.nologos.pdf`, + the exported PDF shows the graphic logos in the header and the footer. + Diagnosis: RUST.md §10.12 (the editor export embeds the application's + bundled branding, never the imported archive's; the expected result + written at R4.6 does not match that rule); owner decision pending. Recommendation (filled after the run): accept R4.6 as is / accept with follow-ups / do not accept, and why. diff --git a/docs/development/R4_MINI_RECETTE.md b/docs/development/R4_MINI_RECETTE.md new file mode 100644 index 00000000..3a9824ca --- /dev/null +++ b/docs/development/R4_MINI_RECETTE.md @@ -0,0 +1,46 @@ +# R4 mini-recette after R4.10 (J1.7 and its dependencies) + +Re-runs only what R4.10 touched: the offline import (J1.7) and the import +path it shares with J1.1 and J1.13. Diagnosis: RUST.md §10.12. J2.3 waits +for the owner's decision on the branding of a re-export; nothing to run for +it until then. + +## 1. Setup (computer, development machine) + +1. Branch `feature/rust-r4-pdf-core` at its last commit; `pnpm build:preview`. +2. Open port 4173 for the session (ENVIRONMENTS.md §3): + `sudo ufw allow in on enp89s0 from 192.168.1.0/24 to any port 4173 proto tcp comment 'faunosteo recette R4'` +3. Serve: `. scripts/dev-env.sh && node scripts/browser/serve.mjs --host "$FAUNOSTEO_DEV_HOST" --port 4173`. + The server now sends the Cache-Control lines of `docker/nginx.conf`. +4. On the computer that runs the browsers, copy `faunosteo-j1-kit` to a + local folder (Documents or Desktop), not a network share. +5. In each browser, clear the site's data once (the old build's entries had + no Cache-Control line), then open `http://:4173/`. + +## 2. Checks + +| Check | Steps | Expected | +|---|---|---| +| M1 file dialog offline, no Faunosteo page | cut the network the same way as at J1.7, open an empty tab, Ctrl+O | the browser's own « Ouvrir un fichier » dialog opens and closes normally | +| M2 J1.7 again | as written in `R4_J1.md` J1.7, the PDF picked from the local copy of step 4 | the editor opens with the bilan, the browser stays usable | +| M3 J1.7 with the browser's offline switch | network kept up for the system; DevTools, Network tab, « Offline » (Chrome, Brave) or « Travailler hors connexion » (Firefox); then the J1.7 steps | the editor opens | +| M4 J1.1 | one reference PDF online | the editor, the message of `ATTENDU.md` | +| M5 J1.13 | as written in `R4_J1.md` | both refusals, the bilan in progress kept | +| M6 J1.7 on the iPhone (when available) | as M2 on Safari iOS | the editor, or the line « Le moteur de lecture n'a pas pu être chargé. Réessayez l'import. » with the page still usable (the headless WebKit result) | + +Browsers: Chrome and Firefox (OD-6), Brave as run on 2026-10-21; Android +with its browser for M2 and M4 when convenient. + +How to read M1 and M2: if M1 hangs, the operating system's file dialog +hangs without the network whatever the page, a browser or system +limitation to note. If M1 opens but M2 hangs, the defect is Faunosteo's and +R4.10 continues. If M2 passes from the local copy but failed from the share +at J1, the kit's location caused it. + +## 3. What to report + +Per check and browser: PASS / FAIL / NON TESTÉ; the operating system of the +computer and the browser versions; how the network was cut (Wi-Fi off, +cable, airplane mode, DevTools); where the kit was read from at J1 and now. +Afterwards delete the UFW rule (`sudo ufw status numbered`, then +`sudo ufw delete `). diff --git a/docs/development/RUST.md b/docs/development/RUST.md index abdb2a6b..40844df5 100644 --- a/docs/development/RUST.md +++ b/docs/development/RUST.md @@ -2240,3 +2240,63 @@ at most the 50 MiB cap after checking the file's type. Last re-gate PASS, LOW residuals only (a local writer swapping a FIFO in between the CLI's stat and open can make it wait). Final `pnpm check:all` green on 49b812b (2 min 51 s). + +### 10.12 R4.10: the J1 / J2 anomalies (2026-10-21, `scripts/browser/results/2026-10-20-r4-offline-import.json`) + +The owner's run (computer: Chrome, Firefox, Brave; Android; Safari iOS not +run) reported two failures. Results as declared: `R4_J1_RESULTS.md`, +`R4_J2_RESULTS.md`. + +**A. J1.7, offline import (FAIL on Brave and Firefox, surface 2).** +Reproduced headless on the same build and server (reference PDF imported +online, editor loaded, network cut, « Accueil », « Choisir un fichier », +« Remplacer », same PDF), two ways to cut: Playwright's offline mode and +the server process killed. + +| Engine | Before (serve.mjs without cache lines) | After (nginx.conf lines) | +|---|---|---| +| Chromium | the worker chunk refused from the cache (`net::ERR_ABORTED`), inline line « Le moteur de lecture n'a pas pu être chargé. » | editor, both cuts | +| Firefox | editor (offline mode serves the stale entry) | editor, both cuts | +| WebKit | inline line | inline line, both cuts | + +Cause found: `scripts/browser/serve.mjs` sent no `Cache-Control` and no +validator on `/assets/`, where `docker/nginx.conf` sends `public, +max-age=31536000, immutable`; without it a browser may not reuse the +prefetched worker chunk offline. A recette surface defect, not an +application one: production already sends the line. Fixed: the server +sends the two nginx lines (`env.js` no-store, `/assets/` immutable); +`scripts/browser/r4-offline-import.mjs` re-runs the path on the three +engines and both cuts and checks the headers (6 runs as expected; with the +old server, Chromium fails both: exit 1). Headless WebKit never takes a +worker script from the HTTP cache offline, even immutable: the page shows +the inline line, stays usable, no data changes. Whether Safari iOS does the +same is not known: J1.7 on the iPhone tells. + +Not reproduced: the file picker that does not open and the browser that +becomes unusable. In every headless run the page answers (picker event, +editor or inline line, no page error). The picker is the +operating system's dialog, which a headless browser replaces; the page's +click handler calls `input.click()` synchronously, before any network +call. A dialog that hangs when the network goes is consistent with a file +dialog opening on a network folder (the kit read from a share) but nothing +proves it yet: the mini-recette's discriminating step settles it (Ctrl+O +offline in an empty tab, the kit copied to a local folder). + +**B. J2.3, export without logos (FAIL).** The reference file +`1-reference/r3-demo.fr.nologos.pdf` carries an archive whose branding has +the four logo slots `null` (the R3 oracle's `nologos` mode: the logo fetch +answered 404, `STEP6_PDF_ARCHIVE_ANALYSIS.md` §17). The editor export builds its branding from +`apps/app/src/pdf/branding.ts` (`loadBranding()`, the four bundled logos) +on every export; the imported archive's branding is kept in the session +(`osteo:archive`) but never handed to the writer. Same rule before R4: +`apps/app/src/pdf/export.ts` at 66909b6 already passed `loadBranding()` to +the TypeScript engine. The archived branding is used only by +`export_from_envelope` (cargo, the oracles), never by the application. The +writer draws the text fallback only for a `null` slot or a logo that +failed to embed, which the application's bundled branding never has since the logos are bundled (Step 6, +fetch removed). So the application behaves as specified, and the expected +result of J2.3 written at R4.6 was wrong: it described the oracle's +`nologos` file, not an editor export. Nothing changed (goldens, oracles, +rules and the expected result untouched); an owner decision is needed: +keep the rule and correct the expected result of J2.3, or make a re-export +of an imported bilan reuse the archived branding (a product change).