@bongos/core 1.24.94 → 1.24.96

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": "0367a0e57f2fcfb1",
       "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": "9de2854d844d990f",
       "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": "78dcb0fa10127d8c",
-      "reading_hash": "0ede747bdc35bbb5",
+      "files_hash": "36c7410d9c8aeae0",
+      "reading_hash": "45468116976bf674",
       "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.92","placement":"unplaced"},
+        {"key":"L0018","section":"Needs your attention13","text":"core 1.24.94","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": "97c8fcdb1e58d08c",
+      "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": "96c460b71d47125f",
       "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/autonomy/db.js

@@ -429,6 +429,53 @@ async function removeRunner({ builderId, host }) {
   return r ? { host: r.host, session_id: r.session_id ? String(r.session_id) : null } : null;
 }
 
+// ── one goal, seen from the builder's runner (task 1005243) ──────────────────
+//
+// readRunnerGoalStats — what the game's runner card says about ONE goal: how
+// many tasks there the builder's runner has shipped, the tokens those sessions
+// spent, their average length, and how many tasks are still to build. All of it
+// is the ledger's answer: a runner's claim carries `autonomous` (set by the
+// server from the claiming session, core_295), a shipped claim is outcome
+// 'shipped', and a session's tokens and length are what ship.js uploaded to
+// session_records. SCOPED TO ONE BUILDER, like the heartbeat read: nobody reads
+// another builder's runner.
+//
+// ITS COST. `mine` starts from the caller's claims through core_263's
+// idx_claims_builder_history (builder_id, claimed_at), so it reads one builder's
+// claims, never the table; session_records goes through idx_session_records_builder,
+// and the tasks count through the goal's own rows. The card asks only while it is
+// open (home-runner.js, every 15 s while the tab is visible).
+async function readRunnerGoalStats(builderId, goalId) {
+  const { rows } = await pool.query(
+    `WITH mine AS (
+       SELECT DISTINCT c.task_id
+         FROM claims c JOIN tasks t ON t.id = c.task_id
+        WHERE c.builder_id = $1 AND c.autonomous AND c.outcome = 'shipped' AND t.goal_id = $2
+     ), spent AS (
+       SELECT COALESCE(SUM(sr.total_tokens), 0)::bigint AS tokens,
+              AVG(sr.duration_seconds) FILTER (WHERE sr.duration_seconds > 0) AS avg_s
+         FROM session_records sr
+        WHERE sr.builder_id = $1 AND sr.task_ids && ARRAY(SELECT task_id FROM mine)
+     )
+     SELECT (SELECT COUNT(*) FROM mine)::int AS tasks_done,
+            spent.tokens, spent.avg_s,
+            -- what is left is told only for a goal the project opened to runners, so
+            -- the read is no window onto a goal's size the caller could not send to
+            CASE WHEN EXISTS (SELECT 1 FROM autonomy_allowed_goals WHERE goal_id = $2)
+                 THEN (SELECT COUNT(*) FROM tasks WHERE goal_id = $2 AND status IN ('ready', 'active'))::int END AS tasks_left
+       FROM spent`,
+    [builderId, goalId]
+  );
+  const r = rows[0] || {};
+  const avg = r.avg_s == null ? null : Math.round(Number(r.avg_s));
+  return {
+    tasks_done: Number(r.tasks_done) || 0,
+    tokens: Number(r.tokens) || 0,
+    avg_task_seconds: Number.isFinite(avg) && avg > 0 ? avg : null,
+    tasks_left: r.tasks_left == null ? null : Number(r.tasks_left) || 0,
+  };
+}
+
 module.exports = {
   recordAutonomyRun,
   lastAutonomyHead,
@@ -449,4 +496,5 @@ module.exports = {
   setBuilderGoals,
   setBuilderPause,
   readAllRunnerScopes,
+  readRunnerGoalStats,
 };

package/modules/autonomy/routes/autonomy.js

@@ -376,6 +376,21 @@ module.exports = function buildAutonomyRouter() {
     }
   });
 
