@bongos/core 1.21.26 → 1.21.27

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

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

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

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

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

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

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

@@ -83,7 +83,7 @@
   </div>
 </div>
 
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/city-draw.js?v=2026-10-02-city1"></script>
 <script src="/builders/city.js?v=2026-10-02-city1"></script>

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

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

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

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

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

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

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

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

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

@@ -97,7 +97,7 @@
 
 <!-- The app shell (sidebar + top bar + footer). Dependency-free; runs at parse
      time so the chrome exists before the deferred page scripts execute. -->
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/diagram-viewer.js?v=2026-06-14-diagviewer-1" defer></script>

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

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

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

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

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

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

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

@@ -137,7 +137,7 @@
   </div>
 </div>
 
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <script src="/builders/palette.js" defer></script>
 
 <script src="/builders/idea-objects.js?v=2026-09-27-split"></script>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -206,7 +206,7 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded before profile.js, which pulls from it. -->

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

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

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

@@ -77,7 +77,7 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded before ranks.js, which pulls from it. -->

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

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

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

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

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

@@ -111,7 +111,7 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded BEFORE sessions.js so it can pull from it. -->

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

@@ -435,7 +435,7 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page scripts run. -->
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded before consuming IIFEs. -->

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

@@ -507,35 +507,16 @@
   }
 
   // ---------- the Back link (task 1004430) ----------
-  // A page reached by a link INSIDE another hall page — a profile opened from
-  // Builders, a task from a goal — shows "← <that page>" at the head of the top
-  // bar, so browsing a list and its records is a round trip. A sidebar hop is
-  // not a drill-down and shows none: the sidebar click leaves a one-shot note
-  // (sessionStorage) naming its target, and the page it lands on reads it.
-  // The origin is `?from=` (a link that knows where it came from), else the
-  // same-origin referrer.
-  //
-  // task 1004477: this is the ONLY place a hall page's way back is decided —
-  // no page draws its own Back link any more. Two hooks cover what the page
-  // copies used to:
-  //   - <body data-back-fallback="/work"> names where Back goes when there is
-  //     no origin at all (a deep-linked task or idea, the tweak editor);
-  //   - a link marked [data-shell-exit] is a second exit the page places (an
-  //     error state's button, the tweak editor's bar in full screen, where the
-  //     top bar is hidden), and the shell fills its address and its words.
+  // A page reached from INSIDE another hall page (`?from=`, else a same-origin
+  // referrer) shows "← <that page>" in the top bar. A sidebar hop is not a
+  // drill-down: its click leaves a one-shot sessionStorage note, and the page it
+  // lands on shows none. task 1004477: the ONLY place a page's way back is
+  // decided. <body data-back-fallback="/work"> names where Back goes with no
+  // origin; a [data-shell-exit] link the page places is filled by the shell.
   var NAV_HOP_KEY = 'hall-nav-hop';
   function hallPath(url) {
     return String(url.pathname).replace(/^\/builders(?=\/|$)/, '').replace(/\.html$/, '').replace(/\/index$/, '') || '/';
   }
-  function backOrigin() {
-    var hop = null;
-    try {
-      hop = window.sessionStorage.getItem(NAV_HOP_KEY);
-      window.sessionStorage.removeItem(NAV_HOP_KEY);
-    } catch (_) { /* private mode: no note, so fall through */ }
-    if (hop && hop === hallPath(location)) return null;
-    return linkOrigin() || fallbackOrigin();
-  }
   // The page this one was opened from: ?from=, then a same-origin referrer.
   function linkOrigin() {
     var from = null;
@@ -548,21 +529,18 @@
     if (!from || from.origin !== location.origin) return null;
     var path = hallPath(from);
     if (/^\/(api|auth|lib)(\/|$)/.test(path)) return null;
-    // The back link keeps the origin's query (a filtered list) but never its
-    // own ?from=, which would chain one page's way back into the next.
+    // Keep the origin's query (a filtered list) but never its own ?from=, which
+    // would chain; and compare without OUR ?from=, so a self-link is refused.
     var params = new URLSearchParams(from.search);
     params.delete('from');
     var search = params.toString() ? '?' + params.toString() : '';
-    // This page's address without its own ?from=, so `?from=` naming the page
-    // itself (a loop, not a way back) is caught like any other self-link.
     var ownParams = new URLSearchParams(location.search || '');
     ownParams.delete('from');
     var here = hallPath(location) + (ownParams.toString() ? '?' + ownParams.toString() : '');
     if (path + search === here) return null;
     return { href: path + search + (from.hash || ''), path: path, label: backLabel(path, from.hash), viaReferrer: viaReferrer };
   }
