@bongos/core 1.19.386 → 1.19.388

package/docs/file-map.md

@@ -9,6 +9,9 @@
 /
 ├── CLAUDE.md                    ← index + framing (descriptive; DB is source of truth for state)
 ├── README.md                    ← public-facing one-paragraph summary
+├── PRODUCT.md                   ← durable product truth for the apex/hall/status surfaces (impeccable init, task 1003296): users, positioning, constraints, brand commitments, principles — no palette, no type
+├── DESIGN.md                    ← the visual rulebook written FROM the built landing (task 1003298, ADR 0196): palette + derived recipes, type, materials (the chrome plates), components, the motion grammar, both modes; what H1 (hall) and S1 (status) build against. Sidecar .impeccable/design.json
+├── .impeccable/                 ← impeccable skill artifacts: config.json (buildPath: code), surfaces/<route>.md (per-route briefs), mocks/world-assets/ (Higgsfield renders + prompt sidecars; the SOURCE of public-landing/assets/world/), mocks/decision/ (A1 comps), design.json (DESIGN.md sidecar), review/ (finish captures)
 ├── .gitignore
 ├── package.json / package-lock.json
 ├── CODEOWNERS                   ← owner review on the merge-gate surfaces (real since task 1002611, ADR 0159); inert until branch protection is on (scripts/gds/gating.js) — keep aligned with gate-review.js HARD_FLOOR_GLOBS
@@ -246,6 +249,17 @@
 │   ├── assets/tray/ + build-resources/ ← generated icons (scripts/gen-icons.js; build-resources name dodges the global build/ gitignore)
 │   └── test/unit.mjs               ← hermetic unit tests (run by the CI workflow, not the root gate)
 │
+├── public-landing/                 ← the APEX front door + hub surfaces served by src/platform-server.js (landingPage(): apex-only strip → brand-token stamp → theme injection → ?v= asset stamp). Ships to EVERY instance; <!--apex-only:start/end--> regions are removed on a child
+│   ├── index.html                  ← the landing (/) — v3 "the template's page" of the chrome world (task 1003298, ADR 0196): server-stamped head, the breath (CSS-only signature), live figures/ledger/orbs from the public feeds baked inside sentinels; page-local <style> only (no :root), links /assets/world.css
+│   ├── projects.html               ← the hub (/projects?view=map|mine|manage|new) on cosmos.css (A4, task 1003299, rebuilds it in the world)
+│   ├── privacy.html / terms.html / contact.html ← the footer doors (task 1003251), on cosmos.css
+│   ├── assets/
+│   │   ├── world.css               ← the WORLD token layer (ADR 0196): contract tier = the pack, derived tier both modes, root-absolute plate token pairs, the reduced-motion kill switch; no page composition
+│   │   ├── world/                  ← the six production plates + <file>.json provenance sidecars (embed-prompt.mjs --scan clean): r2-chrome-blobs-set.jpg, r2-chrome-blob-one.jpg, r2-bongos-chrome-b.jpg (black plates, dark mode, lighten) and their -cut.webp alpha twins (light mode); og-card.jpg (the social card, captured from the page)
+│   │   ├── cosmos.css              ← the HUB component sheet (task 1002696): contract tier synced to the pack, its own derived + dark tiers, the .btn/.chip/.strip/.proj/.tbl vocabulary; measured by tests/cosmos_token_contrast.mjs
+│   │   └── verro-medallion.png     ← the Verro Labs mark (apex-only block)
+│   └── world/assets/               ← the RETIRED gate's clouds/creatures/plates (task 1002407; the gate folded into / in 1003233) — not the chrome plates
+│
 ├── public/                         ← example.com — the game (product)
 │   ├── index.html
 │   ├── assets/

package/modules/dev-box/app/renderer/index.html

@@ -7,7 +7,7 @@
   <title>Dev Box</title>
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Baloo+2:wght@500;600;700&family=Quicksand:wght@400;500;600;700&display=swap" rel="stylesheet">
+  <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400&family=Manrope:wght@300;400;500;600&display=swap" rel="stylesheet">
   <link rel="stylesheet" href="theme.generated.css">
   <link rel="stylesheet" href="styles.css">
 </head>

package/modules/dev-box/app/renderer/styles.css

@@ -154,7 +154,9 @@ main {
   width: 100%;
   margin-top: 10px;
 }