+  // ONE GOAL, SEEN FROM THE CALLER'S RUNNER (task 1005243): the game's runner
+  // card on Home — tasks it shipped there, the tokens they took, the average
+  // task length and what is left, so the card can say roughly how long the rest
+  // takes. Read-only and the caller's own, behind `autonomy.run` like the picks.
+  router.get('/autonomy/me/goals/:goalId/stats', auth.requireBuilder, auth.requirePermission('autonomy.run'), async (req, res) => {
+    const goalId = Number(req.params.goalId);
+    if (!Number.isSafeInteger(goalId) || goalId <= 0) return res.fail('goal_id_invalid', { status: 400, message: 'goal id must be a positive integer' });
+    try {
+      res.json({ goal_id: goalId, ...(await db.readRunnerGoalStats(req.builder.id, goalId)) });
+    } catch (err) {
+      log.error('[gds] GET /autonomy/me/goals/:goalId/stats', err);
+      res.fail('runner_stats_unreadable', { status: 503, message: 'could not read the runner stats' });
+    }
+  });
+
   // The owner pauses or resumes ONE builder's runner without throwing the master
   // switch. Same atom as the kill switch: stopping a machine is the same act
   // whether it is everyone's or one person's, and the paused builder must not be

package/modules/government/catalog.js

@@ -128,7 +128,7 @@ const PERMISSIONS = [
   // "runner operators" should be able to compose one. It can never widen the fence
   // — the project allowlist and the kill switch stay behind autonomy.fence.manage —
   // so delegating it delegates only "whose machine may work the allowed goals".
-  { key: 'autonomy.run', system: false, floor: 'metic', guards: 'PUT /autonomy/me/goals (a builder\'s own runner scope); also decides whether GET /autonomy/fence answers enabled for the caller' },
+  { key: 'autonomy.run', system: false, floor: 'metic', guards: 'PUT /autonomy/me/goals (a builder\'s own runner scope) and GET /autonomy/me/goals/:goalId/stats (its numbers on one goal); also decides whether GET /autonomy/fence answers enabled for the caller' },
   // BV1.R21 (task 1003608, goal 1000086). ADR 0250 §6 amends ADR 0157 for exactly
   // this key: `version.create` returns to the Archon floor.
   //

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-draw.js

@@ -297,6 +297,8 @@
       const a = it.a, x0 = a.x, y0 = a.y, x1 = x0 + FOOT, y1 = y0 + FOOT, base = 4;
       const d = doneAt(a, t), built = Math.max(2, (d.build + d.art) * m.px), clad = d.art * m.px;
       const site = sites[a.id], who = site ? m.people[site.builder] : null, agent = !!(site && (site.agent || (who && who.agent)));
+      // your runner sent here (task 1005243): its marker stands in for the agent's face
+      const mine = latest && o.runner && o.runner.goal === a.id ? o.runner.state : null;
       const wait = latest ? (m.waiting[a.id] || 0) : 0;
       const g = [];
       g.push(...box(x0 - 0.12, y0 - 0.12, x1 + 0.12, y1 + 0.12, 0, base, I.plinth));
@@ -330,12 +332,13 @@
         const hx = mx + 1.8;
         g.push(line(P(hx, my, ct), P(hx, my, top - 6), I.steel, 1));
         g.push(node('g', { class: 'hc-slab' }, box(hx - 0.3, my - 0.2, hx + 0.3, my + 0.2, top - 38, 3, I.slab)));
-        if (who) over.push({ k: 'face', p: P(mx + 0.9, my, ct + 30), who, agent, a });
+        if (who && !mine) over.push({ k: 'face', p: P(mx + 0.9, my, ct + 30), who, agent, a });
       }
+      if (mine) over.push({ k: 'runner', p: site ? P(x0 + 1.4, y0 + 0.5, top + 86) : P((x0 + x1) / 2, (y0 + y1) / 2, top + 40), state: mine, a });
       if (wait) over.push({ k: 'dot', p: P((x0 + x1) / 2, (y0 + y1) / 2, top + (site ? 12 : 22)), a, n: wait });
       const shipped = Math.round(d.build + d.art), byArt = Math.round(d.art);
       const tip = `${shipped} shipped${byArt ? ` · ${byArt} by artists` : ''}${who ? ` · ${agent ? `${who.name}'s agent` : who.name} on site` : ''} · click to open the goal`;
