@bongos/core 1.19.936 → 1.19.937

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.936",
-  "core_contract": "1.19.936",
-  "source_commit": "c584621a2bdc28b094881d2a51384398c3062cfb",
+  "core_version": "1.19.937",
+  "core_contract": "1.19.937",
+  "source_commit": "2aee2eb9e23c44abf42a24b09f9603555ba33673",
   "source_ref": "HEAD",
-  "built_at": "2026-09-21T04:31:32.976Z",
+  "built_at": "2026-09-21T05:57:31.197Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 511,
     "agent_docs_stubbed": 26,
-    "functional_verbatim": 2329,
+    "functional_verbatim": 2334,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 2866,
-  "tree_sha256": "04c64a49cb815692ebbc6ee7382d47e4a296616b707d8e566e0894bf52364655",
+  "file_count": 2871,
+  "tree_sha256": "026277292d3a56e019a060c711325a482164c64ae62daa9c92ee820321bd0a81",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -347,12 +347,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "56d3e08ff4e4893d4d6b30c9292f2c1b0730deb2bff99ea64d7d5df7971995c1"
+      "sha256": "ce2ce4bd71f9ea04c46e8c1f4e7173a941458162be0e3b32759aa0c5f9d97297"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "7cfab2d88dc9d36fc57334db3b43c0c31b3656e2bff7ebff11d0c18b12a61850"
+      "sha256": "47d36e3b0c228706df44c4a91d5b22bd6005a345c95d8ddda2650bf9b8170242"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -362,17 +362,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "8a5ed1946540c3adb30ff986f1845bdc65b5a6e441698723f8c31eb8e1374ef2"
+      "sha256": "5368fb77dc06a2ea22ab2db87ec3ac89a9857388bc12117c31dc327e598f63a1"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "61b51506067b743fef5b475bf3b61914054d18474c0f8368d0bc4520a591ab6d"
+      "sha256": "5d076131337103c34e8b0e46cd613ae898dfa9edeffa6104617f046eb4f651b0"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "7676427e266c9528793e47c3c9431c329b67f0b29edff522724f430b4c29a37f"
+      "sha256": "2e7178e059cb520cf0509a46151624bb00160cc2cd263582015980576b98482d"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2112,12 +2112,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "eb6f7b98ac6b54bdfb35adf224c47de318d5c07aa064276d98bb023633a79ded"
+      "sha256": "d72a950df3fa37b7834a167d60e621434a0d0806f1a3f298b079d0538254be50"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "257966d20d4076a5b3e96e95f1966971a7df6a3218212ee57e980b9adc89a83f"
+      "sha256": "f89f852f211ffee8ccc13f4331fc867837eae6b6ac2a0a24292abc4537aa9591"
     },
     {
       "path": "docs/architecture.md",
@@ -2677,7 +2677,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "cce34badfbc776279489f414db3459706aeb2433726a0d4b1e9d7dd84c5f4731"
+      "sha256": "3fddd5b37bb0a00a12bf88b81992eb2510e0115b8cc7f67c8fd67c51b65ae678"
     },
     {
       "path": "docs/modules-contract.md",
@@ -4317,7 +4317,7 @@
     {
       "path": "modules/government/board.js",
       "mode": "0000644",
-      "sha256": "22b5c7a2f2b41faa222281e1ad9acb1aebed074b065de892c7550f628900d6c2"
+      "sha256": "cce76edcf96a8ece8bb3321f5edb505e0e93acae96babe7169da607fd1888f3b"
     },
     {
       "path": "modules/government/catalog.js",
@@ -4332,7 +4332,7 @@
     {
       "path": "modules/government/db.js",
       "mode": "0000644",
-      "sha256": "10363058d52e097ac4e0f8cdb3957062d446840f42c2ca65ef95b541b6e27aad"
+      "sha256": "dc56a5747bb5275ba372dc297cce585219c649984778a924ce22bab7249889a8"
     },
     {
       "path": "modules/government/membership-predicate.js",
@@ -4459,6 +4459,11 @@
       "mode": "0000644",
       "sha256": "7603087ac279d05eb2c69527557035c72c3bbb1510c16fdb2230b2e377f0df74"
     },
+    {
+      "path": "modules/government/migrations/government_018_passed_items_index.sql",
+      "mode": "0000644",
+      "sha256": "c85b1615c66ae68b630c727faa6ab56358a35dea37a0c2da507d11d3909176fd"
+    },
     {
       "path": "modules/government/module.json",
       "mode": "0000644",
@@ -4492,7 +4497,7 @@
     {
       "path": "modules/government/routes/government.js",
       "mode": "0000644",
-      "sha256": "6c38766b7b2a76a5fc035ad4eefce41fe45739730e70fb26b40546bded7b66b9"
+      "sha256": "40c2cd95481690b88a065afad62636ae732845a5dc81f082ebd623f7fb060de4"
     },
     {
       "path": "modules/government/routes/rank-sync.js",
@@ -5462,7 +5467,7 @@
     {
       "path": "modules/ideas/inbox.js",
       "mode": "0000644",
-      "sha256": "b56a305c8c3b269e6a273b8f1c56da745bc91a57b1028f5c1d2ee33735e3c68d"
+      "sha256": "da8ac68f553980fef162b7d9fbc85481fd60cd885954cf316894a132f845ef6c"
     },
     {
       "path": "modules/ideas/landing-preview.js",
@@ -5514,10 +5519,15 @@
       "mode": "0000644",
       "sha256": "53c66f25e685931e73334d6b904f7d3c0f3838a15f160bd5387864ef27836aa7"
     },
+    {
+      "path": "modules/ideas/migrations/ideas_010_goal_ratification.sql",
+      "mode": "0000644",
+      "sha256": "7ba109e2f5415daec8b0767ecfabb110fc02d8944f4e6cc0664ca2d205e05480"
+    },
     {
       "path": "modules/ideas/module.json",
       "mode": "0000644",
-      "sha256": "c23099e7c3a4768dc68778292c42988ee21234ed81d1832347e9fd272f6137d9"
+      "sha256": "a869f9dec25e003006a495b3fbee45ac99c80b306cec7f16808693d70133e717"
     },
     {
       "path": "modules/ideas/pollers/descent-writer.js",
@@ -5532,7 +5542,7 @@
     {
       "path": "modules/ideas/ratify.js",
       "mode": "0000644",
-      "sha256": "2988a93940cd1eba73fb0c9e04f8326108466ba81901f86b3768b29115f17237"
+      "sha256": "05789550a8e6345f27ac78ccef3ac93a7837e99a6b067871189b1e983b4d374f"
     },
     {
       "path": "modules/ideas/reads.js",
@@ -5549,6 +5559,11 @@
       "mode": "0000644",
       "sha256": "da91fe0641109b3b8adc0cca44480337f15cbd481b590f42d022e9eaa78654b7"
     },
+    {
+      "path": "modules/ideas/routes/ratify-goal.js",
+      "mode": "0000644",
+      "sha256": "92c10dbffef40038dac64ea646372e3fcd1c70c5d2bda1d731ddbdcd508d9181"
+    },
     {
       "path": "modules/ideas/routing.js",
       "mode": "0000644",
@@ -5562,7 +5577,7 @@
     {
       "path": "modules/ideas/templates.js",
       "mode": "0000644",
-      "sha256": "deef66d514a2ea090274acc05e85ffefdfd6c0bf0279b64f7bee16af7b2e1471"
+      "sha256": "345cbf4d87be780ee98c33042d2ec914b40bceeab6122a67a00a3852580b681b"
     },
     {
       "path": "modules/ideas/trail-descent.js",
@@ -5769,6 +5784,11 @@
       "mode": "0000644",
       "sha256": "c22a0782ddf7a93deb40f700a2afab15a313925647bbdf424db777da5aa29aa1"
     },
+    {
+      "path": "modules/lifecycle/goal-from-idea.js",
+      "mode": "0000644",
+      "sha256": "21d091ef596bc67f08a4f0785d17eaddf47d2da702219ccd5af6164413944428"
+    },
     {
       "path": "modules/lifecycle/goal-rollup.js",
       "mode": "0000644",
@@ -5802,7 +5822,7 @@
     {
       "path": "modules/lifecycle/lifecycle.js",
       "mode": "0000644",
-      "sha256": "41ef55efff7f334ee8b19490f03944ca25f22454c718dfb81445539bc6a77aa4"
+      "sha256": "74e09c7d1a978da826f99cff9e863b1051ab19a6437ae398a1e83ec8293e794f"
     },
     {
       "path": "modules/lifecycle/merge-lock.js",
@@ -7982,12 +8002,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "50c742fdaa94ee84b79406b7654fc544f6c355c71e5664e6431785c8fbe882b3"
+      "sha256": "f1999bdf0489eddf32aabd9a5d2aec6b82bd9765a598e0eff299c31a367b6ff6"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "62828bf612cefb41d1c28f7d331d711d2cc2ed5575f6ce506b410c007e47bccb"
+      "sha256": "0be6855a6ff73d2592bff19899727f708abd44265f2ea4538cc48491982a5aac"
     },
     {
       "path": "public-docs/index.html",
@@ -9987,7 +10007,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "ab8bbe4ee49dbf220c6a5550d22c38ef22ea41988b50d8774933e297fc93f496"
+      "sha256": "546941331565d646b5b815a2a66c4833993abd3affcd2ba309ddad87191d766a"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -11687,7 +11707,7 @@
     {
       "path": "tests/government_seed.mjs",
       "mode": "0000644",
-      "sha256": "e31b024ce9a64a13737a32720ba7bef3d92f2644f56581143965afb1bb65f1fd"
+      "sha256": "e165fe5c67ee4e80c58f489514ac77ba34e51984dabd2329ecdd70052b81a9cc"
     },
     {
       "path": "tests/government_session_scope.mjs",
@@ -12064,6 +12084,11 @@
       "mode": "0000644",
       "sha256": "63afe2afd59ff64e290234a0cc8d33a0f77b784d8c10c2d7147fe2ab3c114cd1"
     },
+    {
+      "path": "tests/idea_goal_ratification.mjs",
+      "mode": "0000644",
+      "sha256": "3c624db8e11ae02f503d19c6b2556b286d3ca59229daacd6ea2319782530c84f"
+    },
     {
       "path": "tests/idea_governance_pass_credit.mjs",
       "mode": "0000644",

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`)
-- 403 operations across 61 resource groups
+- 404 operations across 61 resource groups
 
 ## Use it from your project
 

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

@@ -511,6 +511,8 @@ function createClient(opts = {}) {
       postInboxIdDevelop: (args) => request("POST", "/inbox/{id}/develop", { hasBody: true }, args),
       // POST /inbox/{id}/ratify — rank: metic+archon — POST /inbox/:id/ratify
       postInboxIdRatify: (args) => request("POST", "/inbox/{id}/ratify", { hasBody: true }, args),
+      // POST /inbox/{id}/ratify-goal — rank: metic+archon — POST /inbox/:id/ratify-goal
+      postInboxIdRatifyGoal: (args) => request("POST", "/inbox/{id}/ratify-goal", { hasBody: true }, args),
       // POST /inbox/{id}/resubmit — rank: any-builder — POST /inbox/:id/resubmit
       postInboxIdResubmit: (args) => request("POST", "/inbox/{id}/resubmit", { hasBody: true }, args),
       // DELETE /inbox/{id}/spark — rank: any-builder — DELETE /inbox/:id/spark

package/clients/bongos-client/index.cjs

@@ -510,6 +510,8 @@ function createClient(opts = {}) {
       postInboxIdDevelop: (args) => request("POST", "/inbox/{id}/develop", { hasBody: true }, args),
       // POST /inbox/{id}/ratify — rank: metic+archon — POST /inbox/:id/ratify
       postInboxIdRatify: (args) => request("POST", "/inbox/{id}/ratify", { hasBody: true }, args),
+      // POST /inbox/{id}/ratify-goal — rank: metic+archon — POST /inbox/:id/ratify-goal
+      postInboxIdRatifyGoal: (args) => request("POST", "/inbox/{id}/ratify-goal", { hasBody: true }, args),
       // POST /inbox/{id}/resubmit — rank: any-builder — POST /inbox/:id/resubmit
       postInboxIdResubmit: (args) => request("POST", "/inbox/{id}/resubmit", { hasBody: true }, args),
       // DELETE /inbox/{id}/spark — rank: any-builder — DELETE /inbox/:id/spark

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

@@ -323,6 +323,7 @@ export interface PostGovernmentRanksResponse { rank: unknown }
 export interface PostHelpRequestsRequest { needs_craft?: string; needs_builder_id?: number; what_is_stuck: string; task_id?: number; goal_id?: number }
 export interface PostHelpRequestsResponse { ok: boolean; help_request: unknown }
 export interface PostInboxIdDevelopRequest { field_values: Record<string, unknown>; template_key?: string; recommendation?: string }
+export interface PostInboxIdRatifyGoalRequest { target_version: string; scope_modules?: string[]; admit_reason?: string; notes_md?: string }
 export interface PostInboxIdRatifyRequest { notes_md?: string }
 export interface PostInboxIdResubmitRequest { field_values: Record<string, unknown>; template_key?: string; recommendation?: string }
 export interface PostInboxIdSparkResponse { idea: unknown; sparked: boolean; unchanged: boolean }
@@ -886,6 +887,8 @@ export interface BongosClient {
     postInboxIdDevelop(args: RequestArgs & { body: PostInboxIdDevelopRequest }): Promise<ApiResponse>;
     /** POST /inbox/{id}/ratify — rank: metic+archon */
     postInboxIdRatify(args?: RequestArgs & { body?: PostInboxIdRatifyRequest }): Promise<ApiResponse>;
+    /** POST /inbox/{id}/ratify-goal — rank: metic+archon */
+    postInboxIdRatifyGoal(args: RequestArgs & { body: PostInboxIdRatifyGoalRequest }): Promise<ApiResponse>;
     /** POST /inbox/{id}/resubmit — rank: any-builder */
     postInboxIdResubmit(args: RequestArgs & { body: PostInboxIdResubmitRequest }): Promise<ApiResponse>;
     /** DELETE /inbox/{id}/spark — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -507,6 +507,8 @@ export function createClient(opts = {}) {
       postInboxIdDevelop: (args) => request("POST", "/inbox/{id}/develop", { hasBody: true }, args),
       // POST /inbox/{id}/ratify — rank: metic+archon — POST /inbox/:id/ratify
       postInboxIdRatify: (args) => request("POST", "/inbox/{id}/ratify", { hasBody: true }, args),
+      // POST /inbox/{id}/ratify-goal — rank: metic+archon — POST /inbox/:id/ratify-goal
+      postInboxIdRatifyGoal: (args) => request("POST", "/inbox/{id}/ratify-goal", { hasBody: true }, args),
       // POST /inbox/{id}/resubmit — rank: any-builder — POST /inbox/:id/resubmit
       postInboxIdResubmit: (args) => request("POST", "/inbox/{id}/resubmit", { hasBody: true }, args),
       // DELETE /inbox/{id}/spark — rank: any-builder — DELETE /inbox/:id/spark

package/docs/api/openapi.json

@@ -8979,6 +8979,65 @@
         ]
       }
     },
+    "/inbox/{id}/ratify-goal": {
+      "post": {
+        "operationId": "post_inbox_id_ratify_goal",
+        "tags": [
+          "inbox"
+        ],
+        "summary": "POST /inbox/:id/ratify-goal",
+        "description": "BV2.R17 (task 1004096, spec R23, goal 1000095) — ratify a FULL IDEA into a GOAL, atomically: - INSERT goals (title from the idea, description = its five answers) - INSERT done_when_criteria on that goal from the \"what does a successful implementation look like\" answer - UPDATE idea_inbox SET status='promoted', reviewed_at=now() - INSERT ideas_goal_ratifications — who ratified, under which board decision, with the author's own recommendation recorded beside it All of it in one transaction; a partial failure rolls back to an open idea. A SEPARATE ROUTE FROM /ratify, not a mode of it. The two take different subjects (a `criterion-proposal` idea whose body_md is JSON vs. a graded Full Idea whose answers are prose), produce different rows, and differ on whether the board has a say. One route with a discriminator would have to document which half of its own body applies, and a caller who got the discriminator wrong would be told about a field rather than about the act. THE SCOPE AND THE VERSION COME FROM THE REQUEST because nothing else can supply them: no prose answer says which version a goal belongs to or which modules it may touch. THE GATES DO NOT come from the request — the handler passes the caller's LIVE rank through to the lifecycle port, which applies every check POST /goals applies (unknown module key, protected scope → Archon, a building version's goal set closed without a named Archon admission). `idea.ratify`'s floor is Metic, so those gates are load-bearing here rather than ceremonial. Statuses: 400 a bad body / an unratifiable idea / an unmappable template · 403 a rank gate · 404 no such idea · 409 the idea is not open, the board has not passed it, the version will not take a goal, or it is already ratified.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `idea.ratify` (all required).",
+        "x-rank": "metic+archon",
+        "x-source": "modules/ideas/routes/ratify-goal.js",
+        "x-permissions": [
+          "idea.ratify"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `id`."
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostInboxIdRatifyGoalRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/inbox/{id}/resubmit": {
       "post": {
         "operationId": "post_inbox_id_resubmit",
@@ -23241,6 +23300,36 @@
         ],
         "additionalProperties": false
       },
+      "PostInboxIdRatifyGoalRequest": {
+        "type": "object",
+        "properties": {
+          "target_version": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64
+          },
+          "scope_modules": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 64
+          },
+          "admit_reason": {
+            "type": "string",
+            "minLength": 8,
+            "maxLength": 500
+          },
+          "notes_md": {
+            "type": "string",
+            "maxLength": 10000
+          }
+        },
+        "required": [
+          "target_version"
+        ],
+        "additionalProperties": false
+      },
       "PostInboxIdRatifyRequest": {
         "type": "object",
         "properties": {
@@ -25564,8 +25653,8 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 403,
-  "x-schema-count": 442,
+  "x-endpoint-count": 404,
+  "x-schema-count": 443,
   "x-undocumented-bodies": 9,
   "x-response-schemas": 301,
   "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. 403 endpoints across 65 route files.
+> **Generated from the live route files** — the route file is authoritative. 404 endpoints across 66 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`.
@@ -337,7 +337,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/help-requests/for-me` | `any-builder` | — | The addressed read — C01's answer to "and fires a notification". |
 | GET | `/api/bongos/help-requests/mine` | `any-builder` | — | your own asks, so you can settle them. |
 
-## `inbox` (17)
+## `inbox` (18)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -348,6 +348,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | PATCH | `/api/bongos/inbox/:id/body` | `any-builder` | `body_md` | Metic+ (task 360 / ADR 0018): idea triage (promote/discard/merge) shapes the backlog. |
 | POST | `/api/bongos/inbox/:id/develop` | `any-builder` | `field_values`, `template_key`, `recommendation` | POST /inbox/:id/develop — DEVELOP A SPARK INTO A FULL IDEA (task 1002922 / BV1.R146, goal 1000062). |
 | POST | `/api/bongos/inbox/:id/ratify` | `metic+archon` | `notes_md` | V3.R31 (task 252) — Archon ratifies a criterion-proposal idea, atomically: - INSERT done_when_criteria row on the target version - UPDATE… |
+| POST | `/api/bongos/inbox/:id/ratify-goal` | `metic+archon` | `target_version`, `scope_modules`, `admit_reason`, `notes_md` | BV2.R17 (task 1004096, spec R23, goal 1000095) — ratify a FULL IDEA into a GOAL, atomically: - INSERT goals (title from the idea, descrip… |
 | POST | `/api/bongos/inbox/:id/resubmit` | `any-builder` | `field_values`, `template_key`, `recommendation` | RESUBMIT a Full Idea after a rejection (R13 of goal 1000069, criterion C2: an idea never dies and never stalls). |
 | POST | `/api/bongos/inbox/:id/spark` | `any-builder` | — | Mark a Quick Idea as a Big Idea Spark — "I have the spark but not the full picture, someone develop this". |
 | DELETE | `/api/bongos/inbox/:id/spark` | `any-builder` | — | Withdraw the Big Idea Spark mark — the reversibility half of R144. |

package/docs/module-api-changelog.md

@@ -2346,5 +2346,7 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.19.934 with no explicit bump. run 35558269194. (task 1002620)
   1.19.936 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.19.935 with no explicit bump. run 35561285958. (task 1002620)
+  1.19.937 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.19.936 with no explicit bump. run 35566446478. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/modules/government/board.js

@@ -1041,6 +1041,36 @@ async function latestRejectionForIdea(ideaId) {
   });
 }
 
+// ── BV2.R17's read: did the board CARRY this idea? (task 1004096) ───────────
+//
+// The ratification half of the ideator surface turns a Full Idea into a goal,
+// and spec decision 9 is that the ideator RECOMMENDS while the board DECIDES.
+// The ideas module holds the author's recommendation on its own grade row, so
+// without this read "the board decides" would be a sentence in a comment: the
+// only fact stopping a ratification from being one person's opinion is that a
+// sitting actually closed `passed`.
+//
+// Null means "no passing decision on record", which the caller must treat as a
+// refusal and never as an absence it may work around. A returned item, an item
+// still open, and an idea that never reached the board all read the same here,
+// on purpose — none of them is a mandate, and distinguishing them would invite a
+// caller to accept one of them.
+//
+// Frozen, like latestRejectionForIdea, so a caller cannot decorate the record of
+// a decision and pass it on as though the board had said more than it did.
+async function boardPassForIdea(ideaId) {
+  const id = Number(ideaId);
+  if (!Number.isFinite(id) || id <= 0) return null;
+  const row = await db.getLatestPassedItem('full_idea', id);
+  if (!row) return null;
+  return Object.freeze({
+    item_id: row.item_id,
+    outcome: 'passed',
+    opened_at: row.opened_at,
+    closed_at: row.closed_at,
+  });
+}
+
 // ── the summons: what is waiting on THIS member's vote (task 1003271) ───────
 //
 // THE PROBLEM THIS EXISTS TO FIX. Nine items sat open for two days with zero
@@ -1127,6 +1157,7 @@ module.exports = {
   closeItem,
   maybeCloseAfterVote,
   latestRejectionForIdea,
+  boardPassForIdea,
   validateProposedConstitution,
   proposeAmendment,
   boardRoomView,

package/modules/government/db.js

@@ -610,6 +610,38 @@ async function getLatestReturnedItemWithObjection(subjectType, subjectId) {
   return rows[0] || null;
 }
 
+// BV2.R17's read (task 1004096): the most recent PASSED item for a subject.
+//
+// The mirror of getLatestReturnedItemWithObjection above, and the reason it
+// exists separately rather than as a `outcome` parameter on that one: the
+// returned read exists to carry an OBJECTION back to an author and joins the
+// votes table to find it, while this one exists to answer a single yes/no —
+// "did the board carry this?" — and must not depend on any vote row existing.
+// A passed item commonly has NO votes at all (a zero-vote sitting passes under
+// the absence rules, ADR 0175 §3), so the LEFT JOIN that is merely defensive
+// there would be load-bearing here, which is a good sign the two are different
+// questions.
+//
+// Ordering is closed_at DESC, id DESC: an idea returned once and resubmitted can
+// have several closed items, and it is the latest decision that stands.
+//
+// Served by the partial index `government_board_items_passed_by_subject`
+// (government_018), the mirror of government_006's index for the returned read.
+// It needs its own: the table only grows, government_003's two indexes both key
+// on OPEN items and government_008's keys on closed_at alone for the whole-board
+// history feed, so none of them helps a lookup filtered by subject.
+async function getLatestPassedItem(subjectType, subjectId) {
+  const { rows } = await pool.query(
+    `SELECT id AS item_id, closed_at, opened_at, constitution AS decided_under
+       FROM government_board_items
+      WHERE subject_type = $1 AND subject_id = $2 AND outcome = 'passed'
+      ORDER BY closed_at DESC, id DESC
+      LIMIT 1`,
+    [subjectType, subjectId],
+  );
+  return rows[0] || null;
+}
+
 // The expiry sweep's read (R11): every OPEN item whose deadline has passed, on
 // the database clock, oldest deadline first. Served by the partial index
 // government_board_items_open_by_deadline (government_003 built it for exactly
@@ -728,6 +760,7 @@ module.exports = {
   getIdeaCompleteness,
   getExpiredOpenBoardItems,
   getLatestReturnedItemWithObjection,
+  getLatestPassedItem,
   createAmendment,
   getAmendment,
   listOpenBoardItems,

package/modules/government/migrations/government_018_passed_items_index.sql

@@ -0,0 +1,31 @@
+-- government_018_passed_items_index.sql — index the passed-item lookup
+-- (task 1004096 / BV2.R17; a grader efficiency finding, and right — exactly as
+-- government_006 was for the sibling read one outcome over).
+--
+-- `getLatestPassedItem` answers "did the board CARRY this subject?" and runs on
+-- every Full-Idea→goal ratification. It is the mirror of
+-- `getLatestReturnedItemWithObjection`, and it inherits that read's problem in
+-- full: `government_board_items` only grows — one row per window, and a
+-- returned idea can be resubmitted without bound — while the table's two
+-- OPEN-item indexes (`government_003`) both key on `closed_at IS NULL` and the
+-- one closed-item index (`government_008`) keys on `closed_at` alone, for the
+-- whole-board history feed. None of them helps a lookup that filters by
+-- subject. Without this, a ratification scans historical volume that scales
+-- with every sitting the project has ever held.
+--
+-- Partial on outcome='passed' — the only outcome this read asks for — and keyed
+-- (subject_type, subject_id, closed_at DESC) to match the query's WHERE and
+-- ORDER BY exactly, the government_006 shape. Two narrow partial indexes rather
+-- than one wider index over `outcome`: each read asks for exactly one outcome
+-- and never ranges across them, so a shared index would be larger and no more
+-- useful to either.
+--
+-- Additive, idempotent, no rows touched — safe on any database state.
+
+BEGIN;
+
+CREATE INDEX IF NOT EXISTS government_board_items_passed_by_subject
+  ON government_board_items (subject_type, subject_id, closed_at DESC)
+  WHERE outcome = 'passed';
+
+COMMIT;

package/modules/government/routes/government.js

@@ -103,6 +103,13 @@ const governmentPort = {
   // resubmit path in modules/ideas resolves this to show what was objected to
   // and to check whether the flagged section actually changed.
   latestRejectionForIdea: board.latestRejectionForIdea,
+  // BV2.R17 (task 1004096): the record of the board having CARRIED an idea, or
+  // null. The ideas module's ratification path resolves this to check the one
+  // fact that makes turning a Full Idea into a goal a board decision rather
+  // than a ratifier's preference. Read-only, like every other entry here — there
+  // is no counterpart that records an outcome, and there must never be one: an
+  // outcome is written by a close, never by the module reading it.
+  boardPassForIdea: board.boardPassForIdea,
 };
 
 function registerSeams() {

package/modules/ideas/inbox.js

@@ -848,4 +848,15 @@ module.exports = {
   parseProposalBody: ratify.parseProposalBody,
   KARMA_RATIFY_DELTA: ratify.KARMA_RATIFY_DELTA,
   KARMA_RATIFY_REASON: ratify.KARMA_RATIFY_REASON,
+  // Full-Idea → GOAL ratification, the goal half beside it (task 1004096 /
+  // BV2.R17); see ratify.js on why the two halves are not symmetrical.
+  //
+  // ONLY THE TRANSACTION IS RE-EXPORTED. `composeGoalFromFullIdea` and
+  // `GOAL_SHAPE_BY_TEMPLATE` are deliberately NOT on the facade: nothing outside
+  // ratify.js calls either, and a re-export no caller needs is an unused export
+  // the dead-code ratchet counts. The facade's job is to keep the ~20 callers of
+  // the pre-carve surface working, not to publish everything a new file declares
+  // — anything that wants the pure composer requires ./ratify directly, as the
+  // test does.
+  ratifyFullIdeaAsGoal: ratify.ratifyFullIdeaAsGoal,
 };