@bongos/core 1.21.43 → 1.21.45

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

@@ -91,9 +91,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/atlas.js?v=2026-09-02-index" defer></script>

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

@@ -50,9 +50,9 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB — rank labels, number formats) + the

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

@@ -60,9 +60,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-board"></script>

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

@@ -40,9 +40,11 @@
 //  * Review. The prototype's story opens with Review a vacant lot; in this
 //    project Review is held (the grader and the testers sign work off), so the
 //    held recipe is drawn and the parcels leave through Release.
-//  * Pins. A building can hold more matters than the prototype's one; up to
-//    three pins stand side by side over it (needs first, the docket's own
-//    order), and the line under the button carries the full counts.
+//  * Pins (task 1004569). A building can hold more matters than the prototype's
+//    one, and three pins abreast crowded each other; now ONE pin stands over a
+//    building, where the prototype stands its pin, in the importance tier of
+//    its most important matter (buildingPin below, shared with the street so
+//    both views agree), with a count when more than one matter is open there.
 
 (function (root) {
   'use strict';
@@ -244,7 +246,6 @@
     Object.freeze({ x0: 12, x1: 15, y0: 12, y1: 15, tall: 60, route: null }),
   ]);
   const MAX_DISTRICTS = BASE_LOTS.length * 2;
-  const MAX_PINS_PER_BUILDING = 3;
 
   function halve(L) {
     const w = L.x1 - L.x0 + 1, h = L.y1 - L.y0 + 1;
@@ -327,6 +328,39 @@
     return state === 'needs' || state === 'moving' || state === 'settled' ? state : 'moving';
   }
 
+  // ---------- importance tiers (task 1004569) ----------
+  // One pin per building, in the tier of its most important matter, so the city
+  // and the street read the same at a glance. Colour AND size carry the tier
+  // (city.css, street.css), so it also reads without colour:
+  //   urgent   needs you and due within 24 hours (or overdue): largest, orange, pulsing
+  //   needs    needs you: orange, medium (the prototype's pin)
+  //   moving   others are deciding: ink, small
+  //   settled  settled recently: a small grey dot, no label, no count
+  const TIERS = Object.freeze(['urgent', 'needs', 'moving', 'settled']);
+  const URGENT_MS = 24 * 3600 * 1000;
+  function matterTier(m, now) {
+    const st = pinState(m && m.state);
+    if (st !== 'needs') return st;
+    const t = m.deadline ? Date.parse(m.deadline) : NaN;
+    return Number(now) > 0 && isFinite(t) && t - Number(now) <= URGENT_MS ? 'urgent' : 'needs';
+  }
+  // A building's matters → its one pin: the tier of the most important, the
+  // count of the open ones (settled is not open), and every matter, most
+  // important first (the docket's own order inside a tier), for the card pager.
+  function buildingPin(matters, now) {
+    const ranked = (Array.isArray(matters) ? matters : []).filter(Boolean)
+      .map((m, i) => ({ m: m, t: matterTier(m, now), i: i }))
+      .sort((a, b) => TIERS.indexOf(a.t) - TIERS.indexOf(b.t) || a.i - b.i);
+    if (!ranked.length) return null;
+    return { tier: ranked[0].t, top: ranked[0].m, count: ranked.filter((r) => r.t !== 'settled').length, matters: ranked.map((r) => r.m) };
+  }
+  // What a pin says to a screen reader: '3 open at charter, the first needs you within a day'.
+  const TIER_WORDS = Object.freeze({ urgent: 'needs you within a day', needs: 'needs you', moving: 'is moving without you', settled: 'is settled' });
+  function pinAria(building, bp) {
+    const lead = bp.count > 1 ? bp.count + ' open at ' + building + ', the first ' : bp.count === 1 ? 'One open at ' + building + ': it ' : 'At ' + building + ': ';
+    return lead + TIER_WORDS[bp.tier] + '. ' + String(bp.top.title || bp.top.short || '');
+  }
+
   // The home line, when the docket could not be read.
   const FALLBACK_LINE = 'the docket could not be read just now';
 