-.btn:hover:not(:disabled) { background: var(--accent); border-color: var(--accent); }
+/* the hover fill is the raw accent; the chrome world's accent carries a light ink
+   at 2.19:1, so the label flips to --ink on it (8.12:1) — task 1003298 */
+.btn:hover:not(:disabled) { background: var(--accent); border-color: var(--accent); color: var(--ink); }
 .btn:disabled { opacity: 0.55; cursor: default; }
 .btn--ghost {
   background: transparent;

package/modules/dev-box/app/renderer/theme.generated.css

@@ -1,16 +1,16 @@
 /* GENERATED by scripts/gen-brand.js from config/branding.json — do not edit by hand. */
 :root {
-  --bg: #f9d9a8;
-  --bg-card: #fffaf2;
-  --bg-deep: #f6d8ae;
-  --ink: #2b170e;
-  --ink-soft: #6d4a33;
-  --ink-faint: #785a41;
-  --rule: #e8a463;
-  --rule-soft: #f6d8ae;
-  --accent: #ce4806;
-  --accent-deep: #9e3406;
-  --terracotta: #855b3d;
-  --font-display: "Baloo 2", "Quicksand", system-ui, sans-serif;
-  --font-body: "Quicksand", system-ui, -apple-system, "Segoe UI", sans-serif;
+  --bg: #edecee;
+  --bg-card: #fbfafc;
+  --bg-deep: #e2e1e4;
+  --ink: #17181a;
+  --ink-soft: #55565a;
+  --ink-faint: #65656a;
+  --rule: #c6c6c8;
+  --rule-soft: #dcdbdd;
+  --accent: #fb9569;
+  --accent-deep: #a3481a;
+  --terracotta: #c9512c;
+  --font-display: "Manrope", "Segoe UI", system-ui, -apple-system, sans-serif;
+  --font-body: "Manrope", "Segoe UI", system-ui, -apple-system, sans-serif;
 }

package/modules/dev-box/app/scripts/gen-brand.js

@@ -73,7 +73,7 @@ function buildBrand(branding) {
     // Panel header epigraph (branding copy.tagline).
     TAGLINE: (branding.copy && branding.copy.tagline) || '',
     // Pre-CSS window background (main.js) — the theme bg so first paint is on-brand.
-    BG_COLOR: colors.bg || '#fffaf2',
+    BG_COLOR: colors.bg || '#fbfafc',
   };
 }
 
@@ -85,19 +85,19 @@ function buildThemeCss(branding) {
   const v = (x, fb) => x || fb;
   return `/* GENERATED by scripts/gen-brand.js from config/branding.json — do not edit by hand. */
 :root {
-  --bg: ${v(c.bg, '#f9d9a8')};
-  --bg-card: ${v(c.bgCard, '#fffaf2')};
-  --bg-deep: ${v(c.bgDeep, '#f6d8ae')};
-  --ink: ${v(c.ink, '#2b170e')};
-  --ink-soft: ${v(c.inkSoft, '#6d4a33')};
+  --bg: ${v(c.bg, '#edecee')};
+  --bg-card: ${v(c.bgCard, '#fbfafc')};
+  --bg-deep: ${v(c.bgDeep, '#e2e1e4')};
+  --ink: ${v(c.ink, '#17181a')};
+  --ink-soft: ${v(c.inkSoft, '#55565a')};
   --ink-faint: ${v(c.inkFaint, '#785a41')};
-  --rule: ${v(c.rule, '#e8a463')};
-  --rule-soft: ${v(c.ruleSoft, '#f6d8ae')};
-  --accent: ${v(c.accent, '#ce4806')};
-  --accent-deep: ${v(c.accentDeep, '#9e3406')};
-  --terracotta: ${v(c.terracotta, '#855b3d')};
-  --font-display: ${v(fonts.display, '"Baloo 2", "Quicksand", system-ui, sans-serif')};
-  --font-body: ${v(fonts.body, '"Quicksand", system-ui, -apple-system, "Segoe UI", sans-serif')};
+  --rule: ${v(c.rule, '#c6c6c8')};
+  --rule-soft: ${v(c.ruleSoft, '#dcdbdd')};
+  --accent: ${v(c.accent, '#fb9569')};
+  --accent-deep: ${v(c.accentDeep, '#a3481a')};
+  --terracotta: ${v(c.terracotta, '#c9512c')};
+  --font-display: ${v(fonts.display, '"Manrope", "Segoe UI", system-ui, sans-serif')};
+  --font-body: ${v(fonts.body, '"Manrope", "Segoe UI", system-ui, -apple-system, sans-serif')};
 }
 `;
 }

package/modules/dev-box/app/scripts/gen-dmg-backdrop.py

@@ -68,9 +68,9 @@ ICON = 100                 # dmg.iconSize
 # it, so its "fallback" would paint a Cloud Bongos colour into a fully-specified
 # host build. That is exactly what `sea` did to the Applications-well rim.
 COLOR_ROLES = {
-    "bg": "#f9d9a8", "bgDeep": "#f6d8ae", "bgCard": "#fffaf2",
-    "ink": "#2b170e", "inkSoft": "#6d4a33", "ruleSoft": "#f6d8ae",
-    "accent": "#ce4806", "accentDeep": "#9e3406", "terracotta": "#855b3d",
+    "bg": "#edecee", "bgDeep": "#e2e1e4", "bgCard": "#fbfafc",
+    "ink": "#17181a", "inkSoft": "#55565a", "ruleSoft": "#dcdbdd",
+    "accent": "#fb9569", "accentDeep": "#a3481a", "terracotta": "#c9512c",
 }
 
 FONT_DIRS = (

package/modules/dev-box/app/scripts/gen-icons.js

@@ -62,9 +62,9 @@ const OUT_BUILD = path.join(APP_DIR, 'build-resources');
 // it has nothing prompting a host to define it, so its "fallback" would paint a
 // Cloud Bongos colour into a fully-specified host build.
 const COLOR_ROLES = {
-  bgCard: '#fffaf2', bgDeep: '#f6d8ae', ink: '#2b170e',
-  rule: '#e8a463', ruleSoft: '#f6d8ae',
-  accent: '#ce4806', accentDeep: '#9e3406', terracotta: '#855b3d',
+  bgCard: '#fbfafc', bgDeep: '#e2e1e4', ink: '#17181a',
+  rule: '#c6c6c8', ruleSoft: '#dcdbdd',
+  accent: '#fb9569', accentDeep: '#a3481a', terracotta: '#c9512c',
 };
 
 // The pack, resolved exactly as gen-brand.js resolves it (env → instance → neutral).

package/modules/dev-box/app/src/brand.generated.json

@@ -9,5 +9,5 @@
   "COPYRIGHT": "© Cloud Bongos",
   "CONFIG_DIR": "cloudbongos",
   "TAGLINE": "Building Digitally, as simple as Bongos.",
-  "BG_COLOR": "#f9d9a8"
+  "BG_COLOR": "#edecee"
 }

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

