stellavault 0.1.0

package/packages/cli/src/commands/decay-cmd.ts

@@ -0,0 +1,57 @@
+// Design Ref: §4.2 — CLI stellavault decay 명령
+// Plan SC: SC-03
+
+import chalk from 'chalk';
+import { loadConfig, createKnowledgeHub, DecayEngine } from '@stellavault/core';
+
+export async function decayCommand(_opts: any, cmd: any) {
+  const globalOpts = cmd?.parent?.opts?.() ?? {};
+  const jsonMode = globalOpts.json;
+  const config = loadConfig();
+  const hub = createKnowledgeHub(config);
+
+  console.error(chalk.dim('⏳ Initializing...'));
+  await hub.store.initialize();
+
+  const db = hub.store.getDb() as any;
+  if (!db) {
+    console.error(chalk.red('❌ Cannot access database'));
+    process.exit(1);
+  }
+
+  const decayEngine = new DecayEngine(db);
+  const report = await decayEngine.computeAll();
+
+  if (jsonMode) {
+    console.log(JSON.stringify(report, null, 2));
+    await hub.store.close();
+    return;
+  }
+
+  console.log(chalk.green('\n🧠 Knowledge Decay Report'));
+  console.log(chalk.dim('─'.repeat(50)));
+  console.log(`  📄 Total documents:  ${report.totalDocuments}`);
+  console.log(`  ⚠️  Decaying (R<0.5): ${chalk.yellow(String(report.decayingCount))}`);
+  console.log(`  🔴 Critical (R<0.3): ${chalk.red(String(report.criticalCount))}`);
+  console.log(`  📊 Average R:        ${report.averageR}`);
+  console.log(chalk.dim('─'.repeat(50)));
+
+  if (report.topDecaying.length > 0) {
+    console.log(chalk.yellow('\n📋 Top Decaying Notes (리마인드 필요):'));
+    for (const d of report.topDecaying.slice(0, 20)) {
+      const rBar = '█'.repeat(Math.round(d.retrievability * 10)) + '░'.repeat(10 - Math.round(d.retrievability * 10));
+      const color = d.retrievability < 0.3 ? chalk.red : chalk.yellow;
+      console.log(`  ${color(rBar)} R=${d.retrievability.toFixed(2)} | ${d.daysSinceAccess}d ago | ${d.title}`);
+    }
+  }
+
+  if (report.clusterHealth.length > 0) {
+    console.log(chalk.dim('\n📊 Cluster Health:'));
+    for (const c of report.clusterHealth.slice(0, 10)) {
+      const color = c.avgR < 0.3 ? chalk.red : c.avgR < 0.5 ? chalk.yellow : chalk.green;
+      console.log(`  ${color(`R=${c.avgR.toFixed(2)}`)} | ${c.count} docs | ${c.label}`);
+    }
+  }
+
+  console.log(chalk.dim('\n💡 Tip: stellavault search <topic> to refresh decaying knowledge'));
+}

package/packages/cli/src/commands/digest-cmd.ts

