elanous 0.2.24 → 0.2.27

package/src/tui.ts

@@ -978,6 +978,8 @@ export interface RenderOptions {
   force?: boolean;
   /** Physical cursor ANSI emitted after overlays as the last bytes of the frame. */
   cursor?: string;
+  /** Called after this frame finishes rendering and stdout settles. */
+  onWriteComplete?: (error?: Error | null) => void;
 }
 
 let _lastFrameLines: string[] = [];
@@ -1036,7 +1038,22 @@ export function render(lines: string[], opts: RenderOptions = {}): void {
   }
   if (opts.overlay) buf += opts.overlay;
   if (opts.cursor) buf += opts.cursor;
-  process.stdout.write(buf);
+  let writeSettled = false;
+  let writeError: Error | null | undefined;
+  let rendered = false;
+  const finishWrite = () => {
+    if (!opts.onWriteComplete || !writeSettled || !rendered) return;
+    try { opts.onWriteComplete(writeError); } catch { /* observation must not break rendering */ }
+  };
+  if (opts.onWriteComplete) {
+    process.stdout.write(buf, (error) => {
+      writeError = error;
+      writeSettled = true;
+      finishWrite();
+    });
+  } else {
+    process.stdout.write(buf);
+  }
   perf.recordStdoutWrite(buf.length, true);
   perf.markDrawEnd();
 
@@ -1053,6 +1070,8 @@ export function render(lines: string[], opts: RenderOptions = {}): void {
   if (_frameObserver) {
     try { _frameObserver(_lastFrameLines, { rows, cols }); } catch { /* swallow */ }
   }
+  rendered = true;
+  finishWrite();
 }
 
 // ── Utility ──

package/src/user-config.ts

@@ -27,6 +27,9 @@
 // crashed wizard cannot corrupt an existing file. Mode 0600 when the
 // telegram bot token is present.
 
+import { isRuntimeLlmModelCompatibleWithProvider } from './llm/runtime-model-family.js';
+export { inferRuntimeLlmModelFamily, isRuntimeLlmModelCompatibleWithProvider } from './llm/runtime-model-family.js';
+export type { RuntimeLlmModelFamily } from './llm/runtime-model-family.js';
 import { DRAFT_ON_STOP_MODES, parseDraftOnStopMode, type DraftOnStopMode } from './self-implement/draft-on-stop-mode.js';
 import { isCodexQuotaPolicy } from './oauth/codex-quota-policy.js';
 import { defaultObsidianVault } from './obsidian/default-vault.js';
@@ -200,6 +203,9 @@ export interface LLMConfig {
    *    이 축은 «같은 provider 안에서 어느 계정의 토큰을 쓸지»를 바꾼다.
    *  리셋 크레딧 자동 소비는 별도 일일 상한으로 제한한다. */
   codexAccountRotation?: boolean;
+  /** REVIEW-ACP-POD — Pod merge-ready PR 을 병합 전에 호스트 Claude ACP(구독)로 리뷰한다. `true` 일 때만 켜진다(기본 꺼짐 = 종전).
+   *  env `ELANOUS_POD_HOST_ACP_REVIEW` 가 이 값보다 앞선다. ACP 를 못 쓰면 종전 길(Pod 리뷰 → 재게이트). */
+  podHostAcpReview?: boolean;
   /** ⭐⭐ codex 계정 «알림» — 회전·리셋크레딧 소비를 텔레그램 등 outbound 로 보낼지.
    *  ⛔ **기본 ON** — `false` 일 때만 조용해진다.
    *  ⛔⭐ 위 `codexAccountRotation` 과 «다른 축»이다(대표 지시 2026-08-17 *"회전을 끄라는 게
@@ -3829,7 +3835,7 @@ export interface UserConfig {
   guardian?: { mode?: 'shadow' | 'live'; /** Orphan CLI GC on the guardian tick: off = no ps collection, shadow (default) = evidence only, on = evidence then SIGTERM. */ orphanGc?: 'off' | 'shadow' | 'on' };
   /** TA-JUDGE-LIVE-SAFE: task-agent judge moves executed for real. Only `review` · `propose-green` are honoured
    *  (`src/task-agent/live-moves.ts` drops anything else with a warning). Absent = env ELANOUS_TASK_AGENT_LIVE_MOVES, else none (pure shadow). */
