docs(docs): V1-2.1 M5 row, e2e:sheet-assets as an owner step, walk log

Contract §12.3 M5 row names the size CHECK swap and its validation on DEV
rows; §9.5 and §16.11 move the e2e:sheet-assets rerun to the owner (DEV
target). Evidence: 017 count, raw number-walk timings committed.
This commit is contained in:
bchanot committed 2026-10-28 21:08:23 +01:00
1 parent 1f9fa8b835
commit 9350366913
3 files changed
+66 -5

No files matched your search

@@ -53,7 +53,7 @@ files of this pass:
|---|---|---|
| 006 | 2 not ok: another editor uploads a pending key it did not register (L5) | 16/16 |
| 016 | 1 not ok: a draft from a deprecated version takes it as base (M2) | 50/50 |
| 017 | M1 approval on an archived sheet succeeds; M2 base from a deprecated version; the file aborts there | 85/85 (110/110 after the final decisions pass, §4) |
| 017 | M1 approval on an archived sheet succeeds; M2 base from a deprecated version; the file aborts there | 85/85 (111/111 after the final decisions pass, §4) |
| 018 | 93 not ok of 337: capability holders at aal1 get `rights.capability` instead of `rights.mfa` (§6.7); `delete_sheet_asset` answers a raw code | 337/337 |
| 019 | 38/38 (lost coverage of behaviour that was already correct) | 38/38 |
| sheets-concurrency | 5 failed of 15: publish against withdraw (no version lock), two deprecations (no sheet lock), archive against approve (no sheet lock) | 15/15 |
@@ -97,8 +97,10 @@ New in this pass:
non-owner class at aal2 (`rights.owner`) and at aal1 (`rights.mfa`).
Number walk, linear (security gate on `7c4bf12`: `jsonb_path_query` row by row is quadratic on
PostgreSQL 17, 0.15 / 0.53 / 2.17 s for 50k / 100k / 200k numbers on the real image; replaced by
one `jsonb_path_query_array` call: 65 / 128 / 262 / 414 ms for 100k / 200k / 400k / 600k). Over
PostgreSQL 17). Raw psql timings on the sandbox, committed as
`2026-10-28-v1-2-1-number-walk.out` (rolled back): row by row 138 / 506 / 2 172 ms for 50k /
100k / 200k numbers; the shipped walk (one `jsonb_path_query_array` call) 69 / 135 / 267 / 421 ms
for 100k / 200k / 400k / 600k. Over
HTTP on both stacks, each run: 600 000 numbers (1 801 760 bytes of text) saved in 677-695 ms;
1 000 000 numbers answered `document.too_large` in 1 019-1 078 ms (budget 2 000 ms).
@@ -0,0 +1,54 @@
1f9fa8b
Time: 0.086 ms
Time: 1.163 ms
Time: 603.977 ms
per_row 50000
per_row
---------
50692
(1 row)
Time: 137.844 ms
per_row 100000
per_row
---------
100692
(1 row)
Time: 506.026 ms
per_row 200000
per_row
---------
200692
(1 row)
Time: 2172.483 ms (00:02.172)
shipped 100000
check_document_structure
--------------------------
(1 row)
Time: 68.834 ms
shipped 200000
check_document_structure
--------------------------
(1 row)
Time: 134.571 ms
shipped 400000
check_document_structure
--------------------------
(1 row)
Time: 267.344 ms
shipped 600000
check_document_structure
--------------------------
(1 row)
Time: 421.337 ms
Time: 0.498 ms
+7 -2
View File
@@ -1366,7 +1366,10 @@ A drawing never blocks authoring: only the round waits for its verdict.
object's integrity undemonstrated (§12.3, §17.3).
- `pnpm assets:upload` stays the seed tool of local and sandbox stacks. With
the service role's table privileges revoked (F12), the same step gives the
tool a narrow read RPC for its planning and reruns `pnpm e2e:sheet-assets`.
tool a narrow read RPC for its planning. `pnpm e2e:sheet-assets` targets the
local DEV stack only, so V1-2.1 did not run it (sandbox-only rule); the
tool's switch to that RPC is covered by its stub-server tests and pgTAP 006,
and the rerun is an owner step of §16.11.
- Objects are never deleted by the worker: its purge guard refuses any purge
whose bucket is `anatomical-sheet-assets`, and no trigger enqueues a sheet
object.
@@ -1578,7 +1581,7 @@ of the document's JSON text in one form, the same for every layer:
| Id | Step | Content | Data on DEV |
|---|---|---|---|
| M4 `sheet_access_hardening` | V1-2.1 | `anatomical_catalog_grants` and its RPCs; `has_mfa`, `grant_active`, `caller_has`; `can_read_official_catalog` and the reader row predicate; `can_edit_sheet` redefined (F14); AR-1 B on the platform role RPCs and the private write functions (F19, §5.7), F17, F18; F1, F2, F3 (fork closed), F5, F6, F8, F9, F12 (every catalogue table), F13, F15; asset-row immutability trigger (F16); historical-sheet protection trigger (§14.2); reader column grants narrowed; personal creation and visibility changes refused | no row changes |
| M5 `sheet_review_workflow` | V1-2.1 | version columns `revision`, `authors`, `source_version_id`, `published_review_id`, `document_fingerprint`; sheet column `working_copy_source_version_id`; revision, author and freeze triggers, the historical-sheet write rule; extended immutability guard (§6.8); rounds, comments, acknowledgments; `create_official_sheet`, `create_sheet_draft` adapted, `save_sheet_draft`, submit, withdraw, comment, acknowledge, decide, publish; `create_sheet_working_copy`; species RPCs; catalogue and version read RPCs; upload: `register_sheet_asset` extended, `confirm_sheet_asset_upload` with the storage check (F7), INSERT policy, bucket limit 2 MiB; mirror removal and status check (§12.2); superseded signatures dropped | new columns take their defaults on the equine v1 row (`revision` 0, empty author set); its document, status, number and assets unchanged; bucket limit lowered; no round, no grant |
| M5 `sheet_review_workflow` | V1-2.1 | version columns `revision`, `authors`, `source_version_id`, `published_review_id`, `document_fingerprint`; sheet column `working_copy_source_version_id`; revision, author and freeze triggers, the historical-sheet write rule; extended immutability guard (§6.8); rounds, comments, acknowledgments; `create_official_sheet`, `create_sheet_draft` adapted, `save_sheet_draft`, submit, withdraw, comment, acknowledge, decide, publish; `create_sheet_working_copy`; species RPCs; catalogue and version read RPCs; upload: `register_sheet_asset` extended, `confirm_sheet_asset_upload` with the storage check (F7), INSERT policy, bucket limit 2 MiB; mirror removal and status check (§12.2); superseded signatures dropped; the content-size CHECK replaced by the text measure (`octet_length(content::text)`, §12.2) | new columns take their defaults on the equine v1 row (`revision` 0, empty author set); its document, status, number and assets unchanged; the new size CHECK is validated against the existing rows when M5 is applied (the equine document is about 296 KB of text); bucket limit lowered; no round, no grant |
| M6 `sheet_verification_jobs` | V1-2.3 | worker RPCs (claim, input, complete with the verdict structure check, fail), service role only | none |
Each migration ships its pgTAP file (allowed and denied cases), regenerated
@@ -2179,6 +2182,8 @@ Each is an owner action, never run by Claude, after its own checkpoint:
6. any submission, approval, publication, deprecation or archive;
7. any factor reset (§5.6, §5.7.7) and any `object_conflict` deletion (§9.3);
8. rerunning the equine seed.
9. rerunning `pnpm e2e:sheet-assets` against DEV once M4 to M6 are applied
(§9.5).
### 16.12 Deferred (not V1-2)