@bongos/core 1.25.19 → 1.25.20

package/docs/project-context.template.md

@@ -4,7 +4,7 @@
 >
 > **Relationship to the rest of the project:**
 > - [`CLAUDE.md`](../CLAUDE.md) is the **portable methodology core** Cloud Bongos ships — working rules, session protocol, claim→ship lifecycle, the [ADR 0061](adr/0061-context-layer-decomposition.md) content charter, the nested-`CLAUDE.md` pattern. Instance-agnostic; you do not author it.
-> - **The founder's own answers come first.** What the project is, who it is for, what success looks like and the bet it makes are asked in the genesis scope interview and stored as answers in Bongos, not here. `node scripts/bongos/genesis.js context` (or `npx bongos genesis context`) prints them. Where this file and those answers disagree, the answers are the founder's latest word ([ADR 0408](adr/0408-a-genesis-stage-is-three-doors-onto-one-record.md), task 1005114).
+> - **The founder's own answers come first.** What the project is, who it is for, what success looks like and the bet it makes are asked in the genesis scope interview and stored as answers in Bongos, not here. `node scripts/bongos/genesis.js context` (or `npx bongos genesis context`) prints them. Where this file and those answers disagree, the answers are the founder's latest word ([ADR 0408](adr/0408-a-genesis-stage-is-three-doors-onto-one-record.md), task 1005114). A founder who planned the project with the start-a-project guide before signing up also has a hand-off file (where the project started, the plan, the recommended modules and the first steps); the same command prints it first (task 1005274).
 > - **This file is the *prose* identity** — lore, vision, the why. The **machine-readable** identity (exact strings code reads: product/world/company names, domains, cookie/OAuth origins, currency label, palette, repo binding) lives in the branding contract [`config/branding.json`](../config/branding.json) ([`docs/branding-contract.md`](branding-contract.md)). **Where a name must be exact for code, the branding contract wins** — never re-hardcode a contract-owned string here.
 
 <!--

package/modules/front-door-guide/handoff.js

