stellavault 0.2.0 → 0.3.0

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

@@ -1,256 +0,0 @@
-// 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, setTagLevel, setFolderLevel, setNodeLevel, getPendingRequests, approveRequest, denyRequest,
-} from '@stellavault/core';
-import type { SharingLevel } 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 'set-tag': {
-        const tag = parts[1];
-        const lvl = parseInt(parts[2], 10) as SharingLevel;
-        if (!tag || isNaN(lvl) || lvl < 0 || lvl > 4) { console.log(chalk.yellow('  Usage: set-tag <tag> <0-4>')); break; }
-        setTagLevel(tag, lvl);
-        console.log(chalk.green(`  #${tag} → Level ${lvl}`));
-        break;
-      }
-
-      case 'set-folder': {
-        const folder = parts[1];
-        const lvl = parseInt(parts[2], 10) as SharingLevel;
-        if (!folder || isNaN(lvl) || lvl < 0 || lvl > 4) { console.log(chalk.yellow('  Usage: set-folder <folder> <0-4>')); break; }
-        setFolderLevel(folder, lvl);
-        console.log(chalk.green(`  ${folder} → Level ${lvl}`));
-        break;
-      }
-
-      case 'set-level': {
-        const lvl = parseInt(parts[1], 10) as SharingLevel;
-        if (isNaN(lvl) || lvl < 0 || lvl > 4) { console.log(chalk.yellow('  Usage: set-level <0-4> (your node sharing level)')); break; }
-        setNodeLevel(lvl);
-        console.log(chalk.green(`  My node level → ${lvl}`));
-        break;
-      }
-
-      case 'requests': {
-        const pending = getPendingRequests();
-        if (pending.length === 0) { console.log(chalk.dim('  No pending requests')); break; }
-        console.log(`\n  ${pending.length} pending full-text requests:`);
-        for (const r of pending) {
-          console.log(`  ${r.requestId.slice(0, 8)} — "${r.documentTitle}" from ${r.fromName} (${r.requestedAt.slice(0, 10)})`);
-        }
-        break;
-      }
-
-      case 'approve': {
-        const reqId = parts[1];
-        if (!reqId) { console.log(chalk.yellow('  Usage: approve <request-id>')); break; }
-        const match = getPendingRequests().find(r => r.requestId.startsWith(reqId));
-        if (match && approveRequest(match.requestId)) console.log(chalk.green(`  Approved: ${match.documentTitle}`));
-        else console.log(chalk.red('  Request not found'));
-        break;
-      }
-
-      case 'deny': {
-        const reqId = parts[1];
-        if (!reqId) { console.log(chalk.yellow('  Usage: deny <request-id>')); break; }
-        const match = getPendingRequests().find(r => r.requestId.startsWith(reqId));
-        if (match && denyRequest(match.requestId)) console.log(chalk.green(`  Denied: ${match.documentTitle}`));
-        else console.log(chalk.red('  Request not found'));
-        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('set-tag <t> <0-4>')}   Set tag sharing level`);
-        console.log(`    ${chalk.cyan('set-folder <f> <0-4>')} Set folder sharing level`);
-        console.log(`    ${chalk.cyan('set-level <0-4>')}     Set your node level`);
-        console.log(`    ${chalk.cyan('requests')}            Show pending full-text requests`);
-        console.log(`    ${chalk.cyan('approve <id>')}        Approve a request`);
-        console.log(`    ${chalk.cyan('deny <id>')}           Deny a request`);
-        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

@@ -1,40 +0,0 @@
-// 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

@@ -1,88 +0,0 @@
-// 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

@@ -1,65 +0,0 @@
-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}`);
-}

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

