@bongos/core 1.21.167 → 1.21.169

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`)
-- 568 operations across 76 resource groups
+- 572 operations across 76 resource groups
 
 ## Use it from your project
 

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

@@ -505,8 +505,12 @@ function createClient(opts = {}) {
       putGovernmentAsksMatterId: (args) => request("PUT", "/government/asks/{matterId}", { hasBody: true }, args),
       // POST /government/asks/{matterId}/pass — rank: any-builder — POST /government/asks/:matterId/pass
       postGovernmentAsksMatterIdPass: (args) => request("POST", "/government/asks/{matterId}/pass", { hasBody: true }, args),
+      // POST /government/asks/{matterId}/unclear — rank: any-builder — POST /government/asks/:matterId/unclear
+      postGovernmentAsksMatterIdUnclear: (args) => request("POST", "/government/asks/{matterId}/unclear", { hasBody: true }, args),
       // POST /government/asks/check — rank: any-builder — POST /government/asks/check
       postGovernmentAsksCheck: (args) => request("POST", "/government/asks/check", { hasBody: true }, args),
+      // GET /government/asks/unclear — rank: any-builder — GET /government/asks/unclear
+      getGovernmentAsksUnclear: (args) => request("GET", "/government/asks/unclear", { hasBody: false }, args),
       // GET /government/assignments — rank: archon — GET /government/assignments
       getGovernmentAssignments: (args) => request("GET", "/government/assignments", { hasBody: false }, args),
       // POST /government/assignments — rank: archon — POST /government/assignments
@@ -1239,6 +1243,8 @@ function createClient(opts = {}) {
       getStoreModulesKeyEntitlement: (args) => request("GET", "/store/modules/{key}/entitlement", { hasBody: false }, args),
       // POST /store/modules/{key}/versions — rank: metic+archon — POST /store/modules/:key/versions
       postStoreModulesKeyVersions: (args) => request("POST", "/store/modules/{key}/versions", { hasBody: true }, args),
+      // GET /store/modules/{key}/versions/{version}/channel — rank: any-builder — GET /store/modules/:key/versions/:version/channel
+      getStoreModulesKeyVersionsVersionChannel: (args) => request("GET", "/store/modules/{key}/versions/{version}/channel", { hasBody: false }, args),
       // POST /store/modules/{key}/versions/{version}/error-count — rank: any-builder — POST /store/modules/:key/versions/:version/error-count
       postStoreModulesKeyVersionsVersionErrorCount: (args) => request("POST", "/store/modules/{key}/versions/{version}/error-count", { hasBody: true }, args),
       // GET /store/modules/{key}/versions/{version}/howto — rank: any-builder — GET /store/modules/:key/versions/:version/howto
@@ -1247,6 +1253,8 @@ function createClient(opts = {}) {
       postStoreModulesKeyVersionsVersionInstallReport: (args) => request("POST", "/store/modules/{key}/versions/{version}/install-report", { hasBody: true }, args),
       // POST /store/modules/{key}/versions/{version}/reassess — rank: metic+archon — POST /store/modules/:key/versions/:version/reassess
       postStoreModulesKeyVersionsVersionReassess: (args) => request("POST", "/store/modules/{key}/versions/{version}/reassess", { hasBody: true }, args),
+      // POST /store/modules/{key}/versions/{version}/release — rank: metic+archon — POST /store/modules/:key/versions/:version/release
+      postStoreModulesKeyVersionsVersionRelease: (args) => request("POST", "/store/modules/{key}/versions/{version}/release", { hasBody: true }, args),
       // GET /store/modules/{key}/versions/{version}/tarball — rank: any-builder — GET /store/modules/:key/versions/:version/tarball
       getStoreModulesKeyVersionsVersionTarball: (args) => request("GET", "/store/modules/{key}/versions/{version}/tarball", { hasBody: false }, args),
       // GET /store/modules/latest — rank: any-builder — GET /store/modules/latest

package/clients/bongos-client/index.cjs

@@ -504,8 +504,12 @@ function createClient(opts = {}) {
       putGovernmentAsksMatterId: (args) => request("PUT", "/government/asks/{matterId}", { hasBody: true }, args),
       // POST /government/asks/{matterId}/pass — rank: any-builder — POST /government/asks/:matterId/pass
       postGovernmentAsksMatterIdPass: (args) => request("POST", "/government/asks/{matterId}/pass", { hasBody: true }, args),
+      // POST /government/asks/{matterId}/unclear — rank: any-builder — POST /government/asks/:matterId/unclear
+      postGovernmentAsksMatterIdUnclear: (args) => request("POST", "/government/asks/{matterId}/unclear", { hasBody: true }, args),
       // POST /government/asks/check — rank: any-builder — POST /government/asks/check
       postGovernmentAsksCheck: (args) => request("POST", "/government/asks/check", { hasBody: true }, args),
+      // GET /government/asks/unclear — rank: any-builder — GET /government/asks/unclear
+      getGovernmentAsksUnclear: (args) => request("GET", "/government/asks/unclear", { hasBody: false }, args),
       // GET /government/assignments — rank: archon — GET /government/assignments
       getGovernmentAssignments: (args) => request("GET", "/government/assignments", { hasBody: false }, args),
       // POST /government/assignments — rank: archon — POST /government/assignments
@@ -1238,6 +1242,8 @@ function createClient(opts = {}) {
       getStoreModulesKeyEntitlement: (args) => request("GET", "/store/modules/{key}/entitlement", { hasBody: false }, args),
       // POST /store/modules/{key}/versions — rank: metic+archon — POST /store/modules/:key/versions
       postStoreModulesKeyVersions: (args) => request("POST", "/store/modules/{key}/versions", { hasBody: true }, args),
+      // GET /store/modules/{key}/versions/{version}/channel — rank: any-builder — GET /store/modules/:key/versions/:version/channel
+      getStoreModulesKeyVersionsVersionChannel: (args) => request("GET", "/store/modules/{key}/versions/{version}/channel", { hasBody: false }, args),
       // POST /store/modules/{key}/versions/{version}/error-count — rank: any-builder — POST /store/modules/:key/versions/:version/error-count
       postStoreModulesKeyVersionsVersionErrorCount: (args) => request("POST", "/store/modules/{key}/versions/{version}/error-count", { hasBody: true }, args),
       // GET /store/modules/{key}/versions/{version}/howto — rank: any-builder — GET /store/modules/:key/versions/:version/howto
@@ -1246,6 +1252,8 @@ function createClient(opts = {}) {
       postStoreModulesKeyVersionsVersionInstallReport: (args) => request("POST", "/store/modules/{key}/versions/{version}/install-report", { hasBody: true }, args),
       // POST /store/modules/{key}/versions/{version}/reassess — rank: metic+archon — POST /store/modules/:key/versions/:version/reassess
       postStoreModulesKeyVersionsVersionReassess: (args) => request("POST", "/store/modules/{key}/versions/{version}/reassess", { hasBody: true }, args),
+      // POST /store/modules/{key}/versions/{version}/release — rank: metic+archon — POST /store/modules/:key/versions/:version/release
+      postStoreModulesKeyVersionsVersionRelease: (args) => request("POST", "/store/modules/{key}/versions/{version}/release", { hasBody: true }, args),
       // GET /store/modules/{key}/versions/{version}/tarball — rank: any-builder — GET /store/modules/:key/versions/:version/tarball
       getStoreModulesKeyVersionsVersionTarball: (args) => request("GET", "/store/modules/{key}/versions/{version}/tarball", { hasBody: false }, args),
       // GET /store/modules/latest — rank: any-builder — GET /store/modules/latest

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

@@ -74,6 +74,7 @@ export interface GetGoalsIdRequestsResponse { requests: unknown }
 export interface GetGoalsIdResponse { goal: unknown; members: unknown; criteria: unknown; dependencies: unknown; criterionless_task_count: unknown; admitted: unknown; open_tasks: unknown }
 export interface GetGoalsResponse { goals: unknown }
 export interface GetGoalsRollupsResponse { rollups: unknown }
+export interface GetGovernmentAsksUnclearResponse { ok: boolean; matters: unknown }
 export interface GetGovernmentAssignmentsResponse { assignments: unknown }
 export interface GetGovernmentPermissionsResponse { permissions: unknown; principals: unknown }
 export interface GetGovernmentRanksResponse { ranks: unknown }
@@ -373,6 +374,8 @@ export interface PostGoalsResponse { ok: boolean; goal: unknown; succeeds_goal_i
 export interface PostGovernmentAsksCheckResponse { ok: boolean; ask: unknown; question_words: unknown; rules: unknown }
 export interface PostGovernmentAsksMatterIdPassRequest { seat: string }
 export interface PostGovernmentAsksMatterIdPassResponse { ok: boolean; matter_id: unknown; ask: unknown; route: unknown }
+export interface PostGovernmentAsksMatterIdUnclearRequest { note?: string }
+export interface PostGovernmentAsksMatterIdUnclearResponse { ok: boolean; matter_id: unknown; flag: unknown }
 export interface PostGovernmentAssignmentsRequest { builder_id: number; rank_key: string }
 export interface PostGovernmentBoardCharterRequest { form?: string; franchise?: string; council_rank?: string; pass_rule?: string; window_minutes?: unknown; rationale_md?: string; acknowledge_self_removal?: boolean }
 export interface PostGovernmentBoardCharterResponse { ok: boolean; amendment: unknown; item: unknown; reads_as: unknown }
@@ -553,6 +556,8 @@ export interface PostStoreModulesKeyVersionsVersionErrorCountRequest { day: stri
 export interface PostStoreModulesKeyVersionsVersionInstallReportRequest { ok: boolean; error_code?: string }
 export interface PostStoreModulesKeyVersionsVersionReassessRequest { reason?: string }
 export interface PostStoreModulesKeyVersionsVersionReassessResponse { ok: boolean; queued: boolean; module_key: unknown; version: unknown; version_id: unknown }
+export interface PostStoreModulesKeyVersionsVersionReleaseRequest { reason?: string }
+export interface PostStoreModulesKeyVersionsVersionReleaseResponse { ok: boolean; module_key: unknown; version: unknown; channel: unknown; reason: unknown }
 export interface PostStoreUsageReportingRequest { enabled: boolean }
 export interface PostStoreUsageReportingResponse { ok: boolean; enabled: unknown }
 export interface PostTaskRecommendationsRequest { task_id: number; recommended_to: number; reason: string }
@@ -1044,8 +1049,12 @@ export interface BongosClient {
     putGovernmentAsksMatterId(args?: RequestArgs): Promise<PutGovernmentAsksMatterIdResponse>;
     /** POST /government/asks/{matterId}/pass — rank: any-builder */
     postGovernmentAsksMatterIdPass(args: RequestArgs & { body: PostGovernmentAsksMatterIdPassRequest }): Promise<PostGovernmentAsksMatterIdPassResponse>;
+    /** POST /government/asks/{matterId}/unclear — rank: any-builder */
+    postGovernmentAsksMatterIdUnclear(args?: RequestArgs & { body?: PostGovernmentAsksMatterIdUnclearRequest }): Promise<PostGovernmentAsksMatterIdUnclearResponse>;
     /** POST /government/asks/check — rank: any-builder */
     postGovernmentAsksCheck(args?: RequestArgs): Promise<PostGovernmentAsksCheckResponse>;
+    /** GET /government/asks/unclear — rank: any-builder */
+    getGovernmentAsksUnclear(args?: RequestArgs): Promise<GetGovernmentAsksUnclearResponse>;
     /** GET /government/assignments — rank: archon */
     getGovernmentAssignments(args?: RequestArgs): Promise<GetGovernmentAssignmentsResponse>;
     /** POST /government/assignments — rank: archon */
@@ -1778,6 +1787,8 @@ export interface BongosClient {
     getStoreModulesKeyEntitlement(args?: RequestArgs): Promise<ApiResponse>;
     /** POST /store/modules/{key}/versions — rank: metic+archon */
     postStoreModulesKeyVersions(args?: RequestArgs): Promise<PostStoreModulesKeyVersionsResponse>;
+    /** GET /store/modules/{key}/versions/{version}/channel — rank: any-builder */
+    getStoreModulesKeyVersionsVersionChannel(args?: RequestArgs): Promise<ApiResponse>;
     /** POST /store/modules/{key}/versions/{version}/error-count — rank: any-builder */
     postStoreModulesKeyVersionsVersionErrorCount(args: RequestArgs & { body: PostStoreModulesKeyVersionsVersionErrorCountRequest }): Promise<ApiResponse>;
     /** GET /store/modules/{key}/versions/{version}/howto — rank: any-builder */
@@ -1786,6 +1797,8 @@ export interface BongosClient {
     postStoreModulesKeyVersionsVersionInstallReport(args: RequestArgs & { body: PostStoreModulesKeyVersionsVersionInstallReportRequest }): Promise<ApiResponse>;
     /** POST /store/modules/{key}/versions/{version}/reassess — rank: metic+archon */
     postStoreModulesKeyVersionsVersionReassess(args?: RequestArgs & { body?: PostStoreModulesKeyVersionsVersionReassessRequest }): Promise<PostStoreModulesKeyVersionsVersionReassessResponse>;
+    /** POST /store/modules/{key}/versions/{version}/release — rank: metic+archon */
+    postStoreModulesKeyVersionsVersionRelease(args?: RequestArgs & { body?: PostStoreModulesKeyVersionsVersionReleaseRequest }): Promise<PostStoreModulesKeyVersionsVersionReleaseResponse>;
     /** GET /store/modules/{key}/versions/{version}/tarball — rank: any-builder */
     getStoreModulesKeyVersionsVersionTarball(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /store/modules/latest — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -501,8 +501,12 @@ export function createClient(opts = {}) {
       putGovernmentAsksMatterId: (args) => request("PUT", "/government/asks/{matterId}", { hasBody: true }, args),
       // POST /government/asks/{matterId}/pass — rank: any-builder — POST /government/asks/:matterId/pass
       postGovernmentAsksMatterIdPass: (args) => request("POST", "/government/asks/{matterId}/pass", { hasBody: true }, args),
+      // POST /government/asks/{matterId}/unclear — rank: any-builder — POST /government/asks/:matterId/unclear
+      postGovernmentAsksMatterIdUnclear: (args) => request("POST", "/government/asks/{matterId}/unclear", { hasBody: true }, args),
       // POST /government/asks/check — rank: any-builder — POST /government/asks/check
       postGovernmentAsksCheck: (args) => request("POST", "/government/asks/check", { hasBody: true }, args),
+      // GET /government/asks/unclear — rank: any-builder — GET /government/asks/unclear
+      getGovernmentAsksUnclear: (args) => request("GET", "/government/asks/unclear", { hasBody: false }, args),
       // GET /government/assignments — rank: archon — GET /government/assignments
       getGovernmentAssignments: (args) => request("GET", "/government/assignments", { hasBody: false }, args),
       // POST /government/assignments — rank: archon — POST /government/assignments
@@ -1235,6 +1239,8 @@ export function createClient(opts = {}) {
       getStoreModulesKeyEntitlement: (args) => request("GET", "/store/modules/{key}/entitlement", { hasBody: false }, args),
       // POST /store/modules/{key}/versions — rank: metic+archon — POST /store/modules/:key/versions
       postStoreModulesKeyVersions: (args) => request("POST", "/store/modules/{key}/versions", { hasBody: true }, args),
+      // GET /store/modules/{key}/versions/{version}/channel — rank: any-builder — GET /store/modules/:key/versions/:version/channel
+      getStoreModulesKeyVersionsVersionChannel: (args) => request("GET", "/store/modules/{key}/versions/{version}/channel", { hasBody: false }, args),
       // POST /store/modules/{key}/versions/{version}/error-count — rank: any-builder — POST /store/modules/:key/versions/:version/error-count
       postStoreModulesKeyVersionsVersionErrorCount: (args) => request("POST", "/store/modules/{key}/versions/{version}/error-count", { hasBody: true }, args),
       // GET /store/modules/{key}/versions/{version}/howto — rank: any-builder — GET /store/modules/:key/versions/:version/howto
@@ -1243,6 +1249,8 @@ export function createClient(opts = {}) {
       postStoreModulesKeyVersionsVersionInstallReport: (args) => request("POST", "/store/modules/{key}/versions/{version}/install-report", { hasBody: true }, args),
       // POST /store/modules/{key}/versions/{version}/reassess — rank: metic+archon — POST /store/modules/:key/versions/:version/reassess
       postStoreModulesKeyVersionsVersionReassess: (args) => request("POST", "/store/modules/{key}/versions/{version}/reassess", { hasBody: true }, args),
+      // POST /store/modules/{key}/versions/{version}/release — rank: metic+archon — POST /store/modules/:key/versions/:version/release
+      postStoreModulesKeyVersionsVersionRelease: (args) => request("POST", "/store/modules/{key}/versions/{version}/release", { hasBody: true }, args),
       // GET /store/modules/{key}/versions/{version}/tarball — rank: any-builder — GET /store/modules/:key/versions/:version/tarball
       getStoreModulesKeyVersionsVersionTarball: (args) => request("GET", "/store/modules/{key}/versions/{version}/tarball", { hasBody: false }, args),
       // GET /store/modules/latest — rank: any-builder — GET /store/modules/latest

package/docs/api/openapi.json

@@ -8595,6 +8595,47 @@
         ]
       }
     },
+    "/government/asks/unclear": {
+      "get": {
+        "operationId": "get_government_asks_unclear",
+        "tags": [
+          "government"
+        ],
+        "summary": "GET /government/asks/unclear",
+        "description": "board.vote.cast — THE REWORD LIST: the open matters this viewer can see that someone flagged as unclear, oldest flag first, each with its words as they stand (title, detail, stored ask) so a session can rewrite it. → 200 { ok, matters: [{ id, building, source, title, detail, ask, flag }] }\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetGovernmentAsksUnclearResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/government/asks/{matterId}": {
       "put": {
         "operationId": "put_government_asks_matterId",
@@ -8716,6 +8757,72 @@
         ]
       }
     },
+    "/government/asks/{matterId}/unclear": {
+      "post": {
+        "operationId": "post_government_asks_matterId_unclear",
+        "tags": [
+          "government"
+        ],
+        "summary": "POST /government/asks/:matterId/unclear",
+        "description": "board.vote.cast — \"I DON'T UNDERSTAND THIS\" (the \"?\" on a city card, owner 2026-10-23): puts a matter the flagger can see on the reword list (government_032). An AI session works that list and writes the matter a standard ask (PUT above), which closes the flag. A flag changes nothing a person decides; it only asks for better words. Body: { note? } (≤ 500 chars, what confused them) → 200 { ok, matter_id, flag }\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).\n\n**Permissions:** `board.vote.cast` (all required).",
+        "x-rank": "any-builder",
+        "x-source": "modules/government/routes/government.js",
+        "x-permissions": [
+          "board.vote.cast"
+        ],
+        "parameters": [
+          {
+            "name": "matterId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `matterId`."
+          }
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostGovernmentAsksMatterIdUnclearRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostGovernmentAsksMatterIdUnclearResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/government/assignments": {
       "get": {
         "operationId": "get_government_assignments",
@@ -23168,7 +23275,7 @@
           "store"
         ],
         "summary": "GET /store/modules/latest",
-        "description": "The newest published version of each named module — what `bongos upgrade` compares an instance's installed store modules against to report the updates available (task 1003787). `?keys=a,b,c`, at most STORE_LATEST_MAX_KEYS. rank: any-builder — a read of public store metadata (version numbers and the core range each needs, the same facts the how-to page shows). It takes no entitlement and changes nothing, unlike acquire; a key the store does not know is simply absent from the answer.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "description": "The newest published version of each named module — what `bongos upgrade` compares an instance's installed store modules against to report the updates available (task 1003787). `?keys=a,b,c`, at most STORE_LATEST_MAX_KEYS. Only versions on a channel this project takes count (task 1003805), so it reports exactly what `bongos module update` would hand over. rank: any-builder — a read of public store metadata (version numbers and the core range each needs, the same facts the how-to page shows). It takes no entitlement and changes nothing, unlike acquire; a key the store does not know is simply absent from the answer.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
         "x-rank": "any-builder",
         "x-source": "src/bongos/routes/modules.js",
         "responses": {
@@ -23206,7 +23313,7 @@
           "store"
         ],
         "summary": "POST /store/modules/:key/acquire",
-        "description": "---- install: acquire → download → record (task 1003785, ADR 0338 D1) ---- The server end of `bongos module install`. Three steps, so the store never records a version as acquired that the caller did not verify and place: 1. POST acquire — resolve the version, and take the entitlement: a free module (no price, or a zero price) is granted here with source 'free'; a priced one needs the buy action, which is area 8's (tasks 1003788/1003789) and answers 402 until then. 2. GET tarball — served only to a LIVE entitlement holder, never for a delisted module (ADR 0338 D2: no further versions served). 3. POST acquired — the CLI has verified the bytes with verifyModuleArtifact and placed them; recordAcquired stamps the exact version. Own-scoped like the entitlement reads: the holder is always the caller (holder_kind 'builder'), never named in the request, so requireBuilder is the gate — any signed-in builder may take a free module for themselves, and nothing here changes what runs on this instance (install never enables; the CLI places files on the CALLER's checkout). Channels: every version is on the general channel until the channel table (task 1003815) and \"install honours the channel\" (task 1003805) land; those add the channel check to step 1 and step 2, beside the entitlement check.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "description": "---- install: acquire → download → record (task 1003785, ADR 0338 D1) ---- The server end of `bongos module install`. Three steps, so the store never records a version as acquired that the caller did not verify and place: 1. POST acquire — resolve the version, and take the entitlement: a free module (no price, or a zero price) is granted here with source 'free'; a priced one needs the buy action, which is area 8's (tasks 1003788/1003789) and answers 402 until then. 2. GET tarball — served only to a LIVE entitlement holder, never for a delisted module (ADR 0338 D2: no further versions served). 3. POST acquired — the CLI has verified the bytes with verifyModuleArtifact and placed them; recordAcquired stamps the exact version. Own-scoped like the entitlement reads: the holder is always the caller (holder_kind 'builder'), never named in the request, so requireBuilder is the gate — any signed-in builder may take a free module for themselves, and nothing here changes what runs on this instance (install never enables; the CLI places files on the CALLER's checkout). Channels (task 1003805, ADR 0344): steps 1 and 2 hand out only versions on a channel this project takes (projectChannels) — with no version asked for, the newest there. Install and update share step 1, so both honour it. A project that stops testing keeps the tester version it has; its next update is the newest general one, and update only moves forward, so nothing rolls back. Step 3 records what was already placed, so it does not re-check the channel.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
         "x-rank": "any-builder",
         "x-source": "src/bongos/routes/modules.js",
         "parameters": [
@@ -23504,6 +23611,60 @@
         ]
       }
     },
+    "/store/modules/{key}/versions/{version}/channel": {
+      "get": {
+        "operationId": "get_store_modules_key_versions_version_channel",
+        "tags": [
+          "store"
+        ],
+        "summary": "GET /store/modules/:key/versions/:version/channel",
+        "description": "GET /api/bongos/store/modules/:key/versions/:version/channel — where a version stands on the promotion gate (task 1003804, ADR 0344 D3): its current channel, who moved it there and why, the rule in plain words, and on tester the numbers the rule reads and what it is waiting for. Any signed-in builder may read it, so an author is never left guessing why a version has not reached everyone.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "src/bongos/routes/modules.js",
+        "parameters": [
+          {
+            "name": "key",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `key`."
+          },
+          {
+            "name": "version",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `version`."
+          }
+        ],
+        "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": []
+          }
+        ]
+      }
+    },
     "/store/modules/{key}/versions/{version}/error-count": {
       "post": {
         "operationId": "post_store_modules_key_versions_version_error_count",
@@ -23770,6 +23931,81 @@
         ]
       }
     },
+    "/store/modules/{key}/versions/{version}/release": {
+      "post": {
+        "operationId": "post_store_modules_key_versions_version_release",
+        "tags": [
+          "store"
+        ],
+        "summary": "POST /store/modules/:key/versions/:version/release",
+        "description": "POST /api/bongos/store/modules/:key/versions/:version/release — a Metic+ person releases a version the promotion gate HELD on tester (a tester reported a failed install or errors) to general (task 1003804). Gated on module.delist: the owner ruled (2026-10-23) the people who may take a module out of the store are the ones who may let a held version out, with no new permission. Only a held version: one still waiting for its time is the rule's to move. A reason is required; the audit middleware records it with who released it, and set_by on the new channel row.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `module.delist` (all required).",
+        "x-rank": "metic+archon",
+        "x-source": "src/bongos/routes/modules.js",
+        "x-permissions": [
+          "module.delist"
+        ],
+        "parameters": [
+          {
+            "name": "key",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `key`."
+          },
+          {
+            "name": "version",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `version`."
+          }
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostStoreModulesKeyVersionsVersionReleaseRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostStoreModulesKeyVersionsVersionReleaseResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/store/modules/{key}/versions/{version}/tarball": {
       "get": {
         "operationId": "get_store_modules_key_versions_version_tarball",
@@ -27491,6 +27727,19 @@
           "rollups"
         ]
       },
+      "GetGovernmentAsksUnclearResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "matters": {}
+        },
+        "required": [
+          "ok",
+          "matters"
+        ]
+      },
       "GetGovernmentAssignmentsResponse": {
         "type": "object",
         "properties": {
@@ -31991,6 +32240,31 @@
           "route"
         ]
       },
+      "PostGovernmentAsksMatterIdUnclearRequest": {
+        "type": "object",
+        "properties": {
+          "note": {
+            "type": "string",
+            "maxLength": 500
+          }
+        },
+        "additionalProperties": false
+      },
+      "PostGovernmentAsksMatterIdUnclearResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "matter_id": {},
+          "flag": {}
+        },
+        "required": [
+          "ok",
+          "matter_id",
+          "flag"
+        ]
+      },
       "PostGovernmentAssignmentsRequest": {
         "type": "object",
         "properties": {
@@ -35126,6 +35400,35 @@
           "version_id"
         ]
       },
+      "PostStoreModulesKeyVersionsVersionReleaseRequest": {
+        "type": "object",
+        "properties": {
+          "reason": {
+            "type": "string",
+            "maxLength": 2000
+          }
+        },
+        "additionalProperties": false
+      },
+      "PostStoreModulesKeyVersionsVersionReleaseResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "module_key": {},
+          "version": {},
+          "channel": {},
+          "reason": {}
+        },
+        "required": [
+          "ok",
+          "module_key",
+          "version",
+          "channel",
+          "reason"
+        ]
+      },
       "PostStoreUsageReportingRequest": {
         "type": "object",
         "properties": {
@@ -36201,9 +36504,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 568,
-  "x-schema-count": 606,
+  "x-endpoint-count": 572,
+  "x-schema-count": 611,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 396,
+  "x-response-schemas": 399,
   "x-generated-by": "scripts/gds/gen-api-docs.js"
 }

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # Bongos API reference
 
-> **Generated from the live route files** — the route file is authoritative. 568 endpoints across 96 route files.
+> **Generated from the live route files** — the route file is authoritative. 572 endpoints across 96 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`.
@@ -343,13 +343,15 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/goals/rollups` | `any-builder` | — | GET /goals/rollups?version= — one small row per goal: readiness counters, the last-activity timestamp, the craft set, and the next claima… |
 | GET | `/api/bongos/goals/suggestions` | `any-builder` | — | GET /goals/suggestions — "which goal should this draft live in?", answered before anything is created (task 1003062 / R07). |
 
-## `government` (34)
+## `government` (36)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
 | PUT | `/api/bongos/government/asks/:matterId` | `any-builder` | — | board.vote.cast — put an ASK on a docket matter (task 1004703): the one shape every request from an agent to a person takes. |
 | POST | `/api/bongos/government/asks/:matterId/pass` | `any-builder` | `seat` | board.vote.cast — PASS AN ASK ON to another seat (task 1004705, the direction desk). |
+| POST | `/api/bongos/government/asks/:matterId/unclear` | `any-builder` | `note` | board.vote.cast — "I DON'T UNDERSTAND THIS" (the "?" on a city card, owner 2026-10-23): puts a matter the flagger can see on the reword l… |
 | POST | `/api/bongos/government/asks/check` | `any-builder` | — | board.vote.cast — CHECK an ask without storing it (task 1004703): the agent's dry run before it files. |
+| GET | `/api/bongos/government/asks/unclear` | `any-builder` | — | board.vote.cast — THE REWORD LIST: the open matters this viewer can see that someone flagged as unclear, oldest flag first, each with its… |
 | GET | `/api/bongos/government/assignments` | `archon` | — | government.manage — every builder↔rank assignment row. |
 | POST | `/api/bongos/government/assignments` | `archon` | `builder_id`, `rank_key` | government.manage — assign a CUSTOM rank to a builder. |
 | DELETE | `/api/bongos/government/assignments/:builderId/:rankKey` | `archon` | — | government.manage — remove a custom-rank assignment. |
@@ -857,7 +859,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/sso/pubkey` | `public` | — | GET /sso/pubkey — the hub's Ed25519 assertion-verification key (public). |
 | POST | `/api/bongos/sso/token` | `public` | `client_id`, `client_secret`, `code`, `redirect_uri` | POST /sso/token — server-to-server code redemption. |
 