@@ -101,3 +101,73 @@
   font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 12px;
   color: var(--accent-text); background: var(--surface-2); padding: 1px 5px; border-radius: 4px;
 }
+
+/* ---- the Board Room: one sitting, one decision (task 1003270) -------------
+   The item card is NOT `.gov-section`. It used to be, which meant the title of
+   the idea being voted on rendered through `.gov-section__head` — 11.5px,
+   uppercase, letterspaced, i.e. styled as a table header. Here the title is a
+   title, the ballot sits directly under it, the idea's own words are body text,
+   and the constitutional metadata is the only thing behind a click. */
+.gov-item {
+  margin: 0 0 18px; border: 1px solid var(--border); border-radius: var(--radius);
+  background: var(--surface); overflow: hidden;
+}
+.gov-item__head {
+  display: flex; flex-wrap: wrap; align-items: baseline; justify-content: space-between;
+  gap: 6px 12px; padding: 12px 14px 10px;
+}
+.gov-item__title {
+  margin: 0; min-width: 0; font-size: 16px; font-weight: 600; line-height: 1.35;
+  color: var(--ink); overflow-wrap: anywhere;
+}
+.gov-item__title a { color: inherit; }
+.gov-item__state { display: inline-flex; align-items: center; gap: 8px; font-size: 12px; }
+.gov-item__amend { margin: 0; padding: 0 14px 10px; color: var(--ink-soft); font-size: 12.5px; overflow-wrap: anywhere; }
+
+/* The primary action, directly under the title — that adjacency is the fix. */
+.gov-item__act { padding: 2px 14px 14px; }
+.gov-item__cast { margin: 0; color: var(--ink-soft); font-size: 12.5px; }
+
+/* The idea itself: open, and set as prose rather than as permission rows. */
+.gov-idea { padding: 12px 14px 2px; border-top: 1px solid var(--border); }
+.gov-idea__part { margin: 0 0 12px; }
+.gov-idea__label { margin: 0 0 3px; font-size: 12px; font-weight: 600; color: var(--ink-soft); }
+.gov-idea__body {
+  margin: 0; color: var(--ink); font-size: 13.5px; line-height: 1.5;
+  white-space: pre-wrap; overflow-wrap: anywhere;
+}
+
+/* Secondary: the tally rides the summary (visible without a click — ADR 0175
+   §9), the rules and the open ballot sit inside it. */
+.gov-item__meta { border-top: 1px solid var(--border); }
+.gov-item__summary {
+  padding: 8px 14px; cursor: pointer; color: var(--ink-soft); font-size: 12px;
+  list-style-position: inside;
+}
+.gov-item__summary:hover { color: var(--ink); }
+.gov-item__metabody { padding: 10px 14px 2px; background: var(--surface-2); }
+.gov-item__metabody .gov-section { margin: 0 0 12px; background: var(--surface); }
+.gov-item__metabody .gov-empty { padding: 0 0 12px; }
+
+/* ---- the ballot controls ------------------------------------------------- */
+.gov-vote { display: flex; flex-direction: column; align-items: flex-start; gap: 8px; }
+.gov-vote > .gov-grid-note { margin: 0; max-width: 62ch; }
+.gov-vote__no { align-self: stretch; }
+/* The disclosure IS the secondary button, so its marker must go — otherwise the
+   triangle sits inside the pill. */
+.gov-vote__no > summary { display: inline-block; cursor: pointer; }
+.gov-vote__no > summary::marker { content: ''; }
+.gov-vote__no > summary::-webkit-details-marker { display: none; }
+.gov-vote__no > *:not(summary) { margin-top: 8px; }
+.gov-vote__no > textarea.gov-input { display: block; width: 100%; max-width: 62ch; }
+.gov-vote__sections { display: flex; flex-wrap: wrap; gap: 0 18px; }
+.gov-vote__sections .gov-perm {
+  padding: 2px 0; border-bottom: 0; cursor: pointer; font-size: 12.5px; color: var(--ink);
+}
+
+/* The ballot rows reuse `.gov-assign-row`, whose four flex children (name, pill,
+   timestamp, objection) cannot fit one 390w line — the objection is a paragraph,
+   not a cell, so it takes its own row and the rest wraps. Scoped to the metabody
+   so the Permissions and Constitution tabs keep their single-line rows. */
+.gov-item__metabody .gov-assign-row { flex-wrap: wrap; }
+.gov-item__metabody .gov-assign-row .gov-perm__guards { flex: 1 1 100%; margin-top: 4px; }

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

