@bongos/core 1.25.30 → 1.25.32

package/modules/hall-ui/records/welcome-tower.md

@@ -1,15 +1,21 @@
 # The welcome — Home's first visit of the day (tasks 1004785, 1004818)
 
 The owner's Builders' Hall idea 1001262, second half (the first is [`home-reshuffle.md`](home-reshuffle.md)).
-Files: `public/welcome-boot.js` + `public/welcome-boot.css`, and the owner's two paintings
-`public/welcome-day.webp` / `public/welcome-night.webp`, on Home only.
+Files: `public/welcome-boot.js` + `public/welcome-boot.css`, on Home only. The scene is drawn by
+Home's own city painters (`sky-time.js`, `city-draw.js`, `home-city-draw.js`).
 
 **How the look got here (2026-10-23, one day of owner rounds).** Task 1004785 built v5 "the tower"
 ([`docs/design/mocks/hall/welcome/v5.src.html`](../../../docs/design/mocks/hall/welcome/v5.src.html)),
 drawn live from the Repo Atlas. The owner then asked for day and night and a slow way out, then
 swapped the tower for a glowing module city with a lunch crew on a beam, dropped the crew, and
 finally had Gemini paint the city by day and by night and asked for those to be animated (task
-1004818). The atlas-drawn scene is gone; the painting is the scene.
+1004818). The atlas-drawn scene is gone.
+
+**The painting is retired too (task 1005308, owner 2026-11-14: "retire it everywhere").** The scene
+is now the city in the clouds from task 1005196, the same city Home and the City page draw, in the
+hour's sky. The two WebP paintings and every light that was pinned to their pixels (the circuit
+towers' pulses, the hover cars, the moon and stars) are deleted. The game's start and load screens
+stand on the same scene (`records/start-screen.md`).
 
 - **When.** A signed-in builder's first Home load of the LOCAL day, per builder id
   (`localStorage['hall-welcome-day:<id>']`). Storage that throws is never shown it, because it could not
@@ -20,15 +26,16 @@ finally had Gemini paint the city by day and by night and asked for those to be
   `welcome-boot.js` loads before the `shell-trail.js` / `craft-mode.js` / `shell.js` trio, which
   `tests/craft_mode.mjs` keeps adjacent.
 - **Day and night.** `timeOfDay` makes 06:00 to 17:59 local `day`, the rest `night`; the root wears
-  `.wb--day` or `.wb--night` and shows the matching painting. It opens from a veil (`.wb__veil`),
-  white by day and black by night, that lifts once the painting has loaded (or after 1.5s).
-- **The motion is laid on the painting, in its own pixels.** `.wb__art` covers the screen at the
-  paintings' 1024x572 shape (both share one layout), so the SVG over it (`viewBox 0 0 1024 572`) keeps
-  every light on its mark however the screen crops: `TOWERS` (the circuit towers, where `pulseRuns`
-  climbs), `BEACONS` (mast lights, night), `LANES` (hover cars), the moon and stars (night), plus a
-  slow drift of the whole picture and two clouds. **A new painting must keep that layout, or the
-  coordinates in welcome-boot.js move with it** — `tests/welcome_boot.mjs` checks both files are
-  1024x572 WebP.
+  `.wb--day` or `.wb--night`, which sets the ink. It opens from a veil (`.wb__veil`), white by day
+  and black by night, that lifts two frames after the scene is painted (or after 1.5s). The scene's
+  own colours follow the hour more finely (`sky-time.js`: night, dawn, midday, dusk, blended).
+- **The scene is the city, as a backdrop.** `paintScene(host)` asks `OTBHomeCityDraw.citySvg` for an
+  empty week (the Cloud Bongos core and the museum, standing in cloud) and rewrites it with
+  `sceneShape`: every link becomes a plain group, tooltips and goal hooks are dropped, the faded
+  `hc-quiet` look is lifted so the core leads, and every id is prefixed `cs-` so it never meets the
+  ids of Home's own city on the same page. It covers the screen, standing on the bottom edge
+  (`xMidYMax slice`), over `.cloud-scene`'s sky gradient, with a slow drift and two clouds. The same
+  `paintScene` is handed to the game's start screen as `scene`.
 - **Banner.** "Working on the core of <project>" from `__BRANDING__.identity` (never a hardcoded word),
   with `core <version>` under it when the public `GET /version` reports one.
 - **Sequence.** Veil lifts, the city powers up (pulses brighten), the greeting comes up at ~3.4s.
@@ -40,11 +47,13 @@ finally had Gemini paint the city by day and by night and asked for those to be
   Artisan → stays on Home (the Ideator door, once `/thinking`, folded into Artist). A pick also calls
   `OTBCraftMode.choose()` with patron / artist / artisan. **Patron shows only where
   `OTBCraftMode.offered('patron')`** — the patron craft is a seat — and the list is built when "Start with your role" is pressed, after the seats have settled.