@@ -335,6 +369,7 @@
   //   goals    GET /goals goals[] (any status; only 'open' ones are drawn)
   //   rollups  GET /goals/rollups rollups[] (goal_id → task counts)
   //   mode     'dark' | 'light'
+  //   now      ms since the epoch (a deadline inside a day is urgent)
   function cityModel(input) {
     const opts = input || {};
     const docket = opts.docket && typeof opts.docket === 'object' ? opts.docket : null;
@@ -385,7 +420,7 @@
     });
     blds.sort((a, b) => a.depth - b.depth);
 
-    // a pin over each open matter's building (up to three abreast)
+    // one pin over each building with a matter, in its most important matter's tier
     const slotOf = {};
     CIVIC_SLOTS.forEach((s) => { slotOf[s[0]] = s; });
     const matters = docket && Array.isArray(docket.matters) ? docket.matters : [];
@@ -397,14 +432,16 @@
     const pins = [];
     let n = 0;
     CIVIC_SLOTS.forEach((s) => {
-      const here = (atBuilding[s[0]] || []).slice(0, MAX_PINS_PER_BUILDING);
+      const bp = buildingPin(atBuilding[s[0]], opts.now);
+      if (!bp) return;
       const top = P(s[1] + 1, s[2] + 1, ROOF[s[0]] + 8);
-      here.forEach((m, i) => {
-        const g = glyph(m.rule, 7, 7, 13);
-        const dx = (i - (here.length - 1) / 2) * 26;
-        pins.push({ key: String(m.id), building: s[0], state: pinState(m.state), title: String(m.short || m.title || ''), x: r1(top[0] - 15 + dx), y: r1(top[1] - 52), h: 52, gf: g.fill, gl: g.line, delay: -(n * 0.9) });
-        n += 1;
+      const m = bp.top;
+      const g = glyph(m.rule, 7, 7, 13);
+      pins.push({
+        key: String(m.id), building: s[0], state: bp.tier, count: bp.tier === 'settled' ? 0 : bp.count, matters: bp.matters.map((x) => String(x.id)),
+        title: String(m.short || m.title || ''), aria: pinAria(s[0], bp), x: r1(top[0] - 15), y: r1(top[1] - 52), h: 52, gf: g.fill, gl: g.line, delay: -(n * 0.9),
       });
+      n += 1;
     });
 
     // work on the move: parcels ride the ring road to Review, and leave through Release
@@ -423,7 +460,7 @@
 
     const line = docket && docket.line ? String(docket.line) : FALLBACK_LINE;
     const pinCount = { needs: 0, moving: 0, settled: 0 };
-    pins.forEach((p) => { pinCount[p.state] += 1; });
+    pins.forEach((p) => { pinCount[p.state === 'urgent' ? 'needs' : p.state] += 1; });
     const label = 'The governor city: the nine civic buildings round the plaza and '
       + (districts.length === 1 ? 'one district' : districts.length + ' districts') + ', one for each open goal'
       + (pins.length ? '. Pins: ' + pinCount.needs + ' need you, ' + pinCount.moving + ' moving, ' + pinCount.settled + ' settled.' : '.');
@@ -439,7 +476,8 @@
     isoTheme: isoTheme, isoKit: isoKit, isoBox: isoBox, isoGable: isoGable, isoHip: isoHip, isoSaw: isoSaw,
     isoTree: isoTree, isoLight: isoLight, isoInstitution: isoInstitution, isoWork: isoWork, glyph: glyph, rnd: rnd,
     lotsFor: lotsFor, districtWork: districtWork, cityModel: cityModel, rulesAtWork: rulesAtWork,
-    CIVIC_SLOTS: CIVIC_SLOTS, ROOF: ROOF, BASE_LOTS: BASE_LOTS, MAX_DISTRICTS: MAX_DISTRICTS, MAX_PINS_PER_BUILDING: MAX_PINS_PER_BUILDING,
+    matterTier: matterTier, buildingPin: buildingPin, pinAria: pinAria, TIERS: TIERS, URGENT_MS: URGENT_MS,
+    CIVIC_SLOTS: CIVIC_SLOTS, ROOF: ROOF, BASE_LOTS: BASE_LOTS, MAX_DISTRICTS: MAX_DISTRICTS,
     FALLBACK_LINE: FALLBACK_LINE, STREET_HREF: STREET_HREF,
   };
   root.GovCity = api;

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

@@ -84,8 +84,15 @@ html[data-fullscreen="on"] .city-top { right: 184px; }
 .city-pin__head path + path { fill: none; stroke: currentColor; stroke-width: 1.2; }
 .city-pin__stem { width: 0; flex-grow: 1; border-left: 1px solid transparent; }
 .city-pin__ring { position: absolute; inset: -1px; border-radius: 999px; border: 1px solid var(--accent); }
-.city-pin--needs .city-pin__head { background: var(--accent); color: var(--accent-on); box-shadow: var(--city-glow); }
-.city-pin--needs .city-pin__stem { border-left-color: color-mix(in srgb, var(--accent) 60%, transparent); }
+/* importance tiers (task 1004569): colour AND size, so a tier reads without colour.
+   urgent 26 > needs 22 (the prototype's) > moving 16 > settled 8, a plain dot */
+.city-pin--urgent .city-pin__head, .city-pin--needs .city-pin__head { background: var(--accent); color: var(--accent-on); box-shadow: var(--city-glow); }
+.city-pin--urgent .city-pin__head { width: 26px; height: 26px; }
+.city-pin--urgent .city-pin__stem, .city-pin--needs .city-pin__stem { border-left-color: color-mix(in srgb, var(--accent) 60%, transparent); }
+.city-pin--moving .city-pin__head { width: 16px; height: 16px; }
+.city-pin--moving .city-pin__head svg { width: 10px; height: 10px; }
+.city-pin--settled .city-pin__head { width: 8px; height: 8px; margin-top: 14px; }
+.city-pin__count { position: absolute; top: -6px; right: -9px; min-width: 14px; height: 14px; padding: 0 3px; box-sizing: border-box; border-radius: 999px; background: var(--bg-card); color: var(--ink); border: 1px solid currentColor; font-size: 9.5px; font-weight: 600; line-height: 12px; text-align: center; font-variant-numeric: tabular-nums; }
 .city-pin--moving .city-pin__head { background: var(--ink); color: var(--bg-card); }
 .city-pin--moving .city-pin__stem { border-left-color: color-mix(in srgb, var(--ink) 45%, transparent); }
 .city-pin--settled .city-pin__head { background: color-mix(in srgb, var(--ink) 10%, var(--bg)); border: 1px solid color-mix(in srgb, var(--ink) 22%, transparent); color: var(--ink-faint); }

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

@@ -12,7 +12,7 @@
        (tests/hall_tokens.mjs: no hall page hardcodes a web-font stylesheet).
        The prototype carried its own Google Fonts link for the same two faces. -->
   <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
-  <link rel="stylesheet" href="/builders/city.css?v=2026-10-02-city1">
+  <link rel="stylesheet" href="/builders/city.css?v=2026-10-04-pins1">
 </head>
 <!-- THE GOVERNOR CITY, HOME (task 1004524, goal 1000125, R02). The home view
      of docs/design/mocks/governor-city/Street.dc.html (homeView and the home
@@ -83,11 +83,11 @@
   </div>
 </div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <script src="/builders/palette.js" defer></script>
-<script src="/builders/city-draw.js?v=2026-10-02-city1"></script>
-<script src="/builders/city.js?v=2026-10-02-city1"></script>
+<script src="/builders/city-draw.js?v=2026-10-04-pins1"></script>
+<script src="/builders/city.js?v=2026-10-04-pins1"></script>
 </body>
 </html>

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

@@ -132,22 +132,33 @@
     var el = span('city-pin city-pin--' + pin.state);
     el.setAttribute('data-matter', pin.key);
     el.setAttribute('data-building', pin.building);
+    if (pin.aria) el.setAttribute('title', pin.aria);
     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);
+    // only the urgent tier pulses; a settled pin is a plain grey dot, no mark (task 1004569)
+    if (pin.state === 'urgent') head.appendChild(span('city-pin__ring'));
+    if (pin.state !== 'settled') {
+      var svg = document.createElementNS(SVG_NS, 'svg');
+      svg.setAttribute('width', '14');
+      svg.setAttribute('height', '14');
+      svg.setAttribute('viewBox', '0 0 14 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);
+    }
+    // the count of the building's open matters, when there is more than one
+    if (pin.count > 1) {
+      var badge = span('city-pin__count');
+      badge.textContent = String(pin.count);
+      head.appendChild(badge);
+    }
     el.appendChild(head);
     el.appendChild(span('city-pin__stem'));
     return el;
@@ -162,7 +173,7 @@
   }
 
   function draw(mode) {
-    var model = City.cityModel({ docket: data.docket, goals: data.goals, rollups: data.rollups, mode: mode });
+    var model = City.cityModel({ docket: data.docket, goals: data.goals, rollups: data.rollups, mode: mode, now: Date.now() });
     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)); });

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

