@bongos/core 1.20.57 → 1.20.59

package/clients/bongos-client/index.cjs

@@ -378,8 +378,18 @@ function createClient(opts = {}) {
       postFeedback: (args) => request("POST", "/feedback", { hasBody: true }, args),
     },
     "founding": {
+      // POST /founding/alive — rank: any-builder — POST /founding/alive
+      postFoundingAlive: (args) => request("POST", "/founding/alive", { hasBody: true }, args),
       // GET /founding/builders — rank: any-builder — GET /founding/builders
       getFoundingBuilders: (args) => request("GET", "/founding/builders", { hasBody: false }, args),
+      // GET /founding/genesis — rank: any-builder — GET /founding/genesis
+      getFoundingGenesis: (args) => request("GET", "/founding/genesis", { hasBody: false }, args),
+      // POST /founding/plan — rank: any-builder — POST /founding/plan
+      postFoundingPlan: (args) => request("POST", "/founding/plan", { hasBody: true }, args),
+      // POST /founding/stages/{stage}/close — rank: any-builder — POST /founding/stages/:stage/close
+      postFoundingStagesStageClose: (args) => request("POST", "/founding/stages/{stage}/close", { hasBody: true }, args),
+      // POST /founding/start — rank: any-builder — POST /founding/start
+      postFoundingStart: (args) => request("POST", "/founding/start", { hasBody: true }, args),
     },
     "gateApprovals": {
       // GET /gate-approvals — rank: metic+archon — GET /gate-approvals

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

@@ -43,7 +43,7 @@ export interface GetBuildersDirectoryResponse { builders: unknown }
 export interface GetBuildersIdActiveClaimsResponse { builder_id: unknown; claims: unknown; stale_hours: unknown; stale_hours_source: unknown }
 export interface GetBuildersIdActivityResponse { builder_id: unknown; section: unknown; role: unknown; rows: unknown; total: unknown }
 export interface GetBuildersIdOnboardingResponse { builder_id: unknown; onboarding: unknown }
-export interface GetBuildersIdProfileResponse { builder: unknown; shipped_count: unknown; recent_ships: unknown; achievements: unknown; cross_project?: unknown; handle?: unknown }
+export interface GetBuildersIdProfileResponse { builder: unknown; shipped_count: unknown; recent_ships: unknown; achievements: unknown; roles: unknown; cross_project?: unknown; handle?: unknown }
 export interface GetBuildersMePendingRankChangeResponse { change: unknown; greeting?: unknown }
 export interface GetBuildersRosterResponse { builders: unknown; stale_hours: unknown; stale_hours_source: unknown }
 export interface GetCliCommandsResponse { version: unknown; groups: unknown }
@@ -61,7 +61,6 @@ 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 GetFoundingBuildersResponse { builders: unknown }
 export interface GetGithubRepoResponse { ok: boolean; repo: unknown; private_deployable: boolean }
 export interface GetGithubReposResponse { repos: unknown }
 export interface GetGoalTaskRelevancePendingResponse { flags: unknown; count: unknown }
@@ -205,7 +204,7 @@ export interface PatchInboxIdRequest { status?: "open" | "promoted" | "discarded
 export interface PatchInboxIdResponse { idea: unknown }
 export interface PatchMeCrossProjectRequest { hide_stats?: boolean; account_visibility?: string; recruiter_discoverable?: boolean }
 export interface PatchMeCrossProjectResponse { hide_stats: boolean; account_visibility: unknown; recruiter_discoverable: unknown; recruiter_discoverable_effective: unknown }
-export interface PatchMeDisciplinesRequest { preferred_disciplines: string[] }
+export interface PatchMeDisciplinesRequest { preferred_disciplines: string[]; main_discipline?: string }
 export interface PatchMeDisciplinesResponse { builder: unknown; onboarding: unknown }
 export interface PatchMeDisplayNameResponse { display_name: unknown; max_length: unknown }
 export interface PatchMeEventSoundPrefsResponse { prefs: unknown; effective: unknown; effective_wav: unknown; events: unknown }
@@ -298,6 +297,7 @@ export interface PostDoneWhenCriterionIdUatRequest { kind: string; recording?: s
 export interface PostDoneWhenCriterionIdUatResponse { ok: boolean; signoff: unknown; criterion_closed: unknown; achieved_goals: unknown; closed_versions: unknown }
 export interface PostDoneWhenCriterionIdUnsatisfyResponse { criterion: unknown }
 export interface PostFeedbackRequest { message: string; kind?: "bug" | "idea"; context?: unknown }
+export interface PostFoundingPlanRequest { days?: Record<string, unknown>; passes?: number; advisors?: string; government?: string; expected_builders?: number; existing?: boolean }
 export interface PostGateApprovalsPrApproveResponse { ok: boolean; pr: unknown; already_clear?: boolean; message: unknown; head_sha?: unknown; status_set?: boolean; recheck?: unknown; held_for_artist?: unknown }
 export interface PostGithubRepoVisibilityRequest { repo: string; visibility: "public" | "private" }
 export interface PostGithubRepoVisibilityResponse { ok: boolean; repo: unknown; private_deployable: boolean }
@@ -818,8 +818,18 @@ export interface BongosClient {
     postFeedback(args: RequestArgs & { body: PostFeedbackRequest }): Promise<ApiResponse>;
   };
   "founding": {
+    /** POST /founding/alive — rank: any-builder */
+    postFoundingAlive(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /founding/builders — rank: any-builder */
-    getFoundingBuilders(args?: RequestArgs): Promise<GetFoundingBuildersResponse>;
+    getFoundingBuilders(args?: RequestArgs): Promise<ApiResponse>;
+    /** GET /founding/genesis — rank: any-builder */
+    getFoundingGenesis(args?: RequestArgs): Promise<ApiResponse>;
+    /** POST /founding/plan — rank: any-builder */
+    postFoundingPlan(args?: RequestArgs & { body?: PostFoundingPlanRequest }): Promise<ApiResponse>;
+    /** POST /founding/stages/{stage}/close — rank: any-builder */
+    postFoundingStagesStageClose(args?: RequestArgs): Promise<ApiResponse>;
+    /** POST /founding/start — rank: any-builder */
+    postFoundingStart(args?: RequestArgs): Promise<ApiResponse>;
   };
   "gateApprovals": {
     /** GET /gate-approvals — rank: metic+archon */

package/clients/bongos-client/index.mjs

@@ -375,8 +375,18 @@ export function createClient(opts = {}) {
       postFeedback: (args) => request("POST", "/feedback", { hasBody: true }, args),
     },
     "founding": {
+      // POST /founding/alive — rank: any-builder — POST /founding/alive
+      postFoundingAlive: (args) => request("POST", "/founding/alive", { hasBody: true }, args),
       // GET /founding/builders — rank: any-builder — GET /founding/builders
       getFoundingBuilders: (args) => request("GET", "/founding/builders", { hasBody: false }, args),
+      // GET /founding/genesis — rank: any-builder — GET /founding/genesis
+      getFoundingGenesis: (args) => request("GET", "/founding/genesis", { hasBody: false }, args),
+      // POST /founding/plan — rank: any-builder — POST /founding/plan
+      postFoundingPlan: (args) => request("POST", "/founding/plan", { hasBody: true }, args),
+      // POST /founding/stages/{stage}/close — rank: any-builder — POST /founding/stages/:stage/close
+      postFoundingStagesStageClose: (args) => request("POST", "/founding/stages/{stage}/close", { hasBody: true }, args),
+      // POST /founding/start — rank: any-builder — POST /founding/start
+      postFoundingStart: (args) => request("POST", "/founding/start", { hasBody: true }, args),
     },
     "gateApprovals": {
       // GET /gate-approvals — rank: metic+archon — GET /gate-approvals

package/docs/api/openapi.json

@@ -2939,7 +2939,7 @@
           "builders"
         ],
         "summary": "GET /builders/:id/profile",
-        "description": "GET /builders/:id/profile — the viewable builder profile page's read (task 1467, goal 25 \"bx-identity\"). Returns ONE builder's public portfolio: identity + rank + economy counters + shipped-work count + recent ships + unlocked achievements. Backs the shareable /builders/profile page. rank: public — every field returned here is ALREADY world-readable: the leaderboard (GET /public/leaderboard, no auth) exposes rank, total_credits, karma, and the top achievement ids; GET /builders/:id/onboarding is likewise an unauthenticated roster-visible read. This route is a per-builder re- presentation of the SAME already-public data, so a portfolio link is shareable without a sign-in wall (that IS the feature). It deliberately WHITELISTS the public column subset off the full builder row — the private columns getBuilderById also returns (anthropic_email / anthropic_user_id / monthly_budget_usd / system_role) are NEVER spread into the JSON. A leak-prevention unit test (tests/profile_route.mjs) asserts their absence + the 404-on-unknown-id behaviour. THROTTLED since task 1002804. The global limiter meters WRITES only (rateLimitMiddleware returns early for GET) and the public read limiter is mounted under /public/*, which this is not — so this route answered at line rate. That was tolerable while it re-presented leaderboard data; it is not now that it also carries `handle`, because an id walk then yields the builder → canonical-profile-handle map in one call per builder. modules/platform-identity/routes/public-profile.js caps /profiles/:handle for exactly that mapping, so the two routes that publish it get the same ceiling. The EXISTING shared /public/* budget (120/60s per IP), not a new one — ADR 0209's rule that routes answering one question spend one budget.\n\n**Rank:** `public` — No authentication — any caller.",
+        "description": "GET /builders/:id/profile — the viewable builder profile page's read (task 1467, goal 25 \"bx-identity\"). Returns ONE builder's public portfolio: identity + rank + economy counters + shipped-work count + recent ships + unlocked achievements. Backs the shareable /builders/profile page. rank: public — every field returned here is ALREADY world-readable: the leaderboard (GET /public/leaderboard, no auth) exposes rank, total_credits, karma, and the top achievement ids; GET /builders/:id/onboarding is likewise an unauthenticated roster-visible read. This route is a per-builder re- presentation of the SAME already-public data, so a portfolio link is shareable without a sign-in wall (that IS the feature). It deliberately WHITELISTS the public column subset off the full builder row — the private columns getBuilderById also returns (anthropic_email / anthropic_user_id / monthly_budget_usd / system_role) are NEVER spread into the JSON. A leak-prevention unit test (tests/profile_route.mjs) asserts their absence + the 404-on-unknown-id behaviour. `roles` (task 1004433) is the one block that is NOT a re-presentation of the leaderboard: per-craft counts and sums. The owner made them public on 2026-09-30 (RP01 decision (a): the tally and By the numbers stay public, the trail, the earnings and every Activity tab need a sign-in), so the block carries counts only — no idea title, no page wording, no task list. THROTTLED since task 1002804. The global limiter meters WRITES only (rateLimitMiddleware returns early for GET) and the public read limiter is mounted under /public/*, which this is not — so this route answered at line rate. That was tolerable while it re-presented leaderboard data; it is not now that it also carries `handle`, because an id walk then yields the builder → canonical-profile-handle map in one call per builder. modules/platform-identity/routes/public-profile.js caps /profiles/:handle for exactly that mapping, so the two routes that publish it get the same ceiling. The EXISTING shared /public/* budget (120/60s per IP), not a new one — ADR 0209's rule that routes answering one question spend one budget.\n\n**Rank:** `public` — No authentication — any caller.",
         "x-rank": "public",
         "x-source": "src/bongos/routes/builders.js",
         "parameters": [
@@ -5774,6 +5774,37 @@
         ]
       }
     },
+    "/founding/alive": {
+      "post": {
+        "operationId": "post_founding_alive",
+        "tags": [
+          "founding"
+        ],
+        "summary": "POST /founding/alive",
+        "description": "**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/onboarding/routes/onboarding.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/founding/builders": {
       "get": {
         "operationId": "get_founding_builders",
@@ -5786,15 +5817,157 @@
         "x-source": "modules/onboarding/routes/onboarding.js",
         "responses": {
           "200": {
-            "description": "Success.",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/GetFoundingBuildersResponse"
-                }
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/founding/genesis": {
+      "get": {
+        "operationId": "get_founding_genesis",
+        "tags": [
+          "founding"
+        ],
+        "summary": "GET /founding/genesis",
+        "description": "**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/onboarding/routes/onboarding.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/founding/plan": {
+      "post": {
+        "operationId": "post_founding_plan",
+        "tags": [
+          "founding"
+        ],
+        "summary": "POST /founding/plan",
+        "description": "The plan's ranges and vocabularies are genesis-home.js parsePlan's (one source); this schema only names the fields so an unknown one is refused.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/onboarding/routes/onboarding.js",
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostFoundingPlanRequest"
               }
             }
           },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/founding/stages/{stage}/close": {
+      "post": {
+        "operationId": "post_founding_stages_stage_close",
+        "tags": [
+          "founding"
+        ],
+        "summary": "POST /founding/stages/:stage/close",
+        "description": "**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/onboarding/routes/onboarding.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/start": {
+      "post": {
+        "operationId": "post_founding_start",
+        "tags": [
+          "founding"
+        ],
+        "summary": "POST /founding/start",
+        "description": "**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/onboarding/routes/onboarding.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
           "400": {
             "$ref": "#/components/responses/BadRequest"
           },
@@ -11388,7 +11561,7 @@
           "me"
         ],
         "summary": "PATCH /me/disciplines",
-        "description": "Self-service edit of the authenticated builder's preferred disciplines (migrations 027 + 086 / V3.R80). Body: { preferred_disciplines: [\"artist\", ...] }. Valid elements are whatever enabledDisciplines() offers — engineer|ideator core plus any enabled module's (artist, ui); [] clears the preference (a multi-element set just means several lanes). No rank gate — a builder owns their own profile. 422 invalid_discipline if any element is out of range. rank: any-builder — self-service profile edit; documented \"no rank gate\" in the handler comment above (a builder owns their own preference).\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "description": "Self-service edit of the authenticated builder's preferred disciplines (migrations 027 + 086 / V3.R80). Body: { preferred_disciplines: [\"artist\", ...] }. Valid elements are whatever enabledDisciplines() offers — engineer|ideator core plus any enabled module's (artist, ui); [] clears the preference (a multi-element set just means several lanes). No rank gate — a builder owns their own profile. 422 invalid_discipline if any element is out of range. rank: any-builder — self-service profile edit; documented \"no rank gate\" in the handler comment above (a builder owns their own preference). `main_discipline` (optional, task 1004433): the builder's own MAIN role, one of the crafts in the same body; null clears it, absent keeps it (see db.updateBuilderDisciplines). 422 invalid_main_discipline otherwise.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
         "x-rank": "any-builder",
         "x-source": "src/bongos/routes/me.js",
         "requestBody": {
@@ -22671,6 +22844,7 @@
           "shipped_count": {},
           "recent_ships": {},
           "achievements": {},
+          "roles": {},
           "cross_project": {},
           "handle": {}
         },
@@ -22678,7 +22852,8 @@
           "builder",
           "shipped_count",
           "recent_ships",
-          "achievements"
+          "achievements",
+          "roles"
         ]
       },
       "GetBuildersMePendingRankChangeResponse": {
@@ -22919,15 +23094,6 @@
           "count"
         ]
       },
-      "GetFoundingBuildersResponse": {
-        "type": "object",
-        "properties": {
-          "builders": {}
-        },
-        "required": [
-          "builders"
-        ]
-      },
       "GetGithubRepoResponse": {
         "type": "object",
         "properties": {
@@ -24808,6 +24974,10 @@
               "type": "string"
             },
             "maxItems": 16
+          },
+          "main_discipline": {
+            "type": "string",
+            "maxLength": 32
           }
         },
         "required": [
@@ -26371,6 +26541,36 @@
         ],
         "additionalProperties": false
       },
+      "PostFoundingPlanRequest": {
+        "type": "object",
+        "properties": {
+          "days": {
+            "type": "object"
+          },
+          "passes": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 2
+          },
+          "advisors": {
+            "type": "string",
+            "maxLength": 16
+          },
+          "government": {
+            "type": "string",
+            "maxLength": 40
+          },
+          "expected_builders": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100000
+          },
+          "existing": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      },
       "PostGateApprovalsPrApproveResponse": {
         "type": "object",
         "properties": {
@@ -30276,9 +30476,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 473,
+  "x-endpoint-count": 478,
   "x-schema-count": 506,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 341,
+  "x-response-schemas": 340,
   "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. 473 endpoints across 86 route files.
+> **Generated from the live route files** — the route file is authoritative. 478 endpoints across 86 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`.
@@ -262,11 +262,16 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 |---|---|---|---|---|
 | POST | `/api/bongos/feedback` | `any-builder` | `message`, `kind`, `context` | signed-in builder — reporting a problem with Bongos grants nothing here, and the hub files every report at 'backlog' behind a Metic+ nod. |
 
-## `founding` (1)
+## `founding` (6)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
+| POST | `/api/bongos/founding/alive` | `any-builder` | — |  |
 | GET | `/api/bongos/founding/builders` | `any-builder` | — | The founding mark (task 1004424): who joined while the project was founding, in join order, with the stage each joined at. |
+| GET | `/api/bongos/founding/genesis` | `any-builder` | — |  |
+| POST | `/api/bongos/founding/plan` | `any-builder` | `days`, `passes`, `advisors`, `government`, `expected_builders`, `existing` | The plan's ranges and vocabularies are genesis-home.js parsePlan's (one source); this schema only names the fields so an unknown one is r… |
+| POST | `/api/bongos/founding/stages/:stage/close` | `any-builder` | — |  |
+| POST | `/api/bongos/founding/start` | `any-builder` | — |  |
 
 ## `gate-approvals` (2)
 
@@ -466,7 +471,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/me/credits` | `any-builder` | — | GET /me/credits — the caller's own ledger. |
 | GET | `/api/bongos/me/cross-project` | `any-builder` | — | the caller's OWN cross-project record + privacy flags (own data). |
 | PATCH | `/api/bongos/me/cross-project` | `any-builder` | `hide_stats`, `account_visibility`, `recruiter_discoverable` | flip the caller's OWN privacy flags (C2's self-serve opt-out plus the task-1002966 pair; own data, keyed on the authenticated github_id —… |
-| PATCH | `/api/bongos/me/disciplines` | `any-builder` | `preferred_disciplines` | Self-service edit of the authenticated builder's preferred disciplines (migrations 027 + 086 / V3.R80). |
+| PATCH | `/api/bongos/me/disciplines` | `any-builder` | `preferred_disciplines`, `main_discipline` | Self-service edit of the authenticated builder's preferred disciplines (migrations 027 + 086 / V3.R80). |
 | GET | `/api/bongos/me/display-name` | `any-builder` | — | Per-builder DISPLAY NAME (task 1669). |
 | PATCH | `/api/bongos/me/display-name` | `any-builder` | _undocumented_ | PATCH the display name. |
 | GET | `/api/bongos/me/event-sound-prefs` | `any-builder` | — | Per-builder per-event sound variant selection (task 582, migration 164). |

package/docs/architecture.md

@@ -101,6 +101,7 @@ builders(id, github_id UNIQUE, github_login, display_name, avatar_url, total_cre
        (system: can't claim/earn/log-in). The cross-builder memory WRITE gate keys on this
        EXACT value, not on rank (ADR 0026 §6C) — an Archon token is rejected.
   + skill_model_prefs jsonb (mig 037), preferred_disciplines text[] (mig 027), timezone (PMS-V2),
+    main_discipline text NULL (core_268 — the builder chosen MAIN role; NULL = not chosen, inferred from credits),
     deactivated_at/reactivated_at/deactivated_reason (mig 025 — the /builder-exit flow; #307 guard)
 tasks ... + xenos_claimable boolean NOT NULL DEFAULT false (mig 029) -- Xenos may claim only these
 versions(id PK 'V1'|'PMS-V1'..., name, track, status, scope_doc_path, ...)  -- track is free text (the product|internal CHECK was dropped in mig 112, task 1191); the valid set is instance config (config/branding.json "tracks"), not a DB constraint

package/docs/copy-inventory.md

@@ -4,13 +4,13 @@
 > Deterministic on a given tree — regenerate and commit rather than hand-editing.
 > Machine-readable twin: [`copy-registry.json`](copy-registry.json).
 
-**2292 strings** across 3 surfaces · 1976 distinct pieces of copy · 2292 certain, 0 heuristic · 220 shown in more than one place.
+**2308 strings** across 3 surfaces · 1991 distinct pieces of copy · 2308 certain, 0 heuristic · 221 shown in more than one place.
 
 ## Surfaces
 
 | surface | lives at | files | strings |
 |---|---|---|---|
-| `builders-hall` | `modules/hall-ui/public` | 115 | 1701 |
+| `builders-hall` | `modules/hall-ui/public` | 116 | 1717 |
 | `status-dashboard` | `modules/status-ui/public` | 4 | 100 |
 | `landing` | `modules/public-landing/public` | 6 | 491 |
 
@@ -76,9 +76,9 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `0efa2f18bb6c` | 3x | What it does | modules/hall-ui/public/commands-lib.js:100, modules/hall-ui/public/commands-lib.js:122, modules/hall-ui/public/settings-specialities.js:130 |
 | `ed394c66d49c` | 3x | What the choice changes | modules/public-landing/public/projects.html:995, modules/public-landing/public/projects.html:1072, modules/public-landing/public/projects.html:1084 |
 | `4e25e6872321` | 3x | Your projects | modules/public-landing/public/index.html:691, modules/public-landing/public/projects.html:547, modules/public-landing/public/projects.html:709 |
-| … | | _180 more in the JSON registry_ | |
+| … | | _181 more in the JSON registry_ | |
 
-## `builders-hall` — 1701 strings
+## `builders-hall` — 1717 strings
 
 | id | conf | text | where |
 |---|---|---|---|
@@ -289,6 +289,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `f42cb1edcf1e` | certain | Clone the repository | `modules/hall-ui/public/hall-render.js:809` |
 | `70f6a704d504` | certain | Close it | `modules/hall-ui/public/copy-desk.html:140` |
 | `d12a2fb5730d` | certain | Close this flag | `modules/hall-ui/public/copy-desk.html:116` |
+| `9b9c2abeae90` | certain | Close this stage | `modules/hall-ui/public/genesis-home.js:206` |
 | `3d148e19e03a` | certain | Closed. | `modules/hall-ui/public/copy-desk.js:510` |
 | `2654dc3ded21` | certain | Closing is a judgement too — say what you decided, so the next person does not re-litigate it. | `modules/hall-ui/public/copy-desk.js:495` |
 | `e5548861ad79` | certain | Coach the grader | `modules/hall-ui/public/studio.js:211` |
@@ -299,6 +300,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `fe4a2b04eda5` | certain | Commands — {{worldName}} | `modules/hall-ui/public/commands.html:6` |
 | `cfc287c42263` | certain | Complete your profile | `modules/hall-ui/public/profile-nudge.js:79` |
 | `2867c85d196d` | certain | Confirm that verification for #{…} actually passed? | `modules/hall-ui/public/task.js:872` |
+| `e74f4442c338` | certain | Confirm this stage | `modules/hall-ui/public/genesis-home.js:197` |
 | `9b16a22bf24c` | certain | Connect Discord & join the server | `modules/hall-ui/public/hall-render.js:955` |
 | `9b16a22bf24c` | certain | Connect Discord & join the server | `modules/hall-ui/public/settings.js:683` |
 | `c07898571b24` | certain | Connects to | `modules/hall-ui/public/atlas.js:290` |
@@ -446,6 +448,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `8e82771e5b63` | certain | Ending a session takes effect immediately; the token stops working on its very next request. | `modules/hall-ui/public/settings.html:163` |
 | `58d381535285` | certain | Engagement reports | `modules/hall-ui/public/watch.html:130` |
 | `690609c8e9a9` | certain | Enter a goal number. | `modules/hall-ui/public/gate.js:315` |
+| `4f776bc33d5f` | certain | Enter the builders’ hall | `modules/hall-ui/public/genesis-home.js:219` |
 | `1825c9c467d8` | certain | Enter the id of the task this one should wait for. | `modules/hall-ui/public/task.js:928` |
 | `bd7a40639a1c` | certain | Estimate (min) | `modules/hall-ui/public/task-detail.js:460` |
 | `c15d1f0ddfb6` | certain | Estimation accuracy | `modules/hall-ui/public/watch.html:148` |
@@ -516,6 +519,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `c93912bbad76` | certain | Gathering the reviews and flagged copy that wait for you. | `modules/hall-ui/public/studio.html:160` |
 | `4638e024f0af` | certain | Generated from the code on the last deploy · | `modules/hall-ui/public/atlas.js:431` |
 | `3c1a5d27ef0b` | certain | Generated from the code on the last deploy. | `modules/hall-ui/public/atlas.js:431` |
+| `e79fe220b0fc` | certain | Genesis stages | `modules/hall-ui/public/genesis-home.js:71` |
 | `2ae2114b61db` | certain | Get a free key ↗ | `modules/hall-ui/public/settings.js:800` |
 | `4794a991de3d` | certain | Getting started | `modules/hall-ui/public/hall-widgets.js:59` |
 | `a28b1a567f1a` | certain | GitHub username | `modules/hall-ui/public/hall-render.js:297` |
@@ -556,6 +560,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `68382894d8f9` | certain | How a planning session seeds each version's task pool, and how a version closes and archives its scope. | `modules/hall-ui/public/diagrams.html:85` |
 | `0bab9286ea38` | certain | How each builder's shipped work has been graded over the past thirty days. | `modules/hall-ui/public/watch.html:76` |
 | `fb7489e8b67c` | certain | How it has changed | `modules/hall-ui/public/government.js:971` |
+| `1afadcefd6ea` | certain | How many passes | `modules/hall-ui/public/genesis-home.js:105` |
 | `d76a5fcbde7c` | certain | How much the claim and ship cards show. Richer cards explain more and cost more tokens; the confirmation line  | `modules/hall-ui/public/settings-render.js:84` |
 | `160adde1e398` | certain | How much your session cards — what | `modules/hall-ui/public/settings.html:298` |
 | `ec3f26ff8137` | certain | How planning sessions feed each version's task pool and how a version closes. | `modules/hall-ui/public/diagrams.html:84` |
@@ -646,6 +651,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `7c9b7a89353b` | certain | Leave goal | `modules/hall-ui/public/goals-render.js:961` |
 | `6137d2679912` | certain | Leave it off | `modules/hall-ui/public/settings-specialities.js:138` |
 | `f192ff6563f9` | certain | Leave your GitHub username and an Archon will let you in. No coding needed to start — once you're approved, si | `modules/hall-ui/public/hall-render.js:297` |
+| `e14ebcf3eec5` | certain | Legislation has passed. Genesis is complete. | `modules/hall-ui/public/genesis-home.js:188` |
 | `d6a78b9e5368` | certain | Let it be for now | `modules/hall-ui/public/studio.js:233` |
 | `d6a78b9e5368` | certain | Let it be for now | `modules/hall-ui/public/studio.js:248` |
 | `b8ba1fa4457c` | certain | Link a task | `modules/hall-ui/public/blockers.js:148` |
@@ -756,6 +762,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `084748fd85b4` | certain | No shipped work is recorded between core {…} and {…}. | `modules/hall-ui/public/deploy.js:541` |
 | `4485497d87bb` | certain | No specialities yet. Create one below — it takes a name and a craft, and you can train it afterwards. | `modules/hall-ui/public/settings-specialities.js:416` |
 | `545dc44ad427` | certain | No task in this goal depends on another task in this goal. | `modules/hall-ui/public/goal-forest-render.js:126` |
+| `da838f6056b1` | certain | No tasks for this stage yet. | `modules/hall-ui/public/genesis-home.js:178` |
 | `712b64d8273f` | certain | No tasks match these filters. Try widening them. | `modules/hall-ui/public/work.js:427` |
 | `2302ee46744e` | certain | No terminal commands found. | `modules/hall-ui/public/commands.js:46` |
 | `78f78d1d1e1f` | certain | No version is in flight right now. | `modules/hall-ui/public/roadmap.js:409` |
@@ -829,6 +836,8 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `855277dff074` | certain | Open task #{…} | `modules/hall-ui/public/work.js:835` |
 | `99c630009152` | certain | Open tasks whose declared files overlap — sequence these before two builders collide. | `modules/hall-ui/public/goals.html:117` |
 | `99c630009152` | certain | Open tasks whose declared files overlap — sequence these before two builders collide. | `modules/hall-ui/public/goals.html:197` |
+| `fe9986a9d821` | certain | Open the Board Room | `modules/hall-ui/public/genesis-home.js:198` |
+| `fe9986a9d821` | certain | Open the Board Room | `modules/hall-ui/public/genesis-home.js:203` |
 | `e073aa0c3847` | certain | Open the conflicts for {…} | `modules/hall-ui/public/goal-inbox.js:112` |
 | `676361254d92` | certain | Open the idea composer | `modules/hall-ui/public/idea.js:504` |
 | `29e1cb2d32fc` | certain | Open the recording | `modules/hall-ui/public/criterion-uat-ui.js:121` |
@@ -895,6 +904,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `abee9a18325d` | certain | Propose wording… | `modules/hall-ui/public/copy-desk.js:179` |
 | `3f85bdc47099` | certain | Protected module scope — join by request; an Archon admits members | `modules/hall-ui/public/goals-render.js:877` |
 | `e5c292c8b361` | certain | Provides (seams) | `modules/hall-ui/public/atlas.js:288` |
+| `93b836382ec7` | certain | Put it to the board again | `modules/hall-ui/public/genesis-home.js:202` |
 | `4de232a05888` | certain | Raise after | `modules/hall-ui/public/project-settings.js:113` |
 | `0608f71f78fe` | certain | Rank is earned by shipping work. The founding mark is for good: it is numbered in the order people joined whil | `modules/hall-ui/public/ranks.html:47` |
 | `b9c6def6b120` | certain | Rank set to {…}. | `modules/hall-ui/public/watch.js:883` |
@@ -1073,6 +1083,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `9d4372b173cf` | certain | Standing sections | `modules/hall-ui/public/index.html:83` |
 | `ec1c2dae4a90` | certain | Standing there | `modules/hall-ui/public/profile.js:331` |
 | `eaad12cacb9d` | certain | Start over | `modules/hall-ui/public/studio.js:264` |
+| `b01258e8242a` | certain | Starting government | `modules/hall-ui/public/genesis-home.js:131` |
 | `efe530c0e3a7` | certain | Still open | `modules/hall-ui/public/profile.js:511` |
 | `490a3cbb8c1c` | certain | Still working on core {…}. It keeps going without this page — reload to see where it got to. | `modules/hall-ui/public/deploy.js:761` |
 | `9a4ced1afb6c` | certain | Stop waiting on task {…} | `modules/hall-ui/public/task.js:287` |
@@ -1122,6 +1133,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `4462dcaaaa7d` | certain | The artist reads this instead of guessing. A pointer with no judgement costs them a look and tells them nothin | `modules/hall-ui/public/copy-desk.html:103` |
 | `195b295d0bf3` | certain | The atlas regenerates itself on the server every time code ships; it has not been generated on this deploy yet | `modules/hall-ui/public/atlas.html:63` |
 | `f38140e472df` | certain | The board ratified a change that is not in force. | `modules/hall-ui/public/government.js:633` |
+| `ecc7215524c0` | certain | The board sent this stage back. Read why in the Board Room, then put it up again. | `modules/hall-ui/public/genesis-home.js:201` |
 | `e8f011fdaa6b` | certain | The complete architecture: your machine (the worker, the code, and local memory), the server (authority and pr | `modules/hall-ui/public/diagrams.html:76` |
 | `2dc061096c48` | certain | The copy desk — every flagged string | `modules/hall-ui/public/studio.html:165` |
 | `325daac25a9a` | certain | The day the sky is drawn for | `modules/hall-ui/public/goal-map.html:127` |
@@ -1159,6 +1171,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `74bc22f38140` | certain | The platform confirmed this request came from the account it names. | `modules/hall-ui/public/watch.js:396` |
 | `6c3d88de42de` | certain | The primer | `modules/hall-ui/public/primer.html:41` |
 | `dea378cd4837` | certain | The primer did not load | `modules/hall-ui/public/primer.html:88` |
+| `dc2d6fd0350a` | certain | The project’s life so far | `modules/hall-ui/public/genesis-home.js:145` |
 | `3bc5ec5f35ec` | certain | The ranks, lowest to highest | `modules/hall-ui/public/ranks.html:55` |
 | `c0034db3281c` | certain | The reason is recorded in the audit log. This is recoverable: a retired task can be restored to the backlog wi | `modules/hall-ui/public/task.js:802` |
 | `1ce78006fe00` | certain | The reference did not load | `modules/hall-ui/public/drachmae.html:85` |
@@ -1232,6 +1245,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `9a685b01e2c6` | certain | This page opens at a higher rank. | `modules/hall-ui/public/project-settings.html:36` |
 | `9a685b01e2c6` | certain | This page opens at a higher rank. | `modules/hall-ui/public/watch.html:40` |
 | `e7a289134dc3` | certain | This page shows no words the reader could find. | `modules/hall-ui/public/tweak-editor.js:246` |
+| `5368a0140fa4` | certain | This project already exists, so start by gathering what it has | `modules/hall-ui/public/genesis-home.js:113` |
 | `5bdcbec770dd` | certain | This project has no slash commands yet. | `modules/hall-ui/public/commands.js:38` |
 | `fcd43f045614` | certain | This project is upgraded on the server that runs it: | `modules/hall-ui/public/settings-software-update.js:76` |
 | `3c8aaec39c40` | certain | This project's code expects {…} database change{…} that its database has not applied yet. Anything that relies | `modules/hall-ui/public/deploy.js:579` |
@@ -1275,6 +1289,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `67fbc770b3b3` | certain | Upvote (+1) | `modules/hall-ui/public/builders.js:777` |
 | `16d7f809be8a` | certain | Use the control below to take it. | `modules/hall-ui/public/shell.js:844` |
 | `e7e2a99a2bea` | certain | Use this | `modules/hall-ui/public/settings-specialities.js:395` |
+| `fe0f438b2ff9` | certain | Use this plan | `modules/hall-ui/public/genesis-home.js:115` |
 | `e1ecd543a2ca` | certain | Using this speciality. | `modules/hall-ui/public/settings-specialities.js:454` |
 | `6200bac6bdca` | certain | View all sessions | `modules/hall-ui/public/watch.html:99` |
 | `9b92aa01516d` | certain | View all {…} {…} → | `modules/hall-ui/public/goals-render.js:611` |
@@ -1326,6 +1341,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `b8743d16eab8` | certain | What {…} unlocks | `modules/hall-ui/public/hall-render.js:82` |
 | `6ff24dd04d46` | certain | What\u2019s this? | `modules/hall-ui/public/shell.js:1023` |
 | `ecfd34bf5e6f` | certain | What’s stuck (optional) | `modules/hall-ui/public/blockers.js:308` |
+| `55ef095fe001` | certain | When every task above is finished, this stage can be put to the board. | `modules/hall-ui/public/genesis-home.js:208` |
 | `a6e102816e92` | certain | When to reach for it | `modules/hall-ui/public/commands-lib.js:100` |
 | `a6e102816e92` | certain | When to reach for it | `modules/hall-ui/public/settings-specialities.js:130` |
 | `5d73558dae0e` | certain | Where do you begin? | `modules/hall-ui/public/goal-map.html:110` |
@@ -1723,9 +1739,9 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `d73256fbc395` | certain | {…} · who votes, and how it {…} | `modules/hall-ui/public/board-room.js:449` |
 | `cab2a4296aec` | certain | {…} · {…} · {…}{…} | `modules/hall-ui/public/goal-inbox.js:458` |
 | `1ac723849449` | certain | {…} · {…}{…} | `modules/hall-ui/public/sky-interaction.js:33` |
+| `f9958dc71904` | certain | {…} — everything earned: shipped work, approved pages and ideas. | `modules/hall-ui/public/profile.js:94` |
 | `ddd2bfc1fb60` | certain | {…} — how to use it | `modules/hall-ui/public/modules.js:385` |
 | `085f93f3f775` | certain | {…} — see all standings | `modules/hall-ui/public/hall-render.js:80` |
-| `f75ee96a7511` | certain | {…} — total payout from shipped work. | `modules/hall-ui/public/profile.js:94` |
 | `2a2728a4ec4f` | certain | {…}% of tasks complete | `modules/hall-ui/public/roadmap.js:63` |
 | `15e545eb3ce2` | certain | {…}, no such task | `modules/hall-ui/public/task.js:1015` |
 | `8944d0dcf563` | certain | {…}, on the {…} page, is where you left it. | `modules/hall-ui/public/studio.js:658` |