-  taskAgent?: { liveMoves?: string[]; parentHost?: { host?: string; cwd?: string; elanous?: string; configDir?: string; podPool?: string; approvalCapacity?: number } | Array<{ host?: string; cwd?: string; elanous?: string; configDir?: string; podPool?: string; approvalCapacity?: number }> };
+  taskAgent?: { liveMoves?: string[]; /** TA-REJUDGE-PERIODIC — steward tick runs `tasks rejudge --all` every N minutes (absent/0 = off). */ rejudgeEveryMinutes?: number; /** 1-minute load average above which that tick is skipped (default 60). */ rejudgeMaxLoad?: number; parentHost?: { host?: string; cwd?: string; elanous?: string; configDir?: string; podPool?: string; approvalCapacity?: number } | Array<{ host?: string; cwd?: string; elanous?: string; configDir?: string; podPool?: string; approvalCapacity?: number }> };
   events?: EventsConfig;
   /** GATE-REMOTE — see GateRemoteConfig. Absent = defaults (auto on · node-b · load 20 · cap 2). */
   gateRemote?: GateRemoteConfig;
@@ -4140,15 +4146,24 @@ function parseTaskAgentConfig(raw: unknown): UserConfig['taskAgent'] {
     return undefined;
   }
   const parentHost = parseTaskAgentParentHost((raw as Record<string, unknown>).parentHost);
+  // TA-REJUDGE-PERIODIC — 음이 아닌 유한수만 산다(0 = 끔). 그 밖은 경고하고 버린다(= 끔 · 기본 부하 상한).
+  const rejudge: { rejudgeEveryMinutes?: number; rejudgeMaxLoad?: number } = {};
+  for (const key of ['rejudgeEveryMinutes', 'rejudgeMaxLoad'] as const) {
+    const value = (raw as Record<string, unknown>)[key];
+    if (value === undefined) continue;
+    if (typeof value === 'number' && Number.isFinite(value) && value >= 0) rejudge[key] = value;
+    else warnUserConfigDrop(`taskAgent.${key}`, `음이 아닌 수가 아니다(${JSON.stringify(value)}) — 버림`);
+  }
+  const extras = { ...rejudge, ...(parentHost ? { parentHost } : {}) };
   const liveMoves = (raw as Record<string, unknown>).liveMoves;
-  if (liveMoves === undefined) return parentHost ? { parentHost } : undefined;
+  if (liveMoves === undefined) return Object.keys(extras).length ? extras : undefined;
   // 설정이 «있으면» 환경 변수로 내려가지 않는다 — 배열이 아니면 빈 목록(fail-closed), 문자열 밖 항목은 글자로 바꿔 넘겨
   // 실행부가 «모르는 항목»으로 경고하고 버리게 한다(유효한 항목은 산다).
   if (!Array.isArray(liveMoves)) {
     warnUserConfigDrop('taskAgent.liveMoves', '배열이 아니다 — 빈 목록(실행 0)');
-    return { liveMoves: [], ...(parentHost ? { parentHost } : {}) };
+    return { liveMoves: [], ...extras };
   }
