@bongos/core 1.25.18 → 1.25.20

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`)
-- 729 operations across 88 resource groups
+- 731 operations across 88 resource groups
 
 ## Use it from your project
 

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

@@ -519,6 +519,8 @@ function createClient(opts = {}) {
       getFoundingWorkStageAnswersQuestionHistory: (args) => request("GET", "/founding/work/{stage}/answers/{question}/history", { hasBody: false }, args),
       // GET /founding/work/{stage}/assist — rank: any-builder — GET /founding/work/:stage/assist
       getFoundingWorkStageAssist: (args) => request("GET", "/founding/work/{stage}/assist", { hasBody: false }, args),
+      // GET /founding/work/{stage}/document — rank: any-builder — GET /founding/work/:stage/document
+      getFoundingWorkStageDocument: (args) => request("GET", "/founding/work/{stage}/document", { hasBody: false }, args),
       // PUT /founding/work/{stage}/door — rank: any-builder — PUT /founding/work/:stage/door
       putFoundingWorkStageDoor: (args) => request("PUT", "/founding/work/{stage}/door", { hasBody: true }, args),
       // PUT /founding/work/{stage}/link — rank: any-builder — PUT /founding/work/:stage/link
@@ -539,6 +541,8 @@ function createClient(opts = {}) {
       postFrontDoorGuideConversationsIdPlan: (args) => request("POST", "/front-door-guide/conversations/{id}/plan", { hasBody: true }, args),
       // GET /front-door-guide/mine — rank: any-builder — GET /front-door-guide/mine
       getFrontDoorGuideMine: (args) => request("GET", "/front-door-guide/mine", { hasBody: false }, args),
+      // GET /front-door-guide/mine/handoff.md — rank: any-builder — GET /front-door-guide/mine/handoff.md
+      getFrontDoorGuideMineHandoffMd: (args) => request("GET", "/front-door-guide/mine/handoff.md", { hasBody: false }, args),
       // GET /front-door-guide/status — rank: public — GET /front-door-guide/status
       getFrontDoorGuideStatus: (args) => request("GET", "/front-door-guide/status", { hasBody: false }, args),
     },

package/clients/bongos-client/index.cjs

@@ -518,6 +518,8 @@ function createClient(opts = {}) {
       getFoundingWorkStageAnswersQuestionHistory: (args) => request("GET", "/founding/work/{stage}/answers/{question}/history", { hasBody: false }, args),
       // GET /founding/work/{stage}/assist — rank: any-builder — GET /founding/work/:stage/assist
       getFoundingWorkStageAssist: (args) => request("GET", "/founding/work/{stage}/assist", { hasBody: false }, args),
+      // GET /founding/work/{stage}/document — rank: any-builder — GET /founding/work/:stage/document
+      getFoundingWorkStageDocument: (args) => request("GET", "/founding/work/{stage}/document", { hasBody: false }, args),
       // PUT /founding/work/{stage}/door — rank: any-builder — PUT /founding/work/:stage/door
       putFoundingWorkStageDoor: (args) => request("PUT", "/founding/work/{stage}/door", { hasBody: true }, args),
       // PUT /founding/work/{stage}/link — rank: any-builder — PUT /founding/work/:stage/link
@@ -538,6 +540,8 @@ function createClient(opts = {}) {
       postFrontDoorGuideConversationsIdPlan: (args) => request("POST", "/front-door-guide/conversations/{id}/plan", { hasBody: true }, args),
       // GET /front-door-guide/mine — rank: any-builder — GET /front-door-guide/mine
       getFrontDoorGuideMine: (args) => request("GET", "/front-door-guide/mine", { hasBody: false }, args),
+      // GET /front-door-guide/mine/handoff.md — rank: any-builder — GET /front-door-guide/mine/handoff.md
+      getFrontDoorGuideMineHandoffMd: (args) => request("GET", "/front-door-guide/mine/handoff.md", { hasBody: false }, args),
       // GET /front-door-guide/status — rank: public — GET /front-door-guide/status
       getFrontDoorGuideStatus: (args) => request("GET", "/front-door-guide/status", { hasBody: false }, args),
     },

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

@@ -620,7 +620,7 @@ export interface PostProvisioningInstancesIdRestartResponse { ok: boolean; queue
 export interface PostProvisioningInstancesIdTeardownResponse { ok: boolean; queued: unknown; action: unknown; status: unknown; superseded: unknown; sandbox_key_lent: unknown; message: unknown }
 export interface PostProvisioningInstancesIdUpdateSubscriptionRequest { subscribed: boolean }
 export interface PostProvisioningInstancesIdUpdateSubscriptionResponse { ok: boolean; update_subscribed: unknown; previous: unknown; changed: unknown }
-export interface PostProvisioningInstancesRequest { slug: string; target_ref?: string; hosting_shape?: string; domain?: string; no_address?: boolean; tier?: string; onboard_mode?: string; type?: string; description?: string; detail?: Record<string, unknown>; modules?: string[]; terms_acknowledged?: boolean; demo?: Record<string, unknown>; ship_mode?: "auto" | "manual"; genesis?: boolean; test?: boolean }
+export interface PostProvisioningInstancesRequest { slug: string; target_ref?: string; hosting_shape?: string; domain?: string; no_address?: boolean; tier?: string; onboard_mode?: string; type?: string; description?: string; detail?: Record<string, unknown>; modules?: string[]; terms_acknowledged?: boolean; demo?: Record<string, unknown>; ship_mode?: "auto" | "manual"; genesis?: boolean; test?: boolean; from_guide?: boolean }
 export interface PostProvisioningPhysicsCheckRequest { description?: string; detail?: Record<string, unknown> }
 export interface PostProvisioningPhysicsCheckResponse { stop: boolean; message: unknown; soft_limits: unknown }
 export interface PostProvisioningRenderLookupRequest { key: string; owner_id?: string }
@@ -1211,6 +1211,8 @@ export interface BongosClient {
     getFoundingWorkStageAnswersQuestionHistory(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /founding/work/{stage}/assist — rank: any-builder */
     getFoundingWorkStageAssist(args?: RequestArgs): Promise<ApiResponse>;
+    /** GET /founding/work/{stage}/document — rank: any-builder */
+    getFoundingWorkStageDocument(args?: RequestArgs): Promise<ApiResponse>;
     /** PUT /founding/work/{stage}/door — rank: any-builder */
     putFoundingWorkStageDoor(args: RequestArgs & { body: PutFoundingWorkStageDoorRequest }): Promise<ApiResponse>;
     /** PUT /founding/work/{stage}/link — rank: any-builder */
@@ -1231,6 +1233,8 @@ export interface BongosClient {
     postFrontDoorGuideConversationsIdPlan(args: RequestArgs & { body: PostFrontDoorGuideConversationsIdPlanRequest }): Promise<ApiResponse>;
     /** GET /front-door-guide/mine — rank: any-builder */
     getFrontDoorGuideMine(args?: RequestArgs): Promise<GetFrontDoorGuideMineResponse>;
+    /** GET /front-door-guide/mine/handoff.md — rank: any-builder */
+    getFrontDoorGuideMineHandoffMd(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /front-door-guide/status — rank: public */
     getFrontDoorGuideStatus(args?: RequestArgs): Promise<ApiResponse>;
   };

package/clients/bongos-client/index.mjs

@@ -515,6 +515,8 @@ export function createClient(opts = {}) {
       getFoundingWorkStageAnswersQuestionHistory: (args) => request("GET", "/founding/work/{stage}/answers/{question}/history", { hasBody: false }, args),
       // GET /founding/work/{stage}/assist — rank: any-builder — GET /founding/work/:stage/assist
       getFoundingWorkStageAssist: (args) => request("GET", "/founding/work/{stage}/assist", { hasBody: false }, args),
+      // GET /founding/work/{stage}/document — rank: any-builder — GET /founding/work/:stage/document
+      getFoundingWorkStageDocument: (args) => request("GET", "/founding/work/{stage}/document", { hasBody: false }, args),
       // PUT /founding/work/{stage}/door — rank: any-builder — PUT /founding/work/:stage/door
       putFoundingWorkStageDoor: (args) => request("PUT", "/founding/work/{stage}/door", { hasBody: true }, args),
       // PUT /founding/work/{stage}/link — rank: any-builder — PUT /founding/work/:stage/link
@@ -535,6 +537,8 @@ export function createClient(opts = {}) {
       postFrontDoorGuideConversationsIdPlan: (args) => request("POST", "/front-door-guide/conversations/{id}/plan", { hasBody: true }, args),
       // GET /front-door-guide/mine — rank: any-builder — GET /front-door-guide/mine
       getFrontDoorGuideMine: (args) => request("GET", "/front-door-guide/mine", { hasBody: false }, args),
+      // GET /front-door-guide/mine/handoff.md — rank: any-builder — GET /front-door-guide/mine/handoff.md
+      getFrontDoorGuideMineHandoffMd: (args) => request("GET", "/front-door-guide/mine/handoff.md", { hasBody: false }, args),
       // GET /front-door-guide/status — rank: public — GET /front-door-guide/status
       getFrontDoorGuideStatus: (args) => request("GET", "/front-door-guide/status", { hasBody: false }, args),
     },

package/docs/adr/0408-a-genesis-stage-is-three-doors-onto-one-record.md

@@ -57,6 +57,6 @@ every stage, not a strategize feature that charter then copies.
 - Presentation is left to the game frame (the founding of the government district) and
   the hall version (task 1005285). Today a founder works a stage through their AI session
   and `npx bongos genesis …`.
-- Task 1005115 renders each stage's record as an editable document from this store.
+- Task 1005115 renders each stage's record as an editable document from this store (`documentOf`, `GET /founding/work/:stage/document`), and on a project with no Board Room a stage whose tasks are finished advances by itself.
 - Charter adopted it (task 1005119): how decisions should go and the founder's principles. A question may declare `choices` (a closed answer, stored as its key) where another module reads the answer; the charter stage's read carries the government module's recommendation built from them.
 - Scope adopted it with the project interview (task 1005114): six questions in three groups. `/goal-create` and `/planning-session` read the answers before planning, through `genesis.js context`.

package/docs/api/openapi.json

@@ -8312,7 +8312,7 @@
           "founding"
         ],
         "summary": "GET /founding/work",
-        "description": "The read path for every door and for AI sessions planning a goal or task.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "description": "**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
         "x-rank": "any-builder",
         "x-source": "modules/onboarding/routes/genesis-work.js",
         "responses": {
@@ -8597,6 +8597,51 @@
         ]
       }
     },
+    "/founding/work/{stage}/document": {
+      "get": {
+        "operationId": "get_founding_work_stage_document",
+        "tags": [
+          "founding"
+        ],
+        "summary": "GET /founding/work/:stage/document",
+        "description": "The stage's document (task 1005115): its record read as one named page, editable through the writes below at any time, without reopening the stage.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/onboarding/routes/genesis-work.js",
+        "parameters": [
+          {
+            "name": "stage",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `stage`."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/founding/work/{stage}/door": {
       "put": {
         "operationId": "put_founding_work_stage_door",
@@ -9025,6 +9070,37 @@
         ]
       }
     },
+    "/front-door-guide/mine/handoff.md": {
+      "get": {
+        "operationId": "get_front_door_guide_mine_handoff_md",
+        "tags": [
+          "front-door-guide"
+        ],
+        "summary": "GET /front-door-guide/mine/handoff.md",
+        "description": "my plan as the hand-off file (task 1005274), offered as a download on the creation page. 404 with no plan. The name is only the file's title; it is never stored.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/front-door-guide/routes/front-door-guide-plan.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/front-door-guide/status": {
       "get": {
         "operationId": "get_front_door_guide_status",
@@ -43074,6 +43150,9 @@
           },
           "test": {
             "type": "boolean"
+          },
+          "from_guide": {
+            "type": "boolean"
           }
         },
         "required": [
@@ -45543,7 +45622,7 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 729,
+  "x-endpoint-count": 731,
   "x-schema-count": 759,
   "x-undocumented-bodies": 12,
   "x-response-schemas": 473,

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # Bongos API reference
 
-> **Generated from the live route files** — the route file is authoritative. 729 endpoints across 124 route files.
+> **Generated from the live route files** — the route file is authoritative. 731 endpoints across 124 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`.
@@ -333,7 +333,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | POST | `/api/bongos/first-read/maps/:id/reject` | `metic+archon` | — | .create — the owner's no. |
 | GET | `/api/bongos/first-read/prompt` | `any-builder` | — | the prompt and the shape are instructions, not project data. |
 
