@bongos/core 1.21.43 → 1.21.45

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

@@ -1560,6 +1560,14 @@ html[data-theme="light"][data-craft="ideating"] .app-sidebar {
   .craft-tool { width: auto; gap: 6px; padding: 0 12px 0 10px; }
 }
 @media (max-width: 1180px) { .craft-tool__label { display: none; } }
+/* Two tools (Artistry's palette and paintbrush) must still fit a 390px top bar
+   (task 1004497): at phone width the side packs tighter and a tool is 28px. */
+@media (max-width: 640px) {
+  .topbar-side, .topbar-menu { flex-shrink: 0; }
+  .topbar-side { gap: 4px; }
+  .craft-tool { width: 28px; height: 28px; }
+  .topbar-title { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+}
 
 /* The page feedback doc: a sheet from the right over a scrim. */
 html.pn-open { overflow: hidden; }
@@ -1676,6 +1684,76 @@ html.pn-open { overflow: hidden; }
   .pn__body { padding: 14px 16px 24px; }
 }
 
+/* THE PAINTBRUSH (task 1004497, paintbrush.js): the page's own words, edited
+   where they stand. Not modal: the page stays live under it, so the bar docks
+   at the foot and the words carry the mode's colour as a dashed underline. A
+   changed line keeps a quiet wash so the artist can see what moved. */
+.pb {
+  position: fixed;
+  left: 50%;
+  bottom: calc(16px + env(safe-area-inset-bottom, 0px));
+  z-index: var(--z-drawer);
+  width: min(640px, calc(100% - 24px));
+  transform: translateX(-50%);
+  box-sizing: border-box;
+  border-radius: 18px;
+  background: var(--bg-card);
+  color: var(--ink);
+  box-shadow: 0 0 0 1px var(--glass-edge), var(--shadow-pop);
+}
+.pb__inner { display: flex; flex-direction: column; gap: 8px; max-height: min(70vh, 560px); overflow-y: auto; padding: 14px 18px 16px; }
+.pb__eyebrow {
+  display: flex; align-items: center; gap: 8px; margin: 0;
+  font-family: var(--label-face); font-size: 11px; letter-spacing: .12em; text-transform: uppercase;
+  color: var(--craft, var(--ink-faint));
+}
+.pb__dot { width: 8px; height: 8px; border-radius: 50%; background: var(--craft, var(--accent)); }
+.pb__line { margin: 0; font-size: 15px; line-height: 1.45; }
+.pb__line strong { font-weight: 500; }
+.pb__hint { margin: 0; font-size: 13px; line-height: 1.45; color: var(--ink-soft); }
+.pb__hint a, .pb__line a { color: var(--ink); text-decoration: underline; text-underline-offset: 3px; }
+.pb__error { margin: 0; font-size: 13.5px; color: var(--danger); }
+.pb__error:empty { display: none; }
+.pb__error-inline { color: var(--danger); }
+.pb__actions { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: 8px; padding-top: 4px; }
+.pb__btn {
+  min-height: 40px; padding: 0 18px; border: 0; border-radius: var(--radius-pill);
+  background: none; color: var(--ink); font: inherit; font-size: 14px; cursor: pointer;
+  box-shadow: inset 0 0 0 1px var(--rule);
+}
+.pb__btn:hover { background: var(--glass); }
+.pb__btn--go { background: var(--accent); color: var(--accent-on); box-shadow: none; font-weight: 500; }
+.pb__btn--go:hover { background: var(--accent-lift); }
+.pb__btn:disabled { opacity: .5; cursor: default; }
+.pb__btn:focus-visible { outline: 2px solid var(--focus); outline-offset: 2px; }
+.pb__changes { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 6px; }
+.pb__change { display: grid; gap: 3px; padding: 10px 12px; border-radius: var(--radius-sm); background: var(--glass); overflow-wrap: anywhere; }
+.pb__where { font-size: 12px; color: var(--ink-faint); }
+.pb__was { font-size: 14px; color: var(--ink-soft); text-decoration: line-through; text-decoration-color: var(--ink-faint); }
+.pb__now { font-size: 14px; color: var(--ink); }
+.pb__tag {
+  display: inline-block; min-width: 34px; margin-right: 4px;
+  font-family: var(--label-face); font-size: 10.5px; letter-spacing: .1em; text-transform: uppercase;
+  color: var(--ink-faint); text-decoration: none;
+}
+html.pb-editing main { padding-bottom: 180px; }
+.pb-word {
+  outline: none;
+  cursor: text;
+  text-decoration: underline dashed color-mix(in srgb, var(--craft, var(--accent)) 70%, transparent);
+  text-decoration-thickness: 1px;
+  text-underline-offset: 4px;
+  border-radius: 3px;
+}
+.pb-word:hover { background: color-mix(in srgb, var(--craft, var(--accent)) 8%, transparent); }
+.pb-word:focus, .pb-word:focus-visible { background: color-mix(in srgb, var(--craft, var(--accent)) 12%, transparent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--craft, var(--accent)) 55%, transparent); }
+.pb-word--changed { background: color-mix(in srgb, var(--craft, var(--accent)) 14%, transparent); text-decoration-style: solid; }
+@media (max-width: 640px) {
+  .pb { bottom: calc(10px + env(safe-area-inset-bottom, 0px)); width: calc(100% - 20px); border-radius: 16px; }
+  .pb__inner { padding: 12px 14px 14px; max-height: 64vh; }
+  .pb__actions .pb__btn { flex: 1 1 auto; }
+}
+
 /* THE BACK LINK (task 1004430): at the head of the bar when the page was
    reached from inside another hall page. 24px floor on both axes. */
 .topbar-back {

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

@@ -54,9 +54,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>
 <!-- shared frontend toolkit (window.OTB) — loaded FIRST so task.js can pull from it. -->

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

@@ -138,9 +138,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/tweak-editor.html

@@ -142,9 +142,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/brand-holes.js?v=2026-09-29-aqfix"></script>

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

@@ -162,9 +162,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) — loaded before watch.js, which pulls from it. -->

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