@@ -0,0 +1,89 @@
+// stellavault digest — 주간 지식 활동 리포트
+
+import chalk from 'chalk';
+import { loadConfig, createKnowledgeHub, DecayEngine } from '@stellavault/core';
+
+export async function digestCommand(options: { days?: string }) {
+  const config = loadConfig();
+  const hub = createKnowledgeHub(config);
+  const days = parseInt(options.days ?? '7', 10);
+
+  await hub.store.initialize();
+  const db = hub.store.getDb() as any;
+  if (!db) { console.error(chalk.red('❌ DB 접근 불가')); process.exit(1); }
+
+  console.log(chalk.green(`\n📊 지식 활동 리포트 (최근 ${days}일)`));
+  console.log(chalk.dim('─'.repeat(50)));
+
+  // 1. 접근 통계
+  const accessStats = db.prepare(`
+    SELECT access_type, COUNT(*) as cnt
+    FROM access_log WHERE accessed_at > datetime('now', '-${days} days')
+    GROUP BY access_type
+  `).all() as any[];
+
+  const totalAccess = accessStats.reduce((s: number, r: any) => s + r.cnt, 0);
+  console.log(`\n🔍 총 접근: ${chalk.bold(String(totalAccess))}회`);
+  for (const r of accessStats) {
+    const icon = r.access_type === 'view' ? '👁️' : r.access_type === 'search' ? '🔍' : '🤖';
+    console.log(`  ${icon} ${r.access_type}: ${r.cnt}회`);
+  }
+
+  // 2. 가장 많이 본 노트
+  const topDocs = db.prepare(`
+    SELECT al.document_id, d.title, COUNT(*) as cnt
+    FROM access_log al
+    JOIN documents d ON d.id = al.document_id
+    WHERE al.accessed_at > datetime('now', '-${days} days')
+    GROUP BY al.document_id
+    ORDER BY cnt DESC LIMIT 10
+  `).all() as any[];
+
+  if (topDocs.length > 0) {
+    console.log(chalk.dim(`\n📄 가장 많이 접근한 노트:`));
+    for (const d of topDocs) {
+      const bar = '█'.repeat(Math.min(d.cnt, 20));
+      console.log(`  ${chalk.cyan(bar)} ${d.cnt}회 ${d.title}`);
+    }
+  }
+
+  // 3. 일별 활동량
+  const dailyActivity = db.prepare(`
+    SELECT date(accessed_at) as day, COUNT(*) as cnt
+    FROM access_log WHERE accessed_at > datetime('now', '-${days} days')
+    GROUP BY day ORDER BY day
+  `).all() as any[];
+
+  if (dailyActivity.length > 0) {
+    console.log(chalk.dim('\n📅 일별 활동:'));
+    const maxCnt = Math.max(...dailyActivity.map((d: any) => d.cnt));
+    for (const d of dailyActivity) {
+      const barLen = Math.round((d.cnt / maxCnt) * 20);
+      const bar = '█'.repeat(barLen) + '░'.repeat(20 - barLen);
+      console.log(`  ${d.day.slice(5)} ${chalk.green(bar)} ${d.cnt}`);
+    }
+  }
+
+  // 4. type별 분포
+  const typeStats = db.prepare(`
+    SELECT d.type, COUNT(DISTINCT al.document_id) as cnt
+    FROM access_log al
+    JOIN documents d ON d.id = al.document_id
+    WHERE al.accessed_at > datetime('now', '-${days} days')
+    GROUP BY d.type ORDER BY cnt DESC
+  `).all() as any[];
+
+  if (typeStats.length > 0) {
+    console.log(chalk.dim('\n📊 접근한 노트 유형:'));
+    for (const t of typeStats) {
+      console.log(`  ${t.type}: ${t.cnt}개`);
+    }
+  }
+
+  // 5. 감쇠 변화
+  const decayEngine = new DecayEngine(db);
+  const report = await decayEngine.computeAll();
+  console.log(`\n🧠 건강도: R=${report.averageR} | 감쇠 ${report.decayingCount}개 | 위험 ${report.criticalCount}개`);
+
+  console.log(chalk.dim('\n═'.repeat(50)));
+}

package/packages/cli/src/commands/duplicates-cmd.ts

@@ -0,0 +1,38 @@
+// Design Ref: stellavault duplicates — 중복/유사 노트 탐지 CLI
+
+import chalk from 'chalk';
+import { loadConfig, createKnowledgeHub, detectDuplicates } from '@stellavault/core';
+
+export async function duplicatesCommand(options: { threshold?: string }) {
+  const config = loadConfig();
+  const hub = createKnowledgeHub(config);
+  const threshold = parseFloat(options.threshold ?? '0.88');
+
+  console.error(chalk.dim('⏳ Scanning for duplicates...'));
+  await hub.store.initialize();
+  await hub.embedder.initialize();
+
+  const pairs = await detectDuplicates(hub.store, threshold, 20);
+
+  if (pairs.length === 0) {
+    console.log(chalk.green('\n✨ 중복 노트가 없습니다!'));
+    return;
+  }
+
+  console.log(chalk.yellow(`\n🔍 유사 노트 ${pairs.length}쌍 발견 (threshold: ${threshold})`));
+  console.log(chalk.dim('─'.repeat(60)));
+
+  for (let i = 0; i < pairs.length; i++) {
+    const p = pairs[i];
+    const pct = Math.round(p.similarity * 100);
+    const color = pct >= 95 ? chalk.red : chalk.yellow;
+
+    console.log(`\n${chalk.bold(`[${i + 1}]`)} ${color(`${pct}% 유사`)}`);
+    console.log(`  A: ${chalk.cyan(p.docA.title)}`);
+    console.log(`     ${chalk.dim(p.docA.filePath)}`);
+    console.log(`  B: ${chalk.cyan(p.docB.title)}`);
+    console.log(`     ${chalk.dim(p.docB.filePath)}`);
+  }
+
+  console.log(chalk.dim('\n💡 Obsidian에서 직접 병합하거나 삭제하세요'));
+}

