@sealant/mend 0.36.0-next.684 → 0.36.0-next.721

package/dist/{dashboard-OBFWHSPD.js → dashboard-MPO6H5YF.js}

@@ -17,6 +17,8 @@ import {
   normalizeProjectName,
   pendingId,
   repositoryCloneUrlIssue,
+  serviceViewHostPort,
+  serviceViewStatus,
   servicesHoldLine,
   sessionWorkspaceLines,
   withoutLaunchPhase,
@@ -24,7 +26,7 @@ import {
   workspaceReadsOf,
   worktreeJoinLine,
   wrapWords
-} from "./chunk-DHM7VXTR.js";
+} from "./chunk-GF5A6W2Y.js";
 
 // src/dashboard.tsx
 import { CliRenderEvents, createCliRenderer } from "@opentui/core";
@@ -60,6 +62,15 @@ var submitDashboardAdoption = async (api, input) => {
 };
 
 // src/dashboard-model.ts
+var serviceRowOf = (view) => ({
+  id: view.service.id,
+  sessionId: view.service.sessionId,
+  label: view.service.name,
+  status: serviceViewStatus(view),
+  workspacePort: view.service.workspacePort,
+  protocol: view.service.transport,
+  hostPort: serviceViewHostPort(view)
+});
 var worktreeName = (branch) => branch.startsWith("mend/") ? branch.slice("mend/".length) : branch;
 var worktreeDisplayName = (session) => {
   const name = worktreeName(session.branch);
@@ -76,7 +87,7 @@ var fetchWorkbench = async (ctx) => {
     ctx.api("GET", "/services")
   ]);
   const servicesBySession = /* @__PURE__ */ new Map();
