@bongos/core 1.24.9 → 1.24.11

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

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

@@ -771,6 +771,14 @@ function createClient(opts = {}) {
       getMarketWatchRules: (args) => request("GET", "/market-watch/rules", { hasBody: false }, args),
       // POST /market-watch/rules/proposals — rank: any-builder — POST /market-watch/rules/proposals
       postMarketWatchRulesProposals: (args) => request("POST", "/market-watch/rules/proposals", { hasBody: true }, args),
+      // GET /market-watch/settings — rank: metic+archon — GET /market-watch/settings
+      getMarketWatchSettings: (args) => request("GET", "/market-watch/settings", { hasBody: false }, args),
+      // PATCH /market-watch/settings — rank: metic+archon — PATCH /market-watch/settings
+      patchMarketWatchSettings: (args) => request("PATCH", "/market-watch/settings", { hasBody: true }, args),
+      // DELETE /market-watch/settings/key — rank: metic+archon — DELETE /market-watch/settings/key
+      deleteMarketWatchSettingsKey: (args) => request("DELETE", "/market-watch/settings/key", { hasBody: false }, args),
+      // PUT /market-watch/settings/key — rank: metic+archon — PUT /market-watch/settings/key
+      putMarketWatchSettingsKey: (args) => request("PUT", "/market-watch/settings/key", { hasBody: true }, args),
     },
     "me": {
       // GET /me — rank: any-builder — GET /me
@@ -1004,6 +1012,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),
@@ -1049,6 +1061,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

@@ -770,6 +770,14 @@ function createClient(opts = {}) {
       getMarketWatchRules: (args) => request("GET", "/market-watch/rules", { hasBody: false }, args),
       // POST /market-watch/rules/proposals — rank: any-builder — POST /market-watch/rules/proposals
       postMarketWatchRulesProposals: (args) => request("POST", "/market-watch/rules/proposals", { hasBody: true }, args),
+      // GET /market-watch/settings — rank: metic+archon — GET /market-watch/settings
+      getMarketWatchSettings: (args) => request("GET", "/market-watch/settings", { hasBody: false }, args),
+      // PATCH /market-watch/settings — rank: metic+archon — PATCH /market-watch/settings
+      patchMarketWatchSettings: (args) => request("PATCH", "/market-watch/settings", { hasBody: true }, args),
+      // DELETE /market-watch/settings/key — rank: metic+archon — DELETE /market-watch/settings/key
+      deleteMarketWatchSettingsKey: (args) => request("DELETE", "/market-watch/settings/key", { hasBody: false }, args),
+      // PUT /market-watch/settings/key — rank: metic+archon — PUT /market-watch/settings/key
+      putMarketWatchSettingsKey: (args) => request("PUT", "/market-watch/settings/key", { hasBody: true }, args),
     },
     "me": {
       // GET /me — rank: any-builder — GET /me
@@ -1003,6 +1011,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),
@@ -1048,6 +1060,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 }
@@ -243,6 +244,7 @@ export interface PatchInboxIdBodyRequest { body_md: string }
 export interface PatchInboxIdBodyResponse { ok: boolean; idea: unknown; delta: unknown; unchanged: unknown }
 export interface PatchInboxIdRequest { status?: "open" | "promoted" | "discarded" | "merged"; kind?: string; promoted_to_task_id?: number; reviewed_at?: unknown; merged_into_idea_id?: number; triage_note?: string }
 export interface PatchInboxIdResponse { idea: unknown }
+export interface PatchMarketWatchSettingsRequest { enabled?: unknown; monthly_cap_usd?: unknown; cadence?: unknown }
 export interface PatchMeCoreMoveSeenRequest { id: string }
 export interface PatchMeCoreMoveSeenResponse { ok: boolean; seen: unknown }
 export interface PatchMeCrossProjectRequest { hide_stats?: boolean; account_visibility?: string; recruiter_discoverable?: boolean }
