@bongos/core 1.24.93 → 1.24.95

package/docs/page-readings.json

@@ -12,7 +12,7 @@
       "surface": "builders",
       "title": "Studio",
       "states_read": ["pick","describe","make","waiting","result","result-own","failed","balance","balance-all","out"],
-      "files_hash": "4d3ddcf70c72e2d8",
+      "files_hash": "bfd352bc483d41c2",
       "reading_hash": "d9e0e85bcee4aff4",
       "counts": {"lines":106,"placed":41,"shared":7,"unplaced":58},
       "omitted": {"data":17},
@@ -131,7 +131,7 @@
       "surface": "builders",
       "title": "Repo Atlas",
       "states_read": ["map","truth","detail","index","out"],
-      "files_hash": "5ccfecad1f11842c",
+      "files_hash": "133220425bccce34",
       "reading_hash": "6934dead335b2507",
       "counts": {"lines":25,"placed":14,"shared":7,"unplaced":4},
       "omitted": {"data":5},
@@ -169,7 +169,7 @@
       "surface": "builders",
       "title": "Blockers",
       "states_read": ["default"],
-      "files_hash": "3edd4c9a8287965e",
+      "files_hash": "a819c6030cf15a6e",
       "reading_hash": "60d73d854ced958a",
       "counts": {"lines":36,"placed":17,"shared":7,"unplaced":12},
       "omitted": {"data":51},
@@ -218,7 +218,7 @@
       "surface": "builders",
       "title": "Board Room",
       "states_read": ["room","out","sitting-meta","objection-form"],
-      "files_hash": "797b50d46b74f122",
+      "files_hash": "649b8241ac4ad473",
       "reading_hash": "0260b797b8dc1526",
       "counts": {"lines":52,"placed":21,"shared":7,"unplaced":24},
       "omitted": {"data":17},
@@ -283,7 +283,7 @@
       "surface": "builders",
       "title": "The city",
       "states_read": ["city","fullscreen","focus","pins","living","card","card-ask"],
-      "files_hash": "d9dd949934a5b719",
+      "files_hash": "804ce56d156d7046",
       "reading_hash": "277096d903879a57",
       "counts": {"lines":26,"placed":9,"shared":6,"unplaced":11},
       "omitted": {"data":7},
@@ -322,7 +322,7 @@
       "surface": "builders",
       "title": "Collab",
       "states_read": ["board","out"],
-      "files_hash": "6bd34870e07488b0",
+      "files_hash": "6e58d1336b59ed6d",
       "reading_hash": "e6452bf92231656f",
       "counts": {"lines":82,"placed":36,"shared":6,"unplaced":40},
       "omitted": {"data":23},
@@ -417,7 +417,7 @@
       "surface": "builders",
       "title": "Commands",
       "states_read": ["in","out"],
-      "files_hash": "19b25bb84e65c93a",
+      "files_hash": "6c7abde80e1c7a74",
       "reading_hash": "ecc452689a8ee9d7",
       "counts": {"lines":71,"placed":49,"shared":7,"unplaced":15},
       "omitted": {"data":177},
@@ -501,7 +501,7 @@
       "surface": "builders",
       "title": "Copy desk",
       "states_read": ["queue","out","search","composer","closer","proposer"],
-      "files_hash": "3598688fde8da13f",
+      "files_hash": "1f6a0864849d0263",
       "reading_hash": "3819ef6fa8f6fb7c",
       "counts": {"lines":72,"placed":36,"shared":7,"unplaced":29},
       "omitted": {"data":94},
@@ -586,7 +586,7 @@
       "surface": "builders",
       "title": "Deploy",
       "states_read": ["work","out"],
-      "files_hash": "f66bb9f77832d5fe",
+      "files_hash": "b534665c0eb1a176",
       "reading_hash": "3770e8b2fa56bee1",
       "counts": {"lines":14,"placed":5,"shared":7,"unplaced":2},
       "omitted": {"data":5},
@@ -613,7 +613,7 @@
       "surface": "builders",
       "title": "The sky",
       "states_read": ["tour","sky","wells","ledger","full","full-back","out"],
-      "files_hash": "f54ebe767edaf0c8",
+      "files_hash": "a5f2d9cada6d1773",
       "reading_hash": "4a879397a84631e3",
       "counts": {"lines":50,"placed":25,"shared":6,"unplaced":19},
       "omitted": {"data":10},
@@ -676,7 +676,7 @@
       "surface": "builders",
       "title": "Goals",
       "states_read": ["list","filters","cards","detail","dependencies","out","uat","uat-panel","author"],
