@bongos/core 1.20.57 → 1.20.58

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

@@ -0,0 +1,349 @@
+// genesis-home.js — THE GENESIS HOME on the hall's Home view (task 1004423 / BV2.PS08).
+//
+// A founding project's Home leads with where genesis is: deciding the plan, then the
+// five stages (scope, strategize, charter, legalize, legislation) worked as real tasks
+// and closed through the Board Room, then the moment the project comes alive. The
+// design of record is docs/design/mocks/project-startup/GenesisDecide, GenesisHall and
+// Alive.dc.html; the server is modules/onboarding/genesis-home.js.
+//
+// THE BLEND RULE. Genesis is a mode the existing hall wears, so this is one more card
+// in the Home banner, built from the hall's own parts (.scroll, .ledger, .btn-accent,
+// the rank-badge pill grammar). It renders ONLY while html[data-founding="on"], which
+// the shell stamps from /me before any widget mounts, and it never fetches otherwise:
+// a hall that is not founding renders, and requests, exactly what it did before.
+//
+// The AI genesis guide in the canvas is out of scope (the task says so); each stage
+// shows its plain done-when line in its place.
+(function () {
+  'use strict';
+  if (!window.OTB || typeof window.OTB.contributeHallWidget !== 'function') return;
+  var API = '/api/bongos';
+  var esc = function (s) { return window.OTB.escapeHtml(s); };
+  var toast = function (m) { if (window.OTB.toast) window.OTB.toast(m); };
+
+  var ROOM = {
+    roadmap: 'Roadmap', goals: 'Goals', 'goal-map': 'Goal map', work: 'Tasks',
+    'board-room': 'Board Room', economy: 'Economy', ranks: 'Ranks',
+  };
+  var DAY_CHOICES = [1, 2, 3, 4, 5, 7, 10, 14, 21, 30];
+  var REFUSED = {
+    stage_tasks_unfinished: 'This stage still has unfinished tasks.',
+    not_current_stage: 'That stage is not the one in progress.',
+    legislation_not_passed: 'Legislation has to pass the Board Room first.',
+    not_deciding: 'The plan is already settled.',
+  };
+
+  function projectName() {
+    var b = window.__BRANDING__ || {};
+    return (b.identity && b.identity.productName) || 'the project';
+  }
+  function api() {
+    return window.BongosClient
+      ? window.BongosClient.createClient({ baseUrl: '', credentials: 'same-origin', throwOnError: false })
+      : null;
+  }
+  function send(method, path, body) {
+    var c = api();
+    if (!c) return Promise.reject(new Error('no client'));
+    return c.request(method, API + path, body ? { body: body } : undefined).then(function (res) {
+      if (res.ok) return res.data;
+      var e = new Error(path + ' → ' + res.status);
+      e.status = res.status;
+      e.code = res.data && res.data.error && res.data.error.code;
+      throw e;
+    });
+  }
+  function refusal(err) {
+    if (err && err.status === 403) return 'Only the project owner can do that.';
+    return (err && REFUSED[err.code]) || 'That did not go through. Try again in a moment.';
+  }
+
+  // The world pair: the black-ground JPEG in dark, the cutout in light (style.css picks).
+  function plateHtml(slug, cls) {
+    return '<span class="gplate ' + (cls || '') + '" aria-hidden="true">'
+      + '<img class="gplate__dark" src="/builders/genesis/' + esc(slug) + '.jpg" alt="" loading="lazy">'
+      + '<img class="gplate__light" src="/builders/genesis/' + esc(slug) + '-cut.webp" alt="" loading="lazy">'
+      + '</span>';
+  }
+
+  function stepperHtml(g) {
+    var names = ['decide'].concat(g.stages.map(function (s) { return s.key; }));
+    return '<ol class="genesis__steps" aria-label="Genesis stages">' + names.map(function (k, i) {
+      var cls = i < g.stage_number ? 'is-done' : i === g.stage_number ? 'is-now' : '';
+      return '<li class="genesis__step ' + cls + '"' + (i === g.stage_number ? ' aria-current="step"' : '') + '>'
+        + '<span class="genesis__step-n">' + i + '</span>' + esc(k) + '</li>';
+    }).join('') + '</ol>';
+  }
+
+  function headHtml(g) {
+    var now = g.stages.find(function (s) { return s.state === 'now'; });
+    var sub = g.deciding
+      ? 'Deciding the plan' + (g.day ? ' · day ' + g.day : '')
+      : 'Stage ' + g.stage_number + ' of ' + g.stage_count + ' · ' + (now ? now.label.toLowerCase() : g.stage) + (g.day ? ' · day ' + g.day : '');
+    return '<div class="genesis__head"><h2 id="genesis-h" class="scroll__h">Genesis</h2>'
+      + '<p class="genesis__sub">' + esc(sub) + '</p></div>' + stepperHtml(g);
+  }
+
+  // ── decide ────────────────────────────────────────────────────────────────
+
+  function decideHtml(g, gov) {
+    var rows = g.stages.map(function (s) {
+      var opts = DAY_CHOICES.map(function (d) {
+        return '<option value="' + d + '"' + (d === s.days ? ' selected' : '') + '>' + d + (d === 1 ? ' day' : ' days') + '</option>';
+      }).join('');
+      return '<li class="genesis__plan-row">'
+        + '<span class="genesis__plan-n">' + s.number + '</span>'
+        + '<span class="genesis__plan-t"><b>' + esc(s.label) + '</b><span>' + esc(s.done_when) + '</span></span>'
+        + '<label class="genesis__plan-len"><span class="sr-only">Length of ' + esc(s.label) + '</span>'
+        + '<select data-days="' + esc(s.key) + '">' + opts + '</select></label></li>';
+    }).join('');
+    return '<p class="scroll__lede">Settle the plan, then genesis files each stage as real tasks on the board. '
+      + 'Every choice below is already set to its recommended default, so on your own one click is enough.</p>'
+      + '<ol class="genesis__plan">' + rows + '</ol>'
+      + '<div class="genesis__picks">'
+      + governmentHtml(gov)
+      + '<fieldset class="genesis__pick"><legend>How many passes</legend>'
+      + radio('passes', '1', 'One', 'Each stage is decided once.', true)
+      + radio('passes', '2', 'Two', 'Once now, and again when your next builders join.', false)
+      + '</fieldset>'
+      + '<fieldset class="genesis__pick"><legend>Advisors</legend>'
+      + radio('advisors', 'none', 'None for now', 'You can add advisors at any stage.', true)
+      + radio('advisors', 'cbaas', 'CBaaS advisors', 'Ask for Cloud Bongos consultants to review each stage.', false)
+      + '</fieldset>'
+      + '<label class="genesis__check"><input type="checkbox" data-existing> This project already exists, so start by gathering what it has</label>'
+      + '</div>'
+      + '<div class="genesis__doors"><button type="button" class="btn-accent" data-genesis-plan>Use this plan</button></div>';
+  }
+
+  function radio(name, value, label, hint, checked) {
+    return '<label class="genesis__radio"><input type="radio" name="genesis-' + name + '" value="' + esc(value) + '"'
+      + (checked ? ' checked' : '') + '><span><b>' + esc(label) + '</b><span>' + esc(hint) + '</span></span></label>';
+  }
+
+  // The starting government: the real academic names, each with its plain sentence
+  // (spec D10), the recommended one picked. Read from the government module's own
+  // constitution view so the names and explanations are never typed twice.
+  function governmentHtml(gov) {
+    if (!gov || !gov.forms || !gov.forms.length) return '';
+    var rec = gov.recommended && gov.recommended.key;
+    var avail = gov.forms.filter(function (f) { return f.available; });
+    var later = gov.forms.filter(function (f) { return !f.available; });
+    return '<fieldset class="genesis__pick genesis__pick--gov"><legend>Starting government</legend>'
+      + '<label class="genesis__expected">Builders you expect in the first year '
+      + '<input type="number" min="1" max="100000" value="' + esc(String(gov.headcount || 1)) + '" data-expected></label>'
+      + avail.map(function (f) {
+        var hint = f.explanation + (f.key === rec && gov.recommended.why ? ' Recommended: ' + gov.recommended.why : '');
+        return radio('gov', f.key, f.name + (f.key === rec ? ' · recommended' : ''), hint, f.key === rec);
+      }).join('')
+      + (later.length ? '<p class="genesis__later">Coming later: ' + later.map(function (f) { return esc(f.name); }).join(', ') + '.</p>' : '')
+      + '</fieldset>';
+  }
+
+  // ── the stages ────────────────────────────────────────────────────────────
+
+  function lifeHtml(g) {
+    return '<ol class="genesis__life" aria-label="The project’s life so far">' + g.stages.map(function (s) {
+      return '<li class="genesis__life-item is-' + s.state + '">' + plateHtml(s.plate)
+        + '<span class="genesis__life-cap">' + esc(s.key) + '<b>' + esc(s.life) + '</b></span></li>';
+    }).join('') + '</ol>';
+  }
+
+  function stateText(s) {
+    if (s.state === 'done') return 'done';
+    if (s.state === 'later') return 'later';
+    return s.total ? s.finished + ' of ' + s.total + ' done' : 'in progress';
+  }
+
+  function stagesHtml(g) {
+    return '<ol class="genesis__stages">' + g.stages.map(function (s) {
+      var wakes = (s.wakes || []).map(function (id) { return ROOM[id] || id; });
+      var due = s.state === 'now' && s.due ? ' · due ' + new Date(s.due).toLocaleDateString(undefined, { month: 'short', day: 'numeric' }) : '';
+      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></span>'
+        + '<span class="genesis__stage-st">' + esc(stateText(s)) + '</span></li>';
+    }).join('') + '</ol>';
+  }
+
+  function nowHtml(g, viewerId) {
+    var s = g.stages.find(function (x) { return x.state === 'now'; });
+    if (!s) return '';
+    var tasks = s.tasks.length
+      ? '<ul class="genesis__tasks">' + s.tasks.map(function (t) {
+        return '<li class="genesis__task' + (t.finished ? ' is-finished' : '') + '">'
+          + '<a class="genesis__task-t" href="/task/' + encodeURIComponent(t.id) + '">' + esc(t.title) + '</a>'
+          + '<span class="genesis__task-st">' + esc(t.status) + '</span></li>';
+      }).join('') + '</ul>'
+      : '<p class="genesis__note">No tasks for this stage yet.</p>';
+    return '<section class="genesis__now" aria-labelledby="genesis-now-h">'
+      + '<h3 id="genesis-now-h" class="genesis__now-h">This stage’s work · ' + esc(s.label) + '</h3>'
+      + '<p class="genesis__note">Done when: ' + esc(s.done_when) + '</p>'
+      + tasks + closeHtml(g, s, viewerId) + '</section>';
+  }
+
+  // Who the close is waiting on, and the one door the viewer has (spec D7).
+  function closeHtml(g, s, viewerId) {
+    if (g.can_come_alive) {
+      return '<div class="genesis__doors"><p class="genesis__note">Legislation has passed. Genesis is complete.</p>'
+        + '<button type="button" class="btn-accent" data-genesis-alive>Bring ' + esc(projectName()) + ' to life</button></div>';
+    }
+    var b = s.board;
+    if (b && b.state === 'sitting') {
+      var names = (b.waiting_on || []).map(function (m) { return m.display_name || m.github_login; }).filter(Boolean);
+      var mine = (b.waiting_on || []).some(function (m) { return String(m.builder_id) === String(viewerId); });
+      return '<div class="genesis__doors"><p class="genesis__note">Put to the Board Room. '
+        + esc(names.length ? 'Waiting on ' + names.join(', ') + '.' : 'Waiting on the board.') + ' ' + esc(b.needs || '') + '</p>'
+        + (mine && b.item_id ? '<button type="button" class="btn-accent" data-genesis-confirm="' + esc(b.item_id) + '">Confirm this stage</button>' : '')
+        + '<a class="btn-ghost" href="/board-room">Open the Board Room</a></div>';
+    }
+    if (b && b.state === 'returned') {
+      return '<div class="genesis__doors"><p class="genesis__note">The board sent this stage back. Read why in the Board Room, then put it up again.</p>'
+        + (g.can_close ? '<button type="button" class="btn-accent" data-genesis-close="' + esc(s.key) + '">Put it to the board again</button>' : '')
+        + '<a class="btn-ghost" href="/board-room">Open the Board Room</a></div>';
+    }
+    if (g.can_close) {
+      return '<div class="genesis__doors"><button type="button" class="btn-accent" data-genesis-close="' + esc(s.key) + '">Close this stage</button></div>';
+    }
+    return '<p class="genesis__note">When every task above is finished, this stage can be put to the board.</p>';
+  }
+
+  function aliveHtml() {
+    var name = projectName();
+    return '<div class="genesis__alive">'
+      + '<div class="genesis__alive-plates">' + ['r5-life-1-primordial-sea', 'r5-life-2-first-cells', 'r5-life-3-genome', 'r5-life-4-membrane', 'r5-life-5-nervous-system']
+        .map(function (p) { return plateHtml(p, 'gplate--sm'); }).join('') + '</div>'
+      + '<h2 id="genesis-h" class="genesis__alive-h">' + esc(name) + ' is alive</h2>'
+      + '<p class="scroll__lede">Genesis is complete. Every room is open now: Community, the Builders list and the rest of the hall. '
+      + 'The founding builders keep their mark for good.</p>'
+      + '<div class="genesis__doors"><button type="button" class="btn-accent" data-genesis-enter>Enter the builders’ hall</button></div></div>';
+  }
+
+  // ── mount ─────────────────────────────────────────────────────────────────
+
+  function founding() {
+    return document.documentElement.getAttribute('data-founding') === 'on';
+  }
+
+  function render(host, state) {
+    var g = state.genesis;
+    if (!g) { host.hidden = true; return; }
+    host.innerHTML = headHtml(g) + (g.deciding
+      ? decideHtml(g, state.gov)
+      : lifeHtml(g) + '<div class="genesis__grid">' + stagesHtml(g) + nowHtml(g, state.viewer) + '</div>');
+    host.hidden = false;
+  }
+
+  function loadGov(expected) {
+    var q = expected ? '?headcount=' + encodeURIComponent(expected) : '';
+    return send('GET', '/government/constitution' + q).then(function (c) {
+      var ch = c && c.charter;
+      return ch ? { forms: ch.forms || [], recommended: c.recommended || null, headcount: expected || c.headcount || 1 } : null;
+    }).catch(function () { return null; });
+  }
+
+  function load(host, state) {
+    return send('GET', '/founding/genesis').then(function (d) {
+      state.genesis = d && d.genesis;
+      state.viewer = d && d.viewer_id;
+      if (state.genesis && state.genesis.deciding && !state.gov) {
+        return loadGov(null).then(function (gov) { state.gov = gov; render(host, state); });
+      }
+      render(host, state);
+      return null;
+    }).catch(function () { host.hidden = true; });
+  }
+
+  function planBody(host) {
+    var days = {};
+    host.querySelectorAll('[data-days]').forEach(function (el) { days[el.getAttribute('data-days')] = Number(el.value); });
+    var pick = function (n) { var el = host.querySelector('input[name="genesis-' + n + '"]:checked'); return el ? el.value : null; };
+    var exp = host.querySelector('[data-expected]');
+    var existing = host.querySelector('[data-existing]');
+    return {
+      days: days,
+      passes: Number(pick('passes') || 1),
+      advisors: pick('advisors') || 'none',
+      government: pick('gov'),
+      expected_builders: exp && exp.value ? Number(exp.value) : null,
+      existing: !!(existing && existing.checked),
+    };
+  }
+
+  function wire(host, state) {
+    var busy = false;
+    function act(p) {
+      if (busy) return;
+      busy = true;
+      p.catch(function (err) { toast(refusal(err)); })
+        .then(function () { busy = false; });
+    }
+    host.addEventListener('change', function (e) {
+      if (!e.target.matches('[data-expected]')) return;
+      var n = Number(e.target.value);
+      if (!(n >= 1)) return;
+      loadGov(n).then(function (gov) {
+        if (!gov) return;
+        var keep = planBody(host);
+        state.gov = gov;
+        render(host, state);
+        Object.keys(keep.days).forEach(function (k) { var el = host.querySelector('[data-days="' + k + '"]'); if (el) el.value = keep.days[k]; });
+      });
+    });
+    host.addEventListener('click', function (e) {
+      var t = e.target.closest('button');
+      if (!t || !host.contains(t)) return;
+      if (t.hasAttribute('data-genesis-plan')) {
+        act(send('POST', '/founding/plan', planBody(host)).then(function () { window.location.reload(); }));
+      } else if (t.hasAttribute('data-genesis-close')) {
+        // The solo fast-track (spec D4): when the founder's one yes decides the sitting
+        // and nobody else is asked, the close and the confirm are one click.
+        act(send('POST', '/founding/stages/' + encodeURIComponent(t.getAttribute('data-genesis-close')) + '/close', {})
+          .then(function () { return send('GET', '/founding/genesis'); })
+          .then(function (d) {
+            var g = d && d.genesis;
+            var s = g && g.stages.find(function (x) { return x.state === 'now'; });
+            var b = s && s.board;
+            var solo = b && b.state === 'sitting' && b.one_vote_decides && b.item_id
+              && (b.waiting_on || []).length === 1 && String(b.waiting_on[0].builder_id) === String(d.viewer_id);
+            return solo ? send('POST', '/government/board/items/' + encodeURIComponent(b.item_id) + '/votes', { direction: 'yes' }) : null;
+          })
+          .then(function () { return load(host, state); }));
+      } else if (t.hasAttribute('data-genesis-confirm')) {
+        act(send('POST', '/government/board/items/' + encodeURIComponent(t.getAttribute('data-genesis-confirm')) + '/votes', { direction: 'yes' })
+          .then(function () { return load(host, state); }));
+      } else if (t.hasAttribute('data-genesis-alive')) {
+        act(send('POST', '/founding/alive', {}).then(function () { host.innerHTML = aliveHtml(); }));
+      } else if (t.hasAttribute('data-genesis-enter')) {
+        window.location.reload();
+      }
+    });
+  }
+
+  window.OTB.contributeHallWidget({
+    // Order -1: ahead of the welcome card (0), because in founding mode the genesis home
+    // IS the landing (the direction doc's Part 2 table). It renders nothing otherwise, so
+    // outside founding the banner's order is exactly today's.
+    id: 'genesis-home', label: 'Genesis', order: -1, core: true,
+    view: 'home', zone: 'home-banner', labelledby: 'genesis-h', hiddenByDefault: true,
+    sectionClass: 'scroll scroll--genesis',
+    // Widgets mount before /me has been applied, so the founding attribute may not be
+    // stamped yet. Wait for it rather than asking the server: a hall that never turns
+    // founding on never makes a request, and the card stays hidden and empty.
+    mount: function (host) {
+      var started = false;
+      function start() {
+        if (started || !founding()) return;
+        started = true;
+        var state = { genesis: null, gov: null, viewer: null };
+        wire(host, state);
+        load(host, state);
+      }
+      start();
+      if (!started && typeof MutationObserver === 'function') {
+        var mo = new MutationObserver(function () { start(); if (started) mo.disconnect(); });
+        mo.observe(document.documentElement, { attributes: true, attributeFilter: ['data-founding'] });
+      }
+    },
+  });
+}());

