@bongos/core 1.19.781 → 1.19.783

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.781",
-  "core_contract": "1.19.781",
-  "source_commit": "d45eac660796500d874b2c6381eb9c07be462935",
+  "core_version": "1.19.783",
+  "core_contract": "1.19.783",
+  "source_commit": "6e5366479023ac5cbbd19fda61ebf8abc48a6113",
   "source_ref": "HEAD",
-  "built_at": "2026-09-16T21:03:10.547Z",
+  "built_at": "2026-09-16T21:29:40.397Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 482,
     "agent_docs_stubbed": 25,
-    "functional_verbatim": 2153,
+    "functional_verbatim": 2154,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 2660,
-  "tree_sha256": "76c1ea968399be1d516e7abf97ecbd1b1fe812033d8ff2ddf81901b15c0aff15",
+  "file_count": 2661,
+  "tree_sha256": "76a7394b33c9a3c9d901bfc6016b4cc40c410b80f7958034ce571b72e952fdda",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -347,12 +347,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "3c2887d41b9799f5fba5a3a07f6107f4a9d612bdca1b3482d38f012448418b9b"
+      "sha256": "3960e4e1720e6f6613d2fe4fb1527b42b84a61b06b0daf480598e04362a86c2a"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "151c6fbf59b14c9ba14c2744b99284cfda4b6162cdc994b9365964359a1fc5b1"
+      "sha256": "9ee5a9c9f0fb8faac162bce68a06800ba74d2ccf1dd8ede4452b754b99d376db"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -362,17 +362,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "d93fa1a8255ea141cd5973080e2af3de55b3ed25ac1814f94f72ece67f8819f5"
+      "sha256": "898a51f9a3f1f28f94fb978ae0954f8a85771fb158708bddbc4d6d766f854b34"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "52d349f5bd6b6ddefcfdc5072128283d5f6d1be51220ab4af7259f249cdfb019"
+      "sha256": "b82c307a8a951980762cd4baa86088b37cfa1852c3265c1f4a709de8c8479b7e"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "6cd74496ecd53b2d7dfbb1a30277fa3fc7e7abd594a52e2544cf85bec8ef21d7"
+      "sha256": "47f940af83ee05d23d80b02f908ca76c3c8aefe5d5653f19b773017530b47245"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -1947,12 +1947,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "ecf72d6a3402fe266f87bdea5bdb2e81da435ba819993daaa7070f082bb5f15c"
+      "sha256": "4faa312df356d31b6e4bcc5d048d24a63ec380dff9605d42855e1a1033cc33fb"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "ef49510b39bc3e319cace1389e03331c52105a985cea0771eb79cdffbbec4bb4"
+      "sha256": "d2c3c4cf4d078d2f5cd9a5a7948ce10379a30c87c972f4c43d6c0e2e1a49afe9"
     },
     {
       "path": "docs/architecture.md",
@@ -1977,12 +1977,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "99c6bc28a2ce69eb710a346b1733b712e1d8026cae36d9db03c318beadfd9c26"
+      "sha256": "46d4de828ac9f55f3c5613dd0686035bfefb52aaf0e45058a177d72288356138"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "dce65073cba5e640941f627c5cd7ebd480ec3e3caa8badd4aa1bef86c0aa54de"
+      "sha256": "5d09f340f83e1f2da6b99be6e5e721dfc782e6b95b11f4fff185085e98442897"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2507,7 +2507,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "cf5cab9a32c28dae4029b2d175cd06e6a45f33114c0203392f478e8ee5d7e34f"
+      "sha256": "a57c986ed1da32c1bd0bbb2724b8cf178e5df174970f1d1fac2b5a42d36d2279"
     },
     {
       "path": "docs/modules-contract.md",
@@ -3672,7 +3672,7 @@
     {
       "path": "modules/builder-settings/builder-needs.js",
       "mode": "0000644",
-      "sha256": "b0f97f1c6aacd5b39697044083f327ecf254592b638d59d12721c3ccdec2ef80"
+      "sha256": "685c515e0498f2c6b63aee3e06b6b4e62a5e6a69a3d0f3d70b211656fe63bed2"
     },
     {
       "path": "modules/builder-settings/db.js",
@@ -4017,7 +4017,7 @@
     {
       "path": "modules/dev-box/app/src/vendor/bongos-client.cjs",
       "mode": "0000644",
-      "sha256": "d93fa1a8255ea141cd5973080e2af3de55b3ed25ac1814f94f72ece67f8819f5"
+      "sha256": "898a51f9a3f1f28f94fb978ae0954f8a85771fb158708bddbc4d6d766f854b34"
     },
     {
       "path": "modules/dev-box/app/test/unit.mjs",
@@ -4632,22 +4632,22 @@
     {
       "path": "modules/hall-ui/public/collab-lib.js",
       "mode": "0000644",
-      "sha256": "5930395c551506e374c3e7ff89347f4151612ae336a18d8c13c6a725a3e844b4"
+      "sha256": "32099a90da4ff3deb49027102d4a42b7616d5f576340e74e0416b0dd1588a408"
     },
     {
       "path": "modules/hall-ui/public/collab.css",
       "mode": "0000644",
-      "sha256": "b82d7f13cf07cc15b675c1182417f477886e5096aa43b0b4f4f363e3ec0ef63e"
+      "sha256": "964d51e697532fa88c6f1da5cc0e46f47d25ecef3a5cdf55526d721eb781257a"
     },
     {
       "path": "modules/hall-ui/public/collab.html",
       "mode": "0000644",
-      "sha256": "24cfffc0a2ce625c4bb895a719a1fe02d6928ac395af16e4423cff6c41056292"
+      "sha256": "1710a2bf97ffa11daff277148299751fe1ca468e038bfa98c5d62d60b914cbf9"
     },
     {
       "path": "modules/hall-ui/public/collab.js",
       "mode": "0000644",
-      "sha256": "3e953b00bbd57a248ed233b98b2451d8f49760bd066d5a58466860495c4d2e35"
+      "sha256": "039a053ee61e4627b4eaa352c0f1d5c976e4ecbffede2dad9bde63d560e28d01"
     },
     {
       "path": "modules/hall-ui/public/collab.states.json",
@@ -5192,7 +5192,7 @@
     {
       "path": "modules/hall-ui/public/shell.js",
       "mode": "0000644",
-      "sha256": "6a65d9e227406198b198d5346fcc319f904d4bef3162771609c4480ed87c3c21"
+      "sha256": "96fe28b7a05898c43830cf9f088f64869c3161ce659e84e4776c50313b563bf7"
     },
     {
       "path": "modules/hall-ui/public/ship.wav",
@@ -5552,7 +5552,7 @@
     {
       "path": "modules/lifecycle/help-requests.js",
       "mode": "0000644",
-      "sha256": "80eb723feef1875aaa81edf55c6a5b2441bb7dc72c6a6e96ab578026dd742a0f"
+      "sha256": "8879e01093e74dc71386b401dd77f206d540bee3feeb001732bd6c8eff0dea99"
     },
     {
       "path": "modules/lifecycle/hierarchy.js",
@@ -5692,7 +5692,7 @@
     {
       "path": "modules/lifecycle/routes/help-requests.js",
       "mode": "0000644",
-      "sha256": "0e9430101ce99d0a84f1893d13bcf1434af13325c2ce531e693b6bce42cb9385"
+      "sha256": "a4b72ce0451ef72f2daccbb013d84766798ab948448f5511b6c661832c1f4060"
     },
     {
       "path": "modules/lifecycle/routes/kickoff-seed.js",
@@ -7612,12 +7612,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "649f45c7edc727a1e32796caefe1848113a53872e435be1befbd23167e4a71a4"
+      "sha256": "e998a3dbacba277f1fce790f6b672738f339819dd866d3bef1896aee8a44d4a8"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "71490018201c33eea331cb3aaa42d97bc024754b83b4b8d6622ec8aa736bdc30"
+      "sha256": "914d6c6f028d4708afd08513c3e04f062098d14a4d08e2061c5051db928d026a"
     },
     {
       "path": "public-docs/index.html",
@@ -8977,7 +8977,7 @@
     {
       "path": "scripts/gds/start.js",
       "mode": "0000644",
-      "sha256": "6f871e5c89d2f256fbaf5b556a4ffacd5da86a72577d913b086a45893baf445a"
+      "sha256": "3b9cbebddc633952450ee38c933e42b465bd107edb28532ada58a113d6b5cbe5"
     },
     {
       "path": "scripts/gds/status.js",
@@ -9477,7 +9477,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "ae9fcf83cce465b20cd9d5fc34f88c58decace92ebfaf3fd0f2d477d8b46bc16"
+      "sha256": "2b4da6b2263db105e394608f3043a0b7c1c46eb43b36928ccb2f761ccfb2ea6a"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -10032,7 +10032,7 @@
     {
       "path": "tests/builder_needs.mjs",
       "mode": "0000644",
-      "sha256": "dd3f0d37e31d41a51a8661a344ea5d6e3ccd652601caf0ff8b707b6a24d3a0ba"
+      "sha256": "7e640af4e5bf8d0b388aa86689c67a10291fefa38b9de2523bf883baf036f503"
     },
     {
       "path": "tests/bump_version.mjs",
@@ -10197,7 +10197,7 @@
     {
       "path": "tests/collab_page.mjs",
       "mode": "0000644",
-      "sha256": "98408d2e16e0ca596a31e9e97588584717dae126e863323088b5457dfef24420"
+      "sha256": "3f9e3ea6d2b88cd6592ba7b0575908eb020a072e6ccdb8cdf908bfba65b5191c"
     },
     {
       "path": "tests/conductor.mjs",
@@ -11142,7 +11142,7 @@
     {
       "path": "tests/hall_collab_world.mjs",
       "mode": "0000644",
-      "sha256": "051bf806c90c8d62f4ab38b25cb0c8c7b49f68858ab223d74b174cedecc13ac6"
+      "sha256": "847b3c8ea9bfb6c4b047f311338934cedd7e59e3936552e7265612cd0e5302d7"
     },
     {
       "path": "tests/hall_error_envelope.mjs",
@@ -11162,7 +11162,7 @@
     {
       "path": "tests/hall_nav.mjs",
       "mode": "0000644",
-      "sha256": "4e50dc661c67c528892e53ac45014ffa0d3af45131dd8da21d4e11e66d38bf41"
+      "sha256": "63ded71e9a99244d47831a7389d45c84acd147f5cf4f1274f6ba3d41fa7af473"
     },
     {
       "path": "tests/hall_oversight_world.mjs",
@@ -11237,7 +11237,7 @@
     {
       "path": "tests/help_requests.mjs",
       "mode": "0000644",
-      "sha256": "e1e1075e2f8ba4b52acba29804e5fd62443b823cfd15d4c50f0a93fcea0d13bd"
+      "sha256": "6983852833e1a4fe0d13dad5e90b70fe4ede37338f281bf7595b41cd741bfc7b"
     },
     {
       "path": "tests/helpers.mjs",
@@ -12887,7 +12887,7 @@
     {
       "path": "tests/social_mode.mjs",
       "mode": "0000644",
-      "sha256": "24a37c1ee4a5d93374f0f4e2a15581962380d98e067b283f890834c008847fc2"
+      "sha256": "c9576dd8d1406e738cde1db043f2f0728307356e37e6546e199d99714ae6836c"
     },
     {
       "path": "tests/sound_player.mjs",
@@ -12934,6 +12934,11 @@
       "mode": "0000644",
       "sha256": "dd7171dbc59e024de99a063763219237814cf4c943fb3d873cc324f3bfde7f25"
     },
+    {
+      "path": "tests/start_inbox_count.mjs",
+      "mode": "0000644",
+      "sha256": "525f37837e39059c1b40c99b117764ba0547b803f01d709e80354744ad3438b7"
+    },
     {
       "path": "tests/start_rebase_warning.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`)
-- 374 operations across 58 resource groups
+- 375 operations across 58 resource groups
 
 ## Use it from your project
 

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

@@ -469,6 +469,8 @@ function createClient(opts = {}) {
       getHealthz: (args) => request("GET", "/healthz", { hasBody: false }, args),
     },
     "helpRequests": {
+      // GET /help-requests — rank: any-builder — GET /help-requests
+      getHelpRequests: (args) => request("GET", "/help-requests", { hasBody: false }, args),
       // POST /help-requests — rank: any-builder — POST /help-requests
       postHelpRequests: (args) => request("POST", "/help-requests", { hasBody: true }, args),
       // PATCH /help-requests/{id} — rank: any-builder — PATCH /help-requests/:id

package/clients/bongos-client/index.cjs

@@ -468,6 +468,8 @@ function createClient(opts = {}) {
       getHealthz: (args) => request("GET", "/healthz", { hasBody: false }, args),
     },
     "helpRequests": {
+      // GET /help-requests — rank: any-builder — GET /help-requests
+      getHelpRequests: (args) => request("GET", "/help-requests", { hasBody: false }, args),
       // POST /help-requests — rank: any-builder — POST /help-requests
       postHelpRequests: (args) => request("POST", "/help-requests", { hasBody: true }, args),
       // PATCH /help-requests/{id} — rank: any-builder — PATCH /help-requests/:id

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

@@ -66,6 +66,7 @@ export interface GetGradesByBuilderResponse { window_days: unknown; builders: un
 export interface GetHealthzResponse { ok: boolean; auth_configured: unknown }
 export interface GetHelpRequestsForMeResponse { help_requests: unknown; count: unknown; crafts: unknown }
 export interface GetHelpRequestsMineResponse { help_requests: unknown; count: unknown }
+export interface GetHelpRequestsResponse { help_requests: unknown; count: unknown }
 export interface GetInboxAwaitingNodResponse { awaiting: unknown; count: unknown }
 export interface GetInboxByBuilderIdResponse { builder_id: unknown; ideas: unknown; total: unknown; limit: unknown; offset: unknown }
 export interface GetInboxIdResponse { idea: unknown }
@@ -816,6 +817,8 @@ export interface BongosClient {
     getHealthz(args?: RequestArgs): Promise<GetHealthzResponse>;
   };
   "helpRequests": {
+    /** GET /help-requests — rank: any-builder */
+    getHelpRequests(args?: RequestArgs): Promise<GetHelpRequestsResponse>;
     /** POST /help-requests — rank: any-builder */
     postHelpRequests(args: RequestArgs & { body: PostHelpRequestsRequest }): Promise<PostHelpRequestsResponse>;
     /** PATCH /help-requests/{id} — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -465,6 +465,8 @@ export function createClient(opts = {}) {
       getHealthz: (args) => request("GET", "/healthz", { hasBody: false }, args),
     },
     "helpRequests": {
+      // GET /help-requests — rank: any-builder — GET /help-requests
+      getHelpRequests: (args) => request("GET", "/help-requests", { hasBody: false }, args),
       // POST /help-requests — rank: any-builder — POST /help-requests
       postHelpRequests: (args) => request("POST", "/help-requests", { hasBody: true }, args),
       // PATCH /help-requests/{id} — rank: any-builder — PATCH /help-requests/:id

package/docs/api/openapi.json

@@ -7772,6 +7772,42 @@
       }
     },
     "/help-requests": {
+      "get": {
+        "operationId": "get_help_requests",
+        "tags": [
+          "help-requests"
+        ],
+        "summary": "GET /help-requests",
+        "description": "The BOARD read (task 1003942): every open ask in the project, newest first, for the Collab page's \"all open asks\" block. rank: any-builder — an ask is addressed inside this project and every reader here is a member; the route takes no craft and no builder from the caller, so there is nothing to widen.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/help-requests.js",
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetHelpRequestsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      },
       "post": {
         "operationId": "post_help_requests",
         "tags": [
@@ -18009,6 +18045,17 @@
           "count"
         ]
       },
+      "GetHelpRequestsResponse": {
+        "type": "object",
+        "properties": {
+          "help_requests": {},
+          "count": {}
+        },
+        "required": [
+          "help_requests",
+          "count"
+        ]
+      },
       "GetInboxAwaitingNodResponse": {
         "type": "object",
         "properties": {
@@ -23779,9 +23826,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 374,
-  "x-schema-count": 414,
+  "x-endpoint-count": 375,
+  "x-schema-count": 415,
   "x-undocumented-bodies": 9,
-  "x-response-schemas": 281,
+  "x-response-schemas": 282,
   "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. 374 endpoints across 61 route files.
+> **Generated from the live route files** — the route file is authoritative. 375 endpoints across 61 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`.
@@ -315,10 +315,11 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 |---|---|---|---|---|
 | GET | `/api/bongos/healthz` | `public` | — | liveness probe; the status dashboard (status.<apex>) hits this anonymously. |
 
-## `help-requests` (4)
+## `help-requests` (5)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
+| GET | `/api/bongos/help-requests` | `any-builder` | — | The BOARD read (task 1003942): every open ask in the project, newest first, for the Collab page's "all open asks" block. |
 | POST | `/api/bongos/help-requests` | `any-builder` | `needs_craft`, `needs_builder_id`, `what_is_stuck`, `task_id`, `goal_id` | asking for help is not a privileged act, and gating it would exclude exactly the newcomers most likely to be stuck. |
 | PATCH | `/api/bongos/help-requests/:id` | `any-builder` | `status` | Only the ASKER settles their own request: 'answered' when someone helped, 'withdrawn' when they no longer need it. |
 | GET | `/api/bongos/help-requests/for-me` | `any-builder` | — | The addressed read — C01's answer to "and fires a notification". |