@@ -263,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 }
@@ -284,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 }
@@ -680,6 +684,7 @@ export interface PutDoneWhenCriterionIdBackendOnlyResponse { ok: boolean; criter
 export interface PutGovernmentAsksMatterIdResponse { ok: boolean; matter_id: unknown; ask: unknown }
 export interface PutGovernmentRanksRankKeyPermissionsPermissionKeyResponse { ok: boolean; rank_key: unknown; permission_key: unknown; granted: unknown }
 export interface PutGovernmentTreasuryPotsGoalIdRequest { budget_usd?: unknown }
+export interface PutMarketWatchSettingsKeyRequest { key: string }
 export interface PutMingleOptInRequest { opted_in: boolean }
 export interface PutMingleOptInResponse { opted_in: unknown; updated_at: unknown }
 export interface PutMingleProjectRequest { enabled: boolean }
@@ -1395,6 +1400,14 @@ export interface BongosClient {
     getMarketWatchRules(args?: RequestArgs): Promise<ApiResponse>;
     /** POST /market-watch/rules/proposals — rank: any-builder */
     postMarketWatchRulesProposals(args: RequestArgs & { body: PostMarketWatchRulesProposalsRequest }): Promise<PostMarketWatchRulesProposalsResponse>;
+    /** GET /market-watch/settings — rank: metic+archon */
+    getMarketWatchSettings(args?: RequestArgs): Promise<ApiResponse>;
+    /** PATCH /market-watch/settings — rank: metic+archon */
+    patchMarketWatchSettings(args?: RequestArgs & { body?: PatchMarketWatchSettingsRequest }): Promise<ApiResponse>;
+    /** DELETE /market-watch/settings/key — rank: metic+archon */
+    deleteMarketWatchSettingsKey(args?: RequestArgs): Promise<ApiResponse>;
+    /** PUT /market-watch/settings/key — rank: metic+archon */
+    putMarketWatchSettingsKey(args: RequestArgs & { body: PutMarketWatchSettingsKeyRequest }): Promise<ApiResponse>;
   };
   "me": {
     /** GET /me — rank: any-builder */
@@ -1628,6 +1641,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>;
@@ -1673,6 +1690,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

@@ -767,6 +767,14 @@ export function createClient(opts = {}) {
       getMarketWatchRules: (args) => request("GET", "/market-watch/rules", { hasBody: false }, args),
       // POST /market-watch/rules/proposals — rank: any-builder — POST /market-watch/rules/proposals
       postMarketWatchRulesProposals: (args) => request("POST", "/market-watch/rules/proposals", { hasBody: true }, args),
+      // GET /market-watch/settings — rank: metic+archon — GET /market-watch/settings
+      getMarketWatchSettings: (args) => request("GET", "/market-watch/settings", { hasBody: false }, args),
+      // PATCH /market-watch/settings — rank: metic+archon — PATCH /market-watch/settings
+      patchMarketWatchSettings: (args) => request("PATCH", "/market-watch/settings", { hasBody: true }, args),
+      // DELETE /market-watch/settings/key — rank: metic+archon — DELETE /market-watch/settings/key
+      deleteMarketWatchSettingsKey: (args) => request("DELETE", "/market-watch/settings/key", { hasBody: false }, args),
+      // PUT /market-watch/settings/key — rank: metic+archon — PUT /market-watch/settings/key
+      putMarketWatchSettingsKey: (args) => request("PUT", "/market-watch/settings/key", { hasBody: true }, args),
     },
     "me": {
       // GET /me — rank: any-builder — GET /me
@@ -1000,6 +1008,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),
@@ -1045,6 +1057,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`."
@@ -14269,6 +14273,160 @@
         ]
       }
     },
+    "/market-watch/settings": {
+      "get": {
+        "operationId": "get_market_watch_settings",
+        "tags": [
+          "market-watch"
+        ],
+        "summary": "GET /market-watch/settings",
+        "description": "**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/market-watch/routes/settings.js",
+        "x-permissions": [
+          "project.settings.manage"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      },
+      "patch": {
+        "operationId": "patch_market_watch_settings",
+        "tags": [
+          "market-watch"
+        ],
+        "summary": "PATCH /market-watch/settings",
+        "description": "**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/market-watch/routes/settings.js",
+        "x-permissions": [
+          "project.settings.manage"
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PatchMarketWatchSettingsRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/market-watch/settings/key": {
+      "put": {
+        "operationId": "put_market_watch_settings_key",
+        "tags": [
+          "market-watch"
+        ],
+        "summary": "PUT /market-watch/settings/key",
+        "description": "**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/market-watch/routes/settings.js",
+        "x-permissions": [
+          "project.settings.manage"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PutMarketWatchSettingsKeyRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      },
+      "delete": {
+        "operationId": "delete_market_watch_settings_key",
+        "tags": [
+          "market-watch"
+        ],
+        "summary": "DELETE /market-watch/settings/key",
+        "description": "**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/market-watch/routes/settings.js",
+        "x-permissions": [
+          "project.settings.manage"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/me": {
       "get": {
         "operationId": "get_me",
@@ -18959,6 +19117,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",
@@ -19896,6 +20092,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",
@@ -27668,7 +27916,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": [
@@ -31898,6 +32146,15 @@
           "notes"
         ]
       },
+      "GetPayTermsResponse": {
+        "type": "object",
+        "properties": {
+          "pay_terms": {}
+        },
+        "required": [
+          "pay_terms"
+        ]
+      },
       "GetPayoutsApprovalsResponse": {
         "type": "object",
         "properties": {
@@ -33196,6 +33453,15 @@
           "idea"
         ]
       },
+      "PatchMarketWatchSettingsRequest": {
+        "type": "object",
+        "properties": {
+          "enabled": {},
+          "monthly_cap_usd": {},
+          "cadence": {}
+        },
+        "additionalProperties": false
+      },
       "PatchMeCoreMoveSeenRequest": {
         "type": "object",
         "properties": {
@@ -33478,6 +33744,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": {
@@ -33863,7 +34152,8 @@
             "minLength": 1,
             "maxLength": 1000
           },
-          "status": {}
+          "status": {},
+          "pay_terms": {}
         },
         "additionalProperties": false
       },
@@ -40503,6 +40793,19 @@
         },
         "additionalProperties": false
       },
+      "PutMarketWatchSettingsKeyRequest": {
+        "type": "object",
+        "properties": {
+          "key": {
+            "type": "string",
+            "maxLength": 512
+          }
+        },
+        "required": [
+          "key"
+        ],
+        "additionalProperties": false
+      },
       "PutMingleOptInRequest": {
         "type": "object",
         "properties": {
@@ -40804,9 +41107,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 643,
-  "x-schema-count": 691,
+  "x-endpoint-count": 649,
+  "x-schema-count": 696,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 444,
+  "x-response-schemas": 446,
   "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. 643 endpoints across 107 route files.
+> **Generated from the live route files** — the route file is authoritative. 649 endpoints across 108 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,7 +520,7 @@ 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` (6)
+## `market-watch` (10)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -530,6 +530,10 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | 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. |
 | POST | `/api/bongos/market-watch/rules/proposals` | `any-builder` | `step`, `change`, `reason` | Any signed-in member may propose (the task: "every member can read the page and can propose"). |
+| GET | `/api/bongos/market-watch/settings` | `metic+archon` | — |  |
+| PATCH | `/api/bongos/market-watch/settings` | `metic+archon` | `enabled`, `monthly_cap_usd`, `cadence` |  |
+| PUT | `/api/bongos/market-watch/settings/key` | `metic+archon` | `key` |  |
+| DELETE | `/api/bongos/market-watch/settings/key` | `metic+archon` | — |  |
 
 ## `me` (55)
 
@@ -687,6 +691,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 |
@@ -720,11 +730,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' }. |
@@ -993,7 +1004,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` |  |