elanous 0.2.23 → 0.2.25

package/src/dashboard/index.ts

@@ -11,280 +11,26 @@ import { spawn, spawnSync } from 'node:child_process';
 import { $ } from 'bun';
 import { LOCAL_SKILLS_DIR, SERVICE_NAMES, DATA_DIR, OBSIDIAN_VAULT } from '../config.js';
 import { dispatchDashboardSessionRuntimeTool } from './session-runtime-dispatch.js';
-import { buildAdRunSetup } from '../ad-pipeline/ad-run-setup.js';
 import { nextChatScrollOffset } from '../chat/log-scroll-key.js';
-import type { CommandRunner } from '../ad-pipeline/higgsfield-backend.js';
-import type { ShootRunOptions } from '../ad-pipeline/shoot-run.js';
-import type { QcThresholds } from '../ad-pipeline/qc.js';
-import { elanousStateRoot } from '../autopilot/state-paths.js';
 import { suggestProjectForFolder } from '../project/project-store.js';
 import { createProjectSuggester } from '../project/project-suggestion.js';
-
-const dashboardDefaultShootRunOptions: Required<Pick<ShootRunOptions, 'pollIntervalMs' | 'maxPollsPerJob' | 'submitStaggerMs'>> = {
-  pollIntervalMs: 3_000,
-  // 2026-09-12 seedance_2_0 measured 330–400s; 174 polls = 522s, leaving 402s after six 20s staggers.
-  maxPollsPerJob: 174,
-  submitStaggerMs: 20_000,
-};
-
-/**
- * ⛔ `src/ad-pipeline/ad-run-setup.ts` 의 `optionalProductionInputs` «사본»이다 — 그 목록은 export 가 아니다.
- * 여기서 다시 세는 이유: 이 파일이 `buildAdRunSetup` «뒤»에 `assemblyMaterials` 를 덧붙이므로,
- * 그 함수가 «입력» 기준으로 낸 목록은 최종 `production` 과 어긋난다(`#17880`).
- * ⚠️ 사본이라 «늙는다» — `src/dashboard/index.test.ts` 가 권위 목록과 같은지 단언한다.
- */
-export const dashboardOptionalProductionInputs = [
-  'assembly',
-  'assemblyMaterials',
-  'captionFontPath',
-  'musicBedPath',
-  'qcThresholds',
-  'voiceover',
-  'soundtrack',
-  'referenceAssets',
-  'shootRunOptions',
-  'ground',
-  'invariants',
-] as const;
-
-export interface DashboardAdAssetPreset {
-  readonly captionFontPath?: string;
-  readonly musicBedPath?: string;
-  readonly referenceAssets?: Readonly<Record<string, string[]>>;
-  readonly shootRunOptions?: ShootRunOptions;
-  readonly qcThresholds?: QcThresholds;
-}
-
-/** Operator-owned, instance-scoped optional asset preset; never a repository asset path. */
-export function dashboardAdAssetPresetPath(stateRoot = elanousStateRoot()): string {
-  return join(stateRoot, 'ad-assets.json');
-}
-
-/** Reads optional operator-owned asset paths without inventing local defaults. */
-export function loadDashboardAdAssetPreset(path: string): DashboardAdAssetPreset {
-  let raw: string;
-  try {
-    raw = readFileSync(path, 'utf8');
-  } catch (error) {
-    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return {};
-    throw new Error(`dashboard ad asset preset unreadable at ${path}: ${error instanceof Error ? error.message : String(error)}`);
-  }
-
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(raw);
-  } catch (error) {
-    throw new Error(`dashboard ad asset preset malformed at ${path}: ${error instanceof Error ? error.message : String(error)}`);
-  }
-  if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
-    throw new Error(`dashboard ad asset preset malformed at ${path}: expected an object`);
-  }
-
-  const preset = parsed as Record<string, unknown>;
-  for (const key of ['captionFontPath', 'musicBedPath'] as const) {
-    if (preset[key] !== undefined && typeof preset[key] !== 'string') {
-      throw new Error(`dashboard ad asset preset malformed at ${path}: ${key} must be a string`);
-    }
-  }
-  if (preset.referenceAssets !== undefined && (
-    preset.referenceAssets === null
-    || typeof preset.referenceAssets !== 'object'
-    || Array.isArray(preset.referenceAssets)
-    || Object.values(preset.referenceAssets).some((value) => !Array.isArray(value) || value.some((entry) => typeof entry !== 'string'))
-  )) {
-    throw new Error(`dashboard ad asset preset malformed at ${path}: referenceAssets must be a record of string arrays`);
-  }
-  if (preset.shootRunOptions !== undefined && (
-    preset.shootRunOptions === null
-    || typeof preset.shootRunOptions !== 'object'
-    || Array.isArray(preset.shootRunOptions)
-  )) {
-    throw new Error(`dashboard ad asset preset malformed at ${path}: shootRunOptions must be an object`);
-  }
-  const shootRunOptions = preset.shootRunOptions as Record<string, unknown> | undefined;
-  for (const key of ['pollIntervalMs', 'maxPollsPerJob', 'maxPollElapsedMs', 'submitStaggerMs', 'submitRetries'] as const) {
-    if (shootRunOptions?.[key] !== undefined && (typeof shootRunOptions[key] !== 'number' || !Number.isFinite(shootRunOptions[key]))) {
-      throw new Error(`dashboard ad asset preset malformed at ${path}: shootRunOptions.${key} must be a finite number`);
-    }
-  }
-  if (preset.qcThresholds !== undefined && (
-    preset.qcThresholds === null
-    || typeof preset.qcThresholds !== 'object'
-    || Array.isArray(preset.qcThresholds)
-  )) {
-    throw new Error(`dashboard ad asset preset malformed at ${path}: qcThresholds must be an object`);
-  }
-  const qcThresholds = preset.qcThresholds as Record<string, unknown> | undefined;
-  for (const key of ['dialogueLufsTolerance', 'colorDistance', 'frameDiffVariance'] as const) {
-    if (qcThresholds?.[key] !== undefined && (typeof qcThresholds[key] !== 'number' || !Number.isFinite(qcThresholds[key]))) {
-      throw new Error(`dashboard ad asset preset malformed at ${path}: qcThresholds.${key} must be a finite number`);
-    }
-  }
-  if (qcThresholds?.durationRanges !== undefined && (
-    qcThresholds.durationRanges === null
-    || typeof qcThresholds.durationRanges !== 'object'
-    || Array.isArray(qcThresholds.durationRanges)
-  )) {
-    throw new Error(`dashboard ad asset preset malformed at ${path}: qcThresholds.durationRanges must be an object`);
-  }
-  const durationRanges = qcThresholds?.durationRanges as Record<string, unknown> | undefined;
-  for (const scope of ['cut', 'master'] as const) {
-    if (durationRanges?.[scope] !== undefined && (
-      durationRanges[scope] === null
-      || typeof durationRanges[scope] !== 'object'
-      || Array.isArray(durationRanges[scope])
-    )) {
-      throw new Error(`dashboard ad asset preset malformed at ${path}: qcThresholds.durationRanges.${scope} must be an object`);
-    }
-    const range = durationRanges?.[scope] as Record<string, unknown> | undefined;
-    if (range !== undefined) {
-      const minimumSeconds = range.minimumSeconds;
-      const maximumSeconds = range.maximumSeconds;
-      if (typeof minimumSeconds !== 'number' || !Number.isFinite(minimumSeconds)) {
-        throw new Error(`dashboard ad asset preset malformed at ${path}: qcThresholds.durationRanges.${scope}.minimumSeconds must be a finite number`);
-      }
-      if (typeof maximumSeconds !== 'number' || !Number.isFinite(maximumSeconds)) {
-        throw new Error(`dashboard ad asset preset malformed at ${path}: qcThresholds.durationRanges.${scope}.maximumSeconds must be a finite number`);
-      }
-      if (minimumSeconds > maximumSeconds) {
-        throw new Error(`dashboard ad asset preset malformed at ${path}: qcThresholds.durationRanges.${scope}.minimumSeconds must be less than or equal to maximumSeconds`);
-      }
-    }
-  }
-  return {
-    ...(typeof preset.captionFontPath === 'string' ? { captionFontPath: preset.captionFontPath } : {}),
-    ...(typeof preset.musicBedPath === 'string' ? { musicBedPath: preset.musicBedPath } : {}),
-    ...(preset.referenceAssets === undefined ? {} : { referenceAssets: preset.referenceAssets as Record<string, string[]> }),
-    ...(shootRunOptions === undefined ? {} : { shootRunOptions: shootRunOptions as ShootRunOptions }),
-    ...(qcThresholds === undefined ? {} : { qcThresholds: qcThresholds as QcThresholds }),
-  };
-}
-
-export const dashboardAdCommandRunner: CommandRunner = {
-  async run(argv, options) {
-    const process = Bun.spawn([...argv], {
-      stdout: 'pipe',
-      stderr: 'pipe',
-      ...(options?.timeoutMs ? { timeout: options.timeoutMs } : {}),
-    });
-    const [raw, stderr, exitCode] = await Promise.all([
-      new Response(process.stdout).bytes(),
-      new Response(process.stderr).text(),
-      process.exited,
-    ]);
-    return { stdout: new TextDecoder().decode(raw), stderr, exitCode, raw };
-  },
-};
-
-export function createDashboardAdRunSetupFactory(input: {
-  readonly home: string;
-  readonly date: string;
-  readonly contractsJson: string;
-  readonly runner: CommandRunner;
-  readonly assetPresetPath?: string;
-}): (allowSpend: boolean) => ReturnType<typeof buildAdRunSetup> {
-  let runSequence = 0;
-  let activeRunSlug: string | undefined;
-
-  return (allowSpend) => {
-    if (!allowSpend) {
-      const runStart = new Date();
-      const time = [runStart.getHours(), runStart.getMinutes(), runStart.getSeconds()]
-        .map((part) => String(part).padStart(2, '0'))
-        .join('');
-      activeRunSlug = `dashboard-ad-${time}-${++runSequence}`;
-    }
-    const slug = activeRunSlug ?? (() => {
-      const runStart = new Date();
-      const time = [runStart.getHours(), runStart.getMinutes(), runStart.getSeconds()]
-        .map((part) => String(part).padStart(2, '0'))
-        .join('');
-      return `dashboard-ad-${time}-${++runSequence}`;
-    })();
-    const assetPreset = input.assetPresetPath === undefined ? {} : loadDashboardAdAssetPreset(input.assetPresetPath);
-    let setup = buildAdRunSetup({
-      home: input.home,
-      slug,
-      date: input.date,
-      version: 1,
-      aspect: '9x16',
-      contractsJson: input.contractsJson,
-      runner: input.runner,
-      ...assetPreset,
-      referenceAssets: assetPreset.referenceAssets ?? {},
-      shootRunOptions: { ...dashboardDefaultShootRunOptions, ...assetPreset.shootRunOptions },
-      soundtrack: input.runner,
-      voiceover: { runner: input.runner, lines: [] },
-      allowSpend,
-    });
-    if (!('error' in setup) && setup.production) {
-      const production = {
-        ...setup.production,
-        assemblyMaterials: { options: { workDir: setup.workDir, outputName: setup.outputName } },
-      };
-      setup = {
-        ...setup,
-        production,
-        missingProductionInputs: dashboardOptionalProductionInputs.filter((key) => production[key] === undefined),
-      };
-    }
-    return setup;
-  };
-}
-
-/** Builds the /ad runtime bindings used by showDashboard for each invocation's spend intent. */
-export function createDashboardAdRunSetupBindings(
-  buildDashboardAdRunSetup: ReturnType<typeof createDashboardAdRunSetupFactory>,
-) {
-  let adRunSetup: ReturnType<typeof buildAdRunSetup> | undefined;
-  let outputSetupError: string | undefined;
-  try {
-    adRunSetup = buildDashboardAdRunSetup(false);
-    outputSetupError = 'error' in adRunSetup ? adRunSetup.error : undefined;
-  } catch (error) {
-    outputSetupError = error instanceof Error ? error.message : String(error);
-  }
-
-  return {
-    production: adRunSetup && !('error' in adRunSetup) ? adRunSetup.production : undefined,
-    productionForSpend: (allowSpend: boolean) => {
-      try {
-        const setup = buildDashboardAdRunSetup(allowSpend);
-        if ('error' in setup) {
-          outputSetupError = setup.error;
-          return undefined;
-        }
-        return setup.production;
-      } catch (error) {
-        outputSetupError = error instanceof Error ? error.message : String(error);
-        return undefined;
-      }
-    },
-    missingProductionInputs: adRunSetup && !('error' in adRunSetup) ? adRunSetup.missingProductionInputs : undefined,
-    get outputSetupError() {
-      return outputSetupError;
-    },
-  };
-}
-
-/** Connects the dashboard's setup state to the actual /ad runtime. */
-export function createDashboardAdSlashRuntime(
-  input: Omit<DashboardAdSlashRuntimeDeps, 'production' | 'productionForSpend' | 'missingProductionInputs' | 'outputSetupError'> & {
-    readonly adRunSetupBindings?: ReturnType<typeof createDashboardAdRunSetupBindings>;
-    readonly adRunSetupError?: string;
-  },
-): DashboardAdSlashRuntime {
-  const { adRunSetupBindings, adRunSetupError, ...deps } = input;
-  return createAdSlashRuntime({
-    ...deps,
-    production: adRunSetupBindings?.production,
-    productionForSpend: adRunSetupBindings?.productionForSpend,
-    missingProductionInputs: adRunSetupBindings?.missingProductionInputs,
-    get outputSetupError() {
-      return adRunSetupBindings?.outputSetupError ?? adRunSetupError;
-    },
-  });
-}
+import {
+  createDashboardAdRunSetupBindings,
+  createDashboardAdRunSetupFactory,
+  createDashboardAdSlashRuntime,
+  dashboardAdAssetPresetPath,
+  dashboardAdCommandRunner,
+} from './ad-run-setup-bindings.js';
+export {
+  dashboardOptionalProductionInputs,
+  type DashboardAdAssetPreset,
+  dashboardAdAssetPresetPath,
+  loadDashboardAdAssetPreset,
+  dashboardAdCommandRunner,
+  createDashboardAdRunSetupFactory,
+  createDashboardAdRunSetupBindings,
+  createDashboardAdSlashRuntime,
+} from './ad-run-setup-bindings.js';
 
 export interface DashboardGlobalKeyRegistration {
   id: string;
@@ -1005,11 +751,7 @@ import { createDashboardControlSignalSlashRuntime } from './control-signal-slash
 import { createDashboardBrowserCdpSlashRuntime } from './browser-cdp-slash-runtime.js';
 import { collectGroundingFactsViaCdp } from '../product-grounding/cdp-collect.js';
 import { createDashboardSimSlashRuntime } from './sim-slash-runtime.js';
-import {
-  createDashboardAdSlashRuntime as createAdSlashRuntime,
-  type DashboardAdSlashRuntime,
-  type DashboardAdSlashRuntimeDeps,
-} from './ad-slash-runtime.js';
+import type { DashboardAdSlashRuntime } from './ad-slash-runtime.js';
 import { openDashboardLocalSimulationWebCockpit } from './sim-web-cockpit-runtime.js';
 import { createDashboardCompanionFeedbackRuntime } from './companion-feedback-runtime.js';
 import { resolveDashboardMediaSlash } from './media-slash-runtime.js';

package/src/dashboard/slash-runtime/dashboard-handlers.ts

@@ -387,12 +387,13 @@ import {
 import { resolveLocalEndpoints, runLocalLLMCompat } from '../../local-llm-test.js';
 import { getShellRegistry } from '../../shell-runner/registry.js';
 import { renderHandleStatusChip, type HandleStatus } from '../../status/chip.js';
-import { decideAttach } from '../../shell-runner/attach-routing.js';
 import type { DashboardTermSlashRuntime } from '../term-slash-runtime.js';
 import { resolveTerminalMoveDestination } from '../../terminal-matrix/mobility.js';
 import { loadPersistedSessions } from '../../terminal/session-persistence.js';
 import { dispatchTerminalModalObserve } from '../../skills/tools/terminal-modal.js';
 import { SlashCommandRegistry } from './registry.js';
+import { registerShellSlash } from './shell-slash.js';
+export { registerShellSlash } from './shell-slash.js';
 import { cronSecondDueAt, filterLoopRows, formatLoopsTable, localLoopRows, type LoopsTableRow } from './loops-table.js';
 import { loopCronVerdict } from '../../loops/verdict.js';
 import { checklistBoardSlash } from '../../release-loop/checklist-board.js';
@@ -3715,143 +3716,8 @@ export function buildDashboardSlashRegistry(nowDeps?: ContextNowDeps, decideLedg
     ctx.setChatScrollOffset(-1);
   });
 
-  registry.register(['shell', 'sh'], async (args, ctx) => {
-    // SP-C — /shell list|kill|attach family. Talks to the
-    // ShellRegistry singleton (set up in the boot block in
-    // dashboard/index.ts). Kill uses prefix matching on id so users
-    // don't have to type the full slug; attach routes a vw-mode handle
-    // into the foreground via VW switch.
-    //
-    // getShellRegistry + renderHandleStatusChip + decideAttach hoisted
-    // from dynamic to static imports here. Host-local helpers
-    // (shellSlashRuntime + openShellRollupPopup + virtualWindows ops)
-    // come via ctx.shellSlash.
-    const sub = (args[0] ?? '').toLowerCase();
-    const reg = getShellRegistry();
-    if (!sub || sub === 'help') {
-      for (const line of ctx.shellSlash.slashRuntime.helpLines()) ctx.chatLines.push(line);
-      ctx.setChatScrollOffset(-1);
-      return;
-    }
-    const resolveHandle = (needle: string) => {
-      const want = needle.toLowerCase();
-      if (!want) return null;
-      const exact = reg.get(needle);
-      if (exact) return exact;
-      const all = reg.list();
-      const matches = all.filter(h => h.id.toLowerCase().startsWith(want));
-      if (matches.length === 1) return matches[0]!;
-      return matches.length > 1 ? { ambiguous: matches } as const : null;
-    };
-    if (sub === 'rollup') {
-      // N2 — same popup as the 🐚 pill click, openable from
-      // keyboard-only sessions (SSH / nested tmux).
-      await ctx.shellSlash.openRollupPopup();
-      return;
-    }
-    if (sub === 'list') {
-      // N3 — `/shell list all` bypasses the 30s settled TTL so users
-      // can audit everything. Default stays live-only.
-      const showSettled = (args[1] ?? '').toLowerCase() === 'all';
-      const all = reg.list(showSettled ? { includeSettled: true } : undefined);
-      ctx.chatLines.push('');
-      if (all.length === 0) {
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.emptyListLine(showSettled));
-        ctx.setChatScrollOffset(-1);
-        return;
-      }
-      ctx.chatLines.push(ctx.shellSlash.slashRuntime.listHeaderLine(all.length, showSettled));
-      for (const h of all) {
-        const chip = renderHandleStatusChip(h.status);
-        const label = reg.getVwLabel(h.id);
-        const idTail = h.id.length > 10 ? `…${h.id.slice(-8)}` : h.id;
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.listEntryLine({
-          idTail,
-          chip,
-          mode: h.mode,
-          label,
-        }));
-      }
-      ctx.setChatScrollOffset(-1);
-      return;
-    }
-    if (sub === 'kill') {
-      const needle = args[1] ?? '';
-      if (!needle) {
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.killUsageLine());
-        ctx.setChatScrollOffset(-1);
-        return;
-      }
-      const res = resolveHandle(needle);
-      if (!res) {
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.noHandleMatchesLine(needle));
-      } else if ('ambiguous' in res) {
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.ambiguousHeaderLine(needle));
-        for (const h of res.ambiguous) {
-          ctx.chatLines.push(ctx.shellSlash.slashRuntime.ambiguousEntryLine({ id: h.id }));
-        }
-      } else {
-        try {
-          res.kill();
-          ctx.chatLines.push(ctx.shellSlash.slashRuntime.killedLine(res.id));
-        } catch (err) {
-          ctx.chatLines.push(ctx.shellSlash.slashRuntime.killFailedLine(
-            err instanceof Error ? err.message : String(err),
-          ));
-        }
-      }
-      ctx.setChatScrollOffset(-1);
-      return;
-    }
-    if (sub === 'attach') {
-      const needle = args[1] ?? '';
-      if (!needle) {
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.attachUsageLine());
-        ctx.setChatScrollOffset(-1);
-        return;
-      }
-      const res = resolveHandle(needle);
-      if (!res) {
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.noHandleMatchesLine(needle));
-        ctx.setChatScrollOffset(-1);
-        return;
-      }
-      if ('ambiguous' in res) {
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.ambiguousHeaderLine(needle));
-        for (const h of res.ambiguous) {
-          ctx.chatLines.push(ctx.shellSlash.slashRuntime.ambiguousEntryLine({ id: h.id }));
-        }
-        ctx.setChatScrollOffset(-1);
-        return;
-      }
-      // SRF-2 — attach routing by mode, delegated to the pure
-      // decision fn in shell-runner/attach-routing.ts.
-      const outcome = decideAttach(res, {
-        getVwLabel: (id) => reg.getVwLabel(id),
-        resolveVwIdByLabel: (label) => ctx.shellSlash.resolveVwIdByLabel(label),
-      });
-      if (outcome.kind === 'switch-vw') {
-        ctx.shellSlash.virtualWindowsSwitchTo(outcome.windowId);
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.attachedLine(
-          outcome.windowId,
-          outcome.label,
-          outcome.mode,
-        ));
-      } else if (outcome.kind === 'bg') {
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.bgAttachWarningLine(outcome.status));
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.bgAttachHintLine());
-      } else if (outcome.kind === 'no-window') {
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.noWindowAttachWarningLine(outcome.reason));
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.noWindowAttachHintLine());
-      } else {
-        ctx.chatLines.push(ctx.shellSlash.slashRuntime.genericAttachWarningLine(outcome.reason));
-      }
-      ctx.setChatScrollOffset(-1);
-      return;
-    }
-    ctx.chatLines.push(ctx.shellSlash.slashRuntime.unknownSubcommandLine(sub));
-    ctx.setChatScrollOffset(-1);
-  });
+
+  registerShellSlash(registry);
 
   // ── B-3.b ─────────────────────────────────────────────────────────
 