-  return { liveMoves: liveMoves.map((entry) => typeof entry === 'string' ? entry : JSON.stringify(entry) ?? String(entry)), ...(parentHost ? { parentHost } : {}) };
+  return { liveMoves: liveMoves.map((entry) => typeof entry === 'string' ? entry : JSON.stringify(entry) ?? String(entry)), ...extras };
 }
 
 function parseGuardianConfig(raw: unknown): UserConfig['guardian'] {
@@ -4518,65 +4533,6 @@ function runtimeLlmProviderOverride(): LLMProviderName | undefined {
   return requested as LLMProviderName;
 }
 
-/** Lightweight model-id family — prefix/substring only. No catalog, no
- *  `src/llm/model-defaults.ts` (that module imports this file). */
-export type RuntimeLlmModelFamily =
-  | 'grok' | 'anthropic' | 'openai' | 'openai-codex' | 'gemini' | 'local'
-  | 'kimi' | 'qwen' | 'glm' | 'openrouter' | 'bedrock' | 'unknown';
-
-export function inferRuntimeLlmModelFamily(model: string | undefined): RuntimeLlmModelFamily {
-  if (!model) return 'unknown';
-  const m = model.trim().toLowerCase();
-  if (!m) return 'unknown';
-  // ⛔ 2026-09-23 — 게이트웨이 접두가 «먼저»다. 안 그러면 `openrouter/anthropic/claude-…` 가 `anthropic` 으로
-  //   읽혀 openrouter 와 «비호환»이 되고, `openrouter/z-ai/…` 는 `unknown` 이라 아무 provider 와도 «호환»이 됐다.
-  if (m.startsWith('openrouter/')) return 'openrouter';
-  // ⭐ BEDROCK-PROVIDER — Bedrock 전용 꼴(`anthropic.claude-…`·지역 접두·`bedrock/…`)이 `includes('claude')` 보다 «먼저».
-  //   1st-party id(`claude-…`)는 그대로 anthropic 이다(불변).
-  if (m.startsWith('bedrock/') || /^(?:[a-z]{2,6}\.)?anthropic\.claude-/.test(m)) return 'bedrock';
-  if (m.includes('grok')) return 'grok';
-  if (m.includes('claude')) return 'anthropic';
-  if (m.startsWith('gemini-') || m.includes('gemini')) return 'gemini';
-  if (m.startsWith('local:')) return 'local';
-  if (m.startsWith('kimi')) return 'kimi';
-  if (m.startsWith('qwen')) return 'qwen';
-  if (m.startsWith('glm')) return 'glm';
-  // openai-codex 구독 모델만 여기 — gpt-5.5 등 Chat Completions 모델은 openai.
-  // ⛔ openai 와 openai-codex 를 한 계열로 접지 마라. 서로 다른 엔드포인트다.
-  // ✅ 2026-09-23 (대표 ⒜ 결정) — ***`gpt-6` 를 여기 «더했다».***
-  //   종전엔 `gpt-6-*` 가 아래 `startsWith('gpt-')` 로 떨어져 `openai` 가 됐고, 그래서
-  //   ***사다리가 «자기 가드가 거부하는 모델»을 가리켰다*** (`CODEX.loaded = gpt-6-astra`).
-  //   📏 구독 경로 실호출로 확인(codex-cli 0.155.1): gpt-6-sol · luna · astra 전부 응답.
-  //   ⚠️ 이 셋은 API 로도 불린다(`/v1/models` 에 있다). 「계열」이 재는 것은 «가용성»이 아니라
-  //      ***「우리가 어느 문으로 보내나」***다 — 5.6 계열도 API 에 있지만 여기로 온다.
-  if (m.includes('codex') || m.startsWith('gpt-5.6') || m.startsWith('gpt-6')) return 'openai-codex';
-  // Exact o1/o3/o4 ids are standard OpenAI models; prefix-only (`o1-`) misses them.
-  if (
-    m.startsWith('gpt-')
-    || m === 'o1' || m.startsWith('o1-')
-    || m === 'o3' || m.startsWith('o3-')
-    || m === 'o4' || m.startsWith('o4-')
-  ) return 'openai';
-  return 'unknown';
-}
-
-/** Cycle-safe compatibility: same-provider model overrides pass;
- *  cross-family ids fail. Unknown prefixes and `auto` stay silent.
- *  ⛔ `openai` 와 `openai-codex` 는 별개 provider — 양방향 호환으로 접지 않는다. */
-export function isRuntimeLlmModelCompatibleWithProvider(
-  provider: LLMProviderName,
-  model: string | undefined,
-): boolean {
-  if (!model) return true;
-  if (provider === 'auto') return true;
-  const family = inferRuntimeLlmModelFamily(model);
-  if (family === 'unknown') return true;
-  if (provider === 'local') return family === 'local';
-  // bedrock 은 1st-party claude id 도 받는다(공급자가 `anthropic.` 접두로 바꿔 보낸다).
-  if (provider === 'bedrock') return family === 'bedrock' || family === 'anthropic';
-  return provider === family;
-}
-
 function observeRuntimeLlmModelProviderMismatch(provider: LLMProviderName, model: string): void {
   debug.log('user-config.llm', 'model-provider-mismatch', { provider, model });
   try {
@@ -5240,6 +5196,7 @@ export function buildUserConfig(path: string = defaultPath()): UserConfig {
       goalLoop: parseGoalLoop(llm.goalLoop),
       memoryJudge: parseMemoryJudge(llm.memoryJudge),
       codexInspectExempt: llm.codexInspectExempt === true ? true : undefined,
+      podHostAcpReview: llm.podHostAcpReview === true ? true : undefined,
       // ⛔⭐ 「false 만 끈다」 — 미설정·true 는 undefined 로 두어 기본 ON 을 유지한다(대표 결정 ②).
       //   ⚠️ 이 줄이 «없으면» 타입만 있고 파서가 안 읽어 ***노브가 no-op 이 된다***(실측으로 잡았다).
       codexAccountRotation: llm.codexAccountRotation === false ? false : undefined,
@@ -6550,6 +6507,7 @@ export function saveUserConfig(
       goalLoop: cfg.llm.goalLoop,
       memoryJudge: cfg.llm.memoryJudge,
       codexInspectExempt: cfg.llm.codexInspectExempt,
+      podHostAcpReview: cfg.llm.podHostAcpReview,
       codexAccountRotation: cfg.llm.codexAccountRotation,
       codexAccountAlerts: cfg.llm.codexAccountAlerts,
       codexAccountRotationThresholdPercent: cfg.llm.codexAccountRotationThresholdPercent,

package/src/ux-sim/fault-cred-expiry.ts

@@ -0,0 +1,100 @@
+// ── 결함 주입 심 — «자격 만료» (grok 구독) ──────────────────────────────────
+//
+// 🚨 왜 이것이 있나 (SIM-VERIFY-KIT 둘째 심 · 2026-10-12)
+//   «만료가 가까운 grok 구독으로 Pod 를 띄움» 은 운영에서 그 시각이 오기를 기다려야 났다
+//   (10-12 node-b · 만료 32분 전 발사 → 헛발사 · AUT-GROK-CRED-EXPIRY-NO-LAUNCH #26465).
+//   이 심은 임시 HOME 에 만료 시각만 정한 자격 파일을 두고 «시계»와 «호스트 갱신 결과»만 바꿔 그 순간을 일으킨다.
+//
+// ⛔ 흉내 내지 않는다: 디스패처가 보는 grokLaunchReadiness 와 Pod 발사 계획이 보는 podGrokSubscriptionUsable 을
+//    그대로 부른다. 바꾸는 것은 자격 파일 위치(임시 HOME) · 시계(now) · 갱신 결과(refresh) 뿐이다 — CLI·네트워크 없음.
+
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import type { GrokRefreshOutcome } from '../grok/credential.js';
+import { POD_GROK_MIN_VALIDITY_MS, grokLaunchReadiness, podGrokSubscriptionUsable, podGrokSkippedLine } from '../task-orchestrator/surfaces/self-implement-pod.js';
+
+export interface CredExpiryScenario {
+  /** 발사 시각 기준 만료까지 남은 시간(ms) — 음수면 이미 만료. */
+  readonly expiresInMs: number;
+  /** 호스트 갱신(`grok models`) 결과 — 'refreshed' 면 만료를 extendToMs 만큼 늘린다. */
+  readonly refresh: GrokRefreshOutcome | 'threw';
+  /** 'refreshed' 일 때 새 만료까지 남은 시간(ms). */
+  readonly extendToMs?: number;
+}
+
+export interface CredExpiryObservation {
+  readonly scenario: CredExpiryScenario;
+  /** 디스패처 읽기 전용 판정(갱신 없음). */
+  readonly readiness: ReturnType<typeof grokLaunchReadiness>;
+  /** 발사 계획 판정(갱신 한 번 시도 뒤). */
+  readonly usable: ReturnType<typeof podGrokSubscriptionUsable>;
+  /** 발사 화면에 나갈 한 줄(빠졌을 때만). */
+  readonly launchLine: string | null;
+  /** 판정이 남긴 관측 줄. */
+  readonly logs: ReadonlyArray<{ category: string; event: string; data: Record<string, unknown> }>;
+}
+
+/** 'refreshed' 에서 extendToMs 를 안 주면 쓰는 새 만료까지의 시간(가정값 · 표에 «→12h00m» 으로 보인다). */
+export const DEFAULT_EXTEND_MS = 12 * 3600_000;
+
+function writeAuth(home: string, expiresAtMs: number): void {
+  mkdirSync(join(home, '.grok'), { recursive: true });
+  writeFileSync(join(home, '.grok', 'auth.json'), JSON.stringify({
+    'https://auth.x.ai::client': { key: 'sim-access', expires_at: new Date(expiresAtMs).toISOString(), refresh_token: 'sim-refresh' },
+  }));
+}
+
+/** 한 시나리오를 임시 HOME 에서 돌리고 지운다. */
+export function simCredExpiry(scenario: CredExpiryScenario): CredExpiryObservation {
+  const home = mkdtempSync(join(tmpdir(), 'ux-sim-cred-expiry-'));
+  try {
+    const now = Date.now();
+    writeAuth(home, now + scenario.expiresInMs);
+    const readiness = grokLaunchReadiness({ home, env: {} as NodeJS.ProcessEnv });
+    const logs: Array<{ category: string; event: string; data: Record<string, unknown> }> = [];
+    const usable = podGrokSubscriptionUsable({
+      home, env: {} as NodeJS.ProcessEnv,
+      refresh: () => {
+        if (scenario.refresh === 'threw') throw new Error('sim: grok CLI threw');
+        if (scenario.refresh === 'refreshed') writeAuth(home, Date.now() + (scenario.extendToMs ?? DEFAULT_EXTEND_MS));
+        return scenario.refresh;
+      },
+      log: (category, event, data) => { logs.push({ category, event, data }); },
+    });
+    return { scenario, readiness, usable, launchLine: usable.usable ? null : podGrokSkippedLine(usable), logs };
+  } finally {
+    rmSync(home, { recursive: true, force: true });
+  }
+}
+
+/** 기본 훑기 — 10-12 node-b 사건(만료 32분 전)을 갱신 결과 넷으로, 그리고 경계(최소 유효 시간 앞뒤)를. */
+export function credExpirySweep(): CredExpiryObservation[] {
+  const min = 60_000;
+  return [
+    simCredExpiry({ expiresInMs: 12 * 3600_000, refresh: 'unchanged' }),
+    simCredExpiry({ expiresInMs: POD_GROK_MIN_VALIDITY_MS + 5 * min, refresh: 'unchanged' }),
+    simCredExpiry({ expiresInMs: POD_GROK_MIN_VALIDITY_MS - 5 * min, refresh: 'unchanged' }),
+    simCredExpiry({ expiresInMs: 32 * min, refresh: 'unchanged' }),
+    simCredExpiry({ expiresInMs: 32 * min, refresh: 'refreshed' }),
+    simCredExpiry({ expiresInMs: 32 * min, refresh: 'refreshed', extendToMs: 60 * min }),
+    simCredExpiry({ expiresInMs: 32 * min, refresh: 'failed' }),
+    simCredExpiry({ expiresInMs: 32 * min, refresh: 'threw' }),
+    simCredExpiry({ expiresInMs: -10 * min, refresh: 'no-credential' }),
+  ];
+}
+
+/** CLI 한 화면 — 시나리오마다 한 줄. */
+export function renderCredExpiry(rows: readonly CredExpiryObservation[]): string[] {
+  const hm = (ms: number) => `${Math.floor(ms / 3600_000)}h${String(Math.floor((ms % 3600_000) / 60_000)).padStart(2, '0')}m`;
+  const fmt = (ms: number) => (ms < 0 ? `만료+${hm(-ms)}` : hm(ms));
+  return [
+    `cred-expiry · grok 구독 · 최소 유효 ${fmt(POD_GROK_MIN_VALIDITY_MS)}`,
+    ...rows.map((r) => {
+      const ready = r.readiness.ready ? 'ready' : `not-ready(${r.readiness.reason})`;
+      const use = r.usable.usable ? 'usable' : `dropped(${r.usable.reason})`;
+      const ext = r.scenario.refresh === 'refreshed' ? `(→${fmt(r.scenario.extendToMs ?? DEFAULT_EXTEND_MS)})` : '';
+      return `  만료까지 ${fmt(r.scenario.expiresInMs).padStart(9)} · 갱신 ${(r.scenario.refresh + ext).padEnd(18)} → 디스패처 ${ready.padEnd(20)} · 발사 ${use}`;
+    }),
+  ];
+}

package/src/ux-sim/fault-pod-death.ts

@@ -0,0 +1,74 @@
+// ── 결함 주입 심 — «Pod 사망» ────────────────────────────────────────────────
+//
+// 🚨 왜 이것이 있나 (SIM-VERIFY-KIT · 2026-10-12)
+//   «PARTIAL 줄을 남긴 Pod 가 SIGTERM 으로 사라짐» 은 운영에서 카나리를 쏘고 Pod 를 지워야만 났다
+//   (10-12 06:1x TC S3 카나리 run-4c6a70b1 — Pod 안에 PARTIAL 줄이 있었는데 호스트는 결손 줄만 남겼다).
+//   이 심은 그 사건을 «기다리지 않고 일으킨다» — 호스트가 가진 입력(끝 로그 · 도는 동안 본 PARTIAL · 종료 정보)만 준다.
+//
+// ⛔ 흉내 내지 않는다: 호스트 Job 경로가 부르는 «같은» 순수 함수 podUsageReemitPlan 을 그대로 부른다
+//    (METER-POD-ROLLUP-GAP-3 · self-implement-pod.ts). kubectl·Pod·네트워크는 없다.
+
+import { podUsageReemitPlan, type PodUsageReemitInput, type PodUsageReemitPlan } from '../task-orchestrator/surfaces/self-implement-pod.js';
+
+export type PodDeathScenario = PodUsageReemitInput;
+
+export interface PodDeathRow {
+  readonly category: string;
+  readonly event: string;
+  readonly data: Record<string, unknown>;
+}
+
+export interface PodDeathObservation {
+  /** 어느 줄로 재방출했나(final · partial-log · partial-live · missing · unparsable). */
+  readonly source: PodUsageReemitPlan['source'];
+  /** 호스트가 남길 관측 줄 전부(순서 그대로). */
+  readonly rows: readonly PodDeathRow[];
+  /** 사용량 행(llm.usage/llm-usage) 중 PARTIAL 에서 다시 낸 것(partial:true). */
+  readonly partialRows: readonly PodDeathRow[];
+  /** 결손 행(site=pod-rollup:missing). */
+  readonly missingRows: readonly PodDeathRow[];
+}
+
+/** Pod 안 부분 롤업 표본기가 내는 꼴 그대로의 PARTIAL 줄. */
+export function simPartialLine(seq = 1): string {
+  return `ELANOUS_USAGE_ROLLUP_PARTIAL ${JSON.stringify({
+    measured: true, partial: true, seq, at: '2026-10-12T00:00:00.000Z', runId: 'run-sim-pod-death', podName: 'si-sim-pod-death',
+    rows: [{ site: 'self-implement', provider: 'openrouter', model: 'z-ai/glm-5.3', calls: 3, inputTokens: 1200, outputTokens: 300 }],
+  })}`;
+}
+
+/** «PARTIAL 한 줄을 남기고 SIGTERM 으로 지워진 Pod» 기본 시나리오 — 끝 로그는 비었고, 호스트는 도는 동안 PARTIAL 을 봤다. */
+export function podDeathAfterPartialScenario(overrides: Partial<PodDeathScenario> = {}): PodDeathScenario {
+  return {
+    job: 'si-sim-pod-death',
+    runId: 'run-sim-pod-death',
+    logs: '',
+    livePartialLine: simPartialLine(),
+    exit: { state: 'failed', containerReason: 'Error', containerExitCode: 143 },
+    ...overrides,
+  };
+}
+
+/** 시나리오를 호스트 재방출 판정에 넣고 관측을 나눠 돌려준다. */
+export function simPodDeath(scenario: PodDeathScenario = podDeathAfterPartialScenario()): PodDeathObservation {
+  const plan = podUsageReemitPlan(scenario);
+  const usage = plan.rows.filter((r) => r.category === 'llm.usage' && r.event === 'llm-usage');
+  return {
+    source: plan.source,
+    rows: plan.rows,
+    // 결손 행은 partial 꼬리표가 없지만, 꼬리표가 붙어도 «재방출»로 세지 않도록 site 로 한 번 더 뺀다.
+    partialRows: usage.filter((r) => r.data.partial === true && r.data.site !== 'pod-rollup:missing'),
+    missingRows: usage.filter((r) => r.data.site === 'pod-rollup:missing'),
+  };
+}
+
+/** CLI 한 화면 — 사람이 읽는 요약. */
+export function renderPodDeath(obs: PodDeathObservation): string[] {
+  const missing = obs.missingRows[0]?.data;
+  return [
+    `pod-death · source=${obs.source} · 관측 줄 ${obs.rows.length}`,
+    `  PARTIAL 재방출 행: ${obs.partialRows.length}`,
+    `  결손 행: ${obs.missingRows.length}${missing ? ` · reason=${String(missing.reason)} · podExitClass=${String(missing.podExitClass ?? '-')}` : ''}`,
+    ...obs.rows.map((r) => `  ${r.category} ${r.event} ${JSON.stringify(r.data)}`),
+  ];
+}

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

@@ -0,0 +1,81 @@
+// ── 결함 주입 심 — «풀 상한 없음» (Pod 풀 스펙에 `:N` 이 빠짐) ────────────────
+//
+// 🚨 왜 이것이 있나 (SIM-VERIFY-KIT 셋째 심 · 2026-10-12)
+//   `--pod-pool pool-x@host` 처럼 `:N` 을 빼면 «상한 없음»이 아니라 기본 상한 2 다. 그 풀은 Pod 두 개가 돌면
+//   승인 0 으로 멈추는데, 운영에선 프로브를 띄워 40분을 기다려야 보였다(10-10 · POD-POOL-UNCAPPED-SPEC).
+//   이 심은 스펙 문자열과 «멤버마다 지금 도는 Pod 수»만 주고 승인 판정을 바로 낸다.
+//
+// ⛔ 흉내 내지 않는다: 스펙은 진짜 parsePodPool 로 읽고, 승인은 진짜 recommendConcurrency 가 정한다.
+//    클러스터 측정(kubectl)만 «메모리·CPU 넉넉한 노드»로 채운다 — 메모리가 아니라 상한이 판정을 정하게 하려는 것이다.
+
+import { recommendConcurrency, type PodLeaseMember, type PoolLeaseRecommendation } from '../task-orchestrator/surfaces/pod-lease.js';
+import { parsePodPool } from '../task-orchestrator/surfaces/pod-pool.js';
+
+const GiB = 1024 ** 3;
+
+export interface PoolCapScenario {
+  /** `--pod-pool` 값 그대로(예: `pool-node-b@node-b` · `pool-node-b@node-b:20,pool-node-c@node-c`). */
+  readonly spec: string;
+  /** 멤버(컨텍스트)마다 지금 Running 인 하니스 Pod 수 — 멤버마다 «반드시» 준다(빠지면 0 으로 꾸미지 않고 던진다). */
+  readonly running: Readonly<Record<string, number>>;
+}
+
+export interface PoolCapObservation {
+  readonly scenario: PoolCapScenario;
+  readonly members: ReadonlyArray<{ context: string; capacity: number; capacityDefaulted: boolean; running: number }>;
+  readonly recommendation: PoolLeaseRecommendation;
+}
+
+/** 메모리·CPU 가 넉넉한 노드 한 대 — 승인이 상한(capacity)으로만 갈리게 한다. */
+function roomyMember(context: string, capacity: number, capacityDefaulted: boolean, running: number): PodLeaseMember {
+  return {
+    context, capacity, ...(capacityDefaulted ? { capacityDefaulted: true } : {}),
+    running, pending: 0, pendingJobs: [], unleasedRunning: 0,
+    memoryLimitBytes: running * 16 * GiB, allocatableMemoryBytes: 1024 * GiB, allocatableCpuMillicores: 256_000,
+    availableMemoryByNodeBytes: [1024 * GiB - running * 16 * GiB], reason: null,
+  };
+}
+
+function runningOf(scenario: PoolCapScenario, context: string): number {
+  const n = scenario.running[context];
+  if (n === undefined || !Number.isSafeInteger(n) || n < 0) {
+    throw new Error(`simPoolCap: 멤버 「${context}」 의 Running 수가 없다 — 모르는 점유를 0 으로 꾸미지 않는다`);
+  }
+  return n;
+}
+
+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),
+  }));
+  const recommendation = recommendConcurrency(
+    { 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 };
+}
+
+/** 기본 훑기 — 상한 뺀 스펙이 Pod 둘에서 막히는 순간과, 상한을 적은 스펙의 대조. */
+export function poolCapSweep(): PoolCapObservation[] {
+  return [
+    simPoolCap({ spec: 'pool-node-b@node-b', running: { 'pool-node-b': 0 } }),
+    simPoolCap({ spec: 'pool-node-b@node-b', running: { 'pool-node-b': 1 } }),
+    simPoolCap({ spec: 'pool-node-b@node-b', running: { 'pool-node-b': 2 } }),
+    simPoolCap({ spec: 'pool-node-b@node-b:20', running: { 'pool-node-b': 2 } }),
+    simPoolCap({ spec: 'pool-node-b@node-b:20', running: { 'pool-node-b': 20 } }),
+    simPoolCap({ spec: 'pool-node-b@node-b:20,pool-node-c@node-c', running: { 'pool-node-b': 20, 'pool-node-c': 2 } }),
+    simPoolCap({ spec: 'pool-node-b@node-b:20,pool-node-c@node-c', running: { 'pool-node-b': 20, 'pool-node-c': 0 } }),
+  ];
+}
+
+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)}`;
+    }),
+  ];
+}

package/src/version/packed-revision.json

@@ -1 +1 @@
-{"commit":"5becb929a329b00adf1e2366f50edb73ea0f9497"}
+{"commit":"c35a05489ca5528f8c3b63e6adbc04d073b4a430"}

package/src/webclone/qa-table.ts

@@ -0,0 +1,22 @@
+import {
+  compareLayoutAcrossViewports,
+  renderResponsiveSection,
+  type ViewportSample,
+} from './responsive-layout.js';
+
+const QA_WIDTHS = [390, 768, 1280] as const;
+
+export function siteQaTable(samples: readonly ViewportSample[]): {
+  widths: number[];
+  lines: string[];
+  realDevice: '미확인';
+} {
+  const qaSamples = samples.filter((sample) => QA_WIDTHS.some((width) => width === sample.width));
+  const report = compareLayoutAcrossViewports(qaSamples);
+  const lines = [`폭 ${QA_WIDTHS.join(' · ')}`];
+  for (const width of QA_WIDTHS) {
+    if (!qaSamples.some((sample) => sample.width === width)) lines.push(`${width} 못 잼`);
+  }
+  lines.push(...renderResponsiveSection(report), '실기기: 미확인');
+  return { widths: [...QA_WIDTHS], lines, realDevice: '미확인' };
+}