@bongos/core 1.19.1041 → 1.19.1043

package/docs/file-map.md

@@ -137,7 +137,7 @@
 │   ├── hall-ui/                ← CORE-DOMAIN WEB-SURFACE carve (BV1.R85, default-on): the authenticated builders' hall at builders.<apex>, moved from public-builders/ (~13k LOC, the largest). NO routes/db/port — declares contributes.webSurfaces:[{host:"builders.",dir:"public"}] for discovery, but UNLIKE status-ui keeps its DEDICATED serving block in serve-internal (the /builders shim + canonical redirects + citizen/Archon page gates + asset-stamping + hall-widget injection), partitioned out of the generic web-surface loop and served from BUILDERS_DIR. CLAUDE.md, module.json, records/ (one file per page family — what each family's redesign settled; CLAUDE.md points at them, and a new record is a new file there so concurrent hall tasks stop colliding on one insertion point, task 1003499), public/{index.html,builders.js,style.css,work,watch,gate,settings,ranks,sessions,primer,diagrams,atlas,...}.{html,js},cursors/,chime.wav. Four ARCHETYPE sheets sit beside the per-page ones: `record.css` (the task + idea records, task 1003305), `room.css` (the READING ROOMS — the primer + the diagrams index, task 1003306: the reading measure and rhythm, the table of contents, the progress hairline and the framed figure diagram-viewer.js upgrades on both pages), `oversight.css` (the OVERSIGHT family — government, watch, gate, task 1003469 (harbor was its fourth until task 1003890 removed the dev box): the row, the figure band inside a panel, the group head, the inline form, the grant toggle and the shared confirm modal; named oversight because the vocabulary wall bans "governance" on the government surface) and `panel.css` (the PANEL family — settings, profile, task 1003308 (pair was its third until task 1003890 removed the dev box): the row, the switch, the field with its label above, the chip control, the four voices and the sign-in gate; the hall's my-projects page was DELETED in the same task — "my projects" is the hub's user-level page, and the hall keeps no link or redirect; the family's fourth page `not-ready.html` was deleted by task 1003450, along with the emptied `requireNonXenosPage` gate that was the only thing redirecting to it). A page sheet then holds only what one page has and the others do not — `primer.css` the acknowledge gate, `diagrams.css` the legend strip, `gate.css` the hold reasons and file chips, `watch.css` the severities, the report reader and the grade trend, `settings.css` the rail layout, the group head, the token ladder and the voices grid, `profile.css` the identity band and the shelf, `people.css` the directory's identity cell (task 1003470 made the legacy door `/scouting` ship the same body and script as `/people`; task 1003440 then deleted the door — `scouting.html` and `scouting.states.json` are gone and the URL 301s to `/people`), `thinking.css` THE SKY's one sheet (task 1004231 / sky part 3 — `thinking.html` at `/thinking` is the prototype the owner adopted as the design of record, `docs/design/mocks/sky/`, built over `GET /sky` + `GET /sky/mine`; its script is the seven `sky-*.js` files on one shared `window.OTBSky`; it replaced THE ROOM of task 1004098, which survives as the list drawer, and the old `/sky` page, whose URL 301s here; `idea-objects.js` beside it is the shared five-object vocabulary).
 │   ├── lifecycle/               ← CORE-DOMAIN carve (BV1.R86, default-on): the build state machine — tasks · claims · versions · done-when · goals · dependencies · claim→ship→grade→credit · github-push + merge-lock + conflict-resolve + publish-reconciler. The LAST, most-coupled carve; registers the `lifecycle` kernel port (createTask, classifyTaskKind, tallyPeerVotes, work-tracking reads). CLAUDE.md, module.json, routes/{tasks,claims,versions,done-when,goals,dependencies,gate-approvals,analytics}.js, lifecycle.js, github-push.js, merge-lock.js, conflict-resolve.js, publish-reconciler.js, task-visuals.js + task-visual-db.js + routes/visuals.js (the optional ship-time visual, task 1003109 — the route file is NOT named task-*.js on purpose; see the module CLAUDE.md).
 │   ├── copy-desk/               ← CORE-DOMAIN module (task 1003113 / R02 of goal 1000074, default-on): the COPY half of the design contract — ADR 0081 gave design TOKENS a repo-owned source of truth, text had none. Owns the FLAG (anyone in any role marks a string or a whole surface as needing an artist's attention, with a reason required in BOTH the route and a CHECK constraint) and the QUEUE an artist reads it from. READS R01's committed registry (docs/copy-registry.json, generated by scripts/gds/copy-inventory.js) and never writes it. NO LIVE CMS is the hard non-goal: no column here could hold replacement text, and copy_no_cms.mjs pins that. Key is `copy-desk`, not `copy` — the branding contract already owns a `copy` block, so the bare word reds the "core carries no module code" fitness check. R03 (task 1003114, ADR 0233) added the PROPOSAL: an artist writes the replacement wording and it becomes a Bongos task carrying a fenced copy-proposal patch — no row, NO second migration (a proposals table is the forbidden column with extra steps), and scripts/gds/copy-apply.js lands it as a real diff under a claim. CLAUDE.md, module.json, registry.js, flags.js, proposals.js, routes/copy-desk.js, migrations/copy_desk_001_flags.sql, tests/{copy_flags,copy_queue,copy_no_cms,copy_proposals}.mjs. Its hall surface lives with hall-ui (public/copy-desk.{html,js,css}), per the one-key-per-web-surface precedent.
-│   ├── npm-release/             ← the deploy page for a project that publishes an npm package from GitHub (task 1002622, default-OFF — on only in the Bongos hall, which publishes @bongos/core). "Where the work is": every task finished in the last 14 days, placed in the stage it has actually reached (not merged · merged, no version yet · published, not running here · running here, not released · released · in no version), plus the version history — each version's tasks. The version↔task join reads the release-notes.json the package itself carries (scripts/gds/release-notes.js writes it at pack time), streamed out of the NEWEST version's npm tarball in-process (no child process, no sync call) when the running core's own copy stops short. module.json, work.js (the reading + the stage placement), registry.js (packument + tarball stream + a small tar reader, cached), routes/work.js (GET /npm-release/work, gated core.pin.move like the page), public/work.{js,css} (the two sections /deploy lends it: #nr-work, #nr-versions). Tests sit at the repo root — tests/npm_release_{work,page}.mjs — because a default-off module's own tests/ is skipped by the unit runner.
+│   ├── npm-release/             ← the deploy page for a project that publishes an npm package from GitHub (task 1002622, default-OFF — on only in the Bongos hall, which publishes @bongos/core). "Where the work is": every task finished in the last 14 days, placed in the stage it has actually reached (not merged · merged, no version yet · published, not running here · running here, not released · released · in no version), plus the version history — each version's tasks. The version↔task join reads the release-notes.json the package itself carries (scripts/gds/release-notes.js writes it at pack time), streamed out of the NEWEST version's npm tarball in-process (no child process, no sync call) when the running core's own copy stops short. module.json, work.js (the reading + the stage placement — the packument, tarball stream and tar reader it uses are the core's src/bongos/package-registry.js, reached through the doorway's readPackageRegistry since task 1004296), routes/work.js (GET /npm-release/work, gated core.pin.move like the page), public/work.{js,css} (the two sections /deploy lends it: #nr-work, #nr-versions). Task 1004301 added the same line on a task's own page: routes/task-where.js (GET /npm-release/task/:id, any signed-in builder — it shows nothing not already public) + public/task-widget.js, injected into task.html by the loader's uiSections seam (hallWidgetScripts file task-widget.js) to fill #task-contrib on otb:task-shown. Tests sit at the repo root — tests/npm_release_{work,page}.mjs — because a default-off module's own tests/ is skipped by the unit runner.
 │   ├── ui-design/               ← CORE-DOMAIN module (task 1003324 / ADR 0197, default-on): the design capability every builder on every instance gets — ships METHOD, never a world. Absorbs ADR 0081's layer: adapters/{claude-design,figma}/index.js (moved from src/ui/adapters/), scripts/{design-sync,figma-design-sync,validate-design}.js (moved from scripts/gds/, which keeps thin shims), docs/design-contract.md (moved from docs/). Declaration-only: contributes.skills design (the /design playbook, new) + design-sync + figma-design-sync; no routes/port/migrations, so disabling it touches no served surface. CLAUDE.md separates the platform FLOORS (the Fifteen Rule, the dark twins, no page :root, the 24px floor, AA in both modes, the kill switch) from the instance's WORLD (its packs + DESIGN.md). kit/ (task 1003320) is the look-before-you-ship kit: lib.js (the floors, the states/probes contracts, the action + expectation vocabularies, the WCAG maths, the stub spawner), serve.js (any surface through the doorway's real transforms + fixtures/), render.js (states × 1440/390/320 × dark/light, audited), probe.js (PASS/FAIL contracts), check-mock.js (platform rules + the instance's DESIGN.md taste bans, then the detector), tells.js (task 1003329 / ADR 0223: the anti-pattern detector as two tiers — floors FAIL, craft tells WARN, kit-ignore waivers per file; the rendered twins live in lib.js factsInPage), contrast.js + png.js; a page's <page>.states.json / <page>.probes.json sit BESIDE the surface (modules/public-landing/public/, modules/hall-ui/public/). Recipe: docs/recipes/ui-look-before-you-ship.md. skills/ (task 1003321 / ADR 0198) is the vendoring policy: policy.json (licence allowlist, verdicts that may land, sidecar fields, preamble markers), PREAMBLE.md (the platform preamble every vendored SKILL.md opens with), README.md (the roster — both origins scanned dangerous on 2026-08-28, landed as rebuild specs; nothing vendored — and the landing recipe); a landable copy goes under skills/vendor/<name>/ with PROVENANCE.md + LICENSE and is materialised into an instance's .claude/skills/ by claude-materialize.js step 1b. skills/<name>/ (task 1003325 / ADR 0220) are the in-house rebuilds from the specs, first-party and counted: design-taste-frontend (the default taste skill), design-taste-frontend-v1 (the earlier generation, kept distinct), high-end-visual-design (the polish pass), redesign-existing-projects (the in-place upgrade); each opens with the same preamble and carries a "Rebuilt from" section instead of a sidecar. impeccable/ (task 1003326 / ADR 0221) is the design-craft method as ONE skill with sub-commands: SKILL.md (the router, the menu, the craft floor, the bounded finish) + reference/<sub-command>.md (eighteen playbooks, one loaded per request); no hooks, no bypass agent, no telemetry, no live server. minimalist-ui/, industrial-brutalist-ui/, gpt-taste/, stitch-design-taste/ (task 1003327 / ADR 0230) are the four looks, composition grammars with no colours of their own: the palette is the instance's pack and the texture is a named entry in styles/; a substrate is an archetype that still ships both modes, gpt-taste's selection is derived from the route rather than rolled, and stitch-design-taste writes a DESIGN.md-shaped contract document whose thirteen are transcribed from the pack. image-to-code/, imagegen-frontend-web/, imagegen-frontend-mobile/, brandkit/ (task 1003328 / ADR 0222) are the image family under the hero-only rule: plates and hero objects only, the pair (JPEG dark plate + WebP alpha cutout) with a <file>.json sidecar beside each, through the instance's art pipeline key; the grove specimen's styles/grove/assets/ is the worked example. style/ (task 1003475 / ADR 0231) is the module's first FIRST-PARTY skill (no upstream, so a `## First party` section instead of `## Rebuilt from`): the /style session in which an owner authors their own look in four bounded steps, rendering the nearest library entries before asking, drafting inside the contract, retuning by measurement, and handing over the one-step adoption without ever writing config/branding.json. styles/ (task 1003323 / ADR 0219) is the style library: <name>/pack.json (the theme.ui overlay, exactly the fifteen) + DESIGN.md (the look's derived recipes, thirteen in lockstep with the pack) + mock.html (the specimen); chrome-world (pinned to the neutral pack), expedition, grove, blueprint (the first cool look, authored through /style at task 1003475); STYLE=<name> on the kit lays a look over the instance's pack through GDS_BRANDING_FILE; tests/ui_design_styles.mjs runs the world/cosmos/hall token suites once per alternate (UI_DESIGN_PACK). config/design-tokens.* + design-sources.json STAY in config/ as the host boundary; public-landing keeps its own key (first customer, not owner).
 │   ├── character-anim/          ← consistent-character generative animation (ADR 0088) — graded painterly frame sets + manifest, the otb-character-review skill. CLAUDE.md, module.json.
 │   ├── provisioning/            ← stands up + operates a Cloud Bongos instance's own infra (server/DB/domain/DNS/TLS) via the API (ADR 0111); web-tier request+state only, no cloud tokens — a separate control-plane runner drains the intents. Distinct from the `hosting` module (ADR 0092), which brokers compute workloads. CLAUDE.md, module.json.

package/docs/module-api-changelog.md

@@ -2561,5 +2561,17 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.19.1039 with no explicit bump. run 36251192410. (task 1002620)
   1.19.1041 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.19.1040 with no explicit bump. run 36253865251. (task 1002620)
+  (next carrier) — readPackageRegistry re-exported (task 1004296, goal 1000090).
+        What the npm registry says about a package — its versions, their publish
+        dates, the `latest` label, and the release notes the newest version was
+        packed with — moved from a module into the core (src/bongos/
+        package-registry.js), because Settings → Software update needs it in
+        every hall. A module that publishes a package reads the same answer and
+        the same process-local cache through here. Additive — a MINOR by the
+        1.19.0 precedent, riding the next CI patch as joinabilityMode did.
+  1.19.1042 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.19.1041 with no explicit bump. run 36254852933. (task 1002620)
+  1.19.1043 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.19.1042 with no explicit bump. run 36258640780. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/docs/modules-contract.md

@@ -98,7 +98,10 @@ Every module must have a `module.json` at its root (`modules/<key>/module.json`)
     "pollers":     ["box-lifecycle"], //   background pollers (start/stop lifecycle)
     "disciplines": ["artist"],        //   builder disciplines this module adds
     "skills":      ["otb-tile-generate"], // slash-command skills it ships
-    "uiSections":  ["boxes"],         //   hall/status UI sections gated by window.__MODULES__
+    "uiSections":  ["boxes"],         //   hall/status UI sections gated by window.__MODULES__. Ship public/hall-widget.js
+                                      //   and it is injected into the hall index; ship public/task-widget.js and it
+                                      //   is injected into a task's page before task.js, to fill #task-contrib on
+                                      //   `otb:task-shown` (task 1004301). The page itself names no module.
     "webSurfaces": [{ "host": "status.", "dir": "public" }], // static web surfaces: a Host PREFIX (BV1.R84)…
                                                             // …or { "apexRoot": true, "dir": "public" } for the
                                                             // apex root (ADR 0218). One or the other, never both.

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

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

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

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

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

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

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

@@ -148,7 +148,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <script src="/builders/collab-lib.js?v=2026-09-24-archive"></script>

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

@@ -177,7 +177,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -69,7 +69,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -97,7 +97,7 @@
 
 <!-- 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.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/diagram-viewer.js?v=2026-06-14-diagviewer-1" defer></script>

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

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

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

@@ -54,7 +54,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>
 <script src="/builders/hall-kit.js"></script>

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

@@ -76,7 +76,7 @@
 <div id="gate-modal-root"></div>
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>

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

@@ -235,7 +235,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-14-domutils"></script>

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

@@ -134,7 +134,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>

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

@@ -52,7 +52,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib" defer></script>
 <!-- task-detail.js still owns the #/idea/N and #/blocker/N overlay, so a ref

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

@@ -225,7 +225,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <!-- task 1003069 (R08) — the quick-filing form's routed result links a task

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

@@ -102,7 +102,7 @@
 <script src="/builders/brand-apply.js?v=2026-06-27-r75" defer></script>
 <!-- The app shell (sidebar + top bar + view router). Dependency-free; loaded
      BEFORE builders.js so the chrome ids exist when events are wired. -->
-<script src="/builders/shell.js?v=2026-09-26-own1" defer></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate" defer></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- task 2166: the shared component kit (window.OTBKit) — pager/ledger/rail.

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

@@ -80,7 +80,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>

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

@@ -62,6 +62,7 @@
       { label: 'Extensions', href: '/settings#extensions' },
       { label: 'Preferences', href: '/settings#preferences' },
       { label: 'Sound', href: '/settings#sound' },
+      { label: 'Software update', href: '/settings#update' },
     ] },
   ];
 

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

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

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