@@ -37,14 +37,21 @@
                R18/R19; until then the section frames the model honestly. -->
           <section id="gov-panel-constitution" hidden>
             <h2 class="gov-h">Constitution</h2>
-            <p class="gov-grid-note">Three dials decide how this project is governed: <strong>who sits on the board</strong> (a rank — everyone holding it is a member), <strong>what counts as passing</strong> (a first ratifier, or the consent of the sitting), and <strong>how long a vote stays open</strong> (a timed sitting, or no clock at all). They are configuration on the same machinery at every setting — a project starts with the founder ratifying alone and opens up by changing numbers, not code.</p>
+            <!-- Task 1003270: the ~60-word explainer that used to sit here said,
+                 at length, what the three live sentences below say from the real
+                 config. A reader met the paragraph before the values. -->
+            <p class="gov-grid-note">Three dials, all settings rather than code: <strong>who sits on the board</strong>, <strong>what counts as passing</strong>, and <strong>how long a vote stays open</strong>.</p>
             <div id="gov-constitution"></div>
           </section>
 
           <!-- §2 Board Room — open items, the clock, your vote (R16/R17). -->
           <section id="gov-panel-board" hidden>
             <h2 class="gov-h">Board Room</h2>
-            <p class="gov-grid-note">Where a Full Idea that cleared the completeness grade comes to be ratified — and where the constitution itself is amended. Open items appear here with their clock and a live tally; an objection must carry a reason and name the section it faults, which is why votes are cast here and only mirrored to chat.</p>
+            <!-- Task 1003270: one line, then the ballot. Everything the old
+                 ~50-word paragraph explained is now said by the cards themselves
+                 — each one carries who votes and how it passes, in plain words,
+                 under its own summary. -->
+            <p class="gov-grid-note">Read an idea, then decide. An objection needs a reason and the section it faults.</p>
             <div id="gov-board"></div>
           </section>
 

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

@@ -42,6 +42,22 @@
 // items and the vote. Until a frame is filled it states what belongs there
 // and shows an honest kit empty state — never a fake or a hardcoded value that
 // could drift from the real config.
