@bongos/core 1.21.7 → 1.21.8

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

@@ -0,0 +1,364 @@
+// modules/hall-ui/public/street.js — THE STREET, wired (task 1004525, goal
+// 1000125, R03).
+//
+// street-draw.js computes the street as data; this file reads the feeds, hands
+// them to GovStreet.streetModel(), and turns its lists into DOM: SVG paths for
+// the road and the buildings, a span per crate, a name and state line per
+// building, a bracket per group, an <a> door per building and district, a
+// <button> per pin, and an <a> per reading. It owns the light/dark switch, the
+// artboard's fit to the stage, the address (#building= / #district=), and the
+// short matter card a pin opens. No innerHTML anywhere: every node is created,
+// and every docket string lands as text or an attribute.
+//
+// THE FEEDS (all GETs, all gated server-side):
+//   /api/bongos/government/docket          buildings, pins, lines, readings (task 1004523)
+//   /api/bongos/goals                      the open goals: one district each
+//   /api/bongos/goals/rollups              each goal's task counts: its buildings
+//   /api/bongos/builders/<viewer>/earnings your share this month (after the docket names the viewer)
+// A feed that fails leaves its part out (no pins, no districts, "—" for the
+// share) and the page says the docket could not be read; it never draws sample data.
+//
+// THE SWITCH. The hall's own preference ('hall-theme', else the OS) and the
+// hall's own attribute (html[data-theme]), shared with the city and every
+// hall page. The drawing's faces are drawing data in the mode, so a toggle
+// redraws the street from the last feeds (no refetch).
+//
+// MOTION is CSS only (street.css); nothing here animates. The scale write on
+// resize is layout, not motion.
+
+(function () {
+  'use strict';
+  var S = window.GovStreet;
+  var SVG_NS = 'http://www.w3.org/2000/svg';
+  var THEME_KEY = 'hall-theme';
+  var SUN = 'M7 1.5V3M7 11v1.5M1.5 7H3M11 7h1.5M3.1 3.1l1 1M9.9 9.9l1 1M3.1 10.9l1-1M9.9 4.1l1-1M9.5 7A2.5 2.5 0 1 1 4.5 7A2.5 2.5 0 1 1 9.5 7Z';
+  var MOON = 'M11.5 8.6A5 5 0 0 1 5.4 2.5A5 5 0 1 0 11.5 8.6Z';
+  var FEEDS = {
+    docket: '/api/bongos/government/docket',
+    goals: '/api/bongos/goals',
+    rollups: '/api/bongos/goals/rollups',
+    earnings: function (id) { return '/api/bongos/builders/' + encodeURIComponent(id) + '/earnings'; },
+  };
+  // The artboard's street band: the prototype's 900-high board less its 64 px
+  // header and 128 px footer, which this page lays out as real rows.
+  var BAND_TOP = 64, BAND_H = 708;
+  var CARD_W = 390;
+
+  var $ = function (id) { return document.getElementById(id); };
+  var media = window.matchMedia ? window.matchMedia('(prefers-color-scheme: dark)') : null;
+  var data = { docket: null, goals: [], rollups: [], earnings: null, loaded: false };
+  var view = { open: null, opener: null, model: null, scale: 1, mode: null };
+
+  // ---------- light / dark ----------
+  var chosen = null;
+  function storedTheme() {
+    try { var v = window.localStorage.getItem(THEME_KEY); if (v === 'dark' || v === 'light') return v; } catch (_) { /* blocked */ }
+    return chosen;
+  }
+  function effectiveTheme() { return storedTheme() || (media && media.matches ? 'dark' : 'light'); }
+  function paintSwitch(t) {
+    var btn = $('streetMode');
+    var label = t === 'dark' ? 'Switch to light mode' : 'Switch to dark mode';
+    if (btn) { btn.setAttribute('aria-label', label); btn.setAttribute('title', label); }
+    var icon = $('streetModeIcon');
+    if (icon) icon.setAttribute('d', t === 'dark' ? SUN : MOON);
+    var word = $('streetModeWord');
+    if (word) word.textContent = t === 'dark' ? 'light' : 'dark';
+  }
+  function applyTheme() {
+    var t = effectiveTheme();
+    document.documentElement.setAttribute('data-theme', t);
+    paintSwitch(t);
+    return t;
+  }
+  function toggleTheme() {
+    var next = effectiveTheme() === 'dark' ? 'light' : 'dark';
+    chosen = next;
+    try { window.localStorage.setItem(THEME_KEY, next); } catch (_) { /* private mode: this page only */ }
+    applyTheme();
+    draw();
+  }
+  function currentMode() {
+    var t = document.documentElement.getAttribute('data-theme');
+    return t === 'light' || t === 'dark' ? t : effectiveTheme();
+  }
+
+  // ---------- the address ----------
+  function here() { return S.parseHash(window.location && window.location.hash); }
+
+  // ---------- fit the artboard's street band to the stage ----------
+  // 1440 x 708 at scale 1 is the prototype exactly. A wider or taller stage
+  // grows it, a smaller one shrinks it; a phone keeps it near full size and the
+  // street scrolls sideways inside its window, so a pin stays a pin.
+  function fit() {
+    var win = $('streetWindow'), sizer = $('streetSizer'), board = $('streetBoard');
+    if (!win || !sizer || !board) return;
+    var W = view.model ? view.model.width : S.ARTBOARD_W;
+    var cw = win.clientWidth || window.innerWidth || 1440, ch = win.clientHeight || 708;
+    var s = Math.min(cw / W, ch / BAND_H);
+    if (cw / W < 0.6) s = Math.min(1, ch / BAND_H);
+    s = Math.max(0.4, Math.round(s * 1000) / 1000);
+    view.scale = s;
+    sizer.style.width = Math.round(W * s) + 'px';
+    sizer.style.height = Math.round(BAND_H * s) + 'px';
+    board.style.width = W + 'px';
+    board.style.setProperty('--street-scale', String(s));
+    var svg = $('streetSvg');
+    if (svg) { svg.setAttribute('width', String(W)); svg.setAttribute('viewBox', '0 0 ' + W + ' 900'); }
+    placeCard();
+  }
+
+  // ---------- the feeds ----------
+  function getJson(url) {
+    return fetch(url, { credentials: 'same-origin', headers: { accept: 'application/json' } })
+      .then(function (r) { return r && r.ok ? r.json() : null; })
+      .catch(function () { return null; });
+  }
+  function load() {
+    return Promise.all([getJson(FEEDS.docket), getJson(FEEDS.goals), getJson(FEEDS.rollups)]).then(function (res) {
+      data.docket = res[0] && Array.isArray(res[0].matters) ? res[0] : null;
+      data.goals = res[1] && Array.isArray(res[1].goals) ? res[1].goals : [];
+      data.rollups = res[2] && Array.isArray(res[2].rollups) ? res[2].rollups : [];
+      data.loaded = true;
+      draw();
+      var viewer = data.docket && data.docket.viewer && data.docket.viewer.id;
+      if (viewer == null) return null;
+      return getJson(FEEDS.earnings(viewer)).then(function (e) {
+        data.earnings = e && Array.isArray(e.days) ? e : null;
+        draw();
+      });
+    });
+  }
+
+  // ---------- drawing ----------
+  function clear(el) { while (el && el.firstChild) el.removeChild(el.firstChild); }
+  function pathEl(p) {
+    var el = document.createElementNS(SVG_NS, 'path');
+    el.setAttribute('d', p.d);
+    el.setAttribute('fill', p.f);
+    el.setAttribute('stroke', p.s);
+    if (p.dash && p.dash !== 'none') el.setAttribute('stroke-dasharray', p.dash);
+    el.setAttribute('stroke-width', String(p.w || 1));
+    return el;
+  }
+  function node(tag, cls, text) {
+    var el = document.createElement(tag);
+    if (cls) el.className = cls;
+    if (text != null) el.textContent = String(text);
+    return el;
+  }
+  function at(el, x, y, w, h) {
+    el.style.left = x + 'px';
+    el.style.top = y + 'px';
+    if (w != null) el.style.width = w + 'px';
+    if (h != null) el.style.height = h + 'px';
+    return el;
+  }
+
+  function drawPin(p) {
+    var el = node('button', 'street-pin street-pin--' + p.state);
+    el.setAttribute('type', 'button');
+    el.setAttribute('aria-label', p.aria);
+    el.setAttribute('aria-expanded', view.open === p.key ? 'true' : 'false');
+    el.setAttribute('aria-controls', 'streetCard');
+    el.setAttribute('data-matter', p.key);
+    el.setAttribute('data-building', p.building);
+    at(el, p.x, p.y, 110, p.h);
+    var label = node('span', 'street-pin__label', 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.isCount) head.appendChild(node('span', 'street-pin__count', p.count));
+    else {
+      var svg = document.createElementNS(SVG_NS, 'svg');
+      svg.setAttribute('width', '18');
+      svg.setAttribute('height', '18');
+      svg.setAttribute('aria-hidden', 'true');
+      var fill = document.createElementNS(SVG_NS, 'path');
+      fill.setAttribute('d', p.gf || '');
+      var line = document.createElementNS(SVG_NS, 'path');
+      line.setAttribute('d', p.gl || '');
+      svg.appendChild(fill);
+      svg.appendChild(line);
+      head.appendChild(svg);
+    }
+    el.appendChild(head);
+    el.appendChild(node('span', 'street-pin__stem'));
+    el.addEventListener('click', function () { openCard(p.key, el); });
+    return el;
+  }
+
+  function drawSign(sg) {
+    var a = node('a', 'street-sign' + (sg.hot ? ' street-sign--hot' : '') + (sg.here ? ' street-sign--here' : ''));
+    a.setAttribute('href', sg.href);
+    a.setAttribute('aria-label', sg.aria);
+    a.setAttribute('data-reading', sg.key);
+    if (sg.here) a.setAttribute('aria-current', 'location');
+    var top = node('span', 'street-sign__top');
+    top.appendChild(node('span', 'street-sign__dot'));
+    top.appendChild(node('span', 'street-label', sg.label));
+    a.appendChild(top);
+    a.appendChild(node('span', 'street-sign__figure', sg.figure));
+    a.appendChild(node('span', 'street-sign__line', sg.line));
+    return a;
+  }
+
+  function draw() {
+    var mode = currentMode();
+    view.mode = mode;
+    paintSwitch(mode);
+    var m = S.streetModel({ docket: data.docket, goals: data.goals, rollups: data.rollups, earnings: data.earnings, mode: mode, now: Date.now(), here: here() });
+    view.model = m;
+    var flat = $('streetFlat'), blds = $('streetBlds');
+    clear(flat); clear(blds);
+    m.flat.forEach(function (p) { flat.appendChild(pathEl(p)); });
+    m.blds.forEach(function (b) {
+      var g = document.createElementNS(SVG_NS, 'g');
+      g.setAttribute('data-key', b.key);
+      b.polys.forEach(function (p) { g.appendChild(pathEl(p)); });
+      blds.appendChild(g);
+    });
+
+    var crates = $('streetCrates'); clear(crates);
+    m.crates.forEach(function (c) { crates.appendChild(at(node('span', 'street-crate'), c.x, c.y)); });
+
+    var cols = $('streetCols'); clear(cols);
+    m.cols.forEach(function (c) {
+      var el = at(node('div', 'street-col'), c.x, 596, c.w);
+      var name = node('span', 'street-col__name' + (c.strong ? ' street-col__name--strong' : ''), c.name);
+      name.setAttribute('title', c.title);
+      el.appendChild(name);
+      el.appendChild(node('span', 'street-col__state', c.state));
+      cols.appendChild(el);
+    });
+
+    var groups = $('streetGroups'); clear(groups);
+    m.groups.forEach(function (g) {
+      var el = at(node('div', 'street-group'), g.x, 650, g.w);
+      el.appendChild(node('span', 'street-group__bracket'));
+      el.appendChild(node('span', 'street-label', g.name));
+      groups.appendChild(el);
+    });
+
+    var doors = $('streetDoors'); clear(doors);
+    m.doors.forEach(function (d) {
+      var a = at(node('a', 'street-door' + (d.here ? ' street-door--here' : '')), d.x, d.y, d.w, d.h);
+      a.setAttribute('href', d.href);
+      a.setAttribute('aria-label', d.aria);
+      a.setAttribute('data-door', d.key);
+      if (d.here) a.setAttribute('aria-current', 'location');
+      doors.appendChild(a);
+    });
+
+    var pins = $('streetPins'); clear(pins);
+    m.pins.forEach(function (p) { pins.appendChild(drawPin(p)); });
+
+    var signs = $('streetSigns'); clear(signs);
+    m.signs.forEach(function (sg) { signs.appendChild(drawSign(sg)); });
+
+    var hint = $('streetHint');
+    if (hint) { hint.textContent = m.hint; hint.hidden = !m.hint || !!view.open; }
+    var eve = $('streetEvening');
+    if (eve) eve.hidden = !(m.evening && !view.open);
+    var eveLine = $('streetEveningLine');
+    if (eveLine) eveLine.textContent = m.eveningLine;
+
+    $('hudNeeds').textContent = m.hud.needs;
+    $('hudMoving').textContent = m.hud.moving;
+    $('hudShare').textContent = m.hud.share;
+    var dot = $('hudDot');
+    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');
+    var home = $('streetHome');
+    if (home) home.setAttribute('href', S.HOME_HREF);
+
+    fit();
+    if (view.open) fillCard();
+    return m;
+  }
+
+  // ---------- the short matter card ----------
+  function fillCard() {
+    var cv = S.cardFor(data.docket, view.open, Date.now());
+    if (!cv) { closeCard(false); return null; }
+    $('streetCardWhere').textContent = cv.where;
+    $('streetCardWhen').textContent = cv.when;
+    $('streetCardTitle').textContent = cv.title;
+    var meta = $('streetCardMeta');
+    var metaText = [cv.proposer, cv.tally].filter(Boolean).join(' · ');
+    meta.textContent = metaText;
+    meta.hidden = !metaText;
+    var lines = $('streetCardLines');
+    clear(lines);
+    cv.lines.forEach(function (t) { lines.appendChild(node('li', '', t)); });
+    lines.hidden = !cv.lines.length;
+    $('streetCardResult').textContent = cv.result;
+    var open = $('streetCardOpen');
+    if (cv.href) open.setAttribute('href', cv.href);
+    open.hidden = !cv.href;
+    placeCard();
+    return cv;
+  }
+  function placeCard() {
+    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; });
+    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);
+    var cx = pin ? originX + (pin.x + 55) * view.scale : stageW / 2;
+    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) {
+    view.open = key;
+    view.opener = opener || null;
+    var card = $('streetCard');
+    if (!fillCard()) return;
+    card.hidden = false;
+    draw();
+    var close = $('streetCardClose');
+    if (close && close.focus) close.focus();
+  }
+  function closeCard(restore) {
+    var was = view.opener;
+    view.open = null;
+    view.opener = null;
+    var card = $('streetCard');
+    if (card) card.hidden = true;
+    draw();
+    // The pins were redrawn, so focus goes back to the new button for the same matter.
+    if (restore !== false && was && was.getAttribute) {
+      var key = was.getAttribute('data-matter');
+      var pins = $('streetPins').children || [];
+      for (var i = 0; i < pins.length; i++) {
+        if (pins[i].getAttribute('data-matter') === key) { if (pins[i].focus) pins[i].focus(); break; }
+      }
+    }
+  }
+  function onKey(e) {
+    if (e.key === 'Escape' && view.open) { e.preventDefault(); closeCard(true); }
+  }
+
+  function boot() {
+    var btn = $('streetMode');
+    if (btn) btn.addEventListener('click', toggleTheme);
+    var close = $('streetCardClose');
+    if (close) close.addEventListener('click', function () { closeCard(true); });
+    window.addEventListener('keydown', onKey);
+    window.addEventListener('resize', fit);
+    window.addEventListener('hashchange', function () { draw(); });
+    var win = $('streetWindow');
+    if (win) win.addEventListener('scroll', placeCard);
+    if (media && media.addEventListener) media.addEventListener('change', function () { if (!storedTheme()) { applyTheme(); draw(); } });
+    applyTheme();
+    draw();
+    return load();
+  }
+
+  window.GovStreetPage = { boot: boot, draw: draw, load: load, fit: fit, openCard: openCard, closeCard: closeCard, FEEDS: FEEDS, THEME_KEY: THEME_KEY };
+  window.GovStreetPage.ready = boot();
+}());

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

