@bongos/core 1.21.43 → 1.21.44

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

@@ -76,8 +76,11 @@ html[data-fullscreen="on"] .street-top { padding-right: 184px; }
 .street-kicker { margin: 0; font-size: 11.5px; font-weight: 400; letter-spacing: 0.12em; text-transform: uppercase; color: var(--ink-faint); white-space: nowrap; }
 .street-hud { display: flex; align-items: center; gap: 36px; margin-left: auto; }
 .street-hud__item { display: flex; align-items: center; gap: 12px; }
-.street-hud__dot { width: 8px; height: 8px; border-radius: 999px; background: var(--street-rule-strong); }
+/* the header's dots are the pins' colours, so the counts double as the legend
+   (task 1004569): orange for needs you (a ring while nothing does), ink for moving */
+.street-hud__dot { width: 8px; height: 8px; border-radius: 999px; box-sizing: border-box; background: transparent; border: 1.5px solid var(--accent); flex: none; }
 .street-hud__dot--hot { background: var(--accent); }
+.street-hud__dot--moving { width: 6px; height: 6px; border: 0; background: var(--ink); }
 .street-hud__n { font-size: 24px; font-weight: 300; font-variant-numeric: tabular-nums; }
 .street-mode { margin-left: 36px; flex: none; background: none; border: 1px solid var(--street-rule-strong); border-radius: 999px; height: 36px; padding: 0 14px; display: flex; align-items: center; gap: 8px; cursor: pointer; color: var(--ink); font-family: var(--font-body); font-size: 13px; text-transform: lowercase; }
 .street-mode svg { display: block; stroke-width: 1.4; }
@@ -116,7 +119,7 @@ html[data-fullscreen="on"] .street-top { padding-right: 184px; }
 
 /* pins: orange and pulsing waits on you; ink is moving; grey is settled; dashed is the queue */
 .street-pin { position: absolute; z-index: 3; display: flex; flex-direction: column; align-items: center; gap: 6px; background: transparent; border: 0; padding: 0; cursor: pointer; font-family: var(--font-body); color: var(--ink); }
-.street-pin__label { max-width: 110px; overflow: hidden; text-overflow: ellipsis; font-size: 12px; line-height: 1.2; white-space: nowrap; }
+.street-pin__label { max-width: 150px; flex-shrink: 0; min-height: 15px; overflow: hidden; text-overflow: ellipsis; font-size: 12px; line-height: 1.2; white-space: nowrap; visibility: hidden; }
 .street-pin__head { position: relative; width: 28px; height: 28px; flex-shrink: 0; border-radius: 999px; box-sizing: border-box; display: flex; align-items: center; justify-content: center; transition: transform 200ms cubic-bezier(.2,.7,.3,1); }
 .street-pin:hover .street-pin__head { transform: scale(1.12); }
 .street-pin__head svg { display: block; }
@@ -125,14 +128,27 @@ html[data-fullscreen="on"] .street-top { padding-right: 184px; }
 .street-pin__stem { width: 0; flex-grow: 1; border-left: 1px solid transparent; }
 .street-pin__ring { position: absolute; inset: -1px; border-radius: 999px; border: 1px solid var(--accent); }
 .street-pin__count { font-size: 12.5px; font-weight: 500; font-variant-numeric: tabular-nums; }
+/* importance tiers (task 1004569): one pin per building, colour AND size, so a
+   tier reads without colour. urgent 34 > needs 28 (the prototype's) > moving 20
+   > settled 10, a plain grey dot. A label shows only where the collision pass
+   placed it (--shown); any other shows on hover or focus, on a card so it reads
+   over its neighbours. */
+.street-pin--shown .street-pin__label, .street-pin:hover .street-pin__label, .street-pin:focus-visible .street-pin__label { visibility: visible; }
+.street-pin:hover, .street-pin:focus-visible { z-index: 4; }
+.street-pin:not(.street-pin--shown):hover .street-pin__label, .street-pin:not(.street-pin--shown):focus-visible .street-pin__label { background: var(--bg-card); border-radius: 4px; padding: 0 4px; }
+.street-pin--urgent .street-pin__label { color: var(--street-accent-text); font-weight: 500; }
 .street-pin--needs .street-pin__label { color: var(--street-accent-text); }
