@bongos/core 1.19.429 → 1.19.431

package/modules/provisioning/tests/provisioning.mjs

@@ -330,6 +330,40 @@ t('projectDetail: a stored value that has since LEFT the vocabulary never leaks
   assert.deepEqual(P.projectDetail(null), {});
 });
 
+t('the planet (task 1003347): PLANET_TEMPLATES mirrors platform-identity\'s PROJECT_TEMPLATES name for name; the accents are the world\'s five token names', () => {
+  const pi = require('../../platform-identity/platform-identity.js');
+  assert.deepEqual([...P.PLANET_TEMPLATES], [...pi.PROJECT_TEMPLATES], 'the two modules never import each other — the mirror is pinned instead (the PROJECT_TYPES precedent)');
+  assert.equal(P.PLANET_TEMPLATES.length, 36);
+  assert.deepEqual([...P.PLANET_ACCENTS], ['sea', 'terracotta', 'gold-soft', 'sun-lit', 'accent']);
+  for (const a of P.PLANET_ACCENTS) assert.doesNotMatch(a, /^#|rgb|hsl/, 'a name, never a colour (the Fifteen Rule)');
+  assert.deepEqual(Object.keys(P.PLANET_VOCAB), ['planet_template', 'planet_accent']);
+  // the deliberate asymmetry: the planet is NOT a setting — no default, never in SETTINGS_VOCAB
+  for (const k of Object.keys(P.PLANET_VOCAB)) {
+    assert.ok(!(k in P.SETTINGS_VOCAB), `${k} is not a policy the instance obeys`);
+    assert.ok(!(k in P.DEFAULT_SETTINGS), `${k} has no default — null is the platform's own pick`);
+  }
+});
+
+t('planetChoice: null for a bare row or an unset key; a stored on-vocabulary value reads back; junk reads null, never leaks', () => {
+  assert.deepEqual(P.planetChoice(null), { planet_template: null, planet_accent: null });
+  assert.deepEqual(P.planetChoice({}), { planet_template: null, planet_accent: null });
+  assert.deepEqual(P.planetChoice({ settings: { platform_visibility: 'gated' } }), { planet_template: null, planet_accent: null });
+  assert.deepEqual(P.planetChoice({ settings: { planet_template: 'pair-frost-tint', planet_accent: 'sun-lit' } }), { planet_template: 'pair-frost-tint', planet_accent: 'sun-lit' });
+  assert.deepEqual(P.planetChoice({ settings: { planet_template: 'cube', planet_accent: '#fff' } }), { planet_template: null, planet_accent: null });
+  assert.deepEqual(P.planetChoice({ settings: ['nope'] }), { planet_template: null, planet_accent: null });
+});
+
+t('publicInstance carries the planet — both keys, null when unset — so the list and the manage page read it off the row', () => {
+  const chosen = P.publicInstance({ id: 1, slug: 'x', status: 'active', settings: { planet_template: 'bead-gold-tint', planet_accent: 'sea' } });
+  assert.equal(chosen.planet_template, 'bead-gold-tint');
+  assert.equal(chosen.planet_accent, 'sea');
+  const unset = P.publicInstance({ id: 2, slug: 'y', status: 'active' });
+  assert.ok('planet_template' in unset && 'planet_accent' in unset, 'the keys are always present');
+  assert.equal(unset.planet_template, null);
+  assert.equal(unset.planet_accent, null);
+  assert.ok(!('settings' in unset), 'the raw jsonb never rides the projection');
+});
+
 t('PROJECT_DETAIL_VOCAB carries NO defaults — an unanswered question stays unanswered', () => {
   // The deliberate asymmetry with SETTINGS_VOCAB: a setting is a policy the
   // instance must obey, so it needs a default; a detail answer is something the

package/modules/ui-design/kit/fixtures/featured-hub.json

@@ -1 +1 @@
-{"_":"The hub's catalog (task 1003345): the landing's featured.json plus Tidewater, an all-null row nobody owns — the card-floor state opens ITS card, because Demo is owned by the signed-in stub (provisioning-instances.json) and an owned orb's plain click opens the manage view, never the card. Served under the name \"featured\" by projects.states.json's stub.fixtures alias; the landing keeps featured.json.","projects":[{"origin":"https://amazonprimea.com","name":"Off the Boats","tagline":"A singular shop, and a broader videogame in a persistent ancient Greek world that collides with modern day commerce & products.","art_url":"/assets/world/r2-chrome-blob-one.jpg","type":"game","template":"bead-wash","created_at":"2026-07-15T22:12:57.732Z","builders":11,"tags":["art-pipeline","character-anim","demo","game"],"owner":"lars589","owner_avatar":"https://avatars.githubusercontent.com/u/283020391?v=4","faces":["https://avatars.githubusercontent.com/u/283020391?v=4","https://avatars.githubusercontent.com/u/64553469?v=4","https://avatars.githubusercontent.com/u/290184380?v=4","https://avatars.githubusercontent.com/u/295990394?v=4","https://avatars.githubusercontent.com/u/35337514?v=4"],"shipped_30d":0,"shipped_30d_capped":false,"hall_origin":"https://builders.amazonprimea.com"},{"origin":"https://demo.cloudbongos.com","name":"Demo","tagline":"A live demo instance on Cloud Bongos.","art_url":null,"type":null,"template":"pair-gold-wash","created_at":"2026-07-14T19:16:38.160Z","builders":null,"tags":null,"owner":null,"owner_avatar":null,"faces":null,"shipped_30d":null,"shipped_30d_capped":null,"hall_origin":null},{"origin":"https://emersonian-circles.cloudbongos.com","name":"Emersonian Circles","tagline":"An independent project built on Cloud Bongos.","art_url":null,"type":null,"template":null,"created_at":"2026-07-25T02:21:55.641Z","builders":1,"tags":[],"owner":"lars589","owner_avatar":"https://avatars.githubusercontent.com/u/283020391?v=4","faces":[],"shipped_30d":30,"shipped_30d_capped":true,"hall_origin":null},{"origin":"https://tidewater.cloudbongos.com","name":"Tidewater","tagline":"A project that has declared nothing yet.","art_url":null,"type":null,"template":null,"created_at":"2026-07-20T08:00:00.000Z","builders":null,"tags":null,"owner":null,"owner_avatar":null,"faces":null,"shipped_30d":null,"shipped_30d_capped":null,"hall_origin":null}]}
+{"_":"The hub's catalog (task 1003345): the landing's featured.json plus Tidewater, an all-null row nobody owns — the card-floor state opens ITS card, because Demo is owned by the signed-in stub (provisioning-instances.json) and an owned orb's plain click opens the manage view, never the card. Served under the name \"featured\" by projects.states.json's stub.fixtures alias; the landing keeps featured.json.","projects":[{"origin":"https://amazonprimea.com","name":"Off the Boats","tagline":"A singular shop, and a broader videogame in a persistent ancient Greek world that collides with modern day commerce & products.","art_url":"/assets/world/r2-chrome-blob-one.jpg","type":"game","template":"bead-wash","planet_template":null,"planet_accent":null,"created_at":"2026-07-15T22:12:57.732Z","builders":11,"tags":["art-pipeline","character-anim","demo","game"],"owner":"lars589","owner_avatar":"https://avatars.githubusercontent.com/u/283020391?v=4","faces":["https://avatars.githubusercontent.com/u/283020391?v=4","https://avatars.githubusercontent.com/u/64553469?v=4","https://avatars.githubusercontent.com/u/290184380?v=4","https://avatars.githubusercontent.com/u/295990394?v=4","https://avatars.githubusercontent.com/u/35337514?v=4"],"shipped_30d":0,"shipped_30d_capped":false,"hall_origin":"https://builders.amazonprimea.com"},{"origin":"https://demo.cloudbongos.com","name":"Demo","tagline":"A live demo instance on Cloud Bongos.","art_url":null,"type":null,"template":"pair-gold-wash","planet_template":"pair-obsidian-tint","planet_accent":"sea","created_at":"2026-07-14T19:16:38.160Z","builders":null,"tags":null,"owner":null,"owner_avatar":null,"faces":null,"shipped_30d":null,"shipped_30d_capped":null,"hall_origin":null},{"origin":"https://emersonian-circles.cloudbongos.com","name":"Emersonian Circles","tagline":"An independent project built on Cloud Bongos.","art_url":null,"type":null,"template":null,"planet_template":null,"planet_accent":null,"created_at":"2026-07-25T02:21:55.641Z","builders":1,"tags":[],"owner":"lars589","owner_avatar":"https://avatars.githubusercontent.com/u/283020391?v=4","faces":[],"shipped_30d":30,"shipped_30d_capped":true,"hall_origin":null},{"origin":"https://tidewater.cloudbongos.com","name":"Tidewater","tagline":"A project that has declared nothing yet.","art_url":null,"type":null,"template":null,"planet_template":null,"planet_accent":null,"created_at":"2026-07-20T08:00:00.000Z","builders":null,"tags":null,"owner":null,"owner_avatar":null,"faces":null,"shipped_30d":null,"shipped_30d_capped":null,"hall_origin":null}]}

package/modules/ui-design/kit/fixtures/featured.json

@@ -1 +1 @@
-{"projects":[{"origin":"https://amazonprimea.com","name":"Off the Boats","tagline":"A singular shop, and a broader videogame in a persistent ancient Greek world that collides with modern day commerce & products.","art_url":"/assets/world/r2-chrome-blob-one.jpg","type":"game","template":"bead-wash","created_at":"2026-07-15T22:12:57.732Z","builders":11,"tags":["art-pipeline","character-anim","demo","game"],"owner":"lars589","owner_avatar":"https://avatars.githubusercontent.com/u/283020391?v=4","faces":["https://avatars.githubusercontent.com/u/283020391?v=4","https://avatars.githubusercontent.com/u/64553469?v=4","https://avatars.githubusercontent.com/u/290184380?v=4","https://avatars.githubusercontent.com/u/295990394?v=4","https://avatars.githubusercontent.com/u/35337514?v=4"],"shipped_30d":0,"shipped_30d_capped":false,"hall_origin":"https://builders.amazonprimea.com"},{"origin":"https://demo.cloudbongos.com","name":"Demo","tagline":"A live demo instance on Cloud Bongos.","art_url":null,"type":null,"template":"pair-gold-wash","created_at":"2026-07-14T19:16:38.160Z","builders":null,"tags":null,"owner":null,"owner_avatar":null,"faces":null,"shipped_30d":null,"shipped_30d_capped":null,"hall_origin":null},{"origin":"https://emersonian-circles.cloudbongos.com","name":"Emersonian Circles","tagline":"An independent project built on Cloud Bongos.","art_url":null,"type":null,"template":null,"created_at":"2026-07-25T02:21:55.641Z","builders":1,"tags":[],"owner":"lars589","owner_avatar":"https://avatars.githubusercontent.com/u/283020391?v=4","faces":[],"shipped_30d":30,"shipped_30d_capped":true,"hall_origin":null}]}
+{"projects":[{"origin":"https://amazonprimea.com","name":"Off the Boats","tagline":"A singular shop, and a broader videogame in a persistent ancient Greek world that collides with modern day commerce & products.","art_url":"/assets/world/r2-chrome-blob-one.jpg","type":"game","template":"bead-wash","planet_template":null,"planet_accent":null,"created_at":"2026-07-15T22:12:57.732Z","builders":11,"tags":["art-pipeline","character-anim","demo","game"],"owner":"lars589","owner_avatar":"https://avatars.githubusercontent.com/u/283020391?v=4","faces":["https://avatars.githubusercontent.com/u/283020391?v=4","https://avatars.githubusercontent.com/u/64553469?v=4","https://avatars.githubusercontent.com/u/290184380?v=4","https://avatars.githubusercontent.com/u/295990394?v=4","https://avatars.githubusercontent.com/u/35337514?v=4"],"shipped_30d":0,"shipped_30d_capped":false,"hall_origin":"https://builders.amazonprimea.com"},{"origin":"https://demo.cloudbongos.com","name":"Demo","tagline":"A live demo instance on Cloud Bongos.","art_url":null,"type":null,"template":"pair-gold-wash","planet_template":"pair-obsidian-tint","planet_accent":"sea","created_at":"2026-07-14T19:16:38.160Z","builders":null,"tags":null,"owner":null,"owner_avatar":null,"faces":null,"shipped_30d":null,"shipped_30d_capped":null,"hall_origin":null},{"origin":"https://emersonian-circles.cloudbongos.com","name":"Emersonian Circles","tagline":"An independent project built on Cloud Bongos.","art_url":null,"type":null,"template":null,"planet_template":null,"planet_accent":null,"created_at":"2026-07-25T02:21:55.641Z","builders":1,"tags":[],"owner":"lars589","owner_avatar":"https://avatars.githubusercontent.com/u/283020391?v=4","faces":[],"shipped_30d":30,"shipped_30d_capped":true,"hall_origin":null}]}

package/modules/ui-design/kit/fixtures/provisioning-instances.json

@@ -22,7 +22,7 @@
     {
       "id": 102,
       "slug": "harbor",
-      "status": "provisioning",
+      "status": "provisioning", "planet_template": "blob-frost-tint", "planet_accent": "sun-lit",
       "domain": null,
       "target_ref": "builder/harbor",
       "hosting_shape": "standalone",

package/modules/ui-design/kit/serve.js

@@ -133,11 +133,33 @@ const FLOW_RECEIPTS = {
 // after a receipt (doDelete → loadManage), and what it must then see is the queued intent —
 // the same open_intent shape the route stamps — not the untouched fixture row
 const ASKED = new Map();
+// the planet picker (task 1003347): a settings PATCH that carries planet_* is REMEMBERED for
+// the run — the page repaints from the row it re-reads, so the row must carry the choice; a
+// PATCH with only planet keys gets the route's no-restart receipt, a policy key the push
+const PLANETS = new Map();
+const PLANET_KEYS = ['planet_template', 'planet_accent'];
+const NO_PLANET = { planet_template: null, planet_accent: null };
+function readBody(req, cb) {
+  let d = '';
+  req.on('data', (c) => { d += c; });
+  req.on('end', () => { let b = {}; try { b = JSON.parse(d || '{}'); } catch { b = {}; } cb(b); });
+}
+function settingsPatch(res, id, body) {
+  if (PLANET_KEYS.some((k) => k in body)) PLANETS.set(String(id), { planet_template: body.planet_template || null, planet_accent: body.planet_accent || null });
+  const policy = ['platform_visibility', 'joinability'].some((k) => k in body);
+  const push = policy ? FLOW_RECEIPTS.settings.push
+    : { queued: false, restart: false, message: 'Saved. The sky, your list and the card draw it this way from here; nothing on your project restarts for it.' };
+  return json(res, 200, { ok: true, saved: FLOW_RECEIPTS.settings.settings, planet: PLANETS.get(String(id)) || NO_PLANET, push });
+}
+// the row carries its planet: a saved pick for the run, else the fixture's own (or null)
+function withPlanet(inst) {
+  const saved = PLANETS.get(String(inst.id));
+  return { ...inst, planet_template: inst.planet_template || null, planet_accent: inst.planet_accent || null, ...(saved || {}) };
+}
 function flowReceipt(rest, method) {
   if (method === 'POST' && rest === '/provisioning/instances') return FLOW_RECEIPTS.provision;
-  const m = rest.match(/^\/provisioning\/instances\/(\d+)\/(teardown|restart|domain|settings)$/);
+  const m = rest.match(/^\/provisioning\/instances\/(\d+)\/(teardown|restart|domain)$/);
   if (!m) return null;
-  if (m[2] === 'settings') return method === 'PATCH' ? FLOW_RECEIPTS.settings : null;
   if (method !== 'POST') return null;
   if (m[2] === 'teardown' || m[2] === 'restart') ASKED.set(m[1], m[2]);
   return FLOW_RECEIPTS[m[2]];
@@ -151,11 +173,11 @@ function instances(res, id, settings) {
   if (FAIL.has(name)) return json(res, 500, { error: { code: 'stub_failure', message: `FAIL=${name}` } });
   const file = path.join(FIXTURES, (ALIAS[name] || name) + '.json');
   if (!fs.existsSync(file)) return json(res, 404, { error: { code: 'no_fixture', message: name } });
-  const list = stamp((JSON.parse(fs.readFileSync(file, 'utf8')).instances || []).map(withAsk));
+  const list = stamp((JSON.parse(fs.readFileSync(file, 'utf8')).instances || []).map(withAsk).map(withPlanet));
   if (id === null) return json(res, 200, { instances: list });
   const inst = list.find((i) => String(i.id) === String(id));
   if (!inst) return json(res, 404, { error: { code: 'not_found', message: 'no such instance' } });
-  if (settings) return json(res, 200, { settings: { platform_visibility: 'public', joinability: 'open' }, options: { platform_visibility: ['public', 'gated'], joinability: ['open', 'apply', 'invite_only'] } });
+  if (settings) return json(res, 200, { settings: { platform_visibility: 'public', joinability: 'open' }, planet: PLANETS.get(String(id)) || NO_PLANET, options: { platform_visibility: ['public', 'gated'], joinability: ['open', 'apply', 'invite_only'] } });
   return json(res, 200, { instance: inst, open_intent: inst.open_intent || null });
 }
 // A project's art in the featured fixture may be root-relative (the surface's
@@ -215,6 +237,8 @@ const server = http.createServer((req, res) => {
     // (ADR 0111) — the stub answers each ask with the route's receipt so the probes can drive
     // attach / restart / teardown / revive / join end to end; nothing changes in the fixture
     if (req.method !== 'GET') {
+      const ps = rest.match(/^\/provisioning\/instances\/(\d+)\/settings$/);
+      if (ps && req.method === 'PATCH') return AUTH ? readBody(req, (body) => settingsPatch(res, ps[1], body)) : json(res, 401, UNAUTH);
       const flow = flowReceipt(rest, req.method);
       if (flow) return AUTH ? json(res, 200, flow) : json(res, 401, UNAUTH);
     }

package/package-lock.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.429",
+  "version": "1.19.431",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/public-landing/assets/cosmos.css

@@ -1357,6 +1357,29 @@ p.sec-p{font-size:var(--fs-lede);font-weight:500;color:var(--ink-soft);line-heig
 #view-manage .visOpt:has(input:checked) b::before{background:var(--accent);border-color:var(--accent);outline:4px solid color-mix(in srgb,var(--accent) 22%,transparent);}
 #view-manage .visOpt:focus-within{outline:2px solid var(--accent);outline-offset:3px;}
 #view-manage #mVisRuns b,#view-manage #mJoinRuns b{color:var(--ok);font-weight:500;}
+/* ── its planet (task 1003347; direction record §16, v1 the bands): the preview
+   planet left; four bands right — shape · material · style as hairline cells of
+   one band, a word each, the chosen one carrying the dot; the colour as five
+   swatches, the chosen one ringed by a hairline of the ink. The cells outrank
+   the section's generic radiogroup rule by their class. ── */
+#view-manage .pick{display:grid;grid-template-columns:168px 1fr;gap:0 34px;align-items:start;}
+#view-manage .pickPreview{display:grid;gap:12px;justify-items:center;padding-top:6px;}
+#view-manage .pickWords{margin:0;font-size:14px;font-weight:400;line-height:1.45;color:var(--ink);text-align:center;max-width:168px;}
+#view-manage .pickWords small{display:block;font-size:12.5px;color:var(--ink-soft);}
+#view-manage .pickBands{display:grid;border-bottom:1px solid var(--rule);}
+#view-manage .pickBand{display:grid;grid-template-columns:88px 1fr;gap:0 18px;align-items:center;border-top:1px solid var(--rule);}
+#view-manage .pickLabel{font-family:var(--label-face);font-size:var(--label-size);letter-spacing:var(--label-space);text-transform:uppercase;color:var(--ink-faint);padding:14px 0;}
+#view-manage .pickCells[role="radiogroup"]{display:grid;grid-template-columns:none;grid-auto-flow:column;grid-auto-columns:1fr;border:0;}
+#view-manage .pickCell{position:relative;display:flex;align-items:center;gap:10px;min-height:48px;margin:0;padding:10px 16px;border:0;border-left:1px solid var(--rule-soft);border-radius:0;cursor:pointer;font-family:var(--font-body);font-weight:400;font-size:14.5px;color:var(--ink-soft);}
+#view-manage .pickCell::before{content:"";width:7px;height:7px;border-radius:50%;border:1px solid var(--rule);background:var(--bg);flex:none;}
+#view-manage .pickCell:hover,#view-manage .pickCell.on{color:var(--ink);}
+#view-manage .pickCell.on::before{background:var(--accent);border-color:var(--accent);outline:4px solid color-mix(in srgb,var(--accent) 22%,transparent);}
+#view-manage .pickCell input,#view-manage .pickSw input,#view-manage .pickSw span{position:absolute;width:1px;height:1px;margin:0;overflow:hidden;clip-path:inset(50%);}
+#view-manage .pickCell:focus-within,#view-manage .pickSw:focus-within{outline:2px solid var(--accent);outline-offset:3px;}
+#view-manage .pickSwatches[role="radiogroup"]{display:flex;gap:14px;align-items:center;padding:12px 0 12px 16px;border:0;border-left:1px solid var(--rule-soft);}
+#view-manage .pickSw{position:relative;display:block;width:28px;height:28px;margin:0;padding:0;border-radius:50%;border:1px solid var(--rule);background:var(--sw);cursor:pointer;}
+#view-manage .pickSw.on{outline:1px solid var(--ink);outline-offset:3px;}
+#view-manage #mPick .actions{gap:14px;align-items:center;}
 
 /* this block stays HERE, after the rules it narrows: a same-specificity mobile
    override only wins by source order, so folding it into the hub's earlier
@@ -1382,6 +1405,20 @@ p.sec-p{font-size:var(--fs-lede);font-weight:500;color:var(--ink-soft);line-heig
   #view-manage [role="radiogroup"]{grid-template-columns:1fr;}
   #view-manage .visOpt{border-left:0;padding-left:0;border-top:1px solid var(--rule-soft);}
   #view-manage .visOpt:first-child{border-top:0;}
+  /* the picker stacks: the preview above; each band's label above its choices; the
+     cells become the list's filter pills (the chosen one inverted to ink), so the
+     four bands stay one screen */
+  #view-manage .pick{grid-template-columns:1fr;gap:22px 0;}
+  #view-manage .pickPreview{justify-items:start;}
+  #view-manage .pickWords{text-align:left;max-width:none;}
+  #view-manage .pickBand{grid-template-columns:1fr;gap:0;}
+  #view-manage .pickLabel{padding:14px 0 6px;}
+  #view-manage .pickCells[role="radiogroup"]{display:flex;flex-wrap:wrap;gap:8px;padding:0 0 14px;}
+  #view-manage .pickCell{min-height:36px;padding:0 14px;border:1px solid var(--rule);border-radius:var(--radius-pill);gap:0;font-size:14px;}
+  #view-manage .pickCell::before{display:none;}
+  #view-manage .pickCell.on{background:var(--ink);color:var(--bg);border-color:var(--ink);}
+  #view-manage .pickSwatches[role="radiogroup"]{padding:6px 0 14px;border-left:0;}
+  #view-manage #mPick .actions{justify-content:flex-start;}
 }
 @media (prefers-reduced-motion:reduce){
   *,*::before,*::after{animation:none !important;transition:none !important;}

package/public-landing/projects.html

@@ -744,6 +744,22 @@ summary{min-height:24px;padding:3px 0;}
         </details>
       </div>
 
+      <!-- the planet picker (task 1003347; direction record §16, v1 the bands): the
+           owner's own choice of how the platform draws this project — the sky,
+           the list, this page's head and the card read the same row. The pick is
+           a settings save with a receipt, like the two above; unlike them it
+           reaches no instance and restarts nothing (the planet is the platform's
+           to draw). The fold is a SIBLING of the volatile slot so no re-render
+           can drop it. -->
+      <div class="card mSec" id="mPlanetPick">
+        <h2>Its planet</h2>
+        <div id="mPick"><p class="finePrint">Reading the project…</p></div>
+        <details class="finePrint" id="mPickWhat">
+          <summary>What the choice changes</summary>
+          <p>How this project is drawn: on the sky, in your list, at the top of this page and on its card. A planet is a <b>shape</b> (the blob, the bongo pair, the bead), a <b>material</b> (chrome, frost, gold, obsidian), a <b>style</b> (tinted: the colour replaces the material’s own; washed: the material lit by the colour; plain: as it is) and a <b>colour</b>, one of the world’s five. Until you choose, the platform picks one for it. Saving here changes nothing on the project itself: no restart, nothing to apply.</p>
+        </details>
+      </div>
+
       <!-- live since task 1003042: the teardown control, for a project in ANY
            state that still holds something. The server used to refuse a
            'requested' or an 'error' project outright — and force-teardown reused
@@ -1300,6 +1316,12 @@ summary{min-height:24px;padding:3px 0;}
      were orphans). Keeping the per-project variety is what makes a sky legible;
      deriving it from contract tokens is what makes it survive a re-brand. */
   var ORB_ACCENTS = ['var(--sea)', 'var(--terracotta)', 'var(--gold-soft)', 'var(--sun-lit)', 'var(--accent)'];
+  /* the five BY NAME — what an owner's choice stores (task 1003347: a token name,
+     never a colour), in the same order, so a name maps to its var() */
+  var ORB_ACCENT_NAMES = ['sea', 'terracotta', 'gold-soft', 'sun-lit', 'accent'];
+  function accentVar(name) { var i = ORB_ACCENT_NAMES.indexOf(name); return i === -1 ? '' : ORB_ACCENTS[i]; }
+  /* a template name the sky knows, or '' — an unknown name is not a choice */
+  function knownTemplate(name) { return ORB_TEMPLATES.indexOf(name) !== -1 ? name : ''; }
   /* THE PLANET TEMPLATES (task 1003319; the materials, task 1003337). A project's
      orb is one of the world's three whole objects (blob / pair / bead) in one of
      four materials (chrome — the first round, named by omission — frost, gold,
@@ -1357,9 +1379,12 @@ summary{min-height:24px;padding:3px 0;}
         p._tpl = ORB_WALK[i % ORB_WALK.length];
       });
   }
-  function accentOf(p) { return p._acc || ORB_ACCENTS[0]; }
-  /* a curated template wins over the walk; an unknown name is not a choice */
+  /* the owner's own choice first (task 1003347: planet_accent / planet_template ride
+     the featured feed and the owned row alike), then the walk */
+  function accentOf(p) { return accentVar(p.planet_accent) || p._acc || ORB_ACCENTS[0]; }
+  /* the owner's choice wins, then a curated template, then the walk; an unknown name is not a choice */
   function templateOf(p) {
+    if (knownTemplate(p.planet_template)) return p.planet_template;
     return ORB_TEMPLATES.indexOf(p.template) !== -1 ? p.template : (p._tpl || ORB_WALK[0]);
   }
   /* the manage cards' accent rule — one project, one colour, in the sky AND
@@ -4270,13 +4295,19 @@ summary{min-height:24px;padding:3px 0;}
      by its slug, the rule the map's appended entries use — so one project is
      one object in both views and never re-colours between them. ── */
   function planetOf(inst) {
+    /* the owner's own choice (task 1003347) rides the row itself, so it wins in
+       every view before the catalog or the walk is asked; the sky reads the same
+       choice off the featured feed (templateOf / accentOf), so the two agree */
+    var own = { tpl: knownTemplate(inst.planet_template), acc: accentVar(inst.planet_accent) };
     var h = inst.domain ? hostOf(inst.domain) : '';
     for (var i = 0; h && i < catalog.length; i++) {
       if (hostOf(catalog[i].origin) === h) {
-        return { tpl: templateOf(catalog[i]), acc: accentOf(catalog[i]), curated: ORB_TEMPLATES.indexOf(catalog[i].template) !== -1 };
+        var c = catalog[i];
+        return { tpl: own.tpl || templateOf(c), acc: own.acc || accentOf(c), curated: ORB_TEMPLATES.indexOf(c.template) !== -1,
+          chosen: !!(own.tpl || own.acc || knownTemplate(c.planet_template) || accentVar(c.planet_accent)) };
       }
     }
-    return { tpl: slugTemplate(inst.slug), acc: ORB_ACCENTS[slugAccent(inst.slug)], curated: false };
+    return { tpl: own.tpl || slugTemplate(inst.slug), acc: own.acc || ORB_ACCENTS[slugAccent(inst.slug)], curated: false, chosen: !!(own.tpl || own.acc) };
   }
   /* shape[-material]-style → the data attributes cosmos.css draws from (the map's rule) */
   function planetAttrs(pl) {
@@ -4299,6 +4330,10 @@ summary{min-height:24px;padding:3px 0;}
   function repaintPlanets() {
     Object.keys(byId).forEach(function (id) { renderCard(byId[id]); });
     if (manageInst) paintManagePlanet(manageInst);
+    /* the picker may have seeded from the walk before the catalog landed: reseed it
+       only if the resolution actually changed — the owner's pending pick, and a
+       receipt just shown, stand otherwise */
+    if (manageInst && !mPickTouched && JSON.stringify(pickFrom(planetOf(manageInst))) !== mPickSeed) { mPick = null; renderPick(manageInst); }
   }
 
   /* ── the row's object: the planet, its state on the object (ghost = torn
@@ -4808,7 +4843,7 @@ summary{min-height:24px;padding:3px 0;}
   function paintManagePlanet(inst) {
     var pl = planetOf(inst);
     $('mOrb').innerHTML = orbFor(inst);
-    $('mPlanet').innerHTML = ledgerRow(['planet', planetWords(pl) + (pl.curated ? '' : '<small>chosen for it by the platform.</small>')]);
+    $('mPlanet').innerHTML = ledgerRow(['planet', planetWords(pl) + (pl.chosen ? '<small>your choice.</small>' : pl.curated ? '' : '<small>chosen for it by the platform.</small>')]);
     $('mPlanet').hidden = false;
   }
   function renderManage(inst) {
@@ -4846,6 +4881,9 @@ summary{min-height:24px;padding:3px 0;}
        only, so a queued settings push shows up on the tick without a reload */
     renderVisState(inst);
     renderJoinState(inst);
+    /* its planet (task 1003347) reads off the row — fetch-free too; a pick in
+       progress survives the tick because only a different project re-renders it */
+    renderPick(inst);
     /* the page names its project — the heading holds #mName; and in the tab */
     document.title = (inst.slug ? inst.slug + ' — ' : '') + BASE_TITLE;
     /* the card's own story, on the project's own page (task 1003232): the
@@ -5299,6 +5337,127 @@ summary{min-height:24px;padding:3px 0;}
     if (t && t.hasAttribute('data-vis-save')) doVisSave();
   });
 
+  /* ── its planet (task 1003347; direction record §16, v1 the bands): the owner's
+     own choice of how the platform draws the project. Reads OFF THE ROW
+     (publicInstance carries planet_template / planet_accent), so the section is
+     fetch-free like the ledger and safe on the minute tick; the save is the
+     settings PATCH the two sections above use, and its reply is a receipt — the
+     head, the ledger row and the list repaint from the row, never from words in
+     the reply. A planet is shape × material × style (ORB_TEMPLATES, the sky's own
+     names) in one of the five accents BY NAME. ── */
+  var PICK_SHAPES = [['blob', 'the blob'], ['pair', 'the bongo pair'], ['bead', 'the bead']];
+  var PICK_MATERIALS = [['chrome', 'chrome'], ['frost', 'frost'], ['gold', 'gold'], ['obsidian', 'obsidian']];
+  var PICK_STYLES = [['tint', 'tinted'], ['wash', 'washed'], ['plain', 'plain']];
+  var PICK_ACCENTS = [['sea', 'sea'], ['terracotta', 'terracotta'], ['gold-soft', 'soft gold'], ['sun-lit', 'sunlit'], ['accent', 'the accent']];
+  var PICK_FIELDS = { mPickShape: 'shape', mPickMaterial: 'material', mPickStyle: 'style', mPickAccent: 'accent' };
+  var mPick = null;         /* the pending choice: { shape, material, style, accent } */
+  var mPickFor = null;      /* which project it belongs to — a different one starts afresh */
+  var mPickTouched = false; /* the owner changed something since the seed — a late catalog must not undo it */
+  var mPickSeed = '';       /* what the seed resolved to, so a late catalog rebuilds only on a real change */
+  /* shape × material × style → the template name (the chrome material's plain is spelled `chrome`) */
+  function pickTemplate(s) {
+    if (s.material === 'chrome') return s.shape + '-' + (s.style === 'plain' ? 'chrome' : s.style);
+    return s.shape + '-' + s.material + '-' + s.style;
+  }
+  /* a drawn planet → the four fields (the walk's var() back to its name) */
+  function pickFrom(pl) {
+    var parts = pl.tpl.split('-');
+    var style = parts[parts.length - 1];
+    return { shape: parts[0], material: parts.length === 3 ? parts[1] : 'chrome', style: style === 'chrome' ? 'plain' : style,
+      accent: ORB_ACCENT_NAMES[ORB_ACCENTS.indexOf(pl.acc)] || ORB_ACCENT_NAMES[0] };
+  }
+  /* one band: the label, then the choices as hairline cells of one band, a word each */
+  function pickBand(label, name, opts, on) {
+    return '<div class="pickBand"><span class="pickLabel">' + label + '</span><div class="pickCells" role="radiogroup" aria-label="' + label + '">' +
+      opts.map(function (o) {
+        return '<label class="pickCell' + (o[0] === on ? ' on' : '') + '"><input type="radio" name="' + name + '" value="' + esc(o[0]) + '"' +
+          (o[0] === on ? ' checked' : '') + '>' + esc(o[1]) + '</label>';
+      }).join('') + '</div></div>';
+  }
+  function renderPick(inst) {
+    var pl = planetOf(inst);
+    if (!mPick || mPickFor !== inst.id) { mPick = pickFrom(pl); mPickSeed = JSON.stringify(mPick); mPickFor = inst.id; mPickTouched = false; $('mPick').innerHTML = ''; }
+    else if ($('mPick').querySelector('.pick')) return; /* the tick: a pick in progress stands */
+    var s = mPick;
+    var preview = { tpl: pickTemplate(s), acc: accentVar(s.accent) };
+    $('mPick').innerHTML =
+      '<div class="pick">' +
+        '<div class="pickPreview"><span class="worldOrb"' + planetAttrs(preview) + ' style="--acc:' + preview.acc + ';--d:132px" aria-hidden="true"><span class="disc"></span></span>' +
+          '<p class="pickWords">' + planetWords(preview) + '<small>' + (pl.chosen ? 'your choice' : 'the platform’s pick for it') + '</small></p></div>' +
+        '<div class="pickBands">' +
+          pickBand('Shape', 'mPickShape', PICK_SHAPES, s.shape) +
+          pickBand('Material', 'mPickMaterial', PICK_MATERIALS, s.material) +
+          pickBand('Style', 'mPickStyle', PICK_STYLES, s.style) +
+          '<div class="pickBand"><span class="pickLabel">Colour</span><div class="pickSwatches" role="radiogroup" aria-label="Colour">' +
+            PICK_ACCENTS.map(function (a) {
+              return '<label class="pickSw' + (a[0] === s.accent ? ' on' : '') + '" style="--sw:' + accentVar(a[0]) + '"><input type="radio" name="mPickAccent" value="' + a[0] + '"' +
+                (a[0] === s.accent ? ' checked' : '') + '><span>' + esc(a[1]) + '</span></label>';
+            }).join('') + '</div></div>' +
+        '</div>' +
+      '</div>' +
+      '<div class="actions"><button type="button" class="btn small" data-pick-save>Save its planet</button>' +
+        (pl.chosen ? '<button type="button" class="btn small ghost" data-pick-reset>Let the platform choose again</button>' : '') + '</div>' +
+      '<div class="projMsg" id="mPickMsg" role="status" aria-live="polite"></div>';
+  }
+  $('mPick').addEventListener('change', function (ev) {
+    var t = ev.target;
+    var key = t && t.type === 'radio' ? PICK_FIELDS[t.name] : null;
+    if (!key || !manageInst || !mPick) return;
+    mPick[key] = t.value;
+    mPickTouched = true;
+    $('mPick').innerHTML = ''; /* the preview follows the pick: redraw, keeping the cell's focus */
+    renderPick(manageInst);
+    var again = document.querySelector('#mPick input[name="' + t.name + '"][value="' + t.value + '"]');
+    if (again) again.focus({ preventScroll: true });
+  });
+  $('mPick').addEventListener('click', function (ev) {
+    var t = ev.target.closest && ev.target.closest('button');
+    if (!t) return;
+    if (t.hasAttribute('data-pick-save')) doPickSave(false);
+    else if (t.hasAttribute('data-pick-reset')) doPickSave(true);
+  });
+  /* the save: the settings PATCH; null hands the pick back to the platform */
+  function doPickSave(reset) {
+    if (!manageInst || !mPick) return;
+    var body = reset ? { planet_template: null, planet_accent: null } : { planet_template: pickTemplate(mPick), planet_accent: mPick.accent };
+    var box = $('mPickMsg');
+    document.querySelectorAll('#mPick .actions button').forEach(function (b) { b.disabled = true; });
+    box.className = 'projMsg'; box.textContent = 'Saving…';
+    fetch(API + '/provisioning/instances/' + encodeURIComponent(manageId) + '/settings', {
+      method: 'PATCH', credentials: 'same-origin', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body)
+    }).then(function (res) {
+      return jsonOrEmpty(res).then(function (data) {
+        if (res.ok) {
+          /* the row now holds the choice: the head, the ledger row and the list
+             row repaint from it, and the sky re-reads the feed that carries it */
+          var planet = data.planet || {};
+          manageInst.planet_template = planet.planet_template || null;
+          manageInst.planet_accent = planet.planet_accent || null;
+          var row = byId[manageInst.id];
+          if (row) { row.planet_template = manageInst.planet_template; row.planet_accent = manageInst.planet_accent; }
+          mPick = null; mPickTouched = false;
+          $('mPick').innerHTML = '';
+          repaintPlanets();
+          var done = $('mPickMsg');
+          done.className = 'projMsg ok';
+          done.textContent = (data.push && data.push.message) || 'Saved.';
+          loadCatalog();
+          return;
+        }
+        var e = apiError(data, res.status);
+        if (res.status === 401) { box.className = 'projMsg err'; box.innerHTML = signInAgain(); return; }
+        box.className = 'projMsg err';
+        box.textContent = e.message || 'The choice could not be saved — try again in a moment.';
+      });
+    }).catch(function () {
+      box.className = 'projMsg err';
+      box.textContent = 'Couldn’t reach the platform — check your connection and try again.';
+    }).then(function () {
+      document.querySelectorAll('#mPick .actions button').forEach(function (b) { b.disabled = false; });
+    });
+  }
+
   /* ── how people join (task 1003044): the joinability toggle — the visibility
      section's shape, key for key: the CHOICE from the platform's settings row,
      what the project RUNS from its own manifest (brand.project.joinability),

package/public-landing/projects.probes.json

@@ -129,6 +129,18 @@
     { "name": "manage flows: how people join — pick a cell, save, the receipt lands under the choice", "auth": true, "width": 1440, "url": "/projects?view=manage&id=101",
       "steps": [["wait",900],["check","input[name=\"mJoinPick\"][value=\"apply\"]"],["click","[data-join-save]"],["wait",600]],
       "expect": {"text":[["#mJoinMsg","Saved. The project restarts to apply it."],["#mName","demo"]],"checked":"input[name=\"mJoinPick\"][value=\"apply\"]","visible":["#mOrb .worldOrb","#mFacts .ledger .k"]} },
+    { "name": "manage flows: its planet (task 1003347) — pick the bongo pair in gold, washed, on terracotta; save; the receipt lands and the head and the ledger row repaint from the row",
+      "auth": true, "width": 1440, "url": "/projects?view=manage&id=101",
+      "steps": [["wait",900],["check","#mPick input[name=\"mPickShape\"][value=\"pair\"]"],["wait",100],["check","#mPick input[name=\"mPickMaterial\"][value=\"gold\"]"],["wait",100],["check","#mPick input[name=\"mPickStyle\"][value=\"wash\"]"],["wait",100],["check","#mPick input[name=\"mPickAccent\"][value=\"terracotta\"]"],["wait",100],["click","[data-pick-save]"],["wait",700]],
+      "expect": {"text":[["#mPickMsg","Saved. The sky, your list and the card draw it this way from here; nothing on your project restarts for it."],["#mPlanet .v","the bongo pair in gold, washedyour choice."],["#mName","demo"]],"hasClass":[["#mPickMsg","ok",true]],"attr":[["#mOrb .worldOrb","data-template","pair-gold-wash"],["#mPick .pickPreview .worldOrb","data-template","pair-gold-wash"]],"checked":"#mPick input[name=\"mPickAccent\"][value=\"terracotta\"]","visible":["#mPick [data-pick-reset]"]} },
+    { "name": "manage flows: its planet — the pick handed back to the platform: the row's choice clears and the head falls back to the catalog's",
+      "auth": true, "width": 1440, "url": "/projects?view=manage&id=101",
+      "steps": [["wait",900],["click","[data-pick-reset]"],["wait",700]],
+      "expect": {"text":[["#mPickMsg","Saved. The sky, your list and the card draw it this way from here; nothing on your project restarts for it."],["#mName","demo"]],"hasClass":[["#mPickMsg","ok",true]],"attr":[["#mOrb .worldOrb","data-template","pair-obsidian-tint"]]} },
+    { "name": "manage flows: its planet at 390 — the bands fold to pills and a pick still saves",
+      "auth": true, "width": 390, "url": "/projects?view=manage&id=101",
+      "steps": [["wait",900],["check","#mPick input[name=\"mPickShape\"][value=\"blob\"]"],["wait",100],["click","[data-pick-save]"],["wait",700]],
+      "expect": {"hasClass":[["#mPickMsg","ok",true]],"attr":[["#mOrb .worldOrb","data-shape","blob"]],"noOverflow":true} },
     { "name": "manage flows: the ender asks for the name typed back, queues the teardown, and the page re-reads the project as queued", "auth": true, "width": 1440, "url": "/projects?view=manage&id=105",
       "steps": [["wait",900],["click","[data-del-ask]"],["wait",200],["fill","#mDelName","mooring"],["wait",100],["click","[data-del-yes]"],["wait",900]],
       "expect": {"text":[["#mDel .addr","A teardown is queued for this project."],["#mName","mooring"]],"hidden":["#mDelName","[data-del-ask]"],"visible":["#mStrip .strip.flowDown"]} },

package/public-landing/projects.states.json

@@ -9,15 +9,16 @@
   "ignoreControls": [".skip", ".vh"],
   "states": {
     "out-map": { "auth": false, "expect": { "expanded": false } },
-    "in-map": { "auth": true, "expect": { "expanded": false, "count": [["#orbField .worldOrb[data-shape][data-style]", 7]], "attr": [["#selfOrb", "data-template", "pair-chrome"], ["#orbField a.worldOrb[data-origin=\"https://amazonprimea.com\"]", "data-template", "bead-wash"], ["#orbField a.worldOrb[data-origin=\"https://demo.cloudbongos.com\"]", "data-shape", "pair"], ["#orbField a.worldOrb[data-origin=\"https://demo.cloudbongos.com\"]", "data-material", "gold"], ["#orbField a.worldOrb[data-origin=\"https://demo.cloudbongos.com\"]", "data-template", "pair-gold-wash"], ["#orbField a.worldOrb[data-origin=\"https://emersonian-circles.cloudbongos.com\"]", "data-template", "bead-obsidian-plain"]] } },
+    "in-map": { "auth": true, "expect": { "expanded": false, "count": [["#orbField .worldOrb[data-shape][data-style]", 7]], "attr": [["#selfOrb", "data-template", "pair-chrome"], ["#orbField a.worldOrb[data-origin=\"https://amazonprimea.com\"]", "data-template", "bead-wash"], ["#orbField a.worldOrb[data-origin=\"https://demo.cloudbongos.com\"]", "data-shape", "pair"], ["#orbField a.worldOrb[data-origin=\"https://demo.cloudbongos.com\"]", "data-material", "obsidian"], ["#orbField a.worldOrb[data-origin=\"https://demo.cloudbongos.com\"]", "data-template", "pair-obsidian-tint"], ["#orbField a.worldOrb[data-origin=\"https://emersonian-circles.cloudbongos.com\"]", "data-template", "bead-obsidian-plain"]] } },
     "in-map-projects": { "auth": true, "actions": [["click", "#projTrig"], ["wait", 350]], "expect": { "expanded": true, "open": "#menuProjects" } },
     "in-map-profile": { "auth": true, "actions": [["click", "#who"], ["wait", 350]], "expect": { "expanded": true, "open": "#menuProfile" } },
     "in-map-kbd": { "auth": true, "actions": [["focus", "#projTrig"], ["press", "Enter"], ["wait", 350], ["press", "ArrowDown"], ["wait", 120]], "expect": { "expanded": true, "activeText": "Table" } },
     "in-map-search": { "auth": true, "actions": [["clickIfVisible", "#qToggle"], ["wait", 200], ["fill", "#mapQ", "emer"], ["wait", 300]], "expect": { "value": [["#mapQ", "emer"]] } },
     "in-map-mine-on": { "auth": true, "actions": [["check", "#onlyMine"], ["wait", 300]], "expect": { "checked": "#onlyMine" } },
     "in-table": { "auth": true, "actions": [["click", "#projTrig"], ["wait", 250], ["click", "a[data-sub=\"table\"]"], ["wait", 400]], "expect": { "visible": ["#sub-table-body", ".tblMast", ".mastObj", "#selfHall"], "closed": "#menuProjects", "count": [["#mapRows tr[data-generated] .rowHall", 1]] } },
-    "in-mine": { "auth": true, "url": "/projects?view=mine", "expect": { "hidden": ["#qWrap", "#empty"], "visible": ["#mineBar", "#projectsList", "#projectsList .proj .worldOrb .disc"], "count": [["#projectsList .proj", 5], ["#projectsList .proj.gone", 1], ["#projectsList .proj .worldOrb[data-shape][data-material][data-style]", 5], ["#projectsList .proj .strip", 1], ["#projectsList .proj .worldOrb.ashen", 2], ["#projectsList [data-restart]", 1]] } },
+    "in-mine": { "auth": true, "url": "/projects?view=mine", "expect": { "hidden": ["#qWrap", "#empty"], "visible": ["#mineBar", "#projectsList", "#projectsList .proj .worldOrb .disc"], "count": [["#projectsList .proj", 5], ["#projectsList .proj.gone", 1], ["#projectsList .proj .worldOrb[data-shape][data-material][data-style]", 5], ["#projectsList .proj .worldOrb[data-template=\"blob-frost-tint\"]", 1], ["#projectsList .proj .strip", 1], ["#projectsList .proj .worldOrb.ashen", 2], ["#projectsList [data-restart]", 1]] } },
     "in-manage": { "auth": true, "url": "/projects?view=manage&id=101", "expect": { "visible": ["#mMain", "#mChip .chip", "#mOrb .worldOrb", "#mFacts .ledger .k", "#mActs"], "hidden": ["#qWrap", "#mGate", "#mMissing", "#mErr"], "text": [["#mName", "demo"], ["#mTitle", "demo"]] } },
+    "in-manage-planet": { "auth": true, "url": "/projects?view=manage&id=101", "expect": { "visible": ["#mPlanetPick", "#mPick .pick .pickPreview .worldOrb .disc", "#mPick [data-pick-save]", "#mPick [data-pick-reset]", "#mPickWhat summary"], "count": [["#mPick .pickCells[role=\"radiogroup\"]", 3], ["#mPick .pickCell", 10], ["#mPick .pickCell.on", 3], ["#mPick .pickSw", 5], ["#mPick .pickSw.on", 1]], "attr": [["#mPick .pickPreview .worldOrb", "data-template", "pair-obsidian-tint"], ["#mOrb .worldOrb", "data-template", "pair-obsidian-tint"]], "checked": "#mPick input[name=\"mPickAccent\"][value=\"sea\"]", "text": [["#mPlanet .v small", "your choice."]] } },
     "in-manage-snag": { "auth": true, "url": "/projects?view=manage&id=103", "expect": { "visible": ["#mMain", "#mErr", "#mActs"], "text": [["#mName", "tidepool"]] } },
     "in-manage-gone": { "auth": true, "url": "/projects?view=manage&id=104", "expect": { "visible": ["#mMain", "#mActs"], "hidden": ["#mErr"], "text": [["#mName", "old-lantern"]] } },
     "in-manage-missing": { "auth": true, "url": "/projects?view=manage&id=999", "expect": { "visible": ["#mMissing"], "hidden": ["#mMain", "#mGate"] } },

package/src/module-api.js

@@ -33,7 +33,7 @@ const { validateOrRespond, LIMITS, parseId, asyncHandler, corsPublicGet, parsePa
 // there. scripts/gds/bump-version.js still rewrites the literal below; it appends
 // the entry to that file. Look for a version's history there, not here.
 // ---------------------------------------------------------------------------
-const CORE_VERSION = '1.19.429'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.19.431'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('dev-box'); log.info('mounted');