-  for (const service of services) {
+  for (const service of services.map(serviceRowOf)) {
     const bucket = servicesBySession.get(service.sessionId) ?? [];
     bucket.push(service);
     servicesBySession.set(service.sessionId, bucket);
@@ -205,7 +216,7 @@ var pseudoGroup = (session, item) => ({
   live: LIVE_STATUSES.has(session.status) ? 1 : 0,
   annotation: item(session).annotation
 });
-var deriveHarnesses = (resuming) => {
+var deriveHarnesses = (resuming, joining = null) => {
   if (resuming !== null) {
     const others = Object.keys(HARNESS_COMMANDS).filter((h) => h !== resuming.harness);
     return [
@@ -223,11 +234,12 @@ var deriveHarnesses = (resuming) => {
       )
     ];
   }
+  const where = joining === null ? "new worktree" : `joins ${joining}`;
   return Object.keys(HARNESS_COMMANDS).map(
     (harness) => ({
       harness,
       label: harness,
-      hint: harness === "shell" ? "a plain bash session \xB7 new worktree, recorded" : `mend ${harness} \xB7 new worktree, recorded session`
+      hint: harness === "shell" ? `a plain bash session \xB7 ${where}, recorded` : `mend ${harness} \xB7 ${where}, recorded session`
     })
   );
 };
@@ -487,8 +499,35 @@ var advanceFromBase = (current) => {
 var COLUMNS = ["projects", "worktrees", "sessions", "detail"];
 var NAV_SECTIONS = ["projects", "worktrees", "sessions"];
 var isNavSection = (column) => column !== "detail";
+var PANE_NUMBER = {
+  projects: "1",
+  worktrees: "2",
+  sessions: "3",
+  detail: "0"
+};
+var paneForDigit = (digit) => COLUMNS.find((column) => PANE_NUMBER[column] === digit) ?? null;
+var numberedTitle = (column, title) => `[${PANE_NUMBER[column]}] ${title}`;
+var cyclePane = (focus, delta) => {
+  const at = COLUMNS.indexOf(focus);
+  if (at === -1) return "sessions";
+  const next = ((at + delta) % COLUMNS.length + COLUMNS.length) % COLUMNS.length;
+  return COLUMNS[next] ?? focus;
+};
+var backFrom = (focus, lastNav) => focus === "detail" ? lastNav : stepColumn(focus, -1);
+var SCREEN_MODES = ["normal", "half", "full"];
+var stepScreenMode = (mode, delta) => {
+  const at = SCREEN_MODES.indexOf(mode);
+  const next = ((at + delta) % SCREEN_MODES.length + SCREEN_MODES.length) % SCREEN_MODES.length;
+  return SCREEN_MODES[next] ?? mode;
+};
+var matchesFilter = (query, ...fields) => {
+  const needle = query.trim().toLowerCase();
+  if (needle === "") return true;
+  return fields.some((field) => field !== null && field.toLowerCase().includes(needle));
+};
 var expandedSection = (focus, lastNav) => isNavSection(focus) ? focus : lastNav;
 var SIDEBAR_SHARE = 0.25;
+var HALF_SIDEBAR_SHARE = 0.5;
 var MIN_SIDEBAR_WIDTH = 24;
 var MIN_DETAIL_WIDTH = 48;
 var SPLIT_MIN_WIDTH = MIN_SIDEBAR_WIDTH + MIN_DETAIL_WIDTH;
@@ -504,13 +543,11 @@ var stackSections = (body, open) => {
     (section) => section === open ? { section, expanded: true, height: room, rows: room - 2 } : { section, expanded: false, height: MIN_SECTION_HEIGHT, rows: 1 }
   );
 };
-var planLayout = (width, height, focus, lastNav) => {
-  const split = width >= SPLIT_MIN_WIDTH;
+var planLayout = (width, height, focus, lastNav, mode = "normal") => {
+  const split = mode !== "full" && width >= SPLIT_MIN_WIDTH;
   const navVisible = split || isNavSection(focus);
-  const sidebarOuter = split ? Math.max(
-    MIN_SIDEBAR_WIDTH,
-    Math.min(width - MIN_DETAIL_WIDTH, Math.round(width * SIDEBAR_SHARE))
-  ) : navVisible ? Math.max(4, width) : 0;
+  const share = mode === "half" ? HALF_SIDEBAR_SHARE : SIDEBAR_SHARE;
+  const sidebarOuter = split ? Math.max(MIN_SIDEBAR_WIDTH, Math.min(width - MIN_DETAIL_WIDTH, Math.round(width * share))) : navVisible ? Math.max(4, width) : 0;
   const detailOuter = split ? width - sidebarOuter : navVisible ? 0 : Math.max(4, width);
   const build = (body2, breadcrumb) => {
     const sections = navVisible ? stackSections(body2, expandedSection(focus, lastNav)) : [];
@@ -593,6 +630,11 @@ var worktreeJoinRows = (data, projectId, worktree, viewerId, width) => {
   const line = worktreeJoinLine(detail.sessions, id, viewerId);
   return line === null ? [] : wrapWords(line, width);
 };
+var KEY_GROUP_TITLE = {
+  navigate: "move around",
+  session: "act on the selection",
+  dashboard: "the dashboard"
+};
 var KEY_BINDINGS = [
   {
     verb: "moveUp",
@@ -603,36 +645,123 @@ var KEY_BINDINGS = [
       worktrees: "\u2191\u2193 move",
       sessions: "\u2191\u2193 move",
       detail: "\u2191\u2193 scroll"
-    }
+    },
+    help: "up the list, or back through the record",
+    group: "navigate"
+  },
+  {
+    verb: "moveDown",
+    keys: ["down", "j"],
+    shift: false,
+    hints: {},
+    help: "down the list, or toward the newest line",
+    group: "navigate"
+  },
+  { verb: "pageUp", keys: ["pageup"], shift: false, hints: {}, help: "up ten", group: "navigate" },
+  {
+    verb: "pageDown",
+    keys: ["pagedown"],
+    shift: false,
+    hints: {},
+    help: "down ten",
+    group: "navigate"
+  },
+  {
+    verb: "jumpProjects",
+    keys: ["1"],
+    shift: false,
+    hints: {},
+    help: "jump to [1] projects",
+    group: "navigate"
+  },
+  {
+    verb: "jumpWorktrees",
+    keys: ["2"],
+    shift: false,
+    hints: {},
+    help: "jump to [2] worktrees",
+    group: "navigate"
+  },
+  {
+    verb: "jumpSessions",
+    keys: ["3"],
+    shift: false,
+    hints: {},
+    help: "jump to [3] sessions",
+    group: "navigate"
+  },
+  {
+    verb: "jumpDetail",
+    keys: ["0"],
+    shift: false,
+    hints: {},
+    help: "jump to [0], the session pane",
+    group: "navigate"
   },
-  { verb: "moveDown", keys: ["down", "j"], shift: false, hints: {} },
-  { verb: "pageUp", keys: ["pageup"], shift: false, hints: {} },
-  { verb: "pageDown", keys: ["pagedown"], shift: false, hints: {} },
   {
     verb: "columnRight",
-    keys: ["return", "linefeed", "l", "right", "tab"],
+    keys: ["return", "linefeed", "l", "right"],
     shift: false,
-    hints: { projects: "\u2192 worktrees", worktrees: "\u2190\u2192 panes", sessions: "\u2190\u2192 panes" }
+    hints: { projects: "\u2192 worktrees", worktrees: "\u2190\u2192 panes", sessions: "\u2190\u2192 panes" },
+    help: "drill in: projects, worktrees, sessions, then [0]",
+    group: "navigate"
   },
   {
     verb: "columnLeft",
     keys: ["left", "h", "-", "backspace"],
     shift: false,
-    hints: { detail: "\u2190 sessions" }
+    hints: { detail: "\u2190 sessions" },
+    help: "one pane back up the hierarchy",
+    group: "navigate"
+  },
+  {
+    verb: "nextPane",
+    keys: ["tab"],
+    shift: false,
+    hints: {},
+    help: "next pane, round to the first after the last",
+    group: "navigate"
+  },
+  { verb: "prevPane", keys: ["backtab"], shift: "any", hints: {} },
+  {
+    verb: "prevPane",
+    keys: ["tab"],
+    shift: true,
+    hints: {},
+    help: "previous pane, round to the last before the first",
+    group: "navigate"
+  },
+  {
+    verb: "back",
+    keys: ["escape"],
+    shift: false,
+    hints: {},
+    help: "clear the filter, else back to where you came from",
+    group: "navigate"
+  },
+  {
+    verb: "filter",
+    keys: ["/"],
+    shift: false,
+    hints: {},
+    help: "filter this list; enter keeps the filter, esc clears it",
+    group: "navigate"
   },
-  { verb: "columnLeft", keys: ["backtab"], shift: "any", hints: {} },
-  { verb: "columnLeft", keys: ["tab"], shift: true, hints: {} },
   {
     verb: "attach",
     keys: ["a"],
     shift: false,
-    hints: { worktrees: "a attach", sessions: "a attach", detail: "a attach" }
+    hints: { worktrees: "a attach", sessions: "a attach", detail: "a attach" },
+    help: "attach this terminal to the live session",
+    group: "session"
   },
   {
     verb: "resume",
     keys: ["r"],
     shift: false,
-    hints: { worktrees: "r resume", sessions: "r resume", detail: "r resume" }
+    hints: { worktrees: "r resume", sessions: "r resume", detail: "r resume" },
+    help: "resume the settled session, on a harness you pick",
+    group: "session"
   },
   {
     verb: "newSession",
@@ -642,60 +771,166 @@ var KEY_BINDINGS = [
       projects: "n/w new worktree",
       worktrees: "n new session",
       sessions: "n new session"
-    }
+    },
+    help: "another session in this worktree, or a new worktree",
+    group: "session"
   },
   {
     verb: "newWorktree",
     keys: ["w"],
     shift: false,
-    hints: { worktrees: "w new worktree", sessions: "w new worktree" }
+    hints: { worktrees: "w new worktree", sessions: "w new worktree" },
+    help: "a new worktree in this project",
+    group: "session"
   },
   {
     verb: "stop",
     keys: ["k"],
     shift: true,
-    hints: { worktrees: "\u21E7K stop all", sessions: "\u21E7K stop" }
+    hints: { worktrees: "\u21E7K stop all", sessions: "\u21E7K stop" },
+    help: "stop it, or every live session in [2] (press twice)",
+    group: "session"
   },
   { verb: "stop", keys: ["x"], shift: false, hints: {} },
   {
     verb: "remove",
     keys: ["d"],
     shift: true,
-    hints: { worktrees: "\u21E7D remove worktree", sessions: "\u21E7D remove" }
+    hints: { worktrees: "\u21E7D remove worktree", sessions: "\u21E7D remove" },
+    help: "remove it, or the worktree from [2] (press twice)",
+    group: "session"
   },
   {
     verb: "review",
     keys: ["v"],
     shift: false,
-    hints: { worktrees: "v review", sessions: "v review", detail: "v review" }
+    hints: { worktrees: "v review", sessions: "v review", detail: "v review" },
+    help: "review the change in this terminal",
+    group: "session"
   },
   {
     verb: "rename",
     keys: ["e"],
     shift: false,
-    hints: { sessions: "e rename", detail: "e rename" }
+    hints: { sessions: "e rename", detail: "e rename" },
+    help: "label the session; empty clears it",
+    group: "session"
+  },
+  {
+    verb: "openWeb",
+    keys: ["o"],
+    shift: false,
+    hints: { sessions: "o web", detail: "o web" },
+    help: "open the session in the browser",
+    group: "session"
   },
-  { verb: "openWeb", keys: ["o"], shift: false, hints: { sessions: "o web", detail: "o web" } },
   {
     verb: "refresh",
     keys: ["r"],
     shift: true,
-    hints: { projects: "\u21E7R refresh", worktrees: "\u21E7R refresh", detail: "\u21E7R refresh" }
+    hints: { projects: "\u21E7R refresh", worktrees: "\u21E7R refresh", detail: "\u21E7R refresh" },
+    help: "read everything from the server again",
+    group: "dashboard"
+  },
+  {
+    verb: "nextScreenMode",
+    keys: ["+"],
+    shift: "any",
+    hints: {},
+    help: "screen mode: normal, half, full",
+    group: "dashboard"
+  },
+  {
+    verb: "prevScreenMode",
+    keys: ["_"],
+    shift: "any",
+    hints: {},
+    help: "screen mode, the other way",
+    group: "dashboard"
+  },
+  {
+    verb: "help",
+    keys: ["?"],
+    shift: "any",
+    hints: {},
+    help: "this list",
+    group: "dashboard",
+    footer: "? keys"
   },
   {
     verb: "quit",
     keys: ["q"],
     shift: false,
-    hints: { projects: "q quit", worktrees: "q quit", sessions: "q quit", detail: "q quit" }
+    hints: { projects: "q quit", worktrees: "q quit", sessions: "q quit", detail: "q quit" },
+    help: "quit; sessions keep running",
+    group: "dashboard"
   }
 ];
+var SYMBOL_STROKES = /* @__PURE__ */ new Set(["?", "+", "_"]);
+var strokeName = (key) => {
+  const sequence = key.sequence ?? "";
+  return SYMBOL_STROKES.has(sequence) ? sequence : key.name ?? "";
+};
 var verbForKey = (name, shift) => KEY_BINDINGS.find(
   (binding) => binding.keys.includes(name) && (binding.shift === "any" || binding.shift === shift)
 )?.verb ?? null;
+var gameSwallows = (verb) => verb !== null;
 var verbHints = (focus) => KEY_BINDINGS.flatMap((binding) => {
   const hint = binding.hints[focus];
   return hint === void 0 ? [] : [hint];
 });
+var FOOTER_TAIL = KEY_BINDINGS.flatMap(
+  (binding) => binding.footer === void 0 ? [] : [binding.footer]
+);
+var footerHints = (focus, width) => {
+  const tail = FOOTER_TAIL.map((hint) => ` \xB7 ${hint}`).join("");
+  return `${fitHints(verbHints(focus), Math.max(1, width - tail.length))}${tail}`;
+};
+var KEY_LABEL = {
+  up: "\u2191",
+  down: "\u2193",
+  left: "\u2190",
+  right: "\u2192",
+  return: "enter",
+  tab: "tab",
+  backtab: "\u21E7tab",
+  escape: "esc",
+  backspace: "\u232B",
+  pageup: "PgUp",
+  pagedown: "PgDn"
+};
+var keyLabel = (key, shift) => {
+  const base = KEY_LABEL[key] ?? key;
+  return shift === true ? `\u21E7${base.length === 1 ? base.toUpperCase() : base}` : base;
+};
+var helpSections = (focus) => {
+  const rows = /* @__PURE__ */ new Map();
+  for (const binding of KEY_BINDINGS) {
+    const entry = rows.get(binding.verb) ?? { keys: [], help: "", group: null };
+    for (const key of binding.keys) {
+      if (key === "linefeed") continue;
+      const label = keyLabel(key, binding.shift);
+      if (!entry.keys.includes(label)) entry.keys.push(label);
+    }
+    if (entry.help === "" && binding.help !== void 0) entry.help = binding.help;
+    if (entry.group === null && binding.group !== void 0) entry.group = binding.group;
+    rows.set(binding.verb, entry);
+  }
+  const all = [...rows].map(([verb, entry]) => ({
+    verb,
+    keys: entry.keys.join(" "),
+    help: entry.help,
+    group: entry.group ?? "dashboard",
+    here: KEY_BINDINGS.some(
+      (binding) => binding.verb === verb && binding.hints[focus] !== void 0
+    )
+  }));
+  const groups = ["navigate", "session", "dashboard"];
+  return groups.flatMap((group) => {
+    const ordered = all.filter((row) => row.group === group);
+    return ordered.length === 0 ? [] : [{ title: KEY_GROUP_TITLE[group], rows: ordered.map(({ group: _group, ...row }) => row) }];
+  });
+};
 
 // src/dashboard-preview.ts
 import { stripVTControlCharacters } from "node:util";
@@ -2146,9 +2381,6 @@ function ReviewScreen({
   );
 }
 
-// src/snake.tsx
-import { useEffect as useEffect2, useState as useState2 } from "react";
-
 // src/snake-game.ts
 var OPPOSITE = {
   up: "down",
@@ -2230,94 +2462,294 @@ var render = (game) => {
   return rows.map((row) => row.join(""));
 };
 
+// src/snake-play.ts
+var TICK_MS = 140;
+var COUNTDOWN_STEP_MS = 1e3;
+var COUNTDOWN = { kind: "countdown", step: 3 };
+var RUNNING = { kind: "running" };
+var PAUSED = { kind: "paused" };
+var READY = { kind: "ready" };
+var newSnakePlay = (width, height, random) => ({
+  game: newSnakeGame(width, height, random),
+  clock: READY,
+  focused: false,
+  width,
+  height
+});
+var countDown = (play, random) => ({
+  ...play,
+  game: play.game.over ? newSnakeGame(play.width, play.height, random) : play.game,
+  clock: COUNTDOWN
+});
+var reduceSnake = (play, event, random) => {
+  switch (event.type) {
+    case "focus":
+      return play.focused ? play : { ...countDown(play, random), focused: true };
+    case "blur": {
+      if (!play.focused) return play;
+      const clock = play.clock.kind === "running" ? PAUSED : play.clock.kind === "countdown" ? READY : play.clock;
+      return { ...play, focused: false, clock };
+    }
+    case "resize": {
+      if (event.width === play.width && event.height === play.height) return play;
+      return {
+        ...play,
+        width: event.width,
+        height: event.height,
+        game: newSnakeGame(event.width, event.height, random),
+        clock: play.clock.kind === "running" ? COUNTDOWN : play.clock
+      };
+    }
+    case "count": {
+      if (!play.focused || play.clock.kind !== "countdown") return play;
+      const { step } = play.clock;
+      return {
+        ...play,
+        clock: step === 0 ? RUNNING : { kind: "countdown", step: step === 3 ? 2 : step === 2 ? 1 : 0 }
+      };
+    }
+    case "tick": {
+      if (!play.focused || play.clock.kind !== "running") return play;
+      const game = tick(play.game, random);
+      return { ...play, game, clock: game.over ? READY : play.clock };
+    }
+    case "steer": {
+      if (!play.focused) return play;
+      if (play.game.over) return countDown(play, random);
+      const game = turn(play.game, event.direction);
+      return play.clock.kind === "running" || play.clock.kind === "countdown" ? { ...play, game } : { ...play, game, clock: COUNTDOWN };
+    }
+    case "togglePause":
+      if (!play.focused) return play;
+      return play.clock.kind === "running" || play.clock.kind === "countdown" ? { ...play, clock: PAUSED } : countDown(play, random);
+    case "play":
+      if (!play.focused || play.clock.kind === "running" || play.clock.kind === "countdown") {
+        return play;
+      }
+      return countDown(play, random);
+  }
+};
+var KEY_DIRECTIONS = {
+  up: "up",
+  down: "down",
+  left: "left",
+  right: "right",
+  k: "up",
+  j: "down",
+  h: "left",
+  l: "right"
+};
+var snakeKey = (name) => {
+  const direction = KEY_DIRECTIONS[name];
+  if (direction !== void 0) return { type: "steer", direction };
+  if (name === "space" || name === "p") return { type: "togglePause" };
+  if (name === "return" || name === "linefeed") return { type: "play" };
+  if (name === "escape" || name === "q") return { type: "leave" };
+  return null;
+};
+var snakeHints = (play) => play.game.over ? "enter/arrows again \xB7 esc/q leave" : play.clock.kind === "paused" || play.clock.kind === "ready" ? "enter/space resume \xB7 esc/q leave" : "\u2190\u2191\u2193\u2192/hjkl steer \xB7 space/p pause \xB7 esc/q leave";
+var SEGMENTS = {
+  "1": "bc",
+  "2": "abdeg",
+  "3": "abcdg",
+  G: "acdef",
+  O: "abcdef"
+};
+var glyphPixels = (char, length, thickness) => {
+  const lit = new Set(SEGMENTS[char] ?? "");
+  const on = (...segments) => segments.some((segment) => lit.has(segment));
+  const width = length + 2 * thickness;
+  const height = 2 * length + 3 * thickness;
+  const column = (x) => x < thickness ? "left" : x < thickness + length ? "middle" : "right";
+  const row = (y) => y < thickness ? "top" : y < thickness + length ? "upper" : y < 2 * thickness + length ? "centre" : y < 2 * thickness + 2 * length ? "lower" : "bottom";
+  const pixel = (x, y) => {
+    const where = `${column(x)} ${row(y)}`;
+    switch (where) {
+      case "middle top":
+        return on("a");
+      case "middle centre":
+        return on("g");
+      case "middle bottom":
+        return on("d");
+      case "left upper":
+        return on("f");
+      case "right upper":
+        return on("b");
+      case "left lower":
+        return on("e");
+      case "right lower":
+        return on("c");
+      case "left top":
+        return on("a", "f");
+      case "right top":
+        return on("a", "b");
+      case "left centre":
+        return on("f", "e", "g");
+      case "right centre":
+        return on("b", "c", "g");
+      case "left bottom":
+        return on("e", "d");
+      case "right bottom":
+        return on("c", "d");
+      default:
+        return false;
+    }
+  };
+  return Array.from(
+    { length: height },
+    (_row, y) => Array.from({ length: width }, (_cell, x) => pixel(x, y))
+  );
+};
+var halfBlocks = (pixels) => {
+  const rows = [];
+  for (let y = 0; y < pixels.length; y += 2) {
+    const top = pixels[y] ?? [];
+    const bottom = pixels[y + 1] ?? [];
+    rows.push(
+      top.map((upper, x) => {
+        const lower = bottom[x] === true;
+        return upper && lower ? "\u2588" : upper ? "\u2580" : lower ? "\u2584" : " ";
+      }).join("")
+    );
+  }
+  return rows;
+};
+var drawLabel = (label, length, thickness) => {
+  const glyphs = [...label].map((char) => glyphPixels(char, length, thickness));
+  const gap = Array.from({ length: thickness }, () => false);
+  const height = 2 * length + 3 * thickness;
+  const pixels = Array.from(
+    { length: height },
+    (_, y) => glyphs.flatMap((glyph, index) => index === 0 ? glyph[y] : [...gap, ...glyph[y]])
+  );
+  const lit = (x) => pixels.some((line) => line[x] === true);
+  const width = pixels[0]?.length ?? 0;
+  let first = 0;
+  while (first < width && !lit(first)) first += 1;
+  let last = width - 1;
+  while (last > first && !lit(last)) last -= 1;
+  return halfBlocks(pixels.map((line) => line.slice(first, last + 1)));
+};
+var countdownLabel = (step) => step === 0 ? "GO" : String(step);
+var MAX_SEGMENT = 12;
+var countdownArt = (label, cols, rows) => {
+  const marginRows = Math.floor(rows / 8);
+  const marginCols = cols >= 12 ? 1 : 0;
+  const fitRows = rows - 2 * marginRows;
+  const fitCols = cols - 2 * marginCols;
+  for (let length = MAX_SEGMENT; length >= 1; length -= 1) {
+    const thickness = length >= 5 ? 2 : 1;
+    const art = drawLabel(label, length, thickness);
+    if (art.length <= fitRows && (art[0]?.length ?? 0) <= fitCols) return art;
+  }
+  return label.length <= cols ? [label] : [label.slice(0, Math.max(1, cols))];
+};
+var overlayArt = (board, art) => {
+  const height = board.length;
+  const width = [...board[0] ?? ""].length;
+  const artWidth = Math.max(0, ...art.map((line) => [...line].length));
+  const top = Math.floor((height - art.length) / 2);
+  const left = Math.floor((width - artWidth) / 2);
+  return board.map((line, y) => {
+    const artLine = art[y - top];
+    const artCells = artLine === void 0 ? [] : [...artLine];
+    return [...line].map((cell, x) => {
+      const char = artCells[x - left];
+      return { board: cell, art: char === void 0 || char === " " ? null : char };
+    });
+  });
+};
+
 // src/snake.tsx
+import { useEffect as useEffect2, useState as useState2 } from "react";
 import { Fragment as Fragment2, jsx as jsx2, jsxs as jsxs2 } from "@opentui/react/jsx-runtime";
-var TICK_MS = 140;
 var useSnake = (options) => {
-  const { width, height, enabled } = options;
-  const [game, setGame] = useState2(() => newSnakeGame(width, height, Math.random));
-  const [paused, setPaused] = useState2(false);
+  const { width, height, focused } = options;
+  const [stored, setPlay] = useState2(() => newSnakePlay(width, height, Math.random));
+  let play = reduceSnake(stored, { type: "resize", width, height }, Math.random);
+  if (play.focused !== focused) {
+    play = reduceSnake(play, { type: focused ? "focus" : "blur" }, Math.random);
+  }
+  if (play !== stored) setPlay(play);
+  const { clock } = play;
+  const step = clock.kind === "countdown" ? clock.step : null;
   useEffect2(() => {
-    if (enabled) {
-      setGame(newSnakeGame(width, height, Math.random));
-      setPaused(false);
+    if (clock.kind === "countdown") {
+      const timer2 = setTimeout(
+        () => setPlay((current) => reduceSnake(current, { type: "count" }, Math.random)),
+        COUNTDOWN_STEP_MS
+      );
+      return () => clearTimeout(timer2);
     }
-  }, [width, height, enabled]);
-  useEffect2(() => {
-    if (!enabled || paused) return;
-    const timer = setInterval(() => setGame((current) => tick(current, Math.random)), TICK_MS);
-    return () => clearInterval(timer);
-  }, [enabled, paused]);
-  const steer = (direction) => {
-    setPaused(false);
-    setGame(
-      (current) => current.over ? newSnakeGame(current.width, current.height, Math.random) : turn(current, direction)
+    if (clock.kind !== "running") return;
+    const timer = setInterval(
+      () => setPlay((current) => reduceSnake(current, { type: "tick" }, Math.random)),
+      TICK_MS
     );
-  };
-  const togglePause = () => setPaused((current) => !current);
-  return { game, paused, steer, togglePause };
+    return () => clearInterval(timer);
+  }, [clock.kind, step]);
+  const send = (event) => setPlay((current) => reduceSnake(current, event, Math.random));
+  return { play, send };
 };
-var SnakeHeading = ({
-  handle,
-  hint
-}) => {
-  const { game, paused } = handle;
-  const state = game.over ? "over \xB7 any arrow starts again" : paused ? "paused" : null;
-  return /* @__PURE__ */ jsxs2(Fragment2, { children: [
-    /* @__PURE__ */ jsxs2("text", { height: 1, bg: "transparent", children: [
-      /* @__PURE__ */ jsx2("span", { children: "  " }),
-      /* @__PURE__ */ jsx2("span", { fg: INK, children: "play snake while you wait" }),
-      /* @__PURE__ */ jsx2("span", { fg: FAINT, children: " \xB7 score " }),
-      /* @__PURE__ */ jsx2("span", { fg: game.over ? MUTED : ACCENT, children: String(game.score) }),
-      state === null ? null : /* @__PURE__ */ jsx2("span", { fg: FAINT, children: ` \xB7 ${state}` })
-    ] }),
-    /* @__PURE__ */ jsx2("text", { height: 1, bg: "transparent", fg: FAINT, children: `  ${hint}` })
+var SnakeHeading = ({ play }) => {
+  const { game, clock } = play;
+  const state = game.over ? "over" : clock.kind === "paused" ? "paused" : null;
+  return /* @__PURE__ */ jsxs2("text", { height: 1, bg: "transparent", children: [
+    /* @__PURE__ */ jsx2("span", { children: "  " }),
+    /* @__PURE__ */ jsx2("span", { fg: INK, children: "play snake while you wait" }),
+    /* @__PURE__ */ jsx2("span", { fg: FAINT, children: " \xB7 score " }),
+    /* @__PURE__ */ jsx2("span", { fg: game.over ? MUTED : ACCENT, children: String(game.score) }),
+    state === null ? null : /* @__PURE__ */ jsx2("span", { fg: FAINT, children: ` \xB7 ${state}` })
   ] });
 };
+var SNAKE_IDLE = "enter plays";
+var snakeTooSmall = (short) => `make the terminal ${short ? "taller" : "wider"} to play snake`;
+var SNAKE_BEHIND_DIALOG = "the countdown starts when this dialog closes";
+var SnakeFooter = ({
+  play,
+  idle
+}) => /* @__PURE__ */ jsx2("text", { height: 1, bg: "transparent", fg: FAINT, children: `  ${play.focused ? snakeHints(play) : idle}` });
+var cellColor = (cell) => cell === "\u25C6" ? ACCENT : cell === "\u2588" ? GREEN : cell === "\u25CF" ? INK : FAINT;
+var SnakeRows = ({ play }) => {
+  const { game, clock } = play;
+  const board = render(game);
+  if (clock.kind !== "countdown") {
+    return /* @__PURE__ */ jsx2(Fragment2, { children: board.map((row, index) => /* @__PURE__ */ jsx2("text", { height: 1, bg: "transparent", children: [...row].map((cell, x) => /* @__PURE__ */ jsx2("span", { fg: cellColor(cell), children: cell === "\xB7" ? " " : cell }, x)) }, index)) });
+  }
+  const cells = overlayArt(
+    board,
+    countdownArt(countdownLabel(clock.step), game.width, game.height)
+  );
+  return /* @__PURE__ */ jsx2(Fragment2, { children: cells.map((row, index) => /* @__PURE__ */ jsx2("text", { height: 1, bg: "transparent", children: row.map(
+    (cell, x) => cell.board !== "\xB7" || cell.art === null ? /* @__PURE__ */ jsx2("span", { fg: cellColor(cell.board), children: cell.board === "\xB7" ? " " : cell.board }, x) : /* @__PURE__ */ jsx2("span", { fg: ACCENT, children: cell.art }, x)
+  ) }, index)) });
+};
 var SnakeBoard = ({
   handle,
-  focused
+  idle
 }) => {
-  const { game } = handle;
-  const rows = render(game);
+  const { play } = handle;
   return /* @__PURE__ */ jsxs2(Fragment2, { children: [
-    /* @__PURE__ */ jsx2(
-      SnakeHeading,
-      {
-        handle,
-        hint: focused ? "arrows steer \xB7 space pauses \xB7 esc puts it away" : "focus this pane to play \xB7 esc puts it away"
-      }
-    ),
+    /* @__PURE__ */ jsx2(SnakeHeading, { play }),
     /* @__PURE__ */ jsx2(
       "box",
       {
         border: true,
         borderStyle: "rounded",
-        borderColor: focused ? ACCENT : RULE,
-        width: game.width + 2,
-        height: game.height + 2,
+        borderColor: play.focused ? ACCENT : RULE,
+        title: " snake ",
+        titleAlignment: "left",
+        width: play.game.width + 2,
+        height: play.game.height + 2,
         flexShrink: 0,
         marginLeft: 2,
-        children: rows.map((row, index) => /* @__PURE__ */ jsx2("text", { height: 1, bg: "transparent", children: [...row].map((cell, x) => /* @__PURE__ */ jsx2(
-          "span",
-          {
-            fg: cell === "\u25C6" ? ACCENT : cell === "\u2588" ? GREEN : cell === "\u25CF" ? INK : FAINT,
-            children: cell === "\xB7" ? " " : cell
-          },
-          x
-        )) }, index))
+        flexDirection: "column",
+        children: /* @__PURE__ */ jsx2(SnakeRows, { play })
       }
-    )
+    ),
+    /* @__PURE__ */ jsx2(SnakeFooter, { play, idle })
   ] });
 };
-var SnakeRows = ({ game }) => /* @__PURE__ */ jsx2(Fragment2, { children: render(game).map((row, index) => /* @__PURE__ */ jsx2("text", { height: 1, bg: "transparent", children: [...row].map((cell, x) => /* @__PURE__ */ jsx2(
-  "span",
-  {
-    fg: cell === "\u25C6" ? ACCENT : cell === "\u2588" ? GREEN : cell === "\u25CF" ? INK : FAINT,
-    children: cell === "\xB7" ? " " : cell
-  },
-  x
-)) }, index)) });
 
 // src/dashboard.tsx
 import { Fragment as Fragment3, jsx as jsx3, jsxs as jsxs3 } from "@opentui/react/jsx-runtime";
@@ -2351,12 +2783,6 @@ var lastSessionWords = (group) => {
   return [group.sessions.length === 0 ? `created ${ago}` : `last session created ${ago}`];
 };
 var fit = (text, width) => text.length <= width ? text : `${text.slice(0, Math.max(0, width - 1))}\u2026`;
-var COLUMN_TITLE = {
-  projects: "projects",
-  worktrees: "worktrees",
-  sessions: "sessions",
-  detail: "session"
-};
 var WORKTREE_ROW_HEIGHT = 2;
 var SESSION_ROW_HEIGHT = 2;
 var Gutter = ({ selected }) => /* @__PURE__ */ jsx3("span", { fg: selected ? ACCENT : FAINT, children: selected ? "\u258C " : "  " });
@@ -2470,11 +2896,12 @@ var SessionRow = ({
 var HarnessRow = ({
   item,
   selected,
-  background
+  background,
+  width
 }) => /* @__PURE__ */ jsx3("box", { height: 1, flexShrink: 0, backgroundColor: selected ? WASH : background, children: /* @__PURE__ */ jsxs3("text", { height: 1, bg: selected ? WASH : background, children: [
   /* @__PURE__ */ jsx3(Gutter, { selected }),
   /* @__PURE__ */ jsx3("span", { fg: INK, children: item.label.padEnd(12) }),
-  /* @__PURE__ */ jsx3("span", { fg: FAINT, children: item.hint })
+  /* @__PURE__ */ jsx3("span", { fg: FAINT, children: fit(item.hint, Math.max(4, width - 2 - 12)) })
 ] }) });
 var PREVIEW_GLYPH = {
   user: "\u203A ",
@@ -2620,10 +3047,23 @@ var keepSpanVisible = (scroll, top, height, viewRows) => {
 };
 var PREVIEW_MAX_LINES = 300;
 var SESSION_FACT_ROWS = 6;
+var SNAKE_CHROME_ROWS = 5;
+var SNAKE_MIN_BOARD_ROWS = 4;
+var SNAKE_MIN_BOARD_COLS = 8;
+var SNAKE_MIN_PANE_ROWS = SNAKE_CHROME_ROWS + SNAKE_MIN_BOARD_ROWS;
+var SNAKE_MIN_PANE_COLS = SNAKE_MIN_BOARD_COLS + 4;
 var noShare = () => "off";
 var NO_TUNNELS = [];
 var noTunnels = () => NO_TUNNELS;
-var App = ({ ctx, onQuit }) => {
+var NO_FILTERS = {
+  projects: "",
+  worktrees: "",
+  sessions: ""
+};
+var App = ({
+  ctx,
+  onQuit
+}) => {
   const renderer = useRenderer();
   const queryClient = useQueryClient2();
   const { data, failureReason } = useQuery2({
@@ -2633,8 +3073,13 @@ var App = ({ ctx, onQuit }) => {
     retry: true,
     retryDelay: 1e3
   });
-  const [focus, setFocusState] = useState3("sessions");
+  const [columnFocus, setFocusState] = useState3("sessions");
   const [lastNav, setLastNav] = useState3("sessions");
+  const [screenMode, setScreenMode] = useState3("normal");
+  const [filters, setFilters] = useState3(NO_FILTERS);
+  const [filtering, setFiltering] = useState3(null);
+  const [helpOpen, setHelpOpen] = useState3(false);
+  const [helpOffset, setHelpOffset] = useState3(0);
   const [projectKey, setProjectKey] = useState3(null);
   const [worktreeKey, setWorktreeKey] = useState3(null);
   const [sessionKey, setSessionKey] = useState3(null);
@@ -2661,12 +3106,16 @@ var App = ({ ctx, onQuit }) => {
   const adoptOfferDecided = useRef2(false);
   const [reviewing, setReviewing] = useState3(null);
   const lockRef = useRef2(false);
+  const [snakeFocus, setSnakeFocus] = useState3(null);
+  const [snakeOverlay, setSnakeOverlay] = useState3(ctx.openSnake === true);
   const [gate] = useState3(createLaunchGate);
   const creatingRef = useRef2(creating);
   creatingRef.current = creating;
   const branchRequest = useRef2(0);
   const { width: terminalCols, height: terminalRows } = useTerminalDimensions2();
-  const projectItems = deriveProjects(data);
+  const projectItems = deriveProjects(data).filter(
+    (item) => matchesFilter(filters.projects, item.project.name)
+  );
   const homeProject = data === void 0 ? void 0 : matchProjectByCwd(data.projects, cwdFacts(ctx.cwd));
   const projectIndexRaw = projectKey === null ? -1 : projectItems.findIndex((p) => p.project.id === projectKey);
   const projectIndex = projectIndexRaw === -1 ? Math.max(
@@ -2674,20 +3123,38 @@ var App = ({ ctx, onQuit }) => {
     homeProject === void 0 ? 0 : projectItems.findIndex((p) => p.project.id === homeProject.id)
   ) : projectIndexRaw;
   const selectedProject = projectItems[projectIndex] ?? null;
-  const worktreeGroups = deriveWorktrees(data, selectedProject?.project.id ?? null);
+  const worktreeGroups = deriveWorktrees(data, selectedProject?.project.id ?? null).filter(
+    (group) => matchesFilter(filters.worktrees, group.name, groupBaseLabel(group))
+  );
   const worktreeIndexRaw = worktreeKey === null ? -1 : worktreeGroups.findIndex((group) => group.key === worktreeKey);
   const sessionWorktreeIndex = worktreeGroups.findIndex(
     (group) => group.sessions.some((item) => item.session.id === sessionKey)
   );
   const worktreeIndex = worktreeIndexRaw === -1 ? Math.max(0, sessionWorktreeIndex) : worktreeIndexRaw;
   const selectedGroup = worktreeGroups[worktreeIndex] ?? null;
-  const sessionItems = selectedGroup?.sessions ?? [];
+  const sessionItems = (selectedGroup?.sessions ?? []).filter(
+    (item) => matchesFilter(
+      filters.sessions,
+      sessionDisplayName(item.session),
+      item.session.harness,
+      item.session.status
+    )
+  );
   const sessionIndexRaw = sessionKey === null ? -1 : sessionItems.findIndex((item) => item.session.id === sessionKey);
   const sessionIndex = sessionIndexRaw === -1 ? 0 : sessionIndexRaw;
   const selectedItem = sessionItems[sessionIndex] ?? null;
   const selectedSession = selectedItem?.session ?? null;
-  const pickerItems = picker === null ? [] : deriveHarnesses(picker.session);
-  const layout = planLayout(terminalCols, terminalRows, focus, lastNav);
+  const pickerItems = picker === null ? [] : deriveHarnesses(picker.session, picker.worktree?.name ?? null);
+  const waiting = selectedSession !== null && (selectedSession.status === "starting" || isPendingId(selectedSession.id));
+  const dialogOpen = picker !== null || editing !== null || creating !== null || adoptOffer !== null || reviewing !== null || helpOpen || filtering !== null;
+  const gameLayout = planLayout(terminalCols, terminalRows, "detail", lastNav);
+  const snakeFits = gameLayout.detailRows >= SNAKE_MIN_PANE_ROWS && gameLayout.detailWidth >= SNAKE_MIN_PANE_COLS;
+  const overlayFits = terminalRows >= 12 && terminalCols >= 22;
+  const overlayOpen = snakeOverlay && !dialogOpen;
+  const overlayFocused = overlayOpen && overlayFits;
+  const snakeFocused = snakeFocus !== null && waiting && snakeFits && !dialogOpen && !snakeOverlay;
+  const focus = snakeFocused ? "detail" : columnFocus;
+  const layout = planLayout(terminalCols, terminalRows, focus, lastNav, screenMode);
   const detailWidth = layout.detailWidth;
   const sectionRows = (section) => layout.sections.find((entry) => entry.section === section)?.rows ?? 0;
   const previewSessionId = selectedSession !== null && !isPendingId(selectedSession.id) ? selectedSession.id : null;
@@ -2738,27 +3205,28 @@ var App = ({ ctx, onQuit }) => {
     [transcript.data, detailWidth]
   );
   const [previewOffset, setPreviewOffset] = useState3(0);
-  const factRows = Math.max(
+  const allFactRows = Math.max(
     0,
     Math.min(SESSION_FACT_ROWS + workspaceRows.length, layout.detailRows - 2)
   );
+  const factRows = waiting ? Math.max(0, Math.min(allFactRows, layout.detailRows - SNAKE_MIN_PANE_ROWS - 1)) : allFactRows;
   const showFactRule = factRows > 0 && layout.detailRows - factRows > 1;
-  const waiting = selectedSession !== null && (selectedSession.status === "starting" || isPendingId(selectedSession.id));
+  const snakeRoom = {
+    cols: detailWidth - 4,
+    rows: layout.detailRows - factRows - (showFactRule ? 1 : 0) - SNAKE_CHROME_ROWS
+  };
+  const snakeShown = snakeRoom.rows >= SNAKE_MIN_BOARD_ROWS && snakeRoom.cols >= SNAKE_MIN_BOARD_COLS;
   const snake = useSnake({
-    width: Math.max(8, Math.min(40, detailWidth - 4)),
-    // The pane minus the facts, the rule, the starting line, two lines of hints and the border.
-    height: Math.max(4, Math.min(14, layout.detailRows - factRows - 8)),
-    enabled: waiting
+    width: Math.max(SNAKE_MIN_BOARD_COLS, Math.min(40, snakeRoom.cols)),
+    height: Math.max(SNAKE_MIN_BOARD_ROWS, Math.min(14, snakeRoom.rows)),
+    focused: snakeFocused
   });
-  const [snakeAwayFor, setSnakeAwayFor] = useState3(null);
-  const snakeShown = waiting && snakeAwayFor !== selectedSession?.id;
-  const [snakeOverlay, setSnakeOverlay] = useState3(ctx.openSnake === true);
   const overlayWidth = Math.max(16, Math.min(60, terminalCols - 8));
   const overlayHeight = Math.max(6, Math.min(20, terminalRows - 10));
   const overlaySnake = useSnake({
     width: overlayWidth,
     height: overlayHeight,
-    enabled: snakeOverlay
+    focused: overlayFocused
   });
   const previewRows = Math.max(1, layout.detailRows - factRows - (showFactRule ? 1 : 0));
   const previewView = previewWindow(preview, previewRows, previewOffset);
@@ -2771,6 +3239,9 @@ var App = ({ ctx, onQuit }) => {
     setPreviewOffset(0);
   };
   const say = (text) => setStatus({ text, at: Date.now() });
+  const clearFilters = (...sections) => setFilters(
+    (current) => sections.every((section) => current[section] === "") ? current : { ...current, ...Object.fromEntries(sections.map((section) => [section, ""])) }
+  );
   const refetch = () => void queryClient.invalidateQueries({ queryKey: WORKBENCH_KEY });
   useEffect3(() => {
     const share = ctx.agentShare;
@@ -2909,6 +3380,7 @@ ${tunneled}
           createdAt: (/* @__PURE__ */ new Date()).toISOString()
         })
       );
+      clearFilters("worktrees", "sessions");
       setWorktreeKey(vars.pendingKey);
       selectSession(vars.pendingKey);
       setBusy(`provisioning ${vars.harness} workspace \xB7`);
@@ -2916,6 +3388,7 @@ ${tunneled}
     },
     onError: (error, vars) => {
       patchWorkbench((current) => removeSession(current, vars.projectId, vars.pendingKey));
+      setSnakeFocus((current) => current?.start === vars.gateKey ? null : current);
       setBusy(null);
       say(errorText(error));
     },
@@ -2956,7 +3429,8 @@ ${tunneled}
       );
       setBusyStarted(Date.now());
     },
-    onError: (error) => {
+    onError: (error, vars) => {
+      setSnakeFocus((current) => current?.start === vars.gateKey ? null : current);
       setBusy(null);
       say(errorText(error));
       refetch();
@@ -3014,6 +3488,7 @@ ${tunneled}
         return;
       }
       const project = result.project;
+      clearFilters("projects");
       say(`adopted \xB7 ${project.name} \xB7 w starts a worktree`);
       setProjectKey(project.id);
       setWorktreeKey(null);
@@ -3101,12 +3576,14 @@ ${tunneled}
           createdAt: (/* @__PURE__ */ new Date()).toISOString()
         })
       );
+      clearFilters("sessions");
       selectSession(vars.pendingKey);
       setBusy(`starting ${vars.harness} in the worktree \xB7`);
       setBusyStarted(Date.now());
     },
     onError: (error, vars) => {
       patchWorkbench((current) => removeSession(current, vars.projectId, vars.pendingKey));
+      setSnakeFocus((current) => current?.start === vars.gateKey ? null : current);
       setBusy(null);
       say(errorText(error));
     },
@@ -3333,6 +3810,7 @@ ${tunneled}
       return;
     }
     setCreating(null);
+    setSnakeFocus({ returnTo: focus, start: gateKey });
     setFocus("sessions");
     launchMutation.mutate({
       projectId: current.projectId,
@@ -3406,6 +3884,7 @@ ${tunneled}
       say(`already resuming \xB7 ${sessionDisplayName(session)}`);
       return;
     }
+    setSnakeFocus({ returnTo: focus, start: gateKey });
     setFocus("sessions");
     resumeMutation.mutate({ projectId, session, harness, gateKey });
   };
@@ -3437,6 +3916,7 @@ ${tunneled}
       say(`already starting a session in ${group.name}`);
       return;
     }
+    setSnakeFocus({ returnTo: focus, start: gateKey });
     setFocus("sessions");
     launchInWorktreeMutation.mutate({
       projectId,
@@ -3485,34 +3965,34 @@ ${tunneled}
         return;
     }
   };
-  const moveColumn = (delta) => setFocus(stepColumn(focus, delta));
+  const goTo = (next) => {
+    if (next === "detail" && waiting && snakeFits) {
+      setSnakeFocus({ returnTo: focus, start: null });
+      return;
+    }
+    setFocus(next);
+  };
+  const moveColumn = (delta) => goTo(stepColumn(focus, delta));
   useKeyboard2((key) => {
     if (reviewing !== null) return;
     if (lockRef.current) return;
     if (key.ctrl && key.name === "c") return onQuit();
-    if (snakeOverlay) {
-      if (key.name === "up" || key.name === "down" || key.name === "left" || key.name === "right") {
-        overlaySnake.steer(key.name);
-      } else if (key.name === "space") {
-        overlaySnake.togglePause();
-      } else if (key.name === "escape" || key.name === "q") {
-        setSnakeOverlay(false);
-      }
-      return;
-    }
-    if (waiting && focus === "detail" && picker === null && editing === null && creating === null) {
-      if (snakeShown) {
-        if (key.name === "up" || key.name === "down" || key.name === "left" || key.name === "right") {
-          snake.steer(key.name);
-          return;
+    const verb = verbForKey(strokeName(key), key.shift === true);
+    const game = overlayFocused ? overlaySnake : snakeFocused ? snake : null;
+    if (game !== null || overlayOpen) {
+      const action = snakeKey(key.name ?? "");
+      if (action?.type === "leave") {
+        if (overlayOpen) {
+          setSnakeOverlay(false);
+        } else if (snakeFocus !== null) {
+          setFocus(snakeFocus.returnTo);
+          setSnakeFocus(null);
         }
-        if (key.name === "space") return snake.togglePause();
-        if (key.name === "escape") return setSnakeAwayFor(selectedSession?.id ?? null);
-      } else if (key.name === "space") {
-        return setSnakeAwayFor(null);
+        return;
       }
+      if (action !== null) return game?.send(action);
+      if (gameSwallows(verb) || game === null) return;
     }
-    const verb = verbForKey(key.name ?? "", key.shift === true);
     if (verb !== "stop") setStopArmed(null);
     if (verb !== "remove") setRemoveArmed(null);
     if (adoptOffer !== null) {
@@ -3587,6 +4067,26 @@ ${tunneled}
       }
       return;
     }
+    if (helpOpen) {
+      if (key.name === "escape" || key.name === "q" || verb === "help") {
+        setHelpOpen(false);
+      } else if (verb === "moveDown" || verb === "pageDown") {
+        setHelpOffset(
+          (current) => Math.max(0, Math.min(helpMaxOffset, current + (verb === "pageDown" ? 10 : 1)))
+        );
+      } else if (verb === "moveUp" || verb === "pageUp") {
+        setHelpOffset((current) => Math.max(0, current - (verb === "pageUp" ? 10 : 1)));
+      }
+      return;
+    }
+    if (filtering !== null) {
+      if (key.name === "escape") {
+        clearFilters(filtering);
+        setFiltering(null);
+      } else if (key.name === "down") moveSelection(1);
+      else if (key.name === "up") moveSelection(-1);
+      return;
+    }
     if (picker !== null) {
       switch (key.name) {
         case "down":
@@ -3619,6 +4119,10 @@ ${tunneled}
           return;
       }
     }
+    if (snakeFocus !== null && verb !== null) setSnakeFocus(null);
+    if (key.name === "space" && waiting && snakeFits && focus === "detail") {
+      return setSnakeFocus({ returnTo: focus, start: null });
+    }
     if (key.ctrl === true) return;
     if (focus === "projects" && ["attach", "resume", "stop", "remove", "rename", "openWeb", "review"].includes(verb ?? "")) {
       say("select a session first \xB7 \u2192 opens worktrees");
@@ -3639,6 +4143,37 @@ ${tunneled}
         return moveColumn(1);
       case "columnLeft":
         return moveColumn(-1);
+      case "nextPane":
+        return goTo(cyclePane(focus, 1));
+      case "prevPane":
+        return goTo(cyclePane(focus, -1));
+      case "jumpProjects":
+      case "jumpWorktrees":
+      case "jumpSessions":
+      case "jumpDetail":
+        return goTo(paneForDigit(strokeName(key)) ?? focus);
+      case "back":
+        if (isNavSection(focus) && filters[focus] !== "") {
+          clearFilters(focus);
+          return;
+        }
+        return goTo(backFrom(focus, lastNav));
+      case "filter":
+        if (!isNavSection(focus)) {
+          say("/ filters a list \xB7 1 2 3 jump to one");
+          return;
+        }
+        return setFiltering(focus);
+      case "nextScreenMode":
+      case "prevScreenMode": {
+        const next = stepScreenMode(screenMode, verb === "nextScreenMode" ? 1 : -1);
+        setScreenMode(next);
+        say(`screen mode \xB7 ${next}${next === "normal" ? "" : " \xB7 + and _ cycle it"}`);
+        return;
+      }
+      case "help":
+        setHelpOffset(0);
+        return setHelpOpen(true);
       case "attach":
         return attachSelected();
       case "resume":
@@ -3695,18 +4230,20 @@ ${tunneled}
   });
   const liveTotal = projectItems.reduce((sum, item) => sum + item.live, 0);
   const stoppingTotal = projectItems.reduce((sum, item) => sum + item.stopping, 0);
-  const columnTitle = (column) => {
+  const named = (section) => filters[section] === "" ? section : `${section} /${filters[section]}`;
+  const columnTitle = (column) => numberedTitle(column, columnWords(column));
+  const columnWords = (column) => {
     if (column === "worktrees") {
-      return selectedProject === null ? "worktrees" : `worktrees \xB7 ${worktreeGroups.length}${selectedProject.live > 0 ? ` \xB7 ${selectedProject.live} live` : ""}`;
+      return selectedProject === null ? named("worktrees") : `${named("worktrees")} \xB7 ${worktreeGroups.length}${selectedProject.live > 0 ? ` \xB7 ${selectedProject.live} live` : ""}`;
     }
     if (column === "sessions") {
-      return selectedGroup === null ? "sessions" : `sessions \xB7 ${sessionItems.length}`;
+      return selectedGroup === null ? named("sessions") : `${named("sessions")} \xB7 ${sessionItems.length}`;
     }
     if (column === "detail") {
       if (selectedSession === null) return "session";
       return previewView.offset === 0 ? "session \xB7 read-only" : `session \xB7 read-only \xB7 ${previewView.later} newer below`;
     }
-    return COLUMN_TITLE[column];
+    return named("projects");
   };
   const pickerTitle = picker === null ? "" : picker.worktree === void 0 ? picker.session === null ? "new session \xB7 pick a harness" : `resume ${sessionDisplayName(picker.session)} \xB7 pick a harness` : `new session in ${picker.worktree.name} \xB7 pick a harness`;
   const modalWidth = Math.min(74, terminalCols - 4);
@@ -3726,7 +4263,20 @@ ${tunneled}
     modalWidth - 7
   );
   const creatingHeight = 2 + 1 + 1 + 6 + 1 + deriveHarnesses(null).length;
-  const footerText = adoptOffer === null ? editing === null ? creating === null ? picker === null ? ` ${fitHints(verbHints(focus), Math.max(12, terminalCols - 2))}` : " \u2191\u2193 move \xB7 enter start \xB7 esc cancel" : creating.step === "name" ? " enter continue \xB7 esc cancel" : creating.step === "base" ? " type to filter \xB7 \u2191\u2193 move \xB7 enter choose base \xB7 esc back" : " \u2191\u2193 move \xB7 enter launch \xB7 esc back" : " enter save \xB7 esc cancel" : " enter adopt \xB7 \u2190\u2192 auth mode \xB7 esc not now";
+  const modalFieldWidth = Math.max(4, modalWidth - 2 - 11 - 1);
+  const footerText = adoptOffer === null ? editing === null ? creating === null ? picker === null ? overlayFocused || snakeFocused ? ` ${snakeHints(overlayFocused ? overlaySnake.play : snake.play)}` : ` ${footerHints(focus, Math.max(12, terminalCols - 2))}` : " \u2191\u2193 move \xB7 enter start \xB7 esc cancel" : creating.step === "name" ? " enter continue \xB7 esc cancel" : creating.step === "base" ? " type to filter \xB7 \u2191\u2193 move \xB7 enter choose base \xB7 esc back" : " \u2191\u2193 move \xB7 enter launch \xB7 esc back" : " enter save \xB7 esc cancel" : " enter adopt \xB7 \u2190\u2192 auth mode \xB7 esc not now";
+  const helpWidth = Math.min(96, terminalCols - 4);
+  const helpLines = helpSections(focus).flatMap((section, index) => [
+    ...index === 0 ? [] : [{ kind: "blank", key: `blank-${section.title}` }],
+    { kind: "title", key: `title-${section.title}`, text: section.title },
+    ...section.rows.map((row) => ({ kind: "row", key: row.verb, row }))
+  ]);
+  const helpRows = Math.max(1, Math.min(helpLines.length, terminalRows - 6));
+  const helpMaxOffset = Math.max(0, helpLines.length - helpRows);
+  const helpView = helpLines.slice(
+    Math.min(helpOffset, helpMaxOffset),
+    Math.min(helpOffset, helpMaxOffset) + helpRows
+  );
   const loadFailure = data === void 0 && failureReason !== null ? errorText(failureReason) : null;
   if (reviewing !== null) {
     return /* @__PURE__ */ jsx3(
@@ -3811,7 +4361,12 @@ ${tunneled}
                     },
                     item.project.id
                   )),
-                  data !== void 0 && projectItems.length === 0 ? /* @__PURE__ */ jsx3(EmptyNote, { text: "none adopted yet" }) : null
+                  data !== void 0 && projectItems.length === 0 ? /* @__PURE__ */ jsx3(
+                    EmptyNote,
+                    {
+                      text: filters.projects === "" ? "none adopted yet" : `nothing matches /${filters.projects} \xB7 esc clears`
+                    }
+                  ) : null
                 ]
               }
             )
@@ -3843,7 +4398,12 @@ ${tunneled}
                     },
                     group.key
                   )),
-                  data !== void 0 && worktreeGroups.length === 0 ? /* @__PURE__ */ jsx3(EmptyNote, { text: "no worktrees \xB7 w starts one" }) : null
+                  data !== void 0 && worktreeGroups.length === 0 ? /* @__PURE__ */ jsx3(
+                    EmptyNote,
+                    {
+                      text: filters.worktrees === "" ? "no worktrees \xB7 w starts one" : `nothing matches /${filters.worktrees} \xB7 esc clears`
+                    }
+                  ) : null
                 ]
               }
             )
@@ -3878,7 +4438,7 @@ ${tunneled}
                   data !== void 0 && sessionItems.length === 0 ? /* @__PURE__ */ jsx3(
                     EmptyNote,
                     {
-                      text: selectedGroup === null ? "no worktree selected" : "no sessions \xB7 n starts one"
+                      text: selectedGroup === null ? "no worktree selected" : filters.sessions === "" ? "no sessions \xB7 n starts one" : `nothing matches /${filters.sessions} \xB7 esc clears`
                     }
                   ) : null,
                   loadFailure === null ? null : /* @__PURE__ */ jsx3("text", { height: 1, fg: INK_2, bg: "transparent", children: `  ${loadFailure} \xB7 retrying` })
@@ -3908,7 +4468,13 @@ ${tunneled}
         /* @__PURE__ */ jsx3("span", { fg: INK_2, children: "starting" }),
         /* @__PURE__ */ jsx3("span", { fg: FAINT, children: ` \xB7 ${selectedSession === null ? "launching" : startingExplanationOf(selectedSession)}` })
       ] }),