-.street-pin--needs .street-pin__head { background: var(--accent); color: var(--accent-on); box-shadow: var(--street-glow); }
-.street-pin--needs .street-pin__stem { border-left-color: color-mix(in srgb, var(--accent) 65%, transparent); }
-.street-pin--moving .street-pin__head { background: var(--ink); color: var(--bg-card); }
+.street-pin--urgent .street-pin__head, .street-pin--needs .street-pin__head { background: var(--accent); color: var(--accent-on); box-shadow: var(--street-glow); }
+.street-pin--urgent .street-pin__head { width: 34px; height: 34px; }
+.street-pin--urgent .street-pin__head svg { width: 21px; height: 21px; }
+.street-pin--urgent .street-pin__stem, .street-pin--needs .street-pin__stem { border-left-color: color-mix(in srgb, var(--accent) 65%, transparent); }
+.street-pin--moving .street-pin__head { width: 20px; height: 20px; background: var(--ink); color: var(--bg-card); }
+.street-pin--moving .street-pin__head svg { width: 13px; height: 13px; }
 .street-pin--moving .street-pin__stem { border-left-color: color-mix(in srgb, var(--ink) 45%, transparent); }
-.street-pin--settled .street-pin__label { color: var(--ink-faint); }
-.street-pin--settled .street-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); }
+.street-pin--settled .street-pin__head { width: 10px; height: 10px; margin-top: 9px; background: color-mix(in srgb, var(--ink) 38%, var(--bg)); }
 .street-pin--settled .street-pin__stem { border-left-color: color-mix(in srgb, var(--ink) 22%, transparent); }
+.street-pin__badge { position: absolute; top: -7px; right: -12px; min-width: 17px; height: 17px; padding: 0 4px; box-sizing: border-box; border-radius: 999px; background: var(--bg-card); border: 1px solid currentColor; color: var(--ink); font-size: 10.5px; font-weight: 600; line-height: 15px; text-align: center; font-variant-numeric: tabular-nums; }
+.street-pin--urgent .street-pin__badge, .street-pin--needs .street-pin__badge { color: var(--street-accent-text); }
 .street-pin--queue .street-pin__head { background: transparent; border: 1px dashed var(--street-crate); color: var(--ink); }
 .street-pin--queue .street-pin__stem { border-left-color: color-mix(in srgb, var(--ink) 22%, transparent); }
 

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

@@ -11,8 +11,8 @@
        links, injected into this head by the server like every hall page's
        (tests/hall_tokens.mjs: no hall page hardcodes a web-font stylesheet). -->
   <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
-  <link rel="stylesheet" href="/builders/street.css?v=2026-10-03-desk1">
-  <link rel="stylesheet" href="/builders/street-card.css?v=2026-10-02-card1">
+  <link rel="stylesheet" href="/builders/street.css?v=2026-10-04-pins1">
+  <link rel="stylesheet" href="/builders/street-card.css?v=2026-10-04-pins1">
 </head>
 <!-- THE STREET (task 1004525, goal 1000125, R03). The street view of
      docs/design/mocks/governor-city/Street.dc.html (renderVals' street branch,
@@ -73,11 +73,12 @@
       <span class="street-today__n" id="streetTodayN">0 decided</span>
     </div>
     <div class="street-hud__item">
-      <span class="street-hud__dot" id="hudDot"></span>
+      <span class="street-hud__dot" id="hudDot" aria-hidden="true"></span>
       <span class="street-label">needs you</span>
       <span class="street-hud__n" id="hudNeeds">—</span>
     </div>
     <div class="street-hud__item">
+      <span class="street-hud__dot street-hud__dot--moving" aria-hidden="true"></span>
       <span class="street-label">moving</span>
       <span class="street-hud__n" id="hudMoving">—</span>
     </div>
@@ -207,12 +208,12 @@
 <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/palette.js" defer></script>
-<script src="/builders/city-draw.js?v=2026-10-02-street1"></script>
-<script src="/builders/street-draw.js?v=2026-10-02-street1"></script>
-<script src="/builders/street-card.js?v=2026-10-02-amend1"></script>
+<script src="/builders/city-draw.js?v=2026-10-04-pins1"></script>
+<script src="/builders/street-draw.js?v=2026-10-04-pins1"></script>
+<script src="/builders/street-card.js?v=2026-10-04-pins1"></script>
 <script src="/builders/street-inside.js?v=2026-10-03-desk1"></script>
 <script src="/builders/street-desk.js?v=2026-10-03-desk1"></script>
 <script src="/builders/street-amend.js?v=2026-10-02-amend1"></script>
-<script src="/builders/street.js?v=2026-10-03-desk1"></script>
+<script src="/builders/street.js?v=2026-10-04-pins1"></script>
 </body>
 </html>

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

@@ -80,7 +80,9 @@
   var data = { docket: null, goals: [], rollups: [], earnings: null, loaded: false, tasks: {}, room: null, constitution: null };
   // ask: the act whose chips stand open; more: the detail is open in place;
   // pick: which of the review queue the queue's card shows (task 1004566)
-  var card = { cv: null, form: null, ask: null, more: false, pick: null, error: '', busy: false, fresh: null, answer: null };
+  // page: the matters of the pin that opened the card, most important first,
+  // for its "1 of N" pager (task 1004569); null when one matter or a desk row.
+  var card = { cv: null, form: null, ask: null, more: false, pick: null, error: '', busy: false, fresh: null, answer: null, page: null };
   var view = { open: null, opener: null, model: null, scale: 1, mode: null, inside: null, insideModel: null };
   // the desk's own state: rows you acted on this visit, what you did per floor,
   // the floors you cleared, the row whose facts or chips are open
@@ -247,25 +249,31 @@
     return el;
   }
 
