@bongos/core 1.21.4 → 1.21.6

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

@@ -0,0 +1,177 @@
+// modules/hall-ui/public/city.js — THE GOVERNOR CITY's home, wired (task
+// 1004524, goal 1000125, R02).
+//
+// city-draw.js computes the city as data; this file reads the three feeds,
+// hands them to GovCity.cityModel(), and turns its lists into DOM: SVG paths
+// for the ground and the buildings, one span per parcel (CSS offset-path) and
+// one per pin. It also owns the sun/moon switch and the stage's fit to the
+// window. No innerHTML anywhere: every node is created, and every docket string
+// lands as text or an attribute.
+//
+// THE FEEDS (all GETs, all gated server-side):
+//   /api/bongos/government/docket  the pins and the one line (task 1004523)
+//   /api/bongos/goals              the open goals: one district each
+//   /api/bongos/goals/rollups      each goal's task counts: a building per task
+// A feed that fails leaves its part of the city out (no pins, or no districts)
+// and the line says the docket could not be read; it never draws sample data.
+//
+// THE SWITCH. Light and dark use the hall's own preference ('hall-theme' in
+// localStorage, else the OS setting) and the hall's own attribute
+// (html[data-theme]), so the city opens in the mode every other hall page is
+// in, and a change here carries back to them. The drawing's faces come from
+// the mode, so a toggle redraws the city from the last feeds (no refetch).
+//
+// MOTION is CSS only (city.css); nothing here animates. The scale write on
+// resize is layout, not motion.
+
+(function () {
+  'use strict';
+  var City = window.GovCity;
+  var SVG_NS = 'http://www.w3.org/2000/svg';
+  var THEME_KEY = 'hall-theme';
+  var SUN = 'M7 1.5V3M7 11v1.5M1.5 7H3M11 7h1.5M3.1 3.1l1 1M9.9 9.9l1 1M3.1 10.9l1-1M9.9 4.1l1-1M9.5 7A2.5 2.5 0 1 1 4.5 7A2.5 2.5 0 1 1 9.5 7Z';
+  var MOON = 'M11.5 8.6A5 5 0 0 1 5.4 2.5A5 5 0 1 0 11.5 8.6Z';
+  var FEEDS = {
+    docket: '/api/bongos/government/docket',
+    goals: '/api/bongos/goals',
+    rollups: '/api/bongos/goals/rollups',
+  };
+
+  var $ = function (id) { return document.getElementById(id); };
+  var media = window.matchMedia ? window.matchMedia('(prefers-color-scheme: dark)') : null;
+  var data = { docket: null, goals: [], rollups: [], loaded: false };
+
+  // ---------- light / dark ----------
+  // A choice made on this page when storage is blocked (private mode) still
+  // holds for this page view.
+  var chosen = null;
+  function storedTheme() {
+    try { var v = window.localStorage.getItem(THEME_KEY); if (v === 'dark' || v === 'light') return v; } catch (_) { /* blocked */ }
+    return chosen;
+  }
+  function effectiveTheme() { return storedTheme() || (media && media.matches ? 'dark' : 'light'); }
+  function applyTheme() {
+    var t = effectiveTheme();
+    document.documentElement.setAttribute('data-theme', t);
+    var btn = $('cityMode');
+    var label = t === 'dark' ? 'Switch to light mode' : 'Switch to dark mode';
+    if (btn) { btn.setAttribute('aria-label', label); btn.setAttribute('title', label); }
+    var icon = $('cityModeIcon');
+    if (icon) icon.setAttribute('d', t === 'dark' ? SUN : MOON);
+    return t;
+  }
+  function toggleTheme() {
+    var next = effectiveTheme() === 'dark' ? 'light' : 'dark';
+    chosen = next;
+    try { window.localStorage.setItem(THEME_KEY, next); } catch (_) { /* private mode: this page only */ }
+    draw(applyTheme());
+  }
+
+  // ---------- fit the 1440 x 900 artboard to the window ----------
+  // 1440 x 900 is scale 1, the prototype exactly. Narrower or shorter, the
+  // city (960 px wide on the artboard) shrinks to fit; wider and taller, it grows.
+  function fit() {
+    var stage = $('cityStage');
+    if (!stage) return;
+    var w = window.innerWidth || 1440, h = window.innerHeight || 900;
+    var s = Math.min(w / 1000, h / 900);
+    stage.style.setProperty('--city-scale', String(Math.round(s * 1000) / 1000));
+  }
+
+  // ---------- the feeds ----------
+  function getJson(url) {
+    return fetch(url, { credentials: 'same-origin', headers: { accept: 'application/json' } })
+      .then(function (r) { return r && r.ok ? r.json() : null; })
+      .catch(function () { return null; });
+  }
+  function load() {
+    return Promise.all([getJson(FEEDS.docket), getJson(FEEDS.goals), getJson(FEEDS.rollups)]).then(function (res) {
+      data.docket = res[0] && Array.isArray(res[0].matters) ? res[0] : null;
+      data.goals = res[1] && Array.isArray(res[1].goals) ? res[1].goals : [];
+      data.rollups = res[2] && Array.isArray(res[2].rollups) ? res[2].rollups : [];
+      data.loaded = true;
+      draw(effectiveTheme());
+    });
+  }
+
+  // ---------- drawing ----------
+  function clear(el) { while (el && el.firstChild) el.removeChild(el.firstChild); }
+  function pathEl(p) {
+    var el = document.createElementNS(SVG_NS, 'path');
+    el.setAttribute('d', p.d);
+    el.setAttribute('fill', p.f);
+    el.setAttribute('stroke', p.s);
+    if (p.dash && p.dash !== 'none') el.setAttribute('stroke-dasharray', p.dash);
+    el.setAttribute('stroke-width', String(p.w || 1));
+    return el;
+  }
+  function span(cls) { var el = document.createElement('span'); el.className = cls; return el; }
+
+  function drawPin(pin) {
+    var el = span('city-pin city-pin--' + pin.state);
+    el.setAttribute('data-matter', pin.key);
+    el.setAttribute('data-building', pin.building);
+    el.style.left = pin.x + 'px';
+    el.style.top = pin.y + 'px';
+    el.style.height = pin.h + 'px';
+    el.style.animationDelay = pin.delay + 's';
+    var head = span('city-pin__head');
+    if (pin.state === 'needs') head.appendChild(span('city-pin__ring'));
+    var svg = document.createElementNS(SVG_NS, 'svg');
+    svg.setAttribute('width', '14');
+    svg.setAttribute('height', '14');
+    var fill = document.createElementNS(SVG_NS, 'path');
+    fill.setAttribute('d', pin.gf || '');
+    var line = document.createElementNS(SVG_NS, 'path');
+    line.setAttribute('d', pin.gl || '');
+    svg.appendChild(fill);
+    svg.appendChild(line);
+    head.appendChild(svg);
+    el.appendChild(head);
+    el.appendChild(span('city-pin__stem'));
+    return el;
+  }
+
+  function drawParcel(pc) {
+    var el = span(pc.out ? 'city-parcel city-parcel--out' : 'city-parcel');
+    el.style.offsetPath = "path('" + pc.d + "')";
+    el.style.animationDuration = pc.dur + 's';
+    el.style.animationDelay = pc.delay + 's';
+    return el;
+  }
+
+  function draw(mode) {
+    var model = City.cityModel({ docket: data.docket, goals: data.goals, rollups: data.rollups, mode: mode });
+    var flat = $('cityFlat'), blds = $('cityBlds'), parcels = $('cityParcels'), pins = $('cityPins');
+    clear(flat); clear(blds); clear(parcels); clear(pins);
+    model.flat.forEach(function (p) { flat.appendChild(pathEl(p)); });
+    model.blds.forEach(function (b) {
+      var g = document.createElementNS(SVG_NS, 'g');
+      g.setAttribute('data-key', b.key);
+      b.polys.forEach(function (p) { g.appendChild(pathEl(p)); });
+      blds.appendChild(g);
+    });
+    model.parcels.forEach(function (pc) { parcels.appendChild(drawParcel(pc)); });
+    model.pins.forEach(function (pin) { pins.appendChild(drawPin(pin)); });
+    var lineEl = $('cityLine');
+    if (lineEl && data.loaded) lineEl.textContent = model.line;
+    var stage = $('cityStage');
+    if (stage) stage.setAttribute('aria-label', model.label);
+    return model;
+  }
+
+  function boot() {
+    var start = $('cityStart');
+    if (start) start.setAttribute('href', City.STREET_HREF);
+    var btn = $('cityMode');
+    if (btn) btn.addEventListener('click', toggleTheme);
+    if (media && media.addEventListener) media.addEventListener('change', function () { if (!storedTheme()) draw(applyTheme()); });
+    window.addEventListener('resize', fit);
+    fit();
+    draw(applyTheme());
+    return load();
+  }
+
+  window.GovCityPage = { boot: boot, draw: draw, load: load, fit: fit, FEEDS: FEEDS, THEME_KEY: THEME_KEY };
+  window.GovCityPage.ready = boot();
+}());