package/packages/cli/src/commands/federate-cmd.ts

@@ -0,0 +1,236 @@
+// Design Ref: §6 — sv federate CLI (대화형 모드)
+// Plan SC: SC1-SC5
+
+import { createInterface } from 'node:readline';
+import chalk from 'chalk';
+import {
+  loadConfig, createSqliteVecStore, createLocalEmbedder,
+  FederationNode, FederatedSearch, getOrCreateIdentity,
+  getSharingSummary, addBlockedTag, removeBlockedTag, addBlockedFolder, loadSharingConfig, saveSharingConfig,
+} from '@stellavault/core';
+
+export async function federateJoinCommand(options: { name?: string }) {
+  const config = loadConfig();
+  const identity = getOrCreateIdentity(options.name);
+
+  console.log('');
+  console.log(chalk.bold('  ✦ Stellavault Federation'));
+  console.log(chalk.dim(`  Node: ${identity.displayName} (${identity.peerId})`));
+  console.log('');
+
+  // 로컬 스토어 초기화 (검색 응답용)
+  const store = createSqliteVecStore(config.dbPath);
+  await store.initialize();
+
+  const embedder = createLocalEmbedder(config.embedding.localModel);
+  await embedder.initialize();
+
+  // 통계 수집
+  const stats = await store.getStats();
+  const topics = await store.getTopics();
+
+  // Federation 노드 시작
+  const node = new FederationNode(options.name);
+  node.setLocalStats(stats.documentCount, topics.slice(0, 5).map((t: any) => t.topic));
+
+  const search = new FederatedSearch(node, store, embedder);
+  search.startResponder();
+
+  // 이벤트 리스너
+  node.on('joined', (info: any) => {
+    console.log(chalk.green(`  ✦ Joined federation network`));
+    console.log(chalk.dim(`    Topic: ${info.topic}`));
+    console.log(chalk.dim(`    Waiting for peers...\n`));
+  });
+
+  node.on('peer_joined', (peer: any) => {
+    console.log(chalk.cyan(`  → Peer found: ${peer.displayName} (${peer.documentCount} docs) [${peer.peerId}]`));
+  });
+
+  node.on('peer_left', (info: any) => {
+    console.log(chalk.yellow(`  ← Peer left: ${info.peerId}`));
+  });
+
+  node.on('search_request', () => {
+    // 검색 요청 수신 로깅 (응답은 FederatedSearch.startResponder가 처리)
+  });
+
+  await node.join();
+
+  // 대화형 모드
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const prompt = () => rl.question(chalk.dim('federation> '), handleInput);
+
+  async function handleInput(line: string) {
+    const parts = line.trim().split(/\s+/);
+    const cmd = parts[0];
+
+    switch (cmd) {
+      case 'search': {
+        const query = parts.slice(1).join(' ');
+        if (!query) { console.log(chalk.yellow('  Usage: search <query>')); break; }
+
+        const start = Date.now();
+        console.log(chalk.dim(`  Searching ${node.peerCount} peers...`));
+
+        const results = await search.search(query, { limit: 5, timeout: 5000 });
+        const elapsed = Date.now() - start;
+
+        if (results.length === 0) {
+          console.log(chalk.yellow(`  No results from peers. (${elapsed}ms)`));
+        } else {
+          console.log('');
+          for (const r of results) {
+            const simColor = r.similarity >= 0.7 ? chalk.green : r.similarity >= 0.4 ? chalk.yellow : chalk.dim;
+            console.log(`  ${simColor(`${Math.round(r.similarity * 100)}%`)} ${chalk.bold(r.title)} ${chalk.dim(`[${r.peerName}]`)}`);
+            console.log(`     ${chalk.dim(r.snippet)}...`);
+          }
+          console.log(chalk.dim(`\n  ${results.length} results from ${new Set(results.map(r => r.peerId)).size} peers (${elapsed}ms)`));
+        }
+        break;
+      }
+
+      case 'peers': {
+        const peers = node.getPeers();
+        if (peers.length === 0) {
+          console.log(chalk.yellow('  No peers connected'));
+        } else {
+          console.log('');
+          for (const p of peers) {
+            console.log(`  ${chalk.cyan(p.displayName)} ${chalk.dim(`(${p.documentCount} docs)`)} [${p.peerId}]`);
+            if (p.topTopics.length > 0) {
+              console.log(`    ${chalk.dim(p.topTopics.map(t => `#${t}`).join(' '))}`);
+            }
+          }
+          console.log(chalk.dim(`\n  ${peers.length} peer(s) connected`));
+        }
+        break;
+      }
+
+      case 'status': {
+        console.log('');
+        console.log(`  ${chalk.bold('Node:')} ${identity.displayName} (${identity.peerId})`);
+        console.log(`  ${chalk.bold('Docs:')} ${stats.documentCount}`);
+        console.log(`  ${chalk.bold('Peers:')} ${node.peerCount}`);
+        console.log(`  ${chalk.bold('Running:')} ${node.isRunning ? chalk.green('yes') : chalk.red('no')}`);
+        break;
+      }
+
+      case 'connect': {
+        const addr = parts[1];
+        if (!addr || !addr.includes(':')) { console.log(chalk.yellow('  Usage: connect <host:port>')); break; }
+        const [host, portStr] = addr.split(':');
+        try {
+          console.log(chalk.dim(`  Connecting to ${addr}...`));
+          await node.joinDirect(host, parseInt(portStr, 10));
+          console.log(chalk.green(`  Connected to ${addr}`));
+        } catch (err) {
+          console.log(chalk.red(`  Failed: ${err instanceof Error ? err.message : err}`));
+        }
+        break;
+      }
+
+      case 'sharing': {
+        console.log('\n' + chalk.bold('  Sharing Settings'));
+        console.log('  ' + getSharingSummary().split('\n').join('\n  '));
+        console.log('');
+        break;
+      }
+
+      case 'block-tag': {
+        const tag = parts[1];
+        if (!tag) { console.log(chalk.yellow('  Usage: block-tag <tag>')); break; }
+        addBlockedTag(tag);
+        console.log(chalk.green(`  Blocked tag: #${tag}`));
+        break;
+      }
+
+      case 'unblock-tag': {
+        const tag = parts[1];
+        if (!tag) { console.log(chalk.yellow('  Usage: unblock-tag <tag>')); break; }
+        removeBlockedTag(tag);
+        console.log(chalk.green(`  Unblocked tag: #${tag}`));
+        break;
+      }
+
+      case 'block-folder': {
+        const folder = parts[1];
+        if (!folder) { console.log(chalk.yellow('  Usage: block-folder <folder>')); break; }
+        addBlockedFolder(folder);
+        console.log(chalk.green(`  Blocked folder: ${folder}`));
+        break;
+      }
+
+      case 'mode': {
+        const mode = parts[1];
+        if (mode !== 'whitelist' && mode !== 'blacklist') {
+          console.log(chalk.yellow('  Usage: mode whitelist|blacklist'));
+          break;
+        }
+        const cfg = loadSharingConfig();
+        cfg.mode = mode;
+        saveSharingConfig(cfg);
+        console.log(chalk.green(`  Sharing mode: ${mode}`));
+        break;
+      }
+
+      case 'leave':
+      case 'quit':
+      case 'exit': {
+        console.log(chalk.dim('  Leaving federation...'));
+        await node.leave();
+        await store.close();
+        rl.close();
+        process.exit(0);
+        return; // don't re-prompt
+      }
+
+      case 'help': {
+        console.log('');
+        console.log('  Commands:');
+        console.log(`    ${chalk.cyan('search <query>')}    Search across all connected peers`);
+        console.log(`    ${chalk.cyan('peers')}             List connected peers`);
+        console.log(`    ${chalk.cyan('status')}            Show node info`);
+        console.log(`    ${chalk.cyan('connect <ip:port>')} Connect to peer directly`);
+        console.log(`    ${chalk.cyan('sharing')}           Show sharing settings`);
+        console.log(`    ${chalk.cyan('block-tag <tag>')}   Block a tag from sharing`);
+        console.log(`    ${chalk.cyan('unblock-tag <tag>')} Unblock a tag`);
+        console.log(`    ${chalk.cyan('block-folder <f>')}  Block a folder from sharing`);
+        console.log(`    ${chalk.cyan('mode <wl|bl>')}      Set whitelist or blacklist mode`);
+        console.log(`    ${chalk.cyan('leave')}             Disconnect and exit`);
+        break;
+      }
+
+      default: {
+        if (cmd) console.log(chalk.dim(`  Unknown command: ${cmd}. Type 'help' for commands.`));
+        break;
+      }
+    }
+
+    prompt(); // 다음 입력 대기
+  }
+
+  // Ctrl+C 처리
+  process.on('SIGINT', async () => {
+    console.log(chalk.dim('\n  Leaving federation...'));
+    await node.leave();
+    await store.close();
+    process.exit(0);
+  });
+
+  prompt();
+}
+
+// 단순 상태 조회 (join 없이)
+export async function federateStatusCommand() {
+  const identity = getOrCreateIdentity();
+  const config = loadConfig();
+
+  console.log('');
+  console.log(chalk.bold('  ✦ Federation Identity'));
+  console.log(`  PeerID: ${identity.peerId}`);
+  console.log(`  Name:   ${identity.displayName}`);
+  console.log(`  Since:  ${identity.createdAt}`);
+  console.log(`  DB:     ${config.dbPath}`);
+  console.log('');
+}

package/packages/cli/src/commands/gaps-cmd.ts

@@ -0,0 +1,40 @@
+// Design Ref: stellavault gaps — 지식 갭 탐지 CLI
+
+import chalk from 'chalk';
+import { loadConfig, createKnowledgeHub, detectKnowledgeGaps } from '@stellavault/core';
+
+export async function gapsCommand() {
+  const config = loadConfig();
+  const hub = createKnowledgeHub(config);
+
+  console.error(chalk.dim('⏳ Analyzing knowledge gaps...'));
+  await hub.store.initialize();
+  await hub.embedder.initialize();
+
+  const report = await detectKnowledgeGaps(hub.store);
+
+  console.log(chalk.green('\n🕳️ Knowledge Gap Report'));
+  console.log(chalk.dim('─'.repeat(50)));
+  console.log(`  클러스터: ${report.totalClusters}개`);
+  console.log(`  갭: ${chalk.yellow(String(report.totalGaps))}개 (High+Medium)`);
+  console.log(`  고립 노드: ${report.isolatedNodes.length}개`);
+  console.log(chalk.dim('─'.repeat(50)));
+
+  if (report.gaps.length > 0) {
+    console.log(chalk.yellow('\n📊 클러스터 간 갭:'));
+    for (const gap of report.gaps) {
+      const icon = gap.severity === 'high' ? '🔴' : gap.severity === 'medium' ? '🟡' : '🟢';
+      console.log(`  ${icon} ${gap.clusterA} ↔ ${gap.clusterB}`);
+      console.log(`     연결: ${gap.bridgeCount}개 | 제안: ${chalk.cyan(gap.suggestedTopic)}`);
+    }
+  }
+
+  if (report.isolatedNodes.length > 0) {
+    console.log(chalk.dim('\n🏝️ 고립된 노트 (연결 ≤1):'));
+    for (const n of report.isolatedNodes.slice(0, 10)) {
+      console.log(`  • ${n.title} (${n.connections}개 연결)`);
+    }
+  }
+
+  console.log(chalk.dim('\n💡 갭 영역의 지식을 보강하면 지식 그래프가 더 촘촘해집니다'));
+}

package/packages/cli/src/commands/graph-cmd.ts

@@ -0,0 +1,88 @@
+// Design Ref: §11.1 — CLI graph-cmd
+// Plan SC: SC-04 — stellavault graph → 브라우저 3초
+
+import chalk from 'chalk';
+import { loadConfig, createKnowledgeHub, createApiServer } from '@stellavault/core';
+import { spawn } from 'node:child_process';
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+
+export async function graphCommand() {
+  const config = loadConfig();
+  const hub = createKnowledgeHub(config);
+
+  console.error(chalk.dim('⏳ Initializing...'));
+  await hub.store.initialize();
+  await hub.embedder.initialize();
+
+  const stats = await hub.store.getStats();
+  if (stats.documentCount === 0) {
+    console.error(chalk.yellow('⚠ No documents indexed. Run `stellavault index <vault-path>` first.'));
+    process.exit(1);
+  }
+
+  // API 서버 시작
+  const port = config.mcp.port || 3333;
+  // vault 이름 추출 (경로의 마지막 디렉토리명)
+  const vaultName = config.vaultPath
+    ? config.vaultPath.replace(/\\/g, '/').replace(/\/$/, '').split('/').pop() ?? ''
+    : '';
+  const api = createApiServer({
+    store: hub.store,
+    searchEngine: hub.searchEngine,
+    port,
+    vaultName,
+  });
+  await api.start();
+
+  console.error(chalk.green('🧠 Stellavault — Neural Knowledge Graph'));
+  console.error(`   📚 ${stats.documentCount} documents | ${stats.chunkCount} chunks`);
+  console.error(`   🌐 API: http://127.0.0.1:${port}`);
+
+  // Vite dev 서버 시작 시도
+  const graphDir = resolve(process.cwd(), 'packages/graph');
+  const hasGraph = existsSync(resolve(graphDir, 'package.json'));
+
+  if (hasGraph) {
+    console.error(chalk.dim('   🚀 Starting Vite dev server...'));
+
+    const vite = spawn('npx', ['vite', '--host'], {
+      cwd: graphDir,
+      stdio: ['ignore', 'pipe', 'pipe'],
+      shell: true,
+    });
+
+    vite.stderr.on('data', (data: Buffer) => {
+      const line = data.toString();
+      // Vite ready 메시지 감지 → 브라우저 열기
+      if (line.includes('Local:')) {
+        const match = line.match(/http:\/\/localhost:\d+/);
+        const url = match?.[0] ?? 'http://localhost:5173';
+        console.error(chalk.green(`   🔮 Graph: ${url}`));
+        openBrowser(url);
+      }
+    });
+
+    vite.on('close', () => {
+      console.error(chalk.dim('   Vite server stopped'));
+    });
+
+    process.on('SIGINT', () => {
+      vite.kill();
+      process.exit(0);
+    });
+  } else {
+    console.error(chalk.dim('   💡 Graph UI not found. Open http://127.0.0.1:' + port + '/api/graph'));
+  }
+
+  console.error(chalk.dim('   Press Ctrl+C to stop'));
+}
+
+async function openBrowser(url: string) {
+  try {
+    const open = await import('open');
+    await open.default(url);
+  } catch {
+    // open 패키지 없으면 무시
+  }
+}

package/packages/cli/src/commands/index-cmd.ts

@@ -0,0 +1,65 @@
+import ora from 'ora';
+import chalk from 'chalk';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { mkdirSync } from 'node:fs';
+import { loadConfig, createSqliteVecStore, createLocalEmbedder, indexVault, addVault, listVaults } from '@stellavault/core';
+
+// vault 경로 → 고유 DB 경로 생성
+function getVaultDbPath(vaultPath: string): string {
+  const hash = createHash('sha256').update(vaultPath).digest('hex').slice(0, 8);
+  const dir = join(homedir(), '.stellavault', 'vaults');
+  mkdirSync(dir, { recursive: true });
+  return join(dir, `${hash}.db`);
+}
+
+export async function indexCommand(vaultPath?: string) {
+  const config = loadConfig();
+  const vault = vaultPath ?? config.vaultPath;
+  if (!vault) {
+    console.error(chalk.red('Error: vault 경로가 필요합니다. stellavault index <path> 또는 .stellavault.json에 vaultPath 설정'));
+    process.exit(1);
+  }
+
+  // vault별 고유 DB 경로 (multi-vault 지원)
+  const dbPath = vaultPath ? getVaultDbPath(vault) : config.dbPath;
+
+  // Cross-Vault에 자동 등록
+  const existingVaults = listVaults();
+  const vaultName = vault.split(/[/\\]/).filter(Boolean).pop() ?? 'vault';
+  if (!existingVaults.some(v => v.path === vault)) {
+    try {
+      addVault(vaultName.toLowerCase(), vaultName, vault, dbPath);
+      console.log(chalk.dim(`  Auto-registered vault: ${vaultName} (${dbPath})`));
+    } catch { /* 이미 등록됨 */ }
+  }
+
+  const spinner = ora('초기화 중...').start();
+
+  const store = createSqliteVecStore(dbPath);
+  await store.initialize();
+
+  spinner.text = '임베딩 모델 로딩 중...';
+  const embedder = createLocalEmbedder(config.embedding.localModel);
+  await embedder.initialize();
+
+  spinner.text = '인덱싱 시작...';
+  const result = await indexVault(vault, {
+    store,
+    embedder,
+    chunkOptions: config.chunking,
+    onProgress(current, total, doc) {
+      spinner.text = `[${current}/${total}] ${doc.title}`;
+    },
+  });
+
+  await store.close();
+  spinner.stop();
+
+  console.log('');
+  console.log(chalk.green('✅ 인덱싱 완료'));
+  console.log(`  📄 인덱싱: ${result.indexed}건 | ⏭️ 스킵: ${result.skipped}건 | 🗑️ 삭제: ${result.deleted}건${result.failed ? ` | ❌ 실패: ${result.failed}건` : ''}`);
+  console.log(`  🧩 청크: ${result.totalChunks}개 | ⏱ ${(result.elapsedMs / 1000).toFixed(1)}초`);
+  console.log(`  💾 DB: ${dbPath}`);
+}