-      out.push(node('a', { href: `/goals#/goal/${encodeURIComponent(a.id)}`, class: 'hc-tower', 'aria-label': `${a.title}: ${shipped} shipped. Open the goal.`, 'data-tip': a.title, 'data-tip-body': tip }, g));
+      out.push(node('a', { href: `/goals#/goal/${encodeURIComponent(a.id)}`, class: 'hc-tower' + (o.picked === a.id ? ' hc-tower--picked' : ''), 'data-goal': a.id, 'aria-label': `${a.title}: ${shipped} shipped. Open the goal.`, 'data-tip': a.title, 'data-tip-body': tip }, g));
       // the cloud at its foot, over this tower and under the next one forward
       if (cloudy) out.push(puff(x1 - 0.5, y1 - 0.5, 62));
     });
@@ -344,6 +347,7 @@
 
     over.forEach((v, n) => {
       if (v.k === 'face') { out.push(avatarNode(v.p, v.who, v.agent, v.a, I, n, node, line, circle)); return; }
+      if (v.k === 'runner') { out.push(runnerNode(v.p, v.state, v.a, I, node, line, circle)); return; }
       const cx = v.p[0] - 30, cy = v.p[1];
       out.push(node('g', { class: 'hc-wait', 'data-tip': v.a.title, 'data-tip-body': `${v.n} waiting on you` }, [
         circle(cx, cy, 11, { fill: 'var(--accent)', stroke: 'var(--bg-card)', 'stroke-width': 2.5 }),
@@ -607,6 +611,24 @@
     return node('g', { class: 'hc-face-pin', 'data-tip': agent ? `${who.name}'s agent` : who.name, 'data-tip-body': a.title }, g);
   }
 
+  // Your Autobongos runner on the tower it was sent to (task 1005243): the agent's robot face,
+  // ringed in the state it is in. Working wears the accent ring that turns (CSS, under the
+  // Kill Switch); resting a dashed ring; starting the info ring; ready a soft ring; off no ring
+  // and a faded face. The words for each are the visor's card, never this mark alone.
+  // The same words the visor's card puts on the device's face (runner-button.js buttonState).
+  const RUNNER_WORDS = { working: 'Running', resting: 'Resting', starting: 'Starting…', ready: 'Ready', off: 'Recalled' };
+  function runnerNode(p, state, a, I, node, line, circle) {
+    const x = p[0], y = p[1];
+    const st = RUNNER_WORDS[state] ? state : 'off';
+    return node('g', { class: `hc-runner hc-runner--${st}`, 'data-goal': a.id, 'data-tip': 'Your runner', 'data-tip-body': `${RUNNER_WORDS[st]} · ${a.title}` }, [
+      line([x, y + 18], [x, y + 32], I.steel, 1),
+      circle(x, y, 21, { class: 'hc-runner__ring', fill: 'none', 'stroke-width': 2.5 }),
+      circle(x, y, 16, { class: 'hc-runner__face', fill: I.avAgent, stroke: 'var(--bg-card)', 'stroke-width': 3 }),
+      node('rect', { class: 'hc-runner__ink', x: r1(x - 7), y: r1(y - 5), width: 14, height: 11, rx: 3, fill: 'none', stroke: I.avInk, 'stroke-width': 1.5 }),
+      circle(x - 3, y + 0.5, 1.5, { class: 'hc-runner__eye', fill: I.avInk }), circle(x + 3, y + 0.5, 1.5, { class: 'hc-runner__eye', fill: I.avInk }),
+    ]);
+  }
+
   function initial(name) { const s = String(name || '').trim(); return s ? s[0].toUpperCase() : '?'; }
   // a stable spread for an idea's place in the sky (FNV-1a over its id)
   function hash(s) { let h = 2166136261; for (const c of String(s)) { h ^= c.charCodeAt(0); h = Math.imul(h, 16777619); } return Math.abs(h); }

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

@@ -38,6 +38,20 @@ html[data-game="on"] body[data-page="home"] .page-head--hall .page-head__h { wid
 .hc-svg a:focus { outline: none; }
 .hc-svg a:focus-visible .hc-face { filter: brightness(1.35); }
 .hc-svg .hc-tower:hover .hc-face { filter: brightness(1.3); }
+/* game mode, your runner (task 1005243): the tower picked for the visor's card is lit and edged
+   in the accent; your runner's marker is the agent's face in a ring that says its state */
+.hc-svg .hc-tower--picked .hc-face { filter: brightness(1.2); stroke: var(--accent); stroke-width: 2px; }
+.hc-svg .hc-runner { cursor: pointer; }
+.hc-svg .hc-runner__ring { stroke: var(--ink-soft); stroke-opacity: .5; stroke-width: 3.5px; }
+/* yours, not anyone's agent: the accent face, the dark ink on it */
+.hc-svg .hc-runner__face { fill: var(--accent); }
+.hc-svg .hc-runner__ink { stroke: var(--accent-on); }
+.hc-svg .hc-runner__eye { fill: var(--accent-on); }
+.hc-svg .hc-runner--working .hc-runner__ring { stroke: var(--accent); stroke-opacity: 1; stroke-dasharray: 22 10; transform-box: fill-box; transform-origin: center; animation: hc-turn 6s linear infinite; }
+.hc-svg .hc-runner--starting .hc-runner__ring { stroke: var(--info); stroke-opacity: 1; stroke-dasharray: 4 6; }
+.hc-svg .hc-runner--resting .hc-runner__ring { stroke: var(--info); stroke-opacity: .9; stroke-dasharray: 2 5; }
+.hc-svg .hc-runner--off { opacity: .55; }
+.hc-svg .hc-runner--off .hc-runner__ring { stroke-opacity: 0; }
 /* the core and the museum stay quiet on the builder's Home so the new buildings lead;
    each comes back to full colour under the pointer or the keyboard */
 .hc-svg .hc-quiet { opacity: .62; filter: saturate(.3); transition: opacity .3s, filter .3s; }
@@ -110,6 +124,7 @@ html[data-theme="dark"] .home-city.hc-is-sky { background: linear-gradient(color
 
 /* live, and nothing more: a crane's slab climbs, this week's ideas glow (20s+) */
 @keyframes hc-lift { 0%, 12% { transform: translateY(0); } 55%, 70% { transform: translateY(-24px); } 100% { transform: translateY(0); } }
+@keyframes hc-turn { to { transform: rotate(360deg); } }
 @keyframes hc-glow { 0%, 100% { opacity: .55; } 50% { opacity: 1; } }
 @keyframes hc-live { 0% { box-shadow: 0 0 0 0 color-mix(in srgb, var(--ok) 55%, transparent); } 100% { box-shadow: 0 0 0 8px transparent; } }
 .hc-slab { animation: hc-lift 20s ease-in-out infinite; }

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

@@ -104,7 +104,8 @@
     const svg = host.querySelector('.hc-svg');
     const sky = craft() === 'ideating';
     const draw = sky ? Draw.skySvg : Draw.citySvg;
-    const out = draw(model, atLive(t) ? model.W - 1 : t, { mode: mode(), gov: window.GovCity || null });
+    const R = window.OTBHomeRunner; // your runner on its tower, and the tower picked for it (home-runner.js)
+    const out = draw(model, atLive(t) ? model.W - 1 : t, { mode: mode(), gov: window.GovCity || null, runner: R ? R.marker() : null, picked: R ? R.picked() : null });
     host.classList.toggle('hc-is-sky', sky);
     svg.setAttribute('aria-label', sky ? SKY_LABEL : CITY_LABEL);
     host.querySelector('#home-city-h').textContent = sky ? 'The project\'s ideas this week' : 'The project this week';
@@ -354,6 +355,7 @@
     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(); });
+    document.addEventListener('otb:home-runner', () => { if (model) drawScene(); });
     registerScene();
     load();
   }