+  // One pin per building (task 1004569): its tier is its class, a label shows
+  // only when the collision pass placed it (street-pin--shown; the rest show
+  // on hover or focus), and a count badge says how many matters are open there.
   function drawPin(p) {
-    var el = node('button', 'street-pin street-pin--' + p.state);
+    var keys = p.matters && p.matters.length ? p.matters : [p.key];
+    var el = node('button', 'street-pin street-pin--' + p.state + (p.shown ? ' street-pin--shown' : ''));
     el.setAttribute('type', 'button');
     el.setAttribute('aria-label', p.aria);
-    el.setAttribute('aria-expanded', view.open === p.key ? 'true' : 'false');
+    el.setAttribute('aria-expanded', keys.indexOf(view.open) >= 0 ? 'true' : 'false');
     el.setAttribute('aria-controls', 'streetCard');
     el.setAttribute('data-matter', p.key);
+    el.setAttribute('data-matters', keys.join(' '));
     el.setAttribute('data-building', p.building);
-    at(el, p.x, p.y, 110, p.h);
+    at(el, p.x, p.y, S.PIN_W, p.h);
     var label = node('span', 'street-pin__label', p.label);
-    label.setAttribute('title', p.label);
+    if (p.label) label.setAttribute('title', p.label);
     el.appendChild(label);
     var head = node('span', 'street-pin__head');
-    if (p.state === 'needs') head.appendChild(node('span', 'street-pin__ring'));
+    if (p.state === 'urgent') head.appendChild(node('span', 'street-pin__ring'));
     if (p.isCount) head.appendChild(node('span', 'street-pin__count', p.count));
-    else {
+    else if (p.state !== 'settled') {
       var svg = document.createElementNS(SVG_NS, 'svg');
       svg.setAttribute('width', '18');
       svg.setAttribute('height', '18');
+      svg.setAttribute('viewBox', '0 0 18 18');
       svg.setAttribute('aria-hidden', 'true');
       var fill = document.createElementNS(SVG_NS, 'path');
       fill.setAttribute('d', p.gf || '');
@@ -275,9 +283,10 @@
       svg.appendChild(line);
       head.appendChild(svg);
     }
+    if (!p.isCount && Number(p.count) > 1) head.appendChild(node('span', 'street-pin__badge', p.count));
     el.appendChild(head);
     el.appendChild(node('span', 'street-pin__stem'));
-    el.addEventListener('click', function () { openCard(p.key, el); });
+    el.addEventListener('click', function () { openCard(keys[0], el, keys); });
     return el;
   }
 
@@ -366,6 +375,7 @@
     $('hudMoving').textContent = m.hud.moving;
     $('hudShare').textContent = m.hud.share;
     var dot = $('hudDot');
+    // the header's dots are the pins' own colours, so they double as the legend
     if (dot) dot.className = 'street-hud__dot' + (m.hud.hot ? ' street-hud__dot--hot' : '');
     var board = $('streetBoard');
     if (board) board.setAttribute('aria-label', data.loaded ? m.label : 'The street, reading the docket');
@@ -1055,7 +1065,8 @@
     $('streetCardWhere').textContent = cv.where;
     $('streetCardWhen').textContent = cv.when;
     $('streetCardTitle').textContent = cv.title;
-    C.render(document, $('streetCardBody'), cv, { act: actOn, openForm: openForm, ask: askFor, more: toggleMore, pick: pickQueued }, { form: card.form, ask: card.ask, more: card.more, error: card.error, busy: card.busy, fresh: card.fresh });
+    var pager = C.pager ? C.pager(card.page, view.open) : null;
+    C.render(document, $('streetCardBody'), cv, { act: actOn, openForm: openForm, ask: askFor, more: toggleMore, pick: pickQueued, page: turnPage }, { form: card.form, ask: card.ask, more: card.more, error: card.error, busy: card.busy, fresh: card.fresh, pager: pager });
     var frame = $('streetCard'); if (frame) frame.setAttribute('data-more', card.more ? 'open' : 'closed');
     placeCard();
     return cv;
@@ -1073,6 +1084,26 @@
     var mb = $('streetCardBody'), t = mb && mb.querySelector ? mb.querySelector('[data-act="more"]') : null;
     if (t && t.focus) t.focus();
   }
