elanous 0.2.36 → 0.2.37

package/src/cli/msg-cli.ts

@@ -57,7 +57,7 @@ export interface MsgCliDeps {
 }
 
 type CommonOptions = { json?: boolean };
-type RecipientOptions = CommonOptions & { to?: string; after?: string; limit?: string };
+type RecipientOptions = CommonOptions & { to?: string; after?: string; limit?: string; thread?: string };
 
 function seat(raw: string | undefined, flag: string): string {
   if (raw === undefined) throw new Error(`${flag} is required`);
@@ -316,14 +316,19 @@ export function registerMsgCommands(program: Command, deps: MsgCliDeps = {}): vo
         + `\t(${wake.source}${wake.reason ? `: ${wake.reason}` : ''})`));
     })());
 
-  msg.command('list').description('List messages for one recipient without acknowledging them')
-    .option('--to <seat>').option('--after <id>', 'exclusive message ID (default: acknowledged cursor)')
+  msg.command('list').description('List messages for one recipient or one thread without acknowledging them')
+    .option('--to <seat>').option('--thread <id>', 'request ID; list it and its replies, regardless of recipient')
+    .option('--after <id>', 'exclusive message ID (default: acknowledged cursor for a recipient, 0 for a thread)')
     .option('--limit <count>', 'maximum messages (1–1000)').option('--json')
     .action((opts: RecipientOptions) => run(() => {
-      const to = seat(opts.to, '--to');
+      if (opts.thread !== undefined && opts.to !== undefined) throw new Error('--thread cannot be used with --to');
+      const to = opts.thread === undefined ? seat(opts.to, '--to') : undefined;
+      const threadId = opts.thread === undefined ? undefined : integer(opts.thread, '--thread', 0, 1, Number.MAX_SAFE_INTEGER);
       const limit = integer(opts.limit, '--limit', 100, 1, 1000);
       const after = opts.after === undefined ? undefined : integer(opts.after, '--after', 0, 0, Number.MAX_SAFE_INTEGER);
-      const messages = withStore(store => store.list(to, after ?? store.getCursor(to), limit));
+      const messages = withStore(store => threadId === undefined
+        ? store.list(to!, after ?? store.getCursor(to!), limit)
+        : store.listThread(threadId, after ?? 0, limit));
       emit(messages, opts.json, () => {
         if (!messages.length) out.log('No messages.');
         for (const message of messages) out.log(formatMessage(message));
@@ -499,18 +504,17 @@ export function registerMsgCommands(program: Command, deps: MsgCliDeps = {}): vo
     .action((id: string, opts: CommonOptions) => run(() => {
       const target = integer(id, 'message ID', 0, 1, Number.MAX_SAFE_INTEGER);
       const thread = withStore(store => {
-        const question = store.getMessage(target);
-        if (question === null) throw new Error(`message not found: #${target}`);
         // Keep paging until a short page so a thread longer than one store page is never truncated.
-        const replies: Message[] = [];
+        const messages: Message[] = [];
         let after = 0;
         let page: Message[];
         do {
-          page = store.listReplies(target, 100, after);
-          replies.push(...page);
+          page = store.listThread(target, after, 100);
+          messages.push(...page);
           after = page.at(-1)?.id ?? after;
         } while (page.length === 100);
-        return { question, replies };
+        const [question, ...replies] = messages;
+        return { question: question!, replies };
       });
       emit(thread, opts.json, () => {
         out.log(formatMessage(thread.question));

package/src/cli/pr-granularity.ts

@@ -76,7 +76,7 @@ export interface OverlapEntry {
 }
 
 /** Restrict `git log` to commits already on the resolved base, excluding HEAD-only feature commits. */
-export function landingHistoryLogArgs(since: string, baseRef: string): string[] {
+export function landingHistoryLogArgs(since: string | null, baseRef: string): string[] {
   return landingHistoryGitLogArgs(since, baseRef).map((arg) =>
     arg === '--pretty=format:commit %H' ? landingHistoryPrettyFormat() : arg,
   );
@@ -381,9 +381,11 @@ export function countRecentLandingsByAuthor(
 export function collectBaseLandingCommits(
   run: CmdRunner,
   cwd: string,
-  opts: { since?: string; baseRef: string },
+  opts: { since?: string | null; baseRef: string },
 ): LandingCommit[] | null {
-  const since = opts.since?.trim() || DEFAULT_GRANULARITY_SINCE;
+  const since = opts.since === null
+    ? null
+    : opts.since?.trim() || DEFAULT_GRANULARITY_SINCE;
   const history = run('git', landingHistoryLogArgs(since, opts.baseRef), { cwd });
   if (!history.ok) return null;
   return parseCommitNameLog(history.out);

package/src/cli/release-checklist-read-cli.ts

@@ -1,10 +1,11 @@
 import { existsSync, readFileSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
 import { join } from 'node:path';
 import type { Command } from 'commander';
 import { debug } from '../debug/log.js';
 import { getElanousConfigDirOverride } from '../elanous-config-dir.js';
 import { effectiveInstanceRoot } from '../instance/resolve.js';
-import { devVersion, listChecklist, ownerMatches, parseOwner, parityGap, summarizeChecklist } from '../release-loop/checklist.js';
+import { checklistEvidenceChain, devVersion, listChecklist, ownerMatches, parseOwner, parityGap, summarizeChecklist, type ChecklistEvidenceStage } from '../release-loop/checklist.js';
 import { userConfigPath } from '../user-config.js';
 import { CliUserError } from './cli-user-error.js';
 import { writeStdoutJson } from './stdout-json.js';
@@ -55,8 +56,102 @@ export async function checklistOutput(v: string, codenames: Record<string, strin
   }
 }
 
+export type ChecklistEvidenceReader = (item: ReturnType<typeof listChecklist>['items'][number], version: string) => readonly ChecklistEvidenceStage[];
+
+export type ChecklistEvidenceCommandRunner = (command: string, args: string[], timeout?: number) => { status: number | null; stdout: string; stderr: string; error?: string };
+const evidenceCommand: ChecklistEvidenceCommandRunner = (command, args, timeout = 20_000) => {
+  const result = spawnSync(command, args, { cwd: process.cwd(), encoding: 'utf8', timeout, maxBuffer: 4 * 1024 * 1024 });
+  return { status: result.status, stdout: result.stdout ?? '', stderr: result.stderr ?? '', ...(result.error ? { error: result.error.message } : {}) };
+}
+
+function evidenceJson(stdout: string): Record<string, unknown> | null {
+  for (const line of stdout.split(/\r?\n/u).reverse()) {
+    const start = line.indexOf('{');
+    if (start < 0) continue;
+    try { return JSON.parse(line.slice(start)) as Record<string, unknown>; } catch { /* try another complete JSON line */ }
+  }
+  return null;
+}
+
+export function collectChecklistEvidenceStages(item: ReturnType<typeof listChecklist>['items'][number], run: ChecklistEvidenceCommandRunner = evidenceCommand): ChecklistEvidenceStage[] {
+  const measuredAt = new Date().toISOString();
+  const evidence = item.evidence ?? '';
+  const prRefs = [...new Set([...evidence.matchAll(/(?:^|\s)#(\d{1,8})\b/gu)].map((match) => match[1]!))];
+  const pr = prRefs.length === 1 ? prRefs[0] : undefined;
+  const prLine = pr ? evidence.split(/\r?\n/u).find((line) => new RegExp(`(?:^|\\s)#${pr}\\b`).test(line)) : undefined;
+  const e1: ChecklistEvidenceStage = { id: 'E1', state: 'missing', source: 'checklist evidence + eln gh pr view', measuredAt,
+    reason: prRefs.length > 1 ? '근거에서 교차할 PR이 하나로 좁혀지지 않는다' : '근거에 병합 PR 번호가 없다' };
+  let mergeSha: string | null = null;
+  if (pr) {
+    const view = run('eln', ['gh', 'pr', 'view', pr, '--json', 'state,mergeCommit']);
+    const record = view.status === 0 ? evidenceJson(view.stdout) : null;
+    if (!record) { e1.state = 'unmeasurable'; e1.reason = `PR #${pr} 조회 실패${view.error ? `: ${view.error}` : ''}`; }
+    else if (record.state !== 'MERGED') { e1.reason = `PR #${pr} 상태가 MERGED가 아니다`; }
+    else {
+      const commit = record.mergeCommit && typeof record.mergeCommit === 'object' ? (record.mergeCommit as { oid?: unknown }).oid : null;
+      mergeSha = typeof commit === 'string' && /^[a-f0-9]{40}$/i.test(commit) ? commit : null;
+      if (!mergeSha) { e1.state = 'unmeasurable'; e1.reason = `PR #${pr} 조회에 유효한 merge SHA가 없다`; }
+      else if (!prLine || !new RegExp(`\\b${mergeSha}\\b`, 'i').test(prLine)) { e1.reason = `병합 PR #${pr}와 merge SHA가 같은 근거 줄에서 결속되지 않았다`; e1.source = `eln gh pr view #${pr} → ${mergeSha}`; }
+      else { e1.state = 'observed'; e1.reason = `PR #${pr} MERGED 및 merge SHA가 근거와 일치한다`; e1.source = `eln gh pr view #${pr} → ${mergeSha}`; }
+    }
+  }
+
+  const e3: ChecklistEvidenceStage = { id: 'E3', state: 'unmeasurable', source: null, measuredAt, reason: mergeSha ? '설치본 pin을 조회하지 못했다' : 'E1 merge SHA가 없어 조상 관계를 검사할 수 없다' };
+  if (mergeSha) {
+    const pin = run('eln', ['--version']);
+    const pinSha = pin.stdout.match(/\b[a-f0-9]{40}\b/i)?.[0];
+    if (!pinSha) e3.reason = `eln --version에서 설치본 SHA를 읽지 못했다${pin.error ? `: ${pin.error}` : ''}`;
+    else {
+      const repoRoot = run('git', ['rev-parse', '--show-toplevel']);
+      const origin = run('git', ['remote', 'get-url', 'origin']);
+      const pinObject = run('git', ['cat-file', '-e', `${pinSha}^{commit}`]);
+      const repoUrl = origin.stdout.trim().replace(/^git@github\.com:/i, 'https://github.com/').replace(/\.git$/i, '').replace(/\/$/u, '').toLowerCase();
+      const expectedRepo = 'https://github.com/elanvitalai/elanous';
+      if (repoRoot.status !== 0 || !repoRoot.stdout.trim() || origin.status !== 0 || repoUrl !== expectedRepo || pinObject.status !== 0) {
+        e3.reason = '현재 git 저장소가 elanous 원본이 아니거나 설치본 pin 객체가 없어 조상 관계를 판정할 수 없다';
+      } else {
+      const ancestry = run('git', ['merge-base', '--is-ancestor', mergeSha, pinSha]);
+      e3.source = `eln --version ${pinSha}; git -C ${repoRoot.stdout.trim()} merge-base --is-ancestor ${mergeSha} ${pinSha}`;
+      if (ancestry.status === 0) { e3.state = 'observed'; e3.reason = '설치본 pin이 merge SHA의 후손이다'; }
+      else if (ancestry.status === 1) { e3.state = 'missing'; e3.reason = '설치본 pin이 merge SHA의 후손이 아니다'; }
+      else { e3.reason = `설치본 저장소에서 조상 관계를 검사할 수 없다${ancestry.error ? `: ${ancestry.error}` : ''}`; }
+      }
+    }
+  }
+
+  const runId = /\b(run-[a-f0-9]{8}-[a-f0-9-]{27,})\b/i.exec(evidence)?.[1]
+    ?? /\b([a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})\b/i.exec(evidence)?.[1];
+  const event = /(?:event|이벤트)\s*[:=]\s*([A-Za-z0-9_.:-]+)/iu.exec(evidence)?.[1];
+  const verificationCommand = /(?:완료 경계 증거 명령|증거 명령|verification command)\s*[:=]\s*([^\r\n]+)/iu.exec(`${item.title}\n${evidence}`)?.[1]?.trim() ?? null;
+  const e4: ChecklistEvidenceStage = { id: 'E4', state: 'missing', source: null, measuredAt, verificationCommand, reason: '근거에 runId·event·원문 검증 명령이 모두 필요하다' };
+  if (runId && event && verificationCommand) {
+    const logs = run('eln', ['logs', '--grep', runId, '--since', '365d', '--all', '--include-test', '--limit', '1000', '--json'], 30_000);
+    if (logs.status !== 0) { e4.state = 'unmeasurable'; e4.reason = `runId 로그 조회 실패${logs.error ? `: ${logs.error}` : ''}`; }
+    else {
+      const rows = logs.stdout.split(/\r?\n/u).flatMap((line) => { try { return [JSON.parse(line) as Record<string, unknown>]; } catch { return []; } });
+      const truncated = rows.length >= 1000 || rows.some((row) => row._meta && typeof row._meta === 'object' && (row._meta as { limitReached?: unknown }).limitReached === true);
+      const observed = rows.some((row) => {
+        if (row.event !== event || typeof row.data !== 'string') return false;
+        try { return (JSON.parse(row.data) as { runId?: unknown }).runId === runId; } catch { return false; }
+      });
+      e4.source = `eln logs --grep ${runId} --since 365d --all --include-test --limit 1000 --json (event=${event})`;
+      if (observed) { e4.state = 'observed'; e4.reason = `같은 runId의 ${event} 실물 이벤트를 찾았다`; }
+      else if (truncated) { e4.state = 'unmeasurable'; e4.reason = '로그 결과가 잘려 사건 부재를 판정할 수 없다'; }
+      else { e4.reason = `같은 runId의 ${event} 이벤트가 없다`; }
+    }
+  }
+
+  const acceptance = /- 완료 경계 실물:([^\r\n]+)/u.exec(item.title)?.[1]?.trim();
+  const e5Observed = Boolean(acceptance && evidence.includes(acceptance));
+  const e5: ChecklistEvidenceStage = { id: 'E5', state: e5Observed ? 'observed' : 'missing', source: 'checklist title/evidence exact acceptance-text comparison', measuredAt,
+    reason: e5Observed ? '완료 경계 실물 문구가 기록된 근거와 일치한다' : '완료 경계 실물 문구와 일치하는 근거가 없다' };
+  return [
+    e1, e3, e4, e5,
+  ];
+}
+
 /** Register the same read commands on the full and lightweight release roots. */
-export function registerChecklistReadCommands(checklist: Command): void {
+export function registerChecklistReadCommands(checklist: Command, evidenceReader: ChecklistEvidenceReader = collectChecklistEvidenceStages): void {
   const withContext = (cmd: Command) => cmd.option('--version <v>', '판 또는 별칭').option('--json', '결과 JSON').option('--hq-override', '본부 임대 거부를 관측하며 수동 우회');
   withContext(checklist.command('list').description('모든 칸')).option('--owner <owner>', '자리 또는 하위 자리로 거르기').action(async (opts: { owner?: string }, cmd: Command) => {
     const { version, codenames, json } = readChecklistContext(cmd);
@@ -66,14 +161,24 @@ export function registerChecklistReadCommands(checklist: Command): void {
     const { version, codenames, json } = readChecklistContext(cmd);
     await checklistOutput(version, codenames, 'status', json, opts.owner);
   });
+  withContext(checklist.command('evidence [id]').description('칸의 단계별 실물 근거 사슬 조회·PR 참조 추가'))
+    .action(async (id: string | undefined, _opts: unknown, cmd: Command) => {
+      const { version, json } = readChecklistContext(cmd);
+      if (!id) throw new CliUserError('조회할 칸 id를 지정하라');
+      if (!json) throw new CliUserError('evidence 조회는 --json 이 필요하다');
+      const item = listChecklist(version).items.find((row) => row.id === id);
+      if (!item) throw new CliUserError(`없는 칸: ${id}`);
+      const result = checklistEvidenceChain({ item, version, stages: evidenceReader(item, version) });
+      await writeStdoutJson(`${JSON.stringify(result)}\n`);
+    });
 }
 
 /** The light router enters only list/status, so no publishing modules are loaded. */
-export function registerReleaseChecklistReadCommands(program: Command): void {
+export function registerReleaseChecklistReadCommands(program: Command, evidenceReader: ChecklistEvidenceReader = collectChecklistEvidenceStages): void {
   const release = program.command('release').description('공개 배포 한 판 — prepare(로컬) → publish(--yes) → verify (docs/manual/MANUAL-versioning-and-release-2026-09-25.md)');
   const checklist = release.command('checklist').description('판별 확인표 조회·갱신')
     .option('--version <v>', '판 또는 별칭(기본: package.json 의 개발판에서 -dev.N 제거)')
     .option('--json', '결과 JSON')
     .option('--hq-override', '본부 임대 거부를 관측하며 수동 우회');
-  registerChecklistReadCommands(checklist);
+  registerChecklistReadCommands(checklist, evidenceReader);
 }

package/src/cli/release-cli.ts

@@ -57,7 +57,7 @@ import { landingFreezeMessage, LandingFrozenError, readLandingFreeze } from '../
 import { formatLightRc, runLightRc, type LightRcDeps } from '../release-loop/light-rc.js';
 import { applyWatchList, formatGateHistory, gateHistory, ghMergedPrs } from '../../scripts/release-loop/gate-history.js';
 import { registerRfcCommands } from './rfc-cli.js';
-import { checklistCodenames, checklistVersion, isReleaseVersion, readChecklistContext, registerChecklistReadCommands } from './release-checklist-read-cli.js';
+import { checklistCodenames, checklistVersion, isReleaseVersion, readChecklistContext, registerChecklistReadCommands, type ChecklistEvidenceReader } from './release-checklist-read-cli.js';
 
 export { isReleaseVersion } from './release-checklist-read-cli.js';
 
@@ -547,19 +547,35 @@ export interface LandedButYellowDeps {
   evidenceAdd?: typeof features.evidenceAdd;
   schedules?: typeof features.readSchedules;
   released?: typeof features.releasedVersion;
+  /** Isolated cache location for tests; production defaults to the installation release ledger. */
+  mergedPrCacheFile?: () => string;
 }
 
 /** A spawn failure (gh missing from PATH) resolves `status: null` with the error text — the shape the sync runner gave. */
-const defaultMergedPrRunner: MergedPrRunner = (command, args, cwd) => new Promise((resolve) => {
+const defaultMergedPrRunner: MergedPrRunner = (command, args, cwd, timeoutMs) => new Promise((resolve) => {
   const out: Buffer[] = [], err: Buffer[] = [];
   const failed = (error: unknown) => resolve({ status: null, stdout: Buffer.concat(out).toString('utf8'), stderr: String(error) });
   let child: ReturnType<typeof spawn>;
+  let timedOut = false;
+  let timeout: ReturnType<typeof setTimeout> | undefined;
+  let killTimeout: ReturnType<typeof setTimeout> | undefined;
   try { child = spawn(command, [...args], { cwd, env: process.env, stdio: ['ignore', 'pipe', 'pipe'] }); }
   catch (error) { failed(error); return; }
+  if (timeoutMs !== undefined) timeout = setTimeout(() => {
+    timedOut = true;
+    child.kill('SIGTERM');
+    // The caller has already reached its explicit limit. Give gh a short cleanup window, then
+    // force-close it so an ignoring child cannot keep the CLI alive for the former 5s grace.
+    killTimeout = setTimeout(() => child.kill('SIGKILL'), 100);
+  }, timeoutMs);
   child.stdout?.on('data', (chunk: Buffer) => out.push(chunk));
   child.stderr?.on('data', (chunk: Buffer) => err.push(chunk));
   child.on('error', failed);
-  child.on('close', (code) => resolve({ status: code, stdout: Buffer.concat(out).toString('utf8'), stderr: Buffer.concat(err).toString('utf8') }));
+  child.on('close', (code) => {
+    if (timeout !== undefined) clearTimeout(timeout);
+    if (killTimeout !== undefined) clearTimeout(killTimeout);
+    resolve({ status: code, stdout: Buffer.concat(out).toString('utf8'), stderr: Buffer.concat(err).toString('utf8'), ...(timedOut ? { timedOut: true } : {}) });
+  });
 });
 
 function printLandedRows(rows: ReturnType<typeof landedButYellow>, items: ReturnType<typeof listChecklist>['items']): void {
@@ -588,7 +604,7 @@ function compareReleaseVersions(a: string, b: string): number {
   return 0;
 }
 
-export function registerReleaseCommands(program: Command, releaseRunDeps: UnattendedReleaseDeps = {}, landedDeps: LandedButYellowDeps = {}, hqDeps: HqDeps = {}, lightRcDeps: LightRcDeps = {}, rehearsalDeps: RehearsalDeps = {}, resumeDeps: ResumeReleaseDeps = {}): void {
+export function registerReleaseCommands(program: Command, releaseRunDeps: UnattendedReleaseDeps = {}, landedDeps: LandedButYellowDeps = {}, hqDeps: HqDeps = {}, lightRcDeps: LightRcDeps = {}, rehearsalDeps: RehearsalDeps = {}, resumeDeps: ResumeReleaseDeps = {}, checklistEvidenceReader?: ChecklistEvidenceReader): void {
   registerRfcCommands(program);
   const release = program.command('release').description('공개 배포 한 판 — prepare(로컬) → publish(--yes) → verify (docs/manual/MANUAL-versioning-and-release-2026-09-25.md)');
   const schedule = release.command('schedule').description('판별 컷·착지 마감 조회·갱신');
@@ -780,13 +796,15 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
       console.log(renderRefsStatus(rows));
       console.log(`칸 ${rows.length} · 🟢 ${byStatus.green} · 🟡 ${byStatus.yellow} · 🔴 ${byStatus.red} · ✅ ${byStatus.done}`);
     });
-  registerChecklistReadCommands(checklist);
+  registerChecklistReadCommands(checklist, checklistEvidenceReader);
   withContext(checklist.command('landed-but-yellow').description('병합 PR 이 있지만 노랑·빨강인 칸(기본 읽기 전용)'))
     .option('--owner <owner>', '자리 또는 하위 자리로 거르기')
     .option('--open', '미발행 일정 판 중 칸이 있는 판 전부')
     .option('--apply-evidence', '확실한 PR 짝의 근거를 붙인다(상태는 그대로)')
     .option('--dry-run', '근거 추가 없이 계획만 출력')
-    .action(async (opts: { owner?: string; open?: boolean; applyEvidence?: boolean; dryRun?: boolean }, cmd: Command) => {
+    .option('--limit <ms>', '병합 PR 창 조회 시간 상한(밀리초) — 기본 무제한, 명시하면 초과 시 부분 결과와 stopReason·남은 칸 판 목록을 낸다')
+    .option('--time-budget <ms>', 'deprecated alias of --limit')
+    .action(async (opts: { owner?: string; open?: boolean; applyEvidence?: boolean; dryRun?: boolean; limit?: string; timeBudget?: string }, cmd: Command) => {
       // Stage timings (LANDED-YELLOW-FAST): which step ate the time — `elanous logs --category release.landed-yellow`.
       let stageAt = performance.now();
       const stage = (name: string, data: Record<string, unknown>) => {
@@ -835,10 +853,20 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
           .map((item) => Date.parse(item.updatedAt)).filter((at) => Number.isFinite(at)));
         const since = updated.length ? new Date(updated.reduce((earliest, at) => Math.min(earliest, at))).toISOString().slice(0, 10)
           : new Date(now.getTime() - 7 * 86_400_000).toISOString().slice(0, 10);
+        if (opts.limit !== undefined && opts.timeBudget !== undefined) throw new CliUserError('--limit 과 --time-budget 중 하나만 지정할 수 있다');
+        const timeBudget = opts.limit ?? opts.timeBudget;
+        const timeBudgetMs = timeBudget === undefined ? undefined : Number(timeBudget);
+        if (timeBudgetMs !== undefined && (!Number.isFinite(timeBudgetMs) || timeBudgetMs <= 0)) {
+          throw new CliUserError(`잘못된 시간 상한: ${timeBudget}`, '--limit <ms> — 양의 밀리초 수치');
+        }
         const syncRun = landedDeps.run;
         const runAsync: MergedPrRunner = landedDeps.runAsync ?? (syncRun ? async (command, args, cwd) => syncRun(command, args, cwd) : defaultMergedPrRunner);
-        const { prs, truncated, calls } = await fetchMergedChecklistPrs(since, now, runAsync, process.cwd());
-        stage('merged-prs', { n: prs.length, calls, since, truncated });
+        const cacheFile = landedDeps.mergedPrCacheFile?.() ?? ((landedDeps.run || landedDeps.runAsync) ? undefined : join(releaseLedgerRoot(), 'release', 'landed-but-yellow-cache.json'));
+        const { prs, truncated, calls, stopReason, remainingWindows } = await fetchMergedChecklistPrs(since, now, runAsync, process.cwd(), {
+          ...(cacheFile ? { cacheFile } : {}),
+          timeBudgetMs,
+        });
+        stage('merged-prs', { n: prs.length, calls, since, truncated, ...(stopReason !== undefined ? { stopReason, remainingWindows: remainingWindows.length } : {}) });
         const results: Array<{ version: string; rows?: ReturnType<typeof landedButYellow>; plan?: ReturnType<typeof evidencePlan> }> = [];
         let totalAdded = 0, totalSkipped = 0;
         for (const snapshot of snapshots) {
@@ -869,9 +897,14 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
         if (opts.open) {
           if (opts.applyEvidence && !opts.dryRun) debug.log('release.checklist', 'evidence-synced', { versions: snapshots.map(({ version }) => version), added: totalAdded, skippedMention: totalSkipped });
           if (!json) console.log(`판 ${snapshots.length} · 붙임 합 ${totalAdded} · 건너뜀(언급만) 합 ${totalSkipped}`);
+          else if (stopReason !== undefined) await writeStdoutJson(`${JSON.stringify({ results, stopReason, remainingVersions: snapshots.map(({ version }) => version), remainingWindows })}\n`);
           else await writeStdoutJson(`${JSON.stringify(results)}\n`);
-        } else if (json) await writeStdoutJson(`${JSON.stringify(opts.applyEvidence || opts.dryRun ? results[0]!.plan : results[0]!.rows)}\n`);
+        } else if (json) {
+          const output = opts.applyEvidence || opts.dryRun ? results[0]!.plan : results[0]!.rows;
+          await writeStdoutJson(`${JSON.stringify(stopReason === undefined ? output : { results, stopReason, remainingVersions: snapshots.map(({ version }) => version), remainingWindows })}\n`);
+        }
         if (truncated) console.error('⚠ 병합 PR 400개 상한: 목록이 잘렸을 수 있다');
+        if (stopReason !== undefined) console.error(`⚠ 병합 PR 조회 시간 상한 도달: 부분 결과 ${prs.length} · 남은 판 ${snapshots.map(({ version }) => version).join(' · ')} · 미조회 UTC 창 ${remainingWindows.length}(${remainingWindows.slice(0, 3).join(' · ')}${remainingWindows.length > 3 ? ' …' : ''})`);
       } catch (error) {
         console.error(`⛔ ${error instanceof Error ? error.message : String(error)}`);
         process.exitCode = 1;
@@ -972,7 +1005,7 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
       const data = noteDispatchSkip(version, id, reason, opts.expectedTitle, opts.by);
       if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${id} 건너뜀 근거 확인`);
     });
-  const evidence = checklist.command('evidence').description('칸의 PR·커밋 근거');
+  const evidence = checklist.commands.find((command) => command.name() === 'evidence')!;
   withContext(evidence.command('add <id> <ref>').description('근거 참조 추가')).action((id: string, ref: string, _opts: unknown, cmd: Command) => {
       const { version, json } = context(cmd);
       if (!mayWrite(cmd)) return;

package/src/cli/self-update.ts

@@ -10,6 +10,15 @@ import { getUserConfig } from '../user-config.js';
 import { planEdgeRail, type EdgeRailInput, type EdgeRailPlan } from './self-update-canary.js';
 import { loadRunLedger } from '../self-implement/run-ledger.js';
 
+function selfUpdateOutputTail(output: string): string {
+  const lines = output.split(/\r?\n/).filter((line) => line.trim()).slice(-40);
+  return Array.from(lines.join('\n')).slice(-20_000).join('');
+}
+
+function selfUpdateReasonTail(tail: string): string {
+  return Array.from(tail).slice(-4_000).join('');
+}
+
 export interface SelfUpdateOptions {
   from?: string;
   restart?: boolean;
@@ -1241,25 +1250,34 @@ export async function runSelfUpdate(options: SelfUpdateOptions = {}, deps: SelfU
       try {
         const build = run('bun', ['bin/elanous.mjs', 'nexus', 'build'], checkout, { timeout: 15 * 60_000 });
         ok = build.status === 0;
-        tail = (build.stderr?.trim() || build.stdout?.trim() || '').split(/\r?\n/).filter((line) => line.trim()).at(-1)?.trim().slice(0, 500) ?? '';
+        const output = build.stderr?.trim() || build.stdout?.trim() || '';
+        tail = ok ? output.split(/\r?\n/).filter((line) => line.trim()).at(-1)?.trim().slice(0, 500) ?? '' : selfUpdateOutputTail(output);
       } catch (error) {
-        tail = String(error).split(/\r?\n/).at(-1)?.trim().slice(0, 500) ?? '';
+        tail = selfUpdateOutputTail(String(error));
       }
       const ms = Date.now() - started;
       try {
         debug.log('self-update', 'pwa-build', { ok, commit, ms });
         debug.log('self-update', 'pwa-build-tail', { commit, tail: tail || '출력 없음' });
+        if (!ok) debug.log('self-update', 'build-failed', { stage: 'pwa-build', commit, tail: tail || '출력 없음' });
       } catch { /* 관측 실패가 갱신을 막지 않는다 */ }
-      if (!ok) return emit({ exitCode: 1, installedVersion: null, decision, restarted: false, reason: `PWA 빌드 실패: ${tail || '출력 없음'}` });
+      if (!ok) return emit({ exitCode: 1, installedVersion: null, decision, restarted: false, reason: `PWA 빌드 실패: ${selfUpdateReasonTail(tail) || '출력 없음'}` });
       pwaBuild = { pwaBuiltCommit: commit, pwaBuiltAt: new Date().toISOString() };
     }
     let install: ReturnType<NonNullable<SelfUpdateDeps['run']>>;
+    let installTail = '';
     try {
       install = run('bash', [join(checkout, 'scripts/install.sh'), '--no-modify-path'], checkout);
+      if (install.status !== 0) installTail = selfUpdateOutputTail(install.stderr?.trim() || install.stdout?.trim() || '');
     } catch (error) {
-      return emit({ exitCode: 1, installedVersion: null, decision, restarted: false, reason: `설치 실패: ${String(error)}` });
+      installTail = selfUpdateOutputTail(String(error));
+      try { debug.log('self-update', 'build-failed', { stage: 'install', commit: head.stdout.trim().slice(0, 12), tail: installTail || '출력 없음' }); } catch { /* 관측 실패가 갱신을 막지 않는다 */ }
+      return emit({ exitCode: 1, installedVersion: null, decision, restarted: false, reason: `설치 실패: ${selfUpdateReasonTail(installTail) || '출력 없음'}` });
+    }
+    if (install.status !== 0) {
+      try { debug.log('self-update', 'build-failed', { stage: 'install', commit: head.stdout.trim().slice(0, 12), tail: installTail || '출력 없음' }); } catch { /* 관측 실패가 갱신을 막지 않는다 */ }
+      return emit({ exitCode: 1, installedVersion: null, decision, restarted: false, reason: `설치 실패: ${selfUpdateReasonTail(installTail) || '출력 없음'}` });
     }
-    if (install.status !== 0) return emit({ exitCode: 1, installedVersion: null, decision, restarted: false, reason: `설치 실패: ${install.stderr}` });
     let installedVersion: string;
     try {
       installedVersion = (deps.installedVersion ?? (() => basename(readlinkSync(join(homedir(), '.local/share/elanous/current')))))();

package/src/cli/self-utterances-cli.ts

@@ -1,12 +1,12 @@
 import type { Command } from 'commander';
 import { Database } from 'bun:sqlite';
 import { redactSecretText } from '../debug/log.js';
-import { openSurfaceEventsDb, querySurfaceUtterances, surfaceEventsDbPath, type SurfaceEventRow } from '../domains/surface-events.js';
+import { classifySurfaceUtteranceOrigin, countSurfaceUtterancesByOrigin, openSurfaceEventsDb, querySurfaceUtterances, surfaceEventsDbPath, type SurfaceEventRow } from '../domains/surface-events.js';
 import { injectUtterance, type UtteranceInput } from '../domains/self-awareness.js';
 import { writeStdoutJson } from './stdout-json.js';
 
 const PAGE_SIZE = 50;
-type UtteranceOrigin = 'human' | 'agent' | 'unknown';
+type UtteranceOrigin = 'human' | 'agent' | 'test-fixture' | 'unknown';
 
 function refsOf(raw: string | null): Record<string, unknown> {
   if (!raw) return {};
@@ -33,21 +33,15 @@ function isAutomatic(row: SurfaceEventRow): boolean {
   return false;
 }
 
+/** 도메인 원천 분류(사람/시험 fixture/외부 CLI agent/elanous 자기)를 CLI 표기로 접는다.
+ *  시험 fixture 는 사람과 같은 서피스에 기록되지만 사람 표본이 아니다 — 별도 값으로 노출한다. */
 function originOf(row: SurfaceEventRow): UtteranceOrigin {
-  if (row.direction !== 'inbound') return 'unknown';
-  const refs = refsOf(row.refs);
-  if (refs.utteranceOrigin === 'human' || refs.utteranceOrigin === 'agent') return refs.utteranceOrigin;
-  const explicit = refs.origin;
-  if (typeof explicit === 'string') {
-    if (/^(?:human|user|tui|pwa|telegram|discord|cli)$/i.test(explicit)) return 'human';
-    if (/^(?:claude-code|codex|gemini|agent|external:)/i.test(explicit)) return 'agent';
+  switch (classifySurfaceUtteranceOrigin(row)) {
+    case 'human': return 'human';
+    case 'test-fixture': return 'test-fixture';
+    case 'external-cli-agent': case 'elanous-self': return 'agent';
+    default: return 'unknown';
   }
-  // recordInboundTurn marks its recorder as elanous-self; on chat Q&A the speaker is the human.
-  if (row.kind === 'qna' && /^(?:telegram|discord)$/i.test(row.surface)) return 'human';
-  if (explicit === 'elanous-self') return 'agent';
-  if (/^ext:/i.test(row.surface)) return 'agent';
-  if (/^(?:cli|tui|pwa|telegram|discord|ipad|watch)$/i.test(row.surface)) return 'human';
-  return 'unknown';
 }
 
 function utteranceText(row: SurfaceEventRow): { text: string; extract: 'direct' | 'qna' | 'ambiguous' | 'summary'; truncated: boolean; truncationEvidence: 'cap-reached' | 'over-cap' | null; possibleLoss: boolean } {
@@ -101,7 +95,9 @@ export function collectSelfUtterances(opts: SelfUtterancesOptions, db: ReturnTyp
   });
   const total = utterances.length;
   const start = (page - 1) * PAGE_SIZE;
-  return { source: 'surface_events.events (read-only)', filters: { from, to, surface: opts.surface ?? null, origin: opts.origin ?? null, automatic: 'excluded' }, counts: { matched: total, excludedAutomatic, excludedByOrigin, excludedUnextractable, ambiguous, truncated, capReached, possibleLoss }, page: { number: page, size: PAGE_SIZE, total, hasNext: start + PAGE_SIZE < total }, utterances: utterances.slice(start, start + PAGE_SIZE) };
+  // ⭐ 원천별 수를 «명시»한다 — 사람 원천 0 을 사람 표본으로 오인하지 않게(시험 fixture·외부 CLI agent 분리).
+  const originCounts = countSurfaceUtterancesByOrigin(db, { from, to, ...(opts.surface ? { surface: opts.surface } : {}) });
+  return { source: 'surface_events.events (read-only)', filters: { from, to, surface: opts.surface ?? null, origin: opts.origin ?? null, automatic: 'excluded' }, originCounts, humanSample: originCounts.human === 0 ? 'absent' : 'present', counts: { matched: total, excludedAutomatic, excludedByOrigin, excludedUnextractable, ambiguous, truncated, capReached, possibleLoss }, page: { number: page, size: PAGE_SIZE, total, hasNext: start + PAGE_SIZE < total }, utterances: utterances.slice(start, start + PAGE_SIZE) };
 }
 
 export function recordSelfUtterance(input: UtteranceInput & { utteranceOrigin?: 'human' | 'agent' }, db?: Database): { eventId: string } {
@@ -131,6 +127,7 @@ export function registerSelfUtterancesCommand(selfCmd: Command): void {
         if (opts.json) { await writeStdoutJson(JSON.stringify(result, null, 2) + '\n'); return; }
         console.log(`source=${result.source} matched=${result.counts.matched} excludedAutomatic=${result.counts.excludedAutomatic} excludedByOrigin=${result.counts.excludedByOrigin} excludedUnextractable=${result.counts.excludedUnextractable} page=${result.page.number} size=${result.page.size} hasNext=${result.page.hasNext}`);
         console.log(`filters=${JSON.stringify(result.filters)}`);
+        console.log(`origin-counts human=${result.originCounts.human} test-fixture=${result.originCounts.testFixture} external-cli-agent=${result.originCounts.externalCliAgent} elanous-self=${result.originCounts.elanousSelf} unknown=${result.originCounts.unknown} human-sample=${result.humanSample}`);
         for (const item of result.utterances) console.log(JSON.stringify(item));
         console.log(`ambiguous=${result.counts.ambiguous} truncated=${result.counts.truncated} cap-reached=${result.counts.capReached} possibleLoss=${result.counts.possibleLoss}`);
       } finally { db.close(); }