@bongos/core 1.25.17 → 1.25.19

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

@@ -154,6 +154,10 @@ function createClient(opts = {}) {
       // GET /analytics/builder/{id} — rank: any-builder — GET /analytics/builder/:id
       getAnalyticsBuilderId: (args) => request("GET", "/analytics/builder/{id}", { hasBody: false }, args),
     },
+    "appHost": {
+      // GET /app-host — rank: any-builder — GET /app-host
+      getAppHost: (args) => request("GET", "/app-host", { hasBody: false }, args),
+    },
     "artistGate": {
       // GET /artist-gate — rank: any-builder — GET /artist-gate
       getArtistGate: (args) => request("GET", "/artist-gate", { hasBody: false }, args),
@@ -469,12 +473,16 @@ function createClient(opts = {}) {
       getFeedbackReceiptId: (args) => request("GET", "/feedback/receipt/{id}", { hasBody: false }, args),
     },
     "firstRead": {
+      // GET /first-read/catalog — rank: any-builder — GET /first-read/catalog
+      getFirstReadCatalog: (args) => request("GET", "/first-read/catalog", { hasBody: false }, args),
       // POST /first-read/maps — rank: metic+archon — POST /first-read/maps
       postFirstReadMaps: (args) => request("POST", "/first-read/maps", { hasBody: true }, args),
       // GET /first-read/maps/{id} — rank: metic+archon — GET /first-read/maps/:id
       getFirstReadMapsId: (args) => request("GET", "/first-read/maps/{id}", { hasBody: false }, args),
       // POST /first-read/maps/{id}/accept — rank: metic+archon — POST /first-read/maps/:id/accept
       postFirstReadMapsIdAccept: (args) => request("POST", "/first-read/maps/{id}/accept", { hasBody: true }, args),
+      // POST /first-read/maps/{id}/dismiss — rank: metic+archon — POST /first-read/maps/:id/dismiss
+      postFirstReadMapsIdDismiss: (args) => request("POST", "/first-read/maps/{id}/dismiss", { hasBody: true }, args),
       // POST /first-read/maps/{id}/reject — rank: metic+archon — POST /first-read/maps/:id/reject
       postFirstReadMapsIdReject: (args) => request("POST", "/first-read/maps/{id}/reject", { hasBody: true }, args),
       // GET /first-read/prompt — rank: any-builder — GET /first-read/prompt
@@ -511,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
@@ -1515,6 +1525,8 @@ function createClient(opts = {}) {
     "sso": {
       // POST /sso/activity/rollup — rank: public — POST /sso/activity/rollup
       postSsoActivityRollup: (args) => request("POST", "/sso/activity/rollup", { hasBody: true }, args),
+      // POST /sso/app-status — rank: public — POST /sso/app-status
+      postSsoAppStatus: (args) => request("POST", "/sso/app-status", { hasBody: true }, args),
       // POST /sso/applicant-profile — rank: public — POST /sso/applicant-profile
       postSsoApplicantProfile: (args) => request("POST", "/sso/applicant-profile", { hasBody: true }, args),
       // GET /sso/authorize — rank: public — GET /sso/authorize

package/clients/bongos-client/index.cjs

@@ -153,6 +153,10 @@ function createClient(opts = {}) {
       // GET /analytics/builder/{id} — rank: any-builder — GET /analytics/builder/:id
       getAnalyticsBuilderId: (args) => request("GET", "/analytics/builder/{id}", { hasBody: false }, args),
     },
+    "appHost": {
+      // GET /app-host — rank: any-builder — GET /app-host
+      getAppHost: (args) => request("GET", "/app-host", { hasBody: false }, args),
+    },
     "artistGate": {
       // GET /artist-gate — rank: any-builder — GET /artist-gate
       getArtistGate: (args) => request("GET", "/artist-gate", { hasBody: false }, args),
@@ -468,12 +472,16 @@ function createClient(opts = {}) {
       getFeedbackReceiptId: (args) => request("GET", "/feedback/receipt/{id}", { hasBody: false }, args),
     },
     "firstRead": {
+      // GET /first-read/catalog — rank: any-builder — GET /first-read/catalog
+      getFirstReadCatalog: (args) => request("GET", "/first-read/catalog", { hasBody: false }, args),
       // POST /first-read/maps — rank: metic+archon — POST /first-read/maps
       postFirstReadMaps: (args) => request("POST", "/first-read/maps", { hasBody: true }, args),
       // GET /first-read/maps/{id} — rank: metic+archon — GET /first-read/maps/:id
       getFirstReadMapsId: (args) => request("GET", "/first-read/maps/{id}", { hasBody: false }, args),
       // POST /first-read/maps/{id}/accept — rank: metic+archon — POST /first-read/maps/:id/accept
       postFirstReadMapsIdAccept: (args) => request("POST", "/first-read/maps/{id}/accept", { hasBody: true }, args),
+      // POST /first-read/maps/{id}/dismiss — rank: metic+archon — POST /first-read/maps/:id/dismiss
+      postFirstReadMapsIdDismiss: (args) => request("POST", "/first-read/maps/{id}/dismiss", { hasBody: true }, args),
       // POST /first-read/maps/{id}/reject — rank: metic+archon — POST /first-read/maps/:id/reject
       postFirstReadMapsIdReject: (args) => request("POST", "/first-read/maps/{id}/reject", { hasBody: true }, args),
       // GET /first-read/prompt — rank: any-builder — GET /first-read/prompt
@@ -510,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
@@ -1514,6 +1524,8 @@ function createClient(opts = {}) {
     "sso": {
       // POST /sso/activity/rollup — rank: public — POST /sso/activity/rollup
       postSsoActivityRollup: (args) => request("POST", "/sso/activity/rollup", { hasBody: true }, args),
+      // POST /sso/app-status — rank: public — POST /sso/app-status
+      postSsoAppStatus: (args) => request("POST", "/sso/app-status", { hasBody: true }, args),
       // POST /sso/applicant-profile — rank: public — POST /sso/applicant-profile
       postSsoApplicantProfile: (args) => request("POST", "/sso/applicant-profile", { hasBody: true }, args),
       // GET /sso/authorize — rank: public — GET /sso/authorize

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

@@ -75,7 +75,8 @@ 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 GetFirstReadPromptResponse { schema: unknown; file: unknown; prompt: unknown; example: unknown; limits: unknown }
+export interface GetFirstReadCatalogResponse { available: unknown; modules: unknown }
+export interface GetFirstReadPromptResponse { schema: unknown; file: unknown; prompt: unknown; example: unknown; limits: unknown; catalog: unknown }
 export interface GetFrontDoorGuideMineResponse { ok: boolean; conversation: unknown }
 export interface GetGithubOrgsOrgResponse { org: unknown }
 export interface GetGithubRepoResponse { ok: boolean; repo: unknown; private_deployable: boolean }
@@ -391,6 +392,7 @@ export interface PostDoneWhenCriterionIdUnsatisfyResponse { criterion: unknown }
 export interface PostFeedbackReceiptRequest { sha256: string; kind?: "bug" | "idea" }
 export interface PostFeedbackReceiptResponse { ok: boolean; receipt: unknown; hub: unknown }
 export interface PostFirstReadMapsIdAcceptRequest { all?: boolean; items?: string[] }
+export interface PostFirstReadMapsIdDismissRequest { items: string[] }
 export interface PostFirstReadMapsRequest { map: Record<string, unknown> }
 export interface PostFirstReadMapsResponse { map_id: unknown; status: unknown; items: unknown; next: unknown }
 export interface PostFoundingPlanRequest { days?: Record<string, unknown>; passes?: number; advisors?: string; government?: string; expected_builders?: number; existing?: boolean }
@@ -658,6 +660,8 @@ export interface PostSpecialitiesRequest { name: string; discipline: string; sum
 export interface PostSpecialitiesResponse { speciality: unknown }
 export interface PostSsoActivityRollupRequest { client_id: string; client_secret: string; github_id: StringifiableId; credits?: number; tasks_shipped?: number; karma?: number; rank?: string; disciplines?: unknown; recent_ships?: unknown; crafts?: unknown }
 export interface PostSsoActivityRollupResponse { ok: boolean }
+export interface PostSsoAppStatusRequest { client_id: string; client_secret: string }
+export interface PostSsoAppStatusResponse { ok: boolean; known: boolean; app: unknown; sandbox: unknown }
 export interface PostSsoApplicantProfileRequest { client_id: string; client_secret: string; github_id: StringifiableId }
 export interface PostSsoApplicantProfileResponse { profile: unknown; guild: unknown }
 export interface PostSsoDevicePollRequest { device_code: string }
@@ -842,6 +846,10 @@ export interface BongosClient {
     /** GET /analytics/builder/{id} — rank: any-builder */
     getAnalyticsBuilderId(args?: RequestArgs): Promise<ApiResponse>;
   };
+  "appHost": {
+    /** GET /app-host — rank: any-builder */
+    getAppHost(args?: RequestArgs): Promise<ApiResponse>;
+  };
   "artistGate": {
     /** GET /artist-gate — rank: any-builder */
     getArtistGate(args?: RequestArgs): Promise<GetArtistGateResponse>;
@@ -1157,12 +1165,16 @@ export interface BongosClient {
     getFeedbackReceiptId(args?: RequestArgs): Promise<ApiResponse>;
   };
   "firstRead": {
+    /** GET /first-read/catalog — rank: any-builder */
+    getFirstReadCatalog(args?: RequestArgs): Promise<GetFirstReadCatalogResponse>;
     /** POST /first-read/maps — rank: metic+archon */
     postFirstReadMaps(args: RequestArgs & { body: PostFirstReadMapsRequest }): Promise<PostFirstReadMapsResponse>;
     /** GET /first-read/maps/{id} — rank: metic+archon */
     getFirstReadMapsId(args?: RequestArgs): Promise<ApiResponse>;
     /** POST /first-read/maps/{id}/accept — rank: metic+archon */
     postFirstReadMapsIdAccept(args?: RequestArgs & { body?: PostFirstReadMapsIdAcceptRequest }): Promise<ApiResponse>;
+    /** POST /first-read/maps/{id}/dismiss — rank: metic+archon */
+    postFirstReadMapsIdDismiss(args: RequestArgs & { body: PostFirstReadMapsIdDismissRequest }): Promise<ApiResponse>;
     /** POST /first-read/maps/{id}/reject — rank: metic+archon */
     postFirstReadMapsIdReject(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /first-read/prompt — rank: any-builder */
@@ -1199,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 */
@@ -2203,6 +2217,8 @@ export interface BongosClient {
   "sso": {
     /** POST /sso/activity/rollup — rank: public */
     postSsoActivityRollup(args: RequestArgs & { body: PostSsoActivityRollupRequest }): Promise<PostSsoActivityRollupResponse>;
+    /** POST /sso/app-status — rank: public */
+    postSsoAppStatus(args: RequestArgs & { body: PostSsoAppStatusRequest }): Promise<PostSsoAppStatusResponse>;
     /** POST /sso/applicant-profile — rank: public */
     postSsoApplicantProfile(args: RequestArgs & { body: PostSsoApplicantProfileRequest }): Promise<PostSsoApplicantProfileResponse>;
     /** GET /sso/authorize — rank: public */

package/clients/bongos-client/index.mjs

@@ -150,6 +150,10 @@ export function createClient(opts = {}) {
       // GET /analytics/builder/{id} — rank: any-builder — GET /analytics/builder/:id
       getAnalyticsBuilderId: (args) => request("GET", "/analytics/builder/{id}", { hasBody: false }, args),
     },
+    "appHost": {
+      // GET /app-host — rank: any-builder — GET /app-host
+      getAppHost: (args) => request("GET", "/app-host", { hasBody: false }, args),
+    },
     "artistGate": {
       // GET /artist-gate — rank: any-builder — GET /artist-gate
       getArtistGate: (args) => request("GET", "/artist-gate", { hasBody: false }, args),
@@ -465,12 +469,16 @@ export function createClient(opts = {}) {
       getFeedbackReceiptId: (args) => request("GET", "/feedback/receipt/{id}", { hasBody: false }, args),
     },
     "firstRead": {
+      // GET /first-read/catalog — rank: any-builder — GET /first-read/catalog
+      getFirstReadCatalog: (args) => request("GET", "/first-read/catalog", { hasBody: false }, args),
       // POST /first-read/maps — rank: metic+archon — POST /first-read/maps
       postFirstReadMaps: (args) => request("POST", "/first-read/maps", { hasBody: true }, args),
       // GET /first-read/maps/{id} — rank: metic+archon — GET /first-read/maps/:id
       getFirstReadMapsId: (args) => request("GET", "/first-read/maps/{id}", { hasBody: false }, args),
       // POST /first-read/maps/{id}/accept — rank: metic+archon — POST /first-read/maps/:id/accept
       postFirstReadMapsIdAccept: (args) => request("POST", "/first-read/maps/{id}/accept", { hasBody: true }, args),
+      // POST /first-read/maps/{id}/dismiss — rank: metic+archon — POST /first-read/maps/:id/dismiss
+      postFirstReadMapsIdDismiss: (args) => request("POST", "/first-read/maps/{id}/dismiss", { hasBody: true }, args),
       // POST /first-read/maps/{id}/reject — rank: metic+archon — POST /first-read/maps/:id/reject
       postFirstReadMapsIdReject: (args) => request("POST", "/first-read/maps/{id}/reject", { hasBody: true }, args),
       // GET /first-read/prompt — rank: any-builder — GET /first-read/prompt
@@ -507,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
@@ -1511,6 +1521,8 @@ export function createClient(opts = {}) {
     "sso": {
       // POST /sso/activity/rollup — rank: public — POST /sso/activity/rollup
       postSsoActivityRollup: (args) => request("POST", "/sso/activity/rollup", { hasBody: true }, args),
+      // POST /sso/app-status — rank: public — POST /sso/app-status
+      postSsoAppStatus: (args) => request("POST", "/sso/app-status", { hasBody: true }, args),
       // POST /sso/applicant-profile — rank: public — POST /sso/applicant-profile
       postSsoApplicantProfile: (args) => request("POST", "/sso/applicant-profile", { hasBody: true }, args),
       // GET /sso/authorize — rank: public — GET /sso/authorize

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

@@ -57,5 +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

@@ -45,6 +45,10 @@
       "name": "analytics",
       "description": "Endpoints under `/api/bongos/analytics`."
     },
+    {
+      "name": "app-host",
+      "description": "Endpoints under `/api/bongos/app-host`."
+    },
     {
       "name": "artist-gate",
       "description": "Endpoints under `/api/bongos/artist-gate`."
@@ -1748,6 +1752,37 @@
         ]
       }
     },
+    "/app-host": {
+      "get": {
+        "operationId": "get_app_host",
+        "tags": [
+          "app-host"
+        ],
+        "summary": "GET /app-host",
+        "description": "GET /app-host — rank: any signed-in builder; owner-only parts gated on core.pin.move.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/app-host/routes/app-host.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/artist-gate": {
       "get": {
         "operationId": "get_artist_gate",
@@ -7613,6 +7648,44 @@
         "security": []
       }
     },
+    "/first-read/catalog": {
+      "get": {
+        "operationId": "get_first_read_catalog",
+        "tags": [
+          "first-read"
+        ],
+        "summary": "GET /first-read/catalog",
+        "description": "the modules this project can switch on, the only ones a map may recommend. `available: false` when the list cannot be read here.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/first-read.js",
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetFirstReadCatalogResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/first-read/maps": {
       "post": {
         "operationId": "post_first_read_maps",
@@ -7772,6 +7845,65 @@
         ]
       }
     },
+    "/first-read/maps/{id}/dismiss": {
+      "post": {
+        "operationId": "post_first_read_maps_id_dismiss",
+        "tags": [
+          "first-read"
+        ],
+        "summary": "POST /first-read/maps/:id/dismiss",
+        "description": ".create — the owner's no to named items (a module recommendation, usually). Files nothing; a later \"accept all\" passes them by.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `goal.create` (all required).",
+        "x-rank": "metic+archon",
+        "x-source": "modules/lifecycle/routes/first-read.js",
+        "x-permissions": [
+          "goal.create"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `id`."
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostFirstReadMapsIdDismissRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/first-read/maps/{id}/reject": {
       "post": {
         "operationId": "post_first_read_maps_id_reject",
@@ -7827,7 +7959,7 @@
           "first-read"
         ],
         "summary": "GET /first-read/prompt",
-        "description": "the prompt and the shape are instructions, not project data.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "description": "the prompt and the shape are instructions, not project data. The prompt carries the live module list (task 1005281), so a session recommends from it.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
         "x-rank": "any-builder",
         "x-source": "modules/lifecycle/routes/first-read.js",
         "responses": {
@@ -8465,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",
@@ -29282,6 +29459,45 @@
         "security": []
       }
     },
+    "/sso/app-status": {
+      "post": {
+        "operationId": "post_sso_app_status",
+        "tags": [
+          "sso"
+        ],
+        "summary": "POST /sso/app-status",
+        "description": "authenticated by client_id + client_secret, not a builder rank.\n\n**Rank:** `public` — No authentication — any caller.",
+        "x-rank": "public",
+        "x-source": "modules/platform-identity/routes/sso-app-status.js",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostSsoAppStatusRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostSsoAppStatusResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          }
+        },
+        "security": []
+      }
+    },
     "/sso/applicant-profile": {
       "post": {
         "operationId": "post_sso_applicant_profile",
@@ -34664,6 +34880,17 @@
           "count"
         ]
       },
+      "GetFirstReadCatalogResponse": {
+        "type": "object",
+        "properties": {
+          "available": {},
+          "modules": {}
+        },
+        "required": [
+          "available",
+          "modules"
+        ]
+      },
       "GetFirstReadPromptResponse": {
         "type": "object",
         "properties": {
@@ -34671,14 +34898,16 @@
           "file": {},
           "prompt": {},
           "example": {},
-          "limits": {}
+          "limits": {},
+          "catalog": {}
         },
         "required": [
           "schema",
           "file",
           "prompt",
           "example",
-          "limits"
+          "limits",
+          "catalog"
         ]
       },
       "GetFrontDoorGuideMineResponse": {
@@ -39192,6 +39421,22 @@
         },
         "additionalProperties": false
       },
+      "PostFirstReadMapsIdDismissRequest": {
+        "type": "object",
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 500
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "additionalProperties": false
+      },
       "PostFirstReadMapsRequest": {
         "type": "object",
         "properties": {
@@ -43544,6 +43789,43 @@
           "ok"
         ]
       },
+      "PostSsoAppStatusRequest": {
+        "type": "object",
+        "properties": {
+          "client_id": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "client_secret": {
+            "type": "string",
+            "maxLength": 512
+          }
+        },
+        "required": [
+          "client_id",
+          "client_secret"
+        ],
+        "additionalProperties": false
+      },
+      "PostSsoAppStatusResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "known": {
+            "type": "boolean"
+          },
+          "app": {},
+          "sandbox": {}
+        },
+        "required": [
+          "ok",
+          "known",
+          "app",
+          "sandbox"
+        ]
+      },
       "PostSsoApplicantProfileRequest": {
         "type": "object",
         "properties": {
@@ -45306,9 +45588,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 725,
-  "x-schema-count": 755,
+  "x-endpoint-count": 730,
+  "x-schema-count": 759,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 471,
+  "x-response-schemas": 473,
   "x-generated-by": "scripts/bongos/gen-api-docs.js"
 }