elanous 0.2.15 → 0.2.17

package/src/index.ts

@@ -27,10 +27,12 @@ import { installDevCompletionGuard } from './self-dev/dev-completion-guard.js';
 import { buildOrchestrateDecomposePrepareArgs, normalizeOrchestrateRequest, splitOrchestrateGoalTexts } from './self-dev/self-orchestrate-runtime.js';
 import { CLI_ENTRANCE_BASELINE, evaluateCommandEntranceBaseline } from './self-dev/entrance-baseline.js';
 import { CLI_HARNESS_DOGFOOD_ENTRANCE, CLI_HARNESS_ORCHESTRATE_ENTRANCE, describeEntranceCommand, listEntrancesWithModelExposure, renderLaunchEntrances, summarizeEntrances, type EntranceId } from './self-dev/entrance-registry.js';
+import { isOldDoorInternalCall, refuseOldDoor } from './self-dev/old-door.js';
 import { collectCommandEntrances, renderCommandEntrances } from './self-dev/entrance-inventory.js';
 import { isGoalAuthorFileName } from './self-implement/goal-document.js';
 import { DEV_PIPELINE_SINK_SURFACE } from './self-implement/self-cli-sink-surface.js';
 import { registerPrivateLedgerCommands } from './cli/private-ledger-commands.js';
+import { registerKnowCommand } from './cli/know-cli.js';
 import { registerSeatRequestsCommands } from './cli/seat-requests-cli.js';
 import { applyTestStateDirFlagFromArgv } from './cli/test-state-dir-flag.js';
 import { applyTestFlagFromArgv, observeTestFlagOwnership, uncoveredTestFlagPaths, staleTestFlagPaths } from './cli/test-flag.js';
@@ -53,6 +55,7 @@ export { runSchedule, scheduleCreatePlan } from './cli/schedule-cli.js';
 export type { ScheduleDispatch } from './cli/schedule-cli.js';
 import { registerReviewLoopOptions, buildReviewLoopOpts } from './agent-mission/review-loop-cli.js';
 import { registerCapabilitiesCommand } from './agent-mission/capabilities-cli.js';
+import { registerSupervisorMetricsCommand } from './agent-mission/supervisor-metrics-cli.js';
 import { agentBackendNames } from './agent-mission/driver.js';
 import { registerWhereCommand } from './cli/where-cli.js';
 import { registerShadowCommand } from './cli/shadow-cli.js';
@@ -70,6 +73,7 @@ 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';
+import { registerBriefCommands } from './cli/brief-cli.js';
 import { registerLabelsCommands } from './cli/labels-cli.js';
 import { registerMsgCommands } from './cli/msg-cli.js';
 import { registerDoctorCommand } from './cli/doctor-cli.js';
