elanous 0.2.24 → 0.2.27

package/src/index.ts

@@ -9,6 +9,7 @@ import { LOGS_SINCE_OPTION, registerLogsCommands } from './cli/logs-cli.js';
 import { registerDocsCommands } from './cli/docs-cli.js';
 import { registerBenchCommands } from './cli/bench-cli.js';
 import { registerRetroCommands } from './cli/retro-cli.js';
+import { registerMemoryCommands } from './cli/memory-cli.js';
 import { registerA2ACommands } from './cli/a2a-cli.js';
 import { registerPluginCommands } from './cli/plugin-cli.js';
 import { registerMakeCommand } from './cli/make-cli.js';
@@ -37,6 +38,7 @@ import { DEV_PIPELINE_SINK_SURFACE } from './self-implement/self-cli-sink-surfac
 import { registerPrivateLedgerCommands } from './cli/private-ledger-commands.js';
 import { registerKnowCommand } from './cli/know-cli.js';
 import { registerSeatRequestsCommands } from './cli/seat-requests-cli.js';
+import { registerSeatBootCommands } from './cli/seat-cli.js';
 import { applyTestStateDirFlagFromArgv } from './cli/test-state-dir-flag.js';
 import { applyTestFlagFromArgv, observeTestFlagOwnership, uncoveredTestFlagPaths, staleTestFlagPaths } from './cli/test-flag.js';
 import { registerPtyTakeoverCommands } from './cli/pty-takeover-cli.js';
@@ -93,6 +95,7 @@ import { registerStartCommand } from './cli/start-cli.js';
 import { registerGroundingSourcesCli } from './grounding/sources-cli.js';
 import { registerGraphCommands } from './graph-runner/graph-cli.js';
 import { registerLoopCommands } from './loops/loop-cli.js';
+import { registerResourceCommands } from './cli/resource-cli.js';
 import { registerHqMovePlanCommand } from './hq/hq.js';
 import { registerCardCommand } from './task-cards/card-cli.js';
 import { registerLaunchHeadCommands } from './launch-head/launch-head-cli.js';
@@ -121,6 +124,8 @@ 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 { CliUserError, formatCliUserError, isCliUserError } from './cli/cli-user-error.js';
+import { classifyFriendlyError, formatFriendlyError } from './cli/friendly-errors.js';
+import { detectLocale } from './expression/locale.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';
@@ -201,11 +206,6 @@ import {
 } from './cli/mission-config.js';
 import { DEFAULT_THEME_TOKENS, resolveThemeTokens } from './theme/tokens.js';
 import { conatusPath } from './domains/conatus-data-dir.js';
-import {
-  saveMemory, loadMemory, listMemories, deleteMemory, searchMemories,
-  readIndex, memoryRoot, memoryIndexPath,
-  type MemoryType,
-} from './memory.js';
 
 /** 원본 전용 봇랩 도구 — 공개본엔 없다(release/public-export.yaml · scripts/botlab/**). */
 const BOTLAB_STATE_PATHS_MODULE: string = '../scripts/botlab/botlab-state-paths.js';
@@ -1119,6 +1119,7 @@ hqCmd.command('fence').description('이 호스트가 임대를 쥐었을 때만
     process.exitCode = hqFenceRun(opts.role as 'cron', command);
   });
 const seatCmd = program.command('seat').description('분배된 자리의 하루 루프와 보고');
+registerSeatBootCommands(seatCmd);
 registerSeatRequestsCommands(seatCmd);
 seatCmd.command('asks').description('최근 CTO 되묻기 왕복과 10분 판정')
   .option('--since <duration>', '조회 창 (예: 24h)', '24h')
@@ -1268,6 +1269,7 @@ registerStartCommand(program);
 registerGroundingSourcesCli(program);
 registerGraphCommands(program);
 registerLoopCommands(program);
+registerResourceCommands(program);
 // RFC 실행·착지 루프 §3 — 태스크 컨텍스트 카드(`elanous card list|show` · ⛔ `task`/`tasks` 는 TOX 몫).
 registerCardCommand(program);
 registerLaunchHeadCommands(program);
@@ -1935,174 +1937,7 @@ registerAutopilotCommands(program);
 registerRetroCommands(program);
 
 // ── memory ──