+  // The pager turns the card to another matter of the same pin, in place.
+  function turnPage(key, dir) {
+    view.open = key;
+    card.form = null; card.ask = null; card.more = false; card.pick = null; card.error = ''; card.fresh = null;
+    if (!fillCard()) return;
+    draw();
+    var b = findAct($('streetCardBody'), 'page-' + dir);
+    if (b && b.focus) b.focus();
+    if (card.cv && card.cv.loading) loadRoom();
+  }
+  // The first node under `host` with data-act=`act` (a walk, so it needs no selector engine).
+  function findAct(host, act) {
+    var kids = host && host.children ? Array.prototype.slice.call(host.children) : [];
+    for (var i = 0; i < kids.length; i++) {
+      if (kids[i].getAttribute && kids[i].getAttribute('data-act') === act) return kids[i];
+      var hit = findAct(kids[i], act);
+      if (hit) return hit;
+    }
+    return null;
+  }
   function pickQueued(key) {
     card.pick = key; card.ask = null; card.more = false; card.form = null; card.error = '';
     fillCard();
@@ -1083,7 +1114,7 @@
     var card = $('streetCard');
     if (!card || !view.open || !view.model) return;
     var pin = null;
-    view.model.pins.forEach(function (p) { if (p.key === view.open) pin = p; });
+    view.model.pins.forEach(function (p) { if (p.key === view.open || (p.matters && p.matters.indexOf(view.open) >= 0)) pin = p; });
     var win = $('streetWindow'), sizer = $('streetSizer');
     var stageW = (card.parentNode && card.parentNode.clientWidth) || window.innerWidth || 1440;
     var originX = (sizer && sizer.offsetLeft != null ? sizer.offsetLeft : 0) - (win && win.scrollLeft ? win.scrollLeft : 0);
@@ -1091,9 +1122,10 @@
     var x = Math.max(16, Math.min(stageW - CARD_W - 16, Math.round(cx - CARD_W / 2)));
     card.style.setProperty('--street-card-x', x + 'px');
   }
-  function openCard(key, opener) {
+  function openCard(key, opener, keys) {
     view.open = key;
     view.opener = opener || null;
+    card.page = keys && keys.length > 1 ? keys.slice() : null;
     card.form = null; card.ask = null; card.more = false; card.pick = null; card.error = ''; card.fresh = null;
     var el = $('streetCard');
     if (!fillCard()) return;
@@ -1107,7 +1139,7 @@
     var was = view.opener;
     view.open = null;
     view.opener = null;
-    card.cv = null; card.form = null; card.ask = null; card.more = false; card.pick = null; card.error = ''; card.busy = false; card.fresh = null;
+    card.cv = null; card.form = null; card.ask = null; card.more = false; card.pick = null; card.error = ''; card.busy = false; card.fresh = null; card.page = null;
     var el = $('streetCard');
     if (el) el.hidden = true;
     draw();
@@ -1195,7 +1227,7 @@
     var blds = ($('streetBlds') && $('streetBlds').children) || [];
     for (var i = 0; i < blds.length; i++) if (blds[i].getAttribute('data-key') === a.building) blds[i].setAttribute('class', 'street-answer street-answer--' + a.kind);
     var pins = ($('streetPins') && $('streetPins').children) || [];
-    for (var j = 0; j < pins.length; j++) if (pins[j].getAttribute('data-matter') === a.matter) pins[j].className += ' street-pin--answer';
+    for (var j = 0; j < pins.length; j++) if (String(pins[j].getAttribute('data-matters') || pins[j].getAttribute('data-matter')).split(' ').indexOf(a.matter) >= 0) pins[j].className += ' street-pin--answer';
   }
   var toastTimer = null;
   function say(text) {

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

@@ -805,6 +805,74 @@
           ".desk-status--hot"
         ]
       }