-      "files_hash": "e0237363305a997e",
+      "files_hash": "83d51fe0a0cbdc81",
       "reading_hash": "13a5d07b3804b627",
       "counts": {"lines":187,"placed":61,"shared":7,"unplaced":119},
       "omitted": {"data":315},
@@ -876,7 +876,7 @@
       "surface": "builders",
       "title": "Government",
       "states_read": ["constitution","out","permissions","board","constitution-tab"],
-      "files_hash": "cee3223b05313772",
+      "files_hash": "67e03165f6801e25",
       "reading_hash": "37c6878d60447fd6",
       "counts": {"lines":65,"placed":27,"shared":7,"unplaced":31},
       "omitted": {"data":276},
@@ -954,8 +954,8 @@
       "surface": "builders",
       "title": "Builders' Hall",
       "states_read": ["home","out","founding","genesis","decide","demo"],
-      "files_hash": "6fce98a5eabe1c82",
-      "reading_hash": "42901560779fc4d1",
+      "files_hash": "057978d931dfd529",
+      "reading_hash": "c46b0ff89002a2d9",
       "counts": {"lines":32,"placed":12,"shared":8,"unplaced":12},
       "omitted": {"data":5},
       "notes": ["founding: an action failed (page.focus: Timeout 6000ms exceeded.); read as it stood"],
@@ -977,7 +977,7 @@
         {"key":"L0015","section":"Needs your attention13","text":"Ideas awaiting triage","placement":"placed","file":"modules/hall-ui/public/builders.js","line":320,"string_id":"e181637c5a5e"},
         {"key":"L0016","section":"Needs your attention13","text":"Requires project {…} fix","placement":"unplaced"},
         {"key":"L0017","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":514,"string_id":"1883ad7f07fc"},
-        {"key":"L0018","section":"Needs your attention13","text":"core 1.24.90","placement":"unplaced"},
+        {"key":"L0018","section":"Needs your attention13","text":"core 1.24.93","placement":"unplaced"},
         {"key":"L0019","section":"Needs your attention13","text":"Skip","placement":"unplaced"},
         {"key":"L0020","section":"Needs your attention13","text":"Built on","placement":"placed","file":"modules/hall-ui/public/welcome-boot.js","line":183,"string_id":"fef59346ffee"},
         {"key":"L0021","section":"Needs your attention13","text":"cloudbongos.com","placement":"unplaced"},
@@ -999,7 +999,7 @@
       "surface": "builders",
       "title": "Idea",
       "states_read": ["record","missing"],
-      "files_hash": "d657a33a67bc8f3b",
+      "files_hash": "b19a972d3190b27c",
       "reading_hash": "f7d644748c87e426",
       "counts": {"lines":52,"placed":25,"shared":8,"unplaced":19},
       "omitted": {"data":25},
@@ -1064,7 +1064,7 @@
       "surface": "builders",
       "title": "Ideas",
       "states_read": ["compose","full","develop"],
-      "files_hash": "64316b241e5de273",
+      "files_hash": "65f50755fa5d2c77",
       "reading_hash": "a62c05dcef3bf87f",
       "counts": {"lines":68,"placed":34,"shared":7,"unplaced":27},
       "omitted": {"data":118},
@@ -1145,7 +1145,7 @@
       "surface": "builders",
       "title": "Market Watch",
       "states_read": ["desk","settings","out"],
-      "files_hash": "c19fa516071448c1",
+      "files_hash": "2685309696818881",
       "reading_hash": "30512dda207b5ea6",
       "counts": {"lines":23,"placed":11,"shared":7,"unplaced":5},
       "omitted": {"data":5},
@@ -1181,7 +1181,7 @@
       "surface": "builders",
       "title": "Market Watch",
       "states_read": ["dossier","out","propose","correct","filtered"],
-      "files_hash": "9f574f36d050ecb4",
+      "files_hash": "4dd2ab01e84c217f",
       "reading_hash": "129bff28c4e4ed6d",
       "counts": {"lines":24,"placed":12,"shared":7,"unplaced":5},
       "omitted": {"data":5},
@@ -1218,7 +1218,7 @@
       "surface": "builders",
       "title": "Market Watch rules",
       "states_read": ["in","scoring","names","propose","out"],
-      "files_hash": "04757fe324f6331f",
+      "files_hash": "526c2149de84f633",
       "reading_hash": "ca0c62e8dce51c8b",
       "counts": {"lines":36,"placed":12,"shared":7,"unplaced":17},
       "omitted": {"data":20},
@@ -1267,7 +1267,7 @@
       "surface": "builders",
       "title": "Modules",
       "states_read": ["browse","search-empty","lens","details","out"],