@@ -0,0 +1,120 @@
+'use strict';
+
+// modules/front-door-guide/handoff.js — THE GUIDE'S HAND-OFF (task 1005274, goal 1000106):
+// what a founder told the start-a-project guide, carried forward so nothing is asked twice.
+// PURE: a saved Plan in, words out. Nothing here calls an AI; it moves saved answers.
+//
+// Three readers, one source (the Plan the guide saved, plan.js):
+//   * the creation page's pre-fill reads the Plan itself (GET /front-door-guide/mine);
+//   * scopeAnswers(plan) → the Genesis scope interview's carried-over answers;
+//   * handoffMarkdown(plan) → the hand-off file: what the project is, the plan, the
+//     recommended modules and the first steps, written for the founder's own AI.
+//
+// THE SCOPE MAP IS EXPLICIT, and a question the plan does not answer stays EMPTY. The
+// plan's fields are what the guide asked; the scope interview's six questions
+// (modules/onboarding/genesis-work.js QUESTIONS.scope) are the founder's own. Only one
+// field says the same thing as a scope question. Every other question maps to null on
+// purpose: inventing "who it is for" or "the bet" from a chat that never asked would put
+// words in the founder's mouth, which is the one thing genesis exists to prevent.
+
+const SCOPE_MAP = Object.freeze({
+  what_creating: 'summary',     // "what are you creating" ← the guide's summary of what they said
+  goal_impact: null,            // the guide never asks why or for what impact
+  success_two_years: null,      // nor what success looks like
+  reach_who: null,              // the summary may mention who, but not as an answer to this
+  work_with_who: null,          // nor who they want working with them
+  others_wrong: null,           // nor the bet
+});
+
+const ANSWER_MAX = 4000;        // genesis-work.js LIMITS.answer
+const MARKDOWN_MAX = 12000;     // the hand-off rides an env line to the new project; keep it bounded
+const PROJECT_TYPE_WORDS = Object.freeze({
+  game: 'A game', research: 'Research', business: 'A business', 'non-profit': 'A non-profit', 'not-sure': 'Not decided yet',
+});
+
+const str = (v) => (typeof v === 'string' ? v.trim() : '');
+const list = (v) => (Array.isArray(v) ? v : []);
+
+// scopeAnswers(plan) → { question_id: text } for the questions the plan answers, and only
+// those. An empty object for no plan.
+function scopeAnswers(plan) {
+  const out = {};
+  if (!plan || typeof plan !== 'object') return out;
+  for (const [question, field] of Object.entries(SCOPE_MAP)) {
+    if (!field) continue;
+    const words = str(plan[field]).slice(0, ANSWER_MAX);
+    if (words) out[question] = words;
+  }
+  return out;
+}
+
+// handoffMarkdown(plan, { name }) → the hand-off file, or '' for no usable plan. Written
+// so an AI session that reads ONLY this file can say what the project is for and what to
+// do next, and knows these are carried-over words the founder has not yet confirmed.
+function handoffMarkdown(plan, { name = '' } = {}) {
+  if (!plan || typeof plan !== 'object' || !str(plan.summary)) return '';
+  const title = str(name);
+  const lines = [
+    `# ${title ? `${title}: ` : ''}where this project started`,
+    '',
+    'Before signing up, the founder talked with the start-a-project guide. This is what came out of that conversation, carried over so nobody asks them the same things again.',
+    '',
+    'If you are an AI session working on this project: read this first. It is a starting point, not the founder\'s final word. Where the founder has since answered the Genesis questions (`npx bongos genesis context`), their answers win. Confirm anything below with them before relying on it, and never ask them again what is already written here.',
+    '',
+    '## What the project is',
+    '',
+    str(plan.summary),
+    '',
+  ];
+  const type = PROJECT_TYPE_WORDS[plan.project_type];
+  if (type) lines.push(`**Kind of project:** ${type}`, '');
+  if (plan.starting_point === 'existing') {
+    lines.push('**Starting point:** they already have something.', '');
+    const have = list(plan.what_you_have).map(str).filter(Boolean);
+    if (have.length) lines.push('What they said they already have:', '', ...have.map((h) => `- ${h}`), '');
+  } else if (plan.starting_point === 'fresh') {
+    lines.push('**Starting point:** starting fresh.', '');
+  }
+  const how = list(plan.how_it_works).map(str).filter(Boolean);
+  if (how.length) lines.push('## The plan', '', ...how.map((h) => `- ${h}`), '');
+  const modules = list(plan.modules).filter((m) => m && str(m.key));
+  if (modules.length) {
+    lines.push('## Recommended modules', '');
+    for (const m of modules) {
+      const why = str(m.why);
+      lines.push(`- **${str(m.label) || str(m.key)}** (\`${str(m.key)}\`)${str(m.summary) ? `: ${str(m.summary)}` : ''}${why ? ` Why: ${why}` : ''}`);
+    }
+    lines.push('');
+  }
+  const steps = list(plan.steps).filter((s) => s && str(s.title));
+  if (steps.length) {
+    lines.push('## First steps', '');
+    steps.forEach((s, i) => lines.push(`${i + 1}. **${str(s.title)}**${str(s.detail) ? ` ${str(s.detail)}` : ''}`));
+    lines.push('');
+  }
+  const needs = list(plan.needs).filter((n) => n && str(n.item));
+  if (needs.length) {
+    lines.push('## What they will need', '');
+    for (const n of needs) lines.push(`- **${str(n.item)}**${str(n.detail) ? `: ${str(n.detail)}` : ''}`);
+    lines.push('');
+  }
+  const open = list(plan.open_questions).map(str).filter(Boolean);
+  if (open.length) lines.push('## Still open', '', ...open.map((q) => `- ${q}`), '');
+  lines.push('## Your next step', '',
+    steps.length
+      ? `Start with step 1, "${str(steps[0].title)}". Then open the Genesis scope questions with the founder (\`npx bongos genesis show scope\`): only "what are you creating" was carried over, and the rest are theirs to answer.`
+      : 'Open the Genesis scope questions with the founder (`npx bongos genesis show scope`): only "what are you creating" was carried over, and the rest are theirs to answer.',
+    '');
+  const md = lines.join('\n');
+  return md.length > MARKDOWN_MAX ? `${md.slice(0, MARKDOWN_MAX - 40).trimEnd()}\n\n(The rest was cut for length.)\n` : md;
+}
+
+// handoffFor(plan, opts) → { scope, markdown } | null — what the provisioning port hands the
+// create route to stamp on a new project.
+function handoffFor(plan, opts = {}) {
+  const markdown = handoffMarkdown(plan, opts);
+  if (!markdown) return null;
+  return { scope: scopeAnswers(plan), markdown };
+}
+
+module.exports = { SCOPE_MAP, MARKDOWN_MAX, scopeAnswers, handoffMarkdown, handoffFor };

package/modules/front-door-guide/module.json

@@ -25,7 +25,7 @@
       "retention-sweep"
     ]
   },
-  "provides": [],
+  "provides": ["front-door-guide.handoff"],
   "consumes": [],
   "dependencies": { "@anthropic-ai/sdk": "^0.131.0" }
 }

package/modules/front-door-guide/routes/front-door-guide-plan.js