package/modules/hall-ui/public/index-genesis-decide.states.json

@@ -0,0 +1,13 @@
+{
+  "_": "The genesis home on Home (task 1004423) while the founder decides the plan: each stage's length and done-when line, the starting government by its real name with its plain explanation (the recommended one picked, from government-constitution-sample.json), passes and advisors, every default pre-picked so a solo founder needs one click. /founding/genesis answers founding-genesis-decide.json, built from the real server shaper.",
+  "page": "/builders/",
+  "surface": "hall-ui",
+  "stub": { "prefix": "/builders/", "fixtures": { "me": "me-founding", "founding-genesis": "founding-genesis-decide", "government-constitution": "government-constitution-sample" } },
+  "modeQuery": false,
+  "ignoreRequests": ["/api/(gds|bongos)/me$", "/api/(gds|bongos)/me/", "/api/(gds|bongos)/tasks", "/api/(gds|bongos)/claims", "/api/(gds|bongos)/goals", "/api/(gds|bongos)/inbox", "/api/(gds|bongos)/live", "/api/(gds|bongos)/analytics/", "/api/(gds|bongos)/achievements", "/api/(gds|bongos)/versions", "/api/(gds|bongos)/leaderboard", "/api/(gds|bongos)/removal-proposals", "/api/(gds|bongos)/blockers"],
+  "_ignored": "removal-proposals and blockers are fixtures the kit stub does not carry; index.states.json's home render reports the same two 404s.",
+  "ignoreConsole": ["/api/(gds|bongos)/", "\\b401\\b", "\\b404\\b", "Unauthorized", "Not Found", "load failed"],
+  "states": {
+    "decide": { "auth": true, "actions": [["wait", 800]], "expect": { "visible": ["#genesis-home", "[data-genesis-plan]"] } }
+  }
+}

