elanous 0.2.13 → 0.2.15

package/src/harness/harness-cli-command.ts

@@ -2,14 +2,16 @@ import { execFileSync } from 'node:child_process';
 import { dlopen, FFIType } from 'bun:ffi';
 import { createHash } from 'node:crypto';
 import { existsSync, readFileSync } from 'node:fs';
-import { constants as osConstants } from 'node:os';
-import { resolve, sep } from 'node:path';
+import { constants as osConstants, hostname } from 'node:os';
+import { basename, dirname, resolve, sep } from 'node:path';
 import { findGitDir } from '../git-fs/locate.js';
 import { LogStore, logsDbPath } from '../mss/logging/log-store.js';
 import { loadSelfDevRun } from '../self-dev/run-store.js';
 import { normalizeRunId } from './harness-space.js';
-import { effectiveInstanceRoot } from '../instance/resolve.js';
-import { detectBursts, formatIncidentBurstWarning, readRunExits, recentBurst, recordRunExit } from './harness-incidents.js';
+import { effectiveInstanceRoot, prodInstanceRoot } from '../instance/resolve.js';
+import { lookupGoal, type GoalLookupOptions, type GoalLookupResult } from '../self-implement/goal-lookup.js';
+import { archiveGoals, type GoalArchiveOptions } from '../self-implement/goal-archive.js';
+import { detectBursts, formatIncidentBurstWarning, incidentLastLines, readRunExits, recentBurst, recordRunExit } from './harness-incidents.js';
 import { Command, Option } from 'commander';
 import { runGitCommand } from '../git-fs/runner.js';
 import { GOAL_TYPES, lintGoalFile, parseGoalId, parseGoalType, tracedPathReferences, type GoalType } from '../self-implement/goal-author.js';
@@ -19,7 +21,7 @@ import { resolveChildLlmEffort, resolveImplementationChildModel } from '../self-
 import { resolveHarnessTarget } from '../self-implement/harness-target-options.js';
 import { queryRunningRuns } from '../self-implement/running-runs.js';
 import { DevPipelineError } from '../self-dev/dev-pipeline.js';
-import { runDraftSweep, type DraftSweepAdapters, type DraftSweepResult, type SweepDraft, type SweepMergedPr } from '../self-dev/draft-sweep.js';
+import { runDraftSweep, sweepFailureReason, type DraftSweepAdapters, type DraftSweepResult, type SweepDraft, type SweepMergedPr, type SweepReviewGate } from '../self-dev/draft-sweep.js';
 import { debug } from '../debug/log.js';
 import { dispatchTask, type DispatchTaskInput, type DispatchTaskDeps } from '../execution-loop/dispatch-task.js';
 import { launchRequestId, preLaunchGate, type PreLaunchGateDeps } from '../execution-loop/launch-gate.js';
