@bongos/core 1.21.51 → 1.21.53

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

@@ -118,6 +118,7 @@ export interface GetMyProjectsInvitesResponse { invites: unknown }
 export interface GetMyProjectsResponse { owned: unknown; building: unknown; applied: unknown }
 export interface GetOverrideRequestsResponse { requests: unknown }
 export interface GetPageNotesIdResponse { note: unknown; images: unknown; ideas: unknown }
+export interface GetPageNotesIdeasResponse { page_path: unknown; ideas: unknown }
 export interface GetPageNotesResponse { page_id: unknown; notes: unknown }
 export interface GetProfilesHandleResponse { account: unknown; cross_project: unknown }
 export interface GetProjectSettingsResponse { rows: unknown }
@@ -419,6 +420,8 @@ export interface PostOverrideRequestsIdDecideRequest { decision: string; note?:
 export interface PostPageNotesIdImagesRequest { content_type: string; data: string; name?: string }
 export interface PostPageNotesIdImagesResponse { image: unknown }
 export interface PostPageNotesIdSubmitResponse { ok: boolean; status: unknown; note_id: unknown }
+export interface PostPageNotesIdeasRequest { page_id: string; page_path?: string; page_title?: string; body_md: string }
+export interface PostPageNotesIdeasResponse { ideas: unknown; split_by: unknown }
 export interface PostPageNotesRequest { page_id: string; page_path?: string; page_title?: string }
 export interface PostPageNotesResponse { note: unknown; images: unknown }
 export interface PostProjectsInviteRequest { client_id: string; github_login: string }
@@ -1300,6 +1303,10 @@ export interface BongosClient {
     postPageNotesIdImages(args: RequestArgs & { body: PostPageNotesIdImagesRequest }): Promise<PostPageNotesIdImagesResponse>;
     /** POST /page-notes/{id}/submit — rank: any-builder */
     postPageNotesIdSubmit(args?: RequestArgs): Promise<PostPageNotesIdSubmitResponse>;
+    /** GET /page-notes/ideas — rank: any-builder */
+    getPageNotesIdeas(args?: RequestArgs): Promise<GetPageNotesIdeasResponse>;
+    /** POST /page-notes/ideas — rank: any-builder */
+    postPageNotesIdeas(args: RequestArgs & { body: PostPageNotesIdeasRequest }): Promise<PostPageNotesIdeasResponse>;
     /** GET /page-notes/images/{id} — rank: any-builder */
     getPageNotesImagesId(args?: RequestArgs): Promise<ApiResponse>;
   };

package/clients/bongos-client/index.mjs

@@ -817,6 +817,10 @@ export function createClient(opts = {}) {
       postPageNotesIdImages: (args) => request("POST", "/page-notes/{id}/images", { hasBody: true }, args),
       // POST /page-notes/{id}/submit — rank: any-builder — POST /page-notes/:id/submit
       postPageNotesIdSubmit: (args) => request("POST", "/page-notes/{id}/submit", { hasBody: true }, args),
+      // GET /page-notes/ideas — rank: any-builder — GET /page-notes/ideas
+      getPageNotesIdeas: (args) => request("GET", "/page-notes/ideas", { hasBody: false }, args),
+      // POST /page-notes/ideas — rank: any-builder — POST /page-notes/ideas
+      postPageNotesIdeas: (args) => request("POST", "/page-notes/ideas", { hasBody: true }, args),
       // GET /page-notes/images/{id} — rank: any-builder — GET /page-notes/images/:id
       getPageNotesImagesId: (args) => request("GET", "/page-notes/images/{id}", { hasBody: false }, args),
     },

package/docs/api/openapi.json

@@ -14820,6 +14820,91 @@
         ]
       }
     },
+    "/page-notes/ideas": {
+      "get": {
+        "operationId": "get_page_notes_ideas",
+        "tags": [
+          "page-notes"
+        ],
+        "summary": "GET /page-notes/ideas",
+        "description": "---------- the ideator's lightbulb (task 1004498) ---------- Registered before /page-notes/:id, which would read 'ideas' as a bad id.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/page-notes/routes/page-notes.js",
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetPageNotesIdeasResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      },
+      "post": {
+        "operationId": "post_page_notes_ideas",
+        "tags": [
+          "page-notes"
+        ],
+        "summary": "POST /page-notes/ideas",
+        "description": "**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/page-notes/routes/page-notes.js",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostPageNotesIdeasRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostPageNotesIdeasResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/page-notes/images/{id}": {
       "get": {
         "operationId": "get_page_notes_images_id",
@@ -25529,6 +25614,17 @@
           "ideas"
         ]
       },
+      "GetPageNotesIdeasResponse": {
+        "type": "object",
+        "properties": {
+          "page_path": {},
+          "ideas": {}
+        },
+        "required": [
+          "page_path",
+          "ideas"
+        ]
+      },
       "GetPageNotesResponse": {
         "type": "object",
         "properties": {
@@ -30214,6 +30310,42 @@
           "note_id"
         ]
       },
+      "PostPageNotesIdeasRequest": {
+        "type": "object",
+        "properties": {
+          "page_id": {
+            "type": "string",
+            "maxLength": 97
+          },
+          "page_path": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "page_title": {
+            "type": "string",
+            "maxLength": 400
+          },
+          "body_md": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "page_id",
+          "body_md"
+        ],
+        "additionalProperties": false
+      },
+      "PostPageNotesIdeasResponse": {
+        "type": "object",
+        "properties": {
+          "ideas": {},
+          "split_by": {}
+        },
+        "required": [
+          "ideas",
+          "split_by"
+        ]
+      },
       "PostPageNotesRequest": {
         "type": "object",
         "properties": {
@@ -32725,9 +32857,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 510,
-  "x-schema-count": 546,
+  "x-endpoint-count": 512,
+  "x-schema-count": 549,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 362,
+  "x-response-schemas": 364,
   "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. 510 endpoints across 93 route files.
+> **Generated from the live route files** — the route file is authoritative. 512 endpoints across 93 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`.
@@ -573,7 +573,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/override-requests` | `metic+archon` | — | GET /override-requests?status=open — Archon queue. |
 | POST | `/api/bongos/override-requests/:id/decide` | `metic+archon` | `decision`, `note` | POST /override-requests/:id/decide — body: { decision: 'approve'\|'deny', note? } On approve, atomically flips the task completed→confirme… |
 
-## `page-notes` (7)
+## `page-notes` (9)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -583,6 +583,8 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | PATCH | `/api/bongos/page-notes/:id` | `any-builder` | `body_md` |  |
 | POST | `/api/bongos/page-notes/:id/images` | `any-builder` | `content_type`, `data`, `name` |  |
 | POST | `/api/bongos/page-notes/:id/submit` | `any-builder` | — |  |
+| GET | `/api/bongos/page-notes/ideas` | `any-builder` | — | ---------- the ideator's lightbulb (task 1004498) ---------- Registered before /page-notes/:id, which would read 'ideas' as a bad id. |
+| POST | `/api/bongos/page-notes/ideas` | `any-builder` | `page_id`, `page_path`, `page_title`, `body_md` |  |
 | GET | `/api/bongos/page-notes/images/:id` | `any-builder` | — |  |
 
 ## `profiles` (1)