@@ -2,35 +2,169 @@
   "_": "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/" },
+  "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"],
+  "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", "#app-topbar", "#fullscreen-toggle"], "href": [["#cityStart", "/builders/street"]] }
+      "actions": [
+        [
+          "wait",
+          900
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#cityStage",
+          "#cityStart",
+          "#cityLine",
+          "#cityMode",
+          "#app-topbar",
+          "#fullscreen-toggle"
+        ],
+        "href": [
+          [
+            "#cityStart",
+            "/builders/street"
+          ]
+        ]
+      }
     },
     "fullscreen": {
       "auth": true,
       "_": "In the hall since task 1004544: the shell's full-screen switch pressed, the sidebar and the top bar gone, the city filling the window and the one exit in the corner (the sky's mechanism, task 1004327).",
-      "actions": [["wait", 900], ["click", "#fullscreen-toggle"], ["wait", 500]],
-      "expect": { "visible": ["#cityStage", "#cityStart", "#cityMode", "#fullscreen-toggle"], "hidden": ["#app-sidebar", "#topbar-title"], "attr": [["#fullscreen-toggle", "aria-pressed", "true"]] }
+      "actions": [
+        [
+          "wait",
+          900
+        ],
+        [
+          "click",
+          "#fullscreen-toggle"
+        ],
+        [
+          "wait",
+          500
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#cityStage",
+          "#cityStart",
+          "#cityMode",
+          "#fullscreen-toggle"
+        ],
+        "hidden": [
+          "#app-sidebar",
+          "#topbar-title"
+        ],
+        "attr": [
+          [
+            "#fullscreen-toggle",
+            "aria-pressed",
+            "true"
+          ]
+        ]
+      }
     },
     "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"] }
