Files
faunosteo/.claude/tasks/contracts/2026-10-21-rust-r4-maintenance-1700.md

9.6 KiB

Contract: R4.11 dependency maintenance before the R4 merge

Base: 8943bf3 on feature/rust-r4-pdf-core. Date: 2026-10-21. Range: 8943bf3..HEAD.

REQUEST (verbatim, owner, « Dernière maintenance de sécurité avant clôture R4 »)

« Trois dépendances nécessitent une vérification et, si les versions affectées sont présentes, une mise à jour : rustls-webpki : RUSTSEC-2026-0382. webpki-roots : RUSTSEC-2026-0381. react-router : avis concernant les versions antérieures à 7.18.2, selon les plages affectées. […] Ces numéros ne remplacent pas la vérification des contraintes réelles du monorepo et des dépendances transitives. »

« Avant modification, établir : les versions actuellement résolues, les chemins de dépendances qui les introduisent, les composants effectivement concernés, l'exposition réelle de Faunosteo aux vulnérabilités, les versions corrigées disponibles et compatibles, les éventuels changements d'API ou de comportement attendus. Pour react-router, vérifier le mode utilisé par l'application, les appels Link, useNavigate et redirect, ainsi que le traitement des destinations provenant de données non fiables. Pour Rust, vérifier notamment la chaîne TLS du worker, les certificats de confiance et les compatibilités avec rustls. »

« Effectuer les mises à jour minimales raisonnables, avec commits séparés et traçables. Préserver les comportements métier. Ne pas changer l'architecture React ou Rust simplement pour réaliser une montée de version. Ne pas introduire d'exclusion de sécurité pour masquer les alertes. Si une mise à jour nécessite une migration importante ou présente un risque de régression significatif, arrête-toi et présente-moi les alternatives avant de continuer. »

« Après mise à jour : pnpm check:all. Audit npm/pnpm des dépendances de production. Cargo deny et contrôle des avis RustSec. Tests des parcours React Router concernés. Tests d'authentification, navigation, redirections et liens pertinents. Tests TLS du worker avec validation effective des certificats, dans la mesure où l'environnement le permet. Construction des images et tests sandbox. Vérification que les oracles PDF et les goldens restent inchangés. Audit de sécurité indépendant ciblé sur les mises à jour. Ne pas qualifier les vulnérabilités de corrigées uniquement parce que la compilation passe. »

« Présenter un tableau avec chaque avis, l'ancienne version, la nouvelle version, le résultat de l'audit et les risques résiduels. Si toutes les mises à jour sont compatibles et les grilles vertes, considérer la maintenance prête, mais attends toujours mon signal final. »

« M3 reste facultatif et NON TESTÉ. Safari iOS physique reste NON TESTÉ et nécessaire avant la fusion. Ne pas modifier la règle J2.3 ni relancer le diagnostic J1.7 sans nouveau défaut prouvé. Conserver les corrections Cache-Control et CSP. Si le critère de vérification contient inutilement un nom d'utilisateur local, le remplacer par une règle générique équivalente sans réduire sa couverture. Rester sur feature/rust-r4-pdf-core. Aucune fusion dans develop sans mon autorisation. Ne commence pas R5. Ne publie pas la release 0.2.0. Ne déploie rien sur faunosteo.com. »

FILE SCOPE