package/modules/hall-ui/public/city.states.json

@@ -0,0 +1,30 @@
+{
+  "_": "THE GOVERNOR CITY's home (task 1004524, goal 1000125) through modules/ui-design/kit/render.js. The page draws GET /government/docket, GET /goals and GET /goals/rollups; against the kit's own stub none exists, so every state renders the city with no districts and no pins and the line saying the docket could not be read: a real state the floors must hold in. To look at the populated city, run it against the hall-preview harness, whose government__docket.json fixture carries the reference design's seven sample matters (3 need you, 2 moving, 2 settled) and whose goals fixtures carry the open goals:\n\n  node scripts/hall-preview/server.js --port 4624 --fixture-me\n  node modules/ui-design/kit/render.js --states modules/hall-ui/public/city.states.json --base-in http://localhost:4624 --base-out http://localhost:4624\n\nThe page follows the OS mode until the switch is pressed (then the hall's own 'hall-theme' preference), so the kit's dark/light emulation renders both modes.",
+  "page": "/builders/city",
+  "surface": "hall-ui",
+  "stub": { "prefix": "/builders/" },
+  "modeQuery": false,
+  "ignoreRequests": ["/api/(gds|bongos)/", "fonts\\.g(oogleapis|static)\\.com"],
+  "ignoreConsole": ["/api/(gds|bongos)/", "\\b401\\b", "\\b403\\b", "\\b404\\b", "Unauthorized", "Forbidden", "Not Found", "load failed", "fonts\\.g(oogleapis|static)\\.com"],
+  "states": {
+    "city": {
+      "auth": true,
+      "_": "The home: the wordmark, the switch, the city, start governing and the one line.",
+      "actions": [["wait", 900]],
+      "expect": { "visible": ["#cityStage", "#cityStart", "#cityLine", "#cityMode"], "href": [["#cityStart", "/builders/street"]] }
+    },
+    "switched": {
+      "auth": true,
+      "_": "The sun/moon switch pressed once: the other mode, the city redrawn in it.",
+      "actions": [["wait", 600], ["click", "#cityMode"], ["wait", 400]],
+      "expect": { "visible": ["#cityStage", "#cityStart"] }
+    },
+    "focus": {
+      "auth": true,
+      "_": "Keyboard: the start button focused, its ring drawn.",
+      "actions": [["wait", 600], ["focus", "#cityStart"], ["wait", 100]],
+      "expect": { "activeId": "cityStart" }
+    }
+  },
+  "reducedMotion": { "auth": true, "actions": [["wait", 600]] }
+}

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

