@bongos/core 1.19.357 → 1.19.359

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.357",
-  "core_contract": "1.19.357",
-  "source_commit": "3c8f80201ef2dd9992ceea78af1081b7cd74524d",
+  "core_version": "1.19.359",
+  "core_contract": "1.19.359",
+  "source_commit": "d23c36fb93e62c5c592d80daf5754eba2fc4dbf5",
   "source_ref": "HEAD",
-  "built_at": "2026-08-25T16:20:35.425Z",
+  "built_at": "2026-08-25T17:25:50.103Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 330,
     "agent_docs_stubbed": 22,
-    "functional_verbatim": 1511,
+    "functional_verbatim": 1519,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 1863,
-  "tree_sha256": "03a3fad69d2b334568f719ebc41a4cdde66d922efaae81ac1857f85baa39f760",
+  "file_count": 1871,
+  "tree_sha256": "48c8596d49b7f313fede9fcbc4f31f0360ca18ba33d5f8dc26e92bb6344c1137",
   "files": [
     {
       "path": ".claude/skills/blocker-review/SKILL.md",
@@ -347,12 +347,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "8c0c4d213d8968fe1180a945aa847c5cca97e73ae3497290f69200a02f0e3995"
+      "sha256": "a01f701244efc0295413af22c0d487a82ca64b281c6bfcc056a4c51d4987e448"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "762aa91de1b50fa63f8e8d1b1dbdd775b6103c6b8a833dd5f6de4721df7cae15"
+      "sha256": "0a4d72fef0cd507f9efa5725d292c6628caefec677da34223cdc987020a3fe32"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -362,17 +362,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "5f5c9e0ebb6ef5cded0454b08270938e2ade486e13ede3edd89c23fe93f0798d"
+      "sha256": "6815d5cf32acfc8efb36662f6518b2062bb407ca7f7421dc7fb28b569c433d8b"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "4229624f3aebb2f7335278e5c69b32d0d722616d38fc9a511d4c829a3c9d476e"
+      "sha256": "e1f023e1b393626dd766c7869e64462e599f804773b86d658ee00bfc8634d2ca"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "1eb6f3523f67f7a017cb5c28c087aa00363f05335679f3379859aab43bb4d29c"
+      "sha256": "6976836ffb9248c63961cca978c4cb8c1980fa41a820e0a6e99a1339c59aa051"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -1452,12 +1452,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "f8f2920b3448a54530c8da2ae8a2c809c46b3ad8425fe24e3320d782c92e48bb"
+      "sha256": "d9a54ab07b19d3b9f6ba0cf2a22c14928c0b32b5b1939c42847cbe3caa6b6e00"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "ef200cfe7325260763ca25e1af1b506579d69c0c78bc8d9fa276ac2900486ac9"
+      "sha256": "8748278cc36ace3f8b5b7690ec38307a044f31fbf4a3a675b0425d979c3c2223"
     },
     {
       "path": "docs/architecture.md",
@@ -2499,6 +2499,21 @@
       "mode": "0000644",
       "sha256": "a379e9f926274559d8c57c9127024463e38b99e3f73962022b9f5d0f4e156a57"
     },
+    {
+      "path": "modules/agents/migrations/agents_001_definitions.sql",
+      "mode": "0000644",
+      "sha256": "a35cb06d31f05acdc9bee40a977346d258acda79174944361710f3733dd69a2f"
+    },
+    {
+      "path": "modules/agents/module.json",
+      "mode": "0000644",
+      "sha256": "055d1a806c40d8153b45bac2518b183874d9a8df7924f00355c86ed50682dd24"
+    },
+    {
+      "path": "modules/agents/spawn.js",
+      "mode": "0000644",
+      "sha256": "657e6a314e9daec8a7a3d17c3eee1ccfc35aaa1390d89fa0dd135d6365c103b1"
+    },
     {
       "path": "modules/autonomy/CLAUDE.md",
       "mode": "0000644",
@@ -2532,7 +2547,7 @@
     {
       "path": "modules/builder-settings/builder-needs.js",
       "mode": "0000644",
-      "sha256": "01f32e6f160ffbfde7240cfc1dd0e0bdc3501f13578e073c9397a2a0cccb793b"
+      "sha256": "276a92a2000f2bc0e9e157791947f2ee7e6bfe934a15a996d42dba13984c26d7"
     },
     {
       "path": "modules/builder-settings/db.js",
@@ -2862,7 +2877,7 @@
     {
       "path": "modules/dev-box/app/src/vendor/bongos-client.cjs",
       "mode": "0000644",
-      "sha256": "5f5c9e0ebb6ef5cded0454b08270938e2ade486e13ede3edd89c23fe93f0798d"
+      "sha256": "6815d5cf32acfc8efb36662f6518b2062bb407ca7f7421dc7fb28b569c433d8b"
     },
     {
       "path": "modules/dev-box/app/test/unit.mjs",
@@ -4052,7 +4067,7 @@
     {
       "path": "modules/lifecycle/lifecycle.js",
       "mode": "0000644",
-      "sha256": "07ea278ae8c0f0055d6ac332d7580af55e82fecefda2d1cf46dad1bf27678c59"
+      "sha256": "ba8f6356c8ec9f908878d592d294033db1c9ff9403306a2ae5099df7aa466e72"
     },
     {
       "path": "modules/lifecycle/merge-lock.js",
@@ -4074,10 +4089,15 @@
       "mode": "0000644",
       "sha256": "d52627071dcfbf70e9bccef60803d246e49b08c22da4c374d706e1f5712fbb11"
     },
+    {
+      "path": "modules/lifecycle/migrations/lifecycle_005_task_recommendations.sql",
+      "mode": "0000644",
+      "sha256": "0b8fa7b8d1785a92de1cc4000bf003f5a39873f0439c09b4a753241746bce460"
+    },
     {
       "path": "modules/lifecycle/module.json",
       "mode": "0000644",
-      "sha256": "2c7c98cd6d811d23abfbd6448572ec44c6199f7c15514b0c09924126199e23f9"
+      "sha256": "0734a4bf5c63eb1a09c38506fb796d8d0c4e6c032536c1b026a8e65b37d21794"
     },
     {
       "path": "modules/lifecycle/pollers/publish-reconciler.js",
@@ -4134,6 +4154,11 @@
       "mode": "0000644",
       "sha256": "637c442875fbe297e3aba54f4b6b16f9d06b740782e3506f65c58f34b67ea81d"
     },
+    {
+      "path": "modules/lifecycle/routes/recommendations.js",
+      "mode": "0000644",
+      "sha256": "a8e851ca630a24b197e7ecb8f8cd8ac3d169801bacbac72097528500f95d6cdb"
+    },
     {
       "path": "modules/lifecycle/routes/task-route-helpers.js",
       "mode": "0000644",
@@ -4179,6 +4204,11 @@
       "mode": "0000644",
       "sha256": "205bbe37f27191c0404fe03d1e84ce313fc3fdbde0bfcd00c65aca2971c6e163"
     },
+    {
+      "path": "modules/lifecycle/task-recommendations.js",
+      "mode": "0000644",
+      "sha256": "7ed98bbd3d4954808dc64228acb6899a96083081ecc241e81f2b5db9eb568f1f"
+    },
     {
       "path": "modules/lifecycle/task-visual-db.js",
       "mode": "0000644",
@@ -4802,12 +4832,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "b1353851e7bd50f58b47d0191076eacc249bdca62553d0bb9a6ee767aed9c712"
+      "sha256": "e06a1a0d00dd8df697613e06d1806ceb797716c292debd219fe8f0b3a3c896cd"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "632ea5fa7541ae2eb15f7afdc97f5414b65e1cadcf627e03ed7aee1f1443a0c0"
+      "sha256": "f47e3cf3c97d4ab16fb5fa4cdf59fe3fd20c350114dc587122cc1f5ec5bb9842"
     },
     {
       "path": "public-docs/index.html",
@@ -5832,7 +5862,7 @@
     {
       "path": "scripts/gds/publish-manifest.js",
       "mode": "0000644",
-      "sha256": "387a6846692f05c4adee5651a6f45780ec12f24de12621e73014e79ea4c47342"
+      "sha256": "12b3b200c1f60cc8a287d9a3ca2dd28201fda3cc219e83dffb60913c084e0413"
     },
     {
       "path": "scripts/gds/pulse.js",
@@ -6597,7 +6627,7 @@
     {
       "path": "src/bongos/routes/me.js",
       "mode": "0000644",
-      "sha256": "dc32a25a531f9ea76c25df57930e0566259737bbd1c559409df61f5b5f87813e"
+      "sha256": "1d9e11f3ca4d08033bc116e79ccf66e901ec4e8c48b61d969eeeceface1f9da1"
     },
     {
       "path": "src/bongos/routes/modules.js",
@@ -6667,7 +6697,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "2376b2c1c18430faa5dc61183b3dace18e5d991515aa508fcb3d739ba9342701"
+      "sha256": "0c94e1d2f36bff1e43423ae82fadcd6dbb2013368a3ae1dbba860e486ae7c4a1"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -6744,6 +6774,11 @@
       "mode": "0000644",
       "sha256": "125edcec8c7d7536365b9675daa1fceb9fe072a30e2a4a68ee2911cd258a8c10"
     },
+    {
+      "path": "tests/agents_spawn.mjs",
+      "mode": "0000644",
+      "sha256": "8cc261471a36e3c447df57b46082997b6a50da3c8ff4b214787ae55ab27cb9ef"
+    },
     {
       "path": "tests/api_cli_flags.mjs",
       "mode": "0000644",
@@ -8657,7 +8692,7 @@
     {
       "path": "tests/publish_manifest.mjs",
       "mode": "0000644",
-      "sha256": "a5e36e0a0d228638c499ccac2559bd947a85735e1a922a32c7c1377c98ed2a60"
+      "sha256": "5eca5f50f200166ce0fd7e40a57e18fffb135139fe558d0dda34064d426814dc"
     },
     {
       "path": "tests/publish_reconciler.mjs",
@@ -9194,6 +9229,11 @@
       "mode": "0000644",
       "sha256": "cfb57e35ce65f991309e4de64c03f9252e19117a1ad406cf9bb04c1716f57746"
     },
+    {
+      "path": "tests/task_recommendations.mjs",
+      "mode": "0000644",
+      "sha256": "cfce8e24b5844b1720399cc467e89ca457d74dfbf0783ef2a733d433f0443bd8"
+    },
     {
       "path": "tests/task_visual_route_gate.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`)
-- 307 operations across 49 resource groups
+- 312 operations across 50 resource groups
 
 ## Install
 

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

@@ -716,6 +716,16 @@ function createClient(opts = {}) {
       // POST /sso/token — rank: public — POST /sso/token
       postSsoToken: (args) => request("POST", "/sso/token", { hasBody: true }, args),
     },
+    "taskRecommendations": {
+      // POST /task-recommendations — rank: any-builder — POST /task-recommendations
+      postTaskRecommendations: (args) => request("POST", "/task-recommendations", { hasBody: true }, args),
+      // PATCH /task-recommendations/{id} — rank: any-builder — PATCH /task-recommendations/:id
+      patchTaskRecommendationsId: (args) => request("PATCH", "/task-recommendations/{id}", { hasBody: true }, args),
+      // GET /task-recommendations/for-me — rank: any-builder — GET /task-recommendations/for-me
+      getTaskRecommendationsForMe: (args) => request("GET", "/task-recommendations/for-me", { hasBody: false }, args),
+      // GET /task-recommendations/mine — rank: any-builder — GET /task-recommendations/mine
+      getTaskRecommendationsMine: (args) => request("GET", "/task-recommendations/mine", { hasBody: false }, args),
+    },
     "taskVisuals": {
       // GET /task-visuals/{name} — rank: public — GET /task-visuals/:name
       getTaskVisualsName: (args) => request("GET", "/task-visuals/{name}", { hasBody: false }, args),
@@ -761,6 +771,8 @@ function createClient(opts = {}) {
       postTasksIdPublishBranch: (args) => request("POST", "/tasks/{id}/publish-branch", { hasBody: true }, args),
       // GET /tasks/{id}/publish-status — rank: any-builder — GET /tasks/:id/publish-status
       getTasksIdPublishStatus: (args) => request("GET", "/tasks/{id}/publish-status", { hasBody: false }, args),
+      // GET /tasks/{id}/recommendations — rank: any-builder — GET /tasks/:id/recommendations
+      getTasksIdRecommendations: (args) => request("GET", "/tasks/{id}/recommendations", { hasBody: false }, args),
       // POST /tasks/{id}/ship — rank: any-builder — POST /tasks/:id/ship
       postTasksIdShip: (args) => request("POST", "/tasks/{id}/ship", { hasBody: true }, args),
       // DELETE /tasks/{id}/visual — rank: any-builder — DELETE /tasks/:id/visual

package/clients/bongos-client/index.cjs

@@ -715,6 +715,16 @@ function createClient(opts = {}) {
       // POST /sso/token — rank: public — POST /sso/token
       postSsoToken: (args) => request("POST", "/sso/token", { hasBody: true }, args),
     },
+    "taskRecommendations": {
+      // POST /task-recommendations — rank: any-builder — POST /task-recommendations
+      postTaskRecommendations: (args) => request("POST", "/task-recommendations", { hasBody: true }, args),
+      // PATCH /task-recommendations/{id} — rank: any-builder — PATCH /task-recommendations/:id
+      patchTaskRecommendationsId: (args) => request("PATCH", "/task-recommendations/{id}", { hasBody: true }, args),
+      // GET /task-recommendations/for-me — rank: any-builder — GET /task-recommendations/for-me
+      getTaskRecommendationsForMe: (args) => request("GET", "/task-recommendations/for-me", { hasBody: false }, args),
+      // GET /task-recommendations/mine — rank: any-builder — GET /task-recommendations/mine
+      getTaskRecommendationsMine: (args) => request("GET", "/task-recommendations/mine", { hasBody: false }, args),
+    },
     "taskVisuals": {
       // GET /task-visuals/{name} — rank: public — GET /task-visuals/:name
       getTaskVisualsName: (args) => request("GET", "/task-visuals/{name}", { hasBody: false }, args),
@@ -760,6 +770,8 @@ function createClient(opts = {}) {
       postTasksIdPublishBranch: (args) => request("POST", "/tasks/{id}/publish-branch", { hasBody: true }, args),
       // GET /tasks/{id}/publish-status — rank: any-builder — GET /tasks/:id/publish-status
       getTasksIdPublishStatus: (args) => request("GET", "/tasks/{id}/publish-status", { hasBody: false }, args),
+      // GET /tasks/{id}/recommendations — rank: any-builder — GET /tasks/:id/recommendations
+      getTasksIdRecommendations: (args) => request("GET", "/tasks/{id}/recommendations", { hasBody: false }, args),
       // POST /tasks/{id}/ship — rank: any-builder — POST /tasks/:id/ship
       postTasksIdShip: (args) => request("POST", "/tasks/{id}/ship", { hasBody: true }, args),
       // DELETE /tasks/{id}/visual — rank: any-builder — DELETE /tasks/:id/visual

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

@@ -108,9 +108,12 @@ export interface GetSessionsIdResponse { session: unknown }
 export interface GetSessionsMineResponse { sessions: unknown; count: unknown }
 export interface GetSessionsSearchResponse { sessions: unknown; count: unknown; total: unknown; totals: unknown; limit: unknown; offset: unknown }
 export interface GetSsoPubkeyResponse { alg: unknown; format: unknown; public_key_b64: unknown }
+export interface GetTaskRecommendationsForMeResponse { recommendations: unknown; count: unknown }
+export interface GetTaskRecommendationsMineResponse { recommendations: unknown; count: unknown }
 export interface GetTasksClaimableResponse { claimable: unknown; active_claims: unknown }
 export interface GetTasksIdCriteriaResponse { criteria: unknown }
 export interface GetTasksIdDependenciesResponse { dependencies: unknown; dependents: unknown }
+export interface GetTasksIdRecommendationsResponse { recommendations: unknown; count: unknown }
 export interface GetTasksNewcomerFloorResponse { disciplines: unknown }
 export interface GetTasksPeerVotesFeedResponse { tasks: unknown; can_vote: unknown }
 export interface GetTasksResponse { tasks: unknown }
@@ -154,6 +157,8 @@ export interface PatchProjectsIdFeaturedRequest { featured: boolean }
 export interface PatchProjectsIdFeaturedResponse { project: unknown }
 export interface PatchProvisioningInstancesIdSettingsRequest { platform_visibility?: string; joinability?: string }
 export interface PatchProvisioningInstancesIdSettingsResponse { ok: boolean; saved: unknown; push: unknown }
+export interface PatchTaskRecommendationsIdRequest { status: "declined" | "withdrawn" }
+export interface PatchTaskRecommendationsIdResponse { ok: boolean; recommendation: unknown }
 export interface PatchTasksIdRequest { kind?: string; discipline?: string; requires_rank?: string; module_key?: string; goal_id?: number; parent_task_id?: StringifiableId; parallel_safe?: unknown; newcomer_friendly?: boolean; xenos_claimable?: boolean; security_sensitive?: boolean; automation_tag?: string; needs_migration?: boolean; description?: string; status?: unknown }
 export interface PostAccessRequestsRequest { github_login: string; display_name?: string; note?: string }
 export interface PostAccessRequestsResponse { ok: boolean; request?: unknown; already_pending?: boolean }
@@ -318,6 +323,8 @@ export interface PostSsoMembershipCheckInRequest { client_id: string; client_sec
 export interface PostSsoMembershipCheckInResponse { ok: boolean }
 export interface PostSsoTokenRequest { client_id: string; client_secret: string; code: string; redirect_uri: string }
 export interface PostSsoTokenResponse { github_id: unknown; github_login: unknown; display_name: unknown; avatar_url: unknown }
+export interface PostTaskRecommendationsRequest { task_id: number; recommended_to: number; reason: string }
+export interface PostTaskRecommendationsResponse { ok: boolean; recommendation: unknown }
 export interface PostTasksIdAbandonRequest { reason?: string }
 export interface PostTasksIdAttestGateRequest { head_sha: string }
 export interface PostTasksIdAttestGateResponse { ok: boolean; attested: unknown; reason: unknown }
@@ -992,6 +999,16 @@ export interface BongosClient {
     /** POST /sso/token — rank: public */
     postSsoToken(args: RequestArgs & { body: PostSsoTokenRequest }): Promise<PostSsoTokenResponse>;
   };
+  "taskRecommendations": {
+    /** POST /task-recommendations — rank: any-builder */
+    postTaskRecommendations(args: RequestArgs & { body: PostTaskRecommendationsRequest }): Promise<PostTaskRecommendationsResponse>;
+    /** PATCH /task-recommendations/{id} — rank: any-builder */
+    patchTaskRecommendationsId(args: RequestArgs & { body: PatchTaskRecommendationsIdRequest }): Promise<PatchTaskRecommendationsIdResponse>;
+    /** GET /task-recommendations/for-me — rank: any-builder */
+    getTaskRecommendationsForMe(args?: RequestArgs): Promise<GetTaskRecommendationsForMeResponse>;
+    /** GET /task-recommendations/mine — rank: any-builder */
+    getTaskRecommendationsMine(args?: RequestArgs): Promise<GetTaskRecommendationsMineResponse>;
+  };
   "taskVisuals": {
     /** GET /task-visuals/{name} — rank: public */
     getTaskVisualsName(args?: RequestArgs): Promise<ApiResponse>;
@@ -1037,6 +1054,8 @@ export interface BongosClient {
     postTasksIdPublishBranch(args: RequestArgs & { body: PostTasksIdPublishBranchRequest }): Promise<PostTasksIdPublishBranchResponse>;
     /** GET /tasks/{id}/publish-status — rank: any-builder */
     getTasksIdPublishStatus(args?: RequestArgs): Promise<ApiResponse>;
+    /** GET /tasks/{id}/recommendations — rank: any-builder */
+    getTasksIdRecommendations(args?: RequestArgs): Promise<GetTasksIdRecommendationsResponse>;
     /** POST /tasks/{id}/ship — rank: any-builder */
     postTasksIdShip(args?: RequestArgs): Promise<PostTasksIdShipResponse>;
     /** DELETE /tasks/{id}/visual — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -712,6 +712,16 @@ export function createClient(opts = {}) {
       // POST /sso/token — rank: public — POST /sso/token
       postSsoToken: (args) => request("POST", "/sso/token", { hasBody: true }, args),
     },
+    "taskRecommendations": {
+      // POST /task-recommendations — rank: any-builder — POST /task-recommendations
+      postTaskRecommendations: (args) => request("POST", "/task-recommendations", { hasBody: true }, args),
+      // PATCH /task-recommendations/{id} — rank: any-builder — PATCH /task-recommendations/:id
+      patchTaskRecommendationsId: (args) => request("PATCH", "/task-recommendations/{id}", { hasBody: true }, args),
+      // GET /task-recommendations/for-me — rank: any-builder — GET /task-recommendations/for-me
+      getTaskRecommendationsForMe: (args) => request("GET", "/task-recommendations/for-me", { hasBody: false }, args),
+      // GET /task-recommendations/mine — rank: any-builder — GET /task-recommendations/mine
+      getTaskRecommendationsMine: (args) => request("GET", "/task-recommendations/mine", { hasBody: false }, args),
+    },
     "taskVisuals": {
       // GET /task-visuals/{name} — rank: public — GET /task-visuals/:name
       getTaskVisualsName: (args) => request("GET", "/task-visuals/{name}", { hasBody: false }, args),
@@ -757,6 +767,8 @@ export function createClient(opts = {}) {
       postTasksIdPublishBranch: (args) => request("POST", "/tasks/{id}/publish-branch", { hasBody: true }, args),
       // GET /tasks/{id}/publish-status — rank: any-builder — GET /tasks/:id/publish-status
       getTasksIdPublishStatus: (args) => request("GET", "/tasks/{id}/publish-status", { hasBody: false }, args),
+      // GET /tasks/{id}/recommendations — rank: any-builder — GET /tasks/:id/recommendations
+      getTasksIdRecommendations: (args) => request("GET", "/tasks/{id}/recommendations", { hasBody: false }, args),
       // POST /tasks/{id}/ship — rank: any-builder — POST /tasks/:id/ship
       postTasksIdShip: (args) => request("POST", "/tasks/{id}/ship", { hasBody: true }, args),
       // DELETE /tasks/{id}/visual — rank: any-builder — DELETE /tasks/:id/visual