Every path the range touches is listed here; anything else is out of scope.

  • Cargo.lock (two crate bumps, then rcgen's tree), crates/worker/Cargo.toml ([dev-dependencies] only), crates/worker/tests/tls.rs (new)
  • apps/app/package.json (react-router-dom range), pnpm-lock.yaml (react-router, react-router-dom)
  • docs/development/RUST.md §10.13 (new), CHANGELOG.md (Unreleased, Fixed 2026-10-21)
  • .claude/tasks/contracts/2026-10-21-rust-r4-decisions-1500.md (criterion 11 wording), .claude/tasks/contracts/2026-10-21-rust-r4-maintenance-1700.md (this contract)
  • .claude/tasks/TODO.md, .claude/memory/{journal,learnings,decisions}.md

Out of scope: every file under crates/worker/src, crates/core, crates/wasm, apps/app/src, packages/, apps/app/tests/fixtures, crates/core/tests, docker/, DEPLOY.md, .gitleaks.toml, deny.toml, the recette documents and results; any deletion.

ACCEPTANCE CRITERIA

  1. Rust versions: grep -A1 '^name = "rustls-webpki"' Cargo.lock shows 0.103.16, webpki-roots 1.0.10; cargo tree -i rustls-webpki -e normal and cargo tree -i webpki-roots -e normal reach the workspace only through ureq → faunosteo-worker; cargo deny check advisories exits 0 (it exited 1 on 8943bf3 with the two ids); deny.toml unchanged (git diff 8943bf3 -- deny.toml empty) and its ignore = [] still empty.
  2. Node versions: apps/app/package.json has "react-router-dom": "^7.18.4"; pnpm list -r --depth 2 react-router-dom resolves react-router-dom 7.18.4 and react-router 7.18.4; pnpm audit --prod prints No known vulnerabilities found; the lockfile diff from 8943bf3 touches only the react-router and react-router-dom entries (git diff 8943bf3 -- pnpm-lock.yaml | grep -E '^[-+] ' | grep -vcE 'react-router|specifier: \^7|version: 7\.1[58]|resolution: \{integrity: sha512-' = 0).
  3. One commit per update: git log --oneline 8943bf3..HEAD -- Cargo.lock shows the webpki commit (7a7b71c) and the test commit (a604c07) and no other lockfile change; git log --oneline 8943bf3..HEAD -- pnpm-lock.yaml apps/app/package.json shows the react-router commit (c9dab63) alone.
  4. No application or worker source change: git diff --stat 8943bf3 -- apps/app/src crates/worker/src crates/core crates/wasm packages docker DEPLOY.md .gitleaks.toml is empty; no deletion in the range (git diff --diff-filter=D --name-only 8943bf3 empty); no new suppression (git diff 8943bf3 | grep -E '^\+.*(nosemgrep|nosec|eslint-disable|allow\(|gitleaks:allow|ignore = \[)' prints nothing but the test file's #![allow(clippy::unwrap_used, clippy::expect_used)], the convention of every worker test file).
  5. TLS proof: cargo test -p faunosteo-worker --test tls passes; the test builds a HttpBackend from https://127.0.0.1:<port> against an in-process rustls server with a self-signed certificate, expects BackendError::Network whose message contains certificate, asserts the service key string is absent from the message, and asserts the server saw the connection dropped (no request). Negative proof, run by the orchestrator (a verifier edits no tree): with .tls_config(ureq::tls::TlsConfig::builder().disable_verification(true).build()) added to the agent builder in crates/worker/src/http.rs (temporary edit, restored with git checkout --), the test failed at tls.rs expected a network error, got Ok([]) (orchestrator log quoted in the verifier's brief); the verifier checks by reading that the test panics on any Ok and that the server answers [] after a completed handshake.
  6. Dev-dependencies: crates/worker/Cargo.toml adds rustls (default-features false, ring, std, tls12) and rcgen (default-features false, ring) under [dev-dependencies] only; cargo tree -p faunosteo-worker -e normal (no dev edges) lists neither; cargo deny check (all four checks) exits 0.
  7. Suites: pnpm rust:check exits 0; cd apps/app && ./node_modules/.bin/vitest run → 59 files, 429 cases (includes guards.RequireAuth, routes.LoginRoute, routes.SignupRoute, routes.HomeRoute.*, routes.EditorRoute.*, auth.validation with safeNextPath); pnpm typecheck and pnpm lint exit 0; git status --short empty afterwards (the wasm module may need pnpm wasm:build first: the lockfile is a BUILD_STAMP input; the shipped bytes stay 1,535,289 raw).
  8. pnpm check:all exit 0 on the final code state (orchestrator log <session scratchpad>/checkall-r411.log, path given in the verifier's brief, never in a tracked file; ending == all checks passed; the musl test stage runs tests/tls.rs too, grep -n "tests/tls.rs" <log> finds it in the Docker stage with 1 passed); read the log, do not re-run.
  9. Goldens and oracles unchanged: git diff --stat 8943bf3 -- apps/app/tests/fixtures crates/core/tests empty.
  10. Docs: RUST.md §10.13 holds the table (advisory, component and path, before, after, audit, residual) for the five advisories, the exposure analysis (BrowserRouter SPA, safeNextPath, no server), the TLS proof with its negative run and its honest limit, the dev-dependency note, and the checks; CHANGELOG Unreleased has the dependency line.
  11. Criterion 11 of the previous contract no longer names a local username: grep -c "bchano" .claude/tasks/contracts/2026-10-21-rust-r4-decisions-1500.md = 0, and its generic rule git grep -n -I -E "/home/[a-z][a-z0-9_-]*/|-home-[a-z][a-z0-9_-]*-" | grep -v "/home/deploy/" still prints nothing.
  12. Recette state untouched: git diff --stat 8943bf3 -- docs/development/R4_J1.md docs/development/R4_J2.md docs/development/R4_J1_RESULTS.md docs/development/R4_J2_RESULTS.md docs/development/R4_MINI_RECETTE.md empty (J2.3 rule, J1.7, M3 and Safari iOS cells as the owner left them).

CLARIFICATIONS

Q: 7.18.2 (the owner's minimum) or 7.18.4 (latest 7.x)? / A: 7.18.4: the owner allows « une version stable supérieure compatible »; patch-level changelog, published 2026-09-15, React 19 and Node 24 compatible. [gated 2026-10-21, owner's §1] Q: a TLS test needs dev-dependencies (rcgen); allowed? / A: the owner asked for TLS tests « dans la mesure où l'environnement le permet »; dev-only, from the rustls project, named in §10.13; no runtime dependency changes. [gated 2026-10-21, owner's §4] Q: criterion 4 quotes the suppression-grep pattern in its own text; does the floor count it? / A: no: it is the oracle's command, not a suppression in code; waived for this contract file only. [gated 2026-10-21, oracle wording]