@@ -259,8 +259,10 @@
   // decides what dead means and the route attaches it — so this page and any
   // future alert cannot drift into two definitions of the same word. These are
   // only the order to pick the runner to describe in, and the colour of its dot.
-  const HEALTH_RANK = { alive: 0, late: 1, restarting: 2, dead: 3, never_seen: 4 };
-  const HEALTH_DOT = { alive: 'ok', late: 'ok', restarting: 'info', dead: 'danger', never_seen: 'info' };
+  // idle_config (task 1004539): talking, but idle on a setting the owner can fix —
+  // it carries the fix as `remedy`, and draws as a warning, never as "ok".
+  const HEALTH_RANK = { alive: 0, late: 1, idle_config: 2, restarting: 3, dead: 4, never_seen: 5 };
+  const HEALTH_DOT = { alive: 'ok', late: 'ok', idle_config: 'warn', restarting: 'info', dead: 'danger', never_seen: 'info' };
 
   // The panel is drawn from both reads at once; each is kept so a write that only
   // reloads one of them redraws with the other's last answer.
@@ -284,7 +286,7 @@
   // `project`, and then there is no second layer to check.
   function readiness(runner, fence, mine) {
     const h = (runner && runner.health) || {};
-    const connected = ['alive', 'late', 'restarting'].includes(h.state);
+    const connected = ['alive', 'late', 'restarting', 'idle_config'].includes(h.state);
     const goals = (fence && fence.goals) || [];
     const items = [];
     if (!runner) {
@@ -316,6 +318,11 @@
     if (mine && fence && fence.enabled && mine.enabled === false && (mine.goals || []).length) {
       items.push({ key: 'mine-stop', state: 'todo', text: 'Your runner is held', hint: mine.paused_reason || 'It is not allowed to take work right now.' });
     }
+    // The runner's own word that a setting is holding it (task 1004539) — the one
+    // the fence read cannot see: an unreadable fence or a gauge with no reading.
+    if (h.state === 'idle_config') {
+      items.push({ key: 'config-idle', state: 'todo', text: h.why ? `Idle because ${h.why}` : 'Idle because of a setting', hint: h.remedy || '' });
+    }
     return { items, ready: !items.some((i) => i.state === 'todo') };
   }
 
@@ -535,7 +542,7 @@
       : 'has picked no goals, so their runner takes no work';
     const beats = (b.runners || []).map((r) => {
       const h = r.health || {};
-      const label = { dead: 'not checking in', late: 'quiet', alive: 'checking in', restarting: 'restarting' }[h.state] || 'unknown';
+      const label = { dead: 'not checking in', late: 'quiet', alive: 'checking in', restarting: 'restarting', idle_config: `idle on a setting — ${h.remedy || 'see Settings'}` }[h.state] || 'unknown';
       return `<span class="ov-fact"><span class="rn-dot rn-dot--sm rn-dot--${HEALTH_DOT[h.state] || 'info'}" aria-hidden="true"></span> ${escapeHtml(h.host || r.host || '')} ${escapeHtml(label)}</span>`;
     }).join('');
     const paused = b.owner_paused === true;

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

@@ -97,8 +97,8 @@
         + '<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>'
+    return '<p class="scroll__lede">Settle the plan and each stage becomes real tasks. '
+      + 'Everything is preset to our recommendation, so one click is enough.</p>'
       + '<ol class="genesis__plan">' + rows + '</ol>'
       + '<div class="genesis__picks">'
       + governmentHtml(gov)
@@ -108,9 +108,9 @@
       + '</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)
+      + radio('advisors', 'cbaas', 'Cloud Bongos advisors', 'Our consultants 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>'
+      + '<label class="genesis__check"><input type="checkbox" data-existing> It already exists, so gather what it has first</label>'
       + '</div>'
       + '<div class="genesis__doors"><button type="button" class="btn-accent" data-genesis-plan>Use this plan</button></div>';
   }
@@ -208,7 +208,7 @@
     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>';
+    return '<p class="genesis__note">Finish every task above, then put this stage to the board.</p>';
   }
 
   function aliveHtml() {
@@ -217,8 +217,7 @@
       + '<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>'
+      + '<p class="scroll__lede">Every room in the hall is open now. 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>';
   }
 