@@ -0,0 +1,43 @@
+{
+  "_": "THE STREET (task 1004525, goal 1000125) through modules/ui-design/kit/render.js. The page draws GET /government/docket, GET /goals, GET /goals/rollups and the viewer's GET /builders/:id/earnings; against the kit's own stub none exists, so every state renders the bare street (the nine civic buildings, no districts, no pins) with the readings saying the docket could not be read: a real state the floors must hold in. To look at the populated street, 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 4625 --fixture-me\n  node modules/ui-design/kit/render.js --states modules/hall-ui/public/street.states.json --base-in http://localhost:4625 --base-out http://localhost:4625\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/street",
+  "surface": "hall-ui",
+  "stub": { "prefix": "/builders/" },
+  "modeQuery": false,
+  "ignoreRequests": ["/api/(gds|bongos)/", "fonts\\.g(oogleapis|static)\\.com"],
+  "ignoreConsole": ["/api/(gds|bongos)/", "\\b401\\b", "\\b403\\b", "\\b404\\b", "Unauthorized", "Forbidden", "Not Found", "load failed", "fonts\\.g(oogleapis|static)\\.com"],
+  "states": {
+    "street": {
+      "auth": true,
+      "_": "The street: the header, the buildings in the order work moves with their names, state lines and group brackets, the pins, and the six readings.",
+      "actions": [["wait", 900]],
+      "expect": { "visible": ["#streetBoard", "#streetSigns", "#streetMode", "#streetHome"], "href": [["#streetHome", "/builders/city"]] }
+    },
+    "card": {
+      "auth": true,
+      "_": "A pin pressed: the matter's short card over the street.",
+      "actions": [["wait", 900], ["click", ".street-pin"], ["wait", 400]],
+      "expect": { "visible": ["#streetCard", "#streetCardClose"] }
+    },
+    "switched": {
+      "auth": true,
+      "_": "The light/dark switch pressed once: the other mode, the street redrawn in it.",
+      "actions": [["wait", 600], ["click", "#streetMode"], ["wait", 400]],
+      "expect": { "visible": ["#streetBoard", "#streetSigns"] }
+    },
+    "here": {
+      "auth": true,
+      "_": "Arrived through a door: the address names the Charter, so its door and the readings that open it are marked.",
+      "url": "/builders/street#building=charter",
+      "actions": [["wait", 900]],
+      "expect": { "visible": ["#streetBoard"] }
+    },
+    "focus": {
+      "auth": true,
+      "_": "Keyboard: the wordmark back to the city focused, its ring drawn.",
+      "actions": [["wait", 600], ["focus", "#streetHome"], ["wait", 100]],
+      "expect": { "activeId": "streetHome" }
+    }
+  },
+  "reducedMotion": { "auth": true, "actions": [["wait", 600]] }
+}

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