package/src/dashboard/slash-runtime/shell-slash.ts

@@ -0,0 +1,145 @@
+import type { DashboardSlashContext, DashboardSlashReturn } from './dashboard-handlers.js';
+import { getShellRegistry } from '../../shell-runner/registry.js';
+import { renderHandleStatusChip } from '../../status/chip.js';
+import { decideAttach } from '../../shell-runner/attach-routing.js';
+import type { SlashCommandRegistry } from './registry.js';
+
+export function registerShellSlash(registry: SlashCommandRegistry<DashboardSlashContext, DashboardSlashReturn>): void {
+  registry.register(['shell', 'sh'], async (args, ctx) => {
+    // SP-C — /shell list|kill|attach family. Talks to the
+    // ShellRegistry singleton (set up in the boot block in
+    // dashboard/index.ts). Kill uses prefix matching on id so users
+    // don't have to type the full slug; attach routes a vw-mode handle
+    // into the foreground via VW switch.
+    //
+    // getShellRegistry + renderHandleStatusChip + decideAttach hoisted
+    // from dynamic to static imports here. Host-local helpers
+    // (shellSlashRuntime + openShellRollupPopup + virtualWindows ops)
+    // come via ctx.shellSlash.
+    const sub = (args[0] ?? '').toLowerCase();
+    const reg = getShellRegistry();
+    if (!sub || sub === 'help') {
+      for (const line of ctx.shellSlash.slashRuntime.helpLines()) ctx.chatLines.push(line);
+      ctx.setChatScrollOffset(-1);
+      return;
+    }
+    const resolveHandle = (needle: string) => {
+      const want = needle.toLowerCase();
+      if (!want) return null;
+      const exact = reg.get(needle);
+      if (exact) return exact;
+      const all = reg.list();
+      const matches = all.filter(h => h.id.toLowerCase().startsWith(want));
+      if (matches.length === 1) return matches[0]!;
+      return matches.length > 1 ? { ambiguous: matches } as const : null;
+    };
+    if (sub === 'rollup') {
+      // N2 — same popup as the 🐚 pill click, openable from
+      // keyboard-only sessions (SSH / nested tmux).
+      await ctx.shellSlash.openRollupPopup();
+      return;
+    }
+    if (sub === 'list') {
+      // N3 — `/shell list all` bypasses the 30s settled TTL so users
+      // can audit everything. Default stays live-only.
+      const showSettled = (args[1] ?? '').toLowerCase() === 'all';
+      const all = reg.list(showSettled ? { includeSettled: true } : undefined);
+      ctx.chatLines.push('');
+      if (all.length === 0) {
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.emptyListLine(showSettled));
+        ctx.setChatScrollOffset(-1);
+        return;
+      }
+      ctx.chatLines.push(ctx.shellSlash.slashRuntime.listHeaderLine(all.length, showSettled));
+      for (const h of all) {
+        const chip = renderHandleStatusChip(h.status);
+        const label = reg.getVwLabel(h.id);
+        const idTail = h.id.length > 10 ? `…${h.id.slice(-8)}` : h.id;
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.listEntryLine({
+          idTail,
+          chip,
+          mode: h.mode,
+          label,
+        }));
+      }
+      ctx.setChatScrollOffset(-1);
+      return;
+    }
+    if (sub === 'kill') {
+      const needle = args[1] ?? '';
+      if (!needle) {
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.killUsageLine());
+        ctx.setChatScrollOffset(-1);
+        return;
+      }
+      const res = resolveHandle(needle);
+      if (!res) {
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.noHandleMatchesLine(needle));
+      } else if ('ambiguous' in res) {
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.ambiguousHeaderLine(needle));
+        for (const h of res.ambiguous) {
+          ctx.chatLines.push(ctx.shellSlash.slashRuntime.ambiguousEntryLine({ id: h.id }));
+        }
+      } else {
+        try {
+          res.kill();
+          ctx.chatLines.push(ctx.shellSlash.slashRuntime.killedLine(res.id));
+        } catch (err) {
+          ctx.chatLines.push(ctx.shellSlash.slashRuntime.killFailedLine(
+            err instanceof Error ? err.message : String(err),
+          ));
+        }
+      }
+      ctx.setChatScrollOffset(-1);
+      return;
+    }
+    if (sub === 'attach') {
+      const needle = args[1] ?? '';
+      if (!needle) {
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.attachUsageLine());
+        ctx.setChatScrollOffset(-1);
+        return;
+      }
+      const res = resolveHandle(needle);
+      if (!res) {
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.noHandleMatchesLine(needle));
+        ctx.setChatScrollOffset(-1);
+        return;
+      }
+      if ('ambiguous' in res) {
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.ambiguousHeaderLine(needle));
+        for (const h of res.ambiguous) {
+          ctx.chatLines.push(ctx.shellSlash.slashRuntime.ambiguousEntryLine({ id: h.id }));
+        }
+        ctx.setChatScrollOffset(-1);
+        return;
+      }
+      // SRF-2 — attach routing by mode, delegated to the pure
+      // decision fn in shell-runner/attach-routing.ts.
+      const outcome = decideAttach(res, {
+        getVwLabel: (id) => reg.getVwLabel(id),
+        resolveVwIdByLabel: (label) => ctx.shellSlash.resolveVwIdByLabel(label),
+      });
+      if (outcome.kind === 'switch-vw') {
+        ctx.shellSlash.virtualWindowsSwitchTo(outcome.windowId);
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.attachedLine(
+          outcome.windowId,
+          outcome.label,
+          outcome.mode,
+        ));
+      } else if (outcome.kind === 'bg') {
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.bgAttachWarningLine(outcome.status));
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.bgAttachHintLine());
+      } else if (outcome.kind === 'no-window') {
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.noWindowAttachWarningLine(outcome.reason));
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.noWindowAttachHintLine());
+      } else {
+        ctx.chatLines.push(ctx.shellSlash.slashRuntime.genericAttachWarningLine(outcome.reason));
+      }
+      ctx.setChatScrollOffset(-1);
+      return;
+    }
+    ctx.chatLines.push(ctx.shellSlash.slashRuntime.unknownSubcommandLine(sub));
+    ctx.setChatScrollOffset(-1);
+  });
+}

