stellavault 0.1.0

package/packages/cli/dist/index.js

@@ -0,0 +1,156 @@
+import { Command } from 'commander';
+import { indexCommand } from './commands/index-cmd.js';
+import { searchCommand } from './commands/search-cmd.js';
+import { serveCommand } from './commands/serve-cmd.js';
+import { statusCommand } from './commands/status-cmd.js';
+import { graphCommand } from './commands/graph-cmd.js';
+import { cardCommand } from './commands/card-cmd.js';
+import { packCreateCommand, packExportCommand, packImportCommand, packListCommand, packInfoCommand } from './commands/pack-cmd.js';
+import { decayCommand } from './commands/decay-cmd.js';
+import { syncCommand } from './commands/sync-cmd.js';
+import { reviewCommand } from './commands/review-cmd.js';
+import { duplicatesCommand } from './commands/duplicates-cmd.js';
+import { gapsCommand } from './commands/gaps-cmd.js';
+import { clipCommand } from './commands/clip-cmd.js';
+import { briefCommand } from './commands/brief-cmd.js';
+import { digestCommand } from './commands/digest-cmd.js';
+import { initCommand } from './commands/init-cmd.js';
+import { learnCommand } from './commands/learn-cmd.js';
+import { contradictionsCommand } from './commands/contradictions-cmd.js';
+import { federateJoinCommand, federateStatusCommand } from './commands/federate-cmd.js';
+import { cloudSyncCommand, cloudRestoreCommand, cloudStatusCommand } from './commands/cloud-cmd.js';
+import { vaultAddCommand, vaultListCommand, vaultRemoveCommand, vaultSearchAllCommand } from './commands/vault-cmd.js';
+import { captureCommand } from './commands/capture-cmd.js';
+const program = new Command();
+program
+    .name('stellavault')
+    .description('Stellavault — Turn your Obsidian vault into a 3D neural knowledge graph')
+    .version('0.1.0')
+    .option('--json', 'Output in JSON format (for scripting)')
+    .option('--quiet', 'Suppress non-essential output');
+program
+    .command('init')
+    .description('Interactive setup wizard — get started in 3 minutes')
+    .action(initCommand);
+program
+    .command('index [vault-path]')
+    .description('Obsidian vault를 벡터화하여 인덱싱합니다')
+    .action(indexCommand);
+program
+    .command('search <query>')
+    .description('지식 베이스에서 검색합니다')
+    .option('-l, --limit <n>', '결과 수', '5')
+    .action(searchCommand);
+program
+    .command('serve')
+    .description('MCP 서버를 시작합니다 (Claude Code 연동)')
+    .action(serveCommand);
+program
+    .command('status')
+    .description('인덱스 상태를 확인합니다')
+    .action(statusCommand);
+program
+    .command('graph')
+    .description('3D Knowledge Graph API 서버를 시작합니다')
+    .action(graphCommand);
+program
+    .command('card')
+    .description('SVG 프로필 카드를 생성합니다')
+    .option('-o, --output <path>', '출력 파일 경로', 'knowledge-card.svg')
+    .action(cardCommand);
+program
+    .command('learn')
+    .description('AI learning path — personalized recommendations based on decay + gaps')
+    .action(learnCommand);
+program
+    .command('contradictions')
+    .description('Detect contradicting statements across your notes')
+    .action(contradictionsCommand);
+program
+    .command('decay')
+    .description('지식 감쇠 리포트를 출력합니다 (잊어가는 노트 확인)')
+    .action(decayCommand);
+program
+    .command('brief')
+    .description('오늘의 지식 브리핑 (감쇠 + 갭 + 활동 요약)')
+    .action(briefCommand);
+program
+    .command('digest')
+    .description('주간 지식 활동 리포트')
+    .option('-d, --days <n>', '기간 (일)', '7')
+    .action(digestCommand);
+program
+    .command('clip <url>')
+    .description('웹 페이지/YouTube를 Obsidian에 클리핑')
+    .option('-f, --folder <path>', 'vault 내 저장 폴더', '06_Research/clips')
+    .action(clipCommand);
+program
+    .command('gaps')
+    .description('지식 갭을 탐지합니다 (클러스터 간 연결 부족 영역)')
+    .action(gapsCommand);
+program
+    .command('duplicates')
+    .description('중복/유사 노트를 탐지합니다')
+    .option('-t, --threshold <n>', '유사도 임계값 (0~1)', '0.88')
+    .action(duplicatesCommand);
+program
+    .command('review')
+    .description('일일 지식 리뷰 — 잊어가는 노트를 Obsidian에서 열어 리뷰')
+    .option('-n, --count <n>', '리뷰할 노트 수', '5')
+    .action(reviewCommand);
+program
+    .command('sync')
+    .description('Notion → Obsidian 동기화')
+    .option('--upload', 'PDCA 문서를 Notion에 업로드')
+    .option('--watch', '5분 간격 자동 동기화')
+    .action(syncCommand);
+const federate = program.command('federate').description('Federation — P2P knowledge network');
+federate.command('join')
+    .description('Join the federation network (interactive mode)')
+    .option('-n, --name <name>', 'Display name for this node')
+    .action(federateJoinCommand);
+federate.command('status')
+    .description('Show federation identity and status')
+    .action(federateStatusCommand);
+program
+    .command('capture <audio-file>')
+    .description('Voice capture — transcribe audio to knowledge note (requires Whisper)')
+    .option('-m, --model <model>', 'Whisper model (tiny/base/small/medium/large)', 'base')
+    .option('-l, --language <lang>', 'Language (auto-detect if omitted)')
+    .option('-t, --tags <tags>', 'Comma-separated tags')
+    .option('-f, --folder <folder>', 'Vault subfolder', '01_Knowledge/voice')
+    .action(captureCommand);
+const vault = program.command('vault').description('Multi-Vault — manage and search across vaults');
+vault.command('add <id> <path>').description('Register a vault').option('-n, --name <name>', 'Display name').option('-s, --shared', 'Allow federation sharing').action(vaultAddCommand);
+vault.command('list').description('List registered vaults').action(vaultListCommand);
+vault.command('remove <id>').description('Unregister a vault').action(vaultRemoveCommand);
+vault.command('search-all <query>').description('Search across all registered vaults').option('-l, --limit <n>', 'Max results', '10').action(vaultSearchAllCommand);
+const cloud = program.command('cloud').description('Cloud — E2E encrypted backup');
+cloud.command('sync').description('Upload encrypted DB to cloud').action(cloudSyncCommand);
+cloud.command('restore').description('Download and decrypt DB from cloud').action(cloudRestoreCommand);
+cloud.command('status').description('Show last sync status').action(cloudStatusCommand);
+const pack = program.command('pack').description('Knowledge Pack 관리');
+pack.command('create <name>')
+    .description('검색/클러스터 기반 Knowledge Pack 생성')
+    .option('--from-search <query>', '검색 쿼리에서 생성')
+    .option('--from-cluster <id>', '클러스터 ID에서 생성')
+    .option('--author <name>', '작성자', 'anonymous')
+    .option('--license <license>', '라이선스', 'CC-BY-4.0')
+    .option('--description <desc>', '설명')
+    .option('--limit <n>', '최대 청크 수', '100')
+    .action(packCreateCommand);
+pack.command('export <name>')
+    .description('.sv-pack 파일로 내보내기')
+    .option('-o, --output <path>', '출력 경로')
+    .action(packExportCommand);
+pack.command('import <file>')
+    .description('.sv-pack 파일 가져오기 → 벡터 DB 병합')
+    .action(packImportCommand);
+pack.command('list')
+    .description('설치된 팩 목록')
+    .action(packListCommand);
+pack.command('info <name>')
+    .description('팩 상세 정보')
+    .action(packInfoCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/packages/cli/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/packages/cli/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@stellavault/cli",
+  "version": "0.1.0",
+  "description": "Stellavault CLI — stellavault index, search, serve, graph",
+  "type": "module",
+  "bin": {
+    "stellavault": "./bin/stellavault.js",
+    "sv": "./bin/stellavault.js"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@stellavault/core": "*",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "open": "^11.0.0",
+    "ora": "^9.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.7.0"
+  }
+}

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

