@bongos/core 1.24.10 → 1.24.12

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`)
-- 647 operations across 80 resource groups
+- 652 operations across 81 resource groups
 
 ## Use it from your project
 

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

@@ -763,6 +763,12 @@ function createClient(opts = {}) {
       getMarketWatchAsk: (args) => request("GET", "/market-watch/ask", { hasBody: false }, args),
       // POST /market-watch/ask/answer — rank: any-builder — POST /market-watch/ask/answer
       postMarketWatchAskAnswer: (args) => request("POST", "/market-watch/ask/answer", { hasBody: true }, args),
+      // GET /market-watch/home — rank: any-builder — GET /market-watch/home
+      getMarketWatchHome: (args) => request("GET", "/market-watch/home", { hasBody: false }, args),
+      // GET /market-watch/items/{id} — rank: any-builder — GET /market-watch/items/:id
+      getMarketWatchItemsId: (args) => request("GET", "/market-watch/items/{id}", { hasBody: false }, args),
+      // POST /market-watch/proposals — rank: any-builder — POST /market-watch/proposals
+      postMarketWatchProposals: (args) => request("POST", "/market-watch/proposals", { hasBody: true }, args),
       // POST /market-watch/proposals/{id}/decide — rank: any-builder — POST /market-watch/proposals/:id/decide
       postMarketWatchProposalsIdDecide: (args) => request("POST", "/market-watch/proposals/{id}/decide", { hasBody: true }, args),
       // POST /market-watch/proposals/{id}/vote — rank: metic+archon — POST /market-watch/proposals/:id/vote
@@ -1012,6 +1018,10 @@ function createClient(opts = {}) {
       // GET /page-notes/site — rank: any-builder — GET /page-notes/site
       getPageNotesSite: (args) => request("GET", "/page-notes/site", { hasBody: false }, args),
     },
+    "payTerms": {
+      // GET /pay-terms — rank: any-builder — GET /pay-terms
+      getPayTerms: (args) => request("GET", "/pay-terms", { hasBody: false }, args),
+    },
     "payouts": {
       // POST /payouts/age-records — rank: archon — POST /payouts/age-records
       postPayoutsAgeRecords: (args) => request("POST", "/payouts/age-records", { hasBody: true }, args),
@@ -1057,6 +1067,8 @@ function createClient(opts = {}) {
     "projectSettings": {
       // GET /project-settings — rank: metic+archon — GET /project-settings
       getProjectSettings: (args) => request("GET", "/project-settings", { hasBody: false }, args),
+      // PATCH /project-settings/pay-terms — rank: metic+archon — PATCH /project-settings/pay-terms
+      patchProjectSettingsPayTerms: (args) => request("PATCH", "/project-settings/pay-terms", { hasBody: true }, args),
       // PATCH /project-settings/rot-days — rank: metic+archon — PATCH /project-settings/rot-days
       patchProjectSettingsRotDays: (args) => request("PATCH", "/project-settings/rot-days", { hasBody: true }, args),
       // GET /project-settings/ship-mode — rank: any-builder — GET /project-settings/ship-mode

package/clients/bongos-client/index.cjs

@@ -762,6 +762,12 @@ function createClient(opts = {}) {
       getMarketWatchAsk: (args) => request("GET", "/market-watch/ask", { hasBody: false }, args),
       // POST /market-watch/ask/answer — rank: any-builder — POST /market-watch/ask/answer
       postMarketWatchAskAnswer: (args) => request("POST", "/market-watch/ask/answer", { hasBody: true }, args),
+      // GET /market-watch/home — rank: any-builder — GET /market-watch/home
+      getMarketWatchHome: (args) => request("GET", "/market-watch/home", { hasBody: false }, args),
+      // GET /market-watch/items/{id} — rank: any-builder — GET /market-watch/items/:id
+      getMarketWatchItemsId: (args) => request("GET", "/market-watch/items/{id}", { hasBody: false }, args),
+      // POST /market-watch/proposals — rank: any-builder — POST /market-watch/proposals
+      postMarketWatchProposals: (args) => request("POST", "/market-watch/proposals", { hasBody: true }, args),
       // POST /market-watch/proposals/{id}/decide — rank: any-builder — POST /market-watch/proposals/:id/decide
       postMarketWatchProposalsIdDecide: (args) => request("POST", "/market-watch/proposals/{id}/decide", { hasBody: true }, args),
       // POST /market-watch/proposals/{id}/vote — rank: metic+archon — POST /market-watch/proposals/:id/vote
@@ -1011,6 +1017,10 @@ function createClient(opts = {}) {
       // GET /page-notes/site — rank: any-builder — GET /page-notes/site
       getPageNotesSite: (args) => request("GET", "/page-notes/site", { hasBody: false }, args),
     },
+    "payTerms": {
+      // GET /pay-terms — rank: any-builder — GET /pay-terms
+      getPayTerms: (args) => request("GET", "/pay-terms", { hasBody: false }, args),
+    },
     "payouts": {
       // POST /payouts/age-records — rank: archon — POST /payouts/age-records
       postPayoutsAgeRecords: (args) => request("POST", "/payouts/age-records", { hasBody: true }, args),
@@ -1056,6 +1066,8 @@ function createClient(opts = {}) {
     "projectSettings": {
       // GET /project-settings — rank: metic+archon — GET /project-settings
       getProjectSettings: (args) => request("GET", "/project-settings", { hasBody: false }, args),
+      // PATCH /project-settings/pay-terms — rank: metic+archon — PATCH /project-settings/pay-terms
+      patchProjectSettingsPayTerms: (args) => request("PATCH", "/project-settings/pay-terms", { hasBody: true }, args),
       // PATCH /project-settings/rot-days — rank: metic+archon — PATCH /project-settings/rot-days
       patchProjectSettingsRotDays: (args) => request("PATCH", "/project-settings/rot-days", { hasBody: true }, args),
       // GET /project-settings/ship-mode — rank: any-builder — GET /project-settings/ship-mode

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

@@ -141,6 +141,7 @@ export interface GetPageNotesIdResponse { note: unknown; images: unknown; ideas:
 export interface GetPageNotesIdeasResponse { page_path: unknown; ideas: unknown }
 export interface GetPageNotesResponse { page_id: unknown; notes: unknown }
 export interface GetPageNotesSiteResponse { notes: unknown }
+export interface GetPayTermsResponse { pay_terms: unknown }
 export interface GetPayoutsApprovalsResponse { approvals: unknown }
 export interface GetPayoutsGatesBuilderIdResponse { gate: unknown }
 export interface GetPayoutsRulesResponse { rules: unknown }
@@ -264,6 +265,8 @@ export interface PatchNotesIdRequest { kind: string }
 export interface PatchNotesIdResponse { ok: boolean; note: unknown }
 export interface PatchPageNotesIdRequest { body_md: string }
 export interface PatchPageNotesIdResponse { ok: boolean; updated_at: unknown }
+export interface PatchProjectSettingsPayTermsRequest { terms: unknown }
+export interface PatchProjectSettingsPayTermsResponse { ok: boolean; row: unknown }
 export interface PatchProjectSettingsRotDaysRequest { days: number }
 export interface PatchProjectSettingsRotDaysResponse { ok: boolean; rot_days: unknown; source: unknown; describe: unknown }
 export interface PatchProjectSettingsShipModeRequest { mode: string }
@@ -285,7 +288,7 @@ export interface PatchSpecialitiesIdRequest { name?: string; summary?: string; c
 export interface PatchSpecialitiesIdResponse { speciality: unknown }
 export interface PatchTaskRecommendationsIdRequest { status: "declined" | "withdrawn" }
 export interface PatchTaskRecommendationsIdResponse { ok: boolean; recommendation: unknown }
-export interface PatchTasksIdRequest { kind?: string; discipline?: string; requires_rank?: string; module_key?: string; goal_id?: number; parent_task_id?: StringifiableId; parallel_safe?: unknown; newcomer_friendly?: boolean; xenos_claimable?: boolean; security_sensitive?: boolean; automation_tag?: string; needs?: unknown; needs_migration?: boolean; description?: string; title?: string; priority?: unknown; value_summary?: string; status?: unknown }
+export interface PatchTasksIdRequest { kind?: string; discipline?: string; requires_rank?: string; module_key?: string; goal_id?: number; parent_task_id?: StringifiableId; parallel_safe?: unknown; newcomer_friendly?: boolean; xenos_claimable?: boolean; security_sensitive?: boolean; automation_tag?: string; needs?: unknown; needs_migration?: boolean; description?: string; title?: string; priority?: unknown; value_summary?: string; status?: unknown; pay_terms?: unknown }
 export interface PostAccessRequestsInviteRequest { github_login: string; note?: string }
 export interface PostAccessRequestsInviteResponse { ok: boolean; already_invited?: boolean; github_login?: unknown; request?: unknown }
 export interface PostAccessRequestsRequest { github_login: string; display_name?: string; note?: string }
@@ -467,6 +470,8 @@ export interface PostLlmCacheStoreResponse { stored: boolean; result_cost_usd?:
 export interface PostMarketWatchAskAnswerRequest { week_of?: string; picks?: unknown[]; names?: unknown[]; nothing?: boolean; builder_id?: number }
 export interface PostMarketWatchProposalsIdDecideRequest { decision: "approve" | "decline" }
 export interface PostMarketWatchProposalsIdVoteResponse { ok: boolean; matter_id: unknown; item_id: unknown }
+export interface PostMarketWatchProposalsRequest { kind: string; reason?: string; item_id?: StringifiableId; dimension?: string; value?: unknown; url?: string; log_entry_id?: StringifiableId; scout?: string; name?: string }
+export interface PostMarketWatchProposalsResponse { proposal: unknown }
 export interface PostMarketWatchRulesProposalsRequest { step: string; change: Record<string, unknown>; reason: string }
 export interface PostMarketWatchRulesProposalsResponse { ok: boolean; proposal: unknown }
 export interface PostMeAnthropicLinkRequest { anthropic_email: string; anthropic_user_id: string }
@@ -1389,6 +1394,12 @@ export interface BongosClient {
     getMarketWatchAsk(args?: RequestArgs): Promise<GetMarketWatchAskResponse>;
     /** POST /market-watch/ask/answer — rank: any-builder */
     postMarketWatchAskAnswer(args?: RequestArgs & { body?: PostMarketWatchAskAnswerRequest }): Promise<ApiResponse>;
+    /** GET /market-watch/home — rank: any-builder */
+    getMarketWatchHome(args?: RequestArgs): Promise<ApiResponse>;
+    /** GET /market-watch/items/{id} — rank: any-builder */
+    getMarketWatchItemsId(args?: RequestArgs): Promise<ApiResponse>;
+    /** POST /market-watch/proposals — rank: any-builder */
+    postMarketWatchProposals(args: RequestArgs & { body: PostMarketWatchProposalsRequest }): Promise<PostMarketWatchProposalsResponse>;
     /** POST /market-watch/proposals/{id}/decide — rank: any-builder */
     postMarketWatchProposalsIdDecide(args: RequestArgs & { body: PostMarketWatchProposalsIdDecideRequest }): Promise<ApiResponse>;
     /** POST /market-watch/proposals/{id}/vote — rank: metic+archon */
@@ -1638,6 +1649,10 @@ export interface BongosClient {
     /** GET /page-notes/site — rank: any-builder */
     getPageNotesSite(args?: RequestArgs): Promise<GetPageNotesSiteResponse>;
   };
+  "payTerms": {
+    /** GET /pay-terms — rank: any-builder */
+    getPayTerms(args?: RequestArgs): Promise<GetPayTermsResponse>;
+  };
   "payouts": {
     /** POST /payouts/age-records — rank: archon */
     postPayoutsAgeRecords(args: RequestArgs & { body: PostPayoutsAgeRecordsRequest }): Promise<PostPayoutsAgeRecordsResponse>;
@@ -1683,6 +1698,8 @@ export interface BongosClient {
   "projectSettings": {
     /** GET /project-settings — rank: metic+archon */
     getProjectSettings(args?: RequestArgs): Promise<GetProjectSettingsResponse>;
+    /** PATCH /project-settings/pay-terms — rank: metic+archon */
+    patchProjectSettingsPayTerms(args: RequestArgs & { body: PatchProjectSettingsPayTermsRequest }): Promise<PatchProjectSettingsPayTermsResponse>;
     /** PATCH /project-settings/rot-days — rank: metic+archon */
     patchProjectSettingsRotDays(args: RequestArgs & { body: PatchProjectSettingsRotDaysRequest }): Promise<PatchProjectSettingsRotDaysResponse>;
     /** GET /project-settings/ship-mode — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -759,6 +759,12 @@ export function createClient(opts = {}) {
       getMarketWatchAsk: (args) => request("GET", "/market-watch/ask", { hasBody: false }, args),
       // POST /market-watch/ask/answer — rank: any-builder — POST /market-watch/ask/answer
       postMarketWatchAskAnswer: (args) => request("POST", "/market-watch/ask/answer", { hasBody: true }, args),
+      // GET /market-watch/home — rank: any-builder — GET /market-watch/home
+      getMarketWatchHome: (args) => request("GET", "/market-watch/home", { hasBody: false }, args),
+      // GET /market-watch/items/{id} — rank: any-builder — GET /market-watch/items/:id
+      getMarketWatchItemsId: (args) => request("GET", "/market-watch/items/{id}", { hasBody: false }, args),
+      // POST /market-watch/proposals — rank: any-builder — POST /market-watch/proposals
+      postMarketWatchProposals: (args) => request("POST", "/market-watch/proposals", { hasBody: true }, args),
       // POST /market-watch/proposals/{id}/decide — rank: any-builder — POST /market-watch/proposals/:id/decide
       postMarketWatchProposalsIdDecide: (args) => request("POST", "/market-watch/proposals/{id}/decide", { hasBody: true }, args),
       // POST /market-watch/proposals/{id}/vote — rank: metic+archon — POST /market-watch/proposals/:id/vote
@@ -1008,6 +1014,10 @@ export function createClient(opts = {}) {
       // GET /page-notes/site — rank: any-builder — GET /page-notes/site
       getPageNotesSite: (args) => request("GET", "/page-notes/site", { hasBody: false }, args),
     },
+    "payTerms": {
+      // GET /pay-terms — rank: any-builder — GET /pay-terms
+      getPayTerms: (args) => request("GET", "/pay-terms", { hasBody: false }, args),
+    },
     "payouts": {
       // POST /payouts/age-records — rank: archon — POST /payouts/age-records
       postPayoutsAgeRecords: (args) => request("POST", "/payouts/age-records", { hasBody: true }, args),
@@ -1053,6 +1063,8 @@ export function createClient(opts = {}) {
     "projectSettings": {
       // GET /project-settings — rank: metic+archon — GET /project-settings
       getProjectSettings: (args) => request("GET", "/project-settings", { hasBody: false }, args),
+      // PATCH /project-settings/pay-terms — rank: metic+archon — PATCH /project-settings/pay-terms
+      patchProjectSettingsPayTerms: (args) => request("PATCH", "/project-settings/pay-terms", { hasBody: true }, args),
       // PATCH /project-settings/rot-days — rank: metic+archon — PATCH /project-settings/rot-days
       patchProjectSettingsRotDays: (args) => request("PATCH", "/project-settings/rot-days", { hasBody: true }, args),
       // GET /project-settings/ship-mode — rank: any-builder — GET /project-settings/ship-mode

package/docs/api/openapi.json

@@ -241,6 +241,10 @@
       "name": "page-notes",
       "description": "Endpoints under `/api/bongos/page-notes`."
     },
+    {
+      "name": "pay-terms",
+      "description": "Endpoints under `/api/bongos/pay-terms`."
+    },
     {
       "name": "payouts",
       "description": "Endpoints under `/api/bongos/payouts`."
@@ -14078,6 +14082,131 @@
         ]
       }
     },
+    "/market-watch/home": {
+      "get": {
+        "operationId": "get_market_watch_home",
+        "tags": [
+          "market-watch"
+        ],
+        "summary": "GET /market-watch/home",
+        "description": "every member reads the desk.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/market-watch/routes/pages.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/market-watch/items/{id}": {
+      "get": {
+        "operationId": "get_market_watch_items_id",
+        "tags": [
+          "market-watch"
+        ],
+        "summary": "GET /market-watch/items/:id",
+        "description": "every member reads an item's case file.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/market-watch/routes/pages.js",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `id`."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/market-watch/proposals": {
+      "post": {
+        "operationId": "post_market_watch_proposals",
+        "tags": [
+          "market-watch"
+        ],
+        "summary": "POST /market-watch/proposals",
+        "description": "every member may propose; the government decides (task 1004941).\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/market-watch/routes/pages.js",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostMarketWatchProposalsRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostMarketWatchProposalsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/market-watch/proposals/{id}/decide": {
       "post": {
         "operationId": "post_market_watch_proposals_id_decide",
@@ -19113,6 +19242,44 @@
         ]
       }
     },
+    "/pay-terms": {
+      "get": {
+        "operationId": "get_pay_terms",
+        "tags": [
+          "pay-terms"
+        ],
+        "summary": "GET /pay-terms",
+        "description": "GET /pay-terms?task_ids=1,2,3 — what each task pays, in the project's words (task 1004990, ADR 0385 D3), for a list of tasks in one read: the hall task page and `bongos start` show it so a builder sees the pay BEFORE claiming. Each entry is { source: 'task' | 'project' | 'none', terms, set_by, set_at }; a task with none of its own shows the project's standing terms (set below), and a self-managed term carries its \"Bongos does not move or guarantee this money\" label. Records only — no amount here is a Bongos figure. It lives beside the standing-terms write because both serve the one pay-terms table pair. rank: any-builder — the same task metadata GET /tasks/:id serves; nothing changed.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/project-settings.js",
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetPayTermsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/payouts/age-records": {
       "post": {
         "operationId": "post_payouts_age_records",
@@ -20050,6 +20217,58 @@
         ]
       }
     },
+    "/project-settings/pay-terms": {
+      "patch": {
+        "operationId": "patch_project_settings_pay_terms",
+        "tags": [
+          "project-settings"
+        ],
+        "summary": "PATCH /project-settings/pay-terms",
+        "description": "PATCH /project-settings/pay-terms — body { terms: [{ pay_type, amount?, unit?, note? }] } (task 1004990; ADR 0385 decision 3 and the owner's 2026-10-29 ruling). The project's STANDING pay terms: what a builder is shown on any task that carries none of its own. The whole list replaces the current set; [] means none. Every change is a new row naming who set it and when, and the old sets stay, so the table is the audit trail the owner asked for. Bongos fills nothing in. rank: project.settings.manage (metic+, government_010), the same atom as the other writes on this page.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `project.settings.manage` (all required).",
+        "x-rank": "metic+archon",
+        "x-source": "modules/lifecycle/routes/project-settings.js",
+        "x-permissions": [
+          "project.settings.manage"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PatchProjectSettingsPayTermsRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PatchProjectSettingsPayTermsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/project-settings/rot-days": {
       "patch": {
         "operationId": "patch_project_settings_rot_days",
@@ -27822,7 +28041,7 @@
           "tasks"
         ],
         "summary": "POST /tasks",
-        "description": "Task create/promote/edit (plan/scope mutation) is Metic+ as of ADR 0090 (owner decision 2026-06-26): a Metic who can run idea-triage may also seed + shape tasks. Was Archon-only (task task 106 / ADR 0016; three-rank model task 360 / ADR 0018). A Xenos/Thetes still cannot author — they file ideas. Setting rank and closing versions stay Archon. The every-route audit is task task 231 (V3.R06). rank: metic+archon — create work (plan/scope mutation); ADR 0090 (was ADR 0016/0018 archon).\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `task.create` (all required).",
+        "description": "Task create/promote/edit (plan/scope mutation) is Metic+ as of ADR 0090 (owner decision 2026-06-26): a Metic who can run idea-triage may also seed + shape tasks. Was Archon-only (task task 106 / ADR 0016; three-rank model task 360 / ADR 0018). A Xenos/Thetes still cannot author — they file ideas. Setting rank and closing versions stay Archon. The every-route audit is task task 231 (V3.R06). NO pay_terms HERE, on purpose (task 1004990): the task's rule is that only someone who may EDIT a task sets its pay terms, and this route is gated on task.create, not task.edit — so terms are set with PATCH /tasks/:id right after create, under that route's task.edit gate. The strict validator refuses the field here rather than letting a create quietly widen who may set pay. rank: metic+archon — create work (plan/scope mutation); ADR 0090 (was ADR 0016/0018 archon).\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `task.create` (all required).",
         "x-rank": "metic+archon",
         "x-source": "modules/lifecycle/routes/task-write-routes.js",
         "x-permissions": [
@@ -32052,6 +32271,15 @@
           "notes"
         ]
       },
+      "GetPayTermsResponse": {
+        "type": "object",
+        "properties": {
+          "pay_terms": {}
+        },
+        "required": [
+          "pay_terms"
+        ]
+      },
       "GetPayoutsApprovalsResponse": {
         "type": "object",
         "properties": {
@@ -33641,6 +33869,29 @@
           "updated_at"
         ]
       },
+      "PatchProjectSettingsPayTermsRequest": {
+        "type": "object",
+        "properties": {
+          "terms": {}
+        },
+        "required": [
+          "terms"
+        ],
+        "additionalProperties": false
+      },
+      "PatchProjectSettingsPayTermsResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "row": {}
+        },
+        "required": [
+          "ok",
+          "row"
+        ]
+      },
       "PatchProjectSettingsRotDaysRequest": {
         "type": "object",
         "properties": {
@@ -34026,7 +34277,8 @@
             "minLength": 1,
             "maxLength": 1000
           },
-          "status": {}
+          "status": {},
+          "pay_terms": {}
         },
         "additionalProperties": false
       },
@@ -37143,6 +37395,53 @@
           "item_id"
         ]
       },
+      "PostMarketWatchProposalsRequest": {
+        "type": "object",
+        "properties": {
+          "kind": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string",
+            "maxLength": 2000
+          },
+          "item_id": {
+            "$ref": "#/components/schemas/StringifiableId"
+          },
+          "dimension": {
+            "type": "string",
+            "maxLength": 60
+          },
+          "value": {},
+          "url": {
+            "type": "string",
+            "maxLength": 2000
+          },
+          "log_entry_id": {
+            "$ref": "#/components/schemas/StringifiableId"
+          },
+          "scout": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string",
+            "maxLength": 2000
+          }
+        },
+        "required": [
+          "kind"
+        ],
+        "additionalProperties": false
+      },
+      "PostMarketWatchProposalsResponse": {
+        "type": "object",
+        "properties": {
+          "proposal": {}
+        },
+        "required": [
+          "proposal"
+        ]
+      },
       "PostMarketWatchRulesProposalsRequest": {
         "type": "object",
         "properties": {
@@ -40980,9 +41279,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 647,
-  "x-schema-count": 693,
+  "x-endpoint-count": 652,
+  "x-schema-count": 698,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 444,
+  "x-response-schemas": 447,
   "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. 647 endpoints across 108 route files.
+> **Generated from the live route files** — the route file is authoritative. 652 endpoints across 109 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`.
@@ -520,12 +520,15 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | POST | `/api/bongos/llm-cache/lookup` | `metic+archon` | `cache_key`, `tokens_saved_est` | POST /llm-cache/lookup — hit/miss + atomic hit_count bump. |
 | POST | `/api/bongos/llm-cache/store` | `metic+archon` | `spec`, `result_stdout`, `result_cost_usd` | POST /llm-cache/store — upsert a freshly-produced result. |
 