+    },
+    "pins": {
+      "auth": true,
+      "_": "The street over the dense docket (task 1004569): one pin per building in the tier of its most important matter — urgent (needs you within a day: people, rules) largest and pulsing, needs you orange, moving small and ink, settled a grey dot — with a count where a building holds more than one open matter. Only urgent and needs-you pins show a label, and no two labels meet. Render at 1440 and 390 in both modes.",
+      "actions": [
+        [
+          "wait",
+          900
+        ],
+        [
+          "clickIfVisible",
+          "[data-craft-close]"
+        ],
+        [
+          "wait",
+          300
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#streetBoard",
+          ".street-pin--urgent",
+          ".street-pin--needs",
+          ".street-pin__badge"
+        ]
+      }
+    },
+    "pins-pager": {
+      "auth": true,
+      "_": "Planning holds four matters: its pin opens the most important one with \"1 of 4\" and previous/next inside the card; next turns to the second without leaving the street (task 1004569).",
+      "actions": [
+        [
+          "wait",
+          900
+        ],
+        [
+          "clickIfVisible",
+          "[data-craft-close]"
+        ],
+        [
+          "wait",
+          300
+        ],
+        [
+          "dispatchClick",
+          ".street-pin[data-building=\"planning\"]"
+        ],
+        [
+          "wait",
+          600
+        ],
+        [
+          "click",
+          "[data-act=\"page-next\"]"
+        ],
+        [
+          "wait",
+          400
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#streetCard",
+          ".mcard-pager",
+          "[data-act=\"page-prev\"]",
+          "[data-act=\"page-next\"]"
+        ]
+      }
     }
   },
   "reducedMotion": {

package/modules/hall-ui/records/governor-street.md

@@ -10,6 +10,7 @@ What it settled:
 - **The artboard is the street band.** The prototype's 1440 x 900 board less its 64 px header and 128 px footer, which the page lays out as real rows; `street.js` scales the 1440 x 708 band to the window, and on a phone keeps it near full size and lets the street scroll sideways inside its own window, so a pin stays a pin. The header fits the 80 px top-bar floor at 390 and 320 by going to two rows, its three figures as their own sideways strip.
 - **Real data where the prototype had samples.** One district per open goal (up to eight plots; past that seven stand and the eighth is a staked lot that opens the goals page), each goal's tasks drawn in proportion (built, scaffold, the prototype's `ready` slab), Review held while any source that stands in it can be read, its open matters as crates and the dashed "waiting for a tester" count pin, a reading off drawn as a dash and its reason. The full list is the header of `street-draw.js`.
 - **Every building and district is a door** to `/street#building=<key>` or `/street#district=<goal id>`, where its interior opens in place of the street (below). A pin opens the matter's short card (task 1004528 makes it act); its link is offered only for an on-site path.
