docs(docs): R5.5 upload tool runbook, caps, serde tolerance characterisation, contract

This commit is contained in:
bchanot committed 2026-10-23 21:16:59 +02:00
1 parent 2c445063a4
commit a481af52c7
5 files changed
+221 -2

No files matched your search

+5
View File
@@ -6,6 +6,11 @@ Versions follow [Semantic Versioning](https://semver.org/).
## [Unreleased]
### Changed (2026-10-23, Rust R5.5: the sheet-asset upload tool in Rust)
- `pnpm assets:upload [--check] <seed folder>` runs the Rust binary `upload-sheet-assets` (`crates/core`, feature `upload`, `ureq`) in place of the TypeScript script (kept as `assets:upload:legacy` until R5.7). Local stack only: no default destination, `http` with an explicit port on loopback or the configured DEV address, a private-bucket handshake before any transfer; every file checked against `assets.json` and the SVG reader before the first request; an existing object is hashed and never overwritten, a missing or foreign asset row stops the run, a row is confirmed only after its object is read back; bounded retries, resumable; the service key is never printed. Runbook `docs/development/SUPABASE.md` §3.1, `pnpm e2e:sheet-assets` for the local stack, `docs/development/RUST.md` §11.16.
- `changes.json` and `references.json` are refused above 4 MiB with an explicit message (core and binary). The serde tolerance of the R2 contracts is characterised (test `characterisation_serde_tolerance`), not changed.
### Changed (2026-10-23, Rust R5.4: the review files in Rust)
- The review drawings (`review/annotations-*.svg`, `review/app-*.svg`), `CHANGELOG.md` and `REVIEW-REPORT.md` of the draft are produced by the Rust pipeline: the two reports and three drawings byte for byte with the committed files; `review/app-main.svg` carries the head trigger's English name ("Head (left lateral view)"), the name the editor canvas shows since R3, where the committed file repeats the French one. `pnpm r5:import-equine --check` now compares the whole draft (12 files) and fails on any file missing or different without a declared rule; `--out` writes the 18 files. The seed, `horse.svg`, `pnpm import:equine` and `documentSha256` are unchanged (`docs/development/RUST.md` §11.14).