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 | | 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 | | 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 | | 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 | | 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 | | 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`). 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 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 PostgreSQL 17). Raw psql timings on the sandbox, committed as
one `jsonb_path_query_array` call: 65 / 128 / 262 / 414 ms for 100k / 200k / 400k / 600k). Over `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; 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). 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). object's integrity undemonstrated (§12.3, §17.3).
- `pnpm assets:upload` stays the seed tool of local and sandbox stacks. With - `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 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 - 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 whose bucket is `anatomical-sheet-assets`, and no trigger enqueues a sheet
object. 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 | | 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 | | 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 | | 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 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; 6. any submission, approval, publication, deprecation or archive;
7. any factor reset (§5.6, §5.7.7) and any `object_conflict` deletion (§9.3); 7. any factor reset (§5.6, §5.7.7) and any `object_conflict` deletion (§9.3);
8. rerunning the equine seed. 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) ### 16.12 Deferred (not V1-2)