@@ -0,0 +1,14 @@
+# The Governor City's street — /street, the six readings, and the doors to the interiors (task 1004525)
+
+**R03 of goal 1000125.** Built 1:1 on the street view of the reference design [`docs/design/mocks/governor-city/Street.dc.html`](../../../docs/design/mocks/governor-city/README.md): one front-on row in the order work moves under five group brackets, a name and one state line under every building, pins with their labels always showing, work queued at Review as crates by its door, the header (wordmark back to the city, needs you, moving, your share this month, the light/dark switch) and the six readings along the bottom. The home city (`/city`, task 1004524) links here from start governing.
+
+Files: `street-draw.js` (the prototype's front-on kit and street layout, verbatim, as pure data: `window.GovStreet`, node-require-safe), `street.js` (the page: feeds, nodes, the switch, the address, the short card) and `street.css` (the template's styles on the hall's tokens). It reuses `city-draw.js` for the decision glyphs, the seeded random and `rulesAtWork`, which the city now also uses to light the Rules band.
+
+What it settled:
+
+- **Standalone, like the city.** No hall sidebar or top bar; it is the second entry in `tests/hall_audit.mjs`'s `STANDALONE_EXEMPT`, with the city's reason. It still loads `style.css` and reads and writes the hall's own `hall-theme`.
+- **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 task 1004526 builds the interiors; until then the street marks the building the address names. A pin opens the matter's short card (task 1004528 makes it act); its link is offered only for an on-site path.
+
+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.7",
+  "version": "1.21.8",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.21.7",
+      "version": "1.21.8",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.21.7",
+  "version": "1.21.8",
   "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

@@ -8794,5 +8794,15 @@
       "id": "1004503",
       "text": "When you start a project, the invite box now waits until your project is actually up, because nobody can join before then. Until it is, one line says when you can invite, and a demo's teammates are kept ready for that moment."
     }
