@bongos/core 1.19.358 → 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.358",
-  "core_contract": "1.19.358",
-  "source_commit": "6bfaa149e1894ef5d78af75527e0158d951470c7",
+  "core_version": "1.19.359",
+  "core_contract": "1.19.359",
+  "source_commit": "d23c36fb93e62c5c592d80daf5754eba2fc4dbf5",
   "source_ref": "HEAD",
-  "built_at": "2026-08-25T16:32:44.606Z",
+  "built_at": "2026-08-25T17:25:50.103Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 330,
     "agent_docs_stubbed": 22,
-    "functional_verbatim": 1515,
+    "functional_verbatim": 1519,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 1867,
-  "tree_sha256": "bac9c3fc06876d7ba5183bf4a6ace1bdda8e43a3e5f18037d3ebb4e006d7fa7a",
+  "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",
@@ -2547,7 +2547,7 @@
     {
       "path": "modules/builder-settings/builder-needs.js",
       "mode": "0000644",
-      "sha256": "01f32e6f160ffbfde7240cfc1dd0e0bdc3501f13578e073c9397a2a0cccb793b"
+      "sha256": "276a92a2000f2bc0e9e157791947f2ee7e6bfe934a15a996d42dba13984c26d7"
     },
     {
       "path": "modules/builder-settings/db.js",
@@ -2877,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",
@@ -4067,7 +4067,7 @@
     {
       "path": "modules/lifecycle/lifecycle.js",
       "mode": "0000644",
-      "sha256": "07ea278ae8c0f0055d6ac332d7580af55e82fecefda2d1cf46dad1bf27678c59"
+      "sha256": "ba8f6356c8ec9f908878d592d294033db1c9ff9403306a2ae5099df7aa466e72"
     },
     {
       "path": "modules/lifecycle/merge-lock.js",
@@ -4089,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",
@@ -4149,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",
@@ -4194,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",
@@ -4817,12 +4832,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "b155c2a0dda8e0bcfbd1efadbc4ef619a25be608f9e29714e7039f24267bcd25"
+      "sha256": "e06a1a0d00dd8df697613e06d1806ceb797716c292debd219fe8f0b3a3c896cd"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "1f7444718fbae90aa6d3b0f6c33c6cc1052cf48917a3c1c030f7a9de7806ce53"
+      "sha256": "f47e3cf3c97d4ab16fb5fa4cdf59fe3fd20c350114dc587122cc1f5ec5bb9842"
     },
     {
       "path": "public-docs/index.html",
@@ -6612,7 +6627,7 @@
     {
       "path": "src/bongos/routes/me.js",
       "mode": "0000644",
-      "sha256": "dc32a25a531f9ea76c25df57930e0566259737bbd1c559409df61f5b5f87813e"
+      "sha256": "1d9e11f3ca4d08033bc116e79ccf66e901ec4e8c48b61d969eeeceface1f9da1"
     },
     {
       "path": "src/bongos/routes/modules.js",
@@ -6682,7 +6697,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "fdd1d69409cf0ac75e9063d0ec0bf742c83aba0cdc9f15935839c9c6998e96af"
+      "sha256": "0c94e1d2f36bff1e43423ae82fadcd6dbb2013368a3ae1dbba860e486ae7c4a1"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -9214,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