@bongos/core 1.17.2 → 1.17.3

package/docs/api/openapi.json

@@ -4589,6 +4589,58 @@
         ]
       }
     },
+    "/goals/{id}/suggest-criteria": {
+      "get": {
+        "operationId": "get_goals_id_suggest_criteria",
+        "tags": [
+          "goals"
+        ],
+        "summary": "GET /goals/:id/suggest-criteria",
+        "description": "GET /goals/:id/suggest-criteria?title=&description=&limit= — task 2165. Rank THIS goal's unsatisfied criteria by lexical overlap with a candidate task, so a create flow can SUGGEST which done-when criterion to link (the author confirms/overrides — nothing is auto-linked). Read-only + advisory; rank: any-builder (same as GET /goals/:id).\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/goals.js",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `id`."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetGoalsIdSuggestCriteriaResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/goals/{id}/tasks": {
       "post": {
         "operationId": "post_goals_id_tasks",
@@ -8464,14 +8516,7 @@
         },
         "responses": {
           "200": {
-            "description": "Success.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PostTasksResponse"
-                }
-              }
-            }
+            "description": "Success."
           },
           "400": {
             "$ref": "#/components/responses/ValidationFailed"
@@ -10497,6 +10542,17 @@
           "dependencies"
         ]
       },
+      "GetGoalsIdSuggestCriteriaResponse": {
+        "type": "object",
+        "properties": {
+          "goal_id": {},
+          "suggestions": {}
+        },
+        "required": [
+          "goal_id",
+          "suggestions"
+        ]
+      },
       "GetGoalsResponse": {
         "type": "object",
         "properties": {
@@ -13752,23 +13808,6 @@
         ],
         "additionalProperties": false
       },
-      "PostTasksResponse": {
-        "type": "object",
-        "properties": {
-          "task": {},
-          "needs_migration": {},
-          "criteria": {},
-          "idempotent": {
-            "type": "boolean"
-          },
-          "credits_reward": {}
-        },
-        "required": [
-          "task",
-          "needs_migration",
-          "criteria"
-        ]
-      },
       "PostVersionsIdDoneWhenRequest": {
         "type": "object",
         "properties": {
@@ -14021,7 +14060,7 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 229,
+  "x-endpoint-count": 230,
   "x-schema-count": 250,
   "x-undocumented-bodies": 8,
   "x-response-schemas": 170,

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # GDS API reference
 
-> **Generated from the live route files** — the route file is authoritative. 229 endpoints across 38 route files.
+> **Generated from the live route files** — the route file is authoritative. 230 endpoints across 38 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`.
@@ -181,7 +181,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/<redacted>
 | GET | `/api/bongos/gate-approvals` | `archon` | — | GET /gate-approvals — open PRs awaiting owner approval (gate-review red), with the verdict + per-file reasons + changed files + diff link. |
 | POST | `/api/bongos/gate-approvals/:pr/approve` | `archon` | — | POST /gate-approvals/:pr/approve — record owner approval for a stuck gate PR and re-run the gate-review check so it clears. |
 
-## `goals` (23)
+## `goals` (24)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -203,6 +203,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/<redacted>
 | POST | `/api/bongos/goals/:id/requests/:reqId/respond` | `any-builder` | `action` | POST /goals/:id/requests/:reqId/respond { action: approve\|deny } — an owner\| manager\|Archon resolves a pending join-request (task 1952). |
 | POST | `/api/bongos/goals/:id/requests/:reqId/withdraw` | `any-builder` | — | POST /goals/:id/requests/:reqId/withdraw — the requester cancels their OWN pending join-request (task 1953): the symmetric self-served mi… |
 | POST | `/api/bongos/goals/:id/scope` | `metic+archon` | `add` | POST /goals/:id/scope — "ask to widen": add module(s) to a goal's scope_modules (ADR 0086 §4 / BV1.R64). |
+| GET | `/api/bongos/goals/:id/suggest-criteria` | `any-builder` | — | GET /goals/:id/suggest-criteria?title=&description=&limit= — task 2165. |
 | POST | `/api/bongos/goals/:id/tasks` | `any-builder` | `title`, `description`, `touches`, `est_minutes`, `priority`, `kind`, `discipline`, `value_summary`, `parent_task_id` | POST /goals/:id/tasks — bounded task authoring within a goal's scope (BV1.R60 / ADR 0086 §3). |
 | POST | `/api/bongos/goals/:id/transfer` | `any-builder` | `builder_id` | POST /goals/:id/transfer — hand the goal to a new owner (task 1735). |
 | PATCH | `/api/bongos/goals/:id/visibility` | `any-builder` | `visibility` | PATCH /goals/:id/visibility — make a goal public\|private (task 1952 / ADR 0112). |