-## `store` (15)
+## `store` (17)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -868,10 +870,12 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | POST | `/api/bongos/store/modules/:key/delist` | `metic+archon` | `reason` | POST /api/bongos/store/modules/:key/delist — a Metic+ person takes a module out of the store (task 1003797, ADR 0338 D2). |
 | GET | `/api/bongos/store/modules/:key/entitlement` | `any-builder` | — |  |
 | POST | `/api/bongos/store/modules/:key/versions` | `metic+archon` | _undocumented_ | POST /api/bongos/store/modules/:key/versions — publish one module version to the store (task 1004271, ADR 0338 D1). |
+| GET | `/api/bongos/store/modules/:key/versions/:version/channel` | `any-builder` | — | GET /api/bongos/store/modules/:key/versions/:version/channel — where a version stands on the promotion gate (task 1003804, ADR 0344 D3): … |
 | POST | `/api/bongos/store/modules/:key/versions/:version/error-count` | `any-builder` | `day`, `count` |  |
 | GET | `/api/bongos/store/modules/:key/versions/:version/howto` | `any-builder` | — | GET /api/bongos/store/modules/:key/versions/:version/howto — the how-to a version shipped with (task 1004366, ADR 0347 D1/D3), read from … |
 | POST | `/api/bongos/store/modules/:key/versions/:version/install-report` | `any-builder` | `ok`, `error_code` |  |
 | POST | `/api/bongos/store/modules/:key/versions/:version/reassess` | `metic+archon` | `reason` | POST /api/bongos/store/modules/:key/versions/:version/reassess — a Metic+ person asks for a published version's assessment to run again: … |