@@ -255,7 +259,7 @@ interface RunDevAskFromGoalFileDeps {
   runSayLaunchFlow: (
     sayText: string,
     entrance?: import('./self-dev/entrance-registry.js').EntranceDeclaration,
-    selection?: { readonly forcePreflight?: boolean; readonly goalType?: import('./self-implement/goal-author.js').GoalType; readonly groundingCwd?: string },
+    selection?: { readonly forcePreflight?: boolean; readonly goalType?: import('./self-implement/goal-author.js').GoalType; readonly groundingCwd?: string; readonly authorGrade?: import('./self-implement/goal-author.js').GoalAuthorGradeSelection },
   ) => Promise<RunDevAskFlowResult>;
   runAskFileLaunchFlow: (
     askPath: string,
@@ -290,7 +294,7 @@ export function assembleAskLaunchPolicy(selection: {
 async function runDefaultSayLaunchFlow(
   sayText: string,
   entrance?: import('./self-dev/entrance-registry.js').EntranceDeclaration,
-  selection: { readonly forcePreflight?: boolean; readonly goalType?: import('./self-implement/goal-author.js').GoalType; readonly groundingCwd?: string } = {},
+  selection: { readonly forcePreflight?: boolean; readonly goalType?: import('./self-implement/goal-author.js').GoalType; readonly groundingCwd?: string; readonly authorGrade?: import('./self-implement/goal-author.js').GoalAuthorGradeSelection } = {},
 ): Promise<RunDevAskFlowResult> {
   const { readFileSync, writeFileSync } = await import('node:fs');
   const [flowMod, { runGoalAuthorCli }, { relative: relativeToCwdPath }, { CLI_HARNESS_SAY_ENTRANCE }] = await Promise.all([
@@ -315,6 +319,7 @@ async function runDefaultSayLaunchFlow(
     ...assembleAskLaunchPolicy(selection),
     ...(selection.goalType === undefined ? {} : { goalType: selection.goalType }),
     ...(selection.groundingCwd === undefined ? {} : { groundingCwd: selection.groundingCwd }),
+    ...(selection.authorGrade === undefined ? {} : { authorGrade: selection.authorGrade }),
   }, {
     print: (line) => console.error(line),
     log: (event, data, level) => debug.log('dev-pipeline', event, data, { level }),
@@ -324,6 +329,9 @@ async function runDefaultSayLaunchFlow(
     cwd: () => process.cwd(),
     now: () => Date.now(),
     isInteractive: () => process.stdin.isTTY === true && process.stdout.isTTY === true,
+    // POD-SELF-ANSWER: non-TTY (Pod) authoring self-answers clarifications with the author resolver.
+    selfResolveClarification: (await import('./self-implement/goal-author-clarification.js')).defaultGoalAuthorSelfResolve,
+    writeGoalDocument: (await import('./self-implement/goal-document-write.js')).writeGoalDocumentAtomic,
     buildPreflightDeps: askIo.buildAskPreflightDeps,
     priorBlockSamples: () => askIo.priorBlockSamplesFrom(askLogRows),
     recentAuthoringSamples: () => askIo.recentAuthoringSamplesFrom(askLogRows),
@@ -372,6 +380,9 @@ async function runDefaultAskFileLaunchFlow(
     cwd: () => process.cwd(),
     now: () => Date.now(),
     isInteractive: () => process.stdin.isTTY === true && process.stdout.isTTY === true,
+    // POD-SELF-ANSWER: non-TTY (Pod) authoring self-answers clarifications with the author resolver.
+    selfResolveClarification: (await import('./self-implement/goal-author-clarification.js')).defaultGoalAuthorSelfResolve,
+    writeGoalDocument: (await import('./self-implement/goal-document-write.js')).writeGoalDocumentAtomic,
     buildPreflightDeps: askIo.buildAskPreflightDeps,
     priorBlockSamples: () => askIo.priorBlockSamplesFrom(askLogRows),
     recentAuthoringSamples: () => askIo.recentAuthoringSamplesFrom(askLogRows),
@@ -814,6 +825,7 @@ async function runDevSayFromWords(
     authoringEntrance,
     {
       ...(opts.forcePreflight === undefined ? {} : { forcePreflight: opts.forcePreflight }),
+      ...(opts.authorGrade === undefined ? {} : { authorGrade: { grade: opts.authorGrade, source: opts.authorGradeSource ?? 'flag' } }),
       ...(grounding.groundingCwd === undefined ? {} : { groundingCwd: grounding.groundingCwd }),
     },
   );
@@ -875,6 +887,7 @@ registerUsageCommand(program);
 registerLiveCommands(program);
 registerResearchCommand(program);
 registerReleaseCommands(program);
+registerKnowCommand(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.
@@ -893,24 +906,42 @@ hqCmd.command('host').description('이 머신의 HQ 호스트 이름 설정')
   });
 hqCmd.command('lease').argument('<action>', 'acquire|renew|status|release')
   .option('--host <name>', '이 호스트 이름(기본 ~/.elanous-hq/host · hq.hostName · os.hostname)')
+  .option('--expected-holder <name>', 'release CAS: 해제할 임대의 예상 소유자')
+  .option('--expected-generation <number>', 'release CAS: 해제할 임대의 예상 세대')
   .option('--json', 'JSON 출력')
-  .action(async (action: string, opts: { host?: string; json?: boolean }) => {
+  .action(async (action: string, opts: { host?: string; expectedHolder?: string; expectedGeneration?: string; json?: boolean }) => {
     try {
       if (!['acquire', 'renew', 'status', 'release'].includes(action)) throw new CliUserError(`hq lease: unknown action ${action}`, 'acquire|renew|status|release');
+      if ((opts.expectedHolder !== undefined || opts.expectedGeneration !== undefined) && action !== 'release')
+        throw new CliUserError('hq lease: expected holder/generation are only valid for release');
+      if ((opts.expectedHolder === undefined) !== (opts.expectedGeneration === undefined)
+        || (opts.expectedGeneration !== undefined && (!/^[1-9]\d*$/.test(opts.expectedGeneration) || !Number.isSafeInteger(Number(opts.expectedGeneration)))))
+        throw new CliUserError('hq lease release: supply both --expected-holder and --expected-generation (positive integer)');
       await hqSink();
       const { hqLease } = await import('./hq/hq.js');
-      const result = hqLease(action as 'acquire', {}, opts.host ? { host: opts.host } : {});
+      const result = hqLease(action as 'acquire', {}, {
+        ...(opts.host ? { host: opts.host } : {}),
+        ...(opts.expectedHolder !== undefined ? { expectedHolder: opts.expectedHolder, expectedGeneration: Number(opts.expectedGeneration) } : {}),
+      });
       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('--to <host>', '기존 임대 취득 후 승격 대상 호스트 (생략하면 mbp → node-b 전환 포함)')
+  .option('--apply', '임대 이전 및 승격 실행 · 터미널 확인 필수 (기존 --to 경로는 임대 보유 필요)')
   .option('--json', 'JSON 출력')
   .action(async (opts: { to: string; apply?: boolean; json?: boolean }) => {
     try {
+      if (!opts.to) {
+        const { transferHq, formatTransfer } = await import('./hq/transfer.js');
+        const result = transferHq('promote', opts.apply === true);
+        if (opts.json) await writeStdoutJson(`${JSON.stringify(result)}\n`);
+        else console.log(formatTransfer(result));
+        if (!result.ok) process.exitCode = 1;
+        return;
+      }
       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`);
@@ -918,6 +949,18 @@ hqCmd.command('promote').description('HQ 승격 런북 (기본 dry-run · --appl
       if (!result.ok) process.exitCode = 1;
     } catch (error) { console.error(`hq promote: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
   });
+hqCmd.command('handback').description('node-b → mbp 임대·크론 울타리 복귀 (기본 읽기 전용)')
+  .option('--apply', '각 검사를 통과한 뒤 터미널 확인을 받고 이전 실행')
+  .option('--json', '단계별 결과·저널 경로 JSON 출력')
+  .action(async (opts: { apply?: boolean; json?: boolean }) => {
+    try {
+      const { transferHq, formatTransfer } = await import('./hq/transfer.js');
+      const result = transferHq('handback', opts.apply === true);
+      if (opts.json) await writeStdoutJson(`${JSON.stringify(result)}\n`);
+      else console.log(formatTransfer(result));
+      if (!result.ok) process.exitCode = 1;
+    } catch (error) { console.error(`hq handback: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
 hqCmd.command('heartbeat').description('보유자는 갱신 · 아니면 대기(보유자에 닿는지 중재자에 보고)').option('--json', 'JSON 출력')
   .action(async (opts: { json?: boolean }) => {
     try {
@@ -942,12 +985,47 @@ hqCmd.command('seen').description('이 호스트가 본 가장 높은 임대 세
     process.exitCode = result.seen ? 0 : 3;
   });
 registerHqMovePlanCommand(hqCmd);
+const fenceWrapperCmd = hqCmd.command('fence-wrapper').description('설치본 HQ 울타리 크론 래퍼');
+fenceWrapperCmd.command('install').description('래퍼 제안 또는 백업 후 원자적 설치')
+  .option('--dry-run', '변경 내용만 출력 (기본)')
+  .option('--yes', '기존 파일 백업 후 설치')
+  .action(async (opts: { dryRun?: boolean; yes?: boolean }) => {
+    try {
+      if (opts.dryRun && opts.yes) throw new Error('--dry-run and --yes cannot be used together');
+      const { getElanousConfigDir } = await import('./elanous-config-dir.js');
+      const { installedHqFenceEntry, installHqFenceWrapper, renderHqFenceWrapper, resolveHqFenceBun } = await import('./hq/fence-wrapper.js');
+      const configDir = getElanousConfigDir();
+      const bun = resolveHqFenceBun();
+      const body = renderHqFenceWrapper({ entry: installedHqFenceEntry(), configDir, bun });
+      const result = installHqFenceWrapper(configDir, body, opts.yes === true);
+      if (opts.yes) console.log(`hq-fence installed: ${result.path} · bun: ${bun}${result.backup ? ` · backup: ${result.backup}` : ''}`);
+      else console.log(`hq-fence bun (absolute · cron has no PATH): ${bun}\n${result.preview}`);
+    } catch (error) { console.error(`hq fence-wrapper install: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
+fenceWrapperCmd.command('alert <reason>').description('HQ 울타리 실패를 기존 루프 소유자 요청 원장에 적재')
+  .action(async (reason: string) => {
+    try {
+      const { notifyOwners } = await import('./loops/checker.js');
+      const { getElanousConfigDir } = await import('./elanous-config-dir.js');
+      notifyOwners([{ id: `hq-fence:${Date.now()}:${process.pid}`, owner: 'TC', enabled: true, registered: true,
+        state: 'failing', reason }], { root: getElanousConfigDir() });
+    } catch (error) { console.error(`hq fence-wrapper alert: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
 hqCmd.command('fence-audit').description('운영 crontab 의 HQ 울타리 밖 쓰기 잡 목록과 감싼 줄 제안(읽기 전용)')
   .option('--json', 'JSON 출력')
   .action(async (opts: { json?: boolean }) => {
     try {
       await hqSink();
       const rows = (await import('./hq/fence-audit.js')).hqFenceAudit();
+      const { getElanousConfigDir } = await import('./elanous-config-dir.js');
+      const { repositoryWorktreeCdWarning } = await import('./hq/fence-wrapper.js');
+      const wrapper = _joinPath(getElanousConfigDir(), 'bin', 'hq-fence');
+      if (existsSync(wrapper)) {
+        try {
+          const warning = repositoryWorktreeCdWarning(readFileSync(wrapper, 'utf8'));
+          if (warning) console.error(warning);
+        } catch (error) { console.error(`hq fence-audit: wrapper inspection unavailable: ${error instanceof Error ? error.message : String(error)}`); }
+      }
       if (opts.json) await writeStdoutJson(`${JSON.stringify(rows)}\n`);
       else if (!rows.length) console.log('hq fence-audit: unfenced 0');
       else for (const row of rows) console.log(`${row.raw}\n  role: ${row.recommendedRole}\n  suggested: ${row.suggestedLine}`);
@@ -967,9 +1045,59 @@ registerSeatRequestsCommands(seatCmd);
 seatCmd.command('answer <askId> <answer>').description('자리 질문에 답을 남기고 원래 표면으로 회신 예약')
   .action(async (askId: string, answer: string) => {
     try {
-      const { answerSeatAsk } = await import('./seat-dispatch/seat-ask.js');
+      try { await (await import('./domains/standalone-log-sink.js')).registerStandaloneLogSink('seat-answer'); } catch { /* file trail remains available */ }
+      const { debug } = await import('./debug/log.js');
+      const { answerSeatAsk, deliverSeatAnswers, seatAskDeliveryInProgress, seatAskReplyInfo } = await import('./seat-dispatch/seat-ask.js');
       answerSeatAsk(askId, answer);
+      const { origin, askedAt, answeredAt } = seatAskReplyInfo(askId);
       console.log(`자리 답변 기록: ${askId}`);
+      if (origin.channel !== 'telegram') {
+        debug.log('seat.ask', 'reply-no-target', { id: askId, via: origin.channel });
+        console.log(`전달 대상 없음: ${askId} (${origin.channel})`);
+        return;
+      }
+      const token = process.env.TELEGRAM_BOT_TOKEN?.trim();
+      const elapsedMs = askedAt === null ? null : Math.max(0, answeredAt - askedAt);
+      if (!token) {
+        debug.log('seat.ask', 'reply-failed', { id: askId, via: 'telegram', reason: 'token-missing', elapsedMs });
+        console.log(`텔레그램 토큰 없음 (TELEGRAM_BOT_TOKEN): ${askId} · 회신 대기`);
+        return;
+      }
+      const botId = token.split(':')[0];
+      if (origin.botId && origin.botId !== botId) {
+        debug.log('seat.ask', 'reply-no-target', { id: askId, via: 'telegram', reason: 'bot-mismatch' });
+        console.log(`전달 대상 없음: ${askId} (수신 봇 불일치) · 회신 대기`);
+        return;
+      }
+      try {
+        let sent = false;
+        await deliverSeatAnswers({ askId, channel: 'telegram', botId, send: async (target, text) => {
+          if (target.channel !== 'telegram') throw new Error('seat ask belongs to another surface');
+          const response = await fetch(`https://api.telegram.org/bot${token}/sendMessage`, {
+            method: 'POST', headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ chat_id: target.chatId, text, reply_to_message_id: target.messageId,
+              ...(target.threadId === undefined ? {} : { message_thread_id: target.threadId }) }),
+          });
+          const result = await response.json() as { ok?: boolean; description?: string };
+          if (!response.ok || result.ok !== true) throw new Error(result.description ?? `Telegram HTTP ${response.status}`);
+          sent = true;
+        } });
+        if (!sent) {
+          if (seatAskDeliveryInProgress(askId)) {
+            debug.log('seat.ask', 'reply-in-progress', { id: askId, via: 'telegram', reason: 'claimed-by-other-worker' });
+            console.log(`다른 작업자가 전달 중: ${askId}`);
+          } else {
+            debug.log('seat.ask', 'reply-no-target', { id: askId, via: 'telegram', reason: 'not-claimed' });
+            console.log(`전달 대상 없음: ${askId} (회신 대기)`);
+          }
+          return;
+        }
+        debug.log('seat.ask', 'reply-sent', { id: askId, via: 'telegram', elapsedMs });
+        console.log(`텔레그램 회신 전달: ${askId} · 지연 ${elapsedMs === null ? '미상' : `${elapsedMs}ms`}`);
+      } catch (error) {
+        debug.log('seat.ask', 'reply-failed', { id: askId, via: 'telegram', reason: error instanceof Error ? error.message : String(error), elapsedMs });
+        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')
@@ -1170,7 +1298,7 @@ pythonCmd.command('setup').description('elanous venv(~/.local/share/elanous/pyth
 
 program.command('self-update')
   .alias('update')
-  .description('설치본은 릴리스로, 체크아웃은 깨끗한 체크아웃으로 갱신하고 승인 시 넥서스 재시작 · `elanous update` 와 같다 · `--auto on` 이면 매일 자동')
+  .description('설치본은 릴리스로, 체크아웃은 깨끗한 체크아웃으로 갱신 · --auto 는 캐너리 자동 판단, --auto on|off|status 는 기존 자동 갱신 서비스 관리')
   .option('--from <checkout>', '설치할 체크아웃 (기본: 설치본은 릴리스, 체크아웃은 현재 체크아웃)')
   .option('--version <version>', '설치본에서 지정한 릴리스 버전 설치 (기본: latest)')
   .option('--restart', '넥서스 재시작 승인')
@@ -1178,9 +1306,15 @@ program.command('self-update')
   .option('--keep <n>', '설치 뒤 남길 최근 판 수(설치본은 current·직전 판, 체크아웃은 current·데몬 판 보호 · 0 이면 정리 안 함)', '3')
   .option('--alert', '실패(exit≠0)를 알림으로도 보냄 — 크론(무인) 실행용')
   .option('--skip-pwa-build', '체크아웃 설치 전 PWA 빌드를 명시적으로 건너뜀')
-  .option('--auto <on|off|status>', '자동 갱신 — macOS launchd · Linux systemd 타이머가 매일 04:17 에 `self-update --restart --alert` (크론이 이미 부르면 켜지 않는다)')
-  .action(async (opts: { from?: string; version?: string; restart?: boolean; json?: boolean; keep?: string; alert?: boolean; skipPwaBuild?: boolean; auto?: string }) => {
-    if (opts.auto !== undefined) {
+  .option('--dev', '판 사이 dev 빌드 설치 — versions/<판>-dev.<sha12> · install.json channel=dev · 이전 versionDir 보존 (사람 승인 · 자동 아님)')
+  .option('--rollback', 'install.json 의 이전 versionDir 로 current 를 되돌린다 (이전이 없으면 거부)')
+  .option('--auto [on|off|status]', '인자 없이: 에지 레일 계획/실행 · on|off|status: 기존 자동 갱신 서비스 관리')
+  .option('--dry-run', '에지 레일 계획만 출력; 설치·되돌림·상태 쓰기 없음')
+  .option('--seat <seat>', '에지 레일 자리 (OP|TC|MK|UX)')
+  .option('--quiet-window', '상주 프로세스 재시작이 가능한 조용한 창이라고 명시')
+  .option('--canary-run-id <id>', '캐너리 성공 런의 고유 ID (독립 검증된 성공 런에서만 입력; 같은 ID 는 중복 적중하지 않음)')
+  .action(async (opts: { from?: string; version?: string; restart?: boolean; json?: boolean; keep?: string; alert?: boolean; skipPwaBuild?: boolean; dev?: boolean; rollback?: boolean; auto?: string | boolean; dryRun?: boolean; seat?: string; quietWindow?: boolean; canaryRunId?: string }) => {
+    if (typeof opts.auto === 'string') {
       if (!['on', 'off', 'status'].includes(opts.auto)) { console.error(`--auto 는 on · off · status 중 하나: ${opts.auto}`); process.exitCode = 2; return; }
       const { runAutoUpdate } = await import('./cli/update-auto.js');
       process.exitCode = (await runAutoUpdate(opts.auto as 'on' | 'off' | 'status')).exitCode;
@@ -1188,9 +1322,9 @@ program.command('self-update')
     }
     const { runUpdateForInstallation } = await import('./cli/self-update.js');
     // ⭐ 한 번 도는 CLI 는 logs.db 싱크를 스스로 붙여야 `debug.log('self-update', …)` 가 저장된다(없으면 조용히 사라진다 · 09-24 실측).
-    try { const { registerStandaloneLogSink } = await import('./domains/standalone-log-sink.js'); await registerStandaloneLogSink('self-update'); } catch { /* 관측 실패가 갱신을 막지 않는다 */ }
+    if (!opts.dryRun) try { const { registerStandaloneLogSink } = await import('./domains/standalone-log-sink.js'); await registerStandaloneLogSink('self-update'); } catch { /* 관측 실패가 갱신을 막지 않는다 */ }
     const keep = Number.parseInt(opts.keep ?? '3', 10);
-    const result = await runUpdateForInstallation({ ...opts, skipPwaBuild: opts.skipPwaBuild, keep: Number.isFinite(keep) ? keep : 3 }, { cliRoot: REPOSITORY_ROOT });
+    const result = await runUpdateForInstallation({ ...opts, auto: opts.auto === true, quietWindow: opts.quietWindow === true, skipPwaBuild: opts.skipPwaBuild, keep: Number.isFinite(keep) ? keep : 3 }, { cliRoot: REPOSITORY_ROOT });
     process.exitCode = result.exitCode;
   });
 
@@ -4259,6 +4393,12 @@ selfCmd
   .option('--supervise-rounds <n>', '슈퍼바이저 재개 라운드 상한 (기본 3 · 끄려면 --no-supervise)')
   .option('--json', '구조화 출력 {stage, ok, branch, worktree, prUrl?, merged?}')
   .action(async (parts: string[], opts: { featureFile?: string; base?: string; draft?: boolean; openPr?: boolean; autoMerge?: boolean; autoReview?: boolean; maxWait?: string; json?: boolean; plan?: boolean; enhance?: boolean; ground?: boolean; observeOnly?: boolean }) => {
+    if (!isOldDoorInternalCall('self-implement')) {
+      const refused = refuseOldDoor('self-implement');
+      debug.log('harness.entrance', 'old-door-refused', { door: refused.door, caller: refused.caller });
+      ui.error(refused.message);
+      process.exit(refused.exitCode);
+    }
     if (opts.featureFile && parts.length > 0) { ui.error('--feature-file 과 위치 인자 feature 는 함께 줄 수 없다'); process.exit(2); }
     let feature: string;
     try { feature = (opts.featureFile ? readFileSync(opts.featureFile, 'utf8') : parts.join(' ')).trim(); }
@@ -4418,6 +4558,12 @@ const selfOrchestrateCmd = selfCmd
   .option('--help-all', '모든 orchestrate 옵션 표시')
   .action(function (this: Command, parts: string[], opts: { goalFile?: string[]; concurrency?: string; autoMerge?: boolean; autoReview?: boolean; openPr?: boolean; base?: string; teardown?: boolean; resume?: string; board?: boolean; decompose?: boolean; fabricDecompose?: boolean; maxTasks?: string; supervise?: boolean; superviseRounds?: string; json?: boolean }) {
     return (async () => {
+    if (!isOldDoorInternalCall('self-orchestrate')) {
+      const refused = refuseOldDoor('self-orchestrate');
+      debug.log('harness.entrance', 'old-door-refused', { door: refused.door, caller: refused.caller });
+      ui.error(refused.message);
+      process.exit(refused.exitCode);
+    }
     // 위치 인자는 종전처럼 분리하고 파일 입력은 파일당 한 골이다.
     let inputGoals: ReturnType<typeof readSelfOrchestrateGoals>;
     try { inputGoals = readSelfOrchestrateGoals(parts, opts.goalFile); }
@@ -5943,6 +6089,7 @@ agentCmd.hook('preAction', async (_thisCommand, actionCommand) => {
 });
 
 registerCapabilitiesCommand(agentCmd);
+registerSupervisorMetricsCommand(agentCmd);
 
 agentCmd.command('install-from-docs <tool>')
   .description('공식 설치 문서를 읽고 안전한 설치 줄을 선택한다 — sudo는 사람에게 넘긴다')
@@ -6814,6 +6961,11 @@ const selfDevCmd = program
       // ⭐ `--ask`/`--say` — 발사 절차 넷을 «한 로직»으로. 저작 → 전제 검사 → 발사.
       //   ⛔ 여기서 저작한 골 파일을 아래 `--file` 자리에 그대로 넘긴다(새 실행 경로를 만들지 않는다).
       let askAuthoredFile: string | undefined;
+      if (opts.ask !== undefined && !isOldDoorInternalCall('dev-ask')) {
+        const refused = refuseOldDoor('dev-ask');
+        debug.log('harness.entrance', 'old-door-refused', { door: refused.door, caller: refused.caller });
+        throw new DevPipelineError(refused.message);
+      }
       const retirementInput = opts.ask !== undefined
         ? { kind: 'ask' as const, value: opts.ask }
         : opts.say !== undefined
@@ -6896,6 +7048,8 @@ const selfDevCmd = program
           now: () => Date.now(),
           // ⛔ 「대화형인가」는 «두 쪽»을 본다 — 파이프로 몰면 물어도 답이 안 온다.
           isInteractive: () => process.stdin.isTTY === true && process.stdout.isTTY === true,
+          selfResolveClarification: (await import('./self-implement/goal-author-clarification.js')).defaultGoalAuthorSelfResolve,
+          writeGoalDocument: (await import('./self-implement/goal-document-write.js')).writeGoalDocumentAtomic,
           buildPreflightDeps: buildAskPreflightDeps,
           priorBlockSamples: () => askIo.priorBlockSamplesFrom(askLogRows),
           recentAuthoringSamples: () => askIo.recentAuthoringSamplesFrom(askLogRows),
@@ -7538,6 +7692,7 @@ missionCmd
   });
 
 registerTasksCommands(program);
+registerBriefCommands(program);
 registerLabelsCommands(program);
 registerMsgCommands(program);
 

package/src/intake-plane/digest.ts

@@ -6,8 +6,9 @@ import { loadIntakeLedger, type IntakeItem } from './items.js';
 import { readSavedCursorAt } from './collect-telegram-saved.js';
 import { intakeOutboxDir, kstDay } from './route.js';
 
-export interface DigestEntry { id: string; sources: string[]; url?: string; note?: string; noteName?: string; oneLiner?: string; axis: string; impact?: { fact: string; current: string; action: string } }
-export interface IntakeDigest { day: string; absorbed: DigestEntry[]; goals: { fact: string; url?: string }[]; review?: { fact: string; note?: string }[]; grounding: number; release: number; manual: number; savedSilence?: { days: number; lastNewAt: string } }
+export type DigestLensVerdict = '대체 후보' | '보강' | '경쟁 대조';
+export interface DigestEntry { id: string; sources: string[]; url?: string; note?: string; noteName?: string; oneLiner?: string; axis: string; impact?: { verdict: DigestLensVerdict; why: string; target: string } }
+export interface IntakeDigest { day: string; absorbed: DigestEntry[]; goals: { fact: string; url?: string }[]; news?: { title: string; url: string; summary: string[]; implication: string[] }[]; shadowSuggestions?: { fact: string; url?: string; verdict: string }[]; review?: { fact: string; note?: string }[]; grounding: number; release: number; manual: number; savedSilence?: { days: number; lastNewAt: string } }
 
 const AXIS_LABEL: Record<string, string> = {
   video_automation: '영상 자동화', agent_basics: '에이전트 기본', agent_applied: '에이전트 응용', unrelated: '그 밖',
@@ -40,27 +41,32 @@ function readJsonl(file: string): Record<string, unknown>[] {
 /** Saved Messages silent for more than two days → the digest says so (a quiet 0 must not look like «nothing to do»). */
 const SAVED_SILENCE_MS = 48 * 3600_000;
 
+/** A «why» that only names paths (optionally behind a label like «경로:») is evidence, not a reason for us. */
+export function pathOnly(why: string): boolean {
+  const rest = why
+    .replace(/`?(?:[\w.-]+\/)*[\w.-]+\.[A-Za-z0-9]{1,6}(?::\d+)?`?/g, ' ')
+    .replace(/`?(?:[\w.-]+\/)+[\w.-]*`?/g, ' ')
+    .replace(/(?:경로|파일|근거|path|file|evidence)\s*[:：]?/gi, ' ')
+    .replace(/[\s,·:;()[\]\-–—]+/g, '');
+  return rest.length < 4;
+}
+
 export function buildIntakeDigest(root: string, day: string, readFile: (p: string) => string | undefined = (p) => (existsSync(p) ? readFileSync(p, 'utf8') : undefined), now: Date = new Date()): IntakeDigest {
   const items = [...loadIntakeLedger(root).items.values()]
     .filter((i) => (i.status === 'absorbed' || i.status === 'routed') && kstDay(i.lastSeenAt) === day && i.outputs.some((o) => o.kind === 'note'));
   const out = intakeOutboxDir(root);
   const relevant = new Map<string, NonNullable<DigestEntry['impact']>>();
-  for (const [folder, action] of [
-    ['goals', '없는 기능의 골 후보를 세운다'],
-    ['manual', '문서·약속을 현재 동작에 맞게 보강한다'],
-    ['review', '대조 근거를 추가로 확인한다'],
-    ['release', '이미 착지한 기능의 바깥 맥락을 릴리스 노트에 반영한다'],
-  ] as const) {
+  // The lens (src/intake-plane/lens.ts) writes its verdicts to outbox/lens/<day>.jsonl; route folders carry none.
+  for (const folder of ['lens'] as const) {
     for (const row of readJsonl(join(out, folder, `${day}.jsonl`))) {
       if (typeof row.id !== 'string' || relevant.has(row.id)) continue;
-      const fact = folder === 'release' ? row.title : row.fact;
-      if (typeof fact !== 'string' || !fact.trim()) continue;
-      relevant.set(row.id, {
-        fact,
-        current: typeof (folder === 'release' ? row.summary : row.current) === 'string'
-          ? String(folder === 'release' ? row.summary : row.current) : '대조 근거 없음',
-        action,
-      });
+      const verdict = row.lensVerdict;
+      if (verdict !== '대체 후보' && verdict !== '보강' && verdict !== '경쟁 대조') continue;
+      const why = typeof row.why === 'string' ? row.why.trim() : '';
+      const target = typeof row.target === 'string' ? row.target.trim() : '';
+      // A check's fact/current or repo path is evidence, not a lens judgement or a reason for us.
+      if (!why || !target || pathOnly(why)) continue;
+      relevant.set(row.id, { verdict, why, target });
     }
   }
   const absorbed = items.map((i: IntakeItem): DigestEntry => {
@@ -76,12 +82,24 @@ export function buildIntakeDigest(root: string, day: string, readFile: (p: strin
     };
   });
   const goals = readJsonl(join(out, 'goals', `${day}.jsonl`)).map((g) => ({ fact: String(g.fact ?? ''), ...(g.url ? { url: String(g.url) } : {}) }));
+  const lensRows = readJsonl(join(out, 'lens', `${day}.jsonl`));
+  const news = lensRows.flatMap((row) =>
+    typeof row.title === 'string' && typeof row.url === 'string' && Array.isArray(row.summary) && Array.isArray(row.implication)
+      ? [{ title: row.title, url: row.url, summary: row.summary.filter((s): s is string => typeof s === 'string'), implication: row.implication.filter((s): s is string => typeof s === 'string') }]
+      : []);
+  const shadowSuggestions = lensRows.flatMap((row) =>
+    Array.isArray(row.suggestions) ? row.suggestions.flatMap((raw: unknown) => {
+      if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return [];
+      const suggestion = raw as Record<string, unknown>;
+      if (suggestion.status !== '제안' || typeof suggestion.fact !== 'string' || !suggestion.fact.trim()) return [];
+      return [{ fact: suggestion.fact, ...(typeof row.url === 'string' ? { url: row.url } : {}), verdict: typeof suggestion.verdict === 'string' ? suggestion.verdict : '판단 필요' }];
+    }) : []);
   const review = readJsonl(join(out, 'review', `${day}.jsonl`)).map((r) => ({ fact: String(r.fact ?? ''), ...(r.note ? { note: String(r.note) } : {}) }));
   const grounding = readJsonl(join(out, 'grounding.jsonl')).filter((g) => typeof g.at === 'string' && kstDay(g.at) === day).length;
   const lastNewAt = readSavedCursorAt(root);
   const silentMs = lastNewAt ? now.getTime() - Date.parse(lastNewAt) : NaN;
   return {
-    day, absorbed, goals, review, grounding,
+    day, absorbed, goals, ...(news.length ? { news } : {}), ...(shadowSuggestions.length ? { shadowSuggestions } : {}), review, grounding,
     release: readJsonl(join(out, 'release', `${day}.jsonl`)).length,
     manual: readJsonl(join(out, 'manual', `${day}.jsonl`)).length,
     ...(lastNewAt && silentMs > SAVED_SILENCE_MS ? { savedSilence: { days: Math.floor(silentMs / 86_400_000), lastNewAt } } : {}),
@@ -92,7 +110,8 @@ export function buildIntakeDigest(root: string, day: string, readFile: (p: strin
 export function renderDigestMarkdown(d: IntakeDigest): string {
   const L: string[] = [`## 📰 오늘의 흡수 요약 (${d.absorbed.length})`, ''];
   if (d.savedSilence) L.push(`> ⚠️ 텔레그램 «저장된 메시지»에서 새 글을 ${d.savedSilence.days}일째 못 받았다(마지막 새 글 수집 ${kstDay(d.savedSilence.lastNewAt)}) — 저장했는데 안 들어왔다면 저장한 곳(본인 «저장된 메시지»인지)을 확인한다.`, '');
-  if (!d.absorbed.length) { L.push('오늘 흡수한 것이 없다.', ''); return L.join('\n'); }
+  if (!d.absorbed.length) L.push('오늘 흡수한 것이 없다.', '');
+  if (!d.absorbed.length && !d.news?.length) return L.join('\n');
   const byAxis = new Map<string, DigestEntry[]>();
   for (const e of d.absorbed) (byAxis.get(e.axis) ?? byAxis.set(e.axis, []).get(e.axis)!).push(e);
   for (const [axis, rows] of byAxis) {
@@ -100,34 +119,72 @@ export function renderDigestMarkdown(d: IntakeDigest): string {
     for (const e of rows) L.push(`- ${e.noteName ? `[[${e.noteName}]]` : e.url ?? e.id} — ${e.oneLiner ?? '(요약 줄 없음)'}`);
     L.push('');
   }
+  if (d.news?.length) {
+    L.push(`### 📰 관심 뉴스 (${d.news.length})`, '');
+    for (const article of d.news.slice(0, 10)) {
+      L.push(`- [${article.title}](${article.url})`);
+      for (const line of article.summary) L.push(`  - ${line}`);
+      for (const line of article.implication) L.push(`  - 엘라누스 함의: ${line}`);
+    }
+    L.push('');
+  }
   if (d.goals.length) {
     L.push(`### 🔴 엘라누스에 없는 것 — 골 후보 (${d.goals.length})`, '');
     for (const g of d.goals.slice(0, 10)) L.push(`- ${g.fact}${g.url ? ` · [원본](${g.url})` : ''}`);
     L.push('');
   }
-  if (d.review?.length) {
-    L.push(`### 🟡 사람이 가를 것 — 판단 필요 (${d.review.length})`, '', '> 근거가 실행 코드에 닿지만 «같은 것인가»는 결정론으로 못 가른다 — 노트의 🧭 절에서 판단한다.', '');
-    for (const r of d.review.slice(0, 10)) L.push(`- ${r.fact}${r.note ? ` · [[${basename(r.note, '.md')}]]` : ''}`);
-    if (d.review.length > 10) L.push(`- … 외 ${d.review.length - 10}건`);
+  if (d.shadowSuggestions?.length) {
+    L.push(`### 📰 뉴스 칸 제안 — 그림자, 판 미등록 (${d.shadowSuggestions.length})`, '');
+    for (const s of d.shadowSuggestions.slice(0, 10)) L.push(`- [${s.verdict}] ${s.fact}${s.url ? ` · [원본](${s.url})` : ''}`);
     L.push('');
   }
+  const undecided = d.absorbed.filter((e) => !e.impact).length;
+  if (undecided) L.push(`렌즈 판정 못 함 ${undecided} — 원장 \`elanous intake items\``, '');
   L.push(`> 매뉴얼 후보 ${d.manual} · 릴리스 노트 맥락 ${d.release} · 그라운딩 후보 ${d.grounding} — 흡수 원장 \`elanous intake items\` · 큐 \`<인스턴스>/intake/outbox/\``, '');
   return L.join('\n');
 }
 
 /** 텔레그램 — 흡수 렌즈가 대조한 항목만 SCQA 짧은 판으로 낸다. */
 export function renderDigestTelegram(d: IntakeDigest, _opts: { vaultRoot?: string; notePath?: string } = {}): string {
+  // «Touching» is decided by the lens verdict alone; a missing note summary only changes how S reads (ACP must-fix).
   const touching = d.absorbed.filter((e) => e.impact);
   const L = [`흡수 ${d.absorbed.length} → 우리에게 닿는 것 ${touching.length}`];
-  if (!touching.length) return L[0];
-  for (const e of touching.slice(0, 3)) {
+  // 관심 뉴스는 최대 셋 — 기사마다 S(요약 첫 줄) · A(엘라누스 함의 첫 줄) · 링크를 한 덩어리로(NEWS-INTAKE).
+  for (const article of (d.news ?? []).slice(0, 3)) {
+    L.push(`📰 ${article.title}`);
+    if (article.summary[0]) L.push(`S: ${article.summary[0]}`);
+    if (article.implication[0]) L.push(`A: ${article.implication[0]}`);
+    L.push(article.url);
+  }
+  if (d.shadowSuggestions?.length) L.push(`뉴스 칸 제안 ${d.shadowSuggestions.length}건 (그림자·판 미등록): ${d.shadowSuggestions.slice(0, 3).map((s) => `[${s.verdict}] ${s.fact}${s.url ? ` ${s.url}` : ''}`).join(' · ')}`);
+  if (!touching.length) return L.join('\n');
+  // At most three items are shown, each as its own S·C·A·link block so context and source stay paired;
+  // a later item sharing (verdict, target) says «위와 같은 행동» instead of repeating the A sentence (ACP must-fix).
+  // S must be the note's own summary: items without one still count as touching but are not shown (ACP must-fix).
+  const shownItems = touching.filter((e) => e.oneLiner?.trim()).slice(0, 3);
+  const actionSeen = new Set<string>();
+  const actionsUsed = new Set<string>();
+  for (const e of shownItems) {
+    const impact = e.impact!;
+    const key = `${impact.verdict}\u0000${impact.target}`;
+    const base = impact.verdict === '대체 후보' ? `${impact.target} lite Pod 실증 제안`
+      : impact.verdict === '보강' ? `칸 ${impact.target} 에 근거 추가`
+        : `${impact.target} 비교표 갱신`;
+    // Every item keeps its own concrete action; a repeat of (verdict, target) names which item it is, so no two A lines match.
+    const label = (e.oneLiner?.trim() || impact.why).slice(0, 24);
+    let action = actionSeen.has(key) ? `${base} — «${label}» 근거로` : base;
+    // Two identical labels still differ by their position in the list.
+    if (actionsUsed.has(action)) action = `${action} (${shownItems.indexOf(e) + 1})`;
+    actionsUsed.add(action);
+    actionSeen.add(key);
     L.push('',
-      `S 무엇: ${e.impact!.fact}`,
-      `C 우리에게 왜: ${e.impact!.current}`,
-      `A 그래서 무엇을 하나: ${e.impact!.action}`,
+      `S 무엇: ${e.oneLiner?.trim() || '노트 한 줄 요약 없음'}`,
+      `C 우리에게 왜: ${impact.why}`,
+      `A 그래서 무엇을 하나: ${action}`,
       `🔗 원문 링크: ${e.url?.trim() || '링크 없음'}`,
     );
   }
-  if (d.absorbed.length > touching.length) L.push('', `그 밖 ${d.absorbed.length - touching.length}건 · 닿지 않음`);
+  if (touching.length > shownItems.length) L.push('', `닿는 것 ${touching.length - shownItems.length}건 더(요약 없는 것 포함) · 원장 \`elanous intake items\``);
+  if (d.absorbed.length > touching.length) L.push('', `그 밖 ${d.absorbed.length - touching.length}건 · 참고`);
   return L.join('\n');
 }