docs(docs): cat-access compatibility record and N-1 replay

FIXTURE-UNCHANGED (access-category.json since 2860f453); N-1 replay not needed.
git diff --stat bc68463e..HEAD on seed, oracles, goldens, n-1: empty.
import:equine --check: legacy-import 0 differences, draft 0 differences.
cargo test (pdf-write): fingerprint 2, r5_6_switch 4, serde_tolerance 3,
sheet_review 6, canvas_op 14, compose 11, layer 9, all ok.
cargo test (curation): curation_review 27, curation_draft 13, all ok.
This commit is contained in:
bchanot committed 2026-11-23 00:12:09 +01:00
1 parent 867ec5e394
commit 1efb057ca2
3 files changed
+18

No files matched your search

@@ -58,6 +58,8 @@ AnatomicalSheetDocument
├─ references: Reference[] shared bibliography, cited by id from the finding tree
│ Reference = { id, type: book | journal | standard | legal | web | manual, citation, url | null, doi | null }
├─ categories: AnnotationCategory[] { id, name: LocalizedText, color: '#rrggbb' | null }
│ reserved id `cat-access` (detail-view accesses): created by the core with an access, no extra key;
│ the editor refuses any other write on it (`reserved_category`), uniqueness by `category.id.duplicate`
├─ views: SheetView[]
│ main: { id, kind: 'main', name, svg_asset_id: uuid | null, view_box: ViewBox | null }
│ detail: { id, kind: 'detail', name, parent_view_id, svg_asset_id: uuid | null, view_box: ViewBox | null }
+7
View File
@@ -3954,6 +3954,7 @@ trapping test stub (`apps/app/tests/helpers/core.ts`) lists the two new glue mem
|---|---|
| shipped module | 1 513 522 B raw, 559 360 B gzip -9 (script), 569 181 B by Node's gzip in `size.test.ts` (final, finalisation §12.8; 568 696 B at f1ef6a4, the debug `name` section dropped since §12.7); budget 600 000 (D-R13); 596 671 B at ca31b78, 531 715 B before V1-2.2 (RUST.md §11.22) |
| shipped module, V1-2.6 U2 (`PreviewState.min_point_radius`) | 1 580 788 B raw, 585 951 B gzip -9 (script), 595 331 B by Node's gzip in `size.test.ts`; before: 1 569 864 B, 583 126 B, 592 143 B (+3 188 B by the test's measure, +2 825 B by the script); margin under the 600 000 budget 4 669 B |
| shipped module, `cat-access` (`EditError::ReservedCategory`) | 595 873 B by Node's gzip in `size.test.ts` (+542 B); margin under the 600 000 budget 4 127 B |
| verdict at every cap, native | 107 ms release, 493 ms debug (document 1 165 850 bytes) |
| `clean_svg`, shipped module | 45 hostile inputs and floods, slowest 0.4 ms |
@@ -4462,6 +4463,12 @@ once per cargo run whose features build `pdf_serialize` (workspace, `cli`, `ts,p
§10.7, 40 s in debug; run on request in release (2026-11-01: passed, 120 views, 46.5 MB, 5.2 s). The L report's export
itself is covered unignored (`pdf_budget`); it masks no required scenario.
### 12.15 Reserved category `cat-access` (owner, 2026-11-22)
`EditError::ReservedCategory` (`reserved_category`, `domain/sheet/access.rs`): the core creates the internal category
`cat-access` when a detail-view access enters it, and the editor commands refuse every other write on that id. No key,
schema v2, no SQL migration; N-1 readers treat it as an ordinary category (`V1-2-6_UX_COMPATIBILITY.md` §1, §7).
## 13. V1-2.3: the server verdict in the worker (2026-11-01)
Owner brief « Validation définitive V1-2.2 » (V1-2.2 VERIFIED at `c73415a`): V1-2.3 along the V1-2 contract §16.4.
@@ -41,6 +41,14 @@ Under T10 option B (ratified, BDR-101), the automatic access adds, on demand, on
`cat-access` with role `navigation`: an ordinary `{id, name, color}` category for every reader before U6 once the
role is stripped (§4).
2026-11-22 (owner, detail views): the internal category of detail-view accesses is marked by its reserved id
`cat-access`, with no key and no schema bump (documents stay plain v2, no SQL migration). The core creates it when
an access enters it; the editor commands refuse every other write on it (`reserved_category`). Uniqueness is the
core's (editor refusal plus verdict `category.id.duplicate`), not SQL's. N-1 applications read it as an ordinary
`{id, name, color}` category (README « Conséquences » 1); the frozen N-1 readers accept a sheet and a PDF carrying
it (census, Task 4). U6 still brings the `role` key for the fixed categories with its write lock, and decides
whether `navigation` stays in the role list.
Document kinds used below:
- **Old**: any document saved or published before U6 (equine historical, equine working copy, sandbox sheets, seed,
@@ -153,6 +161,7 @@ Rollback:
|---|---|---|
| Any frontend-only sub-step (U1, U3, U4, U7) | yes | none: no document changes form |
| U2, U5 (additive read-only core value and queries) | yes | documents written are plain v2 |
| U2 with `cat-access` | yes | documents stay plain v2: no key, no schema bump, no migration; N-1 readers see an ordinary category |
| U6 → before U6, no New-present document exists | yes | app, worker and gate go back together, the gate lowered by a new forward migration; an old worker under the U6 gate sees every passed verdict refused, so no round opens (fails closed) |
| U6 → before U6, a New-present document exists (any sheet created after U6) | **no: point of no return** | drafts unreadable by the old app (`invalid_document`) and the old worker (`integrity.document`); published rows immutable; migrations forward-only (`docs/development/SUPABASE.md:595-603`). Same class as RR-2; recorded as a release-readiness item (id reconciled with develop) |
| U6 application alone → before U6 | no in practice | the old `sheet.empty` creates sheets with `categories: []` (`create.rs:14-35`), which the U6 worker always fails and the old editor cannot repair |