elanous 0.2.7 → 0.2.9

package/src/cli/persona-cli.ts

@@ -0,0 +1,116 @@
+// PS1 — `elanous persona list|add|show`: 프리셋(persona-presets/)을 보고, 골라서 «내 페르소나»를 만들고, 만든 것을 본다.
+// 만든 페르소나는 기존 페르소나 저장소(resolveStatePersonaDir · Discord·PWA 가 읽는 곳)의 `<id>.yaml` 한 파일이다.
+import type { Command } from 'commander';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { debug } from '../debug/log.js';
+import { parsePersonaYaml } from '../persona/loader.js';
+import { resolveRepositoryPersonaDir, resolveStatePersonaDir } from '../persona/global-registry.js';
+import { choosePersonaId, describePreset, findPreset, loadPresetIndex, loadPresets, presetToProfileYaml } from '../persona/presets.js';
+
+interface StoredPersona { personaId: string; displayName: string; description?: string; preset?: string; title?: string; path: string }
+
+/** Personas the person made (state dir), parsed with the same loader the runtime uses. */
+export function readStoredPersonas(dir = resolveStatePersonaDir()): StoredPersona[] {
+  if (!existsSync(dir)) return [];
+  const out: StoredPersona[] = [];
+  for (const file of readdirSync(dir).filter((f) => f.endsWith('.yaml') && !f.startsWith('_')).sort()) {
+    const path = join(dir, file);
+    const text = readFileSync(path, 'utf8');
+    const parsed = parsePersonaYaml(text, path);
+    if (!parsed.ok) continue;
+    const origin = (parseYaml(text) as { preset?: { id?: unknown; title?: unknown } } | null)?.preset;
+    const preset = typeof origin?.id === 'string' ? origin.id : undefined;
+    const title = typeof origin?.title === 'string' ? origin.title : undefined;
+    out.push({ personaId: parsed.profile.personaId, displayName: parsed.profile.displayName, ...(parsed.profile.description ? { description: parsed.profile.description } : {}), ...(preset ? { preset } : {}), ...(title ? { title } : {}), path });
+  }
+  return out.sort((a, b) => a.personaId.localeCompare(b.personaId));
+}
+
+function takenIds(stateDir: string): Set<string> {
+  const ids = new Set(readStoredPersonas(stateDir).map((p) => p.personaId));
+  const repo = resolveRepositoryPersonaDir();
+  if (existsSync(repo)) for (const f of readdirSync(repo)) if (f.endsWith('.yaml')) ids.add(f.slice(0, -5));
+  if (existsSync(stateDir)) for (const f of readdirSync(stateDir)) if (f.endsWith('.yaml')) ids.add(f.slice(0, -5));
+  return ids;
+}
+
+export function registerPersonaCommands(program: Command): void {
+  const persona = program.command('persona').description('Persona presets — AI coworkers you pick and customise (list · add · show)');
+
+  persona.command('list')
+    .description('List the persona presets, then the personas you have made')
+    .option('--json', 'JSON output')
+    .action((opts: { json?: boolean }) => {
+      const presets = loadPresets();
+      const mine = readStoredPersonas();
+      debug.log('persona.cli', 'list', { presets: presets.length, mine: mine.length });
+      if (opts.json) { console.log(JSON.stringify({ presets: presets.map((p) => ({ id: p.personaId, displayName: p.displayName, role: p.role, oneLine: p.oneLine })), mine }, null, 2)); return; }
+      if (!presets.length) console.log('페르소나 프리셋을 찾지 못했습니다(persona-presets/ 가 이 설치본에 없습니다).');
+      else {
+        console.log('프리셋 — 골라서 내 페르소나로 만들기: elanous persona add <프리셋> [--name <이름>]');
+        const width = Math.max(...presets.map((p) => p.personaId.length));
+        for (const p of presets) console.log(`  ${p.personaId.padEnd(width)}  ${p.displayName} — ${p.role} · ${p.oneLine}`);
+      }
+      const made = mine.filter((p) => p.preset);
+      if (made.length) {
+        console.log('\n내 페르소나:');
+        for (const p of made) console.log(`  ${p.personaId}  ${p.displayName}${p.title ? ` (${p.title})` : ''}  (프리셋 ${p.preset})`);
+      }
+    });
+
+  persona.command('add <preset>')
+    .description('Make your own persona from a preset (id, name or role) — the preset file is not changed')
+    .option('--name <name>', 'What to call it (default: the preset’s first name)')
+    .option('--title <title>', 'Optional title, e.g. CMO')
+    .option('--json', 'JSON output')
+    .action((query: string, opts: { name?: string; title?: string; json?: boolean }) => {
+      const presets = loadPresets();
+      const preset = findPreset(presets, query);
+      if (!preset) {
+        console.error(`프리셋 «${query}» 을 찾지 못했습니다. 있는 것: ${presets.map((p) => p.personaId).join(', ')}`);
+        process.exitCode = 1;
+        return;
+      }
+      const dir = resolveStatePersonaDir();
+      const personaId = choosePersonaId(preset, opts.name, takenIds(dir));
+      const yaml = presetToProfileYaml(preset, loadPresetIndex().common, { personaId, ...(opts.name ? { name: opts.name } : {}), ...(opts.title ? { title: opts.title } : {}) });
+      const path = join(dir, `${personaId}.yaml`);
+      // The runtime loader must accept what we write — check before it lands on disk.
+      const check = parsePersonaYaml(yaml, path);
+      if (!check.ok) { console.error(`만든 페르소나를 읽을 수 없습니다: ${check.error.message}`); process.exitCode = 1; return; }
+      mkdirSync(dir, { recursive: true });
+      writeFileSync(path, yaml, { flag: 'wx' });
+      debug.log('persona.cli', 'added', { preset: preset.personaId, personaId, named: Boolean(opts.name) });
+      if (opts.json) { console.log(JSON.stringify({ personaId, displayName: check.profile.displayName, preset: preset.personaId, path }, null, 2)); return; }
+      console.log(`만들었습니다 — ${check.profile.displayName} (id ${personaId} · 프리셋 ${preset.personaId})`);
+      console.log(`  처음 묻는 것: ${preset.firstQuestions.join(' / ')}`);
+      console.log(`  보기: elanous persona show ${personaId}`);
+    });
+
+  persona.command('show <name>')
+    .description('Show one of your personas (id or name), or a preset')
+    .option('--json', 'JSON output')
+    .action((query: string, opts: { json?: boolean }) => {
+      const q = query.trim().toLowerCase();
+      const mine = readStoredPersonas().find((p) => p.personaId === q || p.displayName.toLowerCase().startsWith(q));
+      const presets = loadPresets();
+      if (mine) {
+        const text = readFileSync(mine.path, 'utf8');
+        const parsed = parsePersonaYaml(text, mine.path);
+        if (opts.json) { console.log(JSON.stringify({ kind: 'persona', ...mine, systemPrompt: parsed.ok ? parsed.profile.systemPrompt : undefined }, null, 2)); return; }
+        console.log(`${mine.displayName}${mine.title ? ` (${mine.title})` : ''}  (id ${mine.personaId}${mine.preset ? ` · 프리셋 ${mine.preset}` : ''})`);
+        if (mine.description) console.log(`  ${mine.description}`);
+        const preset = mine.preset ? presets.find((p) => p.personaId === mine.preset) : undefined;
+        if (preset) for (const line of describePreset(preset).slice(2)) console.log(line);
+        console.log(`  파일: ${mine.path}`);
+        return;
+      }
+      const preset = findPreset(presets, query);
+      if (!preset) { console.error(`«${query}» 페르소나도 프리셋도 없습니다. 목록: elanous persona list`); process.exitCode = 1; return; }
+      if (opts.json) { console.log(JSON.stringify({ kind: 'preset', ...preset }, null, 2)); return; }
+      console.log('(프리셋 — 아직 만들지 않았습니다. 만들기: elanous persona add ' + preset.personaId + ')');
+      for (const line of describePreset(preset)) console.log(line);
+    });
+}

