@open330/kiwimu 0.4.0 → 0.7.1

package/src/config.ts

@@ -1,6 +1,6 @@
 import { parse, stringify } from "smol-toml";
-import { existsSync } from "fs";
-import { join } from "path";
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join, dirname } from "path";
 
 export const CONFIG_FILE = "kiwi.toml";
 export const DB_FILE = "kiwi.db";
@@ -29,38 +29,43 @@ export interface KiwiConfig {
   active_persona?: string; // name of the active persona
 }
 
-export const NAMUWIKI_PERSONA: Persona = {
-  name: "나무위키",
-  description: "나무위키 특유의 문체와 스타일로 문서를 작성합니다",
-  system_prompt: `당신은 나무위키 스타일의 위키 편집자입니다. 다음 특징을 반드시 지켜주세요:
+/** Directory containing built-in persona JSON files (shipped with the package) */
+function getPersonasDir(): string {
+  // Works both in dev (src/) and built (dist/) — personas/ is at project root
+  return join(dirname(__dirname), "personas");
+}
 
-1. **문체**: 해요체(~입니다/~합니다)를 기본으로 하되, 가끔 반말(~이다/~한다)을 섞어 사용
-2. **유머**: 적절한 곳에 ~~취소선 드립~~, (괄호 안의 부연설명), [1] 각주 스타일의 코멘트를 삽입
-3. **강조**: 중요한 키워드는 **굵게** 처리하고, 핵심 개념은 반복 강조
-4. **서술 톤**: 백과사전적이면서도 친근한 톤. "~라고 한다", "~라고 카더라" 등의 표현 활용
-5. **구조**: 목차가 잘 정리된 체계적 구조. 소제목을 적극 활용
-6. **부가 정보**: "여담으로~", "참고로~", "사실~" 등의 표현으로 부가 정보 추가
-7. **링크**: 관련 개념에 적극적으로 [[위키 링크]]를 사용
+/** Load a single persona from a JSON file */
+function loadPersonaFile(filePath: string): Persona {
+  return JSON.parse(readFileSync(filePath, "utf-8")) as Persona;
+}
 
-절대 딱딱한 교과서 문체로 쓰지 마세요. 읽는 사람이 재미있게 학습할 수 있도록 작성해주세요.`,
-  content_style: `Write in Korean 나무위키 style:
-- Use 해요체 with occasional 반말 mix
-- Add ~~strikethrough humor~~ and (parenthetical asides)
-- Bold **key terms** generously
-- Use phrases like "~라고 한다", "여담으로~", "참고로~"
-- Be encyclopedic yet friendly and entertaining
-- Structure with clear subsections
-- Use [[wiki links]] actively for related concepts`,
-};
+/** Load all built-in personas from the personas/ directory */
+export function loadBuiltinPersonas(): Persona[] {
+  const dir = getPersonasDir();
+  if (!existsSync(dir)) return [];
+  return readdirSync(dir)
+    .filter(f => f.endsWith(".json"))
+    .map(f => loadPersonaFile(join(dir, f)));
+}
+
+/** Get the default persona (first built-in, or fallback) */
+export function getDefaultPersona(): Persona {
+  const builtins = loadBuiltinPersonas();
+  if (builtins.length > 0) return builtins[0];
+  // Minimal fallback if no persona files exist
+  return { name: "default", description: "Default wiki style", system_prompt: "", content_style: "" };
+}
 
 export function defaultConfig(name: string): KiwiConfig {
+  const builtins = loadBuiltinPersonas();
   return {
     project: { name, created: new Date().toISOString().slice(0, 10) },
     build: { output_dir: SITE_DIR },
     llm: { provider: "gemini", model: "gemini-2.0-flash-lite", api_key: "", endpoint: "" },
     deploy: { target: "gh-pages" },
-    personas: [NAMUWIKI_PERSONA],
-    active_persona: "나무위키",
+    personas: builtins.length > 0 ? builtins : [getDefaultPersona()],
+    active_persona: builtins[0]?.name || "default",
   };
 }
 