-## `market-watch` (10)
+## `market-watch` (13)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
 | GET | `/api/bongos/market-watch/ask` | `any-builder` | — | every member reads their own card; nobody else's (isMember in gate()). |
 | POST | `/api/bongos/market-watch/ask/answer` | `any-builder` | `week_of`, `picks`, `names`, `nothing`, `builder_id` | a member answers for themselves only (isMember in gate()). |
+| GET | `/api/bongos/market-watch/home` | `any-builder` | — | every member reads the desk. |
+| GET | `/api/bongos/market-watch/items/:id` | `any-builder` | — | every member reads an item's case file. |
+| POST | `/api/bongos/market-watch/proposals` | `any-builder` | `kind`, `reason`, `item_id`, `dimension`, `value`, `url`, `log_entry_id`, `scout`, `name` | every member may propose; the government decides (task 1004941). |
 | POST | `/api/bongos/market-watch/proposals/:id/decide` | `any-builder` | `decision` | THE OWNER'S DECISION. |
 | POST | `/api/bongos/market-watch/proposals/:id/vote` | `metic+archon` | — | PUT TO A VOTE. |
 | GET | `/api/bongos/market-watch/rules` | `any-builder` | — | every member reads the rules (the task); the read grants nothing. |
@@ -691,6 +694,12 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/page-notes/images/:id` | `any-builder` | — |  |
 | GET | `/api/bongos/page-notes/site` | `any-builder` | — | The public site's reviews (task 1004499), for the Studio's list. |
 
+## `pay-terms` (1)
+
+| Method | Path | Rank | Body | Description |
+|---|---|---|---|---|
+| GET | `/api/bongos/pay-terms` | `any-builder` | — | GET /pay-terms?task_ids=1,2,3 — what each task pays, in the project's words (task 1004990, ADR 0385 D3), for a list of tasks in one read:… |
+
 ## `payouts` (16)
 
 | Method | Path | Rank | Body | Description |
@@ -724,11 +733,12 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 |---|---|---|---|---|
 | GET | `/api/bongos/project/manage-link` | `archon` | — | GET /project/manage-link — the hub's page for THIS project, where its owner takes it offline or disconnects it (task 1004570). |
 
-## `project-settings` (7)
+## `project-settings` (8)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
 | GET | `/api/bongos/project-settings` | `metic+archon` | — | GET /project-settings — all five rows in ONE read. |
+| PATCH | `/api/bongos/project-settings/pay-terms` | `metic+archon` | `terms` | PATCH /project-settings/pay-terms — body { terms: [{ pay_type, amount?, unit?, note? }] } (task 1004990; ADR 0385 decision 3 and the owne… |
 | PATCH | `/api/bongos/project-settings/rot-days` | `metic+archon` | `days` | PATCH /project-settings/rot-days — body { days }. |
 | GET | `/api/bongos/project-settings/ship-mode` | `any-builder` | — | GET /project-settings/ship-mode — the ship mode alone, for the CLI and the AI. |
 | PATCH | `/api/bongos/project-settings/ship-mode` | `metic+archon` | `mode` | PATCH /project-settings/ship-mode — body { mode: 'auto' \| 'manual' }. |
@@ -997,7 +1007,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/tasks` | `any-builder` | — |  |
 | POST | `/api/bongos/tasks` | `metic+archon` | `version_id`, `title`, `description`, `status`, `touches`, `est_minutes`, `est_cost_usd`, `manual_degree`, `priority`, `automation_tag`, `credits_reward`, `source`, `source_ref`, `value_summary`, `kind`, `discipline`, `parallel_safe`, `newcomer_friendly`, `security_sensitive`, `requires_rank`, `needs`, `auto_detect_touches`, `criterion_ids`, `module_key`, `goal_id` | Task create/promote/edit (plan/scope mutation) is Metic+ as of ADR 0090 (owner decision 2026-06-26): a Metic who can run idea-triage may … |
 | GET | `/api/bongos/tasks/:id` | `any-builder` | — | single-task read; preserved per CRITICAL §4 (supervisor hot path). |