@@ -1,145 +0,0 @@
-// stellavault init — 인터랙티브 온보딩 위저드 (F-A01)
-
-import { createInterface } from 'node:readline';
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { homedir } from 'node:os';
-import ora from 'ora';
-import chalk from 'chalk';
-import { loadConfig, createSqliteVecStore, createLocalEmbedder, indexVault, createSearchEngine } from '@stellavault/core';
-
-function ask(rl: ReturnType<typeof createInterface>, question: string, defaultVal?: string): Promise<string> {
-  const suffix = defaultVal ? ` ${chalk.dim(`(${defaultVal})`)}` : '';
-  return new Promise((resolve) => {
-    rl.question(`${question}${suffix}: `, (answer) => {
-      resolve(answer.trim() || defaultVal || '');
-    });
-  });
-}
-
-export async function initCommand() {
-  console.log('');
-  console.log(chalk.bold('  ✦ Stellavault Setup Wizard'));
-  console.log(chalk.dim('  Notes die in folders. Let\'s bring yours to life.\n'));
-
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-
-  try {
-    // Step 1: Vault Path
-    console.log(chalk.cyan('  Step 1/3') + ' — Where is your Obsidian vault?');
-    console.log(chalk.dim('  This is the folder containing your .md files.\n'));
-
-    let vaultPath = '';
-    while (!vaultPath) {
-      const input = await ask(rl, '  Vault path');
-      if (!input) {
-        console.log(chalk.yellow('  Please enter your vault path.'));
-        continue;
-      }
-      const resolved = input.replace(/^~/, homedir());
-      if (!existsSync(resolved)) {
-        console.log(chalk.yellow(`  Path not found: ${resolved}`));
-        continue;
-      }
-      vaultPath = resolved;
-    }
-
-    console.log(chalk.green(`  ✓ Vault: ${vaultPath}\n`));
-
-    // Save config
-    const configDir = join(homedir(), '.stellavault');
-    mkdirSync(configDir, { recursive: true });
-    const dbPath = join(configDir, 'index.db');
-
-    const configData = {
-      vaultPath,
-      dbPath,
-      embedding: { model: 'local', localModel: 'all-MiniLM-L6-v2' },
-      chunking: { maxTokens: 300, overlap: 50, minTokens: 50 },
-      search: { defaultLimit: 10, rrfK: 60 },
-      mcp: { mode: 'stdio', port: 3333 },
-    };
-    writeFileSync(join(homedir(), '.stellavault.json'), JSON.stringify(configData, null, 2), 'utf-8');
-    console.log(chalk.dim(`  Config saved: ~/.stellavault.json`));
-
-    // Step 2: Indexing
-    console.log('');
-    console.log(chalk.cyan('  Step 2/3') + ' — Indexing your vault');
-    console.log(chalk.dim('  Vectorizing notes with local AI (no data leaves your machine).\n'));
-
-    const spinner = ora({ text: '  Loading embedding model...', indent: 2 }).start();
-
-    const store = createSqliteVecStore(dbPath);
-    await store.initialize();
-
-    const embedder = createLocalEmbedder('all-MiniLM-L6-v2');
-    await embedder.initialize();
-    spinner.text = '  Scanning vault...';
-
-    const result = await indexVault(vaultPath, {
-      store,
-      embedder,
-      chunkOptions: { maxTokens: 300, overlap: 50, minTokens: 50 },
-      onProgress(current, total, doc) {
-        const pct = Math.round((current / total) * 100);
-        const bar = '█'.repeat(Math.floor(pct / 4)) + '░'.repeat(25 - Math.floor(pct / 4));
-        spinner.text = `  [${bar}] ${pct}% (${current}/${total}) ${doc.title.slice(0, 30)}`;
-      },
-    });
-
-    spinner.succeed(chalk.green(`  Indexed ${result.indexed} docs, ${result.totalChunks} chunks (${(result.elapsedMs / 1000).toFixed(1)}s)`));
-
-    // Step 3: First Search
-    console.log('');
-    console.log(chalk.cyan('  Step 3/3') + ' — Try your first search');
-    console.log(chalk.dim('  Type a topic you know about. Stellavault finds connections.\n'));
-
-    const searchEngine = createSearchEngine({ store, embedder, rrfK: 60 });
-
-    let searchDone = false;
-    while (!searchDone) {
-      const query = await ask(rl, '  Search');
-      if (!query) {
-        console.log(chalk.dim('  Type something, or press Ctrl+C to skip.'));
-        continue;
-      }
-
-      const searchSpinner = ora({ text: '  Searching...', indent: 2 }).start();
-      const results = await searchEngine.search({ query, limit: 5 });
-      searchSpinner.stop();
-
-      if (results.length === 0) {
-        console.log(chalk.yellow('  No results. Try a different topic.'));
-        continue;
-      }
-
-      console.log('');
-      for (const r of results) {
-        const score = Math.round(r.score * 100);
-        const bar = score >= 70 ? chalk.green('●') : score >= 40 ? chalk.yellow('●') : chalk.dim('●');
-        console.log(`  ${bar} ${chalk.bold(r.document.title)} ${chalk.dim(`(${score}%)`)}`);
-        if (r.highlights[0]) {
-          console.log(`    ${chalk.dim(r.highlights[0].slice(0, 80))}...`);
-        }
-      }
-      console.log('');
-      searchDone = true;
-    }
-
-    await store.close();
-
-    // Done!
-    console.log(chalk.bold.green('  ✦ Setup complete!\n'));
-    console.log('  What\'s next:');
-    console.log(`  ${chalk.cyan('stellavault graph')}     Launch 3D knowledge graph`);
-    console.log(`  ${chalk.cyan('stellavault decay')}     See what knowledge is fading`);
-    console.log(`  ${chalk.cyan('stellavault brief')}     Get your daily knowledge briefing`);
-    console.log(`  ${chalk.cyan('stellavault serve')}     Connect AI agents via MCP`);
-    console.log('');
-    console.log(chalk.dim('  Your knowledge is now alive. ✦'));
-    console.log('');
-
-  } finally {
-    rl.close();
-  }
-}

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