@@ -28,8 +30,10 @@ import { CODEX_PROVIDER, GROK_PROVIDER, decideBudget, decideLaunchBudget, readBu
 import { DEFAULT_FALLBACK_CHAIN } from '../oauth/fallback-chain.js';
 import { installDeliverableVerifyCliCommand, type InstallDeliverableVerifyCliDeps } from './deliverable-verify-cli.js';
 import { getUserConfig } from '../user-config.js';
+import { resolveRepositoryName } from './repository-name.js';
 import { installHarnessCliSinkHook } from './harness-cli-sink.js';
-import { addHarnessQueue, listHarnessQueue, reconcileHarnessQueue, removeHarnessQueue, tickHarnessQueue, type HarnessQueueDeps } from './harness-queue.js';
+import { addHarnessQueue, listHarnessQueue, queueSeatForCwd, reconcileHarnessQueue, removeHarnessQueue, tickHarnessQueue, type HarnessQueueDeps, type QueueSeat } from './harness-queue.js';
+import { parseDoorSince, queryLaunchDoors, renderLaunchDoors, type DoorTable } from './launch-stamp.js';
 import { resolveHarnessSubstrate, type ResolvedHarnessSubstrate } from './harness-substrate-default.js';
 import { runHarnessPlanRfc } from './harness-plan-rfc.js';
 import { classifyGarbage, isGarbageProcessTarget, type GarbageProcess } from './process-garbage.js';
@@ -92,6 +96,7 @@ export class HarnessCliInputError extends Error {
 }
 
 export interface HarnessAskSayOptions {
+  seat?: QueueSeat;
   json?: boolean;
   base?: string;
   target?: string;
@@ -253,6 +258,7 @@ function registerHarnessAskSayOptions(command: Command): Command {
     .option('--target <path>', 'self: harness가 작업할 레포 또는 디렉터리(self-mission 전용)')
     .option('--yes', 'git 아닌 프로젝트에 git init 및 첫 커밋을 만들도록 동의')
     .option('--correlation <id>', '요청과 런을 잇는 불투명 correlation 값')
+    .addOption(new Option('--seat <seat>', '런 귀속 자리 (OP|TC|MK|UX)').choices(['OP', 'TC', 'MK', 'UX']))
     .addOption(new Option('--goal-type <type>', `골 종류 (${GOAL_TYPES.join('|')})`).choices([...GOAL_TYPES]))
     .option('--force-preflight', '전제 검사 막힘을 명시 요청으로 우회(관측에 남음)')
     .option('--force-gate', '같은 골 실행 중 막힘을 명시 요청으로 우회(관측에 남음; 예산 막힘은 우회 불가)')
@@ -284,6 +290,7 @@ function registerHarnessMissionOptions(command: Command): Command {
 function normalizeHarnessCommonOptions(opts: HarnessAskSayOptions): HarnessAskSayOptions {
   return {
     ...(opts.json ? { json: true } : {}),
+    ...(opts.seat !== undefined ? { seat: opts.seat } : {}),
     ...(opts.base !== undefined ? { base: opts.base } : {}),
     ...(opts.target !== undefined ? { target: opts.target } : {}),
     ...(opts.yes === true ? { yes: true } : {}),
@@ -328,7 +335,7 @@ function assertHarnessChildLlmModel(opts: HarnessAskSayChildLlmOptions): void {
 }
 
 /** Shared post-parse gate: validate child model before any ask/say early return (including `--dry-run`). */
-type HarnessSubstrateOpts = { substrate?: 'local' | 'pod'; podPool?: string; podMemory?: string; after?: string; autoMerge?: boolean; base?: string; json?: boolean; target?: string; source?: string };
+type HarnessSubstrateOpts = { substrate?: 'local' | 'pod'; podPool?: string; podMemory?: 'lite' | 'standard' | 'high'; after?: string; autoMerge?: boolean; base?: string; json?: boolean; target?: string; source?: string; seat?: QueueSeat };
 function resolveLaunchSubstrate(opts: HarnessSubstrateOpts): ResolvedHarnessSubstrate {
   const resolved = resolveHarnessSubstrate({ flag: opts, config: getUserConfig(), env: process.env });
   debug.log('harness.substrate', 'resolved', resolved);
@@ -338,7 +345,17 @@ function resolveLaunchSubstrate(opts: HarnessSubstrateOpts): ResolvedHarnessSubs
   return resolved;
 }
 type PodExit = { status: number | null; signal?: string | null };
-type PodExitReason = 'signal' | 'human-stop' | 'supervisor' | 'no-launch' | 'unknown';
+type PodExitReason = 'signal' | 'human-stop' | 'supervisor' | 'no-launch' | 'unknown'
+  | 'pod-error' | 'launch-gate-blocked' | 'ENOBUFS' | 'OOMKilled';
+
+function unknownPodExitTailReason(output: string): PodExitReason | undefined {
+  const tail = output.slice(-16_000);
+  if (/\bOOMKilled\b/i.test(tail)) return 'OOMKilled';
+  if (/\bENOBUFS\b/i.test(tail)) return 'ENOBUFS';
+  if (/launch gate[^\r\n]*blocked|blocked[^\r\n]*launch gate/i.test(tail)) return 'launch-gate-blocked';
+  if (/\bpod-error\b/i.test(tail)) return 'pod-error';
+  return undefined;
+}
 /** GitHub lists at most this many files for one pull request; a list that reaches it is not provably complete. */
 export const GITHUB_PR_FILES_LIST_CAP = 3000;
 const STOPPING_SUPERVISOR_VERDICTS = new Set(['UNCONVERGEABLE', 'CONTRACT-CONFLICT']);
@@ -441,34 +458,47 @@ export function classifyHarnessPodExit(
     try { applied = (deps.hasJobApplied ?? hasHarnessPodJobApplied)(runId, output); } catch { /* unknown */ }
     const noLaunch = ledgerReadable && !ledger?.some((entry) => LAUNCH_EVIDENCE_EVENTS.has(entry.event))
       && applied === false && !pr;
-    reason = noLaunch ? 'no-launch' : 'unknown';
+    reason = noLaunch ? 'no-launch' : unknownPodExitTailReason(output) ?? 'unknown';
     line = noLaunch
       ? 'Pod 실행에 닿지 못했다 — 풀·컨텍스트·SSH 연결을 확인하거나 `--substrate local` 로 명시하라'
-      : 'Pod 실행 여부 또는 종료 이유를 확인하지 못했다';
+      : reason === 'unknown' ? 'Pod 실행 여부 또는 종료 이유를 확인하지 못했다'
+        : `Pod 종료 출력에서 확인한 원인: ${reason}`;
   }
   try { debug.log('harness.pod', 'exit-classified', { runId, reason, status: exit.status, signal: signal ?? null }); } catch { /* observation is fail-soft */ }
   return { reason, lines: [line, ...(pr ? [`PR 이 남아 있다: ${pr}`] : [])] };
 }
 
 /** The classified status is the same exit handed to the launcher; ledger failure is never an exit failure. */
-export function recordClassifiedHarnessPodExit(runId: string | undefined, reason: string, status: number): void {
+export function recordClassifiedHarnessPodExit(runId: string | undefined, reason: string, status: number,
+  context: { entrance?: string; seat?: string; output?: string } = {}): void {
   if (!runId) return;
   try {
     const signal = status > 128
       ? Object.entries(osConstants.signals).find(([, number]) => number === status - 128)?.[0] ?? null : null;
-    recordRunExit({ runId, reason, status, signal, at: new Date().toISOString() }, effectiveInstanceRoot());
+    const cwd = process.cwd();
+    const seat = context.seat ?? process.env.ELANOUS_HARNESS_SEAT;
+    recordRunExit({ runId, reason, status, signal, at: new Date().toISOString(),
+      ...(context.entrance ? { entrance: context.entrance } : {}),
+      ...(['OP', 'TC', 'MK', 'UX'].includes(seat ?? '') ? { seat } : {}),
+      cwd: `${basename(dirname(cwd))}/${basename(cwd)}`, hostname: hostname().split('.')[0]!, pid: process.pid,
+      ...(context.output ? { lastLines: incidentLastLines(context.output) } : {}),
+    }, effectiveInstanceRoot());
   } catch { /* incident writes cannot change Pod output or exit */ }
 }
 
 /** Every Pod launch entrance (harness ask/say · dev ask --substrate pod) warns once after a recent burst; it never blocks the launch. */
 export function warnRecentIncidentBurst(
   root: string = effectiveInstanceRoot(), now: Date = new Date(), write: (line: string) => void = (line) => console.error(line),
+  context: { seat?: string; entrance?: string } = {},
 ): boolean {
   try {
-    const burst = recentBurst(root, now);
+    const seat = context.seat ?? process.env.ELANOUS_HARNESS_SEAT;
+    const burst = recentBurst(root, now, { entrance: context.entrance,
+      ...(['OP', 'TC', 'MK', 'UX'].includes(seat ?? '') ? { seat } : {}) });
     if (!burst) return false;
     write(formatIncidentBurstWarning(burst));
-    try { debug.log('harness.incident', 'burst', { reason: burst.reason, count: burst.count }); } catch { /* observation is fail-soft */ }
+    try { debug.log('harness.incident', 'burst', { reason: burst.reason, count: burst.count,
+      ...(burst.seat ? { seat: burst.seat } : {}), ...(burst.entrance ? { entrance: burst.entrance } : {}) }); } catch { /* observation is fail-soft */ }
     return true;
   } catch { return false; /* incident reads cannot block a launch */ }
 }
@@ -524,9 +554,23 @@ function hasHarnessPodJobApplied(runId: string | undefined, output: string): boo
   } finally { store.close(); }
 }
 
+/** 10-05 PODPROVIDER — say which child provider a local run will use (an unnamed choice follows config). */
+function announceLocalChildProvider(opts: unknown): void {
+  const child = opts as HarnessAskSayChildLlmOptions;
+  if (!child.childLlmProvider?.trim()) return;
+  console.error(`child provider 요청 = ${child.childLlmProvider.trim()}${child.childLlmModel?.trim() ? `/${child.childLlmModel.trim()}` : ''} (local)`);
+}
+
+/** `harness.authorOnPod` — 명시 true 만 켠다. 읽기 실패는 끔(호스트 저작)으로 둔다. */
+function harnessAuthorOnPod(): boolean {
+  try { return getUserConfig().harness?.authorOnPod === true; }
+  catch { return false; }
+}
+
 /** ⭐ 런 계약의 실행 칸 = pod — 호스트는 그래프를 안 돌리고 Pod 로 보낸다(harness-pod-dispatch.ts). */
 async function onPod(opts: unknown, entrance: 'cli-harness-ask' | 'cli-harness-say', input: string, pool: string,
-  recordDispatch: (input: DispatchTaskInput, deps?: DispatchTaskDeps) => ReturnType<typeof dispatchTask> = dispatchTask): Promise<void> {
+  recordDispatch: (input: DispatchTaskInput, deps?: DispatchTaskDeps) => ReturnType<typeof dispatchTask> = dispatchTask,
+  authorOnPod = false): Promise<void> {
   const o = opts as HarnessSubstrateOpts;
   if (o.target !== undefined) {
     debug.log('harness.pod', 'target-refused', { target: o.target });
@@ -540,7 +584,8 @@ async function onPod(opts: unknown, entrance: 'cli-harness-ask' | 'cli-harness-s
     process.exitCode = 2;
     return;
   }
-  warnRecentIncidentBurst();
+  warnRecentIncidentBurst(effectiveInstanceRoot(), new Date(), (line) => console.error(line),
+    { entrance, seat: o.seat });
   let dispatchRecorded = false;
   try {
     const goalText = entrance === 'cli-harness-ask' ? readFileSync(input, 'utf8') : input;
@@ -559,14 +604,21 @@ async function onPod(opts: unknown, entrance: 'cli-harness-ask' | 'cli-harness-s
   const { dispatchHarnessOnPod } = await import('./harness-pod-dispatch.js');
   let output = '';
   let runId: string | undefined;
-  const status = await dispatchHarnessOnPod({ entrance, input, podPool: pool, ...(dispatchRecorded ? { dispatchRecorded: true } : {}), ...(o.podMemory ? { podMemory: o.podMemory } : {}), ...(o.after ? { after: o.after } : {}), ...(o.autoMerge === false ? { autoMerge: false } : {}), ...(o.base ? { base: o.base } : {}), ...(o.json ? { json: true } : {}), ...(o.source ? { source: o.source } : {}) },
+  const child = opts as HarnessAskSayChildLlmOptions;
+  // 10-05 PODPROVIDER: say which child provider the Pod will use when the launch named one.
+  if (child.childLlmProvider?.trim()) console.error(`child provider 요청 = ${child.childLlmProvider.trim()}${child.childLlmModel?.trim() ? `/${child.childLlmModel.trim()}` : ''} (pod · 자격 없으면 발사 전 거부)`);
+  const status = await dispatchHarnessOnPod({ entrance, input, podPool: pool, ...(authorOnPod && entrance === 'cli-harness-say' ? { authorOnPod: true } : {}),
+    ...(child.childLlmProvider?.trim() ? { childLlmProvider: child.childLlmProvider.trim() } : {}),
+    ...(child.childLlmModel?.trim() ? { childLlmModel: child.childLlmModel.trim() } : {}),
+    ...(child.childLlmEffort?.trim() ? { childLlmEffort: child.childLlmEffort.trim() } : {}), ...(dispatchRecorded ? { dispatchRecorded: true } : {}), ...(o.podMemory ? { podMemory: o.podMemory } : {}), ...((opts as HarnessAskSayChildLlmOptions).goalType ? { goalType: (opts as HarnessAskSayChildLlmOptions).goalType } : {}), ...(o.after ? { after: o.after } : {}), ...(o.autoMerge === false ? { autoMerge: false } : {}), ...(o.base ? { base: o.base } : {}), ...(o.json ? { json: true } : {}), ...(o.source ? { source: o.source } : {}), ...(o.seat ? { seat: o.seat } : {}) },
     { onOutput: (text) => {
       runId ??= harnessPodRunId(output + text);
       output = (output + text).slice(-16_000);
     } });
   if (status !== 0) {
     const classified = classifyHarnessPodExit({ status }, output, { ...(runId ? { runId } : {}) });
-    recordClassifiedHarnessPodExit(runId ?? harnessPodRunId(output), classified.reason, status);
+    recordClassifiedHarnessPodExit(runId ?? harnessPodRunId(output), classified.reason, status,
+      { entrance, seat: o.seat, output });
     for (const line of classified.lines) console.error(line);
     process.exitCode = status;
   }
@@ -634,7 +686,7 @@ async function dispatchHarnessAskSay(
     readonly wouldStart: string;
     readonly goalPath?: string;
   },
-  dispatch: (resolved: ResolvedHarnessSubstrate) => Promise<void>,
+  dispatch: (resolved: ResolvedHarnessSubstrate, stampedOpts: HarnessAskSayChildLlmOptions & HarnessDryRunOpts) => Promise<void>,
   gate: PreLaunchGateDeps & { readBudget?: () => Promise<BudgetDecision | 'unknown'> } = {},
 ): Promise<void> {
   await runInjectedHarnessHandler(async () => {
@@ -644,6 +696,25 @@ async function dispatchHarnessAskSay(
       printHarnessLaunchDryRun(dryRunPreview);
       return;
     }
+    // Resolve the launch directory once; descendants and the checkpoint retain the same identity.
+    const queued = process.env.ELANOUS_HARNESS_QUEUE_LAUNCH && process.env.ELANOUS_HARNESS_SEAT;
+    const queueSeat = queued === 'OP' || queued === 'TC' || queued === 'MK' || queued === 'UX' ? queued : undefined;
+    const assigned = opts.seat ?? queueSeat ?? queueSeatForCwd(process.cwd(), getUserConfig().loops?.orchestrator?.seatTrees);
+    const inheritedSeat = process.env.ELANOUS_HARNESS_SEAT;
+    const podSeat = resolved.substrate === 'pod' && ['OP', 'TC', 'MK', 'UX'].includes(inheritedSeat ?? '')
+      ? inheritedSeat as QueueSeat : undefined;
+    const stampedSeat = resolved.substrate === 'pod' ? opts.seat ?? queueSeat ?? podSeat ?? assigned : assigned;
+    const stampedOpts = stampedSeat ? { ...opts, seat: stampedSeat } : opts;
+    const launch = async () => {
+      const previous = process.env.ELANOUS_HARNESS_SEAT;
+      if (stampedSeat) process.env.ELANOUS_HARNESS_SEAT = stampedSeat;
+      else delete process.env.ELANOUS_HARNESS_SEAT;
+      try { await dispatch(resolved, stampedOpts); }
+      finally {
+        if (previous === undefined) delete process.env.ELANOUS_HARNESS_SEAT;
+        else process.env.ELANOUS_HARNESS_SEAT = previous;
+      }
+    };
     // Without a GoalId, match the request to a live run's exact verbatim original ask; still check budget.
     let identity = dryRunPreview.input;
     let goalId: string | null = null;
@@ -658,7 +729,7 @@ async function dispatchHarnessAskSay(
     // CLI wiring tests time out on them. Gate tests inject deps or opt in with ELANOUS_LAUNCH_GATE_LIVE=1.
     if (process.env.NODE_ENV === 'test' && Object.keys(gate).length === 0 && process.env.ELANOUS_LAUNCH_GATE_LIVE !== '1') {
       try { debug.log('execution-loop.launch-gate', 'skipped-test-env', { goalId }); } catch { /* observation is fail-soft */ }
-      await dispatch(resolved);
+      await launch();
       return;
     }
     const budget = await (gate.readBudget ?? (() => readHarnessLaunchBudget(opts)))();
@@ -673,7 +744,7 @@ async function dispatchHarnessAskSay(
       ...(decision.budget === 'unknown' ? ['budget unknown'] : decision.budget.action === 'next-provider' ? [decision.budget.reasons.join(' · ') || 'next-provider'] : []),
     ];
     if (warnings.length > 0) console.error(`⚠️ launch gate: ${warnings.join(' · ').split(/\r?\n/, 1)[0]}`);
-    await dispatch(resolved);
+    await launch();
   });
 }
 
@@ -1582,6 +1653,12 @@ export async function runHarnessBudget(opts: { json?: boolean } = {}, io: {
 
 const DRAFT_SWEEP_REPOSITORY = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
 
+/** A review body still names a must-fix. «must-fix 0» and «must-fix: 0» are a cleared list, not a remaining one. */
+function mustFixRemains(text: string): boolean {
+  if (!/(?:^|\n)\s*(?:[-*]\s*)?(?:must-fix|must fix)\b/i.test(text)) return false;
+  return !/(?:^|\n)\s*(?:[-*]\s*)?(?:must-fix|must fix)\s*[:=]?\s*0\b/i.test(text);
+}
+
 type GithubPull = {
   number: number;
   title: string;
@@ -1606,6 +1683,30 @@ const executeGh: GhExecute = (args) => execFileSync('gh', args, {
   stdio: ['ignore', 'pipe', 'pipe'], env: process.env,
 });
 
+/** Merge-time adapter: reuse the sweep's GitHub inventory and worktree liveness without a second triage implementation. */
+export async function supersedeMergedGoalDrafts(
+  number: number, cwd: string,
+  execute: GhExecute = executeGh, git: DraftSweepGitExecute = runGitCommand,
+): Promise<void> {
+  const remote = git(cwd, ['config', '--get', 'remote.origin.url']);
+  const repository = remote.status === 0 ? githubRemoteRepository(remote.stdout) : undefined;
+  if (!repository) throw new Error('Merge repository unavailable');
+  // The PR can change between open and merge; never authorize a close using locally reconstructed metadata.
+  const pr = ghJson<GithubPull>(['api', `repos/${repository}/pulls/${number}`], execute);
+  if (!pr || pr.number !== number || pr.state !== 'closed' || !pr.merged_at || !pr.title?.trim()
+    || !pr.head?.ref?.trim() || !pr.created_at || !Array.isArray(pr.labels)
+    || !Number.isFinite(Date.parse(pr.created_at)) || !Number.isFinite(Date.parse(pr.merged_at))
+    || Date.parse(pr.merged_at) < Date.parse(pr.created_at)) {
+    throw new Error('Merged PR metadata unavailable');
+  }
+  const merged: SweepMergedPr & { createdAt: string; mergedAt: string } = {
+    number: pr.number, title: pr.title, body: pr.body ?? undefined, branch: pr.head.ref,
+    createdAt: pr.created_at, mergedAt: pr.merged_at,
+  };
+  const { supersedeDraftsOnMerge } = await import('../self-dev/draft-sweep.js');
+  await supersedeDraftsOnMerge({ repository, merged, adapters: githubDraftSweepAdapters(execute, git, cwd) });
+}
+
 function ghJson<T>(args: string[], execute: GhExecute): T {
   return JSON.parse(execute(args)) as T;
 }
@@ -1670,7 +1771,7 @@ function githubRemoteRepository(url: string): string | undefined {
   return match?.[1];
 }
 
-export function githubDraftSweepAdapters(execute: GhExecute = executeGh, git: DraftSweepGitExecute = runGitCommand): DraftSweepAdapters {
+export function githubDraftSweepAdapters(execute: GhExecute = executeGh, git: DraftSweepGitExecute = runGitCommand, cwd = process.cwd()): DraftSweepAdapters {
   const inventory = async (repository: string, state: 'open' | 'closed'): Promise<GithubPull[]> => {
     // ⛔ A large repository has tens of thousands of closed PRs (2026-09-28: 21k → «exceeded pagination limit», no sweep at all).
     //    Merged twins only matter after the oldest open draft was opened, so the closed listing stops at that time.
@@ -1741,6 +1842,36 @@ export function githubDraftSweepAdapters(execute: GhExecute = executeGh, git: Dr
     }
     return undefined;
   };
+  const reviewGateForDraft = (draft: SweepDraft, repository: string): SweepReviewGate | undefined => {
+    const head = ghJson<{ head?: { sha?: string } }>(['api', `repos/${repository}/pulls/${draft.number}`], execute);
+    const sha = head?.head?.sha;
+    if (!sha) return undefined;
+    const comments: string[] = [];
+    for (let page = 1; page <= 100; page++) {
+      const batch = ghJson<Array<{ body?: string }>>(['api', `repos/${repository}/issues/${draft.number}/comments?per_page=100&page=${page}`], execute);
+      if (!Array.isArray(batch) || batch.length > 100) throw new Error('Incomplete review comment inventory');
+      comments.push(...batch.map((comment) => comment.body ?? ''));
+      if (batch.length < 100) break;
+      if (page === 100) throw new Error('Review comment inventory exceeded pagination limit');
+    }
+    const reviews = ghJson<Array<{ state?: string; body?: string }>>(['api', `repos/${repository}/pulls/${draft.number}/reviews?per_page=100`], execute);
+    if (!Array.isArray(reviews) || reviews.length > 100) throw new Error('Incomplete review inventory');
+    const text = [...comments, ...reviews.map((review) => review.body ?? '')].join('\n');
+    const status = ghJson<{ state?: string }>(['api', `repos/${repository}/commits/${sha}/status`], execute);
+    const checkRuns = ghJson<{ check_runs?: Array<{ conclusion?: string | null }> }>(
+      ['api', `repos/${repository}/commits/${sha}/check-runs?per_page=100`], execute);
+    if (!checkRuns || !Array.isArray(checkRuns.check_runs)) throw new Error('Incomplete check-run inventory');
+    const conclusions = checkRuns.check_runs.map((run) => run.conclusion ?? null);
+    const gatePass = (status?.state === 'success' || status?.state === undefined)
+      && conclusions.length > 0 && conclusions.every((conclusion) => conclusion === 'success' || conclusion === 'skipped' || conclusion === 'neutral');
+    const gateFail = status?.state === 'failure' || status?.state === 'error'
+      || conclusions.some((conclusion) => conclusion === 'failure' || conclusion === 'cancelled' || conclusion === 'timed_out' || conclusion === 'action_required');
+    return {
+      ...(reviews.some((review) => review.state === 'APPROVED') || /(?:^|\n)\s*VERDICT:\s*PASS\b/i.test(text) ? { review: 'pass' as const } : {}),
+      ...(mustFixRemains(text) ? { mustFix: true } : {}),
+      ...(gatePass && !gateFail ? { gate: 'pass' as const } : gateFail ? { gate: 'fail' as const } : {}),
+    };
+  };
   const landingCommentsFor = (repository: string, number: number): string[] => {
     const comments: string[] = [];
     for (let page = 1; page <= 100; page++) {
@@ -1763,6 +1894,7 @@ export function githubDraftSweepAdapters(execute: GhExecute = executeGh, git: Dr
     return draftSweepRunStatus(ledgerMatches, running, repository, draft.number);
   };
   return {
+    getPrFiles: async (repository, number) => filesFor(repository, number),
     listDrafts: async (page, perPage, repository): Promise<SweepDraft[]> =>
       (await listed(open, repository, 'open')).filter((pr) => pr.draft)
         .slice((page - 1) * perPage, page * perPage)
@@ -1811,7 +1943,6 @@ export function githubDraftSweepAdapters(execute: GhExecute = executeGh, git: Dr
       } finally { store.close(); }
     },
     listLiveBranches: async (repository) => {
-      const cwd = process.cwd();
       const remote = git(cwd, ['config', '--get', 'remote.origin.url']);
       if (remote.status !== 0 || githubRemoteRepository(remote.stdout)?.toLowerCase() !== repository.toLowerCase()) {
         return undefined;
@@ -1829,6 +1960,7 @@ export function githubDraftSweepAdapters(execute: GhExecute = executeGh, git: Dr
       execute(['pr', 'close', String(number), '--repo', repository, '--comment', comment]);
     },
     getClaimOwner: async (repository, number) => claimCommentOwner(repository, number, execute),
+    getReviewGate: async (draft, repository) => reviewGateForDraft(draft, repository),
   };
 }
 
@@ -1863,7 +1995,10 @@ function installHarnessDraftSweepCommand(harnessCmd: Command, deps: HarnessDraft
     .action(async (number: string, opts: { owner?: string; note?: string; release?: boolean; repo?: string }) => {
       try {
         const execute = deps.execute ?? executeGh;
-        const repository = opts.repo ?? deps.repository?.() ?? execute(['repo', 'view', '--json', 'nameWithOwner', '--jq', '.nameWithOwner']).trim();
+        const repository = resolveRepositoryName({
+          repo: opts.repo ?? deps.repository?.(),
+          executeGh: (args) => execute(args),
+        });
         if (!DRAFT_SWEEP_REPOSITORY.test(repository) || repository.includes('..')) throw new HarnessCliInputError(`invalid --repo (expected owner/name): ${repository}`);
         if (!/^[1-9]\d*$/.test(number) || !Number.isSafeInteger(Number(number))) throw new HarnessCliInputError(`invalid PR number: ${number}`);
         const owner = opts.owner?.trim();
@@ -1900,26 +2035,86 @@ function installHarnessDraftSweepCommand(harnessCmd: Command, deps: HarnessDraft
     .action(async (opts: { apply?: boolean; json?: boolean; repo?: string }) => {
       try {
         const write = deps.write ?? console.log;
-        const repository = opts.repo ?? deps.repository?.() ?? execFileSync('gh', ['repo', 'view', '--json', 'nameWithOwner', '--jq', '.nameWithOwner'],
-          { encoding: 'utf8', timeout: 30_000, stdio: ['ignore', 'pipe', 'pipe'], env: process.env }).trim();
+        const execute = deps.execute ?? executeGh;
+        const repository = resolveRepositoryName({
+          repo: opts.repo ?? deps.repository?.(),
+          executeGh: (args) => execute(args),
+        });
         if (!DRAFT_SWEEP_REPOSITORY.test(repository) || repository.includes('..')) {
           throw new HarnessCliInputError(`invalid --repo (expected owner/name): ${repository}`);
         }
         const result: DraftSweepResult = await runDraftSweep({ repository, apply: opts.apply === true, adapters: deps.adapters ?? githubDraftSweepAdapters(deps.execute) });
-        if (opts.json) write(JSON.stringify(result));
+        const reason = result.error ? sweepFailureReason(result.error) : undefined;
+        if (opts.json) write(JSON.stringify(reason ? { ...result, error: reason } : result));
         else {
-          write(`draft sweep ${result.repository}: ${result.complete ? 'complete' : `incomplete (${result.error})`} · ${result.apply ? 'apply' : 'dry-run'}`);
-          for (const entry of result.entries) write(`#${entry.number} ${entry.action}: ${entry.reason}${entry.statusLabel ? ` → ${entry.statusLabel}` : ''}${entry.error ? ` ERROR: ${entry.error}` : ''}`);
-          if (result.complete) write(`못 본 초안 ${result.unobserved ?? 0} · 이번에 닫음 ${result.closed ?? 0}${result.apply ? '' : '(dry-run)'} · 처리 중 ${result.claimed ?? 0} · 표식 만료 ${result.claimExpired ?? 0}`);
+          write(`draft sweep ${result.repository}: ${result.complete ? 'complete' : `incomplete (${reason})`} · ${result.apply ? 'apply' : 'dry-run'}`);
+          for (const entry of result.entries) write(`#${entry.number} ${entry.action}: ${entry.reason}${entry.statusLabel ? ` → ${entry.statusLabel}` : ''}${entry.error ? ` ERROR: ${sweepFailureReason(entry.error)}` : ''}`);
+          if (result.complete) {
+            const daily = result.daily
+              ? ` · 24h 넘음 ${result.daily.over24h} · 정리 대상 ${result.daily.closable} · 수확 대기 ${result.daily.harvestable} · 막힘 ${result.daily.blocked}`
+              : '';
+            write(`못 본 초안 ${result.unobserved ?? 0} · 이번에 닫음 ${result.closed ?? 0}${result.apply ? '' : '(dry-run)'} · 처리 중 ${result.claimed ?? 0} · 표식 만료 ${result.claimExpired ?? 0}${daily}`);
+          }
+          if (reason) write(reason);
         }
         if (!result.complete || result.entries.some((entry) => entry.error)) process.exitCode = 1;
       } catch (error) {
         console.error(humanErrorLine(error));
+        try { debug.log('drafts.cleanup', 'failed', { reason: sweepFailureReason(error) }); } catch { /* observation is fail-soft */ }
         process.exitCode = 1;
       }
     });
 }
 
+function renderHarnessGoal(result: GoalLookupResult, universe: '운영' | '시험'): string {
+  const matchedRun = result.runState?.results.find((entry) => entry.runId === result.runId);
+  return [
+    `골: ${result.goalBody?.split(/\r?\n/, 1)[0] || '골 문서에 없음'}`,
+    `runId: ${result.runId ?? '원장에 없음'}`,
+    `칸 id: ${result.kanId ?? '기록 없음'}`,
+    `PR: ${result.record?.prNumber != null ? `#${result.record.prNumber}` : '기록 없음'}`,
+    `stage/결과: ${result.record?.stage ?? '기록 없음'} / ${result.record?.outcome ?? '기록 없음'}`,
+    `종결 사유: ${result.runState?.supervisorStopReason ?? matchedRun?.error?.message ?? '기록 없음'}`,
+    `찾은 우주: ${universe}`,
+    `원장: ${result.runState ? '찾음' : '원장에 없음'}`,
+    `골 문서: ${result.goalFile ? '찾음' : '골 문서에 없음'}`,
+  ].join('\n');
+}
+
+function installHarnessGoalCommand(harnessCmd: Command, options?: GoalLookupOptions, archiveOptions?: GoalArchiveOptions): Command {
+  const goal = harnessCmd.command('goal').usage('<reference> | archive [--before <date>] [--apply]')
+    .description('골 문서와 실행 결과를 조회하거나 보관한다');
+  goal.command('archive')
+    .description('종료된 골 문서를 미리 보거나 상태 루트에 보관한다 — 저장소는 건드리지 않고 지울 목록(filesForPr)만 낸다')
+    .option('--before <date>', '완료 시각이 이 YYYY-MM-DD 이전인 골만')
+    .option('--apply', '상태 루트에 보관 복사·색인 (저장소 삭제·스테이지·커밋 없음 · 지우기는 filesForPr 로 사람이 PR)')
+    .option('--trust-doc-record', '런 원장이 없을 때 문서에 적힌 종료 실행 기록을 신뢰')
+    .action((opts: { before?: string; apply?: boolean; trustDocRecord?: boolean }) => {
+      try {
+        const result = archiveGoals({ ...archiveOptions, before: opts.before, apply: opts.apply, trustDocRecord: opts.trustDocRecord });
+        console.log(JSON.stringify(result));
+      } catch (error) {
+        console.error(humanErrorLine(error));
+        process.exitCode = 1;
+      }
+    });
+  goal.command('show <reference>', { isDefault: true })
+    .description('PR 번호 또는 runId 로 골 문서와 실행 결과를 조회한다 (읽기 전용)')
+    .option('--json', 'GoalLookupResult 그대로 출력')
+    .action((reference: string, opts: { json?: boolean }) => {
+      try {
+        const result = lookupGoal(reference, options);
+        const universe = effectiveInstanceRoot() === prodInstanceRoot() ? '운영' : '시험';
+        console.log(opts.json ? JSON.stringify(result) : renderHarnessGoal(result, universe));
+        if (!result.goalFile || !result.runState) process.exitCode = 1;
+      } catch (error) {
+        console.error(humanErrorLine(error));
+        process.exitCode = 1;
+      }
+    });
+  return goal;
+}
+
 function installHarnessBudgetCommand(harnessCmd: Command): Command {
   return harnessCmd
     .command('budget')
@@ -2106,6 +2301,8 @@ export interface HarnessCliCommandDeps {
   processObservation?: HarnessProcessObservationDeps;
   draftSweep?: HarnessDraftSweepDeps;
   queue?: HarnessQueueDeps;
+  goalLookup?: GoalLookupOptions;
+  goalArchive?: GoalArchiveOptions;
   ask?: HarnessAskHandler;
   say?: HarnessSayHandler;
   /** Observe-only Pod host dispatch seam. */
@@ -2124,6 +2321,27 @@ export function installHarnessCliCommand(program: Command, deps: HarnessCliComma
     .command('harness')
     .description('dev-harness worktree 수명 — 워크트리 생성(worktree add)·조회(worktrees)·정리(clean)·프로세스 관찰(processes)');
   installHarnessCliSinkHook(harnessCmd, deps.registerSink, deps.resolveSurface);
+  harnessCmd.command('doors').description('기간 안 런을 입구×대기열 경유 표로 읽는다')
+    .option('--since <window>', '조회 창 (30m · 12h · 1d, 기본 1d)', '1d')
+    .option('--json', '구조화 출력')
+    .action((opts: { since?: string; json?: boolean }) => {
+      const parsed = parseDoorSince(opts.since);
+      if ('error' in parsed) {
+        console.error(`❌ ${parsed.error}`);
+        process.exitCode = 2;
+        return;
+      }
+      let table: DoorTable;
+      try {
+        table = queryLaunchDoors({ sinceMs: parsed.sinceMs });
+      } catch (error) {
+        console.error(`❌ doors: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+        return;
+      }
+      if (opts.json) console.log(JSON.stringify(table));
+      else console.log(renderLaunchDoors(table));
+    });
   harnessCmd.command('incidents').description('최근 하니스 Pod 종료 사고 원장을 읽는다')
     .option('--since <minutes>', '최근 몇 분의 종료를 볼지 (기본 15분)', '15')
     .option('--json', '구조화 출력')
@@ -2146,8 +2364,8 @@ export function installHarnessCliCommand(program: Command, deps: HarnessCliComma
         const bursts = detectBursts(rows).filter((burst) => Date.parse(burst.lastAt) >= now - since * 60_000 && Date.parse(burst.lastAt) <= now);
         if (opts.json) console.log(JSON.stringify({ rows: selected, bursts }));
         else {
-          for (const row of selected) console.log(`${row.at} run ${row.runId} · ${row.reason} · status=${row.status} signal=${row.signal ?? '-'}`);
-          for (const burst of bursts) console.log(`${burst.firstAt}–${burst.lastAt} 묶음 ${burst.reason} ×${burst.count} · ${burst.runIds.join(', ')}`);
+          for (const row of selected) console.log(`${row.at} run ${row.runId} · seat=${row.seat ?? '-'} entrance=${row.entrance ?? '-'} reason=${row.reason} · status=${row.status} signal=${row.signal ?? '-'}`);
+          for (const burst of bursts) console.log(`${burst.firstAt}–${burst.lastAt} 묶음 ${burst.reason} ×${burst.count} · seat=${burst.seat ?? '-'} entrance=${burst.entrance ?? '-'} · ${burst.runIds.join(', ')}`);
         }
       } catch (error) {
         console.error(humanErrorLine(error));
@@ -2157,6 +2375,7 @@ export function installHarnessCliCommand(program: Command, deps: HarnessCliComma
   installDeliverableVerifyCliCommand(harnessCmd, deps.deliverableVerify);
   installHarnessProcessObservationCommand(harnessCmd, deps.processObservation);
   installHarnessBudgetCommand(harnessCmd);
+  installHarnessGoalCommand(harnessCmd, deps.goalLookup, deps.goalArchive);
   installHarnessDraftSweepCommand(harnessCmd, deps.draftSweep);
   const queue = harnessCmd.command('queue').description('자리별 영속 발사 대기열');
   const queueDeps = deps.queue ?? {};
@@ -2169,7 +2388,7 @@ export function installHarnessCliCommand(program: Command, deps: HarnessCliComma
       console.log(`${row.id} ${row.seat} ${row.kind} queued`);
     }));
   queue.command('list').description('대기·발사 원장 조회').action(() => queueAction(async () => {
-    for (const row of listHarnessQueue(queueDeps)) console.log(`${row.id} ${row.seat} ${row.status} ${row.kind} ${row.input}`);
+    for (const row of listHarnessQueue(queueDeps)) console.log(`${row.id} ${row.seat} ${row.status} ${row.kind} ${row.input}${row.waitingReason ? ` · ${row.waitingReason}` : ''}`);
   }));
   queue.command('remove <id>').description('대기 중 또는 종료 확인된 항목 제거').action((id: string) => queueAction(async () => {
     if (!await removeHarnessQueue(id, queueDeps)) throw new Error(`queue item active or not found: ${id}`);
@@ -2178,7 +2397,7 @@ export function installHarnessCliCommand(program: Command, deps: HarnessCliComma
   queue.command('reconcile <id>').description('불확정 발사를 확인하고 종료 또는 미발사 증거가 있으면 예약 해소').action((id: string) => queueAction(async () => {
     console.log(`${id} ${await reconcileHarnessQueue(id, queueDeps)}`);
   }));
-  queue.command('tick').description('맨 앞 한 건의 자리 몫과 Pod 풀 여유를 확인하고 발사').action(() => queueAction(async () => {
+  queue.command('tick').description('자리별 맨 앞 한 건을 라운드로빈으로 돌며 자리 몫·Pod 풀 여유·마무리 관문을 확인하고 한 건 발사').action(() => queueAction(async () => {
     const result = await tickHarnessQueue(queueDeps);
     console.log(`${result.outcome}${result.item ? ` ${result.item.id}` : ''}: ${result.reason}`);
   }));
@@ -2197,13 +2416,13 @@ export function installHarnessCliCommand(program: Command, deps: HarnessCliComma
             ...(opts.goalType !== undefined ? { goalType: opts.goalType } : {}),
             ...(opts.target !== undefined ? { target: opts.target } : {}),
           },
-          (resolved) => {
+          (resolved, stampedOpts) => {
             if (resolved.substrate !== 'pod' && (opts as { source?: string }).source !== undefined) {
               console.error('`--source` 는 `--substrate pod` 와 함께');
               process.exitCode = 2;
               return Promise.resolve();
             }
-            return resolved.substrate === 'pod' ? onPod(opts, 'cli-harness-ask', goalPath, resolved.pool!, deps.podDispatchTask) : ask(goalPath, normalizeHarnessAskSayOptions(opts));
+            return resolved.substrate === 'pod' ? onPod(stampedOpts, 'cli-harness-ask', goalPath, resolved.pool!, deps.podDispatchTask) : (announceLocalChildProvider(stampedOpts), ask(goalPath, normalizeHarnessAskSayOptions(stampedOpts)));
           },
           deps.launchGate,
         );
@@ -2222,13 +2441,15 @@ export function installHarnessCliCommand(program: Command, deps: HarnessCliComma
             wouldStart: '골 문서 · 워크트리 · 브랜치 · 자식 · 파이프라인',
             ...(opts.target !== undefined ? { target: opts.target } : {}),
           },
-          (resolved) => {
+          (resolved, stampedOpts) => {
             if (resolved.substrate !== 'pod' && (opts as { source?: string }).source !== undefined) {
               console.error('`--source` 는 `--substrate pod` 와 함께');
               process.exitCode = 2;
               return Promise.resolve();
             }
-            return resolved.substrate === 'pod' ? onPod(opts, 'cli-harness-say', sentence.join(' '), resolved.pool!, deps.podDispatchTask) : say(sentence, normalizeHarnessAskSayOptions(opts));
+            return resolved.substrate === 'pod'
+              ? onPod(stampedOpts, 'cli-harness-say', sentence.join(' '), resolved.pool!, deps.podDispatchTask, harnessAuthorOnPod())
+              : (announceLocalChildProvider(stampedOpts), say(sentence, normalizeHarnessAskSayOptions(stampedOpts)));
           },
           deps.launchGate,
         );