@bongos/core 1.19.274 → 1.19.276

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.274",
-  "core_contract": "1.19.274",
-  "source_commit": "ec41b43ba6a9b1e32db2d3e4b5eeac6361fdb290",
+  "core_version": "1.19.276",
+  "core_contract": "1.19.276",
+  "source_commit": "de2f0fb76790e78b4b2c1bb4878fa88233a36c46",
   "source_ref": "HEAD",
-  "built_at": "2026-08-21T14:03:13.782Z",
+  "built_at": "2026-08-21T15:45:27.022Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 318,
     "agent_docs_stubbed": 22,
-    "functional_verbatim": 1372,
+    "functional_verbatim": 1375,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 1712,
-  "tree_sha256": "55fc345705cf2b709b62edc5c43cc5a18b8ff6b3641f592a9cf5183904f8db3b",
+  "file_count": 1715,
+  "tree_sha256": "abe78982ee6e0304610e16ce97f65fc75baf045c6d210c2ab7ee65ced93b4ee7",
   "files": [
     {
       "path": ".claude/skills/blocker-review/SKILL.md",
@@ -347,12 +347,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "687cc799954164a882f70587922fa313a836eb90aae32f99a4e0c3a0e7333e9c"
+      "sha256": "28ea93104b710162845534c03881affa2ebfa5e9e622c195ef5332fb919762c4"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "2985a6dfb923b6b974aed3da0d6fe0915ae1d439a48c4ee7607062e4fbdc182f"
+      "sha256": "8b6c0691763e21272008f0cb5c24e40d7bc65b297d81e4d1c1b2f58d5f1ab657"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -362,17 +362,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "9ec1876369ac9d53ebf9f742b276314c8731cad32b17e8ed068dc180074098c9"
+      "sha256": "3b7b24b5ced8eead07e1d758e4c1b59321b0fb0f2108aefefd0e4b73bb7cc78b"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "96bbd222f3ccbc2d57bce28e0ac89584252b0e3213bc79f5c8aad54ce10cc845"
+      "sha256": "183d88c492aae87e1a06a1cb69ba5227db6b023057676637025fee0a77bddd88"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "c6d64e8c7efbad95471f0d68a07e5ee4b83d8122ca1d68cf3ea6a614f3fa396f"
+      "sha256": "0348faad8b08aefdc42d7bdff79a97a94f547f824c3ec37ed7642cde357a6950"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -1397,12 +1397,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "3eb89e224eea00629fb69752c7606e9ffed34171ab16fcb82120e030e5db8476"
+      "sha256": "1f499b7f98aba5e51d30f7e3a76c00a3c1b535fe676eb03a31f1eb559d9a0f13"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "2f14ac090adc4b7de69f20948172cee0cf002e1224262d5a51ddcada95ad9489"
+      "sha256": "7fa333bb7864fa72672b463f5c53ae9340bd5ecad808bbfe193e835e57ae3e8d"
     },
     {
       "path": "docs/architecture.md",
@@ -1427,12 +1427,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "47ba743c5ce981d8afafa22013cf596f0ccd26e3f25a43c656188ccd105fafdb"
+      "sha256": "5d38acb7694c5e60631e0ba4ad00f9ce79fd7b761434e6c55de9b1034b62722e"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "473494d43714c9d300487ce7fe976997c3c8d8c3b2d1daeea6481d18cb1997ec"
+      "sha256": "6d4123b12211e88f62337fb4f76743459af1af9629a1e6215676fdcc19a2f71f"
     },
     {
       "path": "docs/design-contract.md",
@@ -2787,7 +2787,7 @@
     {
       "path": "modules/dev-box/app/src/vendor/bongos-client.cjs",
       "mode": "0000644",
-      "sha256": "9ec1876369ac9d53ebf9f742b276314c8731cad32b17e8ed068dc180074098c9"
+      "sha256": "3b7b24b5ced8eead07e1d758e4c1b59321b0fb0f2108aefefd0e4b73bb7cc78b"
     },
     {
       "path": "modules/dev-box/app/test/unit.mjs",
@@ -3377,7 +3377,7 @@
     {
       "path": "modules/hall-ui/public/goal-inbox.js",
       "mode": "0000644",
-      "sha256": "6b3c03ab796597eb6293f28cee278e61c291d58fc3b6468e53b5185d08f97fb3"
+      "sha256": "ede756a5c11c8c6a9eca4c841f2110a5e05293b0fbd6d34a5c90a05dc02943c4"
     },
     {
       "path": "modules/hall-ui/public/goals-page.js",
@@ -3682,7 +3682,7 @@
     {
       "path": "modules/ideas/inbox.js",
       "mode": "0000644",
-      "sha256": "082e2598eec5645a84182d0b56f6e2ba9917d54c0af81bea3196d531099d4249"
+      "sha256": "379a6e51a8865dcf52061d858e7e2f3b572f16bc04473aba163e52cadcaf1873"
     },
     {
       "path": "modules/ideas/migrations/ideas_001_grades.sql",
@@ -3699,6 +3699,11 @@
       "mode": "0000644",
       "sha256": "8edeeb0bbf5bac57111008357fc287f8dc14e6907d7bc218264c40633778b9c3"
     },
+    {
+      "path": "modules/ideas/migrations/ideas_004_lineage_route_index.sql",
+      "mode": "0000644",
+      "sha256": "eb1393f0ee8dccc57efcfe0acd0fdac7857389b74e0cb734042bb4293768b8e8"
+    },
     {
       "path": "modules/ideas/module.json",
       "mode": "0000644",
@@ -3712,7 +3717,12 @@
     {
       "path": "modules/ideas/routes/inbox.js",
       "mode": "0000644",
-      "sha256": "f19fa968ad6fd08b65931039ecf3b8d4b31b1aabef56b42f62cd1a4fbd06328e"
+      "sha256": "9c7027f70daba8cb956ab540567972afcec96900ce8d7f7793647bc58c13abdd"
+    },
+    {
+      "path": "modules/ideas/routing.js",
+      "mode": "0000644",
+      "sha256": "2ca0adb68b0fd44a65b9637c177848648ecd20ecd8ef67e65527c17b7a46414d"
     },
     {
       "path": "modules/ideas/templates.js",
@@ -3742,7 +3752,7 @@
     {
       "path": "modules/lifecycle/db.js",
       "mode": "0000644",
-      "sha256": "b35b53b3badf7f465fe97d317cd32653518f14d98a76a03b18374c49b31db65a"
+      "sha256": "64cdde411e3fb8d1263eebf9093a353dde6ee684be2977057c8800e608b52a63"
     },
     {
       "path": "modules/lifecycle/done-when.js",
@@ -4477,12 +4487,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "2aa1f6741a57aabd4570045588e71afbc04bd100b19fefed328dad581d9bb4f6"
+      "sha256": "db42d8af206914a247ba771e7d711b22137bea42d6b4464eaa60a02bf8947c74"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "edcbca0acb725c24414c2234cc1063d98913867b5ecb0f659e1b58e61e1d6a42"
+      "sha256": "8918824ec6d64703f4976a6f7863aa7ac0f240af95711972715967dfe973f944"
     },
     {
       "path": "public-docs/index.html",
@@ -6127,7 +6137,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "f94e654fd2e4491e44dcec5ac26e4bf97f9a430bdade551f6fd243d3dee005ef"
+      "sha256": "8eb348b653371b264e5c6b6efecddbdf18412e419e7dbd517b87322bdc806aae"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -7409,6 +7419,11 @@
       "mode": "0000644",
       "sha256": "51e1286235cbde1b56188f29b0e2bd12ac73a9637dbf1c16b325f10147256f27"
     },
+    {
+      "path": "tests/idea_routing.mjs",
+      "mode": "0000644",
+      "sha256": "7bea2d388fad9a6b186c4712d6921a554f1d24c70dcae5760b381782149068e7"
+    },
     {
       "path": "tests/idea_task_lineage.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`)
-- 289 operations across 47 resource groups
+- 290 operations across 47 resource groups
 
 ## Install
 

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

@@ -401,6 +401,8 @@ function createClient(opts = {}) {
       postInboxIdRatify: (args) => request("POST", "/inbox/{id}/ratify", { hasBody: true }, args),
       // POST /inbox/{id}/resubmit — rank: any-builder — POST /inbox/:id/resubmit
       postInboxIdResubmit: (args) => request("POST", "/inbox/{id}/resubmit", { hasBody: true }, args),
+      // GET /inbox/awaiting-nod — rank: metic+archon — GET /inbox/awaiting-nod
+      getInboxAwaitingNod: (args) => request("GET", "/inbox/awaiting-nod", { hasBody: false }, args),
     },
     "instance": {
       // GET /instance — rank: public — GET /instance

package/clients/bongos-client/index.cjs

@@ -400,6 +400,8 @@ function createClient(opts = {}) {
       postInboxIdRatify: (args) => request("POST", "/inbox/{id}/ratify", { hasBody: true }, args),
       // POST /inbox/{id}/resubmit — rank: any-builder — POST /inbox/:id/resubmit
       postInboxIdResubmit: (args) => request("POST", "/inbox/{id}/resubmit", { hasBody: true }, args),
+      // GET /inbox/awaiting-nod — rank: metic+archon — GET /inbox/awaiting-nod
+      getInboxAwaitingNod: (args) => request("GET", "/inbox/awaiting-nod", { hasBody: false }, args),
     },
     "instance": {
       // GET /instance — rank: public — GET /instance

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

@@ -47,6 +47,7 @@ export interface GetGovernmentPermissionsResponse { permissions: unknown; princi
 export interface GetGovernmentRanksResponse { ranks: unknown }
 export interface GetGradesByBuilderResponse { window_days: unknown; builders: unknown }
 export interface GetHealthzResponse { ok: boolean; auth_configured: unknown }
+export interface GetInboxAwaitingNodResponse { awaiting: unknown; count: unknown }
 export interface GetInboxIdResponse { idea: unknown }
 export interface GetInboxResponse { ideas: unknown; open_count: unknown }
 export interface GetLeaderboardResponse { leaderboard: unknown; page: unknown }
@@ -244,7 +245,7 @@ export interface PostGovernmentRanksRequest { rank_key: string; label: string; d
 export interface PostGovernmentRanksResponse { rank: unknown }
 export interface PostInboxIdRatifyRequest { notes_md?: string }
 export interface PostInboxIdResubmitRequest { field_values: Record<string, unknown>; template_key?: string }
-export interface PostInboxRequest { title: string; body_md?: string; kind?: string; suggested_version?: string; suggested_priority?: 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> }
 export interface PostLearningsRequest { title: string; body_md: string; tags?: string[]; related_files?: string[]; source?: string; source_ref?: string; task_id?: number }
 export interface PostLearningsResponse { skipped?: boolean; reason?: unknown; learning?: unknown }
 export interface PostLlmCacheLookupRequest { cache_key?: unknown; tokens_saved_est?: unknown }
@@ -659,6 +660,8 @@ export interface BongosClient {
     postInboxIdRatify(args?: RequestArgs & { body?: PostInboxIdRatifyRequest }): Promise<ApiResponse>;
     /** POST /inbox/{id}/resubmit — rank: any-builder */
     postInboxIdResubmit(args: RequestArgs & { body: PostInboxIdResubmitRequest }): Promise<ApiResponse>;
+    /** GET /inbox/awaiting-nod — rank: metic+archon */
+    getInboxAwaitingNod(args?: RequestArgs): Promise<GetInboxAwaitingNodResponse>;
   };
   "instance": {
     /** GET /instance — rank: public */

package/clients/bongos-client/index.mjs

@@ -397,6 +397,8 @@ export function createClient(opts = {}) {
       postInboxIdRatify: (args) => request("POST", "/inbox/{id}/ratify", { hasBody: true }, args),
       // POST /inbox/{id}/resubmit — rank: any-builder — POST /inbox/:id/resubmit
       postInboxIdResubmit: (args) => request("POST", "/inbox/{id}/resubmit", { hasBody: true }, args),
+      // GET /inbox/awaiting-nod — rank: metic+archon — GET /inbox/awaiting-nod
+      getInboxAwaitingNod: (args) => request("GET", "/inbox/awaiting-nod", { hasBody: false }, args),
     },
     "instance": {
       // GET /instance — rank: public — GET /instance

package/docs/api/openapi.json

@@ -6151,6 +6151,47 @@
         ]
       }
     },
+    "/inbox/awaiting-nod": {
+      "get": {
+        "operationId": "get_inbox_awaiting_nod",
+        "tags": [
+          "inbox"
+        ],
+        "summary": "GET /inbox/awaiting-nod",
+        "description": "GET /inbox/awaiting-nod — the NOD QUEUE (task 1003066, BV1.R05). REGISTERED BEFORE /inbox/:id ON PURPOSE. Express matches in registration order, so a literal segment declared after the wildcard is unreachable — this would arrive as /inbox/:id with id='awaiting-nod' and 400 on parseId. rank: metic+ via the EXISTING idea.triage permission, deliberately reused rather than minting a new one. Owner interview Q3: \"any Metic+ gives the nod, in the existing Needs-your-attention slice. No new surface, no new permission.\" The act this queue leads to is POST /tasks/:id/promote, itself gated task.promote (Metic+), so a reader who can see this queue can act on it — the two gates agree by construction instead of by coincidence. Placed on /inbox rather than /tasks because the row is defined by its LINEAGE (origin='route'), and ideas_task_lineage is an ideas-owned table — the lifecycle module must not query it, and this module must not query it from there. \"A task at backlog that a person reported\" is an ideas question.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `idea.triage` (all required).",
+        "x-rank": "metic+archon",
+        "x-source": "modules/ideas/routes/inbox.js",
+        "x-permissions": [
+          "idea.triage"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetInboxAwaitingNodResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/inbox/{id}": {
       "get": {
         "operationId": "get_inbox_id",
@@ -13658,6 +13699,17 @@
           "auth_configured"
         ]
       },
+      "GetInboxAwaitingNodResponse": {
+        "type": "object",
+        "properties": {
+          "awaiting": {},
+          "count": {}
+        },
+        "required": [
+          "awaiting",
+          "count"
+        ]
+      },
       "GetInboxIdResponse": {
         "type": "object",
         "properties": {
@@ -16610,6 +16662,10 @@
             "minimum": 0,
             "maximum": 100
           },
+          "goal_id": {
+            "type": "integer",
+            "minimum": 1
+          },
           "grade": {
             "type": "string",
             "maxLength": 16
@@ -18297,9 +18353,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 289,
-  "x-schema-count": 325,
+  "x-endpoint-count": 290,
+  "x-schema-count": 326,
   "x-undocumented-bodies": 8,
-  "x-response-schemas": 217,
+  "x-response-schemas": 218,
   "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. 289 endpoints across 47 route files.
+> **Generated from the live route files** — the route file is authoritative. 290 endpoints across 47 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/<redacted>.md)): `public` < `any-builder` < `metic+archon` < `archon`.
@@ -255,16 +255,17 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/<redacted>
 |---|---|---|---|---|
 | GET | `/api/bongos/healthz` | `public` | — | liveness probe; status.example.com hits this anonymously. |
 
-## `inbox` (6)
+## `inbox` (7)
 
 | 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`, `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` | 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` | Metic+ (task 360 / ADR 0018): idea triage (promote/discard/merge) shapes the backlog. |
 | 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). |
+| GET | `/api/bongos/inbox/awaiting-nod` | `metic+archon` | — | GET /inbox/awaiting-nod — the NOD QUEUE (task 1003066, BV1.R05). |
 
 ## `instance` (1)
 

package/docs/copy-inventory.md

@@ -4,13 +4,13 @@
 > Deterministic on a given tree — regenerate and commit rather than hand-editing.
 > Machine-readable twin: [`copy-registry.json`](copy-registry.json).
 
-**1335 strings** across 3 surfaces · 1184 distinct pieces of copy · 1335 certain, 0 heuristic · 121 shown in more than one place.
+**1337 strings** across 3 surfaces · 1186 distinct pieces of copy · 1337 certain, 0 heuristic · 121 shown in more than one place.
 
 ## Surfaces
 
 | surface | lives at | files | strings |
 |---|---|---|---|
-| `builders-hall` | `modules/hall-ui/public` | 60 | 1051 |
+| `builders-hall` | `modules/hall-ui/public` | 60 | 1053 |
 | `status-dashboard` | `modules/status-ui/public` | 4 | 98 |
 | `landing` | `public-landing` | 2 | 186 |
 
@@ -78,7 +78,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `7775fec0fa85` | 2x | Could not load sessions. | modules/hall-ui/public/sessions.js:168, modules/hall-ui/public/sessions.js:207 |
 | … | | _81 more in the JSON registry_ | |
 
-## `builders-hall` — 1051 strings
+## `builders-hall` — 1053 strings
 
 | id | conf | text | where |
 |---|---|---|---|
@@ -398,6 +398,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `2ae2114b61db` | certain | Get a free key ↗ | `modules/hall-ui/public/settings.js:917` |
 | `4794a991de3d` | certain | Getting started | `modules/hall-ui/public/hall-widgets.js:59` |
 | `a28b1a567f1a` | certain | GitHub username | `modules/hall-ui/public/builders.js:553` |
+| `79934b879a12` | certain | Give the nod | `modules/hall-ui/public/goal-inbox.js:231` |
 | `51bd60197133` | certain | Go back | `modules/hall-ui/public/drachmae.js:162` |
 | `51bd60197133` | certain | Go back | `modules/hall-ui/public/primer.js:620` |
 | `13acaeb4b0bf` | certain | Goal #{…} | `modules/hall-ui/public/task.js:202` |
@@ -518,7 +519,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `670aa6cee309` | certain | My Projects — {{worldName}} | `modules/hall-ui/public/my-projects.html:6` |
 | `ae84ebe1d735` | certain | Name cannot be blank. | `modules/hall-ui/public/settings.js:730` |
 | `31e91ee6ce03` | certain | Name must be {…} characters or fewer. | `modules/hall-ui/public/settings.js:735` |
-| `7def635421ea` | certain | Needs your attention | `modules/hall-ui/public/goal-inbox.js:204` |
+| `7def635421ea` | certain | Needs your attention | `modules/hall-ui/public/goal-inbox.js:274` |
 | `7fcc2583c372` | certain | New custom rank | `modules/hall-ui/public/government.html:58` |
 | `9e06c14d155a` | certain | New here — request access | `modules/hall-ui/public/builders.js:553` |
 | `6ff07874edef` | certain | Newest first. The fifty most recent write operations. | `modules/hall-ui/public/watch.js:433` |
@@ -1111,6 +1112,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `68b547166d48` | certain | — {…} confirmed {…} can't land yet, so {…} reward is pending (it lands on ship). Rebase + re-ship or release { | `modules/hall-ui/public/builders.js:752` |
 | `ff6b84565e10` | certain | — {…}{…} | `modules/hall-ui/public/government.js:605` |
 | `5b9fa7cb4fb0` | certain | …and {…} more waiting — | `modules/hall-ui/public/goal-inbox.js:121` |
+| `b2a04abfead0` | certain | …{…} more awaiting a nod. | `modules/hall-ui/public/goal-inbox.js:251` |
 | `e35f11bdc5d7` | certain | …{…} more open ideas — triage clears them one at a time. | `modules/hall-ui/public/builders.js:1874` |
 | `de8fa5223aee` | certain | ‹ Prev | `modules/hall-ui/public/hall-kit.js:71` |
 | `d4b84b7fbdeb` | certain | ← All goals | `modules/hall-ui/public/goals.html:56` |

package/docs/copy-registry.json

@@ -3,9 +3,9 @@
   "generator": "scripts/gds/copy-inventory.js",
   "goal": 1000074,
   "counts": {
-    "strings": 1335,
-    "unique_ids": 1184,
-    "certain": 1335,
+    "strings": 1337,
+    "unique_ids": 1186,
+    "certain": 1337,
     "heuristic": 0,
     "duplicate_ids": 121
   },
@@ -13,7 +13,7 @@
     "builders-hall": {
       "at": "modules/hall-ui/public",
       "files": 60,
-      "strings": 1051
+      "strings": 1053
     },
     "status-dashboard": {
       "at": "modules/status-ui/public",
@@ -4124,6 +4124,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "79934b879a12",
+      "surface": "builders-hall",
+      "text": "Give the nod",
+      "file": "modules/hall-ui/public/goal-inbox.js",
+      "line": 231,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "51bd60197133",
       "surface": "builders-hall",
@@ -5209,7 +5218,7 @@
       "surface": "builders-hall",
       "text": "Needs your attention",
       "file": "modules/hall-ui/public/goal-inbox.js",
-      "line": 204,
+      "line": 274,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -10541,6 +10550,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "b2a04abfead0",
+      "surface": "builders-hall",
+      "text": "…{…} more awaiting a nod.",
+      "file": "modules/hall-ui/public/goal-inbox.js",
+      "line": 251,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "e35f11bdc5d7",
       "surface": "builders-hall",

package/modules/dev-box/app/src/vendor/bongos-client.cjs

@@ -400,6 +400,8 @@ function createClient(opts = {}) {
       postInboxIdRatify: (args) => request("POST", "/inbox/{id}/ratify", { hasBody: true }, args),
       // POST /inbox/{id}/resubmit — rank: any-builder — POST /inbox/:id/resubmit
       postInboxIdResubmit: (args) => request("POST", "/inbox/{id}/resubmit", { hasBody: true }, args),
+      // GET /inbox/awaiting-nod — rank: metic+archon — GET /inbox/awaiting-nod
+      getInboxAwaitingNod: (args) => request("GET", "/inbox/awaiting-nod", { hasBody: false }, args),
     },
     "instance": {
       // GET /instance — rank: public — GET /instance

package/modules/hall-ui/public/goal-inbox.js

@@ -146,14 +146,18 @@
   // count-pill/live counter re-derive from the fresh inbox). Disable while in flight
   // so a double-click can't fire the resolve twice (the server 409s a re-resolve, but
   // the UI shouldn't invite it).
-  async function act(fn, okMsg) {
+  // `refresh` defaults to the goals slice's own load(). task 1003066 (BV1.R05):
+  // the nod action lives in a DIFFERENT slice, so it passes its own — otherwise
+  // giving a nod would repaint the goals list and leave the nodded row sitting
+  // there, still asking to be nodded.
+  async function act(fn, okMsg, refresh = load) {
     if (busy) return;
     busy = true;
     host.querySelectorAll('button').forEach((b) => { b.disabled = true; });
     try {
       await fn();
       toast(okMsg);
-      await load();
+      await refresh();
     } catch (err) {
       toast((err && err.data && err.data.message) || 'Could not do that just now — refresh and retry.');
       host.querySelectorAll('button').forEach((b) => { b.disabled = false; });
@@ -163,6 +167,17 @@
   }
 
   function onClick(e) {
+    // task 1003066 (BV1.R05): the nod. It reuses the EXISTING promote route —
+    // POST /tasks/:id/promote, already Metic+ via task.promote — so giving a nod
+    // adds no endpoint and no permission. Handled before the membership branches
+    // because a nod row is a TASK row that merely carries data-goal for styling.
+    const nod = e.target.closest('[data-nod-task]');
+    if (nod) {
+      act(() => postJSON(`${API}/tasks/${encodeURIComponent(nod.dataset.nodTask)}/promote`, {}),
+        'Nodded — it’s claimable now.', loadNodQueue);
+      return;
+    }
+
     const item = e.target.closest('.ginbox__item');
     const goalId = item && item.dataset.goal;
     if (!goalId) return;
@@ -192,6 +207,61 @@
     }
   }
 
+  // ---- the nod queue (task 1003066, BV1.R05) --------------------------------
+  //
+  // A routed filing that soft-landed is a task at 'backlog' in its goal, one
+  // Metic+ promote from claimable — owner interview Q3: any Metic+ gives the nod,
+  // through the EXISTING promote route, in this EXISTING card. No new surface, no
+  // new permission.
+  //
+  // WITHOUT THIS SLICE THE SOFT LANDING IS A SILENT DROP: the filing looks
+  // accepted, nothing tells anyone a human is the blocker, and it sits at backlog
+  // forever. Criterion C2's "one Metic+ promote away" is only true if somebody can
+  // SEE it. The copy says "awaiting a nod", never "triage" — triage is the inbox's
+  // word, and this work already has a home.
+  //
+  // No client-side rank gate: GET /inbox/awaiting-nod is Metic+ server-side, so a
+  // non-triager's fetch 403s and the slice renders nothing. One gate, on the
+  // server, beats a client check that can disagree with it.
+  function nodRowHtml(r) {
+    const title = escapeHtml(r.title || `task #${r.task_id}`);
+    const kind = r.kind ? `<span class="ginbox__sub">${escapeHtml(r.kind)}</span>` : '';
+    const who = r.filed_by_login ? ` · filed by ${escapeHtml(r.filed_by_login)}` : '';
+    const goal = r.goal_title ? escapeHtml(r.goal_title) : `goal ${escapeHtml(String(r.goal_id))}`;
+    return `<li class="ginbox__item" data-goal="${escapeHtml(String(r.goal_id))}">
+        <div class="ginbox__main">
+          <a class="ginbox__goal" href="/task/${encodeURIComponent(r.task_id)}">${title}</a>
+          <span class="ginbox__sub">${goal}${who}</span>
+        </div>
+        ${kind}
+        <div class="ginbox__acts">
+          <button class="btn-ghost" type="button" data-nod-task="${escapeHtml(String(r.task_id))}">Give the nod</button>
+        </div>
+      </li>`;
+  }
+
+  function renderNodQueue(data) {
+    const box = host && host.querySelector('#attention-nod');
+    if (!box) return;
+    const rows = (data && Array.isArray(data.awaiting) ? data.awaiting : []);
+    const count = data && data.count != null ? data.count : rows.length;
+    if (!rows.length) {
+      box.innerHTML = '';
+    } else {
+      const more = count > 5 ? `<p class="ginbox__pending">…${count - 5} more awaiting a nod.</p>` : '';
+      box.innerHTML = '<h3 class="ginbox__sec-h">Reported work awaiting a nod '
+        + `<span class="count-pill">${count}</span></h3>`
+        + `<ul class="ginbox__list">${rows.slice(0, 5).map(nodRowHtml).join('')}</ul>${more}`;
+    }
+    window.OTBAttention?.refresh();
+  }
+
+  function loadNodQueue() {
+    return getJSON(`${API}/inbox/awaiting-nod`)
+      .then((data) => renderNodQueue(data))
+      .catch(() => { /* a non-triager's 403, or a hiccup: never break the hall */ });
+  }
+
   // task 2169: this widget IS the "Needs your attention" card — ONE capped
   // summary hosting every actionable item class: goal invitations +
   // join-requests (this file) and ideas awaiting triage (builders.js renders
@@ -203,9 +273,17 @@
     host.innerHTML =
       '<h2 id="attention-h" class="scroll__h">Needs your attention<span class="count-pill" id="attention-count" hidden></span></h2>' +
       '<div id="attention-goals"></div>' +
-      '<div id="attention-ideas"></div>';
+      '<div id="attention-ideas"></div>' +
+      // task 1003066 (BV1.R05): routed filings that SOFT-LANDED — a reported bug
+      // now sitting at 'backlog' in a real goal, one Metic+ nod from claimable.
+      // Rendered by renderNodQueue above: this file owns the card, and a task
+      // awaiting a nod inside a goal sits nearer the goals slice than idea
+      // triage. Its rows carry the shared .ginbox__item class, so refresh()
+      // counts them with no change to the selector below.
+      '<div id="attention-nod"></div>';
     host.addEventListener('click', onClick);
     load();
+    loadNodQueue();
   }
 
   // The card's shared visibility contract: any slice renderer calls refresh()