@bongos/core 1.19.1059 → 1.19.1061

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.1059",
-  "core_contract": "1.19.1059",
-  "source_commit": "77525594aafb82e0be5f53d111e1d751ed6945cc",
+  "core_version": "1.19.1061",
+  "core_contract": "1.19.1061",
+  "source_commit": "1cc2c2cdca684d17445332667885541d1bd1abbc",
   "source_ref": "HEAD",
-  "built_at": "2026-09-28T11:26:07.315Z",
+  "built_at": "2026-09-28T12:38:11.098Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 543,
     "agent_docs_stubbed": 26,
-    "functional_verbatim": 2525,
+    "functional_verbatim": 2531,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 3095,
-  "tree_sha256": "27e342154726c2063d49121ee1ef6a47f3125fc8673ba3a3ed328c8a15fc25db",
+  "file_count": 3101,
+  "tree_sha256": "22d7d908ffbc96ccc7866b4212aabb6062dfb4b6ffa915ddaa0153125d8aa4dd",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -317,12 +317,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "18f34899047600dc6f4301d3ee6728e7bf01216bb0aad0d3779c90c24878c417"
+      "sha256": "a430ee71b5a2698346d4917245863dfc847cd31091dfa5de9a01ef7d21abd1f7"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "cb4119d5434eb11476fb56ab5f3ad7cba19a04636669def7a9642abdfb379410"
+      "sha256": "86d62d8e000364d5c05ef0eced49f1fa165c923dc7892fe82d918c21864de616"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -332,17 +332,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "3d0b0cee2b777554c3289c54a1986bd65ee3a51b83d26535384b505866f56d5c"
+      "sha256": "e0e84783a89af88a81251931ae7702e0c0302001446bf5b33d7de30bd4c9e264"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "df7d595c5ed10a4472cc3fc7bf3254e8b90eca5651394177b26dcbe3327fcf1e"
+      "sha256": "9fdc897116e58b93d39b940c5ae20108825bc88d67dad1de11d980f943a021c0"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "b211a8a2072874c86fa7d1c948a8e0313b76191c69fd4d044e2704aada198113"
+      "sha256": "102dae082b630a9d2613d1f5dab5b128748a005304f066ce3f36f8ff5166aa04"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2177,12 +2177,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "e79005662b3fc53fed213d29c07885df5563a1319e978387d84fb30295a609c3"
+      "sha256": "66487b94a7ca2646daa4fbe24159396d48fbcf10f2adc9c14b9e43fc86233b56"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "fd26c908294adf589bfe05b6f1432b74bbb07f4cd5c0dce4d89e9b052e3dbdfa"
+      "sha256": "258b4baf4671e59e66464c47193f54a91d34a3a678dcc9db0955053f7f86e48b"
     },
     {
       "path": "docs/architecture.md",
@@ -2742,7 +2742,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "e503dd3babb557fcc2cdd366604e50c845d3264f29a6fbffd8c31b9a40cf6ae9"
+      "sha256": "a47ac184c604897dd657f4995f4e278303d378747164bc9540b0937eab19186e"
     },
     {
       "path": "docs/modules-contract.md",
@@ -4112,7 +4112,7 @@
     {
       "path": "modules/copy-desk/flags.js",
       "mode": "0000644",
-      "sha256": "292f0d3461855552efc25cc5207dd4d58db38ef4c1b6eadcbb55521f89e6fa5e"
+      "sha256": "ca617aef2c209f89c57acf2db7772b27f0bb7e790afb48dc940822422ec8ad81"
     },
     {
       "path": "modules/copy-desk/migrations/copy_desk_001_flags.sql",
@@ -4137,12 +4137,12 @@
     {
       "path": "modules/copy-desk/page-status.js",
       "mode": "0000644",
-      "sha256": "63af13ad05f0b2479eb9488f542f3f0dade74273de41e422583eebe070359271"
+      "sha256": "fe85e899abb8524b36ef7187a8a2b5b127ea87342c378a32b95a644d18a83021"
     },
     {
       "path": "modules/copy-desk/pages.js",
       "mode": "0000644",
-      "sha256": "671edb87faad28217c30abdcfff2c110d9b692f0da0f2d18af975d34d42b782e"
+      "sha256": "ba89a35e225a41e94e20a21e716a3d83ab15081c2f9d6f6718394c25b37ea305"
     },
     {
       "path": "modules/copy-desk/proposals.js",
@@ -4157,7 +4157,7 @@
     {
       "path": "modules/copy-desk/routes/copy-desk.js",
       "mode": "0000644",
-      "sha256": "4c7bab355d8410ec755f9677914b97132edc5be7c61b0aeebbf5b14abd2a3b42"
+      "sha256": "92170c36251df8a1606d87dcbd057bccc167f348f39d2705872934f24411c7d7"
     },
     {
       "path": "modules/copy-desk/tests/copy_flags.mjs",
@@ -4167,7 +4167,17 @@
     {
       "path": "modules/copy-desk/tests/copy_no_cms.mjs",
       "mode": "0000644",
-      "sha256": "17ad6640e97dde18273ccd5c533b6910d490bfad970da16fd0712c20a8b5f7f3"
+      "sha256": "b04b745bfc010ed86d7187c22f067bb8ecaaa24a095420a01f2b37806f283d48"
+    },
+    {
+      "path": "modules/copy-desk/tests/copy_page_draft.mjs",
+      "mode": "0000644",
+      "sha256": "7bae773b6f8e3c4d5dced4d689237f59d421fc34f9d6c809d50e81f610e9eafb"
+    },
+    {
+      "path": "modules/copy-desk/tests/copy_page_next.mjs",
+      "mode": "0000644",
+      "sha256": "d82db6db97b22a88a83b4cf9bac7724a411dc7831b08cacd5548c0ac367ad3b9"
     },
     {
       "path": "modules/copy-desk/tests/copy_page_status.mjs",
@@ -6127,7 +6137,7 @@
     {
       "path": "modules/lifecycle/lifecycle.js",
       "mode": "0000644",
-      "sha256": "05edef42162cff680d96b084805959741be5a9ec09b18c87fdbfab6ff65458e0"
+      "sha256": "8ed95b63975ec4aceb34ddeb31fa147194b38c26242530c83a5ed144214b5150"
     },
     {
       "path": "modules/lifecycle/merge-lock.js",
@@ -6212,7 +6222,12 @@
     {
       "path": "modules/lifecycle/page-tweak-reads.js",
       "mode": "0000644",
-      "sha256": "ed622f53097f8f0595c885c796ca597c6d96004cca82d884c30c97f43afc104e"
+      "sha256": "016329bc9dadda1e1b1dce86aa02aa7c7f259cc56708ca12030ea601ea63e7a0"
+    },
+    {
+      "path": "modules/lifecycle/page-tweak-write.js",
+      "mode": "0000644",
+      "sha256": "a13c01e96c5ae09837b9d599a66b23765f6d6f16cc29b11ca897da4f497d0b0d"
     },
     {
       "path": "modules/lifecycle/pg-constraint-fail.js",
@@ -8517,12 +8532,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "cd48c5b838a56b6fb70ccedf866a234037b46a049f027facc60d0a925eabe5f9"
+      "sha256": "dd4068cbb235742769c4bda2d8d49dd955c266e5986844fc471ef12416166730"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "c2e9d52b540b2adbe2e9e7b8ae333d2b621add895a6280e1cc6d7c961f26b833"
+      "sha256": "c3abc1f3e3b321375820e92c627d7f7aeb13a87259f0783aea211386c68d8267"
     },
     {
       "path": "public-docs/index.html",
@@ -8542,7 +8557,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "77adcb2aa4e1aeed40c59698b77423095609e35589148c112b0a7196a5fc4542"
+      "sha256": "d77397164aba5ff244fe0ddbcd9a4d7e8e327b357a37e6cb48bdfbe1bbbba7a6"
     },
     {
       "path": "scripts/bongos-mcp.js",
@@ -10627,7 +10642,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "d599f052a4dddddb6bc9ca72b7b97c99ba2c2e20e1d577cc8afdbfb2391289a5"
+      "sha256": "56850953ea4d6876e68096995c35e9b9eaa1b44f092715c4aba8677e89c889d3"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -11577,18 +11592,28 @@
     {
       "path": "tests/copy_desk_flags_db.mjs",
       "mode": "0000644",
-      "sha256": "b016c0017adfa95de453d418e81e1c22a2a7193418f05f05845a3212941bd074"
+      "sha256": "739bbd623955742864ac712a5f119968ebac671c005054a07a8521c7770a929b"
     },
     {
       "path": "tests/copy_desk_page_claim.mjs",
       "mode": "0000644",
-      "sha256": "18b0e3cd3384226fe2278a7094e45b849e0f43dc41269b40fa5487fd315e0f20"
+      "sha256": "af6cdac77b90aad511a603757e12d7ffefaa7fdbcdd14aefd70ad49e3cd193fe"
+    },
+    {
+      "path": "tests/copy_desk_page_next.mjs",
+      "mode": "0000644",
+      "sha256": "d9827f75b542ce1a3fe9bfe9e3d5cd8ecaaed4691d611dc73617d280ec6cf292"
     },
     {
       "path": "tests/copy_desk_page_reads.mjs",
       "mode": "0000644",
       "sha256": "29c591eb22b17fb86a3bff894d362f1372e41d1d0e06e3751f36da90184a425a"
     },
+    {
+      "path": "tests/copy_desk_page_submit.mjs",
+      "mode": "0000644",
+      "sha256": "c77d8c60449bad805d048ec78e43169b5ec87283a3f91e29edba9e88352f4c51"
+    },
     {
       "path": "tests/copy_inventory.mjs",
       "mode": "0000644",
@@ -12069,6 +12094,11 @@
       "mode": "0000644",
       "sha256": "2f532cacb06f0f074c15101c16578f3183104042644d6c8aa0d2e80fdb425b2f"
     },
+    {
+      "path": "tests/fixtures/page-ledger.mjs",
+      "mode": "0000644",
+      "sha256": "9087b5a76ddc3d11e5b7a8bf23ac56c824e763e63d302ac457d9515707f0c7a5"
+    },
     {
       "path": "tests/fixtures/session-506-digest.json",
       "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`)
-- 448 operations across 68 resource groups
+- 451 operations across 68 resource groups
 
 ## Use it from your project
 

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

@@ -343,6 +343,8 @@ function createClient(opts = {}) {
       postCopyDeskFlags: (args) => request("POST", "/copy-desk/flags", { hasBody: true }, args),
       // POST /copy-desk/flags/{id}/close — rank: any-builder — POST /copy-desk/flags/:id/close
       postCopyDeskFlagsIdClose: (args) => request("POST", "/copy-desk/flags/{id}/close", { hasBody: true }, args),
+      // GET /copy-desk/next — rank: any-builder — GET /copy-desk/next
+      getCopyDeskNext: (args) => request("GET", "/copy-desk/next", { hasBody: false }, args),
       // GET /copy-desk/pages — rank: any-builder — GET /copy-desk/pages
       getCopyDeskPages: (args) => request("GET", "/copy-desk/pages", { hasBody: false }, args),
       // GET /copy-desk/pages/{pageId} — rank: any-builder — GET /copy-desk/pages/:pageId
@@ -351,6 +353,10 @@ 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),
+      // 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),
+      // POST /copy-desk/pages/{pageId}/submit — rank: any-builder — POST /copy-desk/pages/:pageId/submit
+      postCopyDeskPagesPageIdSubmit: (args) => request("POST", "/copy-desk/pages/{pageId}/submit", { hasBody: true }, args),
       // POST /copy-desk/proposals — rank: any-builder — POST /copy-desk/proposals
       postCopyDeskProposals: (args) => request("POST", "/copy-desk/proposals", { hasBody: true }, args),
       // GET /copy-desk/queue — rank: any-builder — GET /copy-desk/queue

package/clients/bongos-client/index.cjs

@@ -342,6 +342,8 @@ function createClient(opts = {}) {
       postCopyDeskFlags: (args) => request("POST", "/copy-desk/flags", { hasBody: true }, args),
       // POST /copy-desk/flags/{id}/close — rank: any-builder — POST /copy-desk/flags/:id/close
       postCopyDeskFlagsIdClose: (args) => request("POST", "/copy-desk/flags/{id}/close", { hasBody: true }, args),
+      // GET /copy-desk/next — rank: any-builder — GET /copy-desk/next
+      getCopyDeskNext: (args) => request("GET", "/copy-desk/next", { hasBody: false }, args),
       // GET /copy-desk/pages — rank: any-builder — GET /copy-desk/pages
       getCopyDeskPages: (args) => request("GET", "/copy-desk/pages", { hasBody: false }, args),
       // GET /copy-desk/pages/{pageId} — rank: any-builder — GET /copy-desk/pages/:pageId
@@ -350,6 +352,10 @@ 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),
+      // 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),
+      // POST /copy-desk/pages/{pageId}/submit — rank: any-builder — POST /copy-desk/pages/:pageId/submit
+      postCopyDeskPagesPageIdSubmit: (args) => request("POST", "/copy-desk/pages/{pageId}/submit", { hasBody: true }, args),
       // POST /copy-desk/proposals — rank: any-builder — POST /copy-desk/proposals
       postCopyDeskProposals: (args) => request("POST", "/copy-desk/proposals", { hasBody: true }, args),
       // GET /copy-desk/queue — rank: any-builder — GET /copy-desk/queue

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

@@ -481,6 +481,8 @@ export interface PostVersionsIdDoneWhenRequest { criterion_id: string; criterion
 export interface PostVersionsIdDoneWhenResponse { ok: boolean; criterion: unknown }
 export interface PostVersionsRequest { id: string; name: string; status?: string; done_when?: string; scope_doc_path?: string; criteria?: unknown[]; first_goal?: Record<string, unknown> }
 export interface PostVersionsResponse { version: unknown; goal: unknown; criteria: unknown }
+export interface PutCopyDeskPagesPageIdDraftRequest { reading_hash: string; lines: unknown[] }
+export interface PutCopyDeskPagesPageIdDraftResponse { ok: boolean; outcome: unknown; page_id: unknown; round: unknown; draft: unknown; counter: unknown }
 export interface PutGovernmentRanksRankKeyPermissionsPermissionKeyResponse { ok: boolean; rank_key: unknown; permission_key: unknown; granted: unknown }
 export interface PutMingleOptInRequest { opted_in: boolean }
 export interface PutMingleOptInResponse { opted_in: unknown; updated_at: unknown }
@@ -760,6 +762,8 @@ export interface BongosClient {
     postCopyDeskFlags(args: RequestArgs & { body: PostCopyDeskFlagsRequest }): Promise<PostCopyDeskFlagsResponse>;
     /** POST /copy-desk/flags/{id}/close — rank: any-builder */
     postCopyDeskFlagsIdClose(args: RequestArgs & { body: PostCopyDeskFlagsIdCloseRequest }): Promise<PostCopyDeskFlagsIdCloseResponse>;
+    /** GET /copy-desk/next — rank: any-builder */
+    getCopyDeskNext(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /copy-desk/pages — rank: any-builder */
     getCopyDeskPages(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /copy-desk/pages/{pageId} — rank: any-builder */
@@ -768,6 +772,10 @@ export interface BongosClient {
     postCopyDeskPagesPageIdAsks(args: RequestArgs & { body: PostCopyDeskPagesPageIdAsksRequest }): Promise<ApiResponse>;
     /** POST /copy-desk/pages/{pageId}/claim — rank: any-builder */
     postCopyDeskPagesPageIdClaim(args?: RequestArgs): Promise<ApiResponse>;
+    /** PUT /copy-desk/pages/{pageId}/draft — rank: any-builder */
+    putCopyDeskPagesPageIdDraft(args: RequestArgs & { body: PutCopyDeskPagesPageIdDraftRequest }): Promise<PutCopyDeskPagesPageIdDraftResponse>;
+    /** POST /copy-desk/pages/{pageId}/submit — rank: any-builder */
+    postCopyDeskPagesPageIdSubmit(args?: RequestArgs): Promise<ApiResponse>;
     /** POST /copy-desk/proposals — rank: any-builder */
     postCopyDeskProposals(args: RequestArgs & { body: PostCopyDeskProposalsRequest }): Promise<PostCopyDeskProposalsResponse>;
     /** GET /copy-desk/queue — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -339,6 +339,8 @@ export function createClient(opts = {}) {
       postCopyDeskFlags: (args) => request("POST", "/copy-desk/flags", { hasBody: true }, args),
       // POST /copy-desk/flags/{id}/close — rank: any-builder — POST /copy-desk/flags/:id/close
       postCopyDeskFlagsIdClose: (args) => request("POST", "/copy-desk/flags/{id}/close", { hasBody: true }, args),
+      // GET /copy-desk/next — rank: any-builder — GET /copy-desk/next
+      getCopyDeskNext: (args) => request("GET", "/copy-desk/next", { hasBody: false }, args),
       // GET /copy-desk/pages — rank: any-builder — GET /copy-desk/pages
       getCopyDeskPages: (args) => request("GET", "/copy-desk/pages", { hasBody: false }, args),
       // GET /copy-desk/pages/{pageId} — rank: any-builder — GET /copy-desk/pages/:pageId
@@ -347,6 +349,10 @@ 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),
+      // 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),
+      // POST /copy-desk/pages/{pageId}/submit — rank: any-builder — POST /copy-desk/pages/:pageId/submit
+      postCopyDeskPagesPageIdSubmit: (args) => request("POST", "/copy-desk/pages/{pageId}/submit", { hasBody: true }, args),
       // POST /copy-desk/proposals — rank: any-builder — POST /copy-desk/proposals
       postCopyDeskProposals: (args) => request("POST", "/copy-desk/proposals", { hasBody: true }, args),
       // GET /copy-desk/queue — rank: any-builder — GET /copy-desk/queue

package/docs/api/openapi.json

@@ -5091,6 +5091,37 @@
         ]
       }
     },
+    "/copy-desk/next": {
+      "get": {
+        "operationId": "get_copy_desk_next",
+        "tags": [
+          "copy-desk"
+        ],
+        "summary": "GET /copy-desk/next",
+        "description": "------------------------------------------------------------------------- GET /copy-desk/next — the Tweak/CopyWrite Flow's recommendation (task 1004318 / BV2.TW07, ADR 0341 D8): the page the caller should tweak next and why (\"2 people asked for it\"), plus the next few for \"pick another\". Order: asked for (most distinct askers, then the oldest ask), then changed since the last tweak (most changed lines), then untweaked (landing, builders, status, then inventory order); tweaked pages with no drift last. A page another builder holds, or whose round is in flight, is never recommended (it is listed in `skipped`). The caller's own held page is `resume`, not a recommendation. \"Take next\" is POST /copy-desk/pages/:pageId/claim on `recommended.page_id` (each candidate carries its `take`), one call. The availability rule here is the claim's own, so that call is not refused for a reason this read knew. rank: any signed-in builder. The read is the caller's own and needs no craft; the claim it points at is where the artist gate lives. -------------------------------------------------------------------------\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",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/copy-desk/pages": {
       "get": {
         "operationId": "get_copy_desk_pages",
@@ -5280,6 +5311,126 @@
         ]
       }
     },
+    "/copy-desk/pages/{pageId}/draft": {
+      "put": {
+        "operationId": "put_copy_desk_pages_pageId_draft",
+        "tags": [
+          "copy-desk"
+        ],
+        "summary": "PUT /copy-desk/pages/:pageId/draft",
+        "description": "------------------------------------------------------------------------- PUT /copy-desk/pages/:pageId/draft — autosave the artist's draft (task 1004319 / BV2.TW08, ADR 0341 D4). Body: { reading_hash, lines: [{ key, after }] }, the WHOLE draft: every line the artist has changed. The saved draft becomes exactly that (a line sent back at its current text is dropped, so only changed lines are stored). rank: any signed-in builder; only the HOLDER of the page's writing claim (the web claim the page claim took) may save, checked in the lifecycle transaction. Every target is resolved from the page reading by key: section, current text (`before`) and placement are the reading's, never the body's. A body built on an older reading is refused `reading_moved`, whole, since its keys may now mean other lines. Cheap and idempotent: a save that resolves to the draft already stored writes nothing (200 `unchanged`; `updated_at` does not move). The editor debounces; the server only has to make a repeated save free. 200 saved | unchanged with the draft and \"N of M rewritten\" 409 page_not_held the caller does not hold the page (holder named) 409 no_open_round the page has no round: claim it first 409 reading_moved · 400 unknown_line / line_empty / line_too_long -------------------------------------------------------------------------\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`."
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PutCopyDeskPagesPageIdDraftRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PutCopyDeskPagesPageIdDraftResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/copy-desk/pages/{pageId}/submit": {
+      "post": {
+        "operationId": "post_copy_desk_pages_pageId_submit",
+        "tags": [
+          "copy-desk"
+        ],
+        "summary": "POST /copy-desk/pages/:pageId/submit",
+        "description": "------------------------------------------------------------------------- POST /copy-desk/pages/:pageId/submit — freeze the draft and queue the page for /tweak (task 1004319 / BV2.TW08, ADR 0341 D4, D7). Body: {} (it freezes the draft already on the task; nothing is taken from the request). rank: any signed-in builder; the holder only. One lifecycle transaction: * every draft line is re-resolved on the CURRENT page reading; a line the page no longer shows is refused by name (target_gone), as are an ambiguous one and a {…} hole added or dropped. Any refusal refuses the submit, listing the lines, and nothing is frozen; * a rewrite of an UNPLACED line (and of shared shell text with no registry row) leaves the batch and files its own engineer task (source page-tweak-unplaced, backlog), carrying the page, the line and the wording. The page does not wait for it; * the rest is frozen into the `page-tweak` block with each line's file, line and string id from the reading, naming the engineer tasks; * the artist's web claim is released and the task goes back to `ready`: the round reads `submitted`, the /tweak queue. 200 submitted with the batch, the engineer tasks, and where \"next up\" reads (GET /copy-desk/next) 200 already_submitted a repeated submit by the round's artist 409 lines_refused · nothing_to_submit · page_not_held · no_open_round -------------------------------------------------------------------------\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`."
+          }
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "additionalProperties": true
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/copy-desk/proposals": {
       "post": {
         "operationId": "post_copy_desk_proposals",
@@ -28151,6 +28302,45 @@
           "criteria"
         ]
       },
+      "PutCopyDeskPagesPageIdDraftRequest": {
+        "type": "object",
+        "properties": {
+          "reading_hash": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64
+          },
+          "lines": {
+            "type": "array"
+          }
+        },
+        "required": [
+          "reading_hash",
+          "lines"
+        ],
+        "additionalProperties": false
+      },
+      "PutCopyDeskPagesPageIdDraftResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "outcome": {},
+          "page_id": {},
+          "round": {},
+          "draft": {},
+          "counter": {}
+        },
+        "required": [
+          "ok",
+          "outcome",
+          "page_id",
+          "round",
+          "draft",
+          "counter"
+        ]
+      },
       "PutGovernmentRanksRankKeyPermissionsPermissionKeyResponse": {
         "type": "object",
         "properties": {
@@ -28354,9 +28544,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 448,
-  "x-schema-count": 484,
+  "x-endpoint-count": 451,
+  "x-schema-count": 486,
   "x-undocumented-bodies": 9,
-  "x-response-schemas": 331,
+  "x-response-schemas": 332,
   "x-generated-by": "scripts/gds/gen-api-docs.js"
 }

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # Bongos API reference
 
-> **Generated from the live route files** — the route file is authoritative. 448 endpoints across 76 route files.
+> **Generated from the live route files** — the route file is authoritative. 451 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,16 +210,19 @@ 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` (10)
+## `copy-desk` (13)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
 | POST | `/api/bongos/copy-desk/flags` | `any-builder` | `scope`, `surface`, `string_id`, `reason`, `kind` | ------------------------------------------------------------------------- POST /copy-desk/flags — file a flag. |
 | POST | `/api/bongos/copy-desk/flags/:id/close` | `any-builder` | `status`, `resolution_note`, `resolved_task_id` | ------------------------------------------------------------------------- POST /copy-desk/flags/:id/close — resolve or dismiss. |
+| GET | `/api/bongos/copy-desk/next` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/next — the Tweak/CopyWrite Flow's recommendation… |
 | GET | `/api/bongos/copy-desk/pages` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/pages — every page's status, count and drift, pl… |
 | 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… |
+| PUT | `/api/bongos/copy-desk/pages/:pageId/draft` | `any-builder` | `reading_hash`, `lines` | ------------------------------------------------------------------------- PUT /copy-desk/pages/:pageId/draft — autosave the artist's draf… |
+| POST | `/api/bongos/copy-desk/pages/:pageId/submit` | `any-builder` | validated | ------------------------------------------------------------------------- POST /copy-desk/pages/:pageId/submit — freeze the draft and que… |
 | POST | `/api/bongos/copy-desk/proposals` | `any-builder` | `string_id`, `proposed_text`, `why`, `file`, `line`, `flag_id` | ------------------------------------------------------------------------- POST /copy-desk/proposals — an artist proposes new wording, and… |
 | GET | `/api/bongos/copy-desk/queue` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/queue — the artist's working list. |
 | GET | `/api/bongos/copy-desk/strings` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/strings — search the inventory, to find somethin… |

package/docs/module-api-changelog.md

@@ -2605,5 +2605,9 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.19.1057 with no explicit bump. run 36390971623. (task 1002620)
   1.19.1059 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.19.1058 with no explicit bump. run 36415558760. (task 1002620)
+  1.19.1060 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.19.1059 with no explicit bump. run 36418832327. (task 1002620)
+  1.19.1061 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.19.1060 with no explicit bump. run 36423029975. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/modules/copy-desk/flags.js

@@ -297,6 +297,19 @@ async function countPageAskers(pageId) {
   return rows[0] ? Number(rows[0].askers) : 0;
 }
 
+// The recommendation's signal (TW07, ADR 0341 D8): every page with an open
+// ask, its distinct askers and its OLDEST open ask (the tie-break). One grouped
+// read over copy_desk_flags_page_open_idx, never a count per page.
+async function pageAskSummary() {
+  const { rows } = await pool.query(
+    `SELECT page_id, COUNT(DISTINCT flagged_by)::int AS askers, MIN(flagged_at) AS oldest_ask_at
+       FROM copy_desk_flags
+      WHERE scope = 'page' AND status = 'open'
+      GROUP BY page_id`
+  );
+  return rows.map((r) => ({ page_id: r.page_id, askers: Number(r.askers) || 0, oldest_ask_at: r.oldest_ask_at }));
+}
+
 // An open ask is RESOLVED when the page's next tweak ships (ADR 0341 D6): every
 // ask on the page filed before that ship, stamped with the tweak task. Guarded on
 // status = 'open', so a re-run changes nothing and a dismissed ask stays dismissed.
@@ -316,5 +329,5 @@ module.exports = {
   SCOPES, FLAG_SCOPES, PAGE_SCOPE, STATUSES, KINDS, CLOSING_STATUSES, MIN_REASON_CHARS, MAX_REASON_CHARS, MAX_NOTE_CHARS,
   tidy, normalizeFlagPayload, normalizeResolution, normalizePageAsk,
   insertFlag, listFlags, getFlag, closeFlag,
-  findOpenPageAsk, countPageAskers, resolvePageAsks,
+  findOpenPageAsk, countPageAskers, pageAskSummary, resolvePageAsks,
 };