@@ -1,56 +0,0 @@
-// stellavault learn — AI learning path recommendations (F-A11)
-
-import chalk from 'chalk';
-import { loadConfig, createKnowledgeHub, DecayEngine, detectKnowledgeGaps, generateLearningPath } from '@stellavault/core';
-
-export async function learnCommand(_opts: any, cmd: any) {
-  const globalOpts = cmd?.parent?.opts?.() ?? {};
-  const jsonMode = globalOpts.json;
-  const config = loadConfig();
-  const hub = createKnowledgeHub(config);
-
-  await hub.store.initialize();
-  await hub.embedder.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 decayReport = await decayEngine.computeAll();
-
-  let gaps: any[] = [];
-  try {
-    const gapReport = await detectKnowledgeGaps(hub.store);
-    gaps = gapReport.gaps ?? [];
-  } catch { /* gaps may fail without enough data */ }
-
-  const path = generateLearningPath({ decayReport, gaps }, 15);
-  await hub.store.close();
-
-  if (jsonMode) {
-    console.log(JSON.stringify(path, null, 2));
-    return;
-  }
-
-  console.log('');
-  console.log(chalk.bold('  🎯 Your Learning Path'));
-  console.log(chalk.dim(`  ${path.summary.reviewCount} to review · ${path.summary.bridgeCount} gaps to bridge · ~${path.summary.estimatedMinutes}min`));
-  console.log('');
-
-  for (const item of path.items) {
-    const icon = item.category === 'review' ? '📖' : item.category === 'bridge' ? '🌉' : '🔭';
-    const prioColor = item.priority === 'critical' ? chalk.red : item.priority === 'important' ? chalk.yellow : chalk.dim;
-    const prioLabel = prioColor(item.priority.toUpperCase());
-
-    console.log(`  ${icon} ${prioLabel} ${chalk.bold(item.title)} ${chalk.dim(`(${item.score}pt)`)}`);
-    console.log(`     ${chalk.dim(item.reason)}`);
-  }
-
-  if (path.items.length === 0) {
-    console.log(chalk.green('  All clear! Your knowledge is in great shape.'));
-  }
-
-  console.log('');
-  console.log(chalk.dim('  💡 stellavault review — start reviewing decaying notes'));
-  console.log('');
-}