+      "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" }
+      "actions": [
+        [
+          "wait",
+          600
+        ],
+        [
+          "focus",
+          "#cityStart"
+        ],
+        [
+          "wait",
+          100
+        ]
+      ],
+      "expect": {
+        "activeId": "cityStart"
+      }
+    },
+    "pins": {
+      "auth": true,
+      "_": "The home city over the dense docket with the same pin tiers as the street (task 1004569): one pin per building, urgent largest and pulsing, needs you orange, moving small and ink, a count where a building holds more than one open matter.",
+      "actions": [
+        [
+          "wait",
+          900
+        ],
+        [
+          "clickIfVisible",
+          "[data-craft-close]"
+        ],
+        [
+          "wait",
+          300
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#cityPins",
+          ".city-pin--urgent",
+          ".city-pin--needs",
+          ".city-pin--moving",
+          ".city-pin__count"
+        ]
+      }
     }
   },
-  "reducedMotion": { "auth": true, "actions": [["wait", 600]] }
+  "reducedMotion": {
+    "auth": true,
+    "actions": [
+      [
+        "wait",
+        600
+      ]
+    ]
+  }
 }

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

@@ -148,9 +148,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <script src="/builders/collab-lib.js?v=2026-09-24-archive"></script>

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

@@ -54,9 +54,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-14-domutils"></script>

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

@@ -177,9 +177,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <script src="/builders/hall-kit.js"></script>

