@bongos/core 1.24.11 → 1.24.13

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`)
-- 649 operations across 81 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

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

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

@@ -470,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 }
@@ -1392,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 */

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

package/docs/adr/0371-auto-pickup-applies-a-submitted-tweak-on-the-runner.md

@@ -6,6 +6,7 @@
 - **Builds on:** [ADR 0341](0341-the-page-is-the-unit-of-tweak-mode.md) (Tweak Mode; D7 nothing ships without the artist's approval), [ADR 0307](0307-autobongos-a-deterministic-supervisor-and-agentic-workers.md) (Autobongos: one supervisor, one headless worker per task, a DB fence), [ADR 0369](0369-ship-mode-decides-who-starts-a-ship-not-how-it-lands.md) (a live knob in `project_settings` behind one resolver)
 - **Decided with:** the owner, 2026-09-27 ("queue now, auto later") and 2026-10-08 (write the design now, without waiting for the live artist proof, task 1004329)
 - **Amended:** 2026-10-29, [task 1005003](https://cloudbongos.com/builders#/task/1005003) — the owner raised the D5 default cap from 20 to **200** rounds a month (decision on [task 1004971](https://cloudbongos.com/builders#/task/1004971), Q7). A project can set its own cap and one cap per builder rank (`tweak.autopickup_rank_cap.<rank>`, one row per rank so two edits never overwrite each other) on the settings page. The cap for a marked claim is the claimer's rank cap when the project set one, else the project cap; it is measured against the one project-wide monthly count, under the same lock.
+- **Amended:** 2026-10-30, [task 1005019](https://cloudbongos.com/builders#/task/1005019) — the owner ruled that a rank cap is a **per-person** allowance: each builder of that rank may have that many marked claims of their own this month, counted from their own claims under the same lock. The project cap still bounds the total across everyone, checked first. A rank with no cap has only the project cap. The refusal says which limit was hit (`cap_from`: `project` or `rank`).
 
 ## Context
 

package/docs/api/openapi.json

@@ -14082,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",
@@ -37270,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": {
@@ -41107,9 +41279,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 649,
-  "x-schema-count": 696,
+  "x-endpoint-count": 652,
+  "x-schema-count": 698,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 446,
+  "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. 649 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. |