@bongos/core 1.19.1062 → 1.19.1063

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.1062",
-  "core_contract": "1.19.1062",
-  "source_commit": "50e8dd0c7f634e2a9b63dd35707e1a0e6bb9e224",
+  "core_version": "1.19.1063",
+  "core_contract": "1.19.1063",
+  "source_commit": "63e2f7bb716c0dc0961bb67e49922d15f2ed6c76",
   "source_ref": "HEAD",
-  "built_at": "2026-09-28T13:24:10.829Z",
+  "built_at": "2026-09-28T14:25:56.766Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
-    "docs_redacted": 543,
+    "docs_redacted": 544,
     "agent_docs_stubbed": 26,
-    "functional_verbatim": 2535,
+    "functional_verbatim": 2542,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 3105,
-  "tree_sha256": "6fb489b83e1cdeaf974f95a1adfb0bd25dd83ade9748de12f98b9bf3d9d95baa",
+  "file_count": 3113,
+  "tree_sha256": "5c8879d08015963d5d71b6092f41e0ec028b78673d0e79c0d92fb69c978309fe",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -317,12 +317,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "9459ee392b1a2db1a960411c0a41be2f9421cc398392a311cdedb57df41310c4"
+      "sha256": "ca931cbbd9382e0f899e5e7c2d4c2a1addb759f4457bf7cfb860c519d2e4bacd"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "6aaec85ca6a98a25d863b37da5785e3232cb42775a759de992cf2eb0759bc968"
+      "sha256": "b98f7525d1849ee33ff9f634207e91d1121d637cab6d6498d832b5873197642b"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -332,17 +332,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "6c46904bcf4ae17449d693b18166ed600b922a4de7198baccbdc8c96f622619a"
+      "sha256": "110ea054c68274e4061a86551872c254297d42ec205de9b5962f485123070fa8"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "ddfd0be094fb577bc4ec56a698a7b2745d3f9aa8b88537a8726f730a853895c7"
+      "sha256": "76ddcae95933b3bdd9ae458305082d8f332d6fdd11551bedd26e4854b624199c"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "3126818319137ce283ceb4cc6252b3de1fdb12f9f25feaa7f20ea6b2e9ef28be"
+      "sha256": "35d5b13ab21b55308e20c02ca61d030176ec431d9159cb852cc82af4dfdcc0c0"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2177,12 +2177,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "f297f09132092126cac8e6471ce3ba0cd2a1a1550d48f6f64dd0e20f1d38f806"
+      "sha256": "9c2a01131f4eef126542aca1f664883af254edac3cc148f01e8486adecc1bacf"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "c8fb1b6f7e3f67a81f5eaba74e7b0fab5439c7e52dd9a9a959f15a99791ce1ec"
+      "sha256": "23089d5d26da4a14d98ea318d2efab582bc502b6d0ac43a1d5a2db1241a47694"
     },
     {
       "path": "docs/architecture.md",
@@ -2207,12 +2207,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "331d32d43092d540eed68d3a5f69ca88e8b3f1caa478b78cef423710ec285763"
+      "sha256": "0bfc5ea9c331d2797c45cbfaeec7e9b5e264c2feb692a2132ac3dd804d05ea15"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "8721c56306ef590d8268e89e6db295ae1bed0a9025df274554714117ee727e63"
+      "sha256": "2a35ebbece01958ac642faf2a3680d724b3aa7d3179d690fd9583aaf53cf9cb3"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2742,7 +2742,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "9acd9af3c17ae8a44161edb0b037e8fff138a4059e5d7ec2affda4b0ed12b735"
+      "sha256": "230ca05e2cd108f5648d76a776bfc3aeea2b9628a834e6655b16d9d5f60cb280"
     },
     {
       "path": "docs/modules-contract.md",
@@ -2832,12 +2832,12 @@
     {
       "path": "docs/page-inventory.json",
       "mode": "0000644",
-      "sha256": "02c21f9e962d73fc05655943340ce5ef01a2d1e17cd77a9ffd074ffb979445cd"
+      "sha256": "27683df3ef3062442b5a2b3d0d814a2e0d4cfb0c666bf58b96af0f8f5c4bd97e"
     },
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "9d33140a6b9dc8820ef0283985f57dae888a1e7045be3f7ef5922a1d7b09e97b"
+      "sha256": "d5f8ac454357067ac14cb3550c9d12b2b04143e1e796facce51f0510900f0795"
     },
     {
       "path": "docs/project-context.template.md",
@@ -4142,12 +4142,12 @@
     {
       "path": "modules/copy-desk/page-status.js",
       "mode": "0000644",
-      "sha256": "fe85e899abb8524b36ef7187a8a2b5b127ea87342c378a32b95a644d18a83021"
+      "sha256": "e54fe2358641ab6bf157f3a434131a48eda175309480fa402290d8d4e6a431d1"
     },
     {
       "path": "modules/copy-desk/pages.js",
       "mode": "0000644",
-      "sha256": "7cb248a536b49794409bb74c8bed19109b842195c9fb97093250218c3a58f101"
+      "sha256": "76141638d80c0f7ba2046fa84f4e1309e020f065ef39c893d77da04ff2a2da73"
     },
     {
       "path": "modules/copy-desk/proposals.js",
@@ -4162,7 +4162,7 @@
     {
       "path": "modules/copy-desk/routes/copy-desk.js",
       "mode": "0000644",
-      "sha256": "4aaa64c6ec0cc6b63353659007cd3ed1b2daf1f0df77c8e7c98ba63217a1c719"
+      "sha256": "aab0b4221b092333ac6bc502d1bb45229410c270957025c8af20b4e33c776304"
     },
     {
       "path": "modules/copy-desk/tests/copy_docx.mjs",
@@ -5619,6 +5619,31 @@
       "mode": "0000644",
       "sha256": "0d17be2800724ca4130197f222222fcdad167bde24c068739f5ad4bfb6d6ccd8"
     },
+    {
+      "path": "modules/hall-ui/public/tweak-editor-lib.js",
+      "mode": "0000644",
+      "sha256": "cb71d8aedb579c644b5043a838dedcc50a4c24623e281aa2e8db3fd36e7c0ecc"
+    },
+    {
+      "path": "modules/hall-ui/public/tweak-editor.css",
+      "mode": "0000644",
+      "sha256": "a5685c2bada1eb56e4458c9cfca1da7d5035cc0d7bb4e18e8f83e78514346c97"
+    },
+    {
+      "path": "modules/hall-ui/public/tweak-editor.html",
+      "mode": "0000644",
+      "sha256": "b4ad8e1525b4e5352b00b778d2f3e7666d38b96fa655d7959c9e55e77e067d90"
+    },
+    {
+      "path": "modules/hall-ui/public/tweak-editor.js",
+      "mode": "0000644",
+      "sha256": "f8c2097f6c4fb782321f9238622097cd5642d8afacddd431b4a0d2f97e235562"
+    },
+    {
+      "path": "modules/hall-ui/public/tweak-editor.states.json",
+      "mode": "0000644",
+      "sha256": "ced94f02c2c79cb1bdf030e0a86804acabec5bda30378f37f6cf313a6a1b14a0"
+    },
     {
       "path": "modules/hall-ui/public/watch.css",
       "mode": "0000644",
@@ -5719,6 +5744,11 @@
       "mode": "0000644",
       "sha256": "01ea4e44ed380695fa90708fd388dfc3f48e65b17e22941e1542abcc979d1e0b"
     },
+    {
+      "path": "modules/hall-ui/records/tweak-editor.md",
+      "mode": "0000644",
+      "sha256": "21276ee938dac7204e11630eba569ba34a47d7096cdcc57d99157bc55bfd0a6f"
+    },
     {
       "path": "modules/ideas/CLAUDE.md",
       "mode": "0000644",
@@ -8547,12 +8577,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "e7d5ed448c2fa5c6fb22742c4be710109c9fbe6755dd57d6fffd286b7a194cb3"
+      "sha256": "387505d96f16db9259bd3c62fd2420949eabc4b34795f2e2121c5244e39e4a15"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "ac4e84c9db583e987e75010a264f325a9ff10f4c1440aad5bfe6b22048e81688"
+      "sha256": "b86d5a9a682c2c94476f5f629e35ca12060cc5ec743b436dd558c061966632ac"
     },
     {
       "path": "public-docs/index.html",
@@ -8572,7 +8602,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "5b76f8faa6dc8215c2720ca937015f3968689700b842c1bb7e103fc66f17ddc8"
+      "sha256": "bf828c5a5c41c77a922c60057c989f08e668c7e166b5dc2add801094248862ec"
     },
     {
       "path": "scripts/bongos-mcp.js",
@@ -10242,7 +10272,7 @@
     {
       "path": "scripts/hall-preview/server.js",
       "mode": "0000644",
-      "sha256": "5c2c480bea8acc9d74d17a27d60312ae8ef9dc2cb7bd18a776ea3bab8ca49ecc"
+      "sha256": "1e1aa2e636b388c791eccd8c4bf8ad2b1365820594258579b945858fa1646831"
     },
     {
       "path": "scripts/hall-preview/task-visual.js",
@@ -10627,7 +10657,7 @@
     {
       "path": "src/bongos/serve-internal.js",
       "mode": "0000644",
-      "sha256": "cb840dc6bff2664c644770e7c2fcb004beb9dd48011635c1851e12161e7d9c3a"
+      "sha256": "d55251183e8f0c6e210136be886c98c2adb6ea77f374fd375c2b7d44d7e59b48"
     },
     {
       "path": "src/bongos/software-update.js",
@@ -10657,7 +10687,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "5d2d121a71ed87875920963e2dd09b8116a7657e47d76429e921509089919e0c"
+      "sha256": "3bb2c146ee72b0f97bf1c6fa9a02fe90bb7d32cbe5bc1e28d40d2998aff2f187"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -11619,6 +11649,11 @@
       "mode": "0000644",
       "sha256": "e25485728f161b8610f57db11b387f5f7807afb41d0badd2f7a32776eaf97283"
     },
+    {
+      "path": "tests/copy_desk_page_editor.mjs",
+      "mode": "0000644",
+      "sha256": "25878366349548061763c31dd2e1c4a81642a033956d5ac8ec45596e49a17ccd"
+    },
     {
       "path": "tests/copy_desk_page_next.mjs",
       "mode": "0000644",
@@ -12717,7 +12752,7 @@
     {
       "path": "tests/hall_audit.mjs",
       "mode": "0000644",
-      "sha256": "a1fd70d0ffa56e95bf0e4a75a70563943850e3099894a6df178baf62a36aef8a"
+      "sha256": "56a0822be45f279aa2be982ff17d405ac059a1db0199a3cf1febec20dd92c699"
     },
     {
       "path": "tests/hall_board_world.mjs",
@@ -12777,7 +12812,7 @@
     {
       "path": "tests/hall_page_gate_map.mjs",
       "mode": "0000644",
-      "sha256": "69298b95f35817cedd85d12e074bd673fcd06383499613b194a0c786983ef755"
+      "sha256": "af1877acb1cbfaabea5bc59dd4992043a510f948f0617e0bedb1ac820fa6b65c"
     },
     {
       "path": "tests/hall_palette.mjs",
@@ -12864,6 +12899,11 @@
       "mode": "0000644",
       "sha256": "a1da5c5c009acd1286d1f0862c9c57c29b80e5dd6f2f1e3effb459f849b38740"
     },
+    {
+      "path": "tests/hall_tweak_editor.mjs",
+      "mode": "0000644",
+      "sha256": "516da07f8646ce2c0e3755db6cfc58a5c3799a051258b9fff8ce4cf03773c2b9"
+    },
     {
       "path": "tests/handle_machinery.mjs",
       "mode": "0000644",

package/clients/bongos-client/README.md

@@ -5,7 +5,7 @@ A **generated**, zero-dependency typed client for the Bongos API — produced fr
 by hand; it regenerates when the spec changes, so it can never drift from the routes.
 
 - API version: **v1** (served at `/api/bongos/v1`)
-- 453 operations across 68 resource groups
+- 454 operations across 68 resource groups
 
 ## Use it from your project
 

package/clients/bongos-client/bongos-client.global.js

@@ -353,6 +353,8 @@ function createClient(opts = {}) {
       postCopyDeskPagesPageIdAsks: (args) => request("POST", "/copy-desk/pages/{pageId}/asks", { hasBody: true }, args),
       // POST /copy-desk/pages/{pageId}/claim — rank: any-builder — POST /copy-desk/pages/:pageId/claim
       postCopyDeskPagesPageIdClaim: (args) => request("POST", "/copy-desk/pages/{pageId}/claim", { hasBody: true }, args),
+      // GET /copy-desk/pages/{pageId}/draft — rank: any-builder — GET /copy-desk/pages/:pageId/draft
+      getCopyDeskPagesPageIdDraft: (args) => request("GET", "/copy-desk/pages/{pageId}/draft", { hasBody: false }, args),
       // PUT /copy-desk/pages/{pageId}/draft — rank: any-builder — PUT /copy-desk/pages/:pageId/draft
       putCopyDeskPagesPageIdDraft: (args) => request("PUT", "/copy-desk/pages/{pageId}/draft", { hasBody: true }, args),
       // GET /copy-desk/pages/{pageId}/draft.docx — rank: any-builder — GET /copy-desk/pages/:pageId/draft.docx

package/clients/bongos-client/index.cjs

@@ -352,6 +352,8 @@ function createClient(opts = {}) {
       postCopyDeskPagesPageIdAsks: (args) => request("POST", "/copy-desk/pages/{pageId}/asks", { hasBody: true }, args),
       // POST /copy-desk/pages/{pageId}/claim — rank: any-builder — POST /copy-desk/pages/:pageId/claim
       postCopyDeskPagesPageIdClaim: (args) => request("POST", "/copy-desk/pages/{pageId}/claim", { hasBody: true }, args),
+      // GET /copy-desk/pages/{pageId}/draft — rank: any-builder — GET /copy-desk/pages/:pageId/draft
+      getCopyDeskPagesPageIdDraft: (args) => request("GET", "/copy-desk/pages/{pageId}/draft", { hasBody: false }, args),
       // PUT /copy-desk/pages/{pageId}/draft — rank: any-builder — PUT /copy-desk/pages/:pageId/draft
       putCopyDeskPagesPageIdDraft: (args) => request("PUT", "/copy-desk/pages/{pageId}/draft", { hasBody: true }, args),
       // GET /copy-desk/pages/{pageId}/draft.docx — rank: any-builder — GET /copy-desk/pages/:pageId/draft.docx

package/clients/bongos-client/index.d.ts

@@ -773,6 +773,8 @@ export interface BongosClient {
     postCopyDeskPagesPageIdAsks(args: RequestArgs & { body: PostCopyDeskPagesPageIdAsksRequest }): Promise<ApiResponse>;
     /** POST /copy-desk/pages/{pageId}/claim — rank: any-builder */
     postCopyDeskPagesPageIdClaim(args?: RequestArgs): Promise<ApiResponse>;
+    /** GET /copy-desk/pages/{pageId}/draft — rank: any-builder */
+    getCopyDeskPagesPageIdDraft(args?: RequestArgs): Promise<ApiResponse>;
     /** PUT /copy-desk/pages/{pageId}/draft — rank: any-builder */
     putCopyDeskPagesPageIdDraft(args: RequestArgs & { body: PutCopyDeskPagesPageIdDraftRequest }): Promise<PutCopyDeskPagesPageIdDraftResponse>;
     /** GET /copy-desk/pages/{pageId}/draft.docx — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -349,6 +349,8 @@ export function createClient(opts = {}) {
       postCopyDeskPagesPageIdAsks: (args) => request("POST", "/copy-desk/pages/{pageId}/asks", { hasBody: true }, args),
       // POST /copy-desk/pages/{pageId}/claim — rank: any-builder — POST /copy-desk/pages/:pageId/claim
       postCopyDeskPagesPageIdClaim: (args) => request("POST", "/copy-desk/pages/{pageId}/claim", { hasBody: true }, args),
+      // GET /copy-desk/pages/{pageId}/draft — rank: any-builder — GET /copy-desk/pages/:pageId/draft
+      getCopyDeskPagesPageIdDraft: (args) => request("GET", "/copy-desk/pages/{pageId}/draft", { hasBody: false }, args),
       // PUT /copy-desk/pages/{pageId}/draft — rank: any-builder — PUT /copy-desk/pages/:pageId/draft
       putCopyDeskPagesPageIdDraft: (args) => request("PUT", "/copy-desk/pages/{pageId}/draft", { hasBody: true }, args),
       // GET /copy-desk/pages/{pageId}/draft.docx — rank: any-builder — GET /copy-desk/pages/:pageId/draft.docx

package/docs/api/openapi.json

@@ -5312,6 +5312,49 @@
       }
     },
     "/copy-desk/pages/{pageId}/draft": {
+      "get": {
+        "operationId": "get_copy_desk_pages_pageId_draft",
+        "tags": [
+          "copy-desk"
+        ],
+        "summary": "GET /copy-desk/pages/:pageId/draft",
+        "description": "------------------------------------------------------------------------- GET /copy-desk/pages/:pageId/draft — what the tweak editor opens on (task 1004321 / BV2.TW10, ADR 0341 D4): every line of the page reading in page order with its margin note, the open round and whether the caller holds it, and the saved draft (only on the current reading). The read the PUT below saves over, and the .docx download's own data as JSON. rank: any signed-in builder, as the download: the words are the page's own and the draft sits on a task every builder can read. -------------------------------------------------------------------------\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/copy-desk/routes/copy-desk.js",
+        "parameters": [
+          {
+            "name": "pageId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `pageId`."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      },
       "put": {
         "operationId": "put_copy_desk_pages_pageId_draft",
         "tags": [
@@ -28675,7 +28718,7 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 453,
+  "x-endpoint-count": 454,
   "x-schema-count": 487,
   "x-undocumented-bodies": 10,
   "x-response-schemas": 333,

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # Bongos API reference
 
-> **Generated from the live route files** — the route file is authoritative. 453 endpoints across 76 route files.
+> **Generated from the live route files** — the route file is authoritative. 454 endpoints across 76 route files.
 > Machine-readable spec: [`docs/api/openapi.json`](api/openapi.json) (OpenAPI 3.1). Rendered docs site: **`/docs`** (e.g. `cloudbongos.com/docs`).
 
 Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust-boundary-server-enforced-permissions.md)): `public` < `any-builder` < `metic+archon` < `archon`.
@@ -210,7 +210,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/connections/requests` | `any-builder` | — | MY pending requests, both directions (own data). |
 | GET | `/api/bongos/connections/suggestions` | `any-builder` | — | "builders you may know" (R21, task 1002297; ADR 0202 D5). |
 
-## `copy-desk` (15)
+## `copy-desk` (16)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -221,6 +221,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/copy-desk/pages/:pageId` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/pages/:pageId — one page: status, changelog, the… |
 | POST | `/api/bongos/copy-desk/pages/:pageId/asks` | `any-builder` | `reason` | ------------------------------------------------------------------------- POST /copy-desk/pages/:pageId/asks — ask for a page (task 10043… |
 | POST | `/api/bongos/copy-desk/pages/:pageId/claim` | `any-builder` | validated | ------------------------------------------------------------------------- POST /copy-desk/pages/:pageId/claim — claim a page's tweak (tas… |
+| GET | `/api/bongos/copy-desk/pages/:pageId/draft` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/pages/:pageId/draft — what the tweak editor open… |
 | PUT | `/api/bongos/copy-desk/pages/:pageId/draft` | `any-builder` | `reading_hash`, `lines` | ------------------------------------------------------------------------- PUT /copy-desk/pages/:pageId/draft — autosave the artist's draf… |
 | GET | `/api/bongos/copy-desk/pages/:pageId/draft.docx` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/pages/:pageId/draft.docx — download the page's w… |
 | POST | `/api/bongos/copy-desk/pages/:pageId/draft.docx` | `any-builder` | _undocumented_ | ------------------------------------------------------------------------- POST /copy-desk/pages/:pageId/draft.docx — upload the Word file… |