@@ -0,0 +1,87 @@
+// stellavault brief — 아침 브리핑 (decay + gaps + streak 통합)
+
+import chalk from 'chalk';
+import { loadConfig, createKnowledgeHub, DecayEngine, detectKnowledgeGaps } from '@stellavault/core';
+
+export async function briefCommand() {
+  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('❌ DB 접근 불가')); process.exit(1); }
+
+  const decayEngine = new DecayEngine(db);
+  const stats = await hub.store.getStats();
+
+  console.log(chalk.green('\n☀️ Good morning! 오늘의 지식 브리핑'));
+  console.log(chalk.dim('─'.repeat(50)));
+
+  // 1. 전체 상태
+  console.log(`\n📚 ${chalk.bold(String(stats.documentCount))}개 노트 | ${stats.chunkCount} 청크`);
+
+  // 2. 감쇠 요약
+  const report = await decayEngine.computeAll();
+  const avgRColor = report.averageR >= 0.7 ? chalk.green : report.averageR >= 0.5 ? chalk.yellow : chalk.red;
+  console.log(`🧠 전체 건강도: ${avgRColor('R=' + report.averageR)} | 감쇠 ${chalk.yellow(String(report.decayingCount))}개 | 위험 ${chalk.red(String(report.criticalCount))}개`);
+
+  // 3. 리뷰 대상 Top 5
+  if (report.topDecaying.length > 0) {
+    console.log(chalk.yellow('\n📋 리뷰 추천:'));
+    for (const d of report.topDecaying.slice(0, 5)) {
+      const bar = '█'.repeat(Math.round(d.retrievability * 10)) + '░'.repeat(10 - Math.round(d.retrievability * 10));
+      console.log(`  ${chalk.dim(bar)} R=${d.retrievability.toFixed(2)} ${d.title}`);
+    }
+    console.log(chalk.dim('  → stellavault review 로 리뷰 시작'));
+  }
+
+  // 4. 갭 요약
+  try {
+    const gapReport = await detectKnowledgeGaps(hub.store);
+    const highGaps = gapReport.gaps.filter(g => g.severity === 'high');
+    if (highGaps.length > 0) {
+      console.log(chalk.yellow(`\n🕳️ 지식 갭 ${highGaps.length}개:`));
+      for (const g of highGaps.slice(0, 3)) {
+        console.log(`  🔴 ${g.clusterA.replace(/\s*\(\d+\)$/, '')} ↔ ${g.clusterB.replace(/\s*\(\d+\)$/, '')}`);
+      }
+    }
+  } catch { /* gaps 실패해도 무시 */ }
+
+  // 5. Streak
+  try {
+    const days = db.prepare(`
+      SELECT DISTINCT date(accessed_at) as d FROM access_log
+      WHERE access_type = 'view' ORDER BY d DESC LIMIT 30
+    `).all() as any[];
+
+    let streak = 0;
+    for (let i = 0; i < days.length; i++) {
+      const expected = new Date(Date.now() - i * 86400000).toISOString().slice(0, 10);
+      if (days[i]?.d === expected) streak++;
+      else break;
+    }
+    if (streak > 0) console.log(chalk.yellow(`\n🔥 ${streak}일 연속 리뷰!`));
+  } catch {}
+
+  // 6. 최근 활동
+  try {
+    const recent = db.prepare(`
+      SELECT document_id, COUNT(*) as cnt FROM access_log
+      WHERE accessed_at > datetime('now', '-7 days')
+      GROUP BY document_id ORDER BY cnt DESC LIMIT 3
+    `).all() as any[];
+
+    if (recent.length > 0) {
+      console.log(chalk.dim('\n📊 이번 주 가장 많이 본 노트:'));
+      for (const r of recent) {
+        const doc = db.prepare('SELECT title FROM documents WHERE id = ?').get(r.document_id) as any;
+        console.log(`  ${r.cnt}회 — ${doc?.title ?? r.document_id}`);
+      }
+    }
+  } catch {}
+
+  console.log('\n' + chalk.dim('─'.repeat(50)));
+  console.log(chalk.dim('💡 stellavault review | stellavault gaps | stellavault graph'));
+}

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