package/modules/hall-ui/public/index-genesis.states.json

@@ -0,0 +1,13 @@
+{
+  "_": "The genesis home on Home (task 1004423), mid-genesis: scope passed, strategize in progress. /me says founding (kit fixture me-founding.json) and /founding/genesis answers founding-genesis-stage.json, built from the real server shaper. The deciding step is index-genesis-decide.states.json; a hall that is not founding is index.states.json, where the card never renders and never asks. Run it with --states (Home has no last path segment).",
+  "page": "/builders/",
+  "surface": "hall-ui",
+  "stub": { "prefix": "/builders/", "fixtures": { "me": "me-founding", "founding-genesis": "founding-genesis-stage" } },
+  "modeQuery": false,
+  "ignoreRequests": ["/api/(gds|bongos)/me$", "/api/(gds|bongos)/me/", "/api/(gds|bongos)/tasks", "/api/(gds|bongos)/claims", "/api/(gds|bongos)/goals", "/api/(gds|bongos)/inbox", "/api/(gds|bongos)/live", "/api/(gds|bongos)/analytics/", "/api/(gds|bongos)/achievements", "/api/(gds|bongos)/versions", "/api/(gds|bongos)/leaderboard", "/api/(gds|bongos)/removal-proposals", "/api/(gds|bongos)/blockers"],
+  "_ignored": "removal-proposals and blockers are fixtures the kit stub does not carry; index.states.json's home render reports the same two 404s.",
+  "ignoreConsole": ["/api/(gds|bongos)/", "\\b401\\b", "\\b404\\b", "Unauthorized", "Not Found", "load failed"],
+  "states": {
+    "genesis": { "auth": true, "actions": [["wait", 800]], "expect": { "visible": ["#genesis-home", "#founding-band"] } }
+  }
+}

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