+- **One pin per building, its importance at a glance** (task 1004569, owner direction 2026-10-04: the pins stacked and their text overlapped). The prototype stood one pin per matter, up to three stacked; now one pin stands over a building where the prototype stands its pin, in the tier of its most important matter (`GovCity.buildingPin`, shared with the home city so both agree): urgent (needs you, due within 24 hours or overdue) largest, orange and pulsing; needs you orange, the prototype's size; moving small and ink; settled a grey dot with no label and no count. A badge counts the building's open matters when there is more than one. Only urgent and needs-you pins show a label, one short line cut by the line rule's `fit()` (the deadline always survives the cut); a moving pin shows its label on hover or focus. A collision pass (`placeLabels`) places labels most important first: a label that would meet one already placed steps up to an alternate height, and if it still meets one it waits for hover (its count and colour stay). Tapping a pin opens the most important matter's card; with more, the card carries "1 of N" with previous and next, which wrap. The header's dots wear the pin colours, so the counts double as the legend. Rendered through `street.states.json` (`pins`, `pins-pager`) and `city.states.json` (`pins`) at 1440 and 390, light and dark, on the hall-preview harness, whose docket fixture now holds every tier.
 - **A card is only as tall as its words** (task 1004568). Every part of the compact card has a cap (`LINE` in `street-card.js`): the kicker, the fact and a listed line one line, the title about two, a voice's reason two, the proposer's words three. Longer text is cut at a whole word with an ellipsis, and whatever was cut is whole under "more". The kicker is building · floor only: the automation switch's off-reason is no longer joined into it, it is the card's fact. Nothing on the card has a min-height. Rendered through `street-card.states.json` (`automation`, `automation-more`, beside the blocker and Full Idea states) at 1440 and 390, light and dark, on the hall-preview harness.
 
 Tests: `tests/hall_street.mjs` holds the kit, the row, the pins, the doors and the crates equal to the prototype by running its own `Component` class beside `street-draw.js` in both modes, then the docket rules and the page itself in a vm. The states file is `public/street.states.json`; render it against the hall-preview harness, whose `government__docket.json` fixture carries the seven sample matters.

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.21.43",
+  "version": "1.21.44",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.21.43",
+      "version": "1.21.44",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.21.43",
+  "version": "1.21.44",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/release-notes.json

@@ -9022,5 +9022,11 @@
       "id": "1004567",
       "text": "Legacy mode is gone from the builders hall. The mode picker now offers four doors (Building, Artistry, Ideating, Governing) and the top-bar switch shows those four. Anyone who still had Legacy saved simply lands with no mode c"
     }
+  ],
+  "1.21.44": [
+    {
+      "id": "1004569",
+      "text": "The street's pins no longer pile up or talk over each other. Each building now has one pin, and its colour and size show how much it matters: largest and pulsing orange when something needs you within a day, orange when it nee"
+    }
   ]
 }

package/scripts/hall-preview/server.js