@@ -5,6 +5,7 @@
 //   POST /front-door-guide/conversations/:id/plan    write (or re-read) the plan   { token, website? }
 //   POST /front-door-guide/conversations/:id/attach  put the chat on my account    { token }
 //   GET  /front-door-guide/mine                      my newest chat and its plan
+//   GET  /front-door-guide/mine/handoff.md           my plan as the hand-off file, a download  (?name=)
 //
 // The plan is ONE structured-output call per chat (a JSON schema, never parsed prose),
 // asked once the visitor has said something; a second request re-reads the stored plan
@@ -29,6 +30,7 @@ const claude = require('../claude');
 const { readSettings } = require('../settings');
 const L = require('../limits');
 const C = require('../context');
+const H = require('../handoff');
 
 const log = api.logger('front-door-guide');
 const ID_RE = /^\d{1,18}$/;
@@ -62,8 +64,19 @@ function mineView(conv, settings) {
   };
 }
 
+// The `front-door-guide.handoff` port (task 1005274): the signed-in builder's newest attached
+// plan as { scope, markdown }, or null. The hub's create route stamps it on a new project
+// (modules/provisioning/guide-handoff.js), which is how the guide's answers reach a project
+// whose database this process cannot touch. Read-only.
+async function handoffForBuilder(builderId, { name = '' } = {}) {
+  if (builderId == null) return null;
+  const conv = await db.latestForBuilder(builderId);
+  return conv && conv.plan ? H.handoffFor(conv.plan, { name }) : null;
+}
+
 module.exports = function buildFrontDoorGuidePlanRouter() {
   const router = express.Router();
+  if (!api.hasProvider('front-door-guide.handoff')) api.registerProvider('front-door-guide.handoff', handoffForBuilder);
   let current = readSettings();
   const fresh = (req, res, next) => { current = readSettings(); next(); };
   const planLimit = L.makeLimiter({ windowMs: 60_000, max: () => current.messagesPerMinute, scope: 'front-door-guide-plan' });
@@ -141,5 +154,16 @@ module.exports = function buildFrontDoorGuidePlanRouter() {
     res.json({ ok: true, conversation: conv ? mineView(conv, current) : null });
   }));
 
+  // rank: builder — my plan as the hand-off file (task 1005274), offered as a download on the
+  // creation page. 404 with no plan. The name is only the file's title; it is never stored.
+  router.get('/front-door-guide/mine/handoff.md', api.requireBuilder, api.asyncHandler('GET /front-door-guide/mine/handoff.md', async (req, res) => {
+    const name = typeof req.query.name === 'string' ? req.query.name.replace(/[\r\n#]/g, ' ').trim().slice(0, 80) : '';
+    const h = await handoffForBuilder(req.builder.id, { name });
+    if (!h) return res.status(404).json({ ok: false, error: 'no_plan' });
+    res.set('Cache-Control', 'no-store');
+    res.set('Content-Disposition', 'attachment; filename="PROJECT-HANDOFF.md"');
+    res.type('text/markdown; charset=utf-8').send(h.markdown);
+  }));
+
   return router;
 };

package/modules/hall-ui/public/ai-studio.html

@@ -92,7 +92,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/tweak-editor-lib.js?v=2026-09-28-tw23"></script>

package/modules/hall-ui/public/atlas.html

@@ -93,7 +93,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/blockers.html

@@ -62,7 +62,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/board-room.html

@@ -64,7 +64,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/city.html

@@ -116,7 +116,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2" defer></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers" defer></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor" defer></script>
-<script src="/builders/shell.js?v=2026-11-11-view2" defer></script>
+<script src="/builders/shell.js?v=2026-11-13-founding" defer></script>
 <script src="/builders/hall-dialog.js" defer></script>
 <!-- task 1005148: the visor (glass over the scene, game mode only; ADR 0399), after the shell and hall-dialog.js -->
 <script src="/builders/visor.js?v=2026-11-11-helm3" defer></script>

package/modules/hall-ui/public/collab.html

@@ -163,7 +163,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/collab-lib.js?v=2026-09-24-archive"></script>

package/modules/hall-ui/public/commands.html

@@ -55,7 +55,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/copy-desk.html

@@ -181,7 +181,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>

package/modules/hall-ui/public/deploy.html

@@ -82,7 +82,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>

package/modules/hall-ui/public/genesis-home.js

@@ -171,9 +171,24 @@
     return s.total ? s.finished + ' of ' + s.total + ' done' : 'in progress';
   }
 