@@ -121,6 +121,8 @@
      (serve-internal.js injectModuleHallWidgets). -->
 <script src="/builders/founding-mark.js?v=2026-09-30-founding" defer></script>
 <script src="/builders/hall-widgets.js?v=2026-09-30-founding" defer></script>
+<!-- The genesis home (task 1004423): a Home banner card that renders only in founding mode. -->
+<script src="/builders/genesis-home.js?v=2026-10-01-genesis" defer></script>
 <!-- BV1.R78 (task 1694): the Goals widget registers into the same registry. -->
 <script src="/builders/goals.js?v=2026-07-01-goals" defer></script>
 <!-- task 1003455: the shared blocker-row renderer (window.OTBBlockersLib), read by

package/modules/hall-ui/public/style.css

@@ -733,6 +733,71 @@ main:focus { outline: none; }
 .founding-wall__seed { width: 14px; height: 14px; margin-bottom: 4px; box-shadow: 0 0 0 4px color-mix(in srgb, var(--accent) 18%, transparent); }
 .founding-wall__name { padding: 4px 6px; margin: -4px -6px; font-weight: 500; color: var(--ink); }
 .founding-wall__sub { font-size: 11.5px; letter-spacing: 0.06em; text-transform: uppercase; color: var(--ink-faint); }