@@ -234,9 +233,9 @@
     var d = g.demo;
     if (!d) return '';
     var total = g.stages.reduce(function (n, s) { return n + (s.minutes || 0); }, 0);
-    return '<p class="scroll__lede">A demo’s genesis is short: about ' + esc(String(total)) + ' minutes, then the rest of your time is for building. '
-      + 'The plan is already set from your demo: Monarchy / BDFL, ' + esc(String(d.people)) + (d.people === 1 ? ' person, ' : ' people, ')
-      + esc(String(d.hours_each)) + (d.hours_each === 1 ? ' hour' : ' hours') + ' each. Finish each stage’s task, then approve it to move on.</p>';
+    return '<p class="scroll__lede">Your demo’s genesis takes about ' + esc(String(total)) + ' min. '
+      + 'The plan is set: Monarchy / BDFL, ' + esc(String(d.people)) + (d.people === 1 ? ' person, ' : ' people, ')
+      + esc(String(d.hours_each)) + (d.hours_each === 1 ? ' hour' : ' hours') + ' each. Finish each stage’s task, then approve it.</p>';
   }
 
   function render(host, state) {

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

@@ -276,3 +276,7 @@
 @media (max-width: 640px) {
   .pg-ba { grid-template-columns: minmax(0, 1fr); }
 }
+
+/* The cross-project section's second band (task 1004440): each craft's own
+   numbers under the totals, the same glass, held apart by the scroll's own gap. */
+#xp-scroll .stat-row--craft { margin-top: 12px; }

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

@@ -331,6 +331,29 @@
     return `<tr><td>${nameCell}</td><td>${held}</td></tr>`;
   }
 
