@bongos/core 1.24.93 → 1.24.95

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/bongos/package-core.js",
-  "core_version": "1.24.93",
-  "core_contract": "1.24.93",
-  "source_commit": "8071fd2502f713c6b549097cfd5d79d606f32867",
+  "core_version": "1.24.95",
+  "core_contract": "1.24.95",
+  "source_commit": "998afb92495c4be1e9a57fbf18ae033d1affd5ae",
   "source_ref": "HEAD",
-  "built_at": "2026-11-12T20:21:01.886Z",
+  "built_at": "2026-11-12T20:56:00.733Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
-    "docs_redacted": 650,
+    "docs_redacted": 653,
     "agent_docs_stubbed": 32,
-    "functional_verbatim": 3967,
+    "functional_verbatim": 3982,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 4650,
-  "tree_sha256": "14cce51acfe462e49a4caaa95f39316299e9da4b7eaad55df49bd1082d03adaf",
+  "file_count": 4668,
+  "tree_sha256": "464b0075caaaab9588613ed13a60f795c81c1fff326ba3bfe484d15149bf69fa",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -2479,10 +2479,20 @@
       "mode": "0000644",
       "sha256": "d98e0ea9a8a9b541bb58361bb124a4884c8165758aa8e3243e743368467e79ed"
     },
+    {
+      "path": "docs/adr/0404-a-party-is-a-room-and-rooms-register-as-kinds.md",
+      "mode": "0000644",
+      "sha256": "b383c189cf0069b724ee895d984592ec5bc04aded9deef32ea7129f7ce3381da"
+    },
+    {
+      "path": "docs/adr/0405-each-character-has-one-colour-and-the-visor-wears-it.md",
+      "mode": "0000644",
+      "sha256": "1d8b8c6782ca394e6f85072355140136eff97e1a26ace0fcf392f1206b7a77ec"
+    },
     {
       "path": "docs/adr/README.md",
       "mode": "0000644",
-      "sha256": "ca848f718bbc048e492417b7b92b00359d691473891950302d5d7d232da2a1ad"
+      "sha256": "567b8b3dcf30ff69de7c484aa84e142bccd2753c9c89fd1c1ab941c9519a0560"
     },
     {
       "path": "docs/api-reference.md",
@@ -2517,12 +2527,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "4f561c4c13b185d12c1cb4c2dce8d7f4415bf22fd3d9f6969556e21335a1f643"
+      "sha256": "ee662d352052ce7cf385b005cee788a68f8e970c1a19575f259611266f784c88"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "e2fd36ea4e5ba73c38737e07f3ced678d330356bd803cb52ecbb65063e85e457"
+      "sha256": "4a0c854417ce7567781da0405dcbe3f96d301ef238e7facb1a16d419d543df9c"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2534,6 +2544,46 @@
       "mode": "0000644",
       "sha256": "23b1de77bb1cfa998257fbad37b4dd64235ddd5b8e17f53bc83d77d9c6fdd6a8"
     },
+    {
+      "path": "docs/design/characters/v2/artisan-visor.png",
+      "mode": "0000644",
+      "sha256": "6a1ee297f0cc7ff159cc71f7c78df927999893767803d9a005a3068853167d84"
+    },
+    {
+      "path": "docs/design/characters/v2/artisan.png",
+      "mode": "0000644",
+      "sha256": "75efc5fa7efca72582c3354709bbc7de8a70ac9c5b6eac04d3349dc771a267aa"
+    },
+    {
+      "path": "docs/design/characters/v2/artist-visor.png",
+      "mode": "0000644",
+      "sha256": "48250f3529f8cb6644cba99c6e3faeaab0c096838ca472bc7ba5e618569421bc"
+    },
+    {
+      "path": "docs/design/characters/v2/artist.png",
+      "mode": "0000644",
+      "sha256": "e33cae66d718fdc39f22dc634f4c4ac466b119685f5f5a2d8e81534f27e19d31"
+    },
+    {
+      "path": "docs/design/characters/v2/draw-characters.js",
+      "mode": "0000644",
+      "sha256": "3b9a6c07f8e2261c992f3d4f5e4b28e396c146ed3881a7c57c477a1a2e8389ad"
+    },
+    {
+      "path": "docs/design/characters/v2/patron-visor.png",
+      "mode": "0000644",
+      "sha256": "9f95dedffdce4358a3e4f6f97c72b88ce065e4083ae1a9b4566a4a8ea8d7dcf1"
+    },
+    {
+      "path": "docs/design/characters/v2/patron.png",
+      "mode": "0000644",
+      "sha256": "6fc2e84bafe99cb0cf040166bdaeec1431d5fb7d93c3f4900462c2dc2cf9fd53"
+    },
+    {
+      "path": "docs/design/characters/v2/sheet.html",
+      "mode": "0000644",
+      "sha256": "b56308d99dee2d606475bbe6a4d9ca1efc472e18a8e0293d2d70a568bff9e887"
+    },
     {
       "path": "docs/design/craft-mode-direction.md",
       "mode": "0000644",
@@ -3037,12 +3087,12 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "bba6458b2c8742106eabe1e8c4646fb9a5ceea75fba0bb3a375b6ea7a986fc80"
+      "sha256": "d7caaf44b5a42ed511e8f1b1b0f6e63cf73c34b17b579c39bd906af2cf5f1a3e"
     },
     {
       "path": "docs/modules-contract.md",
       "mode": "0000644",
-      "sha256": "d537c6d220e7ba90e46a283c6bf2f0e38699478ff0be33271eeb4e12bd9651c5"
+      "sha256": "612555c173a834511820e075ec61e13b5e89494185ac85d84d6e57eed58dc0a5"
     },
     {
       "path": "docs/onboarding/diagrams/01-task-lifecycle.mmd",
@@ -3122,7 +3172,7 @@
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "a15df86b33d43c4b42bc9854319497d86b3671ffbda88f765bfe8ed3a9ed6fde"
+      "sha256": "c7203e4d93ca91f4a550ff3c132155136e48286400ac15f65f13bd8dd6c11b9d"
     },
     {
       "path": "docs/project-context.template.md",
@@ -6184,20 +6234,50 @@
       "mode": "0000644",
       "sha256": "efe0b6cfb43766e6d72f416df070a170ffc4254495ddcb27c36c8d6ff63582d3"
     },