+/* task 1004423 (BV2.PS08): THE GENESIS HOME — a Home banner card that exists only in
+   founding mode (genesis-home.js renders nothing otherwise). Built from the hall's
+   parts: the .scroll panel, hairline rows like the ledger, the rank-badge pill
+   grammar for the stepper, the accent for "now". */
+.genesis__head { display: flex; align-items: baseline; justify-content: space-between; gap: 12px; flex-wrap: wrap; }
+.genesis__sub { margin: 0; font-size: 13px; color: var(--ink-soft); }
+.genesis__steps { list-style: none; margin: 12px 0 18px; padding: 0; display: flex; flex-wrap: wrap; gap: 6px; }
+.genesis__step { display: inline-flex; align-items: center; gap: 6px; height: 24px; padding: 0 10px 0 4px; border-radius: 999px;
+  font-size: 11.5px; font-weight: 600; letter-spacing: 0.02em; color: var(--ink-faint); border: 1px solid var(--rule); }
+.genesis__step-n { display: inline-grid; place-items: center; width: 16px; height: 16px; border-radius: 50%; font-size: 10px; background: var(--rule-soft); }
+.genesis__step.is-done { color: var(--ink-soft); }
+.genesis__step.is-now { color: var(--ink); border-color: color-mix(in srgb, var(--accent) 45%, transparent); background: color-mix(in srgb, var(--accent) 10%, transparent); }
+.genesis__step.is-now .genesis__step-n { background: var(--accent); color: var(--bg); }
+.genesis__plan, .genesis__stages, .genesis__tasks, .genesis__life { list-style: none; margin: 0; padding: 0; }
+.genesis__plan-row, .genesis__stage, .genesis__task { display: flex; align-items: center; gap: 12px; padding: 12px 0; border-top: 1px solid var(--rule-soft); }
+.genesis__plan-row:first-child, .genesis__stage:first-child, .genesis__task:first-child { border-top: 0; }
+.genesis__plan-n, .genesis__stage-n { flex: none; width: 24px; font-family: var(--font-mono, monospace); font-size: 12px; color: var(--ink-faint); }
+.genesis__plan-t, .genesis__stage-t { flex: 1; min-width: 0; display: grid; gap: 2px; }
+.genesis__plan-t span, .genesis__stage-t span { font-size: 12.5px; color: var(--ink-soft); }
+.genesis__plan-len select { min-height: 32px; }
+.genesis__picks { display: grid; gap: 14px; margin-top: 16px; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); }
+.genesis__pick { margin: 0; padding: 0; border: 0; display: grid; gap: 6px; }
+.genesis__pick legend { padding: 0; margin-bottom: 4px; font-size: 11.5px; font-weight: 600; letter-spacing: 0.08em; text-transform: uppercase; color: var(--ink-soft); }
+.genesis__pick--gov { grid-column: 1 / -1; }
+.genesis__radio { display: flex; gap: 10px; align-items: flex-start; min-height: 24px; cursor: pointer; }
+.genesis__radio input { margin-top: 3px; flex: none; }
+.genesis__radio > span { display: grid; gap: 1px; }
+.genesis__radio > span span { font-size: 12.5px; color: var(--ink-soft); }
+.genesis__expected { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; font-size: 13px; color: var(--ink-soft); }
+.genesis__expected input { width: 96px; min-height: 32px; }
+.genesis__later, .genesis__note { margin: 6px 0 0; font-size: 12.5px; color: var(--ink-faint); }
+.genesis__check { grid-column: 1 / -1; display: flex; gap: 10px; align-items: center; min-height: 24px; font-size: 13px; }
+.genesis__doors { display: flex; flex-wrap: wrap; align-items: center; gap: 10px; margin-top: 16px; }
+.genesis__doors .genesis__note { flex-basis: 100%; margin: 0; }
+.genesis__life { display: grid; grid-template-columns: repeat(5, minmax(0, 1fr)); gap: 10px; margin-bottom: 18px; }
+.genesis__life-item { display: grid; gap: 6px; text-align: center; }
+.genesis__life-item .gplate { aspect-ratio: 1; border-radius: 12px; background: var(--bg-frame, var(--surface-2)); }
+.genesis__life-item.is-later .gplate { opacity: 0.35; }
+.genesis__life-item.is-now .gplate { box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--accent) 60%, transparent); }
+.genesis__life-cap { display: grid; font-size: 11px; letter-spacing: 0.06em; text-transform: uppercase; color: var(--ink-faint); }
+.genesis__life-cap b { font-weight: 500; text-transform: none; letter-spacing: 0; font-size: 12.5px; color: var(--ink-soft); }
+.gplate { display: grid; place-items: center; overflow: hidden; }
+.gplate img { width: 78%; height: auto; }
+.gplate__dark { display: none; }
+html[data-theme="dark"] .gplate__dark { display: block; }
+html[data-theme="dark"] .gplate__light { display: none; }
+@media (prefers-color-scheme: dark) {
+  html:not([data-theme="light"]) .gplate__dark { display: block; }
+  html:not([data-theme="light"]) .gplate__light { display: none; }
+}
+.gplate--sm { width: 56px; height: 56px; }
+.genesis__grid { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1.2fr); gap: 24px; }
+.genesis__stage-st, .genesis__task-st { flex: none; font-size: 11.5px; letter-spacing: 0.04em; color: var(--ink-faint); }
+.genesis__stage.is-now .genesis__stage-st { color: var(--accent-ink); }
+.genesis__stage.is-later { opacity: 0.6; }
+.genesis__now-h { margin: 0 0 4px; font-size: 15px; font-weight: 500; }
+.genesis__task-t { flex: 1; min-width: 0; padding: 3px 0; }
+.genesis__task.is-finished .genesis__task-t { color: var(--ink-faint); text-decoration: line-through; }
+.genesis__alive { display: grid; justify-items: center; text-align: center; gap: 10px; padding: 12px 0; }
+.genesis__alive-plates { display: flex; flex-wrap: wrap; justify-content: center; gap: 8px; }
+.genesis__alive-h { margin: 6px 0 0; font-size: 28px; font-weight: 400; }
+@media (max-width: 760px) {
+  .genesis__grid { grid-template-columns: minmax(0, 1fr); }
+  .genesis__life { grid-template-columns: repeat(3, minmax(0, 1fr)); }
+}
 .nav-item--asleep { opacity: 0.55; }
 .nav-item__wakes { display: none; margin-left: auto; font-size: 10px; letter-spacing: 0.08em; text-transform: uppercase; color: var(--ink-faint); }
 .app-sidebar:hover .nav-item__wakes,

