elanous 0.2.41 → 0.2.42

package/src/tui/entry.ts

@@ -357,6 +357,12 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
 
   const ensureSidetabAttachments = async (): Promise<void> => {
     if (sidetabAttachments) return;
+    const installer = await import('../agent-mission/tool-install.js') as unknown as {
+      detectAgentCli?: (agent: 'codex' | 'claude') => Promise<{
+        agent: 'codex' | 'claude'; installed: boolean; version: string | null;
+        login: 'ready' | 'needed' | 'unknown'; message: string;
+      }>;
+    };
     sidetabAttachments = (await import('./sidetab/attach.js')).createSidetabAttachmentController({
       drawBase: () => {
         paintingCoordinatorFrame = true;
@@ -364,6 +370,7 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
       },
       termSize: () => ({ cols: process.stdout.columns || 80, rows: process.stdout.rows || 24 }),
       setStatus: (message) => { status = safeStatusText(message); },
+      ...(installer.detectAgentCli ? { detectAgentCli: installer.detectAgentCli } : {}),
       drawRemoteFrame: (frame) => {
         sidetabRemoteFrame = frame || null;
         if (sidetabRemoteFrame !== null) {
@@ -575,7 +582,7 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
       .then(({ runLocalChatTurn, onLocalChatBackgroundStatus, onLocalChatSelfHealthStatus }) => {
         observeSession(turnSessionId, onLocalChatBackgroundStatus, onLocalChatSelfHealthStatus);
         let firstResponseSeen = false;
-        return runLocalChatTurn(turnSessionId, turnText, abort.signal, undefined, undefined, (delta) => {
+        return runLocalChatTurn(turnSessionId, turnText, abort.signal, undefined, undefined, (delta, replace = false) => {
           // 스트림 텍스트 = 진전 신호 — 마지막 진전 시각을 올린다(녹음기 없으면 아무 일도 안 한다).
           reportTuiProgress();
           // 첫 응답 경계: 첫 스트림 델타에서 턴 시작 트레이스를 닫는다(endedBy=stream-open).
@@ -585,7 +592,7 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
           }
           // The first model token is visible before the final JSONL frame. Keep only
           // a bounded tail until session history becomes the canonical display.
-          streamingReply = (streamingReply + delta).slice(-32_768);
+          streamingReply = replace ? delta.slice(-32_768) : (streamingReply + delta).slice(-32_768);
           activity = streamReplyLines(streamingReply, process.stdout.columns || 80);
           const now = performance.now();
           if (streamRenderAt === 0 || now - streamRenderAt >= 33) {
@@ -692,8 +699,9 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
   try {
     {
       const { createNextTuiWakeup, setNextTuiWakeupTool } = await import('../tui-client/next-wakeup.js');
-      const { setNextSidetabHandler } = await import('../tui-client/local-chat-turn.js');
+      const { setNextSidetabHandler, setNextSidetabIpcEnabled } = await import('../tui-client/local-chat-turn.js');
       const { createNextSidetabHostHandler } = await import('./sidetab/nl-tool.js');
+      setNextSidetabIpcEnabled(true);
       wakeup = createNextTuiWakeup({
         isTurnRunning: () => busy,
         getBufferText: () => editor.text,
@@ -722,6 +730,7 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
         attach: async (row) => { await ensureSidetabAttachments(); const ok = sidetabAttachments!.select(row); render(); return { ok, action: 'attach', target: row.id }; },
         detach: () => { if (sidetabAttachments?.hasRemoteView()) sidetabAttachments.showMain(); else if (sidetabAttachments?.hasModal()) { sidetabAttachments.handleKey({ name: '\\', ctrl: true, shift: false, raw: '' }); sidetabAttachments.handleKey({ name: 'd', ctrl: false, shift: false, raw: 'd' }); } render(); return { ok: true, action: 'detach' }; },
         spawn: async (character) => { await ensureSidetabAttachments(); const ok = sidetabAttachments!.spawn(character); refreshSidetabRows(); render(); return { ok, action: 'new', character }; },
+        runMission: async (agent, mission) => { await ensureSidetabAttachments(); const result = await sidetabAttachments!.runMission(agent, mission); refreshSidetabRows(); render(); return result; },
         kill: async (row) => { await ensureSidetabAttachments(); const ok = sidetabAttachments!.kill(row); refreshSidetabRows(); render(); return { ok, action: 'kill', target: row.id }; },
       }));
       const gate = wakeup.gate;
@@ -1390,8 +1399,9 @@ export async function showNextTui(options: NextTuiOptions = {}): Promise<void> {
       const { setNextTuiWakeupTool } = await import('../tui-client/next-wakeup.js');
       setNextTuiWakeupTool(null);
     }
-    const { setNextSidetabHandler } = await import('../tui-client/local-chat-turn.js');
+    const { setNextSidetabHandler, setNextSidetabIpcEnabled } = await import('../tui-client/local-chat-turn.js');
     setNextSidetabHandler(null);
+    setNextSidetabIpcEnabled(false);
     turnAbort?.abort();
     await turnDone;
     backgroundSubscription.stop?.();

package/src/tui/sidetab/attach.ts

@@ -1,4 +1,5 @@
 import { randomUUID } from 'node:crypto';
+import { join } from 'node:path';
 import { resolveBackendSpawn, claudeBackend, codexBackend } from '../../agent-mission/driver.js';
 import { DisplayCoordinator } from '../../display/coordinator.js';
 import { createDisplayEventBus } from '../../display/events.js';
@@ -6,6 +7,7 @@ import { createTerminalModalRouter } from '../../terminal/terminal-modal-router.
 import { getSessionCwd } from '../../session/working-dir.js';
 import { TerminalSessionRegistry, type TerminalSession } from '../../terminal/session-registry.js';
 import { requestRemotePtyControl } from '../../pty-shell/pty-control-ipc.js';
+import { runVisibleAgentMission } from '../../sidetab-core/visible-agent-mission.js';
 import type { Key } from '../../tui.js';
 import type { SidetabRow } from './list.js';
 
@@ -16,6 +18,7 @@ export interface SidetabAttachmentController {
   select(row: SidetabRow): boolean;
   showMain(): void;
   spawn(character: SidetabCharacter): boolean;
+  runMission(agent: 'codex' | 'claude', mission: string): Promise<Awaited<ReturnType<typeof runVisibleAgentMission>>>;
   kill(row: SidetabRow): boolean;
   handleKey(key: Key): boolean;
   hasModal(): boolean;
@@ -24,11 +27,21 @@ export interface SidetabAttachmentController {
   close(): void;
 }
 
+export interface AgentCliDetection {
+  agent: 'codex' | 'claude';
+  installed: boolean;
+  version: string | null;
+  login: 'ready' | 'needed' | 'unknown';
+  message: string;
+}
+
 export function createSidetabAttachmentController(deps: {
   drawBase(): void;
   termSize(): { cols: number; rows: number };
   setStatus(message: string): void;
   drawRemoteFrame(frame: string): void;
+  /** Owned by OPT; a missing detector keeps the hook inert until its API lands. */
+  detectAgentCli?(agent: 'codex' | 'claude'): Promise<AgentCliDetection>;
 }): SidetabAttachmentController {
   const eventBus = createDisplayEventBus();
   const coordinator = new DisplayCoordinator({
@@ -45,6 +58,7 @@ export function createSidetabAttachmentController(deps: {
   let remoteFrameTimer: ReturnType<typeof setInterval> | null = null;
   let remoteFramePending = false;
   let remoteHasFrame = false;
+  let lastSpawnedSession: TerminalSession | null = null;
 
   const stopRemote = (): void => {
     if (remoteFrameTimer !== null) clearInterval(remoteFrameTimer);
@@ -164,6 +178,7 @@ export function createSidetabAttachmentController(deps: {
           }
         },
       }, { termCols: cols, termRows: rows });
+      lastSpawnedSession = session;
       if (character === 'codex' || character === 'claude') {
         deps.setStatus(`${character} 실행 · agent-mission 구독 경로 scrub 적용(${unsetEnv?.length ?? 0}개 env 제거)`);
       }
@@ -204,6 +219,38 @@ export function createSidetabAttachmentController(deps: {
     },
     showMain,
     spawn,
+    async runMission(agent, mission) {
+      if (deps.detectAgentCli) {
+        let detection: AgentCliDetection;
+        try { detection = await deps.detectAgentCli(agent); }
+        catch (error) {
+          const message = `${agent} CLI 확인에 실패했습니다: ${error instanceof Error ? error.message : String(error)}`;
+          deps.setStatus(message);
+          return { ok: false, path: '', promptReady: false, missionVisible: false, completionMarker: false, error: message };
+        }
+        if (!detection.installed) {
+          const message = `${detection.message} · 설치 확인 후 미션을 다시 요청하세요`;
+          deps.setStatus(message);
+          return { ok: false, path: '', promptReady: false, missionVisible: false, completionMarker: false, error: message };
+        }
+      }
+      lastSpawnedSession = null;
+      if (!spawn(agent) || !lastSpawnedSession?.modal) {
+        return { ok: false, path: '', promptReady: false, missionVisible: false, completionMarker: false, error: `${agent} side-tab PTY could not start` };
+      }
+      const session = lastSpawnedSession;
+      const outputPath = join(session.cwd, '.elanous', 'mission-results', `sidetab-${Date.now()}.md`);
+      const backend = agent === 'codex' ? codexBackend : claudeBackend;
+      const result = await runVisibleAgentMission({
+        pty: session.modal,
+        mission,
+        outputPath,
+        handleTrust: (screen, write) => backend.handleTrust?.(screen, write) ?? false,
+      });
+      showMain();
+      deps.setStatus(result.ok ? `미션 결과 확인 · ${result.path}` : `미션 확인 실패 · ${result.error}`);
+      return result;
+    },
     kill(row) {
       if (row.currentProcess) {
         deps.setStatus('현재 TUI 세션은 사이드탭에서 종료할 수 없습니다');

package/src/tui-client/local-chat-turn.ts

@@ -6,11 +6,17 @@ import { answerNextSidetabCall, isNextSidetabCall, type NextSidetabHandler } fro
 
 const STATUS_PREFIX = 'ELANOUS_TUI_BG_STATUS\t';
 let nextSidetabHandler: NextSidetabHandler | null = null;
+let nextSidetabIpcEnabled = false;
 
 export function setNextSidetabHandler(handler: NextSidetabHandler | null): void {
   nextSidetabHandler = handler;
 }
 
+/** The Next TUI host enables this before any sticky REPL child is created. */
+export function setNextSidetabIpcEnabled(enabled: boolean): void {
+  nextSidetabIpcEnabled = enabled;
+}
+
 interface TurnResult {
   event?: string | null;
   turnId?: string | null;
@@ -23,7 +29,7 @@ interface TurnResult {
 }
 interface WaitingTurn {
   turnId: string;
-  onDelta?: (text: string) => void;
+  onDelta?: (text: string, replace?: boolean) => void;
   onStatus?: (text: string) => void;
   resolve: (result: TurnResult) => void;
   reject: (error: Error) => void;
@@ -44,7 +50,6 @@ class LocalChatSession {
     // TUI-NEXT-QUEUE-AND-WAKE: the child's ScheduleWakeup asks this process over Bun IPC — the scheduler
     // lives here because the child dies on Esc and /new. No tool registered → no IPC, env unchanged.
     const wakeupTool = nextTuiWakeupTool();
-    const sidetabHandler = nextSidetabHandler;
     this.child = Bun.spawn({
       cmd: [process.execPath, cli, 'repl', '--session', sessionId, '--json', '--stdin-jsonl'],
       stdin: 'pipe', stdout: 'pipe', stderr: 'pipe',
@@ -52,21 +57,23 @@ class LocalChatSession {
         ...process.env, ELANOUS_NEXT_TUI_BG_STATUS: '1', ELANOUS_NEXT_TUI_STREAM: '1',
         ELANOUS_NEXT_TUI_SELF_HEALTH: '1',
         ...(wakeupTool ? { [NEXT_TUI_WAKEUP_IPC_ENV]: '1' } : {}),
-        ELANOUS_NEXT_TUI_SIDETAB_IPC: sidetabHandler ? '1' : '0',
+        // The Next TUI explicitly enables this before child startup. The
+        // callback itself stays live so a child created before handler wiring
+        // can still serve the host once it is installed.
+        ELANOUS_NEXT_TUI_SIDETAB_IPC: nextSidetabIpcEnabled ? '1' : '0',
       },
-      ...(wakeupTool || sidetabHandler ? {
-        ipc: (message: unknown, child: { send(message: unknown): unknown }) => {
+      ipc: (message: unknown, child: { send(message: unknown): unknown }) => {
           if (wakeupTool && isWakeupCallMessage(message)) {
             void answerWakeupCall(wakeupTool, message).then((reply) => {
               try { child.send(reply); } catch { /* the child exited mid-call; its dispatch times out */ }
             });
-          } else if (sidetabHandler && isNextSidetabCall(message)) {
-            void answerNextSidetabCall(sidetabHandler, message).then((reply) => {
+          } else if (isNextSidetabCall(message)) {
+            const handler = nextSidetabHandler ?? (async () => ({ error: 'Next TUI sidetab handler is not ready' }));
+            void answerNextSidetabCall(handler, message).then((reply) => {
               try { child.send(reply); } catch { /* the child exited mid-call; its dispatch times out */ }
             });
           }
-        },
-      } : {}),
+      },
     });
     const input = this.child.stdin;
     const output = this.child.stdout;
@@ -100,6 +107,12 @@ class LocalChatSession {
         }
         return;
       }
+      if (result.event === 'replace') {
+        if (result.turnId === waiting.turnId && typeof result.text === 'string') {
+          try { waiting.onDelta?.(result.text, true); } catch { /* renderer cannot break the turn */ }
+        }
+        return;
+      }
       if (result.event === 'status') {
         if (result.turnId === waiting.turnId && typeof result.text === 'string') {
           try { waiting.onStatus?.(result.text); } catch { /* renderer cannot break the turn */ }
@@ -175,7 +188,7 @@ class LocalChatSession {
     }
   }
 
-  async turn(prompt: string, writePrompt?: (payload: string) => Promise<void>, onDelta?: (text: string) => void, attachments: readonly string[] = [], onStatus?: (text: string) => void): Promise<TurnResult> {
+  async turn(prompt: string, writePrompt?: (payload: string) => Promise<void>, onDelta?: (text: string, replace?: boolean) => void, attachments: readonly string[] = [], onStatus?: (text: string) => void): Promise<TurnResult> {
     if (this.closed) throw new Error('REPL child exited');
     if (this.waiting) throw new Error('REPL turn already running');
     const turnId = `tui-${++this.turnCount}`;
@@ -255,7 +268,7 @@ export async function runLocalChatTurn(
   signal: AbortSignal,
   cli = process.argv[1],
   writePrompt?: (payload: string) => Promise<void>,
-  onDelta?: (text: string) => void,
+  onDelta?: (text: string, replace?: boolean) => void,
   compact: LocalChatTurnCompact = {},
   attachments: readonly string[] = [],
   onStatus?: (line: string) => void,
@@ -278,8 +291,8 @@ export async function runLocalChatTurn(
   if (signal.aborted) abort();
   let result: TurnResult;
   try {
-    result = await session.turn(text, writePrompt, (delta) => {
-      if (!signal.aborted) onDelta?.(delta);
+    result = await session.turn(text, writePrompt, (delta, replace) => {
+      if (!signal.aborted) onDelta?.(delta, replace);
     }, attachments, (line) => { if (!signal.aborted) onStatus?.(line); });
   } catch (error) {
     if (signal.aborted) throw new Error('응답을 취소했습니다');

package/src/tui.ts

@@ -1014,6 +1014,28 @@ export function injectKey(key: Key): boolean {
   return true;
 }
 
+// A foreground dashboard may own an interactive child terminal modal. External
+// control-IPC input must be routed to that modal before it enters the dashboard
+// readKey queue; while the parent loop is busy there may be no readKey consumer.
+let _externalTuiKeyRoutes: Array<{ token: symbol; route: (key: Key) => boolean }> = [];
+
+export function setExternalTuiKeyRoute(route: ((key: Key) => boolean) | null): () => void {
+  if (!route) return () => {};
+  const entry = { token: Symbol('external-tui-key-route'), route };
+  _externalTuiKeyRoutes.push(entry);
+  return () => {
+    _externalTuiKeyRoutes = _externalTuiKeyRoutes.filter((candidate) => candidate.token !== entry.token);
+  };
+}
+
+export function routeExternalTuiKey(key: Key): boolean {
+  const routes = [..._externalTuiKeyRoutes];
+  for (let index = routes.length - 1; index >= 0; index -= 1) {
+    if (routes[index]!.route(key)) return true;
+  }
+  return false;
+}
+
 /** `injectKey` 로 들어온 키 표지 — `takeInjectedKeys` 가 stdin 잔여 키(readKey 몫)는 두고 주입 키만 꺼낸다. */
 const _injectedKeys = new WeakSet<Key>();
 

package/src/ux-sim/fake-kubectl.ts

@@ -1,7 +1,10 @@
+#!/usr/bin/env bun
+import { readFileSync } from 'node:fs';
 import type { PoolKubectl } from '../task-orchestrator/surfaces/pod-pool.js';
 
 /** In-memory Kubernetes boundary for real pool admission and warm-provider tests. Unknown operations fail closed. */
-export function createFakeKubectl(options: { context: string; node: string; jobState?: 'running' | 'complete' }) {
+export function createFakeKubectl(options: { context: string; node: string; jobState?: 'running' | 'complete';
+  failGetPods?: string; podReadinessOnCreate?: boolean }) {
   const jobs = new Map<string, Record<string, unknown>>();
   const pods = new Map<string, Record<string, any>>();
   const calls: string[][] = [];
@@ -9,6 +12,7 @@ export function createFakeKubectl(options: { context: string; node: string; jobS
   const jobCreates: string[] = [];
   const jobDeletes: string[] = [];
   let lease: { workerId: string; podUid: string; key: unknown; job?: string; state: 'idle' | 'leased' | 'released' | 'quarantined' } | null = null;
+  let loseNextLeaseResponse = false;
   const ok = (value: unknown) => ({ status: 0, stdout: JSON.stringify(value), stderr: '' });
   const missing = (kind: string) => ({ status: 1, stdout: '', stderr: `${kind} not found` });
   const kubectl: PoolKubectl = (args, input) => {
@@ -59,7 +63,10 @@ export function createFakeKubectl(options: { context: string; node: string; jobS
       if (query.includes('.status.conditions')) return { status: 0, stdout: (job.status as { conditions?: Array<{ type?: string }> })?.conditions?.map((condition) => condition.type).join(' ') ?? '', stderr: '' };
       return ok(job);
     }
-    if (verb === 'get' && args[at + 1] === 'pods') return ok({ items: [...pods.values()] });
+    if (verb === 'get' && args[at + 1] === 'pods') {
+      if (options.failGetPods) return { status: 1, stdout: '', stderr: options.failGetPods };
+      return ok({ apiVersion: 'v1', kind: 'PodList', metadata: { resourceVersion: '1', continue: '' }, items: [...pods.values()] });
+    }
     if (verb === 'get' && (args[at + 1] === 'pod' || args[at + 1]?.startsWith('pod/'))) {
       const name = args[at + 1] === 'pod' ? args[at + 2] : args[at + 1]?.slice(4);
       const pod = pods.get(name ?? '');
@@ -70,7 +77,8 @@ export function createFakeKubectl(options: { context: string; node: string; jobS
       try { manifest = JSON.parse(input); } catch { return missing('invalid manifest'); }
       const name = manifest.metadata?.name;
       if (typeof name !== 'string' || pods.has(name)) return missing('existing or invalid pod');
-      const created = { ...manifest, metadata: { ...manifest.metadata, uid: `${name}-uid`, resourceVersion: '1' } };
+      const created = { ...manifest, metadata: { ...manifest.metadata, uid: `${name}-uid`, resourceVersion: '1' },
+        ...(options.podReadinessOnCreate ? { status: { phase: 'Running', conditions: [{ type: 'Ready', status: 'True' }] } } : {}) };
       pods.set(name, created);
       return ok(created);
     }
@@ -102,6 +110,10 @@ export function createFakeKubectl(options: { context: string; node: string; jobS
       if (!lease || lease.state !== 'idle' || (lease.job && !jobs.has(lease.job)))
         return Response.json({ unavailable: true }, { status: 503 });
       lease.state = 'leased';
+      if (loseNextLeaseResponse) {
+        loseNextLeaseResponse = false;
+        throw new TypeError('simulated response lost after lease commit');
+      }
       return Response.json({ name: lease.workerId, attrs: { key: lease.key, leaseId: 'lease-1',
         generation: 1, podUid: lease.podUid, state: 'leased' } });
     }
@@ -127,6 +139,7 @@ export function createFakeKubectl(options: { context: string; node: string; jobS
     setWarmLease: (value: { workerId: string; podUid: string; key: unknown; job?: string }) => {
       lease = { ...value, state: 'idle' };
     },
+    loseNextLeaseResponse: () => { loseNextLeaseResponse = true; },
     warmLeaseState: () => lease?.state ?? null,
     putPod: (pod: Record<string, any>) => { pods.set(pod.metadata.name, structuredClone(pod)); },
     replacePodUid: (name: string, uid: string) => {
@@ -140,3 +153,24 @@ export function createFakeKubectl(options: { context: string; node: string; jobS
     hasJob: (name: string) => jobs.has(name),
   };
 }
+
+if (import.meta.main) {
+  const endpoint = process.env.ELANOUS_FAKE_KUBECTL_URL;
+  if (!endpoint) {
+    process.stderr.write('fake-kubectl requires ELANOUS_FAKE_KUBECTL_URL\n');
+    process.exitCode = 2;
+  } else {
+    try {
+      const input = readFileSync(0, 'utf8');
+      const response = await fetch(endpoint, { method: 'POST', headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ args: process.argv.slice(2), input }) });
+      const result = await response.json() as { status: number | null; stdout: string; stderr: string };
+      if (result.stdout) process.stdout.write(result.stdout);
+      if (result.stderr) process.stderr.write(result.stderr);
+      process.exitCode = result.status ?? 2;
+    } catch (error) {
+      process.stderr.write(`fake-kubectl: ${error instanceof Error ? error.message : String(error)}\n`);
+      process.exitCode = 2;
+    }
+  }
+}

package/src/ux-sim/fault-pool-cap.ts

@@ -18,12 +18,14 @@ export interface PoolCapScenario {
   readonly spec: string;
   /** 멤버(컨텍스트)마다 지금 Running 인 하니스 Pod 수 — 멤버마다 «반드시» 준다(빠지면 0 으로 꾸미지 않고 던진다). */
   readonly running: Readonly<Record<string, number>>;
+  /** Query failures for a context stay unknown and suppress the admission recommendation. */
+  readonly queryFailures?: Readonly<Record<string, string>>;
 }
 
 export interface PoolCapObservation {
   readonly scenario: PoolCapScenario;
-  readonly members: ReadonlyArray<{ context: string; capacity: number; capacityDefaulted: boolean; running: number }>;
-  readonly recommendation: PoolLeaseRecommendation;
+  readonly members: ReadonlyArray<{ context: string; capacity: number; capacityDefaulted: boolean; running?: number; queryError?: string }>;
+  readonly recommendation: PoolLeaseRecommendation | null;
 }
 
 /** 메모리·CPU 가 넉넉한 노드 한 대 — 승인이 상한(capacity)으로만 갈리게 한다. */
@@ -48,10 +50,13 @@ export function simPoolCap(scenario: PoolCapScenario): PoolCapObservation {
   const parsed = parsePodPool(scenario.spec);
   const members = parsed.map((m) => ({
     context: m.context, capacity: m.capacity, capacityDefaulted: (m as { capacityDefaulted?: boolean }).capacityDefaulted === true,
-    running: runningOf(scenario, m.context),
+    ...(scenario.queryFailures?.[m.context]
+      ? { queryError: scenario.queryFailures[m.context] }
+      : { running: runningOf(scenario, m.context) }),
   }));
+  if (members.some((member) => member.queryError)) return { scenario, members, recommendation: null };
   const recommendation = recommendConcurrency(
-    { members: members.map((m) => roomyMember(m.context, m.capacity, m.capacityDefaulted, m.running)) },
+    { members: members.map((m) => roomyMember(m.context, m.capacity, m.capacityDefaulted, m.running!)) },
     { capacity: members.reduce((sum, m) => sum + m.capacity, 0), accounts: -1, perAccount: -1 },
   );
   return { scenario, members, recommendation };
@@ -74,8 +79,8 @@ export function renderPoolCap(rows: readonly PoolCapObservation[]): string[] {
   return [
     'pool-cap · `:N` 없는 멤버 = 기본 상한 2(capacityDefaulted)',
     ...rows.map((r) => {
-      const occ = r.members.map((m) => `${m.context} ${m.running}/${m.capacity}${m.capacityDefaulted ? '(기본)' : ''}`).join(' · ');
-      return `  ${r.scenario.spec.padEnd(36)} ${occ.padEnd(40)} → 승인 ${String(r.recommendation.recommended)} · limitedBy=${String(r.recommendation.limitedBy)}`;
+      const occ = r.members.map((m) => `${m.context} ${m.running === undefined ? 'unknown' : m.running}/${m.capacity}${m.capacityDefaulted ? '(기본)' : ''}${m.queryError ? ` query-error=${m.queryError}` : ''}`).join(' · ');
+      return `  ${r.scenario.spec.padEnd(36)} ${occ.padEnd(40)} → 승인 ${String(r.recommendation?.recommended ?? 'unknown')} · limitedBy=${String(r.recommendation?.limitedBy ?? 'unknown')}`;
     }),
   ];
 }

package/src/ux-sim/mock-scenario-catalog.json

@@ -0,0 +1,41 @@
+{
+  "version": 1,
+  "runEvidence": {
+    "scope": "ScenarioV0 YAML runs only; catalog entries reference reusable devices/tests, and list/show do not execute them",
+    "runId": "uuid per execution",
+    "event": { "category": "ux.sim.scenario", "name": "completed" },
+    "persistence": "the isolated test instance logs/logs.db; query by exact category and data.runId",
+    "artifact": "<test-state>/ux-sim/evidence/<scenario>-seed-<seed>-run-<runId>.json"
+  },
+  "devices": [
+    { "id": "fake-llm", "name": "Fake LLM", "implementation": ["src/ux-sim/fake-llm.ts"], "tests": ["src/ux-sim/fake-llm.test.ts"], "target": "LLM response and streaming boundary", "inputs": ["fixed or scripted response", "delay", "error/status"], "observations": ["captured calls", "stream chunks", "completion or failure"] },
+    { "id": "fake-executable", "name": "Fake executable and PATH", "implementation": ["src/ux-sim/fake-bin.ts"], "tests": ["src/ux-sim/fake-bin.test.ts"], "target": "external executable process boundary", "inputs": ["stdout", "stderr", "exit code", "signal", "delay", "argv"], "observations": ["spawn arguments", "output", "exit result"] },
+    { "id": "fake-github", "name": "Fake GitHub CLI and API", "implementation": ["src/ux-sim/fake-gh.ts"], "tests": ["src/ux-sim/fake-gh.test.ts"], "target": "PR list/edit/review/merge responses", "inputs": ["PR records", "pagination", "injected API failure"], "observations": ["requested operations", "deterministic response", "mutated fake state"] },
+    { "id": "fake-kubectl", "name": "Fake kubectl", "implementation": ["src/ux-sim/fake-kubectl.ts"], "tests": ["src/ux-sim/fake-kubectl.test.ts"], "target": "Pod and Job query/termination boundary", "inputs": ["Pod/Job fixtures", "query result or failure"], "observations": ["kubectl argv", "returned resource state", "failure"] },
+    { "id": "fake-herdr", "name": "Fake herdr", "implementation": ["src/ux-sim/fake-herdr.ts"], "tests": ["src/ux-sim/fake-herdr.test.ts"], "target": "pane lifecycle and report-agent handoff", "inputs": ["pane transitions", "missing report", "timeout"], "observations": ["pane state", "handoff result", "timeout classification"] },
+    { "id": "fake-clock", "name": "Fake clock", "implementation": ["src/ux-sim/fake-clock.ts"], "tests": ["src/ux-sim/fake-clock.test.ts"], "target": "process-local time and timer boundary", "inputs": ["clock advance", "scheduled callback"], "observations": ["elapsed time", "fired timers"] },
+    { "id": "temp-git-remote", "name": "Temporary Git remote", "implementation": ["src/ux-sim/temp-git-remote.ts"], "tests": ["src/ux-sim/temp-git-remote.test.ts"], "target": "real local git bare/clone boundary without GitHub", "inputs": ["temporary refs and commits"], "observations": ["local remote state", "branch and commit result"] },
+    { "id": "fake-land-queue", "name": "Fake landing queue", "implementation": ["src/ux-sim/fake-land-queue.ts"], "tests": ["src/ux-sim/fake-land-queue.test.ts"], "target": "landing train scheduling", "inputs": ["load", "gate verdict", "priority", "cut window", "conflict"], "observations": ["queue choice", "wait/reject reason", "slot availability"] },
+    { "id": "scenario-runner", "name": "Scenario file runner and human CLI", "implementation": ["src/ux-sim/scenario.ts", "src/ux-sim/mock-scenario-catalog.ts", "scripts/ux-sim.ts"], "tests": ["src/ux-sim/scenario.test.ts", "src/ux-sim/mock-scenario-catalog.test.ts"], "target": "registered test-only provider-response fault through the real Codex path; catalog list/show CLI", "inputs": ["scenario file", "seed", "registered HTTP/network fault", "MS-id"], "observations": ["widget snapshot", "debug event", "persistent logs.db row", "runId evidence artifact", "catalog listing/detail"] },
+    { "id": "release-graph-rig", "name": "Release graph simulation rig", "implementation": ["src/ux-sim/release-sim-rig.ts"], "tests": ["src/ux-sim/release-sim-rig.test.ts", "scripts/release-loop/gate-flow-sim.test.ts"], "target": "release graph routing, resume and failure paths", "inputs": ["node outcome", "evidence", "resume state"], "observations": ["visited nodes", "unexpected edges", "ledger events", "final graph state"] },
+    { "id": "tui-interaction", "name": "TUI interaction and rendering", "implementation": ["src/ux-sim/interaction.ts", "src/ux-sim/turn-states.ts", "src/ux-sim/render-frame.ts", "src/ux-sim/headless-tui.ts", "src/ux-sim/input-history.ts", "src/ux-sim/slash-menu-frames.ts", "src/ux-sim/mock-seat-pty-frame.ts", "src/ux-sim/mock-seat-pty-frame-child.ts", "src/ux-sim/mock-seat-pty-sequence.ts", "src/ux-sim/mock-seat-pty-sequence-child.ts", "src/ux-sim/pty-key-modifiers-device.ts", "src/ux-sim/tty-foreground-steal-child.ts"], "tests": ["src/ux-sim/interaction.test.ts", "src/ux-sim/turn-states.test.ts", "src/ux-sim/render-frame.test.ts", "src/ux-sim/headless-tui.test.ts", "src/ux-sim/input-history.test.ts", "src/ux-sim/slash-menu-frames.test.ts", "src/ux-sim/mock-seat-pty-frame.test.ts", "src/ux-sim/mock-seat-pty-sequence.test.ts", "src/ux-sim/pty-key-modifiers-device.test.ts"], "target": "TUI event, state, frame, input history and PTY boundaries", "inputs": ["keys", "turn phase", "PTY bytes", "frame dimensions", "queued input"], "observations": ["production renderer output", "state transitions", "PTY input/output", "event history"] },
+    { "id": "fault-injection", "name": "Fault injection devices", "implementation": ["src/ux-sim/fault-cred-expiry.ts", "src/ux-sim/fault-glm-no-credential.ts", "src/ux-sim/fault-needs-human-reason-repair.ts", "src/ux-sim/fault-nextmove-dispatch.ts", "src/ux-sim/fault-pod-child-result.ts", "src/ux-sim/fault-pod-codex-503.ts", "src/ux-sim/fault-pod-death.ts", "src/ux-sim/fault-pool-cap.ts", "src/ux-sim/fault-scope-escape-lift.ts", "src/ux-sim/fault-sqlite-busy.ts", "src/ux-sim/fault-tui-400-autoheal.ts", "src/ux-sim/gate-shard-host-reroute.ts"], "tests": ["src/ux-sim/fault-cred-expiry.test.ts", "src/ux-sim/fault-glm-no-credential.test.ts", "src/ux-sim/fault-needs-human-reason-repair.test.ts", "src/ux-sim/fault-nextmove-dispatch.test.ts", "src/ux-sim/fault-pod-child-result.test.ts", "src/ux-sim/fault-pod-codex-503.test.ts", "src/ux-sim/fault-pod-death.test.ts", "src/ux-sim/fault-pool-cap.test.ts", "src/ux-sim/fault-scope-escape-lift.test.ts", "src/ux-sim/fault-sqlite-busy.test.ts", "src/ux-sim/fault-tui-400-autoheal.test.ts", "src/ux-sim/gate-shard-host-reroute.test.ts"], "target": "credential, Pod, pool, routing, autoheal, scope and persistence failure boundaries", "inputs": ["explicit fault kind", "isolated fixture", "clock or resource outcome"], "observations": ["production decision function output", "reason/event", "recovery or refusal"] },
+    { "id": "product-devices", "name": "Product and task-agent devices", "implementation": ["src/ux-sim/boot-daemon-tools-pty-shell-device.ts", "src/ux-sim/cli-config-audit-device.ts", "src/ux-sim/computer-use.ts", "src/ux-sim/dashboard-event-loop-stall-monitor-device.ts", "src/ux-sim/event-monkey.ts", "src/ux-sim/goal-device.ts", "src/ux-sim/goal-interim-trace.ts", "src/ux-sim/onboarding-first-run-device.ts", "src/ux-sim/resume-picker-device.ts", "src/ux-sim/skills-tools-shell-device.ts", "src/ux-sim/subagent-tools-device.ts", "src/ux-sim/task-agent-parent-host-device.ts", "src/ux-sim/task-agent-rejudge-on-head-device.ts", "src/ux-sim/task-orchestrator-surfaces-self-implement-pod-device.ts"], "tests": ["src/ux-sim/boot-daemon-tools-pty-shell-device.test.ts", "src/ux-sim/cli-config-audit-device.test.ts", "src/ux-sim/computer-use.test.ts", "src/ux-sim/dashboard-event-loop-stall-monitor-device.test.ts", "src/ux-sim/event-monkey.test.ts", "src/ux-sim/goal-device.test.ts", "src/ux-sim/onboarding-first-run-device.test.ts", "src/ux-sim/resume-picker-device.test.ts", "src/ux-sim/self-implement-author-clarification.test.ts", "src/ux-sim/skills-tools-shell-device.test.ts", "src/ux-sim/subagent-tools-device.test.ts", "src/ux-sim/task-agent-parent-host-device.test.ts", "src/ux-sim/task-agent-rejudge-on-head-device.test.ts", "src/ux-sim/task-orchestrator-surfaces-self-implement-pod-device.test.ts"], "target": "selected product, PTY, agent and orchestration seams", "inputs": ["UI state", "task outcome", "host/review decision", "tool result"], "observations": ["rendered state", "decision result", "event sequence", "stop reason"] },
+    { "id": "first-run-and-seminar", "name": "First-run authoring and seminar scenarios", "implementation": ["src/ux-sim/mock-authoring-first-run.ts", "src/ux-sim/mock-authoring-first-run-child.ts", "src/ux-sim/seminar-rehearsal.ts", "src/ux-sim/classic-tui-seat-scenarios.ts", "src/ux-sim/next-tui-seat-scenarios.ts", "src/ux-sim/session-id-seed.ts"], "tests": ["src/ux-sim/mock-authoring-first-run.test.ts", "src/ux-sim/seminar-rehearsal.test.ts", "src/ux-sim/classic-tui-seat-scenarios.test.ts", "src/ux-sim/next-tui-seat-scenarios.test.ts"], "target": "first-run, authoring and scripted TUI flows", "inputs": ["mock author response", "scenario steps", "seeded session id"], "observations": ["step result", "TUI snapshot", "completion and failure markers"] },
+    { "id": "support-fakes", "name": "Additional fake and in-process CLI fixtures", "implementation": ["test/ux-sim/aimock-local.ts", "src/ux-sim/in-process-cli.ts"], "tests": ["src/ux-sim/aimock-local.test.ts", "src/ux-sim/in-process-cli.test.ts"], "target": "local fake LLM server and test CLI instance", "inputs": ["test state root", "fake endpoint response", "temporary git repository"], "observations": ["isolated CLI result", "server requests", "repository state"] }
+  ],
+  "scenarios": [
+    { "id": "UX-MS-01", "name": "Child report deficit with later harvest", "kind": "report-deficit", "device": "fault-injection", "implementation": ["src/ux-sim/fault-pod-child-result.ts"], "tests": ["src/ux-sim/fault-pod-child-result.test.ts"], "trigger": "A child completes with report-deficit while a later child has a harvestable PR.", "observe": ["failure classification remains report-deficit", "Pod terminal data stays attached", "later harvest remains independent"], "expected": "report-deficit is preserved and harvest result is visible" },
+    { "id": "UX-MS-02", "name": "Release gate regression routing", "kind": "gate-regression", "device": "release-graph-rig", "implementation": ["src/ux-sim/release-sim-rig.ts"], "tests": ["src/ux-sim/release-sim-rig.test.ts"], "trigger": "Inject a regression verdict into the release gate node.", "observe": ["visited graph nodes", "unexpected edge list", "terminal status"], "expected": "failure follows the configured repair/review route, not publish" },
+    { "id": "UX-MS-03", "name": "Review cap and no-verdict boundary", "kind": "review-cap-no-verdict", "device": "product-devices", "implementation": ["src/ux-sim/task-agent-rejudge-on-head-device.ts"], "tests": ["src/ux-sim/task-agent-rejudge-on-head-device.test.ts"], "trigger": "Stored review count reaches the cap or a review result is absent.", "observe": ["review request count", "verdict classification", "decision reason"], "expected": "the cap blocks another request and missing verdict stays unmeasured" },
+    { "id": "UX-MS-04", "name": "Pod credential failure", "kind": "pod-auth-failure", "device": "fault-injection", "implementation": ["src/ux-sim/fault-glm-no-credential.ts", "src/ux-sim/fault-pod-codex-503.ts"], "tests": ["src/ux-sim/fault-glm-no-credential.test.ts", "src/ux-sim/fault-pod-codex-503.test.ts"], "trigger": "Remove the child credential or inject a Codex 401/503 response.", "observe": ["credential readiness", "provider error event", "launch/recovery disposition"], "expected": "credential absence and temporary provider unavailability remain distinguishable" },
+    { "id": "UX-MS-05", "name": "TUI and gate worker stall", "kind": "stall", "device": "product-devices", "implementation": ["src/ux-sim/dashboard-event-loop-stall-monitor-device.ts"], "tests": ["src/ux-sim/dashboard-event-loop-stall-monitor-device.test.ts", "scripts/release-loop/gate-pod-stall.test.ts"], "trigger": "Delay the UI event loop or stop gate shard output.", "observe": ["typing lag/stall sample", "stalled shard reason", "bounded completion"], "expected": "stall is named and unrelated work can finish" },
+    { "id": "UX-MS-06", "name": "Landing train rejection", "kind": "train-rejection", "device": "fake-land-queue", "implementation": ["src/ux-sim/fake-land-queue.ts"], "tests": ["src/ux-sim/fake-land-queue.test.ts"], "trigger": "Inject a full queue, failed gate, conflicting head or closed cut window.", "observe": ["queue decision", "rejection reason", "slot state"], "expected": "the queue refuses with a reason and does not grant a slot" },
+    { "id": "UX-MS-07", "name": "Pod pool capacity and query errors", "kind": "pod-pool-error", "device": "fault-injection", "implementation": ["src/ux-sim/fault-pool-cap.ts", "src/ux-sim/fake-kubectl.ts"], "tests": ["src/ux-sim/fault-pool-cap.test.ts", "src/ux-sim/fake-kubectl.test.ts"], "trigger": "Omit a pool limit, saturate members, or inject a kubectl query failure.", "observe": ["recommended concurrency", "limitedBy", "query error"], "expected": "known running counts are capped; a query failure preserves unknown occupancy and emits no concurrency recommendation" }
+  ],
+  "discovery": {
+    "trackedRoot": "src/ux-sim/*.ts runtime modules",
+    "candidateRoots": ["scripts/*sim*.ts", "scripts/release-loop/*sim*.ts", "scripts/lib/pwa-scenarios/*.ts", "test/**/*fake*", "test/**/*stub*", "test/scenarios/**/*"],
+    "limits": "The index records reviewed reusable simulation devices and named acceptance scenarios. Candidate paths outside the tracked root are surfaced for review; this is not proof that every repository fake/stub has scenario value."
+  }
+}