@bongos/core 1.25.12 → 1.25.13

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/bongos/package-core.js",
-  "core_version": "1.25.12",
-  "core_contract": "1.25.12",
-  "source_commit": "5eb4ec735850cf6ebc5665a9231ef3f808303216",
+  "core_version": "1.25.13",
+  "core_contract": "1.25.13",
+  "source_commit": "6144401eb07488528be2d4c98786f479a900c9d0",
   "source_ref": "HEAD",
-  "built_at": "2026-11-13T19:09:33.917Z",
+  "built_at": "2026-11-13T19:37:53.952Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 656,
     "agent_docs_stubbed": 33,
-    "functional_verbatim": 4009,
+    "functional_verbatim": 4016,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 4699,
-  "tree_sha256": "39c06d7795f2cf9046050b08d20f5f8ada423a1efe3064d0791ba6a22fd03846",
+  "file_count": 4706,
+  "tree_sha256": "fbec1349dacd426f02d295f9f37bf8e36691d86d3ba8c9d5df7f9c70123dc2e7",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -332,12 +332,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "975f22a318be1e185d76e76fdcba623e00318e5dc2cbc257a36192a6df3066e4"
+      "sha256": "443db1b62f84147c42bcbc1d2556e47f90925c2e1fe67107193101ae611d69f4"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "140924d60108d727a9652a94ff8ede3dc515976b508bf07a54b2c6327a2c80bc"
+      "sha256": "701b55ca742af38e1fd644a11fc550c992b4c243621a3a66b8b303d988f9bef5"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -347,17 +347,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "fa491e142cfd9941d5779ca483b4032c06aed4c46365cb2c1b5d1b1ea0c73a6d"
+      "sha256": "01eec68e5292a12cb58ddc22e78893c0dd1ef374c4949d8f58486cd86ba3809c"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "8ffb0c1faa3c5dcd128058bdc5f127333c06e916da6daaa94d4d24ea3f37edf0"
+      "sha256": "72b35b37e40d677c4f0b3df0fbc69c7bc062daeac97fd71b67e9a463af24fadb"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "99d5d3c4fe3265405d7446409d171e084432c4cf330c4476fdc3f5c93bc6056b"
+      "sha256": "603986b89a0e4030b3ce590f47d2d2f99e994ca3b596c58a117cb2c08d37f558"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2502,12 +2502,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "1835d64e19290c34c53e25da3ef0fdafad5112ea39a89387aef859784523680c"
+      "sha256": "956db8f10f4503ccaedbfe94b50449bdffbb70fd8fdb1aae7397b9973e62c84f"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "3b07133efee8bde9714e1e3828d5d0508e030f669e432c83ca0d60000876336b"
+      "sha256": "b60a213d5657260a2e12a85eb83e364722e954cb2c39730c6a596433a7d73126"
     },
     {
       "path": "docs/architecture.md",
@@ -3082,7 +3082,7 @@
     {
       "path": "docs/file-map.md",
       "mode": "0000644",
-      "sha256": "4cd32a0888cf2216e43dea2ada3986d214eb6f391d7484c7ed35931d11bdd0ee"
+      "sha256": "0d82688dbf0f4b2fb85eaabe58972e9fedc7579c933e83ce431624567099ff36"
     },
     {
       "path": "docs/handoff-template.md",
@@ -3092,7 +3092,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "6b0d0e8cde4b5dcd1366775407312925bf68f1fc93fad031cec90fb12dffa46e"
+      "sha256": "0ddc252d589300b4d36f14e8c24f5133e17da786060a2c7ae7b50c7caa77e86e"
     },
     {
       "path": "docs/modules-contract.md",
@@ -5527,17 +5527,22 @@
     {
       "path": "modules/front-door-guide/claude.js",
       "mode": "0000644",
-      "sha256": "4ef75dd80af31db062183ea3b4446358bc68d2740e111ff93a92d2640fbe5477"
+      "sha256": "789c754572ea1183ea276f66e202192d1ccf3032d4661d3d5e572de41ce5a3c9"
+    },
+    {
+      "path": "modules/front-door-guide/context.js",
+      "mode": "0000644",
+      "sha256": "81c10bc4e96f603416cab0c8bb6af3c204b136d67ab7f01fede558de39c06c0c"
     },
     {
       "path": "modules/front-door-guide/db.js",
       "mode": "0000644",
-      "sha256": "2ed6652a13137fde3aa7cdc381e299e3223551f3ba27cf4b3be5bb15b5f13a5f"
+      "sha256": "1bbe4f1605e1e8cc6daa6d32150e7cd32cb28df5f527f88b8d36a0d6b6dcc1fc"
     },
     {
       "path": "modules/front-door-guide/guide.js",
       "mode": "0000644",
-      "sha256": "0264d44c5c026b65ff7be2be5cabec5b44dc0cec2c4f8c8dbef0ed39969d779b"
+      "sha256": "590a26cd79ce41f84fa29635da0e63fc682db3653fdebeb9ba0e834a6fa4062c"
     },
     {
       "path": "modules/front-door-guide/limits.js",
@@ -5549,20 +5554,40 @@
       "mode": "0000644",
       "sha256": "aad5ccdcfcdc275e5f3448d9e90c4982d5f382fb1e4d015c4709ddb4354837a7"
     },
+    {
+      "path": "modules/front-door-guide/migrations/front_door_guide_002_plan_and_account.sql",
+      "mode": "0000644",
+      "sha256": "632ea54bd430c2d143da7323ad848f28a1c53ac0735850d04cd6177b10c9c857"
+    },
     {
       "path": "modules/front-door-guide/module.json",
       "mode": "0000644",
-      "sha256": "7f3844d43cc45d566be8200444324815f2e5a65e33789d640d9aac14dd129861"
+      "sha256": "de486a674d919fed27a3356dade38e29c14dc2a0efa45eb4f9013fdeb17cd326"
+    },
+    {
+      "path": "modules/front-door-guide/plan.js",
+      "mode": "0000644",
+      "sha256": "6da0d0b8c41c9a8b8fbffacbbc85cffe1e7c61853f847fb2ac72b0ec77ae0460"
+    },
+    {
+      "path": "modules/front-door-guide/pollers/retention-sweep.js",
+      "mode": "0000644",
+      "sha256": "12c973f96f276c3552e6d4137fe29d39e1319286418f9f81231a2661da663209"
+    },
+    {
+      "path": "modules/front-door-guide/routes/front-door-guide-plan.js",
+      "mode": "0000644",
+      "sha256": "58cee518fe51190f7d4105b82d199f5868b6a0fd8747c9212a0e83bed435ac06"
     },
     {
       "path": "modules/front-door-guide/routes/front-door-guide.js",
       "mode": "0000644",
-      "sha256": "798c216746610784077a50f24096d633a2443bfc80bdb862dc382471d0ff5913"
+      "sha256": "f53fd28640999a4ab2868010b7502712fb9b82d70a043d5f97aa916bd603b9e8"
     },
     {
       "path": "modules/front-door-guide/settings.js",
       "mode": "0000644",
-      "sha256": "dcb4af540fe925eedb9a3e28f5118fbe70c379b9b328c02a1bf026491d8b652a"
+      "sha256": "fc0726ff9e1e0f2be291d8af37ff2ac1f36735c7dcf376bf9c4c201e2db35e6e"
     },
     {
       "path": "modules/government/CLAUDE.md",
@@ -10202,7 +10227,7 @@
     {
       "path": "modules/provisioning/module.json",
       "mode": "0000644",
-      "sha256": "cf3310beddd37559b57a4fa996430d73e6957b297bfa675ed46148b926dd4150"
+      "sha256": "535232bcf3691956bd0e34386da934b23f25889334dcad16c3f2983e2104b6ad"
     },
     {
       "path": "modules/provisioning/onboard-plan.js",
@@ -10357,7 +10382,7 @@
     {
       "path": "modules/provisioning/seams.js",
       "mode": "0000644",
-      "sha256": "5a3fe49444a9c176e4b86bb0fa9fc50d90d165e87c4e9857c9e1de410c01ad12"
+      "sha256": "26168956a1c30dcb6192d2c0f4865ab3bc02fe89eb4551b82a66069027e8f473"
     },
     {
       "path": "modules/provisioning/settings-push.js",
@@ -12297,12 +12322,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "222aede17920090083f580d3f9e9163bee43e6a268ca31638253a55f53695874"
+      "sha256": "3e98540a12076778a81f41e055028f600bcbf94c0c2a555adf002c69d2b72734"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "47b5416c11fe0fd7b4475f39909b9891b9f3aa0ab3490498e2191803cb1f4b99"
+      "sha256": "158a3afd6782e3f28c2a49dd85e5fe3a83bb8debb3464a5d851c685fb36f53ba"
     },
     {
       "path": "public-docs/index.html",
@@ -12322,7 +12347,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "7ff1f4117ef6c899824b56c4780177db1cd5979234db26b70e27d932ba58e29f"
+      "sha256": "6010acbd56137643326e0ecc314d93c9b097dd4cbff4cf9d801e4ce7a51acc67"
     },
     {
       "path": "scripts/bongos/CLAUDE.md",
@@ -13592,7 +13617,7 @@
     {
       "path": "scripts/bongos/run-unit-tests.js",
       "mode": "0000644",
-      "sha256": "85fc4fb8e3940c71b4f2eac604374b583bca16e6e590847d597cf9e59fbb44f7"
+      "sha256": "248d61074607a03eb23d6a23c009a8ed8f332128865c591d7481325943d2f61d"
     },
     {
       "path": "scripts/bongos/runner-drift.js",
@@ -15977,7 +16002,7 @@
     {
       "path": "src/bongos/module-scope-map.js",
       "mode": "0000644",
-      "sha256": "74b9c7908fd548adb9a718cc3c4daa8d3d0c13ac5a9d5367e726632c34dadfb1"
+      "sha256": "92b6ac609252f96e73acab6a9171cda465d36d75975ede79c96f13176e0d54ef"
     },
     {
       "path": "src/bongos/module-store.js",
@@ -16332,7 +16357,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "32107c8946e5617f4daf8a8974065aa78a010471b7d8c1f4fdac155df7bae0e1"
+      "sha256": "012ede63ed757a41e42926e2d3b0516e703aede0515a5140614882f16607d470"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -18334,6 +18359,16 @@
       "mode": "0000644",
       "sha256": "d4f0af7817c3e0f031fc00d8b77d2b94ddb994a39d6a03e3ba9badabae362f7a"
     },
+    {
+      "path": "tests/front_door_guide_db.mjs",
+      "mode": "0000644",
+      "sha256": "e5f04555dd7bf89159afe0bef0ea1bc98f3218b9643dff122dd847f5730a923c"
+    },
+    {
+      "path": "tests/front_door_guide_plan.mjs",
+      "mode": "0000644",
+      "sha256": "42bf945cfe325b0654f6ab621f0cc95b5a97e712641ae088ff577753ec042ad5"
+    },
     {
       "path": "tests/funded_project_pays_proof_db.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`)
-- 706 operations across 86 resource groups
+- 709 operations across 86 resource groups
 
 ## Use it from your project
 

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

@@ -491,8 +491,14 @@ function createClient(opts = {}) {
       postFrontDoorGuideConversations: (args) => request("POST", "/front-door-guide/conversations", { hasBody: true }, args),
       // GET /front-door-guide/conversations/{id} — rank: public — GET /front-door-guide/conversations/:id
       getFrontDoorGuideConversationsId: (args) => request("GET", "/front-door-guide/conversations/{id}", { hasBody: false }, args),
+      // POST /front-door-guide/conversations/{id}/attach — rank: any-builder — POST /front-door-guide/conversations/:id/attach
+      postFrontDoorGuideConversationsIdAttach: (args) => request("POST", "/front-door-guide/conversations/{id}/attach", { hasBody: true }, args),
       // POST /front-door-guide/conversations/{id}/messages — rank: public — POST /front-door-guide/conversations/:id/messages
       postFrontDoorGuideConversationsIdMessages: (args) => request("POST", "/front-door-guide/conversations/{id}/messages", { hasBody: true }, args),
+      // POST /front-door-guide/conversations/{id}/plan — rank: public — POST /front-door-guide/conversations/:id/plan
+      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/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

@@ -490,8 +490,14 @@ function createClient(opts = {}) {
       postFrontDoorGuideConversations: (args) => request("POST", "/front-door-guide/conversations", { hasBody: true }, args),
       // GET /front-door-guide/conversations/{id} — rank: public — GET /front-door-guide/conversations/:id
       getFrontDoorGuideConversationsId: (args) => request("GET", "/front-door-guide/conversations/{id}", { hasBody: false }, args),
+      // POST /front-door-guide/conversations/{id}/attach — rank: any-builder — POST /front-door-guide/conversations/:id/attach
+      postFrontDoorGuideConversationsIdAttach: (args) => request("POST", "/front-door-guide/conversations/{id}/attach", { hasBody: true }, args),
       // POST /front-door-guide/conversations/{id}/messages — rank: public — POST /front-door-guide/conversations/:id/messages
       postFrontDoorGuideConversationsIdMessages: (args) => request("POST", "/front-door-guide/conversations/{id}/messages", { hasBody: true }, args),
+      // POST /front-door-guide/conversations/{id}/plan — rank: public — POST /front-door-guide/conversations/:id/plan
+      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/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

@@ -75,7 +75,7 @@ export interface GetCoreUpgradesResponse { ok: boolean; running: unknown; limit:
 export interface GetDiscordChannelsPlanResponse { ok: boolean; guild_id: unknown; op_count: unknown; ops: unknown; warnings: unknown }
 export interface GetDiscordChannelsSnapshotResponse { ok: boolean; guild_id: unknown; config: unknown; warnings: unknown }
 export interface GetDoneWhenPendingReviewResponse { criteria: unknown; count: unknown }
-export interface GetFrontDoorGuideConversationsIdResponse { ok: boolean; conversation: unknown; transcript: unknown }
+export interface GetFrontDoorGuideMineResponse { ok: boolean; conversation: unknown }
 export interface GetGithubOrgsOrgResponse { org: unknown }
 export interface GetGithubRepoResponse { ok: boolean; repo: unknown; private_deployable: boolean }
 export interface GetGithubReposResponse { repos: unknown }
@@ -390,7 +390,10 @@ export interface PostDoneWhenCriterionIdUnsatisfyResponse { criterion: unknown }
 export interface PostFeedbackReceiptRequest { sha256: string; kind?: "bug" | "idea" }
 export interface PostFeedbackReceiptResponse { ok: boolean; receipt: unknown; hub: unknown }
 export interface PostFoundingPlanRequest { days?: Record<string, unknown>; passes?: number; advisors?: string; government?: string; expected_builders?: number; existing?: boolean }
+export interface PostFrontDoorGuideConversationsIdAttachRequest { token: string }
+export interface PostFrontDoorGuideConversationsIdAttachResponse { ok: boolean; conversation: unknown }
 export interface PostFrontDoorGuideConversationsIdMessagesRequest { token: string; text: string; website?: string }
+export interface PostFrontDoorGuideConversationsIdPlanRequest { token: string; website?: string }
 export interface PostFrontDoorGuideConversationsRequest { website?: string }
 export interface PostGithubRepoInviteRequest { github_login: string; permission?: string }
 export interface PostGithubRepoVisibilityRequest { repo: string; visibility: "public" | "private" }
@@ -1165,9 +1168,15 @@ export interface BongosClient {
     /** POST /front-door-guide/conversations — rank: public */
     postFrontDoorGuideConversations(args?: RequestArgs & { body?: PostFrontDoorGuideConversationsRequest }): Promise<ApiResponse>;
     /** GET /front-door-guide/conversations/{id} — rank: public */
-    getFrontDoorGuideConversationsId(args?: RequestArgs): Promise<GetFrontDoorGuideConversationsIdResponse>;
+    getFrontDoorGuideConversationsId(args?: RequestArgs): Promise<ApiResponse>;
+    /** POST /front-door-guide/conversations/{id}/attach — rank: any-builder */
+    postFrontDoorGuideConversationsIdAttach(args: RequestArgs & { body: PostFrontDoorGuideConversationsIdAttachRequest }): Promise<PostFrontDoorGuideConversationsIdAttachResponse>;
     /** POST /front-door-guide/conversations/{id}/messages — rank: public */
     postFrontDoorGuideConversationsIdMessages(args: RequestArgs & { body: PostFrontDoorGuideConversationsIdMessagesRequest }): Promise<ApiResponse>;
+    /** POST /front-door-guide/conversations/{id}/plan — rank: public */
+    postFrontDoorGuideConversationsIdPlan(args: RequestArgs & { body: PostFrontDoorGuideConversationsIdPlanRequest }): Promise<ApiResponse>;
+    /** GET /front-door-guide/mine — rank: any-builder */
+    getFrontDoorGuideMine(args?: RequestArgs): Promise<GetFrontDoorGuideMineResponse>;
     /** GET /front-door-guide/status — rank: public */
     getFrontDoorGuideStatus(args?: RequestArgs): Promise<ApiResponse>;
   };

package/clients/bongos-client/index.mjs

@@ -487,8 +487,14 @@ export function createClient(opts = {}) {
       postFrontDoorGuideConversations: (args) => request("POST", "/front-door-guide/conversations", { hasBody: true }, args),
       // GET /front-door-guide/conversations/{id} — rank: public — GET /front-door-guide/conversations/:id
       getFrontDoorGuideConversationsId: (args) => request("GET", "/front-door-guide/conversations/{id}", { hasBody: false }, args),
+      // POST /front-door-guide/conversations/{id}/attach — rank: any-builder — POST /front-door-guide/conversations/:id/attach
+      postFrontDoorGuideConversationsIdAttach: (args) => request("POST", "/front-door-guide/conversations/{id}/attach", { hasBody: true }, args),
       // POST /front-door-guide/conversations/{id}/messages — rank: public — POST /front-door-guide/conversations/:id/messages
       postFrontDoorGuideConversationsIdMessages: (args) => request("POST", "/front-door-guide/conversations/{id}/messages", { hasBody: true }, args),
+      // POST /front-door-guide/conversations/{id}/plan — rank: public — POST /front-door-guide/conversations/:id/plan
+      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/status — rank: public — GET /front-door-guide/status
       getFrontDoorGuideStatus: (args) => request("GET", "/front-door-guide/status", { hasBody: false }, args),
     },

package/docs/api/openapi.json

@@ -7946,25 +7946,81 @@
             "description": "Path parameter `id`."
           }
         ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": []
+      }
+    },
+    "/front-door-guide/conversations/{id}/attach": {
+      "post": {
+        "operationId": "post_front_door_guide_conversations_id_attach",
+        "tags": [
+          "front-door-guide"
+        ],
+        "summary": "POST /front-door-guide/conversations/:id/attach",
+        "description": "the visitor has just signed in; the chat moves onto their account.\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",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `id`."
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostFrontDoorGuideConversationsIdAttachRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
         "responses": {
           "200": {
             "description": "Success.",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetFrontDoorGuideConversationsIdResponse"
+                  "$ref": "#/components/schemas/PostFrontDoorGuideConversationsIdAttachResponse"
                 }
               }
             }
           },
           "400": {
-            "$ref": "#/components/responses/BadRequest"
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
           },
           "404": {
             "$ref": "#/components/responses/NotFound"
           }
         },
-        "security": []
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
       }
     },
     "/front-door-guide/conversations/{id}/messages": {
@@ -8013,6 +8069,90 @@
         "security": []
       }
     },
+    "/front-door-guide/conversations/{id}/plan": {
+      "post": {
+        "operationId": "post_front_door_guide_conversations_id_plan",
+        "tags": [
+          "front-door-guide"
+        ],
+        "summary": "POST /front-door-guide/conversations/:id/plan",
+        "description": "the visitor has no account yet.\n\n**Rank:** `public` — No authentication — any caller.",
+        "x-rank": "public",
+        "x-source": "modules/front-door-guide/routes/front-door-guide-plan.js",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `id`."
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostFrontDoorGuideConversationsIdPlanRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": []
+      }
+    },
+    "/front-door-guide/mine": {
+      "get": {
+        "operationId": "get_front_door_guide_mine",
+        "tags": [
+          "front-door-guide"
+        ],
+        "summary": "GET /front-door-guide/mine",
+        "description": "my newest chat and plan (the creation wizard's pre-fill reads it).\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.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetFrontDoorGuideMineResponse"
+                }
+              }
+            }
+          },
+          "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",
@@ -33721,19 +33861,17 @@
           "count"
         ]
       },
