@hawon/nexus 0.2.0 → 0.3.0

package/src/skills/skill-reconciler.ts

@@ -1,699 +0,0 @@
-/**
- * Skill Reconciler — Evolving Knowledge Through Contradiction
- *
- * The smartest part of the system. When a new skill conflicts with
- * an existing one, it doesn't just overwrite — it asks:
- *
- * "왜 그때는 이랬는데 이번에는 이랬지?"
- *
- * Then it:
- * 1. Finds the DIFFERENCE in context that caused the change
- * 2. Creates CONDITIONAL branches: "When [X], use A; when [Y], use B"
- * 3. Keeps COMMON parts merged
- *
- * Three core mechanisms:
- *
- * A. STRICT QUALITY GATE
- *    - Won't create a skill if context is unclear
- *    - Requires minimum understanding confidence
- *    - Rejects noise, ambiguity, and too-specific patterns
- *
- * B. PREFERENCE LEARNING
- *    - "이 상황에서는 A보다 B가 효율적"
- *    - Tracks which approaches were chosen over alternatives
- *    - Builds preference rankings per situation type
- *
- * C. SKILL RECONCILIATION
- *    - Detects when new wisdom contradicts existing
- *    - Finds the contextual difference that explains the change
- *    - Splits into conditional branches or merges common ground
- */
-
-import type { Wisdom, WisdomBody } from "./wisdom-extractor.js";
-import { semanticSimilarity } from "../memory-engine/semantic.js";
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-import { createHash } from "node:crypto";
-
-// ═══════════════════════════════════════════════════════════════════
-// TYPES
-// ═══════════════════════════════════════════════════════════════════
-
-/** A refined skill with conditional branches. */
-export type RefinedSkill = {
-  id: string;
-  /** Core topic this skill covers. */
-  topic: string;
-  /** What all branches share in common. */
-  commonGround: string;
-  /** Conditional branches: different approaches for different contexts. */
-  branches: SkillBranch[];
-  /** Learned preferences: "A > B when [condition]". */
-  preferences: Preference[];
-  /** How many times this skill was validated. */
-  validations: number;
-  /** Overall confidence. */
-  confidence: number;
-  /** Domain tags. */
-  domains: string[];
-  /** Version: increments on each reconciliation. */
-  version: number;
-  createdAt: string;
-  updatedAt: string;
-};
-
-export type SkillBranch = {
-  /** When does this branch apply? */
-  condition: string;
-  /** What to do. */
-  approach: string;
-  /** Why this approach for this condition. */
-  rationale: string;
-  /** Source wisdom IDs that support this branch. */
-  sources: string[];
-  /** Success count for this branch. */
-  successCount: number;
-  /** Failure count. */
-  failureCount: number;
-};
-
-export type Preference = {
-  /** The situation. */
-  situation: string;
-  /** Preferred approach. */
-  preferred: string;
-  /** Less preferred approach. */
-  overWhat: string;
-  /** Why preferred. */
-  reason: string;
-  /** How many times this preference was confirmed. */
-  confirmations: number;
-};
-
-export type ReconciliationResult = {
-  /** New skills created. */
-  created: RefinedSkill[];
-  /** Existing skills updated (new branch added). */
-  updated: RefinedSkill[];
-  /** Wisdoms rejected by quality gate. */
-  rejected: { wisdom: Wisdom; reason: string }[];
-  /** Preferences learned. */
-  preferencesLearned: Preference[];
-};
-
-export type SkillLibrary = {
-  skills: RefinedSkill[];
-  version: number;
-  updatedAt: string;
-};
-
-// ═══════════════════════════════════════════════════════════════════
-// STRICT QUALITY GATE
-// ═══════════════════════════════════════════════════════════════════
-
-type QualityCheck = { pass: boolean; reason: string };
-
-function qualityGate(wisdom: Wisdom): QualityCheck {
-  const { body } = wisdom;
-
-  // 1. Situation must be meaningful
-  // If situation is empty but approach is technical and substantial, derive situation from approach
-  if (!body.situation || body.situation.length < 5) {
-    // Try to salvage: if approach is very technical and >40 chars, use first line of approach as situation
-    const approachFirstLine = (body.approach ?? "").split("\n")[0]?.trim() ?? "";
-    const hasTechContent = /overflow|bypass|injection|exploit|vulnerability|encrypt|decrypt|hash|shellcode|rop|heap|stack|deserialization|sandbox|hook|patch|fuzzing|scanner|audit|authentication|authorization|deploy|refactor|migrate|optimize|pipeline|middleware|proxy|gateway|socket|protocol|container/i.test(approachFirstLine);
-    if (hasTechContent && approachFirstLine.length > 30) {
-      body.situation = approachFirstLine.slice(0, 80);
-      // Prevent circular: if salvaged situation is same as approach, reject
-      if (body.situation === body.approach.split("\n")[0]?.trim()) {
-        return { pass: false, reason: "circular wisdom — situation derived from approach itself" };
-      }
-    } else {
-      return { pass: false, reason: "situation too vague — can't determine when this applies" };
-    }
-  }
-
-  // 2. Approach must be substantive
-  if (!body.approach || body.approach.length < 10) {
-    return { pass: false, reason: "approach too short — not enough information to be useful" };
-  }
-
-  // 3. Reason must exist
-  if (!body.reason || body.reason.length < 5) {
-    return { pass: false, reason: "no clear reason — can't learn without understanding why" };
-  }
-
-  // 4. Must not be system noise
-  const noisePatterns = [
-    /task-notification/i, /system-reminder/i, /<[a-z]/i,
-    /\[result-id/i, /tool loaded/i, /Using Node/i,
-    /npm warn/i, /npm notice/i, /npm error/i,
-  ];
-  const allText = `${body.situation} ${body.approach} ${body.reason}`;
-  if (noisePatterns.some((p) => p.test(allText))) {
-    return { pass: false, reason: "contains system noise — not a real interaction" };
-  }
-
-  // 5. Confidence must be above threshold
-  if (wisdom.confidence < 0.5) {
-    return { pass: false, reason: `confidence too low (${(wisdom.confidence * 100).toFixed(0)}% < 50%)` };
-  }
-
-  // 6. Must have at least one domain
-  if (wisdom.domains.length === 0) {
-    return { pass: false, reason: "no domain identified — too generic to be useful" };
-  }
-
-  // 7. Situation and approach must be different (not circular)
-  const situationWords = new Set(tokenize(body.situation));
-  const approachWords = new Set(tokenize(body.approach));
-  const overlap = [...situationWords].filter((w) => approachWords.has(w)).length;
-  const overlapRatio = overlap / Math.max(situationWords.size, 1);
-  if (overlapRatio > 0.8) {
-    return { pass: false, reason: "situation and approach are too similar — circular wisdom" };
-  }
-
-  // 8. Situation must not be a raw user message (question, command, etc.)
-  const rawMessagePatterns = [
-    /^[ㄱ-ㅎㅏ-ㅣ가-힣]{1,5}$/, // Very short Korean (ㅇㅇ, 응, 해줘)
-    /^[\w\s]{1,10}\?$/, // Short question
-    /^host\d.*games|^nc\s+host|^\d+\.\d+\.\d+\.\d+/i, // Specific addresses/IPs (not the technique)
-    /^'.*\.py'|^'.*\.sage'/i, // Specific file invocations
-    /^'.*'$/, // Quoted file paths
-  ];
-  if (rawMessagePatterns.some((p) => p.test(body.situation))) {
-    return { pass: false, reason: "situation is a raw command/challenge, not a generalizable pattern" };
-  }
-
-  // 9. Approach must be a principle, not a specific action
-  const tooSpecificPatterns = [
-    /^(Read|Edit|Bash|Write|Grep|Agent|WebSearch)\b/, // Raw tool name
-    /^\/home\/|^\/mnt\/|^C:\\/, // File paths
-    /^\d{1,5}\.\d{1,5}\.\d{1,5}/, // IP addresses
-  ];
-  if (tooSpecificPatterns.some((p) => p.test(body.approach))) {
-    return { pass: false, reason: "approach is a specific action, not a reusable principle" };
-  }
-
-  // 10. Reject casual chat / emotional expressions / not technical
-  const casualPatterns = [
-    /미친|개쩐|대박|ㅋㅋ|ㅎㅎ|ㅠㅠ|씨발|부모님|돈이잖/i,
-    /야\s|아\s.*맞다|음\s|스티븐|스테인버그/i,
-    /lol|wtf|omg|damn|shit/i,
-  ];
-  if (casualPatterns.some((p) => p.test(body.situation))) {
-    return { pass: false, reason: "casual chat, not a technical skill" };
-  }
-
-  // 10b. Reject vague/short commands that aren't descriptive
-  // BUT allow short technical phrases like "CVE 연구", "보안 감사"
-  const techShort = /보안|security|취약|exploit|코드|서버|테스트|빌드|배포|디버그|리팩토|설정|분석|스캔|감사|review|deploy|test|build|debug|refactor|analyze|audit|scan|vulnerability/i;
-  const vaguePatterns = [
-    /^이게\s*뭔/i, /^뭐야/i, /^뭔데/i,
-    /^해줘/i, /^해봐/i, /^봐봐/i, /^봐줘/i,
-    /^하나로/i, /^전부/i,
-    /^ㅇㅇ|^ㄱㄱ|^ㅇㅋ|^응$/i,
-    /^PS\s*C/i, /^C[-:]Users/i,
-    /^npm\s*cache/i,
-  ];
-  // Only reject if both: matches vague pattern AND no technical content
-  const isVague = vaguePatterns.some((p) => p.test(body.situation.trim()));
-  const hasTechInSituation = techShort.test(body.situation);
-  if (isVague && !hasTechInSituation) {
-    return { pass: false, reason: "too vague or too specific command, not a generalizable situation" };
-  }
-
-  // 11. Situation should have at least one technical/actionable keyword
-  const technicalKeywords = /코드|파일|프로젝트|서버|배포|테스트|보안|설정|빌드|에러|api|git|docker|deploy|build|test|security|config|server|database|code|function|module|component|review|refactor|debug|optimize|install|fix|create|implement|analyze|scan|vulnerability|exploit|injection|authenticate|authorize|overflow|bypass|reverse|binary|payload|shellcode|rop|heap|stack|format\s*string|race\s*condition|privilege|escalat|forensic|malware|encrypt|decrypt|hash|xss|csrf|ssrf|sqli|deserialization|sandbox|hook|intercept|patch|fuzzing|brute|crack|token|session|cookie|header|request|response|scraping|crawl|parsing|regex|algorithm|data\s*structure|complexity|cache|memory|thread|async|concurrency|pipeline|middleware|proxy|gateway|socket|websocket|protocol|packet|network|dns|ssl|tls|certificate|container|kubernetes|ci\/cd|workflow|migration|schema|query|index|replication/i;
-  if (!technicalKeywords.test(body.situation) && !technicalKeywords.test(body.approach)) {
-    return { pass: false, reason: "no technical content — not actionable as a skill" };
-  }
-
-  // 12. Approach must be longer than 20 chars and contain a principle (not just "공통점 없음")
-  if (body.approach.length < 20 || body.approach === "공통점 없음") {
-    return { pass: false, reason: "approach is not substantial enough to be a skill" };
-  }
-
-  // 13. Situation must be at least 15 chars (shorter OK if highly technical)
-  const isTechnical = technicalKeywords.test(body.situation);
-  if (body.situation.length < 15 && !isTechnical) {
-    return { pass: false, reason: "situation description too short to be useful" };
-  }
-
-  // 14. Situation must NOT be a response/confirmation (Claude or user quoting)
-  const responsePatterns = [
-    /^네\s+판단|^맞습니다|^정확|^그렇습니다|^좋습니다/i, // Agreement
-    /^PS\s+[A-Z]:|^C:\\|^\/home\//i, // Terminal prompts/paths
-    /^LDPlayer|^BlueStacks|^Nox/i, // Emulator names
-    /설치.*완료|설치.*했는데|재실행/i, // Status reports not situations
-    /^근데\s+html|^근데\s+css/i, // Casual follow-ups
-  ];
-  if (responsePatterns.some((p) => p.test(body.situation.trim()))) {
-    return { pass: false, reason: "situation is a response/status, not a generalizable scenario" };
-  }
-
-  return { pass: true, reason: "passed all quality checks" };
-}
-
-// ═══════════════════════════════════════════════════════════════════
-// SIMILARITY MATCHING
-// ═══════════════════════════════════════════════════════════════════
-
-function computeTopicSimilarity(a: string, b: string): number {
-  // Use full semantic similarity (synonyms + co-occurrence + Jaccard)
-  return semanticSimilarity(a, b);
-}
-
-function findSimilarSkill(
-  wisdom: Wisdom,
-  library: SkillLibrary,
-  threshold = 0.4,  // Raised from 0.25 to prevent over-merging
-): RefinedSkill | null {
-  let bestMatch: RefinedSkill | null = null;
-  let bestSimilarity = 0;
-
-  for (const skill of library.skills) {
-    // Compare topic similarity
-    const topicSim = computeTopicSimilarity(wisdom.body.situation, skill.topic);
-
-    // Compare domain overlap
-    const domainOverlap = wisdom.domains.filter((d) =>
-      skill.domains.includes(d),
-    ).length / Math.max(wisdom.domains.length, 1);
-
-    // Combined score
-    const similarity = topicSim * 0.6 + domainOverlap * 0.4;
-
-    if (similarity > bestSimilarity && similarity >= threshold) {
-      bestSimilarity = similarity;
-      bestMatch = skill;
-    }
-  }
-
-  return bestMatch;
-}
-
-// ═══════════════════════════════════════════════════════════════════
-// DIFFERENCE ANALYSIS
-// ═══════════════════════════════════════════════════════════════════
-
-type DifferenceAnalysis = {
-  /** What's different in the context. */
-  contextDifference: string;
-  /** What's different in the approach. */
-  approachDifference: string;
-  /** What's the same. */
-  commonGround: string;
-  /** Is this a genuine contradiction or just a different context? */
-  type: "contradiction" | "context_dependent" | "evolution" | "complementary";
-};
-
-function analyzeDifference(
-  existingSkill: RefinedSkill,
-  newWisdom: Wisdom,
-): DifferenceAnalysis {
-  const existingApproaches = existingSkill.branches.map((b) => b.approach).join(" ");
-  const newApproach = newWisdom.body.approach;
-
-  // Find common words
-  const existingWords = new Set(tokenize(existingApproaches));
-  const newWords = new Set(tokenize(newApproach));
-  const common = [...existingWords].filter((w) => newWords.has(w));
-  const onlyExisting = [...existingWords].filter((w) => !newWords.has(w));
-  const onlyNew = [...newWords].filter((w) => !existingWords.has(w));
-
-  const commonGround = common.length > 0
-    ? `공통: ${common.slice(0, 5).join(", ")}`
-    : "공통점 없음";
-
-  const approachDifference = onlyNew.length > 0
-    ? `새로운 접근: ${onlyNew.slice(0, 5).join(", ")}`
-    : "접근법 동일";
-
-  // Determine the context difference
-  const existingConditions = existingSkill.branches.map((b) => b.condition).join(" ");
-  const newContext = newWisdom.body.situation;
-  const contextWords = tokenize(newContext).filter(
-    (w) => !new Set(tokenize(existingConditions)).has(w),
-  );
-  const contextDifference = contextWords.length > 0
-    ? contextWords.slice(0, 5).join(", ")
-    : "맥락 차이 불명확";
-
-  // Classify the type of difference
-  let type: DifferenceAnalysis["type"] = "context_dependent";
-
-  // If approaches are very different but context is similar → contradiction
-  const approachOverlap = common.length / Math.max(existingWords.size, newWords.size, 1);
-  if (approachOverlap < 0.2) {
-    const contextOverlap = computeTopicSimilarity(existingConditions, newContext);
-    if (contextOverlap > 0.5) {
-      type = "contradiction";
-    } else {
-      type = "context_dependent";
-    }
-  }
-
-  // If new approach is a superset of existing → evolution
-  if (onlyNew.length > 0 && onlyExisting.length === 0) {
-    type = "evolution";
-  }
-
-  // If approaches are different but non-overlapping domains → complementary
-  if (approachOverlap < 0.3) {
-    const domainOverlap = newWisdom.domains.filter((d) =>
-      existingSkill.domains.includes(d),
-    ).length;
-    if (domainOverlap === 0) type = "complementary";
-  }
-
-  return { contextDifference, approachDifference, commonGround, type };
-}
-
-// ═══════════════════════════════════════════════════════════════════
-// RECONCILIATION
-// ═══════════════════════════════════════════════════════════════════
-
-function reconcileWithExisting(
-  existingSkill: RefinedSkill,
-  newWisdom: Wisdom,
-): { skill: RefinedSkill; preference?: Preference } {
-  const diff = analyzeDifference(existingSkill, newWisdom);
-  const updated = { ...existingSkill };
-  let preference: Preference | undefined;
-
-  switch (diff.type) {
-    case "context_dependent": {
-      // Add a new conditional branch
-      updated.branches.push({
-        condition: newWisdom.body.situation,
-        approach: newWisdom.body.approach,
-        rationale: `${newWisdom.body.reason} (맥락 차이: ${diff.contextDifference})`,
-        sources: [newWisdom.id],
-        successCount: newWisdom.type === "principle" ? 1 : 0,
-        failureCount: newWisdom.type === "warning" ? 1 : 0,
-      });
-      updated.commonGround = diff.commonGround;
-      break;
-    }
-
-    case "contradiction": {
-      // The new approach contradicts the old one for similar contexts
-      // → Create a preference: new > old (because it's more recent = learned from mistake)
-      const existingBranch = updated.branches[updated.branches.length - 1];
-      preference = {
-        situation: newWisdom.body.situation,
-        preferred: newWisdom.body.approach,
-        overWhat: existingBranch?.approach ?? "이전 접근법",
-        reason: `더 최신 경험에서 학습: ${newWisdom.body.reason}`,
-        confirmations: 1,
-      };
-
-      // Update existing branch or add new one
-      if (existingBranch) {
-        existingBranch.failureCount++;
-      }
-      updated.branches.push({
-        condition: `${newWisdom.body.situation} (개선된 접근)`,
-        approach: newWisdom.body.approach,
-        rationale: `이전 접근법(${existingBranch?.approach.slice(0, 30) ?? "?"})이 비효율적이어서 변경: ${newWisdom.body.reason}`,
-        sources: [newWisdom.id],
-        successCount: 1,
-        failureCount: 0,
-      });
-      updated.preferences.push(preference);
-      break;
-    }
-
-    case "evolution": {
-      // New approach is an improvement — update the latest branch
-      const lastBranch = updated.branches[updated.branches.length - 1];
-      if (lastBranch) {
-        lastBranch.approach = `${lastBranch.approach}\n→ 개선: ${newWisdom.body.approach}`;
-        lastBranch.rationale += ` → 진화: ${newWisdom.body.reason}`;
-        lastBranch.sources.push(newWisdom.id);
-        lastBranch.successCount++;
-      }
-      break;
-    }
-
-    case "complementary": {
-      // Different domain, just add as a new branch
-      updated.branches.push({
-        condition: newWisdom.body.situation,
-        approach: newWisdom.body.approach,
-        rationale: newWisdom.body.reason,
-        sources: [newWisdom.id],
-        successCount: 1,
-        failureCount: 0,
-      });
-      // Merge domains
-      for (const d of newWisdom.domains) {
-        if (!updated.domains.includes(d)) updated.domains.push(d);
-      }
-      break;
-    }
-  }
-
-  updated.version++;
-  updated.updatedAt = new Date().toISOString();
-  updated.validations++;
-
-  // Recalculate confidence
-  const totalSuccess = updated.branches.reduce((s, b) => s + b.successCount, 0);
-  const totalFailure = updated.branches.reduce((s, b) => s + b.failureCount, 0);
-  const total = totalSuccess + totalFailure;
-  updated.confidence = total > 0
-    ? Math.min(0.95, 0.3 + (totalSuccess / total) * 0.5 + updated.validations * 0.05)
-    : updated.confidence;
-
-  return { skill: updated, preference };
-}
-
-function abstractTopicName(wisdom: Wisdom): string {
-  // Generate a proper skill name from wisdom, not raw user message
-  const domains = wisdom.domains.slice(0, 2).join("/");
-  const type = wisdom.type === "principle" ? "원칙" : wisdom.type === "warning" ? "주의사항" : "판단기준";
-
-  // Extract the core action/concept from the situation
-  const situation = wisdom.body.situation
-    .replace(/\[파일 경로\]/g, "")
-    .replace(/\[코드\]/g, "")
-    .replace(/\[URL\]/g, "")
-    .trim();
-
-  // Take first meaningful phrase (up to 40 chars)
-  const firstPhrase = situation.split(/[.!?\n]/)[0]?.trim() ?? situation;
-  const short = firstPhrase.length > 40 ? firstPhrase.slice(0, 37) + "..." : firstPhrase;
-
-  return `[${domains}] ${short} — ${type}`;
-}
-
-function createNewSkill(wisdom: Wisdom): RefinedSkill {
-  return {
-    id: createHash("sha256").update(wisdom.id + wisdom.body.situation).digest("hex").slice(0, 12),
-    topic: abstractTopicName(wisdom),
-    commonGround: wisdom.body.approach,
-    branches: [{
-      condition: wisdom.body.situation,
-      approach: wisdom.body.approach,
-      rationale: wisdom.body.reason,
-      sources: [wisdom.id],
-      successCount: wisdom.type === "principle" ? 1 : 0,
-      failureCount: wisdom.type === "warning" ? 1 : 0,
-    }],
-    preferences: [],
-    validations: 1,
-    confidence: wisdom.confidence,
-    domains: [...wisdom.domains],
-    version: 1,
-    createdAt: new Date().toISOString(),
-    updatedAt: new Date().toISOString(),
-  };
-}
-
-// ═══════════════════════════════════════════════════════════════════
-// MAIN PIPELINE
-// ═══════════════════════════════════════════════════════════════════
-
-export function reconcileWisdom(
-  wisdoms: Wisdom[],
-  library: SkillLibrary,
-): ReconciliationResult {
-  const result: ReconciliationResult = {
-    created: [],
-    updated: [],
-    rejected: [],
-    preferencesLearned: [],
-  };
-
-  for (const wisdom of wisdoms) {
-    // Step 1: Quality gate
-    const quality = qualityGate(wisdom);
-    if (!quality.pass) {
-      result.rejected.push({ wisdom, reason: quality.reason });
-      continue;
-    }
-
-    // Step 2: Find similar existing skill
-    const existing = findSimilarSkill(wisdom, library);
-
-    if (existing) {
-      // Step 3a: Reconcile with existing
-      const { skill: updated, preference } = reconcileWithExisting(existing, wisdom);
-
-      // Replace in library
-      const idx = library.skills.indexOf(existing);
-      if (idx >= 0) library.skills[idx] = updated;
-      result.updated.push(updated);
-
-      if (preference) {
-        result.preferencesLearned.push(preference);
-      }
-    } else {
-      // Step 3b: Create new skill
-      const newSkill = createNewSkill(wisdom);
-      library.skills.push(newSkill);
-      result.created.push(newSkill);
-    }
-  }
-
-  library.version++;
-  library.updatedAt = new Date().toISOString();
-
-  return result;
-}
-
-// ═══════════════════════════════════════════════════════════════════
-// PERSISTENCE
-// ═══════════════════════════════════════════════════════════════════
-
-export function loadRefinedLibrary(dataDir: string): SkillLibrary {
-  const filePath = join(dataDir, "refined-skills.json");
-  if (existsSync(filePath)) {
-    return JSON.parse(readFileSync(filePath, "utf-8")) as SkillLibrary;
-  }
-  return { skills: [], version: 1, updatedAt: new Date().toISOString() };
-}
-
-export function saveRefinedLibrary(library: SkillLibrary, dataDir: string): void {
-  mkdirSync(dataDir, { recursive: true });
-  writeFileSync(
-    join(dataDir, "refined-skills.json"),
-    JSON.stringify(library, null, 2),
-    "utf-8",
-  );
-}
-
-// ═══════════════════════════════════════════════════════════════════
-// OBSIDIAN RENDERER
-// ═══════════════════════════════════════════════════════════════════
-
-export function renderRefinedSkillMarkdown(skill: RefinedSkill): string {
-  const lines: string[] = [];
-
-  lines.push("---");
-  lines.push(`type: refined-skill`);
-  lines.push(`topic: "${skill.topic.slice(0, 60)}"`);
-  lines.push(`confidence: ${skill.confidence.toFixed(2)}`);
-  lines.push(`version: ${skill.version}`);
-  lines.push(`branches: ${skill.branches.length}`);
-  lines.push(`validations: ${skill.validations}`);
-  lines.push(`domains: [${skill.domains.map((d) => `"${d}"`).join(", ")}]`);
-  lines.push(`tags: [claude/refined-skill]`);
-  lines.push("---");
-  lines.push("");
-  lines.push(`# ${skill.topic.slice(0, 60)}`);
-  lines.push("");
-  lines.push(`> 확신도: ${(skill.confidence * 100).toFixed(0)}% | 버전: ${skill.version} | 검증: ${skill.validations}회`);
-  lines.push("");
-
-  // Common ground
-  if (skill.commonGround) {
-    lines.push("## 공통 원칙");
-    lines.push("");
-    lines.push(skill.commonGround);
-    lines.push("");
-  }
-
-  // Conditional branches
-  if (skill.branches.length > 1) {
-    lines.push("## 상황별 접근법");
-    lines.push("");
-    lines.push("같은 주제라도 상황에 따라 접근법이 다릅니다:");
-    lines.push("");
-
-    for (let i = 0; i < skill.branches.length; i++) {
-      const branch = skill.branches[i];
-      const successRate = branch.successCount + branch.failureCount > 0
-        ? (branch.successCount / (branch.successCount + branch.failureCount) * 100).toFixed(0)
-        : "N/A";
-
-      lines.push(`### ${i + 1}. ${branch.condition.slice(0, 60)}`);
-      lines.push("");
-      lines.push(`**접근법**: ${branch.approach}`);
-      lines.push("");
-      lines.push(`**이유**: ${branch.rationale}`);
-      lines.push("");
-      lines.push(`> 성공률: ${successRate}%`);
-      lines.push("");
-    }
-  } else if (skill.branches.length === 1) {
-    const branch = skill.branches[0];
-    lines.push("## 접근법");
-    lines.push("");
-    lines.push(branch.approach);
-    lines.push("");
-    lines.push("## 이유");
-    lines.push("");
-    lines.push(branch.rationale);
-    lines.push("");
-  }
-
-  // Preferences
-  if (skill.preferences.length > 0) {
-    lines.push("## 학습된 선호도");
-    lines.push("");
-    for (const pref of skill.preferences) {
-      lines.push(`- **${pref.situation.slice(0, 50)}**에서:`);
-      lines.push(`  - ✅ **${pref.preferred.slice(0, 50)}** 선호`);
-      lines.push(`  - ❌ ~~${pref.overWhat.slice(0, 50)}~~ 비선호`);
-      lines.push(`  - 이유: ${pref.reason.slice(0, 80)}`);
-      lines.push(`  - 확인: ${pref.confirmations}회`);
-      lines.push("");
-    }
-  }
-
-  return lines.join("\n");
-}
-
-export function exportRefinedSkills(library: SkillLibrary, vaultPath: string): string[] {
-  const dir = join(vaultPath, "Refined Skills");
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-
-  const files: string[] = [];
-  for (const skill of library.skills) {
-    const safeName = skill.topic
-      .replace(/[<>:"/\\|?*#^[\]]/g, "-")
-      .replace(/-+/g, "-")
-      .slice(0, 60);
-    const filePath = join(dir, `${safeName}.md`);
-    writeFileSync(filePath, renderRefinedSkillMarkdown(skill), "utf-8");
-    files.push(filePath);
-  }
-  return files;
-}
-
-// ═══════════════════════════════════════════════════════════════════
-// HELPERS
-// ═══════════════════════════════════════════════════════════════════
-
-function tokenize(text: string): string[] {
-  return text
-    .toLowerCase()
-    .replace(/[^a-z가-힣0-9\s]/g, " ")
-    .split(/\s+/)
-    .filter((w) => w.length > 2);
-}