-- **No painting** (a 404) hides the image and leaves the sky gradient; everything else works.
-- **Colours are the paintings'**, in both hall themes: `welcome-boot.css` and `welcome-boot.js` are on
-  `tests/hall_audit.mjs`'s literal exemptions with that reason.
-- **Tests.** `tests/welcome_boot.mjs` (the day rule, the paintings' files and shape, every light inside
-  the painting and every pulse inside its tower, the banner, the role map, the load order);
-  `tests/welcome_boot_browser.mjs` runs Home's markup with the real shell, craft mode, welcome and
-  paintings in a browser: once a day, Skip, Esc, no double picker, the seat rule, no painting, reduced
-  motion, the veil by day and night, the slow exit, and that the old drawn scene is gone.
+- **No city painters** on the page: the root wears `.wb--bare`, the hour's sky gradient stands alone,
+  and everything else works.
+- **The scene's colours are the hour's sky tokens only** (`--sky-now-*`); the welcome's ink, veil and
+  panels keep their fixed day/night literals, on `tests/hall_audit.mjs`'s literal exemptions.
+- **Tests.** `tests/welcome_boot.mjs` (the day rule, that the painting and its lights are gone, the
+  scene's shapes with no door, no unprefixed id and no typed colour, the banner, the role map, the
+  load order); `tests/welcome_boot_browser.mjs` runs Home's markup with the real shell, craft mode,
+  welcome and city painters in a browser: once a day, Skip, Esc, no double picker, the seat rule, no
+  painters, reduced motion, the city in the hour's sky by day and night, the slow exit, and that the
+  painting's lights are gone.

package/modules/lifecycle/routes/tasks.js