+  // Each craft's own numbers across every project (task 1004440 / WA6.RP10): an
+  // artist's approved pages and an ideator's thoughts, so neither reads on the hub
+  // as an engineer with nothing shipped. The hub sends a craft only once the
+  // builder has earned credits in it, so an absent craft has no tile. A count no
+  // project could report is a dash, never 0 ("could not ask" is not "nothing
+  // there"). The words are the role-shaped profile's own (profile-roles.js).
+  function xpCount(n) {
+    return Number.isInteger(n) && n >= 0 ? fmtNum(n) : '—';
+  }
+  function xpCraftTiles(crafts) {
+    if (!crafts || typeof crafts !== 'object') return '';
+    const out = [];
+    const artist = crafts.artist;
+    if (artist && typeof artist === 'object') out.push(tile('Pages approved', xpCount(artist.pages_approved), 'as an artist'));
+    const ideator = crafts.ideator;
+    if (ideator && typeof ideator === 'object') {
+      out.push(tile('Thoughts filed', xpCount(ideator.filed), 'as an ideator'));
+      const ratified = Number.isInteger(ideator.ratified) ? `${fmtNum(ideator.ratified)} ratified by the board` : '';
+      out.push(tile('Full Ideas', xpCount(ideator.full_ideas), ratified));
+    }
+    return out.length ? `<div class="stat-row stat-row--craft">${out.join('')}</div>` : '';
+  }
+
   function renderCrossProject(data, selfId) {
     const section = $('#xp-scroll');
     const body = $('#xp-body');
@@ -357,7 +380,8 @@
       tile('Works shipped', fmtNum(t.works_shipped)) +
       tile('Credits', fmtNum(t.credits)) +
       tile('Karma', fmtNum(t.karma)) +
-      `</div>`;
+      `</div>` +
+      xpCraftTiles(cp.crafts);
     const discs = Array.isArray(cp.disciplines) ? cp.disciplines.filter((d) => typeof d === 'string') : [];
     const metaBits = [];
     if (discs.length) metaBits.push(`${window.OTB.roleAxisLabel()}s: ${discs.map((d) => window.OTB.roleLabel(d)).join(', ')}`);

package/modules/hall-ui/public/settings-autobongos.js

@@ -38,6 +38,14 @@
     const project = fence.project || {};
     const scope = fence.scope || {};
     const out = [];
+    // First, because it is the one that has already cost time: a runner of yours
+    // that has been idle on a setting past its grace (task 1004539). The verdict
+    // and the fix are the server's (runner-health.js); this only draws them.
+    for (const r of myRunners) {
+      const h = r.health || {};
+      if (h.state !== 'idle_config') continue;
+      out.push(`<strong>Your runner${h.host ? ` on ${escapeHtml(h.host)}` : ''} is idle</strong> because ${escapeHtml(h.why || 'of a setting')}. ${escapeHtml(h.remedy || '')}`);
+    }
     if (project.enabled !== true) {
       out.push(`The project's runner switch is off right now${project.paused_reason ? `: ${escapeHtml(project.paused_reason)}` : ''}. Your choices are kept and apply when it is back on.`);
     }
@@ -62,6 +70,16 @@
   }
   const goalLabel = (id) => goalNames.get(Number(id)) || `Goal ${id}`;
 