+| POST | `/api/bongos/store/modules/:key/versions/:version/release` | `metic+archon` | `reason` | POST /api/bongos/store/modules/:key/versions/:version/release — a Metic+ person releases a version the promotion gate HELD on tester (a t… |
 | GET | `/api/bongos/store/modules/:key/versions/:version/tarball` | `any-builder` | — |  |
 | GET | `/api/bongos/store/modules/latest` | `any-builder` | — | The newest published version of each named module — what `bongos upgrade` compares an instance's installed store modules against to repor… |
 | GET | `/api/bongos/store/usage-reporting` | `any-builder` | — | The caller's own reporting switch (Settings → Profile and privacy). |

package/docs/architecture.md

@@ -271,6 +271,8 @@ store_module_version_channels(id, version_id FK store_module_versions, channel F
               reason short code, set_by builder | NULL (system), set_at)
               -- history; newest row per version is current. Pre-existing versions were
               -- backfilled to general ('predates_staged_rollout').
+              -- idx_store_module_version_channels_current (version_id, set_at DESC, id DESC):
+              -- "current channel" is one index probe per version, never a table scan.
 ```
 
 Module entitlements (migration `core_259`, task 1003813 — who holds which module, at which version; the record install, update and the telemetry signals consult; it records ownership, never payment — area 8 owns money):