project-librarian 0.2.1 → 0.3.0

package/dist/modes.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildRefreshIndexBlock = buildRefreshIndexBlock;
 exports.runQueryMode = runQueryMode;
+exports.runWikiImpactMode = runWikiImpactMode;
 exports.projectCandidatesContent = projectCandidatesContent;
 exports.appendCaptureInbox = appendCaptureInbox;
 exports.runIssueDraftMode = runIssueDraftMode;
@@ -49,6 +50,7 @@ exports.runQualityCheckMode = runQualityCheckMode;
 exports.runMigrationQualityCheckMode = runMigrationQualityCheckMode;
 exports.runMigrationLintMode = runMigrationLintMode;
 exports.runMigrationDoctorMode = runMigrationDoctorMode;
+exports.collectRouterTruthDiagnostics = collectRouterTruthDiagnostics;
 exports.runDoctorMode = runDoctorMode;
 exports.runLintMode = runLintMode;
 const fs = __importStar(require("node:fs"));
@@ -60,6 +62,7 @@ const workspace_1 = require("./workspace");
 const templates_1 = require("./templates");
 const migration_1 = require("./migration");
 const wiki_files_1 = require("./wiki-files");
+const wiki_graph_1 = require("./wiki-graph");
 const scopedAutoIndexThreshold = 40;
 const scopedAutoIndexMarker = "<!-- PROJECT-WIKI-SCOPED-AUTO-INDEX -->";
 function isScopedAutoIndex(file) {
@@ -167,26 +170,46 @@ This block is managed by \`--refresh-index\`. Move useful rows into a hand-writt
 | --- | --- | --- | --- |
 ${rows}<!-- PROJECT-WIKI-AUTO-INDEX:END -->`;
 }