-  // Where Back goes with no origin: the page's own <body data-back-fallback>,
-  // honoured only as a path on this host (one leading slash, never the API).
+  // <body data-back-fallback>, honoured only as a path on this host (never the API).
   function fallbackOrigin() {
     var f = document.body && document.body.dataset && document.body.dataset.backFallback;
     if (!f || !/^\/(?!\/)/.test(f) || /[\\\s]/.test(f)) return null;
@@ -573,14 +551,12 @@
     if (/^\/(api|auth|lib)(\/|$)/.test(path) || path === hallPath(location)) return null;
     return { href: path + (u.search || '') + (u.hash || ''), path: path, label: backLabel(path, u.hash), viaReferrer: false };
   }
-  // "Back to tasks", "Back to goal 12": a nav label reads as a place mid-sentence,
-  // so it is lowercased unless it carries an acronym ("API docs").
+  // "Back to tasks": a nav label is lowercased mid-sentence unless it has an acronym.
   function exitWords(label) {
     return 'Back to ' + (/[A-Z]{2}/.test(label) ? label : label.toLowerCase());
   }
-  // Fill every [data-shell-exit] link under `root` with the way back. With no
-  // way back at all the exit still works: it goes home. A page script that
-  // renders an exit later (task.js's failure states) calls this once it has.
+  // Fill every [data-shell-exit] under `root` with the way back (else home); a
+  // page that renders one later (task.js's failure states) calls this again.
   function fillExits(root) {
     var scope = root || document;
     if (!scope.querySelectorAll) return;
@@ -610,39 +586,99 @@
     }
     return 'Back';
   }
