@open330/kiwimu 0.4.1 → 0.8.0

package/src/index.ts

@@ -8,14 +8,46 @@ import { Store } from "./store";
 const program = new Command()
   .name("kiwimu")
   .description("🥝 Kiwi Mu — 나만의 학습 위키를 만드세요")
-  .version("0.2.0");
+  .version("0.8.0");
 
 // --- init ---
 program
   .command("init [name]")
   .description("새 Kiwi Mu 프로젝트를 생성합니다")
-  .action(async (name?: string) => {
+  .option("--demo", "샘플 데이터로 즉시 체험")
+  .action(async (name: string | undefined, opts: { demo?: boolean }) => {
     const root = process.cwd();
+
+    if (opts.demo) {
+      // Demo mode: skip API key prompt, use sample data
+      const demoName = name || "Quantum Wiki Demo";
+      console.log(`\x1b[34m🥝 데모 모드로 '${demoName}' 위키를 생성합니다...\x1b[0m`);
+
+      const config = defaultConfig(demoName);
+      config.llm.provider = "demo";
+      config.llm.model = "";
+      config.llm.api_key = "";
+      config.llm.endpoint = "";
+      saveConfig(root, config);
+
+      const store = new Store(join(root, DB_FILE));
+      store.initSchema();
+
+      const { setupDemo } = await import("./demo/setup");
+      await setupDemo(store);
+
+      const { buildSite } = await import("./build/renderer");
+      const count = await buildSite(store, config, root);
+      store.close();
+
+      console.log(`\x1b[32m✅ ${count}개 페이지가 빌드되었습니다!\x1b[0m`);
+
+      const { startServer } = await import("./server");
+      console.log("🎉 데모 위키가 준비되었습니다! http://localhost:8000 에서 확인하세요");
+      startServer(root, 8000, "localhost");
+      return;
+    }
+
     if (Bun.file(join(root, CONFIG_FILE)).size > 0) {
       try {
         require("fs").accessSync(join(root, CONFIG_FILE));
@@ -25,7 +57,6 @@ program
     }
 
     const p = await import("@clack/prompts");
-
     p.intro("🥝 Kiwi Mu — 새 학습 위키 만들기");
 
     const values = await p.group({
@@ -91,94 +122,53 @@ program
 // --- add ---
 program
   .command("add <source>")
-  .description("URL 또는 PDF 파일을 추가합니다")
+  .description("URL 또는 파일을 추가합니다 (PDF, DOCX, PPTX, DOC, PPT, KEY, RTF)")
   .action(async (source: string) => {
     const root = findProjectRoot();
+    const config = loadConfig(root);
+    const persona = getActivePersona(config);
     const store = new Store(join(root, DB_FILE));
-
-    const isUrl = source.startsWith("http://") || source.startsWith("https://");
-    const isPdf = source.toLowerCase().endsWith(".pdf");
-
-    if (isUrl) {
-      await addUrl(store, source);
-    } else if (isPdf) {
-      await addPdf(store, source);
-    } else {
-      console.log(`\x1b[31m지원하지 않는 소스 형식: ${source}\x1b[0m`);
-      console.log("URL (http/https) 또는 PDF 파일을 입력해주세요.");
+    try {
+      const isUrl = source.startsWith("http://") || source.startsWith("https://");
+
+      if (isUrl) {
+        const { validateUrl } = await import("./ingest/web");
+        validateUrl(source);
+        console.log(`\x1b[34m📥 URL 가져오는 중: ${source}\x1b[0m`);
+        const { ingestUrl } = await import("./services/ingest");
+        const result = await ingestUrl(root, store, source, config.llm, persona, (s) => console.log(`  ${s}`));
+        console.log(`\x1b[32m✅ 📖 ${result.sourceCount}개 원본 + 📝 ${result.conceptCount}개 개념 문서 생성\x1b[0m`);
+        console.log(`\x1b[34m📊 LLM: ${result.usage.totalCalls}회 호출, ~$${result.usage.estimatedCostUsd.toFixed(4)}\x1b[0m`);
+      } else {
+        const { resolve } = await import("path");
+        const absPath = resolve(source);
+        const file = Bun.file(absPath);
+        if (!(await file.exists())) {
+          console.error(`\x1b[31m❌ 파일을 찾을 수 없습니다: ${source}\x1b[0m`);
+          process.exit(1);
+        }
+        const ext = source.split(".").pop()?.toLowerCase() || "";
+        const SUPPORTED_EXTENSIONS = ['pdf', 'docx', 'pptx', 'doc', 'ppt', 'key', 'rtf'];
+        if (!SUPPORTED_EXTENSIONS.includes(ext)) {
+          console.error(`\x1b[31m❌ 지원하지 않는 파일 형식입니다: .${ext}\x1b[0m`);
+          console.error(`   지원 형식: ${SUPPORTED_EXTENSIONS.join(', ')}`);
+          process.exit(1);
+        }
+        console.log(`\x1b[34m📥 파일 처리 중: ${source}\x1b[0m`);
+        const { ingestFile } = await import("./services/ingest");
+        const result = await ingestFile(root, store, absPath, source, config.llm, persona, (s) => console.log(`  ${s}`));
+        console.log(`\x1b[32m✅ 📖 ${result.sourceCount}개 원본 + 📝 ${result.conceptCount}개 개념 문서 생성\x1b[0m`);
+        console.log(`\x1b[34m📊 LLM: ${result.usage.totalCalls}회 호출, ~$${result.usage.estimatedCostUsd.toFixed(4)}\x1b[0m`);
+      }
+    } catch (e: unknown) {
+      const message = e instanceof Error ? e.message : String(e);
+      console.error(`\x1b[31m❌ ${message}\x1b[0m`);
+      process.exit(1);
+    } finally {
       store.close();
-      return;
     }
-
-    store.close();
   });
 
-async function initLLM(root: string) {
-  const config = loadConfig(root);
-  const { setLLMConfig } = await import("./llm-client");
-  setLLMConfig(config.llm);
-}
-
-async function addUrl(store: Store, url: string) {
-  const { fetchPage } = await import("./ingest/web");
-  const { llmChunkDocument, htmlToRawText } = await import("./pipeline/llm-chunker");
-
-  const root = findProjectRoot();
-  await initLLM(root);
-  const config = loadConfig(root);
-  const persona = getActivePersona(config);
-
-  console.log(`\x1b[34m📥 URL 가져오는 중: ${url}\x1b[0m`);
-  const { title, html } = await fetchPage(url);
-  console.log(`  제목: ${title}`);
-
-  const source = store.addSource(url, "web", title, html);
-  const rawText = htmlToRawText(html);
-
-  console.log("\x1b[34m📄 LLM 기반 문서 분석 중...\x1b[0m");
-  const { sourceCount, conceptCount } = await llmChunkDocument(rawText, title, source.id, store, 0, persona);
-  console.log(`\x1b[32m✅ 📖 ${sourceCount}개 원본 + 📝 ${conceptCount}개 개념 문서 생성\x1b[0m`);
-
-  const { getUsageStats, getEstimatedCost, printUsageSummary } = await import("./llm-client");
-  printUsageSummary();
-  const u = getUsageStats();
-  store.addUsageLog(source.id, u.totalCalls, u.promptTokens, u.completionTokens, u.totalTokens, getEstimatedCost());
-}
-
-async function addPdf(store: Store, pdfPath: string) {
-  const { extractTextFromPdf } = await import("./ingest/pdf");
-  const { llmChunkDocument } = await import("./pipeline/llm-chunker");
-  const { resolve } = await import("path");
-
-  const absPath = resolve(pdfPath);
-  const file = Bun.file(absPath);
-  if (!(await file.exists())) {
-    console.log(`\x1b[31m파일을 찾을 수 없습니다: ${pdfPath}\x1b[0m`);
-    return;
-  }
-
-  const root = findProjectRoot();
-  await initLLM(root);
-  const config = loadConfig(root);
-  const persona = getActivePersona(config);
-
-  console.log(`\x1b[34m📥 PDF 처리 중: ${pdfPath}\x1b[0m`);
-  const { title, text } = await extractTextFromPdf(absPath);
-  console.log(`  제목: ${title}`);
-  console.log(`  텍스트 길이: ${text.length.toLocaleString()} 자`);
-
-  const source = store.addSource(absPath, "pdf", title, "(PDF)");
-
-  console.log("\x1b[34m📄 LLM 기반 문서 분석 중...\x1b[0m");
-  const { sourceCount, conceptCount } = await llmChunkDocument(text, title, source.id, store, 0, persona);
-  console.log(`\x1b[32m✅ 📖 ${sourceCount}개 원본 + 📝 ${conceptCount}개 개념 문서 생성\x1b[0m`);
-
-  const { getUsageStats, getEstimatedCost, printUsageSummary } = await import("./llm-client");
-  printUsageSummary();
-  const u = getUsageStats();
-  store.addUsageLog(source.id, u.totalCalls, u.promptTokens, u.completionTokens, u.totalTokens, getEstimatedCost());
-}
-
 // --- expand ---
 program
   .command("expand")
@@ -190,43 +180,45 @@ program
     const root = findProjectRoot();
     const config = loadConfig(root);
     const store = new Store(join(root, DB_FILE));
+    try {
+      const provider: string = opts.provider || (config as Record<string, unknown>).expand?.provider;
+      if (!provider) {
+        console.log("\x1b[33m확장 프로바이더가 설정되지 않았습니다.\x1b[0m");
+        console.log("사용법: kiwimu expand --provider anthropic");
+        return;
+      }
 
-    const provider: string = opts.provider || config.expand.provider;
-    if (!provider) {
-      console.log("\x1b[33m확장 프로바이더가 설정되지 않았습니다.\x1b[0m");
-      console.log("사용법: kiwimu expand --provider anthropic");
-      store.close();
-      return;
-    }
-
-    const allPages = store.listPages();
-    let pages = allPages;
-    if (opts.pages) {
-      pages = allPages.filter((p) => (opts.pages as string[]).includes(p.slug));
-    }
-
-    console.log(`\x1b[34m🧠 ${pages.length}개 문서를 확장합니다...\x1b[0m`);
-
-    const isCli = provider === "claude-cli" || provider === "codex-cli";
-    const { expandWithApi, expandWithCli } = await import("./expand/llm");
+      const allPages = store.listPages();
+      let pages = allPages;
+      if (opts.pages) {
+        pages = allPages.filter((p) => (opts.pages as string[]).includes(p.slug));
+      }
 
-    for (let i = 0; i < pages.length; i++) {
-      const page = pages[i];
-      console.log(`  [${i + 1}/${pages.length}] ${page.title}`);
-      try {
-        const newContent = isCli
-          ? await expandWithCli(page, allPages, provider.replace("-cli", ""))
-          : await expandWithApi(page, allPages, provider, opts.model);
-        store.updatePageContent(page.id, newContent);
-      } catch (e: any) {
-        console.log(`    \x1b[31m실패: ${e.message}\x1b[0m`);
+      console.log(`\x1b[34m🧠 ${pages.length}개 문서를 확장합니다...\x1b[0m`);
+
+      const isCli = provider === "claude-cli" || provider === "codex-cli";
+      const { expandWithApi, expandWithCli } = await import("./expand/llm");
+
+      for (let i = 0; i < pages.length; i++) {
+        const page = pages[i];
+        console.log(`  [${i + 1}/${pages.length}] ${page.title}`);
+        try {
+          const newContent = isCli
+            ? await expandWithCli(page, allPages, provider.replace("-cli", ""))
+            : await expandWithApi(page, allPages, provider, opts.model);
+          store.updatePageContent(page.id, newContent);
+        } catch (e: unknown) {
+          const message = e instanceof Error ? e.message : String(e);
+          console.error(`    \x1b[31m❌ 실패: ${message}\x1b[0m`);
+        }
       }
-    }
 
-    const { autoLinkPages } = await import("./pipeline/linker");
-    const linkCount = autoLinkPages(store);
-    console.log(`\x1b[32m✅ 확장 완료! (${linkCount}개 링크 갱신)\x1b[0m`);
-    store.close();
+      const { autoLinkPages } = await import("./pipeline/linker");
+      const linkCount = autoLinkPages(store);
+      console.log(`\x1b[32m✅ 확장 완료! (${linkCount}개 링크 갱신)\x1b[0m`);
+    } finally {
+      store.close();
+    }
   });
 
 // --- build ---
@@ -237,14 +229,15 @@ program
     const root = findProjectRoot();
     const config = loadConfig(root);
     const store = new Store(join(root, DB_FILE));
-
-    const { buildSite } = await import("./build/renderer");
-
-    console.log("\x1b[34m🔨 위키 빌드 중...\x1b[0m");
-    const count = await buildSite(store, config, root);
-    console.log(`\x1b[32m✅ ${count}개 페이지가 빌드되었습니다!\x1b[0m`);
-    console.log(`  출력: ${join(root, config.build.output_dir)}/`);
-    store.close();
+    try {
+      const { buildSite } = await import("./build/renderer");
+      console.log("\x1b[34m🔨 위키 빌드 중...\x1b[0m");
+      const count = await buildSite(store, config, root);
+      console.log(`\x1b[32m✅ ${count}개 페이지가 빌드되었습니다!\x1b[0m`);
+      console.log(`  출력: ${join(root, config.build.output_dir)}/`);
+    } finally {
+      store.close();
+    }
   });
 
 // --- deploy ---
@@ -258,13 +251,15 @@ program
     const config = loadConfig(root);
     const siteDir = join(root, config.build.output_dir);
 
-    // Auto-build before deploy
     const store = new Store(join(root, DB_FILE));
-    const { buildSite } = await import("./build/renderer");
-    console.log("\x1b[34m🔨 빌드 중...\x1b[0m");
-    const count = await buildSite(store, config, root);
-    console.log(`\x1b[32m  ${count}개 페이지 빌드 완료\x1b[0m`);
-    store.close();
+    try {
+      const { buildSite } = await import("./build/renderer");
+      console.log("\x1b[34m🔨 빌드 중...\x1b[0m");
+      const count = await buildSite(store, config, root);
+      console.log(`\x1b[32m  ${count}개 페이지 빌드 완료\x1b[0m`);
+    } finally {
+      store.close();
+    }
 
     console.log(`\x1b[34m🚀 ${opts.target}에 배포 중...\x1b[0m`);
 
@@ -272,7 +267,6 @@ program
       const { deployGhPages } = await import("./deploy");
       await deployGhPages(siteDir, opts.message);
       console.log("\x1b[32m✅ GitHub Pages에 배포되었습니다!\x1b[0m");
-      // Try to get the pages URL
       try {
         const proc = Bun.spawn(["gh", "repo", "view", "--json", "url", "-q", ".url"], { stdout: "pipe" });
         const repoUrl = (await new Response(proc.stdout).text()).trim();
@@ -287,7 +281,8 @@ program
       await deployVercel(siteDir);
       console.log("\x1b[32m✅ Vercel에 배포되었습니다!\x1b[0m");
     } else {
-      console.log(`\x1b[31m지원하지 않는 배포 대상: ${opts.target}\x1b[0m`);
+      console.error(`\x1b[31m❌ 지원하지 않는 배포 대상: ${opts.target}\x1b[0m`);
+      process.exit(1);
     }
   });
 
@@ -303,8 +298,6 @@ program
     const siteDir = join(root, config.build.output_dir);
 
     const { existsSync } = await import("fs");
-
-    // Auto-build if needed
     if (!existsSync(siteDir)) {
       const store = new Store(join(root, DB_FILE));
       const { buildSite } = await import("./build/renderer");
@@ -312,318 +305,100 @@ program
       store.close();
     }
 
-    let isProcessing = false;
-    let processingStatus = "";
-
-    const port = parseInt(opts.port);
-    const hostname = opts.host;
-    console.log(`\x1b[32m🥝 Kiwi Mu 서버 시작!\x1b[0m`);
-    console.log(`  http://${hostname === "0.0.0.0" ? "localhost" : hostname}:${port}`);
-    if (hostname === "0.0.0.0") console.log("  네트워크에 공개됨 (0.0.0.0)");
-    console.log("  웹에서 문서 추가 가능합니다.\n");
-
-    Bun.serve({
-      port,
-      hostname,
-      async fetch(req) {
-        const url = new URL(req.url);
-
-        // ── API endpoints ──
-
-        // File upload endpoint
-        if (url.pathname === "/api/upload" && req.method === "POST") {
-          if (isProcessing) {
-            return Response.json({ error: "이미 처리 중입니다", status: processingStatus }, { status: 409 });
-          }
-
-          const formData = await req.formData();
-          const file = formData.get("file") as File | null;
-          if (!file) {
-            return Response.json({ error: "파일이 필요합니다" }, { status: 400 });
-          }
-
-          const ext = file.name.split(".").pop()?.toLowerCase() || "";
-          const supported = ["pdf", "docx", "doc", "pptx", "ppt", "key", "rtf"];
-          if (!supported.includes(ext)) {
-            return Response.json({ error: `지원하지 않는 형식: .${ext}. 지원: ${supported.join(", ")}` }, { status: 400 });
-          }
-
-          // Save uploaded file
-          const uploadDir = join(root, "uploads");
-          const { mkdirSync } = await import("fs");
-          mkdirSync(uploadDir, { recursive: true });
-          const filePath = join(uploadDir, file.name);
-          await Bun.write(filePath, await file.arrayBuffer());
-
-          isProcessing = true;
-          processingStatus = "파일 처리 시작...";
-
-          (async () => {
-            try {
-              const store = new Store(join(root, DB_FILE));
-              const { setLLMConfig, resetUsageStats, getUsageStats, getEstimatedCost } = await import("./llm-client");
-              setLLMConfig(loadConfig(root).llm);
-              const { llmChunkDocument } = await import("./pipeline/llm-chunker");
-              resetUsageStats();
-
-              let title: string;
-              let text: string;
-
-              if (ext === "pdf") {
-                const { extractTextFromPdf } = await import("./ingest/pdf");
-                processingStatus = "PDF 텍스트 추출 중...";
-                ({ title, text } = await extractTextFromPdf(filePath));
-              } else if (ext === "docx") {
-                const { extractTextFromDocx } = await import("./ingest/docx");
-                processingStatus = "DOCX 텍스트 추출 중...";
-                ({ title, text } = await extractTextFromDocx(filePath));
-              } else if (ext === "pptx") {
-                const { extractTextFromPptx } = await import("./ingest/pptx");
-                processingStatus = "PPTX 텍스트 추출 중...";
-                ({ title, text } = await extractTextFromPptx(filePath));
-              } else {
-                const { extractWithTextutil } = await import("./ingest/legacy");
-                processingStatus = `${ext.toUpperCase()} 텍스트 추출 중...`;
-                ({ title, text } = await extractWithTextutil(filePath));
-              }
-
-              const src = store.addSource(filePath, ext, title, "(file)");
-              // Clean up old pages from previous processing of same source
-              store.deletePagesBySource(src.id);
-
-              processingStatus = "LLM 분석 중...";
-              const currentPersona = getActivePersona(loadConfig(root));
-              await llmChunkDocument(text, title, src.id, store, 0, currentPersona);
-
-              const u = getUsageStats();
-              store.addUsageLog(src.id, u.totalCalls, u.promptTokens, u.completionTokens, u.totalTokens, getEstimatedCost());
-
-              processingStatus = "빌드 중...";
-              const { buildSite } = await import("./build/renderer");
-              await buildSite(store, config, root);
-              store.close();
-
-              processingStatus = "완료!";
-            } catch (e: any) {
-              processingStatus = `오류: ${e.message}`;
-            } finally {
-              setTimeout(() => { isProcessing = false; }, 2000);
-            }
-          })();
-
-          return Response.json({ ok: true, message: "파일 처리 시작" });
-        }
+    const { startServer } = await import("./server");
+    startServer(root, parseInt(opts.port), opts.host);
+  });
 
-        // URL add endpoint
-        if (url.pathname === "/api/add" && req.method === "POST") {
-          if (isProcessing) {
-            return Response.json({ error: "이미 처리 중입니다", status: processingStatus }, { status: 409 });
-          }
-
-          const body = await req.json() as { source: string };
-          if (!body.source) {
-            return Response.json({ error: "source가 필요합니다" }, { status: 400 });
-          }
-
-          isProcessing = true;
-          processingStatus = "시작 중...";
-
-          (async () => {
-            try {
-              const store = new Store(join(root, DB_FILE));
-              const { setLLMConfig, resetUsageStats, getUsageStats, getEstimatedCost } = await import("./llm-client");
-              setLLMConfig(loadConfig(root).llm);
-              resetUsageStats();
-
-              const source = body.source;
-              const { fetchPage } = await import("./ingest/web");
-              const { llmChunkDocument, htmlToRawText } = await import("./pipeline/llm-chunker");
-
-              processingStatus = "URL 가져오는 중...";
-              const { title, html } = await fetchPage(source);
-              const src = store.addSource(source, "web", title, html);
-              const rawText = htmlToRawText(html);
-
-              processingStatus = "LLM 분석 중...";
-              const currentPersona = getActivePersona(loadConfig(root));
-              await llmChunkDocument(rawText, title, src.id, store, 0, currentPersona);
-
-              const u = getUsageStats();
-              store.addUsageLog(src.id, u.totalCalls, u.promptTokens, u.completionTokens, u.totalTokens, getEstimatedCost());
-
-              processingStatus = "빌드 중...";
-              const { buildSite } = await import("./build/renderer");
-              await buildSite(store, config, root);
-              store.close();
-
-              processingStatus = "완료!";
-            } catch (e: any) {
-              processingStatus = `오류: ${e.message}`;
-            } finally {
-              setTimeout(() => { isProcessing = false; }, 2000);
-            }
-          })();
-
-          return Response.json({ ok: true, message: "처리 시작" });
-        }
+// --- quiz ---
+program
+  .command("quiz")
+  .description("학습 퀴즈를 풀어봅니다")
+  .option("-n, --count <count>", "문제 수", "5")
+  .action(async (opts) => {
+    const root = findProjectRoot();
+    const store = new Store(join(root, DB_FILE));
+    try {
+      store.initSchema(); // ensure quizzes table exists
+      const count = parseInt(opts.count) || 5;
+      const quizzes = store.getSmartQuizzes(count);
+      if (quizzes.length === 0) {
+        console.log("\x1b[33m퀴즈가 없습니다. 먼저 문서를 추가하세요.\x1b[0m");
+        return;
+      }
 
-        // Admin API - update LLM settings
-        if (url.pathname === "/api/settings" && req.method === "POST") {
-          const body = await req.json() as any;
-          const currentConfig = loadConfig(root);
-          if (body.wiki_name) currentConfig.project.name = body.wiki_name;
-          if (body.provider) currentConfig.llm.provider = body.provider;
-          if (body.model) currentConfig.llm.model = body.model;
-          if (body.api_key !== undefined) currentConfig.llm.api_key = body.api_key;
-          if (body.endpoint !== undefined) currentConfig.llm.endpoint = body.endpoint;
-          saveConfig(root, currentConfig);
-          // Reload config for serve
-          Object.assign(config, currentConfig);
-
-          // Auto-rebuild site with new settings
-          (async () => {
-            try {
-              const store = new Store(join(root, DB_FILE));
-              const { buildSite } = await import("./build/renderer");
-              await buildSite(store, currentConfig, root);
-              store.close();
-              console.log("\x1b[32m✅ 설정 변경 후 사이트 리빌드 완료\x1b[0m");
-            } catch (e: any) {
-              console.log(`\x1b[31m리빌드 실패: ${e.message}\x1b[0m`);
-            }
-          })();
-
-          return Response.json({ ok: true });
-        }
+      const p = await import("@clack/prompts");
+      p.intro("📝 학습 퀴즈");
+      console.log(`  ${quizzes.length}개 문제를 풀어봅니다.\n`);
+
+      let score = 0;
+      for (let i = 0; i < quizzes.length; i++) {
+        const q = quizzes[i];
+        const typeLabel = q.quiz_type === "fill_blank" ? "빈칸 채우기" : q.quiz_type === "ox" ? "OX 퀴즈" : "단답형";
 
-        if (url.pathname === "/api/settings" && req.method === "GET") {
-          const currentConfig = loadConfig(root);
-          // Mask API key
-          const masked = { ...currentConfig.llm, api_key: currentConfig.llm.api_key ? "••••" + currentConfig.llm.api_key.slice(-4) : "" };
-          return Response.json(masked);
+        console.log(`\x1b[1m[${i + 1}/${quizzes.length}] ${typeLabel}\x1b[0m`);
+        console.log(`  ${q.question}`);
+        if (q.page_title) {
+          console.log(`  \x1b[2m출처: ${q.page_title}\x1b[0m`);
         }
 
-        // Persona API
-        if (url.pathname === "/api/personas" && req.method === "GET") {
-          const currentConfig = loadConfig(root);
-          return Response.json({
-            personas: currentConfig.personas || [],
-            active: currentConfig.active_persona || "",
+        let userAnswer: string | symbol;
+        if (q.quiz_type === "ox") {
+          userAnswer = await p.select({
+            message: "정답은?",
+            options: [
+              { value: "O", label: "⭕ O" },
+              { value: "X", label: "❌ X" },
+            ],
+          });
+        } else {
+          userAnswer = await p.text({
+            message: "정답을 입력하세요",
+            placeholder: "...",
           });
         }
 
-        if (url.pathname === "/api/personas" && req.method === "POST") {
-          const body = await req.json() as any;
-          const currentConfig = loadConfig(root);
-          if (!currentConfig.personas) currentConfig.personas = [];
-
-          if (body.action === "add") {
-            const { name, description, system_prompt, content_style } = body.persona;
-            if (!name) return Response.json({ error: "이름이 필요합니다" }, { status: 400 });
-            if (currentConfig.personas.find(p => p.name === name)) {
-              return Response.json({ error: "이미 존재하는 페르소나입니다" }, { status: 409 });
-            }
-            currentConfig.personas.push({ name, description: description || "", system_prompt: system_prompt || "", content_style: content_style || "" });
-          } else if (body.action === "update") {
-            const idx = currentConfig.personas.findIndex(p => p.name === body.original_name);
-            if (idx === -1) return Response.json({ error: "페르소나를 찾을 수 없습니다" }, { status: 404 });
-            currentConfig.personas[idx] = body.persona;
-            if (currentConfig.active_persona === body.original_name && body.persona.name !== body.original_name) {
-              currentConfig.active_persona = body.persona.name;
-            }
-          } else if (body.action === "delete") {
-            currentConfig.personas = currentConfig.personas.filter(p => p.name !== body.name);
-            if (currentConfig.active_persona === body.name) {
-              currentConfig.active_persona = currentConfig.personas[0]?.name || "";
-            }
-          } else if (body.action === "activate") {
-            if (!currentConfig.personas.find(p => p.name === body.name)) {
-              return Response.json({ error: "페르소나를 찾을 수 없습니다" }, { status: 404 });
-            }
-            currentConfig.active_persona = body.name;
-          }
-
-          saveConfig(root, currentConfig);
-          Object.assign(config, currentConfig);
-          return Response.json({ ok: true, personas: currentConfig.personas, active: currentConfig.active_persona });
+        if (p.isCancel(userAnswer)) {
+          p.cancel("퀴즈를 종료합니다.");
+          return;
         }
 
-        // Build API
-        if (url.pathname === "/api/build" && req.method === "POST") {
-          if (isProcessing) {
-            return Response.json({ error: "이미 처리 중입니다" }, { status: 409 });
-          }
-          isProcessing = true;
-          processingStatus = "빌드 중...";
-          (async () => {
-            try {
-              const store = new Store(join(root, DB_FILE));
-              const { buildSite } = await import("./build/renderer");
-              await buildSite(store, loadConfig(root), root);
-              store.close();
-              processingStatus = "빌드 완료!";
-              console.log("\x1b[32m✅ 수동 빌드 완료\x1b[0m");
-            } catch (e: any) {
-              processingStatus = `빌드 오류: ${e.message}`;
-            } finally {
-              setTimeout(() => { isProcessing = false; }, 2000);
-            }
-          })();
-          return Response.json({ ok: true, message: "빌드 시작" });
-        }
+        const norm = (s: string) => s.trim().toLowerCase().replace(/\s+/g, ' ');
+        const isCorrect = norm(userAnswer as string) === norm(q.answer);
 
-        // Admin page
-        if (url.pathname === "/admin") {
-          const store = new Store(join(root, DB_FILE));
-          const sources = store.listSources();
-          const usage = store.getUsageSummary();
-          const configData = loadConfig(root);
-          store.close();
-
-          const { renderAdmin } = await import("./build/templates");
-          return new Response(renderAdmin({
-            wikiName: configData.project.name,
-            sources,
-            usage,
-            llmConfig: configData.llm,
-            personas: configData.personas || [],
-            activePersona: configData.active_persona || "",
-          }), { headers: { "Content-Type": "text/html" } });
-        }
+        store.addQuizAttempt(q.id, isCorrect);
 
-        if (url.pathname === "/api/status") {
-          const store = new Store(join(root, DB_FILE));
-          const sources = store.listSources();
-          const sourcePages = store.listSourcePages();
-          const conceptPages = store.listConceptPages();
-          const links = store.getAllLinks();
-          const usage = store.getUsageSummary();
-          store.close();
-
-          return Response.json({
-            processing: isProcessing,
-            processingStatus,
-            sources: sources.length,
-            sourcePages: sourcePages.length,
-            conceptPages: conceptPages.length,
-            links: links.length,
-            usage,
-          });
+        if (isCorrect) {
+          score++;
+          console.log(`  \x1b[32m✅ 정답!\x1b[0m`);
+        } else {
+          console.log(`  \x1b[31m❌ 오답! 정답: ${q.answer}\x1b[0m`);
         }
+        if (q.explanation) {
+          console.log(`  \x1b[36m💡 ${q.explanation}\x1b[0m`);
+        }
+        console.log();
+      }
 
-        // ── Static file serving ──
-        let pathname = url.pathname;
-        if (pathname === "/") pathname = "/index.html";
-
-        const filePath = join(siteDir, pathname);
-        const file = Bun.file(filePath);
-
-        if (await file.exists()) {
-          return new Response(file);
+      const pct = Math.round((score / quizzes.length) * 100);
+      console.log(`\x1b[1m📊 결과: ${score}/${quizzes.length} (${pct}%)\x1b[0m`);
+      if (pct >= 90) console.log("  🏆 완벽에 가깝습니다!");
+      else if (pct >= 70) console.log("  👏 잘 하셨습니다!");
+      else if (pct >= 50) console.log("  📚 조금 더 복습해보세요!");
+      else console.log("  💪 다시 도전해보세요!");
+
+      const stats = store.getQuizStats();
+      if (stats.total > 0) {
+        const overallPct = Math.round(stats.correct / stats.total * 100);
+        console.log(`\n📊 전체 통계: ${stats.correct}/${stats.total} 정답 (${overallPct}%)`);
+        if (stats.unattempted > 0) {
+          console.log(`  📋 미시도 퀴즈: ${stats.unattempted}개`);
         }
-        return new Response("Not Found", { status: 404 });
-      },
-    });
+      }
+
+      p.outro("학습을 계속하세요! 🥝");
+    } finally {
+      store.close();
+    }
   });
 
 // --- status ---
@@ -634,35 +409,36 @@ program
     const root = findProjectRoot();
     const config = loadConfig(root);
     const store = new Store(join(root, DB_FILE));
-
-    const sources = store.listSources();
-    const sourcePages = store.listSourcePages();
-    const conceptPages = store.listConceptPages();
-    const links = store.getAllLinks();
-
-    console.log(`\n\x1b[1m🥝 ${config.project.name}\x1b[0m\n`);
-    console.log(`  소스     ${sources.length}`);
-    console.log(`  📖 원본  ${sourcePages.length}`);
-    console.log(`  📝 개념  ${conceptPages.length}`);
-    console.log(`  🔗 링크  ${links.length}`);
-    console.log(`  빌드     ${config.build.output_dir}`);
-    console.log(`  배포     ${config.deploy.target}`);
-
-    if (sourcePages.length) {
-      console.log("\n\x1b[1m📖 원본 문서:\x1b[0m");
-      for (const p of sourcePages) {
-        console.log(`  • ${p.title} \x1b[2m(${p.slug})\x1b[0m`);
+    try {
+      const sources = store.listSources();
+      const sourcePages = store.listSourcePages();
+      const conceptPages = store.listConceptPages();
+      const links = store.getAllLinks();
+
+      console.log(`\n\x1b[1m🥝 ${config.project.name}\x1b[0m\n`);
+      console.log(`  소스     ${sources.length}`);
+      console.log(`  📖 원본  ${sourcePages.length}`);
+      console.log(`  📝 개념  ${conceptPages.length}`);
+      console.log(`  🔗 링크  ${links.length}`);
+      console.log(`  빌드     ${config.build.output_dir}`);
+      console.log(`  배포     ${config.deploy.target}`);
+
+      if (sourcePages.length) {
+        console.log("\n\x1b[1m📖 원본 문서:\x1b[0m");
+        for (const p of sourcePages) {
+          console.log(`  • ${p.title} \x1b[2m(${p.slug})\x1b[0m`);
+        }
       }
-    }
-    if (conceptPages.length) {
-      console.log("\n\x1b[1m📝 개념 문서:\x1b[0m");
-      for (const p of conceptPages) {
-        console.log(`  • ${p.title} \x1b[2m(${p.slug})\x1b[0m`);
+      if (conceptPages.length) {
+        console.log("\n\x1b[1m📝 개념 문서:\x1b[0m");
+        for (const p of conceptPages) {
+          console.log(`  • ${p.title} \x1b[2m(${p.slug})\x1b[0m`);
+        }
       }
+      console.log();
+    } finally {
+      store.close();
     }
-
-    console.log();
-    store.close();
   });
 
 program.parse();