+  ],
+  "1.21.8": [
+    {
+      "id": "1004525",
+      "text": "The city's start governing button now opens the governor's street. Every part of the project's government stands as a building in one row, in the order work moves, with a building for each open goal. A pin with its label stand"
+    },
+    {
+      "id": "1004441",
+      "text": "Checked and signed off on the live site: artists and ideators now read as their own craft on profiles, the builders list and the status page. Their earnings charts show, and builders can choose their main role in Settings."
+    }
   ]
 }

package/src/bongos/serve-internal.js

@@ -951,6 +951,14 @@ function mountInternalSurfaces(app) {
   // NB as at PROJECT_SETTINGS_PAGE_RE: nothing between the `=` and the literal
   // (tests/hall_page_gate_map.mjs parses this file statically). Prose goes above.
   const CITY_PAGE_RE = /^\/builders\/city(?:\.html)?\/?$/;
+  // /street — the Governor City's street (task 1004525), the city's one door.
+  // The same atom for the same reason: its governed read is the same docket.
+  // Its other reads (goals, rollups, the viewer's own earnings) are
+  // requireBuilder, a wider floor.
+  //
+  // NB as at PROJECT_SETTINGS_PAGE_RE: nothing between the `=` and the literal
+  // (tests/hall_page_gate_map.mjs parses this file statically). Prose goes above.
+  const STREET_PAGE_RE = /^\/builders\/street(?:\.html)?\/?$/;
   // /deploy — the owner's deploy door (task 1003159, ADR 0293). Gated on the
   // `core.pin.move` atom, the same key its preview and its move both check, so the
   // shell's reach equals the right to press the button. Archon-floor and system:true,
@@ -1037,6 +1045,10 @@ function mountInternalSurfaces(app) {
     if (CITY_PAGE_RE.test(norm)) {
       return gdsAuth.requireBoardVotePage(req, res, next);
     }
+    // task 1004525: the street, on the same atom (see STREET_PAGE_RE).
+    if (STREET_PAGE_RE.test(norm)) {
+      return gdsAuth.requireBoardVotePage(req, res, next);
+    }
     // ADR 0293: the deploy door, on the same atom its two routes check.
     if (DEPLOY_PAGE_RE.test(norm)) {
       return gdsAuth.requireCorePinPage(req, res, next);

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.7'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.21.8'; // 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_audit.mjs

@@ -378,7 +378,15 @@ test('the module doc still records where the 2179 density pass landed', () => {
 // the hall's own 'hall-theme' preference. Whether it should join the chrome
 // behind the full-screen switch, as the sky did in task 1004327, is the
 // owner's call, named in that task's ship notes.
-const STANDALONE_EXEMPT = { 'city.html': 'the governor city home: nothing on the page but the prototype home (task 1004524)' };
+// THE STREET (task 1004525) follows the city, for the same reason: the
+// reference design's street view shows nothing on the page but its own header
+// (the wordmark back to the city, needs you, moving, your share, the switch),
+// the street and the six readings. Same terms as the city: style.css and the
+// hall's tokens, the hall's own 'hall-theme' preference, no private palette.
+const STANDALONE_EXEMPT = {
+  'city.html': 'the governor city home: nothing on the page but the prototype home (task 1004524)',
+  'street.html': 'the governor street: nothing on the page but the prototype street view (task 1004525)',
+};
 
 test('every hall page loads style.css and shell.js', () => {
   const missing = [];

package/tests/hall_page_gate_map.mjs

@@ -144,6 +144,9 @@ const ORACLE = {
   // governed read, GET /government/docket, checks board.vote.cast, so the page's
   // reach equals the right to read the docket it draws.
   '/builders/city': 'requireBoardVotePage',
+  // task 1004525: the street, the city's one door, on the same atom for the
+  // same reason (its governed read is the same docket).
+  '/builders/street': 'requireBoardVotePage',
 
   // Deliberately UNGATED — the landing card, the rank ladder, the reward
   // schedule and a builder's public portfolio all render for a stranger.