docs(docs): R4.12 RUST.md §10.14 (D3 safeNextPath, D1 distroless debian13, D6 nginx http2 and its 1.24 incompatibility), CHANGELOG, contract, TODO

This commit is contained in:
bchanot committed 2026-10-21 18:56:43 +02:00
1 parent 60faac8557
commit e6fbed5e12
4 files changed
+111 -1

No files matched your search

+60
View File
@@ -2436,3 +2436,63 @@ apps/app/tests/fixtures crates/core/tests` empty). Nothing is called fixed
because it compiles: the Rust ids are gone from the advisory check and the
npm ones from the production audit, and the two reachable behaviours
(certificate validation, `next` redirection) have a test each.
### 10.14 R4.12: the three pre-merge fixes of the Context7 review (2026-10-21)
Owner decisions on `.claude/audits/CONTEXT7-2026-10-21.md`: D1, D3 and D6
now, one commit each; D2 (Tailwind `outline-hidden`) and D5 (`MotionConfig
reducedMotion="user"`) for a separate accessibility chantier with a visual
recette; D4 (vitest coverage block, jest-dom entry, `defineConfig`,
`forwardRef`, the authStore comment) in the maintenance backlog; no major
upgrade.
**D3, `safeNextPath` (51a5a80).** The URL parser's own normalisation turned
`/..//evil.test`, `/.//`, `/a/..//`, `/%2e%2e//`, `/.%2e//`, `/..\\` and a
tab inside `..` into `//evil.test`: same origin for the sentinel, yet a
protocol-relative path once returned. The rebuilt value is now refused when
it starts with `//` or no longer resolves to the sentinel origin, so the
function's contract holds by itself. Consumers (`LoginRoute`,
`RedirectIfSignedIn`, `AuthCallbackRoute`) were not exposed in practice:
react-router 7.18.4's `useNavigate` throws « External navigation is not
allowed » on such a target and `<Navigate>` collapses the slashes
(`resolvePath('//evil.test/app/account')` = `/evil.test/app/account`, a
not-found page), read in the installed package; the fix does not rely on
it. Tests: 4 new `safeNextPath` cases (12 dot-segment spellings, external
schemes and escapes, encoded slashes kept literal and legitimate paths
unchanged, idempotence) and a `LoginRoute` case through the real router
(`next=/..//evil.test/app/account` lands on the dashboard); on the old
function, 3 of them fail.
**D1, worker runtime image (49b1849).** `gcr.io/distroless/static-debian12`
→ `static-debian13:nonroot` (the distroless README: only the Debian 13
tags are still published and updated). Provenance: the official
`gcr.io/distroless` registry, digest
`sha256:d62067879de890a1def9da0e7766b7d20810a5e5555cef8506b752437d7a3e88`
at the build; its cosign signature was not checked (no cosign on this
machine). Same contents for the worker: user `nonroot` 65532, no shell
(`/bin/sh` absent), CA bundle at `/etc/ssl/certs` (the worker's TLS uses
the bundled webpki roots, not the system store). The build, the sandbox
and seccomp `test` stage and the binary are unchanged. Proofs:
`pnpm worker:test` (sandbox tests 11 + 16, TLS 1, seccomp derivation),
`pnpm worker:image` (user nonroot, `run --check`, 12.1 MB), `run --check`
under `--read-only --cap-drop ALL --network none`, and `pnpm e2e:avatar`
against the local Supabase stack with this image: 5/5 (clean upload,
replacement and purge, signed-URL leftovers, hostile and corrupted uploads
refused with closed codes, removal); the stack was stopped afterwards
(volumes kept).
**D6, DEPLOY.md host nginx (60faac8).** `listen 443 ssl http2;` →
`listen 443 ssl;` + `http2 on;`. Incompatibility found and kept visible:
faunosteo.com answers `Server: nginx/1.24.0 (Ubuntu)`, and nginx 1.24 does
not know `http2 on` (`nginx -t` in a throwaway `nginx:1.24-alpine`:
`unknown directive "http2"`), while nginx 1.31 accepts it and warns that
`listen ... http2` is deprecated. The runbook gives the new form for
nginx >= 1.25.1 and names the old one for 1.24, with `nginx -v` to choose;
no other directive changed, no server touched.
Checks on 60faac8: `pnpm check:all` green (18:55:30; apps/app 59 files,
434 cases; the worker image on the Debian 13 digest; the TLS test native
and in the musl stage); `pnpm audit --prod` clean; `cargo deny check`
(all four) ok; the goldens, oracles and the PDF engine untouched
(`git diff --stat 8943bf3 -- apps/app/tests/fixtures crates/core/tests
crates/core/src` empty).