package/src/cli/pr-cli.ts

@@ -115,6 +115,8 @@ export interface PrLandDeps {
   /** iOS 시험 게이트 심(시험 주입용). */
   runIosGate?: (out: { log: (message: string) => void; error: (message: string) => void }, changedFiles: readonly string[]) => boolean;
   isInteractive?: () => boolean;
+  /** Clock for the recent-landings window (test seam · default Date.now). */
+  now?: () => number;
   requestConfirmation?: (opts: ConfirmOpts) => Promise<ConfirmResult>;
   overlapConfirmChannels?: ConfirmChannel[];
   overlapConfirmTimeoutMs?: number;
@@ -822,11 +824,12 @@ function emitRecentLandingRateAdvisory(
   cwd: string,
   commits: readonly { subject: string; authorEmail: string; committedAtMs: number }[] | null,
   out: { log: (message: string) => void },
+  now: () => number = Date.now,
 ): boolean {
   const windowMinutes = RECENT_LANDING_WINDOW_MINUTES;
   const authorEmail = currentAuthorEmail(run, cwd);
   if (!authorEmail || commits === null) {
-    const previous = commits === null ? undefined : previousLandingSummary(commits, Date.now());
+    const previous = commits === null ? undefined : previousLandingSummary(commits, now());
     record('recent-landing-rate', true, {
       recentCount: 0,
       windowMinutes,
@@ -836,7 +839,7 @@ function emitRecentLandingRateAdvisory(
     });
     return false;
   }
-  const nowMs = Date.now();
+  const nowMs = now();
   const recentCount = countRecentLandings(commits, {
     authorEmail,
     nowMs,
@@ -1077,6 +1080,7 @@ export async function runPrLand(opts: PrLandOpts = {}, deps: PrLandDeps = {}): P
     cwd,
     collectResolvedBaseLandings(run, cwd, DEFAULT_GRANULARITY_SINCE, base),
     out,
+    deps.now,
   );
 
   // ⛔ local-path / no-remote 는 gh 가 원리상 못 한다. 이미 아는 자리에서 멈춘다.

package/src/cli/release-cli.ts

@@ -23,7 +23,8 @@ import { effectiveInstanceRoot, releaseLedgerRoot } from '../instance/resolve.js
 import { getElanousConfigDirOverride } from '../elanous-config-dir.js';
 import { envLiteral } from '../platform/env-literal.js';
 import { userConfigPath } from '../user-config.js';
-import { addItem, devVersion, listChecklist, removeItem, seedFromRoadmap, setItem, summarizeChecklist, type ChecklistStatus, type ChecklistDisposition } from '../release-loop/checklist.js';
+import { addItem, devVersion, listChecklist, removeItem, seedFromRoadmap, setItem, summarizeChecklist, type ChecklistStatus, type ChecklistDisposition, type ChecklistKind } from '../release-loop/checklist.js';
+import * as features from '../release-loop/feature-store.js';
 import { writeStdoutJson } from './stdout-json.js';
 import { runUnattendedRelease, type UnattendedReleaseDeps } from '../../scripts/release-loop/unattended-release.js';
 import { releaseReadiness } from '../../scripts/release-loop/release-readiness.js';
@@ -492,7 +493,7 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
     .option('--version <v>', '판 또는 별칭(기본: package.json 의 개발판에서 -dev.N 제거)')
     .option('--json', '결과 JSON');
   const context = (cmd: Command) => {
-    const opts = { ...(cmd.parent?.opts() as { version?: string; json?: boolean }), ...(cmd.opts() as { version?: string; json?: boolean }) };
+    const opts = { ...(cmd.parent?.parent?.opts() as { version?: string; json?: boolean }), ...(cmd.parent?.opts() as { version?: string; json?: boolean }), ...(cmd.opts() as { version?: string; json?: boolean }) };
     const codenames = checklistCodenames();
     return { version: checklistVersion(opts.version, codenames), codenames, json: opts.json };
   };
@@ -505,20 +506,21 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
     const { version, codenames, json } = context(cmd);
     await checklistOutput(version, codenames, 'status', json);
   });
-  withContext(checklist.command('add <id> <title>').description('칸 추가')).option('--owner <owner>', '담당').action((id: string, title: string, opts: { owner?: string }, cmd: Command) => {
+  withContext(checklist.command('add <id> <title>').description('칸 추가')).option('--owner <owner>', '담당').option('--kind <kind>', 'screen = 다섯 화면 짝 칸')
+    .action((id: string, title: string, opts: { owner?: string; kind?: string }, cmd: Command) => {
     const { version, json } = context(cmd);
-    const data = addItem(version, { id, title, ...(opts.owner !== undefined ? { owner: opts.owner } : {}) });
+    const data = addItem(version, { id, title, ...(opts.owner !== undefined ? { owner: opts.owner } : {}), ...(opts.kind !== undefined ? { kind: opts.kind as ChecklistKind } : {}) });
     if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${id} 추가`);
   });
   withContext(checklist.command('set <id>').description('칸 상태·근거·담당·처분 갱신'))
     .option('--status <status>', 'green|yellow|red|done').option('--evidence <evidence>', '근거').option('--owner <owner>', '담당')
-    .option('--disposition <disposition>', 'move|known-issue|block')
-    .action((id: string, opts: { status?: string; evidence?: string; owner?: string; disposition?: string }, cmd: Command) => {
+    .option('--disposition <disposition>', 'move|known-issue|block').option('--kind <kind>', 'screen = 다섯 화면 짝 칸')
+    .action((id: string, opts: { status?: string; evidence?: string; owner?: string; disposition?: string; kind?: string }, cmd: Command) => {
       const { version, json } = context(cmd);
       if (opts.status !== undefined && !['green', 'yellow', 'red', 'done'].includes(opts.status)) throw new Error(`잘못된 상태: ${opts.status}`);
       if (opts.disposition !== undefined && !['move', 'known-issue', 'block'].includes(opts.disposition)) throw new Error(`잘못된 처분: ${opts.disposition}`);
-      if (opts.status === undefined && opts.evidence === undefined && opts.owner === undefined && opts.disposition === undefined) throw new Error('갱신할 칸을 지정하라');
-      const data = setItem(version, id, { ...(opts.status !== undefined ? { status: opts.status as ChecklistStatus } : {}), ...(opts.evidence !== undefined ? { evidence: opts.evidence } : {}), ...(opts.owner !== undefined ? { owner: opts.owner } : {}), ...(opts.disposition !== undefined ? { disposition: opts.disposition as ChecklistDisposition } : {}) }, process.env.ELANOUS_TRACK || 'cli');
+      if (opts.status === undefined && opts.evidence === undefined && opts.owner === undefined && opts.disposition === undefined && opts.kind === undefined) throw new Error('갱신할 칸을 지정하라');
+      const data = setItem(version, id, { ...(opts.status !== undefined ? { status: opts.status as ChecklistStatus } : {}), ...(opts.evidence !== undefined ? { evidence: opts.evidence } : {}), ...(opts.owner !== undefined ? { owner: opts.owner } : {}), ...(opts.disposition !== undefined ? { disposition: opts.disposition as ChecklistDisposition } : {}), ...(opts.kind !== undefined ? { kind: opts.kind as ChecklistKind } : {}) }, process.env.ELANOUS_TRACK || 'cli');
       if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${id} 갱신`);
     });
   withContext(checklist.command('rm <id>').description('칸 삭제')).action((id: string, _opts: unknown, cmd: Command) => {
@@ -532,6 +534,45 @@ export function registerReleaseCommands(program: Command, releaseRunDeps: Unatte
       const data = seedFromRoadmap(version, readFileSync(opts.from, 'utf8'));
       if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${version} ${data.items.length}칸`);
     });
+  const actor = () => process.env.ELANOUS_TRACK || 'cli';
+  withContext(checklist.command('move <id>').description('칸을 한 트랜잭션으로 다른 판에 옮긴다'))
+    .requiredOption('--from <v>', '현재 판').requiredOption('--to <v>', '새 판')
+    .action((id: string, opts: { from: string; to: string }, cmd: Command) => {
+      const { codenames, json } = context(cmd);
+      const from = checklistVersion(opts.from, codenames), to = checklistVersion(opts.to, codenames);
+      const data = features.move(id, from, to, actor());
+      if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${id} ${from} → ${to}`);
+    });
+  withContext(checklist.command('retitle <id> <title>').description('칸 제목 수정')).action((id: string, title: string, _opts: unknown, cmd: Command) => {
+    const { version, json } = context(cmd);
+    const snapshot = listChecklist(version);
+    features.retitle(id, title, actor(), snapshot.released, snapshot.dev);
+    if (json) console.log(JSON.stringify(listChecklist(version))); else console.log(`✅ ${id} 제목 수정`);
+  });
+  const evidence = checklist.command('evidence').description('칸의 PR·커밋 근거');
+  withContext(evidence.command('add <id> <ref>').description('근거 참조 추가')).action((id: string, ref: string, _opts: unknown, cmd: Command) => {
+    const { version, json } = context(cmd);
+    const snapshot = listChecklist(version);
+    features.evidenceAdd(id, version, ref, actor(), snapshot.released, snapshot.dev);
+    if (json) console.log(JSON.stringify(features.history(id))); else console.log(`✅ ${id} 근거 ${ref}`);
+  });
+  withContext(checklist.command('history <id>').description('칸의 판 이동·변경 이력')).action((id: string, _opts: unknown, cmd: Command) => {
+    const { json } = context(cmd);
+    const rows = features.history(id);
+    if (json) { console.log(JSON.stringify(rows)); return; }
+    const info = features.details(id);
+    if (info) {
+      console.log(`${info.id} · ${info.title} · 담당 ${info.owner ?? '-'} · 종류 ${info.kind ?? '-'} · 처음 ${info.createdAt}`);
+      for (const ev of info.evidence) console.log(`  근거 ${ev.version} ${ev.ref} (${ev.at} ${ev.by})`);
+    }
+    for (const row of rows) console.log(`${row.at} ${row.version} ${row.by} ${row.field}: ${JSON.stringify(row.from)} → ${JSON.stringify(row.to)}`);
+  });
+  withContext(checklist.command('export').description('SQLite 에서 checklist.json 스냅샷 생성')).action((_opts: unknown, cmd: Command) => {
+    const { version, json } = context(cmd);
+    const snapshot = listChecklist(version);
+    const data = features.exportJson(version, snapshot.released, snapshot.dev);
+    if (json) console.log(JSON.stringify(data)); else console.log(`✅ ${version} checklist.json 내보냄`);
+  });
   release.command('prepare')
     .description('깨끗한 원본 → 공개본 → 공개 저장소 이력 위 커밋 → PWA → 묶음·체크섬 → 로컬 끝까지 (네트워크 쓰기 없음)')
     .requiredOption('--version <x.y.z>', 'package.json 과 같은 버전(먼저 버전 PR 을 착지)')

package/src/cli/skills-cli.ts

@@ -0,0 +1,173 @@
+// SK2 — `elanous skills repair`: 색인이 못 읽은 스킬을 보여 주고, 확인([y/N])한 것만 그 자리에서 고친다.
+import type { Command } from 'commander';
+import { createInterface } from 'node:readline/promises';
+import { getSkillIndex, resetSkillIndex, skillIndexProblems } from '../skills/index.js';
+import { applySkillRepair, planSkillRepair, skillRepairNotice } from '../skills/repair.js';
+import { CONNECT_AGENTS, connectPrompt, connectSkillRoot, planConnect, withConnectedSource, withoutSources, type ConnectAgent } from '../skills/connect.js';
+import { debug } from '../debug/log.js';
+import { resolve } from 'node:path';
+import { claudePluginPrompt, isClaudePluginDir, mcpEnableHint, planClaudePlugin, readClaudePlugin } from '../skills/connect-claude-plugin.js';
+
+async function ask(question: string, defaultYes = false): Promise<boolean> {
+  if (!process.stdin.isTTY) return false;
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = (await rl.question(question)).trim();
+    return answer === '' ? defaultYes : /^(y|yes|예|네)$/i.test(answer);
+  }
+  finally { rl.close(); }
+}
+
+/** EN9 — `elanous connect <claude|codex>`: find the skills that agent already uses and register their folder (no copy). */
+export function registerConnectCommand(program: Command): void {
+  program.command('connect <agent>')
+    .description(`Use the skills you already have in another agent (${CONNECT_AGENTS.join(' | ')}) or a Claude Code plugin folder — registers in place, never copies; plugin MCP servers are added switched off`)
+    .option('--yes', 'Register without asking')
+    .option('--json', 'Print the plan as JSON and change nothing')
+    .option('--undo', 'Stop using that folder (the files stay where they are)')
+    .action(async (agentArg: string, opts: { yes?: boolean; json?: boolean; undo?: boolean }) => {
+      const agent = agentArg.toLowerCase() as ConnectAgent;
+      if (!CONNECT_AGENTS.includes(agent) && isClaudePluginDir(resolve(agentArg))) {
+        await connectClaudePlugin(resolve(agentArg), opts);
+        return;
+      }
+      if (!CONNECT_AGENTS.includes(agent)) {
+        console.error(`지원하는 에이전트: ${CONNECT_AGENTS.join(', ')} · 또는 Claude 플러그인 폴더(.claude-plugin/plugin.json) (받은 값: ${agentArg})`);
+        process.exitCode = 2;
+        return;
+      }
+      const { defaultSkillDirs, getUserConfig, saveUserConfig } = await import('../user-config.js');
+      const cfg = getUserConfig();
+      if (opts.undo) {
+        const root = connectSkillRoot(agent);
+        const sources = withoutSources(cfg.skills.sources, [root]);
+        if (sources.length === (cfg.skills.sources ?? []).length) { console.log(`연결된 적이 없습니다(${root}).`); return; }
+        saveUserConfig({ ...cfg, skills: { ...cfg.skills, sources } });
+        resetSkillIndex();
+        debug.log('skills.connect', 'undone', { agent });
+        console.log(`연결을 끊었습니다. 파일은 그대로 있습니다(${root}).`);
+        return;
+      }
+      const plan = planConnect(agent, defaultSkillDirs(cfg));
+      debug.log('skills.connect', 'plan', { agent, state: plan.state, count: 'skills' in plan ? plan.skills.length : 0 });
+      if (opts.json) { console.log(JSON.stringify(plan, null, 2)); return; }
+      const prompt = connectPrompt(plan);
+      if (plan.state !== 'new') { console.log(prompt); return; }
+      if (!opts.yes) {
+        if (!process.stdin.isTTY) { console.log(`${prompt.split('\n')[0]}\n가져오려면: elanous connect ${agent} --yes`); return; }
+        if (!(await ask(prompt, true))) { console.log('가져오지 않았습니다. 나중에: elanous connect ' + agent); return; }
+      } else {
+        console.log(prompt.split('\n')[0]);
+      }
+      const next = { ...cfg, skills: { ...cfg.skills, sources: withConnectedSource(cfg.skills.sources, plan.root, agent) } };
+      saveUserConfig(next);
+      resetSkillIndex();
+      const index = getSkillIndex(defaultSkillDirs(next));
+      const problems = skillIndexProblems().filter((p) => p.dir === plan.root);
+      const usable = plan.skills.length - problems.length;
+      debug.log('skills.connect', 'registered', { agent, found: plan.skills.length, problems: problems.length, indexed: index.length });
+      console.log(`연결했습니다 — ${usable}개를 바로 쓸 수 있습니다. 끊으려면: elanous connect ${agent} --undo`);
+      const notice = skillRepairNotice(problems);
+      if (notice) console.log(notice);
+    });
+}
+
+export function registerSkillsCommands(program: Command): void {
+  const skills = program.command('skills').description('Check and repair installed skills');
+  skills.command('sources')
+    .description('List every skill folder elanous reads, in order (preset · shared · connected · package)')
+    .option('--json', 'JSON output')
+    .action(async (opts: { json?: boolean }) => {
+      const { resolveSkillSources } = await import('../user-config.js');
+      const { existsSync } = await import('node:fs');
+      const sources = resolveSkillSources().map((source) => ({ ...source, exists: existsSync(source.path) }));
+      debug.log('skills.sources', 'listed', { count: sources.length, kinds: sources.map((source) => source.kind) });
+      if (opts.json) { console.log(JSON.stringify(sources, null, 2)); return; }
+      const width = Math.max(10, ...sources.map((source) => source.id.length));
+      for (const source of sources) {
+        console.log(`${source.enabled ? '●' : '○'} ${source.id.padEnd(width)}  ${source.kind.padEnd(9)} ${source.path}${source.exists ? '' : '  (없음)'}`);
+      }
+      console.log('묶음 스킬(패키지 skills/)은 늘 마지막에 읽습니다. 다른 에이전트 스킬 더하기: elanous connect claude|codex|<플러그인 폴더>');
+    });
+  skills.command('repair')
+    .description('List skills that could not be read and repair the ones that can be fixed (asks first)')
+    .option('--yes', 'Repair every fixable skill without asking')
+    .action(async (opts: { yes?: boolean }) => {
+      getSkillIndex();
+      const problems = skillIndexProblems();
+      if (!problems.length) { console.log('모든 스킬을 읽었습니다. 고칠 것이 없습니다.'); return; }
+      console.log(`스킬 ${problems.length}개를 읽지 못했습니다.`);
+      // ER1 — operations hears about it too (consented · scrubbed).
+      try {
+        const { reportError } = await import('../error-report/report.js');
+        for (const p of problems.slice(0, 3)) await reportError({ code: 'skill-index', message: `${p.name}: ${p.code ?? ''} ${p.error}`.trim(), surface: 'cli' });
+      } catch { /* reporting is advisory */ }
+      let fixed = 0;
+      for (const problem of problems) {
+        const plan = planSkillRepair(problem);
+        console.log(`\n· ${problem.name} — ${problem.error.split('\n')[0]}`);
+        if (plan.kind === 'permission' || plan.kind === 'manual') { console.log(`  ${plan.hint}`); continue; }
+        const what = plan.kind === 'fixable-permission' ? '읽기 권한을 켭니다' : `${plan.keys.join(', ')} 를 한 줄로 고칩니다(원본은 .bak 으로 남김)`;
+        if (!opts.yes && !(await ask(`  ${what}. 고칠까요? [y/N] `))) { console.log('  건너뜀'); continue; }
+        const result = applySkillRepair(plan);
+        if (result.ok) { fixed += 1; console.log(`  고쳤습니다 — ${result.path}`); }
+        else console.log(`  고치지 못했습니다(${result.reason}) — 원래대로 되돌렸습니다.`);
+      }
+      console.log(`\n${fixed}개를 고쳤습니다.`);
+      if (fixed < problems.length) process.exitCode = 1;
+    });
+}
+
+/** EN8 — a Claude Code plugin folder: skills join `skills.sources[]` (kind connected) in place, `.mcp.json` servers join `mcp.servers[]` switched off. */
+async function connectClaudePlugin(dir: string, opts: { yes?: boolean; json?: boolean; undo?: boolean }): Promise<void> {
+  const { defaultSkillDirs, getUserConfig, saveUserConfig } = await import('../user-config.js');
+  const cfg = getUserConfig();
+  let plugin;
+  try { plugin = readClaudePlugin(dir); }
+  catch (error) {
+    console.error(`플러그인 정보를 읽지 못했습니다(.claude-plugin/plugin.json): ${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = 1;
+    return;
+  }
+  const rawMcp = (cfg.raw.mcp && typeof cfg.raw.mcp === 'object' && !Array.isArray(cfg.raw.mcp) ? cfg.raw.mcp : {}) as Record<string, unknown>;
+  const rawServers = (Array.isArray(rawMcp.servers) ? rawMcp.servers : []) as Array<Record<string, unknown>>;
+  const writeServers = (servers: Array<Record<string, unknown>>) => ({ ...cfg.raw, mcp: { ...rawMcp, servers } });
+  if (opts.undo) {
+    const ids = new Set(plugin.mcp.map((server) => server.id));
+    const sources = withoutSources(cfg.skills.sources, plugin.skillRoots);
+    const servers = rawServers.filter((row) => !ids.has(row.id as string));
+    if (sources.length === (cfg.skills.sources ?? []).length && servers.length === rawServers.length) { console.log(`연결된 적이 없습니다(${plugin.name}).`); return; }
+    saveUserConfig({ ...cfg, raw: writeServers(servers), skills: { ...cfg.skills, sources } });
+    resetSkillIndex();
+    debug.log('skills.connect', 'undone', { plugin: plugin.name });
+    console.log(`«${plugin.name}» 연결을 끊었습니다. 파일은 그대로 있습니다(${plugin.root}).`);
+    return;
+  }
+  const plan = planClaudePlugin(plugin, defaultSkillDirs(cfg), rawServers.map((row) => row.id as string));
+  debug.log('skills.connect', 'plan', { plugin: plugin.name, state: plan.state, skills: plugin.skills.length, mcp: plugin.mcp.length, skipped: plugin.skipped.length });
+  if (opts.json) { console.log(JSON.stringify(plan, null, 2)); return; }
+  const prompt = claudePluginPrompt(plan);
+  if (plan.state !== 'new') { console.log(prompt); return; }
+  const firstLines = prompt.slice(0, prompt.lastIndexOf('\n'));
+  if (!opts.yes) {
+    if (!process.stdin.isTTY) { console.log(`${firstLines}\n가져오려면: elanous connect ${plugin.root} --yes`); return; }
+    if (!(await ask(prompt, true))) { console.log(`가져오지 않았습니다. 나중에: elanous connect ${plugin.root}`); return; }
+  } else {
+    console.log(firstLines);
+  }
+  const sources = plan.newSkillRoots.reduce((list, root, i) => withConnectedSource(list, root, `plugin:${plugin.name}${i ? `:${i + 1}` : ''}`), cfg.skills.sources ?? []);
+  const servers = [...rawServers, ...plan.newMcp];
+  saveUserConfig({ ...cfg, raw: writeServers(servers), skills: { ...cfg.skills, sources } });
+  resetSkillIndex();
+  const next = { ...cfg, skills: { ...cfg.skills, sources } };
+  getSkillIndex(defaultSkillDirs(next));
+  const problems = skillIndexProblems().filter((p) => plugin.skillRoots.includes(p.dir));
+  debug.log('skills.connect', 'registered', { plugin: plugin.name, skills: plugin.skills.length, problems: problems.length, mcp: plan.newMcp.length });
+  console.log(`연결했습니다 — 스킬 ${plugin.skills.length - problems.length}개를 바로 쓸 수 있습니다. 끊으려면: elanous connect ${plugin.root} --undo`);
+  const notice = skillRepairNotice(problems);
+  if (notice) console.log(notice);
+  if (plan.newMcp.length) {
+    console.log(`MCP 서버 ${plan.newMcp.length}개를 꺼진 채로 등록했습니다. 믿을 수 있는 것만 켜 주세요(켠 뒤 데몬 재시작):`);
+    for (const line of mcpEnableHint(plan.newMcp, servers)) console.log(line);
+  }
+}

package/src/cli/start-cli.ts

@@ -5,6 +5,8 @@ import type { DetectedProvider } from '../llm/provider-detect.js';
 import { resolveUsableLlm, type UsableLlm } from '../llm/usable-llm.js';
 import { resolveDaemonEndpoint, type DaemonEndpoint, type ResolveDaemonEndpointOpts } from '../nexus/daemon-endpoint.js';
 import { runBgLaunch } from './bg-launch.js';
+import { browserUnavailableReason } from '../oauth/browser-availability.js';
+import { debug } from '../debug/log.js';
 
 export interface StartOptions {
   gui?: boolean;
@@ -63,6 +65,8 @@ export interface StartDeps {
   openTui?: (json: boolean) => Promise<number>;
   sleep?: (ms: number) => Promise<void>;
   output?: (line: string) => void;
+  browserEnv?: NodeJS.ProcessEnv;
+  browserPlatform?: NodeJS.Platform;
   /** Test seam — daemon address. `null` means this universe has no daemon (do not guess a port).
    *  Called again after a launch so the opened address is the daemon that was just started. */
   resolveEndpoint?: (opts?: ResolveDaemonEndpointOpts) => DaemonEndpoint | null;
@@ -193,10 +197,15 @@ export async function runStart(options: StartOptions = {}, deps: StartDeps = {})
       if (!openUrl) {
         record('open-gui', 'failed', 'Daemon address unknown');
       } else {
-        try {
-          if (await (deps.openGui ?? defaultOpenGui)(openUrl)) surface = 'gui';
-        } catch { /* A browser is optional; retain the URL for manual opening. */ }
-        record('open-gui', surface === 'gui' ? 'done' : 'failed', surface === 'gui' ? `Opened ${openUrl}` : `Open manually: ${openUrl}`);
+        const why = browserUnavailableReason(deps.browserEnv ?? process.env, deps.browserPlatform ?? process.platform);
+        if (why) {
+          debug.log('browser.open', 'skipped', { reason: why.includes('ssh') ? 'ssh' : 'no-display' });
+        } else {
+          try {
+            if (await (deps.openGui ?? defaultOpenGui)(openUrl)) surface = 'gui';
+          } catch { /* A browser is optional; retain the URL for manual opening. */ }
+        }
+        record('open-gui', surface === 'gui' ? 'done' : why ? 'skipped' : 'failed', surface === 'gui' ? `Opened ${openUrl}` : `Open manually: ${openUrl}${why ? ` — ${why}` : ''}`);
       }
       record('open-tui', 'skipped', 'GUI selected');
     } else {

package/src/codex/setup.ts

@@ -82,12 +82,14 @@ export async function pickCodexAuthMode(io: WizardIO, deps: CodexAuthModeDeps =
   if (existing || codexCli) {
     if (existing) {
       const exp = existing.tokens.expiresAt;
-      const when = exp != null
-        ? (Date.now() > exp ? 'EXPIRED' : `${Math.round((exp - Date.now()) / 60000)}min left`)
-        : 'no expiry tracked';
-      io.print(`  OAuth tokens already on file (${when}).`);
+      const left = exp != null ? exp - Date.now() : null;
+      const when = left == null ? '만료 시각 모름'
+        : left <= 0 ? '만료됨'
+          : left >= 86_400_000 ? `약 ${Math.round(left / 86_400_000)}일 남음`
+            : left >= 3_600_000 ? `약 ${Math.round(left / 3_600_000)}시간 남음` : `약 ${Math.max(1, Math.round(left / 60_000))}분 남음`;
+      io.print(`  이미 로그인돼 있습니다(${when}).`);
     } else {
-      io.print('  Found your ChatGPT/Codex login from the codex CLI (~/.codex/auth.json).');
+      io.print('  Codex CLI 에 있는 ChatGPT/Codex 로그인을 찾았습니다(~/.codex/auth.json).');
     }
     // Sprint 11 — chooseFrom Yes/No so fullScreenIO renders the arrow
     // picker (with 'y'/'n' + 한글 자모 quick-pick from PR #986 + #988)
@@ -96,10 +98,10 @@ export async function pickCodexAuthMode(io: WizardIO, deps: CodexAuthModeDeps =
     // rotation on an unnecessary refresh).
     const keep = await chooseFrom<boolean>(
       io,
-      'Keep using existing OAuth tokens?',
+      '지금 로그인을 그대로 쓸까요?',
       [
-        { key: 'y', label: 'Yes — keep them', value: true },
-        { key: 'n', label: 'No — re-run device-code flow', value: false },
+        { key: 'y', label: '예 — 그대로 씁니다', value: true },
+        { key: 'n', label: '아니오 — 다시 로그인합니다', value: false },
       ],
       { defaultIndex: 0 },
       undefined,
@@ -265,18 +267,18 @@ async function runCodexSetupImpl(
   let apiKey: string | undefined = initial.llm.apiKey;
 
   if (authMode === 'oauth') {
-    io.print('  Launching device-code flow…');
+    io.print('  코드로 로그인합니다…');
     try {
       await loginWithCodex({
         onProgress: (p) => {
           if (p.type === 'user_code') {
             io.print('');
-            io.print(`    1) Open in any browser: ${p.loginUrl}`);
-            io.print(`    2) Enter code:          ${p.userCode}`);
+            io.print(`    1) 아무 브라우저에서 열기: ${p.loginUrl}`);
+            io.print(`    2) 코드 입력:             ${p.userCode}`);
             io.print('');
-            io.print('  Waiting for sign-in…');
+            io.print('  로그인을 기다리는 중…');
           }
-          if (p.type === 'saved') io.print('  Signed in. Tokens saved.');
+          if (p.type === 'saved') io.print('  로그인했습니다. 저장했습니다.');
         },
         fetchImpl: opts.fetchImpl,
         sleepImpl: opts.sleepImpl,

package/src/dashboard/dashboard-status-lines.ts

@@ -0,0 +1,45 @@
+export interface DashboardStatusLinesInput {
+  readonly provider?: string | null;
+  readonly model?: string | null;
+  readonly reasoning?: string | null;
+  readonly daemonAddress?: string | null;
+  readonly daemonConnected: boolean;
+  readonly accountName?: string | null;
+  readonly sessionSurfaceLines: readonly string[];
+  readonly view: string;
+  readonly focus: string;
+  readonly cwd: string;
+  readonly preview: string;
+  readonly starterClosed: string;
+  readonly chatOnly: string;
+  readonly acp: string;
+}
+
+export function buildDashboardStatusLines(input: DashboardStatusLinesInput): string[] {
+  const known = (value?: string | null): string => value?.trim() || '모름';
+  // A remote URL can contain credentials or query parameters. Neither belongs in /status.
+  let address = '모름';
+  if (input.daemonAddress?.trim()) {
+    try {
+      const url = new URL(input.daemonAddress);
+      address = `${url.protocol}//${url.host}`;
+    } catch {
+      address = '모름';
+    }
+  }
+  return [
+    `모델: ${known(input.provider)}/${known(input.model)} (${known(input.reasoning)})`,
+    `연결: 데몬 ${address} ${input.daemonConnected ? '붙음' : '안 붙음'}`,
+    `계정: ${input.accountName?.trim() === 'default' ? '기본' : known(input.accountName)}`,
+    '',
+    '자세히',
+    ...input.sessionSurfaceLines.map(line => `  ${line}`),
+    `  view: ${input.view}`,
+    `  focus: ${input.focus}`,
+    `  cwd: ${input.cwd}`,
+    `  preview: ${input.preview}`,
+    `  starterClosed: ${input.starterClosed}`,
+    `  chatOnly: ${input.chatOnly}`,
+    `  acp: ${input.acp}`,
+  ];
+}

