elanous 0.2.22 → 0.2.24

package/src/instance/child-scope.ts

@@ -2,7 +2,7 @@ import { debug } from '../debug/log.js';
 import { getUserConfig, type SelfImplementChildInstanceMode } from '../user-config.js';
 import { readFileSync } from 'node:fs';
 import { join, resolve } from 'node:path';
-import { effectiveInstanceRoot, prodInstanceRoot, treeDerivedRootFor } from './resolve.js';
+import { effectiveInstanceRoot, prodInstanceRoot, measureUniverse, treeDerivedRootFor, universeMismatch, type UniverseMeasure } from './resolve.js';
 
 interface ChildInstanceScope {
   configDir?: string;
@@ -69,6 +69,33 @@ function instanceScopeLog(event: string, data: Record<string, unknown>, warn = f
   debug.log('instance.identity', event, data, warn ? { level: 'warn' } : undefined);
 }
 
+/**
+ * 부모가 도장(`ELANOUS_STATE_DIR`)으로 물려준 우주와 이 프로세스가 실제로 쓰는 우주를 대조한다.
+ * 다르면 `instance.identity universe-mismatch` 경고 한 줄을 남긴다 — 막지 않고 적기만 한다.
+ * 도장이 없으면(사람이 직접 띄운 입구) 비교할 부모가 없으므로 조용하다.
+ */
+export function observeUniverseMismatch(
+  deps: { stamp?: string | undefined; effectiveRoot?: () => string; log?: ChildInstanceScopeDeps['log'] } = {},
+): { parentRoot: string; childRoot: string } | null {
+  const stamp = 'stamp' in deps ? deps.stamp : process.env.ELANOUS_STATE_DIR;
+  const mismatch = universeMismatch(stamp, (deps.effectiveRoot ?? effectiveInstanceRoot)());
+  if (mismatch) (deps.log ?? instanceScopeLog)('universe-mismatch', { ...mismatch, why: 'child resolved a different universe than the one its parent stamped' }, true);
+  return mismatch;
+}
+
+/**
+ * 읽을 우주가 비어 있으면 «0» 이 아니라 «측정 불가(빈 우주)» 라고 `instance.identity universe-unmeasurable` 로 적는다.
+ * 새 test 우주는 늘 비어 있으므로 경고(warn)가 아니라 정보 한 줄이다 — 막지 않고 적기만 한다.
+ */
+export function observeEmptyUniverse(
+  root: string,
+  deps: { entries?: (dir: string) => string[]; log?: ChildInstanceScopeDeps['log'] } = {},
+): UniverseMeasure {
+  const measure = measureUniverse(root, deps.entries);
+  if (!measure.measurable) (deps.log ?? instanceScopeLog)('universe-unmeasurable', { root, reason: measure.reason, why: '읽을 우주가 비어 있어 0 이 아니라 측정 불가로 취급한다' });
+  return measure;
+}
+
 /** Resolve the current universe once; operational parents derive an isolated child universe by default. */
 export function childInstanceScope(deps: ChildInstanceScopeDeps = {}): ChildInstanceScope {
   const elanousBinRoot = resolve(import.meta.dir, '../..');
@@ -77,6 +104,10 @@ export function childInstanceScope(deps: ChildInstanceScopeDeps = {}): ChildInst
   const parentIsProduction = root === prodRoot;
   const mode = (deps.childInstanceMode ?? configuredChildInstanceMode)();
   const log = deps.log ?? instanceScopeLog;
+  if (!deps.effectiveRoot) {
+    observeUniverseMismatch({ effectiveRoot: () => root, log });
+    observeEmptyUniverse(root, { log });
+  }
 
   const readProvider = deps.rawProviderAt ?? rawLlmProviderAt;
   /** 자식이 갈 우주의 provider 가 운영과 어긋나는지 «한 칸»으로 남긴다. 판정하지 않고 적기만 한다. */

package/src/instance/dev-project.ts

@@ -0,0 +1,133 @@
+import { execFileSync } from 'node:child_process';
+import { createHash, randomBytes } from 'node:crypto';
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+import { elanousStateRoot } from '../autopilot/state-paths.js';
+
+export interface DevProjectDeps {
+  git?: (dir: string, args: readonly string[]) => string | null;
+  stateDir?: string;
+}
+
+interface DevProjectRegistry {
+  projects: Record<string, string>;
+}
+
+interface DevProjectCache {
+  identityKey: string;
+  devProject: string;
+}
+
+const ULID_ALPHABET = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
+
+export function resolveDevProject(dir: string, deps: DevProjectDeps = {}): string {
+  const suppliedDir = resolve(dir);
+  const git = deps.git ?? runGit;
+  const gitRoot = git(suppliedDir, ['rev-parse', '--show-toplevel'])?.trim();
+  const root = gitRoot ? resolve(gitRoot) : suppliedDir;
+  let identityKey: string;
+  // A repo with no commit yet (`git init` only) has no first commit to anchor on — it falls back to
+  // the path identity like a plain folder until its first commit exists.
+  const rootCommits = gitRoot
+    ? git(root, ['rev-list', '--max-parents=0', 'HEAD'])?.trim().split(/\s+/).filter(Boolean) ?? []
+    : [];
+
+  if (rootCommits.length > 0) {
+    const firstCommit = rootCommits.length === 1 ? rootCommits[0]! : rootCommits
+      .map((commit) => ({
+        commit,
+        timestamp: Number(git(root, ['show', '-s', '--format=%ct', commit])?.trim()),
+      }))
+      .filter(({ timestamp }) => Number.isFinite(timestamp))
+      .sort((left, right) => left.timestamp - right.timestamp || left.commit.localeCompare(right.commit))[0]?.commit;
+    if (!firstCommit) throw new Error(`Unable to resolve oldest root commit for git project at ${root}`);
+    const remote = git(root, ['remote', 'get-url', 'origin']);
+    identityKey = `git:${firstCommit}:${normalizeRemoteUrl(remote ?? '')}`;
+  } else {
+    identityKey = `path:${createHash('sha256').update(root).digest('hex')}`;
+  }
+
+  const stateDir = resolve(deps.stateDir ?? elanousStateRoot());
+  const registryPath = join(stateDir, 'dev-projects.json');
+  const registry = readRegistry(registryPath);
+  const id = registry.projects[identityKey] ?? newDevProjectId();
+  if (!registry.projects[identityKey]) {
+    registry.projects[identityKey] = id;
+    writeJsonAtomically(registryPath, registry);
+  }
+
+  // The cache is disposable (RFC §4f): a read-only root must not stop the id from resolving.
+  try {
+    writeJsonAtomically(join(root, '.elanous', 'project.json'), { identityKey, devProject: id } satisfies DevProjectCache);
+  } catch { /* cache only */ }
+  return id;
+}
+
+function runGit(dir: string, args: readonly string[]): string | null {
+  try {
+    return execFileSync('git', ['-C', dir, ...args], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+  } catch {
+    return null;
+  }
+}
+
+function normalizeRemoteUrl(remote: string): string {
+  const value = remote.trim();
+  if (!value) return '';
+
+  const scp = /^(?![a-z][a-z0-9+.-]*:\/\/)(?:[^@/]+@)?([^:/]+):(.+)$/.exec(value);
+  if (scp) return normalizeRemotePath(`${scp[1]!.toLowerCase()}/${scp[2]}`);
+
+  try {
+    const url = new URL(value);
+    return normalizeRemotePath(`${url.hostname.toLowerCase()}${url.pathname}`);
+  } catch {
+    return normalizeRemotePath(resolve(value));
+  }
+}
+
+function normalizeRemotePath(value: string): string {
+  return value.replace(/\\/g, '/').replace(/\/+$/, '').replace(/\.git$/i, '');
+}
+
+/**
+ * The registry is the source of truth for prj- ids. A missing file starts a fresh registry; an
+ * existing but unreadable/corrupt one throws instead of silently re-issuing every project a new id.
+ */
+function readRegistry(path: string): DevProjectRegistry {
+  let raw: string;
+  try {
+    raw = readFileSync(path, 'utf8');
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return { projects: {} };
+    throw error;
+  }
+  let parsed: Partial<DevProjectRegistry> | undefined;
+  try { parsed = JSON.parse(raw) as Partial<DevProjectRegistry>; } catch { parsed = undefined; }
+  if (parsed?.projects && typeof parsed.projects === 'object' && !Array.isArray(parsed.projects)) {
+    return { projects: parsed.projects as Record<string, string> };
+  }
+  throw new Error(`dev-projects registry is corrupt: ${path}`);
+}
+
+function writeJsonAtomically(path: string, value: unknown): void {
+  mkdirSync(dirname(path), { recursive: true });
+  const temporaryPath = join(dirname(path), `.${basename(path)}.${process.pid}.${newDevProjectId()}.tmp`);
+  writeFileSync(temporaryPath, `${JSON.stringify(value, null, 2)}\n`, { flag: 'wx' });
+  renameSync(temporaryPath, path);
+}
+
+function newDevProjectId(): string {
+  const now = BigInt(Date.now());
+  let timestamp = '';
+  for (let index = 9; index >= 0; index -= 1) {
+    timestamp += ULID_ALPHABET[Number((now >> BigInt(index * 5)) & 31n)];
+  }
+
+  const entropy = BigInt(`0x${randomBytes(10).toString('hex')}`);
+  let random = '';
+  for (let index = 15; index >= 0; index -= 1) {
+    random += ULID_ALPHABET[Number((entropy >> BigInt(index * 5)) & 31n)];
+  }
+  return `prj-${timestamp}${random}`;
+}

package/src/instance/resolve.ts

@@ -56,6 +56,30 @@ export function resolveInstance(deps: ResolveDeps = {}): InstanceResolution {
   return { kind: 'test', root: normRoot(join(process.cwd(), '.elanous-test')), layer: 'default', why: '소스 트리 밖 실행(격리)' };
 }
 
+/** 부모가 도장으로 물려준 우주와 자식이 실제로 쓰는 우주가 다른가. 비어 있는 쪽은 비교하지 않는다. */
+export function universeMismatch(parentRoot: string | undefined, childRoot: string | undefined): { parentRoot: string; childRoot: string } | null {
+  const parent = parentRoot?.trim();
+  const child = childRoot?.trim();
+  if (!parent || !child) return null;
+  const p = normRoot(parent);
+  const c = normRoot(child);
+  return p === c ? null : { parentRoot: p, childRoot: c };
+}
+
+export type UniverseMeasure = { measurable: true } | { measurable: false; reason: '빈 우주' };
+
+/** 읽을 우주가 비어 있으면 «0» 이 아니라 «측정 불가» 로 말해야 한다. 디렉터리가 없거나 항목이 하나도 없으면 빈 우주다. */
+export function measureUniverse(root: string, entries: (dir: string) => string[] = defaultEntries): UniverseMeasure {
+  return entries(root).length > 0 ? { measurable: true } : { measurable: false, reason: '빈 우주' };
+}
+
+function defaultEntries(dir: string): string[] {
+  try {
+    const { readdirSync } = require('node:fs') as typeof import('node:fs');
+    return readdirSync(dir);
+  } catch { return []; }
+}
+
 /** 명시 config-dir 이 없으면 state-dir 과 config-dir 을 같은 우주로 유지한다. */
 export function configDirFollowingStateDir(
   explicitConfigDir: string | undefined,

package/src/instance/spawn-elanous.ts

@@ -0,0 +1,45 @@
+// 자식 elanous 기동의 단일 입구. 우주는 부모가 한 번 정해 ELANOUS_STATE_DIR 도장으로 물려준다.
+import { spawn, spawnSync, type ChildProcess, type SpawnOptions, type SpawnSyncOptions, type SpawnSyncReturns } from 'node:child_process';
+import { resolve } from 'node:path';
+import { stateDirSourceForChild } from '../agent/identity-env.js';
+import { effectiveInstanceRoot } from './resolve.js';
+
+const DEFAULT_BIN = resolve(import.meta.dir, '../../bin/elanous.mjs');
+
+export interface SpawnElanousOptions {
+  /** 자식이 쓸 우주. 생략하면 부모의 effectiveInstanceRoot(). 명시한 값이 이긴다. */
+  stateDir?: string;
+  /** 실행할 elanous 진입 스크립트. 생략하면 이 트리의 bin/elanous.mjs. */
+  bin?: string;
+  cwd?: string;
+  env?: NodeJS.ProcessEnv;
+}
+
+export interface ElanousInvocation {
+  command: string;
+  args: string[];
+  env: NodeJS.ProcessEnv;
+}
+
+/** 자식 기동 명세를 만든다. env 는 부모 env 위에 우주 도장(뿌리 ⊕ 출처)을 얹은 것이다. */
+export function elanousInvocation(args: readonly string[], opts: SpawnElanousOptions = {}): ElanousInvocation {
+  const root = opts.stateDir?.trim() || effectiveInstanceRoot();
+  const base = opts.env ?? process.env;
+  return {
+    command: process.execPath,
+    args: [opts.bin ?? DEFAULT_BIN, ...args],
+    env: { ...base, ELANOUS_STATE_DIR: root, ELANOUS_STATE_DIR_SOURCE: stateDirSourceForChild(root, base) },
+  };
+}
+
+export function spawnElanous(args: readonly string[], opts: SpawnElanousOptions & Omit<SpawnOptions, 'env' | 'cwd'> = {}): ChildProcess {
+  const { stateDir: _s, bin: _b, env: _e, ...rest } = opts;
+  const inv = elanousInvocation(args, opts);
+  return spawn(inv.command, inv.args, { ...rest, cwd: opts.cwd, env: inv.env });
+}
+
+export function spawnElanousSync(args: readonly string[], opts: SpawnElanousOptions & Omit<SpawnSyncOptions, 'env' | 'cwd'> = {}): SpawnSyncReturns<string | Buffer> {
+  const { stateDir: _s, bin: _b, env: _e, ...rest } = opts;
+  const inv = elanousInvocation(args, opts);
+  return spawnSync(inv.command, inv.args, { ...rest, cwd: opts.cwd, env: inv.env });
+}

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

@@ -41,6 +41,7 @@ export interface GithubStarRepo {
 
 /** 질의 하나 → 저장소 목록. 실제 구현은 `gh api` · 시험은 가짜. */
 export type SearchGithubRepos = (query: string, perQuery: number) => Promise<GithubStarRepo[]>;
+export type FetchGithubReadme = (fullName: string) => Promise<string>;
 
 export interface StarSnapshot { day: string; repo: string; stars: number }
 
@@ -175,6 +176,8 @@ export interface CollectGithubOpts {
   now?: () => Date;
   /** 등록 원천이 질의 하나만 수집할 때; 생략 시 관심 질의 전부 (최대 10개). */
   queries?: readonly string[];
+  /** 상위 세 저장소의 README 텍스트를 가져온다. 생략 시 gh api 사용. */
+  fetchReadme?: FetchGithubReadme;
 }
 
 /**
@@ -218,11 +221,21 @@ export async function collectGithubStars(
       ...(surge.baselineDays !== undefined ? { baselineDays: surge.baselineDays } : {}),
     };
   }).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)) {
+      try {
+        readmes.set(row.repo, `README:\n${(await (opts.fetchReadme ?? ghApiFetchReadme)(row.repo)).slice(0, 1_500)}`);
+      } catch {
+        readmes.set(row.repo, 'README 미상');
+      }
+    }
+  }
   const raws: RawIntakeItem[] = repos.map((row) => ({
     url: row.url,
     title: row.title,
     // 모든 행 첫 줄에 라이선스: SPDX · 확인된 부재는 «없음» · 응답이 알려 주지 않으면 «미상»(없음으로 읽지 않는다).
-    text: `라이선스: ${row.license ?? '미상'}\n${row.text}`,
+    text: `라이선스: ${row.license ?? '미상'}\n${readmes.has(row.repo) ? `${readmes.get(row.repo)}\n` : ''}${row.text}`,
     signals: {
       stars: row.stars,
       ...(row.starsDelta !== undefined ? { starsDelta: row.starsDelta } : {}),
@@ -274,6 +287,11 @@ export function reposFromGhSearchItems(items: GhSearchItem[], perQuery: number):
   return repos.slice(0, perQuery);
 }
 
+/** GitHub README raw 응답 — API 실패는 호출자가 해당 저장소의 «미상»으로 격리한다. */
+export const ghApiFetchReadme: FetchGithubReadme = async (fullName) => execFileSync('gh', [
+  'api', `repos/${fullName}/readme`, '-H', 'Accept: application/vnd.github.raw+json',
+], { encoding: 'utf8', timeout: 30_000, maxBuffer: 2 * 1024 * 1024 });
+
 /** `gh api search/repositories` 를 `sort=stars` 로 한 번 부른다. */
 export const ghApiSearchRepos: SearchGithubRepos = async (query, perQuery) => {
   const perPage = Math.min(100, Math.max(1, perQuery));

package/src/intake-plane/digest.ts

@@ -9,7 +9,8 @@ import { intakeOutboxDir, kstDay } from './route.js';
 
 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; seat?: 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 } }
+export interface DigestLedgerEntry { id: string; title: string; url: string; verdict: DigestLensVerdict | '참고' | '판정 대기' }
+export interface IntakeDigest { day: string; seat?: string; absorbed: DigestEntry[]; goals: { fact: string; url?: string }[]; news?: { title: string; url: string; summary: string[]; implication: string[] }[]; xTrends?: DigestLedgerEntry[]; githubNew?: DigestLedgerEntry[]; 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: '그 밖',
@@ -69,29 +70,31 @@ export function buildIntakeDigest(root: string, day: string, readFile: (p: strin
   const briefedEarlier = new Set(selectedSeat
     ? readJsonl(seatBriefFile(root, selectedSeat)).filter((r) => typeof r.id === 'string' && r.day !== day).map((r) => r.id as string)
     : []);
-  const items = [...loadIntakeLedger(root).items.values()]
+  const ledgerItems = [...loadIntakeLedger(root).items.values()];
+  const items = ledgerItems
     .filter((i) => (selectedSeat === undefined || (i.seat === selectedSeat && !briefedEarlier.has(i.id)))
       && (selectedSeat ? i.status !== 'discarded' : (i.status === 'absorbed' || i.status === 'routed') && i.outputs.some((o) => o.kind === 'note'))
       && kstDay(i.lastSeenAt) === day);
   const out = intakeOutboxDir(root);
-  const relevant = new Map<string, NonNullable<DigestEntry['impact']>>();
-  // 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 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 allLensRows = readJsonl(join(out, 'lens', `${day}.jsonl`));
+  const ledgerDecisions = new Map<string, { verdict: Exclude<DigestLedgerEntry['verdict'], '판정 대기'>; why: string; target: string }>();
+  // The first valid lens row owns an ID's verdict for both absorbed notes and same-day ledger sections.
+  for (const row of allLensRows) {
+    if (typeof row.id !== 'string' || ledgerDecisions.has(row.id)) continue;
+    const verdict = row.lensVerdict;
+    if (verdict !== '대체 후보' && 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;
+    ledgerDecisions.set(row.id, { verdict, why, target });
   }
   const absorbed = items.map((i: IntakeItem): DigestEntry => {
     const note = [...i.outputs].reverse().find((o) => o.kind === 'note')?.ref;
     const md = note ? readFile(note) : undefined;
-    const impact = relevant.get(i.id);
+    const decision = ledgerDecisions.get(i.id);
+    const impact = decision && decision.verdict !== '참고'
+      ? { verdict: decision.verdict, why: decision.why, target: decision.target } : undefined;
     return {
       id: i.id, sources: i.sources, ...(i.url ? { url: i.url } : {}),
       ...(note ? { note, noteName: basename(note, '.md') } : {}),
@@ -101,11 +104,19 @@ export function buildIntakeDigest(root: string, day: string, readFile: (p: strin
     };
   });
   const goals = selectedSeat ? [] : readJsonl(join(out, 'goals', `${day}.jsonl`)).map((g) => ({ fact: String(g.fact ?? ''), ...(g.url ? { url: String(g.url) } : {}) }));
-  const lensRows = selectedSeat ? [] : readJsonl(join(out, 'lens', `${day}.jsonl`));
+  const lensRows = selectedSeat ? [] : allLensRows;
   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 ledgerEntry = (item: IntakeItem): DigestLedgerEntry => ({
+    id: item.id, title: item.title?.trim() || item.url!, url: item.url!,
+    verdict: ledgerDecisions.get(item.id)?.verdict ?? '판정 대기',
+  });
+  const sameDayLedger = selectedSeat ? [] : ledgerItems
+    .filter((item) => item.status !== 'discarded' && item.url && kstDay(item.lastSeenAt) === day);
+  const xTrends = sameDayLedger.filter((item) => item.sources.includes('x')).map(ledgerEntry);
+  const githubNew = sameDayLedger.filter((item) => item.sources.includes('github')).map(ledgerEntry);
   const shadowSuggestions = lensRows.flatMap((row) =>
     Array.isArray(row.suggestions) ? row.suggestions.flatMap((raw: unknown) => {
       if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return [];
@@ -118,7 +129,7 @@ export function buildIntakeDigest(root: string, day: string, readFile: (p: strin
   const lastNewAt = selectedSeat ? undefined : readSavedCursorAt(root);
   const silentMs = lastNewAt ? now.getTime() - Date.parse(lastNewAt) : NaN;
   return {
-    day, ...(selectedSeat ? { seat: selectedSeat } : {}), absorbed, goals, ...(news.length ? { news } : {}), ...(shadowSuggestions.length ? { shadowSuggestions } : {}), review, grounding,
+    day, ...(selectedSeat ? { seat: selectedSeat } : {}), absorbed, goals, ...(news.length ? { news } : {}), ...(xTrends.length ? { xTrends } : {}), ...(githubNew.length ? { githubNew } : {}), ...(shadowSuggestions.length ? { shadowSuggestions } : {}), review, grounding,
     release: selectedSeat ? 0 : readJsonl(join(out, 'release', `${day}.jsonl`)).length,
     manual: selectedSeat ? 0 : readJsonl(join(out, 'manual', `${day}.jsonl`)).length,
     ...(!selectedSeat && lastNewAt && silentMs > SAVED_SILENCE_MS ? { savedSilence: { days: Math.floor(silentMs / 86_400_000), lastNewAt } } : {}),
@@ -142,8 +153,10 @@ function digestReferenceLine(entries: DigestEntry[]): string {
 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('오늘 흡수한 것이 없다.', '');
-  if (!d.absorbed.length && !d.news?.length) return L.join('\n');
+  if (!d.absorbed.length && !d.news?.length && !d.xTrends?.length && !d.githubNew?.length) {
+    L.push('오늘 흡수한 것이 없다.', '');
+    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) {
@@ -160,6 +173,12 @@ export function renderDigestMarkdown(d: IntakeDigest): string {
     }
     L.push('');
   }
+  for (const [heading, entries] of [['X 트렌드', d.xTrends], ['GitHub 신규', d.githubNew]] as const) {
+    if (!entries?.length) continue;
+    L.push(`### ${heading} (${entries.length})`, '');
+    for (const entry of entries) L.push(`- [${entry.title}](${entry.url}) — ${entry.verdict}`);
+    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})` : ''}`);
@@ -189,6 +208,12 @@ export function renderDigestTelegram(d: IntakeDigest, _opts: { vaultRoot?: strin
     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(' · ')}`);
+  for (const [heading, entries] of [['X 트렌드', d.xTrends], ['GitHub 신규', d.githubNew]] as const) {
+    if (!entries?.length) continue;
+    L.push('', `${heading} (${entries.length})`);
+    for (const entry of entries.slice(0, 5)) L.push(`- [${entry.verdict}] ${entry.title} — ${entry.url}`);
+    if (entries.length > 5) L.push(`외 ${entries.length - 5}건 · 원장 \`elanous intake items\``);
+  }
   // At most three items are shown, each as its own S·C·A·note block so context and source stay paired.
   // 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);

package/src/intake-plane/lens.ts

@@ -1,10 +1,11 @@
-// 흡수 렌즈 — outbox 항목마다 «우리에게 무엇인가»를 판정해 outbox/lens/<day>.jsonl 에만 남긴다.
-// 원 갈래(goals·manual·review·release)는 읽기만 한다. LLM 은 judge 한 번(id 당).
+// 흡수 렌즈 — E1 outbox 와 같은 날 공개 GitHub·X 원장 항목을 판정해 outbox/lens/<day>.jsonl 에만 남긴다.
+// 원 갈래(goals·manual·review·release)와 원장은 읽기만 한다. LLM 은 judge 한 번(id 당).
 import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { debug } from '../debug/log.js';
 import { judge } from '../llm/judge-layer.js';
-import { intakeOutboxDir } from './route.js';
+import { loadIntakeLedger } from './items.js';
+import { intakeOutboxDir, kstDay } from './route.js';
 
 export const LENS_VERDICTS = ['대체 후보', '보강', '경쟁 대조', '참고'] as const;
 export type LensVerdict = (typeof LENS_VERDICTS)[number];
@@ -98,6 +99,26 @@ function groupOutbox(root: string, day: string): GroupedItem[] {
   return order.map((id) => groups.get(id)!);
 }
 
+function ledgerLensItems(root: string, day: string, existing: ReadonlySet<string>): GroupedItem[] {
+  const items: GroupedItem[] = [];
+  const seen = new Set(existing);
+  const ledger = [...loadIntakeLedger(root).items.values()];
+  for (const source of ['github', 'x'] as const) {
+    for (const item of ledger) {
+      if (!item.id || seen.has(item.id) || item.status === 'discarded' || item.privacy !== 'public'
+        || !item.url || kstDay(item.lastSeenAt) !== day || !item.sources?.includes(source)) continue;
+      const title = item.title?.trim();
+      const text = item.text?.trim();
+      const facts = [title, text].filter((value): value is string => Boolean(value)).slice(0, LENS_FACT_CAP)
+        .map((fact) => ({ fact, current: '' }));
+      if (!facts.length) continue;
+      seen.add(item.id);
+      items.push({ id: item.id, facts, url: item.url });
+    }
+  }
+  return items;
+}
+
 function judgedIds(file: string): Set<string> {
   return new Set(readJsonl(file).flatMap((row) => typeof row.id === 'string' && row.id ? [row.id] : []));
 }
@@ -130,7 +151,7 @@ async function defaultJudge(item: GroupedItem): Promise<unknown> {
   return decision.value;
 }
 
-/** 그날 outbox 를 id 로 묶어 아직 없는 판정만 남긴다. 원 갈래 파일은 쓰지 않는다. */
+/** 그날 E1 outbox 뒤에 공개 GitHub·X 원장을 붙여 아직 없는 판정만 남긴다. 원천 파일은 쓰지 않는다. */
 export async function annotateIntakeLens(
   root: string,
   day: string,
@@ -142,13 +163,20 @@ export async function annotateIntakeLens(
     log('skipped-test', {});
     return empty;
   }
-  const items = groupOutbox(root, day);
+  const outbox = groupOutbox(root, day);
+  const ledger = ledgerLensItems(root, day, new Set(outbox.map((item) => item.id)));
+  const items = [...outbox, ...ledger];
   const file = join(intakeOutboxDir(root), 'lens', `${day}.jsonl`);
   const done = judgedIds(file);
   const pending = items.filter((item) => !done.has(item.id));
-  const capped = pending.length > LENS_DAILY_CAP;
-  const batch = pending.slice(0, LENS_DAILY_CAP);
-  if (capped) log('capped', { day, total: pending.length, judged: batch.length });
+  const remaining = Math.max(0, LENS_DAILY_CAP - done.size);
+  const capped = pending.length > remaining;
+  const batch = pending.slice(0, remaining);
+  if (capped) {
+    const skippedIds = pending.slice(remaining).map((item) => item.id);
+    log('capped', { day, total: pending.length, judged: batch.length, skippedIds,
+      ...(skippedIds.length ? { marker: `외 ${skippedIds.length}건 · 원장 \`elanous intake items\`` } : {}) });
+  }
   const judgeOne = deps.judge ?? ((input: LensJudgeInput) => defaultJudge(input));
   const now = deps.now ?? (() => new Date().toISOString());
   let judged = 0;

package/src/intake-plane/ref-prefetch.ts

@@ -0,0 +1,110 @@
+import type { RegisteredIntakeSource } from './intake-sources.js';
+
+/** listChecklist(v).items 꼴 — 호출 쪽이 다음 두 판 칸을 모아 넘긴다. */
+export interface PrefetchCell {
+  id: string;
+  title: string;
+  status: string;
+  refs?: readonly string[];
+  /** 그 판 날짜(YYYY-MM-DD). 주제 until 로 실린다. */
+  until?: string;
+}
+
+export interface PrefetchTopic {
+  topic: string;
+  cellIds: string[];
+  until?: string;
+}
+
+export interface PrefetchTopicsOpts {
+  max?: number;
+}
+
+/**
+ * 의도적 경계: 이 파일은 제안만 만든다. intake CLI `prefetch --dry-run|--apply` 와
+ * REQ-LEDGER 테마 원천 교체는 다음 조각 — addSource · CLI 를 부르지 않는다.
+ */
+function backtickTokens(title: string): string[] {
+  const tokens: string[] = [];
+  const re = /`([^`]+)`/g;
+  for (let match = re.exec(title); match; match = re.exec(title)) {
+    const token = match[1]!.trim();
+    if (token) tokens.push(token);
+  }
+  return tokens;
+}
+
+function englishProperNouns(title: string): string[] {
+  const stripped = title.replace(/`[^`]*`/g, ' ');
+  const tokens: string[] = [];
+  // CamelCase · 내부 대문자 식별자, 또는 2글자 이상 대문자(하이픈 칸 id 포함).
+  const re = /\b(?:[A-Z][A-Za-z0-9]*[A-Z][A-Za-z0-9]*|[A-Z]{2,}(?:-[A-Z0-9]+)*)\b/g;
+  for (let match = re.exec(stripped); match; match = re.exec(stripped)) tokens.push(match[0]);
+  return tokens;
+}
+
+function rfcNames(refs: readonly string[] | undefined): string[] {
+  if (!refs) return [];
+  const names: string[] = [];
+  for (const ref of refs) {
+    const file = (ref.split('#')[0] ?? '').split('/').pop() ?? '';
+    const stem = file.replace(/\.[A-Za-z0-9]+$/, '').replace(/-\d{4}-\d{2}-\d{2}$/, '');
+    if (stem.startsWith('RFC-') && stem.length > 4) names.push(stem);
+  }
+  return names;
+}
+
+function laterDate(a: string | undefined, b: string | undefined): string | undefined {
+  if (!a) return b;
+  if (!b) return a;
+  return a >= b ? a : b;
+}
+
+function sourceId(topic: string): string {
+  const slug = topic.replace(/[^\w.-]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 48);
+  return `ref-prefetch-${slug || 'topic'}`;
+}
+
+export function prefetchTopics(cells: readonly PrefetchCell[], opts: PrefetchTopicsOpts = {}): PrefetchTopic[] {
+  const max = opts.max ?? 5;
+  const byTopic = new Map<string, { topic: string; count: number; cellIds: string[]; until?: string }>();
+  const order: string[] = [];
+  for (const cell of cells) {
+    if (cell.status !== 'yellow') continue;
+    const tokens = new Set([
+      ...englishProperNouns(cell.title),
+      ...backtickTokens(cell.title),
+      ...rfcNames(cell.refs),
+    ]);
+    for (const topic of tokens) {
+      let acc = byTopic.get(topic);
+      if (!acc) {
+        acc = { topic, count: 0, cellIds: [], until: cell.until };
+        byTopic.set(topic, acc);
+        order.push(topic);
+      }
+      acc.count++;
+      if (!acc.cellIds.includes(cell.id)) acc.cellIds.push(cell.id);
+      acc.until = laterDate(acc.until, cell.until);
+    }
+  }
+  return order
+    .map((topic) => byTopic.get(topic)!)
+    .sort((a, b) => b.count - a.count || order.indexOf(a.topic) - order.indexOf(b.topic))
+    .slice(0, Math.max(0, max))
+    .map(({ topic, cellIds, until }) => until === undefined ? { topic, cellIds } : { topic, cellIds, until });
+}
+
+export function prefetchSources(topics: readonly PrefetchTopic[], seat: string, now: Date): RegisteredIntakeSource[] {
+  // 판 날짜를 모르면 until 을 비운다 — now 로 채우면 untilMs(그날 00:00Z) 기준으로 이미 만료된 제안이 된다.
+  void now;
+  return topics.map((entry) => ({
+    id: sourceId(entry.topic),
+    seat,
+    kind: 'github-query',
+    spec: entry.topic,
+    every: '1d',
+    ...(entry.until === undefined ? {} : { until: entry.until }),
+    why: `REF-PREFETCH ⊕ ${entry.cellIds.join(' ')}`,
+  }));
+}

package/src/intelligence-map/model-alias.ts

@@ -35,6 +35,12 @@ const MODEL_ALIASES: Readonly<Record<string, string>> = {
   'opus-5':          'claude-opus-5',
   'opus-4-8':        'claude-opus-4-8',
   'opus-4-7':        'claude-opus-4-7',    // 하위호환
+  // ⭐ 2026-10-10 (MK) — 5.5 세대는 판을 붙여서만 부른다(맨몸 `sonnet`·`haiku` 는 옮기지 않았다 — 별개 결정).
+  //   공식 API id 는 하이픈(`claude-sonnet-5-5`)인데 OpenRouter·사람은 점(`claude-sonnet-5.5`)으로 쓴다 — 둘 다 받는다.
+  'sonnet-5-5':        'claude-sonnet-5-5',
+  'haiku-5-5':         'claude-haiku-5-5',
+  'claude-sonnet-5.5': 'claude-sonnet-5-5',
+  'claude-haiku-5.5':  'claude-haiku-5-5',
   // Google Gemini family
   'flash':           'gemini-3.8-flash',   // ⭐ 2026-09-25 최신 flash(models.list 실측)
   'flash-3-7':       'gemini-3.7-flash',