@@ -219,7 +219,7 @@ module.exports = function buildTasksRouter() {
     // RETURNED feed, never the query — lifecycle/CLAUDE.md has the why.
     const claimNeeds = parseNeedsFilter(req.query.needs); if (claimNeeds && claimNeeds.bad) return badNeedsFilter(res); // task 1004950
     const claimLimit = posInt(req.query.limit, 'bad_limit', 1000);
-    if (claimLimit && claimLimit.bad) return res.fail('bad_limit', { status: 400, message: 'limit must be a positive integer (max 1000).' });
+    if (claimLimit && claimLimit.bad) return res.fail('bad_limit', { status: 400, message: 'limit must be a positive integer (max 1000).' }); if (req.query.view === 'claims') return res.json({ active_claims: await db.listActiveClaims() }); // open claims only, no claimable feed: the street needs just these (task 1005310)
     const [feed, active] = await Promise.all([
       db.listClaimableTasks({
         versionId: version || null, builderId: req.builder.id,

package/package-lock.json

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

package/package.json

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

@@ -11955,5 +11955,17 @@
       "id": "1005307",
       "text": "Choosing Patron in game mode no longer reloads the hall endlessly; it settles on the city."
     }
+  ],
+  "1.25.31": [
+    {
+      "id": "1005310",
+      "text": "The governor's street asks the server for less and gets its answers sooner."
+    }
+  ],
+  "1.25.32": [
+    {
+      "id": "1005308",
+      "text": "The old circuit-city painting is gone. The welcome screen and the game's start screens now open on the city in the clouds, coloured for the time of day: deep night with lit windows, a warm dawn, a bright midday."
+    }
   ]
 }

package/src/module-api.js

@@ -81,7 +81,7 @@ const { sleep } = require('./sleep');
 // MAJOR (see allowBoxScope below): passes the request through untouched.
 function deprecatedNoopMiddleware(_req, _res, next) { next(); }
 
-const CORE_VERSION = '1.25.30'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.25.32'; // 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/docket_load_speed.mjs

@@ -0,0 +1,99 @@
+// tests/docket_load_speed.mjs — the governor's street loads faster (task 1005310).
+//
+// Measured on the live hub: the street asked for GET /government/docket and
+// GET /government/counts together, counts rebuilt the same docket, and each build
+// waited for the government reads before it even started its sources. Three
+// properties now hold, and each is driven here against the real docket.js:
+//   1. two asks for the SAME viewer while a build runs share that one build, and
+//      nothing is kept once it finishes (no cache: the next ask builds afresh);
+//   2. the sources start reading before the government reads have answered;
+//   3. a government read that fails is never an unhandled rejection while the
+//      sources are still reading, and the docket still answers or fails as before.
+// And the street's claims read (GET /tasks/claimable?view=claims) answers only the
+// open claims, without building the claimable feed.
+import { strict as assert } from 'node:assert';
+import { test, after } from 'node:test';
+import fs from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const require = createRequire(import.meta.url);
+const api = require(path.join(ROOT, 'src', 'module-api.js'));
+const docket = require(path.join(ROOT, 'modules', 'government', 'docket.js'));
+const board = require(path.join(ROOT, 'modules', 'government', 'board.js'));
+const resolver = require(path.join(ROOT, 'modules', 'government', 'resolver.js'));
+const read = (p) => fs.readFileSync(path.join(ROOT, p), 'utf8');
+
+const REAL = { perms: resolver.resolveBuilderPermissions, rules: board.decisionRulesView };
+after(() => { resolver.resolveBuilderPermissions = REAL.perms; board.decisionRulesView = REAL.rules; });
+
+const order = [];
+let permReads = 0;
+// The docket's own atom only: no government gate, so no government tables are read.
+resolver.resolveBuilderPermissions = async () => { permReads += 1; return ['board.vote.cast']; };
+board.decisionRulesView = () => new Promise((r) => setTimeout(() => { order.push('decisions'); r(null); }, 40));
+api.contribute(docket.CONTRIBUTION_POINT, {
+  source: 'blockers', building: 'planning', gate: { anyBuilder: true },
+  read: async () => { order.push('source'); return []; },
+});
+
+test('two asks for one viewer while a build runs share it; the next ask builds afresh', async () => {
+  permReads = 0;
+  const viewer = { id: 7001, rank: 'metic' };
+  const [a, b] = await Promise.all([docket.docketFor(viewer), docket.docketFor({ ...viewer })]);
+  assert.equal(permReads, 1, 'one build for both asks');
+  assert.equal(a, b, 'both asks receive the same answer');
+  await docket.docketFor(viewer);
+  assert.equal(permReads, 2, 'a finished build is not kept: the next ask builds again');
+  await Promise.all([docket.docketFor({ id: 7002 }), docket.docketFor({ id: 7003 })]);
+  assert.equal(permReads, 4, 'different viewers never share a build');
+});
+
+test('the sources start reading before the government reads answer', async () => {
+  order.length = 0;
+  await docket.docketFor({ id: 7004, rank: 'metic' });
+  assert.deepEqual(order, ['source', 'decisions']);
+});
+
+const VIEWER = { id: 42, rank: 'metic' };
+const NOW = Date.parse('2026-11-14T12:00:00Z');
+const slowSource = (ms) => ({
+  sources: new Map([['blockers', { source: 'blockers', building: 'planning', gate: { anyBuilder: true },
+    read: () => new Promise((r) => setTimeout(() => r([{ id: 1, title: 'Pick a host', state: 'needs', rule: 'decide' }]), ms)) }]]),
+  readings: new Map(), floors: new Map(), histories: new Map(), desks: new Map(),
+});
+
+test('a government read handed in as a promise answers exactly as its value does', async () => {
+  const plain = await docket.buildDocket({ viewer: VIEWER, permissions: ['board.vote.cast'], contributions: slowSource(1), now: NOW, decisions: [], government: null, seats: null });
+  const later = await docket.buildDocket({ viewer: VIEWER, permissions: ['board.vote.cast'], contributions: slowSource(1), now: NOW,
+    decisions: Promise.resolve([]), government: Promise.resolve(null), seats: Promise.resolve(null) });
+  assert.deepEqual(later, plain);
+});
+
+test('a failed government read is never an unhandled rejection while the sources read', async () => {
+  const unhandled = [];
+  const onUnhandled = (e) => unhandled.push(e);
+  process.on('unhandledRejection', onUnhandled);
+  try {
+    const boom = new Error('government unreadable');
+    await assert.rejects(docket.buildDocket({ viewer: VIEWER, permissions: ['board.vote.cast'], contributions: slowSource(30), now: NOW,
+      decisions: Promise.resolve(null), government: Promise.reject(boom), seats: Promise.resolve(null) }), /government unreadable/);
+    await new Promise((r) => setTimeout(r, 20));
+    assert.deepEqual(unhandled, []);
+  } finally {
+    process.off('unhandledRejection', onUnhandled);
+  }
+});
+
+test('the claims read answers the open claims without building the claimable feed', () => {
+  const src = read('modules/lifecycle/routes/tasks.js');
+  const at = src.indexOf("req.query.view === 'claims'");
+  assert.ok(at > 0, 'GET /tasks/claimable has a claims-only view');
+  assert.ok(at < src.indexOf('db.listClaimableTasks({', at - 2000), 'it answers before the claimable feed is built');
+  assert.match(src.slice(at, at + 200), /active_claims: await db\.listActiveClaims\(\)/);
+  for (const f of ['modules/hall-ui/public/gov-feeds.js', 'modules/hall-ui/public/city.js']) {
+    assert.match(read(f), /tasks\/claimable\?view=claims/, `${f} asks for the claims alone`);
+  }
+});

package/tests/hall_city_living.mjs

@@ -488,7 +488,7 @@ async function bootLiving({ asks = false, answer = null } = {}) {
   const feeds = {
     '/api/bongos/government/docket': asks ? withAsks(docketRouted()) : docketRouted(), '/api/bongos/goals': fx('goals'), '/api/bongos/goals/rollups': fx('goals__rollups'),
     '/api/bongos/government/leads': leadsRead(), '/api/bongos/government/treasury': fx('government__treasury'),
-    '/api/bongos/government/constitution': fx('government__constitution'), '/api/bongos/tasks/claimable?limit=1': fx('tasks__claimable'),
+    '/api/bongos/government/constitution': fx('government__constitution'), '/api/bongos/tasks/claimable?view=claims': fx('tasks__claimable'),
     '/api/bongos/tasks?status=active&limit=200': fx('tasks__status-active'), '/api/bongos/public/cost-summary': fx('public__cost-summary'),
     '/api/bongos/builders/roster': fx('builders__roster'), '/api/bongos/me': fx('me'), '/api/bongos/blockers?limit=100': fx('blockers'),
     '/api/bongos/autonomy/fence': fx('autonomy__fence'), '/api/bongos/moving': fx('moving'),

package/tests/hall_gov_counts.mjs

@@ -172,7 +172,7 @@ test('in the harness COUNT_FEEDS, with the docket the page already read, give th
   assert.equal(L.countsOf(m, s).on_others, L.countsOf(m).on_others - 1);
   // and nothing the shell reads is a task list
   assert.ok(!F.COUNT_FEEDS.includes('tasks') && !F.COUNT_FEEDS.includes('goals'), 'the tally reads no task or goal list');
-  assert.match(F.FEEDS.claims, /limit=1\b/, 'the claims ride the claimable feed at one row');
+  assert.match(F.FEEDS.claims, /[?&]view=claims\b/, 'the claims ride the claims-only view of the claimable route (task 1005310)');
 });
 
 // ── 3. every surface prints the same numbers ────────────────────────────────

package/tests/hall_gov_real_site.mjs

@@ -197,7 +197,7 @@ const FEED = {
   '/api/bongos/government/docket': 'government__docket', '/api/bongos/government/counts': 'government__counts', '/api/bongos/goals': 'goals', '/api/bongos/goals/rollups': 'goals__rollups',
   '/api/bongos/me': 'me', '/api/bongos/builders/roster': 'builders__roster', '/api/bongos/blockers': 'blockers',
   '/api/bongos/public/cost-summary': 'public__cost-summary', '/api/bongos/tasks/claimable': 'tasks__claimable',
-  '/api/bongos/tasks/claimable?limit=1': 'tasks__claimable', '/api/bongos/tasks?status=active&limit=200': 'tasks__status-active',
+  '/api/bongos/tasks/claimable?view=claims': 'tasks__claimable', '/api/bongos/tasks?status=active&limit=200': 'tasks__status-active',
   '/api/bongos/blockers?limit=100': 'blockers', '/api/bongos/moving': 'moving', '/api/bongos/autonomy/fence': 'autonomy__fence',
   '/api/bongos/government/constitution': 'government__constitution',
   // the hub's law book, as the route answers it (no law passed yet)

package/tests/hall_sky_time.mjs

@@ -112,8 +112,9 @@ test('the sky tokens are art: no control, no text and no chrome spends one', ()
       const sel = m[1].trim();
       if (f === 'style.css' && /(^|\n):root$/.test(sel)) continue; // the token block itself
       // only the two scenes spend them: the City page's frame, stage and cloud; Home's scene, its
-      // stage, and (in game mode) the ground of the Home view
-      if (!/^(\.city-frame|\.city-stage|\.city-cloud|\.city-stars|\.hc-svg|\.hc-cloud|\.hc-stage|html\[data-game="on"\] body\[data-page="home"\]$)/.test(sel)) { hits.push(`${f}: ${sel}`); continue; }
+      // stage, and (in game mode) the ground of the Home view; and the cloud scene behind the welcome
+      // and the game's start screens (task 1005308)
+      if (!/^(\.city-frame|\.city-stage|\.city-cloud|\.city-stars|\.hc-svg|\.hc-cloud|\.hc-stage|\.cloud-scene|html\[data-game="on"\] body\[data-page="home"\]$)/.test(sel)) { hits.push(`${f}: ${sel}`); continue; }
       for (const d of m[2].split(';')) {
         const prop = d.split(':')[0].trim();
         if (/--sky-/.test(d) && (prop === 'color' || /^border|^outline|^caret|^text-/.test(prop))) hits.push(`${f}: ${sel} { ${prop} }`);

package/tests/hall_start_screen.mjs

@@ -95,13 +95,14 @@ test('the load screen fills one segment per week, up to the week it is showing (
   assert.equal(G.segsDone(0, 0), 0);
 });
 
-test('a fresh sign-in is handed to the start screen with the still, and the craft picker waits for the world', () => {
+test('a fresh sign-in is handed to the start screen with the city in the clouds, and the craft picker waits for the world', () => {
   const s = sandbox({ store: { 'hall-welcome-signin': '1' } });
   const access = { authed: true }, builder = { id: 7, display_name: 'Ada' };
   assert.equal(s.window.OTBWelcome.onAccess(access, builder), true, 'the shell is told a screen is up, so it asks no picker');
   assert.equal(s.started.length, 1);
   assert.equal(s.started[0].name, 'Harbor');
-  assert.match(s.started[0].art, /^\/builders\/welcome-(day|night)\.webp$/);
+  assert.equal(typeof s.started[0].scene, 'function', 'the scene is painted, not a picture (task 1005308)');
+  assert.equal(s.started[0].art, undefined, 'the circuit-city painting is retired');
   assert.equal(s.store['hall-welcome-signin'], undefined, 'the flag is spent');
   assert.deepEqual(s.asked, [], 'nothing is asked while the start screen is up');
   s.started[0].done();

package/tests/hall_street_deck.mjs

@@ -411,7 +411,7 @@ const FEED = {
   '/api/bongos/me': 'me', '/api/bongos/builders/roster': 'builders__roster',
   '/api/bongos/blockers': 'blockers', '/api/bongos/public/cost-summary': 'public__cost-summary',
   // the living model's reads, as gov-feeds.js names them (one read each per page)
-  '/api/bongos/tasks/claimable?limit=1': 'tasks__claimable', '/api/bongos/tasks?status=active&limit=200': 'tasks__status-active',
+  '/api/bongos/tasks/claimable?view=claims': 'tasks__claimable', '/api/bongos/tasks?status=active&limit=200': 'tasks__status-active',
   '/api/bongos/blockers?limit=100': 'blockers', '/api/bongos/moving': 'moving', '/api/bongos/autonomy/fence': 'autonomy__fence',
   '/api/bongos/government/constitution': 'government__constitution', '/api/bongos/government/leads': 'government__leads',
 };

package/tests/hall_street_depth.mjs

@@ -471,7 +471,7 @@ async function bootPage({ withLiving = true } = {}) {
   const F = {
     '/api/bongos/government/docket': docketRouted(), '/api/bongos/goals': fx('goals'), '/api/bongos/goals/rollups': fx('goals__rollups'),
     '/api/bongos/government/leads': leadsRead(),
-    '/api/bongos/tasks/claimable?limit=1': fx('tasks__claimable'), '/api/bongos/tasks?status=active': fx('tasks__status-active'),
+    '/api/bongos/tasks/claimable?view=claims': fx('tasks__claimable'), '/api/bongos/tasks?status=active': fx('tasks__status-active'),
     '/api/bongos/public/cost-summary': fx('public__cost-summary'), '/api/bongos/builders/roster': fx('builders__roster'), '/api/bongos/me': fx('me'),
     // the living model's reads, as gov-feeds.js names them
     '/api/bongos/tasks?status=active&limit=200': fx('tasks__status-active'), '/api/bongos/blockers?limit=100': fx('blockers'),
@@ -493,7 +493,7 @@ test('the page draws the living street: the skyline, a pod per claim, the plates
   const p = await bootPage();
   const all = (id) => walk(p.byId.get(id));
   const cls = (id, c) => all(id).filter((e) => (e.className || '').split(' ').includes(c));
-  for (const u of ['/api/bongos/tasks/claimable?limit=1', '/api/bongos/government/leads']) assert.ok(p.calls.includes(u), u);
+  for (const u of ['/api/bongos/tasks/claimable?view=claims', '/api/bongos/government/leads']) assert.ok(p.calls.includes(u), u);
   assert.ok(!p.calls.some((u) => /governor-overlay/.test(u)), 'no overlay is read');
   assert.equal(p.calls.filter((u) => u === '/api/bongos/me').length, 1, 'the living feeds are read once');
   assert.equal(cls('streetDepthNear', 'street-depth-sil__face').length, 1);

package/tests/welcome_boot.mjs

@@ -1,8 +1,8 @@
 // tests/welcome_boot.mjs — the welcome's pure parts (tasks 1004785, 1004818).
 //
 // WHY. The welcome decides things a reader would only notice going wrong over days: whether today
-// is the first visit, whether it is day or night (and so which painting), what the banner names,
-// where each role goes, and whether the motion still sits on the painting. Those are pure, so this
+// is the first visit, whether it is day or night, what the banner names, where each role goes,
+// and that the scene is the city in the clouds with its doors taken out (task 1005308). Those are pure, so this
 // runs the REAL welcome-boot.js (it is Node-require-safe). The overlay itself is
 // tests/welcome_boot_browser.mjs.
 import assert from 'node:assert/strict';
@@ -39,40 +39,48 @@ test('the greeting follows the local hour, and the name falls back sensibly', ()
   assert.equal(W.nameOf({}), 'builder');
 });
 
-test('day is 06:00 to 17:59 local, night the rest, and each has its painting (task 1004818)', () => {
+test('day is 06:00 to 17:59 local, night the rest (the ink and the veil follow it)', () => {
   const at = (h, m = 0) => W.timeOfDay(new Date(2026, 9, 23, h, m));
   assert.deepEqual([at(5, 59), at(6), at(12), at(17, 59), at(18), at(23, 30), at(0)],
     ['night', 'day', 'day', 'day', 'night', 'night', 'night']);
-  assert.equal(W.artFor('day'), '/builders/welcome-day.webp');
-  assert.equal(W.artFor('night'), '/builders/welcome-night.webp');
 });
 
-test('both paintings ship, as WebP, in the one shape the motion is laid out for', () => {
-  for (const url of Object.values(W.ART)) {
-    const file = path.join(HALL, url.replace(/^\/builders\//, ''));
-    const buf = fs.readFileSync(file);
-    assert.equal(buf.toString('latin1', 0, 4) + buf.toString('latin1', 8, 12), 'RIFFWEBP', url + ' is a WebP');
-    assert.ok(buf.length < 400 * 1024, url + ' stays small enough for a first paint');
-    // The VP8X header carries the canvas size (24-bit, minus one) at bytes 24..29.
-    assert.equal(buf.toString('latin1', 12, 16), 'VP8X', url + ' carries its size');
-    const w = 1 + buf.readUIntLE(24, 3), h = 1 + buf.readUIntLE(27, 3);
-    assert.deepEqual([w, h], [W.AW, W.AH], url + ' is the painting the lights were placed on');
+// Task 1005308 (owner, 2026-11-14): the circuit-city painting is retired everywhere; the scene is the
+// city in the clouds Home's own painters draw (task 1005196), as a backdrop.
+test('the circuit-city painting is retired: no picture file, no lights pinned to its pixels', () => {
+  for (const name of ['welcome-day.webp', 'welcome-night.webp']) assert.equal(fs.existsSync(path.join(HALL, name)), false, name + ' is gone');
+  for (const gone of ['ART', 'artFor', 'TOWERS', 'LANES', 'AW', 'AH', 'pulseRuns', 'BEACONS']) assert.equal(W[gone], undefined, gone + ' went with the painting');
+  for (const file of ['welcome-boot.js', 'welcome-boot.css', 'shell-game.js', 'shell-game.css', 'index.html']) {
+    assert.doesNotMatch(fs.readFileSync(path.join(HALL, file), 'utf8'), /welcome-(day|night)\.webp|wb__img|gs__img|wb-motion/, file + ' names no part of the painting');
   }
 });
 
-test('every light sits inside the painting, and every pulse climbs inside its tower', () => {
-  const inside = ([x, y]) => x >= 0 && x <= W.AW && y >= 0 && y <= W.AH;
-  assert.equal(W.BEACONS, undefined, 'the blinking mast lights are gone (task 1005087)');
-  for (const t of W.TOWERS) assert.ok(inside([t.x, t.y]) && inside([t.x + t.w, t.y + t.h]), 'tower inside the painting');
-  const runs = W.pulseRuns(W.TOWERS, 3, 7);
-  assert.equal(runs.length, W.TOWERS.length * 3);
-  for (const r of runs) {
-    const t = W.TOWERS[r.tower];
-    assert.ok(r.x >= t.x && r.x <= t.x + t.w, 'a pulse runs up its own tower');
-    assert.ok(r.y1 > r.y0 && r.y0 >= t.y && r.y1 <= t.y + t.h, 'bottom to top, within the tower');
-    assert.ok(r.dur > 0 && r.delay >= 0);
+test("the scene is the city in the clouds, drawn by Home's own painters, with every door taken out", async () => {
+  const vm = await import('node:vm');
+  const ctx = { window: {}, console };
+  vm.createContext(ctx);
+  vm.runInContext(fs.readFileSync(path.join(HALL, 'city-draw.js'), 'utf8'), ctx);
+  const Gov = ctx.window.GovCity;
+  const Draw = require(path.join(HALL, 'home-city-draw.js'));
+  assert.ok(Gov && Draw, 'the painters load');
+  const s = W.sceneShapes(Draw, Gov);
+  assert.match(s.viewBox, /^0 0 1000 \d+$/);
+  const all = [];
+  (function walk(n) { all.push(n); n.kids.forEach(walk); })({ tag: 'root', attrs: {}, kids: s.nodes });
+  assert.ok(all.some((n) => /hc-cloud/.test(n.attrs.class || '')), 'it stands in cloud');
+  assert.ok(all.filter((n) => n.tag === 'path').length > 50, 'the core and the museum are drawn');
+  assert.equal(all.filter((n) => n.tag === 'a').length, 0, 'no link: it is a backdrop');
+  for (const n of all) {
+    for (const k of ['href', 'tabindex', 'aria-label', 'data-tip', 'data-tip-body', 'data-goal']) assert.equal(n.attrs[k], undefined, k + ' is taken out');
+    if (n.attrs.id) assert.ok(n.attrs.id.startsWith(W.SCENE_ID), "its ids never meet Home's own city's");
+    for (const v of Object.values(n.attrs)) assert.doesNotMatch(String(v), /url\(#(?!cs-)/, 'every reference points at its own prefixed id');
+    assert.doesNotMatch(n.attrs.class || '', /hc-quiet/, 'nothing is faded: the core leads');
   }
-  assert.deepEqual(W.pulseRuns(W.TOWERS, 3, 7), runs, 'seeded: every visit draws the same picture');
+  const json = JSON.stringify(s);
+  assert.doesNotMatch(json, /#[0-9a-f]{6}\b/i, "no typed colour: the hour's sky tokens only");
+  assert.match(json, /--sky-now-/, "it paints in the hour's sky");
+  assert.equal(W.sceneShapes(null, Gov), null, 'no painters: no city, and the sky stands alone');
+  assert.equal(W.paintScene(null), false);
 });
 
 test('the banner is the logo, named from the branding pack, never a hardcoded word (task 1004953)', () => {

package/tests/welcome_boot_browser.mjs

@@ -1,9 +1,9 @@
 // tests/welcome_boot_browser.mjs — the welcome in a real browser (tasks 1004785, 1004818).
 //
 // WHY. "Once a day", "Skip", "the craft picker does not also open", "Patron only with a seat", the day
-// and night paintings and the slow way out are behaviour across the real shell.js, craft-mode.js and
+// and night veils over the city in the clouds and the slow way out are behaviour across the real shell.js, craft-mode.js and
 // welcome-boot.js together — the shell is what decides which of the two greets a builder — so this
-// serves the REAL Home markup, the REAL hall scripts and the REAL paintings from a routed origin
+// serves the REAL Home markup and the REAL hall scripts (the city's painters too) from a routed origin
 // (localStorage needs one) in the ui-design kit's launcher. Every wait is on DOM state, never on a
 // flag that flips before the DOM settles (the task 1004780 CI flake). Skips when the machine has no
 // system Edge or Chrome, as ui_design_kit_fit does.
@@ -33,7 +33,9 @@ const INDEX = fs.readFileSync(path.join(HALL, 'index.html'), 'utf8')
   .replace(/<script\b[^>]*>[\s\S]*?<\/script>/g, '')
   .replace(/\{\{[^}]*\}\}/g, '');
 const STUB = '<script>window.__BRANDING__ = { identity: { worldName: "Harbor" } }; window.BongosClient = { createClient: () => ({ request: async () => ({ ok: false, status: 404, data: null }) }) };</script>';
-const SCRIPTS = ['dom-utils.js', 'shell-trail.js', 'craft-mode.js', 'welcome-boot.js', 'shell.js'] // dom-utils first, as on the real page (task 1004876)
+// The city's three painters draw the scene (task 1005308: the city in the clouds, not a painting).
+const PAINTERS = ['sky-time.js', 'city-draw.js', 'home-city-draw.js'];
+const SCRIPTS = ['dom-utils.js', ...PAINTERS, 'shell-trail.js', 'craft-mode.js', 'welcome-boot.js', 'shell.js'] // dom-utils first, as on the real page (task 1004876)
   .map((f) => `<script src="/builders/${f}"></script>`).join('');
 const PAGE = INDEX.replace('</body>', STUB + SCRIPTS + '</body>');
 
@@ -46,7 +48,7 @@ async function hall({ art = true, reducedMotion = 'no-preference', time = null }
     if (p === '/api/bongos/auth/web/start') return route.fulfill({ contentType: 'text/html', body: '<!doctype html><title>github</title><p id="auth">sign in</p>' });
     if (p === '/studio' || p === '/city') return route.fulfill({ contentType: 'text/html', body: '<!doctype html><title>room</title><p id="room">' + p + '</p>' });
     const ext = path.extname(p);
-    if (ext === '.webp' && !art) return route.fulfill({ status: 404, body: '' });
+    if (!art && PAINTERS.includes(path.basename(p))) return route.fulfill({ status: 404, body: '' });
     const f = path.join(HALL, p.replace(/^\/builders\//, ''));
     if (p.startsWith('/builders/') && TYPES[ext] && fs.existsSync(f)) return route.fulfill({ contentType: TYPES[ext], body: fs.readFileSync(f) });
     return route.fulfill({ status: 404, body: '' });
@@ -91,8 +93,8 @@ test('first visit of the day: the welcome, not the craft picker; Skip brings the
     'the welcome shows, the picker is marked asked and does not stack on it');
   assert.equal(await page.evaluate(() => document.querySelector('.wb__banner').tagName), 'DIV',
     'over a signed-in hall the shell keeps the one <header>; the banner is a plain block (task 1005080)');
-  // The painting loads and its motion is laid over it.
-  await page.waitForFunction(() => { const i = document.querySelector('#welcome-boot .wb__img'); return i && i.complete && i.naturalWidth === 1024; });
+  // The city in the clouds is drawn behind it (task 1005308).
+  await page.waitForSelector('#welcome-boot .cloud-scene .cloud-scene__svg path');
   assert.equal(await page.isVisible('[data-wb-skip]'), true);
   await page.click('[data-wb-skip]');
   await done(page);
@@ -227,17 +229,18 @@ test('roles: a seat holder sees Patron; Artisan stays on Home in Artisan', { ski
   await ctx.close();
 });
 
-test('no painting: the greeting and the choice still come up, over the sky colour', { skip }, async () => {
+test('no city painters: the greeting and the choice still come up, over the sky colour', { skip }, async () => {
   const ctx = await hall({ art: false });
   const { page } = await open(ctx);
   await signIn(page);
   await done(page);
   const s = await page.evaluate(() => ({
     bare: document.getElementById('welcome-boot').classList.contains('wb--bare'),
-    img: document.querySelector('#welcome-boot .wb__img').hidden,
+    city: !!document.querySelector('#welcome-boot .cloud-scene__svg'),
+    sky: !!document.querySelector('#welcome-boot .cloud-scene'),
     choices: document.querySelectorAll('.wb__choice').length,
   }));
-  assert.deepEqual(s, { bare: true, img: true, choices: 2 });
+  assert.deepEqual(s, { bare: true, city: false, sky: true, choices: 2 });
   await ctx.close();
 });
 
@@ -256,15 +259,16 @@ const look = (page) => page.evaluate(() => {
   return {
     day: r.classList.contains('wb--day'), night: r.classList.contains('wb--night'),
     veil: getComputedStyle(r.querySelector('.wb__veil')).backgroundColor,
-    art: r.querySelector('.wb__img').getAttribute('src'),
-    beacons: r.querySelectorAll('.wb-beacon').length,
+    city: !!r.querySelector('.cloud-scene__svg'),
+    hour: document.documentElement.getAttribute('data-sky-hour'),
+    img: r.querySelectorAll('img:not(.wb__logo)').length,
   };
 });
 
-test('by day the day painting opens from a white veil; by night the night one from black, with its lights', { skip }, async () => {
+test('by day the city opens from a white veil, by night from black, in the sky of that hour (task 1005308)', { skip }, async () => {
   for (const [time, want] of [
-    [new Date(2026, 9, 23, 10, 0), { day: true, night: false, veil: 'rgb(255, 255, 255)', art: '/builders/welcome-day.webp', beacons: 0 }],
-    [new Date(2026, 9, 23, 22, 0), { day: false, night: true, veil: 'rgb(0, 0, 0)', art: '/builders/welcome-night.webp', beacons: 0 }], // task 1005087 took the beacons out
+    [new Date(2026, 9, 23, 10, 0), { day: true, night: false, veil: 'rgb(255, 255, 255)', city: true, hour: '10', img: 0 }],
+    [new Date(2026, 9, 23, 22, 0), { day: false, night: true, veil: 'rgb(0, 0, 0)', city: true, hour: '22', img: 0 }],
   ]) {
     const ctx = await hall({ time });
     const { page } = await open(ctx);
@@ -305,19 +309,21 @@ test('the banner is the animated logo, the motion is laid on, and the drawn towe
   const ctx = await hall();
   const { page } = await open(ctx);
   await signIn(page);
-  await page.waitForSelector('#welcome-boot.wb--lit .wb-motion');
+  await page.waitForSelector('#welcome-boot.wb--lit .cloud-scene__svg');
   const s = await page.evaluate(() => ({
     banner: document.querySelector('.wb__banner').textContent,
     name: document.querySelector('.wb__banner .wb__name').textContent,
     mark: !!document.querySelector('.wb__banner svg.wb__mark .wb__moonlet'),
     ringAnim: getComputedStyle(document.querySelector('.wb__ring')).animationName,
-    pulses: document.querySelectorAll('#wb-fx .wb-pulse').length,
-    cars: document.querySelectorAll('#wb-fx .wb-car').length,
-    old: document.querySelectorAll('.wb-floor, .wb-bldg, .wb-person, #wb-scene, #wb-beam, #wb-city').length,
+    // anywhere on the page, under any container: the painting's lights must not come back
+    pulses: document.querySelectorAll('.wb-pulse, .wb-pulses').length,
+    cars: document.querySelectorAll('.wb-car').length,
+    // every earlier scene: the drawn tower and city, the painting and its light layer
+    old: document.querySelectorAll('.wb-floor, .wb-bldg, .wb-person, #wb-beam, #wb-city, #wb-fx, .wb-motion, .wb-moon, .wb-star, .wb__img').length,
   }));
   assert.doesNotMatch(s.banner, /Working on the core of/, 'task 1004953: the banner text is gone');
   assert.deepEqual({ name: s.name, mark: s.mark, ringAnim: s.ringAnim, pulses: s.pulses, cars: s.cars, old: s.old },
-    { name: 'Harbor', mark: true, ringAnim: 'wb-ring', pulses: 21, cars: 3, old: 0 });
+    { name: 'Harbor', mark: true, ringAnim: 'wb-ring', pulses: 0, cars: 0, old: 0 }, 'the painting\'s lights went with it (task 1005308)');
   await ctx.close();
 });