@bongos/core 1.19.1058 → 1.19.1060

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.1058",
-  "core_contract": "1.19.1058",
-  "source_commit": "cc3df3cd962250b782d68eb7bb5f7c50a3adef1e",
+  "core_version": "1.19.1060",
+  "core_contract": "1.19.1060",
+  "source_commit": "053ab05047f2cede246dd8c6cca763a032ee8495",
   "source_ref": "HEAD",
-  "built_at": "2026-09-28T07:19:18.896Z",
+  "built_at": "2026-09-28T11:58:43.905Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 543,
     "agent_docs_stubbed": 26,
-    "functional_verbatim": 2522,
+    "functional_verbatim": 2528,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 3092,
-  "tree_sha256": "569bc59d91cfa01943f2591d40e7136410d57e9be9720aeafd1ab628b3971f55",
+  "file_count": 3098,
+  "tree_sha256": "80aa074ee45fe0f2b5b60a190786cd4833e3aad1153828d157d5fe2b865b7db0",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -317,12 +317,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "17846768bf8c6fd8b5a84a696be3ed55965b7b88d6ce5a70cf0255817f3f96ee"
+      "sha256": "3e5980fb95bfaf6029cdddc9c9921053d9897cbcbf15be30e58e9b494177d4af"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "73eb44a425e2b44ce41f2e556a091de336b3fd6f22f9781d94c63cc12de94434"
+      "sha256": "c587bec39fefe04695a0c1673882e3af552fe72486909e9e90759a3b46e20916"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -332,17 +332,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "561070585719a7bcc8b6ae9151b96ea2b8d676cfa55d7f9fd320cd8766f8554e"
+      "sha256": "ee6df391f3c319e77b9601fb47bf5deddc56adb95af62e8086a3d6dbeac4993b"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "6e8171ab15b946e28e2fc174ff883755bbfbdd6b13b72c73e2bd75776eb7a52e"
+      "sha256": "ed5f287b10278823cf322091feff1e784125d21a7856ad021a98e6e3e2269f71"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "6cfbac603f79180a0533e122fb51e176194c59bb522a33d4e7e9856017cfd378"
+      "sha256": "a43b2952238b2f19e76fe8767ec6b8a313fdfb0173cfa10946b6dee63e97af69"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2177,12 +2177,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "f87e4dd9f5f81900d70c1ade0fa2ae5f6dfce1a8b62ce54ac24976ddaa41dc7c"
+      "sha256": "d642de14db69137bb04bf79bf4a67b8ec01818ac2ff6b85f04fca4944f2bdd15"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "6468cbac38f8ed6c96a7c7a16237c6189137dd5d12ffaad14380a03705c1c8d3"
+      "sha256": "f47a697a636c8b50dafd4d8e58986676af0b8fcacaf89f6a418b230ebcb28cdc"
     },
     {
       "path": "docs/architecture.md",
@@ -2732,7 +2732,7 @@
     {
       "path": "docs/file-map.md",
       "mode": "0000644",
-      "sha256": "e7b65a4390baf004e1012a0cda4e08cab1f0b1f80be187abc62f953b01cf2bef"
+      "sha256": "43d6bdc61cd3401d35e68f0e98caa645db48a81eb59df2fd0b0c5e04d42b9254"
     },
     {
       "path": "docs/handoff-template.md",
@@ -2742,7 +2742,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "d1434d385623d6fc7714a173431c891c1e7c1a024c871992a77c528c386eb8f4"
+      "sha256": "72f72960133805df016e92eb786b37d8fb7cb67bf3f09e9fcade295cce4773cb"
     },
     {
       "path": "docs/modules-contract.md",
@@ -4112,13 +4112,18 @@
     {
       "path": "modules/copy-desk/flags.js",
       "mode": "0000644",
-      "sha256": "b2959e28807e25a6c80691569a5653bc5adf6471ae1d4b4e33bd2cda5e5054cb"
+      "sha256": "ca617aef2c209f89c57acf2db7772b27f0bb7e790afb48dc940822422ec8ad81"
     },
     {
       "path": "modules/copy-desk/migrations/copy_desk_001_flags.sql",
       "mode": "0000644",
       "sha256": "7569a5b33b9a2c86c588b49d086c443966066a412855d3f88367851a24edcfa7"
     },
+    {
+      "path": "modules/copy-desk/migrations/copy_desk_002_page_asks.sql",
+      "mode": "0000644",
+      "sha256": "776a4374537dcc86ef8ecb2c333cf12889832ae6319727a7787783e5ee80dfd3"
+    },
     {
       "path": "modules/copy-desk/module.json",
       "mode": "0000644",
@@ -4132,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": "86304a2cc8fc8a2f80eebe86812fd7778c8098b0d1caca47cce50e74c2b1da4e"
+      "sha256": "671edb87faad28217c30abdcfff2c110d9b692f0da0f2d18af975d34d42b782e"
     },
     {
       "path": "modules/copy-desk/proposals.js",
@@ -4152,17 +4157,22 @@
     {
       "path": "modules/copy-desk/routes/copy-desk.js",
       "mode": "0000644",
-      "sha256": "46d40786129f22f7c853f115b4f76deb2d6a2d96e408ec6e59e84bd97b61cc6f"
+      "sha256": "6d313d730906c5f240504695b792401fc0dc9ffde993efd2f330a9e71df276c0"
     },
     {
       "path": "modules/copy-desk/tests/copy_flags.mjs",
       "mode": "0000644",
-      "sha256": "b16ce15ebed9e750d03ddc6f72f63fdde62e550536576a9ece09d4585840c55d"
+      "sha256": "2af8862a4bb01acea75b775139db43d78218841cc217638c9a72b3e658e6d6c5"
     },
     {
       "path": "modules/copy-desk/tests/copy_no_cms.mjs",
       "mode": "0000644",
-      "sha256": "565c1c24bd41f43b3b6e42ddb74acd6e12735f1da57acd985b42cce3b53b8362"
+      "sha256": "17ad6640e97dde18273ccd5c533b6910d490bfad970da16fd0712c20a8b5f7f3"
+    },
+    {
+      "path": "modules/copy-desk/tests/copy_page_next.mjs",
+      "mode": "0000644",
+      "sha256": "d82db6db97b22a88a83b4cf9bac7724a411dc7831b08cacd5548c0ac367ad3b9"
     },
     {
       "path": "modules/copy-desk/tests/copy_page_status.mjs",
@@ -6122,7 +6132,7 @@
     {
       "path": "modules/lifecycle/lifecycle.js",
       "mode": "0000644",
-      "sha256": "b43edaac701104da26a612f8fa4fc373e591a799f2991939bfe3a82b6a241323"
+      "sha256": "05edef42162cff680d96b084805959741be5a9ec09b18c87fdbfab6ff65458e0"
     },
     {
       "path": "modules/lifecycle/merge-lock.js",
@@ -6199,6 +6209,11 @@
       "mode": "0000644",
       "sha256": "472161627fdeb33b628eb3d9b4d4d58eba13dc74dacee1f661fc79856496cff8"
     },
+    {
+      "path": "modules/lifecycle/page-tweak-claim.js",
+      "mode": "0000644",
+      "sha256": "4b9f9c23161a961381857a01fc810ce1b960e2b89b74e616fa17d34a403b592f"
+    },
     {
       "path": "modules/lifecycle/page-tweak-reads.js",
       "mode": "0000644",
@@ -8507,12 +8522,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "5f37f58bbc94f89857f41dcfd8b0c9fd052118dd52f28e21ca4a098de1e0b850"
+      "sha256": "1dd792c5514fb93f90ca899378a3fe7fb0ba2759d11ae763a593eaa4de211a37"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "02bba46e9a1f548100cccf7c6234dd8255f0f4d890a2006169430b660a9b54e8"
+      "sha256": "8e2cc56778737033b8c49aabdb41869132a0343fae6419e90aa23adedf474daa"
     },
     {
       "path": "public-docs/index.html",
@@ -8532,7 +8547,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "c9ff38bf3344440a544c306b9ebb9656c27b7635d165138dc9598f255c928cfd"
+      "sha256": "971eebaefe45a5e3bd6eac7a217d7a1abc571d02240dac97799f9167643a227b"
     },
     {
       "path": "scripts/bongos-mcp.js",
@@ -10617,7 +10632,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "287c1572709df01e1343615bfcda4efabff15c9b81aba18c93c4ffc9802cdb44"
+      "sha256": "5be8c8ecfa92788bfeef57fd9e4235d24ac3e4257d10e9936f38ace6b627d2cb"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -11567,7 +11582,17 @@
     {
       "path": "tests/copy_desk_flags_db.mjs",
       "mode": "0000644",
-      "sha256": "5ffe8f556f30f00f8489ca0922dc45fef4695a022b0ccee379fe6bd11e7870d5"
+      "sha256": "739bbd623955742864ac712a5f119968ebac671c005054a07a8521c7770a929b"
+    },
+    {
+      "path": "tests/copy_desk_page_claim.mjs",
+      "mode": "0000644",
+      "sha256": "af6cdac77b90aad511a603757e12d7ffefaa7fdbcdd14aefd70ad49e3cd193fe"
+    },
+    {
+      "path": "tests/copy_desk_page_next.mjs",
+      "mode": "0000644",
+      "sha256": "d9827f75b542ce1a3fe9bfe9e3d5cd8ecaaed4691d611dc73617d280ec6cf292"
     },
     {
       "path": "tests/copy_desk_page_reads.mjs",
@@ -12054,6 +12079,11 @@
       "mode": "0000644",
       "sha256": "2f532cacb06f0f074c15101c16578f3183104042644d6c8aa0d2e80fdb425b2f"
     },
+    {
+      "path": "tests/fixtures/page-ledger.mjs",
+      "mode": "0000644",
+      "sha256": "7e6cee001284e873e06a3037f6916abcfbfa53e243daafd652c6f629d4f73012"
+    },
     {
       "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`)
-- 446 operations across 68 resource groups
+- 449 operations across 68 resource groups
 
 ## Use it from your project
 

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

@@ -343,10 +343,16 @@ 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
       getCopyDeskPagesPageId: (args) => request("GET", "/copy-desk/pages/{pageId}", { hasBody: false }, args),
+      // POST /copy-desk/pages/{pageId}/asks — rank: any-builder — POST /copy-desk/pages/:pageId/asks
+      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),
       // 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,10 +342,16 @@ 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
       getCopyDeskPagesPageId: (args) => request("GET", "/copy-desk/pages/{pageId}", { hasBody: false }, args),
+      // POST /copy-desk/pages/{pageId}/asks — rank: any-builder — POST /copy-desk/pages/:pageId/asks
+      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),
       // 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

@@ -297,6 +297,7 @@ export interface PostCopyDeskFlagsIdCloseRequest { status: string; resolution_no
 export interface PostCopyDeskFlagsIdCloseResponse { ok: boolean; flag: unknown }
 export interface PostCopyDeskFlagsRequest { scope?: string; surface: string; string_id?: string; reason: string; kind?: string }
 export interface PostCopyDeskFlagsResponse { ok: boolean; flag: unknown }
+export interface PostCopyDeskPagesPageIdAsksRequest { reason: string }
 export interface PostCopyDeskProposalsRequest { string_id: string; proposed_text: string; why: string; file?: string; line?: number; flag_id?: number }
 export interface PostCopyDeskProposalsResponse { ok: boolean; task: unknown; created: boolean; patch?: unknown }
 export interface PostCostRequest { task_id?: number; amount_usd: number; category: string; description?: string; source?: string; source_ref?: string; recorded_at?: string; fresh_input_usd?: number; cache_read_usd?: number; cache_write_usd?: number; output_usd?: number; builder_id?: number; skill_name?: string }
@@ -759,10 +760,16 @@ 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 */
     getCopyDeskPagesPageId(args?: RequestArgs): Promise<ApiResponse>;
+    /** POST /copy-desk/pages/{pageId}/asks — rank: any-builder */
+    postCopyDeskPagesPageIdAsks(args: RequestArgs & { body: PostCopyDeskPagesPageIdAsksRequest }): Promise<ApiResponse>;
+    /** POST /copy-desk/pages/{pageId}/claim — rank: any-builder */
+    postCopyDeskPagesPageIdClaim(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,10 +339,16 @@ 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
       getCopyDeskPagesPageId: (args) => request("GET", "/copy-desk/pages/{pageId}", { hasBody: false }, args),
+      // POST /copy-desk/pages/{pageId}/asks — rank: any-builder — POST /copy-desk/pages/:pageId/asks
+      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),
       // 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",
@@ -5167,6 +5198,119 @@
         ]
       }
     },
+    "/copy-desk/pages/{pageId}/asks": {
+      "post": {
+        "operationId": "post_copy_desk_pages_pageId_asks",
+        "tags": [
+          "copy-desk"
+        ],
+        "summary": "POST /copy-desk/pages/:pageId/asks",
+        "description": "------------------------------------------------------------------------- POST /copy-desk/pages/:pageId/asks — ask for a page (task 1004317 / TW06, ADR 0341 D6). Body: { reason } — one line, the flag's own floor (10 characters). rank: any signed-in builder, any craft. A page ask is a copy_desk_flags row with scope 'page'; it carries a judgement and a page id, never text. 201 a new ask · 200 the caller's open ask on this page already (the first one comes back; a double ask is not a second signal) Both carry `askers`: distinct builders with an open ask on the page. -------------------------------------------------------------------------\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/PostCopyDeskPagesPageIdAsksRequest"
+              }
+            }
+          },
+          "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/pages/{pageId}/claim": {
+      "post": {
+        "operationId": "post_copy_desk_pages_pageId_claim",
+        "tags": [
+          "copy-desk"
+        ],
+        "summary": "POST /copy-desk/pages/:pageId/claim",
+        "description": "------------------------------------------------------------------------- POST /copy-desk/pages/:pageId/claim — claim a page's tweak (task 1004317 / BV2.TW06, ADR 0341 D2 and D5). Also Resume and \"Take next\". Body: {} (nothing — who claims is the session, what is claimed is the path). rank: any signed-in builder; the gate is the CRAFT, read server-side (builders.preferred_disciplines includes artist), never the request. One call finds the page's open round or creates it (source_ref page-tweak/<page_id>/r<n>, 30 credits, the building version's catch-all goal) and WEB-claims it: no worktree, no session. The lifecycle port runs it in one transaction under an advisory lock on the page, so two artists cannot both open a round. 201 created a new round, held by the caller 200 claimed an unheld round still being written (a draft released without submitting) taken over; the draft stays 200 resumed the caller already holds it 409 page_held another builder holds it; the holder is named 409 page_in_flight the round is past writing (submitted, applying, waiting for the artist, landing) 403 not_an_artist the caller's crafts do not include artist; they are offered the ask -------------------------------------------------------------------------\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",
@@ -24726,6 +24870,19 @@
           "flag"
         ]
       },
+      "PostCopyDeskPagesPageIdAsksRequest": {
+        "type": "object",
+        "properties": {
+          "reason": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "required": [
+          "reason"
+        ],
+        "additionalProperties": false
+      },
       "PostCopyDeskProposalsRequest": {
         "type": "object",
         "properties": {
@@ -28228,8 +28385,8 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 446,
-  "x-schema-count": 483,
+  "x-endpoint-count": 449,
+  "x-schema-count": 484,
   "x-undocumented-bodies": 9,
   "x-response-schemas": 331,
   "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. 446 endpoints across 76 route files.
+> **Generated from the live route files** — the route file is authoritative. 449 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,14 +210,17 @@ 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` (8)
+## `copy-desk` (11)
 
 | 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… |
 | 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/file-map.md

@@ -131,7 +131,7 @@
 │   ├── status-ui/              ← CORE-DOMAIN WEB-SURFACE carve (BV1.R84, default-on): the public status dashboard at status.<apex>, moved from public-status/. NO routes/db/port — declares contributes.webSurfaces:[{host:"status.",dir:"public"}], served by the loader web-surface seam (moduleWebSurfaces → serve-internal). CLAUDE.md, module.json, public/{index.html,status.js,style.css,cursors/,snapshots/}.
 │   ├── hall-ui/                ← CORE-DOMAIN WEB-SURFACE carve (BV1.R85, default-on): the authenticated builders' hall at builders.<apex>, moved from public-builders/ (~13k LOC, the largest). NO routes/db/port — declares contributes.webSurfaces:[{host:"builders.",dir:"public"}] for discovery, but UNLIKE status-ui keeps its DEDICATED serving block in serve-internal (the /builders shim + canonical redirects + citizen/Archon page gates + asset-stamping + hall-widget injection), partitioned out of the generic web-surface loop and served from BUILDERS_DIR. CLAUDE.md, module.json, records/ (one file per page family — what each family's redesign settled; CLAUDE.md points at them, and a new record is a new file there so concurrent hall tasks stop colliding on one insertion point, task 1003499), public/{index.html,builders.js,style.css,work,watch,gate,settings,ranks,sessions,primer,diagrams,atlas,...}.{html,js},cursors/,chime.wav. Four ARCHETYPE sheets sit beside the per-page ones: `record.css` (the task + idea records, task 1003305), `room.css` (the READING ROOMS — the primer + the diagrams index, task 1003306: the reading measure and rhythm, the table of contents, the progress hairline and the framed figure diagram-viewer.js upgrades on both pages), `oversight.css` (the OVERSIGHT family — government, watch, gate, task 1003469 (harbor was its fourth until task 1003890 removed the dev box): the row, the figure band inside a panel, the group head, the inline form, the grant toggle and the shared confirm modal; named oversight because the vocabulary wall bans "governance" on the government surface) and `panel.css` (the PANEL family — settings, profile, task 1003308 (pair was its third until task 1003890 removed the dev box): the row, the switch, the field with its label above, the chip control, the four voices and the sign-in gate; the hall's my-projects page was DELETED in the same task — "my projects" is the hub's user-level page, and the hall keeps no link or redirect; the family's fourth page `not-ready.html` was deleted by task 1003450, along with the emptied `requireNonXenosPage` gate that was the only thing redirecting to it). A page sheet then holds only what one page has and the others do not — `primer.css` the acknowledge gate, `diagrams.css` the legend strip, `gate.css` the hold reasons and file chips, `watch.css` the severities, the report reader and the grade trend, `settings.css` the rail layout, the group head, the token ladder and the voices grid, `profile.css` the identity band and the shelf, `roster.css` the Builders roster's identity cell (was `people.css`, shared with the cross-project `/people` directory until task 1003444 deleted that page — `/people` and its legacy door `/scouting` now 302 to `/roster`), `thinking.css` THE SKY's one sheet (task 1004231 / sky part 3 — `thinking.html` at `/thinking` is the prototype the owner adopted as the design of record, `docs/design/mocks/sky/`, built over `GET /sky` + `GET /sky/mine`; its script is the seven `sky-*.js` files on one shared `window.OTBSky`; it replaced THE ROOM of task 1004098, which survives as the list drawer, and the old `/sky` page, whose URL 301s here; `idea-objects.js` beside it is the shared five-object vocabulary).
 │   ├── lifecycle/               ← CORE-DOMAIN carve (BV1.R86, default-on): the build state machine — tasks · claims · versions · done-when · goals · dependencies · claim→ship→grade→credit · github-push + merge-lock + conflict-resolve + publish-reconciler. The LAST, most-coupled carve; registers the `lifecycle` kernel port (createTask, classifyTaskKind, tallyPeerVotes, work-tracking reads). CLAUDE.md, module.json, routes/{tasks,claims,versions,done-when,goals,dependencies,gate-approvals,analytics}.js, lifecycle.js, github-push.js, merge-lock.js, conflict-resolve.js, publish-reconciler.js, task-visuals.js + task-visual-db.js + routes/visuals.js (the optional ship-time visual, task 1003109 — the route file is NOT named task-*.js on purpose; see the module CLAUDE.md).
-│   ├── copy-desk/               ← CORE-DOMAIN module (task 1003113 / R02 of goal 1000074, default-on): the COPY half of the design contract — ADR 0081 gave design TOKENS a repo-owned source of truth, text had none. Owns the FLAG (anyone in any role marks a string or a whole surface as needing an artist's attention, with a reason required in BOTH the route and a CHECK constraint) and the QUEUE an artist reads it from. READS R01's committed registry (docs/copy-registry.json, generated by scripts/gds/copy-inventory.js) and never writes it. NO LIVE CMS is the hard non-goal: no column here could hold replacement text, and copy_no_cms.mjs pins that. Key is `copy-desk`, not `copy` — the branding contract already owns a `copy` block, so the bare word reds the "core carries no module code" fitness check. R03 (task 1003114, ADR 0233) added the PROPOSAL: an artist writes the replacement wording and it becomes a Bongos task carrying a fenced copy-proposal patch — no row, NO second migration (a proposals table is the forbidden column with extra steps), and scripts/gds/copy-apply.js lands it as a real diff under a claim. BV2.TW05 (task 1004316, ADR 0341 D8) added Tweak Mode's three derived READS — GET /copy-desk/pages, /copy-desk/pages/:pageId, /copy-desk/tally: page status and count, changelog, drift, "N of M tweaked" per surface, and the artist's tally — over the page-tweak tasks (lifecycle port), docs/page-inventory.json and docs/page-readings.json (both now in the publish manifest), with no status table. CLAUDE.md, module.json, registry.js, flags.js, proposals.js, pages.js (the page-tweak block format), page-status.js (the pure derivation), page-data.js (the page artifacts' read side), routes/copy-desk.js, migrations/copy_desk_001_flags.sql, tests/{copy_flags,copy_queue,copy_no_cms,copy_proposals,copy_page_status}.mjs + tests/fixtures/page-tweak.cjs. Its hall surface lives with hall-ui (public/copy-desk.{html,js,css}), per the one-key-per-web-surface precedent.
+│   ├── copy-desk/               ← CORE-DOMAIN module (task 1003113 / R02 of goal 1000074, default-on): the COPY half of the design contract — ADR 0081 gave design TOKENS a repo-owned source of truth, text had none. Owns the FLAG (anyone in any role marks a string or a whole surface as needing an artist's attention, with a reason required in BOTH the route and a CHECK constraint) and the QUEUE an artist reads it from. READS R01's committed registry (docs/copy-registry.json, generated by scripts/gds/copy-inventory.js) and never writes it. NO LIVE CMS is the hard non-goal: no column here could hold replacement text, and copy_no_cms.mjs pins that. Key is `copy-desk`, not `copy` — the branding contract already owns a `copy` block, so the bare word reds the "core carries no module code" fitness check. R03 (task 1003114, ADR 0233) added the PROPOSAL: an artist writes the replacement wording and it becomes a Bongos task carrying a fenced copy-proposal patch — no row, NO second migration (a proposals table is the forbidden column with extra steps), and scripts/gds/copy-apply.js lands it as a real diff under a claim. BV2.TW05 (task 1004316, ADR 0341 D8) added Tweak Mode's three derived READS — GET /copy-desk/pages, /copy-desk/pages/:pageId, /copy-desk/tally: page status and count, changelog, drift, "N of M tweaked" per surface, and the artist's tally — over the page-tweak tasks (lifecycle port), docs/page-inventory.json and docs/page-readings.json (both now in the publish manifest), with no status table. BV2.TW06 (task 1004317, ADR 0341 D2, D5, D6) added its first two page WRITES: POST /copy-desk/pages/:pageId/claim (an artist-craft builder opens or takes the page's tweak round as a web-claimed task, through the lifecycle port's webClaimPageTweak, under an advisory lock on the page) and POST /copy-desk/pages/:pageId/asks (anyone files a page ask, a copy_desk_flags row with scope 'page', added by copy_desk_002_page_asks.sql). CLAUDE.md, module.json, registry.js, flags.js, proposals.js, pages.js (the page-tweak block format), page-status.js (the pure derivation), page-data.js (the page artifacts' read side), routes/copy-desk.js, migrations/copy_desk_001_flags.sql, migrations/copy_desk_002_page_asks.sql, tests/{copy_flags,copy_queue,copy_no_cms,copy_proposals,copy_page_status}.mjs + tests/fixtures/page-tweak.cjs. Its hall surface lives with hall-ui (public/copy-desk.{html,js,css}), per the one-key-per-web-surface precedent.
 │   ├── npm-release/             ← the deploy page for a project that publishes an npm package from GitHub (task 1002622, default-OFF — on only in the Bongos hall, which publishes @bongos/core). "Where the work is": every task finished in the last 14 days, placed in the stage it has actually reached (not merged · merged, no version yet · published, not running here · running here, not released · released · in no version), plus the version history — each version's tasks. The version↔task join reads the release-notes.json the package itself carries (scripts/gds/release-notes.js writes it at pack time), streamed out of the NEWEST version's npm tarball in-process (no child process, no sync call) when the running core's own copy stops short. module.json, work.js (the reading + the stage placement — the packument, tarball stream and tar reader it uses are the core's src/bongos/package-registry.js, reached through the doorway's readPackageRegistry since task 1004296), routes/work.js (GET /npm-release/work, gated core.pin.move like the page), public/work.{js,css} (the two sections /deploy lends it: #nr-work, #nr-versions). Task 1004301 added the same line on a task's own page: routes/task-where.js (GET /npm-release/task/:id, any signed-in builder — it shows nothing not already public) + public/task-widget.js, injected into task.html by the loader's uiSections seam (hallWidgetScripts file task-widget.js) to fill #task-contrib on otb:task-shown. Tests sit at the repo root — tests/npm_release_{work,page}.mjs — because a default-off module's own tests/ is skipped by the unit runner.
 │   ├── ui-design/               ← CORE-DOMAIN module (task 1003324 / ADR 0197, default-on): the design capability every builder on every instance gets — ships METHOD, never a world. Absorbs ADR 0081's layer: adapters/{claude-design,figma}/index.js (moved from src/ui/adapters/), scripts/{design-sync,figma-design-sync,validate-design}.js (moved from scripts/gds/, which keeps thin shims), docs/design-contract.md (moved from docs/). Declaration-only: contributes.skills design (the /design playbook, new) + design-sync + figma-design-sync; no routes/port/migrations, so disabling it touches no served surface. CLAUDE.md separates the platform FLOORS (the Fifteen Rule, the dark twins, no page :root, the 24px floor, AA in both modes, the kill switch) from the instance's WORLD (its packs + DESIGN.md). kit/ (task 1003320) is the look-before-you-ship kit: lib.js (the floors, the states/probes contracts, the action + expectation vocabularies, the WCAG maths, the stub spawner), serve.js (any surface through the doorway's real transforms + fixtures/), render.js (states × 1440/390/320 × dark/light, audited), probe.js (PASS/FAIL contracts), check-mock.js (platform rules + the instance's DESIGN.md taste bans, then the detector), tells.js (task 1003329 / ADR 0223: the anti-pattern detector as two tiers — floors FAIL, craft tells WARN, kit-ignore waivers per file; the rendered twins live in lib.js factsInPage), contrast.js + png.js; a page's <page>.states.json / <page>.probes.json sit BESIDE the surface (modules/public-landing/public/, modules/hall-ui/public/). Recipe: docs/recipes/ui-look-before-you-ship.md. skills/ (task 1003321 / ADR 0198) is the vendoring policy: policy.json (licence allowlist, verdicts that may land, sidecar fields, preamble markers), PREAMBLE.md (the platform preamble every vendored SKILL.md opens with), README.md (the roster — both origins scanned dangerous on 2026-08-28, landed as rebuild specs; nothing vendored — and the landing recipe); a landable copy goes under skills/vendor/<name>/ with PROVENANCE.md + LICENSE and is materialised into an instance's .claude/skills/ by claude-materialize.js step 1b. skills/<name>/ (task 1003325 / ADR 0220) are the in-house rebuilds from the specs, first-party and counted: design-taste-frontend (the default taste skill), design-taste-frontend-v1 (the earlier generation, kept distinct), high-end-visual-design (the polish pass), redesign-existing-projects (the in-place upgrade); each opens with the same preamble and carries a "Rebuilt from" section instead of a sidecar. impeccable/ (task 1003326 / ADR 0221) is the design-craft method as ONE skill with sub-commands: SKILL.md (the router, the menu, the craft floor, the bounded finish) + reference/<sub-command>.md (eighteen playbooks, one loaded per request); no hooks, no bypass agent, no telemetry, no live server. minimalist-ui/, industrial-brutalist-ui/, gpt-taste/, stitch-design-taste/ (task 1003327 / ADR 0230) are the four looks, composition grammars with no colours of their own: the palette is the instance's pack and the texture is a named entry in styles/; a substrate is an archetype that still ships both modes, gpt-taste's selection is derived from the route rather than rolled, and stitch-design-taste writes a DESIGN.md-shaped contract document whose thirteen are transcribed from the pack. image-to-code/, imagegen-frontend-web/, imagegen-frontend-mobile/, brandkit/ (task 1003328 / ADR 0222) are the image family under the hero-only rule: plates and hero objects only, the pair (JPEG dark plate + WebP alpha cutout) with a <file>.json sidecar beside each, through the instance's art pipeline key; the grove specimen's styles/grove/assets/ is the worked example. style/ (task 1003475 / ADR 0231) is the module's first FIRST-PARTY skill (no upstream, so a `## First party` section instead of `## Rebuilt from`): the /style session in which an owner authors their own look in four bounded steps, rendering the nearest library entries before asking, drafting inside the contract, retuning by measurement, and handing over the one-step adoption without ever writing config/branding.json. styles/ (task 1003323 / ADR 0219) is the style library: <name>/pack.json (the theme.ui overlay, exactly the fifteen) + DESIGN.md (the look's derived recipes, thirteen in lockstep with the pack) + mock.html (the specimen); chrome-world (pinned to the neutral pack), expedition, grove, blueprint (the first cool look, authored through /style at task 1003475); STYLE=<name> on the kit lays a look over the instance's pack through GDS_BRANDING_FILE; tests/ui_design_styles.mjs runs the world/cosmos/hall token suites once per alternate (UI_DESIGN_PACK). config/design-tokens.* + design-sources.json STAY in config/ as the host boundary; public-landing keeps its own key (first customer, not owner).
 │   ├── character-anim/          ← consistent-character generative animation (ADR 0088) — graded painterly frame sets + manifest, the otb-character-review skill. CLAUDE.md, module.json.

package/docs/module-api-changelog.md

@@ -2603,5 +2603,9 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.19.1056 with no explicit bump. run 36387147130. (task 1002620)
   1.19.1058 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         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)
 ---------------------------------------------------------------------------
 ```