elanous 0.2.41 → 0.2.43

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/fake-linear-device.ts

@@ -0,0 +1,31 @@
+import type { BrowserHandDeps } from '../tool-runtime/browser-hand-runtime.js';
+
+interface FakeLinearAttachment {
+  issueId: string;
+  title: string;
+  url: string;
+}
+
+/** Fake Linear's network API while preserving the production coordinator's calls. */
+export function createFakeLinearDevice() {
+  const uploads: Array<{ filename: string; contentType: string; body: Buffer }> = [];
+  const attachments: FakeLinearAttachment[] = [];
+  const comments: Array<{ issueId: string; body: string }> = [];
+
+  const deps: Pick<BrowserHandDeps, 'upload' | 'attach' | 'reflectSelection'> = {
+    upload: async input => {
+      uploads.push({ filename: input.filename, contentType: input.contentType, body: Buffer.from(input.body) });
+      return `https://linear-sim.invalid/files/${uploads.length}`;
+    },
+    attach: async input => {
+      attachments.push({ issueId: input.issueId, title: input.title, url: input.url });
+      return `linear-attachment-${attachments.length}`;
+    },
+    reflectSelection: async input => {
+      comments.push(input);
+      return true;
+    },
+  };
+
+  return { deps, uploads, attachments, comments };
+}

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/graph-engine-sim.ts

@@ -0,0 +1,47 @@
+import { nextNode, withGrowth } from '../graph-runner/runner.js';
+import type { GraphGrowth } from '../graph-runner/graph-grow.js';
+import type { GraphEdgeSpec, GraphTemplateSpec } from '../self-implement/graph-yaml.js';
+
+/** Synthetic component result supplied to the simulator; no node executor or external effect is run. */
+export interface GraphEngineSimExit {
+  readonly nodeId: string;
+  readonly outcome: 'success' | 'failure' | 'missing' | 'stuck' | 'budget-exceeded' | (string & {});
+}
+
+export interface GraphEngineSimObservation {
+  readonly from: string;
+  readonly outcome: string;
+  readonly to?: string;
+  readonly growthApplied: boolean;
+  readonly sourceGraphUnchanged: boolean;
+}
+
+/**
+ * GRAPH-ENGINE-SIM: inject only a component's exit label and run the production graph-growth and
+ * edge-selector functions. This is a selector device, not a simulated executor or live graph run.
+ */
+export function simGraphEngineSelection(input: {
+  graph: GraphTemplateSpec;
+  exit: GraphEngineSimExit;
+  growth?: GraphGrowth;
+}): GraphEngineSimObservation {
+  const sourceEdges = input.graph.edges;
+  const graph = input.growth ? withGrowth(input.graph, [input.growth]) : input.graph;
+  const isSuccess = input.exit.outcome === 'success';
+  const to = nextNode(graph.edges, input.exit.nodeId, isSuccess ? 'ok' : 'fail', input.exit.outcome);
+  return {
+    from: input.exit.nodeId,
+    outcome: input.exit.outcome,
+    ...(to === undefined ? {} : { to }),
+    growthApplied: graph !== input.graph,
+    sourceGraphUnchanged: input.graph.edges === sourceEdges,
+  };
+}
+
+/** Small receipt useful to command-line and test consumers. */
+export function renderGraphEngineSim(observation: GraphEngineSimObservation): string {
+  return `${observation.from} --${observation.outcome}--> ${observation.to ?? '(no edge)'} · growth=${observation.growthApplied ? 'applied' : 'none'} · source-unchanged=${observation.sourceGraphUnchanged}`;
+}
+
+/** Keep the production selector's accepted edge shape visible to device authors. */
+export type GraphEngineSimEdges = readonly GraphEdgeSpec[];

package/src/ux-sim/linear-secretary.ts