-      "files_hash": "bb880eb91b5bffa2",
+      "files_hash": "574e1738477d342c",
       "reading_hash": "6a12e9306bba5622",
       "counts": {"lines":59,"placed":29,"shared":7,"unplaced":23},
       "omitted": {"data":107},
@@ -1339,7 +1339,7 @@
       "surface": "builders",
       "title": "Money",
       "states_read": ["money","hosting","out"],
-      "files_hash": "eab833a98ae63570",
+      "files_hash": "816343bf158f836b",
       "reading_hash": "e355d5466b123e07",
       "counts": {"lines":83,"placed":28,"shared":7,"unplaced":48},
       "omitted": {"data":27},
@@ -1435,7 +1435,7 @@
       "surface": "builders",
       "title": "My agents",
       "states_read": ["desk","factory","saved","what-it-knows","speciality-walk","speciality-forms","nobody"],
-      "files_hash": "f9fd9939a04db900",
+      "files_hash": "3e69046bdd44b756",
       "reading_hash": "5347e0496b38727d",
       "counts": {"lines":100,"placed":33,"shared":7,"unplaced":60},
       "omitted": {"data":38},
@@ -1548,7 +1548,7 @@
       "surface": "builders",
       "title": "Primer",
       "states_read": ["in","toc-open","jump","out"],
-      "files_hash": "bab434369863a9c0",
+      "files_hash": "da0299600036bb6f",
       "reading_hash": "85790bd421e5c387",
       "counts": {"lines":487,"placed":57,"shared":7,"unplaced":423},
       "omitted": {"data":18},
@@ -2048,7 +2048,7 @@
       "surface": "builders",
       "title": "Profile",
       "states_read": ["own","works","activity","yours","activity-artist","activity-artist-ideas","other","artist","artist-ideas","out"],
-      "files_hash": "a1e1acb3badc9e27",
+      "files_hash": "88fc36c8238827bf",
       "reading_hash": "3ff8d703d17e8c2a",
       "counts": {"lines":232,"placed":84,"shared":7,"unplaced":141},
       "omitted": {"data":263},
@@ -2293,7 +2293,7 @@
       "surface": "builders",
       "title": "Project settings",
       "states_read": ["default"],
-      "files_hash": "bf4ce03972123088",
+      "files_hash": "dec5d7d8359c913d",
       "reading_hash": "283df27d0d5bfc1b",
       "counts": {"lines":43,"placed":25,"shared":7,"unplaced":11},
       "omitted": {"data":33},
@@ -2349,7 +2349,7 @@
       "surface": "builders",
       "title": "Builders",
       "states_read": ["roster","artists","search","out"],
-      "files_hash": "c4f41160afeaf87f",
+      "files_hash": "eada2a8ff8a184ab",
       "reading_hash": "665ac2e36339f5d3",
       "counts": {"lines":56,"placed":17,"shared":7,"unplaced":32},
       "omitted": {"data":137},
@@ -2418,7 +2418,7 @@
       "surface": "builders",
       "title": "Options",
       "states_read": ["account","access","preferences","install-reports","sound","update"],
-      "files_hash": "0f1849a1dab98d9a",
+      "files_hash": "9ee8d40cdee36f53",
       "reading_hash": "898a13fda24c3c90",
       "counts": {"lines":162,"placed":104,"shared":7,"unplaced":51},
       "omitted": {"data":23},
@@ -2593,7 +2593,7 @@
       "surface": "builders",
       "title": "The street",
       "states_read": ["street","fullscreen","card","focus","here","inside-rules","inside-disputes","inside-people","inside-planning","inside-automation","inside-review","inside-release","inside-treasury","floor","amend","district","desk","desk-facts","desk-quiet","desk-people-builders","desk-people-tier","desk-disputes","desk-automation-goals","desk-release-core","desk-rules","desk-rules-category","desk-planning-priorities","desk-planning-ideas","desk-planning-blockers","pins","pins-pager","living","deck","deck-treasury","sitting","object","voted","admission","settled","blocker","blocker-more","report","report-more","core","core-more","recheck","recheck-more","idea","idea-more","queue","queue-more","automation","automation-more"],
-      "files_hash": "6768ffb4c12c21ac",
+      "files_hash": "b034bee92146665b",
       "reading_hash": "e788e6bf4be8d68c",
       "counts": {"lines":325,"placed":54,"shared":6,"unplaced":265},
       "omitted": {"data":240},
@@ -2931,7 +2931,7 @@
       "surface": "builders",
       "title": "Studio",
       "states_read": ["home","out","flow","flow-pick","status","words-offer","words-edit","reviews","full","full-back","approvals","approvals-before","approvals-phone","approvals-note","approved","sent-back","approvals-page"],
