okf 1.8.0 → 1.10.0

data/lib/okf/{server → render}/graph/template.html.erb

@@ -27,6 +27,26 @@
 <script src="https://cdn.jsdelivr.net/npm/marked@14/marked.min.js"></script>
 <script src="https://cdn.jsdelivr.net/npm/dompurify@3/dist/purify.min.js"></script>
 <style>
+/* ═══ CSS sections, in file order ═══════════════════════════════════════════
+   Each is opened by a `── name ──` banner; `grep -n '── ' template.html.erb`
+   prints this list with current line numbers, which is the reliable version.
+
+     app shell: rail + main        main column
+     shared controls               section head
+     chips / badges                graph view
+     filters slide-over            inspector content
+     markdown body                 fullscreen diagram viewer
+     bundle switcher (hub)         the ? sheet
+     bundle-count badge (hub)      mobile nav + first-visit note
+     catalog                       files
+     tags                          stats
+     type autocomplete             synthesized-map listing
+     ≤768px compact chrome         ≥769px pane folding
+
+   The last two rebuild the layout at a breakpoint and are checked by
+   test/browser/specs/responsive.spec.js — computed style at a real viewport
+   width, which is the only way that block can be checked at all.
+   ═════════════════════════════════════════════════════════════════════════ */
  :root{
   --bg:#ffffff; --panel:#ffffff; --panel-2:#f6f7f8; --canvas:#f4f5f7; --ink:#1f2328; --ink-soft:#333333;
   --muted:#63697a; --faint:#9298a4; --line:#e6e8eb; --line-2:#eef0f2;
@@ -86,7 +106,12 @@
  .ident .muted{color:var(--muted);font-weight:400;margin-left:9px;font-size:12.5px}
  .ident .src{color:var(--accent-ink);text-decoration:none;margin-left:8px}
  .ident .src:hover{text-decoration:underline}
- #views{flex:1;min-height:0;position:relative;background:var(--bg)}
+ /* overflow:hidden is load-bearing, not tidiness: a slide-over parked or
+    *animating* off the right edge widens the document unless something clips
+    it, and #views is the containing block for any panel that belongs to more
+    than one view. #stage has always done this job for the Filters panel, which
+    is exactly why that one never showed the bug. */
+ #views{flex:1;min-height:0;position:relative;background:var(--bg);overflow:hidden}
  .view{position:absolute;inset:0;display:none;flex-direction:column;min-height:0}
  .view.active{display:flex}
 
@@ -97,7 +122,37 @@
  .field::placeholder{color:var(--muted)}
  .search{position:relative;display:flex;align-items:center;flex:1 1 320px;min-width:130px;max-width:520px}
  .search svg{position:absolute;left:11px;width:15px;height:15px;stroke:var(--muted);fill:none;stroke-width:1.8;pointer-events:none}
- .search input{width:100%;padding-left:33px}
+ .search input{width:100%;padding-left:33px;padding-right:52px}
+ /* the count only exists while filtering, so the room for it is claimed only then */
+ .search.has-cnt input{padding-right:104px}
+ /* ── the search box's right-edge tools: the live match count, and the chip
+       that names the palette. The box filters what is on screen and the palette
+       finds across every bundle — two grammars behind one look — so the second
+       one is advertised inside the first, where the reader already is when the
+       filter disappoints them. ── */
+ .s-tools{position:absolute;right:7px;top:50%;transform:translateY(-50%);display:flex;align-items:center;gap:8px}
+ .s-cnt{font-size:11px;color:var(--faint);font-variant-numeric:tabular-nums;white-space:nowrap;pointer-events:none}
+ .s-cnt[hidden]{display:none}
+ .s-kbd{cursor:pointer;border:1px solid var(--line);border-radius:6px;background:var(--panel-2);color:var(--muted);
+  font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:10.5px;font-weight:600;letter-spacing:.02em;
+  line-height:1;padding:4px 6px;transition:color .15s,border-color .15s}
+ .s-kbd:hover{color:var(--ink);border-color:var(--accent)}
+ .s-kbd:focus-visible{outline:2px solid var(--accent);outline-offset:2px}
+ /* the bridge: the local filter came up empty, so say so and offer the way on —
+    same surface language as the palette it hands over to */
+ .s-bridge{position:absolute;top:calc(100% + 6px);left:0;right:0;z-index:60;background:var(--panel);border:1px solid var(--line);
+  border-radius:11px;box-shadow:var(--shadow);padding:11px 13px;font-size:12.5px}
+ .s-bridge[hidden]{display:none}
+ .sb-msg{color:var(--muted);margin-bottom:9px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+ .sb-msg b{color:var(--ink);font-weight:600}
+ .sb-row{display:flex;gap:8px;flex-wrap:wrap}
+ .sb-act{cursor:pointer;display:inline-flex;align-items:center;gap:7px;font-family:inherit;font-size:12px;padding:5px 10px;
+  border:1px solid var(--line);border-radius:8px;background:var(--panel-2);color:var(--muted);transition:color .15s,border-color .15s}
+ .sb-act:hover{color:var(--ink);border-color:var(--accent)}
+ .sb-act[hidden]{display:none}
+ .sb-act.primary{color:var(--accent-ink);border-color:var(--accent);background:var(--accent-soft)}
+ .sb-act kbd{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:10px;color:var(--faint);
+  border:1px solid var(--line);border-radius:4px;padding:1px 4px;background:var(--panel);line-height:1.3}
  .selwrap{position:relative;display:inline-flex;flex:none}
  .selwrap::after{content:"";position:absolute;right:12px;top:50%;width:7px;height:7px;border-right:1.6px solid var(--muted);border-bottom:1.6px solid var(--muted);transform:translateY(-70%) rotate(45deg);pointer-events:none}
  select.field{appearance:none;-webkit-appearance:none;padding-right:30px;cursor:pointer}
@@ -110,6 +165,10 @@
  .btn svg{width:16px;height:16px;stroke:currentColor;fill:none;stroke-width:1.7;stroke-linecap:round;stroke-linejoin:round}
  .btn[hidden]{display:none}
  .btn.text{width:auto;display:inline-flex;align-items:center;padding:0 12px;gap:7px;font-size:13px;font-weight:500;color:var(--ink)}
+ /* `.btn.text` sets display, which outranks `.btn[hidden]` above at equal
+    specificity — so hiding a text button (e.g. #fp-graph on a log) needs its own
+    [hidden] rule to win, same as .fp-head[hidden] does below. */
+ .btn.text[hidden]{display:none}
  .btn .fbadge{position:absolute;top:-6px;right:-6px;min-width:16px;height:16px;padding:0 4px;border-radius:9px;background:var(--accent);
   color:#fff;font-size:10px;font-weight:600;display:none;place-items:center;line-height:1}
  .btn.on-filter .fbadge{display:grid}
@@ -140,7 +199,7 @@
  .chip{display:inline-flex;align-items:center;gap:7px;padding:5px 11px;border-radius:999px;font-size:12.5px;
   color:var(--muted);background:var(--panel);border:1px solid var(--line);cursor:pointer;user-select:none;transition:.14s;font-family:inherit}
  .chip:hover{color:var(--ink);border-color:var(--accent)}
- .chip.off{opacity:.38} .chip.on{background:var(--accent);border-color:var(--accent);color:#fff}
+ .chip.on{background:var(--accent);border-color:var(--accent);color:#fff}
  .chip .dot{width:9px;height:9px;border-radius:50%} .chip .c{color:var(--faint);font-variant-numeric:tabular-nums}
  .chip.on .c{color:rgba(255,255,255,.8)}
  .badge{display:inline-flex;align-items:center;gap:7px;font-size:11.5px;font-weight:600;letter-spacing:.02em;color:var(--ink);
@@ -188,6 +247,91 @@
  .link{background:none;border:0;color:var(--accent-ink);font:inherit;font-size:12.5px;cursor:pointer;padding:0;font-weight:500}
  .link:hover{text-decoration:underline}
 
+ /* ── bundles slide-over (⚙ in the rail) ──
+    The registry, surfaced on the page, so choosing which bundle `/` opens no
+    longer means leaving the graph for /b/ — and knowing /b/ exists. --warn is
+    the one added hue; ok and error reuse --ok and --accent-ink, so the health
+    trio stays the page's own. ── */
+ :root{--warn:#9a6700}
+ :root[data-theme=dark]{--warn:#d4a72c}
+ a.rail-brand{display:block;cursor:pointer;border-radius:9px}
+ a.rail-brand:focus-visible{outline:2px solid var(--accent);outline-offset:3px}
+ #ws-ovl{position:absolute;inset:0;z-index:5;background:rgba(15,17,22,.28)}
+ #ws-ovl[hidden]{display:none}
+ #ws{width:340px}
+ /* Parked off-canvas, a slide-over STILL OCCUPIES LAYOUT — and #views does not
+    clip, which the Filters panel only gets away with because #stage does. The
+    closed panel widened the document by its own 340px: a horizontal scrollbar
+    on every page, from a panel nobody had opened. So it is out of the box
+    entirely while closed; display is restored one frame before .open so the
+    slide still animates, and taken away again once the slide back has ended. */
+ #ws[hidden]{display:none}
+ .ws-head-t{margin-right:auto;min-width:0}
+ .ws-sub{font-size:11px;color:var(--faint);margin-top:1px}
+ #ws-flash{font-size:11.5px;color:var(--muted);background:var(--panel-2);border-bottom:1px solid var(--line);padding:7px 14px}
+ #ws-flash[hidden]{display:none}
+ #ws-flash.err{color:var(--accent-ink)}
+ .ws-row{padding:11px 2px;border-bottom:1px solid var(--line-2);display:flex;align-items:flex-start;gap:8px}
+ .ws-row:last-child{border-bottom:0}
+ .ws-row-main{min-width:0;flex:1}
+ .ws-t{display:flex;align-items:center;gap:8px;flex-wrap:wrap;min-width:0}
+ .ws-title{font-size:13px;font-weight:600;color:var(--ink);background:none;border:0;padding:0;cursor:pointer;
+  font-family:inherit;text-align:left;text-decoration:none;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+ .ws-title:hover{color:var(--accent-ink);text-decoration:underline}
+ .ws-title.off{color:var(--faint);cursor:default}
+ .ws-title.off:hover{color:var(--faint);text-decoration:none}
+ .ws-pill{font-size:9.5px;font-weight:600;text-transform:uppercase;letter-spacing:.05em;padding:1px 7px;
+  border-radius:999px;border:1px solid var(--line);color:var(--muted);background:var(--line-2);flex:none}
+ .ws-pill.def{color:var(--accent-ink);background:var(--accent-soft);border-color:transparent}
+ .ws-meta{display:flex;align-items:center;gap:9px;font-size:11.5px;color:var(--muted);margin-top:3px;flex-wrap:wrap}
+ .ws-slug{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px;color:var(--faint)}
+ .ws-health.ok{color:var(--ok)} .ws-health.warn{color:var(--warn)}
+ .ws-health.error,.ws-health.missing{color:var(--accent-ink)}
+ .ws-slug-edit{height:24px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px;padding:0 7px;width:150px;border-radius:6px}
+ /* One ⋯ per row, and the verbs inside it. Three same-weight text links under
+    every row meant eighteen down the panel, none of which looked pressable and
+    one of which was destructive in the same clothes as the harmless two. In a
+    menu they can be ordered, separated and coloured by consequence. */
+ .ws-menu-btn{flex:none;width:28px;height:26px;border-radius:7px;border:1px solid var(--line);background:var(--panel-2);
+  color:var(--muted);cursor:pointer;display:grid;place-items:center;font-family:inherit;line-height:1;
+  transition:color .15s,border-color .15s,background .15s}
+ .ws-menu-btn:hover{color:var(--ink);border-color:var(--accent);background:var(--panel)}
+ .ws-menu-btn[aria-expanded=true]{color:var(--accent-ink);border-color:var(--accent);background:var(--accent-soft)}
+ .ws-menu-btn:focus-visible{outline:2px solid var(--accent);outline-offset:1px}
+ .ws-menu-btn svg{width:15px;height:15px;stroke:currentColor;fill:none;stroke-width:2;stroke-linecap:round}
+ .ws-menu{position:absolute;z-index:8;min-width:180px;background:var(--panel);border:1px solid var(--line);
+  border-radius:10px;box-shadow:var(--shadow);padding:5px;display:flex;flex-direction:column}
+ .ws-menu[hidden]{display:none}
+ .ws-menu button{display:flex;align-items:center;gap:9px;width:100%;padding:7px 9px;border:0;border-radius:7px;
+  background:none;color:var(--ink);font:inherit;font-size:12.5px;cursor:pointer;text-align:left}
+ .ws-menu button:hover{background:var(--line-2)}
+ .ws-menu button:disabled{color:var(--faint);cursor:default;background:none}
+ .ws-menu button.danger{color:var(--accent-ink)}
+ .ws-menu button.danger:hover{background:var(--accent-soft)}
+ .ws-menu .sep{height:1px;background:var(--line);margin:4px 2px}
+ /* A rename and a removal both need a second thought, so both take over the row
+    and state themselves — no armed link hiding a second meaning in its colour,
+    and no timed revert asking the reader to be quick. */
+ .ws-edit{margin-top:7px;display:flex;align-items:center;gap:7px;flex-wrap:wrap}
+ .ws-hint{font-size:10.5px;color:var(--faint);margin-top:5px}
+ .ws-confirm{margin-top:7px;padding:9px 10px;border:1px solid var(--line);border-radius:8px;background:var(--panel-2)}
+ .ws-confirm p{margin:0 0 8px;font-size:11.5px;color:var(--ink-soft);line-height:1.5}
+ .ws-confirm .crow{display:flex;gap:8px}
+ .btn-sm{height:26px;padding:0 10px;border-radius:7px;border:1px solid var(--line);background:var(--panel);
+  color:var(--ink);font:inherit;font-size:12px;cursor:pointer}
+ .btn-sm:hover{border-color:var(--accent)}
+ .btn-sm.primary{background:var(--accent);border-color:var(--accent);color:#fff}
+ .btn-sm.primary:hover{filter:brightness(1.07)}
+ /* Read-only is a state to explain, not a set of controls to hide silently: the
+    reader keeps every fact and gets one sentence naming who may change them. */
+ .ws-ro-note{margin:0 0 4px;padding:9px 10px;border:1px solid var(--line);border-left:2px solid var(--warn);
+  border-radius:8px;background:var(--panel-2);font-size:11.5px;color:var(--muted);line-height:1.55}
+ .ws-ro-note code,.ws-empty code,.ws-foot code{background:var(--line-2);border:1px solid var(--line);padding:1px 5px;
+  border-radius:5px;font-size:.92em;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--ink-soft)}
+ .ws-empty{margin:0;padding:22px 16px;font-size:12.5px;color:var(--muted);line-height:1.7;text-align:center}
+ .ws-foot{border-top:1px solid var(--line);padding:11px 14px;font-size:11.5px;color:var(--muted);line-height:1.6}
+ @media (max-width:768px){#ws{width:100%;max-width:100%}}
+
  /* ── inspector content ── */
  .type{display:inline-flex;align-items:center;gap:7px;font-size:11.5px;font-weight:600;color:var(--ink);
   background:var(--line-2);border:1px solid var(--line);border-radius:7px;padding:3px 9px}
@@ -279,6 +423,24 @@
  #sw-list a.cur:hover{background:none}
  #sw-list a.none{color:var(--muted);cursor:default;font-size:13px}
  .sw-def{margin-left:7px;padding:1px 7px;border-radius:99px;background:var(--line-2);color:var(--muted);font-size:11px;vertical-align:1px}
+ /* A concept hit is the one two-line row in the palette: a bundle or a view is
+    a destination you already know the name of, a concept is one you are being
+    shown evidence for. The snippet is that evidence, so it gets its own line
+    rather than being squeezed onto the first. */
+ #sw-list a.sw-hit{display:block;padding:8px 10px}
+ #sw-list a.sw-hit .hit-top{display:flex;align-items:baseline;gap:8px}
+ #sw-list a.sw-hit .hit-t{font-weight:500;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+ #sw-list a.sw-hit .hit-type{color:var(--faint);font-size:11.5px;white-space:nowrap}
+ #sw-list a.sw-hit .slug{margin-left:auto;flex:none}
+ #sw-list a.sw-hit .hit-s{display:block;margin-top:2px;color:var(--muted);font-size:12.5px;line-height:1.45;
+  overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+ /* The matched terms, marked where they landed. This is the only place the
+    palette says *why* a row is here, so it takes the accent — muted enough to
+    read as text, not as a highlighter pen. */
+ #sw-list a.sw-hit mark{background:var(--accent-soft);color:var(--accent-ink);border-radius:3px;padding:0 1px}
+ /* The async group: results arrive after the keystroke that asked for them, so
+    the header carries the state instead of the list jumping to a spinner. */
+ #sw-list .sw-grp .sw-state{margin-left:6px;font-weight:400;text-transform:none;letter-spacing:0}
 
  /* ── the ? sheet — same overlay shape as the palette, one row per binding ── */
  #kb{position:fixed;inset:0;z-index:91;background:rgba(0,0,0,.34);display:flex;align-items:flex-start;justify-content:center;padding-top:14vh}
@@ -308,10 +470,91 @@
  #btn-menu .menudot[hidden]{display:none}
  #nav-bk{position:fixed;inset:0;z-index:74;background:rgba(0,0,0,.35)}
  #nav-bk[hidden]{display:none}
- #mnote{position:fixed;left:12px;right:12px;bottom:12px;z-index:72;display:flex;gap:10px;align-items:center;justify-content:space-between;
-  background:var(--panel);border:1px solid var(--line);border-radius:12px;box-shadow:var(--shadow);padding:10px 12px;font-size:13px;color:var(--ink)}
- #mnote[hidden]{display:none}
- #mnote .btn{flex:none;width:28px;height:28px;font-size:13px}
+ /* the second beat: where the rail is folded behind ☰, a reader who has just
+    left the graph cannot see where the other views went. It sits *under the
+    button it is about*, with a caret pointing at it — a bottom sheet naming a
+    top-left control asks the reader to do the mapping. Lighter than the first
+    note in every way, because it is a nudge and not a decision. */
+ #hello2{position:fixed;top:56px;left:10px;z-index:73;max-width:250px;
+  background:var(--panel);border:1px solid var(--line);border-radius:12px;box-shadow:var(--shadow);
+  padding:12px 13px 11px;color:var(--ink)}
+ #hello2[hidden]{display:none}
+ @media (min-width:769px){ #hello2{display:none} }
+ #hello2::before{content:"";position:absolute;top:-6px;left:16px;width:10px;height:10px;
+  background:var(--panel);border-left:1px solid var(--line);border-top:1px solid var(--line);transform:rotate(45deg)}
+ #hello2 .hello-dots{margin-bottom:9px}
+ #hello2 .hello2-h{margin:0 0 5px;font-size:15px;font-weight:650;line-height:1.3}
+ #hello2 .hello2-b{margin:0 0 11px;font-size:13px;line-height:1.45;color:var(--muted)}
+ #hello2 #hello2-x{min-height:40px;font-size:14px}
+ /* the first-visit note. One card at the bottom of the graph, stacked so each
+    part does one job: the question, then the action, then the gestures. It was
+    a single 13px paragraph with the action buried mid-sentence, which is the
+    one layout that fails hardest on the screen it matters most on. */
+ #hello{position:fixed;left:12px;right:12px;bottom:12px;z-index:72;
+  background:var(--panel);border:1px solid var(--line);border-radius:16px;box-shadow:var(--shadow);
+  padding:18px 18px 16px;color:var(--ink)}
+ @media (min-width:769px){ #hello{left:50%;right:auto;transform:translateX(-50%);width:380px} }
+ #hello[hidden]{display:none}
+ /* a *sibling* combinator, not a descendant one: the note lives outside #app,
+    next to the other fixed overlays, so `#app … #hello` matches nothing */
+ #app:not([data-view=graph]) ~ #hello{display:none}
+ /* the page's own vocabulary: the hint says "any dot", and these are what it
+    means — the graph's real node colours, at something like their real size */
+ .hello-dots{display:flex;gap:5px;margin-bottom:11px}
+ .hello-dots i{width:9px;height:9px;border-radius:50%}
+ .hello-dots i:nth-child(1){background:#6E56CF}
+ .hello-dots i:nth-child(2){background:#D97757}
+ .hello-dots i:nth-child(3){background:#22C55E}
+ #hello .hello-h{margin:0 0 13px;font-size:17px;font-weight:650;letter-spacing:-.01em;line-height:1.25}
+ /* One rule dresses both notes' buttons — they are the same guide speaking, and
+    a shared selector is what keeps them from drifting apart later. Ink-on-bg
+    rather than the accent: it is the only pairing that clears 4.5:1 in both
+    themes, and it leaves the dots as the one piece of colour in either card. */
+ #hello #hello-go,#hello2 #hello2-x{display:block;width:100%;min-height:46px;border:0;border-radius:11px;
+  background:var(--ink);color:var(--bg);font-family:inherit;font-size:15px;font-weight:600;cursor:pointer}
+ #hello #hello-go:hover,#hello2 #hello2-x:hover{opacity:.88}
+ #hello .hello-hint{margin:13px 0 0;font-size:13.5px;line-height:1.5;color:var(--muted)}
+ #hello #hello-x{position:absolute;top:11px;right:11px;width:34px;height:34px;font-size:13px}
+ /* Two independent questions, so two independent gates — width answers neither
+    on its own. What the reader *does* follows the pointer: a touch tablet in
+    landscape is wider than 768px and still taps, a narrow desktop window is
+    narrower and still clicks. What the reader can *reach* follows the width:
+    ☰ exists only once the rail collapses, so promising it anywhere else is a
+    lie. A pointer-less environment matches nothing and keeps the click wording,
+    which is the safe default. */
+ #hello .hello-touch{display:none}
+ @media (pointer:coarse){ #hello .hello-touch{display:inline} #hello .hello-point{display:none} }
+ #hello .hello-menu{display:none}
+ @media (max-width:768px){ #hello .hello-menu{display:inline} }
+ /* a landscape phone has width to spare and no height at all, where the stacked
+    card takes half the screen — same words, tighter setting */
+ @media (max-height:480px){
+  #hello{padding:13px 15px 12px;border-radius:14px}
+  #hello .hello-dots{margin-bottom:8px}
+  #hello .hello-h{font-size:15.5px;margin-bottom:10px}
+  #hello #hello-go{min-height:42px;font-size:14.5px}
+  #hello .hello-hint{margin-top:9px;font-size:12.5px}
+ }
+ /* and once it is short *and* wide, the stack itself is the problem: the
+    question and the action sit on one row and spend the width instead of the
+    height. Scoped to ≥769px so it stays inside the centred regime above —
+    below that the card is edge-to-edge with no transform to conflict with. */
+ @media (max-height:480px) and (min-width:769px){
+  #hello{display:grid;grid-template-columns:1fr auto;column-gap:18px;align-items:center;
+   width:min(640px,calc(100vw - 24px))}
+  #hello .hello-dots{grid-column:1/-1}
+  #hello .hello-h{grid-column:1;grid-row:2;margin:0}
+  #hello #hello-go{grid-column:2;grid-row:2;width:auto;padding:0 22px}
+  #hello .hello-hint{grid-column:1/-1;margin-top:10px}
+ }
+ @media (prefers-reduced-motion:no-preference){
+  #hello:not([hidden]){animation:hello-in .22s ease-out both}
+  @keyframes hello-in{from{opacity:0;transform:translateY(10px)}to{opacity:1;transform:translateY(0)}}
+  @media (min-width:769px){
+   #hello:not([hidden]){animation-name:hello-in-c}
+   @keyframes hello-in-c{from{opacity:0;transform:translate(-50%,10px)}to{opacity:1;transform:translate(-50%,0)}}
+  }
+ }
 
  /* ── catalog ── */
  .pad{padding:22px 24px;overflow:auto;flex:1}
@@ -341,24 +584,34 @@
  #ftree-resizer::after{content:"";position:absolute;right:3px;top:0;bottom:0;width:2px;background:var(--accent);opacity:0;transition:opacity .15s}
  #ftree-resizer:hover::after,#ftree-resizer.dragging::after{opacity:.7}
  .ftree-list{overflow:auto;flex:1;padding:8px}
+ /* --d is the row's depth in the tree, set inline by the renderer; the Indexes
+    tab sets none and falls back to 0, which is the flat list it wants. */
  .ffolder{display:flex;align-items:center;gap:6px;width:100%;text-align:left;border:0;background:none;cursor:pointer;font-family:inherit;
-  font-size:11px;text-transform:uppercase;letter-spacing:.05em;color:var(--faint);padding:12px 8px 5px;font-weight:600}
+  font-size:11px;text-transform:uppercase;letter-spacing:.05em;color:var(--faint);font-weight:600;
+  padding:12px 8px 5px calc(8px + var(--d,0)*13px)}
  .ffolder:hover{color:var(--muted)}
+ /* the root row carries the bundle's name rather than a path segment, so it is
+    set as a name: no uppercasing, and truncated instead of wrapping */
+ .ffolder.root{text-transform:none;letter-spacing:0;font-size:12px;color:var(--muted)}
+ .ffolder.root span{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0}
  .ffolder .chev{width:11px;height:11px;flex:none;stroke:currentColor;fill:none;stroke-width:2.2;stroke-linecap:round;stroke-linejoin:round;transition:transform .15s}
  .ffolder.closed .chev{transform:rotate(-90deg)}
  .file.res .fn{color:var(--muted)}
  .file .fn .ricon{width:12px;height:12px;flex:none;stroke:var(--faint);fill:none;stroke-width:1.9;stroke-linecap:round;stroke-linejoin:round}
- .ftabs{display:flex;gap:2px;padding:8px 10px 0;border-bottom:1px solid var(--line);flex:none;align-items:center}
+ .ftabs{display:flex;gap:6px;padding:9px 10px;border-bottom:1px solid var(--line);flex:none;align-items:center}
+ .ftree-name{font-size:12.5px;font-weight:600;color:var(--ink);padding-left:2px}
+ /* the filter that replaced the Indexes tab: pressed, it narrows the same tree
+    to the authored layer instead of swapping in a second, flat one */
+ #ftree-ixonly{height:28px;gap:5px;font-size:12px;color:var(--muted)}
+ #ftree-ixonly svg{width:13px;height:13px}
+ #ftree-ixonly[aria-pressed=true]{background:var(--accent-soft);color:var(--accent-ink);border-color:transparent}
  /* mobile-only: collapses the stacked file list down to this tab bar */
- #ftree-min{display:none;width:28px;height:28px;flex:none;margin-bottom:4px}
+ #ftree-min{display:none;width:28px;height:28px;flex:none;margin-left:auto}
  #ftree-min svg{transition:transform .15s}
  .files-grid.tree-min #ftree-min svg{transform:rotate(180deg)}
- .ftab{flex:1;border:0;background:none;font:inherit;font-size:12.5px;font-weight:600;color:var(--muted);
-  padding:8px 10px;cursor:pointer;border-bottom:2px solid transparent;margin-bottom:-1px}
- .ftab:hover{color:var(--ink)}
- .ftab.active{color:var(--ink);border-bottom-color:var(--accent)}
- /* the type/tag combos filter concepts; they mean nothing on the Indexes tab */
- #app[data-ftab=indexes] #file-controls .combo{display:none}
+ #ftree-foldall{width:28px;height:28px;flex:none}
+ #ftree-foldall svg{transition:transform .15s}
+ #ftree-foldall.all-closed svg{transform:rotate(180deg)}
  .file .fn .badge-res{margin-left:auto;flex:none;font-size:9.5px;font-weight:600;letter-spacing:.04em;text-transform:uppercase;
   color:var(--faint);background:var(--line-2);border:1px solid var(--line);border-radius:999px;padding:1px 7px}
  /* The name needs an element of its own: as a bare text node it was an
@@ -367,13 +620,18 @@
     edge instead. overflow:hidden takes that minimum to zero, which is what lets
     the name give way and the badge stay put. */
  .file .fn .rn{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
- .file{display:block;width:100%;text-align:left;border:0;background:none;border-radius:8px;padding:7px 9px;cursor:pointer;font-family:inherit;color:var(--ink)}
+ .file{display:block;width:100%;text-align:left;border:0;background:none;border-radius:8px;cursor:pointer;font-family:inherit;color:var(--ink);
+  padding:7px 9px 7px calc(8px + var(--d,0)*13px)}
  .file:hover{background:var(--panel-2)} .file.sel{background:var(--accent-soft)}
  .file .fn{font-size:13px;font-weight:500;display:flex;align-items:center;gap:7px}
  .file .fn .dot{width:7px;height:7px;border-radius:50%;flex:none}
  .file .fd{font-size:11.5px;color:var(--faint);margin-top:2px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
  .fpreview{min-width:0;overflow:auto;display:flex;flex-direction:column}
  .fp-head{display:flex;align-items:center;gap:10px;padding:14px 22px;border-bottom:1px solid var(--line);flex:none}
+ /* `display:flex` outranks the UA sheet's `[hidden]{display:none}`, so the head
+    stayed on screen with nothing in it — an empty badge and a graph button
+    pointing nowhere — every time the reader had no file open. */
+ .fp-head[hidden]{display:none}
  .fp-head .title{margin:0;font-size:16px}
  .fp-body{padding:20px 28px;overflow:auto;flex:1}
  .fp-body .body{border-top:0;padding-top:0;margin-top:0}
@@ -427,6 +685,59 @@
  .ix-listing a:hover{text-decoration:underline}
  .ix-listing .d{color:var(--muted)}
 
+ /* ── concept preview (touch) ────────────────────────────────────────────────
+    Deliberately not a third "sheet": the ⚙ tools sheet and the ? sheet already
+    own that word, and a third would make every `grep -n sheet` on this file
+    ambiguous. This is the preview card — what a tap on a dot opens on a touch
+    screen, in place of the inspector.
+
+    In place of it because at this width the inspector *is* the viewport:
+    `grid-template-columns:0 1fr` below measures #stage at width 0, so tapping a
+    dot did not cover the graph, it deleted it, and exploring a phone became
+    open → read → close → tap the next dot. The card puts the concept's head at
+    the bottom edge and leaves the graph every pixel it had, live above it.
+
+    The element is the whole band from under the topbar to the bottom edge, so a
+    snap point is only a translateY: visible height H ⇒ translateY(FULL - H).
+    Hidden is translateY(100%); display:none off the touch branch keeps the
+    desktop DOM inert — no layout, no width, nothing to widen the document,
+    which is the lesson the Bundles panel above already paid for. ── */
+ #preview{position:fixed;left:0;right:0;top:var(--pv-top,56px);bottom:0;z-index:70;display:none;flex-direction:column;
+  background:var(--panel);border-top:1px solid var(--line);border-radius:16px 16px 0 0;
+  box-shadow:0 -10px 34px rgba(0,0,0,.30),0 -1px 0 var(--line);
+  /* No transition on transform, and that is the feature. The card used to rise
+     over 0.26s, so every one of the dozens of taps that exploring a graph takes
+     cost the same wait — and a miss on bare canvas dismissed it, which meant the
+     next dot replayed the entrance from scratch. Dragging still moves the card
+     directly; that was never a transition, so it survived. Nothing else may
+     animate here: mobile-preview.spec.js counts the distinct transform values
+     the element wears while it is on screen, and the contract is exactly one. */
+  transform:translateY(100%);overscroll-behavior:contain}
+ /* the grip and the head are the drag surface, so the browser must not claim
+    the gesture for a scroll — but only here, or the card's own body stops
+    scrolling at `full` */
+ #pv-grip{flex:none;padding:9px 0 4px;display:flex;justify-content:center;touch-action:none;cursor:grab}
+ #pv-grip:active{cursor:grabbing}
+ #pv-grip .pill{display:block;width:40px;height:4px;border-radius:3px;background:var(--line-2);border:1px solid var(--line)}
+ #pv-grip:focus-visible{outline:2px solid var(--accent);outline-offset:-3px;border-radius:10px}
+ #pv-head{flex:none;position:relative;touch-action:none;padding:2px 16px 12px;border-bottom:1px solid var(--line)}
+ /* a tablet is not a stretched phone: the column stops at a readable measure and
+    centres, while the card still spans the screen */
+ #pv-head>.col,#pv-body>.col{max-width:720px;margin:0 auto;width:100%}
+ #pv-x{position:absolute;top:0;right:10px;width:30px;height:30px;z-index:2}
+ #preview .pv-title{font-size:17px;font-weight:600;margin:.45em 0 0;line-height:1.32;letter-spacing:-.01em;
+  display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}
+ #preview .pv-desc{color:var(--muted);margin:7px 0 0;font-size:13.5px;line-height:1.5;
+  display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}
+ #preview[data-snap=half] .pv-desc,#preview[data-snap=full] .pv-desc{-webkit-line-clamp:4}
+ #preview .pv-meta{margin:9px 0 0;font-size:11.5px;color:var(--faint);font-variant-numeric:tabular-nums}
+ #pv-head .type{max-width:calc(100% - 38px)}
+ #pv-body{flex:1;min-height:0;overflow:auto;-webkit-overflow-scrolling:touch;padding:14px 16px 30px}
+ #pv-body .rel:first-child{margin-top:0}
+ #pv-body .body{font-size:14.5px}
+ /* the canvas hint sits exactly where the card lands */
+ #app.preview-up .ghint{display:none}
+
  /* ── compact chrome for ≤768px (phones and portrait tablets): the rail becomes
     a drawer behind ☰ and every topbar tool collapses into the ⚙ sheet. Wider
     viewports — a rotated tablet included — fall back to the desktop layout;
@@ -451,6 +762,17 @@
   #bar-tools .search{min-width:0;max-width:none;flex:1 1 auto} /* search spans the full sheet width */
   #app.controls-open #graph-controls,#app.controls-open #file-controls{flex-wrap:wrap}
   #app.controls-open #file-controls .combo{flex:1 1 44%;width:auto;min-width:130px}
+  /* Wrapping by whatever happened to fit left one icon orphaned on a line of its
+     own. The two controls carrying words take a column each, so the first line
+     is two even halves; the icon buttons then get a line to themselves and
+     spread across it. */
+  #app.controls-open #graph-controls{gap:8px}
+  #app.controls-open #graph-controls>#btn-filters,
+  #app.controls-open #graph-controls>.selwrap{flex:1 1 calc(50% - 4px);min-width:0}
+  /* the select has to grow with its wrapper. Stretching only the wrapper left
+     the control at its natural width with the chevron pinned to the wrapper's
+     far edge — a chevron floating over dead space, and every click on it lost. */
+  #app.controls-open #graph-controls>.selwrap>#layout{width:100%}
   /* the graph inspector takes the whole viewport — the ✕ closes it; widening,
      drag-resizing, and the topbar panel toggle have no job at this size
      (grid-template beats the resizer's inline --side-w) */
@@ -473,23 +795,46 @@
   .files-grid.tree-min{grid-template-rows:auto minmax(0,1fr)}
   .files-grid.tree-min .ftree-list{display:none}
  }
+ /* The card's branch is wider than the chrome's above. A portrait tablet keeps
+    the rail and the desktop topbar — it has the room — but 0-width-stage is its
+    bug too, and a bottom card is the right gesture on any touch screen held
+    upright. Landscape at the same size matches neither and keeps the inspector.
+    Written twice, here and as MOBILE_MQ in the JS, because neither language can
+    read the other: they are one decision, so keep them identical. */
+ @media (max-width:768px),(max-width:1024px) and (orientation:portrait){
+  #preview.up{display:flex}
+  /* the inspector's controls have no job on this branch — the panel they toggle
+     can only ever show its "Select a concept…" placeholder, because show() is
+     what fills it and show() never runs here */
+  #btn-panel,#side-widen,#side-resizer{display:none}
+ }
+ /* on a portrait tablet the rail is still on screen (it only folds at 768px), so
+    the card starts where the rail ends — one that buried Stats under itself
+    would be the takeover again, just shorter */
+ @media (min-width:769px) and (max-width:1024px) and (orientation:portrait){
+  #preview{left:76px;border-top-left-radius:16px}
+ }
  /* ── tablet and up: the panes stay side-by-side, but the same chevron folds
     the whole list column into a slim strip so the reader takes the width ── */
  @media (min-width:769px){
-  #ftree-min{display:inline-grid;margin-left:auto}
+  #ftree-min{display:inline-grid}
   #ftree-min svg{transform:rotate(90deg)}
   .files-grid.tree-min #ftree-min svg{transform:rotate(-90deg)}
   .files-grid.tree-min{grid-template-columns:auto 1fr}
-  .files-grid.tree-min .ftree-list,.files-grid.tree-min .ftab,.files-grid.tree-min #ftree-resizer{display:none}
+  .files-grid.tree-min .ftree-list,.files-grid.tree-min .ftabs,.files-grid.tree-min #ftree-resizer{display:none}
  }
  @media (prefers-reduced-motion:reduce){*{transition:none!important;animation:none!important}}
 </style></head>
 <body>
 <div id="app" data-view="graph">
  <nav id="rail" aria-label="Views">
-  <span class="rail-brand" title="<%= escaped_name %> — <%= @graph.nodes.length %> concepts · <%= @graph.edges.length %> links">
+  <%# Behind a hub the mark is the way back to every bundle — the missing-navbar
+      fix in miniature, and "../" reaches it under any mount because every page
+      lives at <prefix>/b/<slug>/. Standalone and static have nowhere to go, so
+      there it stays the plain identity badge it has always been. %>
+  <%= rail_brand_open %><%= escaped_name %> — <%= @graph.nodes.length %> concepts · <%= @graph.edges.length %> links">
    <svg viewBox="0 0 100 100"><rect width="100" height="100" rx="24" fill="#1a1a1a"/><polygon points="38,44 62,44 50,82" fill="#7a0a1e"/><polygon points="18,44 38,44 50,82" fill="#a8112c"/><polygon points="62,44 82,44 50,82" fill="#a8112c"/><polygon points="35,28 18,44 38,44" fill="#dc1e3c"/><polygon points="65,28 82,44 62,44" fill="#dc1e3c"/><polygon points="35,28 65,28 62,44 38,44" fill="#f43f5e"/><polygon points="36,29 49,29 42,42" fill="#fff" opacity=".38"/><polygon points="35,28 65,28 82,44 50,82 18,44" fill="none" stroke="#ff6b7f" stroke-width="2" stroke-linejoin="round"/></svg>
-  </span>
+  <%= rail_brand_close %>
   <button class="rail-item active" data-view="graph"><span class="ri-ico"><svg viewBox="0 0 24 24"><circle cx="6" cy="6" r="2.4"/><circle cx="18" cy="9" r="2.4"/><circle cx="9" cy="18" r="2.4"/><path d="M7.7 7.3 15.9 8.6M7.5 16 8.2 8.3M10.9 16.4 16.3 10.5"/></svg></span><span class="ri-lbl">Graph</span></button>
   <button class="rail-item" data-view="index"><span class="ri-ico"><svg viewBox="0 0 24 24"><path d="M4 5h16M4 9.6h10.5M4 14.2h16M4 18.8h7.5"/></svg></span><span class="ri-lbl">Index</span></button>
   <button class="rail-item" data-view="files"><span class="ri-ico"><svg viewBox="0 0 24 24"><path d="M3 7a2 2 0 0 1 2-2h3.5l2 2H19a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2Z"/></svg></span><span class="ri-lbl">Files</span></button>
@@ -501,6 +846,10 @@
    <button class="btn" id="btn-switch" type="button" hidden aria-label="Switch bundle (⌘K)" title="Switch bundle (⌘K)">
     <svg viewBox="0 0 24 24"><path d="M18 3a3 3 0 0 0-3 3v12a3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3H6a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3V6a3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3h12a3 3 0 0 0 3-3 3 3 0 0 0-3-3Z"/></svg>
     <span class="swcount" id="sw-count" hidden>0</span></button>
+   <%# Only a registry-backed hub has anything here to manage; the JS reveals it
+       off MANAGE_ROOT, the same way the switcher reveals itself off HUB_PATH. %>
+   <button class="btn" id="btn-ws" type="button" hidden aria-label="Bundles (registry)" title="Bundles (registry)" aria-expanded="false">
+    <svg viewBox="0 0 24 24" style="stroke-width:1.8"><circle cx="12" cy="12" r="3.1"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09a1.65 1.65 0 0 0-1-1.51 1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09a1.65 1.65 0 0 0 1.51-1 1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 2.83-2.83l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg></button>
    <button class="btn" id="btn-theme" type="button" aria-label="Toggle theme">
     <svg class="moon" viewBox="0 0 24 24"><path d="M20 14.5A8 8 0 0 1 9.5 4 8 8 0 1 0 20 14.5Z"/></svg>
     <svg class="sun" viewBox="0 0 24 24"><circle cx="12" cy="12" r="4.2"/><path d="M12 2.5v2M12 19.5v2M2.5 12h2M19.5 12h2M5.2 5.2l1.5 1.5M17.3 17.3l1.5 1.5M18.8 5.2l-1.5 1.5M6.7 17.3l-1.5 1.5"/></svg></button>
@@ -519,7 +868,12 @@
    <span class="ident"><%= escaped_name %><span class="muted"><%= @graph.nodes.length %> concepts · <%= @graph.edges.length %> links</span><%= source_link %></span>
    <div id="bar-tools">
    <div id="search-wrap"><label class="search"><svg viewBox="0 0 24 24" fill="none"><circle cx="11" cy="11" r="7"/><path d="m21 21-4.3-4.3"/></svg>
-    <input id="search" class="field" placeholder="search concepts…" autocomplete="off" aria-label="Search"></label></div>
+    <input id="search" class="field" placeholder="search concepts…" autocomplete="off" aria-label="Search">
+    <span class="s-tools"><span id="s-cnt" class="s-cnt" hidden></span><button type="button" id="s-cmdk" class="s-kbd" title="Search every bundle (⌘K)" aria-label="Search every bundle (⌘K)">⌘K</button></span>
+    <div id="s-bridge" class="s-bridge" role="status" hidden>
+     <div class="sb-msg"></div>
+     <div class="sb-row"><button type="button" class="sb-act primary" id="sb-go" hidden>Search every bundle <kbd>⏎</kbd></button><button type="button" class="sb-act" id="sb-clear">Clear <kbd>esc</kbd></button></div>
+    </div></label></div>
    <div id="file-controls">
     <div class="combo" id="file-type-combo"><input id="file-type-input" class="field" placeholder="all types" autocomplete="off" role="combobox" aria-expanded="false" aria-controls="file-type-list" aria-autocomplete="list" aria-label="Filter files by type"><button class="clear" id="file-type-clear" type="button" aria-label="Clear type filter"><svg viewBox="0 0 24 24"><path d="M6 6l12 12M18 6 6 18"/></svg></button><ul class="listbox" id="file-type-list" role="listbox" hidden></ul></div>
     <div class="combo" id="file-tag-combo"><input id="file-tag-input" class="field" placeholder="all tags" autocomplete="off" role="combobox" aria-expanded="false" aria-controls="file-tag-list" aria-autocomplete="list" aria-label="Filter files by tag"><button class="clear" id="file-tag-clear" type="button" aria-label="Clear tag filter"><svg viewBox="0 0 24 24"><path d="M6 6l12 12M18 6 6 18"/></svg></button><ul class="listbox" id="file-tag-list" role="listbox" hidden></ul></div>
@@ -541,6 +895,8 @@
      <svg viewBox="0 0 24 24"><rect x="3" y="3" width="18" height="18" rx="4" opacity=".45"/><circle cx="9" cy="9" r="1.9" fill="currentColor" stroke="none"/><circle cx="15" cy="10" r="1.9" fill="currentColor" stroke="none"/><circle cx="11" cy="15" r="1.9" fill="currentColor" stroke="none"/></svg></button>
     <button class="btn" id="btn-tree" type="button" aria-label="File tree" aria-pressed="false" title="File tree: folders and files, parent-to-child edges only">
      <svg viewBox="0 0 24 24"><rect x="9" y="3" width="6" height="5" rx="1.2"/><rect x="3" y="16" width="6" height="5" rx="1.2"/><rect x="15" y="16" width="6" height="5" rx="1.2"/><path d="M12 8v4M12 12H6v4M12 12h6v4"/></svg></button>
+    <button class="btn" id="btn-ix" type="button" aria-label="Show indexes" aria-pressed="false" title="Draw the index.md map layer alongside the concepts">
+     <svg viewBox="0 0 24 24"><path d="M4 5h16M4 9.6h10.5M4 14.2h16M4 18.8h7.5"/></svg></button>
     <button class="btn" id="btn-panel" type="button" aria-label="Toggle inspector" aria-pressed="true"><svg viewBox="0 0 24 24"><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M15 4v16"/></svg></button>
    </div>
    </div>
@@ -576,6 +932,19 @@
        <button class="btn" id="side-close" type="button" aria-label="Hide panel" title="Hide panel"><svg viewBox="0 0 24 24"><path d="M6 6l12 12M18 6 6 18"/></svg></button></div>
       <div id="side-body"><p class="empty">Select a concept — <b>click a node</b> in the graph, or search above — to read its full markdown here.</p></div>
      </aside>
+     <!-- the touch preview card. Non-modal on purpose: the graph behind it stays
+          live, pannable and tappable, which is the whole point — so role=region
+          and not dialog, because a dialog promises a focus trap this interaction
+          must not have. -->
+     <aside id="preview" role="region" aria-label="Concept preview" data-snap="peek" aria-hidden="true">
+      <div id="pv-grip" role="slider" tabindex="0" aria-label="Preview size — arrow keys resize"
+           aria-valuemin="1" aria-valuemax="3" aria-valuenow="1" aria-valuetext="peek"><span class="pill"></span></div>
+      <div id="pv-head">
+       <button class="btn" id="pv-x" type="button" aria-label="Close preview" title="Close"><svg viewBox="0 0 24 24"><path d="M6 6l12 12M18 6 6 18"/></svg></button>
+       <div class="col" id="pv-head-in"></div>
+      </div>
+      <div id="pv-body"><div class="col" id="pv-body-in"></div></div>
+     </aside>
     </div>
    </section>
 
@@ -606,9 +975,12 @@
    <section class="view" id="view-files">
     <div class="files-grid">
      <div class="ftree">
-      <div class="ftabs" role="tablist" aria-label="File kinds">
-       <button class="ftab active" id="ftab-files" type="button" role="tab" aria-selected="true">Files</button>
-       <button class="ftab" id="ftab-indexes" type="button" role="tab" aria-selected="false">Indexes</button>
+      <div class="ftabs">
+       <span class="ftree-name">Files</span>
+       <button class="btn text" id="ftree-ixonly" type="button" aria-pressed="false" title="Show only index.md and log.md">
+        <svg viewBox="0 0 24 24"><path d="M4 5h16M4 9.6h10.5M4 14.2h16M4 18.8h7.5"/></svg><span>Indexes only</span></button>
+       <button class="btn" id="ftree-foldall" type="button" aria-label="Collapse all folders" title="Collapse all folders">
+        <svg viewBox="0 0 24 24"><path d="m7 13 5-5 5 5"/><path d="m7 19 5-5 5 5"/></svg></button>
        <button class="btn" id="ftree-min" type="button" aria-label="Collapse file list" aria-expanded="true" aria-controls="ftree-list">
         <svg viewBox="0 0 24 24"><path d="m6 9 6 6 6-6"/></svg></button>
       </div>
@@ -652,6 +1024,20 @@
      </div>
     </div>
    </section>
+
+   <%# The Bundles panel lives in #views rather than #stage, so it is reachable
+       from every view — which is also why its closed state has to be `hidden`
+       and not merely translated: #stage clips, #views does not. %>
+   <div id="ws-ovl" hidden></div>
+   <aside id="ws" class="slideover" aria-label="Bundles" hidden>
+    <div class="fhead">
+     <div class="ws-head-t"><h3>Bundles</h3><div class="ws-sub" id="ws-sub"></div></div>
+     <button class="btn" id="ws-close" type="button" aria-label="Close bundles" style="width:28px;height:28px"><svg viewBox="0 0 24 24"><path d="M6 6l12 12M18 6 6 18"/></svg></button>
+    </div>
+    <div id="ws-flash" role="status" hidden></div>
+    <div class="fbody" id="ws-list"></div>
+    <div class="ws-foot" id="ws-foot">Adding a bundle is done from the terminal — <code>okf registry set &lt;dir&gt;</code> — usually by your agent.</div>
+   </aside>
   </div>
  </div>
 </div>
@@ -685,24 +1071,101 @@
 </div>
 
 <div id="nav-bk" hidden></div>
-<div id="mnote" hidden role="note">
- <span>Best experienced on a desktop — tap ☰ for views, pinch to zoom, tap a concept to read it.</span>
- <button class="btn" id="mnote-x" type="button" aria-label="Dismiss">✕</button>
+<div id="hello2" hidden role="note" aria-labelledby="hello2-h">
+ <span class="hello-dots" aria-hidden="true"><i></i><i></i><i></i></span>
+ <p class="hello2-h" id="hello2-h">Tap ☰ for the other views</p>
+ <p class="hello2-b">Graph, Files, Catalog, Tags and Stats.</p>
+ <button id="hello2-x" type="button">Got it</button>
+</div>
+<div id="hello" hidden role="note" aria-labelledby="hello-h">
+ <button class="btn" id="hello-x" type="button" aria-label="Dismiss">✕</button>
+ <span class="hello-dots" aria-hidden="true"><i></i><i></i><i></i></span>
+ <p class="hello-h" id="hello-h">First time here?</p>
+ <button id="hello-go" type="button">Read the index</button>
+ <p class="hello-hint">
+  <span class="hello-point">Or click any dot to read that concept. Scroll to zoom, drag to pan.</span>
+  <span class="hello-touch">Or tap any dot to read that concept. Pinch to zoom, drag to pan.</span>
+  <span class="hello-menu"> ☰ opens the other views.</span>
+ </p>
 </div>
 
 <script>
+/* ═══ JS sections, in file order ════════════════════════════════════════════
+   Same `── name ──` banners as the CSS above; same grep prints them with live
+   line numbers.
+
+     payload + derived indexes     Cytoscape (style, instance)
+     Mermaid (lazy)                fullscreen diagram viewer
+     inspector                     drag-resize splitters
+     graph filters                 layout
+     cluster by area               file-tree mode
+     the authored layer            fit to screen
+     view switching                full-text search
+     catalog                       files
+     tags                          stats
+     theme / fullscreen            §6 map payload · §7 log payload
+     command palette               the search bridge
+     concept preview (touch)       mobile drawer + sheet
+     keyboard                      deep links · first visit
+
+   ── What actually couples these ──────────────────────────────────────────
+   The sections are tidy lexically and entangled at runtime, which is why a
+   change in one breaks another. Three seams carry almost all of it:
+
+   1. `applyGraphFilter()` is the shared sink. The search box, the three chip
+      groups in the slide-over, the inspector's focus chips and cluster mode
+      all funnel into it, and it reads `q.graph`, `activeTypes`, `activeTags`,
+      `activeAreas` and `ftMatch()` together. Touching any one caller can
+      change what the other four produce.
+   2. `setView()` reaches into nearly every section — it toggles the tool
+      groups, seeds a view on first entry via `inited`, and has to
+      `cy.resize()` on the way back to the graph, because Cytoscape measures a
+      hidden container as 0×0 and returns collapsed without it.
+   3. The lazy caches — `CATALOG`, `INDEX`, `LOGS`, `ftIndex` — are each
+      filled by one section and read by three or four. A stale one is
+      invisible until an unrelated view renders wrong.
+
+   The mode flags (`clustered`, `treeMode`, `ixNodes`, `ixOnly`, `view`) are
+   read across boundaries too: each rebuilds the graph's elements and must
+   undo itself exactly, or its nodes leak into the plain view.
+
+   All of the above is pinned by test/browser/ — `bundle exec rake
+   test:browser`. Run it before and after editing this file; it drives the
+   real page in Chromium and fails on any error the page throws.
+   ═════════════════════════════════════════════════════════════════════════ */
 const NODES=<%= nodes_json %>, EDGES=<%= edges_json %>, TYPES=<%= types_json %>, TAGS=<%= tags_json %>;
 const NODE_ENDPOINT=<%= @node_endpoint.to_json %>, META_ENDPOINT=<%= @meta_endpoint.to_json %>;
+const BUNDLE=<%= name_json %>;
 const CATALOG_ENDPOINT="catalog",INDEX_ENDPOINT="index",LOG_ENDPOINT="log";
 /* The hub's bundle switcher (⌘/Ctrl-K). SIBLINGS is empty for a standalone
    server and for `okf render`, so a single bundle or a static file offers none. */
 const SIBLINGS=<%= siblings_json %>, SELF_SLUG=<%= self_slug_json %>, HUB_PATH=<%= hub_path_json %>;
+/* The hub's cross-bundle search, mount-relative — null for a standalone server
+   and for `okf render`, where there is no set of bundles to search. */
+const SEARCH_ENDPOINT=<%= search_endpoint_json %>;
+/* The hub root, mount-relative — where the Bundles panel reads /bundles and
+   posts /registry/<verb>. Null for a standalone server and for `okf render`,
+   and that null is the gate: neither has a registry behind it, so neither ever
+   shows the ⚙. MANAGE_TOKEN is null wherever a write would be refused anyway
+   (a read-only bind, an ephemeral set), so the page holds no credential it
+   cannot use — and the panel reads that null to explain itself. */
+const MANAGE_ROOT=<%= manage_root_json %>, MANAGE_TOKEN=<%= manage_token_json %>;
 /* null when served live (`okf server`) — the getters below fetch the endpoints
-   above. `okf render` injects a payload {catalog,index,logs,bodies,meta}, and
-   every getter resolves from it instead, so one file needs no server and the
-   endpoint consts above go inert. */
+   above. `okf render` injects a payload {catalog,index,logs,bodies}, and every
+   getter resolves from it instead (the /node/meta fragment derived from the
+   catalog), so one file needs no server and the endpoint consts above go inert. */
 const EMBED=<%= embed_json %>;
-const MIN=<%= OKF::Server::Graph::MIN_SIZE %>, MAX=<%= OKF::Server::Graph::MAX_SIZE %>;
+/* Full-text search state (MiniSearch, lazy — built on first search). One ranked
+   index behind the search box for the graph, catalog and files views. It indexes
+   title/id/type/tags/description in every mode, plus each concept body wherever
+   the page already holds it: `okf render` bakes every body in, so a static file
+   searches bodies offline; the live server keeps bodies lazy, so its index stays
+   metadata-only until a backend body index arrives. Same 7.2.0 build and config
+   as the Ruby port, so a Ruby-built index and this one rank identically. */
+const FT_FIELDS=['title','id','type','tags','description'].concat(EMBED?['body']:[]);
+let _MiniSearch=null,ftIndex=null,ftBuilding=null;
+const descOf={};
+const MIN=<%= OKF::Render::Graph::MIN_SIZE %>, MAX=<%= OKF::Render::Graph::MAX_SIZE %>;
 const PALETTE=["#6E56CF","#D97757","#22C55E","#3B82F6","#EAB308","#EC4899","#14B8A6","#F97316","#A855F7","#0EA5E9","#84CC16","#EF4444","#64748B"];
 const root=document.documentElement;
 const byId=Object.fromEntries(NODES.map(n=>[n.id,n]));
@@ -733,13 +1196,32 @@ function styleSheet(){const ink=cvar('--ink'),halo=cvar('--canvas'),edge=cvar('-
    'font-size':10,'font-weight':500,'text-wrap':'wrap','text-max-width':120,'text-valign':'bottom','text-margin-y':5,
    'text-outline-width':2.5,'text-outline-color':halo,'min-zoomed-font-size':7,'border-width':0,'width':'data(sz)','height':'data(sz)'}},
   {selector:'edge',style:{'width':1.2,'line-color':edge,'target-arrow-color':edge,'target-arrow-shape':'triangle','arrow-scale':.8,'curve-style':'bezier','opacity':.8}},
-  {selector:'.dim',style:{'opacity':.1}},
-  {selector:'.hl',style:{'border-width':3,'border-color':cvar('--accent')}},
-  {selector:'node.dir',style:{'shape':'round-rectangle','background-color':cvar('--faint'),'background-opacity':.85,
-   'font-size':9.5,'font-weight':600,'color':cvar('--muted')}},
-  {selector:'edge.tree',style:{'width':1.1,'opacity':.7,'target-arrow-shape':'none'}},
+  /* A folder node and a map node are the same thing twice over — clicking
+     either opens that directory's index — so they converge on one look instead
+     of parting by mode: an accent square, never a concept's circle, with the
+     edges into it dashed. Colour separates *kinds* here, not modes; a directory
+     is not a concept and should not read as one. */
+  {selector:'node.dir,node.ix',style:{'shape':'round-rectangle','background-color':cvar('--accent'),'background-opacity':.9,
+   'font-size':9.5,'font-weight':700,'color':cvar('--ink')}},
+  {selector:'edge.tree',style:{'width':1.1,'opacity':.7,'line-style':'dashed','target-arrow-shape':'none'}},
+  /* what separates the two maps is authorship, not hue: a directory the bundle
+     only implies is hollow and dashed, which is the same "not really there"
+     the dashed edges say. */
+  /* authorship still shows as form: a map nobody wrote is hollow and dashed */
+  {selector:'node.ix-syn',style:{'background-color':cvar('--faint'),'background-opacity':.2,'color':cvar('--muted'),
+   'border-width':1.5,'border-color':cvar('--faint'),'border-style':'dashed'}},
+  {selector:'edge.ixe',style:{'width':1,'opacity':.5,'line-style':'dashed','line-color':cvar('--edge'),'target-arrow-shape':'none'}},
+  {selector:'edge.ixe-syn',style:{'opacity':.3}},
   {selector:'edge.linkhid',style:{'display':'none'}},
-  {selector:':parent',style:{'background-color':cvar('--ink'),'background-opacity':0.05,'border-width':1,'border-color':cvar('--edge'),'shape':'round-rectangle','padding':26,'label':'data(label)','color':cvar('--ink'),'font-size':13,'font-weight':600,'text-valign':'top','text-halign':'center','text-margin-y':-8,'min-zoomed-font-size':0,'text-outline-width':3,'text-outline-color':cvar('--canvas')}}
+  {selector:':parent',style:{'background-color':cvar('--ink'),'background-opacity':0.05,'border-width':1,'border-color':cvar('--edge'),'shape':'round-rectangle','padding':26,'label':'data(label)','color':cvar('--ink'),'font-size':13,'font-weight':600,'text-valign':'top','text-halign':'center','text-margin-y':-8,'min-zoomed-font-size':0,'text-outline-width':3,'text-outline-color':cvar('--canvas')}},
+  /* ── state, last so it outranks every look above ──
+     Cytoscape resolves equal-specificity selectors by array order, so a base
+     rule declared after `.dim` beats it. `edge.tree` and `edge.ixe` each set
+     their own opacity, which meant neither ever dimmed: a map's dashed edges
+     sat at half opacity across the whole graph, and selecting one emphasised
+     nothing. Dim and highlight are states, not looks — they go last. */
+  {selector:'.dim',style:{'opacity':.1}},
+  {selector:'.hl',style:{'border-width':3,'border-color':cvar('--accent')}}
  ];}
 /* Only the floor for a graph that already fits. "Far enough out to see
    everything" is not a constant — a big bundle, especially clustered by area
@@ -906,7 +1388,7 @@ interceptMdLinks(document.getElementById('fp-body'),()=>fileSel,id=>openFile(id)
 function showDir(dir){getIndex().then(dirs=>{const d=dirs.find(x=>x.dir===dir);if(!d)return;
  const opened=openPanel();sideBody.scrollTop=0;
  shownId=d.dir==='.'?'index':d.dir+'/index'; /* pseudo-id: relative links in the map resolve against its directory */
- const label=d.dir==='.'?'(root)':d.dir+'/';
+ const label=d.dir==='.'?BUNDLE:d.dir+'/';
  const types=Object.entries(d.types||{}).map(([t,n])=>esc(t||'Untyped')+' '+n).join(' · ');
  sideBody.innerHTML=`<span class="type">${d.present?'index.md':'no index.md · synthesized'}</span>
   <h2 class="title">${esc(label)}</h2>
@@ -925,10 +1407,14 @@ function showLog(path){LOGS=null;getLogs().then(logs=>{const l=logs.find(x=>x.pa
  if(opened)requestAnimationFrame(()=>cy.resize());});}
 /* Two per-concept reads shared by the inspector and the files preview: the raw
    markdown body (rendered client-side) and the description fragment. Live they
-   hit /node and /node/meta; under EMBED they resolve from the baked payload.
+   hit /node and /node/meta; under EMBED the body resolves from the baked payload
+   and the meta fragment is derived from the baked catalog — escaped here the same
+   way /node/meta escapes it — so the description lives in exactly one place.
    Never memoized in server mode, so on-disk edits keep reflecting. */
+const EMBED_DESC=EMBED?Object.fromEntries((EMBED.catalog||[]).map(c=>[c.id,c.description||''])):null;
+const metaFragment=d=>(d==null||String(d).trim()==='')?'<span class="empty">no description</span>':esc(d);
 function getNodeBody(id){return EMBED?Promise.resolve(EMBED.bodies[id]||''):fetch(NODE_ENDPOINT+'?id='+encodeURIComponent(id)).then(r=>r.ok?r.text():'');}
-function getNodeMeta(id){return EMBED?Promise.resolve(EMBED.meta[id]||''):fetch(META_ENDPOINT+'?id='+encodeURIComponent(id)).then(r=>r.ok?r.text():'');}
+function getNodeMeta(id){return EMBED?Promise.resolve(metaFragment(EMBED_DESC[id])):fetch(META_ENDPOINT+'?id='+encodeURIComponent(id)).then(r=>r.ok?r.text():'');}
 function show(id){const n=byId[id];if(!n)return false;const ty=typeOf[id]||'Untyped';const c=color[ty]||'#64748b';
  shownId=id;const opened=openPanel();sideBody.scrollTop=0;
  sideBody.innerHTML=`<button type="button" class="type facet" data-focus-type="${esc(ty)}" title="Show only ${esc(ty)} in the graph"><span class="dot" style="background:${c}"></span>${esc(ty)}</button>
@@ -954,38 +1440,80 @@ function show(id){const n=byId[id];if(!n)return false;const ty=typeOf[id]||'Unty
    container is still animating (--side-w, .22s), so pan now and the debounced
    cy.resize() would shift the view again a moment later — the double movement.
    Instead wait for the panel to settle, resize once, then pan. cy.stop() first
-   so rapid clicks replace the animation instead of queueing repeats. */
-let centerTimer;
+   so rapid clicks replace the animation instead of queueing repeats.
+
+   window.__camCenters mirrors a counter bumped just before each committed
+   centre-pan. It is test-only instrumentation, invisible to users, and it
+   exists because this fix has no other external observable: a panel-opening
+   click must commit exactly one pan, and it must be the *deferred* one — read
+   synchronously right after the tap the counter is still 0 (nothing fired), it
+   reaches 1 once the 260ms defer elapses, and it never doubles. An immediate
+   pan would read 1 on that first synchronous read.
+   test/browser/specs/camera-races.spec.js pins all three. */
+let centerTimer,centerCommits=0;window.__camCenters=0;
 function centerOn(ele,delay){clearTimeout(centerTimer);
- const go=()=>{cy.resize();cy.stop();cy.animate({center:{eles:ele},duration:450,easing:'ease-in-out-cubic'});};
- if(delay)centerTimer=setTimeout(go,260);else{cy.stop();cy.animate({center:{eles:ele},duration:450,easing:'ease-in-out-cubic'});}}
+ const go=()=>{cy.resize();cy.stop();window.__camCenters=++centerCommits;cy.animate({center:{eles:ele},duration:450,easing:'ease-in-out-cubic'});};
+ if(delay)centerTimer=setTimeout(go,260);else{cy.stop();window.__camCenters=++centerCommits;cy.animate({center:{eles:ele},duration:450,easing:'ease-in-out-cubic'});}}
+/* Emphasise a node and its immediate neighbourhood. One gesture for a concept,
+   a folder and a map: selection should mean the same thing on this canvas
+   whatever was selected, and it used to mean three things — a concept dimmed the
+   rest, a map did nothing, a folder node did nothing either. */
+function focusNode(ele,opened){if(!ele||!ele.length)return;
+ /* Dim the leaves and edges, never the compound area boxes: a parent's opacity
+    cascades to the nodes inside it (effectiveOpacity), so dimming the boxes fades
+    the whole graph — the selection and its neighbourhood included — and emphasis
+    reads as nothing at all in cluster mode. The boxes stay put; the leaves carry
+    the state. (Outside cluster mode there are no :parent nodes, so this is a
+    no-op there.) */
+ cy.elements().removeClass('hl');cy.elements().not(':parent').addClass('dim');
+ ele.closedNeighborhood().removeClass('dim');ele.addClass('hl');
+ centerOn(ele,opened);}
 function select(id){const ele=cy.getElementById(id);if(!ele.length)return;const opened=show(id);
- cy.elements().removeClass('hl').addClass('dim');const nb=ele.closedNeighborhood();nb.removeClass('dim');ele.addClass('hl');
- centerOn(ele,opened);
+ focusNode(ele,opened);
  try{if(decodeURIComponent((location.hash||'').slice(1))!==id)location.hash=encodeURIComponent(id);}catch(e){}}
 cy.on('tap','node',e=>{const t=e.target;
- if(t.hasClass('dir'))return showDir(t.id().slice(DIR.length)||'.');
+ if(t.hasClass('dir')){showDir(t.id().slice(DIR.length)||'.');return focusNode(t,true);}
+ if(t.hasClass('ix')){showDir(t.data('dir')||'.');return focusNode(t,true);}
  if(t.isParent()){const a=t.id().indexOf('area::')===0?t.id().slice(6):null;return showDir(a&&a!=='(root)'?a:'.');}
  select(t.id());});
-cy.on('tap',e=>{if(e.target===cy)cy.elements().removeClass('dim hl');});
+/* Clear the focus: drop the dim/highlight and let the hash forget the node, so a
+   reload does not reselect it. Tapping empty canvas does this — but a dense graph
+   leaves almost no empty canvas to hit, so Esc is bound to it too (keydown). */
+function deselect(){cy.elements().removeClass('dim hl');try{if(location.hash)history.replaceState(null,'',location.pathname+location.search);}catch(e){}}
+cy.on('tap',e=>{if(e.target===cy)deselect();});
 
 /* ── graph filters (slide-over) ── */
-const hiddenTypes=new Set(), activeTags=new Set(), activeAreas=new Set();
+/* Three groups, one grammar: empty means everything, a click narrows, a second
+   click puts it back. Types used to be the odd one out — a `hiddenTypes` set
+   where every type showed until you clicked one *away* — so the same chip
+   component meant "include" under Areas and Tags and "exclude" two rows above,
+   and meant "include" again on the catalog's own type chips one view over. That
+   is a rule a reader has to learn per panel instead of once. Within a group
+   selections union (Service *or* Charter); across groups they intersect. */
+const activeTypes=new Set(), activeTags=new Set(), activeAreas=new Set();
 const searchInput=document.getElementById('search');
 const q={graph:'',catalog:'',files:'',tags:''};
-function applyGraphFilter(){const s=q.graph.toLowerCase();
- cy.nodes().forEach(n=>{if(n.isParent()||n.hasClass('dir'))return;const id=n.data('id');const t=typeOf[id]||'Untyped';const nt=tagsOf[id]||[];
-  const hay=(n.data('title')+' '+t+' '+nt.join(' ')).toLowerCase();
-  const m=(!s||hay.includes(s))&&!hiddenTypes.has(t)&&(activeTags.size===0||nt.some(x=>activeTags.has(x)))&&(activeAreas.size===0||activeAreas.has(areaOf(id)));
+function applyGraphFilter(){const s=q.graph.toLowerCase();const ids=ftMatch(q.graph);
+ cy.nodes().forEach(n=>{if(n.isParent()||n.hasClass('dir')||n.hasClass('ix'))return;const id=n.data('id');const t=typeOf[id]||'Untyped';const nt=tagsOf[id]||[];
+  const hay=(n.data('title')+' '+t+' '+nt.join(' ')+' '+(descOf[id]||'')).toLowerCase();
+  const txt=ids?ids.has(id):(!s||hay.includes(s));
+  const m=txt&&(activeTypes.size===0||activeTypes.has(t))&&(activeTags.size===0||nt.some(x=>activeTags.has(x)))&&(activeAreas.size===0||activeAreas.has(areaOf(id)));
   n.style('display',m?'element':'none');});
- relaxZoom();}
-function fbadge(){const c=hiddenTypes.size+activeTags.size+activeAreas.size;const b=document.getElementById('btn-filters');
+ /* Cluster mode draws an area box around each group's concepts. When a filter
+    hides every concept in a group, hide the now-empty box too (and bring it back
+    when one survives) — the same rule fitBox already uses to leave stale boxes
+    out of the fit, now applied to what is drawn. */
+ cy.nodes(':parent').forEach(p=>p.style('display',p.children().some(c=>c.style('display')!=='none')?'element':'none'));
+ ixVisibility();
+ relaxZoom();
+ bridgeSync();}
+function fbadge(){const c=activeTypes.size+activeTags.size+activeAreas.size;const b=document.getElementById('btn-filters');
  b.classList.toggle('on-filter',c>0);b.querySelector('.fbadge').textContent=c;ctlBadge();syncFacets();}
 /* mirror the active view's tool state onto the ⚙ toggle — when the sheet is
    folded away on mobile, an active filter must still call out from the bar */
 function ctlBadge(){const b=document.getElementById('btn-controls');if(!b)return;
  let c=0;
- if(view==='graph')c=hiddenTypes.size+activeTags.size+activeAreas.size;
+ if(view==='graph')c=activeTypes.size+activeTags.size+activeAreas.size;
  else if(view==='files'){try{c=(fileTypeCombo.get()?1:0)+(fileTagCombo.get()?1:0);}catch(err){}}
  b.classList.toggle('on-filter',c>0);b.querySelector('.fbadge').textContent=c;}
 const ftypes=document.getElementById('ftypes'), ftags=document.getElementById('ftags'), fareas=document.getElementById('fareas');
@@ -996,8 +1524,8 @@ const dotFor=t=>`<span class="dot" style="background:${color[t]}"></span>`;
 const toggleSet=(s,v)=>{s.has(v)?s.delete(v):s.add(v);};
 /* One renderer for every filter chip group (graph, catalog and tags views):
    paints the items with their current state class and wires the toggle. */
-function chipRow(el,items,attr,stateCls,isOn,onToggle){
- el.innerHTML=items.map(o=>`<span class="chip${isOn(o.v)?' '+stateCls:''}" ${attr}="${esc(o.v)}">${o.dot||''}${esc(o.v)} <span class="c">${o.n}</span></span>`).join('');
+function chipRow(el,items,attr,isOn,onToggle){
+ el.innerHTML=items.map(o=>`<span class="chip${isOn(o.v)?' on':''}" ${attr}="${esc(o.v)}">${o.dot||''}${esc(o.v)} <span class="c">${o.n}</span></span>`).join('');
  el.querySelectorAll('.chip').forEach(ch=>ch.onclick=()=>onToggle(ch.getAttribute(attr)));}
 const typeItems=list=>list.map(t=>({v:t,n:(TYPES[t]||[]).length,dot:dotFor(t)}));
 const areaItems=list=>list.map(a=>({v:a,n:areaCount[a]}));
@@ -1007,28 +1535,30 @@ const tagItems=list=>list.map(t=>({v:t,n:(TAGS[t]||[]).length}));
 const fsearch=document.getElementById('filter-search');
 function syncFilterChips(){const qq=fsearch.value.trim().toLowerCase();const match=v=>!qq||v.toLowerCase().includes(qq);
  const after=()=>{syncFilterChips();applyGraphFilter();fbadge();};
- chipRow(ftypes,typeItems(types.filter(match)),'data-t','off',t=>hiddenTypes.has(t),t=>{toggleSet(hiddenTypes,t);after();});
- chipRow(fareas,areaItems(graphAreas.filter(match)),'data-area','on',a=>activeAreas.has(a),a=>{toggleSet(activeAreas,a);after();});
- chipRow(ftags,tagItems(qq?tagsByCount.filter(match):tagsByCount.slice(0,40)),'data-tag','on',t=>activeTags.has(t),t=>{toggleSet(activeTags,t);after();});}
+ chipRow(ftypes,typeItems(types.filter(match)),'data-t',t=>activeTypes.has(t),t=>{toggleSet(activeTypes,t);after();});
+ chipRow(fareas,areaItems(graphAreas.filter(match)),'data-area',a=>activeAreas.has(a),a=>{toggleSet(activeAreas,a);after();});
+ chipRow(ftags,tagItems(qq?tagsByCount.filter(match):tagsByCount.slice(0,40)),'data-tag',t=>activeTags.has(t),t=>{toggleSet(activeTags,t);after();});}
 fsearch.oninput=syncFilterChips;
 syncFilterChips();
 // Fit the graph to the currently-visible nodes after a view swap settles (two rAFs
 // so the container has resized), reusing the working fitGraph implementation.
 function fitVisible(){requestAnimationFrame(()=>requestAnimationFrame(fitGraph));}
-function focusGraphType(t){setView('graph');hiddenTypes.clear();activeTags.clear();activeAreas.clear();types.forEach(x=>{if(x!==t)hiddenTypes.add(x);});syncFilterChips();applyGraphFilter();fbadge();fitVisible();}
-function focusGraphArea(a){setView('graph');hiddenTypes.clear();activeTags.clear();activeAreas.clear();activeAreas.add(a);syncFilterChips();applyGraphFilter();fbadge();fitVisible();}
-function focusGraphTag(t){setView('graph');hiddenTypes.clear();activeTags.clear();activeAreas.clear();activeTags.add(t);syncFilterChips();applyGraphFilter();fbadge();fitVisible();}
-function clearGraphFilter(){hiddenTypes.clear();activeTags.clear();activeAreas.clear();syncFilterChips();applyGraphFilter();fbadge();fitVisible();}
+function focusGraphType(t){setView('graph');clearSets();activeTypes.add(t);syncFilterChips();applyGraphFilter();fbadge();fitVisible();}
+function focusGraphArea(a){setView('graph');clearSets();activeAreas.add(a);syncFilterChips();applyGraphFilter();fbadge();fitVisible();}
+function focusGraphTag(t){setView('graph');clearSets();activeTags.add(t);syncFilterChips();applyGraphFilter();fbadge();fitVisible();}
+const clearSets=()=>{activeTypes.clear();activeTags.clear();activeAreas.clear();};
+function clearGraphFilter(){clearSets();syncFilterChips();applyGraphFilter();fbadge();fitVisible();}
 /* Is the graph focused on exactly this facet and nothing else? Only then is a
    second click on the chip an undo — with any other filter in play, clearing
    would throw away more than the click put there, so the chip re-focuses
    instead. This is also what lights the chip, so what you see and what the
    next click does are the same question, asked once. */
-/* hiddenTypes.size>0 is not redundant: in a one-type bundle `types.length-1` is
-   zero, so an unfiltered graph would read as focused, light the chip, and spend
-   the first click clearing nothing. */
-function typeFocused(t){return !activeTags.size&&!activeAreas.size&&hiddenTypes.size>0&&hiddenTypes.size===types.length-1&&!hiddenTypes.has(t);}
-function tagFocused(t){return !hiddenTypes.size&&!activeAreas.size&&activeTags.size===1&&activeTags.has(t);}
+/* The two read alike now. They could not while types were subtractive: "focused
+   on t" was `every other type hidden`, which a one-type bundle satisfies with
+   nothing hidden at all — so an unfiltered graph read as focused, lit the chip,
+   and spent the first click clearing nothing. */
+function typeFocused(t){return !activeTags.size&&!activeAreas.size&&activeTypes.size===1&&activeTypes.has(t);}
+function tagFocused(t){return !activeTypes.size&&!activeAreas.size&&activeTags.size===1&&activeTags.has(t);}
 /* The chips are filter indicators, so they repaint wherever the badge does —
    that way a filter cleared from the slide-over un-lights the chip too. */
 function syncFacets(){
@@ -1037,7 +1567,7 @@ function syncFacets(){
 const filtersEl=document.getElementById('filters');
 document.getElementById('btn-filters').onclick=()=>filtersEl.classList.toggle('open');
 document.getElementById('filters-close').onclick=()=>filtersEl.classList.remove('open');
-document.getElementById('filters-reset').onclick=()=>{hiddenTypes.clear();activeTags.clear();activeAreas.clear();syncFilterChips();applyGraphFilter();fbadge();};
+document.getElementById('filters-reset').onclick=()=>{clearSets();syncFilterChips();applyGraphFilter();fbadge();};
 
 /* ── layout: 5 built-ins + extension layouts loaded lazily on first use ── */
 const layoutSel=document.getElementById('layout');
@@ -1090,6 +1620,11 @@ function setClustered(on){if(on===clustered)return;if(on&&treeMode)setTree(false
  if(on){const as=[...new Set(NODES.map(n=>areaOf(n.id)))];
   cy.add(as.map(a=>({group:'nodes',data:{id:'area::'+a,label:a}})));
   cy.batch(()=>NODES.forEach(n=>{const e=cy.getElementById(n.id);if(e.length)e.move({parent:'area::'+areaOf(n.id)});}));
+  /* A box is made for every area; if a search or filter was already narrowing
+     the graph, the areas it emptied would cluster as phantom boxes. Re-apply the
+     filter now — before the layout tiles them — so empty areas never get drawn.
+     (Filtering while already clustered runs applyGraphFilter on its own.) */
+  applyGraphFilter();
   clusterLayout();
  }else{
   cy.batch(()=>NODES.forEach(n=>{const e=cy.getElementById(n.id);if(e.length&&e.isChild())e.move({parent:null});}));
@@ -1103,12 +1638,13 @@ let treeMode=false;const btnTree=document.getElementById('btn-tree');
 const DIR='dir::';
 function setTree(on){if(on===treeMode)return;if(on&&clustered)setClustered(false);
  treeMode=on;btnTree.setAttribute('aria-pressed',String(on));layoutSel.disabled=on;btnCluster.disabled=on;
+ btnIx.disabled=on;if(on&&ixNodes)setIxNodes(false,false);
  if(on){
   const dirs=new Set(['']);
   NODES.forEach(n=>{const parts=n.id.split('/');for(let i=1;i<parts.length;i++)dirs.add(parts.slice(0,i).join('/'));});
   cy.batch(()=>{
    cy.add([...dirs].map(d=>({group:'nodes',classes:'dir',
-    data:{id:DIR+d,title:d?d.split('/').pop()+'/':'/',c:cvar('--faint'),sz:d?20:28}})));
+    data:{id:DIR+d,title:d?d.split('/').pop()+'/':BUNDLE,c:cvar('--accent'),sz:d?20:28}})));
    [...dirs].forEach(d=>{if(!d)return;const p=d.split('/').slice(0,-1).join('/');
     cy.add({group:'edges',classes:'tree',data:{id:'tree::'+d,source:DIR+p,target:DIR+d}});});
    NODES.forEach(n=>{const p=n.id.split('/').slice(0,-1).join('/');
@@ -1124,13 +1660,69 @@ function setTree(on){if(on===treeMode)return;if(on&&clustered)setClustered(false
   cy.batch(()=>{cy.edges('.tree').remove();cy.nodes('.dir').remove();cy.edges().removeClass('linkhid');});
   runLayout(layoutSel.value);}}
 btnTree.onclick=()=>setTree(!treeMode);
+/* ── the authored layer, drawn ──
+   The §6 map used to be visible only inside file-tree mode, where a folder node
+   stood in for a directory's index.md. It is a layer of its own now: switch it
+   on under any layout and each `index.md` becomes a node, edged to the concepts
+   it maps and to the child maps beneath it. Cluster and tree mode still work —
+   tree already draws folders, so it disables the toggle rather than doubling it.
+
+   These nodes are *drawn, never modelled*. index.md is reserved (it is not a
+   concept), and the page must not be the place that quietly decides otherwise:
+   they are built from /index straight onto the canvas, so NODES, /catalog and
+   the type and tag indexes never learn they exist. */
+const IX='ix::';
+let ixNodes=false,IXROWS=[],ixSeq=0;
+const btnIx=document.getElementById('btn-ix');
+/* `relayout:false` says a caller owns the layout and is about to run its own —
+   without it the teardown's layout and file-tree mode's breadthfirst raced over
+   the same canvas, and the tree landed wrong until it was clicked again. The
+   ticket covers the other direction: the add is async, so a toggle flipped or a
+   mode entered while /index is in flight has to cancel the landing. */
+function setIxNodes(on,relayout){if(on===ixNodes)return Promise.resolve();
+ ixNodes=on;btnIx.setAttribute('aria-pressed',String(on));
+ const seq=++ixSeq;
+ if(!on){IXROWS=[];cy.batch(()=>{cy.edges('.ixe').remove();cy.nodes('.ix').remove();});
+  if(relayout!==false)runLayout(layoutSel.value);return Promise.resolve();}
+ return getIndex().then(dirs=>{if(seq!==ixSeq||!ixNodes||treeMode)return;IXROWS=dirs||[];
+  cy.batch(()=>{
+   IXROWS.forEach(d=>{const syn=!!d.synthesized;
+    cy.add({group:'nodes',classes:'ix'+(syn?' ix-syn':''),
+     data:{id:IX+d.dir,dir:d.dir,title:d.dir==='.'?BUNDLE:d.dir.split('/').pop()+'/',
+      c:cvar(syn?'--faint':'--accent'),sz:d.dir==='.'?30:22}});});
+   /* map → the maps below it, and map → each concept it lists. A listing entry
+      whose node is missing is skipped rather than conjuring a dangling edge. */
+   IXROWS.forEach(d=>(d.subdirs||[]).forEach(sub=>{
+    if(cy.getElementById(IX+sub).length)
+     cy.add({group:'edges',classes:'ixe',data:{id:'ixe::'+d.dir+'>'+sub,source:IX+d.dir,target:IX+sub}});}));
+   IXROWS.forEach(d=>(d.listing||[]).forEach(it=>{
+    if(cy.getElementById(it.id).length)
+     cy.add({group:'edges',classes:'ixe'+(d.synthesized?' ixe-syn':''),data:{id:'ixe::n::'+d.dir+'::'+it.id,source:IX+d.dir,target:it.id}});}));
+  });
+  applyGraphFilter();runLayout(layoutSel.value);});}
+btnIx.onclick=()=>setIxNodes(!ixNodes);
+/* A map whose concepts are all filtered away has nothing left to point at, so it
+   leaves with them — the same rule that keeps emptied area boxes off the canvas.
+   Deepest first, because a parent map survives on a surviving child. */
+function ixVisibility(){if(!ixNodes||!IXROWS.length)return;
+ const depth=d=>d==='.'?0:d.split('/').length;
+ const rows=IXROWS.slice().sort((a,b)=>depth(b.dir)-depth(a.dir));
+ const on={};
+ rows.forEach(d=>{
+  const anyConcept=(d.listing||[]).some(it=>{const n=cy.getElementById(it.id);return n.length&&n.style('display')!=='none';});
+  const anyChild=(d.subdirs||[]).some(sub=>on[sub]);
+  on[d.dir]=anyConcept||anyChild;});
+ rows.forEach(d=>{const n=cy.getElementById(IX+d.dir);if(n.length)n.style('display',on[d.dir]?'element':'none');});}
 /* A reserved file's "Open in graph": switch to the file tree, select its
    folder node, and put the directory's map in the inspector. */
-function openInTree(dir){setView('graph');setTree(true);
- showDir(dir);
- requestAnimationFrame(()=>{const ele=cy.getElementById(DIR+(dir==='.'?'':dir));if(!ele.length)return;
-  cy.elements().removeClass('hl').addClass('dim');ele.closedNeighborhood().removeClass('dim');ele.addClass('hl');
-  centerOn(ele,true);});}
+function openMapInGraph(dir){setView('graph');showDir(dir);
+ /* Already in file-tree mode: that view *is* the map, so focus its folder node
+    and keep the neighbourhood emphasis the mode is for. */
+ if(treeMode){requestAnimationFrame(()=>focusNode(cy.getElementById(DIR+(dir==='.'?'':dir)),true));return;}
+ /* Otherwise switch the *layer* on rather than the mode: the reader asked to see
+    this map in the graph, not to be handed a different graph. The layout they
+    chose survives, and the map is emphasised exactly as a concept would be. */
+ setIxNodes(true).then(()=>focusNode(cy.getElementById(IX+dir),true));}
 
 /* ── fit to screen ── */
 // cy.animate({fit:…}) is a no-op in this Cytoscape build, so compute the target
@@ -1159,7 +1751,13 @@ function relaxZoom(){const bb=fitBox(),w=cy.width(),h=cy.height();
 // and let the handler take every layout after it.
 cy.on('layoutstop',relaxZoom);relaxZoom();
 
-function fitGraph(){relaxZoom();const bb=fitBox();if(!bb)return;
+/* A fit reads the container's own width to compute the zoom, so fitting a hidden
+   0×0 canvas clamps straight to minZoom — and the graph then returns from another
+   view as a few dots in the corner. The boot fit (setTimeout after load, below)
+   is the caller that reaches this hidden: leave the graph inside its 400ms window
+   and it lands on nothing. Skip the fit when the canvas has no size — the graph
+   keeps its last good zoom across the round trip. */
+function fitGraph(){if(!cyEl.clientWidth||!cyEl.clientHeight)return;relaxZoom();const bb=fitBox();if(!bb)return;
  /* padding scales with the canvas — 60px is right on a desktop but eats a third
     of a phone's width */
  const w=cy.width(),h=cy.height(),pad=Math.min(60,Math.max(16,Math.round(w*.06)));
@@ -1182,17 +1780,20 @@ function setView(v){if(v===view)return;view=v;document.getElementById('app').set
  const ph=SEARCH_PH[v];
  if(ph!==undefined){searchInput.placeholder=ph;searchInput.value=q[v]||'';}
  if(v==='graph')requestAnimationFrame(()=>cy.resize());
+ if(v!=='graph')hello2();
  if(v==='catalog'&&!inited.catalog)initCatalog();
  if(v==='files'&&!inited.files)initFiles();
  if(v==='tags'&&!inited.tags)initTags();
- if(v==='stats'&&!inited.stats)initStats();}
+ if(v==='stats'&&!inited.stats)initStats();
+ /* the count and the dead-end offer belong to the view's own query, so they
+    re-decide on every switch — including into a view that has no box at all */
+ bridgeSync();}
 /* The Files view answers to two rail items: Files when the Files tab is up,
    Index when the Indexes tab is — the Index rail item is a shortcut into it. */
-/* Which rail item the page is standing on. "index" is not a view — there is no
-   #view-index — but the files view showing its Indexes tab, so the answer is a
-   question of view *and* tab. Everything that has to name the current place
-   asks here: the rail's own highlight, and the palette's `current` badge. */
-function activeRail(){return view==='files'&&typeof ftab!=='undefined'&&ftab==='indexes'?'index':view;}
+/* Which rail item the page is standing on. It was a question of view *and*
+   tab, back when "index" was a rail item with no #view-index behind it. The
+   tab is gone and so is the pretence: a rail item is a view. */
+function activeRail(){return view;}
 /* And everything that has to *go* somewhere clicks the rail item rather than
    calling setView: Index and Files are one view differing by tab, so setView
    alone lands on whichever tab was last open — and for "index" it lands on a
@@ -1201,18 +1802,77 @@ function activeRail(){return view==='files'&&typeof ftab!=='undefined'&&ftab==='
 function goRail(v){const b=document.querySelector('.rail-item[data-view="'+v+'"]');if(b)b.click();}
 function railActive(){const v=activeRail();
  document.querySelectorAll('.rail-item').forEach(b=>b.classList.toggle('active',b.dataset.view===v));}
-function goIndexes(){if(view!=='files')setView('files');setFtab('indexes');railActive();}
+/* The root map, opened. There is no longer a view to send anyone to instead:
+   index.md is a row in the tree like any other, so "read the index" can only
+   mean the file. */
+function readIndex(){setView('files');openReserved('index','index.md');}
+/* The second beat, and only where it is true: above 768px the rail is on screen
+   and needs no introduction. It fires on *leaving the graph* rather than off the
+   first note's button, so the reader who dismissed that note and found their own
+   way still gets told where the views went. Opening the menu answers it — the
+   reader has demonstrably found ☰, so the note stops asking. */
+function hello2Done(){const h=document.getElementById('hello2');
+ /* only a note on screen can be answered. ☰ is the *only* way off the graph on
+    a compact layout, so the first tap always comes before the note — marking it
+    done there would burn the flag on a hint the reader never saw. */
+ if(h.hidden)return;
+ h.hidden=true;try{localStorage.setItem('okf-hello2','1');}catch(err){}}
+function hello2(){try{
+ if(localStorage.getItem('okf-hello2'))return;
+ if(!matchMedia('(max-width:768px)').matches)return;
+ document.getElementById('hello2').hidden=false;
+}catch(err){}}
+document.getElementById('hello2-x').addEventListener('click',hello2Done);
+/* Index is a shortcut, not a view: it opens the root map exactly as the
+   first-visit note's button does. Keeping it in the rail (and so in the palette,
+   which reads the rail) costs nothing now that `activeRail()` answers with the
+   view it lands on — Files — so nothing has to invent a place for it to be. */
 document.querySelectorAll('.rail-item').forEach(b=>b.onclick=()=>{
- if(b.dataset.view==='index')return goIndexes();
- if(b.dataset.view==='files'&&typeof ftab!=='undefined'&&ftab!=='files'){if(view!=='files')setView('files');setFtab('files');railActive();return;}
+ if(b.dataset.view==='index')return readIndex();
  setView(b.dataset.view);});
-searchInput.oninput=()=>{q[view]=searchInput.value;
- if(view==='graph')applyGraphFilter();else if(view==='catalog')renderCatalog();else if(view==='tags')renderCloud();
- else if(view==='files')refreshTree();};
+/* ── full-text search (MiniSearch, lazy) ──
+   loadScript-loads the pinned build on first focus, then builds one index over
+   FT_FIELDS. combineWith:'AND' + prefix keeps as-you-type search intuitive;
+   fuzzy:0.2 tolerates typos; the boosts mirror the Ruby port's field weights
+   (title>id>tags>type=description>body). Until it is ready — or if the CDN is
+   unreachable — ftMatch returns null and each view keeps its substring filter,
+   so the box is never dead. */
+function loadMiniSearch(){return _MiniSearch||(_MiniSearch=loadScript('https://cdn.jsdelivr.net/npm/minisearch@7.2.0/dist/umd/index.js').then(()=>window.MiniSearch));}
+function buildFtIndex(){return ftIndex?Promise.resolve(ftIndex):(ftBuilding||(ftBuilding=Promise.all([loadMiniSearch(),getCatalog()]).then(([MiniSearch,list])=>{
+ const idx=new MiniSearch({idField:'id',fields:FT_FIELDS,storeFields:['id'],
+  extractField:(doc,f)=>f==='tags'?(doc.tags||[]).join(' '):f==='body'?((EMBED&&EMBED.bodies[doc.id])||''):(doc[f]==null?'':String(doc[f])),
+  searchOptions:{prefix:true,fuzzy:0.2,combineWith:'AND',boost:{title:5,id:4,tags:3,type:2,description:2,body:1}}});
+ idx.addAll(list);ftIndex=idx;
+ if((view==='graph'||view==='catalog'||view==='files')&&(q[view]||'').trim())applySearch();
+ return idx;}).catch(()=>{ftBuilding=null;return null;})));}
+/* The ranked set of ids a query matches, or null → the caller keeps its own
+   substring filter (index not ready, or an empty query that shows everything). */
+function ftMatch(text){const t=(text||'').trim();if(!ftIndex||!t)return null;return new Set(ftIndex.search(t).map(r=>r.id));}
+/* The Indexes tab lists the authored reserved files (log.md + each index.md).
+   Those are not concepts, so they ride in a second small index keyed by path,
+   over each file's path and its body/content — same engine, so the Indexes tab
+   searches full text just like the concept views instead of matching only the
+   filename. Built lazily on the first search while that tab is open. */
+let ftResIndex=null,ftResBuilding=null;
+function buildFtResIndex(){return ftResIndex?Promise.resolve(ftResIndex):(ftResBuilding||(ftResBuilding=Promise.all([loadMiniSearch(),getIndex(),getLogs()]).then(([MiniSearch,dirs,logs])=>{
+ const docs=[];
+ logs.forEach(l=>docs.push({id:'log:'+l.path,path:l.path,text:l.path+' '+(l.content||'')}));
+ dirs.forEach(d=>{if(d.present)docs.push({id:'idx:'+d.index_path,path:d.index_path,text:d.index_path+' '+(d.body||'')});});
+ const idx=new MiniSearch({idField:'id',fields:['path','text'],storeFields:['path'],searchOptions:{prefix:true,fuzzy:0.2,combineWith:'AND',boost:{path:3,text:1}}});
+ idx.addAll(docs);ftResIndex=idx;
+ if(view==='files'&&(q.files||'').trim())refreshTree();
+ return idx;}).catch(()=>{ftResBuilding=null;return null;})));}
+function ftResMatch(text){const t=(text||'').trim();if(!ftResIndex||!t)return null;return new Set(ftResIndex.search(t).map(r=>r.path));}
+function applySearch(){if(view==='graph')applyGraphFilter();else if(view==='catalog')renderCatalog();else if(view==='tags')renderCloud();else if(view==='files')refreshTree();}
+searchInput.oninput=()=>{q[view]=searchInput.value;buildFtIndex();applySearch();};
+searchInput.onfocus=()=>{buildFtIndex();};
 
 /* ── catalog ── */
 let CATALOG=null;
-function getCatalog(){return CATALOG||(CATALOG=EMBED?Promise.resolve(EMBED.catalog):fetch(CATALOG_ENDPOINT).then(r=>r.json()).then(d=>d.concepts));}
+/* Resolves the rich per-concept rows once (inlined under EMBED, fetched live
+   otherwise) and fills descOf on the way, so even the pre-index substring
+   fallback can match a graph node by its leaf description. */
+function getCatalog(){return CATALOG||(CATALOG=(EMBED?Promise.resolve(EMBED.catalog):fetch(CATALOG_ENDPOINT).then(r=>r.json()).then(d=>d.concepts)).then(list=>{list.forEach(c=>{descOf[c.id]=c.description||'';});return list;}));}
 const catActiveTypes=new Set(), catActiveAreas=new Set(), catActiveTags=new Set();
 const catByCount=types.slice().sort((a,b)=>(TYPES[b]||[]).length-(TYPES[a]||[]).length);
 const catChip=t=>`<span class="chip" data-t="${esc(t)}"><span class="dot" style="background:${color[t]}"></span>${esc(t)} <span class="c">${(TYPES[t]||[]).length}</span></span>`;
@@ -1226,9 +1886,9 @@ function wireCatChips(el){el.querySelectorAll('.chip').forEach(ch=>ch.onclick=()
 function renderCatFilters(){const qq=(document.getElementById('cat-filter-search').value||'').trim().toLowerCase();
  const match=v=>!qq||v.toLowerCase().includes(qq);
  const after=()=>{renderCatFilters();renderCatalog();};
- chipRow(document.getElementById('cat-ftypes'),typeItems(catByCount.filter(match)),'data-t','on',t=>catActiveTypes.has(t),t=>{toggleSet(catActiveTypes,t);after();});
- chipRow(document.getElementById('cat-fareas'),areaItems(graphAreas.filter(match)),'data-area','on',a=>catActiveAreas.has(a),a=>{toggleSet(catActiveAreas,a);after();});
- chipRow(document.getElementById('cat-ftags'),tagItems(qq?tagsByCount.filter(match):tagsByCount.slice(0,40)),'data-tag','on',t=>catActiveTags.has(t),t=>{toggleSet(catActiveTags,t);after();});
+ chipRow(document.getElementById('cat-ftypes'),typeItems(catByCount.filter(match)),'data-t',t=>catActiveTypes.has(t),t=>{toggleSet(catActiveTypes,t);after();});
+ chipRow(document.getElementById('cat-fareas'),areaItems(graphAreas.filter(match)),'data-area',a=>catActiveAreas.has(a),a=>{toggleSet(catActiveAreas,a);after();});
+ chipRow(document.getElementById('cat-ftags'),tagItems(qq?tagsByCount.filter(match):tagsByCount.slice(0,40)),'data-tag',t=>catActiveTags.has(t),t=>{toggleSet(catActiveTags,t);after();});
  syncCatChips();}
 function initCatalog(){inited.catalog=true;
  // Only the five most common types get inline chips; everything else — types,
@@ -1242,12 +1902,16 @@ function initCatalog(){inited.catalog=true;
  document.getElementById('cat-filters-reset').onclick=()=>{catActiveTypes.clear();catActiveAreas.clear();catActiveTags.clear();renderCatFilters();renderCatalog();};
  document.getElementById('cat-filter-search').oninput=renderCatFilters;
  getCatalog().then(renderCatalog);}
-function renderCatalog(){if(!CATALOG)return;getCatalog().then(list=>{const s=(q.catalog||'').toLowerCase();
+function renderCatalog(){if(!CATALOG)return;getCatalog().then(list=>{const s=(q.catalog||'').toLowerCase();const ids=ftMatch(q.catalog);
  const rows=list.filter(c=>{if(catActiveTypes.size&&!catActiveTypes.has(c.type))return false;
   if(catActiveAreas.size&&!catActiveAreas.has(areaOf(c.id)))return false;
   if(catActiveTags.size&&!c.tags.some(t=>catActiveTags.has(t)))return false;
+  if(ids)return ids.has(c.id);
   if(s){const hay=(c.title+' '+c.description+' '+c.type+' '+c.tags.join(' ')+' '+c.id).toLowerCase();if(!hay.includes(s))return false;}return true;});
  document.getElementById('cat-cnt').textContent=rows.length+' of '+list.length+' concepts';
+ /* the catalog resolves asynchronously, so it reports its own count rather than
+    being asked for one at a moment it may not have it yet */
+ bridgeReport('catalog',rows.length,list.length);
  const g=document.getElementById('cat-grid');
  if(!rows.length){g.innerHTML='<div class="none">No concepts match — try clearing the filters.</div>';return;}
  g.innerHTML=rows.map(c=>{const cc=color[c.type]||'#64748b';
@@ -1270,44 +1934,134 @@ function initFiles(){inited.files=true;refreshTree();}
    chronological index), then every index.md, root before nested. Reserved
    files come from the /index and /log payloads — they are not concepts, so
    the catalog cannot know them. */
-let IXDIRS=null,LOGPATHS=null,ftab='files';
+let IXDIRS=null,LOGPATHS=null;
+let ixOnly=false;
 const collapsedDirs=new Set();
+let lastFileDirs=[];
+const foldAllBtn=document.getElementById('ftree-foldall');
 function dirOfPath(p){return p.indexOf('/')<0?'.':p.split('/').slice(0,-1).join('/');}
+/* Folding the files list down to its header. Lives out here because the tree
+   itself has a reason to call it: on a compact layout the list is stacked on
+   top of the reader, so a list with nothing left in it should hand the screen
+   back rather than sit there empty. */
+let foldedByRoot=false;
+function treeMin(on){const g=document.querySelector('.files-grid'),b=document.getElementById('ftree-min');
+ if(!g||!b)return;g.classList.toggle('tree-min',on);
+ b.setAttribute('aria-expanded',on?'false':'true');
+ b.setAttribute('aria-label',on?'Expand file list':'Collapse file list');}
+/* Every parent→child step on the way from a directory up to the root. The tree
+   is built from these rather than from the directory names alone, so a folder
+   holding nothing but folders still renders as their parent: `core` has to exist
+   for `core/configurations` to sit inside it, even when no file lives in `core`. */
+function dirParents(dir){const out=[];let d=dir;
+ while(d!=='.'){const p=dirOfPath(d);out.push([ p,d ]);d=p;}
+ return out;}
+/* One reserved row. `label` is what the reader reads: the bare filename when the
+   row sits inside the folder that owns it, the whole path when it stands in for
+   that folder. `data-path` is the real one either way. */
+function resRow(r,depth,label){
+ const icon=r.kind==='index'?'<path d="M4 5h16M4 9.6h10.5M4 14.2h16M4 18.8h7.5"/>':'<circle cx="12" cy="12" r="8.5"/><path d="M12 7.3V12l3.2 2"/>';
+ return `<button class="file res${fileSel===r.path?' sel':''}" data-res="${r.kind}" data-path="${esc(r.path)}" title="${esc(r.path)}" style="--d:${depth}"><span class="fn"><svg class="ricon" viewBox="0 0 24 24">${icon}</svg><span class="rn">${esc(label)}</span><span class="badge-res">${r.kind==='index'?'map':'log'}</span></span></button>`;}
+/* Narrowed to the authored layer, a folder owns exactly one row — so its header
+   is a line of chrome per map, and a reader scrolls twice as far to read half as
+   much. The row stands where the header stood, at the folder's own depth and
+   carrying the path: the flat list the tab used to show, with the nesting still
+   legible in the indent. */
+function flatRes(res){
+ const dirs=Object.keys(res).sort((a,b)=>a==='.'?-1:b==='.'?1:(a<b?-1:1));
+ return dirs.map(d=>{const depth=d==='.'?0:d.split('/').length;
+  return res[d].map(r=>resRow(r,depth,r.path)).join('');}).join('');}
+/* One tree, both layers. The authored files used to live on a second tab as a
+   flat list of paths, which put a directory's own map somewhere other than the
+   directory — the one place a reader looks for it. They are rows now, at the top
+   of the folder they document. */
 function renderTree(list){const s=(q.files||'').toLowerCase();
  const el=document.getElementById('ftree-list');
- if(ftab==='indexes'){
-  const reserved=[];
-  (LOGPATHS||[]).forEach(p=>{if(!s||p.toLowerCase().includes(s))reserved.push({kind:'log',path:p});});
-  (IXDIRS||[]).forEach(d=>{if(d.present&&(!s||d.index_path.toLowerCase().includes(s)))reserved.push({kind:'index',path:d.index_path});});
-  const rank=r=>[ r.kind==='log'?0:1, r.path.indexOf('/')<0?0:1, r.path ];
-  reserved.sort((a,b)=>{const x=rank(a),y=rank(b);return (x[0]-y[0])||(x[1]-y[1])||(x[2]<y[2]?-1:1);});
-  if(!reserved.length){el.innerHTML='<p class="empty" style="padding:14px">No index.md or log.md files'+(s?' match.':' yet.')+'</p>';return;}
-  el.innerHTML=reserved.map(r=>{
-   const icon=r.kind==='index'?'<path d="M4 5h16M4 9.6h10.5M4 14.2h16M4 18.8h7.5"/>':'<circle cx="12" cy="12" r="8.5"/><path d="M12 7.3V12l3.2 2"/>';
-   return `<button class="file res${fileSel===r.path?' sel':''}" data-res="${r.kind}" data-path="${esc(r.path)}" title="${esc(r.path)}"><span class="fn"><svg class="ricon" viewBox="0 0 24 24">${icon}</svg><span class="rn">${esc(r.path)}</span><span class="badge-res">${r.kind==='index'?'map':'log'}</span></span></button>`;}).join('');
+ const ft=fileTypeCombo.get(), fg=fileTagCombo.get();const ids=ftMatch(q.files);
+ const rows=ixOnly?[]:list.filter(c=>(!ft||c.type===ft)&&(!fg||c.tags.indexOf(fg)>=0)&&(ids?ids.has(c.id):(!s||(c.title+' '+c.id+' '+c.description).toLowerCase().includes(s))));
+ /* Reserved files carry neither a type nor tags, so either combo filtering is
+    a statement about concepts and they step aside for it. */
+ const res={};let resCount=0;
+ if(!ft&&!fg){
+  if((q.files||'').trim())buildFtResIndex();
+  const rset=ftResMatch(q.files);
+  const keep=p=>rset?rset.has(p):(!s||p.toLowerCase().includes(s));
+  (IXDIRS||[]).forEach(d=>{if(d.present&&keep(d.index_path))(res[d.dir]=res[d.dir]||[]).push({kind:'index',path:d.index_path});});
+  (LOGPATHS||[]).forEach(p=>{if(keep(p))(res[dirOfPath(p)]=res[dirOfPath(p)]||[]).push({kind:'log',path:p});});
+  Object.keys(res).forEach(d=>{res[d].sort((a,b)=>a.kind===b.kind?0:(a.kind==='index'?-1:1));resCount+=res[d].length;});
+ }
+ /* Reported here rather than at the end, because the ixOnly branch below
+    returns early — and a count that skips a mode is worse than no count. The
+    tree's rows are concepts *plus* the reserved files, so the total is too. */
+ bridgeReport('files',rows.length+resCount,(ixOnly?0:NODES.length)+(IXDIRS||[]).filter(d=>d.present).length+(LOGPATHS||[]).length);
+ if(ixOnly){el.innerHTML=flatRes(res)||'<p class="empty" style="padding:14px">No index.md or log.md files'+(s?' match.':' yet.')+'</p>';
+  lastFileDirs=[];syncFoldAll();
   el.querySelectorAll('.file[data-res]').forEach(b=>b.onclick=()=>openReserved(b.dataset.res,b.dataset.path));
   return;}
- const ft=fileTypeCombo.get(), fg=fileTagCombo.get();
- const rows=list.filter(c=>(!ft||c.type===ft)&&(!fg||c.tags.indexOf(fg)>=0)&&(!s||(c.title+' '+c.id+' '+c.description).toLowerCase().includes(s)));
  const groups={};rows.forEach(c=>{(groups[c.dir]=groups[c.dir]||[]).push(c);});
- const dirs=Object.keys(groups).sort();
- if(!dirs.length){el.innerHTML='<p class="empty" style="padding:14px">No files match.</p>';return;}
- const filtering=!!(s||ft||fg);
- el.innerHTML=dirs.map(dir=>{
-  const closed=!filtering&&collapsedDirs.has(dir);
-  const head=`<button class="ffolder${closed?' closed':''}" data-dir="${esc(dir)}"><svg class="chev" viewBox="0 0 24 24"><path d="m6 9 6 6 6-6"/></svg>${dir==='.'?'(root)':esc(dir)+'/'}</button>`;
+ /* Directories nest. A sorted list of full paths made `core` and
+    `core/configurations` siblings, which reads as two unrelated folders instead
+    of a parent and its child — and left the depth of a bundle invisible. */
+ const kids={};
+ Object.keys(groups).concat(Object.keys(res)).forEach(d=>dirParents(d).forEach(pair=>{
+  const set=kids[pair[0]]=kids[pair[0]]||[];if(set.indexOf(pair[1])<0)set.push(pair[1]);}));
+ Object.keys(kids).forEach(k=>kids[k].sort());
+ /* The fold controls read every folder in the tree, not just the ones on screen:
+    computed from the walk itself, "collapse all" stays reversible after the root
+    closes and hides the rest. */
+ const dirs=[];(function walk(d){dirs.push(d);(kids[d]||[]).forEach(walk);})('.');
+ lastFileDirs=dirs;syncFoldAll();
+ if(!rows.length&&!resCount){el.innerHTML='<p class="empty" style="padding:14px">'+
+  (ixOnly?('No index.md or log.md files'+(s?' match.':' yet.')):'No files match.')+'</p>';return;}
+ /* A directory's own map and log, above the folders and files they cover. */
+ function resIn(dir,depth){return (res[dir]||[]).map(r=>resRow(r,depth,r.path.split('/').pop())).join('');}
+ /* Collapse is honored whether or not a search is active — a search that force-
+    expanded every folder left the fold clicks dead. A folder that matches still
+    shows its header, so a collapsed group is never a hidden match. Closing a
+    folder now takes its subtree with it, because the subtree renders from inside. */
+ function subtree(dir,depth){
+  const closed=collapsedDirs.has(dir);
+  const name=dir==='.'?esc(BUNDLE):esc(dir.split('/').pop())+'/';
+  const head=`<button class="ffolder${closed?' closed':''}${dir==='.'?' root':''}" data-dir="${esc(dir)}" style="--d:${depth}"><svg class="chev" viewBox="0 0 24 24"><path d="m6 9 6 6 6-6"/></svg><span>${name}</span></button>`;
   if(closed)return head;
-  return head+(groups[dir]||[]).map(c=>{const cc=color[c.type]||'#64748b';const name=c.id.split('/').pop()+'.md';
-   return `<button class="file${fileSel===c.id?' sel':''}" data-id="${esc(c.id)}"><span class="fn"><span class="dot" style="background:${cc}"></span>${esc(name)}</span>${c.description?`<span class="fd">${esc(c.description)}</span>`:''}</button>`;}).join('');}).join('');
+  return head
+   +resIn(dir,depth+1)
+   +(kids[dir]||[]).map(k=>subtree(k,depth+1)).join('')
+   +(groups[dir]||[]).map(c=>{const cc=color[c.type]||'#64748b';const fname=c.id.split('/').pop()+'.md';
+     return `<button class="file${fileSel===c.id?' sel':''}" data-id="${esc(c.id)}" style="--d:${depth+1}"><span class="fn"><span class="dot" style="background:${cc}"></span>${esc(fname)}</span>${c.description?`<span class="fd">${esc(c.description)}</span>`:''}</button>`;}).join('');}
+ el.innerHTML=subtree('.',0);
  el.querySelectorAll('.ffolder').forEach(b=>b.onclick=()=>{const d=b.dataset.dir;
-  if(collapsedDirs.has(d))collapsedDirs.delete(d);else collapsedDirs.add(d);renderTree(list);});
- el.querySelectorAll('.file[data-id]').forEach(b=>b.onclick=()=>openFile(b.dataset.id,list));}
-function setFtab(t){if(ftab===t)return;
- ftab=t;document.getElementById('app').setAttribute('data-ftab',t);
- [ 'files','indexes' ].forEach(x=>{const b=document.getElementById('ftab-'+x);
-  b.classList.toggle('active',x===t);b.setAttribute('aria-selected',String(x===t));});
- railActive();refreshTree();}
-[ 'files','indexes' ].forEach(t=>{document.getElementById('ftab-'+t).onclick=()=>setFtab(t);});
+  if(collapsedDirs.has(d))collapsedDirs.delete(d);else collapsedDirs.add(d);renderTree(list);
+  /* Closing the root leaves a single row above a column of nothing, so on a
+     compact layout the list hands the screen back. Remember *why*: reopening it
+     has to undo the collapse, or the reader lands on one row with the button
+     they just used unable to bring the tree back. */
+  if(d==='.'&&collapsedDirs.has('.')&&matchMedia('(max-width:768px)').matches){foldedByRoot=true;treeMin(true);}});
+ el.querySelectorAll('.file[data-id]').forEach(b=>b.onclick=()=>openFile(b.dataset.id,list));
+ el.querySelectorAll('.file[data-res]').forEach(b=>b.onclick=()=>openReserved(b.dataset.res,b.dataset.path));}
+/* Fold/unfold every folder at once. When they are all already collapsed the
+   button expands them; otherwise it collapses them.
+   The root is not one of them. Folding it answers "collapse all" with a lone
+   `(root)` row and hides the top-level folders — the one thing a reader wants
+   left standing after collapsing everything — so the control folds everything
+   *inside* the root and opens the root itself. Unfolding clears the whole set,
+   root included, so a root closed by hand is still reversible from here. */
+function foldable(){return lastFileDirs.filter(d=>d!=='.');}
+function syncFoldAll(){const d=foldable(),all=d.length>0&&d.every(x=>collapsedDirs.has(x));
+ foldAllBtn.classList.toggle('all-closed',all);foldAllBtn.disabled=d.length===0;
+ const lbl=all?'Expand all folders':'Collapse all folders';foldAllBtn.title=lbl;foldAllBtn.setAttribute('aria-label',lbl);}
+foldAllBtn.onclick=()=>{const d=foldable();if(!d.length)return;
+ if(d.every(x=>collapsedDirs.has(x)))collapsedDirs.clear();
+ else{d.forEach(x=>collapsedDirs.add(x));collapsedDirs.delete('.');}
+ refreshTree();};
+/* What the Indexes tab did, as a filter over the same tree: same rows, fewer of
+   them, the structure they sit in intact. Opening a reserved file releases it —
+   a reader who has arrived somewhere should not have to undo a filter to see
+   where they are. */
+const ixBtn=document.getElementById('ftree-ixonly');
+function setIxOnly(on){if(ixOnly===on)return;
+ ixOnly=on;ixBtn.setAttribute('aria-pressed',String(on));refreshTree();}
+ixBtn.onclick=()=>setIxOnly(!ixOnly);
 /* Searchable single-select combobox (keyboard-navigable) — one per files filter:
    type and tag. `items` is lazy so counts always reflect the current indexes. */
 function makeCombo(name,allLabel,items,onChange){
@@ -1337,27 +2091,42 @@ function makeCombo(name,allLabel,items,onChange){
 const refreshTree=()=>{ctlBadge();return Promise.all([ getCatalog(),getIndex(),getLogs() ]).then(([ list,dirs,logs ])=>{IXDIRS=dirs;LOGPATHS=logs.map(l=>l.path);renderTree(list);});};
 const fileTypeCombo=makeCombo('file-type','All types',()=>catByCount.map(t=>({v:t,n:(TYPES[t]||[]).length,c:color[t]})),refreshTree);
 const fileTagCombo=makeCombo('file-tag','All tags',()=>tagsByCount.map(t=>({v:t,n:(TAGS[t]||[]).length})),refreshTree);
-function openFile(id,list){fileSel=id;const c=(list||[]).find(x=>x.id===id)||byId[id]||{};
- setFtab('files');
+/* The reader's graph button. One label for every file: the question is the same
+   whatever is open — where is this in the graph? — and wording it per file made
+   one action read as three. Only the destination differs, so only that is passed.
+   The label itself lives in the markup, where it cannot go stale. */
+function fpGraph(go){const fg=document.getElementById('fp-graph');fg.hidden=false;fg.onclick=go;}
+function openFile(id,list){fileSel=id;
+ /* A concept cannot appear in an Indexes-only list, so opening one releases the
+    filter that would hide it — otherwise the reader's selection is invisible and
+    they lose their place. Opening a *map* does not release it: that row is right
+    there in the list, and dropping a filter the reader set is not a click's
+    business. The rule is the filter yields only when it would hide what was just
+    opened. */
+ if(ixOnly)setIxOnly(false);
+ const c=(list||[]).find(x=>x.id===id)||byId[id]||{};
  document.querySelectorAll('.file').forEach(b=>b.classList.toggle('sel',b.dataset.id===id));
  const ty=c.type||typeOf[id]||'Untyped';const cc=color[ty]||'#64748b';
  document.getElementById('fp-head').hidden=false;
  document.getElementById('fp-type').innerHTML=`<span class="dot" style="background:${cc}"></span>${esc(ty)}`;
  document.getElementById('fp-title').textContent=c.title||(byId[id]||{}).title||id;
- document.getElementById('fp-graph').hidden=false;
- document.getElementById('fp-graph').onclick=()=>goToGraph(id);
+ fpGraph(()=>goToGraph(id));
  const body=document.getElementById('fp-body');body.innerHTML='<p class="loading">loading…</p>';
  getNodeBody(id).then(txt=>{
   const wrap=document.createElement('div');wrap.className='body';renderMarkdown(wrap,txt);body.innerHTML='';body.appendChild(wrap);}).catch(()=>{body.innerHTML='<p class="empty">could not load this file</p>';});}
 /* Reserved files read in the preview too: the index map from its payload, the
    log fetched fresh on every click so a just-appended entry shows. */
 function openReserved(kind,path){fileSel=path;
- setFtab('indexes');
  document.querySelectorAll('.file').forEach(b=>b.classList.toggle('sel',b.dataset.path===path));
  document.getElementById('fp-head').hidden=false;
  document.getElementById('fp-title').textContent=path;
- const fg=document.getElementById('fp-graph');
- fg.hidden=false;fg.onclick=()=>openInTree(dirOfPath(path));
+ const d=dirOfPath(path);
+ /* A log is a chronology, not a place in the graph, so the button is not shown
+    at all — hidden rather than disabled, because it is never applicable here, not
+    merely unavailable now. It was worse than useless: a log's directory is the
+    root, so it opened the *root index's* node. */
+ if(kind==='index')fpGraph(()=>openMapInGraph(d));
+ else document.getElementById('fp-graph').hidden=true;
  const type=document.getElementById('fp-type');
  const body=document.getElementById('fp-body');body.innerHTML='<p class="loading">loading…</p>';
  const done=txt=>{const wrap=document.createElement('div');wrap.className='body';renderMarkdown(wrap,txt);body.innerHTML='';body.appendChild(wrap);};
@@ -1376,8 +2145,8 @@ const tagSel=new Set(), tagTypes=new Set(), tagAreas=new Set();
 function tagMatch(id){return (tagTypes.size===0||tagTypes.has(typeOf[id]||'Untyped'))&&(tagAreas.size===0||tagAreas.has(areaOf(id)));}
 function renderTagChips(){
  const after=()=>{renderTagChips();renderCloud();};
- chipRow(document.getElementById('tag-ftypes'),typeItems(types),'data-t','on',t=>tagTypes.has(t),t=>{toggleSet(tagTypes,t);after();});
- chipRow(document.getElementById('tag-fareas'),areaItems(graphAreas),'data-area','on',a=>tagAreas.has(a),a=>{toggleSet(tagAreas,a);after();});
+ chipRow(document.getElementById('tag-ftypes'),typeItems(types),'data-t',t=>tagTypes.has(t),t=>{toggleSet(tagTypes,t);after();});
+ chipRow(document.getElementById('tag-fareas'),areaItems(graphAreas),'data-area',a=>tagAreas.has(a),a=>{toggleSet(tagAreas,a);after();});
  const n=tagTypes.size+tagAreas.size;const b=document.getElementById('tag-filters-btn');
  b.classList.toggle('on-filter',n>0);b.querySelector('.fbadge').textContent=n;}
 function initTags(){inited.tags=true;
@@ -1450,20 +2219,37 @@ function listingHtml(items){if(!items||!items.length)return '<p class="empty" st
 let LOGS=null;
 function getLogs(){return LOGS||(LOGS=EMBED?Promise.resolve(EMBED.logs):fetch(LOG_ENDPOINT).then(r=>r.json()).then(d=>d.logs));}
 
-/* ── command palette: jump to a view always, and to a sibling bundle when a hub
-   is serving one. It began as the bundle switcher, gated on HUB_PATH — which
-   meant ⌘K did not exist at all under a standalone `okf server` or in `okf
-   render` output, the two modes most people meet first. Views are what earn the
-   palette a place in every mode; bundles are the group that comes and goes.
-   The two are grouped rather than merged because the actions differ: a view is
+/* ── command palette: jump to a view always, to a sibling bundle when a hub is
+   serving one, and to any concept in any hosted bundle when that hub answers
+   /search. It began as the bundle switcher, gated on HUB_PATH — which meant ⌘K
+   did not exist at all under a standalone `okf server` or in `okf render`
+   output, the two modes most people meet first. Views are what earn the palette
+   a place in every mode; bundles and concepts are the groups that come and go.
+   The three are grouped rather than merged because the actions differ: a view is
    in-page and instant, a bundle is a page load that carries the view and layout
-   across and deliberately drops the selected node. ── */
+   across and deliberately drops the selected node, and a concept is the opposite
+   of that — it is *only* a node, so it carries ?select= and nothing else.
+
+   Concepts come last, and not because they matter least. They are the one group
+   that arrives asynchronously, and a group that lands above the cursor moves the
+   row under the user's fingers between the keystroke and the Enter. Last means
+   results can only ever appear below what is already selected. ── */
+/* The palette's one door from outside its IIFE. `var`, so the bridge below can
+   guard on it before this section has run; assigned at the end of the IIFE, so
+   nothing can open a palette that is only half-wired. */
+var openPalette=null;
 (function(){
  const ov=document.getElementById('sw'),input=document.getElementById('sw-input'),list=document.getElementById('sw-list');
  const isMac=/Mac|iP/.test(navigator.platform||'');
  const layout0=layoutSel?layoutSel.value:null;
  const HUB=HUB_PATH!==null;
+ /* Only a hub can answer about every bundle at once, so this is null on a
+    standalone server and in a static file — and there the group never exists. */
+ const FINDS=SEARCH_ENDPOINT!==null;
  let active=0,lastFocus=null;
+ /* the Concepts group's state: the rows, what the whole answer counted, the
+    terms they came from (for the marks), and where the request is up to */
+ let hits=[],hitTotal=0,hitTerms=[],hitState='',hitSeq=0,hitTimer=null;
  /* The rail is the source of truth for which views exist, so read it back
     rather than keeping a second list here that a new view could fall out of. */
  const VIEWS=[ ...document.querySelectorAll('.rail-item[data-view]') ].map(b=>{
@@ -1487,6 +2273,25 @@ function getLogs(){return LOGS||(LOGS=EMBED?Promise.resolve(EMBED.logs):fetch(LO
   const qs=ps.toString();return qs?p+'?'+qs:p;}
  const grp=t=>`<li class="sw-grp">${t}</li>`;
  const opt=(i,inner)=>`<a ${inner.attrs} id="sw-opt-${i}" role="option" class="${(i===active?'active':'')+(inner.cls||'')}">${inner.html}</a>`;
+ const note=t=>`<a class="none"><span>${t}</span></a>`;
+ /* Mark the typed terms where they landed — the only thing on a hit row that
+    says *why* it is here. Built by splitting the raw text and escaping each
+    piece, never by wrapping tags around already-escaped text: a term like "amp"
+    would otherwise cut an entity in half and put a <mark> inside it. */
+ const rxEsc=t=>t.replace(/[.*+?^${}()|[\]\\]/g,'\\$&');
+ function hilite(text,terms){const s=text==null?'':String(text);
+  if(!terms.length)return esc(s);
+  const rx=new RegExp('('+terms.map(rxEsc).join('|')+')','ig');
+  return s.split(rx).map((part,i)=>i%2?`<mark>${esc(part)}</mark>`:esc(part)).join('');}
+ /* A hit names a node, so its URL carries ?select= and nothing else — the view
+    and layout a bundle switch preserves are exactly what a node has to override.
+    A hit in *this* bundle is not a navigation at all; go() selects it in place
+    and this href only exists for ⌘-click, where a second tab is the point. */
+ const hitHref=c=>(c.slug===SELF_SLUG?'':'../'+encodeURIComponent(c.slug)+'/')+'?select='+encodeURIComponent(c.id);
+ const hitHtml=c=>`<span class="hit-top"><span class="hit-t">${hilite(c.title||c.id,hitTerms)}</span>`+
+  (c.type?`<span class="hit-type">${esc(c.type)}</span>`:'')+
+  `<span class="slug">${esc(c.slug)}</span></span>`+
+  (c.snippet?`<span class="hit-s">${hilite(c.snippet,hitTerms)}</span>`:'');
  /* Bundles lead, and on an empty box they are the only thing here: switching
     bundles is what the palette is for, and six views above them would push the
     answer below the fold to advertise a convenience. So views wait until what
@@ -1499,9 +2304,11 @@ function getLogs(){return LOGS||(LOGS=EMBED?Promise.resolve(EMBED.logs):fetch(LO
  function render(qs){const q=(qs||'').trim().toLowerCase();
   const bs=matchBundles(q);
   const vs=(q||!HUB)?matchViews(q):[];
+  const showC=FINDS&&!!q;
+  const cs=showC?hits:[];
   const showB=HUB&&(bs.length||!q);
-  const heads=showB&&vs.length>0;
-  active=Math.min(active,Math.max(0,bs.length+vs.length-1));
+  const heads=(showB?1:0)+(vs.length?1:0)+(showC?1:0)>1;
+  active=Math.min(active,Math.max(0,bs.length+vs.length+cs.length-1));
   let h='';
   if(showB){
    if(heads)h+=grp('Bundles');
@@ -1518,9 +2325,21 @@ function getLogs(){return LOGS||(LOGS=EMBED?Promise.resolve(EMBED.logs):fetch(LO
     attrs:`data-view="${esc(x.v)}"`,
     html:`<span class="sw-ico">${x.icon}</span><span>${esc(x.label)}${x.v===activeRail()?'<span class="sw-def">current</span>':''}</span>`})).join('');
   }
+  if(showC){
+   if(heads)h+=grp('Concepts');
+   h+=cs.map((c,i)=>opt(bs.length+vs.length+i,{
+    cls:' sw-hit',
+    attrs:`href="${esc(hitHref(c))}" data-hit="${esc(c.id)}" data-slug="${esc(c.slug)}"`,
+    html:hitHtml(c)})).join('');
+   /* The cap is reported, never silent: a palette that shows 50 of 214 and says
+      nothing has told the reader the answer is complete. */
+   if(hitTotal>cs.length&&cs.length)h+=note(`showing ${cs.length} of ${hitTotal} matches — narrow the search`);
+   if(!cs.length)h+=note(hitState==='error'?'search is unavailable right now':
+    hitState==='done'?'no concepts match':'searching every bundle…');
+  }
   if(!h)h='<a class="none"><span>no matches</span></a>';
   list.innerHTML=h;mark();}
- const items=()=>[ ...list.querySelectorAll('a[data-view],a[data-path]') ];
+ const items=()=>[ ...list.querySelectorAll('a[data-view],a[data-path],a[data-hit]') ];
  function mark(){const its=items();
   its.forEach((a,i)=>a.classList.toggle('active',i===active));
   input.setAttribute('aria-activedescendant',its[active]?its[active].id:'');
@@ -1528,16 +2347,47 @@ function getLogs(){return LOGS||(LOGS=EMBED?Promise.resolve(EMBED.logs):fetch(LO
  /* Unhide before rendering: mark() scrolls the active row into view, and a list
     still display:none measures zero, so the scroll lands somewhere arbitrary
     and takes the first group's header off the top of the box with it. */
- function open(){discovered();lastFocus=document.activeElement;active=0;input.value='';ov.hidden=false;render('');input.setAttribute('aria-expanded','true');input.focus();}
+ /* `prefill` seeds the box and fires the concept search in the same breath: the
+    bridge under the topbar search hands its dead-end query over through this,
+    and a reader who has already typed the word must not have to type it twice. */
+ function open(prefill){const pq=prefill==null?'':String(prefill);
+  discovered();lastFocus=document.activeElement;active=0;input.value=pq;
+  hits=[];hitTotal=0;hitTerms=[];hitState='';hitSeq++;clearTimeout(hitTimer);
+  ov.hidden=false;if(pq)findLater(pq);render(pq);input.setAttribute('aria-expanded','true');input.focus();}
  function close(){ov.hidden=true;input.setAttribute('aria-expanded','false');if(lastFocus&&lastFocus.focus)lastFocus.focus();}
  /* A view switches in place, so it ignores the new-tab chord — opening this same
     bundle again in a second tab is not what ⌘⏎ was asked for. A bundle is a real
     navigation and honours it. */
  function go(a,newTab){if(!a)return;
   const v=a.dataset.view;if(v){goRail(v);close();return;}
+  const id=a.dataset.hit;
+  /* A concept in this bundle is already loaded — selecting it in place keeps the
+     camera, the filters and the layout the reader built. Only a hit in another
+     bundle is worth a page load. */
+  if(id!==undefined){const t=a.getAttribute('href');
+   if(newTab){window.open(t,'_blank');close();return;}
+   if(a.dataset.slug===SELF_SLUG){close();goToGraph(id);return;}
+   location.href=t;return;}
   const p=a.dataset.path;if(!p)return;const t=target(p);
   if(newTab){window.open(t,'_blank');close();}else{location.href=t;}}
- input.addEventListener('input',()=>{active=0;render(input.value);});
+ /* The Concepts group is the one that costs a request, so it is debounced and
+    sequenced: only the newest answer may land, and a slow one that lost the race
+    is dropped rather than overwriting what the reader is looking at now. */
+ function findLater(q){clearTimeout(hitTimer);
+  const t=q.trim();
+  hitSeq++;
+  if(!FINDS||!t){hits=[];hitTotal=0;hitTerms=[];hitState='';return;}
+  hitState='searching';
+  hitTimer=setTimeout(()=>find(t),150);}
+ function find(t){const mine=hitSeq;
+  fetch(SEARCH_ENDPOINT+'?q='+encodeURIComponent(t))
+   .then(r=>r.ok?r.json():Promise.reject(new Error('search '+r.status)))
+   .then(d=>{if(mine!==hitSeq)return;
+    hits=d.results||[];hitTotal=d.total===undefined?hits.length:d.total;
+    hitTerms=t.split(/\s+/).filter(Boolean);hitState='done';render(input.value);})
+   .catch(()=>{if(mine!==hitSeq)return;
+    hits=[];hitTotal=0;hitTerms=[];hitState='error';render(input.value);});}
+ input.addEventListener('input',()=>{active=0;findLater(input.value);render(input.value);});
  input.addEventListener('keydown',e=>{const its=items();
   if(e.key==='ArrowDown'){e.preventDefault();active=Math.min(its.length-1,active+1);}
   else if(e.key==='ArrowUp'){e.preventDefault();active=Math.max(0,active-1);}
@@ -1545,7 +2395,7 @@ function getLogs(){return LOGS||(LOGS=EMBED?Promise.resolve(EMBED.logs):fetch(LO
   else if(e.key==='Escape'){e.preventDefault();close();return;}
   else return;
   mark();});
- list.addEventListener('click',e=>{const a=e.target.closest('a[data-path]');if(!a)return;
+ list.addEventListener('click',e=>{const a=e.target.closest('a[data-path],a[data-hit]');if(!a)return;
   if(e.metaKey||e.ctrlKey||e.shiftKey||e.altKey)return; /* let the browser handle its own new-tab/window conventions */
   e.preventDefault();go(a,false);});
  ov.addEventListener('mousedown',e=>{if(e.target===ov)close();});
@@ -1556,21 +2406,24 @@ function getLogs(){return LOGS||(LOGS=EMBED?Promise.resolve(EMBED.logs):fetch(LO
     mode can actually do, since a standalone bundle has no bundle to switch to
     and no second tab to open one in. */
  const chord=isMac?'⌘K':'Ctrl-K';
- /* Every label names the mode's primary job and nothing else. Under a hub that
-    is switching bundles — the placeholder trails "or a view" only because a
-    convenience nobody can find is not one, and that is the whole billing views
-    get. Standalone has no bundles, so there the view is the job. */
- const label=HUB?'Switch bundle':'Jump to a view';
- input.placeholder=HUB?'switch bundle, or type a view…':'jump to a view…';
+ /* Every label names the mode's primary job and nothing else. Where the hub
+    answers /search that job is finding a concept — you type words, not names —
+    and switching bundles becomes the second billing. Where it does not, the job
+    is switching bundles. Standalone has neither, so there the view is the job.
+    The ⇄ button keeps the bundle wording in every mode: it draws a swap, and a
+    control whose tooltip disagrees with its icon teaches the wrong thing. */
+ const label=FINDS?'Search all bundles':HUB?'Switch bundle':'Jump to a view';
+ const btnLabel=HUB?'Switch bundle':label;
+ input.placeholder=FINDS?'search concepts, switch bundle, or a view…':HUB?'switch bundle, or type a view…':'jump to a view…';
  input.setAttribute('aria-label',label);
- ov.setAttribute('aria-label',HUB?'Switch bundle':'Command palette');
+ ov.setAttribute('aria-label',FINDS?label:HUB?'Switch bundle':'Command palette');
  document.getElementById('sw-hint').textContent='↑↓ move · ⏎ open · '+(HUB?(isMac?'⌘⏎':'Ctrl-⏎')+' new tab · ':'')+'Esc close';
  const gh=document.querySelector('.ghint');
- if(gh)gh.textContent+=' · '+chord+(HUB?' switches bundle':' jumps to a view');
+ if(gh)gh.textContent+=' · '+chord+(FINDS?' (or the chip in the search box) searches every bundle':HUB?' switches bundle':' jumps to a view');
  /* the ⇄ button is bundle-swap in both icon and meaning, so it stays with the
     bundles — a standalone page reaches the palette by the chord and the hint */
  const btn=document.getElementById('btn-switch');
- if(btn&&HUB){btn.hidden=false;btn.title=label+' ('+chord+')';btn.setAttribute('aria-label',label+' ('+chord+')');
+ if(btn&&HUB){btn.hidden=false;btn.title=btnLabel+' ('+chord+')';btn.setAttribute('aria-label',btnLabel+' ('+chord+')');
   btn.addEventListener('click',()=>{ov.hidden?open():close();});}
  /* the pulse badge (and its hamburger-dot mirror on mobile) exists to get the
     switcher discovered — once the palette has been opened it has done its job,
@@ -1585,6 +2438,511 @@ function getLogs(){return LOGS||(LOGS=EMBED?Promise.resolve(EMBED.logs):fetch(LO
   if(dot&&SIBLINGS.length)dot.hidden=false;
  }
  function discovered(){if(cnt)cnt.hidden=true;if(dot)dot.hidden=true;try{localStorage.setItem('okf-swseen','1');}catch(err){}}
+ openPalette=open;
+})();
+
+/* ── the search bridge: the topbar box, told to stop pretending ──────────────
+   The box and the palette look alike and mean different things — the box
+   filters what is on screen, the palette finds across every bundle a hub hosts
+   — and the box carried neither fact. It said "search concepts…", emptied the
+   graph in silence when nothing matched, and never mentioned the palette. A
+   reader whose word lived in another bundle got a blank canvas and no exit.
+
+   Three additions, all inside the box:
+
+     the chip   names the palette where the disappointment happens, and opens it
+     the count  makes an empty result a number that reached zero, not a view
+                that went blank — the difference between "nothing here" and
+                "something broke"
+     the panel  on zero, says which bundle and which query came up empty, and
+                offers the way on (a hub) or the way back (anywhere else)
+
+   Counts come from two directions because the views do. The graph has already
+   decided by the time `applyGraphFilter` returns, so its count is read live off
+   Cytoscape with that function's own skip predicate. The catalog and the tree
+   resolve asynchronously, so they report from inside their own render — asking
+   them would read whatever the last fetch happened to leave behind.
+
+   The bridge fires rarely, and that is fine: the box's MiniSearch reaches full
+   bodies wherever the page holds them, so most real words match *something*
+   locally. It is the dead-end case that needs an exit, not the common one. ── */
+var bridge=null;
+/* Hoisted `function`s called from applyGraphFilter and renderTree, which are
+   defined far above this and could run before it — both guard on `bridge`. */
+function bridgeSync(){if(bridge)bridge.sync();}
+function bridgeReport(v,shown,total){if(bridge)bridge.report(v,shown,total);}
+(function(){
+ const label=document.querySelector('#search-wrap .search');
+ const cntEl=document.getElementById('s-cnt'),chip=document.getElementById('s-cmdk'),panel=document.getElementById('s-bridge');
+ if(!label||!cntEl||!chip||!panel)return;
+ const msgEl=panel.querySelector('.sb-msg'),goBtn=document.getElementById('sb-go'),clearBtn=document.getElementById('sb-clear');
+ const isMac=/Mac|iP/.test(navigator.platform||'');
+ const chord=isMac?'⌘K':'Ctrl-K';
+ chip.textContent=chord;
+ /* Only a hub can answer about every bundle, so only there is there anywhere to
+    escalate to. Everywhere else the panel still earns its place: it names the
+    dead end the blank canvas used to leave unexplained. */
+ const FINDS=SEARCH_ENDPOINT!==null;
+ const chipLbl=(FINDS?'Search every bundle':'Open the command palette')+' ('+chord+')';
+ chip.title=chipLbl;chip.setAttribute('aria-label',chipLbl);
+ goBtn.hidden=!FINDS;
+ /* The bundle's own name, as the topbar already says it — the ident's first
+    child is the name, before the concepts/links muted span. */
+ const identEl=document.querySelector('#topbar .ident');
+ const IDENT=identEl&&identEl.firstChild?identEl.firstChild.textContent.trim():(BUNDLE||'this bundle');
+
+ const last={};
+ /* The same skip predicate applyGraphFilter uses — parents, folder nodes and
+    map nodes are furniture, not concepts, and counting them would make the
+    denominator disagree with the graph the reader is looking at. */
+ function graphCounts(){let shown=0,total=0;
+  cy.nodes().forEach(n=>{if(n.isParent()||n.hasClass('dir')||n.hasClass('ix'))return;
+   total++;if(n.style('display')!=='none')shown++;});
+  return [ shown,total ];}
+ function sync(){
+  /* SEARCH_PH is the table of which views have a box at all; of those, tags
+     counts nothing (its cloud is not a list of concepts), so it is named out. */
+  const counted=SEARCH_PH[view]!==undefined&&view!=='tags';
+  const qs=(q[view]||'').trim();
+  let shown=null,total=null;
+  if(counted){const c=view==='graph'?graphCounts():last[view];if(c){shown=c[0];total=c[1];}}
+  const showCnt=counted&&!!qs&&shown!==null;
+  cntEl.hidden=!showCnt;if(showCnt)cntEl.textContent=shown+'/'+total;
+  label.classList.toggle('has-cnt',showCnt);
+  const zero=showCnt&&shown===0;
+  if(zero)msgEl.innerHTML='No matches in <b>'+esc(IDENT)+'</b> for “'+esc(qs)+'”';
+  panel.hidden=!zero;}
+ bridge={sync:sync,report:function(v,shown,total){last[v]=[ shown,total ];if(v===view)sync();}};
+
+ function clearBox(){searchInput.value='';q[view]='';applySearch();sync();}
+ function toPalette(){const qs=(q[view]||'').trim();panel.hidden=true;if(openPalette)openPalette(qs);}
+ /* A chip inside a <label> hands its click's focus to the input, which would
+    fight the palette for the cursor — swallow the mousedown, keep the click. */
+ chip.addEventListener('mousedown',e=>e.preventDefault());
+ chip.addEventListener('click',e=>{e.preventDefault();if(openPalette)openPalette();});
+ panel.addEventListener('mousedown',e=>e.preventDefault());
+ goBtn.addEventListener('click',e=>{e.preventDefault();toPalette();});
+ clearBtn.addEventListener('click',e=>{e.preventDefault();clearBox();searchInput.focus();});
+ searchInput.addEventListener('keydown',e=>{
+  if(panel.hidden)return;
+  if(e.key==='Enter'&&FINDS){e.preventDefault();toPalette();}
+  else if(e.key==='Escape'){e.preventDefault();e.stopPropagation();clearBox();}});
+ /* The views that report nothing, and the emptied box, both land here. */
+ searchInput.addEventListener('input',sync);
+ /* The palette hands focus back when it closes. If the query is still a dead
+    end, the offer comes back with it rather than leaving the box silent again. */
+ const ov=document.getElementById('sw');
+ if(ov&&window.MutationObserver)new MutationObserver(()=>{if(ov.hidden)sync();}).observe(ov,{attributes:true,attributeFilter:[ 'hidden' ]});
+ sync();
+})();
+
+/* ── bundles slide-over (⚙): the registry, on the page ───────────────────────
+   Choosing which bundle `/` opens used to mean leaving the graph for /b/ — and
+   knowing /b/ was there at all. This is the same list, in the same place the
+   reader already is.
+
+   It reads GET <MANAGE_ROOT>bundles on every open rather than baking the list
+   in: the hub re-reads the registry per request, so an `okf registry rename` in
+   another terminal shows the next time the panel is opened. A boot snapshot
+   would go stale and say nothing about it.
+
+   Writes POST <MANAGE_ROOT>registry/<verb> with Accept: application/json, so
+   the hub answers with the outcome instead of the redirect the /b/ manager's
+   forms want. Every gate is the server's; this only renders what it decides.
+
+   No Add. Registering a bundle means naming a filesystem path, a browser cannot
+   hand one over (the File System Access API yields an opaque handle, never a
+   path, and is Chromium-only), and it is the agent's act anyway. The footer
+   says so rather than leaving the absence to be noticed.
+
+   MANAGE_TOKEN is null on a read-only hub, which is what the panel reads to
+   decide between offering the menus and explaining why it does not. ── */
+(function(){
+ if(MANAGE_ROOT===null)return;
+ const btn=document.getElementById('btn-ws'),panel=document.getElementById('ws'),ovl=document.getElementById('ws-ovl');
+ const list=document.getElementById('ws-list'),sub=document.getElementById('ws-sub'),flash=document.getElementById('ws-flash');
+ const foot=document.getElementById('ws-foot');
+ if(!btn||!panel)return;
+ btn.hidden=false;
+ let rows=[],writable=false,hasRegistry=false,editing=null,confirming=null,menuFor=null,flashT=0;
+
+ /* Out of the box while closed (see the CSS): display is restored one frame
+    before .open so the slide still animates, and taken away again when the
+    slide back has finished — a panel parked off-canvas still widens the page. */
+ function open(){
+  panel.hidden=false;ovl.hidden=false;btn.setAttribute('aria-expanded','true');
+  requestAnimationFrame(()=>panel.classList.add('open'));
+  load();}
+ function close(){
+  panel.classList.remove('open');ovl.hidden=true;btn.setAttribute('aria-expanded','false');
+  editing=null;confirming=null;menuFor=null;closeMenu();
+  const done=()=>{if(!panel.classList.contains('open'))panel.hidden=true;};
+  if(reduce())done(); else setTimeout(done,240);}
+ btn.addEventListener('click',()=>panel.classList.contains('open')?close():open());
+ document.getElementById('ws-close').addEventListener('click',close);
+ ovl.addEventListener('click',close);
+ /* Escape peels one layer at a time: an open menu first, then the panel. Closing
+    the whole panel out from under an open menu throws away more than was asked
+    for, and doing nothing at all — which is what an unguarded `if(!menuFor)`
+    does — leaves the reader pressing a key that answers nothing. */
+ addEventListener('keydown',e=>{
+  if(e.key!=='Escape'||!panel.classList.contains('open'))return;
+  if(menuFor){e.stopPropagation();closeMenu();return;}
+  close();});
+
+ function load(){
+  fetch(MANAGE_ROOT+'bundles',{headers:{'accept':'application/json'}})
+   .then(r=>r.json())
+   .then(data=>{rows=data.bundles||[];writable=!!data.writable;hasRegistry=!!data.registry;render();})
+   .catch(()=>{list.innerHTML='<p class="ws-empty">The bundle list could not be loaded.</p>';});}
+
+ /* Two different reasons there is nothing to change, and they need different
+    sentences: a read-only bind names the flag, an ephemeral set names the
+    terminal. "No controls" with no explanation is the failure both share. */
+ function manageable(){return writable&&hasRegistry&&MANAGE_TOKEN!==null;}
+ function note(){
+  if(manageable())return '';
+  if(!hasRegistry)return '<p class="ws-ro-note">These bundles were named on the command line, so there is no registry to change. '+
+   '<code>okf registry set &lt;dir&gt;</code> registers one for good.</p>';
+  return '<p class="ws-ro-note">Read-only — this server is bound to an address other than loopback, so nothing here changes '+
+   'the registry. Restart it on a loopback bind, without <code>--read-only</code>, or use <code>okf registry</code> in the terminal.</p>';}
+
+ function render(){
+  closeMenu();
+  sub.textContent=rows.length+' bundle'+(rows.length===1?'':'s')+(hasRegistry?' in the registry':' on this server');
+  foot.hidden=!hasRegistry;
+  /* An empty list rendering *nothing* reads as a broken page. It is a real
+     state — the one a fresh install is in — so it says so and names the way out. */
+  if(!rows.length){
+   list.innerHTML='<p class="ws-empty">Nothing is registered yet.<br>Register a bundle with <code>okf registry set &lt;dir&gt;</code>.</p>';
+   return;}
+  list.innerHTML=note()+rows.map(row).join('');
+  wire();}
+
+ function row(b){
+  const cur=b.mount!==null&&b.mount===SELF_SLUG;
+  const pills=(b['default']?'<span class="ws-pill def">default</span>':'')+(cur?'<span class="ws-pill cur">current</span>':'');
+  /* A row the hub could not load links nowhere, because there is nowhere to
+     link — but it is still a row: "where did my bundle go?" is the question it
+     exists to answer. */
+  const title=b.mount!==null
+   ?'<a class="ws-title" href="../'+encodeURIComponent(b.mount)+'/">'+esc(b.title)+'</a>'
+   :'<span class="ws-title off">'+esc(b.title)+'</span>';
+  const count=b.count===null?'':'<span>'+b.count+' concept'+(b.count===1?'':'s')+'</span>';
+  const body='<div class="ws-row-main"><div class="ws-t">'+title+pills+'</div>'+
+   '<div class="ws-meta"><span class="ws-slug">@'+esc(b.slug)+'</span>'+count+
+   '<span class="ws-health '+esc(b.health)+'">'+esc(b.word)+'</span></div>'+
+   (editing===b.slug?edit(b):'')+(confirming===b.slug?confirm(b):'')+'</div>';
+  return '<div class="ws-row" data-slug="'+esc(b.slug)+'">'+body+(manageable()?menuBtn(b):'')+'</div>';}
+
+ function menuBtn(b){
+  return '<button class="ws-menu-btn" type="button" aria-haspopup="true" aria-expanded="false" '+
+   'aria-label="Actions for @'+esc(b.slug)+'" data-menu="'+esc(b.slug)+'">'+
+   '<svg viewBox="0 0 24 24"><circle cx="5" cy="12" r=".9" fill="currentColor" stroke="none"/>'+
+   '<circle cx="12" cy="12" r=".9" fill="currentColor" stroke="none"/>'+
+   '<circle cx="19" cy="12" r=".9" fill="currentColor" stroke="none"/></svg></button>';}
+
+ function edit(b){
+  return '<div class="ws-edit"><input class="field ws-slug-edit" value="'+esc(b.slug)+'" '+
+   'aria-label="New name for @'+esc(b.slug)+'" data-edit="'+esc(b.slug)+'">'+
+   '<button class="btn-sm primary" type="button" data-save="'+esc(b.slug)+'">Save</button>'+
+   '<button class="btn-sm" type="button" data-cancel="1">Cancel</button></div>'+
+   '<div class="ws-hint">Lowercase letters, numbers and hyphens. The folder is not touched.</div>';}
+
+ function confirm(b){
+  return '<div class="ws-confirm"><p>Remove <code>@'+esc(b.slug)+'</code> from the registry? '+
+   'The folder stays where it is — only this server stops listing it.</p>'+
+   '<div class="crow"><button class="btn-sm primary" type="button" data-remove="'+esc(b.slug)+'">Remove</button>'+
+   '<button class="btn-sm" type="button" data-cancel="1">Cancel</button></div></div>';}
+
+ /* The menu is appended to the panel rather than to the row, so a row with no
+    height left cannot clip it and no row needs overflow:visible to be usable. */
+ function openMenu(slug,anchor){
+  closeMenu();
+  const b=rows.filter(r=>r.slug===slug)[0];if(!b)return;
+  const isDefault=!!b['default'];
+  const el=document.createElement('div');
+  el.className='ws-menu';el.setAttribute('role','menu');
+  el.innerHTML='<button type="button" data-act="default"'+(isDefault||b.mount===null?' disabled':'')+'>'+
+    (isDefault?'Already the default':'Make default')+'</button>'+
+   '<button type="button" data-act="rename">Rename…</button>'+
+   '<div class="sep"></div>'+
+   '<button type="button" class="danger" data-act="remove">Remove…</button>';
+  panel.appendChild(el);
+  const a=anchor.getBoundingClientRect(),p=panel.getBoundingClientRect();
+  el.style.top=(a.bottom-p.top+4)+'px';
+  el.style.right=(p.right-a.right)+'px';
+  anchor.setAttribute('aria-expanded','true');
+  menuFor=slug;
+  el.addEventListener('click',e=>{
+   const item=e.target.closest('button[data-act]');if(!item||item.disabled)return;
+   const act=item.dataset.act;closeMenu();
+   if(act==='default')post('default',{slug:slug});
+   else if(act==='rename'){editing=slug;confirming=null;render();focusEdit();}
+   else{confirming=slug;editing=null;render();}});}
+ function closeMenu(){
+  const el=panel.querySelector('.ws-menu');if(el)el.remove();
+  const open=panel.querySelector('.ws-menu-btn[aria-expanded=true]');if(open)open.setAttribute('aria-expanded','false');
+  menuFor=null;}
+
+ function focusEdit(){const f=list.querySelector('.ws-slug-edit');if(f){f.focus();f.select();}}
+
+ function wire(){
+  list.querySelectorAll('.ws-menu-btn').forEach(b=>b.addEventListener('click',e=>{
+   e.stopPropagation();
+   const slug=b.dataset.menu;
+   if(menuFor===slug){closeMenu();return;}
+   openMenu(slug,b);}));
+  list.querySelectorAll('[data-cancel]').forEach(b=>b.addEventListener('click',()=>{editing=null;confirming=null;render();}));
+  list.querySelectorAll('[data-save]').forEach(b=>b.addEventListener('click',()=>save(b.dataset.save)));
+  list.querySelectorAll('[data-remove]').forEach(b=>b.addEventListener('click',()=>post('remove',{slug:b.dataset.remove})));
+  list.querySelectorAll('.ws-slug-edit').forEach(f=>f.addEventListener('keydown',e=>{
+   if(e.key==='Enter'){e.preventDefault();save(f.dataset.edit);}
+   else if(e.key==='Escape'){e.preventDefault();e.stopPropagation();editing=null;render();}}));}
+ panel.addEventListener('click',e=>{if(!e.target.closest('.ws-menu')&&!e.target.closest('.ws-menu-btn'))closeMenu();});
+
+ function save(slug){
+  const f=list.querySelector('.ws-slug-edit');if(!f)return;
+  post('rename',{slug:slug,to:f.value});}
+
+ function post(verb,params){
+  const body=new URLSearchParams();
+  Object.keys(params).forEach(k=>body.append(k,params[k]));
+  body.append('token',MANAGE_TOKEN);
+  fetch(MANAGE_ROOT+'registry/'+verb,{method:'POST',headers:{
+    'accept':'application/json','content-type':'application/x-www-form-urlencoded'},body:body.toString()})
+   .then(r=>r.json().then(d=>({ok:r.ok,data:d})))
+   .then(res=>{
+    editing=null;confirming=null;
+    say(res.ok?res.data.message:res.data.error,!res.ok);
+    /* Re-read rather than patch the row in place: a write rebuilds the hub's
+       whole set, so the list after it is the server's answer, not a guess. */
+    load();})
+   .catch(()=>{say('That change could not be sent.',true);});}
+
+ function say(message,bad){
+  flash.textContent=message||'';flash.classList.toggle('err',!!bad);flash.hidden=!message;
+  clearTimeout(flashT);flashT=setTimeout(()=>{flash.hidden=true;},6000);}
+})();
+
+/* ── concept preview (touch): how a phone inspects a dot ─────────────────────
+   The desktop inspector is a column beside the graph. On a touch-sized viewport
+   the same panel is the *whole* viewport (grid-template-columns:0 1fr), so a tap
+   on a node measured #stage at width 0 and the graph was simply gone — read,
+   close, tap the next dot, repeat. There is no exploring in that loop.
+
+   So on this branch a tap never opens #side. It fills the card instead: the head
+   (type · title · description · link counts) rides at the bottom of a graph that
+   keeps every pixel and stays pannable, zoomable and tappable. Drag it up for
+   the neighbourhood lists and the body; tap a row in one and the card's contents
+   swap in place while the camera walks to the new node. Three snaps — dragged,
+   flicked, tapped or arrowed.
+
+   Four seams with the rest of the page, and they stay this narrow on purpose:
+   · openPanel() returns false here, which is the whole of what suppresses the
+     takeover — data-side stays "hidden" for show(), showDir() and showLog()
+     alike, so the grid is `1fr 0px` and #stage keeps the screen.
+   · select() is wrapped, not rewritten: cy's tap handler, goToGraph, the hash
+     deep-link and the palette all reach the card through the same door.
+   · centerOn() aims at a band rather than the centre — cy.center() would park
+     the selected node underneath the card describing it.
+   · setSide() is pinned to "hidden", so `\` cannot raise an inspector that
+     show() never fills. ── */
+(function(){
+ const card=document.getElementById('preview'),grip=document.getElementById('pv-grip'),
+       head=document.getElementById('pv-head'),body=document.getElementById('pv-body'),
+       headIn=document.getElementById('pv-head-in'),bodyIn=document.getElementById('pv-body-in'),
+       app=document.getElementById('app'),bar=document.getElementById('topbar');
+ /* identical to the CSS branch — one decision, written twice because neither
+    language can read the other */
+ const MOBILE_MQ=matchMedia('(max-width:768px),(max-width:1024px) and (orientation:portrait)');
+ const isTouch=()=>MOBILE_MQ.matches;
+ const SNAPS=[ 'peek','half','full' ];
+ /* the card hangs off the bottom of the topbar, and the bar is not the same
+    height on every branch — measure it rather than carry a constant that a
+    padding change would quietly falsify, and hand the CSS the same number */
+ let TOPBAR=56;
+ function measure(){TOPBAR=Math.round(bar.getBoundingClientRect().height);
+  root.style.setProperty('--pv-top',TOPBAR+'px');}
+ measure();
+ const fullH=()=>Math.max(220,innerHeight-TOPBAR);
+ function snapH(s){const vh=innerHeight;
+  if(s==='half')return Math.round(vh*.62);
+  if(s==='full')return fullH();
+  return Math.min(fullH(),Math.max(150,Math.round(vh*.34)));}
+ const yFor=h=>Math.max(0,fullH()-h);
+ let snap='peek', up=false, shown=null, bodyLoaded=null, aimed=null;
+
+ /* ---- snap + visibility ------------------------------------------------- */
+ function apply(h){card.style.transform='translateY('+yFor(h)+'px)';}
+ function setSnap(s,quiet){snap=s;card.setAttribute('data-snap',s);
+  grip.setAttribute('aria-valuenow',String(SNAPS.indexOf(s)+1));grip.setAttribute('aria-valuetext',s);
+  apply(snapH(s));
+  if(s!=='peek')loadBody();
+  if(!quiet)panToBand();}
+ /* Shown and hidden with no frame in between: no rAF dance to give a slide
+    something to slide from, and no timer waiting for one to finish. The class
+    comes off before the hiding transform goes on, so the card takes exactly one
+    transform value for the whole time it is on screen — which is the only
+    external evidence that nothing animates. */
+ function raise(){if(up)return;up=true;card.classList.add('up');card.setAttribute('aria-hidden','false');
+  app.classList.add('preview-up');
+  setSnap('peek',true);
+  if(aimed)panToBand(aimed);}
+ function close(){if(!up)return;up=false;card.classList.remove('dragging');
+  card.classList.remove('up');card.style.transform='translateY(100%)';
+  card.setAttribute('aria-hidden','true');
+  app.classList.remove('preview-up');
+  shown=null;aimed=null;
+  try{cy.elements().removeClass('dim hl');}catch(e){}
+  try{if(location.hash)history.replaceState(null,'',location.pathname+location.search);}catch(e){}}
+ document.getElementById('pv-x').addEventListener('click',close);
+
+ /* ---- content ----------------------------------------------------------- */
+ /* Every string here goes through esc(); the only innerHTML that is not escaped
+    is the markdown body, and that one goes through renderMarkdown — i.e.
+    DOMPurify.sanitize(marked.parse(...)) — like every other body on the page. A
+    second render path that skipped either defense would reopen the hole the
+    template closed once, which is why mobile-preview.spec.js runs the hostile
+    bundle's payloads through this card too. */
+ function fill(id){const n=byId[id];if(!n)return false;
+  const ty=typeOf[id]||'Untyped', c=color[ty]||'#64748b';
+  const out=(outL[id]||[]).length, inn=(inL[id]||[]).length;
+  shown=id;bodyLoaded=null;body.scrollTop=0;
+  headIn.innerHTML='<span class="type"><span class="dot" style="background:'+esc(c)+'"></span>'+esc(ty)+'</span>'+
+   '<h2 class="pv-title">'+esc(n.title||id)+'</h2>'+
+   '<p class="pv-desc loading" id="pv-desc">loading…</p>'+
+   '<p class="pv-meta">'+out+' link'+(out===1?'':'s')+' out · '+inn+' in</p>';
+  bodyIn.innerHTML=relList('Links to',outL[id]||[])+relList('Linked from',inL[id]||[])+'<div class="body" id="pv-md"></div>';
+  bodyIn.querySelectorAll('[data-go]').forEach(a=>a.onclick=()=>select(a.getAttribute('data-go')));
+  getNodeMeta(id).then(h=>{const d=document.getElementById('pv-desc');
+   if(d&&shown===id){d.innerHTML=h||'<span class="empty">no description</span>';d.classList.remove('loading');}}).catch(()=>{});
+  if(snap!=='peek')loadBody();
+  return true;}
+ /* lazy: the body is markdown nobody can see at peek, and on a phone peek is the
+    state the card spends most of its life in */
+ function loadBody(){const id=shown;if(!id||bodyLoaded===id)return;bodyLoaded=id;
+  const el=document.getElementById('pv-md');if(!el)return;
+  el.innerHTML='<span class="loading">loading…</span>';
+  getNodeBody(id).then(md=>{if(el.isConnected&&shown===id)renderMarkdown(el,md);}).catch(()=>{});}
+ /* The authored layer needs its own filler for the same reason concepts do:
+    showDir and showLog write into #side-body, and on this branch that is a panel
+    nobody can see — so a folder in tree mode, an area box in cluster mode and an
+    index node all did nothing visible at all. Not a crash, which is exactly why
+    it survived: the tap looked ignored. */
+ function fillHead(kind,title,meta){shown=null;bodyLoaded=null;body.scrollTop=0;
+  headIn.innerHTML='<span class="type">'+esc(kind)+'</span>'+
+   '<h2 class="pv-title">'+esc(title)+'</h2>'+
+   '<p class="pv-meta">'+esc(meta)+'</p>';
+  bodyIn.innerHTML='<div class="body" id="pv-md"></div>';
+  return document.getElementById('pv-md');}
+ function fillDir(dir){getIndex().then(function(dirs){const d=dirs.find(x=>x.dir===dir);if(!d)return;
+  const types=Object.entries(d.types||{}).map(([t,n])=>(t||'Untyped')+' '+n).join(' · ');
+  const el=fillHead(d.present?'index.md':'no index.md · synthesized',
+   d.dir==='.'?BUNDLE:d.dir+'/',
+   d.count+' concept'+(d.count===1?'':'s')+(types?' · '+types:''));
+  if(d.present)renderMarkdown(el,d.body||'');else el.innerHTML=listingHtml(d.listing);
+  bodyIn.querySelectorAll('[data-go]').forEach(a=>a.onclick=()=>select(a.getAttribute('data-go')));
+  raise();}).catch(function(){});}
+ function fillLog(path){LOGS=null;getLogs().then(function(logs){const l=logs.find(x=>x.path===path);if(!l)return;
+  renderMarkdown(fillHead('update log · §7',path,'the §7 history'),l.content||'');
+  raise();}).catch(function(){});}
+
+ /* ---- the camera -------------------------------------------------------- */
+ /* cy.center() puts the node in the middle of the canvas, which here is behind
+    the card describing it. Aim at the middle of the *visible band* instead — the
+    strip between the top of the canvas and the card's edge — and skip the move
+    outright when the card leaves no band worth aiming at. The bump into
+    centerCommits is the same counter centerOn uses: a band-pan is a committed
+    camera move like any other, and one-move-per-selection is the invariant
+    camera-races.spec.js pins (at a desktop width, where this branch is off). */
+ function panToBand(ele){
+  if(!up||!isTouch())return;
+  const e=ele||(shown?cy.getElementById(shown):null);
+  if(!e||!e.length)return;
+  const r=cy.container().getBoundingClientRect();
+  const top=innerHeight-snapH(snap);
+  const band=Math.min(r.bottom,top)-r.top;
+  if(band<140)return; /* at full there is nothing to see; do not jerk the view */
+  const rp=e.renderedPosition(), p=cy.pan();
+  const dx=r.width/2-rp.x, dy=band/2-rp.y;
+  if(Math.abs(dx)<1&&Math.abs(dy)<1)return;
+  cy.stop();window.__camCenters=++centerCommits;
+  cy.animate({pan:{x:p.x+dx,y:p.y+dy},duration:420,easing:'ease-in-out-cubic'});}
+
+ /* ---- gestures ---------------------------------------------------------- */
+ /* One pointer stream for the grip and the head. A short, still press is a tap
+    (peek↔half); anything longer follows the finger and lands on the nearest
+    snap, one step further when it was flicked. Below peek a downward flick means
+    "go away", which is the gesture people already have. */
+ let drag=null;
+ function down(e){if(!up||e.target.closest('button,a'))return;
+  drag={y0:e.clientY,h0:snapH(snap),h:snapH(snap),ly:e.clientY,lt:performance.now(),v:0,moved:0,t0:performance.now()};
+  card.classList.add('dragging');
+  try{e.currentTarget.setPointerCapture(e.pointerId);}catch(err){}
+  addEventListener('pointermove',move);addEventListener('pointerup',upEv);addEventListener('pointercancel',upEv);}
+ function move(e){if(!drag)return;
+  const dy=e.clientY-drag.y0;drag.moved=Math.max(drag.moved,Math.abs(dy));
+  const now=performance.now(),dt=now-drag.lt;
+  if(dt>0){drag.v=(e.clientY-drag.ly)/dt;drag.ly=e.clientY;drag.lt=now;}
+  drag.h=Math.min(fullH(),Math.max(20,drag.h0-dy));apply(drag.h);}
+ function upEv(){if(!drag)return;const d=drag;drag=null;
+  removeEventListener('pointermove',move);removeEventListener('pointerup',upEv);removeEventListener('pointercancel',upEv);
+  card.classList.remove('dragging');
+  if(d.moved<8&&performance.now()-d.t0<500){setSnap(snap==='peek'?'half':'peek');return;}
+  let i=0,best=Infinity;
+  SNAPS.forEach((s,k)=>{const g=Math.abs(snapH(s)-d.h);if(g<best){best=g;i=k;}});
+  /* 0.9 px/ms is where a flick stops being a drag. Measured lower (0.55), a
+     deliberate ~150ms pull already read as a flick and overshot its target by a
+     whole snap — the difference between a card you place and one that argues. */
+  if(d.v>.9)i--;else if(d.v<-.9)i++;
+  if(i<0||d.h<snapH('peek')*.55){close();return;}
+  setSnap(SNAPS[Math.min(SNAPS.length-1,i)]);}
+ grip.addEventListener('pointerdown',down);head.addEventListener('pointerdown',down);
+ grip.addEventListener('keydown',e=>{const i=SNAPS.indexOf(snap);
+  if(e.key==='ArrowUp'){e.preventDefault();setSnap(SNAPS[Math.min(2,i+1)]);}
+  else if(e.key==='ArrowDown'){e.preventDefault();if(i===0)close();else setSnap(SNAPS[i-1]);}
+  else if(e.key==='Enter'||e.key===' '){e.preventDefault();setSnap(snap==='peek'?'half':'peek');}});
+ /* Esc closes what is on top, and the card is the bottom-most thing it can
+    reach — it is not modal, so every overlay above it answers first. */
+ const covered=()=>!dgv.hidden||!kb.hidden||(swModal&&!swModal.hidden)||
+  document.getElementById('ws').classList.contains('open')||
+  document.getElementById('filters').classList.contains('open');
+ addEventListener('keydown',e=>{if(up&&e.key==='Escape'&&!covered())close();});
+ /* a rotation, or a phone's address bar sliding away, changes what the snaps mean */
+ addEventListener('resize',()=>{measure();if(up)apply(snapH(snap));});
+ MOBILE_MQ.addListener&&MOBILE_MQ.addListener(()=>{if(!isTouch())close();});
+
+ /* ---- the seams --------------------------------------------------------- */
+ const _openPanel=openPanel;
+ openPanel=function(){if(isTouch())return false;return _openPanel();};
+ const _setSide=setSide;
+ setSide=function(s){return _setSide(isTouch()?'hidden':s);};
+ const _centerOn=centerOn;
+ /* remembered, because a folder tap centres before its index has been fetched —
+    the card raises afterwards and re-aims at the band it now leaves */
+ centerOn=function(ele,delay){if(!isTouch())return _centerOn(ele,delay);aimed=ele;panToBand(ele);};
+ const _showDir=showDir, _showLog=showLog;
+ showDir=function(dir){if(!isTouch())return _showDir(dir);fillDir(dir);};
+ showLog=function(path){if(!isTouch())return _showLog(path);fillLog(path);};
+ const _select=select;
+ select=function(id){
+  if(!isTouch())return _select(id);
+  const ele=cy.getElementById(id);if(!ele||!ele.length)return;
+  if(!fill(id))return;
+  /* raise first: the card is already at its snap by the time focusNode pans, so
+     the band is measured once and the camera moves once */
+  raise();
+  focusNode(ele,false);
+  try{if(decodeURIComponent((location.hash||'').slice(1))!==id)location.hash=encodeURIComponent(id);}catch(e){}};
+ /* A bare-canvas tap deliberately does NOT dismiss the card. It used to, on the
+    reasoning that the gesture means "never mind" — but the dots are small, the
+    misses constant, and the card kept closing by accident, which is what made
+    the *next* dot replay the whole entrance. Exploring turned into a slideshow.
+    (It also explains why a tablet felt fine and a phone did not: the same code,
+    with dots far enough apart that the miss rarely fired.) The card is a preview
+    of the last dot you touched, so it survives a miss and swaps in place on a
+    hit; dismissing stays explicit — ✕, swipe down, or Esc. */
 })();
 
 /* ── mobile: the rail as a drawer, the topbar controls as a sheet, and a
@@ -1602,13 +2960,9 @@ function getLogs(){return LOGS||(LOGS=EMBED?Promise.resolve(EMBED.logs):fetch(LO
  const bf=document.getElementById('btn-filters');
  if(bf)bf.addEventListener('click',()=>ctlSet(false));
  menuBtn.addEventListener('click',()=>navSet(!app.classList.contains('nav-open')));
+ menuBtn.addEventListener('click',hello2Done);
  bk.addEventListener('mousedown',()=>navSet(false));
  document.getElementById('rail').addEventListener('click',e=>{if(e.target.closest('.rail-item,.btn')){navSet(false);ctlSet(false);}});
- let small=false;try{small=matchMedia('(max-width:768px)').matches;}catch(err){}
- if(small){try{
-  if(!localStorage.getItem('okf-mnote')){const n=document.getElementById('mnote');n.hidden=false;
-   document.getElementById('mnote-x').addEventListener('click',()=>{n.hidden=true;try{localStorage.setItem('okf-mnote','1');}catch(err){}});}
- }catch(err){}}
  /* the initial layout runs before the viewport settles (fonts, window chrome,
     a phone's address bar), which can leave the graph tiny — on any screen. Fit
     once after load (past the canvas ResizeObserver's 240ms debounce) and again
@@ -1621,18 +2975,17 @@ function getLogs(){return LOGS||(LOGS=EMBED?Promise.resolve(EMBED.logs):fetch(LO
   addEventListener('load',()=>setTimeout(fitGraph,400));
   addEventListener('orientationchange',()=>setTimeout(fitGraph,450));
  }
- /* files view: the stacked list collapses to its tab bar — picking a file
-    hands the screen to the reader, picking a tab brings the list back */
+ /* files view: the stacked list collapses to its header — picking a file hands
+    the screen to the reader, the filter toggle brings the list back */
  const fgridEl=document.querySelector('.files-grid'),ftmin=document.getElementById('ftree-min');
  if(fgridEl&&ftmin){
-  const treeSet=o=>{fgridEl.classList.toggle('tree-min',o);
-   ftmin.setAttribute('aria-expanded',o?'false':'true');
-   ftmin.setAttribute('aria-label',o?'Expand file list':'Collapse file list');};
-  ftmin.addEventListener('click',()=>treeSet(!fgridEl.classList.contains('tree-min')));
+  ftmin.addEventListener('click',()=>{const on=!fgridEl.classList.contains('tree-min');
+   if(!on&&foldedByRoot){foldedByRoot=false;collapsedDirs.delete('.');refreshTree();}
+   treeMin(on);});
   document.getElementById('ftree-list').addEventListener('click',e=>{
-   if(e.target.closest('.file')&&matchMedia('(max-width:768px)').matches)treeSet(true);});
-  [ 'ftab-files','ftab-indexes' ].forEach(id=>{const t=document.getElementById(id);
-   if(t)t.addEventListener('click',()=>treeSet(false));});
+   if(e.target.closest('.file')&&matchMedia('(max-width:768px)').matches)treeMin(true);});
+  const ix=document.getElementById('ftree-ixonly');
+  if(ix)ix.addEventListener('click',()=>treeMin(false));
  }
 })();
 
@@ -1652,9 +3005,11 @@ const KEYS=[
  [ '\\', 'show or hide the inspector — graph' ],
  [ '0', 'fit the graph to the screen — graph' ],
  [ 'f', 'fullscreen' ],
- [ /Mac|iP/.test(navigator.platform||'')?'⌘K':'Ctrl-K', HUB_PATH!==null?'switch bundle, or jump to a view':'jump to a view' ],
+ [ /Mac|iP/.test(navigator.platform||'')?'⌘K':'Ctrl-K',
+   SEARCH_ENDPOINT!==null?'search every bundle, switch bundle, or jump to a view':
+   HUB_PATH!==null?'switch bundle, or jump to a view':'jump to a view' ],
  [ '?', 'this list' ],
- [ 'Esc', 'close whatever is open' ]
+ [ 'Esc', 'close what is open, or clear the graph selection' ]
 ];
 const kb=document.getElementById('kb');
 let kbLast=null;
@@ -1678,17 +3033,40 @@ addEventListener('keydown',e=>{if(!dgv.hidden){if(e.key==='Escape')closeDiagram(
  else if(e.key==='?'){e.preventDefault();kbOpen();}
  else if(e.key==='\\'&&view==='graph'){setSide(gbody.getAttribute('data-side')==='hidden'?'default':'hidden');}
  else if(e.key==='0'&&view==='graph'){fitGraph();}
+ else if(e.key==='Escape'&&view==='graph'){deselect();}
  else if(e.key==='f'){btnFull.click();}});
 
 /* ── deep links ── */
 const Q=new URLSearchParams(location.search),QL=Q.get('layout'),QS=Q.get('select');
 if(QL&&[...layoutSel.options].some(o=>o.value===QL)){layoutSel.value=QL;runLayout(QL);}
 const QV=Q.get('view');
-if(QV==='index')goIndexes();
+if(QV==='index')readIndex();
 else if(QV&&document.querySelector('.rail-item[data-view="'+CSS.escape(QV)+'"]'))setView(QV);
-function fromHash(){try{const h=decodeURIComponent((location.hash||'').slice(1));if(h&&byId[h])select(h);}catch(e){}}
+/* Both of these name a *node*, so each has to carry the view with it: the page
+   can now be standing on the index when one is read, and selecting into a graph
+   nobody is looking at is a silent no-op. goToGraph on the graph is a no-op
+   itself (setView returns early), so this costs the old path nothing. */
+function fromHash(){try{const h=decodeURIComponent((location.hash||'').slice(1));if(h&&byId[h])goToGraph(h);}catch(e){}}
 addEventListener('hashchange',fromHash);
-if(QS&&byId[QS])select(QS);else fromHash();
+if(QS&&byId[QS])goToGraph(QS);else fromHash();
+
+/* ── first visit ──
+   The graph is the first impression and stays that way. What it cannot say on
+   its own is that the bundle has an index — the one page an author wrote to be
+   read first — so a note says it once, and never again. Landing on the index
+   instead was the other way to solve this; it only read well on a wide window,
+   and cost every visitor the view that makes a bundle legible at a glance.
+   The wording is written for a finger, because a phone is where a newcomer is
+   least oriented and where "click" means nothing. */
+try{if(!localStorage.getItem('okf-hello')){
+ const h=document.getElementById('hello');h.hidden=false;
+ /* the canvas hint says the same three gestures the note just said, so it
+    stands down while the note is up rather than repeating it alongside */
+ const gh=document.querySelector('.ghint');if(gh)gh.style.visibility='hidden';
+ const close=()=>{h.hidden=true;if(gh)gh.style.visibility='';try{localStorage.setItem('okf-hello','1');}catch(err){}};
+ document.getElementById('hello-x').addEventListener('click',close);
+ document.getElementById('hello-go').addEventListener('click',()=>{close();readIndex();});
+}}catch(err){}
 
 /* ── a small hello for the curious ── */
 try{console.log('%cokf%c — knowledge as code. '+NODES.length+' concepts, one graph.','color:#e21e1e;font-weight:700;font-size:15px','color:inherit');}catch(e){}