+  // The caller's own runners, with the server's health verdict attached. Best-
+  // effort like the names: a failed read just means no runner warning is drawn.
+  let myRunners = [];
+  async function loadMyRunners() {
+    try {
+      const res = await api.request('GET', `${API}/autonomy/runners`);
+      if (res.ok && res.data && Array.isArray(res.data.runners)) myRunners = res.data.runners;
+    } catch (_) { /* the picker works without it */ }
+  }
+
   function render(fence) {
     const body = $('#autobongos-body');
     if (!body) return;
@@ -138,7 +156,7 @@
     const section = $('#autobongos-scroll');
     if (!section) return;
     try {
-      const [fence] = await Promise.all([load(), loadGoalNames()]);
+      const [fence] = await Promise.all([load(), loadGoalNames(), loadMyRunners()]);
       if (!fence) return;
       render(fence);
       section.hidden = false;

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

@@ -327,3 +327,29 @@ select.voices__select { min-width: 140px; }
   text-underline-offset: 3px;
 }
 .su-entries a:hover { color: var(--ink); text-decoration-color: currentColor; }
+
+/* ---- MAIN ROLE (task 1004541) -------------------------------------------- */
+/* A sub-group of Preferred roles: the shell's chip control with a RADIO in it.
+   The 24px target and 14px drawn mark are panel.css's; only the shape changes
+   (a ring, and a dot when chosen), so a choice of one never reads as a tick. */
+.craft-main { border: 0; margin: var(--sp-sm) 0 0; padding: 0; min-width: 0; }
+.craft-main__h {
+  padding: 0;
+  font-family: var(--label-face);
+  font-size: var(--label-size);
+  letter-spacing: var(--label-space);
+  text-transform: var(--label-case);
+  color: var(--ink-faint);
+}
+.craft-main__lede { margin: 6px 0 0; font-size: 13.5px; color: var(--ink-soft); max-width: 62ch; }
+.craft-main .chip-ctl input::before { border-radius: 50%; }
+.craft-main .chip-ctl input:checked::after {
+  left: 9px;
+  top: 9px;
+  width: 6px;
+  height: 6px;
+  border: 0;
+  border-radius: 50%;
+  background: var(--accent-on);
+  transform: none;
+}

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

@@ -118,6 +118,14 @@
                 choices — pick one, several, or none.
               </p>
               <div class="craft-chips" id="craft-chips"></div>
+              <!-- MAIN ROLE (task 1004541): which of the roles above leads your
+                   profile, its tabs and your leaderboard entry. Saved with the
+                   chips, in the same PATCH (main_discipline). -->
+              <fieldset class="craft-main" id="craft-main">
+                <legend class="craft-main__h">Main role</legend>
+                <p class="craft-main__lede">Your main role leads your profile and your leaderboard entry. Let your work decide, and it is the role you have earned the most in.</p>
+                <div class="chips" id="craft-main-opts"></div>
+              </fieldset>
               <div class="craft-actions">
                 <button type="button" class="craft-save" id="craft-save">Save</button>
                 <span class="settings-status" id="craft-status" role="status" aria-live="polite"></span>

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

@@ -516,7 +516,10 @@
 
   // Current selection mutated in place as the builder toggles chips; saved on
   // the "Save" button (the hall's profile card behaviour) via PATCH.
-  const craft = { selected: new Set() };
+  // `main` (task 1004541) is the builder's chosen MAIN role, one of the ticked
+  // roles, or null for "let my work decide" (the profile then leads with the
+  // craft earned most in — src/bongos/role-stats.js resolveMainRole).
+  const craft = { selected: new Set(), main: null };
 
   function renderCraft() {
     const wrap = $('#craft-chips');
@@ -529,6 +532,29 @@
         `${escapeHtml(window.OTB.roleLabel(d))}</label>`
       );
     }).join('');