-      snakeShown ? /* @__PURE__ */ jsx3(SnakeBoard, { handle: snake, focused: focus === "detail" }) : /* @__PURE__ */ jsx3(EmptyNote, { text: "snake is put away \xB7 space brings it back" })
+      snakeShown ? /* @__PURE__ */ jsx3(
+        SnakeBoard,
+        {
+          handle: snake,
+          idle: snakeFocus !== null && dialogOpen ? SNAKE_BEHIND_DIALOG : SNAKE_IDLE
+        }
+      ) : /* @__PURE__ */ jsx3(EmptyNote, { text: snakeTooSmall(snakeRoom.rows < SNAKE_MIN_BOARD_ROWS) })
     ] }) : previewSessionId === null ? /* @__PURE__ */ jsx3(EmptyNote, { text: "provisioning \xB7 no record yet" }) : selectedSession?.harness === "shell" ? /* @__PURE__ */ jsx3(EmptyNote, { text: "shell \xB7 no conversation record; a attaches if live" }) : transcript.isPending ? /* @__PURE__ */ jsx3(EmptyNote, { text: "reading the record\u2026" }) : transcript.error === null ? previewView.lines.length === 0 ? /* @__PURE__ */ jsx3(EmptyNote, { text: "no conversation recorded yet" }) : previewView.lines.map((line, index) => /* @__PURE__ */ jsx3(PreviewRow, { line }, `${index}-${line.kind}`)) : /* @__PURE__ */ jsx3("text", { height: 1, fg: INK_2, bg: "transparent", children: `  could not read the record \xB7 ${errorText(transcript.error)}` }) })
   ] }) });
   const offNav = layout.offscreen.filter(isNavSection);
