elanous 0.2.4 → 0.2.6

package/src/chat/index.ts

@@ -107,9 +107,27 @@ import {
 import { resolveTextInputControlAction } from './input-control-key.js';
 import { resolveTextInputEditAction } from './input-edit-key.js';
 import { resolveTextInputTextAction } from './input-text-key.js';
+import { classifyLeftoverInput, summarizeSubmitText } from './submit-trace.js';
 
 import { perf } from '../perf-counters.js';
 
+let lastSubmitAt: number | null = null;
+
+function traceAfterSubmitKey(key: Key): void {
+  if (lastSubmitAt === null) return;
+  const withinMs = Date.now() - lastSubmitAt;
+  if (withinMs > 1000) {
+    lastSubmitAt = null;
+    return;
+  }
+  if (key.ctrl || key.alt) return;
+  const input = key.name === 'paste' ? key.paste ?? '' : key.name;
+  if (!input || (key.name !== 'paste' && [...input].length !== 1)) return;
+  lastSubmitAt = null;
+  const kind = classifyLeftoverInput(input, withinMs);
+  if (kind) debug.log('chat.input.leftover', 'after-submit', { withinMs, kind });
+}
+
 /** Row where the input prompt starts — set by the textInput paint
  *  loop so writeTerminal knows which rows to invalidate in the
  *  frame cache. Falls back to "invalidate everything" when unknown
@@ -419,14 +437,14 @@ export const SLASH_COMMANDS: SlashCommand[] = [
   // B4 — craft rulebook verdict, same resolution as `elanous repo design-check`
   //   and the PWA `/design-check` panel. Listed (not baselined as hidden) on
   //   purpose: a surface nobody can discover is not a surface.
-  { name: 'design',    aliases: ['design-check'], description: 'Craft rulebooks — 이 저장소 DESIGN.md 가 선언한 규칙집 · 못 찾은 것 · elanous 가 주는데 선언 안 된 것. /design [--declared] · /design pick [번호|id] 디자인 방향 선택', subcommands: ['--declared', 'pick'] },
+  { name: 'design',    aliases: ['design-check'], description: 'Design rulebooks this repository declares · /design [--declared] · /design pick [number|id] to choose a design direction', subcommands: ['--declared', 'pick'] },
   { name: 'provider',  aliases: ['p'],          description: 'LLM providers — /provider (list) · next (cycle, also Alt+M / pill click) · use <name> · pick (visual picker) · reset', subcommands: ['next', 'use', 'pick', 'picker', 'menu', 'reset', 'list'] },
   { name: 'reasoning', aliases: ['r', 'think'],  description: 'Reasoning level (codex effort + summary, anthropic extended-thinking budget) — /reasoning [off|low|medium|high|xhigh] (cycle when no arg · xhigh 는 모델 상한이 xhigh 이상일 때만 wire 에 실린다, 아니면 high 로 깎인다)', subcommands: ['off', 'low', 'medium', 'high', 'xhigh'] },
   { name: 'model',     aliases: ['m'],           description: 'Switch active model — /model <codex|terra|sol|luna|opus|sonnet|grok> (list + current when no arg). OpenAI 는 Codex(Responses API)만. effort 는 /reasoning.', subcommands: ['codex', 'terra', 'sol', 'luna', 'opus', 'sonnet', 'grok'] },
   { name: 'local',     aliases: ['ll'],         description: 'Local OpenAI-compatible LLM — ping / models / test / use', subcommands: ['ping', 'models', 'test', 'use', 'status'] },
   { name: 'session',   aliases: ['sess'],       description: 'Session resume — list / load / sync / new (handoff from mobile)', subcommands: ['list', 'load', 'sync', 'new'] },
-  { name: 'resume',    aliases: [],             description: 'Resume session — 픽커에서 선택 · /resume <id-prefix> 즉시 로드 (TUI 부활 S-a)' },
-  { name: 'fork',      aliases: [],             description: 'Fork — 현 시점 전체 복사로 새 세션 분기 (codex /fork 동형)' },
+  { name: 'resume',    aliases: [],             description: 'Pick a past session, or load one by id prefix · /resume <id-prefix>' },
+  { name: 'fork',      aliases: [],             description: 'Copy this session into a new one' },
   { name: 'rewind',    aliases: [],             description: 'Rewind — 과거 user 턴 픽커로 되감기 (원본 보존 · 새 세션 분기 · /rewind <n> 숏컷)' },
   // TUI 부활 C-a (2026-07-12): autopilot 미션 TUI 표면 — CLI 동등 단일 창구 소비.
   { name: 'mission',   aliases: [],             description: 'Autopilot 미션 — list(+헬스) · trace <id> 계보 · arm <id> 승인 (구체화/종료는 CLI)', subcommands: ['list', 'trace', 'arm'] },
@@ -468,7 +486,7 @@ export const SLASH_COMMANDS: SlashCommand[] = [
   { name: 'acp',    aliases: [], description: 'ACP chat — stream claude-code / codex / gemini replies into the chat pane (not a VW spawn). /acp codex points at the canonical codex app-server path; /acp cas is a synonym.', subcommands: ['claude', 'codex', 'gemini', 'cas', 'cancel', 'status', 'drop'] },
   { name: 'conv', aliases: [], description: 'Conversation widget/popup host — /conv list · /conv open <session-id> · /conv layout <cascade|tile|stack> · /conv focus <next|prev>.', subcommands: ['list', 'ls', 'open', 'layout', 'focus'] },
   { name: 'handoff', aliases: [], description: 'H5 P3 cross-agent context handoff: /handoff <from_session_id> <to_brand> [--channels r,p,m] [--prompt "prefix"]. Takes source session snapshot (filtered by channels if observer present) and launches target via adapter registry. Brands: codex · claude · claude-code · gemini · elanous.' },
-  { name: 'remaining', aliases: [], description: '계정마다 행으로 「지금 쓸 수 있는 것이 얼마나 남았나」를 본다 — 크레딧 축과 구독 축을 갈라 낸다. 화면은 명령 산출을 그대로 읽는다.' },
+  { name: 'remaining', aliases: [], description: 'What each account has left' },
   { name: 'agent-room', aliases: [], description: 'H6 P4 VW agent-room — /agent-room <N> <brands...> · /agent-room list · /agent-room close <id> · N ∈ {2,3,4} · brands: codex/claude/gemini/elanous/auto/lll:<m>', subcommands: ['list', 'close', 'preset', 'help'] },
   { name: 'showroom', aliases: ['sr'], description: 'Showroom v2 multi-LLM lane composer — /showroom (default 2-pane) · /showroom <lane1> <lane2> [<lane3> [<lane4>]] · lane = role:provider[:transport] · roles plan/build/exec/review/reflect · pair with /lane and /relay for cross-lane handoffs.', subcommands: ['help'] },
   { name: 'reply',   aliases: [], description: 'H6 P5 AgentReply — /reply <target-session-id> <message...> · send message to a live session, capture the response · flags: --from · --channels r,m · --idle-ms · --timeout-ms', subcommands: ['help'] },
@@ -701,6 +719,8 @@ export async function textInput(opts: {
    *  typing. The host is expected to mutate its own state; the input
    *  redraws the bar + picker on top afterward. */
   onMouse?: (mouse: { row: number; col: number; type: 'click' | 'double-click' | 'right-click' | 'scroll-up' | 'scroll-down' | 'drag' | 'release'; shift?: boolean }) => void | boolean | Promise<void | boolean>;
+  /** Scroll the host's chat log from the input without editing its buffer. */
+  onScrollKey?: (name: 'pageup' | 'pagedown') => boolean | void;
   /** MX11b — key interceptor called BEFORE textInput's own key
    *  handling. Host returns 'consumed' to short-circuit the event
    *  (no further input processing), 'passthrough' to let the default
@@ -1331,13 +1351,15 @@ export async function textInput(opts: {
     writeTerminal(endTextInputCursor(opts.cursorSink));
     return result;
   };
-  const submitBufferResult = (text: string): InputResult => (
-    finalizeInput({
+  const submitBufferResult = (text: string): InputResult => {
+    debug.log('chat.input.submit', 'summary', summarizeSubmitText(text.trim()));
+    lastSubmitAt = Date.now();
+    return finalizeInput({
       text: text.trim(),
       submitted: true,
       ...(pendingExternalSubmitSource ? { externalSubmitSource: pendingExternalSubmitSource } : {}),
-    })
-  );
+    });
+  };
   const currentBufferText = (): string => lines.join('\n').trim();
 
   // Expose drawAll so the host can ping us to re-paint after an
@@ -1401,6 +1423,7 @@ export async function textInput(opts: {
     }
 
     const key = await (opts.readKey ?? (() => readKey('input')))();
+    traceAfterSubmitKey(key);
 
     // Raw-key trace — diagnoses "modifier bit dropped before global-action
     // matcher saw the chord" cases (e.g. tablet terminal apps that
@@ -1627,6 +1650,11 @@ export async function textInput(opts: {
       }
     }
 
+    if (!key.ctrl && (key.name === 'pageup' || key.name === 'pagedown') && opts.onScrollKey) {
+      if (opts.onScrollKey(key.name) !== false) drawAll();
+      continue;
+    }
+
     const controlAction = resolveTextInputControlAction(key, {
       currentLine: lines[lineIdx] ?? '',
       cursor: colIdx,
@@ -1897,6 +1925,7 @@ export function attachStreamingKeys(
   };
   function deliver(keys: readonly Key[]): void {
     for (const key of keys) {
+      traceAfterSubmitKey(key);
       traceKey(key, 'stream');
       try {
         const r = handler(key);

package/src/chat/log-scroll-key.ts

@@ -0,0 +1,12 @@
+export function nextChatScrollOffset(
+  current: number,
+  key: 'pageup' | 'pagedown',
+  pageSize: number,
+  maxOffset: number,
+): number {
+  if (maxOffset <= 0) return -1;
+  const offset = current < 0 ? maxOffset : Math.max(0, Math.min(current, maxOffset));
+  if (key === 'pageup') return Math.max(0, offset - pageSize);
+  const next = offset + pageSize;
+  return next >= maxOffset ? -1 : next;
+}

package/src/chat/submit-trace.ts

@@ -0,0 +1,30 @@
+const LONE_JAMO = /[\u3131-\u318e\u1100-\u11ff]/u;
+const HANGUL_SYLLABLE = /[\uac00-\ud7a3]/u;
+
+export function summarizeSubmitText(text: string): {
+  chars: number;
+  lines: number;
+  lastIsLoneJamo: boolean;
+  loneJamoCount: number;
+  hasHangul: boolean;
+} {
+  const characters = [...text];
+  const loneJamoCount = characters.filter(char => LONE_JAMO.test(char)).length;
+  return {
+    chars: characters.length,
+    lines: text.split('\n').length,
+    lastIsLoneJamo: LONE_JAMO.test(characters.at(-1) ?? ''),
+    loneJamoCount,
+    hasHangul: loneJamoCount > 0 || HANGUL_SYLLABLE.test(text),
+  };
+}
+
+export function classifyLeftoverInput(
+  input: string,
+  msSinceSubmit: number,
+): 'syllable' | 'jamo' | null {
+  if (msSinceSubmit < 0 || msSinceSubmit > 1000 || [...input].length !== 1) return null;
+  if (HANGUL_SYLLABLE.test(input)) return 'syllable';
+  if (LONE_JAMO.test(input)) return 'jamo';
+  return null;
+}

package/src/cli/agent-cli.ts

@@ -1,7 +1,7 @@
 import type { Command } from 'commander';
 import { resolve } from 'node:path';
 import { getUserConfig, reloadUserConfig } from '../user-config.js';
-import { needsOnboarding, runOnboarding } from '../onboarding.js';
+import { handleOnboardingRefusal, needsOnboarding, runOnboarding } from '../onboarding.js';
 import { runTurn, ensureCliSession, sessionBudget } from '../session/chat.js';
 import { NoLlmProviderAvailableError, noProviderAvailableMessage } from '../llm.js';
 import { resolveSessionId, getActiveSessionId, setActiveSessionId } from '../session/index.js';
@@ -93,7 +93,12 @@ export function registerAgentCommands(program: Command): void {
     const cfg = getUserConfig();
     if (needsOnboarding(cfg)) {
       ui.info('No config yet — launching setup wizard first.');
-      await runOnboarding();
+      try {
+        await runOnboarding();
+      } catch (error) {
+        if (handleOnboardingRefusal(error, 'agent')) return;
+        throw error;
+      }
     }
     const refreshed = reloadUserConfig();
     await runChatTurnCli({

package/src/cli/decisions-cli.ts

@@ -0,0 +1,94 @@
+import type { Command } from 'commander';
+import { DecisionLedger, importDecisionMarkdown, type DecisionCategory, type DecisionLedgerOptions, type DecisionOption, type DecisionTrack, type DecisionEntry } from '../decisions/decision-ledger.js';
+
+const repeat = (value: string, values: string[]) => [...values, value];
+function date(raw?: string): string | undefined {
+  if (!raw) return undefined;
+  const days = /^(\d+)d$/.exec(raw);
+  const parsed = days ? new Date(Date.now() - Number(days[1]) * 86400000) : new Date(raw);
+  if (!Number.isFinite(parsed.getTime())) throw new Error(`invalid since: ${raw}`);
+  return parsed.toISOString();
+}
+const kst = (at: string) => new Intl.DateTimeFormat('sv-SE', { timeZone: 'Asia/Seoul', dateStyle: 'short', timeStyle: 'medium' }).format(new Date(at)) + ' KST';
+const version = (e: DecisionEntry['version']) => e ? `released=${e.released ?? '-'} · dev=${e.dev ?? '-'}${e.codename ? ` «${e.codename}»` : ''}` : '판 미상';
+function agent(o?: string): string {
+  const value = o?.trim() || process.env.AI_AGENT?.trim();
+  if (!value) throw new Error('agent unknown: provide --agent or AI_AGENT');
+  return value;
+}
+function parseOption(raw: string): DecisionOption {
+  const m = /^([a-z])=(.+?):(.+)$/.exec(raw);
+  if (!m) throw new Error(`invalid --option: ${raw} (expected a=label:consequence)`);
+  return { key: m[1]!, label: m[2]!, consequence: m[3]! };
+}
+export function formatDecisionRow(e: DecisionEntry): string {
+  const recommendation = 'skipped' in e.recommendation ? '권고 생략' : `${e.recommendation.option} (${e.recommendation.why})`;
+  return `${e.id} · ${e.category} · ${e.title} · ${recommendation} · ${e.raisedAt ? kst(e.raisedAt) : '올린 시각 미상'} · ${version(e.version)}`;
+}
+export function formatDecisionDetail(e: DecisionEntry): string {
+  return [formatDecisionRow(e), `상태: ${e.status}`, `S: ${e.scqa.s}`, `C: ${e.scqa.c}`, `Q: ${e.scqa.q ?? '(비움)'}`, `A: ${e.scqa.a ?? '(비움)'}`,
+    '선택지 | 결과', ...(e.options.length ? e.options.map(o => `${o.key}: ${o.label} | ${o.consequence}`) : ['원문에 선택지 없음 · 확인 필요']),
+    'skipped' in e.recommendation ? `권고 생략: ${e.recommendation.reason}` : `권고: ${e.recommendation.option} — ${e.recommendation.why}`,
+    `올림: ${e.raisedAt ? kst(e.raisedAt) : '시각 미상'} · ${e.raisedBy.agent} · ${version(e.version)}`,
+    ...(e.importedAt ? [`가져옴: ${kst(e.importedAt)}`] : []),
+    ...(e.status === 'decided' ? [`결정: ${e.decidedAt ? kst(e.decidedAt) : '시각 미상'} · ${e.decidedBy?.kind === 'auto' ? `AUTO ${e.decidedBy.agent} (${e.decidedBy.delegation})` : e.decidedBy?.kind === 'human' ? 'human' : '주체 미상'} · ${e.choice ?? '선택 키 미상'} · ${e.versionAtDecision ? version(e.versionAtDecision) : '결정 당시 판 미상'}`,
+      ...(e.note ? [`메모: ${e.note}`] : [])] : []),
+    ...(e.withdrawnAt ? [`철회: ${kst(e.withdrawnAt)} · ${e.withdrawReason}`] : []),
+    '이력:', ...e.history.map(h => `  ${h.type} · ${h.at ? kst(h.at) : '시각 미상'} · ${h.by}${h.choice ? ` · ${h.choice}` : ''}${h.reason ? ` · ${h.reason}` : ''} · ${h.version ? version(h.version) : '판 미상'}`),
+    ...(e.refs?.length ? [`참조: ${e.refs.join(' · ')}`] : [])].join('\n');
+}
+
+export function registerDecisionsCommands(program: Command, config: DecisionLedgerOptions = {}, out: Pick<Console, 'log'> = console): void {
+  const root = program.command('decisions').description('대표 결정 원장 · 로컬 전용');
+  const emit = (value: unknown, json?: boolean, text?: string) => out.log(json ? JSON.stringify(value) : text ?? JSON.stringify(value));
+  const fail = (action: () => void) => { try { action(); } catch (e) { throw new Error(`decisions: ${e instanceof Error ? e.message : String(e)}`); } };
+  root.command('raise').description('SCQA·선택지와 권고로 결정 항목을 올린다')
+    .requiredOption('--title <text>').requiredOption('--category <category>')
+    .requiredOption('--s <text>').requiredOption('--c <text>').option('--q <text>').option('--a <text>')
+    .requiredOption('--option <key=label:consequence>', '선택지 (두 번 이상)', repeat, [] as string[])
+    .option('--recommend <key>').option('--why <text>').option('--skip-recommend <reason>')
+    .option('--track <track>').option('--agent <agent>').option('--session <id>')
+    .option('--ref <url>', '참조 (반복)', repeat, [] as string[]).option('--json')
+    .action((o: { title: string; category: DecisionCategory; s: string; c: string; q?: string; a?: string; option: string[]; recommend?: string; why?: string; skipRecommend?: string; track?: DecisionTrack; agent?: string; session?: string; ref: string[]; json?: boolean }) => fail(() => {
+      if (o.skipRecommend !== undefined && (o.recommend !== undefined || o.why !== undefined)) throw new Error('choose recommendation or skip, not both');
+      if (o.skipRecommend === undefined && (!o.recommend || !o.why)) throw new Error('--recommend and --why required, or --skip-recommend <reason>');
+      const options: DecisionOption[] = o.option.map(parseOption);
+      const entry = new DecisionLedger(config).raise({ title: o.title, category: o.category, scqa: { s: o.s, c: o.c, ...(o.q ? { q: o.q } : {}), ...(o.a ? { a: o.a } : {}) }, options,
+        recommendation: o.skipRecommend !== undefined ? { skipped: true, reason: o.skipRecommend } : { option: o.recommend!, why: o.why! },
+        raisedBy: { agent: agent(o.agent), ...(o.track ? { track: o.track } : {}), ...(o.session ? { session: o.session } : {}) }, ...(o.ref.length ? { refs: o.ref } : {}) });
+      emit(entry, o.json, `올림: ${formatDecisionRow(entry)}`);
+    }));
+  root.command('list').description('결정 목록 (기본 열린 것)')
+    .option('--status <open|decided|all>', '기본 open', 'open').option('--since <date>').option('--version <version>')
+    .option('--decided-by <human|auto>').option('--category <category>').option('--json')
+    .action((o: { status: 'open' | 'decided' | 'all'; since?: string; version?: string; decidedBy?: 'human' | 'auto'; category?: DecisionCategory; json?: boolean }) => fail(() => {
+      const rows = new DecisionLedger(config).list({ status: o.status, since: date(o.since), version: o.version, decidedBy: o.decidedBy, category: o.category });
+      emit(rows, o.json, rows.length ? rows.map(formatDecisionRow).join('\n') : '결정 0건');
+    }));
+  root.command('show <id>').description('SCQA · 선택지 · 권고 · 이력 · 판').option('--json')
+    .action((id: string, o: { json?: boolean }) => fail(() => { const entry = new DecisionLedger(config).show(id); emit(entry, o.json, formatDecisionDetail(entry)); }));
+  root.command('decide <id> <option>').description('사람 또는 AUTO 위임 결정 기록')
+    .option('--note <text>').option('--auto').option('--delegation <reason>').option('--track <track>').option('--agent <agent>').option('--json')
+    .action((id: string, choice: string, o: { note?: string; auto?: boolean; delegation?: string; track?: DecisionTrack; agent?: string; json?: boolean }) => fail(() => {
+      if (o.auto && !o.delegation?.trim()) throw new Error('--auto requires --delegation');
+      if (!o.auto && (o.delegation || o.track || o.agent)) throw new Error('delegation/track/agent require --auto');
+      const by = o.auto ? { kind: 'auto' as const, agent: agent(o.agent), delegation: o.delegation!, ...(o.track ? { track: o.track } : {}) } : { kind: 'human' as const };
+      const entry = new DecisionLedger(config).decide(id, choice, by, o.note);
+      emit(entry, o.json, `결정: ${formatDecisionDetail(entry)}`);
+    }));
+  root.command('add-options <id>').description('선택지가 미기재된 과거 항목에 확인된 선택지를 추가')
+    .requiredOption('--option <key=label:consequence>', '선택지 (두 번 이상)', repeat, [] as string[])
+    .option('--agent <agent>').option('--json')
+    .action((id: string, o: { option: string[]; agent?: string; json?: boolean }) => fail(() => {
+      const entry = new DecisionLedger(config).addOptions(id, o.option.map(parseOption), agent(o.agent));
+      emit(entry, o.json, formatDecisionDetail(entry));
+    }));
+  root.command('withdraw <id>').description('결정 철회도 원장에 남긴다').requiredOption('--reason <reason>').option('--json')
+    .action((id: string, o: { reason: string; json?: boolean }) => fail(() => { const entry = new DecisionLedger(config).withdraw(id, o.reason); emit(entry, o.json, `철회: ${formatDecisionDetail(entry)}`); }));
+  root.command('import-markdown <file>').description('기존 대표 결정 문서 씨앗을 가져온다 (재실행 안전)').option('--json')
+    .action((file: string, o: { json?: boolean }) => fail(() => {
+      const result = importDecisionMarkdown(new DecisionLedger(config), file);
+      emit(result, o.json, `가져옴 ${result.imported.length} · 기존 ${result.existing.length} · 불완전 ${result.incomplete.length} · 못 읽음 ${result.unread.length}${result.incomplete.length ? `\n${result.incomplete.join('\n')}` : ''}${result.unread.length ? `\n${result.unread.join('\n')}` : ''}`);
+      if (result.unread.length) process.exitCode = 1;
+    }));
+}

package/src/cli/doctor-cli.ts

@@ -8,7 +8,7 @@ import { fileURLToPath } from 'node:url';
 import type { Command } from 'commander';
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
 import { discoverChromeBinary } from '../browser-cdp/client.js';
-import { listProviders } from '../oauth/store.js';
+import { resolveUsableLlm, type UsableLlm } from '../llm/usable-llm.js';
 import { detectLocale } from '../expression/locale.js';
 import { findRetiredConfigKeysInFile, getUserConfig, type RetiredConfigKey, type UserConfig } from '../user-config.js';
 import { codeRevision } from '../version/code-revision.js';
@@ -142,7 +142,8 @@ export interface DoctorOptions {
    */
   readiness?: ReadinessDeps;
   checkReadiness?: (deps: ReadinessDeps) => ReadinessReport;
-  /** Read-only auth-store provider names. Values are never requested. */
+  resolveLlm?: () => UsableLlm;
+  /** Legacy read-only seam; route selection no longer uses provider-name presence. */
   listAuthProviders?: () => readonly string[];
   /** Read-only `codeRevision()`. */
   codeRevision?: () => string | undefined;
@@ -187,15 +188,6 @@ export interface DoctorCliDeps extends DoctorOptions, Pick<DoctorFixDeps, 'home'
 const repositoryRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../..');
 const tavilyNames = new Set(['TAVILY_API_KEY', 'TAVILY_KEY']);
 
-function codexLoginPresent(providers: readonly string[]): boolean {
-  return providers.some((name) => name === 'openai-codex' || name.startsWith('openai-codex:'));
-}
-
-/** Presence only. Token strings from the auth store never leave this function. */
-function defaultListAuthProviders(): readonly string[] {
-  return listProviders();
-}
-
 function defaultCodeRevision(): string | undefined {
   try {
     return codeRevision();
@@ -294,7 +286,6 @@ interface ReadinessLookup {
   platform: NodeJS.Platform;
   commandExists: (name: string) => boolean;
   getConfig: () => UserConfig;
-  listAuthProviders: () => readonly string[];
   codeRevision: () => string | undefined;
   fetchHealth: () => { daemonSha?: string } | null;
   readInstallPrefix: () => string | null | undefined;
@@ -306,8 +297,6 @@ interface ReadinessLookup {
   /** 저장소가 시험한 bun 판(`.bun-version`) · 지금 도는 bun 판(시험 seam). */
   bunPin?: () => string | null;
   bunVersion?: () => string | null;
-  /** LLM 키가 하나라도 풀렸나(자격 보고서에서 · 없으면 못 쟀다). */
-  llmKeyResolved?: boolean;
   /** `/etc/os-release` 본문(시험 seam) — 못 읽으면 null. */
   readOsRelease?: () => string | null;
   /** 빌드 도구 탐침(시험 seam). */
@@ -371,19 +360,6 @@ function resolveReadinessDeps(lookup: ReadinessLookup): ReadinessDeps {
   if (provider !== null && provider !== 'auto' && !/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(provider)) {
     provider = null;
   }
-  let codexLogin: boolean | null = null;
-  let anyLogin: boolean | null = null;
-  try {
-    const providers = lookup.listAuthProviders();
-    codexLogin = codexLoginPresent(providers);
-    anyLogin = providers.length > 0;
-  } catch {
-    codexLogin = null;
-  }
-  // 로그인이 있거나 LLM 키가 풀렸으면 true · 둘 다 «아니라고 잰» 경우만 false · 하나라도 못 쟀으면 null.
-  const llmCredentialAvailable = anyLogin === true || lookup.llmKeyResolved === true
-    ? true
-    : anyLogin === false && lookup.llmKeyResolved === false ? false : null;
   const pathEntries = (lookup.env.PATH ?? '').split(lookup.pathDelimiter).filter((entry) => entry.length > 0);
   let ghOnPath: boolean | null = null;
   let ghAuthStatus: number | null = null;
@@ -466,8 +442,6 @@ function resolveReadinessDeps(lookup: ReadinessLookup): ReadinessDeps {
   }
   return {
     provider,
-    codexLogin,
-    llmCredentialAvailable,
     ghOnPath,
     ghAuthStatus,
     ghVersion,
@@ -1045,8 +1019,7 @@ export function runDoctor(options: DoctorOptions = {}): DoctorReport {
         pathDelimiter,
         platform,
         commandExists,
-        getConfig,
-        listAuthProviders: options.listAuthProviders ?? defaultListAuthProviders,
+        getConfig: () => resolutionOptions.userConfig,
         codeRevision: options.codeRevision ?? defaultCodeRevision,
         fetchHealth: options.fetchHealth ?? (() => defaultFetchHealth(options.resolveDaemonEndpoint ?? resolveDaemonEndpoint)),
         readInstallPrefix: options.readInstallPrefix ?? (() => defaultReadInstallPrefix(root, exists)),
@@ -1054,12 +1027,17 @@ export function runDoctor(options: DoctorOptions = {}): DoctorReport {
         ghAuthStatus: options.ghAuthStatus ?? (() => defaultGhAuthStatus(commandExists)),
         ghVersion: options.ghVersion ?? (() => defaultGhVersion(commandExists)),
         tmpdirSameFsAsBunCache: options.tmpdirSameFsAsBunCache ?? (() => defaultTmpdirSameFsAsBunCache(env)),
-        llmKeyResolved: llmKeyResolvedFrom(credentials),
         nodePty: nodePtyStatus(externalCommands.commands),
         ...(options.probeBuildToolchain ? { probeBuildToolchain: options.probeBuildToolchain } : {}),
         ...(options.checkPythonEnv ? { checkPythonEnv: options.checkPythonEnv } : {}),
         ...(options.probeHostEnvironment ? { probeHostEnvironment: options.probeHostEnvironment } : {}),
       });
+    // An injected readiness snapshot stays as-is. For a real machine, measure the
+    // same runtime route as `start` rather than inferring usability from key names.
+    if (options.readiness === undefined && readiness.provider !== null) {
+      try { readiness.usableLlm = options.resolveLlm ? options.resolveLlm() : resolveUsableLlm({ config: resolutionOptions.userConfig }); }
+      catch { readiness.usableLlm = null; }
+    }
     return {
       ok: true,
       credentials,
@@ -1083,15 +1061,14 @@ function formatReadiness(readiness: ReadinessReport | undefined): string[] {
   if (readiness === undefined) return [];
   const todo = readiness.items.filter((entry) => entry.status === 'manual' || entry.status === 'fixable');
   return [
-    '준비 상태:',
+    'Readiness:',
     ...readiness.items.map((entry) => {
       const remedy = entry.remedy === undefined ? '' : ` — ${entry.remedy}`;
       return `  ${entry.id}: ${entry.status} — ${entry.evidence}${remedy}`;
     }),
     todo.length === 0
-      ? '할 일 없음.'
-      // 처방은 줄마다 이미 있다 — 「fixable」이 곧 `doctor --fix` 는 아니다(install-path 의 처방은 export 한 줄).
-      : `할 일 ${todo.length}개: ${todo.map((entry) => entry.id).join(', ')} — 처방은 위 각 줄 끝`,
+      ? 'Nothing to do.'
+      : `To do (${todo.length}): ${todo.map((entry) => entry.id).join(', ')} — each line above ends with its fix`,
   ];
 }
 
@@ -1105,14 +1082,21 @@ function humanFreeFallback(value: string): string {
     .replace(/\s{2,}/g, ' ').trim().replace(/[—–·;,\s]+$/, '');
 }
 
+export function humanBreaks(value: string): string | undefined {
+  if (value.trim().toLowerCase() === 'unmeasured'
+    || /\b\d+ test (failures|errors)\b|\bmeasured\b|\bpostmortem\b|\bquota\b/i.test(value)
+    || /[가-힣ㄱ-ㅎㅏ-ㅣ]/.test(value)) return undefined;
+  return humanFreeFallback(value) || undefined;
+}
+
 function formatCapabilitySummary(summary: DoctorCapabilitySummary): string[] {
   const unavailable = summary.unavailable.map((capability) =>
     `  ${capability.name} — unlock with ${capability.credential}${capability.freeFallback !== undefined && humanFreeFallback(capability.freeFallback) ? `; free alternative: ${humanFreeFallback(capability.freeFallback)}` : ''}`,
   );
   return [
-    '할 수 있는 일:',
+    'Available:',
     ...(summary.available.length === 0 ? ['  None.'] : summary.available.map((capability) => `  ${capability.name} — unlocked by ${capability.credential}`)),
-    '못 하는 일:',
+    'Unavailable:',
     ...(unavailable.length === 0 ? ['  None.'] : unavailable),
     'Unknown by credential:',
     ...(summary.unknownCredentials.length === 0 ? ['  Empty.'] : summary.unknownCredentials.map((credential) => `  ${credential}`)),
@@ -1129,8 +1113,8 @@ export function formatDoctorReport(report: DoctorReport, options: { credentials?
   const satisfied = report.credentials.filter((credential) => !credential.resolved && credential.satisfiedBy !== undefined).length;
   return [
     ...formatReadiness(report.readiness),
-    ...(requiredMissing.length ? [`⛔ 필수 명령 없음: ${requiredMissing.join(', ')}`] : []),
-    `자격증명: ${resolved}/${report.credentials.length} resolved${satisfied ? ` · ${satisfied} satisfied by alternative names` : ''} · details: elanous doctor --credentials`,
+    ...(requiredMissing.length ? [`⛔ Required commands missing: ${requiredMissing.join(', ')}`] : []),
+    `Credentials: ${resolved}/${report.credentials.length} resolved${satisfied ? ` · ${satisfied} satisfied by alternative names` : ''} · details: elanous doctor --credentials`,
     ...(options.credentials ? report.credentials.map((credential) => [
       `${credential.name}: ${credential.resolved ? 'resolved' : 'unresolved'} (${credential.source}) — ${credential.note}`,
       ...(credential.satisfiedBy !== undefined ? [`  Satisfied by: ${credential.satisfiedBy.name} (${credential.satisfiedBy.source})`] : []),
@@ -1138,14 +1122,15 @@ export function formatDoctorReport(report: DoctorReport, options: { credentials?
       ...(credential.freeFallback !== undefined ? [`  Free fallback${credential.freeFallbackMode === 'auto' || credential.freeFallbackMode === 'manual' || credential.freeFallbackMode === 'none' ? ` [${credential.freeFallbackMode}]` : ''}: ${humanFreeFallback(credential.freeFallback)}`] : []),
     ].join('\n')) : []),
     ...(report.catalogMetadataUnavailable ? ['Catalog metadata unavailable: could not read catalog/resources.yaml.'] : []),
-    ...(report.retiredConfigKeys ?? []).map(({ path, reason }) => `더는 안 쓰는 설정 키: ${path} — ${reason}`),
+    ...(report.retiredConfigKeys ?? []).map(({ path, reason }) => `Retired config key: ${path} — ${reason}`),
     'External commands:',
     ...report.externalCommands.map((command) => {
       const breaks = command.status === 'broken' ? command.breaks_broken ?? command.breaks : command.breaks;
+      const visibleBreaks = breaks === undefined ? undefined : humanBreaks(breaks);
       const fix = command.status === 'broken' ? command.fix_broken ?? command.fix : command.fix;
       return [
         `${command.name}: ${command.status === 'skipped' ? `skipped (${command.platform}-only)` : `${command.status} (${command.tier})`}${command.detail === undefined ? '' : ` — ${command.detail}`}`,
-        ...((command.status === 'missing' || command.status === 'broken') && breaks !== undefined ? [`  Breaks: ${breaks}`] : []),
+        ...((command.status === 'missing' || command.status === 'broken') && visibleBreaks !== undefined ? [`  Breaks: ${visibleBreaks}`] : []),
         ...((command.status === 'missing' || command.status === 'broken') && fix !== undefined ? [`  Fix: ${fix}`] : []),
       ].join('\n');
     }),
@@ -1260,13 +1245,12 @@ export function registerDoctorCommand(program: Command, deps: DoctorCliDeps = {}
         home: deps.home,
         cacheDir: deps.cacheDir,
         readdir: deps.readdir,
-        readiness: deps.readiness ?? resolveReadinessDeps({
+        readiness: deps.readiness ?? { ...resolveReadinessDeps({
           env: deps.env ?? process.env,
           pathDelimiter: deps.pathDelimiter ?? delimiter,
           platform: deps.platform ?? process.platform,
           commandExists: deps.commandExists ?? ((name) => (deps.env ?? process.env).PATH?.split(deps.pathDelimiter ?? delimiter).some((dir) => existsSync(join(dir, name))) ?? false),
-          getConfig: deps.getUserConfig ?? getUserConfig,
-          listAuthProviders: deps.listAuthProviders ?? defaultListAuthProviders,
+          getConfig: () => deps.userConfig ?? (deps.getUserConfig ?? getUserConfig)(),
           codeRevision: deps.codeRevision ?? defaultCodeRevision,
           fetchHealth: deps.fetchHealth ?? (() => defaultFetchHealth(deps.resolveDaemonEndpoint ?? resolveDaemonEndpoint)),
           readInstallPrefix: deps.readInstallPrefix ?? (() => defaultReadInstallPrefix(deps.repositoryRoot ?? repositoryRoot, deps.exists ?? existsSync)),
@@ -1274,13 +1258,15 @@ export function registerDoctorCommand(program: Command, deps: DoctorCliDeps = {}
           // gh 판은 수리 계획에 쓰인다(낡은 gh → 정적 gh) — 🩸 09-25: 여기서 안 재서 계획은 보고서에만 뜨고 적용이 안 됐다.
           ghVersion: deps.ghVersion ?? (() => defaultGhVersion((name) => (deps.env ?? process.env).PATH?.split(deps.pathDelimiter ?? delimiter).some((dir) => existsSync(join(dir, name))) ?? false)),
           tmpdirSameFsAsBunCache: deps.tmpdirSameFsAsBunCache ?? (() => defaultTmpdirSameFsAsBunCache(deps.env ?? process.env)),
-          // 보고서와 같은 자로 — 로그인도 LLM 키도 없으면 계획에 «사람 한 줄»(로그인)이 실린다(🅢 #20263 ③).
-          ...(source.ok ? { llmKeyResolved: llmKeyResolvedFrom(source.credentials), nodePty: nodePtyStatus(source.externalCommands) } : {}),
+          ...(source.ok ? { nodePty: nodePtyStatus(source.externalCommands) } : {}),
           // L0 칸(substrate·docker·kubernetes·memory)은 «정보성·선택 기능»이라 수리 계획에 싣지 않는다 —
           // `--sudo` 가 `sudo systemctl start docker` 를 «설치 줄»로 치지 않게 하고, docker·kubectl 탐침(최대 수 초)을 두 번 돌리지 않는다.
           // 보고서(`runDoctor`)에는 그대로 나온다.
           probeHostEnvironment: () => null,
-        }),
+        }), usableLlm: (() => {
+          try { return deps.resolveLlm ? deps.resolveLlm() : resolveUsableLlm({ config: deps.userConfig ?? (deps.getUserConfig ?? getUserConfig)() }); }
+          catch { return null; }
+        })() },
         exists: deps.exists,
         readFile: deps.readFile,
         writeFile: deps.writeFile,
@@ -1374,16 +1360,16 @@ export function registerDoctorCommand(program: Command, deps: DoctorCliDeps = {}
       else out.log([
         formatDoctorReport(currentReport, { credentials: opts.credentials }),
         ...(advice ? [formatDoctorAdvice(advice)] : []),
-        '수정 계획:',
+        'Fix plan:',
         ...plan.items.map((item) => `  ${item.id}: ${item.status} — ${item.path} — ${item.action}${item.reason ? ` — ${item.reason}` : ''}`),
         ...plan.manual.map((item) => `  ${item.id}: manual${item.remedy ? ` — ${item.remedy}` : ''}`),
         ...manualCommandFixes(currentReport).map((line) => `  ${line}`),
-        ...(gitInstall ? [`git 설치: ${gitInstall.detail}${gitPlan?.note ? ` — ${gitPlan.note}` : ''}`] : []),
+        ...(gitInstall ? [`Git installation: ${gitInstall.detail}${gitPlan?.note ? ` — ${gitPlan.note}` : ''}`] : []),
         ...(sudoResult ? [sudoResult.sudoAvailable
-          ? `sudo 설치: ${sudoResult.runs.length ? sudoResult.runs.map((entry) => `${entry.result} — ${entry.command}${entry.detail ? ` — ${entry.detail}` : ''}`).join(' · ') : '칠 줄 없음'}`
-          : 'sudo 설치: 건너뜀 — 이 기계는 sudo 에 암호가 필요하다(sudo -n true 실패). 위 «manual» 줄을 직접 치세요.'] : []),
-        ...(results ? ['적용 결과:', ...results.items.map((item) => `  ${item.id}: ${item.result} — ${item.path}${item.reason ? ` — ${item.reason}` : ''}`)] : ['적용하려면 --fix --yes']),
-        ...(restartResult ? [`서비스 재시작: ${restartResult.result} — ${restartResult.reason}`] : []),
+          ? `Sudo installation: ${sudoResult.runs.length ? sudoResult.runs.map((entry) => `${entry.result} — ${entry.command}${entry.detail ? ` — ${entry.detail}` : ''}`).join(' · ') : '칠 줄 없음'}`
+          : 'Sudo installation: 건너뜀 — 이 기계는 sudo 에 암호가 필요하다(sudo -n true 실패). 위 «manual» 줄을 직접 치세요.'] : []),
+        ...(results ? ['Applied:', ...results.items.map((item) => `  ${item.id}: ${item.result} — ${item.path}${item.reason ? ` — ${item.reason}` : ''}`)] : ['적용하려면 --fix --yes']),
+        ...(restartResult ? [`Service restart: ${restartResult.result} — ${restartResult.reason}`] : []),
       ].join('\n'));
       const exitCode = Math.max(results?.exitCode ?? 0, sudoResult?.exitCode ?? 0, restartResult?.result === 'failed' ? 1 : 0, currentReport.requiredMissing?.length ? 1 : 0, gitInstall?.ran && !gitInstall.ok ? 1 : 0);
       if (results || exitCode) setExitCode(exitCode);

package/src/cli/doctor-readiness.ts

@@ -1,4 +1,5 @@
 import { remediesFor, type DistroFamily } from './doctor-distro.js';
+import type { UsableLlm } from '../llm/usable-llm.js';
 import { providerSecretNames } from '../nexus/install/launchd.js';
 import { win32 } from 'node:path';
 /**
@@ -42,13 +43,8 @@ export interface ReadinessDeps {
    * must pass `null` rather than omit it).
    */
   provider?: string | null;
-  /**
-   * Codex subscription login is present. `null` means not measured.
-   * The token itself is never passed in.
-   */
-  codexLogin?: boolean | null;
-  /** LLM 을 부를 자격이 «하나라도» 있나(어떤 로그인이든 · LLM 키가 풀렸든). 없으면(undefined/null) 못 쟀다. */
-  llmCredentialAvailable?: boolean | null;
+  /** Selected runtime route, already resolved with the runtime auto selector. null = unmeasured. */
+  usableLlm?: UsableLlm | null;
   /** `gh` is on PATH. `null` means not measured. */
   ghOnPath?: boolean | null;
   /** `gh --version` 의 판 · null/undefined = 못 쟀다. */
@@ -210,23 +206,19 @@ function providerDecision(deps: ReadinessDeps): ReadinessItem {
     return item('provider-decision', 'unknown', 'llm.provider was not measured');
   }
   const provider = deps.provider.trim() || 'auto';
-  if (provider !== 'auto') {
-    // 아는 provider 이름만 보여 준다 — 설정 칸에 자격 같은 값이 들어와 있어도 보고에 싣지 않는다.
-    const shown = KNOWN_PROVIDERS.has(provider) ? provider : '(set · value not shown)';
-    return item('provider-decision', 'ok', `llm.provider=${shown}`);
-  }
-  if (deps.codexLogin === undefined || deps.codexLogin === null) {
-    return item('provider-decision', 'unknown', 'llm.provider=auto but codex login was not measured');
-  }
-  if (deps.codexLogin === true) {
-    // 2026-09-24 결정(`#20142`) — auto 는 codex 구독을 먼저 쓰고 계정 회전·llm.fallbackChain 이 뒤를 잇는다.
-    return item('provider-decision', 'ok', 'llm.provider=auto uses the codex login first; account rotation and llm.fallbackChain apply');
-  }
-  // 🩸 2026-09-24 빈 VM(🅢 #20263): 로그인도 키도 없는데 여기서 `ok` 가 나왔다(거짓 초록) — auto 가 고를 것이 없다.
-  if (deps.llmCredentialAvailable === false) {
-    return item('provider-decision', 'manual', 'llm.provider=auto but no LLM login or key was found — LLM commands will fail', 'elanous login openai-codex');
-  }
-  return item('provider-decision', 'ok', 'llm.provider=auto and no codex login');
+  const shown = KNOWN_PROVIDERS.has(provider) ? provider : '(set · value not shown)';
+  if (deps.usableLlm == null) return item('provider-decision', 'unknown', `llm.provider=${shown} route was not measured`);
+  const { usable, provider: selected, via, why } = deps.usableLlm;
+  if (!usable) {
+    const reason = why === 'no usable LLM route selected' ? why : 'route unavailable';
+    const remedy = provider === 'auto' || provider === 'openai-codex' ? 'elanous login openai-codex'
+      : provider === 'openai' ? 'Set OPENAI_API_KEY or llm.apiKey for openai'
+      : provider === 'local' ? 'Set llm.baseUrl or LOCAL_LLM_URL for local'
+      : KNOWN_PROVIDERS.has(provider) ? `Configure credentials for llm.provider=${provider}` : undefined;
+    return item('provider-decision', 'manual', `llm.provider=${shown} selected no usable LLM (via none) — ${reason}`, remedy);
+  }
+  const selectedName = selected && KNOWN_PROVIDERS.has(selected) ? selected : 'selected provider';
+  return item('provider-decision', 'ok', `llm.provider=${shown} → ${via} ${selectedName}`);
 }
 
 /** Debian 계열 apt 의 gh 는 GH_MIN_VERSION 미만이다(📏 09-25: Debian 12 = 2.23 · Ubuntu 24.04 = 2.45) — apt 로 깔면 곧바로

package/src/cli/intake-cli.ts

@@ -282,7 +282,7 @@ export function registerIntakeCommands(program: Command): void {
         const { sendTelegramReport } = await import('../telegram-report.js');
         const { getUserConfig } = await import('../user-config.js');
         const text = renderDigestTelegram(d, { ...(opts.vault ? { vaultRoot: opts.vault } : {}), ...(opts.note ? { notePath: opts.note } : {}) });
-        const sent = await sendTelegramReport(getUserConfig(), text, { markdown: true });
+        const sent = await sendTelegramReport(getUserConfig(), text, { markdown: true, kind: 'intake' });
         debug.log('intake.digest', 'telegram', { day, absorbed: d.absorbed.length, goals: d.goals.length, sent });
         console.log(sent ? `텔레그램 보고 채널로 보냈다 (${day} · 흡수 ${d.absorbed.length} · 골 후보 ${d.goals.length})` : '텔레그램 보고 채널 설정이 없다(telegram.reportChannel) — 보내지 않음');
         if (!sent) process.exitCode = 3;

package/src/cli/mcp-call.ts

@@ -1,6 +1,7 @@
 import { resolveDaemonEndpoint, type ResolveDaemonEndpointOpts } from '../nexus/daemon-endpoint.js';
 import { RemotesStore } from './remotes.js';
 import { bookmarkAttachDefaults } from './remote-resolve.js';
+import { getNodeKind } from '../graph-kinds/registry.js';
 
 export type McpCliClassification =
   | 'ok'
@@ -84,7 +85,15 @@ export async function callDaemonMcpTool(opts: {
   arguments: Record<string, unknown>;
   endpoint?: string | ResolvedEndpoint;
   fetchFn?: McpCallOpts['fetchFn'];
+  pluginKind?: string;
 }): Promise<unknown> {
+  if (opts.pluginKind) {
+    const entry = getNodeKind('workflow', opts.pluginKind);
+    if (!entry || entry.core || !entry.plugin || !entry.run || !('mcp' in entry.run)
+      || opts.tool !== `${entry.run.mcp.server}.${entry.run.mcp.tool}`) {
+      throw new McpCliFailure('mcp-usage-error', 'invalid plugin MCP kind');
+    }
+  }
   const endpoint = typeof opts.endpoint === 'string' ? { url: opts.endpoint } : opts.endpoint;
   const resolved = endpoint ? { ok: true as const, value: endpoint } : resolveMcpEndpoint({});
   if (!resolved.ok) throw new McpCliFailure(resolved.classification, resolved.message);