+    renderCraftMain();
+  }
+
+  // The main-role choice: "Let my work decide", then each role ticked above. A
+  // role can only lead once it is one of your roles (the server refuses
+  // otherwise), so unticking the main role hands the choice back to your work —
+  // the same thing the server does when that role leaves the set.
+  const MAIN_BY_WORK = 'Let my work decide';
+  function renderCraftMain() {
+    const wrap = $('#craft-main-opts');
+    if (!wrap) return;
+    if (craft.main && !craft.selected.has(craft.main)) craft.main = null;
+    const opts = [{ value: '', label: MAIN_BY_WORK }].concat(
+      DISCIPLINES.filter((d) => craft.selected.has(d)).map((d) => ({ value: d, label: window.OTB.roleLabel(d) })),
+    );
+    wrap.innerHTML = opts.map((o) => {
+      const on = (craft.main || '') === o.value;
+      return (
+        `<label class="chip-ctl craft-main__opt">` +
+        `<input type="radio" name="craft-main" class="craft-main-pick" value="${escapeHtml(o.value)}"${on ? ' checked' : ''}>` +
+        `${escapeHtml(o.label)}</label>`
+      );
+    }).join('');
   }
 
   async function saveCraft() {
@@ -538,7 +564,10 @@
     if (btn) { btn.disabled = true; btn.textContent = 'Saving…'; }
     if (status) status.textContent = '';
     try {
-      const res = await api.request('PATCH', `${API}/me/disciplines`, { body: { preferred_disciplines: selected } });
+      const main = craft.main && selected.includes(craft.main) ? craft.main : null;
+      const res = await api.request('PATCH', `${API}/me/disciplines`, {
+        body: { preferred_disciplines: selected, main_discipline: main },
+      });
       if (res.status === 401) { toAuth(); return; }
       if (!res.ok) throw new Error(`disciplines PATCH → ${res.status}`);
       const data = res.data;
@@ -547,8 +576,10 @@
         ? data.builder.preferred_disciplines
         : selected;
       craft.selected = new Set(prefs.filter((d) => DISCIPLINES.includes(d)));
+      craft.main = data?.builder && 'main_discipline' in data.builder ? (data.builder.main_discipline || null) : main;
       renderCraft();
-      const msg = selected.length ? `Preferred work: ${selected.join(', ')}.` : 'Preference cleared.';
+      const leads = craft.main ? ` Main role: ${window.OTB.roleLabel(craft.main)}.` : '';
+      const msg = (selected.length ? `Preferred work: ${selected.join(', ')}.` : 'Preference cleared.') + leads;
       if (status) status.textContent = msg;
       toast(msg);
     } catch (err) {
@@ -570,6 +601,14 @@
         else craft.selected.delete(box.value);
         const chip = box.closest('.craft-chip');
         if (chip) chip.dataset.on = box.checked ? '1' : '0';
+        renderCraftMain();
+      });
+    }
+    const mainWrap = $('#craft-main-opts');
+    if (mainWrap) {
+      mainWrap.addEventListener('change', (e) => {
+        const pick = e.target.closest('.craft-main-pick');
+        if (pick) craft.main = pick.value || null;
       });
     }
     const btn = $('#craft-save');
@@ -1176,6 +1215,7 @@
     // Seed craft state from the /me payload, then render + reveal that section.
     const prefs = Array.isArray(builder.preferred_disciplines) ? builder.preferred_disciplines : [];
     craft.selected = new Set(prefs.filter((d) => DISCIPLINES.includes(d)));
+    craft.main = typeof builder.main_discipline === 'string' ? builder.main_discipline : null;
     renderCraft();
     wireCraft();
     $('#craft-scroll').hidden = false;

package/modules/ideas/governor-docket.js