@@ -3947,7 +4513,7 @@ ${tunneled}
           /* @__PURE__ */ jsx3("span", { fg: shareState === "connected" ? MUTED : FAINT, children: shareState === "connected" ? "agent shared" : "agent share reconnecting" })
         ] })
       ] }),
-      /* @__PURE__ */ jsx3("text", { height: 1, fg: FAINT, bg: "transparent", children: `${ctx.config.url}  ` })
+      /* @__PURE__ */ jsx3("text", { height: 1, fg: FAINT, bg: "transparent", children: `${screenMode === "normal" ? "" : `${screenMode} screen \xB7 `}${ctx.config.url}  ` })
     ] }),
     !layout.breadcrumb ? null : /* @__PURE__ */ jsxs3("text", { height: 1, bg: "transparent", children: [
       /* @__PURE__ */ jsx3("span", { fg: FAINT, children: "  " }),
@@ -3971,28 +4537,51 @@ ${tunneled}
       ),
       detailWidth === 0 ? null : renderDetail()
     ] }),
-    snakeOverlay ? /* @__PURE__ */ jsxs3(
+    snakeOverlay && !overlayFits ? /* @__PURE__ */ jsx3(
       "box",
       {
         position: "absolute",
-        zIndex: 13,
-        left: Math.max(1, Math.floor((terminalCols - (overlayWidth + 4)) / 2)),
-        top: Math.max(1, Math.floor((terminalRows - (overlayHeight + 5)) / 2)),
-        width: overlayWidth + 4,
-        height: overlayHeight + 5,
+        zIndex: 9,
+        left: 1,
+        top: Math.max(1, Math.floor((terminalRows - 3) / 2)),
+        width: Math.max(4, terminalCols - 2),
+        height: 3,
         border: true,
         borderStyle: "rounded",
-        borderColor: ACCENT,
-        title: " snake ",
-        titleAlignment: "left",
+        borderColor: RULE,
         backgroundColor: SURFACE,
-        flexDirection: "column",
-        children: [
-          /* @__PURE__ */ jsx3(SnakeHeading, { handle: overlaySnake, hint: "arrows steer \xB7 space pauses \xB7 esc closes" }),
-          /* @__PURE__ */ jsx3("box", { marginLeft: 1, flexDirection: "column", children: /* @__PURE__ */ jsx3(SnakeRows, { game: overlaySnake.game }) })
-        ]
+        children: /* @__PURE__ */ jsx3("text", { height: 1, bg: "transparent", fg: FAINT, children: fit(
+          ` ${snakeTooSmall(terminalRows < 12)} \xB7 esc closes`,
+          Math.max(1, terminalCols - 4)
+        ) })
       }
     ) : null,
+    snakeOverlay && overlayFits ? (
+      // Under every dialog: one that opens over the game has the keyboard until it closes.
+      /* @__PURE__ */ jsxs3(
+        "box",
+        {
+          position: "absolute",
+          zIndex: 9,
+          left: Math.max(1, Math.floor((terminalCols - (overlayWidth + 4)) / 2)),
+          top: Math.max(1, Math.floor((terminalRows - (overlayHeight + 4)) / 2)),
+          width: overlayWidth + 4,
+          height: overlayHeight + 4,
+          border: true,
+          borderStyle: "rounded",
+          borderColor: overlayFocused ? ACCENT : RULE,
+          title: " snake ",
+          titleAlignment: "left",
+          backgroundColor: SURFACE,
+          flexDirection: "column",
+          children: [
+            /* @__PURE__ */ jsx3(SnakeHeading, { play: overlaySnake.play }),
+            /* @__PURE__ */ jsx3("box", { marginLeft: 1, flexDirection: "column", flexShrink: 0, children: /* @__PURE__ */ jsx3(SnakeRows, { play: overlaySnake.play }) }),
+            /* @__PURE__ */ jsx3(SnakeFooter, { play: overlaySnake.play, idle: SNAKE_BEHIND_DIALOG })
+          ]
+        }
+      )
+    ) : null,
     picker === null ? null : /* @__PURE__ */ jsxs3(
       "box",
       {
@@ -4020,7 +4609,8 @@ ${tunneled}
             {
               item,
               selected: index === pickerIndex,
-              background: SURFACE
+              background: SURFACE,
+              width: modalWidth - 2
             },
             String(item.harness)
           ))
@@ -4127,7 +4717,10 @@ ${tunneled}
               {
                 focused: true,
                 value: creating.name,
-                placeholder: "e.g. fix-auth (empty = auto \xB7 an existing name joins it)",
+                placeholder: fit(
+                  "e.g. fix-auth (empty = auto \xB7 an existing name joins it)",
+                  modalFieldWidth
+                ),
                 backgroundColor: SURFACE,
                 focusedBackgroundColor: SURFACE,
                 textColor: INK,
@@ -4158,7 +4751,10 @@ ${tunneled}
               {
                 focused: true,
                 value: "",
-                placeholder: "type to filter \xB7 enter takes the highlighted branch, or the default when empty",
+                placeholder: fit(
+                  "filter \xB7 enter takes the highlighted branch, or the default",
+                  modalFieldWidth
+                ),
                 backgroundColor: SURFACE,
                 focusedBackgroundColor: SURFACE,
                 textColor: INK,
@@ -4191,7 +4787,7 @@ ${tunneled}
                   height: 1,
                   bg: SURFACE,
                   fg: creating.branchError === null ? FAINT : ERROR,
-                  children: index === 0 && notice !== null ? `     ${fit(notice, 66)}` : " "
+                  children: index === 0 && notice !== null ? `     ${fit(notice, modalWidth - 7)}` : " "
                 },
                 `slot-${index}`
               );
@@ -4219,7 +4815,7 @@ ${tunneled}
             /* @__PURE__ */ jsx3(Gutter, { selected: creating.step === "harness" }),
             /* @__PURE__ */ jsx3("span", { fg: FAINT, children: "harness" })
           ] }),