package/modules/hall-ui/public/craft-mode.js

@@ -30,6 +30,7 @@
     artistry: '<path d="M8 2a6 6 0 1 0 0 12c.9 0 1.4-.6 1.4-1.3 0-.8-.6-1-.6-1.7 0-.6.5-1 1.2-1h1.6A2.4 2.4 0 0 0 14 7.6C14 4.5 11.3 2 8 2Z"/><path d="M5 6.2h.01M7.6 4.6h.01M10.4 5.2h.01M4.6 9h.01" stroke-width="2.2"/>',
     ideating: '<path d="M6 12.5h4M6.6 14.5h2.8M8 1.8a4.2 4.2 0 0 0-2.6 7.5c.6.5 1 1.2 1 2h3.2c0-.8.4-1.5 1-2A4.2 4.2 0 0 0 8 1.8Z"/>',
     governing: '<path d="M2 6 8 2.5 14 6M3.5 6.5v6M6.5 6.5v6M9.5 6.5v6M12.5 6.5v6M2 13.5h12"/>',
+    brush: '<path d="M13.6 2.4 7.4 8.6"/><path d="M7.4 8.6c-1.3-.7-3-.1-3.4 1.5-.3 1.3-.8 2.2-1.9 2.9 2.4.7 4.6.1 5.6-1.4.6-.9.5-2.1-.3-3Z"/>',
     modes: '<rect x="2.5" y="2.5" width="4.5" height="4.5" rx="1"/><rect x="9" y="2.5" width="4.5" height="4.5" rx="1"/><rect x="2.5" y="9" width="4.5" height="4.5" rx="1"/><rect x="9" y="9" width="4.5" height="4.5" rx="1"/>',
   };
   // The four crafts. `short` is the switch's label; `line` is the
@@ -127,12 +128,18 @@
   }
 
   // ---------- each mode's tools (task 1004496 onward) ----------
+  // Artistry has two: the palette (a feedback doc, page-notes.js) and the
+  // paintbrush (the page's words as a wording change, paintbrush.js).
   // A tool is a top-bar button beside the switch, shown only in its mode. Its
   // code is NOT on every page: pressing it loads the tool's own script once
   // (same ?v as this file) and calls its open(). Cosmetic, like the mode: the
   // routes behind a tool hold its walls (ADR 0016).
   var TOOLS = {
-    artistry: [{ id: 'palette', icon: 'artistry', short: 'Feedback', label: 'Write feedback on this page', script: 'page-notes.js', api: 'OTBPageNotes' }],
+    artistry: [
+      { id: 'palette', icon: 'artistry', short: 'Feedback', label: 'Write feedback on this page', script: 'page-notes.js', api: 'OTBPageNotes' },
+      // Task 1004497: this page's words, edited where they stand as a proposed wording change.
+      { id: 'paintbrush', icon: 'brush', short: 'Edit words', label: 'Edit this page\'s words', script: 'paintbrush.js', api: 'OTBPaintbrush' },
+    ],
   };
   var SCRIPT_V = (function () {
     var src = document.currentScript && document.currentScript.src;

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

@@ -74,9 +74,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -97,9 +97,9 @@
 
 <!-- The app shell (sidebar + top bar + footer). Dependency-free; runs at parse
      time so the chrome exists before the deferred page scripts execute. -->
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/diagram-viewer.js?v=2026-06-14-diagviewer-1" defer></script>

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

@@ -98,9 +98,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/md-reader.js?v=2026-09-02-mdreader-2"></script>

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

@@ -54,9 +54,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -77,9 +77,9 @@
 <div id="gate-modal-root"></div>
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>

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

@@ -137,9 +137,9 @@
   </div>
 </div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <script src="/builders/palette.js" defer></script>
 
 <script src="/builders/idea-objects.js?v=2026-09-27-split"></script>

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

@@ -230,9 +230,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/craft-mode.js?v=2026-10-04-nolegacy"></script>
-<script src="/builders/shell.js?v=2026-10-04-nolegacy"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-paintbrush"></script>
+<script src="/builders/shell.js?v=2026-10-04-paintbrush"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-14-domutils"></script>