package/src/dashboard/first-screen-band.ts

@@ -0,0 +1,35 @@
+export interface FirstScreenBandInput {
+  readonly width: number;
+  readonly daemon: boolean;
+  readonly pwa?: {
+    readonly tailnet?: string | null;
+    readonly lan?: string | null;
+    readonly loopback?: string | null;
+  };
+}
+
+/** A startup transcript band; never includes credentials or a partial address. */
+export function buildFirstScreenBand(input: FirstScreenBandInput): string[] {
+  const width = Number.isFinite(input.width) ? Math.max(0, Math.floor(input.width)) : 0;
+  const fit = (text: string): string => text.slice(0, width);
+  const address = [input.pwa?.tailnet, input.pwa?.lan, input.pwa?.loopback]
+    .map((candidate) => {
+      if (!candidate) return null;
+      try {
+        const url = new URL(candidate);
+        if (!['http:', 'https:'].includes(url.protocol) || !url.hostname) return null;
+        return `${url.origin}${url.pathname === '/app/' ? '/app/' : ''}`;
+      } catch {
+        return null;
+      }
+    })
+    .find((candidate) => candidate !== null);
+  const fallback = input.pwa === undefined ? 'PWA: not checked' : 'PWA: unavailable';
+  const addressLine = address ? `PWA: ${address}` : fallback;
+
+  return [
+    fit(`elanous | daemon: ${input.daemon ? 'online' : 'offline'}`),
+    addressLine.length <= width ? addressLine : fit(address ? 'PWA: address available' : fallback),
+    fit('Type a message to begin | /help for commands'),
+  ];
+}