@@ -171,9 +171,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>
 <!-- shared frontend toolkit (window.OTB) — loaded FIRST so work.js can pull from it. -->

package/modules/hall-ui/records/craft-mode.md

@@ -35,3 +35,12 @@ Covers: every shelled hall page (`craft-mode.js`, `shell.js`, `style.css`), and
 - **Two pieces are drawn by `craft-mode.js` `applyLook()`, on every mode change:** the eyebrow beside `#topbar-title` (`LOOKS`: "the studio · night", "the sky", "the city"; hidden at <=640px, where it overflowed phones) and the scene plate under `.app-sidebar__brand` (40px closed rail, 64px open). The plate's markup IS `artHtml(mode)`, the picker's door art, exported rather than copied; light mode recolours it to each scene's day (the city is the dark one through `invert(1) hue-rotate(180deg)`). It does not animate.
 - **Always-present tabs widened** (owner, 2026-10-03): `ALWAYS_TABS` is Builders, Collab and Profile, so every mode keeps the You and Community groups.
 - **Governing's header tallies** ("needs you · moving") are task 1004563, not this look.
+
+## The paintbrush (task 1004497)
+
+- **Artistry carries two tools**: the palette (a feedback doc, `page-notes.js`, record `page-notes.md`) and the paintbrush (`paintbrush.js`). Both are `TOOLS` entries in `craft-mode.js` and load their own script on first press.
+- **The paintbrush edits the page's own words where they stand, as a REAL wording change** (owner, 2026-10-04): it is the copy desk's page round, the same one the tweak editor and the studio's own words write (ADR 0341). Pressing it reads `GET /copy-desk/pages/builders:<page>/draft`; a page nobody holds is OFFERED, never taken silently (taking it is the copy desk's artists-only claim, and the page shows as being tweaked while held). Typing saves the whole draft; "Review" lists every change as was/now; "Send for approval" submits the round. It never writes `page-notes` (owner: kept separate from the feedback docs).
+- **Only a leaf element inside `<main>` whose words are one reading line becomes editable.** Shared chrome, a line with a `{…}` hole, controls (`button`, form fields, `code`), and anything hidden stay as they are; the bar counts the lines it cannot reach and links to the tweak editor for them. A click on edited words inside a link does not navigate.
+- **Nobody else's view changes, and neither does yours once editing ends**: "Stop editing" and "Send" both put the page's own words back. The draft stays on the round.
+- **The top bar fits two tools at 390px** because, at phone width, the side packs to a 4px gap, a tool is 28px, the side and the menu do not shrink, and a long page title trims with an ellipsis instead. All 34 hall pages measure 0px of sideways scroll in Artistry at 390px.
+- `tests/paintbrush.mjs` runs the real script and both shared libs over a small page.

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.45",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.21.43",
+      "version": "1.21.45",
       "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.45",
   "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,17 @@
       "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"
+    }
+  ],
+  "1.21.45": [
+    {
+      "id": "1004497",
+      "text": "Artists can now edit any hall page's words right where they stand. In Artistry mode, \"Edit words\" offers to take the page; the words get an underline and can be typed over, a review lists each change as was/now, and \"Send for"
+    }
   ]
 }

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.45'; // 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]);
+});