-const memCmd = program.command('memory').description('Persistent memories injected into every chat turn (user / feedback / project / reference)');
-
-memCmd
-  .command('list [type]')
-  .description('List memories (optionally filtered by type)')
-  .option('-n, --limit <n>', 'Max entries to show', '30')
-  .action((type?: string, opts?: { limit: string }) => {
-    const t = type as MemoryType | undefined;
-    const entries = listMemories({ type: t, limit: parseInt(opts?.limit ?? '30', 10) });
-    if (entries.length === 0) {
-      ui.info('No memories yet. Add one with `elanous memory add <type> "<name>" "<description>"`.');
-      return;
-    }
-    ui.header(`memories (${entries.length})`);
-    for (const e of entries) {
-      console.log(`  ${e.id.slice(0, 8)}  [${e.type.padEnd(9)}]  ${e.name}`);
-      if (e.description) console.log(`             ${e.description.slice(0, 100)}`);
-    }
-  });
-
-memCmd
-  .command('add <type> <name> [description...]')
-  .description('Create a memory (type: user|feedback|project|reference). Body piped via stdin if available.')
-  .action(async (type: string, name: string, descParts: string[]) => {
-    if (!['user', 'feedback', 'project', 'reference'].includes(type)) {
-      ui.error(`invalid type "${type}". Use: user | feedback | project | reference`);
-      process.exit(1);
-    }
-    const description = (descParts || []).join(' ');
-    // Read body from stdin if piped; otherwise use description as body too.
-    let body = description;
-    const pipedBody = await readPipedStdin();   // ★ OBS-T3 — 비-TTY 는 파이프를 뜻하지 않는다(소켓이면 EOF 가 안 온다)
-    if (pipedBody) body = pipedBody;
-    const e = saveMemory({ type: type as MemoryType, name, description, body });
-    ui.info(`saved ${e.id.slice(0, 8)} [${e.type}] "${e.name}"`);
-  });
-
-// 3번째 recall 레버(2026-07-19) — pin(항상주입) / priority(매칭 시 순위 부스트).
-memCmd
-  .command('pin <idPrefix>')
-  .description('Pin a memory so it is ALWAYS injected (bypass keyword gate). Optionally set priority.')
-  .option('-p, --priority <n>', 'priority boost (higher = ranked/kept first)', '5')
-  .action((prefix: string, opts: { priority: string }) => {
-    const e = loadMemory(prefix);
-    if (!e) { ui.error(`no memory matching "${prefix}"`); process.exit(1); }
-    saveMemory({ type: e.type, name: e.name, description: e.description, body: e.body, id: e.id, pinned: true, priority: parseInt(opts.priority, 10) || 0 });
-    ui.info(`📌 pinned ${e.id.slice(0, 8)} "${e.name}" (priority ${opts.priority})`);
-  });
-
-memCmd
-  .command('unpin <idPrefix>')
-  .description('Un-pin a memory (back to keyword-gated recall).')
-  .action((prefix: string) => {
-    const e = loadMemory(prefix);
-    if (!e) { ui.error(`no memory matching "${prefix}"`); process.exit(1); }
-    saveMemory({ type: e.type, name: e.name, description: e.description, body: e.body, id: e.id, pinned: false, priority: e.priority });
-    ui.info(`unpinned ${e.id.slice(0, 8)} "${e.name}"`);
-  });
-
-memCmd
-  .command('priority <idPrefix> <n>')
-  .description('Set a memory\'s injection priority boost (0 = default). Added to match score.')
-  .action((prefix: string, n: string) => {
-    const e = loadMemory(prefix);
-    if (!e) { ui.error(`no memory matching "${prefix}"`); process.exit(1); }
-    saveMemory({ type: e.type, name: e.name, description: e.description, body: e.body, id: e.id, priority: parseInt(n, 10) || 0, pinned: e.pinned });
-    ui.info(`priority ${e.id.slice(0, 8)} "${e.name}" → ${parseInt(n, 10) || 0}`);
-  });
-
-// 통합 관리 뷰(2026-07-19) — 2 시스템(큐레이션 파일메모리 + 에피소드 self-log)을 한 화면에.
-memCmd
-  .command('status')
-  .description('Unified memory overview — ① curated file-memory + ② self-log (surface_events)')
-  .action(async () => {
-    const { memoryRoot } = await import('./memory.js');
-    const mems = listMemories();
-    const byType: Record<string, number> = {};
-    let pinned = 0;
-    for (const e of mems) { byType[e.type] = (byType[e.type] ?? 0) + 1; if (e.pinned) pinned += 1; }
-    ui.header('memory (unified)');
-    console.log(`① 큐레이션 파일메모리: ${mems.length}건  [${Object.entries(byType).map(([k, v]) => `${k}:${v}`).join(' ') || '-'}]  📌pinned ${pinned}`);
-    console.log(`   ${memoryRoot()}  (LLM-judge/luna recall · MEMORY.md 항상주입)`);
-    try {
-      const { surfaceEventsDbPath, openSurfaceEventsDb } = await import('./domains/surface-events.js');
-      const path = surfaceEventsDbPath();
-      // 항상 open — legacy conatus/ → memory/ 자가치유 마이그레이션이 여기서 실행된다(존재 체크 먼저
-      // 하면 신 경로 부재로 마이그레이션이 스킵됨). 없으면 빈 store 생성(무해).
-      const db = openSurfaceEventsDb(path);
-      const n = (db.prepare('SELECT count(*) c FROM events').get() as { c: number }).c;
-      const recent = (db.prepare('SELECT ts FROM events ORDER BY ts DESC LIMIT 1').get() as { ts: string } | undefined)?.ts;
-      db.close();
-      console.log(`② 에피소드 self-log: ${n.toLocaleString()} events  (최근 ${recent?.slice(0, 16) ?? '-'})`);
-      console.log(`   ${path}  (FTS5 bm25+recency+myelin rerank · ambient 회상)`);
-    } catch (e) { console.log(`② self-log 조회 실패: ${(e as Error).message}`); }
-    try {
-      const { openKnowledgeDb, knowledgeDbPath } = await import('./domains/knowledge.js');
-      const kdb = openKnowledgeDb(); // 기본 경로 → legacy conatus/ 자가치유 이전
-      const kn = (kdb.prepare('SELECT count(*) c FROM docs').get() as { c: number }).c;
-      const dom = (kdb.prepare("SELECT domain, count(*) c FROM docs GROUP BY domain ORDER BY c DESC LIMIT 3").all() as Array<{ domain: string | null; c: number }>);
-      kdb.close();
-      console.log(`③ 시맨틱 knowledge: ${kn.toLocaleString()} docs  [${dom.map(d => `${d.domain ?? 'null'}:${d.c}`).join(' ')}]`);
-      console.log(`   ${knowledgeDbPath()}  (임베딩 벡터+BM25 하이브리드 · 의미 회상)`);
-    } catch (e) { console.log(`③ knowledge 조회 실패: ${(e as Error).message}`); }
-  });
-
-memCmd
-  .command('show <idPrefix>')
-  .description('Print full memory body')
-  .action((prefix: string) => {
-    const entries = listMemories();
-    const hit = entries.find(e => e.id.startsWith(prefix));
-    if (!hit) { ui.error(`no memory matching "${prefix}"`); process.exit(1); }
-    const full = loadMemory(hit.id)!;
-    ui.header(`${full.type}: ${full.name}`);
-    console.log(`  id          ${full.id}`);
-    console.log(`  created     ${full.createdAt}`);
-    console.log(`  updated     ${full.updatedAt}`);
-    console.log(`  description ${full.description}`);
-    console.log('');
-    console.log(full.body);
-  });
-
-memCmd
-  .command('search <query...>')
-  .description('Keyword search across all memories')
-  .option('--type <t>', 'Filter by type')
-  .option('-n, --limit <n>', 'Max results', '10')
-  .action((parts: string[], opts) => {
-    const hits = searchMemories(parts.join(' '), {
-      type: opts.type as MemoryType | undefined,
-      limit: parseInt(opts.limit, 10),
-    });
-    if (hits.length === 0) { ui.info('No matches.'); return; }
-    ui.header(`matches (${hits.length})`);
-    for (const h of hits) {
-      console.log(`  ${h.entry.id.slice(0, 8)}  score ${h.score}  [${h.entry.type}]  ${h.entry.name}`);
-      if (h.entry.description) console.log(`             ${h.entry.description.slice(0, 100)}`);
-    }
-  });
-
-memCmd
-  .command('delete <idPrefix>')
-  .description('Delete a memory')
-  .action((prefix: string) => {
-    const entries = listMemories();
-    const hit = entries.find(e => e.id.startsWith(prefix));
-    if (!hit) { ui.error(`no memory matching "${prefix}"`); process.exit(1); }
-    deleteMemory(hit.id);
-    ui.info(`deleted ${hit.id.slice(0, 8)}`);
-  });
-
-memCmd
-  .command('index')
-  .description('Print MEMORY.md index verbatim')
-  .action(() => {
-    const idx = readIndex();
-    if (!idx) { ui.info('empty (no memories yet)'); return; }
-    console.log(idx);
-  });
-
-memCmd
-  .command('where')
-  .description('Show the memory storage path')
-  .action(() => {
-    console.log(`memory dir   ${memoryRoot()}`);
-    console.log(`index file   ${memoryIndexPath()}`);
-  });
-
+registerMemoryCommands(program);
 // ── self (self-awareness memory — 외부 도구가 elanous 구현 이력을 주입/회상) ──
 // ── decide (Jev · System One — ⛔ 텍스트를 «생성하지 않는다». 확률이 붙은 판정만 받는다) ──
 program