@@ -0,0 +1,216 @@
+// Integrated, test-only scene 2 device. Production coordinators run against fake external I/O.
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { createTelegramAmbientMessageHandler } from '../intake-plane/adapters/telegram-ambient.js';
+import { createLinearSecretaryBreakdown, updateLinearSecretaryProgress, type LinearSecretaryPlan } from '../intake-plane/linear-wish.js';
+import { submitIntakeWork } from '../intake-plane/submit-intake-work.js';
+import { DecisionLedger } from '../decisions/decision-ledger.js';
+import { DecisionCardService, type CardRef, type CardTransport, type CardView } from '../decisions/decision-cards.js';
+import { LogStore } from '../mss/logging/log-store.js';
+import { simBrowserHand } from './browser-hand.js';
+
+const NOW = new Date('2026-10-31T00:00:00.000Z');
+const REQUEST = 'https://example.test/demo/brief 11-04 데모 준비를 리니어로 정리해줘';
+const PLAN: LinearSecretaryPlan = {
+  title: '11-04 데모 준비', rationale: '무대·흡수·브라우저·승인 경계를 근거가 보이게 나눴습니다.',
+  assigneeId: 'fake-owner', dueDate: '2026-11-05',
+  tasks: [
+    { title: '무대 자료 확인', intent: '요청의 공개 근거를 확인한다', refs: ['https://example.test/demo/brief'], assigneeId: 'fake-owner', dueDate: '2026-11-05' },
+    { title: '흡수 자료 연결', intent: '흡수한 자료를 하위 태스크에 연결한다', refs: ['https://example.test/demo/absorb'], assigneeId: 'fake-owner', dueDate: '2026-11-05' },
+    { title: '브라우저 캡처 첨부', intent: '승인된 브라우저 캡처를 같은 태스크에 붙인다', refs: ['https://example.test/demo/browser'], assigneeId: 'fake-owner', dueDate: '2026-11-05' },
+  ],
+};
+
+export interface LinearSecretarySimulationResult {
+  runId: string;
+  evidencePath: string;
+  cleanup(): void;
+  reply: string | null;
+  parentIssueId: string;
+  intakeIds: string[];
+  childIssueIds: string[];
+  completedIssueIds: string[];
+  childEvidence: Array<{ issueId: string; description: string }>;
+  linearAttachments: Array<{ issueId: string; url: string }>;
+  progressCommentCount: number;
+  browserAttachment: { issueId: string; url: string } | null;
+  approvalCard: { id: string; text: string; buttons: CardView['buttons'] } | null;
+  approvalCardStatus: string | null;
+  browserRunId: string | null;
+  browserActionRunIds: Array<string | null>;
+  externalCalls: number;
+  runEvents: string[];
+  runEvidence: { category: string; event: string; persisted: boolean };
+}
+
+export async function simLinearSecretary(): Promise<LinearSecretarySimulationResult> {
+  const root = mkdtempSync(join(tmpdir(), 'ux-sim-linear-secretary-'));
+  const runId = randomUUID();
+  const store = new LogStore(join(root, 'logs', 'logs.db'), { instance: 'ux-sim' });
+  let retainEvidence = false;
+  const eventNames: string[] = [];
+  const event = (name: string, data: Record<string, unknown> = {}): void => {
+    eventNames.push(name);
+    store.insertBatch([{ surface: 'ux-sim', rec: { ts: NOW.toISOString(), category: 'ux.sim.linear-secretary', event: name,
+      level: 'debug', data: { runId, ...data } } }]);
+  };
+  let externalCalls = 0;
+  const descriptions = new Map<string, string>();
+  const states = new Map<string, string>();
+  const attachments: Array<{ issueId: string; url: string }> = [];
+  const comments: Array<{ issueId: string; body: string }> = [];
+  const childEvidence: Array<{ issueId: string; description: string }> = [];
+  let nextIssue = 0;
+  let parentIssueId = '';
+  let intakeIds: string[] = [];
+  let childIssueIds: string[] = [];
+  let completedIssueIds: string[] = [];
+  let browserAttachment: { issueId: string; url: string } | null = null;
+  let reply: string | null = null;
+  let approvalCard: LinearSecretarySimulationResult['approvalCard'] = null;
+  let approvalCardStatus: string | null = null;
+  let approvalDecisionId: string | undefined;
+  let browserRunId: string | null = null;
+  let browserActionRunIds: Array<string | null> = [];
+  let failure: string | undefined;
+  const fakeFetch = (async (_url: string | URL | Request, init?: RequestInit) => {
+    externalCalls++;
+    if (typeof init?.body !== 'string') throw new Error('fake Linear expected a JSON GraphQL POST body');
+    let body: { query?: unknown; variables?: Record<string, unknown> };
+    try { body = JSON.parse(init.body) as typeof body; }
+    catch { throw new Error('fake Linear expected valid JSON GraphQL POST body'); }
+    if (typeof body.query !== 'string') throw new Error('fake Linear GraphQL body is missing its query');
+    const id = String(body.variables?.id ?? '');
+    if (body.query.includes('LinearIssueStatus')) return Response.json({ data: { issue: { state: { type: states.get(id) ?? 'started' } } } });
+    if (body.query.includes('DecisionIssueStates')) return Response.json({ data: { issue: { team: { states: { nodes: [
+      { id: 'todo', type: 'unstarted' }, { id: 'doing', type: 'started' }, { id: 'done', type: 'completed' },
+    ] } } } } });
+    if (body.query.includes('LinearAttachmentCreate')) {
+      const input = body.variables?.input as { issueId: string; url: string };
+      attachments.push({ issueId: input.issueId, url: input.url });
+      return Response.json({ data: { attachmentCreate: { success: true, attachment: { id: `attachment-${attachments.length}` } } } });
+    }
+    if (body.query.includes('DecisionComment')) {
+      const input = body.variables?.input as { issueId: string; body: string };
+      comments.push(input);
+      return Response.json({ data: { commentCreate: { success: true, comment: { id: `comment-${comments.length}` } } } });
+    }
+    if (body.query.includes('LinearIssueDescription($id')) return Response.json({ data: { issue: { description: descriptions.get(id) } } });
+    if (body.query.includes('LinearIssueDescriptionUpdate')) {
+      const input = body.variables?.input as { description: string };
+      descriptions.set(id, input.description);
+      return Response.json({ data: { issueUpdate: { success: true } } });
+    }
+    if (body.query.includes('DecisionIssueClose')) {
+      const input = body.variables?.input as { stateId: string };
+      states.set(id, input.stateId === 'done' ? 'completed' : 'started');
+      return Response.json({ data: { issueUpdate: { success: true } } });
+    }
+    throw new Error(`unexpected fake Linear query: ${body.query}`);
+  }) as typeof fetch;
+
+  try {
+    event('request-received');
+    const runSecretary = async (request: string) => {
+      try {
+      if (request !== REQUEST) throw new Error('unexpected request');
+      event('secretary-started');
+      const absorbed = await submitIntakeWork({ text: request, track: 'absorb', origin: {
+        kind: 'external', ledgerSource: 'telegram-bot', provider: 'telegram', ref: 'ux-sim:message-1',
+      } }, {
+        root: () => join(root, 'intake'), now: () => NOW.toISOString(),
+        ingest: (_root, _source, raws) => ({ shaped: raws.length, added: raws.length, merged: 0, seen: 0, skipped: 0, badLines: 0 }),
+        log: name => event(name === 'submitted' ? 'intake-submit-observed' : `intake-${name}`),
+      });
+      if (!absorbed.ok || absorbed.track !== 'absorb' || absorbed.ids.length !== 1) throw new Error('demo URL did not enter the absorb seam');
+      intakeIds = absorbed.ids;
+      const groundedPlan: LinearSecretaryPlan = { ...PLAN, tasks: PLAN.tasks.map((task, index) => index === 0
+        ? { ...task, refs: [`elanous:intake:${intakeIds[0]}`] } : task) };
+      event('intake-ledger-seam-completed', { intakeIds });
+      const result = await createLinearSecretaryBreakdown({ apiKey: 'ux-sim-key', teamKey: 'DEMO', request, plan: groundedPlan,
+        fetch: fakeFetch,
+        deps: {
+          createIssue: async input => {
+            const id = `00000000-0000-4000-8000-${String(++nextIssue).padStart(12, '0')}`;
+            if (input.parentId) { states.set(id, 'started'); childEvidence.push({ issueId: id, description: input.description ?? '' }); }
+            else { parentIssueId = id; states.set(id, 'started'); descriptions.set(id, input.description ?? ''); }
+            return id;
+          },
+          updateDescription: async input => { descriptions.set(input.issueId, input.description); },
+        } });
+      childIssueIds = result.childIssueIds;
+      event('breakdown-created', { parentIssueId, childIssueIds });
+
+      for (let index = 0; index < childIssueIds.length; index++) {
+        const issueId = childIssueIds[index]!;
+        const task = groundedPlan.tasks[index]!;
+        let captureUrl: string | undefined;
+        if (index === 1) {
+          const browser = await simBrowserHand('attach', issueId, runId);
+          browserRunId = browser.observedRunId;
+          browserActionRunIds = [...browser.observedBrowserActionRunIds];
+          if (!browserActionRunIds.includes(runId)) throw new Error('browser-act execution event did not consume the secretary runId');
+          const attached = browser.linear.attachments.find(item => item.issueId === issueId);
+          if (!attached) throw new Error('browser capture was not attached to its Linear child');
+          browserAttachment = { issueId, url: attached.url };
+          captureUrl = attached.url;
+          event('browser-capture-attached', { issueId, url: attached.url });
+        }
+        await updateLinearSecretaryProgress({ apiKey: 'ux-sim-key', parentIssueId, taskIssueId: issueId, taskTitle: task.title,
+          tasks: groundedPlan.tasks.map((item, taskIndex) => ({ issueId: childIssueIds[taskIndex]!, title: item.title })),
+          completedIssueIds, state: 'started', summary: `흡수 근거로 ${task.title}을 시작`, fetch: fakeFetch });
+        await updateLinearSecretaryProgress({ apiKey: 'ux-sim-key', parentIssueId, taskIssueId: issueId, taskTitle: task.title,
+          tasks: groundedPlan.tasks.map((item, taskIndex) => ({ issueId: childIssueIds[taskIndex]!, title: item.title })),
+          completedIssueIds, state: 'completed', summary: `${task.title} 완료`, ...(captureUrl ? { captureUrl } : {}), fetch: fakeFetch });
+        completedIssueIds = [...completedIssueIds, issueId];
+        event('subtask-absorbed', { issueId, completedIssueIds: [...completedIssueIds] });
+      }
+      const ledger = new DecisionLedger({ stateDir: join(root, 'state'), now: () => NOW,
+        resolveVersion: () => ({ released: '0.2.42', dev: '0.2.43-dev.0', codename: null }) });
+      const decision = ledger.raise({ title: '11-04 Linear 데모 게시 승인', category: 'publish',
+        scqa: { s: '데모 산출물이 준비됐다.', c: '외부 공개는 대표 승인이 필요하다.' },
+        options: [{ key: 'a', label: '승인', consequence: '공개를 진행한다' }, { key: 'b', label: '보류', consequence: '외부 공개를 멈춘다' }],
+        recommendation: { option: 'b', why: '이 장치는 승인 전 경계까지만 재현한다' }, raisedBy: { agent: 'OPT', track: 'O' },
+        refs: [parentIssueId, ...childIssueIds] });
+      const sent: Array<{ view: CardView }> = [];
+      const transport: CardTransport = {
+        platform: 'telegram', async ownerChats() { return ['fake-owner']; },
+        async send(_chat: string, view: CardView): Promise<CardRef> { sent.push({ view }); return { chat: 'fake-owner', message: String(sent.length) }; },
+        async edit() {}, async notify() {},
+      };
+      await new DecisionCardService({ transport, ownerIds: ['fake-owner'], ledger, now: () => NOW }).tick();
+      const card = sent.find(item => item.view.text.includes(decision.id));
+      if (!card) throw new Error('approval card did not reach the fake owner transport');
+      approvalDecisionId = decision.id;
+      approvalCard = { id: decision.id, text: card.view.text, buttons: card.view.buttons };
+      approvalCardStatus = ledger.show(decision.id).status;
+      if (approvalCardStatus !== 'open') throw new Error(`approval card was not left open: ${approvalCardStatus}`);
+      event('approval-card-opened', { decisionId: decision.id, status: approvalCardStatus });
+      return { replyCard: result.replyCard };
+      } catch (error) {
+        failure = error instanceof Error ? error.message : String(error);
+        event('failed', { message: failure });
+        throw error;
+      }
+    };
+    const handle = createTelegramAmbientMessageHandler({ runSecretary });
+    reply = await handle({ text: REQUEST, chatId: 'fake-chat', userId: 'fake-owner' });
+    if (reply === null) throw new Error('one-line Linear request was not routed');
+    if (failure) throw new Error(`integrated secretary scene failed: ${failure}`);
+    event('completed', { parentIssueId, childIssueIds, decisionId: approvalDecisionId });
+    const runRows = store.queryByDataKeys({ exactCategories: ['ux.sim.linear-secretary'], runIds: [runId] });
+    const linkedEvents = runRows.filter(row => row.event === 'completed');
+    const result: LinearSecretarySimulationResult = { runId, evidencePath: store.path, cleanup: () => rmSync(root, { recursive: true, force: true }),
+      reply, parentIssueId, intakeIds, childIssueIds, completedIssueIds,
+      childEvidence: childEvidence.map(item => ({ ...item, description: descriptions.get(item.issueId) ?? item.description })),
+      linearAttachments: attachments, progressCommentCount: comments.length, browserAttachment, browserRunId, browserActionRunIds, approvalCard, approvalCardStatus, externalCalls, runEvents: eventNames,
+      runEvidence: { category: 'ux.sim.linear-secretary', event: 'completed', persisted: linkedEvents.length === 1 } };
+    retainEvidence = true;
+    return result;
+  } finally {
+    try { store.close(); }
+    finally { if (!retainEvidence) rmSync(root, { recursive: true, force: true }); }
+  }
+}

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