-      "files_hash": "8afa7e332b24559f",
+      "files_hash": "c01cf7220bebfb79",
       "reading_hash": "c4e3b4188c1db755",
       "counts": {"lines":51,"placed":29,"shared":7,"unplaced":15},
       "omitted": {"data":23},
@@ -2995,7 +2995,7 @@
       "surface": "builders",
       "title": "Task",
       "states_read": ["record","from-goal","missing"],
-      "files_hash": "b839c7b452afbfbe",
+      "files_hash": "91a9c833cdebb28b",
       "reading_hash": "8dd803b6934e6388",
       "counts": {"lines":151,"placed":46,"shared":9,"unplaced":96},
       "omitted": {"data":111},
@@ -3159,7 +3159,7 @@
       "surface": "builders",
       "title": "Your thinking",
       "states_read": ["tour","sky","list","simple","full-idea","full","full-list","full-back","out"],
-      "files_hash": "3cce7079079c7782",
+      "files_hash": "fa151338327f0a86",
       "reading_hash": "b73f848b46b0f9b8",
       "counts": {"lines":50,"placed":25,"shared":6,"unplaced":19},
       "omitted": {"data":10},
@@ -3222,7 +3222,7 @@
       "surface": "builders",
       "title": "Tweak a page",
       "states_read": ["doc","typed","chrome","submitted","picking","out"],
-      "files_hash": "6fc3e45b7cc82f9f",
+      "files_hash": "f52e3d547a72e46c",
       "reading_hash": "f521f8d9a7147557",
       "counts": {"lines":26,"placed":18,"shared":2,"unplaced":6},
       "omitted": {"data":19},
@@ -3261,7 +3261,7 @@
       "surface": "builders",
       "title": "Watch",
       "states_read": ["board","out","operations","security","sessions","autobongos"],
-      "files_hash": "4e769b3c76d5f3b8",
+      "files_hash": "8c900aaef19935e9",
       "reading_hash": "1961a0c06b9d8477",
       "counts": {"lines":72,"placed":33,"shared":7,"unplaced":32},
       "omitted": {"data":52},
@@ -3346,7 +3346,7 @@
       "surface": "builders",
       "title": "Tasks",
       "states_read": ["ready","in-progress","backlog","completed","filters-open","out","founding"],
-      "files_hash": "cb9ac65fd6baed84",
+      "files_hash": "932f03e5ce99e576",
       "reading_hash": "e9b412d1ec59ceee",
       "counts": {"lines":122,"placed":49,"shared":7,"unplaced":66},
       "omitted": {"data":323},

package/modules/hall-ui/public/craft-mode.js

@@ -830,8 +830,12 @@
   // clears the pick and signs out, and the next sign-in finds none and asks again.
   // Identity and view only — rank still gates every verb on the server (ADR 0016).
   //
-  // The sprites are the owner's art (Builder → Artisan, Artist → Artist, Ruler →
-  // Patron; the Governor is the spare), one file per character under characters/.
+  // The sprites are the second look (task 1005218): 64x64 pixel art, two animals in one
+  // body (Artisan a ram on a lizard, Artist an ibis on an octopus, Patron a falcon on a
+  // lion), each with one colour of its own (style.css --char-*). Three files per character
+  // under characters/: <id>.png the whole figure, <id>-face.png the head (the chip),
+  // <id>-visor.png the head wearing the visor (the visor's corner). All are DRAWN by
+  // docs/design/characters/v2/draw-characters.js --hall, never edited by hand.
   var account;            // undefined: not told; null: none picked; else the character
   var creating = false;   // the preselected door while character creation is open
   var CHAR_KEY = 'hall-character'; // localStorage: the last held character, so the first paint is right
@@ -841,9 +845,14 @@
     patron: 'Watch the project, propose, and with a seat decide.',
   };
   // Only ever one of the three names reaches the URL (valid() is the allowlist).
