elanous 0.2.40 → 0.2.42

package/src/tui/sidetab/peek.ts

@@ -0,0 +1,52 @@
+const graphemes = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+
+const ANSI_CONTROL = /\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07]*(?:\x07|\x1b\\)|[PX^_].*?\x1b\\|.)/gs;
+const NON_TEXT_CONTROL = /[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g;
+const MAX_PEEK_SOURCE_CHARS = 16_384;
+
+function fitLine(value: string, width: number): string {
+  if (width <= 0) return '';
+  if (Bun.stringWidth(value) <= width) return value;
+  const maxTextWidth = Math.max(0, width - 1);
+  let result = '';
+  let used = 0;
+  for (const { segment } of graphemes.segment(value)) {
+    const cells = Bun.stringWidth(segment);
+    if (used + cells > maxTextWidth) break;
+    result += segment;
+    used += cells;
+  }
+  return `${result}…`;
+}
+
+/** Return up to three recent plain-text output lines for the selected sidebar row. */
+export function formatSidetabPeekLines(
+  source: string,
+  width: number,
+  maxLines = 3,
+): string[] {
+  if (!source || width < 5 || maxLines <= 0) return [];
+
+  let start = Math.max(0, source.length - MAX_PEEK_SOURCE_CHARS);
+  // Keep a surrogate pair intact when the bounded tail starts in its second code unit.
+  const firstCodeUnit = source.charCodeAt(start);
+  if (start > 0 && firstCodeUnit >= 0xdc00 && firstCodeUnit <= 0xdfff) start++;
+  let bounded = source.slice(start);
+  // The cut may land in an ANSI sequence or line. Drop that partial prefix; recent complete lines follow it.
+  if (start > 0) {
+    const firstLineBreak = bounded.search(/[\r\n]/);
+    if (firstLineBreak >= 0) bounded = bounded.slice(firstLineBreak + 1);
+  }
+
+  const clean = bounded
+    .replace(ANSI_CONTROL, '')
+    .replace(NON_TEXT_CONTROL, '')
+    .replace(/\r\n?/g, '\n');
+  const recent = clean.split('\n')
+    .map((line) => line.trimEnd())
+    .filter((line) => line.trim().length > 0)
+    .slice(-Math.min(3, Math.floor(maxLines)));
+  const prefix = '   ↳ ';
+  const textWidth = Math.max(1, width - Bun.stringWidth(prefix));
+  return recent.map((line) => `${prefix}${fitLine(line, textWidth)}`);
+}

package/src/tui-client/dashboard-session.ts

@@ -211,6 +211,9 @@ export class DashboardSession {
         ? { resolveMaxToolTurns: opts.resolveMaxToolTurns }
         : {}),
       ...(opts.abortPollMs !== undefined ? { abortPollMs: opts.abortPollMs } : {}),
+      // TUI-TOKEN-GUARD-WIRE — the host history write-back for the request-size cap.
+      ...(opts.compactPersistedHistory ? { compactPersistedHistory: opts.compactPersistedHistory } : {}),
+      ...(opts.requestSizeMaxChars !== undefined ? { requestSizeMaxChars: opts.requestSizeMaxChars } : {}),
     });
 
     const serverPromise = runAcpServer({

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/user-config.ts

@@ -1156,6 +1156,8 @@ export interface HarnessBudgetGateConfig {
 }
 
 export interface SelfImplementToolConfig {
+  /** Explicit opt-in for the needs-human reason-specific automatic repair goal. Defaults off. */
+  supervisor?: { reasonRepair?: boolean };
   /** Absolute root that holds per-repository child worktree directories. */
   worktreeRoot: string;
   /** Self-implement children receive a derived isolated universe by default; `inherit` keeps the parent's universe. */
@@ -1292,7 +1294,7 @@ const TOOLS_DEFAULTS: ToolsConfig = {
   selfOrchestrate: {},
   nativeStructure: { enabled: false },
   // 대표 결정(2026-07-26): 오토 선호 — 기본 ON.
-  selfImplement: { worktreeRoot: join(homedir(), '.elanous', 'worktrees'), childInstanceMode: 'isolated', prApprovalDelivery: 'terminal' as const, observeOnly: false, goalRecordInDoc: true, fabricDecompose: false, fabricDecomposeAutoPathThreshold: 5, autoOpenPr: true, autoStop: { enabled: true, minRung: 2 }, autoAssist: { enabled: true, minRung: 2 }, screenStallTermination: { enabled: true, minRung: 2 }, reworkBudget: { shadowStop: false, maxRounds: 3 }, decompositionShadow: { enabled: false }, clarificationEscalation: { enabled: false } },
+  selfImplement: { worktreeRoot: join(homedir(), '.elanous', 'worktrees'), childInstanceMode: 'isolated', prApprovalDelivery: 'terminal' as const, observeOnly: false, goalRecordInDoc: true, fabricDecompose: false, fabricDecomposeAutoPathThreshold: 5, autoOpenPr: true, supervisor: { reasonRepair: false }, autoStop: { enabled: true, minRung: 2 }, autoAssist: { enabled: true, minRung: 2 }, screenStallTermination: { enabled: true, minRung: 2 }, reworkBudget: { shadowStop: false, maxRounds: 3 }, decompositionShadow: { enabled: false }, clarificationEscalation: { enabled: false } },
 };
 
 // ── Debug ────────────────────────────────────────────────────────────
@@ -2649,6 +2651,10 @@ function parseToolsConfig(raw: unknown): ToolsConfig {
   const selfImplRaw = (root.selfImplement && typeof root.selfImplement === 'object' && !Array.isArray(root.selfImplement))
     ? root.selfImplement as Record<string, unknown>
     : {};
+  const supervisorRaw = selfImplRaw.supervisor && typeof selfImplRaw.supervisor === 'object' && !Array.isArray(selfImplRaw.supervisor)
+    ? selfImplRaw.supervisor as Record<string, unknown>
+    : {};
+  const supervisor = { reasonRepair: supervisorRaw.reasonRepair === true };
   const observeOnly = typeof selfImplRaw.observeOnly === 'boolean'
     ? selfImplRaw.observeOnly
     : TOOLS_DEFAULTS.selfImplement.observeOnly;
@@ -2807,7 +2813,7 @@ function parseToolsConfig(raw: unknown): ToolsConfig {
     runDevHarness,
     selfOrchestrate,
     nativeStructure,
-    selfImplement: { worktreeRoot, childInstanceMode, prApprovalDelivery, observeOnly, goalRecordInDoc, goalAuthorPersistentGrounding, fabricDecompose, fabricDecomposeAutoPathThreshold, autoOpenPr, draftOnStop, salvageRetention, autoStop, autoAssist, screenStallTermination, reworkBudget, decompositionShadow, clarificationEscalation, ...(childLlm ? { childLlm } : {}), ...(escalateChild && Object.keys(escalateChild).length ? { escalateChild } : {}), ...(selfImplRaw.podChildDefault !== undefined ? { podChildDefault: selfImplRaw.podChildDefault } : {}), ...(runTtlHours !== undefined ? { runTtlHours } : {}), ...(draftSweepCloseCap !== undefined ? { draftSweepCloseCap } : {}), ...(runTtl ? { runTtl } : {}), ...(autoheal ? { autoheal } : {}) },
+    selfImplement: { worktreeRoot, childInstanceMode, prApprovalDelivery, observeOnly, goalRecordInDoc, goalAuthorPersistentGrounding, fabricDecompose, fabricDecomposeAutoPathThreshold, autoOpenPr, supervisor, draftOnStop, salvageRetention, autoStop, autoAssist, screenStallTermination, reworkBudget, decompositionShadow, clarificationEscalation, ...(childLlm ? { childLlm } : {}), ...(escalateChild && Object.keys(escalateChild).length ? { escalateChild } : {}), ...(selfImplRaw.podChildDefault !== undefined ? { podChildDefault: selfImplRaw.podChildDefault } : {}), ...(runTtlHours !== undefined ? { runTtlHours } : {}), ...(draftSweepCloseCap !== undefined ? { draftSweepCloseCap } : {}), ...(runTtl ? { runTtl } : {}), ...(autoheal ? { autoheal } : {}) },
   };
 }
 
@@ -6344,11 +6350,11 @@ export const PROVIDER_DEFAULT_MODEL: Record<LLMProviderName, string> = {
   //   ⛔ openai(API 키)는 gpt-4o 그대로 — `gpt-6-*` 는 openai-codex 계열이라 openai 로 부르면 호환 판정이 거부한다(09-23 대표 · 같은 날 되돌림).
   anthropic: 'claude-opus-5-5',
   openai: 'gpt-4o',
-  // ⛔ 2026-09-23: `gpt-5.5` 는 ***두 세대 낡았다***. 운영 기본은 `gpt-6-sol` 이고
-  //    (대표 2026-09-23 · `llm.ts` `CODEX_DEFAULT_MODEL`), 이 표만 안 따라왔다.
+  // 2026-10-28: GPT-6.1 Terra is the current recommended Codex default.
+  //    `llm.ts` avoids importing this UI-facing module, so keep its local default aligned here.
   //    ⚠️ `llm.ts` 에서 import 하지 «않는다» — 이 파일은 UI 소비자가 CLI 표면을 안 끌어오게
   //    «일부러» 독립돼 있다(이 상수의 머리말). ⇒ 값을 맞추고 «자»로 묶는다.
-  'openai-codex': 'gpt-6-sol',
+  'openai-codex': 'gpt-6.1-terra',
   // ⛔ 2026-08-18: 'grok-4-1-fast' 는 «200 OK 로 응답하지만 실제로는 grok-4.3 이 도는»
   //    레거시 별칭이었다(xAI 실호출 대조). 실물 flagship 으로 고친다.
   grok: 'grok-4.7',

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-needs-human-reason-repair.ts

@@ -0,0 +1,107 @@
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { debug } from '../debug/log.js';
+import { superviseRun, type SupervisorJobResult, type SupervisorStopReason } from '../self-dev/run-supervisor.js';
+
+const CASES = [
+  { reason: 'missing-path', runId: 'run-a4117f90-20261028-0000-4000-8000-000000000001',
+    piece: { taskId: 'missing-path-piece', feature: 'missing path piece', status: 'failed', stage: 'error',
+      targetPaths: ['src/gone.ts'],
+      error: { code: 'ENOENT', message: "ENOENT: no such file or directory, open 'src/gone.ts'" } }, goalText: '없는 경로를 다시 접지한다' },
+  { reason: 'scope-expansion', runId: 'run-b2aa6c1e-20261028-0000-4000-8000-000000000002',
+    piece: { taskId: 'scope-expansion-piece', feature: 'scope expansion piece', status: 'failed', stage: 'error',
+      error: { code: 'SCOPE_OUTSIDE', message: 'changed files outside the goal target paths' },
+      changedFiles: ['src/other/expanded.ts'], targetPaths: ['src/self-dev/run-supervisor.ts'] }, goalText: '범위 확장을 좁힌다' },
+  { reason: 'step-timeout', runId: 'run-c928719f-20261028-0000-4000-8000-000000000003',
+    piece: { taskId: 'step-timeout-piece', feature: 'step timeout piece', status: 'failed', stage: 'timed-out',
+      targetPaths: ['src/self-dev/run-supervisor.ts'],
+      error: { code: 'ETIMEDOUT', message: 'review step exceeded its budget' } }, goalText: '좁은 시험' },
+  { reason: 'no-piece', runId: 'run-d31870a2-20261028-0000-4000-8000-000000000004',
+    piece: { taskId: 'no-piece-piece', feature: 'no piece piece', status: 'failed', stage: 'error',
+      targetPaths: ['src/self-dev/run-supervisor.ts'],
+      error: { code: 'BOOM', message: 'TypeError: undefined is not a function' } }, goalText: '조각 없이 실패했다' },
+] as const;
+
+export interface NeedsHumanReasonRepairSimulationCase {
+  reason: typeof CASES[number]['reason'];
+  runId: string;
+  taskId: string;
+  goalText: string;
+  reruns: number;
+  repairGoal?: string;
+  stopReason?: SupervisorStopReason;
+  why?: string;
+  events: Array<{ event: string; data: Record<string, unknown> }>;
+}
+
+/** Runs the production supervisor with one injected failure per repair reason. */
+export async function simulateNeedsHumanReasonRepair(): Promise<NeedsHumanReasonRepairSimulationCase[]> {
+  const outcomes: NeedsHumanReasonRepairSimulationCase[] = [];
+  const previousStateDir = process.env.ELANOUS_STATE_DIR;
+  process.env.ELANOUS_STATE_DIR = join(process.cwd(), '.elanous-test');
+  let logStore: import('../mss/logging/log-store.js').LogStore | null = null;
+  let logSink: import('../mss/logging/log-store.js').StoreSink | null = null;
+  let unregisterLogSink: (() => void) | null = null;
+  if (process.env.NODE_ENV === 'test') {
+    const storeModule = await import('../mss/logging/log-store.js');
+    logStore = new storeModule.LogStore();
+    logSink = new storeModule.StoreSink(logStore, 'self-dev.supervisor', { installExitHandlers: false });
+    unregisterLogSink = debug.registerSink(logSink);
+  } else {
+    const { registerStandaloneLogSink } = await import('../domains/standalone-log-sink.js');
+    await registerStandaloneLogSink('self-dev.supervisor');
+  }
+  try {
+    for (const fixture of CASES) {
+      const operatorDir = mkdtempSync(join(tmpdir(), 'needs-human-reason-repair-sim-'));
+      const events: NeedsHumanReasonRepairSimulationCase['events'] = [];
+      const decisions: Array<{ action: string; stopReason?: SupervisorStopReason; why: string }> = [];
+      let repairGoal: string | undefined;
+      let reruns = 0;
+      try {
+        await superviseRun({
+          initial: [fixture.piece as unknown as SupervisorJobResult],
+          repairGoalExecution: true,
+          needsHumanReasonRepairExecution: true,
+          runStore: { runId: fixture.runId, operatorDir },
+          rerun: async (_previous, invocation) => {
+            reruns++;
+            repairGoal = invocation.repairGoals?.[fixture.piece.taskId];
+            return [fixture.piece as unknown as SupervisorJobResult];
+          },
+          onDecision: (decision) => decisions.push(decision),
+          observe: (event, data) => {
+            events.push({ event, data });
+            // Mirror the production single-run observer in self-implement-cli.ts.
+            try { debug.log('self-dev.supervisor', event, { ...data, surface: 'single' }); } catch { /* fail-open */ }
+          },
+          sweepPendingMerges: async () => ({ pending: 0, merged: 0 }),
+          taskAgentShadow: false,
+          taskAgentRejudge: false,
+        });
+        const terminal = decisions.at(-1);
+        outcomes.push({
+          reason: fixture.reason,
+          runId: fixture.runId,
+          taskId: fixture.piece.taskId,
+          goalText: fixture.goalText,
+          reruns,
+          ...(repairGoal === undefined ? {} : { repairGoal }),
+          ...(terminal?.stopReason === undefined ? {} : { stopReason: terminal.stopReason }),
+          ...(terminal === undefined ? {} : { why: terminal.why }),
+          events,
+        });
+      } finally {
+        rmSync(operatorDir, { recursive: true, force: true });
+      }
+    }
+  } finally {
+    logSink?.close();
+    unregisterLogSink?.();
+    logStore?.close();
+    if (previousStateDir === undefined) delete process.env.ELANOUS_STATE_DIR;
+    else process.env.ELANOUS_STATE_DIR = previousStateDir;
+  }
+  return outcomes;
+}

package/src/ux-sim/fault-pod-child-result.ts

@@ -0,0 +1,42 @@
+import { classifyPodTerminal } from '../self-dev/draft-residue.js';
+import { podChildEvidenceLedgerRow, type PodTermination } from '../task-orchestrator/surfaces/pod-failure-reason.js';
+
+export interface PodChildResultScenario {
+  firstAttempt: Record<string, unknown>;
+  harvestAttempt: Record<string, unknown>;
+}
+
+/** Replays a successful Kubernetes Job carrying a failed/partial child result. */
+export function podChildResultScenario(): PodChildResultScenario {
+  const podTermination: PodTermination = {
+    job: 'si-task-report-deficit', path: 'result-marker', observedAt: '2026-10-28T09:35:13Z',
+    jobLookup: 'ok', jobUid: 'job-uid-1', jobConditionReason: 'CompletionsReached',
+    activeDeadlineSeconds: 14400, deadlineExceeded: false, podLookup: 'terminated',
+    containerReason: 'Completed', exitCode: 0, finishedAt: '2026-10-28T09:35:13Z', oomKilled: false,
+  };
+  const firstAttempt = podChildEvidenceLedgerRow({
+    job: podTermination.job, childRunId: 'run-first-report-deficit', state: 'complete',
+    result: {
+      stage: 'aborted', ok: false, failureClassification: 'report-deficit',
+      completionDisposition: 'partial', childEvidence: { error: 'report-deficit: missing child result summary' },
+    },
+    noResultDiagnostic: null, noResultLogEvidence: null, podTermination,
+  });
+  const harvestAttempt = classifyPodTerminal({
+    childRunId: 'run-second-harvest', state: 'complete', env: { ELANOUS_HARNESS_SEAT: 'UX' },
+    disposition: { stage: 'pr-opened', ok: true, prNumber: 32614,
+      prUrl: 'https://github.com/ElanvitalAI/elanous/pull/32614', branch: 'self-impl/coord-entrance-fold' },
+    at: '2026-10-28T09:35:29Z',
+  });
+  return { firstAttempt: firstAttempt ?? {}, harvestAttempt };
+}
+
+export function renderPodChildResult(scenario: PodChildResultScenario): string[] {
+  const first = scenario.firstAttempt as { childResult?: Record<string, unknown>; podTermination?: PodTermination };
+  return [
+    `pod-child-result · child completion=${String(first.childResult?.completionDisposition ?? 'unknown')}`,
+    `  first: child=${String(first.childResult?.ok)} · stage=${String(first.childResult?.stage)} · failure=${String(first.childResult?.failureClassification)}`,
+    `  pod: ${String(first.podTermination?.containerReason)} · exit=${String(first.podTermination?.exitCode)} · childRunId=${String(scenario.firstAttempt.childRunId)}`,
+    `  harvest: PR #${String(scenario.harvestAttempt.prNumber)} · ${String(scenario.harvestAttempt.terminalClass)}`,
+  ];
+}

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."
+  }
+}