@@ -0,0 +1,93 @@
+{
+  "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", "scenarios/ux-sim/provider-4xx-no-provider.yaml"], "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": "draft-inventory", "name": "Draft triage inventory simulator", "implementation": ["src/ux-sim/draft-inventory-builder.ts", "src/ux-sim/scenario.ts"], "tests": ["src/ux-sim/draft-inventory-builder.test.ts", "src/ux-sim/scenario.test.ts"], "target": "production draft triage decision distribution and protected/running safety", "inputs": ["deterministic 200-draft inventory", "merged twins", "open duplicates", "harvest references", "file lineage", "labels", "run state", "age"], "observations": ["real decideDraft/draftClaimState decisions", "scenario screen summary", "runId-scoped logs.db events", "evidence artifact"]},
+    {"id": "linear-secretary", "name": "Integrated Linear secretary simulation", "implementation": ["src/ux-sim/linear-secretary.ts"], "tests": ["src/ux-sim/linear-secretary.test.ts"], "target": "test-only Telegram ambient intake through production intake/decision/browser coordinators with fake Linear and persisted isolated run evidence", "inputs": ["one-line request", "fake Linear GraphQL responses", "isolated browser capture"], "observations": ["child issues and progress", "browser attachment", "approval card", "runId-scoped event evidence", "external calls remain simulated"]},
+    {"id": "release-graph-rig", "name": "Release graph simulation rig", "implementation": ["src/ux-sim/release-sim-rig.ts", "scripts/release-loop/gate-node-sim.ts", "scripts/release-loop/gate-autoheal-sim-evidence.ts", "scenarios/ux-sim/release-sim-rig.yaml"], "tests": ["src/ux-sim/release-sim-rig.test.ts", "scripts/release-loop/gate-flow-sim.test.ts", "scripts/release-loop/gate-node-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": "graph-engine-selector", "name": "Graph engine selection simulator", "implementation": ["src/ux-sim/graph-engine-sim.ts"], "tests": ["src/ux-sim/graph-engine-sim.test.ts"], "target": "production graph edge selection and growth policy from a synthetic component outcome", "inputs": ["graph", "component exit label", "optional growth"], "observations": ["selected edge", "growth applied", "source graph unchanged"]},
+    {"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": "turn-throw-sim", "name": "Delayed dashboard turn-body throw", "implementation": ["src/ux-sim/turn-throw-sim.ts", "src/dashboard/input/chat-main-plain-turn-runtime.ts", "src/dashboard/turn-busy-teardown.ts"], "tests": ["src/ux-sim/turn-throw-sim.test.ts", "src/dashboard/turn-busy-teardown.test.ts"], "target": "production plain-turn stage failure, turn-threw logging and busy teardown", "inputs": ["turn stage", "delay milliseconds", "queued external input"], "observations": ["tui.turn turn-threw phase=turn:<stage>", "turn.state idle", "one queued input delivered"]},
+    {"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", "src/ux-sim/browser-hand.ts", "src/ux-sim/fake-browser-page.ts", "src/ux-sim/fake-linear-device.ts", "src/ux-sim/service-key-setup.ts", "src/ux-sim/term-slash-device.ts"], "tests": ["src/ux-sim/aimock-local.test.ts", "src/ux-sim/in-process-cli.test.ts", "src/ux-sim/browser-hand.test.ts", "src/ux-sim/service-key-setup.test.ts", "src/ux-sim/term-slash-device.test.ts"], "target": "local fake LLM server, browser/linear fakes, service-key setup, terminal slash device and test CLI instance", "inputs": ["test state root", "fake endpoint response", "temporary git repository", "browser/page and service state"], "observations": ["isolated CLI result", "server requests", "repository state", "fake device interactions"]}
+  ],
+  "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", "scripts/release-loop/gate-node-sim.ts", "scripts/release-loop/gate-autoheal-sim-evidence.ts", "scenarios/ux-sim/release-sim-rig.yaml"], "tests": ["src/ux-sim/release-sim-rig.test.ts", "scripts/release-loop/gate-node-sim.test.ts", "scripts/release-loop/gate-flow-sim.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"},
+    {"id": "UX-MS-08", "name": "Delayed dashboard turn throw and queue teardown", "kind": "turn-throw-teardown", "device": "turn-throw-sim", "implementation": ["src/ux-sim/turn-throw-sim.ts", "src/dashboard/input/chat-main-plain-turn-runtime.ts", "src/dashboard/turn-busy-teardown.ts"], "tests": ["src/ux-sim/turn-throw-sim.test.ts", "src/dashboard/turn-busy-teardown.test.ts"], "trigger": "Configure a turn:<stage> throw with an optional delay while one external input is queued.", "observe": ["tui.turn turn-threw phase=turn:<stage>", "turn.state idle", "one queued input delivered"], "expected": "the production plain-turn catch logs the configured stage, teardown restores idle, and the queued input is delivered once"},
+    {"id": "UX-MS-09", "name": "Draft triage 200-case safety inventory", "kind": "draft-inventory-triage", "device": "draft-inventory", "implementation": ["src/ux-sim/draft-inventory-builder.ts", "src/ux-sim/scenario.ts"], "tests": ["src/ux-sim/draft-inventory-builder.test.ts", "src/ux-sim/scenario.test.ts"], "trigger": "Evaluate deterministic twin, duplicate, harvest, landed-file, protected-label, running, and stale draft cases.", "observe": ["200 production decideDraft results", "draftClaimState for running samples", "protected/running close count", "runId-linked assessment and completion events"], "expected": "scenario completes PASS with the intended case distribution, no mismatches, and no protected/running draft closed"},
+    {"id": "UX-MS-11", "name": "Codex request-shape 400 recovery boundary", "kind": "provider-request-rejected", "device": "scenario-runner", "implementation": ["scenarios/ux-sim/provider-4xx-no-provider.yaml", "src/ux-sim/scenario.ts"], "tests": ["src/ux-sim/scenario.test.ts"], "trigger": "Run the test-universe ScenarioV0 fixture with two injected HTTP 400 responses for the Codex request-shape boundary.", "observe": ["llm.codex/request-rejected-shape debug event", "response status and count", "ScenarioV0 completion event and runId evidence artifact"], "expected": "The isolated scenario records one request-rejected-shape event and one runId-scoped completion row."}
+  ],
+  "candidateAudit": {
+    "source": "~/elanous-hq/seat-state/OP/MOCK-DEVICES-INVENTORY-1031.md §3",
+    "baseCommit": "0d483f46e1ab9ea081cff933f8bb840790c44dde",
+    "sourceRows": 34,
+    "existingPaths": 33,
+    "excludedPaths": 27,
+    "sourceExclusions": [
+      {"path": "scenarios/ux-sim/MK-MS-01.yaml", "reason": "Separately registered by open PR #34039 (MK-MS-01 E4 sequence); keep it outside this 33-candidate registration to avoid duplicate catalog ownership."}
+    ],
+    "candidates": [
+      {"path": "scripts/tui-sim-bench.ts", "disposition": "excluded", "entryCommand": "not-applicable: benchmark requires an explicitly selected goal and provider", "logsRecorded": "no", "logsDetail": "Benchmark is not run by catalog discovery.", "excludeReason": "Measurement/benchmark tool, not a mock device."},
+      {"path": "scripts/tui-sim.ts", "disposition": "excluded", "entryCommand": "bun scripts/tui-sim.ts start --id mock-catalog-example --test", "logsRecorded": "conditional", "logsDetail": "Writes its own simulation artifacts, not ScenarioV0 logs.", "excludeReason": "Standalone TUI driver; separate artifact contract."},
+      {"path": "scripts/ux-sim.ts", "disposition": "already-indexed", "entryCommand": "bun scripts/ux-sim.ts list", "logsRecorded": "conditional", "logsDetail": "ScenarioV0 runs log completion; list/show are read-only.", "deviceId": "scenario-runner"},
+      {"path": "scripts/voice-dogfood-sim.ts", "disposition": "excluded", "entryCommand": "bun run scripts/voice-dogfood-sim.ts", "logsRecorded": "no", "logsDetail": "No ScenarioV0 logs.db contract.", "excludeReason": "Product dogfood script, not a reusable fake-device contract."},
+      {"path": "scripts/voice-pwa-sim.ts", "disposition": "excluded", "entryCommand": "bun run scripts/voice-pwa-sim.ts", "logsRecorded": "no", "logsDetail": "No ScenarioV0 logs.db contract.", "excludeReason": "PWA voice dogfood script, not an isolated reusable device."},
+      {"path": "scripts/release-loop/gate-autoheal-sim-evidence.ts", "disposition": "device", "entryCommand": "bun scripts/release-loop/gate-autoheal-sim-evidence.ts", "logsRecorded": "yes", "logsDetail": "Writes release-loop events to isolated logs.db with runId.", "deviceId": "release-graph-rig", "scenarioIds": ["UX-MS-02"]},
+      {"path": "scripts/release-loop/gate-node-sim.ts", "disposition": "device", "entryCommand": "bun test scripts/release-loop/gate-node-sim.test.ts", "logsRecorded": "no", "logsDetail": "Pure decision result asserted by test; no persistent event.", "deviceId": "release-graph-rig", "scenarioIds": ["UX-MS-02"]},
+      {"path": "scripts/release-loop/tui-sim-node.ts", "disposition": "excluded", "entryCommand": "called by release-loop tui-sim graph node; no standalone CLI", "logsRecorded": "no", "logsDetail": "Node result/artifact only.", "excludeReason": "Graph-node adapter for TUI measurements, not an independent mock device."},
+      {"path": "scripts/lib/pwa-scenarios/acp-replay.ts", "disposition": "excluded", "entryCommand": "bun test scripts/lib/pwa-scenarios/acp-replay.test.ts", "logsRecorded": "no", "logsDetail": "Browser/E2E cell result, not ScenarioV0 logs.", "excludeReason": "Live-browser PWA runner support; not a mock device."},
+      {"path": "scripts/lib/pwa-scenarios/cdp-driver.ts", "disposition": "excluded", "entryCommand": "bun scripts/pwa-scenarios.ts --base-url http://127.0.0.1:31455 --shots ./shots", "logsRecorded": "no", "logsDetail": "Writes optional screenshots and cell output through the PWA runner; no logs.db row.", "excludeReason": "Live-browser PWA runner support; not a mock device."},
+      {"path": "scripts/lib/pwa-scenarios/runner.ts", "disposition": "excluded", "entryCommand": "bun test scripts/lib/pwa-scenarios/runner.test.ts", "logsRecorded": "no", "logsDetail": "Browser/E2E cell result, not ScenarioV0 logs.", "excludeReason": "Live-browser PWA runner support; not a mock device."},
+      {"path": "scripts/lib/pwa-scenarios/scenarios.ts", "disposition": "excluded", "entryCommand": "bun test scripts/lib/pwa-scenarios/scenarios.test.ts", "logsRecorded": "no", "logsDetail": "Browser/E2E cell result, not ScenarioV0 logs.", "excludeReason": "Live-browser PWA runner support; not a mock device."},
+      {"path": "test/fixtures/acp-initialize-stub.ts", "disposition": "excluded", "entryCommand": "bun test test/acp-client-observability.test.ts", "logsRecorded": "no", "logsDetail": "The consuming ACP test asserts protocol behavior; fixture emits no app logs.db row.", "excludeReason": "Protocol fixture only; no independent scenario entry."},
+      {"path": "test/fixtures/mock-lsp-server.ts", "disposition": "excluded", "entryCommand": "bun test test/lsp-client.test.ts test/lsp-operations-dispatch.test.ts", "logsRecorded": "no", "logsDetail": "The consuming LSP tests assert protocol behavior; fixture emits no app logs.db row.", "excludeReason": "Protocol fixture only; no independent scenario entry."},
+      {"path": "test/helpers/intake-fake-repo.ts", "disposition": "excluded", "entryCommand": "bun test test/intake-plane-check-common-name.test.ts", "logsRecorded": "no", "logsDetail": "The consumer test asserts temporary-repository behavior.", "excludeReason": "Test helper, not a simulation device."},
+      {"path": "test/ux-sim/aimock-local.ts", "disposition": "already-indexed", "entryCommand": "bun test src/ux-sim/aimock-local.test.ts", "logsRecorded": "no", "logsDetail": "Test server interactions are asserted by tests, not app logs.db.", "deviceId": "support-fakes"},
+      {"path": "scenarios/dashboard-default.yaml", "disposition": "excluded", "entryCommand": "not-applicable: consumed by the Playground renderer; no direct scenario CLI", "logsRecorded": "runner-dependent", "logsDetail": "No standalone command or UX ScenarioV0 completion contract.", "excludeReason": "Graph/playground scenario, outside UX mock-device scope."},
+      {"path": "scenarios/heap-graph.yaml", "disposition": "excluded", "entryCommand": "not-applicable: consumed by the Playground renderer; no direct scenario CLI", "logsRecorded": "runner-dependent", "logsDetail": "No standalone command or UX ScenarioV0 completion contract.", "excludeReason": "Graph/playground scenario, outside UX mock-device scope."},
+      {"path": "scenarios/iul-timeline-viewer.yaml", "disposition": "excluded", "entryCommand": "not-applicable: consumed by the IUL timeline viewer; no direct scenario CLI", "logsRecorded": "runner-dependent", "logsDetail": "No standalone command or UX ScenarioV0 completion contract.", "excludeReason": "Graph/playground scenario, outside UX mock-device scope."},
+      {"path": "scenarios/ux-sim/provider-4xx-no-provider.yaml", "disposition": "scenario", "entryCommand": "bun bin/elanous.mjs --test sim run scenarios/ux-sim/provider-4xx-no-provider.yaml", "logsRecorded": "yes", "logsDetail": "ux.sim.scenario/completed in test logs.db; expects llm.codex/request-rejected-shape.", "deviceId": "scenario-runner", "scenarioIds": ["UX-MS-11"]},
+      {"path": "scenarios/ux-sim/release-sim-rig.yaml", "disposition": "already-indexed", "entryCommand": "bun bin/elanous.mjs --test sim run scenarios/ux-sim/release-sim-rig.yaml", "logsRecorded": "yes", "logsDetail": "ScenarioV0 completion row is stored in isolated test logs.db; the evidence artifact is a separate JSON file.", "deviceId": "release-graph-rig", "scenarioIds": ["UX-MS-02"]},
+      {"path": "tests/scenarios/4provider-feature-impl.yaml", "disposition": "excluded", "entryCommand": "eln repl --new --json --scenario tests/scenarios/4provider-feature-impl.yaml", "logsRecorded": "runner-dependent", "logsDetail": "REPL logs are separate; some scenarios invoke live models.", "excludeReason": "REPL/provider workflow, not reusable mock device; separate runner or live model dependency."},
+      {"path": "tests/scenarios/capability-level-11.yaml", "disposition": "excluded", "entryCommand": "eln repl --new --json --scenario tests/scenarios/capability-level-11.yaml", "logsRecorded": "runner-dependent", "logsDetail": "REPL logs are separate; some scenarios invoke live models.", "excludeReason": "REPL/provider workflow, not reusable mock device; separate runner or live model dependency."},
+      {"path": "tests/scenarios/codex-baseline.yaml", "disposition": "excluded", "entryCommand": "eln repl --new --json --scenario tests/scenarios/codex-baseline.yaml", "logsRecorded": "runner-dependent", "logsDetail": "REPL logs are separate; some scenarios invoke live models.", "excludeReason": "REPL/provider workflow, not reusable mock device; separate runner or live model dependency."},
+      {"path": "tests/scenarios/codex-opus-2way.yaml", "disposition": "excluded", "entryCommand": "eln repl --new --json --scenario tests/scenarios/codex-opus-2way.yaml", "logsRecorded": "runner-dependent", "logsDetail": "REPL logs are separate; some scenarios invoke live models.", "excludeReason": "REPL/provider workflow, not reusable mock device; separate runner or live model dependency."},
+      {"path": "tests/scenarios/codex-variance-w5f.yaml", "disposition": "excluded", "entryCommand": "eln repl --new --json --scenario tests/scenarios/codex-variance-w5f.yaml", "logsRecorded": "runner-dependent", "logsDetail": "REPL logs are separate; some scenarios invoke live models.", "excludeReason": "REPL/provider workflow, not reusable mock device; separate runner or live model dependency."},
+      {"path": "tests/scenarios/multi-turn-cache-rate.yaml", "disposition": "excluded", "entryCommand": "eln repl --new --json --scenario tests/scenarios/multi-turn-cache-rate.yaml", "logsRecorded": "runner-dependent", "logsDetail": "REPL logs are separate; some scenarios invoke live models.", "excludeReason": "REPL/provider workflow, not reusable mock device; separate runner or live model dependency."},
+      {"path": "tests/scenarios/repl-rotation-chain.yaml", "disposition": "excluded", "entryCommand": "eln repl --new --json --scenario tests/scenarios/repl-rotation-chain.yaml", "logsRecorded": "runner-dependent", "logsDetail": "REPL logs are separate; some scenarios invoke live models.", "excludeReason": "REPL/provider workflow, not reusable mock device; separate runner or live model dependency."},
+      {"path": "tests/scenarios/repl-self-debug-arc.yaml", "disposition": "excluded", "entryCommand": "eln repl --new --json --scenario tests/scenarios/repl-self-debug-arc.yaml", "logsRecorded": "runner-dependent", "logsDetail": "REPL logs are separate; some scenarios invoke live models.", "excludeReason": "REPL/provider workflow, not reusable mock device; separate runner or live model dependency."},
+      {"path": "tests/scenarios/repl-tool-doom-recovery.yaml", "disposition": "excluded", "entryCommand": "eln repl --new --json --scenario tests/scenarios/repl-tool-doom-recovery.yaml", "logsRecorded": "runner-dependent", "logsDetail": "REPL logs are separate; some scenarios invoke live models.", "excludeReason": "REPL/provider workflow, not reusable mock device; separate runner or live model dependency."},
+      {"path": "src/playground-scenario/default-scenarios.ts", "disposition": "excluded", "entryCommand": "bun test src/playground-scenario/", "logsRecorded": "no", "logsDetail": "Scenario constants consumed by Playground tests.", "excludeReason": "Product demo inputs, not mock-device implementation."},
+      {"path": "src/playground-scenario/fake-harness.ts", "disposition": "excluded", "entryCommand": "bun test src/playground-scenario/", "logsRecorded": "no", "logsDetail": "In-memory test harness consumed by Playground tests.", "excludeReason": "Test helper, no independent reusable mock interface."},
+      {"path": "src/showroom/outbound/channels/stubs.ts", "disposition": "excluded", "entryCommand": "bun test src/showroom/outbound/channels/", "logsRecorded": "no", "logsDetail": "Stub results asserted by channel tests.", "excludeReason": "Outbound channel stub, not a UX simulation device."}
+    ]
+  },
+  "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/**/*", "scenarios/**/*.yaml", "src/playground-scenario/*.ts", "src/showroom/outbound/channels/stubs.ts"],
+    "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."
+  }
+}