-  function spriteSrc(id) { return '/builders/characters/' + (valid(id) || 'artisan') + '.png' + (SCRIPT_V ? '?v=' + SCRIPT_V : ''); }
+  function pictureSrc(id, part) { return '/builders/characters/' + (valid(id) || 'artisan') + (part ? '-' + part : '') + '.png' + (SCRIPT_V ? '?v=' + SCRIPT_V : ''); }
+  function spriteSrc(id) { return pictureSrc(id, ''); }
+  // The head alone, and the head wearing the visor (what the visor shows of you).
+  function faceSrc(id) { return pictureSrc(id, 'face'); }
+  function portraitSrc(id) { return pictureSrc(id, 'visor'); }
   function spriteHtml(id, cls) {
-    return '<img class="craft-sprite ' + cls + '" src="' + spriteSrc(id) + '" alt="" width="250" height="290" decoding="async">';
+    var face = cls === 'craft-sprite--chip';
+    return '<img class="craft-sprite ' + cls + '" src="' + (face ? faceSrc(id) : spriteSrc(id)) + '" alt="" width="' + (face ? 32 : 64) + '" height="' + (face ? 32 : 64) + '" decoding="async">';
   }
   function heldCharacter() {
     if (typeof account === 'string') return account;
@@ -1061,6 +1070,8 @@
     character: function () { return account; },
     changeCharacter: changeCharacter,
     spriteSrc: spriteSrc,
+    faceSrc: faceSrc,
+    portraitSrc: portraitSrc,
     // task 1005148: the visor's two reads — the /me the gate saw, and a tool by id.
     me: function () { return lastMe; },
     // A tool opens only for the character whose tool it is (task 1005207): the

package/modules/hall-ui/public/home-city.js

@@ -347,17 +347,28 @@
     wireTip();
     wireDoors();
     if (window.OTBHomeGallery) gallery = window.OTBHomeGallery.attach(host);
+    if (gallery && gallery.onChange) gallery.onChange(registerScene);
     if (window.OTBHomeIdeaBox) ideaBox = window.OTBHomeIdeaBox.attach(host);
     document.addEventListener('otb:craft', craftHome);
     craftHome();
     new MutationObserver(() => { if (model) drawScene(); }).observe(document.documentElement, { attributes: true, attributeFilter: ['data-theme'] });
     document.addEventListener('otb:craft', () => { if (model) { drawScene(); drawLadder(); } });
     window.addEventListener('resize', () => { if (model) drawLadder(); });
-    // task 1005148: Home's city as the visor's scene; R13 adds its camera's actions here.
-    window.__visorScene = { name: 'home', place: 'Home' };
-    if (window.OTBVisor) window.OTBVisor.scene(window.__visorScene);
+    registerScene();
     load();
   }
+  // task 1005148: Home's city as the visor's scene; R13 adds its camera's actions here.
+  // task 1005211 (ADR 0403): in Artistry Home is the gallery, and its controls are the visor's:
+  // the gallery's own rows (home-gallery.js visorActions), registered again when they change.
+  let sceneSig = null;
+  function registerScene() {
+    const actions = gallery && gallery.visorActions ? gallery.visorActions() : [];
+    const sig = actions.map((a) => a.label + '|' + (a.key || '')).join('\n');
+    if (sig === sceneSig && window.__visorScene) return;
+    sceneSig = sig;
+    window.__visorScene = { name: 'home', place: 'Home', actions };
+    if (window.OTBVisor) window.OTBVisor.scene(window.__visorScene);
+  }
 
   window.OTB.contributeHallWidget({
     id: 'home-city', label: 'The project', order: 15, core: true, mount,

package/modules/hall-ui/public/home-gallery.css

@@ -127,3 +127,9 @@
   .hg-count { left: 50%; }
   .hg-salon { left: 20px; right: 20px; top: 196px; grid-template-columns: repeat(auto-fill, minmax(140px, 1fr)); gap: 22px 16px; }
 }
+
+/* task 1005211 (ADR 0403): in game mode the visor is the control and the gallery is the view.
+   Its order tabs, its ways (the full gallery, your studio), the arrows and the full-screen
+   button are rows on the visor (home-gallery.js visorActions); looking along the wall, a work's
+   label, its heart and a piece in the full gallery stay in the scene. Classic mode is as it was. */
+html.visor-on .hg-sort, html.visor-on .hg-ways, html.visor-on .hg-edge, html.visor-on .hg-fsbtn { display: none; }

package/modules/hall-ui/public/home-gallery.js

@@ -122,6 +122,29 @@
     var room = root.querySelector('.hg-room'), track = root.querySelector('.hg-track'), salon = root.querySelector('.hg-salon');
     var prev = root.querySelector('.hg-prev'), next = root.querySelector('.hg-next'), count = root.querySelector('.hg-count');
     var wayAll = root.querySelector('.hg-way-all'), empty = root.querySelector('.hg-empty');
+    var fsbtn = root.querySelector('.hg-fsbtn'), studio = root.querySelector('a.hg-way');
+    // task 1005211 (ADR 0403): in game mode the gallery's tabs, ways, arrows and full-screen
+    // button are the visor's (home-gallery.css hides them under html.visor-on). These are
+    // their rows, each pressing the gallery's own control, in the control's own words; Home
+    // (home-city.js) registers them as the scene's actions and asks again when they change.
+    var changed = function () {};
+    function visorActions() {
+      if (root.hidden) return [];
+      var all = room.classList.contains('is-all');
+      var out = [{ label: wayAll.firstChild.textContent.trim(), key: 'g', bind: true, lead: true, run: function () { wayAll.click(); room.focus(); } }];
+      root.querySelectorAll('.hg-sort button').forEach(function (b) {
+        out.push({ label: b.textContent + (b.getAttribute('aria-pressed') === 'true' ? ' · on' : ' · off'), run: function () { b.click(); } });
+      });
+      // the wall's own keys answer once the room has the keyboard, so a row hands it over
+      if (!all && list.length) {
+        out.push({ label: prev.getAttribute('aria-label'), key: '←', run: function () { prev.click(); room.focus(); } });
+        out.push({ label: next.getAttribute('aria-label'), key: '→', run: function () { next.click(); room.focus(); } });
+        out.push({ label: 'Full screen', key: 'F', run: function () { fsbtn.click(); room.focus(); } });
+      }
+      var href = studio.getAttribute('href');
+      out.push({ label: studio.firstChild.textContent.trim(), run: function () { window.location.assign(href); } });
+      return out;
+    }
     room.setAttribute('aria-label', ROOM_LABEL);
 
     function hang(w, i) {
@@ -239,6 +262,7 @@
       wayAll.firstChild.textContent = on ? 'Back to the bench ' : 'The full gallery ';
       room.setAttribute('aria-label', on ? ALL_LABEL : ROOM_LABEL);
       if (on) renderSalon();
+      changed();
     }
 
     // ---- full screen: the art alone, with its signature and heart ----
@@ -264,6 +288,7 @@
         if (order === b.dataset.order) return;
         order = b.dataset.order;
         root.querySelectorAll('.hg-sort button').forEach(function (x) { x.setAttribute('aria-pressed', String(x === b)); });
+        changed();
         load();
       });
     });