package/modules/hall-ui/records/genesis-home.md

@@ -0,0 +1,18 @@
+# The genesis home — a Home banner card in founding mode: decide, five stages, alive (task 1004423)
+
+**BV2.PS08 (goal 1000121; spec `docs/specs/<redacted>.md` D4, D7, D10).** The canvas frames are `docs/design/mocks/project-startup/GenesisDecide`, `GenesisHall` and `Alive.dc.html`. The server is `modules/onboarding/genesis-home.js`; the stage tasks are filed by the kickoff seeder (`modules/lifecycle/kickoff-seed.js` `seedGenesisStages`, on the `lifecycle.kickoffSeed` port).
+
+Files: `genesis-home.js` (the card, `id: 'genesis-home'`), its CSS block beside the founding band in `style.css`, and `genesis/` (the five life plates, byte-identical copies of the world pair, because the hall host does not serve the landing's `assets/world/`; `tests/genesis_home.mjs` holds them equal).
+
+## Blended, not a second hall
+
+- **One card in the Home banner**, at order -1 so it leads the page while founding (the direction doc makes the genesis home the founding-mode landing). The banner carries no zone budget. The card renders nothing and makes no request unless `html[data-founding="on"]`, so a hall that is not founding is today's Home byte for byte.
+- **It waits for the shell, it does not ask the server.** Widgets mount before `/me` is applied, so the card watches the `data-founding` attribute (a MutationObserver) and starts the first time the shell stamps it.
+- **The canvas's guide panel is out of scope**: each stage shows its plain done-when line instead. The canvas's founding builders panel is the founding wall (task 1004424), already on Home.
+- **The hall's own parts**: `.scroll`, hairline rows in the ledger rhythm, `.btn-accent` / `.btn-ghost`, a stepper in the rank-badge pill grammar. The plates use the world pair: the black-ground JPEG under the dark theme, the cutout under light.
+
+## What it does
+
+- **Decide**: each stage's length (pre-picked), its done-when line, the starting government by its real name with its plain explanation (the forms and the recommendation are read from `GET /government/constitution`, never retyped), passes, advisors, and a "this project already exists" tick for the brownfield path. **Use this plan** records the plan, files the five stage tasks, and moves to scope. A solo founder needs that one click.
+- **Each stage**: the life strip, the stage list with what each stage wakes and its due date, and the current stage's tasks. **Close this stage** puts it to the Board Room. When the founder's single yes decides it (Monarchy / BDFL) and nobody else is asked, the card casts that yes in the same click (the D4 fast-track). Otherwise it says who the sitting is waiting on.
+- **Alive**: after legislation passes, **Bring the project to life** switches founding mode off and shows the alive moment; **Enter the builders' hall** reloads into the full hall.

package/modules/lifecycle/kickoff-checklist.js

@@ -131,4 +131,57 @@ function kickoffChecklist(spec = {}, { provisioned = false, firstSignIn = false
   return tasks.map((t) => ({ ...t }));
 }
 
-module.exports = { kickoffChecklist, productionTopologyKickoff };
+// ── genesis (task 1004423 / BV2.PS08) ───────────────────────────────────────
+// The five genesis stages are worked as REAL tasks on the new project's board, filed
+// by the same seeder as the kickoff checklist (kickoff-seed.js seedGenesisStages) the
+// moment the founder settles the plan. Each stage closes only when its tasks are
+// finished AND the constitution in force decides it (spec D7), so these are the tasks
+// the Board Room's genesis-stage sitting checks. Ideator decisions, because a stage is
+// a decision written down; an AI session can draft each one the way it drafts any task.
+//
+// A project that already exists (the brownfield path) is asked for what it has first,
+// so its scope stage opens with gathering the existing documents.
+const GENESIS_STEPS = Object.freeze({
+  scope: [
+    { title: 'Write the project scope: what we are making, for whom, and what is out of scope',
+      description: 'Genesis stage 1 (scope). One page the whole team can read: the thing being made, who it is for, what done looks like for the first version, and what is deliberately left out. When it is written, Goals and the Roadmap wake.' },
+  ],
+  strategize: [
+    { title: 'Write out the strategy, or link the one you already have',
+      description: 'Genesis stage 2 (strategize). How the project gets from here to its first version: the order of the big pieces, the risks, and what gets tried first. A strategy that already exists can be linked instead. When it is done, Tasks wake.' },
+  ],
+  charter: [
+    { title: 'Choose the starting government and write the bylaws',
+      description: 'Genesis stage 3 (charter). Pick the form of government the project starts under (the genesis plan recommends one from the team size) and write the short bylaws and code of conduct it runs by. When it is done, the Board Room wakes.' },
+  ],
+  legalize: [
+    { title: 'Decide how contributors are rewarded and who can be paid',
+      description: 'Genesis stage 4 (legalize). Whether builders earn credits, money or nothing, and the limits that apply (age, country, the entity behind the project). When it is done, the Economy wakes.' },
+  ],
+  legislation: [
+    { title: 'Set the voting rules: who votes and how many must agree',
+      description: 'Genesis stage 5 (legislation). Who has a say, and the rule a decision passes by. When it is done, Ranks wake, and the project can come alive.' },
+  ],
+});
+const GENESIS_EXISTING_FIRST = {
+  title: 'Gather what already exists: link the documents, code and notes the project has',
+  description: 'Genesis stage 1 (scope), for a project that already exists. Before writing anything new, link what is already there, so the scope is written from it rather than beside it.',
+};
+
+// genesisChecklist({ existing }) → { stageKey: [{ title, description, kind, discipline, ref }] }
+// in genesis order. `ref` is the stable per-task key the seeder dedups on, so filing
+// twice files nothing new. Pure — no I/O.
+function genesisChecklist({ existing = false } = {}) {
+  const out = {};
+  for (const [stage, steps] of Object.entries(GENESIS_STEPS)) {
+    const list = stage === 'scope' && existing ? [GENESIS_EXISTING_FIRST, ...steps] : steps;
+    // The ref names the step, never its position, so the brownfield step slotting in
+    // ahead of scope's own cannot re-key it into a duplicate.
+    out[stage] = list.map((t) => ({
+      ...t, kind: 'decision', discipline: 'ideator', ref: t === GENESIS_EXISTING_FIRST ? 'genesis:scope:existing' : `genesis:${stage}`,
+    }));
+  }
+  return out;
+}
+
+module.exports = { kickoffChecklist, productionTopologyKickoff, genesisChecklist };

package/modules/lifecycle/kickoff-seed.js

@@ -20,7 +20,7 @@
 
 const api = require('../../src/module-api');
 const db = require('./db');
-const { kickoffChecklist } = require('./kickoff-checklist');
+const { kickoffChecklist, genesisChecklist } = require('./kickoff-checklist');
 
 // The spec the checklist reads, from the instance's own branding pack. `modules` is
 // empty on purpose: a hub-provisioned project is scaffolded with every optional module
@@ -71,4 +71,63 @@ async function seedKickoffIfEmpty({ builderId = null } = {}, deps = {}) {
   return { seeded, versionId };
 }
 
-module.exports = { seedKickoffIfEmpty, specFromBranding, FIRST_VERSION_SQL };
+// ── genesis (task 1004423 / BV2.PS08) ───────────────────────────────────────
+// The same seeder files the five genesis stages as real tasks when the founder settles
+// the genesis plan — one seeder, not a second one (spec reuse table). The kickoff seed
+// is idempotent by emptiness, which cannot work here: by genesis the board already
+// holds the kickoff checklist. So each genesis task carries source 'genesis' and a
+// stable source_ref per step (genesisChecklist's `ref`), and a step already filed is
+// skipped. Filing twice files nothing new.
+const GENESIS_SOURCE = 'genesis';
+
+// seedGenesisStages({ builderId, existing }, deps) → { seeded, versionId } | { seeded: 0, skipped }
+async function seedGenesisStages({ builderId = null, existing = false } = {}, deps = {}) {
+  const pool = deps.pool || api.pool;
+  const insert = deps.createTask || ((row) => db.createTask(row));
+  const find = deps.findTaskBySourceRef || ((q) => db.findTaskBySourceRef(q));
+  const { rows: versions } = await pool.query(FIRST_VERSION_SQL);
+  if (!versions.length) return { seeded: 0, skipped: 'no_version' };
+  const versionId = versions[0].id;
+  let seeded = 0;
+  for (const steps of Object.values(genesisChecklist({ existing }))) {
+    for (const t of steps) {
+      if (await find({ source: GENESIS_SOURCE, sourceRef: t.ref })) continue;
+      await insert({
+        versionId,
+        title: t.title,
+        description: t.description,
+        status: 'ready',
+        kind: t.kind,
+        discipline: t.discipline,
+        source: GENESIS_SOURCE,
+        sourceRef: t.ref,
+        createdBy: builderId,
+        // As the kickoff checklist: a project in genesis has no goals yet (Goals wake
+        // only when scope is done), so the catch-all is the honest home.
+        allowCatchAll: true,
+      });
+      seeded += 1;
+    }
+  }
+  return { seeded, versionId };
+}
+
+// genesisStageTasks(deps) → { stageKey: [{ id, title, status }] } for every genesis
+// task on the board, grouped by the stage its source_ref names. The genesis home lists
+// them, and a stage close hands their ids to the Board Room's finished-tasks gate.
+async function genesisStageTasks(deps = {}) {
+  const pool = deps.pool || api.pool;
+  const { rows } = await pool.query(
+    `SELECT id, title, status, source_ref FROM tasks WHERE source = $1 ORDER BY id ASC`,
+    [GENESIS_SOURCE],
+  );
+  const out = {};
+  for (const r of rows) {
+    const stage = String(r.source_ref || '').split(':')[1];
+    if (!stage) continue;
+    (out[stage] = out[stage] || []).push({ id: String(r.id), title: r.title, status: r.status });
+  }
+  return out;
+}
+
+module.exports = { seedKickoffIfEmpty, specFromBranding, FIRST_VERSION_SQL, seedGenesisStages, genesisStageTasks, GENESIS_SOURCE };