package/src/dashboard/stale-install-check.ts

@@ -12,6 +12,17 @@ export type StaleInstallResult = {
 
 export const STALE_INSTALL_CHECK_INTERVAL_MS = 60_000;
 
+/**
+ * Builds the command that relaunches the TUI on the same daemon session: `elanous --resume <id>` boots the dashboard,
+ * loads that session (ACP session/load) and replays its turns (src/index.ts resumeSessionId · dashboard acp-boot).
+ * The user-facing hint and its key binding land with the dashboard wiring slice (`r` is the render toggle today).
+ * Intentional wiring boundary: the dashboard owns the key binding and executes this command;
+ * this scoped helper only constructs it and does not spawn a child process.
+ */
+export function buildStaleInstallRelaunchCommand(sessionId: string): string {
+  return `elanous --resume ${JSON.stringify(sessionId)}`;
+}
+
 export function formatStaleInstallNotice(result: StaleInstallResult, notifiedCount: number): string {
   const message = `새 판이 깔렸습니다 (부팅 판 ${result.bootCommit!.slice(0, 7)} → 지금 ${result.installedCommit!.slice(0, 7)}) · TUI 를 다시 띄우면 새 판으로 돕니다`;
   return notifiedCount >= 2 ? `${message} · 이 TUI 가 뜬 뒤 ${notifiedCount}번째 새 판` : message;