elanous 0.2.16 → 0.2.18

package/src/index.ts

@@ -74,6 +74,7 @@ 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 { registerNotifyCommand } from './cli/notify-cli.js';
 import { registerLabelsCommands } from './cli/labels-cli.js';
 import { registerMsgCommands } from './cli/msg-cli.js';
 import { registerDoctorCommand } from './cli/doctor-cli.js';
@@ -135,6 +136,7 @@ import type { ReviewResult } from './agent-substrate/pr-reviewer.js';
 import type { ReviewVerdict } from './agent-mission/review-loop.js';
 import type { SyncMode } from './types.js';
 import { runOnboarding, runOnboardingStep, runOnboardingNonInteractive, needsOnboarding, needsFirstRun, handleOnboardingRefusal, type OnboardingStepId } from './onboarding.js';
+import { firstChatGate } from './onboarding/first-chat-gate.js';
 import {
   getUserConfig, reloadUserConfig, userConfigPath, saveUserConfig,
   backupUserConfig, backupConfigPath, addRotationEntry, type RotationEntry,
@@ -259,7 +261,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,
@@ -294,7 +296,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([
@@ -319,6 +321,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 }),
@@ -328,6 +331,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),
@@ -376,6 +382,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),
@@ -818,6 +827,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 }),
     },
   );
@@ -880,6 +890,7 @@ registerLiveCommands(program);
 registerResearchCommand(program);
 registerReleaseCommands(program);
 registerKnowCommand(program);
+registerNotifyCommand(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.
@@ -977,12 +988,78 @@ hqCmd.command('seen').description('이 호스트가 본 가장 높은 임대 세
     process.exitCode = result.seen ? 0 : 3;
   });
 registerHqMovePlanCommand(hqCmd);