-## `founding` (18)
+## `founding` (19)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -346,17 +346,18 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | POST | `/api/bongos/founding/skip` | `any-builder` | — | Skip genesis: the owner opens the full hall from any stage, no sitting, no gate. |
 | POST | `/api/bongos/founding/stages/:stage/close` | `any-builder` | — | task 1005121: one call. |
 | POST | `/api/bongos/founding/start` | `any-builder` | — |  |
-| GET | `/api/bongos/founding/work` | `any-builder` | — | The read path for every door and for AI sessions planning a goal or task. |
+| GET | `/api/bongos/founding/work` | `any-builder` | — |  |
 | GET | `/api/bongos/founding/work/:stage` | `any-builder` | — |  |
 | PUT | `/api/bongos/founding/work/:stage/answers/:question` | `any-builder` | `state`, `text`, `origin`, `if_empty` |  |
 | DELETE | `/api/bongos/founding/work/:stage/answers/:question` | `any-builder` | — | Un-answer: back to empty, which is not the same as skipped. |
 | GET | `/api/bongos/founding/work/:stage/answers/:question/history` | `any-builder` | — |  |
 | GET | `/api/bongos/founding/work/:stage/assist` | `any-builder` | — |  |
+| GET | `/api/bongos/founding/work/:stage/document` | `any-builder` | — | The stage's document (task 1005115): its record read as one named page, editable through the writes below at any time, without reopening … |
 | PUT | `/api/bongos/founding/work/:stage/door` | `any-builder` | `door` | The founder's writes. |
 | PUT | `/api/bongos/founding/work/:stage/link` | `any-builder` | `url` |  |
 | PUT | `/api/bongos/founding/work/:stage/page` | `any-builder` | `page` |  |
 