@@ -115,7 +115,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- the shared markdown reader (window.OTBMdReader) — primer.js renders through

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

@@ -187,7 +187,7 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></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 profile.js, which pulls from it. -->

package/modules/hall-ui/public/project-settings.html

@@ -58,7 +58,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>

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

@@ -68,7 +68,7 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></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 ranks.js, which pulls from it. -->

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

@@ -41,7 +41,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-14-domutils"></script>

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

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

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

@@ -99,7 +99,7 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell.js?v=2026-09-26-own1"></script>
+<script src="/builders/shell.js?v=2026-09-26-swupdate"></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 sessions.js so it can pull from it. -->

package/modules/hall-ui/public/settings-software-update.js

@@ -0,0 +1,194 @@
+// modules/hall-ui/public/settings-software-update.js — Settings → Software update
+// (task 1004296).
+//
+// The owner, 2026-09-25: "each builders hall settings has a version description where they
+// can pull the latest release. Just like iOS does." So this panel says three things and
+// offers one: the version this project runs; either "up to date" or the newest release its
+// update channel lets it take; what each version in between brings — and, for the people
+// the upgrade door lets through, an Update button.
+//
+// THE BUTTON LEADS TO THE DOOR; IT IS NOT THE DOOR. Taking an update is the deploy door's
+// two steps (see exactly what moves, then confirm that version) with its health check and
+// auto-rollback (ADR 0293), and on a hosted project that door is on the hub (ADR 0339 D3).
+// A second copy of that flow here would be a second place for its safety rules to drift, so
+// the server names where this project's door is (`door`) and the button goes there.
+//
+// THE PAGE KNOWS NOTHING (deploy.js's rule, kept). Every version here is the server's reading
+// with the time it was taken. "Up to date" is drawn only from an ok reading with nothing
+// offered; a reading that failed says so, and release notes that could not be read are
+// reported as unread, never drawn as a version with no changes.
+//
+// READ WHEN ITS GROUP OPENS, not with the page: an update's notes come out of the newer
+// package's download (src/bongos/package-registry.js), and most visits to Settings are for
+// something else. settings.js announces each group switch as a `settings:group` event.
+//
+// Its own file, like the sessions and interaction panels: settings.js is against the
+// 1500-line ratchet, and this panel shares nothing with it but the toolkit globals.
+
+(() => {
+  'use strict';
+
+  const API = '/api/bongos';
+  const GROUP = 'update';
+  const { escapeHtml } = window.OTB;
+  const byId = (id) => document.getElementById(id);
+  const api = window.BongosClient.createClient({ baseUrl: '', credentials: 'same-origin', throwOnError: false });
+
+  // Versions drawn open before "Show every version": enough to read the recent work
+  // without a project that is a hundred versions behind burying the button.
+  const VERSIONS_OPEN = 5;
+
+  let asked = false;
+
+  function ago(iso) {
+    const then = iso ? new Date(iso).getTime() : NaN;
+    if (!Number.isFinite(then)) return null;
+    const mins = Math.max(0, Math.round((Date.now() - then) / 60000));
+    if (mins < 1) return 'just now';
+    if (mins < 60) return `${mins} minute${mins === 1 ? '' : 's'} ago`;
+    const hours = Math.round(mins / 60);
+    if (hours < 48) return `${hours} hour${hours === 1 ? '' : 's'} ago`;
+    const days = Math.round(hours / 24);
+    return `${days} day${days === 1 ? '' : 's'} ago`;
+  }
+
+  const mono = (v) => `<span class="su-ver">${escapeHtml(String(v))}</span>`;
+  // Voice rule V4 (docs/voice.md): a dash is banned in QUOTED data — and a release-note line
+  // is a task's ship summary, handed over by the ledger — so it becomes a comma at render,
+  // the way goal-inbox.js and the public feed's cleanTitle() do. Never by editing the data.
+  const unDash = (raw) => String(raw == null ? '' : raw).replace(/\s*[—–]\s*/g, ', ').replace(/,\s*,/g, ',').trim();
+
+  function row(label, desc, ctl) {
+    return `<div class="prow">
+      <div class="prow__main"><span class="prow__label">${label}</span>${desc ? `<span class="prow__desc">${desc}</span>` : ''}</div>
+      ${ctl ? `<div class="prow__ctl">${ctl}</div>` : ''}
+    </div>`;
+  }
+
+  // Where the Update button goes, and what it says it will do. Only a plain same-origin path
+  // or an http(s) URL is ever put in an href; anything else draws no button.
+  function doorHtml(data, offered) {
+    const door = data.door || {};
+    if (!data.can_update) {
+      return '<p class="panel-hint su-door">Only the people allowed to upgrade this project see an Update button here.</p>';
+    }
+    if (door.kind === 'cli') {
+      return '<p class="panel-hint su-door">This project is upgraded on the server that runs it: <code>bongos upgrade</code> there takes this version, with the same health check and rollback.</p>';
+    }
+    const url = String(door.url || '');
+    const sameOrigin = /^\/[a-z0-9/_-]*$/i.test(url);
+    if (!sameOrigin && !/^https?:\/\/[^\s"'<>]+$/i.test(url)) return '';
+    let where = '';
+    if (!sameOrigin) {
+      try { where = ` on ${new URL(url).host}`; } catch (e) { return ''; }
+    }
+    return `<div class="row-end su-door">
+      <a class="pbtn pbtn--save" id="su-update" href="${escapeHtml(url)}">Update to ${escapeHtml(offered)}${sameOrigin ? '' : ' ↗'}</a>
+      <span class="panel-hint">Opens this project's upgrade${escapeHtml(where)}: you see what would move, confirm it, and it installs, checks itself, and rolls back if the project does not come back healthy.</span>
+    </div>`;
+  }
+
+  // One entry: its text, and — only in the hall whose ledger the ids belong to, which is
+  // the one that runs the door itself — a link to that task.
+  function entryHtml(e, linkTasks) {
+    const text = escapeHtml(unDash(e.text));
+    return linkTasks && e.id ? `<li><a href="/task/${escapeHtml(e.id)}">${text}</a></li>` : `<li>${text}</li>`;
+  }
+
+  function versionHtml(v, linkTasks, notesRead) {
+    const when = ago(v.published_at);
+    let body;
+    if (!notesRead) body = '<p class="prow__desc">Its notes could not be read.</p>';
+    else if (v.entries === null) body = '<p class="prow__desc">No notes were packed for this version.</p>';
+    else if (!v.entries.length) body = '<p class="prow__desc">No changes are listed for this version.</p>';
+    else body = `<ul class="su-entries">${v.entries.map((e) => entryHtml(e, linkTasks)).join('')}</ul>`;
+    return `<li class="su-version">
+      <span class="prow__label">${mono(v.version)}${when ? `<span class="prow__tag">published ${escapeHtml(when)}</span>` : ''}</span>
+      ${body}
+    </li>`;
+  }
+
+  function whatsNewHtml(w, linkTasks) {
+    if (!w) return '';
+    const n = w.count;
+    const head = `<h3 class="su-h" id="su-new-h">What's new in ${n === 1 ? 'this version' : `these ${escapeHtml(String(n))} versions`}</h3>`;
+    const warn = w.ok ? '' : `<p class="panel-status panel-status--danger" role="status">The release notes could not be read: ${escapeHtml(w.error || 'unknown error')}. The versions are still listed.</p>`;
+    const items = w.versions.map((v, i) => versionHtml(v, linkTasks, w.ok).replace('<li class="su-version">',
+      i < VERSIONS_OPEN ? '<li class="su-version">' : '<li class="su-version" hidden>'));
+    const hiddenCount = Math.max(0, w.versions.length - VERSIONS_OPEN);
+    const more = hiddenCount ? `<button type="button" class="pbtn pbtn--quiet" id="su-more">Show ${escapeHtml(String(hiddenCount))} more version${hiddenCount === 1 ? '' : 's'}</button>` : '';
+    const beyond = w.more ? `<p class="panel-hint">…and ${escapeHtml(String(w.more))} older version${w.more === 1 ? '' : 's'}, also in this update.</p>` : '';
+    return `${head}${warn}<ol class="su-versions" aria-labelledby="su-new-h">${items.join('')}</ol>${more ? `<div class="row-end">${more}</div>` : ''}${beyond}`;
+  }
+
+  function render(data) {
+    const body = byId('su-body');
+    const note = byId('su-note');
+    if (!body) return;
+    const u = (data && data.update) || {};
+    const checked = ago(u.checked_at);
+    const notes = [];
+    if (checked) notes.push(`Checked ${checked}.`);
+
+    if (u.reading !== 'ok') {
+      body.innerHTML = row('This project runs', u.running ? mono(u.running) : 'a version it could not name')
+        + `<p class="panel-status panel-status--danger" role="status">Could not check for a newer version: ${escapeHtml(u.error || 'no answer')}.</p>`;
+      if (note) note.textContent = notes.join(' ');
+      return;
+    }
+
+    let html = row('This project runs', mono(u.running));
+    if (!u.offered) {
+      html += row('Newest for this project', `${mono(u.running)} — this project is up to date.`, '<span class="su-pill su-pill--ok">Up to date</span>');
+    } else {
+      const when = ago(u.offered_published_at);
+      html += row('Newest for this project', `${mono(u.offered)}${when ? ` — published ${escapeHtml(when)}` : ''}`, '<span class="su-pill">Update ready</span>');
+      html += doorHtml(data, u.offered);
+      html += whatsNewHtml(u.whats_new, (data.door || {}).kind === 'local');
+    }
+    // A newer line this project's channel does not take is a fact worth one sentence — it
+    // explains why the newest number on the registry is not the one offered.
+    if (u.newest && u.newest !== (u.offered || u.running) && String(u.newest).split('.')[1] !== String(u.running).split('.')[1]) {
+      notes.push(`${u.newest} is also published; it starts a new line, and this project takes updates within ${String(u.running).split('.').slice(0, 2).join('.')} on its own.`);
+    }
+    body.innerHTML = html;
+    if (note) note.textContent = notes.join(' ');
+
+    const more = byId('su-more');
+    if (more) {
+      more.addEventListener('click', () => {
+        for (const li of body.querySelectorAll('.su-version[hidden]')) li.hidden = false;
+        more.parentNode.remove();
+      });
+    }
+  }
+
+  async function load() {
+    if (asked) return;
+    asked = true;
+    const body = byId('su-body');
+    if (body) body.innerHTML = '<p class="panel-hint">Checking for a newer version…</p>';
+    try {
+      const res = await api.request('GET', `${API}/software-update`);
+      if (res.status === 401) { window.location.assign(`${API}/auth/web/start`); return; }
+      if (!res.ok || !res.data) throw new Error((res.data && res.data.error && res.data.error.message) || `HTTP ${res.status}`);
+      render(res.data);
+    } catch (err) {
+      // Its own failure, like every section here: this panel says it could not check, and
+      // the rest of Settings is untouched. Asking again is allowed.
+      asked = false;
+      if (body) body.innerHTML = `<p class="panel-status panel-status--danger" role="status">Could not check for updates: ${escapeHtml(err.message || 'unknown error')}.</p>`;
+    }
+  }
+
+  function boot() {
+    const section = byId('software-update-scroll');
+    if (!section) return;
+    section.hidden = false;
+    const groups = byId('settings-groups');
+    if (groups && groups.dataset && groups.dataset.active === GROUP) load();
+    document.addEventListener('settings:group', (e) => { if (e && e.detail && e.detail.group === GROUP) load(); });
+  }
+
+  boot();
+})();

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

@@ -26,6 +26,7 @@
 .settings-groups[data-active="access"] > [data-group="access"],
 .settings-groups[data-active="preferences"] > [data-group="preferences"],
 .settings-groups[data-active="sound"] > [data-group="sound"],
+.settings-groups[data-active="update"] > [data-group="update"],
 .settings-groups[data-active="extensions"] > [data-group="extensions"] { display: block; }
 .settings-groups > [data-group][hidden] { display: none !important; }
 .settings-groups .scroll { margin: 0 0 var(--sp-sm); }
@@ -212,3 +213,41 @@ select.voices__select { min-width: 140px; }
   font-family: inherit;
   opacity: 0.92;
 }
+
+/* ---- Software update (task 1004296) -------------------------------------- */
+/* A version is read digit by digit and compared against another, so it takes the mono
+   face. The state pill borrows project-settings' shape: a word in its own colour with a
+   hairline of the same, so "up to date" and "update ready" differ by more than hue. */
+.su-ver { font-family: var(--font-mono); font-size: 13.5px; color: var(--ink); }
+.su-pill {
+  display: inline-block;
+  padding: 1px 8px;
+  border: var(--line) solid currentColor;
+  border-radius: var(--radius-pill);
+  font-size: 11.5px;
+  font-weight: 600;
+  white-space: nowrap;
+  color: var(--accent-ink);
+}
+.su-pill--ok { color: var(--ok); }
+.su-door { margin-top: var(--sp-sm); }
+.su-door .panel-hint { flex: 1 1 18rem; min-width: 0; }
+.su-h { margin: var(--sp-md) 0 0; font-size: 14.5px; font-weight: 600; color: var(--ink); }
+.su-versions { list-style: none; margin: var(--sp-xs) 0 0; padding: 0; }
+.su-version { padding: var(--sp-sm) 0; border-top: var(--line) solid var(--rule-soft); }
+.su-version > .prow__label { display: flex; flex-wrap: wrap; align-items: baseline; gap: 4px; }
+.su-entries { margin: var(--sp-hair) 0 0; padding-left: 1.15rem; max-width: var(--measure); font-size: 13.5px; color: var(--ink-soft); }
+.su-entries li + li { margin-top: 2px; }
+/* a task title is a link, and a link owes the 24px floor. Block, so a two-line note keeps
+   its bullet on its first line; the soft ink with an underline, because on the platform
+   every note is a link and a list of accent-coloured sentences reads as a warning. */
+.su-entries a {
+  display: block;
+  min-height: 24px;
+  padding: 2px 0;
+  color: var(--ink-soft);
+  text-decoration: underline;
+  text-decoration-color: color-mix(in srgb, var(--ink-soft) 45%, transparent);
+  text-underline-offset: 3px;
+}
+.su-entries a:hover { color: var(--ink); text-decoration-color: currentColor; }