-| PATCH | `/api/bongos/tasks/:id` | `metic+archon` | `kind`, `discipline`, `requires_rank`, `module_key`, `goal_id`, `parent_task_id`, `parallel_safe`, `newcomer_friendly`, `xenos_claimable`, `security_sensitive`, `automation_tag`, `needs`, `needs_migration`, `description`, `title`, `priority`, `value_summary`, `status` | PATCH /tasks/:id — supports body.parent_task_id (V2 C2), body.kind (V2 B1), body.discipline (mig 014), body.parallel_safe (mig 028), and … |
+| PATCH | `/api/bongos/tasks/:id` | `metic+archon` | `kind`, `discipline`, `requires_rank`, `module_key`, `goal_id`, `parent_task_id`, `parallel_safe`, `newcomer_friendly`, `xenos_claimable`, `security_sensitive`, `automation_tag`, `needs`, `needs_migration`, `description`, `title`, `priority`, `value_summary`, `status`, `pay_terms` | PATCH /tasks/:id — supports body.parent_task_id (V2 C2), body.kind (V2 B1), body.discipline (mig 014), body.parallel_safe (mig 028), and … |
 | POST | `/api/bongos/tasks/:id/abandon` | `any-builder` | — | POST /tasks/:id/abandon — terminal "retire this task" transition (task 987). |
 | POST | `/api/bongos/tasks/:id/attest-gate` | `any-builder` | `head_sha` | POST /tasks/:id/attest-gate — body: { head_sha }. |
 | POST | `/api/bongos/tasks/:id/confirm` | `any-builder` | `verified` |  |

package/docs/architecture.md

@@ -252,6 +252,10 @@ store_modules(module_key PK, title, description, author_id, status CHECK IN (lis
 store_module_versions(id, module_key, version exact X.Y.Z, core_version, manifest jsonb,
               tree_sha256, tarball_sha256, tarball_bytes, artifact_path, published_by,
               published_at, UNIQUE(module_key, version))  -- immutable; a fix is a new version
+lifecycle_pay_term_sets(id, task_id NULL = the project's standing terms, set_by, set_at)
+lifecycle_pay_terms(id, set_id, position, pay_type, amount text, unit, note)
+              -- task 1004990 (module lifecycle, lifecycle_018): what a task pays, in the project's words; append-only
+              -- history of whole sets (newest current), records only, no default amount.
 store_module_prices(id, module_key, price_cents, price_credits, set_by, set_at)
               -- history; newest row per module is current. Cash only since core_287 (task 1004989):
               -- price_credits is historical, a credit-only newest row reads "price coming". 0 cents = free.