@@ -327,6 +352,7 @@
         if (mine !== asking) return;
         list = res && res.ok && res.data && Array.isArray(res.data.works) ? res.data.works.filter(function (w) { return w && w.id && w.artist; }) : [];
         render();
+        changed();
         if (first) { first = false; arrive(); }
       }, function () { if (mine === asking) { list = []; render(); } });
     }
@@ -348,7 +374,11 @@
         root.hidden = !on;
         if (on && !loaded) load();
         if (!on && isFs()) setFs(false);
+        changed();
       },
+      // task 1005211: the rows the visor shows for the gallery, and a hook for when they change
+      visorActions: visorActions,
+      onChange: function (fn) { changed = typeof fn === 'function' ? fn : function () {}; },
     };
   }
 

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

@@ -1587,15 +1587,28 @@ html.opt-window-open { overflow: hidden; }
 
 /* THE CHARACTER (task 1005147). A builder who holds a character wears its sprite in
    the top bar in place of the switch: one button, which offers "Change character"
-   (signing out). The sprites are pixel art, so they scale by whole pixels. */
+   (signing out). The sprites are pixel art, so they scale by whole pixels.
+   EACH CHARACTER HAS ONE COLOUR (task 1005218; --char-*): the Artisan's is the hall's own
+   accent, the Artist's violet and the Patron's gold are the two colours the second look
+   added, the same three the pictures are drawn in (docs/design/characters/v2). In game mode
+   the visor wears the held character's (visor.css). */
+html {
+  --char-artisan: var(--accent);
+  --char-artist: color-mix(in oklch, color-mix(in oklch, var(--sea) 82%, var(--accent)) 72%, var(--ink));
+  --char-patron: color-mix(in srgb, var(--warn) 72%, var(--ink));
+}
 .craft-sprite { display: block; image-rendering: pixelated; object-fit: contain; }
 .craft-switch__me { padding: 0 10px 0 4px; color: var(--ink); }
-/* The chip is the figure's head: the portrait cropped to its top third. */
-.craft-sprite--chip { width: 26px; height: 26px; border-radius: var(--radius-pill); object-fit: cover; object-position: 50% 22%; }
+/* The chip is the figure's head: its own 32px picture. */
+.craft-sprite--chip { width: 26px; height: 26px; border-radius: var(--radius-pill); object-fit: cover; background: var(--bg-deep); }
 /* Character creation: each door is the owner's portrait — the figure on its plinth
    in the torch-lit hall — filling the top of the door, the words beneath it. */
-.craft-plinth { display: block; overflow: hidden; }
-.craft-sprite--door { width: 100%; height: auto; aspect-ratio: 250 / 290; transition: transform var(--ds-dur-base) var(--ds-ease); }
+.craft-plinth { display: block; overflow: hidden; background: var(--bg-deep); }
+.craft-sprite--door { width: 100%; height: auto; aspect-ratio: 1; transition: transform var(--ds-dur-base) var(--ds-ease); }
+.craft-door--artisan { --char: var(--char-artisan); }
+.craft-door--artist { --char: var(--char-artist); }
+.craft-door--patron { --char: var(--char-patron); }
+.craft-door--character .craft-door__name { color: var(--char); }
 .craft-door--character:hover .craft-sprite--door,
 .craft-door--character:focus-visible .craft-sprite--door { transform: scale(1.03); }
 

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

