stellavault 0.1.0 → 0.2.1

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

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

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

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

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

@@ -1,41 +0,0 @@
-// 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('');
-  }
-}

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

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

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

@@ -1,38 +0,0 @@
-// 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에서 직접 병합하거나 삭제하세요'));
-}