@bongos/core 1.19.935 → 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.935",
-  "core_contract": "1.19.935",
-  "source_commit": "b3b2e4e86881e90300f7b23d75f5e1508eb2bf81",
+  "core_version": "1.19.937",
+  "core_contract": "1.19.937",
+  "source_commit": "2aee2eb9e23c44abf42a24b09f9603555ba33673",
   "source_ref": "HEAD",
-  "built_at": "2026-09-21T03:42:26.193Z",
+  "built_at": "2026-09-21T05:57:31.197Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 511,
     "agent_docs_stubbed": 26,
-    "functional_verbatim": 2327,
+    "functional_verbatim": 2334,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 2864,
-  "tree_sha256": "e3c4fa4ce99958763ab765d6846942c8fad965add8df64e1f54a7e375806c926",
+  "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": "e84a082d51b6f1e3890886a087763ec155fa31d17ac697a291e557df5bce2345"
+      "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": "8c709c0a86391ef42df7c594087d8ebe77bb26c19b8f92f95a21c19da30de87e"
+      "sha256": "d72a950df3fa37b7834a167d60e621434a0d0806f1a3f298b079d0538254be50"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "6e2d8fc4d48d267ee7b16a81f48651c6d19dfa55716d7736c92e5cb734cc6b4f"
+      "sha256": "f89f852f211ffee8ccc13f4331fc867837eae6b6ac2a0a24292abc4537aa9591"
     },
     {
       "path": "docs/architecture.md",
@@ -2142,12 +2142,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "6b522b8315ca83fe72a7b4848c1a079149c8ba3804ace7de85b5fb2936e6de66"
+      "sha256": "26af5ed255669bbd57112d663e6206c6ff1f13a5dc728851ad9c1a8901dbff05"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "4ff37259be59178b608d303df04a9c6717c297ec22138815ef0066ac5fc16849"
+      "sha256": "25916cf25193f4153694b24f0fd9a120f4dc966fbf8ec73aec21565565cfac2c"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2677,7 +2677,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "4c9bccb55d99dc3c2588b73ae95d365511eb433e27265822725aeed38420992b"
+      "sha256": "3fddd5b37bb0a00a12bf88b81992eb2510e0115b8cc7f67c8fd67c51b65ae678"
     },
     {
       "path": "docs/modules-contract.md",
@@ -4317,7 +4317,7 @@
     {
       "path": "modules/government/board.js",
       "mode": "0000644",
-      "sha256": "00183b9c1b2e822ac8da6a156daab8242f1997de2c1171bd7581961ee6c214e5"
+      "sha256": "cce76edcf96a8ece8bb3321f5edb505e0e93acae96babe7169da607fd1888f3b"
     },
     {
       "path": "modules/government/catalog.js",
@@ -4332,7 +4332,7 @@
     {
       "path": "modules/government/db.js",
       "mode": "0000644",
-      "sha256": "99be259855d63808adca140222eaf8563cff054b06ecc1acdd49594fcfc129fe"
+      "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",
@@ -4692,7 +4697,7 @@
     {
       "path": "modules/hall-ui/public/board-room.css",
       "mode": "0000644",
-      "sha256": "863c8af438be96097a63555d4573baec2b3a0bbdc73c1d23366cf5484189fb8a"
+      "sha256": "0487726b9c742550164e2c974c146a1715caa9dcb855ab3da5c53d07444bbca2"
     },
     {
       "path": "modules/hall-ui/public/board-room.html",
@@ -4702,7 +4707,7 @@
     {
       "path": "modules/hall-ui/public/board-room.js",
       "mode": "0000644",
-      "sha256": "0345390d8da4270b6f33b1a4e4469b10ec59a49de652567cb678ecc79a8fe093"
+      "sha256": "e5cfe87a21297ce1c61132b7b98f43edf07fdaf8075be6e219d09c279bfb836e"
     },
     {
       "path": "modules/hall-ui/public/board-room.states.json",
@@ -4982,17 +4987,17 @@
     {
       "path": "modules/hall-ui/public/ideas.css",
       "mode": "0000644",
-      "sha256": "57a41781c81b02cbac7b30a0a13f50f4a913e55f348d84cfc4244a99372932c2"
+      "sha256": "8d93461c423e176f8a2aee3bc6c9b0e9d0187d6ff811cedd6b2e32866aed39a3"
     },
     {
       "path": "modules/hall-ui/public/ideas.html",
       "mode": "0000644",
-      "sha256": "1ca434b944e917e075fd86c0806b4781b6e8f3ddb2454d11540d070715d288e3"
+      "sha256": "c27d6509ee5c8ac7937d7ee7b421359c3fabe835e0db583ab59b52e8b5c3aa19"
     },
     {
       "path": "modules/hall-ui/public/ideas.js",
       "mode": "0000644",
-      "sha256": "54fa21caf9ab7173952e9b84d60e6334743f749044c8b226cd21277f7dec574e"
+      "sha256": "2f532cacb06f0f074c15101c16578f3183104042644d6c8aa0d2e80fdb425b2f"
     },
     {
       "path": "modules/hall-ui/public/ideas.states.json",
@@ -5447,7 +5452,7 @@
     {
       "path": "modules/ideas/grades.js",
       "mode": "0000644",
-      "sha256": "a445024a9da1f91d1b5842066599e12422f6252a71fd0c30c4a60c2ecfb6ae51"
+      "sha256": "e968d10ee2c1ed682e09f823ff67951bbcf3323dc34322208cff987df7de9fbb"
     },
     {
       "path": "modules/ideas/homeless-home.js",
@@ -5462,7 +5467,7 @@
     {
       "path": "modules/ideas/inbox.js",
       "mode": "0000644",
-      "sha256": "14194ba97438709fbf4628c87760cfc46c2c9a5c4531ef81515296f99cb6edf7"
+      "sha256": "da8ac68f553980fef162b7d9fbc85481fd60cd885954cf316894a132f845ef6c"
     },
     {
       "path": "modules/ideas/landing-preview.js",
@@ -5509,10 +5514,20 @@
       "mode": "0000644",
       "sha256": "4c404d3bd264bb326fb28572e999b081636e81fd6a16b923c86df49854df8061"
     },
+    {
+      "path": "modules/ideas/migrations/ideas_009_recommendation.sql",
+      "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",
@@ -5522,12 +5537,12 @@
     {
       "path": "modules/ideas/projection.js",
       "mode": "0000644",
-      "sha256": "ba49f771b9bc1fcf64e0df3ba3bd9a53717f20ae9ccb8f6592bc10b96467eb20"
+      "sha256": "95ee83106b484d24fb60e1411a2d2616dfc9670eecdb174bbae4bb47a70cd3ff"
     },
     {
       "path": "modules/ideas/ratify.js",
       "mode": "0000644",
-      "sha256": "2988a93940cd1eba73fb0c9e04f8326108466ba81901f86b3768b29115f17237"
+      "sha256": "05789550a8e6345f27ac78ccef3ac93a7837e99a6b067871189b1e983b4d374f"
     },
     {
       "path": "modules/ideas/reads.js",
@@ -5542,7 +5557,12 @@
     {
       "path": "modules/ideas/routes/inbox.js",
       "mode": "0000644",
-      "sha256": "1caa8ca38d0dc26f3411be63596f6522d1ea4177f6cb74ebc3fa07e3d8f2876a"
+      "sha256": "da91fe0641109b3b8adc0cca44480337f15cbd481b590f42d022e9eaa78654b7"
+    },
+    {
+      "path": "modules/ideas/routes/ratify-goal.js",
+      "mode": "0000644",
+      "sha256": "92c10dbffef40038dac64ea646372e3fcd1c70c5d2bda1d731ddbdcd508d9181"
     },
     {
       "path": "modules/ideas/routing.js",
@@ -5557,7 +5577,7 @@
     {
       "path": "modules/ideas/templates.js",
       "mode": "0000644",
-      "sha256": "deef66d514a2ea090274acc05e85ffefdfd6c0bf0279b64f7bee16af7b2e1471"
+      "sha256": "345cbf4d87be780ee98c33042d2ec914b40bceeab6122a67a00a3852580b681b"
     },
     {
       "path": "modules/ideas/trail-descent.js",
@@ -5764,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",
@@ -5797,7 +5822,7 @@
     {
       "path": "modules/lifecycle/lifecycle.js",
       "mode": "0000644",
-      "sha256": "41ef55efff7f334ee8b19490f03944ca25f22454c718dfb81445539bc6a77aa4"
+      "sha256": "74e09c7d1a978da826f99cff9e863b1051ab19a6437ae398a1e83ec8293e794f"
     },
     {
       "path": "modules/lifecycle/merge-lock.js",
@@ -7977,12 +8002,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "cc78b4e84d90eba27a329d88ae83b507df318962b057d9281c3cc1b858063e05"
+      "sha256": "f1999bdf0489eddf32aabd9a5d2aec6b82bd9765a598e0eff299c31a367b6ff6"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "12f2fd99b6ac30b3bd8a443f576cf083c97eee82623b4392b714b107ab0c666b"
+      "sha256": "0be6855a6ff73d2592bff19899727f708abd44265f2ea4538cc48491982a5aac"
     },
     {
       "path": "public-docs/index.html",
@@ -9982,7 +10007,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "fe49958cdbfc0121ca262cd95b1fef21fc3028aa5da19250fb4bab2e68e42ccd"
+      "sha256": "546941331565d646b5b815a2a66c4833993abd3affcd2ba309ddad87191d766a"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -11562,7 +11587,7 @@
     {
       "path": "tests/government_board_view.mjs",
       "mode": "0000644",
-      "sha256": "827d743080201f11b2282aaa77d37149aaddaddc42b2b444c260a2696a7727ca"
+      "sha256": "035295e2dda0f0352eec6981b08e1b7b5259cdd8f1bf1aee161690e1fb7c682f"
     },
     {
       "path": "tests/government_board_vote.mjs",
@@ -11682,7 +11707,7 @@
     {
       "path": "tests/government_seed.mjs",
       "mode": "0000644",
-      "sha256": "e31b024ce9a64a13737a32720ba7bef3d92f2644f56581143965afb1bb65f1fd"
+      "sha256": "e165fe5c67ee4e80c58f489514ac77ba34e51984dabd2329ecdd70052b81a9cc"
     },
     {
       "path": "tests/government_session_scope.mjs",
@@ -12047,7 +12072,7 @@
     {
       "path": "tests/idea_develop_spark.mjs",
       "mode": "0000644",
-      "sha256": "fe55e01a0be2aa6ca0bc536469eefcee7d44f40dfa0767fedf1709aed3f7d81e"
+      "sha256": "4d64c378808ab7891ec5af6345b53da15f2ad3a9fc2fdcaa788fc2b7b8d25dad"
     },
     {
       "path": "tests/idea_full_capture.mjs",
@@ -12059,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",
@@ -12089,6 +12119,11 @@
       "mode": "0000644",
       "sha256": "729c511f9bb3d4a9b7fb76c7b3843e1900c8d4c9cfa30fe08e482d1e41113839"
     },
+    {
+      "path": "tests/idea_recommendation.mjs",
+      "mode": "0000644",
+      "sha256": "b8f206392c0d5d590dd00840152942103d28f7121d8e4b1906bc131ff8731fcd"
+    },
     {
       "path": "tests/idea_resubmit.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

@@ -322,12 +322,13 @@ export interface PostGovernmentRanksRequest { rank_key: string; label: string; d
 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 }
+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 }
+export interface PostInboxIdResubmitRequest { field_values: Record<string, unknown>; template_key?: string; recommendation?: string }
 export interface PostInboxIdSparkResponse { idea: unknown; sparked: boolean; unchanged: boolean }
 export interface PostInboxPreviewLandingRequest { goal_id?: number; kind?: string; grade?: string }
-export interface PostInboxRequest { title: string; body_md?: string; kind?: string; suggested_version?: string; suggested_priority?: number; goal_id?: number; grade?: string; template_key?: string; field_values?: Record<string, unknown> }
+export interface PostInboxRequest { title: string; body_md?: string; kind?: string; suggested_version?: string; suggested_priority?: number; goal_id?: number; grade?: string; template_key?: string; field_values?: Record<string, unknown>; recommendation?: string }
 export interface PostInboxScoreRequest { field_values: Record<string, unknown>; template_key?: string }
 export interface PostInboxScoreResponse { score: unknown; fields: unknown; template_key: unknown }
 export interface PostLearningsRequest { title: string; body_md: string; tags?: string[]; related_files?: string[]; source?: string; source_ref?: string; task_id?: number }
@@ -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",
@@ -23230,6 +23289,10 @@
           "template_key": {
             "type": "string",
             "maxLength": 64
+          },
+          "recommendation": {
+            "type": "string",
+            "maxLength": 16
           }
         },
         "required": [
@@ -23237,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": {
@@ -23256,6 +23349,10 @@
           "template_key": {
             "type": "string",
             "maxLength": 64
+          },
+          "recommendation": {
+            "type": "string",
+            "maxLength": 16
           }
         },
         "required": [
@@ -23336,6 +23433,10 @@
           },
           "field_values": {
             "type": "object"
+          },
+          "recommendation": {
+            "type": "string",
+            "maxLength": 16
           }
         },
         "required": [
@@ -25552,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,18 +337,19 @@ 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 |
 |---|---|---|---|---|
 | GET | `/api/bongos/inbox` | `any-builder` | — | read open ideas; skill-friction rows filtered by viewer rank. |
-| POST | `/api/bongos/inbox` | `any-builder` | `title`, `body_md`, `kind`, `suggested_version`, `suggested_priority`, `goal_id`, `grade`, `template_key`, `field_values` | for ordinary ideas; metic+ for kind='criterion-proposal'. |
+| POST | `/api/bongos/inbox` | `any-builder` | `title`, `body_md`, `kind`, `suggested_version`, `suggested_priority`, `goal_id`, `grade`, `template_key`, `field_values`, `recommendation` | for ordinary ideas; metic+ for kind='criterion-proposal'. |
 | GET | `/api/bongos/inbox/:id` | `any-builder` | — | single idea read for the "#NNN" deep-link resolver (task 1047). |
 | PATCH | `/api/bongos/inbox/:id` | `metic+archon` | `status`, `kind`, `promoted_to_task_id`, `reviewed_at`, `merged_into_idea_id`, `triage_note` |  |
 | 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` | POST /inbox/:id/develop — DEVELOP A SPARK INTO A FULL IDEA (task 1002922 / BV1.R146, goal 1000062). |
+| 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/resubmit` | `any-builder` | `field_values`, `template_key` | 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/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. |
 | GET | `/api/bongos/inbox/awaiting-nod` | `metic+archon` | — | GET /inbox/awaiting-nod — the NOD QUEUE (task 1003066, BV1.R05). |