@bongos/core 1.24.16 → 1.24.18

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/bongos/package-core.js",
-  "core_version": "1.24.16",
-  "core_contract": "1.24.16",
-  "source_commit": "e8dbc5553383bc1a79bba1d5b54537e89ea25d12",
+  "core_version": "1.24.18",
+  "core_contract": "1.24.18",
+  "source_commit": "0ebf219ad01de6b8e9ed1b617c4fcf6857ebabbf",
   "source_ref": "HEAD",
-  "built_at": "2026-10-30T20:37:30.980Z",
+  "built_at": "2026-10-30T21:27:32.715Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 632,
     "agent_docs_stubbed": 32,
-    "functional_verbatim": 3798,
+    "functional_verbatim": 3802,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 4463,
-  "tree_sha256": "27ce12aa54042b2a48e3165cd44421d2ded0772dffbf4f47cdca60288614cc6a",
+  "file_count": 4467,
+  "tree_sha256": "c5ec1713b059cfb62f825c5ff39b3ebf934db4b9ef6bee93c174a99da1c999f1",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -332,12 +332,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "a2e94297703074317b5bceb88168c4d7c2caa79d4619b2dad16445a8eacd85e8"
+      "sha256": "93014d9ba68f4a28c1c23ca623762df541883df9201aad5ffdfd53bee22a0b8d"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "dee0d76f41a5c0449c9bb506287911470a78744370c225247eb80f74a049c7fe"
+      "sha256": "f4ef4c8a0d192356bcbf81a20d793ad368506a245f9b392d4654776fde6539f0"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -347,17 +347,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "4277b81ea894f709e793e1cc2b9080ca65ac2c50e383e994082c2af3a973d467"
+      "sha256": "fafbd80941536f67f85b55c5c250df1ed152398f30ebec2820d431c99676ffb3"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "01c06f818ea2709ec5af984a362306ae444e04911f8062712b8f02ff2f8f036d"
+      "sha256": "0e60eb71a4c912b79c2cac3bc338403883667da5c6f871ed811f21dec58d33f9"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "5fe1ff79bf2840651074640d90f9daab7db4455eddf1d2ace559589bc8b74f70"
+      "sha256": "68e375e1c32558fc6e442849bac87b2a82433d333bee255d3aeb0904b9c3f5a1"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2457,17 +2457,17 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "2eeb56594f7d73ba944f8154c1ad7dad95be7e3b3979298ca84607db0e3d5ee8"
+      "sha256": "57e77a6ffdbe2d558c088fce69e154b3b595b4d6d10b5053ad4ba0043cb00c46"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "8b51cc3fd37cd0cd371424ac821f84285f0e4fba5fc79a0efddb2ae92ca6bae4"
+      "sha256": "d2e12182597058030c086d3283f652f8d8e2b2e62900c9babed2eba71a97996a"
     },
     {
       "path": "docs/architecture.md",
       "mode": "0000644",
-      "sha256": "9aafe52bde706254b562411ff290104c0aa5dbe8a29e2e3e61fec89b2f3bb24c"
+      "sha256": "ac90efe1fecf89564c59896f69f6131923dfbfdc480f514af9e86802eb1041de"
     },
     {
       "path": "docs/branding-contract.md",
@@ -2487,12 +2487,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "59713d4b3b53edf02ccd29125effd2e677c83ecc6a6616064be5b53ed3ff6ce1"
+      "sha256": "e12823aa3c890a488a59b6e1fa098cbb527312c2d670b38f8aea1662bf6bbcd9"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "f87a88a59f03b3b33c85a18b5f325ea976539b6ddaccc4e5c3745a2e423862aa"
+      "sha256": "d72c6c9a078af32b7412c2ec8da6abe091d75251c2f0acd3c2dd7e44297e6198"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -3002,7 +3002,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "691f8ca91b557183307f411c12394ec8d9b69dfa3217032fd8c8278183444fe8"
+      "sha256": "f452287804538b6969ab460071c916397ba3ec34aa53231b18f30d52d3d00b7a"
     },
     {
       "path": "docs/modules-contract.md",
@@ -3092,7 +3092,7 @@
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "41a0a25a8eab0ac5e0885ef4bace2ff10af9187493703b6cb5f72d2ea2d542a0"
+      "sha256": "9470379d40e621c3a1dbb0bde781f96b3f13617f1ddec8a66202c7e0d5ef6ef7"
     },
     {
       "path": "docs/project-context.template.md",
@@ -4309,6 +4309,11 @@
       "mode": "0000644",
       "sha256": "e7be74430d0d9349b4f9820ff3f202ef03d8c28363fecbaa532c4b9c119e77ec"
     },