@@ -18,6 +18,21 @@ html[data-game="on"] .visor:not([hidden]) {
   color: var(--ink); font-family: var(--font-body);
 }
 
+/* THE GLASS TAKES YOUR CHARACTER'S COLOUR (task 1005218). --char is the held character's one
+   colour (style.css --char-*): the frame's lines, the sight, your name and the rim of your
+   picture wear it, and the accent on the glass (the one button, the segment being built, a
+   hovered row) IS it, so nothing here names a colour of its own. The Artisan's is the hall's
+   accent, so an Artisan's glass is the accent it always was. */
+.visor[data-character="artisan"] { --char: var(--char-artisan, var(--accent)); }
+.visor[data-character="artist"] { --char: var(--char-artist, var(--accent)); }
+.visor[data-character="patron"] { --char: var(--char-patron, var(--accent)); }
+/* on the glass's parts, not the glass: --char reads the hall's accent above, so re-pointing
+   the accent on the same element would be a cycle */
+.visor[data-character] > * {
+  --accent: var(--char); --accent-ink: var(--char);
+  --accent-lift: color-mix(in srgb, var(--char) 58%, var(--ink));
+}
+
 /* the frame: each arc is stretched across the stage, every stroke one hairline at any size. The
    top arc, its notch and the place all sit inside the top inset, above where a scene starts its
    own top row; the foot arc runs under the foot row. */