-      "GetFrontDoorGuideConversationsIdResponse": {
+      "GetFrontDoorGuideMineResponse": {
         "type": "object",
         "properties": {
           "ok": {
             "type": "boolean"
           },
-          "conversation": {},
-          "transcript": {}
+          "conversation": {}
         },
         "required": [
           "ok",
-          "conversation",
-          "transcript"
+          "conversation"
         ]
       },
       "GetGithubOrgsOrgResponse": {
@@ -38246,6 +38384,32 @@
         },
         "additionalProperties": false
       },
+      "PostFrontDoorGuideConversationsIdAttachRequest": {
+        "type": "object",
+        "properties": {
+          "token": {
+            "type": "string",
+            "maxLength": 64
+          }
+        },
+        "required": [
+          "token"
+        ],
+        "additionalProperties": false
+      },
+      "PostFrontDoorGuideConversationsIdAttachResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "conversation": {}
+        },
+        "required": [
+          "ok",
+          "conversation"
+        ]
+      },
       "PostFrontDoorGuideConversationsIdMessagesRequest": {
         "type": "object",
         "properties": {
@@ -38268,6 +38432,23 @@
         ],
         "additionalProperties": false
       },
+      "PostFrontDoorGuideConversationsIdPlanRequest": {
+        "type": "object",
+        "properties": {
+          "token": {
+            "type": "string",
+            "maxLength": 64
+          },
+          "website": {
+            "type": "string",
+            "maxLength": 500
+          }
+        },
+        "required": [
+          "token"
+        ],
+        "additionalProperties": false
+      },
       "PostFrontDoorGuideConversationsRequest": {
         "type": "object",
         "properties": {
@@ -44165,9 +44346,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 706,
-  "x-schema-count": 742,
+  "x-endpoint-count": 709,
+  "x-schema-count": 745,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 467,
+  "x-response-schemas": 468,
   "x-generated-by": "scripts/bongos/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. 706 endpoints across 119 route files.
+> **Generated from the live route files** — the route file is authoritative. 709 endpoints across 120 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`.
@@ -328,13 +328,16 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | POST | `/api/bongos/founding/stages/:stage/close` | `any-builder` | — | task 1005121: one call. |
 | POST | `/api/bongos/founding/start` | `any-builder` | — |  |
 
-## `front-door-guide` (4)
+## `front-door-guide` (7)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
 | POST | `/api/bongos/front-door-guide/conversations` | `public` | `website` | start a chat. |
 | GET | `/api/bongos/front-door-guide/conversations/:id` | `public` | — | the transcript, for the plan and the sign-up hand-off. |
+| POST | `/api/bongos/front-door-guide/conversations/:id/attach` | `any-builder` | `token` | the visitor has just signed in; the chat moves onto their account. |
 | POST | `/api/bongos/front-door-guide/conversations/:id/messages` | `public` | `token`, `text`, `website` | 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/status` | `public` | — | the landing asks before it offers the chat. |
 
 ## `github` (8)