elanous 0.2.12 → 0.2.14

package/src/index.ts

@@ -41,6 +41,7 @@ import { registerRepoCommands } from './cli/repo-cli.js';
 import { registerAgentCommands, runChatTurnCli, emitDetachedProgress } from './cli/agent-cli.js';
 export { runChatTurnCli, buildCliAgentTools, setCliAgentDispatchForTesting, emitDetachedProgress, emitHarnessFeedbackProgress } from './cli/agent-cli.js';
 import { registerOpsCommands } from './cli/ops-cli.js';
+import { registerOutputsCommands } from './cli/outputs-cli.js';
 import { registerPublishCommands } from './cli/publish-cli.js';
 import { registerAutopilotCommands } from './cli/autopilot-cli.js';
 import { registerRoleCommands } from './cli/role-cli.js';
@@ -62,6 +63,8 @@ import { registerUsageCommand } from './cli/usage-cli.js';
 import { registerLiveCommands } from './cli/live-cli.js';
 import { registerResearchCommand } from './cli/research-cli.js';
 import { registerReleaseCommands } from './cli/release-cli.js';
+import { registerFreezeCommands } from './cli/freeze-cli.js';
+import { registerFlowCommands } from './cli/flow-cli.js';
 import { registerModelWatchCommand } from './cli/model-watch-cli.js';
 import { registerIntakeCommands } from './cli/intake-cli.js';
 import { registerTasksCommands } from './cli/tasks-cli.js';
@@ -103,7 +106,7 @@ import type { AcpPermissionApprover } from './acp/client.js';
 import { runGitCommand } from './git-fs/runner.js';
 import { debug, redactSecretText, redactSecrets } from './debug/log.js';
 import { installHarnessCliCommand, type HarnessAskSayChildLlmOptions, type HarnessAskSayOptions, type HarnessPlanOptions } from './harness/harness-cli-command.js';
-import { formatCliUserError, isCliUserError } from './cli/cli-user-error.js';
+import { CliUserError, formatCliUserError, isCliUserError } from './cli/cli-user-error.js';
 import { dispatchSolveMission } from './skills/tools/solve-mission.js';
 import { performBrowserAction, type BrowserActionDeps, type BrowserActionResult } from './harness/browser-act.js';
 import { decideTypeAction, type TypeActionDecision, type TypeTarget } from './harness/browser-act-type.js';
@@ -868,7 +871,90 @@ registerUsageCommand(program);
 registerLiveCommands(program);
 registerResearchCommand(program);
 registerReleaseCommands(program);