@@ -3519,6 +3354,7 @@ coordCmd.command('events')
   });
 
 const selfCmd = program.command('self').description('Self-awareness memory — 외부 도구(Claude Code/Codex)가 구현/변경 이력을 elanous 기억에 주입·회상');
+{ const { registerSelfUtterancesCommand } = await import('./cli/self-utterances-cli.js'); registerSelfUtterancesCommand(selfCmd); }
 
 // M12 Claude Code 의존도 계기판 — `elanous self dependence [--since] [--until] [--json]`(읽기만).
 { const { registerDependenceCommand } = await import('./cli/dependence-gauge.js'); registerDependenceCommand(selfCmd); }
@@ -5865,6 +5701,8 @@ selfCmd
         return (prompt: string) =>
           streamLLM([{ role: 'user', content: prompt }], () => {}, {
             model,
+            // ⛔ 어댑터 기본 2048 은 리뷰 응답을 자른다(VERDICT/MUST-FIX 줄이 잘리면 reviewed=false 로 접힌다).
+            maxTokens: 16_000,
             ...(o?.pinProvider ? { provider: getProvider(model) } : {}),
             ...(o?.onResolved ? { onResolvedProvider: o.onResolved } : {}),
             ...(effort ? { reasoningEffort: effort } : {}),
@@ -5878,7 +5716,7 @@ selfCmd
         return async (prompt: string, images?: readonly ReviewImage[]) => {
           if (!made) {
             const { makeLazyAcpReviewLLM } = await import('./agent-substrate/acp-reviewer.js');
-            made = makeLazyAcpReviewLLM({ cwd: process.cwd(), backend: o.backend, model: o.model, timeoutMs: o.timeoutMs });
+            made = makeLazyAcpReviewLLM({ cwd: o.cwd ?? process.cwd(), backend: o.backend, model: o.model, timeoutMs: o.timeoutMs });
           }
           return made(prompt, images);
         };
@@ -5894,7 +5732,7 @@ selfCmd
         // handshakeTimeoutMs left to the adapter default (min(timeoutMs, 60s)) — the harness lane passes none either.
         return {
           backend: 'claude',
-          llm: makeRoleAcpReviewLLM({ cwd: process.cwd(), backend: 'claude', backendSpec: spawn.backendSpec, env: spawn.env, timeoutMs: o.timeoutMs }),
+          llm: makeRoleAcpReviewLLM({ cwd: o.cwd ?? process.cwd(), backend: 'claude', backendSpec: spawn.backendSpec, env: spawn.env, timeoutMs: o.timeoutMs }),
         };
       },
       // SUBSCRIPTION-EXHAUST-REROUTE — role reviewer unavailable ⇒ GLM on OpenRouter (the review policy's first
@@ -5909,6 +5747,19 @@ selfCmd
       envModel: () => process.env.ELANOUS_PR_REVIEW_MODEL,
     });
     if (opts.json) await writeStdoutJson(selfReviewJsonLine(results));
