stellavault 0.5.4 → 0.6.0

package/dist/stellavault.js

@@ -1349,9 +1349,9 @@ async function extractTimedTranscriptFromHtml(html) {
 async function extractTimedTranscriptViaTool(videoId) {
   const { execSync: execSync2 } = await import("node:child_process");
   const { readdirSync: readdirSync9, readFileSync: readFileSync18, unlinkSync } = await import("node:fs");
-  const { join: join29 } = await import("node:path");
+  const { join: join30 } = await import("node:path");
   const tmpDir = (await import("node:os")).tmpdir();
-  const tmpBase = join29(tmpDir, `sv-sub-${videoId}`);
+  const tmpBase = join30(tmpDir, `sv-sub-${videoId}`);
   const url = `https://www.youtube.com/watch?v=${videoId}`;
   for (const lang of ["ko", "en"]) {
     try {
@@ -1362,10 +1362,10 @@ async function extractTimedTranscriptViaTool(videoId) {
     const files = readdirSync9(tmpDir).filter((f) => f.startsWith(`sv-sub-${videoId}`) && f.endsWith(".srv1"));
     if (files.length === 0)
       continue;
-    const xml = readFileSync18(join29(tmpDir, files[0]), "utf-8");
+    const xml = readFileSync18(join30(tmpDir, files[0]), "utf-8");
     for (const f of files) {
       try {
-        unlinkSync(join29(tmpDir, f));
+        unlinkSync(join30(tmpDir, f));
       } catch {
       }
     }
@@ -5138,7 +5138,7 @@ function createApiServer(options) {
         res.status(404).json({ error: "Document not found" });
         return;
       }
-      const { resolve: resolve22, join: join29 } = await import("node:path");
+      const { resolve: resolve22, join: join30 } = await import("node:path");
       const { writeFileSync: writeFileSync21, readFileSync: readFileSync18 } = await import("node:fs");
       const fullPath = resolve22(vaultPath, doc.filePath);
       if (!fullPath.startsWith(resolve22(vaultPath))) {
@@ -5188,13 +5188,13 @@ function createApiServer(options) {
         return;
       }
       const { resolve: resolve22 } = await import("node:path");
-      const { unlinkSync, existsSync: existsSync24 } = await import("node:fs");
+      const { unlinkSync, existsSync: existsSync25 } = await import("node:fs");
       const fullPath = resolve22(vaultPath, doc.filePath);
       if (!fullPath.startsWith(resolve22(vaultPath))) {
         res.status(403).json({ error: "Access denied" });
         return;
       }
-      if (existsSync24(fullPath)) {
+      if (existsSync25(fullPath)) {
         unlinkSync(fullPath);
       }
       await store.deleteByDocumentId(id);
@@ -5352,9 +5352,9 @@ function createApiServer(options) {
         }
         try {
           const { writeFileSync: writeFileSync21, unlinkSync } = await import("node:fs");
-          const { join: join29 } = await import("node:path");
+          const { join: join30 } = await import("node:path");
           const { tmpdir } = await import("node:os");
-          const tmpPath = join29(tmpdir(), `sv-upload-${Date.now()}-${file.originalname}`);
+          const tmpPath = join30(tmpdir(), `sv-upload-${Date.now()}-${file.originalname}`);
           writeFileSync21(tmpPath, file.buffer);
           const { extractFileContent: extractFileContent2, isBinaryFormat: isBinaryFormat2 } = await Promise.resolve().then(() => (init_file_extractors(), file_extractors_exports));
           const ext = file.originalname.split(".").pop()?.toLowerCase() ?? "";
@@ -5531,10 +5531,10 @@ function createApiServer(options) {
         return;
       }
       const { readFileSync: readFileSync18, writeFileSync: writeFileSync21, unlinkSync } = await import("node:fs");
-      const { join: join29, resolve: resolve22, relative: relative2 } = await import("node:path");
+      const { join: join30, resolve: resolve22, relative: relative2 } = await import("node:path");
       const [keeper, removed] = docA.content.length >= docB.content.length ? [docA, docB] : [docB, docA];
-      const keeperPath = resolve22(join29(vaultPath, keeper.filePath));
-      const removedPath = resolve22(join29(vaultPath, removed.filePath));
+      const keeperPath = resolve22(join30(vaultPath, keeper.filePath));
+      const removedPath = resolve22(join30(vaultPath, removed.filePath));
       const vaultRoot = resolve22(vaultPath);
       if (!keeperPath.startsWith(vaultRoot) || !removedPath.startsWith(vaultRoot)) {
         res.status(400).json({ error: "Invalid file path" });
@@ -5572,7 +5572,7 @@ ${removed.content}`;
         return;
       }
       const { writeFileSync: writeFileSync21, mkdirSync: mkdirSync22 } = await import("node:fs");
-      const { join: join29 } = await import("node:path");
+      const { join: join30 } = await import("node:path");
       const nameA = clusterA.replace(/\s*\(\d+\)$/, "");
       const nameB = clusterB.replace(/\s*\(\d+\)$/, "");
       const resultsA = await searchEngine.search({ query: nameA, limit: 3 });
@@ -5613,13 +5613,13 @@ ${removed.content}`;
       ].join("\n");
       const safeTitle = title.replace(/[<>:"/\\|?*]/g, "").replace(/\s+/g, " ");
       const { resolve: resolve22 } = await import("node:path");
-      const dir = resolve22(join29(vaultPath, "01_Knowledge"));
+      const dir = resolve22(join30(vaultPath, "01_Knowledge"));
       if (!dir.startsWith(resolve22(vaultPath))) {
         res.status(400).json({ error: "Invalid path" });
         return;
       }
       mkdirSync22(dir, { recursive: true });
-      const filePath = join29(dir, `${safeTitle}.md`);
+      const filePath = join30(dir, `${safeTitle}.md`);
       writeFileSync21(filePath, content, "utf-8");
       res.json({ success: true, title: safeTitle, path: filePath });
     } catch (err) {
@@ -5797,12 +5797,12 @@ ${removed.content}`;
       const { resolve: resolve22 } = await import("node:path");
       const syncScript = resolve22(process.cwd(), "packages/sync/sync-to-obsidian.mjs");
       const syncDir = resolve22(process.cwd(), "packages/sync");
-      const { existsSync: existsSync24 } = await import("node:fs");
-      if (!existsSync24(syncScript)) {
+      const { existsSync: existsSync25 } = await import("node:fs");
+      if (!existsSync25(syncScript)) {
         res.json({ success: false, error: "sync script not found" });
         return;
       }
-      if (!existsSync24(resolve22(syncDir, ".env"))) {
+      if (!existsSync25(resolve22(syncDir, ".env"))) {
         res.json({ success: false, error: ".env not found" });
         return;
       }
@@ -5877,9 +5877,9 @@ ${desc}
           content = content.slice(0, 1e4) + "\n\n...(truncated)";
       }
       const { writeFileSync: writeFileSync21, mkdirSync: mkdirSync22 } = await import("node:fs");
-      const { join: join29 } = await import("node:path");
+      const { join: join30 } = await import("node:path");
       const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-      const clipDir = join29(vaultPath || ".", "06_Research", "clips");
+      const clipDir = join30(vaultPath || ".", "06_Research", "clips");
       mkdirSync22(clipDir, { recursive: true });
       const fileName = `${date} ${safeTitle}.md`;
       const md = `---
@@ -5894,8 +5894,8 @@ tags: [clip${isYT ? ", youtube" : ""}]
 > Source: ${url}
 
 ${content}`;
-      writeFileSync21(join29(clipDir, fileName), md, "utf-8");
-      res.json({ success: true, fileName, path: join29(clipDir, fileName) });
+      writeFileSync21(join30(clipDir, fileName), md, "utf-8");
+      res.json({ success: true, fileName, path: join30(clipDir, fileName) });
     } catch (err) {
       console.error(err);
       res.status(500).json({ error: "Clip failed" });
@@ -6612,7 +6612,7 @@ async function indexCommand(vaultPath) {
   const config = loadConfig();
   const vault2 = vaultPath ?? config.vaultPath;
   if (!vault2) {
-    console.error(chalk.red("Error: vault \uACBD\uB85C\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. stellavault index <path> \uB610\uB294 .stellavault.json\uC5D0 vaultPath \uC124\uC815"));
+    console.error(chalk.red("Error: vault path required. Use stellavault index <path> or set vaultPath in .stellavault.json"));
     process.exit(1);
   }
   const dbPath = vaultPath ? getVaultDbPath(vault2) : config.dbPath;
@@ -6625,13 +6625,13 @@ async function indexCommand(vaultPath) {
     } catch {
     }
   }
-  const spinner = ora("\uCD08\uAE30\uD654 \uC911...").start();
+  const spinner = ora("Initializing...").start();
   const store = createSqliteVecStore(dbPath);
   await store.initialize();
-  spinner.text = "\uC784\uBCA0\uB529 \uBAA8\uB378 \uB85C\uB529 \uC911...";
+  spinner.text = "Loading embedding model...";
   const embedder = createLocalEmbedder(config.embedding.localModel);
   await embedder.initialize();
-  spinner.text = "\uC778\uB371\uC2F1 \uC2DC\uC791...";
+  spinner.text = "Starting indexing...";
   const result = await indexVault(vault2, {
     store,
     embedder,
@@ -6643,9 +6643,9 @@ async function indexCommand(vaultPath) {
   await store.close();
   spinner.stop();
   console.log("");
-  console.log(chalk.green("\u2705 \uC778\uB371\uC2F1 \uC644\uB8CC"));
-  console.log(`  \u{1F4C4} \uC778\uB371\uC2F1: ${result.indexed}\uAC74 | \u23ED\uFE0F \uC2A4\uD0B5: ${result.skipped}\uAC74 | \u{1F5D1}\uFE0F \uC0AD\uC81C: ${result.deleted}\uAC74${result.failed ? ` | \u274C \uC2E4\uD328: ${result.failed}\uAC74` : ""}`);
-  console.log(`  \u{1F9E9} \uCCAD\uD06C: ${result.totalChunks}\uAC1C | \u23F1 ${(result.elapsedMs / 1e3).toFixed(1)}\uCD08`);
+  console.log(chalk.green("\u2705 Indexing complete"));
+  console.log(`  \u{1F4C4} Indexed: ${result.indexed} | \u23ED\uFE0F Skipped: ${result.skipped} | \u{1F5D1}\uFE0F Deleted: ${result.deleted}${result.failed ? ` | \u274C Failed: ${result.failed}` : ""}`);
+  console.log(`  \u{1F9E9} Chunks: ${result.totalChunks} | \u23F1 ${(result.elapsedMs / 1e3).toFixed(1)}s`);
   console.log(`  \u{1F4BE} DB: ${dbPath}`);
 }
 
@@ -6678,7 +6678,7 @@ async function searchCommand(query, options, cmd) {
     return;
   }
   if (results.length === 0) {
-    console.log(chalk2.yellow("\uAC80\uC0C9 \uACB0\uACFC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk2.yellow("No search results found."));
     return;
   }
   console.log("");
@@ -6986,7 +6986,7 @@ async function decayCommand(_opts, cmd) {
   console.log(`  \u{1F4CA} Average R:        ${report.averageR}`);
   console.log(chalk8.dim("\u2500".repeat(50)));
   if (report.topDecaying.length > 0) {
-    console.log(chalk8.yellow("\n\u{1F4CB} Top Decaying Notes (\uB9AC\uB9C8\uC778\uB4DC \uD544\uC694):"));
+    console.log(chalk8.yellow("\n\u{1F4CB} Top Decaying Notes (need review):"));
     for (const d of report.topDecaying.slice(0, 20)) {
       const rBar = "\u2588".repeat(Math.round(d.retrievability * 10)) + "\u2591".repeat(10 - Math.round(d.retrievability * 10));
       const color = d.retrievability < 0.3 ? chalk8.red : chalk8.yellow;
@@ -7077,11 +7077,11 @@ async function reviewCommand(options) {
   const decayEngine = new DecayEngine(db);
   const decaying = await decayEngine.getDecaying(0.6, count);
   if (decaying.length === 0) {
-    console.log(chalk10.green("\n\u2728 \uBAA8\uB4E0 \uC9C0\uC2DD\uC774 \uAC74\uAC15\uD569\uB2C8\uB2E4! \uB9AC\uBDF0\uD560 \uB178\uD2B8\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk10.green("\n\u2728 All knowledge is healthy! No notes to review."));
     return;
   }
   console.log(chalk10.green(`
-\u{1F9E0} \uC624\uB298\uC758 \uB9AC\uBDF0 (${decaying.length}\uAC1C)`));
+\u{1F9E0} Today's review (${decaying.length})`));
   console.log(chalk10.dim("\u2500".repeat(50)));
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   const ask2 = (q) => new Promise((r) => rl.question(q, r));
@@ -7093,10 +7093,10 @@ async function reviewCommand(options) {
     const color = d.retrievability < 0.3 ? chalk10.red : chalk10.yellow;
     console.log(`
 ${chalk10.bold(`[${i + 1}/${decaying.length}]`)} ${chalk10.cyan(d.title)}`);
-    console.log(`  ${color(rBar)} R=${d.retrievability.toFixed(2)} | ${elapsed}\uC77C \uC804`);
-    const answer = await ask2(chalk10.dim("  \u2192 [y]\uC5F4\uAE30 [n]\uC2A4\uD0B5 [s]\uB0B4\uC77C \uB2E4\uC2DC [q]\uC885\uB8CC: "));
+    console.log(`  ${color(rBar)} R=${d.retrievability.toFixed(2)} | ${elapsed} days ago`);
+    const answer = await ask2(chalk10.dim("  \u2192 [y]open [n]skip [s]snooze [q]quit: "));
     if (answer.toLowerCase() === "q") {
-      console.log(chalk10.dim("\n\uB9AC\uBDF0 \uC911\uB2E8."));
+      console.log(chalk10.dim("\nReview stopped."));
       break;
     }
     if (answer.toLowerCase() === "s") {
@@ -7106,7 +7106,7 @@ ${chalk10.bold(`[${i + 1}/${decaying.length}]`)} ${chalk10.cyan(d.title)}`);
         timestamp: new Date(Date.now() - 23 * 36e5).toISOString()
         // 23시간 전으로 기록
       });
-      console.log(chalk10.dim("  \u23F0 \uB0B4\uC77C \uB2E4\uC2DC \uB9AC\uB9C8\uC778\uB4DC"));
+      console.log(chalk10.dim("  \u23F0 Reminder set for tomorrow"));
       continue;
     }
     if (answer.toLowerCase() === "y") {
@@ -7129,14 +7129,14 @@ ${chalk10.bold(`[${i + 1}/${decaying.length}]`)} ${chalk10.cyan(d.title)}`);
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       });
       reviewed++;
-      console.log(chalk10.green("  \u2705 \uC5F4\uAE30 + \uAE30\uC5B5 \uAC15\uB3C4 \uC5C5\uB370\uC774\uD2B8"));
+      console.log(chalk10.green("  \u2705 Opened + memory strength updated"));
     } else {
-      console.log(chalk10.dim("  \u23ED\uFE0F \uC2A4\uD0B5"));
+      console.log(chalk10.dim("  \u23ED\uFE0F Skipped"));
     }
   }
   rl.close();
   console.log(chalk10.dim("\n\u2500".repeat(50)));
-  console.log(chalk10.green(`\uB9AC\uBDF0 \uC644\uB8CC! ${reviewed}/${decaying.length}\uAC1C \uC5F4\uB78C`));
+  console.log(chalk10.green(`Review complete! ${reviewed}/${decaying.length} reviewed`));
   try {
     const days = db.prepare(`
       SELECT DISTINCT date(accessed_at) as d FROM access_log
@@ -7153,7 +7153,7 @@ ${chalk10.bold(`[${i + 1}/${decaying.length}]`)} ${chalk10.cyan(d.title)}`);
         break;
     }
     if (streak > 1) {
-      console.log(chalk10.yellow(`\u{1F525} ${streak}\uC77C \uC5F0\uC18D \uB9AC\uBDF0!`));
+      console.log(chalk10.yellow(`\u{1F525} ${streak}-day review streak!`));
     }
   } catch {
   }
@@ -7170,24 +7170,24 @@ async function duplicatesCommand(options) {
   await hub.embedder.initialize();
   const pairs = await detectDuplicates(hub.store, threshold, 20);
   if (pairs.length === 0) {
-    console.log(chalk11.green("\n\u2728 \uC911\uBCF5 \uB178\uD2B8\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4!"));
+    console.log(chalk11.green("\n\u2728 No duplicate notes found!"));
     return;
   }
   console.log(chalk11.yellow(`
-\u{1F50D} \uC720\uC0AC \uB178\uD2B8 ${pairs.length}\uC30D \uBC1C\uACAC (threshold: ${threshold})`));
+\u{1F50D} Found ${pairs.length} similar note pairs (threshold: ${threshold})`));
   console.log(chalk11.dim("\u2500".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 ? chalk11.red : chalk11.yellow;
     console.log(`
-${chalk11.bold(`[${i + 1}]`)} ${color(`${pct}% \uC720\uC0AC`)}`);
+${chalk11.bold(`[${i + 1}]`)} ${color(`${pct}% similar`)}`);
     console.log(`  A: ${chalk11.cyan(p.docA.title)}`);
     console.log(`     ${chalk11.dim(p.docA.filePath)}`);
     console.log(`  B: ${chalk11.cyan(p.docB.title)}`);
     console.log(`     ${chalk11.dim(p.docB.filePath)}`);
   }
-  console.log(chalk11.dim("\n\u{1F4A1} Obsidian\uC5D0\uC11C \uC9C1\uC811 \uBCD1\uD569\uD558\uAC70\uB098 \uC0AD\uC81C\uD558\uC138\uC694"));
+  console.log(chalk11.dim("\n\u{1F4A1} Merge or delete duplicates in Obsidian"));
 }
 
 // packages/cli/dist/commands/gaps-cmd.js
@@ -7201,25 +7201,25 @@ async function gapsCommand() {
   const report = await detectKnowledgeGaps(hub.store);
   console.log(chalk12.green("\n\u{1F573}\uFE0F Knowledge Gap Report"));
   console.log(chalk12.dim("\u2500".repeat(50)));
-  console.log(`  \uD074\uB7EC\uC2A4\uD130: ${report.totalClusters}\uAC1C`);
-  console.log(`  \uAC2D: ${chalk12.yellow(String(report.totalGaps))}\uAC1C (High+Medium)`);
-  console.log(`  \uACE0\uB9BD \uB178\uB4DC: ${report.isolatedNodes.length}\uAC1C`);
+  console.log(`  Clusters: ${report.totalClusters}`);
+  console.log(`  Gaps: ${chalk12.yellow(String(report.totalGaps))} (High+Medium)`);
+  console.log(`  Isolated nodes: ${report.isolatedNodes.length}`);
   console.log(chalk12.dim("\u2500".repeat(50)));
   if (report.gaps.length > 0) {
-    console.log(chalk12.yellow("\n\u{1F4CA} \uD074\uB7EC\uC2A4\uD130 \uAC04 \uAC2D:"));
+    console.log(chalk12.yellow("\n\u{1F4CA} Inter-cluster gaps:"));
     for (const gap of report.gaps) {
       const icon = gap.severity === "high" ? "\u{1F534}" : gap.severity === "medium" ? "\u{1F7E1}" : "\u{1F7E2}";
       console.log(`  ${icon} ${gap.clusterA} \u2194 ${gap.clusterB}`);
-      console.log(`     \uC5F0\uACB0: ${gap.bridgeCount}\uAC1C | \uC81C\uC548: ${chalk12.cyan(gap.suggestedTopic)}`);
+      console.log(`     Bridges: ${gap.bridgeCount} | Suggestion: ${chalk12.cyan(gap.suggestedTopic)}`);
     }
   }
   if (report.isolatedNodes.length > 0) {
-    console.log(chalk12.dim("\n\u{1F3DD}\uFE0F \uACE0\uB9BD\uB41C \uB178\uD2B8 (\uC5F0\uACB0 \u22641):"));
+    console.log(chalk12.dim("\n\u{1F3DD}\uFE0F Isolated notes (\u22641 connections):"));
     for (const n of report.isolatedNodes.slice(0, 10)) {
-      console.log(`  \u2022 ${n.title} (${n.connections}\uAC1C \uC5F0\uACB0)`);
+      console.log(`  \u2022 ${n.title} (${n.connections} connections)`);
     }
   }
-  console.log(chalk12.dim("\n\u{1F4A1} \uAC2D \uC601\uC5ED\uC758 \uC9C0\uC2DD\uC744 \uBCF4\uAC15\uD558\uBA74 \uC9C0\uC2DD \uADF8\uB798\uD504\uAC00 \uB354 \uCD18\uCD18\uD574\uC9D1\uB2C8\uB2E4"));
+  console.log(chalk12.dim("\n\u{1F4A1} Filling knowledge gaps strengthens your graph"));
 }
 
 // packages/cli/dist/commands/clip-cmd.js
@@ -7228,7 +7228,7 @@ import { writeFileSync as writeFileSync16, mkdirSync as mkdirSync17 } from "node
 import { join as join22 } from "node:path";
 async function clipCommand(url, options) {
   if (!url) {
-    console.error(chalk13.red("\u274C URL\uC744 \uC785\uB825\uD558\uC138\uC694: stellavault clip <url>"));
+    console.error(chalk13.red("\u274C Please provide a URL: stellavault clip <url>"));
     process.exit(1);
   }
   const config = loadConfig();
@@ -7276,7 +7276,7 @@ async function clipCommand(url, options) {
     writeFileSync16(filePath, md, "utf-8");
     console.log(chalk13.green(`\u2705 Saved: ${fileName}`));
     console.log(chalk13.dim(`   \u2192 ${filePath}`));
-    console.log(chalk13.dim("   \u{1F4A1} stellavault index\uB85C \uC7AC\uC778\uB371\uC2F1\uD558\uBA74 \uAC80\uC0C9 \uAC00\uB2A5"));
+    console.log(chalk13.dim("   \u{1F4A1} Run stellavault index to make it searchable"));
   } catch (err) {
     console.error(chalk13.red(`\u274C Clip failed: ${err.message}`));
     process.exit(1);
@@ -7303,16 +7303,16 @@ async function clipYouTube(url) {
   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, 3e3) : "(\uC124\uBA85 \uC5C6\uC74C)";
+  const description = descMatch ? descMatch[1].replace(/\\n/g, "\n").replace(/\\"/g, '"').slice(0, 3e3) : "(No description)";
   const videoId = url.match(/(?:v=|youtu\.be\/)([a-zA-Z0-9_-]+)/)?.[1] ?? "";
   const content = [
     `![thumbnail](https://img.youtube.com/vi/${videoId}/maxresdefault.jpg)`,
     "",
-    "## \uC124\uBA85",
+    "## Description",
     "",
     description,
     "",
-    `## \uB9C1\uD06C`,
+    `## Links`,
     "",
     `- [YouTube](${url})`,
     videoId ? `- [Embed](https://www.youtube.com/embed/${videoId})` : ""
@@ -7329,32 +7329,32 @@ async function briefCommand() {
   await hub.embedder.initialize();
   const db = hub.store.getDb();
   if (!db) {
-    console.error(chalk14.red("\u274C DB \uC811\uADFC \uBD88\uAC00"));
+    console.error(chalk14.red("\u274C Cannot access database"));
     process.exit(1);
   }
   const decayEngine = new DecayEngine(db);
   const stats = await hub.store.getStats();
-  console.log(chalk14.green("\n\u2600\uFE0F Good morning! \uC624\uB298\uC758 \uC9C0\uC2DD \uBE0C\uB9AC\uD551"));
+  console.log(chalk14.green("\n\u2600\uFE0F Good morning! Today's knowledge briefing"));
   console.log(chalk14.dim("\u2500".repeat(50)));
   console.log(`
-\u{1F4DA} ${chalk14.bold(String(stats.documentCount))}\uAC1C \uB178\uD2B8 | ${stats.chunkCount} \uCCAD\uD06C`);
+\u{1F4DA} ${chalk14.bold(String(stats.documentCount))} notes | ${stats.chunkCount} chunks`);
   const report = await decayEngine.computeAll();
   const avgRColor = report.averageR >= 0.7 ? chalk14.green : report.averageR >= 0.5 ? chalk14.yellow : chalk14.red;
-  console.log(`\u{1F9E0} \uC804\uCCB4 \uAC74\uAC15\uB3C4: ${avgRColor("R=" + report.averageR)} | \uAC10\uC1E0 ${chalk14.yellow(String(report.decayingCount))}\uAC1C | \uC704\uD5D8 ${chalk14.red(String(report.criticalCount))}\uAC1C`);
+  console.log(`\u{1F9E0} Overall health: ${avgRColor("R=" + report.averageR)} | Decaying ${chalk14.yellow(String(report.decayingCount))} | Critical ${chalk14.red(String(report.criticalCount))}`);
   if (report.topDecaying.length > 0) {
-    console.log(chalk14.yellow("\n\u{1F4CB} \uB9AC\uBDF0 \uCD94\uCC9C:"));
+    console.log(chalk14.yellow("\n\u{1F4CB} Review recommendations:"));
     for (const d of report.topDecaying.slice(0, 5)) {
       const bar = "\u2588".repeat(Math.round(d.retrievability * 10)) + "\u2591".repeat(10 - Math.round(d.retrievability * 10));
       console.log(`  ${chalk14.dim(bar)} R=${d.retrievability.toFixed(2)} ${d.title}`);
     }
-    console.log(chalk14.dim("  \u2192 stellavault review \uB85C \uB9AC\uBDF0 \uC2DC\uC791"));
+    console.log(chalk14.dim("  \u2192 Run stellavault review to start"));
   }
   try {
     const gapReport = await detectKnowledgeGaps(hub.store);
     const highGaps = gapReport.gaps.filter((g) => g.severity === "high");
     if (highGaps.length > 0) {
       console.log(chalk14.yellow(`
-\u{1F573}\uFE0F \uC9C0\uC2DD \uAC2D ${highGaps.length}\uAC1C:`));
+\u{1F573}\uFE0F ${highGaps.length} knowledge gaps:`));
       for (const g of highGaps.slice(0, 3)) {
         console.log(`  \u{1F534} ${g.clusterA.replace(/\s*\(\d+\)$/, "")} \u2194 ${g.clusterB.replace(/\s*\(\d+\)$/, "")}`);
       }
@@ -7376,7 +7376,7 @@ async function briefCommand() {
     }
     if (streak > 0)
       console.log(chalk14.yellow(`
-\u{1F525} ${streak}\uC77C \uC5F0\uC18D \uB9AC\uBDF0!`));
+\u{1F525} ${streak}-day review streak!`));
   } catch {
   }
   try {
@@ -7386,10 +7386,10 @@ async function briefCommand() {
       GROUP BY document_id ORDER BY cnt DESC LIMIT 3
     `).all();
     if (recent.length > 0) {
-      console.log(chalk14.dim("\n\u{1F4CA} \uC774\uBC88 \uC8FC \uAC00\uC7A5 \uB9CE\uC774 \uBCF8 \uB178\uD2B8:"));
+      console.log(chalk14.dim("\n\u{1F4CA} Most viewed notes this week:"));
       for (const r of recent) {
         const doc = db.prepare("SELECT title FROM documents WHERE id = ?").get(r.document_id);
-        console.log(`  ${r.cnt}\uD68C \u2014 ${doc?.title ?? r.document_id}`);
+        console.log(`  ${r.cnt} views \u2014 ${doc?.title ?? r.document_id}`);
       }
     }
   } catch {
@@ -7407,11 +7407,11 @@ async function digestCommand(options) {
   await hub.store.initialize();
   const db = hub.store.getDb();
   if (!db) {
-    console.error(chalk15.red("\u274C DB \uC811\uADFC \uBD88\uAC00"));
+    console.error(chalk15.red("\u274C Cannot access database"));
     process.exit(1);
   }
   console.log(chalk15.green(`
-\u{1F4CA} \uC9C0\uC2DD \uD65C\uB3D9 \uB9AC\uD3EC\uD2B8 (\uCD5C\uADFC ${days}\uC77C)`));
+\u{1F4CA} Knowledge activity report (last ${days} days)`));
   console.log(chalk15.dim("\u2500".repeat(50)));
   const accessStats = db.prepare(`
     SELECT access_type, COUNT(*) as cnt
@@ -7420,10 +7420,10 @@ async function digestCommand(options) {
   `).all();
   const totalAccess = accessStats.reduce((s, r) => s + r.cnt, 0);
   console.log(`
-\u{1F50D} \uCD1D \uC811\uADFC: ${chalk15.bold(String(totalAccess))}\uD68C`);
+\u{1F50D} Total access: ${chalk15.bold(String(totalAccess))} times`);
   for (const r of accessStats) {
     const icon = r.access_type === "view" ? "\u{1F441}\uFE0F" : r.access_type === "search" ? "\u{1F50D}" : "\u{1F916}";
-    console.log(`  ${icon} ${r.access_type}: ${r.cnt}\uD68C`);
+    console.log(`  ${icon} ${r.access_type}: ${r.cnt} times`);
   }
   const topDocs = db.prepare(`
     SELECT al.document_id, d.title, COUNT(*) as cnt
@@ -7435,10 +7435,10 @@ async function digestCommand(options) {
   `).all();
   if (topDocs.length > 0) {
     console.log(chalk15.dim(`
-\u{1F4C4} \uAC00\uC7A5 \uB9CE\uC774 \uC811\uADFC\uD55C \uB178\uD2B8:`));
+\u{1F4C4} Most accessed notes:`));
     for (const d of topDocs) {
       const bar = "\u2588".repeat(Math.min(d.cnt, 20));
-      console.log(`  ${chalk15.cyan(bar)} ${d.cnt}\uD68C ${d.title}`);
+      console.log(`  ${chalk15.cyan(bar)} ${d.cnt} views ${d.title}`);
     }
   }
   const dailyActivity = db.prepare(`
@@ -7447,7 +7447,7 @@ async function digestCommand(options) {
     GROUP BY day ORDER BY day
   `).all();
   if (dailyActivity.length > 0) {
-    console.log(chalk15.dim("\n\u{1F4C5} \uC77C\uBCC4 \uD65C\uB3D9:"));
+    console.log(chalk15.dim("\n\u{1F4C5} Daily activity:"));
     const maxCnt = Math.max(...dailyActivity.map((d) => d.cnt));
     for (const d of dailyActivity) {
       const barLen = Math.round(d.cnt / maxCnt * 20);
@@ -7463,25 +7463,25 @@ async function digestCommand(options) {
     GROUP BY d.type ORDER BY cnt DESC
   `).all();
   if (typeStats.length > 0) {
-    console.log(chalk15.dim("\n\u{1F4CA} \uC811\uADFC\uD55C \uB178\uD2B8 \uC720\uD615:"));
+    console.log(chalk15.dim("\n\u{1F4CA} Note types accessed:"));
     for (const t2 of typeStats) {
-      console.log(`  ${t2.type}: ${t2.cnt}\uAC1C`);
+      console.log(`  ${t2.type}: ${t2.cnt}`);
     }
   }
   const decayEngine = new DecayEngine(db);
   const report = await decayEngine.computeAll();
   console.log(`
-\u{1F9E0} \uAC74\uAC15\uB3C4: R=${report.averageR} | \uAC10\uC1E0 ${report.decayingCount}\uAC1C | \uC704\uD5D8 ${report.criticalCount}\uAC1C`);
+\u{1F9E0} Health: R=${report.averageR} | Decaying ${report.decayingCount} | Critical ${report.criticalCount}`);
   console.log(chalk15.dim("\n\u2550".repeat(50)));
   if (options.visual) {
-    const { writeFileSync: writeFileSync21, mkdirSync: mkdirSync22, existsSync: existsSync24 } = await import("node:fs");
-    const { join: join29, resolve: resolve22 } = await import("node:path");
+    const { writeFileSync: writeFileSync21, mkdirSync: mkdirSync22, existsSync: existsSync25 } = await import("node:fs");
+    const { join: join30, resolve: resolve22 } = await import("node:path");
     const outputDir = resolve22(config.vaultPath, "_stellavault/digests");
-    if (!existsSync24(outputDir))
+    if (!existsSync25(outputDir))
       mkdirSync22(outputDir, { recursive: true });
     const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const filename = `digest-${date}.md`;
-    const outputPath = join29(outputDir, filename);
+    const outputPath = join30(outputDir, filename);
     const pieData = (typeStats.length > 0 ? typeStats : [{ type: "note", cnt: 1 }]).map((t2) => `    "${t2.type}" : ${t2.cnt}`).join("\n");
     const timelineData = dailyActivity.map((d) => `    ${d.day.slice(5)} : ${d.cnt}`).join("\n");
     const md = [
@@ -7598,6 +7598,92 @@ async function initCommand() {
       }
     });
     spinner.succeed(chalk16.green(`  Indexed ${result.indexed} docs, ${result.totalChunks} chunks (${(result.elapsedMs / 1e3).toFixed(1)}s)`));
+    if (result.indexed === 0) {
+      console.log(chalk16.yellow("\n  Your vault is empty \u2014 creating 3 starter notes so you can explore.\n"));
+      const rawDir = join23(vaultPath, "raw");
+      mkdirSync18(rawDir, { recursive: true });
+      const samples = [
+        {
+          file: "welcome-to-stellavault.md",
+          content: `---
+title: "Welcome to Stellavault"
+tags: [getting-started]
+---
+
+# Welcome to Stellavault
+
+This is your self-compiling knowledge base. Drop any note, URL, or file here and Stellavault will organize, index, and connect it automatically.
+
+## How it works
+
+1. **Capture** \u2014 Write notes, clip URLs, ingest PDFs
+2. **Organize** \u2014 Auto-classify, tag, and link
+3. **Distill** \u2014 Find gaps, duplicates, contradictions
+4. **Express** \u2014 Draft blog posts, reports from your knowledge
+
+Try: \`stellavault graph\` to see your notes as a 3D neural network.`
+        },
+        {
+          file: "spaced-repetition.md",
+          content: `---
+title: "Spaced Repetition & Memory Decay"
+tags: [learning, memory]
+---
+
+# Spaced Repetition
+
+Forgetting is natural. The **Ebbinghaus forgetting curve** shows we lose ~70% of new information within 24 hours.
+
+## FSRS Algorithm
+
+Stellavault uses the **Free Spaced Repetition Scheduler** to track which notes are fading from your memory.
+
+- Run \`stellavault decay\` to see what you're forgetting
+- Run \`stellavault review\` for a daily review session
+- Each review strengthens the memory trace
+
+## Why it matters
+
+Knowledge you don't revisit becomes invisible. Spaced repetition surfaces the right note at the right time.`
+        },
+        {
+          file: "zettelkasten-method.md",
+          content: `---
+title: "The Zettelkasten Method"
+tags: [knowledge-management, zettelkasten]
+---
+
+# Zettelkasten
+
+Niklas Luhmann's note-taking system that produced 70+ books and 400+ papers.
+
+## Three stages
+
+1. **Fleeting notes** \u2014 Quick ideas captured in raw/
+2. **Literature notes** \u2014 Processed from sources
+3. **Permanent notes** \u2014 Refined, atomic, interconnected
+
+Stellavault follows this flow:
+- \`stellavault fleeting "idea"\` \u2192 captures to raw/
+- \`stellavault compile\` \u2192 promotes and links
+- \`stellavault promote note.md --to permanent\` \u2192 finalizes
+
+## Connection to Karpathy's self-compiling knowledge
+
+Andrej Karpathy's approach: every session auto-compiles into structured knowledge. Stellavault automates this: session-save \u2192 flush \u2192 wiki.`
+        }
+      ];
+      for (const s of samples) {
+        writeFileSync17(join23(rawDir, s.file), s.content, "utf-8");
+      }
+      const reSpinner = ora2({ text: "  Indexing sample notes...", indent: 2 }).start();
+      const reResult = await indexVault(vaultPath, {
+        store,
+        embedder,
+        chunkOptions: { maxTokens: 300, overlap: 50, minTokens: 50 }
+      });
+      reSpinner.succeed(chalk16.green(`  Indexed ${reResult.indexed} sample notes, ${reResult.totalChunks} chunks`));
+    }
     console.log("");
     console.log(chalk16.cyan("  Step 3/3") + " \u2014 Try your first search");
     console.log(chalk16.dim("  Type a topic you know about. Stellavault finds connections.\n"));
@@ -9099,55 +9185,206 @@ async function autopilotCommand(options) {
   await hub.store.close?.();
 }
 
+// packages/cli/dist/commands/doctor-cmd.js
+import chalk33 from "chalk";
+import { existsSync as existsSync24, statSync as statSync6 } from "node:fs";
+import { join as join29 } from "node:path";
+import { homedir as homedir15 } from "node:os";
+async function doctorCommand() {
+  console.log("");
+  console.log(chalk33.bold("  \u{1FA7A} Stellavault Doctor\n"));
+  const checks = [];
+  const nodeVersion2 = parseInt(process.versions.node.split(".")[0], 10);
+  checks.push({
+    name: "Node.js version",
+    pass: nodeVersion2 >= 20,
+    detail: `v${process.versions.node}`,
+    fix: nodeVersion2 < 20 ? "Download Node.js 20+: https://nodejs.org" : void 0
+  });
+  const configPaths = [
+    join29(process.cwd(), ".stellavault.json"),
+    join29(homedir15(), ".stellavault.json")
+  ];
+  const configPath = configPaths.find((p) => existsSync24(p));
+  checks.push({
+    name: "Config file",
+    pass: !!configPath,
+    detail: configPath ? configPath : "not found",
+    fix: !configPath ? "Run: stellavault init" : void 0
+  });
+  let vaultPath = "";
+  let dbPath = "";
+  if (configPath) {
+    try {
+      const { readFileSync: readFileSync18 } = await import("node:fs");
+      const config = JSON.parse(readFileSync18(configPath, "utf-8"));
+      vaultPath = config.vaultPath || "";
+      dbPath = config.dbPath || "";
+    } catch (err) {
+      checks.push({
+        name: "Config valid JSON",
+        pass: false,
+        detail: err.message,
+        fix: `Delete ${configPath} and re-run: stellavault init`
+      });
+    }
+  }
+  if (vaultPath) {
+    const vaultExists = existsSync24(vaultPath);
+    checks.push({
+      name: "Vault path",
+      pass: vaultExists,
+      detail: vaultExists ? vaultPath : `${vaultPath} (not found)`,
+      fix: !vaultExists ? `Create the folder or re-run: stellavault init` : void 0
+    });
+    if (vaultExists) {
+      try {
+        const { readdirSync: readdirSync9 } = await import("node:fs");
+        const files = readdirSync9(vaultPath, { recursive: true });
+        const mdCount = files.filter((f) => typeof f === "string" && f.endsWith(".md")).length;
+        checks.push({
+          name: "Markdown files in vault",
+          pass: mdCount > 0,
+          detail: `${mdCount} .md files`,
+          fix: mdCount === 0 ? "Add some .md notes to your vault, then run: stellavault index" : void 0
+        });
+      } catch {
+        checks.push({
+          name: "Vault readable",
+          pass: false,
+          detail: "Cannot read vault directory",
+          fix: "Check file permissions on your vault folder"
+        });
+      }
+    }
+  }
+  if (dbPath) {
+    const dbExists = existsSync24(dbPath);
+    checks.push({
+      name: "Database",
+      pass: dbExists,
+      detail: dbExists ? `${dbPath} (${formatBytes(statSync6(dbPath).size)})` : `${dbPath} (not found)`,
+      fix: !dbExists ? "Run: stellavault index" : void 0
+    });
+  } else if (configPath) {
+    checks.push({
+      name: "Database path",
+      pass: false,
+      detail: "dbPath not set in config",
+      fix: "Re-run: stellavault init"
+    });
+  }
+  const cacheDir = join29(homedir15(), ".cache", "onnxruntime");
+  const hfCache = join29(homedir15(), ".cache", "huggingface");
+  const xenovaCache = join29(homedir15(), ".cache", "xenova");
+  const modelCached = existsSync24(cacheDir) || existsSync24(hfCache) || existsSync24(xenovaCache) || existsSync24(join29(homedir15(), ".cache", "transformers"));
+  checks.push({
+    name: "Embedding model cached",
+    pass: modelCached,
+    detail: modelCached ? "local model files found" : "not downloaded yet",
+    fix: !modelCached ? "Will download automatically on first index (~30MB)" : void 0
+  });
+  const testDir = join29(homedir15(), ".stellavault");
+  try {
+    const { mkdirSync: mkdirSync22 } = await import("node:fs");
+    mkdirSync22(testDir, { recursive: true });
+    checks.push({ name: "Write permission (~/.stellavault)", pass: true, detail: "OK" });
+  } catch {
+    checks.push({
+      name: "Write permission (~/.stellavault)",
+      pass: false,
+      detail: "Cannot write to home directory",
+      fix: "Check disk space and permissions on your home folder"
+    });
+  }
+  let passCount = 0;
+  for (const c of checks) {
+    const icon = c.pass ? chalk33.green("\u2713") : chalk33.red("\u2717");
+    console.log(`  ${icon} ${c.name}  ${chalk33.dim("\u2014")}  ${c.pass ? chalk33.dim(c.detail) : chalk33.yellow(c.detail)}`);
+    if (c.fix)
+      console.log(`    ${chalk33.dim("Fix:")} ${c.fix}`);
+    if (c.pass)
+      passCount++;
+  }
+  console.log("");
+  if (passCount === checks.length) {
+    console.log(chalk33.green.bold(`  All ${checks.length} checks passed. You're good to go! \u2726
+`));
+  } else {
+    const failCount = checks.length - passCount;
+    console.log(chalk33.yellow(`  ${failCount} issue${failCount > 1 ? "s" : ""} found. Fix them and re-run: stellavault doctor
+`));
+  }
+  process.exit(passCount === checks.length ? 0 : 1);
+}
+function formatBytes(bytes) {
+  if (bytes < 1024)
+    return `${bytes}B`;
+  if (bytes < 1024 * 1024)
+    return `${(bytes / 1024).toFixed(1)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+
 // packages/cli/dist/index.js
+var nodeVersion = parseInt(process.versions.node.split(".")[0], 10);
+if (nodeVersion < 20) {
+  console.error(`
+  Stellavault requires Node.js 20 or later.
+  You are running Node.js ${process.versions.node}.
+
+  Download the latest LTS: https://nodejs.org
+`);
+  process.exit(1);
+}
 var program = new Command();
-var SV_VERSION = true ? "0.5.4" : "0.0.0-dev";
-program.name("stellavault").description("Stellavault \u2014 Turn your Obsidian vault into a 3D neural knowledge graph").version(SV_VERSION).option("--json", "Output in JSON format (for scripting)").option("--quiet", "Suppress non-essential output");
+var SV_VERSION = true ? "0.6.0" : "0.0.0-dev";
+program.name("stellavault").description("Stellavault \u2014 Self-compiling knowledge base for your Obsidian vault").version(SV_VERSION).option("--json", "Output in JSON format (for scripting)").option("--quiet", "Suppress non-essential output");
 program.command("init").description("Interactive setup wizard \u2014 get started in 3 minutes").action(initCommand);
-program.command("index [vault-path]").description("Obsidian vault\uB97C \uBCA1\uD130\uD654\uD558\uC5EC \uC778\uB371\uC2F1\uD569\uB2C8\uB2E4").action(indexCommand);
-program.command("search <query>").description("\uC9C0\uC2DD \uBCA0\uC774\uC2A4\uC5D0\uC11C \uAC80\uC0C9\uD569\uB2C8\uB2E4").option("-l, --limit <n>", "\uACB0\uACFC \uC218", "5").action(searchCommand);
-program.command("serve").description("MCP \uC11C\uBC84\uB97C \uC2DC\uC791\uD569\uB2C8\uB2E4 (Claude Code \uC5F0\uB3D9)").action(serveCommand);
-program.command("status").description("\uC778\uB371\uC2A4 \uC0C1\uD0DC\uB97C \uD655\uC778\uD569\uB2C8\uB2E4").action(statusCommand);
-program.command("graph").description("3D Knowledge Graph API \uC11C\uBC84\uB97C \uC2DC\uC791\uD569\uB2C8\uB2E4").action(graphCommand);
-program.command("card").description("SVG \uD504\uB85C\uD544 \uCE74\uB4DC\uB97C \uC0DD\uC131\uD569\uB2C8\uB2E4").option("-o, --output <path>", "\uCD9C\uB825 \uD30C\uC77C \uACBD\uB85C", "knowledge-card.svg").action(cardCommand);
-program.command("learn").description("AI learning path \u2014 personalized recommendations based on decay + gaps").action(learnCommand);
+program.command("doctor").description("Diagnose setup issues (config, vault, DB, model, Node version)").action(doctorCommand);
+program.command("index [vault-path]").description("Index your vault (vectorize all documents for search)").action(indexCommand);
+program.command("status").description("Show index status (document count, last indexed, DB size)").action(statusCommand);
+program.command("search <query>").description("Search your knowledge base (hybrid BM25 + vector)").option("-l, --limit <n>", "Max results", "5").action(searchCommand);
+program.command("ask <question>").description("Ask a question \u2014 search, compose answer, optionally save").option("-s, --save", "Save answer as a new note in your vault").option("-q, --quotes", "Show direct quotes from sources").action((question, opts) => askCommand(question, opts));
+program.command("ingest <input>").description("Ingest any input (URL, file, text, PDF, YouTube) into your vault").option("-t, --tags <tags>", "Comma-separated tags").option("-s, --stage <stage>", "Note stage: fleeting, literature, permanent", "fleeting").option("--title <title>", "Override title").action((input, opts) => ingestCommand(input, opts));
+program.command("clip <url>").description("Clip a web page or YouTube video into your vault").option("-f, --folder <path>", "Vault subfolder for clips", "06_Research/clips").action(clipCommand);
+program.command("graph").description("Launch the 3D knowledge graph in your browser").action(graphCommand);
+program.command("serve").description("Start MCP server (for Claude Code / Claude Desktop)").action(serveCommand);
+program.command("decay").description("Memory decay report \u2014 find notes you are forgetting").action(decayCommand);
+program.command("brief").description("Daily knowledge briefing (decay + gaps + activity)").action(briefCommand);
+program.command("digest").description("Weekly knowledge activity report").option("-d, --days <n>", "Period in days", "7").option("-v, --visual", "Save as .md with Mermaid charts for Obsidian").action(digestCommand);
+program.command("gaps").description("Detect knowledge gaps (weak connections between clusters)").action(gapsCommand);
+program.command("duplicates").description("Find duplicate or near-identical notes").option("-t, --threshold <n>", "Similarity threshold (0\u20131)", "0.88").action(duplicatesCommand);
 program.command("contradictions").description("Detect contradicting statements across your notes").action(contradictionsCommand);
-program.command("decay").description("\uC9C0\uC2DD \uAC10\uC1E0 \uB9AC\uD3EC\uD2B8\uB97C \uCD9C\uB825\uD569\uB2C8\uB2E4 (\uC78A\uC5B4\uAC00\uB294 \uB178\uD2B8 \uD655\uC778)").action(decayCommand);
-program.command("brief").description("\uC624\uB298\uC758 \uC9C0\uC2DD \uBE0C\uB9AC\uD551 (\uAC10\uC1E0 + \uAC2D + \uD65C\uB3D9 \uC694\uC57D)").action(briefCommand);
-program.command("digest").description("\uC8FC\uAC04 \uC9C0\uC2DD \uD65C\uB3D9 \uB9AC\uD3EC\uD2B8").option("-d, --days <n>", "\uAE30\uAC04 (\uC77C)", "7").option("-v, --visual", "Save as .md with Mermaid charts for Obsidian").action(digestCommand);
-program.command("clip <url>").description("\uC6F9 \uD398\uC774\uC9C0/YouTube\uB97C Obsidian\uC5D0 \uD074\uB9AC\uD551").option("-f, --folder <path>", "vault \uB0B4 \uC800\uC7A5 \uD3F4\uB354", "06_Research/clips").action(clipCommand);
-program.command("gaps").description("\uC9C0\uC2DD \uAC2D\uC744 \uD0D0\uC9C0\uD569\uB2C8\uB2E4 (\uD074\uB7EC\uC2A4\uD130 \uAC04 \uC5F0\uACB0 \uBD80\uC871 \uC601\uC5ED)").action(gapsCommand);
-program.command("duplicates").description("\uC911\uBCF5/\uC720\uC0AC \uB178\uD2B8\uB97C \uD0D0\uC9C0\uD569\uB2C8\uB2E4").option("-t, --threshold <n>", "\uC720\uC0AC\uB3C4 \uC784\uACC4\uAC12 (0~1)", "0.88").action(duplicatesCommand);
-program.command("review").description("\uC77C\uC77C \uC9C0\uC2DD \uB9AC\uBDF0 \u2014 \uC78A\uC5B4\uAC00\uB294 \uB178\uD2B8\uB97C Obsidian\uC5D0\uC11C \uC5F4\uC5B4 \uB9AC\uBDF0").option("-n, --count <n>", "\uB9AC\uBDF0\uD560 \uB178\uD2B8 \uC218", "5").action(reviewCommand);
-program.command("sync").description("Notion \u2192 Obsidian \uB3D9\uAE30\uD654").option("--upload", "PDCA \uBB38\uC11C\uB97C Notion\uC5D0 \uC5C5\uB85C\uB4DC").option("--watch", "5\uBD84 \uAC04\uACA9 \uC790\uB3D9 \uB3D9\uAE30\uD654").action(syncCommand);
-var federate = program.command("federate").description("Federation \u2014 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 \u2014 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);
-program.command("ask <question>").description("Ask a question about your knowledge base \u2014 search, compose answer, optionally save").option("-s, --save", "Save answer as a new note in your vault").option("-q, --quotes", "Show direct quotes from sources (Insight Extraction mode)").action((question, opts) => askCommand(question, opts));
+program.command("review").description("Daily review \u2014 resurface fading notes for spaced repetition").option("-n, --count <n>", "Number of notes to review", "5").action(reviewCommand);
+program.command("learn").description("AI learning path \u2014 personalized recommendations based on decay + gaps").action(learnCommand);
+program.command("lint").description("Knowledge health check \u2014 gaps, duplicates, contradictions, stale notes").action(() => lintCommand());
+program.command("draft [topic]").description("Generate a draft from your knowledge (blog/report/outline/instagram/thread/script)").option("--format <type>", "Output format: blog, report, outline, instagram, thread, script").option("--ai", "Use Claude API for AI-enhanced draft (requires ANTHROPIC_API_KEY)").option("--blueprint <spec>", 'Chapter structure: "Ch1:tag1,tag2; Ch2:tag3"').action((topic, opts) => draftCommand(topic, opts));
 program.command("compile").description("Compile raw/ documents into a structured wiki").option("-r, --raw <dir>", "Raw documents directory (default: raw/)").option("-w, --wiki <dir>", "Wiki output directory (default: _wiki/)").option("-f, --force", "Overwrite existing wiki files").action((opts) => compileCommand(opts));
-program.command("draft [topic]").description("Express: Generate draft from knowledge (blog/report/outline/instagram/thread/script)").option("--format <type>", "Output format: blog, report, outline, instagram, thread, script").option("--ai", "Use Claude API for AI-enhanced draft (requires ANTHROPIC_API_KEY)").option("--blueprint <spec>", 'Chapter structure: "Ch1:tag1,tag2; Ch2:tag3"').action((topic, opts) => draftCommand(topic, opts));
-program.command("session-save").description("Save session summary to daily log (used by Claude Code hooks)").option("-s, --summary <text>", "Session summary text (or pipe via stdin)").option("-d, --decisions <text>", "Key decisions made").option("-l, --lessons <text>", "Lessons learned").option("-a, --actions <text>", "Action items").action((opts) => sessionSaveCommand(opts));
-program.command("flush").description("Flush daily logs \u2192 wiki: extract concepts, rebuild connections (Karpathy compile)").action(() => flushCommand());
-program.command("adr <title>").description("Create an Architecture Decision Record (structured decision log)").option("--context <text>", "Why is this decision needed?").option("--options <text>", "What alternatives were considered?").option("--decision <text>", "What was decided and why?").option("--consequences <text>", "What are the implications?").action((title, opts) => adrCommand(title, opts));
-program.command("lint").description("Knowledge health check \u2014 find gaps, duplicates, contradictions, stale notes").action(() => lintCommand());
+program.command("card").description("Generate an SVG knowledge profile card").option("-o, --output <path>", "Output file path", "knowledge-card.svg").action(cardCommand);
 program.command("fleeting <text>").description("Capture a fleeting idea instantly to raw/ folder").option("-t, --tags <tags>", "Comma-separated tags").action((text, opts) => fleetingCommand(text, opts));
-program.command("ingest <input>").description("Ingest any input (URL, file, text) into your knowledge base").option("-t, --tags <tags>", "Comma-separated tags").option("-s, --stage <stage>", "Note stage: fleeting, literature, permanent", "fleeting").option("--title <title>", "Override title").action((input, opts) => ingestCommand(input, opts));
+program.command("capture <audio-file>").description("Voice capture \u2014 transcribe audio to a 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);
 program.command("promote <file>").description("Promote a note: fleeting \u2192 literature \u2192 permanent").requiredOption("--to <stage>", "Target stage: literature or permanent").action((file, opts) => promoteCommand(file, opts));
+program.command("flush").description("Flush daily logs \u2192 wiki: extract concepts, rebuild connections").action(() => flushCommand());
+program.command("session-save").description("Save session summary to daily log (used by Claude Code hooks)").option("-s, --summary <text>", "Session summary text (or pipe via stdin)").option("-d, --decisions <text>", "Key decisions made").option("-l, --lessons <text>", "Lessons learned").option("-a, --actions <text>", "Action items").action((opts) => sessionSaveCommand(opts));
+program.command("adr <title>").description("Create an Architecture Decision Record (structured decision log)").option("--context <text>", "Why is this decision needed?").option("--options <text>", "What alternatives were considered?").option("--decision <text>", "What was decided and why?").option("--consequences <text>", "What are the implications?").action((title, opts) => adrCommand(title, opts));
 program.command("autopilot").description("Run the full knowledge flywheel: inbox \u2192 compile \u2192 lint").option("--once", "Run once (default)").action((opts) => autopilotCommand(opts));
+program.command("sync").description("Sync Notion \u2192 Obsidian").option("--upload", "Upload PDCA documents to Notion").option("--watch", "Auto-sync every 5 minutes").action(syncCommand);
 var vault = program.command("vault").description("Multi-Vault \u2014 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);
+var federate = program.command("federate").description("Federation \u2014 P2P knowledge network");
+federate.command("join").description("Join the Stella 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);
 var cloud = program.command("cloud").description("Cloud \u2014 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);
-var pack = program.command("pack").description("Knowledge Pack \uAD00\uB9AC");
-pack.command("create <name>").description("\uAC80\uC0C9/\uD074\uB7EC\uC2A4\uD130 \uAE30\uBC18 Knowledge Pack \uC0DD\uC131").option("--from-search <query>", "\uAC80\uC0C9 \uCFFC\uB9AC\uC5D0\uC11C \uC0DD\uC131").option("--from-cluster <id>", "\uD074\uB7EC\uC2A4\uD130 ID\uC5D0\uC11C \uC0DD\uC131").option("--author <name>", "\uC791\uC131\uC790", "anonymous").option("--license <license>", "\uB77C\uC774\uC120\uC2A4", "CC-BY-4.0").option("--description <desc>", "\uC124\uBA85").option("--limit <n>", "\uCD5C\uB300 \uCCAD\uD06C \uC218", "100").action(packCreateCommand);
-pack.command("export <name>").description(".sv-pack \uD30C\uC77C\uB85C \uB0B4\uBCF4\uB0B4\uAE30").option("-o, --output <path>", "\uCD9C\uB825 \uACBD\uB85C").action(packExportCommand);
-pack.command("import <file>").description(".sv-pack \uD30C\uC77C \uAC00\uC838\uC624\uAE30 \u2192 \uBCA1\uD130 DB \uBCD1\uD569").action(packImportCommand);
-pack.command("list").description("\uC124\uCE58\uB41C \uD329 \uBAA9\uB85D").action(packListCommand);
-pack.command("info <name>").description("\uD329 \uC0C1\uC138 \uC815\uBCF4").action(packInfoCommand);
+var pack = program.command("pack").description("Knowledge Packs \u2014 create, share, and import curated bundles");
+pack.command("create <name>").description("Create a Knowledge Pack from search results or clusters").option("--from-search <query>", "Build from a search query").option("--from-cluster <id>", "Build from a cluster ID").option("--author <name>", "Author name", "anonymous").option("--license <license>", "License", "CC-BY-4.0").option("--description <desc>", "Pack description").option("--limit <n>", "Max chunks to include", "100").action(packCreateCommand);
+pack.command("export <name>").description("Export a pack as a .sv-pack file").option("-o, --output <path>", "Output path").action(packExportCommand);
+pack.command("import <file>").description("Import a .sv-pack file into your vector DB").action(packImportCommand);
+pack.command("list").description("List installed packs").action(packListCommand);
+pack.command("info <name>").description("Show pack details").action(packInfoCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stellavault",
-  "version": "0.5.4",
+  "version": "0.6.0",
   "description": "Drop anything. It compiles itself into knowledge. Claude remembers everything you know. Local-first MCP server, vault files never modified.",
   "repository": {
     "type": "git",