@@ -0,0 +1,34 @@
+// sv capture <audio-file> — Voice Knowledge Capture (P3)
+
+import chalk from 'chalk';
+import { loadConfig, captureVoice, isWhisperAvailable } from '@stellavault/core';
+
+export async function captureCommand(audioFile: string, options: { model?: string; language?: string; tags?: string; folder?: string }) {
+  if (!isWhisperAvailable()) {
+    console.log(chalk.red('\n  Whisper not installed.'));
+    console.log(chalk.dim('  Install: pip install openai-whisper'));
+    console.log(chalk.dim('  Or: brew install whisper-cpp\n'));
+    return;
+  }
+
+  const config = loadConfig();
+  console.log(chalk.dim(`\n  Transcribing ${audioFile}...`));
+
+  const result = await captureVoice(audioFile, {
+    vaultPath: config.vaultPath,
+    model: options.model,
+    language: options.language,
+    tags: options.tags?.split(',').map(t => t.trim()),
+    folder: options.folder,
+  });
+
+  if (result.success) {
+    console.log(chalk.green(`\n  ✅ Captured: "${result.title}"`));
+    console.log(`    Tags: ${result.tags.join(', ')}`);
+    console.log(`    File: ${result.filePath}`);
+    console.log(chalk.dim(`    Transcript: ${result.transcript.slice(0, 100)}...`));
+    console.log(chalk.dim('\n  💡 Run stellavault index to add to the graph\n'));
+  } else {
+    console.log(chalk.red(`\n  ❌ Capture failed: ${result.error}\n`));
+  }
+}

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