+//
+// TASK 1003270 rebuilt the BOARD ROOM CARD around one claim: the idea is the
+// subject, everything else is apparatus. So the idea's title renders at title
+// size and its five sections render open as prose; the ballot sits directly
+// beneath the title; and the government apparatus — who votes, how it passes,
+// the clock, the open ballot — moved behind one summary that still shows the
+// tally. Two rules came out of it and should survive the next edit here:
+//   • NO RAW CONFIG KEY REACHES A READER. `first_ratifier` / `rank:archon` /
+//     `why_matters` are grammar for the server; a person gets the sentence
+//     (decidedByHtml, rankNames, SECTION_LABELS). The single exception is a
+//     membership predicate that cannot be PARSED, where the broken string is
+//     the actionable fact.
+//   • COPY THAT EXPLAINS THE UI TO ITSELF IS DELETED, not shortened.
+// What simplifying may NOT touch is ADR 0175 §8: an objection still carries a
+// reason and names one section. That requirement is why voting lives in the
+// hall and not on a chat reaction.
 
 (() => {
   'use strict';
@@ -497,7 +513,12 @@
       // and fixable, a board described as working is neither.
       return `Membership predicate <code>${escapeHtml(raw || 'unset')}</code> cannot be read, so <strong>nobody</strong> sits on the board until it is corrected.`;
     }
-    const strong = keys.map((k) => `<strong>${escapeHtml(k)}</strong>`);
+    // Task 1003270: the DISPLAY label, not the Greek enum key. The enum is the
+    // grammar an owner types into the predicate (and the charter library below
+    // still shows it verbatim, which is that library's whole job); this sentence
+    // is the one that answers "who governs", so it uses the words the rest of
+    // the hall shows a rank in.
+    const strong = keys.map((k) => `<strong>${escapeHtml(window.OTB.rankLabel(k))}</strong>`);
     if (keys.length === 1) {
       return `Every active builder holding the ${strong[0]} rank — and only that rank — sits on the board. Membership follows the rank, live.`;
     }
@@ -536,7 +557,7 @@
     const early = board.close_early_on_full_turnout
       ? ', closing early the moment every member has voted'
       : '';
-    return `A sitting runs <strong>${escapeHtml(String(board.window_minutes))} minutes</strong>${early}. An unvoted window nulls that member's vote — absence never blocks.`;
+    return `A sitting runs <strong>${fmtWindow(board.window_minutes)}</strong>${early}. An unvoted window nulls that member's vote — absence never blocks.`;
   }
 
   function historyRow(h) {
@@ -545,8 +566,10 @@
     const pill = h.outcome === 'passed'
       ? '<span class="gov-pill gov-pill--seeded">ratified</span>'
       : '<span class="gov-pill gov-pill--locked">returned</span>';
+    // Task 1003270: the rule by name, not by config key. An unknown value still
+    // shows verbatim — a rule this build does not know about is worth seeing.
     const under = h.decided_under && h.decided_under.pass_rule
-      ? ` · decided under <code>${escapeHtml(h.decided_under.pass_rule)}</code>`
+      ? ` · decided ${escapeHtml(PASS_RULE_NAME[h.decided_under.pass_rule] || `under ${h.decided_under.pass_rule}`)}`
       : '';
     return `<div class="gov-assign-row">
       <span class="gov-assign-row__who">${who} proposed <code>${escapeHtml(JSON.stringify(h.proposed))}</code>${h.rationale_md ? ` — ${escapeHtml(h.rationale_md)}` : ''}</span>
@@ -717,11 +740,14 @@
       const who = escapeHtml(v.display_name || v.github_login || `builder ${v.voter_id}`);
       const mine = String(v.voter_id) === String(viewerId) ? ' <span class="gov-held-note">your vote</span>' : '';
       const when = escapeHtml(String(v.cast_at).slice(0, 16).replace('T', ' '));
+      // Task 1003270: the faulted section by its LABEL — the words the author
+      // wrote under and the objector picked from. `why_matters` is a jsonb key,
+      // not something a reader should have to decode.
       const objection = v.direction === 'no'
-        ? `<div class="gov-perm__guards">objected to <code>${escapeHtml(v.section_key || '')}</code> — ${escapeHtml(v.reason_md || '')}</div>`
+        ? `<div class="gov-perm__guards">objected to <strong>${escapeHtml(SECTION_LABELS[v.section_key] || v.section_key || 'the idea')}</strong> — ${escapeHtml(v.reason_md || '')}</div>`
         : '';
       return `<div class="gov-assign-row"><span class="gov-assign-row__who">${who}${mine}</span>
-        <span class="gov-pill ${v.direction === 'no' ? 'gov-pill--locked' : 'gov-pill--seeded'}">${v.direction}</span>
+        <span class="gov-pill ${v.direction === 'no' ? 'gov-pill--locked' : 'gov-pill--seeded'}">${v.direction === 'no' ? 'objected' : 'yes'}</span>
         <span class="muted">${when}</span>${objection}</div>`;
     }).join('');
     return `<div class="gov-section">${rows}</div>`;
@@ -742,20 +768,102 @@
 
   // The idea's five sections, IN FRONT of the voter — the entire reason voting
   // happens in the hall rather than on a reaction. Rendered in template order.
+  //
+  // TASK 1003270 — OPEN, AND SET AS PROSE. This used to be a <details> summarised
+  // "The idea, in full · completeness 100/100": the substance the vote is about
+  // sat behind a click while the constitutional metadata above it stayed expanded,
+  // which is exactly backwards. The labels were <code> pills over
+  // `.gov-perm__guards`, so an author's answers were styled as config rows. The
+  // score moved into the collapsed metadata (decidedByHtml) — it describes the
+  // grade the idea cleared, not the idea.
   function ideaSectionsHtml(item) {
     const fv = item.subject && item.subject.field_values;
     if (!fv) return '';
-    const rows = Object.keys(SECTION_LABELS).map((key) => `
-      <div class="gov-perm">
-        <div class="gov-perm__main">
-          <code class="gov-perm__key">${escapeHtml(SECTION_LABELS[key])}</code>
-          <div class="gov-perm__guards">${escapeHtml(String(fv[key] ?? ''))}</div>
-        </div>
-      </div>`).join('');
-    const score = item.subject.completeness_score;
-    return `<details class="gov-section"><summary class="gov-section__head">The idea, in full${score != null ? ` \u00b7 completeness ${escapeHtml(String(score))}/100` : ''}</summary>${rows}</details>`;
+    const rows = Object.keys(SECTION_LABELS).map((key) => {
+      // An unanswered section is dropped rather than rendered as a bare heading:
+      // a graded Full Idea has all five, and a blank one is only noise.
+      const body = String(fv[key] ?? '').trim();
+      if (!body) return '';
+      return `<div class="gov-idea__part">
+        <h4 class="gov-idea__label">${escapeHtml(SECTION_LABELS[key])}</h4>
+        <p class="gov-idea__body">${escapeHtml(body)}</p>
+      </div>`;
+    }).join('');
+    return rows
+      ? `<div class="gov-idea">${rows}</div>`
+      : '<p class="gov-empty">This idea has no written sections.</p>';
+  }
+
+  // ---- the sitting's rules, in plain words (task 1003270) --------------------
+
+  // The card used to carry `tally: 0 yes · 0 no — sitting under <first_ratifier>,
+  // membership <rank:archon>` — raw config keys, in a reader's face, ABOVE the
+  // idea they were being asked to decide. These say the same thing in the words
+  // a person thinks in, filed under a summary where secondary information
+  // belongs.
+  //
+  // Read from the item's SNAPSHOT constitution (the rules in force when the
+  // window opened), never today's config — the same rules the server tallies
+  // under. Rank KEYS never surface: the display label comes from the branding
+  // pack via OTB.rankLabel, as on every other hall surface. The one place a raw
+  // predicate still shows is an UNREADABLE one, where the broken string is the
+  // actionable fact and hiding it would help nobody.
+  function rankNames(keys) {
+    const labels = keys.map((k) => escapeHtml(window.OTB.rankLabel(k)));
+    if (labels.length === 1) return labels[0];
+    return `${labels.slice(0, -1).join(', ')} or ${labels[labels.length - 1]}`;
+  }
+
+  // A sitting length in the unit a person would say it in. The config stores
+  // minutes; "2880 minutes" is a number nobody converts in their head.
+  function fmtWindow(minutes) {
+    const m = Number(minutes);
+    if (!Number.isFinite(m) || m <= 0) return `${escapeHtml(String(minutes))} minutes`;
+    const plural = (n, word) => `${n} ${word}${n === 1 ? '' : 's'}`;
+    if (m % 1440 === 0) return plural(m / 1440, 'day');
+    if (m % 60 === 0) return plural(m / 60, 'hour');
+    return plural(m, 'minute');
   }
 
+  // The short name of a pass rule, for a place a whole sentence will not fit.
+  const PASS_RULE_NAME = {
+    first_ratifier: 'by first ratifier',
+    consent: 'by consent',
+    majority: 'by majority',
+  };
+
+  const PASS_RULE_PLAIN = {
+    first_ratifier: 'The first vote decides it: a yes ratifies, an objection returns it to its author.',
+    consent: 'It passes unless someone objects \u2014 silence is agreement, and one reasoned objection returns it.',
+    majority: 'It passes only when more than half the board votes yes. Silence is not agreement here.',
+  };
+
+  function decidedByHtml(item) {
+    const c = item.constitution || {};
+    const past = !!item.closed_at;
+    const keys = membershipRankKeys(c.membership);
+    const who = keys
+      ? `Every active <strong>${rankNames(keys)}</strong> ${past ? 'could vote on this' : 'may vote on this'}.`
+      : `Nobody ${past ? 'could vote' : 'may vote'} \u2014 the membership setting <code>${escapeHtml(String(c.membership || 'unset'))}</code> cannot be read.`;
+    const rule = PASS_RULE_PLAIN[c.pass_rule] || 'How this sitting passes could not be read.';
+    const clock = c.window_minutes === null || c.window_minutes === undefined
+      ? `No deadline \u2014 it ${past ? 'stayed' : 'stays'} open until a vote decides it.`
+      : `The sitting ${past ? 'ran' : 'runs'} ${fmtWindow(c.window_minutes)}${c.close_early_on_full_turnout ? ', closing early once every member has voted' : ''}.`;
+    const score = item.subject ? item.subject.completeness_score : null;
+    const grade = score == null
+      ? ''
+      : `<p class="gov-grid-note">It cleared the completeness grade at ${escapeHtml(String(score))}/100.</p>`;
+    return `<p class="gov-grid-note">${who}</p>
+      <p class="gov-grid-note">${rule}</p>
+      <p class="gov-grid-note">${clock}</p>${grade}`;
+  }
+
+  // TASK 1003270: the ballot is the point of the card, so its copy earns its
+  // place or goes. What stayed is the ADR 0175 §8 requirement itself — an
+  // objection carries a REASON and names ONE SECTION — because that requirement
+  // is the whole reason voting lives in the hall instead of on a chat reaction.
+  // Simplifying may not weaken it, so the reason box and the five-way picker are
+  // untouched; only the sentences around them shrank.
   function voteFormHtml(item, viewerId) {
     if (item.closed_at) return '';
     const mine = item.votes.find((v) => String(v.voter_id) === String(viewerId));
@@ -770,16 +878,16 @@
     const isOwnIdea = item.subject_type === 'full_idea'
       && item.subject && String(item.subject.author_id) === String(viewerId);
     const sections = Object.keys(SECTION_LABELS).map((key) => `
-      <label class="gov-perm" style="cursor:pointer"><input type="radio" name="vote-section-${escapeHtml(item.id)}" value="${escapeHtml(key)}"> <span>${escapeHtml(SECTION_LABELS[key])}</span></label>`).join('');
+      <label class="gov-perm"><input type="radio" name="vote-section-${escapeHtml(item.id)}" value="${escapeHtml(key)}"> <span>${escapeHtml(SECTION_LABELS[key])}</span></label>`).join('');
     const ownNote = isOwnIdea
-      ? `<p class="gov-grid-note">This is your idea. You can vote on it \u2014 your position belongs on the record \u2014 but it can\u2019t be decided by your vote alone, and a vote on your own idea earns no karma.</p>`
+      ? `<p class="gov-grid-note">Your own idea. You may vote, but it can\u2019t be decided by your vote alone, and a vote on your own idea earns no karma.</p>`
       : '';
     return `<div class="gov-vote" data-item="${escapeHtml(item.id)}">
       ${ownNote}
       <button type="button" class="gov-btn" data-vote="yes">Vote yes</button>
       <details class="gov-vote__no">
         <summary class="gov-btn gov-btn--ghost">Object\u2026</summary>
-        <p class="gov-grid-note">An objection returns the idea to its author with your reason and the section it faults \u2014 the feedback they revise against.</p>
+        <p class="gov-grid-note">This sends the idea back to its author. Say why, and which section.</p>
         <textarea class="gov-input" data-vote-reason placeholder="Why \u2014 the reason the author will act on" maxlength="5000" rows="3"></textarea>
         <div class="gov-vote__sections">${sections}</div>
         <button type="button" class="gov-btn" data-vote="no">Cast objection</button>
@@ -807,27 +915,60 @@
     loadBoard(); // re-render either way — the room shows what stands
   }
 
+  // ONE SITTING, ONE DECISION (task 1003270). The card reads top-down in the
+  // order a person actually needs it:
+  //
+  //   1. what is being decided — the idea's TITLE, at title size. It used to
+  //      render through `.gov-section__head`, i.e. 11.5px uppercase letterspaced:
+  //      the subject of the vote styled as a table header.
+  //   2. the ACTION, immediately under it. Everything that used to sit between
+  //      the two — a tally of raw config keys, a sentence explaining that the UI
+  //      had no vote form (it does), and a collapsed idea — is gone or moved, so
+  //      "Vote yes" lands above the fold on an ordinary window instead of below
+  //      a wall of prose.
+  //   3. the idea itself, open (ideaSectionsHtml).
+  //   4. the constitutional metadata, collapsed — who votes, how it passes, the
+  //      clock, and the open ballot. Still one click away, never invisible: the
+  //      tally rides the summary, which is the part of it a reader scans for
+  //      (ADR 0175 §9 — a board whose votes are invisible constrains nobody).
+  //
+  // A CLOSED sitting has no action and no idea body: its head carries the
+  // outcome and the record lives under the same summary.
   function itemCard(item, viewerId) {
     const yes = item.votes.filter((v) => v.direction === 'yes').length;
     const no = item.votes.filter((v) => v.direction === 'no').length;
-    const state = item.closed_at
-      ? `<span class="gov-pill ${item.outcome === 'passed' ? 'gov-pill--seeded' : 'gov-pill--locked'}">${escapeHtml(item.outcome || '')}</span>`
-      : `<span class="gov-pill gov-pill--custom">open</span> <span class="muted">${escapeHtml(clockLine(item))}</span>`;
+    const isOpen = !item.closed_at;
+    const state = isOpen
+      ? `<span class="gov-pill gov-pill--custom">open</span> <span class="muted">${escapeHtml(clockLine(item))}</span>`
+      : `<span class="gov-pill ${item.outcome === 'passed' ? 'gov-pill--seeded' : 'gov-pill--locked'}">${escapeHtml(item.outcome || '')}</span>`;
     const amendmentDetail = item.subject_type === 'constitutional_amendment' && item.subject
-      ? `<div class="gov-perm__guards">proposes: <code>${escapeHtml(JSON.stringify(item.subject.proposed))}</code>${item.subject.rationale_md ? ` — ${escapeHtml(item.subject.rationale_md)}` : ''}</div>`
+      ? `<p class="gov-item__amend">Proposes <code>${escapeHtml(JSON.stringify(item.subject.proposed))}</code>${item.subject.rationale_md ? ` \u2014 ${escapeHtml(item.subject.rationale_md)}` : ''}</p>`
       : '';
     const mine = item.votes.find((v) => String(v.voter_id) === String(viewerId));
-    const myLine = item.closed_at ? '' : (mine
-      ? `<p class="gov-grid-note">You voted <strong>${escapeHtml(mine.direction)}</strong>. One vote per member — no changes.</p>`
-      : `<p class="gov-grid-note">You have not voted on this item. Casting arrives with the vote form.</p>`);
-    return `<section class="gov-section" id="board-item-${escapeHtml(item.id)}">
-      <div class="gov-section__head">${subjectLine(item)} ${state}</div>
+    // A voter who has cast sees WHAT they cast where the buttons were. The line
+    // that used to fill this slot for everyone else — announcing that the reader
+    // had not voted and that casting was still to come — is deleted outright: it
+    // explained the UI to itself, and the form it promised shipped in R17.
+    const action = !isOpen ? ''
+      : mine
+        ? `<p class="gov-item__cast">You ${mine.direction === 'no' ? 'objected' : 'voted yes'}. One vote per member.</p>`
+        : voteFormHtml(item, viewerId);
+    const tally = `${yes} yes \u00b7 ${no} objection${no === 1 ? '' : 's'}`;
+    return `<section class="gov-item" id="board-item-${escapeHtml(item.id)}">
+      <div class="gov-item__head">
+        <h3 class="gov-item__title">${subjectLine(item)}</h3>
+        <span class="gov-item__state">${state}</span>
+      </div>
       ${amendmentDetail}
-      <p class="gov-grid-note">tally: ${yes} yes · ${no} no — sitting under <code>${escapeHtml((item.constitution && item.constitution.pass_rule) || '?')}</code>, membership <code>${escapeHtml((item.constitution && item.constitution.membership) || '?')}</code></p>
-      ${myLine}
-      ${item.closed_at ? '' : ideaSectionsHtml(item)}
-      ${ballotHtml(item, viewerId)}
-      ${voteFormHtml(item, viewerId)}
+      ${action ? `<div class="gov-item__act">${action}</div>` : ''}
+      ${isOpen ? ideaSectionsHtml(item) : ''}
+      <details class="gov-item__meta">
+        <summary class="gov-item__summary">${tally} \u00b7 who votes, and how it ${isOpen ? 'passes' : 'passed'}</summary>
+        <div class="gov-item__metabody">
+          ${decidedByHtml(item)}
+          ${ballotHtml(item, viewerId)}
+        </div>
+      </details>
     </section>`;
   }
 
@@ -905,7 +1046,9 @@
     const rank = (me && (me.builder || me).rank || '').toLowerCase();
     const isArchon = rank === 'archon';
 
-    document.getElementById('gov-sub').textContent = 'How this project is governed — the constitution it runs, the Board Room, and the ranks & permissions that administer it.';
+    // Task 1003270: the subtitle used to restate the three tab labels sitting
+    // directly beneath it, in ~20 words, above everything actionable.
+    document.getElementById('gov-sub').textContent = 'How this project is governed.';
     document.getElementById('gov-body').hidden = false;
     wireTabs({ isArchon });
     loadBoard();        // the room loads for everyone the page admits

package/modules/provisioning/routes/provisioning.js

@@ -99,8 +99,8 @@ function esc(s) {
 const ACCENT = (() => {
   try {
     const c = api.branding().theme?.ui?.colors || {};
-    return { sun: c.accent || '#ce4806', sun600: c.accentDeep || '#9e3406' };
-  } catch { return { sun: '#ce4806', sun600: '#9e3406' }; }
+    return { sun: c.accent || '#fb9569', sun600: c.accentDeep || '#a3481a' };
+  } catch { return { sun: '#fb9569', sun600: '#a3481a' }; }
 })();
 
 // Brand styling for the standalone onboarding pages — sunrise palette + Baloo 2 /
@@ -108,7 +108,7 @@ const ACCENT = (() => {
 // under the instance's own config/branding.json). Light + dark aware; no external
 // dependency beyond an optional Google-Fonts link (system fallback if it doesn't load).
 const PAGE_STYLE = `
-:root{color-scheme:light dark;--sun:${ACCENT.sun};--sun600:${ACCENT.sun600};--coral:#fb7185;--sky:#38bdf8;--sky600:#0284c7;--ok:#16a34a;--warn:#f59e0b;--ink:#2a1f17;--inkSoft:#6b5d52;--card:#fffdfa;--line:#f0e2cf;--bg1:#fde8c8;--bg2:#fff4e6;--bg3:#fffdfa}
+:root{color-scheme:light dark;--sun:${ACCENT.sun};--sun600:${ACCENT.sun600};--sunInk:#2a1305;--coral:#fb7185;--sky:#38bdf8;--sky600:#0284c7;--ok:#16a34a;--warn:#f59e0b;--ink:#2a1f17;--inkSoft:#6b5d52;--card:#fffdfa;--line:#f0e2cf;--bg1:#fde8c8;--bg2:#fff4e6;--bg3:#fffdfa}
 @media (prefers-color-scheme:dark){:root{--ink:#f5efe6;--inkSoft:#cbbdad;--card:#241b13;--line:#3a2c1e;--bg1:#2a1d10;--bg2:#1b130b;--bg3:#130d07}}
 *{box-sizing:border-box}html,body{height:100%}
 body{margin:0;font-family:"Quicksand",system-ui,-apple-system,"Segoe UI",sans-serif;color:var(--ink);background:linear-gradient(180deg,var(--bg1) 0%,var(--bg2) 45%,var(--bg3) 100%);background-attachment:fixed;display:flex;align-items:center;justify-content:center;padding:1.5rem;-webkit-font-smoothing:antialiased;text-rendering:optimizeLegibility}
@@ -135,7 +135,7 @@ code{font-family:"Fira Code",ui-monospace,SFMono-Regular,monospace;background:rg
 @media (prefers-reduced-motion:reduce){.step.active .dot,.step.active .dot::after{animation:none}}
 .status-line{min-height:1.4em;color:var(--inkSoft);font-size:.94rem;margin:.4rem auto 0;max-width:24rem;line-height:1.45}
 .cta{margin-top:1.4rem}
-.btn{display:inline-block;background:var(--sun);color:#fff;text-decoration:none;font-weight:700;font-family:"Baloo 2",system-ui,sans-serif;padding:.72rem 1.5rem;border-radius:999px;font-size:1.02rem;box-shadow:0 10px 22px -8px rgba(249,115,22,.7);transition:transform .15s ease,box-shadow .15s ease}
+.btn{display:inline-block;background:var(--sun);color:var(--sunInk);text-decoration:none;font-weight:700;font-family:"Baloo 2",system-ui,sans-serif;padding:.72rem 1.5rem;border-radius:999px;font-size:1.02rem;box-shadow:0 10px 22px -8px rgba(249,115,22,.7);transition:transform .15s ease,box-shadow .15s ease}
 .btn:hover{transform:translateY(-1px);box-shadow:0 14px 28px -8px rgba(249,115,22,.8)}
 .muted{color:var(--inkSoft);opacity:.9;font-size:.85rem;margin:1.1rem auto 0;max-width:24rem;line-height:1.45}
 .hidden{display:none!important}