+// Answer-shaped query output (2026-06-12 method-transfer decision): first line is
+// the answer, each result carries the page's TL;DR first bullet so the agent can
+// pick a page without opening it, and the whole body sits under the shared hard
+// cap with an explicit truncation notice.
 function runQueryMode() {
     if (!args_1.queryTerm.trim()) {
         console.error("missing query: use --query \"search terms\"");
         process.exit(1);
     }
     const terms = args_1.queryTerm.toLowerCase().split(/\s+/).filter(Boolean);
-    const results = (0, wiki_files_1.wikiMarkdownFiles)().map((file) => {
+    const matches = (0, wiki_files_1.wikiMarkdownFiles)().map((file) => {
         const text = (0, workspace_1.read)(file);
         const body = (0, workspace_1.stripMetadataHeader)(text);
         const title = (0, wiki_files_1.wikiTitleForFile)(file, text);
         const meta = (0, wiki_files_1.metadataSummary)(file, text);
         const weighted = `${file}\n${title}\n${meta.scope}\n${(0, workspace_1.metadataValue)(text, "tags")}\n${body}`.toLowerCase();
         const score = terms.reduce((sum, term) => sum + (weighted.split(term).length - 1) + (file.toLowerCase().includes(term) ? 3 : 0) + (title.toLowerCase().includes(term) ? 5 : 0), 0);
-        return { file, title, score, ...meta };
-    }).filter((item) => item.score > 0).sort((a, b) => b.score - a.score || a.file.localeCompare(b.file)).slice(0, 10);
-    console.log(`Project wiki query: ${args_1.queryTerm}`);
-    if (results.length === 0)
-        console.log("no matches");
-    for (const item of results)
-        console.log(`${item.score.toString().padStart(3)}  ${item.file}  ${item.scope}  ${item.status}  ${item.title}`);
+        return { file, title, score, tldr: (0, wiki_files_1.firstTldrBullet)(text), ...meta };
+    }).filter((item) => item.score > 0).sort((a, b) => b.score - a.score || a.file.localeCompare(b.file));
+    const results = matches.slice(0, 10);
+    const best = results[0];
+    const lines = [best
+            ? `Project wiki query "${args_1.queryTerm}": best match ${best.file} — ${best.title} (${matches.length} matching page${matches.length === 1 ? "" : "s"}, top ${results.length} shown).`
+            : `Project wiki query "${args_1.queryTerm}": no matches.`];
+    for (const item of results) {
+        lines.push(`${item.score.toString().padStart(3)}  ${item.file}  [${item.scope}|${item.status}|${item.budget}]  ${item.title}`);
+        if (item.tldr)
+            lines.push(`     tldr: ${item.tldr}`);
+    }
+    console.log((0, wiki_graph_1.finalizeWikiAnswer)(lines.join("\n")));
+}
+// Wiki impact mode: backlink/decision_ref/routing evidence for a page so wiki
+// maintenance can find review candidates when project truth changes.
+function runWikiImpactMode() {
+    if (!args_1.wikiImpactTarget.trim()) {
+        console.error("missing wiki impact target: use --wiki-impact \"page-or-term\"");
+        process.exit(1);
+    }
+    const pages = (0, wiki_files_1.wikiMarkdownFiles)().map((file) => ({ file, text: (0, workspace_1.read)(file) }));
+    console.log((0, wiki_graph_1.wikiImpactAnswer)(pages, args_1.wikiImpactTarget.trim()));
 }
 function projectCandidatesContent() {
     return `${(0, templates_1.metadata)("inbox", "on-demand", "wiki/meta/wiki-ops-v1-decisions.md", "candidates are adopted, rejected, or stale")}
@@ -456,15 +479,12 @@ function printDiagnostics(title, diagnostics, checked) {
     console.log(`passed: ${checked} wiki markdown files checked, ${warnings} warnings`);
     return true;
 }
-function collectWikiLinkReferences(files) {
-    return files.flatMap((file) => (0, wiki_files_1.extractWikiLinks)(file, (0, workspace_1.read)(file)));
-}
 function collectLinkDiagnostics() {
     const diagnostics = [];
     const files = (0, wiki_files_1.wikiMarkdownFiles)();
     const fileSet = new Set(files);
-    const links = collectWikiLinkReferences(files);
-    for (const link of links) {
+    const graph = (0, wiki_graph_1.buildWikiGraph)(files.map((file) => ({ file, text: (0, workspace_1.read)(file) })));
+    for (const link of graph.links) {
         if (!fileSet.has(link.normalizedTarget)) {
             diagnostics.push({
                 code: "broken-link",
@@ -474,25 +494,29 @@ function collectLinkDiagnostics() {
             });
         }
     }
-    if ((0, workspace_1.exists)("wiki/index.md")) {
-        const indexLinks = (0, wiki_files_1.extractWikiLinks)("wiki/index.md", (0, workspace_1.read)("wiki/index.md"));
-        const indexTargets = new Map();
-        for (const link of indexLinks)
-            indexTargets.set(link.normalizedTarget, (indexTargets.get(link.normalizedTarget) ?? 0) + 1);
-        for (const [target, count] of indexTargets) {
-            if (count > 1) {
-                diagnostics.push({
-                    code: "duplicate-route",
-                    severity: "warn",
-                    file: "wiki/index.md",
-                    message: `${count} index routes resolve to ${target}`,
-                });
-            }
+    const indexTargets = new Map();
+    for (const link of graph.outgoingLinks.get("wiki/index.md") ?? []) {
+        indexTargets.set(link.normalizedTarget, (indexTargets.get(link.normalizedTarget) ?? 0) + 1);
+    }
+    for (const [target, count] of indexTargets) {
+        if (count > 1) {
+            diagnostics.push({
+                code: "duplicate-route",
+                severity: "warn",
+                file: "wiki/index.md",
+                message: `${count} index routes resolve to ${target}`,
+            });
         }
     }
+    // Self-links are not connectivity: a page whose only incoming link is its own
+    // self-loop has no route into it and must stay an orphan-page finding, keeping
+    // the orphan and router-unreachable rules disjoint.
     const incoming = new Map();
-    for (const link of links)
+    for (const link of graph.links) {
+        if (link.file === link.normalizedTarget)
+            continue;
         incoming.set(link.normalizedTarget, (incoming.get(link.normalizedTarget) ?? 0) + 1);
+    }
     const orphanExemptions = new Set(["wiki/index.md", "wiki/startup.md", "wiki/README.md"]);
     for (const file of files) {
         if (orphanExemptions.has(file))
@@ -506,6 +530,50 @@ function collectLinkDiagnostics() {
             });
         }
     }
+    // Bounded router reachability, promoted from the benchmark fixture A1 hard
+    // assert (benchmarks/lib/llm-fixtures.js assertBoundedAnswerReachability) to the
+    // real wiki: fixture wikis were guaranteed navigable from startup while real
+    // wikis were never checked for the same property. Pages with zero incoming
+    // links are already the orphan-page rule's finding, so reachability reports
+    // only the cases orphan cannot see: linked-but-disconnected islands, an index
+    // the startup router never links (hop 1), and routes deeper than the budget.
+    // When wiki/startup.md itself is missing, lint owns that as a required-file
+    // error and reachability has no root to check from.
+    if (fileSet.has(wiki_graph_1.wikiRouterRoot)) {
+        const depths = (0, wiki_graph_1.wikiRouterDepths)(graph);
+        for (const file of files) {
+            if (wiki_graph_1.wikiRouterExemptPages.has(file))
+                continue;
+            const depth = depths.get(file);
+            const isIndex = file === "wiki/index.md";
+            if (depth === undefined) {
+                if (isIndex) {
+                    diagnostics.push({
+                        code: "router-unreachable",
+                        severity: "warn",
+                        file,
+                        message: `${wiki_graph_1.wikiRouterRoot} does not link [[index]], so the router chain never starts (hop 1 broken)`,
+                    });
+                }
+                else if ((incoming.get(file) ?? 0) > 0) {
+                    diagnostics.push({
+                        code: "router-unreachable",
+                        severity: "warn",
+                        file,
+                        message: `linked only from pages that never connect to ${wiki_graph_1.wikiRouterRoot}; route it from wiki/index.md or a scoped router`,
+                    });
+                }
+            }
+            else if (depth > wiki_graph_1.wikiRouterDepthBudget) {
+                diagnostics.push({
+                    code: "router-depth-exceeded",
+                    severity: "warn",
+                    file,
+                    message: `reachable from ${wiki_graph_1.wikiRouterRoot} only at depth ${depth} (budget ${wiki_graph_1.wikiRouterDepthBudget}); add a shorter route`,
+                });
+            }
+        }
+    }
     return diagnostics.sort((a, b) => a.severity.localeCompare(b.severity) || a.file.localeCompare(b.file) || a.code.localeCompare(b.code));
 }
 function legacyWikiRoots() {
@@ -585,15 +653,19 @@ function collectMigrationQualityDiagnostics() {
 function collectMigrationLintDiagnostics() {
     if (legacyWikiRoots().length === 0)
         return [];
-    const requiredFiles = [
+    const requiredCoreFiles = [
+        "wiki/meta/document-taxonomy.md",
         "wiki/migration/inventory.md",
+        "wiki/migration/unit-map.md",
+        "wiki/migration/split-plan.md",
         "wiki/migration/coverage.md",
         "wiki/migration/plan.md",
+        "wiki/migration/review.md",
         "wiki/migration/verification.md",
-        "wiki/canonical/migration-inbox.md",
-        "wiki/decisions/migration-inbox.md",
-        "wiki/sources/migration-inbox.md",
+        "wiki/migration/bulk-review.md",
     ];
+    const requiredInboxFiles = (0, migration_1.migrationSemanticReviewComplete)() ? [] : [...migration_1.generatedMigrationInboxFiles];
+    const requiredFiles = [...requiredCoreFiles, ...requiredInboxFiles];
     const diagnostics = requiredFiles
         .filter((file) => !(0, workspace_1.exists)(file))
         .map((file) => ({
@@ -603,6 +675,8 @@ function collectMigrationLintDiagnostics() {
         message: "migration review files are missing; run --migrate or keep migration diagnostics out of normal doctor",
     }));
     diagnostics.push(...(0, migration_1.collectMigrationCoverageDiagnostics)());
+    diagnostics.push(...(0, migration_1.collectMigrationUnitMapDiagnostics)());
+    diagnostics.push(...(0, migration_1.collectMigrationSplitPlanDiagnostics)());
     return diagnostics.sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code) || a.message.localeCompare(b.message));
 }
 function runLinkCheckMode() {
@@ -631,6 +705,73 @@ function runMigrationDoctorMode() {
     if (!lintOk || !qualityOk)
         process.exit(1);
 }
+// B2 router-truth contradiction rule. A compact router that contradicts the
+// decision log is worse than none: the measured 2026-06-10 run spiraled into
+// post-answer verification because wiki/startup.md Recent Decisions and
+// wiki/decisions/recent.md said "None yet." while wiki/decisions/log.md held the
+// dated answer. This flags that exact contradiction as an error-level diagnostic.
+// "None yet." is the bootstrap template marker for an empty decision surface
+// (startup template "## Recent Project Decisions" and recent.md template
+// "## Decisions" both seed "- None yet."), so its presence while the log carries a
+// dated entry is the template-equivalent of an unmaintained router.
+//
+// SECTION-ANCHORED SCAN: the rule checks the relevant section body only, not the
+// whole file, to avoid false-positives on other sections (e.g. an open-questions
+// list that legitimately says "None yet." while Recent Decisions is maintained).
+//   wiki/startup.md   → "## Recent Project Decisions" section body
+//   decisions/recent.md → "## Decisions" section body
+//
+// MINOR 2: the marker regex is tolerant of trailing whitespace / omitted terminal
+// period ("None yet", "None yet. ") but stays anchored to the section scope above.
+// Coupling: this English-only marker matches the bootstrap template text only;
+// a project using a different language for these sections will not be checked.
+const ROUTER_TRUTH_NONE_YET_REGEX = /\bNone yet\.?\s*$/m;
+// Extract the body of a named heading section (from the heading line to the next
+// same-or-higher-level heading, or end of string). Returns empty string when the
+// heading is absent so the caller can decide whether to flag or skip.
+function extractSectionBody(markdown, headingText) {
+    // Match `## <headingText>` (level-2 only, matching the template structure).
+    const headingRe = new RegExp(`^##\\s+${headingText.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*$`, "m");
+    const match = headingRe.exec(markdown);
+    if (!match)
+        return "";
+    const afterHeading = markdown.slice(match.index + match[0].length);
+    // Stop at the next ## heading (same or higher level), or end of string.
+    const nextHeading = /^##\s/m.exec(afterHeading);
+    return nextHeading ? afterHeading.slice(0, nextHeading.index) : afterHeading;
+}
+function collectRouterTruthDiagnostics() {
+    const logPath = "wiki/decisions/log.md";
+    if (!(0, workspace_1.exists)(logPath))
+        return [];
+    const logHasDatedEntry = /\b\d{4}-\d{2}-\d{2}\b/.test((0, workspace_1.stripMetadataHeader)((0, workspace_1.read)(logPath)));
+    if (!logHasDatedEntry)
+        return [];
+    const diagnostics = [];
+    // Each tuple: [file, headingText, surfaceLabel]
+    // headingText must match the bootstrap template section heading exactly so the
+    // section-anchored scan never accidentally reads unrelated sections.
+    const routers = [
+        ["wiki/startup.md", "Recent Project Decisions", "Recent Decisions"],
+        ["wiki/decisions/recent.md", "Decisions", "Decisions"],
+    ];
+    for (const [file, heading, surface] of routers) {
+        if (!(0, workspace_1.exists)(file))
+            continue;
+        const section = extractSectionBody((0, workspace_1.stripMetadataHeader)((0, workspace_1.read)(file)), heading);
+        if (section === "")
+            continue; // section absent — skip rather than false-positive
+        if (ROUTER_TRUTH_NONE_YET_REGEX.test(section)) {
+            diagnostics.push({
+                code: "router-truth-contradiction",
+                severity: "error",
+                file,
+                message: `${file} ${surface} still says "None yet." while ${logPath} holds a dated decision entry; update ${file} to reflect the recorded decision`,
+            });
+        }
+    }
+    return diagnostics.sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code));
+}
 function runDoctorMode(fix) {
     if (fix) {
         console.log("Project wiki doctor --fix");
@@ -645,40 +786,45 @@ function runDoctorMode(fix) {
     const files = (0, wiki_files_1.wikiMarkdownFiles)();
     const linkOk = printDiagnostics("Project wiki link-check", collectLinkDiagnostics(), files.length);
     const qualityOk = printDiagnostics("Project wiki quality-check", collectQualityDiagnostics(), files.length);
+    const routerTruthOk = printDiagnostics("Project wiki router-truth check", collectRouterTruthDiagnostics(), files.length);
     runLintMode();
-    if (!linkOk || !qualityOk)
+    if (!linkOk || !qualityOk || !routerTruthOk)
         process.exit(1);
 }
+const commonLintRequiredFiles = [
+    "AGENTS.md",
+    "wiki/AGENTS.md",
+    "wiki/startup.md",
+    "wiki/index.md",
+    "wiki/decisions/log.md",
+    "wiki/decisions/recent.md",
+    "wiki/meta/operating-model.md",
+    "wiki/meta/decision-policy.md",
+    "wiki/meta/wiki-ops-v1-decisions.md",
+    ".githooks/prepare-commit-msg",
+    ".githooks/wiki-commit-trailers.js",
+];
+const agentLintRequiredFiles = {
+    codex: [".codex/hooks/wiki-session-start.js", ".codex/hooks.json"],
+    claude: ["CLAUDE.md", ".claude/hooks/wiki-session-start.js", ".claude/settings.json"],
+    cursor: [".cursor/rules/project-librarian.mdc", ".cursor/hooks/wiki-session-start.js", ".cursor/hooks.json"],
+    gemini: ["GEMINI.md", ".gemini/hooks/wiki-session-start.js", ".gemini/settings.json"],
+};
+function activeLintAgentSurfaces() {
+    const active = new Set();
+    for (const [agent, files] of Object.entries(agentLintRequiredFiles)) {
+        if (files.some((file) => (0, workspace_1.exists)(file)))
+            active.add(agent);
+    }
+    return active;
+}
 function runLintMode() {
     const errors = [];
     const warnings = [];
+    const activeAgents = activeLintAgentSurfaces();
     const requiredFiles = [
-        "AGENTS.md",
-        "CLAUDE.md",
-        "GEMINI.md",
-        "wiki/AGENTS.md",
-        "wiki/startup.md",
-        "wiki/index.md",
-        "wiki/canonical/project-brief.md",
-        "wiki/canonical/open-questions.md",
-        "wiki/canonical/assumptions.md",
-        "wiki/canonical/risks.md",
-        "wiki/decisions/log.md",
-        "wiki/decisions/recent.md",
-        "wiki/meta/operating-model.md",
-        "wiki/meta/decision-policy.md",
-        "wiki/meta/wiki-ops-v1-decisions.md",
-        ".githooks/prepare-commit-msg",
-        ".githooks/wiki-commit-trailers.js",
-        ".codex/hooks/wiki-session-start.js",
-        ".codex/hooks.json",
-        ".claude/hooks/wiki-session-start.js",
-        ".claude/settings.json",
-        ".cursor/rules/project-librarian.mdc",
-        ".cursor/hooks/wiki-session-start.js",
-        ".cursor/hooks.json",
-        ".gemini/hooks/wiki-session-start.js",
-        ".gemini/settings.json",
+        ...commonLintRequiredFiles,
+        ...Array.from(activeAgents).flatMap((agent) => agentLintRequiredFiles[agent]),
     ];
     for (const file of requiredFiles) {
         if (!(0, workspace_1.exists)(file))

package/dist/taxonomy.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyMigrationUnit = classifyMigrationUnit;
+exports.storageToMigrationKind = storageToMigrationKind;
+const taxonomyAreas = [
+    {
+        id: "research-sources",
+        label: "Research / Source Evidence",
+        storage: "sources",
+        targetSlug: "research-sources",
+        keywords: ["source", "sources", "reference", "references", "citation", "bibliography", "research", "paper", "article", "link", "출처", "참고", "자료", "근거", "링크", "리서치", "논문"],
+    },
+    {
+        id: "decision-record",
+        label: "Decision Record",
+        storage: "decisions",
+        targetSlug: "decision-records",
+        keywords: ["adr", "decision", "decisions", "rationale", "tradeoff", "trade-off", "alternative", "rejected", "accepted", "decided", "결정", "의사결정", "기각", "대안", "트레이드오프", "선택", "채택"],
+    },
+    {
+        id: "strategy",
+        label: "Strategy / Business Context",
+        storage: "canonical",
+        targetSlug: "strategy-context",
+        keywords: ["vision", "mission", "strategy", "business model", "market", "positioning", "competitive", "gtm", "pricing", "roadmap", "비전", "미션", "전략", "시장", "포지셔닝", "경쟁", "사업", "가격", "로드맵"],
+    },
+    {
+        id: "product-requirements",
+        label: "Product Requirements",
+        storage: "canonical",
+        targetSlug: "product-requirements",
+        keywords: ["prd", "requirement", "requirements", "feature", "features", "function", "functional", "scope", "goal", "goals", "acceptance", "use case", "기능", "기능명세", "요구사항", "요건", "범위", "목표", "수용기준", "유스케이스", "서비스기획", "기획"],
+    },
+    {
+        id: "user-flow",
+        label: "User Flow / Journey",
+        storage: "canonical",
+        targetSlug: "user-flows",
+        keywords: ["user flow", "flow", "journey", "scenario", "persona", "story", "navigation", "screen flow", "유저플로우", "사용자 흐름", "사용자 여정", "시나리오", "페르소나", "스토리", "화면흐름", "동선"],
+    },
+    {
+        id: "ux-content",
+        label: "UX / Content",
+        storage: "canonical",
+        targetSlug: "ux-content",
+        keywords: ["ux", "interaction", "wireframe", "copy", "content", "microcopy", "empty state", "error state", "accessibility", "i18n", "사용성", "인터랙션", "와이어프레임", "카피", "콘텐츠", "빈상태", "오류상태", "접근성", "문구"],
+    },
+    {
+        id: "design-system",
+        label: "Design System / UI",
+        storage: "canonical",
+        targetSlug: "design-system",
+        keywords: ["design", "ui", "component", "prototype", "figma", "style guide", "brand", "visual", "layout", "디자인", "컴포넌트", "프로토타입", "스타일가이드", "브랜드", "시각", "레이아웃"],
+    },
+    {
+        id: "data-analytics",
+        label: "Data / Analytics",
+        storage: "canonical",
+        targetSlug: "data-analytics",
+        keywords: ["data", "schema", "database", "db", "erd", "entity", "event", "metric", "analytics", "kpi", "tracking", "데이터", "스키마", "디비", "엔티티", "이벤트", "지표", "분석", "트래킹"],
+    },
+    {
+        id: "api-contract",
+        label: "API Contract",
+        storage: "canonical",
+        targetSlug: "api-contracts",
+        keywords: ["api", "endpoint", "request", "response", "rest", "graphql", "webhook", "sdk", "openapi", "swagger", "인증", "토큰", "요청", "응답", "엔드포인트", "웹훅", "api명세", "api 명세"],
+    },
+    {
+        id: "engineering-architecture",
+        label: "Engineering / Architecture",
+        storage: "canonical",
+        targetSlug: "engineering-architecture",
+        keywords: ["architecture", "system", "service", "module", "implementation", "tech stack", "dependency", "infra", "deployment", "queue", "cache", "아키텍처", "시스템", "서비스", "모듈", "구현", "기술스택", "인프라", "배포", "큐", "캐시"],
+    },
+    {
+        id: "security-legal",
+        label: "Security / Legal",
+        storage: "canonical",
+        targetSlug: "security-legal",
+        keywords: ["security", "privacy", "permission", "role", "auth", "authorization", "compliance", "legal", "terms", "consent", "보안", "개인정보", "권한", "역할", "인가", "인증", "준수", "법무", "약관", "동의"],
+    },
+    {
+        id: "policy",
+        label: "Policy / Governance",
+        storage: "canonical",
+        targetSlug: "policy-governance",
+        keywords: ["policy", "rule", "moderation", "governance", "sla", "retention", "eligibility", "refund", "정책", "규칙", "운영정책", "거버넌스", "보관", "자격", "환불"],
+    },
+    {
+        id: "qa",
+        label: "QA / Test",
+        storage: "canonical",
+        targetSlug: "qa-test-plan",
+        keywords: ["qa", "test", "testing", "validation", "verification", "bug", "edge case", "regression", "acceptance test", "테스트", "검증", "품질", "버그", "엣지케이스", "회귀", "테스트케이스"],
+    },
+    {
+        id: "release-ops",
+        label: "Release / Operations",
+        storage: "canonical",
+        targetSlug: "release-operations",
+        keywords: ["release", "launch", "operation", "runbook", "monitoring", "alert", "incident", "support", "cs", "migration", "rollout", "릴리즈", "출시", "운영", "런북", "모니터링", "알림", "장애", "고객지원", "마이그레이션"],
+    },
+    {
+        id: "business-ops",
+        label: "Business Operations",
+        storage: "canonical",
+        targetSlug: "business-operations",
+        keywords: ["sales", "marketing", "crm", "customer success", "finance", "billing", "invoice", "contract", "영업", "마케팅", "고객성공", "재무", "청구", "계약", "정산"],
+    },
+    {
+        id: "wiki-meta",
+        label: "Wiki Operations / Meta",
+        storage: "meta",
+        targetSlug: "wiki-operations",
+        keywords: ["wiki", "documentation", "document taxonomy", "canonical", "source of truth", "lint", "doctor", "위키", "문서화", "문서체계", "정본", "정보구조", "린트", "닥터"],
+    },
+];
+function slugPart(value, maxLength = 36) {
+    return value.toLowerCase().replace(/[^a-z0-9가-힣ぁ-んァ-ン一-龥]+/g, "-").replace(/^-|-$/g, "").slice(0, maxLength) || "migration";
+}
+function legacyStem(legacyPath) {
+    return slugPart(legacyPath.replace(/\.(md|mdx)$/i, "").split(/[\\/]+/).pop() ?? legacyPath);
+}
+function fallbackStorageFromLegacyPath(legacyPath) {
+    if (/^meta\//.test(legacyPath))
+        return "meta";
+    if (/^decisions\//.test(legacyPath))
+        return "decisions";
+    if (/^sources\//.test(legacyPath))
+        return "sources";
+    return "canonical";
+}
+function keywordScore(haystack, keyword) {
+    const normalized = keyword.toLowerCase();
+    const escaped = normalized.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    if (/^[a-z0-9 -]+$/.test(normalized)) {
+        const matches = haystack.match(new RegExp(`\\b${escaped}\\b`, "g"));
+        return matches ? matches.length : 0;
+    }
+    return haystack.includes(normalized) ? 1 : 0;
+}
+function areaScore(area, haystack) {
+    return area.keywords.reduce((sum, keyword) => sum + keywordScore(haystack, keyword), 0);
+}
+function targetPath(storage, base, targetSlug) {
+    return `wiki/${storage}/${slugPart(base, 32)}-${targetSlug}.md`;
+}
+function classifyMigrationUnit(input) {
+    const haystack = [
+        legacyStem(input.legacyPath),
+        input.heading,
+        input.headingPath.join(" "),
+        input.summary,
+        input.content,
+    ].join("\n").toLowerCase();
+    const scored = taxonomyAreas
+        .map((area) => ({ area, score: areaScore(area, haystack) }))
+        .filter((item) => item.score > 0)
+        .sort((left, right) => right.score - left.score || left.area.id.localeCompare(right.area.id));
+    const fallbackStorage = fallbackStorageFromLegacyPath(input.legacyPath);
+    const best = scored[0]?.area ?? {
+        id: "unclassified",
+        label: "Needs Human Review",
+        storage: fallbackStorage,
+        targetSlug: "migration-review",
+        keywords: [],
+    };
+    const bestScore = scored[0]?.score ?? 0;
+    const secondScore = scored[1]?.score ?? 0;
+    const confidence = bestScore >= 3 && bestScore > secondScore ? "high" : bestScore >= 1 && bestScore >= secondScore ? "medium" : "low";
+    const base = legacyStem(input.legacyPath);
+    const reason = confidence === "low"
+        ? "no strong taxonomy signal; human review required"
+        : `matched ${best.label}${secondScore > 0 && bestScore === secondScore ? " with overlapping signals" : ""}`;
+    return {
+        area: best.id,
+        label: best.label,
+        storage: best.storage,
+        target: targetPath(best.storage, base, best.targetSlug),
+        confidence,
+        reason,
+    };
+}
+function storageToMigrationKind(storage) {
+    if (storage === "decisions")
+        return "decision";
+    if (storage === "sources")
+        return "source";
+    if (storage === "meta")
+        return "meta";
+    return "canonical";
+}