-          deriveHarnesses(null).map((item, index) => {
+          deriveHarnesses(null, creating.joins ? creating.name : null).map((item, index) => {
             const active = creating.step === "harness";
             const highlighted = active && index === creating.harnessIndex;
             return /* @__PURE__ */ jsx3(
@@ -4232,7 +4828,7 @@ ${tunneled}
                   /* @__PURE__ */ jsx3("span", { fg: FAINT, children: "   " }),
                   /* @__PURE__ */ jsx3(Gutter, { selected: highlighted }),
                   /* @__PURE__ */ jsx3("span", { fg: active ? INK : FAINT, children: item.label.padEnd(12) }),
-                  /* @__PURE__ */ jsx3("span", { fg: FAINT, children: active ? item.hint : "" })
+                  /* @__PURE__ */ jsx3("span", { fg: FAINT, children: active ? fit(item.hint, Math.max(4, modalWidth - 2 - 3 - 2 - 12)) : "" })
                 ] })
               },
               String(item.harness)
@@ -4242,7 +4838,57 @@ ${tunneled}
       }
     ),
     loadFailure === null ? /* @__PURE__ */ jsx3(StatusLine, { busy, busyStarted, status }) : /* @__PURE__ */ jsx3("text", { height: 1, fg: ERROR, bg: "transparent", children: ` could not load workbench \xB7 ${loadFailure} \xB7 retrying` }),