@@ -25,9 +40,9 @@ html[data-game="on"] .visor:not([hidden]) {
 .visor__frame--top { top: calc(var(--visor-arc) - 50px); height: 42px; }
 .visor__frame--foot { bottom: calc(var(--visor-inset-bottom) - 44px); height: 18px; }
 .visor__frame path { vector-effect: non-scaling-stroke; }
-.visor__line { fill: none; stroke: var(--ink-soft); stroke-opacity: .6; stroke-width: var(--line-strong); }
+.visor__line { fill: none; stroke: var(--char, var(--ink-soft)); stroke-opacity: .7; stroke-width: var(--line-strong); }
 .visor__line--under { stroke: var(--bg); stroke-opacity: 1; stroke-width: 5px; }
-.visor__dot { fill: var(--ink-soft); stroke: var(--bg); stroke-width: var(--line-strong); }
+.visor__dot { fill: var(--char, var(--ink-soft)); stroke: var(--bg); stroke-width: var(--line-strong); }
 .visor__notch, .visor__sight { position: absolute; left: 50%; transform: translate(-50%, -50%); overflow: visible; }
 .visor__notch { top: calc(var(--visor-arc) - 36px); width: 12px; height: 9px; }
 .visor__sight { top: 50%; width: 24px; height: 24px; }
@@ -76,12 +91,12 @@ html[data-game="on"] .visor:not([hidden]) {
   transform: perspective(900px) rotateY(16deg); transform-origin: left center;
 }
 .visor__sprite {
-  flex: none; width: 56px; height: 56px; object-fit: cover; object-position: 50% 12%;
-  background: var(--glass-strong); clip-path: var(--cut-path-sm);
+  flex: none; box-sizing: border-box; width: 56px; height: 56px; object-fit: cover; image-rendering: pixelated;
+  background: var(--bg-card); border: var(--line-strong) solid var(--char, var(--ink-soft)); clip-path: var(--cut-path-sm);
 }
 /* your name and credits stand in a box of the night, cut like the sprite beside it */
 .visor__who { display: flex; flex-direction: column; gap: 2px; padding: var(--ds-space-hair) var(--ds-space-xs); }
-.visor__name { font-size: var(--ds-text-xs); letter-spacing: var(--name-space); line-height: 1; color: var(--ink-soft); }
+.visor__name { font-size: var(--ds-text-xs); letter-spacing: var(--name-space); line-height: 1; color: var(--char, var(--ink-soft)); }
 .visor__credits { display: flex; align-items: baseline; gap: var(--ds-space-xs); white-space: nowrap; }
 .visor__num { font-family: var(--name-face); font-size: var(--ds-text-headline); font-weight: 400; line-height: 1; color: var(--ink); font-variant-numeric: tabular-nums; }
 .visor__unit { font-size: var(--ds-text-md); letter-spacing: var(--name-space); color: var(--ink-soft); }

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

@@ -7,7 +7,8 @@
 //     a small notch under the top arc and a ring-and-dot sight at the centre. Drawn as SVG;
 //     it is ornament, never a control.
 //   - the place, in the name voice under the top arc ("THE SKY", "GOVERNOR CITY", …).
-//   - the foot row. Left: your sprite (third person), your character's name and your credits
+//   - the foot row. Left: your sprite (your character's head, wearing the visor, its rim in
+//     the character's colour; task 1005218), your character's name and your credits
 //     (builders.total_credits — credits only, never a payout; the spec's "does not exist").
 //     Centre: your character's main action, the one accent button, with its key. Right: the
 //     quiet key hints, no boxes: your other actions, "Actions" (key A), which opens the
@@ -189,14 +190,16 @@
   }
   function glassHtml(id) {
     var acts = actionsFor(id), main = acts[0], C = craft();
-    var sprite = C && typeof C.spriteSrc === 'function' ? C.spriteSrc(id) : '';
+    // Your picture on the glass is you wearing the visor (task 1005218); an older craft-mode
+    // without that picture still hands over the whole figure.
+    var sprite = C && typeof C.portraitSrc === 'function' ? C.portraitSrc(id) : (C && typeof C.spriteSrc === 'function' ? C.spriteSrc(id) : '');
     var n = credits();
     return frameSvg() +
       (scene.place ? '<p class="visor__place">' + esc(scene.place) + '</p>' : '') +
       progressHtml() +
       '<div class="visor__foot">' +
         '<div class="visor__me">' +
-          (sprite ? '<img class="visor__sprite" src="' + esc(sprite) + '" alt="" width="250" height="290" decoding="async">' : '') +
+          (sprite ? '<img class="visor__sprite" src="' + esc(sprite) + '" alt="" width="32" height="32" decoding="async">' : '') +
           '<span class="visor__who"><span class="visor__name">' + esc(NAMES[id]) + '</span>' +
           '<span class="visor__credits" data-visor-credits>' + creditsHtml(n) + '</span></span>' +
         '</div>' +

package/modules/hall-ui/records/characters.md

@@ -0,0 +1,19 @@
+# The characters — the three pictures, their colours, and where each is worn (task 1005218; ADR 0405)
+
+Covers: `public/characters/*.png`, the character parts of `craft-mode.js` (creation doors, the top-bar chip), the `--char-*` tokens in `style.css`, and the character's colour on the visor (`visor.css`). The visor itself is in `visor.md`; character creation's behaviour is task 1005147's and is unchanged.
+
+## What it settled
+
+- **The second look.** 64 by 64 pixel art, two animals in one body, as aliens in the Helm night. One animal gives the whole head, the other the whole body: Artisan a ram on a lizard with the long spanner, Artist an ibis on an octopus with the light-brush, Patron a falcon on a lion with the staff of office. They stand three-quarters to the viewer on a lit disc. The six rules the owner's feedback set (recognisable animals, not childish, a role tool, a 2.5D stance, simple shapes, one light) are the header of the drawing script.
+- **The pictures are drawn, never edited.** `node docs/design/characters/v2/draw-characters.js --hall` writes all nine files: `<id>.png` (the whole figure, 64 by 64: the creation doors), `<id>-face.png` (the head, 32 by 32: the top-bar chip) and `<id>-visor.png` (the head wearing the visor, 32 by 32: the visor's corner). `craft-mode.js` hands them out as `spriteSrc`, `faceSrc` and `portraitSrc`.
+- **One colour each** (`style.css`, on `html`, beside the sprite rules): `--char-artisan` is the accent, `--char-artist` a violet and `--char-patron` a gold, both mixed from the hall's own tokens (ADR 0405 §2). No colour is typed in.
+- **Where the colour is worn.** The creation door's name; and, in game mode, the visor: `.visor[data-character]` sets `--char` and re-points `--accent`, `--accent-ink` and `--accent-lift` at it, so the frame's lines, the sight, the name, the picture's rim, the one button and the segment being built all follow with no rule of their own. An Artisan's glass is exactly what it was.
+- **Pixel art scales by nearest pixel** (`image-rendering: pixelated`) everywhere a picture is shown.
+
+## Not done
+
+- A scene's own buttons keep the hall's accent under a violet or gold glass (the Governor City's "decide" button). ADR 0403's follow-up tasks move them to the visor.
+- The visor shows the 32px head at 56px (36px on a phone), which is not a whole multiple, so a few pixels are uneven.
+- The pictures keep their own fixed colours when a host re-themes its accent.
+
+Tests: `tests/character_creation.mjs` (the nine files, their sizes, the chip's picture) and `tests/hall_visor.mjs` (the portrait, the colour on the glass per character).