+registerFreezeCommands(program);
+registerFlowCommands(program);
+// HQ-HB · HQ-FENCE (10-04): one writer across mbp · node-b · cloud-vm — lease on the arbiter, 2-of-3 quorum, generation fencing.
+const hqCmd = program.command('hq').description('본부 임대 — 하트비트·중재·단일 작성자 래퍼');
+async function hqSink(): Promise<void> {
+  try { await (await import('./domains/standalone-log-sink.js')).registerStandaloneLogSink('hq'); } catch { /* observation is fail-soft */ }
+}
+hqCmd.command('host').description('이 머신의 HQ 호스트 이름 설정')
+  .command('set <name>').description('호스트 로컬 ~/.elanous-hq/host 에 한 줄로 기록')
+  .action(async (name: string) => {
+    try {
+      const { hqHostSet } = await import('./hq/hq.js');
+      const path = hqHostSet(name);
+      console.log(`hq host set: ${name} (${path})`);
+    } catch (error) { console.error(`hq host set: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
+hqCmd.command('lease').argument('<action>', 'acquire|renew|status|release')
+  .option('--host <name>', '이 호스트 이름(기본 ~/.elanous-hq/host · hq.hostName · os.hostname)')
+  .option('--json', 'JSON 출력')
+  .action(async (action: string, opts: { host?: string; json?: boolean }) => {
+    try {
+      if (!['acquire', 'renew', 'status', 'release'].includes(action)) throw new CliUserError(`hq lease: unknown action ${action}`, 'acquire|renew|status|release');
+      await hqSink();
+      const { hqLease } = await import('./hq/hq.js');
+      const result = hqLease(action as 'acquire', {}, opts.host ? { host: opts.host } : {});
+      if (opts.json) await writeStdoutJson(`${JSON.stringify(result)}\n`);
+      else console.log(result.ok ? `hq lease ${action}: ok${'record' in result && result.record ? ` · holder ${result.record.holder} · generation ${result.record.generation}` : ''}` : `hq lease ${action}: refused — ${'reason' in result ? result.reason : ''}`);
+      if (!result.ok) process.exitCode = 2;
+    } catch (error) { if (error instanceof CliUserError) throw error; console.error(`hq lease: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
+hqCmd.command('promote').description('HQ 승격 런북 (기본 dry-run · --apply 일 때만 변경)')
+  .requiredOption('--to <host>', '승격 대상 호스트')
+  .option('--apply', '대기 사본을 승격 우주에 반영하고 넥서스·rescue 실행')
+  .option('--json', 'JSON 출력')
+  .action(async (opts: { to: string; apply?: boolean; json?: boolean }) => {
+    try {
+      const { promoteHq, formatPromote } = await import('./hq/promote.js');
+      const result = promoteHq(opts.to, opts.apply === true);
+      if (opts.json) await writeStdoutJson(`${JSON.stringify(result)}\n`);
+      else console.log(formatPromote(result));
+      if (!result.ok) process.exitCode = 1;
+    } catch (error) { console.error(`hq promote: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
+hqCmd.command('heartbeat').description('보유자는 갱신 · 아니면 대기(보유자에 닿는지 중재자에 보고)').option('--json', 'JSON 출력')
+  .action(async (opts: { json?: boolean }) => {
+    try {
+      await hqSink();
+      const result = (await import('./hq/hq.js')).hqHeartbeat();
+      if (opts.json) await writeStdoutJson(`${JSON.stringify(result)}\n`); else console.log(`hq heartbeat: ${result.outcome}`);
+    } catch (error) { console.error(`hq heartbeat: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
+hqCmd.command('arbiter-check').description('중재자(cloud-vm)에서: 보유자 탐침 · 연속 2회 이중 불통이면 대기 호스트 승격').option('--json', 'JSON 출력')
+  .action(async (opts: { json?: boolean }) => {
+    try {
+      await hqSink();
+      const result = (await import('./hq/hq.js')).hqArbiterCheck();
+      if (opts.json) await writeStdoutJson(`${JSON.stringify(result)}\n`); else console.log(`hq arbiter-check: ${result.promoted ? `promoted ${result.holder} gen ${result.generation}` : `streak ${result.streak}`}`);
+    } catch (error) { console.error(`hq arbiter-check: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
+hqCmd.command('seen').description('이 호스트가 본 가장 높은 임대 세대(한 번도 못 봤으면 exit 3 — 드릴 전 기본 원천 판단용)').option('--json', 'JSON 출력')
+  .action(async (opts: { json?: boolean }) => {
+    const result = (await import('./hq/hq.js')).hqSeen();
+    if (opts.json) await writeStdoutJson(`${JSON.stringify(result)}\n`);
+    else console.log(result.seen ? `hq seen: generation ${result.generation}` : 'hq seen: never');
+    process.exitCode = result.seen ? 0 : 3;
+  });
+hqCmd.command('fence').description('이 호스트가 임대를 쥐었을 때만 명령 실행(아니면 건너뜀 · exit 0)')
+  .requiredOption('--role <role>', 'telegram-poller|cron|seat-loop|release-run|conatus|git-push')
+  .argument('<command...>', '-- 뒤의 명령')
+  .action(async (command: string[], opts: { role: string }) => {
+    const { FENCE_ROLES, hqFenceRun } = await import('./hq/hq.js');
+    if (!(FENCE_ROLES as readonly string[]).includes(opts.role)) throw new CliUserError(`hq fence: unknown role ${opts.role}`, FENCE_ROLES.join('|'));
+    await hqSink();
+    process.exitCode = hqFenceRun(opts.role as 'cron', command);
+  });
 const seatCmd = program.command('seat').description('분배된 자리의 하루 루프와 보고');
+seatCmd.command('answer <askId> <answer>').description('자리 질문에 답을 남기고 원래 표면으로 회신 예약')
+  .action(async (askId: string, answer: string) => {
+    try {
+      const { answerSeatAsk } = await import('./seat-dispatch/seat-ask.js');
+      answerSeatAsk(askId, answer);
+      console.log(`자리 답변 기록: ${askId}`);
+    } catch (error) { console.error(`seat answer: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
 seatCmd.command('loop').requiredOption('--seat <SEAT>', 'MK|OP|TC|UX')
   .requiredOption('--once', '한 번 실행')
   .option('--json', 'JSON 출력')
@@ -893,6 +979,20 @@ seatCmd.command('report').requiredOption('--seat <SEAT>', 'MK|OP|TC|UX')
       else console.log(result.body);
     } catch (error) { console.error(`seat report: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
   });
+seatCmd.command('pack').description('자리 묶음').command('export')
+  .requiredOption('--seat <SEAT>', '내보낼 자리')
+  .requiredOption('--out <dir>', '비어 있는 산출 폴더')
+  .action(async (opts: { seat: string; out: string }) => {
+    try {
+      const { exportSeatPack } = await import('./seat-loop/seat-pack.js');
+      const result = exportSeatPack(opts.seat, opts.out);
+      console.log(`seat pack ${result.name} ${result.version}: ${result.files.length} files → ${opts.out}`);
+    } catch (error) {
+      const { SeatPackLeakError } = await import('./seat-loop/seat-pack.js');
+      console.error(`seat pack export: ${error instanceof Error ? error.message : String(error)}`);
+      process.exitCode = error instanceof SeatPackLeakError ? 2 : 1;
+    }
+  });
 registerModelWatchCommand(program);
 registerDoctorCommand(program);
 // runCli() → main() → program.parseAsync() dispatches control serve and resources where|list.
@@ -974,6 +1074,19 @@ marketCmd.command('keygen').description('Generate a local test index signing key
     console.log(`Generated local index key ${pair.keyId}`);
   });
 
+const stewardCmd = program.command('steward').description('Steward loop controls');
+stewardCmd.command('readiness').description('Read-only shadow evidence for a live decision')
+  .option('--since <duration>', 'Lookback duration, e.g. 24h', '24h')
+  .option('--json', 'JSON output')
+  .action(async (opts: { since: string; json?: boolean }) => {
+    process.exitCode = (await import('./steward/readiness.js')).runStewardReadinessCli(opts);
+  });
+stewardCmd.command('mode [mode]').description('Show or set the steward mode: off|shadow|live|rescue (rescue = HQ move: launch·harvest·alert·decision cards only)')
+  .option('--json', 'JSON output')
+  .action(async (mode: string | undefined, opts: { json?: boolean }) => {
+    process.exitCode = await (await import('./steward/rescue.js')).runStewardModeCli(mode, opts);
+  });
+
 program.command('directive').description('Turn instructions into Linear issues')
   .command('add <text>').option('--source <source>', 'telegram|pwa|tui|cli', 'cli')
   .option('--dry-run', 'Preview the normalized directive without contacting Linear')
@@ -2938,6 +3051,8 @@ export async function runHarnessOrchestrateExecution(
     prior,
     goals,
     pid,
+    ...(['OP', 'TC', 'MK', 'UX'].includes(process.env.ELANOUS_HARNESS_SEAT ?? '')
+      ? { seat: process.env.ELANOUS_HARNESS_SEAT as SelfDevRunState['seat'] } : {}),
     runIdSource,
     now,
     onPersistenceFailure: reportPersistenceFailure,
@@ -3029,6 +3144,39 @@ const harnessOrchestrateCmd = registerHarnessOrchestrateCapabilityOptions(
   });
 
 const contextCmd = program.command('context').description('외부 에이전트 맥락 이벤트');
+contextCmd.command('day')
+  .description('자리 넷과 외부 세션의 최근 맥락 이벤트 수·마지막 시각 (읽기 전용)')
+  .option('--since <hours>', '최근 시간 창 (예: 24h)', '24h')
+  .option('--json', '구조화된 JSON 출력')
+  .action(async (opts: { since: string; json?: boolean }) => {
+    try {
+      const { contextDay, renderContextDay } = await import('./context-bus/context-day.js');
+      const report = contextDay(opts.since);
+      await writeStdoutJson(`${opts.json ? JSON.stringify(report) : renderContextDay(report)}\n`);
+    } catch (error) {
+      console.error(`context day: ${error instanceof Error ? error.message : String(error)}`);
+      process.exitCode = 2;
+    }
+  });
+contextCmd.command('condense')
+  .description('최근 맥락 이벤트·결정·조율 요약을 프로젝트/자리별 장기 기억 후보 JSON ⊕ Markdown 으로 응축')
+  .option('--since <hours>', '최근 시간 창 (예: 24h)', '24h')
+  .option('--dry-run', '읽고 stdout 에만 출력 (기본 동작)')
+  .option('--apply', '충돌은 OP 결정 원장으로 올리고 비충돌 후보를 기존 프로젝트 기억에 저장 · 이전 버전 은퇴')
+  .option('--json', '구조화된 JSON 출력')
+  .action(async (opts: { since: string; dryRun?: boolean; apply?: boolean; json?: boolean }) => {
+    try {
+      if (opts.apply && opts.dryRun) throw new Error('--apply and --dry-run cannot be combined');
+      if (!/^[1-9]\d*h$/.test(opts.since)) throw new Error('--since requires positive hours, e.g. 24h');
+      const { runContextCondense } = await import('./context-bus/condense.js');
+      const report = await runContextCondense({ hours: Number(opts.since.slice(0, -1)), apply: opts.apply === true });
+      await writeStdoutJson(JSON.stringify({ since: report.since, until: report.until, cards: report.cards, conflicts: report.conflicts, skipped: report.skipped, folded: report.folded, droppedHarnessChild: report.droppedHarnessChild, funnel: report.funnel, ...(report.applied ? { applied: report.applied } : {}) }) + '\n');
+      if (!opts.json) await writeStdoutFully(report.markdown);
+    } catch (error) {
+      console.error(`context condense: ${error instanceof Error ? error.message : String(error)}`);
+      process.exitCode = 2;
+    }
+  });
 contextCmd.command('hooks').description('Claude Code 맥락 훅 설정').command('install')
   .requiredOption('--print', '설정 조각만 출력하고 설정 파일은 수정하지 않음')
   .action(async () => {
@@ -4171,6 +4319,35 @@ selfCmd
     } catch (e) { console.error(`⛔ ${(e as Error).message}`); process.exitCode = 1; }
   });
 
+export async function announceLaunchQuotaPolicy(input: {
+  runId: string;
+  current: import('./oauth/codex-quota-policy.js').ResolvedCodexQuotaPolicy;
+  universe: { kind: 'prod' | 'test'; root: string };
+  production?: import('./oauth/codex-quota-policy.js').ResolvedCodexQuotaPolicy;
+}): Promise<{ line: string; warning?: string; quotaPolicy: {
+  policy: import('./oauth/codex-quota-policy.js').CodexQuotaPolicy;
+  source: import('./oauth/codex-quota-policy.js').ResolvedCodexQuotaPolicy['source'];
+  universeKind: 'prod' | 'test';
+} }> {
+  const { describeLaunchQuotaPolicy } = await import('./oauth/codex-quota-policy.js');
+  const { appendRunLedgerEntry } = await import('./self-implement/run-ledger.js');
+  const described = describeLaunchQuotaPolicy(input);
+  const data = { policy: input.current.policy, source: input.current.source, universe: input.universe,
+    ...(described.warning ? { warning: described.warning } : {}) };
+  try {
+    appendRunLedgerEntry({ runId: input.runId, timestamp: new Date().toISOString(), event: 'launch-quota-policy', data });
+  } catch (error) {
+    debug.log('pod.quota-policy', 'ledger-unavailable', { runId: input.runId, error: String(error) }, { level: 'warn' });
+    throw new Error(`pod launch quota policy ledger write failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+  }
+  debug.log('pod.quota-policy', 'announced', data);
+  return { ...described, quotaPolicy: { policy: input.current.policy, source: input.current.source, universeKind: input.universe.kind } };
+}
+
+export function withLaunchQuotaPolicy<T extends object>(results: readonly T[], quotaPolicy: Awaited<ReturnType<typeof announceLaunchQuotaPolicy>>['quotaPolicy'] | undefined): (T & { quotaPolicy?: Awaited<ReturnType<typeof announceLaunchQuotaPolicy>>['quotaPolicy'] })[] {
+  return quotaPolicy ? results.map((result) => ({ ...result, quotaPolicy })) : [...results];
+}
+
 // self orchestrate — 병렬 self-dev(S1·2026-07-21) — N개 독립 goal 을 각자 `elanous self implement` 서브프로세스로
 //   TOX 디스패처 위에서 동시성캡 병렬 실행. 각 잡=자기 프로세스=자기 harness-space(병렬안전). 엔진(그래프/
 //   디스패처)은 기존 재사용·새 조각=self-implement surface 어댑터. [[PLAN-parallel-self-dev-orchestrator-2026-07-21]].
@@ -4329,6 +4506,8 @@ const selfOrchestrateCmd = selfCmd
         prior,
         goals,
         pid: process.pid,
+        ...(['OP', 'TC', 'MK', 'UX'].includes(process.env.ELANOUS_HARNESS_SEAT ?? '')
+          ? { seat: process.env.ELANOUS_HARNESS_SEAT as SelfDevRunState['seat'] } : {}),
         runIdSource,
         now: () => Date.now(),
       });
@@ -4363,6 +4542,7 @@ const selfOrchestrateCmd = selfCmd
       //   coordinator 해석(decompose·run-identity·checkpoint·board)은 액션에 유지·감독 콜백은 runtime 으로 주입.
       // ☸️ 실행 칸 — pod 면 self-implement 자식을 k8s Job 으로(계약 동일 · 슈퍼바이저 무수정).
       const substrate = (opts as { substrate?: string }).substrate ?? 'local';
+      let launchQuotaPolicy: Awaited<ReturnType<typeof announceLaunchQuotaPolicy>>['quotaPolicy'] | undefined;
       let podSpawn: import('./task-orchestrator/surfaces/self-implement.js').SelfImplementJobSpawn | undefined;
       let podTargets: { context: string; namespace: string }[] | undefined;
       if (substrate === 'pod') {
@@ -4445,30 +4625,39 @@ const selfOrchestrateCmd = selfCmd
           const resolvedQuota = resolveCodexQuotaPolicy(getUserConfig().llm);
           const quotaPolicy = resolvedQuota.policy;
           // POL1 — say which policy this launch uses and where it came from; warn when a test universe disagrees with production.
-          try {
-            const { effectiveInstanceRoot, prodInstanceRoot } = await import('./instance/resolve.js');
-            const { describeLaunchQuotaPolicy } = await import('./oauth/codex-quota-policy.js');
-            const root = effectiveInstanceRoot();
-            const kind = root === prodInstanceRoot() ? 'prod' as const : 'test' as const;
-            let production: ReturnType<typeof resolveCodexQuotaPolicy> | undefined;
-            if (kind === 'test') {
-              try {
-                const { readFileSync } = await import('node:fs');
-                const prodLlm = (JSON.parse(readFileSync(`${prodInstanceRoot()}/config.json`, 'utf8')) as { llm?: Record<string, unknown> }).llm;
-                production = resolveCodexQuotaPolicy(prodLlm);
-              } catch { /* no production config on this machine */ }
+          const { effectiveInstanceRoot, prodInstanceRoot } = await import('./instance/resolve.js');
+          const root = effectiveInstanceRoot();
+          const kind = root === prodInstanceRoot() ? 'prod' as const : 'test' as const;
+          let production: ReturnType<typeof resolveCodexQuotaPolicy> | undefined;
+          if (kind === 'test') {
+            try {
+              const { readFileSync } = await import('node:fs');
+              const prodLlm = (JSON.parse(readFileSync(`${prodInstanceRoot()}/config.json`, 'utf8')) as { llm?: Record<string, unknown> }).llm;
+              production = resolveCodexQuotaPolicy(prodLlm);
+            } catch { /* no production config on this machine */ }
+          }
+          const described = await announceLaunchQuotaPolicy({ runId, current: resolvedQuota, universe: { kind, root }, ...(production ? { production } : {}) });
+          launchQuotaPolicy = described.quotaPolicy;
+          debug.log('self-implement.pod', 'quota-policy', { policy: resolvedQuota.policy, source: resolvedQuota.source, universe: kind, productionPolicy: production?.policy ?? null });
+          if (!opts.json) { ui.info(described.line); if (described.warning) ui.warn(described.warning); }
+          // GROK-OPTIONAL (10-05): an expiring grok subscription the host cannot refresh is dropped from the chain here,
+          // so the launch goes on with codex instead of dying later in hostGrokCredentials.
+          let grokSubscriptionUsable = credential?.kind === 'subscription';
+          if (grokSubscriptionUsable && codexPolicyAllowsFallback(quotaPolicy)) {
+            const { podGrokSubscriptionUsable, podGrokSkippedLine } = await import('./task-orchestrator/surfaces/self-implement-pod.js');
+            const grokCheck = podGrokSubscriptionUsable();
+            if (!grokCheck.usable) {
+              grokSubscriptionUsable = false;
+              if (!opts.json) ui.warn(podGrokSkippedLine(grokCheck));
             }
-            const described = describeLaunchQuotaPolicy({ current: resolvedQuota, universe: { kind, root }, ...(production ? { production } : {}) });
-            debug.log('self-implement.pod', 'quota-policy', { policy: resolvedQuota.policy, source: resolvedQuota.source, universe: kind, productionPolicy: production?.policy ?? null });
-            if (!opts.json) { ui.info(described.line); if (described.warning) ui.warn(described.warning); }
-          } catch { /* the line is advice; the launch goes on */ }
+          }
           const plan = planPodProvider({
             codexCandidates: inspectCodexRotation().candidates,
             // Per-account caps (대표 default:97) override the Pod default cap — without them default was dropped at 60%.
             thresholdPercentByAccount: getUserConfig().llm?.codexAccountRotationThresholdPercentByAccount,
             // 대표 한도 정책 한 값(`llm.codexQuotaPolicy`) — 크레딧·폴백을 같이 정한다.
             creditsAllowed: codexPolicyAllowsCredits(quotaPolicy),
-            grokSubscription: codexPolicyAllowsFallback(quotaPolicy) && credential?.kind === 'subscription',
+            grokSubscription: codexPolicyAllowsFallback(quotaPolicy) && grokSubscriptionUsable,
             grokApiKey: codexPolicyAllowsFallback(quotaPolicy) && credential?.kind === 'api_key',
             grokApiKeyOptIn,
           });
@@ -4585,7 +4774,7 @@ const selfOrchestrateCmd = selfCmd
           debug.log('self-dev.reduce', 'orchestrate-reduce', { runId, shards: shards.length, kind: r.kind });
         }
       }
-      if (opts.json) { await writeStdoutJson(JSON.stringify(results) + '\n'); await reportRun(results); return; }
+      if (opts.json) { await writeStdoutJson(JSON.stringify(withLaunchQuotaPolicy(results, launchQuotaPolicy)) + '\n'); await reportRun(results); return; }
       const done = results.filter((r) => r.status === 'done').length;
       const promoted = results.filter((r) => r.prUrl).length;
       const incomplete = results.length - done;
@@ -5616,6 +5805,7 @@ registerFleetCommands(program);
 
 // ── ops (운영 관측 — 지금 뭐 도나·이상 없나·상태 전이) ──
 registerOpsCommands(program);
+registerOutputsCommands(program);
 
 registerPublishCommands(program);
 
@@ -5794,6 +5984,33 @@ agentCmd
     process.exit(outcome.exitCode);
   });
 
+agentCmd.command('duo [text...]')
+  .description('Run Codex and Claude Code concurrently on the same mission in separate worktrees; summarize both PTY decisions and evidence.')
+  .requiredOption('--left <backend>', 'codex or claude')
+  .requiredOption('--right <backend>', 'codex or claude')
+  .requiredOption('--branch <name>', 'base name for two distinct worktree branches')
+  .option('--base <ref>', 'common branch base (default HEAD)')
+  .option('--mission-file <path>', 'read the same verbatim mission from a file')
+  .option('--evidence <mode>', 'doc|tsc|test (default tsc)', 'tsc')
+  .option('--doc-dir <rel>', 'doc evidence directory')
+  .option('--doc-glob <re>', 'doc evidence filename pattern')
+  .option('--test-path <p>', 'test evidence test path')
+  .option('--file <rel>', 'test evidence output file')
+  .option('--max-rounds <n>', 'maximum PTY control rounds', '16')
+  .option('--no-commit', 'do not commit completed worktrees')
+  .action(async (textParts: string[], opts: import('./agent-mission/duo.js').DuoOptions) => {
+    try {
+      delete process.env.OPENAI_API_KEY;
+      const { runAgentMissionDuo } = await import('./agent-mission/duo.js');
+      const result = await runAgentMissionDuo(textParts, opts);
+      console.log(`[duo] missionId=${result.missionId}\n${result.lines.join('\n')}`);
+      process.exitCode = result.exitCode;
+    } catch (error) {
+      console.error(`duo: ${error instanceof Error ? error.message : String(error)}`);
+      process.exitCode = 1;
+    }
+  });
+
 // ★ 리뷰 반응 완결 루프 (L1) — PR 리뷰(OK/보강/거절)를 트리거로 codex 가 자율 rework→재제출.
 // ⭐ 옵션 정의·opts 조립은 `agent-mission/review-loop-cli.ts`(테스트 가능 seam) — 액션은 I/O 만 한다.
 registerReviewLoopOptions(
@@ -6515,6 +6732,12 @@ const selfDevCmd = program
     let devRunId = '';
     let devRunIdSource: import('./harness/harness-space.js').RunIdSource | undefined;
     let preparedWorktree: import('./harness/harness-worktree-auto.js').PreparedDevWorktree | undefined;
+    let authoringLease: import('./pod-lease/host-lease.js').HostLeaseHandle | undefined;
+    const releaseAuthoringLease = () => {
+      if (!authoringLease) return;
+      authoringLease(); authoringLease = undefined;
+      process.off('exit', releaseAuthoringLease);
+    };
     try {
       // ⛔ raw 입력 배타성 검증은 try 안의 selectDevAuthorInput 하나가 소유한다 — 실패도 아래 catch가 관측한다.
       const { buildDevCommandInput, selectDevAuthorInput } = await import('./self-dev/dev-cli.js');
@@ -6607,6 +6830,23 @@ const selfDevCmd = program
           priorBlockSamples: () => askIo.priorBlockSamplesFrom(askLogRows),
           recentAuthoringSamples: () => askIo.recentAuthoringSamplesFrom(askLogRows),
           authorGoal: (args, options) => runGoalAuthorCli([...args], options as never),
+          ...(devAskSubstrate?.substrate === 'pod' ? { beforeAuthoring: async () => {
+            const { parsePodPool, podPoolHostLease } = await import('./task-orchestrator/surfaces/pod-pool.js');
+            const { measurePoolLease, recommendConcurrency } = await import('./task-orchestrator/surfaces/pod-lease.js');
+            const members = parsePodPool(devAskSubstrate.pool!);
+            const host = podPoolHostLease(members);
+            while (!authoringLease) {
+              const status = recommendConcurrency(measurePoolLease(members), { capacity: members.reduce((n, m) => n + m.capacity, 0), accounts: 0, perAccount: 0 });
+              if (status.recommended !== null && status.recommended > 0) {
+                const { leaseHasPendingPod } = await import('./pod-lease/host-lease.js');
+                const pendingJobs = status.pendingJobs ?? [];
+                authoringLease = host.tryReserve((others) =>
+                  others - host.live().filter((r) => leaseHasPendingPod(r, pendingJobs)).length < status.recommended!, true) ?? undefined;
+                if (authoringLease) process.once('exit', releaseAuthoringLease);
+              }
+              if (!authoringLease) await new Promise((resolve) => setTimeout(resolve, 15_000));
+            }
+          } } : {}),
           relativeToCwd: (file) => relativeToCwdPath(process.cwd(), file),
         });
         // ⛔ 종료는 «표면»이 한다 — 흐름은 세 값만 낸다.
@@ -6616,6 +6856,7 @@ const selfDevCmd = program
         }
         askAuthoredFile = flowResult.goalFile;
         if (flowResult.kind === 'stopped-by-preflight') {
+          releaseAuthoringLease();
           completionGuard.conclude();
           process.exit(1);
         }
@@ -6630,18 +6871,29 @@ const selfDevCmd = program
         const { dispatchHarnessOnPod } = await import('./harness/harness-pod-dispatch.js');
         const { devAskPodDispatchInput } = await import('./harness/harness-substrate-default.js');
         const { classifyHarnessPodExit, harnessPodRunId, recordClassifiedHarnessPodExit, warnRecentIncidentBurst } = await import('./harness/harness-cli-command.js');
-        warnRecentIncidentBurst();
+        warnRecentIncidentBurst(undefined, undefined, undefined,
+          { entrance: 'cli-dev-ask', seat: opts.seat });
         let podOutput = '';
         let podRunId: string | undefined;
-        const status = await dispatchHarnessOnPod(devAskPodDispatchInput(opts, askAuthoredFile!, devAskSubstrate.pool!), {
-          onOutput: (text) => {
-            podRunId ??= harnessPodRunId(podOutput + text);
-            podOutput = (podOutput + text).slice(-16_000);
-          },
-        });
+        const previousLeaseId = process.env.ELANOUS_POD_RESERVED_LEASE;
+        if (authoringLease) process.env.ELANOUS_POD_RESERVED_LEASE = authoringLease.id;
+        let status: number;
+        try {
+          status = await dispatchHarnessOnPod(devAskPodDispatchInput(opts, askAuthoredFile!, devAskSubstrate.pool!), {
+            onOutput: (text) => {
+              podRunId ??= harnessPodRunId(podOutput + text);
+              podOutput = (podOutput + text).slice(-16_000);
+            },
+          });
+        } finally {
+          releaseAuthoringLease();
+          if (previousLeaseId === undefined) delete process.env.ELANOUS_POD_RESERVED_LEASE;
+          else process.env.ELANOUS_POD_RESERVED_LEASE = previousLeaseId;
+        }
         if (status !== 0) {
           const classified = classifyHarnessPodExit({ status }, podOutput, { ...(podRunId ? { runId: podRunId } : {}) });
-          recordClassifiedHarnessPodExit(podRunId ?? harnessPodRunId(podOutput), classified.reason, status);
+          recordClassifiedHarnessPodExit(podRunId ?? harnessPodRunId(podOutput), classified.reason, status,
+            { entrance: 'cli-dev-ask', seat: opts.seat, output: podOutput });
           for (const line of classified.lines) console.error(line);
         }
         completionGuard.conclude();
@@ -6940,9 +7192,11 @@ const selfDevCmd = program
         completionGuard.conclude();
         process.exit(r.result.exitCode);
       }
+      releaseAuthoringLease();
       completionGuard.conclude();
       process.exit(ok ? 0 : 2);
     } catch (e) {
+      releaseAuthoringLease();
       const msg = e instanceof Error ? e.message : String(e);
       // ⚠️ 관측은 결론을 막지 않는다(리뷰 should-fix 5R) — 여기서 로거가 던지면 아래 `console.error` 와
       //    의도한 `exit(1)` 까지 통째로 우회해, 사용자는 이유도 모른 채 다른 종료코드를 받는다.

package/src/intake-plane/discord-seat-work.ts

@@ -9,7 +9,7 @@ import { askSeat, parseSeatAsk, type SeatAskDeps } from '../seat-dispatch/seat-a
 import { parseSeatAddress, resolveSeat } from '../seat-address/seat-address.js';
 import { getUserConfig, type UserConfig } from '../user-config.js';
 import { answerAsSeat } from './seat-answer.js';
-import { answerAsPersona, resolvePersonaAddress, type PersonaAnswerDeps } from './persona-answer.js';
+import { answerAsPersona, resolvePersonaAddress, seatOfPersona, type PersonaAnswerDeps } from './persona-answer.js';
 import {
   submitIntakeWork,
   type SubmitIntakeWorkDeps,
@@ -72,14 +72,21 @@ export async function handleDiscordSeatWork(
     return ['OP', 'TC', 'MK', 'UX'].includes(id) ? sendTask(id, text, auth!.cfg, auth!.id) : null;
   }
 
-  const seats = address.seats.map((name) => ({ name, seat: resolveSeat(name) }));
-  const hasUnresolved = seats.some(({ seat }) => !seat);
+  const initialSeats = address.seats.map((name) => ({ name, seat: resolveSeat(name) }));
+  const hasUnresolved = initialSeats.some(({ seat }) => !seat);
   const auth = hasUnresolved ? owner() : null;
   if (hasUnresolved && auth && !deps.personaSource) await awaitGlobalPersonaLoad();
   const source = hasUnresolved && auth ? (deps.personaSource ?? getGlobalPersonaRegistry()) : null;
-  const addressed = seats.map(({ name, seat }) => ({
-    name, seat, persona: !seat && source ? resolvePersonaAddress(name, source) : null,
-  }));
+  const addressed = initialSeats.map(({ name, seat }) => {
+    const persona = !seat && source ? resolvePersonaAddress(name, source) : null;
+    const personaSeat = persona ? seatOfPersona(persona) : null;
+    if (persona && personaSeat) {
+      debug.log('persona.address', 'seat-alias', { name, personaId: persona.personaId, seat: personaSeat.id, via: 'discord' });
+      return { name: personaSeat.id, seat: personaSeat, persona: null };
+    }
+    return { name, seat, persona };
+  });
+  const seats = addressed;
   const unknown = addressed.filter(({ seat, persona }) => !seat && (!persona || !auth)).map(({ name }) => `@${name}`);
   if (unknown.length) return `어느 좌석을 말씀하시나요? ${unknown.join(', ')}은(는) 등록된 좌석이 아닙니다. 좌석을 확인해 다시 보내 주세요.`;
   const personas = addressed.filter(({ persona }) => persona);

package/src/intake-plane/linear-wish.ts

@@ -0,0 +1,72 @@
+import { fetchLinearIssues } from '../connectors/linear.js';
+import { debug } from '../debug/log.js';
+import { getSecretAsync } from '../nexus/config/secrets/index.js';
+import { CardStore } from '../task-cards/card-store.js';
+import { createWishCard } from './wish-card.js';
+
+export const LINEAR_WISH_KEY_MISSING = 'Linear 키가 없습니다 — elanous connector linear 로 먼저 등록하세요';
+
+type LinearWishDeps = {
+  getApiKey?: () => Promise<string | undefined>;
+  fetchIssues?: typeof fetchLinearIssues;
+};
+
+async function readLinearWishes(teamKey: string, options: { labelOrPrefix?: string; excludeLabel?: string }, deps: LinearWishDeps) {
+  const apiKey = await (deps.getApiKey ?? (() => getSecretAsync('connector.linear.apiKey')))();
+  if (!apiKey?.trim()) throw new Error(LINEAR_WISH_KEY_MISSING);
+  try {
+    return await (deps.fetchIssues ?? fetchLinearIssues)({ apiKey, teamKey, ...options });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(message.replaceAll(apiKey, '[redacted]'));
+  }
+}
+
+export interface LinearWishSuggestion { identifier: string; title: string; reason: string }
+
+const WISH_PHRASES = [
+  { pattern: /해\s*줘(?:요|라)?/, reason: '요청' },
+  { pattern: /만들어(?:\s*줘(?:요)?)?/, reason: '제작' },
+  { pattern: /원해(?:요)?/, reason: '희망' },
+  { pattern: /있으면\s*좋겠다/, reason: '희망' },
+];
+
+export async function suggestLinearWishes({ teamKey, deps = {} }: {
+  teamKey: string;
+  deps?: LinearWishDeps;
+}): Promise<LinearWishSuggestion[]> {
+  const issues = await readLinearWishes(teamKey, { excludeLabel: 'wish' }, deps);
+  return issues.flatMap(issue => {
+    const match = WISH_PHRASES.find(({ pattern }) => pattern.test(`${issue.title}\n${issue.body}`));
+    return match && issue.identifier
+      ? [{ identifier: issue.identifier, title: Array.from(issue.title).slice(0, 40).join(''), reason: match.reason }]
+      : [];
+  });
+}
+
+export async function scanLinearWishes({ teamKey, label = 'wish', store, deps = {} }: {
+  teamKey: string;
+  label?: string;
+  store: CardStore;
+  deps?: LinearWishDeps;
+}): Promise<{ added: number; duplicate: number; failed: number }> {
+  const issues = await readLinearWishes(teamKey, { labelOrPrefix: label }, deps);
+  let added = 0;
+  let duplicate = 0;
+  let failed = 0;
+  for (const issue of issues) {
+    try {
+      const result = createWishCard({
+        text: `${issue.title}\n\n${issue.body}\n\n${issue.url}`,
+        source: 'linear', ref: issue.identifier ?? '',
+        replyTo: { surface: 'linear', issueId: issue.ref },
+      }, store);
+      if (result.created) added++;
+      else duplicate++;
+    } catch {
+      failed++;
+    }
+  }
+  debug.log('intake.linear-wish', 'scanned', { teamKey, label, added, duplicate, failed });
+  return { added, duplicate, failed };
+}

package/src/intake-plane/persona-answer.ts

@@ -1,11 +1,16 @@
 import { debug } from '../debug/log.js';
 import { resolveMention, type PersonaSource } from '../persona/mention-parser.js';
 import type { PersonaProfile } from '../persona/types.js';
+import { resolveSeat, type SeatEntry } from '../seat-address/seat-address.js';
 
 export interface PersonaAnswerDeps {
   complete?: (prompt: string) => Promise<string>;
 }
 
+export function seatOfPersona(persona: PersonaProfile, resolve = resolveSeat): SeatEntry | null {
+  return persona.seat ? resolve(persona.seat) ?? null : null;
+}
+
 /** Resolve the registry mention first, then an exact display name. */
 export function resolvePersonaAddress(name: string, source: PersonaSource): PersonaProfile | null {
   const mention = resolveMention(name, source);

package/src/intake-plane/telegram-seat-work.ts

@@ -9,7 +9,7 @@ import { askSeat, parseSeatAsk, type SeatAskDeps } from '../seat-dispatch/seat-a
 import { parseSeatAddress, resolveSeat } from '../seat-address/seat-address.js';
 import { getUserConfig, type UserConfig } from '../user-config.js';
 import { answerAsSeat } from './seat-answer.js';
-import { answerAsPersona, resolvePersonaAddress, type PersonaAnswerDeps } from './persona-answer.js';
+import { answerAsPersona, resolvePersonaAddress, seatOfPersona, type PersonaAnswerDeps } from './persona-answer.js';
 import {
   submitIntakeWork,
   type SubmitIntakeWorkDeps,
@@ -66,16 +66,23 @@ export async function handleTelegramSeatWork(
   const address = parseSeatAddress(text.replace(/^(@[A-Za-z][A-Za-z0-9_-]*(?:,@?[A-Za-z][A-Za-z0-9_-]*)*)/, (prefix) => prefix.replaceAll(',@', ',')));
   if (!address) return null;
 
-  const seats = address.seats.map((name) => ({ name, seat: resolveSeat(name) }));
+  const initialSeats = address.seats.map((name) => ({ name, seat: resolveSeat(name) }));
   const names = address.seats;
   debug.log('seat-address.telegram', 'parsed', { seats: names });
-  const hasUnresolved = seats.some(({ seat }) => !seat);
+  const hasUnresolved = initialSeats.some(({ seat }) => !seat);
   const auth = hasUnresolved ? owner() : null;
   if (hasUnresolved && auth && !deps.personaSource) await awaitGlobalPersonaLoad();
   const source = hasUnresolved && auth ? (deps.personaSource ?? getGlobalPersonaRegistry()) : null;
-  const addressed = seats.map(({ name, seat }) => ({
-    name, seat, persona: !seat && source ? resolvePersonaAddress(name, source) : null,
-  }));
+  const addressed = initialSeats.map(({ name, seat }) => {
+    const persona = !seat && source ? resolvePersonaAddress(name, source) : null;
+    const personaSeat = persona ? seatOfPersona(persona) : null;
+    if (persona && personaSeat) {
+      debug.log('persona.address', 'seat-alias', { name, personaId: persona.personaId, seat: personaSeat.id, via: 'telegram' });
+      return { name: personaSeat.id, seat: personaSeat, persona: null };
+    }
+    return { name, seat, persona };
+  });
+  const seats = addressed;
   const unknown = addressed.filter(({ seat, persona }) => !seat && (!persona || !auth)).map(({ name }) => `@${name}`);
   if (unknown.length) {
     debug.log('seat-address.telegram', 'rejected', { seats: names, reason: 'unknown-seat' });