+hqCmd.command('init').description('한 저장소의 bare 미러와 집 원장을 만들고 5분 fetch 크론 줄만 출력')
+  .option('--root <dir>', 'HQ 폴더 (기본 ~/elanous-hq)')
+  .action(async (opts: { root?: string }) => {
+    try {
+      const { hqInit } = await import('./hq/seats.js');
+      const { getElanousConfigDir } = await import('./elanous-config-dir.js');
+      const result = hqInit({ ...opts, home: getElanousConfigDir() });
+      console.log(`hq init: ${result.created ? 'created' : 'already exists'} ${result.root}\n# OP installs this line; nothing was installed:\n${result.cron}`);
+    } catch (error) { console.error(`hq init: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
+hqCmd.command('seat <role>').description('OP|MK|TC|UX 자리 워크트리 (깨끗할 때만 갱신)')
+  .option('--refresh', 'origin/main으로 깨끗한 자리만 최신화')
+  .option('--root <dir>', 'HQ 폴더')
+  .action(async (role: string, opts: { refresh?: boolean; root?: string }) => {
+    try {
+      const { hqSeat } = await import('./hq/seats.js');
+      const result = hqSeat(role, opts);
+      if (result.outcome === 'dirty') console.warn(`hq seat ${role}: dirty — refresh skipped; move edits to hq work new`);
+      else console.log(`hq seat ${role}: ${result.outcome} ${result.path}`);
+    } catch (error) { console.error(`hq seat: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
+const hqWorkCmd = hqCmd.command('work').description('고칠 때만 작업 워크트리를 만들고 병합 후 회수');
+for (const action of ['new', 'done'] as const) hqWorkCmd.command(`${action} <role> <name>`)
+  .option('--root <dir>', 'HQ 폴더')
+  .action(async (role: string, name: string, opts: { root?: string }) => {
+    try {
+      const { hqWork } = await import('./hq/seats.js');
+      const result = hqWork(action, role, name, opts);
+      console.log(`hq work ${action}: ${result.outcome} ${result.path}`);
+    } catch (error) { console.error(`hq work ${action}: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
+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}`);
@@ -999,6 +1076,40 @@ hqCmd.command('fence').description('이 호스트가 임대를 쥐었을 때만
   });
 const seatCmd = program.command('seat').description('분배된 자리의 하루 루프와 보고');
 registerSeatRequestsCommands(seatCmd);
+seatCmd.command('asks').description('최근 CTO 되묻기 왕복과 10분 판정')
+  .option('--since <duration>', '조회 창 (예: 24h)', '24h')
+  .option('--json', 'JSON 출력')
+  .action(async (opts: { since: string; json?: boolean }) => {
+    try {
+      const duration = /^(\d+)([mhd])$/.exec(opts.since);
+      if (!duration || !Number.isSafeInteger(Number(duration[1]))) throw new Error('--since: 24h, 30m, 7d 형식 필요');
+      const ms = Number(duration[1]) * ({ m: 60_000, h: 3_600_000, d: 86_400_000 }[duration[2]!] ?? 0);
+      if (!Number.isSafeInteger(ms) || ms <= 0) throw new Error('--since: 양의 시간 필요');
+      const { defaultMsgStorePath } = await import('./msg/msg-store.js');
+      const path = defaultMsgStorePath();
+      if (!(await import('node:fs')).existsSync(path)) {
+        if (opts.json) await writeStdoutJson('[]\n');
+        else console.log(`원장 없음 — ${path}`);
+        return;
+      }
+      const { listSeatAskRoundTrips } = await import('./seat-dispatch/seat-ask.js');
+      const now = Date.now();
+      const rows = listSeatAskRoundTrips({ since: now - ms, now });
+      if (!rows.length) {
+        if (opts.json) await writeStdoutJson('[]\n');
+        else console.log('이 창에 되묻기 0건');
+        return;
+      }
+      if (opts.json) { await writeStdoutJson(`${JSON.stringify(rows)}\n`); return; }
+      const clock = (value: number | null) => value === null ? '-' : new Intl.DateTimeFormat('ko-KR', {
+        timeZone: 'Asia/Seoul', hour: '2-digit', minute: '2-digit', hourCycle: 'h23',
+      }).format(value);
+      console.log('id · 표면 · 물음 HH:MM KST · 답 · 도착 · 왕복 분 · 판정');
+      for (const row of rows) console.log(`${row.id} · ${row.surface} · ${clock(row.askedAt)} KST · ${clock(row.answeredAt)} · ${clock(row.deliveredAt)} · ${row.roundTripMs === null ? '-' : (row.roundTripMs / 60_000).toFixed(1)}분 · ${row.verdict}`);
+      const count = (verdict: string) => rows.filter(row => row.verdict === verdict).length;
+      console.log(`10분 안 ${count('10분 안')} / 넘음 ${count('10분 넘음')} / 미답 ${count('미답')} / 대기 ${count('답 대기') + count('전달 대기')} / 미상 ${count('시각 미상')}`);
+    } catch (error) { console.error(`seat asks: ${error instanceof Error ? error.message : String(error)}`); process.exitCode = 1; }
+  });
 seatCmd.command('answer <askId> <answer>').description('자리 질문에 답을 남기고 원래 표면으로 회신 예약')
   .action(async (askId: string, answer: string) => {
     try {
@@ -1255,7 +1366,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', '넥서스 재시작 승인')
@@ -1265,9 +1376,13 @@ program.command('self-update')
   .option('--skip-pwa-build', '체크아웃 설치 전 PWA 빌드를 명시적으로 건너뜀')
   .option('--dev', '판 사이 dev 빌드 설치 — versions/<판>-dev.<sha12> · install.json channel=dev · 이전 versionDir 보존 (사람 승인 · 자동 아님)')
   .option('--rollback', 'install.json 의 이전 versionDir 로 current 를 되돌린다 (이전이 없으면 거부)')
-  .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; dev?: boolean; rollback?: boolean; auto?: string }) => {
-    if (opts.auto !== undefined) {
+  .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;
@@ -1275,9 +1390,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;
   });
 
@@ -3252,11 +3367,20 @@ contextCmd.command('day')
   .description('자리 넷과 외부 세션의 최근 맥락 이벤트 수·마지막 시각 (읽기 전용)')
   .option('--since <hours>', '최근 시간 창 (예: 24h)', '24h')
   .option('--json', '구조화된 JSON 출력')
-  .action(async (opts: { since: string; json?: boolean }) => {
+  .option('--timeline', '시간순 사건 한 줄씩 (KST)')
+  .option('--seat <source>', '한 출처만 (OP|TC|MK|UX|claude-code|codex-agent-mission|harness-child)')
+  .action(async (opts: { since: string; json?: boolean; timeline?: boolean; seat?: string }) => {
     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`);
+      const { contextDay, contextDayTimeline, renderContextDay, renderContextDayTimeline, CONTEXT_DAY_SOURCES } = await import('./context-bus/context-day.js');
+      if (opts.seat && !CONTEXT_DAY_SOURCES.some(source => source === opts.seat)) throw new Error(`unknown --seat: ${opts.seat}`);
+      if (opts.seat && !opts.timeline) throw new Error('--seat requires --timeline');
+      if (opts.timeline) {
+        const report = contextDayTimeline(opts.since, { seat: opts.seat as typeof CONTEXT_DAY_SOURCES[number] | undefined });
+        await writeStdoutJson(`${opts.json ? JSON.stringify(report) : renderContextDayTimeline(report)}\n`);
+      } else {
+        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;
@@ -4290,16 +4414,52 @@ selfCmd
   .option('--base <ref>', '커밋됐지만 PR 없는 변경의 비교 기준(ref...HEAD)')
   .option('--pr <number>', '열린 PR 번호에서 gh pr view files로 변경 파일을 읽는다')
   .option('--shards [number]', '메모리 예산에 맞춰 시험을 별도 프로세스로 분할한다 (기본 2)')
-  .action((opts: { changed?: boolean; base?: string; pr?: string; shards?: string | boolean }) => {
+  .option('--remote [host]', 'GATE-REMOTE — 같은 커밋을 원격 호스트(기본 config gateRemote.host=node-b)에서 돌리고 결과만 가져온다(깨끗한 트리 · --pr 은 로컬)')
+  .option('--local', '원격 자동 분배(로컬 1분 부하 > gateRemote.loadThreshold=20)를 끄고 로컬에서 돌린다')
+  .action(async (opts: { changed?: boolean; base?: string; pr?: string; shards?: string | boolean; remote?: string | boolean; local?: boolean }) => {
     if (!opts.changed && opts.shards === undefined) { ui.error('self gate requires --changed or --shards'); process.exitCode = 2; return; }
+    // The root strips `--local` from argv anywhere (remote-bookmark attach · src/cli/remote-resolve.ts) before Commander
+    // sees it, so this subcommand reads it from the untouched process.argv.
+    opts.local = !!opts.local || process.argv.slice(2).includes('--local');
+    if (opts.remote !== undefined && opts.local) { ui.error('self gate: --remote and --local cannot be combined'); process.exitCode = 2; return; }
+    if (typeof opts.remote === 'string') {
+      const { isValidGateHost } = await import('./self-implement/gate-remote.js');
+      if (!isValidGateHost(opts.remote)) { ui.error(`self gate: invalid --remote host: ${opts.remote}`); process.exitCode = 2; return; }
+    }
+    const shards = opts.shards === undefined ? undefined : opts.shards === true ? 2 : Number(opts.shards);
+    const runLocal = () => {
+      try {
+        const { runSelfGateCli } = require('./self-implement/gate-cli.js') as typeof import('./self-implement/gate-cli.js');
+        const result = runSelfGateCli(process.cwd(), { base: opts.base, pr: opts.pr, shards });
+        console.log(result.lines.join('\n'));
+        return result.exitCode;
+      } catch (error) {
+        ui.error(`self gate failed: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+      }
+    };
     try {
-      const { runSelfGateCli } = require('./self-implement/gate-cli.js') as typeof import('./self-implement/gate-cli.js');
-      const result = runSelfGateCli(process.cwd(), { base: opts.base, pr: opts.pr, shards: opts.shards === undefined ? undefined : opts.shards === true ? 2 : Number(opts.shards) });
-      console.log(result.lines.join('\n'));
-      process.exitCode = result.exitCode;
+      const { dispatchHeavyCheck } = await import('./self-implement/gate-remote.js');
+      const { execFileSync } = await import('node:child_process');
+      const repo = execFileSync('git', ['rev-parse', '--show-toplevel'], { encoding: 'utf8' }).trim();
+      // Only a committed --base range is reproducible on another host: the default mode measures uncommitted files, --pr
+      // reads files through gh on this host, and the remote checkout runs from the repository root — those stay local.
+      const { realpathSync } = await import('node:fs');
+      const localOnlyReason = opts.pr ? 'self gate --pr reads PR files through gh on this host'
+        : !opts.base ? 'self gate without --base measures uncommitted files on this host'
+        : realpathSync(repo) !== realpathSync(process.cwd()) ? 'self gate run from a sub-directory' : undefined;
+      // origin/main is pinned to this machine's origin/main on the host; any other base is passed as its resolved sha.
+      const remoteArgv = (sha: (ref: string) => string) => ['bun', 'bin/elanous.mjs', 'self', 'gate', '--local', ...(opts.changed ? ['--changed'] : []),
+        ...(opts.base ? ['--base', opts.base === 'origin/main' ? opts.base : sha(opts.base)] : []), ...(shards !== undefined ? ['--shards', String(shards)] : [])];
+      process.exitCode = await dispatchHeavyCheck({
+        tool: 'self-gate', repo, installPwa: true, remoteArgv, refs: opts.base ? [opts.base] : [],
+        localOnlyReason,
+        flags: { remote: typeof opts.remote === 'string' ? opts.remote : opts.remote ? true : undefined, local: !!opts.local },
+        runLocal,
+      });
     } catch (error) {
-      ui.error(`self gate failed: ${error instanceof Error ? error.message : String(error)}`);
-      process.exitCode = 1;
+      ui.error(`self gate dispatch failed: ${error instanceof Error ? error.message : String(error)}`);
+      process.exitCode = runLocal();
     }
   });
 
@@ -7001,6 +7161,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),
@@ -8550,10 +8712,15 @@ program
     }
     if (opts.tools) announceChatToolsCompatibility();
     const cfg = getUserConfig();
-    if (needsOnboarding(cfg)) {
-      if (cfg.onboarding.webFirst === false) ui.info('No config yet — launching setup wizard first.');
-      if (!await runFirstSetupForCli(cfg, true)) return;
-    }
+    if (await firstChatGate(cfg, {
+      isTTY: process.stdin.isTTY === true,
+      runFirstRun: async (deps) => (await import('./onboarding/first-run.js')).runFirstRun(deps),
+      runInteractive: () => {
+        if (cfg.onboarding.webFirst === false) ui.info('No config yet — launching setup wizard first.');
+        return runFirstSetupForCli(cfg, true);
+      },
+      print: (line) => console.log(line),
+    }) === 'stop') return;
     const refreshed = reloadUserConfig();
     // ★ 관측갭 수리(2026-07-21·제1원칙·트랙A) — self-implement 자식 goal-loop(`chat --goal-loop`)은 데몬과
     //   별개 독립 프로세스라 nexus StoreSink 를 상속 안 한다. 부모 `self implement`(위 self 커맨드)는 sink 를

package/src/intake-plane/adopt-gate.ts

@@ -0,0 +1,49 @@
+import { debug } from '../debug/log.js';
+
+export interface AdoptionCandidate {
+  readonly id: string;
+  readonly grade: 'P1' | 'P2' | 'P3' | 'P4';
+  readonly risk: number;
+  readonly money: number;
+  readonly security: number;
+  readonly license: string | null;
+  readonly touchesPatentCandidate: boolean;
+}
+
+export type AdoptShadowReason = 'grade' | 'risk' | 'money' | 'security' | 'license' | 'patent' | 'daily-cap';
+
+export interface AdoptShadowVerdict {
+  readonly id: string;
+  readonly adopt: boolean;
+  readonly reasons: readonly AdoptShadowReason[];
+}
+
+const ALLOWED_LICENSES: ReadonlySet<string> = new Set([
+  'MIT', 'Apache-2.0', 'BSD-2-Clause', 'BSD-3-Clause', 'ISC', 'MPL-2.0',
+]);
+
+export function judgeAdoption(candidate: AdoptionCandidate, adoptedToday: number): AdoptShadowVerdict {
+  const reasons: AdoptShadowReason[] = [];
+  if (candidate.grade !== 'P1' && candidate.grade !== 'P2') reasons.push('grade');
+  if (!(candidate.risk <= 1)) reasons.push('risk');
+  if (candidate.money !== 0) reasons.push('money');
+  if (candidate.security !== 0) reasons.push('security');
+  if (candidate.license === null || !ALLOWED_LICENSES.has(candidate.license)) reasons.push('license');
+  if (candidate.touchesPatentCandidate !== false) reasons.push('patent');
+  if (!(adoptedToday < 5)) reasons.push('daily-cap');
+  return { id: candidate.id, adopt: reasons.length === 0, reasons };
+}
+
+export function shadowAdopt(candidates: readonly AdoptionCandidate[]): AdoptShadowVerdict[] {
+  const verdicts: AdoptShadowVerdict[] = [];
+  let adoptedToday = 0;
+  for (const candidate of candidates) {
+    const verdict = judgeAdoption(candidate, adoptedToday);
+    if (verdict.adopt) adoptedToday++;
+    verdicts.push(verdict);
+    debug.log('intake.adopt', 'shadow-verdict', {
+      id: verdict.id, adopt: verdict.adopt, reasons: verdict.reasons,
+    });
+  }
+  return verdicts;
+}

package/src/intake-plane/check.ts

@@ -21,6 +21,7 @@ import { parse as parseYaml } from 'yaml';
 import { debug } from '../debug/log.js';
 import { openSurfaceEventsDb, recallEvents } from '../domains/surface-events.js';
 import { extractJsonBlock, skeletonFallback } from './decompose.js';
+import type { AdoptShadowVerdict } from './adopt-gate.js';
 
 export const INTAKE_CHECK_MODE = 'check' as const;
 
@@ -110,6 +111,7 @@ export interface IntakeCheckReport {
   /** 비교·시너지 제안 수(근거 없음 포함). */
   readonly proposalCount?: number;
   readonly proposals?: readonly IntakeCompareProposal[];
+  readonly adoptShadow?: readonly AdoptShadowVerdict[];
 }
 
 /** 선가공 렌즈 여섯. 🅞 원장 · PR #20009. */
@@ -1826,6 +1828,7 @@ export function intakeCheckReportJson(report: IntakeCheckReport): Record<string,
       proposalCount: report.proposalCount,
       proposals: report.proposals,
     } : {}),
+    ...(report.adoptShadow !== undefined ? { adoptShadow: report.adoptShadow } : {}),
   };
 }
 

package/src/intake-plane/collect-github.ts

@@ -6,14 +6,18 @@ import { execFileSync } from 'node:child_process';
 import { debug } from '../debug/log.js';
 import { ingestIntakeItems, intakeLedgerDir, type IngestResult, type RawIntakeItem } from './items.js';
 
-/** 한 판에 열 번 안쪽 — 검색 API 비율 제한(인증 시 분당 30회)을 시험 밖에서 상수로 묶는다. */
+/** 한 판에 열 번 이하 — 검색 API 비율 제한(인증 시 분당 30회)을 시험 밖에서 상수로 묶는다. */
 export const GITHUB_STAR_QUERIES = [
   'topic:ai-agents',
-  'topic:llm-agent',
   'topic:coding-agent',
   'topic:mcp',
   'topic:video-generation',
-  '"ai agent" in:name,description',
+  'topic:agent-framework',
+  'topic:computer-use',
+  'topic:local-llm',
+  'topic:claude-code',
+  'topic:codex',
+  'topic:agent-memory',
 ] as const;
 
 /** `--days` 기본. 최근 이 일수 안에 만들어졌거나 푸시된 저장소만 받는다. */
@@ -32,6 +36,7 @@ export interface GithubStarRepo {
   stars: number;
   createdAt: string;
   pushedAt: string;
+  license?: string;
 }
 
 /** 질의 하나 → 저장소 목록. 실제 구현은 `gh api` · 시험은 가짜. */
@@ -43,6 +48,7 @@ export interface GithubStarSignals {
   stars: number;
   starsDelta?: number;
   starsPerDay?: number;
+  baselineDays?: number;
 }
 
 export interface CollectGithubQueryCount { query: string; received: number }
@@ -55,6 +61,8 @@ export interface CollectGithubRepoRow {
   stars: number;
   starsDelta?: number;
   starsPerDay?: number;
+  baselineDays?: number;
+  license?: string;
 }
 
 export interface CollectGithubResult {
@@ -99,6 +107,17 @@ export function precedingSnapshot(snaps: readonly StarSnapshot[], repo: string,
   return best;
 }
 
+/** 7일 전 또는 그 이전 중 가장 가까운 스냅숏; 없으면 직전 스냅숏. */
+export function surgeBaseline(snaps: readonly StarSnapshot[], repo: string, day: string): StarSnapshot | undefined {
+  const cutoff = new Date(Date.parse(`${day}T00:00:00.000Z`) - 7 * 86_400_000).toISOString().slice(0, 10);
+  let best: StarSnapshot | undefined;
+  for (const s of snaps) {
+    if (s.repo !== repo || s.day > cutoff) continue;
+    if (!best || s.day > best.day) best = s;
+  }
+  return best ?? precedingSnapshot(snaps, repo, day);
+}
+
 function utcDay(iso: string): string {
   const t = Date.parse(iso);
   if (!Number.isFinite(t)) return '';
@@ -128,7 +147,7 @@ export function signalsFromSnapshot(stars: number, prev: StarSnapshot | undefine
   if (!prev) return { stars };
   const span = Math.max(1, daysBetween(prev.day, day));
   const starsDelta = stars - prev.stars;
-  return { stars, starsDelta, starsPerDay: starsDelta / span };
+  return { stars, starsDelta, starsPerDay: starsDelta / span, baselineDays: span };
 }
 
 export function appendGithubStarSnapshots(root: string, rows: StarSnapshot[]): void {
@@ -154,13 +173,13 @@ export interface CollectGithubOpts {
   /** 스냅숏·비교의 «오늘». 생략하면 UTC 날짜. */
   day?: string;
   now?: () => Date;
-  /** 등록 원천이 질의 하나만 수집할 때; 생략 시 기존 관심 질의 전부. */
+  /** 등록 원천이 질의 하나만 수집할 때; 생략 시 관심 질의 전부 (최대 10개). */
   queries?: readonly string[];
 }
 
 /**
  * 관심 주제 질의마다 별 순 검색을 부르고, 최근 창 안의 저장소만 남긴 뒤 질의 사이에서 중복을 없앤다.
- * 저장소마다 오늘 별 수 스냅숏을 덧붙이고, 직전 스냅숏과 비교한 신호를 원장에 넣는다.
+ * 저장소마다 오늘 별 수 스냅숏을 덧붙이고, 7일 기준(없으면 직전) 스냅숏과 비교한 신호를 원장에 넣는다.
  * dryRun 이면 스냅숏·원장을 바꾸지 않는다.
  */
 export async function collectGithubStars(
@@ -175,7 +194,7 @@ export async function collectGithubStars(
   const found: GithubStarRepo[] = [];
   // «급상승»은 최근에 생긴 저장소 중 별 순이다 — 전체 기간 별 순이면 활발한 거대 저장소가 매일 같은 목록으로 나온다(2026-09-26 검토).
   const windowStart = new Date(Date.parse(`${day}T00:00:00.000Z`) - days * 86_400_000).toISOString().slice(0, 10);
-  for (const query of opts.queries ?? GITHUB_STAR_QUERIES) {
+  for (const query of (opts.queries ?? GITHUB_STAR_QUERIES).slice(0, 10)) {
     const rows = await search(`${query} created:>=${windowStart}`, perQuery);
     const recent = rows.filter((r) => isRecentRepo(r, day, days));
     queries.push({ query, received: recent.length });
@@ -186,20 +205,24 @@ export async function collectGithubStars(
   const repos: CollectGithubRepoRow[] = unique.map((repo) => {
     const prev = precedingSnapshot(prior, repo.fullName, day);
     const signals = signalsFromSnapshot(repo.stars, prev, day);
+    const surge = signalsFromSnapshot(repo.stars, surgeBaseline(prior, repo.fullName, day), day);
     return {
       repo: repo.fullName,
       url: repo.url,
       title: repo.fullName,
       text: repo.description,
       stars: signals.stars,
+      ...(repo.license !== undefined ? { license: repo.license } : {}),
       ...(signals.starsDelta !== undefined ? { starsDelta: signals.starsDelta } : {}),
-      ...(signals.starsPerDay !== undefined ? { starsPerDay: signals.starsPerDay } : {}),
+      ...(surge.starsPerDay !== undefined ? { starsPerDay: surge.starsPerDay } : {}),
+      ...(surge.baselineDays !== undefined ? { baselineDays: surge.baselineDays } : {}),
     };
-  });
+  }).sort((a, b) => (b.starsPerDay ?? -Infinity) - (a.starsPerDay ?? -Infinity) || b.stars - a.stars);
   const raws: RawIntakeItem[] = repos.map((row) => ({
     url: row.url,
     title: row.title,
-    text: row.text,
+    // 모든 행 첫 줄에 라이선스: SPDX · 확인된 부재는 «없음» · 응답이 알려 주지 않으면 «미상»(없음으로 읽지 않는다).
+    text: `라이선스: ${row.license ?? '미상'}\n${row.text}`,
     signals: {
       stars: row.stars,
       ...(row.starsDelta !== undefined ? { starsDelta: row.starsDelta } : {}),
@@ -226,23 +249,10 @@ interface GhSearchItem {
   stargazers_count?: number;
   created_at?: string;
   pushed_at?: string;
+  license?: { spdx_id?: string | null } | null;
 }
 
-/** `gh api search/repositories` 를 `sort=stars` 로 한 번 부른다. */
-export const ghApiSearchRepos: SearchGithubRepos = async (query, perQuery) => {
-  const perPage = Math.min(100, Math.max(1, perQuery));
-  const q = `${query} sort:stars`;
-  const out = execFileSync('gh', [
-    'api',
-    '-X', 'GET',
-    'search/repositories',
-    '-f', `q=${q}`,
-    '-f', 'sort=stars',
-    '-f', 'order=desc',
-    '-f', `per_page=${perPage}`,
-    '--jq', '.items',
-  ], { encoding: 'utf8', timeout: 30_000 });
-  const items = JSON.parse(out) as GhSearchItem[];
+export function reposFromGhSearchItems(items: GhSearchItem[], perQuery: number): GithubStarRepo[] {
   if (!Array.isArray(items)) return [];
   const repos: GithubStarRepo[] = [];
   for (const item of items) {
@@ -254,7 +264,29 @@ export const ghApiSearchRepos: SearchGithubRepos = async (query, perQuery) => {
       stars: Number(item.stargazers_count ?? 0),
       createdAt: item.created_at ?? '',
       pushedAt: item.pushed_at ?? '',
+      ...(item.license === null
+        ? { license: '없음' }
+        : typeof item.license?.spdx_id === 'string' && item.license.spdx_id
+          ? { license: item.license.spdx_id }
+          : {}),
     });
   }
   return repos.slice(0, perQuery);
+}
+
+/** `gh api search/repositories` 를 `sort=stars` 로 한 번 부른다. */
+export const ghApiSearchRepos: SearchGithubRepos = async (query, perQuery) => {
+  const perPage = Math.min(100, Math.max(1, perQuery));
+  const q = `${query} sort:stars`;
+  const out = execFileSync('gh', [
+    'api',
+    '-X', 'GET',
+    'search/repositories',
+    '-f', `q=${q}`,
+    '-f', 'sort=stars',
+    '-f', 'order=desc',
+    '-f', `per_page=${perPage}`,
+    '--jq', '.items',
+  ], { encoding: 'utf8', timeout: 30_000 });
+  return reposFromGhSearchItems(JSON.parse(out) as GhSearchItem[], perQuery);
 };