@@ -195,18 +195,21 @@ const CANNED_WRITES = [
 // year from now. Any string field may use it; nothing else changes, so a fixture
 // with absolute dates is served exactly as before.
 //
+// A deadline still to come is "@+20.5h" (task 1004569: the street's urgent
+// tier is a matter that needs you within a day, so it must stay a day ahead).
+//
 // WRITE A FRACTIONAL OFFSET. "@-3d" lands exactly on the 3-day band boundary, so
 // whether it reads as 2 days or 3 depends on the milliseconds between this
 // resolve and the browser's own clock — the row flickers between two bands
 // across reloads and a screenshot pass cannot be compared. "@-3.4d" cannot.
-const RELATIVE_AT = /^@-(\d+(?:\.\d+)?)([dh])$/;
+const RELATIVE_AT = /^@([-+])(\d+(?:\.\d+)?)([dh])$/;
 const HOUR_MS = 60 * 60 * 1000;
 
 function resolveRelativeDates(v, nowMs) {
   if (typeof v === 'string') {
     const m = RELATIVE_AT.exec(v);
     if (!m) return v;
-    const hours = Number(m[1]) * (m[2] === 'd' ? 24 : 1);
+    const hours = Number(m[2]) * (m[3] === 'd' ? 24 : 1) * (m[1] === '+' ? -1 : 1);
     return new Date(nowMs - hours * HOUR_MS).toISOString();
   }
   if (Array.isArray(v)) return v.map((x) => resolveRelativeDates(x, nowMs));

package/src/module-api.js

@@ -75,7 +75,7 @@ const { responsibilityFor, ROLE_RESPONSIBILITIES } = require('./role-responsibil
 // MAJOR (see allowBoxScope below): passes the request through untouched.
 function deprecatedNoopMiddleware(_req, _res, next) { next(); }
 
-const CORE_VERSION = '1.21.43'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.21.44'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('discord'); log.info('mounted');

package/tests/hall_city.mjs

@@ -142,12 +142,38 @@ test('the line is the docket\'s own line, word for word', () => {
   assert.equal(m.line, '1 matter waits on you');
 });
 
-test('at most three pins stand over one building, needs first as the docket ordered them', () => {
-  const ms = ['needs', 'needs', 'moving', 'moving', 'settled'].map((state, i) => matter({ id: `blockers:${i}`, state }));
-  const m = City.cityModel({ docket: docket(ms), mode: 'dark' });
-  assert.equal(m.pins.length, City.MAX_PINS_PER_BUILDING);
-  assert.deepEqual(m.pins.map((p) => p.state), ['needs', 'needs', 'moving']);
-  assert.equal(new Set(m.pins.map((p) => p.x)).size, 3, 'abreast, not stacked on one spot');
+// task 1004569 (owner, 2026-10-04): deliberate change from the prototype's
+// drawing — ONE pin per building, in its most important matter's tier, the
+// same tiers as the street (GovCity.buildingPin is the one rule both use).
+test('one pin per building, in the tier of its most important matter, with the count of its open matters', () => {
+  const NOW = Date.parse('2026-10-02T12:00:00.000Z');
+  const ms = ['moving', 'needs', 'moving', 'settled'].map((state, i) => matter({ id: `blockers:${i}`, state }));
+  ms.push(matter({ id: 'blockers:9', state: 'needs', deadline: '2026-10-03T06:00:00.000Z' }));
+  const m = City.cityModel({ docket: docket(ms), mode: 'dark', now: NOW });
+  assert.equal(m.pins.length, 1, 'one pin, never more');
+  assert.deepEqual([m.pins[0].key, m.pins[0].state, m.pins[0].count], ['blockers:9', 'urgent', 4], 'urgent (needs you, due within a day); four open');
+  assert.deepEqual(m.pins[0].matters, ['blockers:9', 'blockers:1', 'blockers:0', 'blockers:2', 'blockers:3']);
+  const k = City.isoKit(60, 30, 720, 176, 30 / 28, City.isoTheme('dark'), false);
+  const top = k.P(6, 6, City.ROOF.planning + 8);
+  assert.equal(m.pins[0].x, Math.round((top[0] - 15) * 10) / 10, 'where the prototype stands a single pin');
+  const tier = (list) => City.cityModel({ docket: docket(list), mode: 'dark', now: NOW }).pins[0].state;
+  assert.equal(tier([matter({ state: 'needs', deadline: '2026-10-05T12:00:00.000Z' })]), 'needs', 'due after a day');
+  assert.equal(tier([matter({ state: 'settled' }), matter({ id: 'b:2', state: 'moving' })]), 'moving');
+  const settled = City.cityModel({ docket: docket([matter({ state: 'settled' })]), mode: 'dark', now: NOW }).pins[0];
+  assert.deepEqual([settled.state, settled.count], ['settled', 0], 'settled: a dot, no count');
+});
+
+test('the city and the street agree: the same docket gives each building the same tier and the same top matter', () => {
+  const S = require(path.join(PUB, 'street-draw.js'));
+  const NOW = Date.parse('2026-10-02T12:00:00.000Z');
+  const ms = [
+    matter({ id: 'board:1', building: 'charter', state: 'needs', deadline: '2026-10-02T20:00:00.000Z' }), matter({ id: 'board:2', building: 'charter', state: 'moving' }),
+    matter({ id: 'blockers:3', state: 'moving' }), matter({ id: 'blockers:4', state: 'needs' }),
+    matter({ id: 'override_requests:5', building: 'release', state: 'settled' }),
+  ];
+  const city = City.cityModel({ docket: docket(ms), mode: 'dark', now: NOW }).pins.map((p) => [p.building, p.state, p.key, p.matters.join(' ')]).sort();
+  const street = S.streetModel({ docket: docket(ms), goals: [], rollups: [], mode: 'dark', now: NOW }).pins.map((p) => [p.building, p.state, p.key, p.matters.join(' ')]).sort();
+  assert.deepEqual(city, street);
 });
 
 test('a matter at a building the city does not have is not drawn, and an unknown state is never "needs"', () => {
@@ -346,16 +372,21 @@ const FEEDS = (ms, goals = [goal(1)], rollups = [rollup(1, { done: 2, active: 1
 });
 
 test('the page reads the three feeds and draws the docket\'s pins and line', async () => {
-  const ms = [matter({ id: 'board:1', building: 'charter', state: 'needs' }), matter({ id: 'blockers:2', state: 'needs' }), matter({ id: 'gate_approvals:3', building: 'release', state: 'moving' })];
+  const soon = new Date(Date.now() + 2 * 3600000).toISOString();
+  const ms = [matter({ id: 'board:1', building: 'charter', state: 'needs', deadline: soon }), matter({ id: 'blockers:2', state: 'needs' }), matter({ id: 'blockers:4', state: 'moving' }), matter({ id: 'gate_approvals:3', building: 'release', state: 'moving' }), matter({ id: 'removal_proposals:5', building: 'disputes', state: 'settled' })];
   const p = await bootPage({ feeds: FEEDS(ms) });
   assert.deepEqual([...p.calls].sort(), ['/api/bongos/goals', '/api/bongos/goals/rollups', '/api/bongos/government/docket']);
   const pins = p.byId.get('cityPins').children;
-  assert.equal(pins.length, 3);
-  assert.deepEqual(pins.map((s) => s.className).sort(), ['city-pin city-pin--moving', 'city-pin city-pin--needs', 'city-pin city-pin--needs']);
-  const needs = pins.find((s) => s.attrs['data-matter'] === 'board:1');
-  assert.equal(needs.children[0].children[0].className, 'city-pin__ring', 'a needs pin pulses');
+  assert.equal(pins.length, 4, 'one per building');
+  assert.deepEqual(pins.map((s) => s.className).sort(), ['city-pin city-pin--moving', 'city-pin city-pin--needs', 'city-pin city-pin--settled', 'city-pin city-pin--urgent']);
+  const urgent = pins.find((s) => s.attrs['data-matter'] === 'board:1');
+  assert.equal(urgent.children[0].children[0].className, 'city-pin__ring', 'the urgent pin pulses');
+  const needs = pins.find((s) => s.className.includes('needs'));
+  assert.ok(!needs.children[0].children.some((c) => c.className === 'city-pin__ring'), 'a needs-you pin is solid orange, no ring');
+  assert.equal(needs.children[0].children.find((c) => c.className === 'city-pin__count').textContent, '2', 'it counts its building\'s two open matters');
   const moving = pins.find((s) => s.className.includes('moving'));
   assert.ok(!moving.children[0].children.some((c) => c.className === 'city-pin__ring'), 'a moving pin only bobs');
+  assert.equal(pins.find((s) => s.className.includes('settled')).children[0].children.length, 0, 'a settled pin is a plain dot');
   assert.equal(p.byId.get('cityLine').textContent, '2 matters wait on you · 1 moving');
   assert.equal(p.byId.get('cityStart').attrs.href, '/builders/street');
   assert.ok(p.byId.get('cityBlds').children.length > 9, 'the civic quarter and the district are drawn');

package/tests/hall_matter_card.mjs

@@ -590,3 +590,20 @@ test('the Board Room labels a building\'s matter as that building\'s matter, and
   assert.equal(subjectLine({ subject_type: 'constitutional_amendment', subject: { kind: 'decision_rules' } }), 'Who decides what [amendment]');
   assert.equal(subjectLine({ subject_type: 'constitutional_amendment', subject: { proposed: {} } }), 'Constitutional amendment [amendment]');
 });
+
+// task 1004569: a street pin stands for every matter at its building; the card
+// pages through them so each is reachable without leaving the street.
+test('the card pager: "i of N" over the pin\'s matters, previous and next wrapping; none for one matter', () => {
+  assert.equal(C.pager(['a'], 'a'), null, 'one matter, no pager');
+  assert.equal(C.pager(null, 'a'), null);
+  assert.equal(C.pager(['a', 'b'], 'zz'), null, 'a key the pin does not hold');
+  assert.deepEqual(C.pager(['a', 'b', 'c'], 'a'), { i: 0, n: 3, words: '1 of 3', prev: 'c', next: 'b' });
+  assert.deepEqual(C.pager(['a', 'b', 'c'], 'c'), { i: 2, n: 3, words: '3 of 3', prev: 'b', next: 'a' });
+  // walking next from the first visits every key exactly once
+  const keys = ['k1', 'k2', 'k3', 'k4', 'k5'];
+  const seen = [];
+  let k = keys[0];
+  for (let i = 0; i < keys.length; i++) { seen.push(k); k = C.pager(keys, k).next; }
+  assert.deepEqual(seen, keys);
+  assert.equal(k, keys[0]);
+});