@@ -75,18 +80,19 @@ export function saveConfig(root: string, config: KiwiConfig): void {
 
 export function loadConfig(root: string): KiwiConfig {
   const content = require("fs").readFileSync(join(root, CONFIG_FILE), "utf-8");
-  const raw = parse(content) as any;
+  const raw = parse(content) as Partial<KiwiConfig> & Record<string, unknown>;
   // Migrate old config format
   if (!raw.llm) {
     raw.llm = { provider: "gemini", model: "gemini-2.0-flash-lite", api_key: "", endpoint: "" };
   }
   // Migrate: add default persona if missing
   if (!raw.personas || !raw.personas.length) {
-    raw.personas = [NAMUWIKI_PERSONA];
-    raw.active_persona = "나무위키";
+    const builtins = loadBuiltinPersonas();
+    raw.personas = builtins.length > 0 ? builtins : [getDefaultPersona()];
+    raw.active_persona = raw.personas[0]?.name || "default";
   }
   if (!raw.active_persona) {
-    raw.active_persona = raw.personas[0]?.name || "나무위키";
+    raw.active_persona = raw.personas[0]?.name || "default";
   }
   return raw as KiwiConfig;
 }

package/src/demo/sample-data.ts

@@ -0,0 +1,70 @@
+export const DEMO_SOURCES = [
+  {
+    uri: "demo://quantum-mechanics",
+    type: "demo",
+    title: "양자역학 입문",
+    raw_content: "양자역학의 기초 개념을 소개합니다..."
+  }
+];
+
+export const DEMO_PAGES = [
+  {
+    slug: "양자역학-입문",
+    title: "양자역학 입문",
+    content: `# 양자역학 입문\n\n양자역학은 원자와 아원자 입자의 행동을 설명하는 물리학의 분야입니다.\n\n## 핵심 개념\n\n### 파동-입자 이중성\n입자는 파동과 입자의 성질을 동시에 가집니다. ~~이것만 이해하면 양자역학 마스터~~\n\n### 불확정성 원리\n[[하이젠베르크]]가 제안한 원리로, 위치와 운동량을 동시에 정확히 측정할 수 없습니다. (아인슈타인도 처음엔 못 믿었다고 합니다)\n\n### 슈뢰딩거 방정식\n$$i\\hbar\\frac{\\partial}{\\partial t}|\\psi(t)\\rangle = \\hat{H}|\\psi(t)\\rangle$$\n\n양자계의 시간 변화를 기술하는 기본 방정식입니다.\n\n## 관련 개념\n- [[슈뢰딩거-방정식]]\n- [[하이젠베르크]]\n- [[양자-중첩]]\n- [[양자-얽힘]]`,
+    page_type: "source",
+    source_id: 1
+  },
+  {
+    slug: "슈뢰딩거-방정식",
+    title: "슈뢰딩거 방정식",
+    content: `# 슈뢰딩거 방정식\n\n**슈뢰딩거 방정식**은 양자역학에서 양자계의 [[파동함수]]를 기술하는 편미분 방정식입니다.\n\n## 시간 의존 방정식\n$$i\\hbar\\frac{\\partial}{\\partial t}\\Psi(\\mathbf{r},t) = \\hat{H}\\Psi(\\mathbf{r},t)$$\n\n## 시간 독립 방정식\n$$\\hat{H}|\\psi\\rangle = E|\\psi\\rangle$$\n\n여기서 $E$는 에너지 고유값입니다. ~~사실 이 방정식만 풀면 세상 모든 화학 문제가 풀린다는 건 비밀~~\n\n## 역사\n1926년 에르빈 슈뢰딩거가 발표했습니다. [[하이젠베르크]]의 행렬역학과 동등하다는 것이 나중에 증명되었습니다.`,
+    page_type: "concept",
+    source_id: 1
+  },
+  {
+    slug: "하이젠베르크",
+    title: "하이젠베르크의 불확정성 원리",
+    content: `# 하이젠베르크의 불확정성 원리\n\n**불확정성 원리**는 1927년 베르너 하이젠베르크가 발표한 [[양자역학-입문|양자역학]]의 핵심 원리입니다.\n\n## 수학적 표현\n$$\\Delta x \\cdot \\Delta p \\geq \\frac{\\hbar}{2}$$\n\n위치($x$)의 불확정성과 운동량($p$)의 불확정성의 곱은 항상 $\\frac{\\hbar}{2}$ 이상입니다.\n\n## 의미\n(이건 측정 기술의 한계가 아니라 자연의 근본적인 성질입니다!)\n\n이 원리는 고전물리학의 결정론적 세계관에 근본적인 도전을 제기했습니다.`,
+    page_type: "concept",
+    source_id: 1
+  },
+  {
+    slug: "양자-중첩",
+    title: "양자 중첩",
+    content: `# 양자 중첩\n\n**양자 중첩**(superposition)은 양자계가 여러 상태의 선형 결합으로 존재할 수 있는 [[양자역학-입문|양자역학]]의 원리입니다.\n\n## 슈뢰딩거의 고양이\n가장 유명한 사고 실험으로, 고양이가 살아있는 상태와 죽어있는 상태의 중첩에 놓인다는 역설입니다. ~~고양이한테는 미안하지만~~\n\n$$|\\psi\\rangle = \\alpha|살아있음\\rangle + \\beta|죽어있음\\rangle$$\n\n## 측정 문제\n관측하면 중첩이 붕괴하여 하나의 상태만 남습니다. [[하이젠베르크|불확정성 원리]]와도 깊이 연결됩니다.`,
+    page_type: "concept",
+    source_id: 1
+  },
+  {
+    slug: "양자-얽힘",
+    title: "양자 얽힘",
+    content: `# 양자 얽힘\n\n**양자 얽힘**(entanglement)은 두 입자가 서로의 상태에 즉각적으로 영향을 주는 [[양자역학-입문|양자역학]] 현상입니다.\n\n## EPR 역설\n아인슈타인, 포돌스키, 로젠이 1935년에 제기한 사고 실험입니다. 아인슈타인은 이를 "으스스한 원격 작용"이라 불렀습니다.\n\n## 벨 부등식\n1964년 존 벨이 증명한 부등식으로, 실험으로 양자역학의 예측이 맞다는 것이 확인되었습니다. (2022년 노벨 물리학상!)\n\n## 응용\n- 양자 컴퓨팅\n- 양자 암호\n- 양자 텔레포테이션`,
+    page_type: "concept",
+    source_id: 1
+  }
+];
+
+export const DEMO_QUIZZES = [
+  { page_slug: "하이젠베르크", question: "___은 위치와 운동량을 동시에 정확히 측정할 수 없다는 양자역학의 원리이다.", answer: "불확정성 원리", quiz_type: "fill_blank" },
+  { page_slug: "슈뢰딩거-방정식", question: "슈뢰딩거 방정식은 1926년에 발표되었다.", answer: "O", quiz_type: "ox" },
+  { page_slug: "양자-중첩", question: "양자 중첩에서 관측하면 어떤 현상이 일어나는가?", answer: "중첩이 붕괴하여 하나의 상태만 남는다", quiz_type: "short_answer" },
+  { page_slug: "양자-얽힘", question: "아인슈타인은 양자 얽힘을 '___한 원격 작용'이라 불렀다.", answer: "으스스", quiz_type: "fill_blank" },
+  { page_slug: "양자-중첩", question: "슈뢰딩거의 고양이 사고실험에서 고양이는 살아있는 상태와 죽어있는 상태의 ___에 놓인다.", answer: "중첩", quiz_type: "fill_blank" },
+  { page_slug: "양자-얽힘", question: "2022년 노벨 물리학상은 양자 얽힘의 벨 부등식 실험 검증과 관련이 있다.", answer: "O", quiz_type: "ox" },
+  { page_slug: "슈뢰딩거-방정식", question: "시간 독립 슈뢰딩거 방정식에서 E는 무엇을 나타내는가?", answer: "에너지 고유값", quiz_type: "short_answer" },
+  { page_slug: "하이젠베르크", question: "불확정성 원리에서 Δx·Δp ≥ ℏ/2 이다.", answer: "O", quiz_type: "ox" },
+];
+
+export const DEMO_LINKS = [
+  // source_slug -> target_slug
+  { from: "양자역학-입문", to: "슈뢰딩거-방정식" },
+  { from: "양자역학-입문", to: "하이젠베르크" },
+  { from: "양자역학-입문", to: "양자-중첩" },
+  { from: "양자역학-입문", to: "양자-얽힘" },
+  { from: "슈뢰딩거-방정식", to: "하이젠베르크" },
+  { from: "하이젠베르크", to: "양자역학-입문" },
+  { from: "양자-중첩", to: "양자역학-입문" },
+  { from: "양자-중첩", to: "하이젠베르크" },
+  { from: "양자-얽힘", to: "양자역학-입문" },
+];

package/src/demo/setup.ts

@@ -0,0 +1,31 @@
+import { DEMO_SOURCES, DEMO_PAGES, DEMO_LINKS, DEMO_QUIZZES } from "./sample-data";
+import type { Store } from "../store";
+
+export async function setupDemo(store: Store): Promise<void> {
+  // 1. Insert demo source
+  for (const source of DEMO_SOURCES) {
+    store.addSource(source.uri, source.type, source.title, source.raw_content);
+  }
+
+  // 2. Insert demo pages
+  for (const page of DEMO_PAGES) {
+    store.addPage(page.slug, page.title, page.content, page.source_id, undefined, page.page_type);
+  }
+
+  // 3. Insert demo links
+  for (const link of DEMO_LINKS) {
+    const fromPage = store.getPage(link.from);
+    const toPage = store.getPage(link.to);
+    if (fromPage && toPage) {
+      store.addLink(fromPage.id, toPage.id, toPage.title);
+    }
+  }
+
+  // 4. Insert demo quizzes
+  for (const quiz of DEMO_QUIZZES) {
+    const page = store.getPage(quiz.page_slug);
+    if (page) {
+      store.addQuiz(page.id, quiz.question, quiz.answer, quiz.quiz_type);
+    }
+  }
+}

package/src/expand/llm.ts

@@ -35,7 +35,7 @@ export async function expandWithApi(page: Page, context: Page[], provider: strin
       max_tokens: 4096,
       messages: [{ role: "user", content: prompt }],
     });
-    return (resp.content[0] as any).text;
+    return (resp.content[0] as { type: string; text: string }).text;
   }
 
   if (provider === "openai") {