-  var BACK = null;
+  // ---------- the trail (task 1004476) ----------
+  // Two clicks deep the bar shows the run of pages that led here, "Goals › goal
+  // 12 › task 340", the last crumb being Back. Kept per tab (sessionStorage) as
+  // crumbs ending with THIS page: a drill-down cuts after its origin and appends;
+  // returning to a crumb (the origin, if any, sits after it) trims; an unknown
+  // origin starts fresh by the ?from= / referrer / fallback rules; a sidebar hop
+  // starts over. Storage that throws, or no URL API, keeps the one-step Back.
+  var TRAIL_KEY = 'hall-nav-trail', TRAIL_MAX = 4, BACK = null;
+  function hereCrumb() {
+    var own = new URLSearchParams(location.search || ''); own.delete('from');
+    var path = hallPath(location), hash = location.hash || '';
+    return { href: path + (own.toString() ? '?' + own.toString() : '') + hash, label: backLabel(path, hash) };
+  }
+  // A stored crumb is honoured only as a path on this host with a string label.
+  function crumbOk(c) {
+    return !!c && typeof c.href === 'string' && typeof c.label === 'string' &&
+      /^\/(?!\/)/.test(c.href) && !/[\\\s]/.test(c.href) && !/^\/(api|auth|lib)(\/|[?#]|$)/.test(c.href);
+  }
+  function readTrail() {
+    try { var t = JSON.parse(window.sessionStorage.getItem(TRAIL_KEY) || '[]'); return Array.isArray(t) ? t.filter(crumbOk) : []; } catch (_) { return null; }
+  }
+  function writeTrail(t) {
+    try { window.sessionStorage.setItem(TRAIL_KEY, JSON.stringify(t.slice(-(TRAIL_MAX + 1)))); } catch (_) { /* private mode */ }
+  }
+  // Latest crumb at `href`; a referrer has no #hash, so it matches on the address alone.
+  function crumbAt(t, href, anyHash) {
+    for (var i = t.length - 1; i >= 0; i--) if (anyHash ? t[i].href.split('#')[0] === href.split('#')[0] : t[i].href === href) return i;
+    return -1;
+  }
+  // The crumbs before this page; the last is where Back goes. Sets BACK.
+  function trailCrumbs() {
+    var hop = null, here = null;
+    try { hop = window.sessionStorage.getItem(NAV_HOP_KEY); window.sessionStorage.removeItem(NAV_HOP_KEY); } catch (_) { /* private mode */ }
+    try { here = hereCrumb(); } catch (_) { /* no URL API */ }
+    var stored = here ? readTrail() : null, t = stored || [], trail = null, via = false;
+    here = here || { href: '', label: '' };
+    if (hop && hop === hallPath(location)) trail = [here];
+    var origin = trail ? null : linkOrigin();
+    var at = crumbAt(t, here.href), from = origin ? crumbAt(t, origin.href, origin.viaReferrer) : -1;
+    var f = trail || origin || at >= 0 ? null : fallbackOrigin();
+    if (!trail && at >= 0 && (!origin || from > at)) trail = t.slice(0, at + 1);
+    else if (!trail && origin) { trail = (from >= 0 ? t.slice(0, from + 1) : [origin]).concat([here]); via = origin.viaReferrer; }
+    else if (!trail) trail = f ? [f, here] : [here];
+    trail = trail.slice(-(TRAIL_MAX + 1)).map(function (c) { return { href: c.href, label: c.label }; });
+    if (stored) writeTrail(trail);
+    var crumbs = trail.slice(0, -1), last = crumbs[crumbs.length - 1];
+    BACK = last ? { href: last.href, label: last.label, viaReferrer: via } : null;
+    return crumbs;
+  }
+  // A hash route moves without a page load: a record view is a drill-down, a
+  // crumb already held is a return, any other view just renames this page's crumb.
+  function onTrailHash() {
+    var t = readTrail(), here;
+    if (!t || !t.length || t[t.length - 1].href.split(/[?#]/)[0] !== hallPath(location)) return;
+    try { here = hereCrumb(); } catch (_) { return; }
+    var at = crumbAt(t, here.href);
+    if (at >= 0) t = t.slice(0, at + 1);
+    else if (/^#\/(task|idea|blocker|goal)\/\d+/.test(location.hash || '')) t = t.concat([here]);
+    else t[t.length - 1] = here;
+    writeTrail(t);
+  }
+  var BACK_ICON = '<svg viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M11 4 6 9l5 5"/></svg>';
+  // Narrower windows fold the trail (style.css): the middle goes to "…", then
+  // the first crumb joins it and "…" links to the start, then only Back is left.
   function backLinkHtml() {
-    BACK = backOrigin();
+    var crumbs = trailCrumbs(), sep = '<span class="topbar-trail__sep" aria-hidden="true">›</span>';
     if (!BACK) return '';
-    return '<a class="topbar-back" id="topbar-back" href="' + esc(BACK.href) + '" title="Back to ' + esc(BACK.label) + '">' +
-      '<svg viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M11 4 6 9l5 5"/></svg>' +
-      '<span class="topbar-back__label">' + esc(BACK.label) + '</span></a>';
+    var back = '<a class="topbar-back" id="topbar-back" href="' + esc(BACK.href) + '" title="Back to ' + esc(BACK.label) + '">' +
+      BACK_ICON + '<span class="topbar-back__label">' + esc(BACK.label) + '</span></a>';
+    if (crumbs.length < 2) return back;
+    var older = crumbs.slice(0, -1), steps = older.map(function (c, i) {
+      return '<span class="topbar-trail__step topbar-trail__step--' + (i ? 'mid' : 'first') + '"><a class="topbar-crumb" href="' +
+        esc(c.href) + '">' + esc(c.label) + '</a>' + sep + '</span>';
+    });
+    steps.splice(1, 0, '<span class="topbar-trail__more"><a class="topbar-crumb topbar-crumb--more" href="' + esc(older[0].href) + '" title="' +
+      esc(older.map(function (c) { return c.label; }).join(' › ')) + '" aria-label="' + esc(older[0].label) + '">…</a>' + sep + '</span>');
+    return '<nav class="topbar-trail' + (older.length > 1 ? ' topbar-trail--long' : '') + '" aria-label="Breadcrumb">' +
+      BACK_ICON.replace('<svg ', '<svg class="topbar-trail__mark" ') + steps.join('') + back + '</nav>';
   }
-  // Back through history when the origin IS the previous entry, so the list
-  // comes back where the reader left it (its scroll, its filters); the href
-  // stays the real address for a new tab or a lost history.
+  // Back through history when the origin IS the previous entry (the list keeps its
+  // scroll and filters); the href stays the real address for a new tab.
   function onBackClick(e) {
     if (!BACK || !BACK.viaReferrer || e.metaKey || e.ctrlKey || e.shiftKey || e.button > 0) return;
     if (window.history && window.history.length > 1) { e.preventDefault(); window.history.back(); }
   }
 
   // ---------- full screen (task 1004327; standard since task 1004430) ----------
-  // One switch on EVERY shelled page: it hides the sidebar, the top bar and the
-  // foot so the page fills the window, and the same button (the only thing left
-  // of the top bar) brings them back. Escape leaves too. A page opts OUT with
-  // <body data-fullscreen-switch="off">. A page that carries the bare attribute
-  // lays itself out for full screen (the sky, the studio); every other page is
-  // `plain` and style.css only steps its content clear of the corner button.
-  // The state is html[data-fullscreen="on"] — the data-theme / data-social
-  // pattern — so the chrome's hiding is style.css's, and a page that lays itself
-  // out against the chrome reads the same attribute.
-  //
-  // Remembered PER PAGE (`hall-fullscreen:<data-page>`): full screen is a choice
-  // about one surface, and the studio's must not follow the reader to the sky.
-  // Storage can throw in a private window; the chrome then just shows, which is
-  // the honest default. Because it is remembered, a page can OPEN in full screen,
-  // so entering it says once how to leave (the hint below) — task 1004430 found
-  // /thinking read as "stuck without its bars" when nothing did.
+  // One switch on EVERY shelled page hides the sidebar, top bar and foot; the same
+  // button (all that is left of the bar) and Escape bring them back. Opt out with
+  // <body data-fullscreen-switch="off">; the bare attribute means the page lays
+  // itself out for it (sky, studio), else it is `plain`. State: html[data-fullscreen="on"].
+  // Remembered PER PAGE (`hall-fullscreen:<data-page>`), so a page can OPEN in full
+  // screen and says once how to leave (task 1004430: /thinking read as "stuck").
   var FULLSCREEN_KEY = 'hall-fullscreen:';
   function fullscreenAttr() {
     var b = document.body;
@@ -1354,6 +1390,7 @@
     });
     var back = document.getElementById('topbar-back');
     if (back) back.addEventListener('click', onBackClick);
+    window.addEventListener('hashchange', onTrailHash);
     if (IS_INDEX) {
       window.addEventListener('hashchange', function () { route(); });
     }

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

@@ -203,7 +203,7 @@
   </div>
 </div>
 
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/city-draw.js?v=2026-10-02-street1"></script>
 <script src="/builders/street-draw.js?v=2026-10-02-street1"></script>

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

@@ -176,7 +176,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <!-- The kit, for its ONE renderer: the full-size ship-time visual figure

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

@@ -1224,6 +1224,52 @@ html[data-fullscreen="on"][data-fullscreen-plain="on"] .app-content { padding-to
 .topbar-back:hover { color: var(--ink); background: var(--rule-soft); }
 .topbar-back svg { width: 16px; height: 16px; flex-shrink: 0; }
 @media (max-width: 480px) { .topbar-back__label { display: none; } .topbar-back { padding: 0 8px; } }
+/* The trail (task 1004476): "‹ Goals › goal 12 › task 340", the last crumb
+   being the Back link. On a phone the middle collapses to "…", and on a narrow
+   one the bar's page name gives the trail its room (the page heading below
+   still names the page). */
+.topbar-trail {
+  display: inline-flex;
+  align-items: center;
+  flex-shrink: 0;
+  margin-right: -4px;
+  color: var(--ink-soft);
+  font-size: 13px;
+  white-space: nowrap;
+}
+.topbar-trail__mark { width: 16px; height: 16px; flex-shrink: 0; margin: 0 2px 0 6px; }
+.topbar-trail__step, .topbar-trail__more { display: inline-flex; align-items: center; }
+.topbar-crumb {
+  display: inline-flex;
+  align-items: center;
+  min-height: 32px;
+  padding: 0 6px;
+  border-radius: var(--radius-pill);
+  color: inherit;
+  text-decoration: none;
+}
+.topbar-crumb:hover { color: var(--ink); background: var(--rule-soft); }
+.topbar-trail__sep { padding: 0 2px; color: var(--ink-faint); }
+.topbar-trail .topbar-back { padding: 0 10px 0 6px; }
+.topbar-trail .topbar-back svg { display: none; }
+.topbar-trail__more { display: none; }
+@media (max-width: 640px) {
+  .topbar-trail__step--mid { display: none; }
+  .topbar-trail--long .topbar-trail__more { display: inline-flex; }
+}
+@media (max-width: 480px) {
+  .topbar-trail__step--first { display: none; }
+  .topbar-trail .topbar-trail__more { display: inline-flex; }
+  .topbar-trail .topbar-back__label { display: inline; }
+  .topbar-trail .topbar-back { padding: 0 8px 0 6px; }
+  .topbar-trail ~ .topbar-title { display: none; }
+}
+@media (max-width: 360px) {
+  .topbar-trail__mark, .topbar-trail .topbar-trail__more, .topbar-trail .topbar-back__label { display: none; }
+  .topbar-trail .topbar-back svg { display: block; }
+  .topbar-trail .topbar-back { padding: 0 8px; }
+  .topbar-trail ~ .topbar-title { display: block; }
+}
 .zoom-toggle__pct {
   font-size: 12px;
   font-weight: 500;

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

@@ -54,7 +54,7 @@
 
 <!-- The app shell (sidebar + top bar + footer). Dependency-free; runs at parse
      time so the chrome exists before the deferred page scripts execute. -->
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded FIRST so task.js can pull from it. -->

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

@@ -138,7 +138,7 @@
   </div>
 </div>
 
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <script src="/builders/palette.js" defer></script>
 
 <script src="/builders/idea-objects.js?v=2026-09-27-split"></script>

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

@@ -142,7 +142,7 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell.js?v=2026-10-02-back"></script>
+<script src="/builders/shell.js?v=2026-10-02-trail"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <script src="/builders/brand-holes.js?v=2026-09-29-aqfix"></script>