+    // Detached TA review: stdout is now complete in its result file. Resume only the bound card.
+    try {
+      const { rejudgeCompletedTaskReview, TA_REVIEW_COMPLETION_CARD_ENV, TA_REVIEW_COMPLETION_STATE_ENV, TA_REVIEW_COMPLETION_RESULT_ENV } = await import('./task-agent/review-result-capture.js');
+      const completionEnv: Record<string, string | undefined> = {};
+      for (const key of [TA_REVIEW_COMPLETION_CARD_ENV, TA_REVIEW_COMPLETION_STATE_ENV, TA_REVIEW_COMPLETION_RESULT_ENV]) {
+        const value = process.env[key];
+        if (value) completionEnv[key] = value;
+        delete process.env[key];
+      }
+      await rejudgeCompletedTaskReview(completionEnv);
+    } catch (error) {
+      try { debug.log('task-agent', 'review-completion-rejudge-failed', { reason: String(error).slice(-300) }, { level: 'warn' }); } catch { /* fail-soft */ }
+    }
     if (failed >= 1) process.exitCode = 1;
   });
 
@@ -5987,22 +5838,25 @@ selfCmd
   .description('외부 도구 발화를 elanous 기억에 주입 — origin/git/branch/cwd/시간 태그(회상이 "누가 언제 어디서" 구분). text=--text 또는 stdin')
   .option('-s, --text <text>', '발화 원문(생략 시 stdin)')
   .option('--source <origin>', 'claude-code|codex|gemini|…', 'claude-code')
+  .option('--origin <origin>', '발화 주체: human|agent (기본 agent)')
   .option('--session <id>', '세션 id')
   .option('--git-hash <hash>', '발화 시점 git HEAD(short)')
   .option('--branch <name>', 'git 브랜치')
   .option('--cwd <dir>', '작업 디렉토리')
   .option('--ts <iso>', 'ISO 시간(기본 now)')
   .option('-i, --importance <n>', '0-10 현저성', '5')