+  // The government district's buildings, by the city's key (city-draw.js CIVIC_SLOTS).
+  var BUILDING = {
+    charter: 'Charter', release: 'Release', planning: 'Planning', automation: 'Automation', treasury: 'Treasury',
+    rules: 'Rules', disputes: 'Disputes', people: 'People', review: 'Review',
+  };
+  function gainsText(s) {
+    var wakes = (s.wakes || []).map(function (id) { return ROOM[id] || id; });
+    var raises = (s.raises || []).map(function (k) { return BUILDING[k] || k; });
+    var parts = [];
+    if (wakes.length) parts.push('Wakes ' + wakes.join(', '));
+    if (raises.length) parts.push('raises ' + raises.join(', '));
+    if (!wakes.length && s.earns) parts.push(s.earns.charAt(0).toLowerCase() + s.earns.slice(1));
+    var line = parts.join(' · ');
+    return line ? line.charAt(0).toUpperCase() + line.slice(1) : '';
+  }
+
   function stagesHtml(g) {
     return '<ol class="genesis__stages">' + g.stages.map(function (s) {
-      var wakes = (s.wakes || []).map(function (id) { return ROOM[id] || id; });
       // A demo's stage is minutes long (task 1004506): say how long, and due at a time.
       var due = s.minutes
         ? ' · ' + s.minutes + ' min' + (s.state === 'now' && s.due ? ', due ' + new Date(s.due).toLocaleTimeString(undefined, { hour: 'numeric', minute: '2-digit' }) : '')
@@ -181,7 +196,9 @@
       return '<li class="genesis__stage is-' + s.state + '">'
         + '<span class="genesis__stage-n">0' + s.number + '</span>'
         + '<span class="genesis__stage-t"><b>' + esc(s.label) + '</b>'
-        + '<span>' + esc(wakes.length ? 'Wakes ' + wakes.join(', ') : '') + esc(due) + '</span>'
+        // task 1005112: what finishing the stage gives — the rooms it wakes, the district
+        // buildings it raises, and for a stage that wakes no room, what it earns.
+        + '<span>' + esc(gainsText(s)) + esc(due) + '</span>'
         + (s.state === 'later' && s.can_close ? '<span><button type="button" class="btn-ghost" data-genesis-close="' + esc(s.key) + '">Put to the board</button></span>' : '')
         + '</span>'
         + '<span class="genesis__stage-st">' + esc(stateText(s)) + '</span></li>';
@@ -221,13 +238,15 @@
     var state = t.state === 'done' || t.state === 'locked' ? t.state : 'open';
     var check = window.OTB.CHECK_SVG || '';
     var mark = '<span class="genesis__mark" aria-hidden="true">' + (state === 'done' ? check : '') + '</span>';
-    var said = { done: 'Done', open: 'To do', locked: 'Locked' }[state];
+    // Only the states the status pill does not already say: an open row's pill names its
+    // own status, and a second word beside it could disagree with it.
+    var said = { done: 'Done: ', locked: 'Locked: ' }[state] || '';
     var after = (t.waits_on || []).map(function (w) { return w.title; }).filter(Boolean);
     var tail = state === 'locked'
       ? '<span class="genesis__task-wait">' + esc(after.length ? 'after ' + after.join(', ') : 'after an earlier task') + '</span>'
       : window.OTB.statusPill(t.status, { small: true, extraClass: 'genesis__task-st' }) + copyButtonHtml(t);
     return '<li class="genesis__task is-' + state + '">' + mark
-      + '<span class="sr-only">' + said + ': </span>'
+      + (said ? '<span class="sr-only">' + said + '</span>' : '')
       + '<a class="genesis__task-t" href="/task/' + encodeURIComponent(t.id) + '">' + esc(t.title) + '</a>'
       + tail + '</li>';
   }

package/modules/hall-ui/public/goal-map.html

@@ -142,7 +142,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- task 1005148: the visor (glass over the scene, game mode only; ADR 0399), after the shell and hall-dialog.js -->
 <script src="/builders/visor.js?v=2026-11-11-helm3"></script>

package/modules/hall-ui/public/goals.html

@@ -254,7 +254,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/government.html

@@ -158,7 +158,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/home-city-draw.js

@@ -172,6 +172,8 @@
     return {
       weeks, W, areas, unplaced: all.length - areas.length,
       px: TOWER_PX / tallest, people, sites, waiting, ideas, version,
+      // task 1005112: while founding, the district buildings not raised yet (server-decided)
+      unbuilt: d.founding && d.founding.unbuilt && typeof d.founding.unbuilt === 'object' ? Object.assign({}, d.founding.unbuilt) : null,
       width: GROUND.w, depth: GROUND.d,
     };
   }
@@ -362,12 +364,23 @@
       const CI = Gov.isoTheme();
       const k = Gov.isoKit(TW, TH, vb.OX, vb.OY, CIVIC_S, CI, true);
       const kids = [face([P(CORE.x0, CORE.y0), P(CORE.x1, CORE.y0), P(CORE.x1, CORE.y1), P(CORE.x0, CORE.y1)], I.plaza, I.plazaLine)];
+      const unbuilt = m.unbuilt || {};
+      let raised = 0;
       Gov.CIVIC_SLOTS.slice().sort((p, q) => (p[1] + p[2]) - (q[1] + q[2])).forEach((sl) => {
+        // task 1005112: a building whose genesis stage is still ahead is a marked-out
+        // foundation on the plaza, and rises when that stage is done.
+        if (unbuilt[sl[0]]) {
+          const x0 = sl[1] - 0.55, y0 = sl[2] - 0.55, w = 1.1;
+          kids.push(node('path', { d: pts([P(x0, y0), P(x0 + w, y0), P(x0 + w, y0 + w), P(x0, y0 + w)]), fill: 'none', stroke: I.plazaLine, 'stroke-width': 1, 'stroke-dasharray': '3 3', class: 'hc-face hc-foundation', 'data-building': sl[0] }));
+          return;
+        }
+        raised += 1;
         const list = [];
         Gov.isoInstitution(list, k, sl[0], sl[1] - 0.6, sl[2] - 0.6, {});
         list.forEach((pa) => kids.push(node('path', { d: pa.d, fill: pa.f, stroke: pa.s, 'stroke-width': pa.w, 'stroke-dasharray': pa.dash, 'stroke-linejoin': 'round', class: 'hc-face' })));
       });
-      return node('a', { href: Gov.STREET_HREF || '/street', class: 'hc-door hc-core' + quiet('core'), 'aria-label': 'The government district: nine buildings, one for each part of the government. Walk the street.', 'data-tip': 'Government', 'data-tip-body': 'The Cloud Bongos core: nine buildings, one for each part of the government. Click to walk the street.' }, kids);
+      const told = raised === Gov.CIVIC_SLOTS.length ? 'nine buildings, one for each part of the government' : raised + ' of nine buildings raised so far; each founding stage raises more';
+      return node('a', { href: Gov.STREET_HREF || '/street', class: 'hc-door hc-core' + quiet('core'), 'aria-label': 'The government district: ' + told + '. Walk the street.', 'data-tip': 'Government', 'data-tip-body': 'The Cloud Bongos core: ' + told + '. Click to walk the street.' }, kids);
     }
 
     // The art museum and its garden, after the Cleveland Museum of Art: a long white