+    {
+      "path": "migrations/core_290_builder_payouts.sql",
+      "mode": "0000644",
+      "sha256": "6a8ca9343a4e7d9657baaadb89f42fe76f9354ce739d09ea51569d12e01d8706"
+    },
     {
       "path": "modules/agents/CLAUDE.md",
       "mode": "0000644",
@@ -4422,7 +4427,7 @@
     {
       "path": "modules/ai-studio/keys.js",
       "mode": "0000644",
-      "sha256": "a1b92a3661832537bedbbf5b5c8a111cef7398e928de71c6f631d5c4865f8b6c"
+      "sha256": "4fd7a7b6f9bf0ed8f0e5c73ce24101832b5b82a4fb47a997bb58409be747fcc4"
     },
     {
       "path": "modules/ai-studio/migrations/ai_studio_001_keys.sql",
@@ -4462,7 +4467,7 @@
     {
       "path": "modules/ai-studio/routes/ai-studio.js",
       "mode": "0000644",
-      "sha256": "dbd4a55ba9942cdbc0103b402d1081423cad23adf30725d03b370aa73261c56f"
+      "sha256": "4211cabb9b3923acc9d82bb0459efa6d2e2b4b115c9968927ec666a8115035ef"
     },
     {
       "path": "modules/ai-studio/studio.js",
@@ -5242,7 +5247,7 @@
     {
       "path": "modules/economy/module.json",
       "mode": "0000644",
-      "sha256": "b958458c140d149228f8ed40487f3e982466cf79be585691d4f1ffcbef13480d"
+      "sha256": "0c1dd2a3a6f467697bdd72443d05cc3f99ec51b2b4e6d2efdd2e0f57a03cf6c9"
     },
     {
       "path": "modules/economy/policy.js",
@@ -5287,7 +5292,7 @@
     {
       "path": "modules/economy/routes/project-account.js",
       "mode": "0000644",
-      "sha256": "d2a4dd604dd29ad6b0da1d7d8fadba423b6279fd46866512cd0cc4fbb37ad1cb"
+      "sha256": "1e61263bf8b0aaf2ad0e677fb4a57ab2c02888c296de4ca8fc76ccd2c135f235"
     },
     {
       "path": "modules/economy/routes/reward.js",
@@ -5877,7 +5882,7 @@
     {
       "path": "modules/hall-ui/public/ai-studio-lib.js",
       "mode": "0000644",
-      "sha256": "903ee8f348ac461d2c2e2712e110d17ef6e1fa25d0f89a3ad570d456b482bdff"
+      "sha256": "f845fd50a042a785b9ea06fb651ed55d459c2b7d631b19576199c6c641feed12"
     },
     {
       "path": "modules/hall-ui/public/ai-studio.css",
@@ -5892,7 +5897,7 @@
     {
       "path": "modules/hall-ui/public/ai-studio.js",
       "mode": "0000644",
-      "sha256": "70d9aee3ed9057f1460de3c8ff641396b28271186a7a980e1785061a675dbe4e"
+      "sha256": "67c9b6f4652a71357fc1f435637f14ed6725530c0544ca338a7b95e128bd7741"
     },
     {
       "path": "modules/hall-ui/public/ai-studio.states.json",
@@ -11692,12 +11697,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "2fdb487bbe1ef223f624f1aada21af2df70d420640eb77b4b61ce7995ad95424"
+      "sha256": "575055f35b185145ffef2a3568a1ac4547fb6fa2379d6e130d70563660fb25b8"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "93b9f649209897afd37554864ecd9f8372414a168191d11e3c8e9f14296cb593"
+      "sha256": "121c3e8f9ea0d45d23fcb52d5791b7e6524aac3ae9898f922d0c7b259e945b35"
     },
     {
       "path": "public-docs/index.html",
@@ -11717,7 +11722,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "f01ac97b1d814ccd53835a41a5a3a5feb2c091b8673f36b26b9138935c0009e5"
+      "sha256": "00b08004177af637f2afa9c9eb567146deaf53ad93d975965eeb99f86d3024d2"
     },
     {
       "path": "scripts/bongos/CLAUDE.md",
@@ -12947,7 +12952,7 @@
     {
       "path": "scripts/bongos/run-unit-tests.js",
       "mode": "0000644",
-      "sha256": "16b3277dc426f3bb2c7043d1c0b466b7db65c75a277c4e77864457152624cf2a"
+      "sha256": "52b452c7f022282371d0583561498737716103358ed8e010eb9734efe77f2e89"
     },
     {
       "path": "scripts/bongos/runner-drift.js",
@@ -15139,6 +15144,11 @@
       "mode": "0000644",
       "sha256": "f09f297371563a361002d1443414aa5ab65da36ad5e68bfadb634c659aeda6f3"
     },
+    {
+      "path": "src/bongos/builder-payouts.js",
+      "mode": "0000644",
+      "sha256": "b84ffb276778a5ddf018618c689b656c2d5d3a810af9e829dcb5fd20e6d6e81f"
+    },
     {
       "path": "src/bongos/cascade-dispatch.js",
       "mode": "0000644",
@@ -15492,7 +15502,7 @@
     {
       "path": "src/bongos/routes/payout-approvals.js",
       "mode": "0000644",
-      "sha256": "7528a05d03970ea359b8b15e8bdd2a8cc56835e3c867f7662f09b3adf38ea8d5"
+      "sha256": "5575f0616b45c78f57a8fa237ead916f3b04e4eae394f807603d7bf6cb53a912"
     },
     {
       "path": "src/bongos/routes/payout-gates.js",
@@ -15582,7 +15592,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "ac2f7155740717b05c1024991a25fd662afedd122eb15672126e2a75d82eb423"
+      "sha256": "8db80ccb2a1b60d7c647717b445dafeb381b0473e21b64da3ae780124f9afe4d"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -15852,7 +15862,7 @@
     {
       "path": "tests/ai_studio_generate.mjs",
       "mode": "0000644",
-      "sha256": "ee75867d1f3a45d0a06242b664f2d2f0829f34c586bcd883c04ac64eefc53dfd"
+      "sha256": "e4b659932669bd58e44a0216a5b1e8643a0961a60ecda9b695f9042b40fc3c4d"
     },
     {
       "path": "tests/ai_studio_keys.mjs",
@@ -16399,6 +16409,16 @@
       "mode": "0000644",
       "sha256": "2eecaaa02ad5d2cd8e25449d66dc86aa1884278dbf72656c0d9401129034e247"
     },
+    {
+      "path": "tests/builder_payouts.mjs",
+      "mode": "0000644",
+      "sha256": "45d49e84f826115c43bf9f01a42eae4ee70ffe26fdc02acf303b345c9850d397"
+    },
+    {
+      "path": "tests/builder_payouts_db.mjs",
+      "mode": "0000644",
+      "sha256": "1676f0b2452e0d834df2b49974d4699f918e223e56d2f4193ffe87339b6f1f4a"
+    },
     {
       "path": "tests/builder_tester_tag.mjs",
       "mode": "0000644",
@@ -18292,7 +18312,7 @@
     {
       "path": "tests/hall_ai_studio.mjs",
       "mode": "0000644",
-      "sha256": "5b027b4922f78764d8d1222763e4aca31cc2d43895f616e37b35d018ca5188a2"
+      "sha256": "e4c7673b57e03ce15eade36932ac02efdceb06101c53f673d8978e35de22cb33"
     },
     {
       "path": "tests/hall_approval_queue.mjs",

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`)
-- 657 operations across 83 resource groups
+- 659 operations across 83 resource groups
 
 ## Use it from your project
 

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

@@ -1037,6 +1037,10 @@ function createClient(opts = {}) {
       getPayoutsApprovals: (args) => request("GET", "/payouts/approvals", { hasBody: false }, args),
       // POST /payouts/approve — rank: archon — POST /payouts/approve
       postPayoutsApprove: (args) => request("POST", "/payouts/approve", { hasBody: true }, args),
+      // GET /payouts/builder-payouts — rank: archon — GET /payouts/builder-payouts
+      getPayoutsBuilderPayouts: (args) => request("GET", "/payouts/builder-payouts", { hasBody: false }, args),
+      // POST /payouts/builder-payouts — rank: archon — POST /payouts/builder-payouts
+      postPayoutsBuilderPayouts: (args) => request("POST", "/payouts/builder-payouts", { hasBody: true }, args),
       // POST /payouts/contracts — rank: archon — POST /payouts/contracts
       postPayoutsContracts: (args) => request("POST", "/payouts/contracts", { hasBody: true }, args),
       // POST /payouts/freezes — rank: archon — POST /payouts/freezes

package/clients/bongos-client/index.cjs

@@ -1036,6 +1036,10 @@ function createClient(opts = {}) {
       getPayoutsApprovals: (args) => request("GET", "/payouts/approvals", { hasBody: false }, args),
       // POST /payouts/approve — rank: archon — POST /payouts/approve
       postPayoutsApprove: (args) => request("POST", "/payouts/approve", { hasBody: true }, args),
+      // GET /payouts/builder-payouts — rank: archon — GET /payouts/builder-payouts
+      getPayoutsBuilderPayouts: (args) => request("GET", "/payouts/builder-payouts", { hasBody: false }, args),
+      // POST /payouts/builder-payouts — rank: archon — POST /payouts/builder-payouts
+      postPayoutsBuilderPayouts: (args) => request("POST", "/payouts/builder-payouts", { hasBody: true }, args),
       // POST /payouts/contracts — rank: archon — POST /payouts/contracts
       postPayoutsContracts: (args) => request("POST", "/payouts/contracts", { hasBody: true }, args),
       // POST /payouts/freezes — rank: archon — POST /payouts/freezes

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

@@ -144,6 +144,7 @@ export interface GetPageNotesSiteResponse { notes: unknown }
 export interface GetPayTermsResponse { pay_terms: unknown }
 export interface GetPayTypeGatesResponse { gates: unknown }
 export interface GetPayoutsApprovalsResponse { approvals: unknown }
+export interface GetPayoutsBuilderPayoutsResponse { payouts: unknown; page: PageInfo }
 export interface GetPayoutsGatesBuilderIdResponse { gate: unknown }
 export interface GetPayoutsRulesResponse { rules: unknown }
 export interface GetProfilesHandleResponse { account: unknown; cross_project: unknown }
@@ -303,7 +304,7 @@ export interface PostAgentsNameEnableResponse { ok: boolean; agent: unknown }
 export interface PostAgentsNameInvokeRequest { input?: string }
 export interface PostAgentsNameInvokeResponse { ok: boolean; run_id: unknown; poll: unknown; message: unknown }
 export interface PostAgentsResponse { ok: boolean; agent: unknown }
-export interface PostAiStudioRequestsRequest { prompt: string; file_ids: unknown[]; pay_with?: "own" | "ours" }
+export interface PostAiStudioRequestsRequest { prompt: string; file_ids: unknown[]; pay_with?: "own" | "ours" | "openrouter" | "gemini" }
 export interface PostAiStudioRequestsResponse { request: unknown }
 export interface PostAiStudioTopupRequest { amount_usd: number }
 export interface PostAiStudioTopupResponse { topup: unknown; balance: unknown }
@@ -534,6 +535,7 @@ export interface PostPayoutsAgeRecordsRequest { builder_id: StringifiableId; tie
 export interface PostPayoutsAgeRecordsResponse { record: unknown }
 export interface PostPayoutsApproveRequest { recipient_id?: StringifiableId; amount_cents?: unknown; currency?: unknown; note?: unknown }
 export interface PostPayoutsApproveResponse { approval: unknown }
+export interface PostPayoutsBuilderPayoutsRequest { approval_id: StringifiableId; task_id: StringifiableId }
 export interface PostPayoutsFreezesIdDecideRequest { decision: unknown; statement: unknown }
 export interface PostPayoutsFreezesIdDecideResponse { event: unknown }
 export interface PostPayoutsFreezesRequest { builder_id: StringifiableId; notice_text: unknown; owed_cents?: unknown }
@@ -1675,6 +1677,10 @@ export interface BongosClient {
     getPayoutsApprovals(args?: RequestArgs): Promise<GetPayoutsApprovalsResponse>;
     /** POST /payouts/approve — rank: archon */
     postPayoutsApprove(args?: RequestArgs & { body?: PostPayoutsApproveRequest }): Promise<PostPayoutsApproveResponse>;
+    /** GET /payouts/builder-payouts — rank: archon */
+    getPayoutsBuilderPayouts(args?: RequestArgs): Promise<GetPayoutsBuilderPayoutsResponse>;
+    /** POST /payouts/builder-payouts — rank: archon */
+    postPayoutsBuilderPayouts(args: RequestArgs & { body: PostPayoutsBuilderPayoutsRequest }): Promise<ApiResponse>;
     /** POST /payouts/contracts — rank: archon */
     postPayoutsContracts(args?: RequestArgs): Promise<ApiResponse>;
     /** POST /payouts/freezes — rank: archon */

package/clients/bongos-client/index.mjs

@@ -1033,6 +1033,10 @@ export function createClient(opts = {}) {
       getPayoutsApprovals: (args) => request("GET", "/payouts/approvals", { hasBody: false }, args),
       // POST /payouts/approve — rank: archon — POST /payouts/approve
       postPayoutsApprove: (args) => request("POST", "/payouts/approve", { hasBody: true }, args),
+      // GET /payouts/builder-payouts — rank: archon — GET /payouts/builder-payouts
+      getPayoutsBuilderPayouts: (args) => request("GET", "/payouts/builder-payouts", { hasBody: false }, args),
+      // POST /payouts/builder-payouts — rank: archon — POST /payouts/builder-payouts
+      postPayoutsBuilderPayouts: (args) => request("POST", "/payouts/builder-payouts", { hasBody: true }, args),
       // POST /payouts/contracts — rank: archon — POST /payouts/contracts
       postPayoutsContracts: (args) => request("POST", "/payouts/contracts", { hasBody: true }, args),
       // POST /payouts/freezes — rank: archon — POST /payouts/freezes

package/docs/api/openapi.json

@@ -19595,6 +19595,90 @@
         ]
       }
     },
+    "/payouts/builder-payouts": {
+      "get": {
+        "operationId": "get_payouts_builder_payouts",
+        "tags": [
+          "payouts"
+        ],
+        "summary": "GET /payouts/builder-payouts",
+        "description": "GET /api/bongos/payouts/builder-payouts — every builder payout and where it stands (task 1003183, M04): paid, or owed with its latest try and the reason in words.\n\n**Rank:** `archon` — Archon only (rank and identity management + the escalation keys — the trust boundary).\n\n**Permissions:** `payout.approve` (all required).",
+        "x-rank": "archon",
+        "x-source": "src/bongos/routes/payout-approvals.js",
+        "x-permissions": [
+          "payout.approve"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetPayoutsBuilderPayoutsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      },
+      "post": {
+        "operationId": "post_payouts_builder_payouts",
+        "tags": [
+          "payouts"
+        ],
+        "summary": "POST /payouts/builder-payouts",
+        "description": "POST /api/bongos/payouts/builder-payouts — send ONE approved payout for ONE task (task 1003183, M04). Body: { approval_id, task_id }. The person and the amount come from the approval, never the body. A person presses it on the website: the approval says what may be paid, and this is the person sending it (Art. I). Pressing again is safe: a paid task answers paid, an owed one retries with the same processor key.\n\n**Rank:** `archon` — Archon only (rank and identity management + the escalation keys — the trust boundary).\n\n**Permissions:** `payout.approve` (all required).",
+        "x-rank": "archon",
+        "x-source": "src/bongos/routes/payout-approvals.js",
+        "x-permissions": [
+          "payout.approve"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostPayoutsBuilderPayoutsRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/payouts/contracts": {
       "post": {
         "operationId": "post_payouts_contracts",
@@ -32569,6 +32653,19 @@
           "approvals"
         ]
       },
+      "GetPayoutsBuilderPayoutsResponse": {
+        "type": "object",
+        "properties": {
+          "payouts": {},
+          "page": {
+            "$ref": "#/components/schemas/PageInfo"
+          }
+        },
+        "required": [
+          "payouts",
+          "page"
+        ]
+      },
       "GetPayoutsGatesBuilderIdResponse": {
         "type": "object",
         "properties": {
@@ -34768,7 +34865,9 @@
             "type": "string",
             "enum": [
               "own",
-              "ours"
+              "ours",
+              "openrouter",
+              "gemini"
             ]
           }
         },
@@ -38570,6 +38669,22 @@
           "approval"
         ]
       },
+      "PostPayoutsBuilderPayoutsRequest": {
+        "type": "object",
+        "properties": {
+          "approval_id": {
+            "$ref": "#/components/schemas/StringifiableId"
+          },
+          "task_id": {
+            "$ref": "#/components/schemas/StringifiableId"
+          }
+        },
+        "required": [
+          "approval_id",
+          "task_id"
+        ],
+        "additionalProperties": false
+      },
       "PostPayoutsFreezesIdDecideRequest": {
         "type": "object",
         "properties": {
@@ -41642,9 +41757,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 657,
-  "x-schema-count": 705,
+  "x-endpoint-count": 659,
+  "x-schema-count": 707,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 451,
+  "x-response-schemas": 452,
   "x-generated-by": "scripts/bongos/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. 657 endpoints across 111 route files.
+> **Generated from the live route files** — the route file is authoritative. 659 endpoints across 111 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`.
@@ -708,13 +708,15 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/pay-type-gates` | `any-builder` | — | for met/missing (the same pay information `GET /pay-terms` shows, no person's money); the evidence references and who cleared each requir… |
 | PUT | `/api/bongos/pay-type-gates/:payType/:requirement` | `archon` | `state`, `evidence_ref`, `acknowledged` | .approve (archon floor). |
 
-## `payouts` (16)
+## `payouts` (18)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
 | POST | `/api/bongos/payouts/age-records` | `archon` | `builder_id`, `tier` | POST /api/bongos/payouts/age-records — record a builder's age tier, verified by a person. |
 | GET | `/api/bongos/payouts/approvals` | `archon` | — | GET /api/bongos/payouts/approvals — the log, newest first. |
 | POST | `/api/bongos/payouts/approve` | `archon` | `recipient_id`, `amount_cents`, `currency`, `note` | POST /api/bongos/payouts/approve — approve ONE payout. |
+| GET | `/api/bongos/payouts/builder-payouts` | `archon` | — | GET /api/bongos/payouts/builder-payouts — every builder payout and where it stands (task 1003183, M04): paid, or owed with its latest try… |
+| POST | `/api/bongos/payouts/builder-payouts` | `archon` | `approval_id`, `task_id` | POST /api/bongos/payouts/builder-payouts — send ONE approved payout for ONE task (task 1003183, M04). |
 | POST | `/api/bongos/payouts/contracts` | `archon` | — | POST /api/bongos/payouts/contracts — sign ONE contract. |
 | POST | `/api/bongos/payouts/freezes` | `archon` | `builder_id`, `notice_text`, `owed_cents` | POST /api/bongos/payouts/freezes — a person freezes a builder's payouts by hand. |
 | POST | `/api/bongos/payouts/freezes/:id/decide` | `archon` | `decision`, `statement` | POST /api/bongos/payouts/freezes/:id/decide — uphold or lift a freeze, with the reason the person will read. |

package/docs/architecture.md

@@ -308,6 +308,21 @@ payout_guardian_cosigns(id, builder_id, guardian_id, approval_id | rule_id+run_k
               -- and a co-signature by anyone but the current guardian.
 ```
 
+Builder payouts (migration `core_290`, task 1003183, [ADR 0397](adr/0397-the-payment-rail-is-stripe-connect-with-one-connected-account-per-project.md) D7 — a builder is paid for a task exactly once; `src/bongos/builder-payouts.js`, routes `GET`/`POST /payouts/builder-payouts` gated `payout.approve` plus the person's own web session for the POST; the `payout` movement is booked through the economy module's `economy.account` port in the same transaction. No processor adapter exists yet, so every payout is recorded owed and held `no_processor`):
+
+```
+builder_payouts_owed(id, builder_id FK, task_id FK, approval_id FK payout_approvals,
+              amount_cents, currency, recorded_by FK, created_at)
+              -- written BEFORE anything is sent; UNIQUE (builder_id, task_id) and UNIQUE
+              -- (approval_id): a task is paid once, an approval pays one task.
+builder_payout_attempts(id, owed_id FK, outcome sent|failed|held, processor_ref, reason,
+              actor_id, created_at)
+              -- at most one `sent` per debt (partial UNIQUE); sent needs processor_ref,
+              -- failed/held need a reason. BOTH APPEND-ONLY by trigger. The processor is
+              -- called with idempotency key `bongos-payout-<owed id>`, so a retry after an
+              -- unknown outcome gets the same transfer back.
+```
+
 Store sub-categories (migration `core_280`, task 1004355, [ADR 0342](adr/0342-module-categories-are-eight-parents-with-approved-sub-categories.md) D3 — an author proposes one at publish, a Metic+ person approves, renames or merges it; `src/bongos/module-subcategories.js`):
 
 ```

package/docs/copy-inventory.md

@@ -4,13 +4,13 @@
 > Deterministic on a given tree — regenerate and commit rather than hand-editing.
 > Machine-readable twin: [`copy-registry.json`](copy-registry.json).
 
-**3278 strings** across 3 surfaces · 2595 distinct pieces of copy · 3278 certain, 0 heuristic · 275 shown in more than one place.
+**3276 strings** across 3 surfaces · 2593 distinct pieces of copy · 3276 certain, 0 heuristic · 275 shown in more than one place.
 
 ## Surfaces
 
 | surface | lives at | files | strings |
 |---|---|---|---|
-| `builders-hall` | `modules/hall-ui/public` | 172 | 2165 |
+| `builders-hall` | `modules/hall-ui/public` | 172 | 2163 |
 | `status-dashboard` | `modules/status-ui/public` | 4 | 91 |
 | `landing` | `modules/public-landing/public` | 10 | 1022 |
 
@@ -78,7 +78,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `72a29648399b` | 4x | Tweak a page | modules/hall-ui/public/tweak-editor.html:32, modules/hall-ui/public/tweak-editor.html:32, modules/hall-ui/public/tweak-editor.html:55 |
 | … | | _235 more in the JSON registry_ | |
 
-## `builders-hall` — 2165 strings
+## `builders-hall` — 2163 strings
 
 | id | conf | text | where |
 |---|---|---|---|
@@ -581,7 +581,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `94c68a78cd89` | certain | Follow a route from a goal you know to reach it — or turn explore off to see everything. | `modules/hall-ui/public/sky-interaction.js:35` |
 | `d5d7bad187ac` | certain | For a criterion with nothing to see on screen: it will be signed off without a recording | `modules/hall-ui/public/criterion-uat-ui.js:88` |
 | `3001bd688837` | certain | Founding builders | `modules/hall-ui/public/ranks.html:40` |
-| `e9a1af5dc515` | certain | Free here. {…} bills you for it directly. | `modules/hall-ui/public/ai-studio.js:334` |
+| `e9a1af5dc515` | certain | Free here. {…} bills you for it directly. | `modules/hall-ui/public/ai-studio.js:336` |
 | `36ecb5d3686c` | certain | Fresh CLI token issued. Paste this into a terminal in your project folder: | `modules/hall-ui/public/settings.js:800` |
 | `55c71d76a94c` | certain | From creation to production — and the exact step where {{currency}} are awarded (at | `modules/hall-ui/public/diagrams.html:49` |
 | `edced5d528c3` | certain | From the live site | `modules/hall-ui/public/studio.html:155` |
@@ -860,7 +860,6 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `b5839a34590c` | certain | My agents — {{worldName}} | `modules/hall-ui/public/my-agents.html:6` |
 | `b5839a34590c` | certain | My agents — {{worldName}} | `modules/hall-ui/public/my-agents.html:6` |
 | `39afdc03594a` | certain | My balance | `modules/hall-ui/public/ai-studio.js:340` |
-| `b7d4eeb3f762` | certain | My own key | `modules/hall-ui/public/ai-studio.js:334` |
 | `3d0d554cd684` | certain | Name (optional) | `modules/hall-ui/public/gate.js:201` |
 | `ae84ebe1d735` | certain | Name cannot be blank. | `modules/hall-ui/public/settings.js:649` |
 | `31e91ee6ce03` | certain | Name must be {…} characters or fewer. | `modules/hall-ui/public/settings.js:654` |
@@ -2137,7 +2136,6 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `cf89ac85440d` | certain | {…} earned | `modules/hall-ui/public/goals-render.js:821` |
 | `55b949873848` | certain | {…} is in. | `modules/hall-ui/public/tweak-editor.js:578` |
 | `80b4aa799a4b` | certain | {…} is writing this page now. You can read it, download it, or take another page from the studio. | `modules/hall-ui/public/tweak-editor.js:329` |
-| `c80c3434ae36` | certain | {…} key ending {…} | `modules/hall-ui/public/ai-studio.js:334` |
 | `5ad81ff61920` | certain | {…} lands in your balance; your card is charged {…}. | `modules/hall-ui/public/ai-studio.js:579` |
 | `92b79edf21f6` | certain | {…} left | `modules/hall-ui/public/market-watch.js:73` |
 | `830d2be6f859` | certain | {…} line | `modules/hall-ui/public/tweak-editor.js:235` |