+    {
+      "path": "modules/hall-ui/public/characters/artisan-face.png",
+      "mode": "0000644",
+      "sha256": "8639879d7613c953cc22436d052b3b199401098b653cba98fa626d0407c0fd45"
+    },
+    {
+      "path": "modules/hall-ui/public/characters/artisan-visor.png",
+      "mode": "0000644",
+      "sha256": "83b4a196eb9e92b360a7a8556fc00f3ed70ce47d8d2d06b29b7f7075ff47dfac"
+    },
     {
       "path": "modules/hall-ui/public/characters/artisan.png",
       "mode": "0000644",
-      "sha256": "68fc4927c4e3addd4c0d71419cd36ce0adc9bf125946c3c1cede26ec51c91144"
+      "sha256": "75efc5fa7efca72582c3354709bbc7de8a70ac9c5b6eac04d3349dc771a267aa"
+    },
+    {
+      "path": "modules/hall-ui/public/characters/artist-face.png",
+      "mode": "0000644",
+      "sha256": "20dd36710c52f164ece07da65104b827472ac47df8c5eeb966e56afac143a6d8"
+    },
+    {
+      "path": "modules/hall-ui/public/characters/artist-visor.png",
+      "mode": "0000644",
+      "sha256": "f1124a72857581e2b2df36600aac2c0ea4bc5a0f02e95dfa92cc2e93797b525b"
     },
     {
       "path": "modules/hall-ui/public/characters/artist.png",
       "mode": "0000644",
-      "sha256": "d75f3b2c0d90be3ca4d2d26ee3c8cedb34bd22015eca55c992361534fdaa1cf5"
+      "sha256": "e33cae66d718fdc39f22dc634f4c4ac466b119685f5f5a2d8e81534f27e19d31"
+    },
+    {
+      "path": "modules/hall-ui/public/characters/patron-face.png",
+      "mode": "0000644",
+      "sha256": "09199a2663190ce07dcd4583acd6a857b7c2f066ac630c53a08e2f25320be5b2"
+    },
+    {
+      "path": "modules/hall-ui/public/characters/patron-visor.png",
+      "mode": "0000644",
+      "sha256": "22d0bea9159a1960f7237af708a0327409c630b88b40e259f22e0976ce5df81c"
     },
     {
       "path": "modules/hall-ui/public/characters/patron.png",
       "mode": "0000644",
-      "sha256": "88742f5047d183b74718276c83bc36a22646e58484c6cd5713459c0fdaaaf82a"
+      "sha256": "6fc2e84bafe99cb0cf040166bdaeec1431d5fb7d93c3f4900462c2dc2cf9fd53"
     },
     {
       "path": "modules/hall-ui/public/chime.wav",
@@ -6332,7 +6412,7 @@
     {
       "path": "modules/hall-ui/public/craft-mode.js",
       "mode": "0000644",
-      "sha256": "15dc97554ec17cde2938078650290333d5d15a847654688381d5a9b218d90b9f"
+      "sha256": "97673df1b505c56d8265ac49896eb96479fe81b5dfc2fa2e694364ed4614122b"
     },
     {
       "path": "modules/hall-ui/public/craft-review.css",
@@ -6647,17 +6727,17 @@
     {
       "path": "modules/hall-ui/public/home-city.js",
       "mode": "0000644",
-      "sha256": "438c26d63fdc11c89c219e317ded486217275fc48e3c3746f76b9565c11342a7"
+      "sha256": "9a8a5b5eeae1af57285b0f352e6c01a721ea2d0b5a0310e3efd7197344eb5d05"
     },
     {
       "path": "modules/hall-ui/public/home-gallery.css",
       "mode": "0000644",
-      "sha256": "416059288af3503f90a6aff4ed2b8b1ce94741cd975fbc5bed3838c4d69a632c"
+      "sha256": "416a9e3abf34f48f0037350cb43f9b795197ae9e004aa2b0baeeb55b89e959de"
     },
     {
       "path": "modules/hall-ui/public/home-gallery.js",
       "mode": "0000644",
-      "sha256": "aed701de3b07999ef86c7e5b93ac294b1e413ada1230fbb909049e8aa6bd23d0"
+      "sha256": "6e56d2f9a5cbb9248e15d4a135756ceaec1b1f186c635e2f21ca091a730d964d"
     },
     {
       "path": "modules/hall-ui/public/home-idea-box.css",
@@ -7352,7 +7432,7 @@
     {
       "path": "modules/hall-ui/public/style.css",
       "mode": "0000644",
-      "sha256": "d42939b4e5777cd304c272caa057f6723b8cff8a372b4275a7caa6dade7200b4"
+      "sha256": "ee20d5dc4b74f5d2568ae49ce1ad83ab9380d95415a0ef859056888109f4be97"
     },
     {
       "path": "modules/hall-ui/public/task-detail.js",
@@ -7442,12 +7522,12 @@
     {
       "path": "modules/hall-ui/public/visor.css",
       "mode": "0000644",
-      "sha256": "8c7c3088fb756d2e6fddc6d9d9df81fb67ada498628dc3a9ff67a8cbb97ab3e6"
+      "sha256": "d6f65d5ac6756b323d47ad8eaa2b4a08c207cbf9424e6b07821ef29ffa42fe60"
     },
     {
       "path": "modules/hall-ui/public/visor.js",
       "mode": "0000644",
-      "sha256": "ce6b2a68e041a0e529fed8270405dcd15bb300e1ec5bf1d3c6afbf561ee53936"
+      "sha256": "4cad8cd3de8c9cc20af4cc8c6afdecd893ee2a41b5feff02b51f4406459d1e1b"
     },
     {
       "path": "modules/hall-ui/public/vote-control.js",
@@ -7559,6 +7639,11 @@
       "mode": "0000644",
       "sha256": "d3911fb48be461f005561fb69af5ca1124af02db909b751fbe4c2bc98b301850"
     },
+    {
+      "path": "modules/hall-ui/records/characters.md",
+      "mode": "0000644",
+      "sha256": "0ed7c25438fac16e87a78aff0786792d8a54fd69d207fc52bbd12c2ed4c6fff8"
+    },
     {
       "path": "modules/hall-ui/records/collaboration.md",
       "mode": "0000644",
@@ -7757,7 +7842,7 @@
     {
       "path": "modules/hall-ui/records/visor.md",
       "mode": "0000644",
-      "sha256": "a1e1421463d9107782c46309339510d6e5c82a38f142ccf35f17fb53effb6c97"
+      "sha256": "f41c9dc1788401b4c25cab81c345fe622d6fc4725fe76993b95959b4ba2c59c8"
     },
     {
       "path": "modules/hall-ui/records/welcome-tower.md",
@@ -12107,12 +12192,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "aca584f965a5191a12f9c0547ed3bc0be72a13f8043b13a2d3a2ec65b08d8632"
+      "sha256": "b9da5660886768da2f0a99dc2f2eff462cc080983515d1d9ca06374d62db70fa"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "c0cae817310174c3e98cef573263c33c9807c1c8086b050fc13f5f1a18001b4d"
+      "sha256": "acaf640eb1edf032dfaa9a676b38bfec7a079c78d8962ca45963a232965be486"
     },
     {
       "path": "public-docs/index.html",
@@ -12132,7 +12217,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "6aff28036a7071c6895abc1f682477f4cd41b1fe02bf96fad15a7f42c05de7d9"
+      "sha256": "df32f9a699d1cfd5239943e3e08aed1601401996748abf9a23984d52cffa2a74"
     },
     {
       "path": "scripts/bongos/CLAUDE.md",
@@ -16137,7 +16222,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "a8399bb92d13d12c44c07cf942398f10b93590bbeb054610a5d9952cd9b044ab"
+      "sha256": "244c19299fa34d2c8578e20ea64d2f1a103cf49db7d25f7203efa1dd76ee2bab"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -16172,7 +16257,7 @@
     {
       "path": "src/module-seams.js",
       "mode": "0000644",
-      "sha256": "e3cacfd18defeb53108e2696a14efba7012d052899620deccd4e08248f618bd2"
+      "sha256": "7975a911a4bf1f42eb3fecbf5b2d4bb0d62716a58bc6ee442f71a5a155f0cf76"
     },
     {
       "path": "src/modules.js",
@@ -17072,7 +17157,7 @@
     {
       "path": "tests/character_creation.mjs",
       "mode": "0000644",
-      "sha256": "ce048c8ba8a60d5725feb4a9a9961b6a2a9561b16cddca54f48354644262cc51"
+      "sha256": "0631568f7aea189a66537eaabeedc2edbcfca5f031c419810d44e8842293c8a7"
     },
     {
       "path": "tests/city_card_context.mjs",
@@ -19402,7 +19487,7 @@
     {
       "path": "tests/hall_visor.mjs",
       "mode": "0000644",
-      "sha256": "7cebc92c9a8c34eb1d11ef0316767fd0ff3fc01dfe20917f7b4194f89174830c"
+      "sha256": "5c91b7d8d9b9b997c05620ea48bfdfb4209b163d10a9ef03345c883d79823bad"
     },
     {
       "path": "tests/hall_work_history_id.mjs",
@@ -19462,7 +19547,7 @@
     {
       "path": "tests/home_gallery_widget.mjs",
       "mode": "0000644",
-      "sha256": "c6efbc12c975d3a6ca63219dcdd3748b79d7365097d9fb8881503c9769a1db6a"
+      "sha256": "60e0615ea852127d3aedfba058e50ab56957e314bd56a32dd99a8df5326662cc"
     },
     {
       "path": "tests/home_idea_box.mjs",
@@ -21849,6 +21934,11 @@
       "mode": "0000644",
       "sha256": "1e565de6c7587bd32d3e8c8fba7ad245776285f3a882c752e7e4ca7cfacbd063"
     },
+    {
+      "path": "tests/room_kinds_seam.mjs",
+      "mode": "0000644",
+      "sha256": "0bdb24f1af191a0f9b0aad33f5e8de6d01c48c9affc101049c856df5866a892e"
+    },
     {
       "path": "tests/roster_government_columns.mjs",
       "mode": "0000644",

package/docs/adr/0404-a-party-is-a-room-and-rooms-register-as-kinds.md

@@ -0,0 +1,118 @@
+# ADR 0404 — A party is a room, and rooms register as kinds
+
+- **Status:** Accepted
+- **Date:** 2026-11-12
+- **Task:** [task 1005220](https://cloudbongos.com/builders#/task/1005220) — goal 1000148 "A party talks through Discord" (BONGOS-V3, criterion `a-party-talks-through-discord`)
+- **Deciders:** the owner, Lars, 2026-11-12: free-form parties are in V3 as well as the game's existing groups; the chat bridge to Discord comes after the core; the party bars show in voice / muted, not a live speaker. The plan behind this ADR went through two rounds of adversarial review the same day.
+- **Builds on:** [ADR 0400](0400-a-chain-reserves-work-and-each-sub-quest-is-still-claimed-alone.md) (`chain_party`), [ADR 0403](0403-in-game-mode-the-visor-is-the-control-and-the-scene-is-the-view.md) (controls live on the visor), [ADR 0083](0083-modular-architecture-strangler-build-plan.md) (modules meet only through seams), [ADR 0016](0016-trust-boundary-server-enforced-permissions.md) (rank is the only authority).
+- **Gates:** every task in goal 1000148. Its sibling, the ADR on Discord room channels and chat crossing (task 1005221), decides the Discord side and amends ADR 0032, 0033 and 0037.
+
+## Context
+
+The owner asked for Discord text and voice in the game "to begin party dynamics". The game already has several groups that would talk together, each planned in a different module:
+
+- a **chain party** (`chain_party`, ADR 0400): the people holding a quest chain, with a raid quorum;
+- a **scoping session** (task 1005164): a Patron's room of up to about forty;
+- a **decision room** (task 1005173): a presenter, the people in the room, and pre-voters outside it;
+- and, by the owner's decision, a **free-form party** a player forms on their own.
+
+Each needs the same three things: a private Discord voice channel, a list of who is in it and whether they are in voice, and a chat. Building those three things once per group would mean four copies. Building them in a new module that reads each group's tables would break the module boundary (a module may require only `src/module-api.js`, never another module).
+
+The obvious seam does not work. A port is single-provider: `registerProvider` throws on a second provider (`src/module-seams.js`) and `verifyPortsSatisfied` fails the boot when two enabled modules declare the same port. Four modules cannot all provide `room.members`.
+
+## Decision
+
+### D1 — A room is any group that talks together; a party is a room
+
+"Room" is the one word for a group with a voice channel, a member list and a chat. A party in the player's sense is any room they are in. There are four **kinds** in V3, each owned by the module that already owns the group:
+
+| Kind | What it is | Owner module | Cap |
+|---|---|---|---|
+| `party` | a free-form party a player forms (tasks 1005233–1005236) | `lifecycle` | 8 |
+| `chain` | a chain party, an open `chain_party` row (ADR 0400) | `lifecycle` | the largest raid R21 allows; 8 until R21 sets one |
+| `scoping` | a scoping session's participants (task 1005164, which had no module: it is assigned `lifecycle`, because a scope ends as goals and tasks) | `lifecycle` | 40 |
+| `decision` | a decision room's attendees (task 1005173); pre-voters are not members | `government` | 40 |
+
+A room's cap is also the `user_limit` of its Discord voice channel.
+
+### D2 — Rooms register through a contribution point, not a port
+
+Each owner module contributes its kind at mount time:
+
+```js
+api.contribute('room.kinds', {
+  kind: 'scoping',              // unique across kinds; a duplicate is a boot error
+  owner: 'lifecycle',           // the contributing module's key
+  cap: 40,
+  members: async (roomId) => [{ builderId, joinedAt }],   // current members only
+  isMember: async (roomId, builderId) => true | false,
+  invite: async (roomId, inviterId, inviteeLogin) => {...}, // optional
+  accept: async (inviteId, builderId) => {...},              // optional
+});
+```
+
+A consumer (the Discord side, the chat, the party bars) finds a kind with `api.contributions('room.kinds')` and calls its functions. It never reads the owner's tables. A contribution point accepts many contributors, so four owners cause no conflict, and an instance with none of them simply has no rooms.
+
+**Two kinds with the same `kind` value is a configuration error.** Consumers look a kind up by its name and must never have to choose between two. The room channels task (task 1005225), the first consumer, adds the boot check that refuses it, the same way a doubly-provided port is refused.
+
+The owner fires four events through the normal event seam, each with plain ids and nothing else:
+
+| Event | Payload |
+|---|---|
+| `room.opened` | `{ kind, roomId }` |
+| `room.member.joined` | `{ kind, roomId, builderId }` |
+| `room.member.left` | `{ kind, roomId, builderId, reason }`, where reason is `left`, `kicked`, `lapsed` or `deactivated` |
+| `room.closed` | `{ kind, roomId }` |
+
+Listeners must also be correct when they miss an event (the bot was down, the process restarted): `members()` is the truth, and every consumer that keeps its own state reconciles against it.
+
+### D3 — Free-form party rules
+
+- One open party per builder at a time.
+- The creator leads. When the leader leaves, the longest-standing member leads. When the last member leaves, the party disbands and fires `room.closed`.
+- A party lasts until it is disbanded. It does not end when someone logs out.
+- Only the leader removes a member.
+- Invites go through `invite`/`accept`, with the abuse controls task 1005231 builds: a per-inviter rate limit, a cap on pending invites, silent decline, a cooldown before re-inviting, an invitee-side block, and a switch to refuse all invites.
+
+### D4 — A chain party's voice follows its reservation
+
+A member of a chain room is a builder with an open `chain_party` row. This closes ADR 0400's open question 3 *for voice and chat*: a member who leaves the chain loses the voice channel and the chat at once. What the chain's remaining sub-quests do when a raid member leaves stays the chain's own question, settled where the leave door is built (task 1005238).
+
+### D5 — Players without a linked Discord account
+
+They get the whole room except voice: they are members, they appear on the party bars marked **not linked**, and they can chat in the game. They are never sent a channel id or link.
+
+### D6 — Realtime is polling in V3
+
+The live stream (`GET /api/bongos/live`) sends one empty nudge to every open hall, and modules cannot add their own. Pushing every chat line or voice change through it would make every builder's hall reload everything. V3 polls instead:
+
+- **party bars:** every 3 seconds while visible;
+- **chat:** every 3 seconds while the drawer is open;
+- both send a cursor (`?since=`) and get **304** when nothing changed;
+- both stop when the tab is hidden and slow to 15 seconds after 60 seconds idle;
+- both read through a limiter keyed by the builder, tagged with a `meteredScope` like every per-surface limiter, never the shared per-IP default.
+
+A scoped live event is the upgrade path if 40-person rooms make polling too costly. It is a core change and is not decided here.
+
+### D7 — With the discord module off
+
+No Voice key and no voice state anywhere. Nothing is drawn empty (the visor rule). Rooms, members, invites, the party bars and chat all still work.
+
+### D8 — A room is never authority
+
+Being in a room, leading one or inviting into one admits no claim, vote, approval, deploy or spend that rank would refuse (criterion C3, ADR 0016). Every write route the room tasks add is rank-gated like any other.
+
+## Consequences
+
+- Goal 1000148's tasks build to this: the room channels (task 1005225) and access sync (task 1005226) read `members()` and listen for the four events; voice presence (task 1005227) and the party bars (task 1005205) check `isMember`; the room chat (task 1005228) keys its lines by `(kind, roomId)`; each kind's task contributes its entry.
+- The `room.kinds` point and the four events are added to the live seam registry in [`docs/modules-contract.md`](../modules-contract.md), and `src/module-seams.js` lists the point among its canonical extension points.
+- `tests/room_kinds_seam.mjs` pins the seam choice: two kinds from two modules register and the boot check still passes, while the same pair registered as a port is refused.
+
+## Rejected
+
+- **One `room.members` port.** Ports are single-provider. Four owners would fail the boot.
+- **One port per kind** (`room.members.chain`, `room.members.scoping`, …). It works, but every consumer must hard-code the list of kinds, and a new kind means editing every consumer.
+- **A new `rooms` module that reads each owner's tables.** A module may not require another module, and the rooms module would end up copying each owner's rules about who counts as a member.
+- **A free-form party as a second roster beside `chain_party`, kept in sync.** Two rosters drift. A free-form party is its own kind; when a party takes a chain, its members join through the chain's own door (task 1005160, R20) and the chain room is a separate room.
+- **Push through `/live` now.** It reloads every hall for every message (D6).
+- **Speaking indicators.** Discord gives a web page no "speaking" signal without a partner-only permission. The bars show in voice and muted only, by owner decision.

package/docs/adr/0405-each-character-has-one-colour-and-the-visor-wears-it.md

@@ -0,0 +1,31 @@
+# 0405 — Each character has one colour, and the visor wears it
+
+- **Status:** Accepted
+- **Date:** 2026-11-12
+- **Decided by:** the owner, in the brief for [task 1005218](https://cloudbongos.com/builders#/task/1005218) (2026-11-11) and on the picture sheet `docs/design/characters/v2/sheet.png` (2026-11-12).
+- **Goal:** [goal 1000142](https://cloudbongos.com/builders#/goal/1000142) — the V3 game conversion.
+- **Builds on:** [ADR 0399](0399-the-visor-is-glass-over-the-scene-and-owns-no-camera.md) (the visor), [ADR 0402](0402-helm-is-the-halls-look-and-the-hall-is-dark-only.md) (Helm), [ADR 0403](0403-in-game-mode-the-visor-is-the-control-and-the-scene-is-the-view.md) (the visor is the control).
+
+## 1. The decision
+
+The three characters each have **one colour**: the Artisan ember, the Artist violet, the Patron gold. In game mode **the visor wears the held character's colour**: the frame's lines, the sight, the character's name, the rim of your picture, and the accent on the glass (the one button, the segment being built, a hovered row). Your picture on the glass is your character **wearing the visor**, its rim in the same colour.
+
+The characters themselves are redrawn (the "second look"): 64 by 64 pixel art, still two animals in one body, as space-faring aliens in the Helm night rather than figures from ancient Egypt. One animal gives the whole head and the other the whole body: a ram on a lizard (Artisan), an ibis on an octopus (Artist), a falcon on a lion (Patron).
+
+## 2. How it sits with the design rules
+
+- **The Fifteen Rule holds.** No colour is typed in. `--char-artisan` is `--accent`; `--char-artist` is a mix of `--sea`, `--accent` and `--ink`; `--char-patron` is a mix of `--warn` and `--ink` (`modules/hall-ui/public/style.css`). A host that overrides its accent or sea moves the characters' colours with it.
+- **The One Warm Thing Rule is narrowed, on the glass only.** The hall still has one accent, and it still marks only what you can act on. On the visor that accent **is** the character's colour (`visor.css` re-points `--accent` under `.visor[data-character]`), so there is still one lit colour on the glass at a time; it is yours rather than the hall's. An Artisan's glass is unchanged, because the Artisan's colour is the accent. Classic mode and every hall page outside the glass are untouched.
+- **The Patron's gold is made from the status amber.** It is lighter than `--warn` and never appears as a status, but the two are neighbours. If a Patron's glass is ever read as a warning, the fix is a different mix here, not a new literal.
+
+## 3. What was considered and not done
+
+- **Two new typed-in colours** (`#c59bff`, `#ffd166`, the values the pictures are drawn in). Refused by the design-count ratchet, correctly: the baseline is never raised to pass. The mixes land close to them.
+- **Tinting the whole hall** by character. Not asked for; the brief names the visor.
+
+## 4. Consequences
+
+- The pictures are **drawn by a script**, `docs/design/characters/v2/draw-characters.js --hall`, which writes the hall's nine files (`<id>.png`, `<id>-face.png`, `<id>-visor.png`). A change to a character is an edit there and a re-run, never a hand-edited PNG. The script's header holds the six rules the owner's feedback set.
+- The pictures use their own fixed colours (they are art, not UI), so a host that re-themes its accent will see the Artisan's glass move while the Artisan's picture keeps its ember trim.
+- A scene's own buttons still wear the hall's accent (the Governor City's "decide" button stays salmon under a violet or gold glass). ADR 0403 already moves those onto the visor.
+- The old Egyptian sheet stays at `docs/design/characters/character-sprites-source.webp` as the record of the first look.

package/docs/adr/README.md

@@ -519,3 +519,5 @@ These 20 numbers are each shared by exactly two files. They are **accepted histo
 | 0400 | [**A chain reserves work; each sub-quest is still claimed on its own** ([task 1005158](https://cloudbongos.com/builders#/task/1005158), spike V3G.R18, goal 1000144). C5 of the game conversion: work is claimed as a chain, not picked from a flat table. Owner ruling (interview answer 3): a chain RESERVES, tasks are still claimed one at a time. **Decision:** three new tables (`chains` inside one goal, `chain_tasks` with a task in at most one open chain, `chain_party`), none of them a claim — no `claims` row, no session binding, no worktree — so `gateOneActiveClaimPerSession` (ADR 0097) and its unique index never see a chain. **Order is derived, never stored** (ADR 0153's rejection holds): the topological order of `task_dependencies` over the chain's members, ties by priority/estimate/id — `sequence.js`'s `topoOrder`, moved into one shared module. Every sub-quest claims through the unchanged `POST /claims` ladder. **The one addition** is a narrowing-only `CHAIN_RESERVED` check placed AFTER the last existing rung on both insert sites + the dry run + the feed: an outsider can't claim a reserved chain's sub-quest, while every existing refusal keeps its code, message and precedence. Party size (raid quorum vs routine) is refused at the chain's own join door, never in the claim ladder; character counts seats and is never read by a claim rung. A reservation lapses after days with no claim or ship, reported before it acts (ADR 0226). Rejected: a chain as N claims, loosening the session guard, chain = goal, a stored order, an early-ladder check (would mask rank/deps refusals), a feed-only reservation.](0400-a-chain-reserves-work-and-each-sub-quest-is-still-claimed-alone.md) | lifecycle / claims / game conversion |
 | 0402 | [**Helm is the hall's look, and the hall is dark only** ([task 1005192](https://cloudbongos.com/builders#/task/1005192)). The game (the hall, everything after sign-in) wears Helm; the landing, the hub and the status page keep the chrome world. The kit: two voices (Barlow Condensed in wide capitals names a thing, Barlow says everything else), four colours with one job each (Night the ground, Ice what you read, White names and numbers, the accent only what you can act on), three shapes (the cut corner for anything pressable, the segment for progress, the arc for the visor). The values live in the hall's token block; `src/hall-helm.js` recognises a hall page by the sheet it links, pins it dark and hands it the Helm faces unless its pack chose its own. The light/dark switch is gone; the light tier stays until its own removal. The shared button spends every Helm token with the old pill as the fallback, so the status page does not move.](0402-helm-is-the-halls-look-and-the-hall-is-dark-only.md) | design system / hall |
 | 0403 | [**In game mode the visor is the control and the scene is the view** ([task 1005203](https://cloudbongos.com/builders#/task/1005203), goal 1000142; owner 2026-11-11). Every main call to action you can see in game mode lives on the visor (the accent button, the key hints, the Actions sheet); the city, the sky and Home only show the project and can be moved through, never carry buttons of their own. A scene offers its actions to the visor through `OTBVisor.scene`. Found not yet keeping it: the city's decide button and door, the sky's top row and composer, Home's gallery links, the Artist's feedback tab.](0403-in-game-mode-the-visor-is-the-control-and-the-scene-is-the-view.md) | hall / game frame |
+| 0404 | [**A party is a room, and rooms register as kinds** ([task 1005220](https://cloudbongos.com/builders#/task/1005220), goal 1000148). Any group that talks together is a room: a free-form party (cap 8), a chain party (ADR 0400), a scoping session (cap 40, owned by `lifecycle`) or a decision room (cap 40, `government`). Each owner contributes its kind to the `room.kinds` contribution point (a port is single-provider, so four owners would fail the boot) with `members`/`isMember`/optional `invite`/`accept`, and fires `room.opened`/`room.member.joined`/`room.member.left`/`room.closed`; consumers never read an owner's tables and reconcile against `members()`. Free-form party: one per builder, leader handover to the longest-standing member, disband on last leave. A chain room follows an open `chain_party` row. Unlinked players get everything but voice. V3 polls (3 s, cursor + 304, paused when hidden, per-builder limiter) rather than pushing through `/live`. With discord off, no voice key or voice state; chat still works. A room is never authority. Rejected: one port, a port per kind, a rooms module reading other modules' tables, a second party roster, push via `/live`, speaking indicators.](0404-a-party-is-a-room-and-rooms-register-as-kinds.md) | game frame / modules / Discord |
+| 0405 | [**Each character has one colour, and the visor wears it** ([task 1005218](https://cloudbongos.com/builders#/task/1005218), goal 1000142; owner 2026-11-12). The Artisan is ember (the accent), the Artist violet, the Patron gold, each mixed from the hall’s tokens and none typed in. In game mode the visor’s lines, name, picture rim and accent are the held character’s colour, and your picture on the glass is your character wearing the visor. The characters are redrawn at 64 by 64 as two-animal aliens, drawn by a script.](0405-each-character-has-one-colour-and-the-visor-wears-it.md) | hall / game frame |

package/docs/copy-inventory.md

@@ -284,7 +284,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `906c2947dfc1` | certain | Changes save at once and take effect the next time you start a session on this machine. | `modules/hall-ui/public/settings.html:362` |
 | `52384bdc035c` | certain | Changes save at once. Your new choice plays the next time that event fires. | `modules/hall-ui/public/settings.html:375` |
 | `864503935eca` | certain | Changing the rule… | `modules/hall-ui/public/deploy.js:742` |
-| `44f783393438` | certain | Character creation | `modules/hall-ui/public/craft-mode.js:896` |
+| `44f783393438` | certain | Character creation | `modules/hall-ui/public/craft-mode.js:905` |
 | `55ad21bd03eb` | certain | Chart the routes | `modules/hall-ui/public/goal-map.html:101` |
 | `55ad21bd03eb` | certain | Chart the routes | `modules/hall-ui/public/thinking.html:109` |
 | `e6982a9ff948` | certain | Charter library | `modules/hall-ui/public/government.js:855` |
@@ -303,7 +303,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `89ddfeda9566` | certain | Choose goals | `modules/hall-ui/public/gate.js:186` |
 | `6bf684ebc1c3` | certain | Choose the skills for {…} | `modules/hall-ui/public/speciality-tools.js:199` |
 | `6c88cdf417f1` | certain | Choose which sound plays for each build event — one when Claude waits for your input, another when a task ship | `modules/hall-ui/public/settings.html:368` |
-| `7b984c01b6a8` | certain | Choose your character | `modules/hall-ui/public/craft-mode.js:897` |
+| `7b984c01b6a8` | certain | Choose your character | `modules/hall-ui/public/craft-mode.js:906` |
 | `f7d8c25af75d` | certain | Choose your mode | `modules/hall-ui/public/craft-mode.js:670` |
 | `b7d5648b66db` | certain | Claim it | `modules/hall-ui/public/task.js:766` |
 | `b7d5648b66db` | certain | Claim it | `modules/hall-ui/public/task.js:899` |
@@ -316,7 +316,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `4df46e2be815` | certain | Clear the key? | `modules/hall-ui/public/market-watch-settings.js:218` |
 | `593dda3178eb` | certain | Click to copy | `modules/hall-ui/public/copy-on-click.js:137` |
 | `34624d39ff29` | certain | Clone the project to your machine and run | `modules/hall-ui/public/setup-gate.js:34` |
-| `3a426bad2c49` | certain | Close actions | `modules/hall-ui/public/visor.js:232` |
+| `3a426bad2c49` | certain | Close actions | `modules/hall-ui/public/visor.js:235` |
 | `70f6a704d504` | certain | Close it | `modules/hall-ui/public/copy-desk.html:140` |
 | `053e576ba9a3` | certain | Close options | `modules/hall-ui/public/shell-game.js:454` |
 | `d12a2fb5730d` | certain | Close this flag | `modules/hall-ui/public/copy-desk.html:116` |
@@ -1474,7 +1474,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `604292be5554` | certain | This goal is scoped to a protected module — only an Archon may bring someone in. | `modules/hall-ui/public/goals-render.js:1309` |
 | `ba404d3207f7` | certain | This goal isn't taking requests right now. | `modules/hall-ui/public/goals-render.js:1395` |
 | `c7d2bc751184` | certain | This goal was added to {…} after it had already started building — an Archon override of the scope gate | `modules/hall-ui/public/goals-render.js:895` |
-| `1ab370135bee` | certain | This is who you are in the project. To change it later, sign out and pick again. | `modules/hall-ui/public/craft-mode.js:898` |
+| `1ab370135bee` | certain | This is who you are in the project. To change it later, sign out and pick again. | `modules/hall-ui/public/craft-mode.js:907` |
 | `23f531302e9e` | certain | This is you — | `modules/hall-ui/public/profile.js:364` |
 | `d313d3dfe438` | certain | This move is decided by the project’s government, not by one person here. | `modules/hall-ui/public/deploy.js:634` |
 | `f303bd107422` | certain | This page has been submitted and is on its way to the site. Its words are frozen until it ships or is sent bac | `modules/hall-ui/public/tweak-editor.js:332` |
@@ -1486,7 +1486,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `9a685b01e2c6` | certain | This page opens at a higher rank. | `modules/hall-ui/public/watch.html:237` |
 | `e7a289134dc3` | certain | This page shows no words the reader could find. | `modules/hall-ui/public/tweak-editor.js:246` |
 | `d4b3b5556986` | certain | This page's reference docs | `modules/hall-ui/public/page-notes.js:166` |
-| `79e4a934b434` | certain | This place | `modules/hall-ui/public/visor.js:234` |
+| `79e4a934b434` | certain | This place | `modules/hall-ui/public/visor.js:237` |
 | `5bdcbec770dd` | certain | This project has no slash commands yet. | `modules/hall-ui/public/commands.js:37` |
 | `f53b83bfbe54` | certain | This project has no watch rules yet. | `modules/hall-ui/public/market-watch-rules.js:62` |
 | `e97b2d549f10` | certain | This project is hosted on {…}, and that is where it is taken offline or removed. Both links below open this pr | `modules/hall-ui/public/project-settings.js:412` |
@@ -1692,8 +1692,8 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `a1f290d92800` | certain | Your browser kept this tab open. Close it to quit. | `modules/hall-ui/public/shell-game.js:295` |
 | `3812b4d8106f` | certain | Your changes to this page | `modules/hall-ui/public/paintbrush.js:150` |
 | `7e5697ffbfc4` | certain | Your character | `modules/hall-ui/public/craft-mode.js:660` |
-| `791f72bb7b35` | certain | Your character could not be saved. Reload and try again. | `modules/hall-ui/public/craft-mode.js:928` |
-| `a80d4145a438` | certain | Your character could not be saved. Try again. | `modules/hall-ui/public/craft-mode.js:940` |
+| `791f72bb7b35` | certain | Your character could not be saved. Reload and try again. | `modules/hall-ui/public/craft-mode.js:937` |
+| `a80d4145a438` | certain | Your character could not be saved. Try again. | `modules/hall-ui/public/craft-mode.js:949` |
 | `44a68d05519e` | certain | Your choices for {…} | `modules/hall-ui/public/speciality-tools.js:171` |
 | `3f67b866f24e` | certain | Your devices | `modules/hall-ui/public/settings-autobongos.js:141` |
 | `909b0b7c6ffa` | certain | Your display name | `modules/hall-ui/public/settings.html:93` |

package/docs/copy-registry.json

@@ -4920,7 +4920,7 @@
       "surface": "builders-hall",
       "text": "Character creation",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 896,
+      "line": 905,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -5091,7 +5091,7 @@
       "surface": "builders-hall",
       "text": "Choose your character",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 897,
+      "line": 906,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -5208,7 +5208,7 @@
       "surface": "builders-hall",
       "text": "Close actions",
       "file": "modules/hall-ui/public/visor.js",
-      "line": 232,
+      "line": 235,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -15630,7 +15630,7 @@
       "surface": "builders-hall",
       "text": "This is who you are in the project. To change it later, sign out and pick again.",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 898,
+      "line": 907,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -15738,7 +15738,7 @@
       "surface": "builders-hall",
       "text": "This place",
       "file": "modules/hall-ui/public/visor.js",
-      "line": 234,
+      "line": 237,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -17592,7 +17592,7 @@
       "surface": "builders-hall",
       "text": "Your character could not be saved. Reload and try again.",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 928,
+      "line": 937,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -17601,7 +17601,7 @@
       "surface": "builders-hall",
       "text": "Your character could not be saved. Try again.",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 940,
+      "line": 949,
       "origin": "js-text-assign",
       "confidence": "certain"
     },