package/modules/hall-ui/public/idea.html

@@ -54,7 +54,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <!-- task-detail.js still owns the #/idea/N and #/blocker/N overlay, so a ref

package/modules/hall-ui/public/ideas.html

@@ -229,7 +229,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <!-- task 1004727: the ONE karma vote control every task/idea list renders -->

package/modules/hall-ui/public/index.html

@@ -106,7 +106,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2" defer></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers" defer></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor" defer></script>
-<script src="/builders/shell.js?v=2026-11-11-view2" defer></script>
+<script src="/builders/shell.js?v=2026-11-13-founding" defer></script>
 <script src="/builders/hall-dialog.js" defer></script>
 <!-- task 1005148: the visor (glass over the scene, game mode only; ADR 0399), after the shell and hall-dialog.js -->
 <script src="/builders/visor.js?v=2026-11-12-runner" defer></script>

package/modules/hall-ui/public/market-watch-item.html

@@ -75,7 +75,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>

package/modules/hall-ui/public/market-watch-rules.html

@@ -44,7 +44,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/market-watch.html

@@ -186,7 +186,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/hall-kit.js"></script>

package/modules/hall-ui/public/modules.html

@@ -129,7 +129,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/money.html

@@ -83,7 +83,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/my-agents.html

@@ -85,7 +85,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/primer.html

@@ -114,7 +114,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/profile.html

@@ -251,7 +251,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/project-settings.html

@@ -78,7 +78,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/roster.html

@@ -60,7 +60,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>

package/modules/hall-ui/public/settings.html

@@ -420,7 +420,7 @@
 <script src="/builders/shell-game.js?v=2026-11-11-view2"></script>
 <script src="/builders/shell-trail.js?v=2026-11-05-numbers"></script>
 <script src="/builders/craft-mode.js?v=2026-11-10-visor"></script>
-<script src="/builders/shell.js?v=2026-11-11-view2"></script>
+<script src="/builders/shell.js?v=2026-11-13-founding"></script>
 <script src="/builders/hall-dialog.js"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>