@@ -0,0 +1,29 @@
+// stellavault card — SVG 프로필 카드 생성
+
+import chalk from 'chalk';
+import { writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+export async function cardCommand(options: { output?: string }) {
+  const output = options.output ?? 'knowledge-card.svg';
+  const outPath = resolve(process.cwd(), output);
+
+  console.error(chalk.dim('⏳ Generating profile card...'));
+
+  try {
+    // API 서버에서 SVG 가져오기 (서버가 실행 중이어야 함)
+    const res = await fetch('http://127.0.0.1:3333/api/profile-card');
+    if (!res.ok) throw new Error(`API error: ${res.status}. Is 'stellavault graph' running?`);
+
+    const svg = await res.text();
+    writeFileSync(outPath, svg, 'utf-8');
+
+    console.error(chalk.green(`✅ Profile card saved: ${outPath}`));
+    console.error(chalk.dim('   Embed in GitHub README:'));
+    console.error(chalk.dim(`   ![Knowledge Card](${output})`));
+  } catch (err) {
+    console.error(chalk.red(`❌ Failed: ${err}`));
+    console.error(chalk.dim('   Make sure API server is running: stellavault graph'));
+    process.exit(1);
+  }
+}

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

@@ -0,0 +1,172 @@
+// Design Ref: stellavault clip — 웹 페이지/YouTube를 Obsidian에 클리핑
+
+import chalk from 'chalk';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadConfig } from '@stellavault/core';
+
+export async function clipCommand(url: string, options: { folder?: string }) {
+  if (!url) {
+    console.error(chalk.red('❌ URL을 입력하세요: stellavault clip <url>'));
+    process.exit(1);
+  }
+
+  const config = loadConfig();
+  const vaultPath = config.vaultPath;
+  if (!vaultPath) {
+    console.error(chalk.red('❌ vaultPath not configured'));
+    process.exit(1);
+  }
+
+  const folder = options.folder ?? '06_Research/clips';
+  const targetDir = join(vaultPath, folder);
+  mkdirSync(targetDir, { recursive: true });
+
+  console.error(chalk.dim(`📎 Clipping: ${url}`));
+
+  try {
+    // URL 유형 감지
+    const isYouTube = /youtube\.com\/watch|youtu\.be\//.test(url);
+
+    let title: string;
+    let content: string;
+
+    if (isYouTube) {
+      // YouTube — 메타데이터 + 설명 추출
+      const result = await clipYouTube(url);
+      title = result.title;
+      content = result.content;
+    } else {
+      // 일반 웹페이지 — HTML → Markdown
+      const result = await clipWebPage(url);
+      title = result.title;
+      content = result.content;
+    }
+
+    // 파일명 생성 (안전한 문자만)
+    const safeTitle = title
+      .replace(/[<>:"/\\|?*]/g, '')
+      .replace(/\s+/g, ' ')
+      .trim()
+      .slice(0, 80);
+
+    const date = new Date().toISOString().slice(0, 10);
+    const fileName = `${date} ${safeTitle}.md`;
+    const filePath = join(targetDir, fileName);
+
+    // Frontmatter + 내용 조합
+    const md = [
+      '---',
+      `title: "${safeTitle}"`,
+      `source: "${url}"`,
+      `clipped: ${date}`,
+      `tags: [clip${isYouTube ? ', youtube' : ''}]`,
+      '---',
+      '',
+      `# ${safeTitle}`,
+      '',
+      `> Source: ${url}`,
+      `> Clipped: ${date}`,
+      '',
+      content,
+    ].join('\n');
+
+    writeFileSync(filePath, md, 'utf-8');
+
+    console.log(chalk.green(`✅ Saved: ${fileName}`));
+    console.log(chalk.dim(`   → ${filePath}`));
+    console.log(chalk.dim('   💡 stellavault index로 재인덱싱하면 검색 가능'));
+  } catch (err) {
+    console.error(chalk.red(`❌ Clip failed: ${(err as Error).message}`));
+    process.exit(1);
+  }
+}
+
+async function clipWebPage(url: string): Promise<{ title: string; content: string }> {
+  const res = await fetch(url, {
+    headers: { 'User-Agent': 'Mozilla/5.0 stellavault-clipper/1.0' },
+  });
+  const html = await res.text();
+
+  // 제목 추출
+  const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+  const title = titleMatch ? titleMatch[1].trim() : new URL(url).hostname;
+
+  // HTML → 간단한 마크다운 변환
+  let content = html
+    // 스크립트/스타일 제거
+    .replace(/<script[\s\S]*?<\/script>/gi, '')
+    .replace(/<style[\s\S]*?<\/style>/gi, '')
+    // 헤딩
+    .replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, '\n# $1\n')
+    .replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, '\n## $1\n')
+    .replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, '\n### $1\n')
+    // 단락/줄바꿈
+    .replace(/<p[^>]*>([\s\S]*?)<\/p>/gi, '\n$1\n')
+    .replace(/<br\s*\/?>/gi, '\n')
+    // 링크
+    .replace(/<a[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, '[$2]($1)')
+    // 리스트
+    .replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, '- $1\n')
+    // 강조
+    .replace(/<(strong|b)[^>]*>([\s\S]*?)<\/\1>/gi, '**$2**')
+    .replace(/<(em|i)[^>]*>([\s\S]*?)<\/\1>/gi, '*$2*')
+    // 코드
+    .replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, '`$1`')
+    .replace(/<pre[^>]*>([\s\S]*?)<\/pre>/gi, '\n```\n$1\n```\n')
+    // 나머지 태그 제거
+    .replace(/<[^>]+>/g, '')
+    // HTML 엔티티
+    .replace(/&amp;/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;/g, "'")
+    .replace(/&nbsp;/g, ' ')
+    // 다중 줄바꿈 정리
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+
+  // 너무 길면 자르기
+  if (content.length > 10000) {
+    content = content.slice(0, 10000) + '\n\n...(truncated)';
+  }
+
+  return { title, content };
+}
+
+async function clipYouTube(url: string): Promise<{ title: string; content: string }> {
+  // YouTube 페이지에서 메타데이터 추출
+  const res = await fetch(url, {
+    headers: { 'User-Agent': 'Mozilla/5.0 stellavault-clipper/1.0' },
+  });
+  const html = await res.text();
+
+  const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+  const title = (titleMatch ? titleMatch[1] : 'YouTube Video')
+    .replace(/ - YouTube$/, '')
+    .trim();
+
+  // 비디오 설명 추출 시도
+  const descMatch = html.match(/"shortDescription":"([\s\S]*?)"/);
+  const description = descMatch
+    ? descMatch[1].replace(/\\n/g, '\n').replace(/\\"/g, '"').slice(0, 3000)
+    : '(설명 없음)';
+
+  const videoId = url.match(/(?:v=|youtu\.be\/)([a-zA-Z0-9_-]+)/)?.[1] ?? '';
+
+  const content = [
+    `![thumbnail](https://img.youtube.com/vi/${videoId}/maxresdefault.jpg)`,
+    '',
+    '## 설명',
+    '',
+    description,
+    '',
+    `## 링크`,
+    '',
+    `- [YouTube](${url})`,
+    videoId ? `- [Embed](https://www.youtube.com/embed/${videoId})` : '',
+  ].filter(Boolean).join('\n');
+
+  return { title, content };
+}

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

@@ -0,0 +1,75 @@
+// sv cloud sync/restore/status — E2E encrypted cloud backup (F-A04)
+
+import chalk from 'chalk';
+import { loadConfig } from '@stellavault/core';
+import { syncToCloud, restoreFromCloud, getSyncState } from '@stellavault/core';
+import type { CloudConfig } from '@stellavault/core';
+
+function getCloudConfig(): CloudConfig | null {
+  const endpoint = process.env.SV_CLOUD_ENDPOINT;
+  const bucket = process.env.SV_CLOUD_BUCKET ?? 'stellavault';
+  const accessKeyId = process.env.SV_CLOUD_ACCESS_KEY ?? '';
+  const secretAccessKey = process.env.SV_CLOUD_SECRET_KEY ?? '';
+  const encryptionKey = process.env.SV_CLOUD_ENCRYPTION_KEY;
+
+  if (!endpoint || !secretAccessKey) return null;
+
+  return { endpoint, bucket, accessKeyId, secretAccessKey, encryptionKey };
+}
+
+export async function cloudSyncCommand() {
+  const cloudConfig = getCloudConfig();
+  if (!cloudConfig) {
+    console.log(chalk.red('\n  Cloud not configured. Set environment variables:'));
+    console.log(chalk.dim('    SV_CLOUD_ENDPOINT=https://xxx.r2.cloudflarestorage.com'));
+    console.log(chalk.dim('    SV_CLOUD_SECRET_KEY=your_api_token'));
+    console.log(chalk.dim('    SV_CLOUD_ENCRYPTION_KEY=your_passphrase (optional)\n'));
+    return;
+  }
+
+  const config = loadConfig();
+  console.log(chalk.dim('\n  Encrypting and uploading...'));
+
+  const result = await syncToCloud(config.dbPath, cloudConfig);
+
+  if (result.success) {
+    console.log(chalk.green('\n  ✅ Cloud sync complete'));
+    console.log(`    DB: ${(result.dbSize / 1024).toFixed(0)}KB → Encrypted: ${(result.encryptedSize / 1024).toFixed(0)}KB`);
+    console.log(chalk.dim(`    ${result.timestamp}\n`));
+  } else {
+    console.log(chalk.red(`\n  ❌ Sync failed: ${result.error}\n`));
+  }
+}
+
+export async function cloudRestoreCommand() {
+  const cloudConfig = getCloudConfig();
+  if (!cloudConfig) {
+    console.log(chalk.red('\n  Cloud not configured. See: sv cloud sync --help\n'));
+    return;
+  }
+
+  const config = loadConfig();
+  console.log(chalk.dim('\n  Downloading and decrypting...'));
+
+  const result = await restoreFromCloud(config.dbPath, cloudConfig);
+
+  if (result.success) {
+    console.log(chalk.green('\n  ✅ Restore complete'));
+    console.log(`    Encrypted: ${(result.encryptedSize / 1024).toFixed(0)}KB → DB: ${(result.dbSize / 1024).toFixed(0)}KB`);
+    console.log(chalk.dim('    Previous DB backed up as .backup\n'));
+  } else {
+    console.log(chalk.red(`\n  ❌ Restore failed: ${result.error}\n`));
+  }
+}
+
+export async function cloudStatusCommand() {
+  const state = getSyncState();
+  if (!state) {
+    console.log(chalk.yellow('\n  No cloud sync history. Run: sv cloud sync\n'));
+    return;
+  }
+
+  console.log(chalk.bold('\n  ☁️  Cloud Sync Status'));
+  console.log(`    Last sync: ${state.lastSync}`);
+  console.log(`    DB size:   ${(state.dbSize / 1024).toFixed(0)}KB\n`);
+}

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

@@ -0,0 +1,41 @@
+// stellavault contradictions — detect contradicting statements (F-A12)
+
+import chalk from 'chalk';
+import { loadConfig, createKnowledgeHub } from '@stellavault/core';
+import { detectContradictions } from '@stellavault/core';
+
+export async function contradictionsCommand(_opts: any, cmd: any) {
+  const globalOpts = cmd?.parent?.opts?.() ?? {};
+  const jsonMode = globalOpts.json;
+  const config = loadConfig();
+  const hub = createKnowledgeHub(config);
+
+  console.error(chalk.dim('Scanning for contradictions...'));
+  await hub.store.initialize();
+  await hub.embedder.initialize();
+
+  const pairs = await detectContradictions(hub.store, 20);
+  await hub.store.close();
+
+  if (jsonMode) {
+    console.log(JSON.stringify({ count: pairs.length, contradictions: pairs }, null, 2));
+    return;
+  }
+
+  console.log('');
+  console.log(chalk.bold(`  ⚡ ${pairs.length} potential contradictions found`));
+  console.log('');
+
+  for (const p of pairs) {
+    const confColor = p.confidence >= 0.8 ? chalk.red : p.confidence >= 0.6 ? chalk.yellow : chalk.dim;
+    console.log(`  ${confColor(`${Math.round(p.confidence * 100)}%`)} ${chalk.dim(`[${p.type}]`)} ${chalk.bold(p.docA.title)} vs ${chalk.bold(p.docB.title)}`);
+    console.log(`    A: ${chalk.dim(p.docA.statement.slice(0, 80))}`);
+    console.log(`    B: ${chalk.dim(p.docB.statement.slice(0, 80))}`);
+    console.log('');
+  }
+
+  if (pairs.length === 0) {
+    console.log(chalk.green('  No contradictions detected. Your knowledge is consistent!'));
+    console.log('');
+  }
+}