-  .action(async (opts: { text?: string; source: string; session?: string; gitHash?: string; branch?: string; cwd?: string; ts?: string; importance: string }) => {
+  .action(async (opts: { text?: string; source: string; origin?: string; session?: string; gitHash?: string; branch?: string; cwd?: string; ts?: string; importance: string }) => {
+    if (opts.origin !== undefined && opts.origin !== 'human' && opts.origin !== 'agent') { ui.error('utterance: --origin must be human or agent'); process.exitCode = 1; return; }
     let text = opts.text;
     if (!text) text = await readPipedStdin();   // ★ OBS-T3
     if (!text || !text.trim()) { ui.error('utterance: --text 또는 stdin 필요'); process.exit(1); }
     // 독립 CLI 프로세스 — 데몬 StoreSink 를 상속 안 하므로 logs.db 싱크를 붙여야
     // injectUtterance 의 `debug.log('memory.utterance','ingress')` 가 logs.db 에 닿음(제1원칙 관측).
-    const { injectUtterance } = await import('./domains/self-awareness.js');
-    const r = injectUtterance({
+    const { recordSelfUtterance } = await import('./cli/self-utterances-cli.js');
+    const r = recordSelfUtterance({
       text: text.trim(),
       origin: opts.source,
+      utteranceOrigin: opts.origin === 'human' ? 'human' : 'agent',
       ...(opts.session ? { sessionId: opts.session } : {}),
       ...(opts.gitHash ? { gitHash: opts.gitHash } : {}),
       ...(opts.branch ? { branch: opts.branch } : {}),
@@ -11887,7 +11741,10 @@ async function main(): Promise<void> {
   // 한다. 인터랙티브 TUI 는 데몬 sink 를 상속 안 하므로 안 붙이면 debug.log 가 no-op
   // (제1원칙 관측 갭 · tui-sim 드라이브에서 agent.source 0건으로 실측 2026-07-19).
   // PR#4622(self utterance CLI)·session-cli 미러. fail-open·비블로킹.
+  const bootTimer = (await import('./dashboard/boot-timing.js')).createBootTimer();
+  bootTimer.begin();
   try { await (await import('./domains/standalone-log-sink.js')).registerStandaloneLogSink('tui'); } catch { /* fail-open */ }
+  bootTimer.phase('log-sink');
   // P3(대표 2026-07-26) — footgun 관측을 logs.db 에 도달시킨다. 초반(arg 파싱 前) warnProdSpawnFootgun 은
   //   StoreSink 등록 前이라 debug.log 가 logs.db 미도달이었다(순서 갭). sink 등록 직후 관측만 재발행(stderr 중복 X).
   try { (await import('./instance-root-coherence.js')).warnProdSpawnFootgun({ emit: 'log' }); } catch { /* fail-open */ }
@@ -11897,7 +11754,9 @@ async function main(): Promise<void> {
   // so `elanous self screen` / `/v1/terminals` / (P2) PWA can see the
   // dashboard the user is actually looking at. Off unless this boots
   // (no producer in headless/daemon paths). fail-soft·비블로킹.
+  bootTimer.begin();
   try { (await import('./capture/tui-self-report.js')).startTuiSelfReport(); } catch { /* fail-soft */ }
+  bootTimer.phase('self-report');
 
   // Dashboard handles sync inline — only returns on quit
   // ⛔ stdin 이 TTY 가 아니면 «뜨지 않는다» — 뜨면 readKey 가 엔터를 지어내 초당 수백 프레임을
@@ -11910,7 +11769,14 @@ async function main(): Promise<void> {
       return;
     }
   }
-  await showDashboard(dashboardOpts);
+  bootTimer.begin();
+  await showDashboard({
+    ...dashboardOpts,
+    onFirstFrameRendered: () => {
+      bootTimer.phase('show-dashboard');
+      bootTimer.done();
+    },
+  });
   closeTui();
   // Force exit: the dashboard starts background timers (clipboard
   // poller, shimmer/blink animations) that keep the Bun event loop
@@ -11941,6 +11807,13 @@ export function runCli(): void {
       console.error(formatCliUserError(err));
       process.exit(1);
     }
+    const friendlyCode = classifyFriendlyError(err);
+    if (friendlyCode) {
+      const locale = detectLocale();
+      console.error(formatFriendlyError(friendlyCode, locale));
+      debug.log('cli.friendly-error', 'shown', { code: friendlyCode, locale });
+      process.exit(1);
+    }
     // ER1 — a real crash is reported once (consented · scrubbed · never blocks more than the send timeout).
     try {
       const { reportError } = await import('./error-report/report.js');

package/src/instance/current.ts

@@ -1,9 +1,8 @@
-import { join } from 'node:path';
 import { debug } from '../debug/log.js';
 import { getElanousConfigDirOverride } from '../elanous-config-dir.js';
 import { getTestStateRoot } from '../nexus/paths.js';
-import { findTreeRoot, getAppliedGlobalTestRoot } from '../cli/test-flag.js';
-import { isInstalledCopyScript, treeFromScriptPath } from './leader.js';
+import { getAppliedGlobalTestRoot } from '../cli/test-flag.js';
+import { isInstalledCopyScript } from './leader.js';
 import { prodInstanceRoot, resolveInstance, type InstanceResolution } from './resolve.js';
 
 interface ResolveCurrentInstanceDeps {
@@ -16,15 +15,12 @@ interface ResolveCurrentInstanceDeps {
 
 /** 현재 프로세스의 4층 판정 입력을 모아 순수 리졸버에 전달한다. */
 export function resolveCurrentInstance(deps: ResolveCurrentInstanceDeps = {}): InstanceResolution {
-  const cwd = (deps.cwd ?? (() => process.cwd()))();
   const explicitFlagRoot = (deps.explicitFlagRoot ?? (() =>
     getAppliedGlobalTestRoot() ?? getTestStateRoot() ?? getElanousConfigDirOverride()))();
-  const treeRoot = (process.argv[1] ? treeFromScriptPath(process.argv[1]) : null) ?? findTreeRoot(cwd);
   const resolution = resolveInstance({
     explicitFlagRoot,
     stampedStateDir: (deps.stampedStateDir ?? (() => process.env.ELANOUS_STATE_DIR))(),
     installedCopy: isInstalledCopyScript(),
-    treeTestRoot: treeRoot ? join(treeRoot, '.elanous-test') : null,
     prodRoot: prodInstanceRoot(),
   });
   debug.log('instance.current', 'resolved', { layer: resolution.layer, kind: resolution.kind });

package/src/instance/resolve.ts

@@ -1,9 +1,9 @@
-// 인스턴스 우주: 명시 루트 → 부모 스탬프 → 설치본 → 소스 트리 격리.
+// 인스턴스 우주: 명시 루트 → 부모 스탬프 → 운영 집. 트리 위치는 우주를 고르지 않는다.
 import { homedir } from 'node:os';
 import { join, resolve } from 'node:path';
 
 export type InstanceKind = 'prod' | 'test';
-export type ResolutionLayer = 'explicit-flag' | 'parent-stamp' | 'installed' | 'tree-derived' | 'default';
+export type ResolutionLayer = 'explicit-flag' | 'parent-stamp' | 'installed' | 'default';
 
 export interface InstanceResolution {
   kind: InstanceKind;
@@ -50,10 +50,9 @@ export function resolveInstance(deps: ResolveDeps = {}): InstanceResolution {
   }
   const installed = deps.installedCopy ?? isInstalledExecution();
   if (installed) return { kind: 'prod', root: prodRoot, layer: 'installed', why: '설치본으로 실행' };
-  const treeTestRoot = deps.treeTestRoot === undefined ? treeDerivedRootFor(process.cwd()) : deps.treeTestRoot;
-  if (treeTestRoot) return { kind: 'test', root: normRoot(treeTestRoot), layer: 'tree-derived', why: '소스 트리(격리)' };
-  // 레포 밖의 비설치 실행은 운영 권위를 얻지 않는다. 격리 루트를 cwd 에 둔다.
-  return { kind: 'test', root: normRoot(join(process.cwd(), '.elanous-test')), layer: 'default', why: '소스 트리 밖 실행(격리)' };
+  // Explicit --test selects a test root before this resolver runs. A checkout,
+  // worktree, or arbitrary cwd alone never changes the operating house.
+  return { kind: 'prod', root: prodRoot, layer: 'default', why: '명시 시험 우주가 없는 운영 집' };
 }
 
 /** 부모가 도장으로 물려준 우주와 자식이 실제로 쓰는 우주가 다른가. 비어 있는 쪽은 비교하지 않는다. */

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

@@ -29,6 +29,9 @@ export const DEFAULT_GITHUB_STAR_DAYS = 30;
  */
 export const DEFAULT_GITHUB_STAR_PER_QUERY = 20;
 
+/** 하루당 별 증가 상위 이 개수 행만 README 를 싣고 `surge.score` 를 받는다. */
+const GITHUB_SURGE_TOP = 3;
+
 export interface GithubStarRepo {
   fullName: string;
   url: string;
@@ -223,7 +226,7 @@ export async function collectGithubStars(
   }).sort((a, b) => (b.starsPerDay ?? -Infinity) - (a.starsPerDay ?? -Infinity) || b.stars - a.stars);
   const readmes = new Map<string, string>();
   if (!opts.dryRun) {
-    for (const row of repos.slice(0, 3)) {
+    for (const row of repos.slice(0, GITHUB_SURGE_TOP)) {
       try {
         readmes.set(row.repo, `README:\n${(await (opts.fetchReadme ?? ghApiFetchReadme)(row.repo)).slice(0, 1_500)}`);
       } catch {
@@ -231,7 +234,7 @@ export async function collectGithubStars(
       }
     }
   }
-  const raws: RawIntakeItem[] = repos.map((row) => ({
+  const raws: RawIntakeItem[] = repos.map((row, rank) => ({
     url: row.url,
     title: row.title,
     // 모든 행 첫 줄에 라이선스: SPDX · 확인된 부재는 «없음» · 응답이 알려 주지 않으면 «미상»(없음으로 읽지 않는다).
@@ -240,6 +243,8 @@ export async function collectGithubStars(
       stars: row.stars,
       ...(row.starsDelta !== undefined ? { starsDelta: row.starsDelta } : {}),
       ...(row.starsPerDay !== undefined ? { starsPerDay: row.starsPerDay } : {}),
+      // 급등 상위 3 행(README 를 싣는 그 셋)만 1위 3 · 2위 2 · 3위 1 — pickAbsorbQueue 가 `.score` 로 앞세운다.
+      ...(rank < GITHUB_SURGE_TOP ? { 'surge.score': GITHUB_SURGE_TOP - rank } : {}),
     },
   }));
   const result: CollectGithubResult = {

package/src/intake-plane/lens.ts

@@ -43,8 +43,13 @@ export interface AnnotateIntakeLensResult {
   capped: boolean;
 }
 
+/** 렌즈가 판정하는 갈래 — 하루 상한을 갈래별로 번갈아 나눈다(한 갈래가 많아도 다른 갈래가 0 이 되지 않게). */
+export type LensLane = 'outbox' | 'github' | 'x';
+export const LENS_LANES: readonly LensLane[] = ['outbox', 'github', 'x'];
+
 interface GroupedItem {
   id: string;
+  lane?: LensLane;
   facts: { fact: string; current: string }[];
   url?: string;
 }
@@ -88,7 +93,7 @@ function groupOutbox(root: string, day: string): GroupedItem[] {
       if (!id || !fact) continue;
       let group = groups.get(id);
       if (!group) {
-        group = { id, facts: [] };
+        group = { id, lane: 'outbox', facts: [] };
         groups.set(id, group);
         order.push(id);
       }
@@ -113,12 +118,39 @@ function ledgerLensItems(root: string, day: string, existing: ReadonlySet<string
         .map((fact) => ({ fact, current: '' }));
       if (!facts.length) continue;
       seen.add(item.id);
-      items.push({ id: item.id, facts, url: item.url });
+      items.push({ id: item.id, lane: source, facts, url: item.url });
     }
   }
   return items;
 }
 
+/**
+ * 남은 몫(remaining)을 갈래별로 번갈아 채운다 — 매 칸마다 «이미 판정된 수 ⊕ 이번에 고른 수»가 가장 적은 갈래에서
+ * 하나를 꺼낸다(동점이면 LENS_LANES 순서). 비거나 다 쓴 갈래의 몫은 남은 갈래로 넘어간다. 총량은 remaining 을 넘지 않는다.
+ */
+export function fairLensBatch<T extends { id: string; lane?: LensLane }>(
+  pending: readonly T[],
+  doneByLane: Readonly<Partial<Record<LensLane, number>>>,
+  remaining: number,
+): T[] {
+  const queues = new Map<LensLane, T[]>(LENS_LANES.map((lane) => [lane, []]));
+  for (const item of pending) queues.get(item.lane ?? 'outbox')!.push(item);
+  const used = new Map<LensLane, number>(LENS_LANES.map((lane) => [lane, doneByLane[lane] ?? 0]));
+  const picked = new Set<string>();
+  for (let n = 0; n < remaining; n++) {
+    let best: LensLane | undefined;
+    for (const lane of LENS_LANES) {
+      if (!queues.get(lane)!.length) continue;
+      if (best === undefined || used.get(lane)! < used.get(best)!) best = lane;
+    }
+    if (best === undefined) break;
+    picked.add(queues.get(best)!.shift()!.id);
+    used.set(best, used.get(best)! + 1);
+  }
+  // 원래 순서를 지킨다(흡수 → GitHub → X).
+  return pending.filter((item) => picked.has(item.id));
+}
+
 function judgedIds(file: string): Set<string> {
   return new Set(readJsonl(file).flatMap((row) => typeof row.id === 'string' && row.id ? [row.id] : []));
 }
@@ -171,10 +203,20 @@ export async function annotateIntakeLens(
   const pending = items.filter((item) => !done.has(item.id));
   const remaining = Math.max(0, LENS_DAILY_CAP - done.size);
   const capped = pending.length > remaining;
-  const batch = pending.slice(0, remaining);
+  const doneByLane: Partial<Record<LensLane, number>> = {};
+  for (const item of items) {
+    if (!done.has(item.id)) continue;
+    const lane = item.lane ?? 'outbox';
+    doneByLane[lane] = (doneByLane[lane] ?? 0) + 1;
+  }
+  const batch = capped ? fairLensBatch(pending, doneByLane, remaining) : pending;
   if (capped) {
-    const skippedIds = pending.slice(remaining).map((item) => item.id);
+    const chosen = new Set(batch.map((item) => item.id));
+    const skippedIds = pending.filter((item) => !chosen.has(item.id)).map((item) => item.id);
+    const byLane = (list: readonly GroupedItem[]) => Object.fromEntries(LENS_LANES.map((lane) =>
+      [lane, list.filter((item) => (item.lane ?? 'outbox') === lane).length]));
     log('capped', { day, total: pending.length, judged: batch.length, skippedIds,
+      pendingByLane: byLane(pending), judgedByLane: byLane(batch), doneByLane,
       ...(skippedIds.length ? { marker: `외 ${skippedIds.length}건 · 원장 \`elanous intake items\`` } : {}) });
   }
   const judgeOne = deps.judge ?? ((input: LensJudgeInput) => defaultJudge(input));

package/src/intake-plane/requirement-funnel.ts

@@ -12,6 +12,7 @@ import { getUserConfig } from '../user-config.js';
 import { dateKey } from '../time/format.js';
 import { cardIndexPath, CardStore, type TaskCard } from '../task-cards/card-store.js';
 import { loadIntakeLedger, type IntakeItem } from './items.js';
+import { RequirementLedger } from '../requirements/requirement-ledger.js';
 import { parseRubric, rubricGrade, rubricScore } from '../release-loop/rubric.js';
 
 export type RequirementSource = 'directive' | 'intake' | 'grounding' | 'coordination' | 'linear';
@@ -67,6 +68,8 @@ export interface FunnelOptions {
   allowedLicenses?: readonly string[];
   placement?: PlacementDeps;
   adopt?: (candidate: RequirementCandidate, version: string, cellId: string, evidence: string) => void;
+  /** REQ-INTAKE-ALL (0.2.25) piece 1: REQ-LEDGER side-record — every candidate captured once (idempotent on candidate id); adopted decisions fold to `placed`. */
+  ledger?: RequirementLedger;
 }
 
 /** How many of the last 24 hours' unlinked directives the single P0 brief line names (the full backlog is one count). */
@@ -170,6 +173,15 @@ export function runRequirementFunnel(options: FunnelOptions): RequirementFunnelR
       cellId, version: placement.version, rubric });
     if (!isDirective) used++;
   }
+  // REQ-INTAKE-ALL (0.2.25) piece 1: record every funnel candidate into the REQ-LEDGER side-ledger
+  // (idempotent on candidate id). The ledger is a side-record — a capture failure must not change the
+  // funnel result or any other command's default behavior (preservation contract).
+  if (options.ledger) {
+    try { captureFunnelCandidates(decisions, options.ledger); }
+    catch (error) {
+      debug.log('intake.requirement-funnel', 'ledger-capture-failed', { error: error instanceof Error ? error.message : String(error) });
+    }
+  }
   const unlinkedDirectives = [...directiveCandidates(options.historicalDirectives ?? []).filter(candidate =>
     candidate.text && Number.isFinite(Date.parse(candidate.receivedAt)) && Date.parse(candidate.receivedAt) <= now.getTime()
     && !linkFor(candidate, cells) && !arrivals.some(arrival => arrival.id === candidate.id)),
@@ -202,7 +214,46 @@ export function runRequirementFunnel(options: FunnelOptions): RequirementFunnelR
   return { counts, candidates: groups.size, decisions, unlinkedDirectives, briefItems };
 }
 
-/** Existing ledgers only; no source collector or sender is started here. */
+/**
+ * REQ-INTAKE-ALL (0.2.25) piece 1 — record the funnel's five entrances (directive · intake · grounding ·
+ * coordination · linear) into the REQ-LEDGER. Each decision captures one row per candidate (its `sources`
+ * members) with status `captured`, kind fixed to `fr`, source {kind, at: receivedAt}, statement = one-line
+ * text and tags = [priority] (the funnel's own P1 default when the candidate carries none). Idempotent on
+ * candidate id — re-running adds no rows. Adopted decisions fold their rows to `placed`. Per source with
+ * fresh rows it emits debug.log('requirements.intake', 'captured', {source, count}). Ledger validation
+ * (secret-shape rejection, allowlist) stays REQ-LEDGER's share; kind classification (REQ-KINDS) is a later
+ * piece — kind is fixed to `fr` here.
+ */
+export function captureFunnelCandidates(candidates: readonly RequirementDecision[], ledger: RequirementLedger): void {
+  const statuses = new Map(ledger.list().map(row => [row.id, row.status] as const));
+  const fresh = new Map<RequirementSource, number>();
+  for (const decision of candidates) {
+    for (const candidate of decision.sources) {
+      if (statuses.has(candidate.id)) continue;
+      // One bad candidate (secret-shaped text · unparseable time) must not stop the rest of the capture.
+      try {
+        const at = new Date(candidate.receivedAt).toISOString(); // ledger takes UTC `…Z` only; sources may carry offsets
+        ledger.capture({ id: candidate.id, statement: oneLine(candidate.text), kind: 'fr',
+          source: { kind: candidate.source, at }, tags: [candidate.priority ?? 'P1'] });
+      } catch (error) {
+        debug.log('intake.requirement-funnel', 'ledger-capture-failed', { id: candidate.id, source: candidate.source,
+          error: error instanceof Error ? error.message : String(error) });
+        continue;
+      }
+      statuses.set(candidate.id, 'captured');
+      fresh.set(candidate.source, (fresh.get(candidate.source) ?? 0) + 1);
+    }
+    if (decision.status !== 'adopted') continue;
+    for (const candidate of decision.sources) {
+      if (statuses.get(candidate.id) !== 'captured') continue;
+      ledger.place(candidate.id);
+      statuses.set(candidate.id, 'placed');
+    }
+  }
+  for (const [source, count] of fresh) debug.log('requirements.intake', 'captured', { source, count });
+}
+
+/** Existing ledgers only; no source collector or sender is started here. Side effect: captures every candidate into this universe's REQ-LEDGER (REQ-INTAKE-ALL). */
 export function readRequirementFunnel(options: { stateDir?: string; now?: Date; mode?: 'shadow' | 'live'; dailyCap?: number;
   allowedLicenses?: readonly string[]; grounding?: readonly IncomingRequirement[]; coordination?: readonly IncomingRequirement[];
   linear?: readonly IncomingRequirement[]; placement?: PlacementDeps } = {}): RequirementFunnelResult {
@@ -276,6 +327,7 @@ export function readRequirementFunnel(options: { stateDir?: string; now?: Date;
     grounding: today(options.grounding ?? fromQueue('outbox/grounding.jsonl')),
     coordination: today(options.coordination ?? cardRequests.coordination), linear: today(options.linear ?? cardRequests.linear) }, historicalDirectives, cells, now, mode,
     dailyCap, adoptedToday: todayCount, allowedLicenses, placement: { ...options.placement, schedules },
+    ledger: new RequirementLedger({ stateDir }),
     adopt: (candidate, version, cellId, evidence) => {
       placeCell({ id: cellId, title: candidate.text, owner: candidate.owner ?? 'OP', priority: candidate.priority ?? 'P1',
         predecessors: [], ...(candidate.deadlineVersion ? { deadlineVersion: candidate.deadlineVersion } : {}) }, { ...options.placement, now, schedules });