-## `front-door-guide` (7)
+## `front-door-guide` (8)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -366,6 +367,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | POST | `/api/bongos/front-door-guide/conversations/:id/messages` | `public` | `token`, `text`, `website`, `starting_point` | one visitor message, one guide reply. |
 | POST | `/api/bongos/front-door-guide/conversations/:id/plan` | `public` | `token`, `website` | the visitor has no account yet. |
 | GET | `/api/bongos/front-door-guide/mine` | `any-builder` | — | my newest chat and plan (the creation wizard's pre-fill reads it). |
+| GET | `/api/bongos/front-door-guide/mine/handoff.md` | `any-builder` | — | my plan as the hand-off file (task 1005274), offered as a download on the creation page. |
 | GET | `/api/bongos/front-door-guide/status` | `public` | — | the landing asks before it offers the chat. |
 
 ## `github` (8)
@@ -882,7 +884,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/provisioning/github-app/status` | `public` | — | GET /provisioning/github-app/status?state=<> — the PUBLIC progress read (task 1004548; the checklist since task 1004649). |
 | GET | `/api/bongos/provisioning/health` | `public` | — | GET /provisioning/health — liveness + the core version this module mounted against. |
 | GET | `/api/bongos/provisioning/instances` | `any-builder` | — | GET /provisioning/instances — the caller's own instances + each open intent. |
-| POST | `/api/bongos/provisioning/instances` | `any-builder` | `slug`, `target_ref`, `hosting_shape`, `domain`, `no_address`, `tier`, `onboard_mode`, `type`, `description`, `detail`, `modules`, `terms_acknowledged`, `demo`, `ship_mode`, `genesis`, `test` | POST /provisioning/instances — request a new instance. |
+| POST | `/api/bongos/provisioning/instances` | `any-builder` | `slug`, `target_ref`, `hosting_shape`, `domain`, `no_address`, `tier`, `onboard_mode`, `type`, `description`, `detail`, `modules`, `terms_acknowledged`, `demo`, `ship_mode`, `genesis`, `test`, `from_guide` | POST /provisioning/instances — request a new instance. |
 | GET | `/api/bongos/provisioning/instances/:id` | `any-builder` | — | GET /provisioning/instances/:id — read one instance (the manage page's read). |
 | GET | `/api/bongos/provisioning/instances/:id/core-upgrade` | `archon` | — | GET the same path — step ONE of the two-step (ADR 0293 D4): what a move would do. |
 | POST | `/api/bongos/provisioning/instances/:id/core-upgrade` | `archon` | — | POST /provisioning/instances/:id/core-upgrade — move the core pin. |