@@ -0,0 +1,93 @@
+'use strict';
+
+// modules/ideas/governor-docket.js — the ideas module's part of the governor's
+// docket (task 1004523, goal 1000125; collector: modules/government/docket.js,
+// decision: ADR 0362).
+//
+// WHY. Two things the Governor City shows live here. Open BLOCKERS stand at
+// Planning ("waiting on a decision"). And the "rules at work" reading — matters
+// settled by a rule, without a vote — is the idea ROUTING rule (routing.js, the
+// landing matrix): a filing that has a home lands in its goal at filing time
+// instead of waiting for a triage vote, and each one leaves an
+// `ideas_task_lineage` row with origin 'route'. That count is the honest answer
+// to "what did the rules settle this month"; the design's other standing rules
+// do not exist yet and are not counted.
+//
+// A module may not require a sibling (ADR 0083), so this is contributed to the
+// `governor.docket` point from the blockers route factory rather than reached
+// for by government. Pure mappers exported for tests/governor_docket.mjs.
+
+const api = require('../../src/module-api');
+const blockers = require('./blockers');
+
+const POINT = 'governor.docket';
+const DOCKET_BLOCKER_LIMIT = 50;
+
+// One open blocker for one viewer. The list is public (GET /blockers), so every
+// governor sees it; only a viewer who may resolve it (`blocker.review`, the
+// resolve route's atom) is told it needs them — for anyone else it is moving.
+function blockerDocketMatter(b, mayResolve) {
+  const holds = Array.isArray(b.blocking_task_ids) ? b.blocking_task_ids.length : 0;
+  return {
+    id: b.id,
+    rule: 'decide',
+    state: mayResolve ? 'needs' : 'moving',
+    title: b.title,
+    short: 'blocker',
+    where: holds ? `planning · holds ${holds} ${holds === 1 ? 'task' : 'tasks'}` : 'planning · waiting on a decision',
+    opened_at: b.created_at,
+    deadline: null,
+    proposer: null,
+    tally: null,
+    href: `/blockers#blocker-${b.id}`,
+    ref: { type: 'blocker', id: b.id },
+  };
+}
+
+// The rules-at-work reading from this month's routed filings. Pure.
+function rulesReading(settledThisMonth) {
+  const n = Number(settledThisMonth) || 0;
+  return {
+    value: { rules: 1, settled_this_month: n },
+    figure: '1 rule',
+    line: n
+      ? `the landing rule settled ${n} ${n === 1 ? 'filing' : 'filings'} this month without a vote`
+      : 'the landing rule settled nothing this month',
+    hot: false,
+  };
+}
+
+// Filings the routing rule landed this month (origin 'route').
+async function countRoutedThisMonth() {
+  const { rows } = await api.pool.query(
+    `SELECT count(*)::int AS n FROM ideas_task_lineage
+      WHERE origin = 'route' AND created_at >= date_trunc('month', now())`,
+  );
+  return rows[0] ? rows[0].n : 0;
+}
+
+function contributeIdeasToDocket() {
+  api.contribute(POINT, {
+    source: 'blockers',
+    building: 'planning',
+    gate: { anyBuilder: true },
+    read: async (ctx) => {
+      const rows = await blockers.listOpenBlockers({ limit: DOCKET_BLOCKER_LIMIT, offset: 0 });
+      const mayResolve = ctx.has('blocker.review');
+      return rows.map((b) => blockerDocketMatter(b, mayResolve));
+    },
+  });
+  // A count, no rows: any builder may read it.
+  api.contribute(POINT, {
+    reading: 'rules',
+    gate: { anyBuilder: true },
+    read: async () => rulesReading(await countRoutedThisMonth()),
+  });
+}
+
+module.exports = {
+  contributeIdeasToDocket,
+  blockerDocketMatter,
+  rulesReading,
+  countRoutedThisMonth,
+};

package/modules/ideas/routes/blockers.js

@@ -27,7 +27,12 @@ const api = require('../../../src/module-api');
 const blockers = require('../blockers');
 const { validateOrRespond, LIMITS, parseId } = api;
 
+// The governor's docket (task 1004523): open blockers + the rules-at-work
+// reading, contributed from this factory (see ../governor-docket.js).
+const governorDocket = require('../governor-docket');
+
 module.exports = function buildBlockersRouter() {
+  governorDocket.contributeIdeasToDocket();
   const router = express.Router();
 
   // List currently-open blockers + the tasks each is blocking.