-    /* @__PURE__ */ jsx3("text", { height: 1, fg: FAINT, bg: "transparent", children: footerText })
+    helpOpen ? /* @__PURE__ */ jsxs3(
+      "box",
+      {
+        position: "absolute",
+        zIndex: 14,
+        left: Math.max(1, Math.floor((terminalCols - helpWidth) / 2)),
+        top: Math.max(1, Math.floor((terminalRows - (helpRows + 3)) / 2)),
+        width: helpWidth,
+        height: helpRows + 3,
+        border: true,
+        borderStyle: "rounded",
+        borderColor: ACCENT,
+        title: ` keys \xB7 ${fit(columnTitle(focus), Math.max(6, helpWidth - 14))} `,
+        titleAlignment: "left",
+        backgroundColor: SURFACE,
+        flexDirection: "column",
+        children: [
+          helpView.map(
+            (line) => line.kind === "blank" ? /* @__PURE__ */ jsx3("text", { height: 1, bg: SURFACE, children: " " }, line.key) : line.kind === "title" ? /* @__PURE__ */ jsx3("text", { height: 1, bg: SURFACE, fg: MUTED, children: `  ${line.text}` }, line.key) : /* @__PURE__ */ jsxs3("text", { height: 1, bg: SURFACE, children: [
+              /* @__PURE__ */ jsx3("span", { fg: INK, children: `  ${fit(line.row.keys, 18).padEnd(19)}` }),
+              /* @__PURE__ */ jsx3("span", { fg: line.row.here ? INK_2 : FAINT, children: fit(line.row.help, Math.max(8, helpWidth - 25)) })
+            ] }, line.key)
+          ),
+          /* @__PURE__ */ jsx3("text", { height: 1, bg: SURFACE, fg: FAINT, children: `  ${helpMaxOffset > 0 ? "\u2191\u2193 scroll \xB7 " : ""}esc closes` })
+        ]
+      }
+    ) : null,
+    filtering === null ? /* @__PURE__ */ jsx3("text", { height: 1, fg: FAINT, bg: "transparent", children: footerText }) : /* @__PURE__ */ jsxs3("box", { height: 1, flexShrink: 0, flexDirection: "row", children: [
+      /* @__PURE__ */ jsx3("text", { height: 1, bg: "transparent", fg: ACCENT, children: " / " }),
+      /* @__PURE__ */ jsx3(
+        "input",
+        {
+          focused: true,
+          value: filters[filtering],
+          placeholder: `filter ${columnTitle(filtering)} \xB7 enter keeps it \xB7 esc clears it`,
+          backgroundColor: CANVAS,
+          focusedBackgroundColor: CANVAS,
+          textColor: INK,
+          focusedTextColor: INK,
+          placeholderColor: FAINT,
+          cursorColor: INK,
+          flexGrow: 1,
+          onInput: (value) => {
+            const section = filtering;
+            const clean = value.replace(/\t/g, "");
+            setFilters((current) => ({ ...current, [section]: clean }));
+          },
+          onSubmit: () => setFiltering(null)
+        }
+      )
+    ] })
   ] });
 };
 var runDashboard = async (ctx) => {
@@ -4313,5 +4959,6 @@ var runDashboard = async (ctx) => {
   });
 };
 export {
+  App,
   runDashboard
 };