project-librarian 0.4.0 → 0.4.1

package/dist/init-project-wiki.js

@@ -43,6 +43,7 @@ Options:
   --review-migration               Sync unit coverage and compatible inbox statuses into migration review files.
   --no-git-config                  Install hook files without changing git core.hooksPath.
   --code-index                     Build the disposable .project-wiki code evidence index.
+  --code-index-health              Inspect code evidence cache compatibility and print rebuild guidance without writing.
   --acknowledge-small-repo         With --code-index, proceed below the small-repo scale gate after its cost warning.
   --incremental                    With --code-index, require an existing compatible index and update only changes.
   --code-index-full                With --code-index, force a full rebuild even when incremental update is possible.
@@ -68,6 +69,20 @@ Commands:
 function exitAfterStdoutDrain(code) {
     process.stdout.write("", () => process.exit(code));
 }
+function activeCodeEvidenceCliModes() {
+    const modes = [
+        { active: args_1.codeQueryMode, drainStdout: true, run: (codeIndexModule) => codeIndexModule.runCodeQueryMode() },
+        { active: args_1.codeReportMode, drainStdout: true, run: (codeIndexModule) => codeIndexModule.runCodeReportMode() },
+        { active: args_1.codeStatusMode, drainStdout: true, run: (codeIndexModule) => codeIndexModule.runCodeStatusMode() },
+        { active: args_1.codeFilesMode, drainStdout: true, run: (codeIndexModule) => codeIndexModule.runCodeFilesMode() },
+        { active: args_1.codeImpactMode, drainStdout: true, run: (codeIndexModule) => codeIndexModule.runCodeImpactMode() },
+        { active: args_1.codeContextPackMode, drainStdout: true, run: (codeIndexModule) => codeIndexModule.runCodeContextPackMode() },
+        { active: args_1.codeSearchSymbolMode, drainStdout: true, run: (codeIndexModule) => codeIndexModule.runCodeSearchSymbolMode() },
+        { active: args_1.codeIndexHealthMode, drainStdout: true, run: (codeIndexModule) => codeIndexModule.runCodeIndexHealthMode() },
+        { active: args_1.codeIndexMode, drainStdout: false, run: (codeIndexModule) => codeIndexModule.runCodeIndexMode() },
+    ];
+    return modes.filter((mode) => mode.active);
+}
 if (args_1.helpMode) {
     printUsage();
     process.exit(0);
@@ -147,50 +162,20 @@ else {
     runInitCommand();
 }
 function runInitCommand() {
-    const activeCodeModes = [args_1.codeQueryMode, args_1.codeReportMode, args_1.codeStatusMode, args_1.codeFilesMode, args_1.codeImpactMode, args_1.codeContextPackMode, args_1.codeSearchSymbolMode, args_1.codeIndexMode].filter(Boolean).length;
-    if (activeCodeModes > 1) {
-        console.error("Use one code evidence mode at a time: --code-index, --code-query, --code-report, --code-status, --code-files, --code-impact, --code-context-pack, or --code-search-symbol.");
+    const activeCodeModes = activeCodeEvidenceCliModes();
+    if (activeCodeModes.length > 1) {
+        console.error("Use one code evidence mode at a time: --code-index, --code-index-health, --code-query, --code-report, --code-status, --code-files, --code-impact, --code-context-pack, or --code-search-symbol.");
         process.exit(1);
     }
-    if (args_1.codeQueryMode) {
-        codeIndex().runCodeQueryMode();
-        exitAfterStdoutDrain(0);
-        return;
-    }
-    if (args_1.codeReportMode) {
-        codeIndex().runCodeReportMode();
-        exitAfterStdoutDrain(0);
-        return;
-    }
-    if (args_1.codeStatusMode) {
-        codeIndex().runCodeStatusMode();
-        exitAfterStdoutDrain(0);
-        return;
-    }
-    if (args_1.codeFilesMode) {
-        codeIndex().runCodeFilesMode();
-        exitAfterStdoutDrain(0);
-        return;
-    }
-    if (args_1.codeImpactMode) {
-        codeIndex().runCodeImpactMode();
-        exitAfterStdoutDrain(0);
-        return;
-    }
-    if (args_1.codeContextPackMode) {
-        codeIndex().runCodeContextPackMode();
-        exitAfterStdoutDrain(0);
-        return;
-    }
-    if (args_1.codeSearchSymbolMode) {
-        codeIndex().runCodeSearchSymbolMode();
-        exitAfterStdoutDrain(0);
+    const activeCodeMode = activeCodeModes[0];
+    if (activeCodeMode) {
+        activeCodeMode.run(codeIndex());
+        if (activeCodeMode.drainStdout)
+            exitAfterStdoutDrain(0);
+        else
+            process.exit(0);
         return;
     }
-    if (args_1.codeIndexMode) {
-        codeIndex().runCodeIndexMode();
-        process.exit(0);
-    }
     if (args_1.wikiImpactMode) {
         (0, modes_1.runWikiImpactMode)();
         exitAfterStdoutDrain(0);
@@ -258,6 +243,10 @@ function runInitCommand() {
         (0, modes_1.runLintMode)();
         process.exit(0);
     }
+    if (args_1.refreshIndexMode && !args_1.migrateMode && !args_1.glossaryMode && !args_1.captureInboxMode) {
+        runRefreshIndexOnlyMode();
+        process.exit(0);
+    }
     const migrationState = args_1.migrateMode ? (0, migration_1.prepareMigrationMode)() : null;
     const results = [];
     if (migrationState)
@@ -366,3 +355,12 @@ function runInitCommand() {
         console.log(`${String(status).padEnd(7)} ${relativePath}`);
     }
 }
+function runRefreshIndexOnlyMode() {
+    const results = [];
+    results.push(["wiki/index.md", (0, workspace_1.writeStarter)("wiki/index.md", templates_1.index)]);
+    results.push(["wiki/index.md auto-discovered pages", (0, workspace_1.upsertMarkedSection)("wiki/index.md", "<!-- PROJECT-WIKI-AUTO-INDEX:START -->", "<!-- PROJECT-WIKI-AUTO-INDEX:END -->", (0, modes_1.buildRefreshIndexBlock)())]);
+    console.log("Project Librarian refresh-index complete.");
+    for (const [relativePath, status] of results) {
+        console.log(`${String(status).padEnd(7)} ${relativePath}`);
+    }
+}

package/dist/mcp-server.js

@@ -58,6 +58,7 @@ const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const code_index_1 = require("./code-index");
 const code_index_file_policy_1 = require("./code-index-file-policy");
+const schema_1 = require("./code-index/schema");
 const workspace_1 = require("./workspace");
 // Pinned MCP protocol version. This is the spec revision this server is written
 // against; one constant so the supported version is auditable in a single place.
@@ -366,8 +367,8 @@ function ownershipAnswer(filePath) {
     lines.push(`Workspace owner: ${info.owner} (source: ${info.owner_source})${info.codeowners ? `; codeowners ${info.codeowners}` : ""}.`);
     return lines.join("\n");
 }
-function impactAnswer(database, term) {
-    const impact = (0, code_index_1.codeImpact)(database, term);
+function impactAnswer(database, term, context) {
+    const impact = (0, code_index_1.codeImpact)(database, term, { staleness: context.staleness });
     const matches = (impact.matches ?? {});
     const edges = (impact.edges ?? {});
     const owners = asRows(impact.impacted_owners);
@@ -483,7 +484,7 @@ const TOOLS = [
             properties: { term: { type: "string", description: "Path, symbol, route, module, or concept to build a compact code context pack for." } },
             required: ["term"],
         },
-        run: (database, args) => (0, code_index_1.codeContextPack)(database, requireStringArg(args, "term")),
+        run: (database, args, context) => (0, code_index_1.codeContextPack)(database, requireStringArg(args, "term"), { staleness: context.staleness }),
     },
     {
         name: "code_impact",
@@ -493,7 +494,7 @@ const TOOLS = [
             properties: { term: { type: "string", description: "File path, symbol name, route, or module to trace." } },
             required: ["term"],
         },
-        run: (database, args) => impactAnswer(database, requireStringArg(args, "term")),
+        run: (database, args, context) => impactAnswer(database, requireStringArg(args, "term"), context),
     },
     {
         name: "code_ownership",
@@ -537,6 +538,59 @@ const TOOLS = [
     },
 ];
 const TOOLS_BY_NAME = new Map(TOOLS.map((tool) => [tool.name, tool]));
+let cachedStaleness = null;
+function statFingerprint(relativePath) {
+    const absolutePath = path.join(workspace_1.root, relativePath);
+    try {
+        const stat = fs.statSync(absolutePath);
+        if (!stat.isFile())
+            return `${relativePath}:not-file`;
+        return [
+            relativePath,
+            stat.size,
+            stat.mtimeMs,
+            stat.ctimeMs,
+        ].join(":");
+    }
+    catch {
+        return `${relativePath}:missing`;
+    }
+}
+function codeEvidenceFreshnessCacheKey(opened) {
+    try {
+        const database = opened.database;
+        const scopes = (0, schema_1.indexedScopes)(database);
+        const parserMode = (0, schema_1.indexedParserMode)(database);
+        const schemaVersion = (0, schema_1.readMetaValue)(database, "schema_version");
+        const updatedAt = (0, schema_1.readMetaValue)(database, "updated_at");
+        const currentFiles = (0, code_index_file_policy_1.discoverCodeFiles)(scopes.length > 0 ? scopes : ["."]);
+        const currentFingerprint = currentFiles.map(statFingerprint).join("\n");
+        const indexedFingerprint = database.prepare("SELECT path, hash, mtime_ms, size FROM files ORDER BY path")
+            .all()
+            .map((row) => `${String(row.path)}:${String(row.hash)}:${Number(row.mtime_ms)}:${Number(row.size)}`)
+            .join("\n");
+        return [
+            opened.relativePath,
+            schemaVersion,
+            updatedAt,
+            parserMode,
+            scopes.join("\0"),
+            currentFingerprint,
+            indexedFingerprint,
+        ].join("\n---\n");
+    }
+    catch {
+        return null;
+    }
+}
+function codeIndexStalenessForToolCall(opened) {
+    const cacheKey = codeEvidenceFreshnessCacheKey(opened);
+    if (cacheKey && cachedStaleness?.cacheKey === cacheKey)
+        return cachedStaleness.staleness;
+    const staleness = (0, code_index_1.codeIndexStaleness)(opened.database);
+    cachedStaleness = cacheKey ? { cacheKey, staleness } : null;
+    return staleness;
+}
 // ---------------------------------------------------------------------------
 // tools/call dispatch
 // ---------------------------------------------------------------------------
@@ -559,10 +613,10 @@ function callTool(name, rawArgs) {
         throw error;
     }
     try {
-        const staleness = (0, code_index_1.codeIndexStaleness)(opened.database);
+        const staleness = codeIndexStalenessForToolCall(opened);
         const body = name === "code_status"
             ? statusAnswer(opened.database, opened.relativePath, staleness)
-            : TOOLS_BY_NAME.get(name).run(opened.database, args);
+            : TOOLS_BY_NAME.get(name).run(opened.database, args, { staleness });
         return toolResultContent(finalizeAnswer(body, staleness));
     }
     catch (error) {

package/dist/migration.js

@@ -37,6 +37,7 @@ exports.generatedMigrationInboxFiles = void 0;
 exports.classifyMarkdown = classifyMarkdown;
 exports.formOnlyMigrationDocumentReason = formOnlyMigrationDocumentReason;
 exports.extractMigrationUnits = extractMigrationUnits;
+exports.loadMigrationUnitContext = loadMigrationUnitContext;
 exports.collectMigrationCoverageDiagnostics = collectMigrationCoverageDiagnostics;
 exports.collectMigrationUnitMapDiagnostics = collectMigrationUnitMapDiagnostics;
 exports.collectMigrationSplitPlanDiagnostics = collectMigrationSplitPlanDiagnostics;
@@ -321,6 +322,9 @@ function expectedMigrationUnits() {
         .flatMap((legacyRoot) => (0, wiki_files_1.walkMarkdownFiles)((0, workspace_1.abs)(legacyRoot), [], (0, workspace_1.abs)(legacyRoot)))
         .flatMap((file) => extractMigrationUnits(file.basePath, (0, workspace_1.read)(file.path)));
 }
+function loadMigrationUnitContext() {
+    return { units: expectedMigrationUnits() };
+}
 function isMigrationConfidence(value) {
     return ["high", "medium", "low"].includes(value);
 }
@@ -353,8 +357,8 @@ function isReviewedCoverageRetarget(cells) {
     return note.includes("reviewed low-confidence content; retargeted")
         || reason.includes("reviewed source context; taxonomy target assigned");
 }
-function collectMigrationCoverageDiagnostics() {
-    const units = expectedMigrationUnits();
+function collectMigrationCoverageDiagnostics(context = loadMigrationUnitContext()) {
+    const units = context.units;
     if (units.length === 0)
         return [];
     if (!(0, workspace_1.exists)("wiki/migration/coverage.md")) {
@@ -417,8 +421,8 @@ function collectMigrationCoverageDiagnostics() {
     }
     return diagnostics.sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code) || a.message.localeCompare(b.message));
 }
-function collectMigrationUnitMapDiagnostics() {
-    const units = expectedMigrationUnits();
+function collectMigrationUnitMapDiagnostics(context = loadMigrationUnitContext()) {
+    const units = context.units;
     if (units.length === 0)
         return [];
     const file = "wiki/migration/unit-map.md";
@@ -485,8 +489,8 @@ function collectMigrationUnitMapDiagnostics() {
     }
     return diagnostics.sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code) || a.message.localeCompare(b.message));
 }
-function collectMigrationSplitPlanDiagnostics() {
-    const units = expectedMigrationUnits();
+function collectMigrationSplitPlanDiagnostics(context = loadMigrationUnitContext()) {
+    const units = context.units;
     if (units.length === 0)
         return [];
     const file = "wiki/migration/split-plan.md";

package/dist/modes.js

@@ -63,6 +63,8 @@ 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 wiki_corpus_1 = require("./wiki-corpus");
+const wiki_diagnostics_1 = require("./wiki-diagnostics");
 const scopedAutoIndexThreshold = 40;
 const scopedAutoIndexMarker = "<!-- PROJECT-WIKI-SCOPED-AUTO-INDEX -->";
 function isScopedAutoIndex(file) {
@@ -187,6 +189,27 @@ function scoreQueryBlock(block, terms) {
     const occurrences = termOccurrences(`${block.headingPath.join(" ")}\n${block.text}`, terms);
     return occurrences > 0 ? occurrences + blockKindBoost(block) : 0;
 }
+function hasMigrationQueryIntent(terms) {
+    return terms.some((term) => /^(migrat|legacy|coverage|unit|ledger|review)/.test(term));
+}
+function isMigrationSurface(file, meta) {
+    return file.startsWith("wiki/migration/")
+        || /(?:^|-)migration(?:-|$)/.test(file)
+        || /migration|legacy/.test(meta.scope);
+}
+function querySurfaceScore(file, meta, rawScore, terms) {
+    if (rawScore <= 0)
+        return 0;
+    if (isMigrationSurface(file, meta) && !hasMigrationQueryIntent(terms)) {
+        return Math.max(1, Math.floor(rawScore * 0.25) - 20);
+    }
+    let score = rawScore;
+    if (file.startsWith("wiki/canonical/") && meta.status === "active")
+        score += 12;
+    else if (meta.status === "active")
+        score += 2;
+    return score;
+}
 // 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 and the strongest
 // matching block so the agent can pick a page without opening it, and the whole
@@ -197,8 +220,9 @@ function runQueryMode() {
         process.exit(1);
     }
     const terms = args_1.queryTerm.toLowerCase().split(/\s+/).filter(Boolean);
-    const pages = (0, wiki_files_1.wikiMarkdownFiles)().map((file) => ({ file, text: (0, workspace_1.read)(file) }));
-    const graph = (0, wiki_graph_1.buildWikiGraph)(pages);
+    const corpus = (0, wiki_corpus_1.loadWikiCorpus)();
+    const pages = corpus.pages;
+    const graph = (0, wiki_corpus_1.wikiCorpusGraph)(corpus);
     const routerDepths = (0, wiki_graph_1.wikiRouterDepths)(graph);
     const matches = pages.map(({ file, text }) => {
         const body = (0, workspace_1.stripMetadataHeader)(text);
@@ -212,7 +236,7 @@ function runQueryMode() {
             .sort((left, right) => right.score - left.score || left.block.line - right.block.line || left.block.id.localeCompare(right.block.id));
         const topBlock = blocks[0]?.block;
         const blockScore = blocks.slice(0, 5).reduce((sum, item) => sum + item.score, 0);
-        const score = metadataScore + blockScore;
+        const score = querySurfaceScore(file, meta, metadataScore + blockScore, terms);
         return {
             blockKind: topBlock?.kind ?? "",
             blockLine: topBlock?.line ?? 0,
@@ -262,8 +286,8 @@ function runWikiImpactMode() {
         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()));
+    const corpus = (0, wiki_corpus_1.loadWikiCorpus)();
+    console.log((0, wiki_graph_1.wikiImpactAnswer)(corpus.pages, args_1.wikiImpactTarget.trim(), (0, wiki_corpus_1.wikiCorpusGraph)(corpus)));
 }
 function projectCandidatesContent() {
     return `${(0, templates_1.metadata)("inbox", "on-demand", "wiki/meta/wiki-ops-v1-decisions.md", "candidates are adopted, rejected, or stale")}
@@ -533,11 +557,11 @@ function printDiagnostics(title, diagnostics, checked) {
     console.log(`passed: ${checked} wiki markdown files checked, ${warnings} warnings`);
     return true;
 }
-function collectLinkDiagnostics() {
+function collectLinkDiagnostics(corpus = (0, wiki_corpus_1.loadWikiCorpus)()) {
     const diagnostics = [];
-    const files = (0, wiki_files_1.wikiMarkdownFiles)();
-    const fileSet = new Set(files);
-    const graph = (0, wiki_graph_1.buildWikiGraph)(files.map((file) => ({ file, text: (0, workspace_1.read)(file) })));
+    const files = corpus.files;
+    const fileSet = corpus.fileSet;
+    const graph = (0, wiki_corpus_1.wikiCorpusGraph)(corpus);
     for (const link of graph.links) {
         if (!fileSet.has(link.normalizedTarget)) {
             diagnostics.push({
@@ -643,10 +667,10 @@ function shouldGuardAgainstLegacyReference(file) {
         return false;
     return !file.endsWith("/migration-inbox.md");
 }
-function migrationLegacyReferenceDiagnostics(files) {
+function migrationLegacyReferenceDiagnostics(files, corpus) {
     return files
         .filter(shouldGuardAgainstLegacyReference)
-        .filter((file) => /\bwiki_legacy(?:_|\b|\/)/.test((0, workspace_1.stripMetadataHeader)((0, workspace_1.read)(file))))
+        .filter((file) => /\bwiki_legacy(?:_|\b|\/)/.test((0, workspace_1.stripMetadataHeader)((0, wiki_corpus_1.wikiCorpusText)(corpus, file))))
         .map((file) => ({
         code: "migration-legacy-reference",
         severity: "error",
@@ -654,12 +678,12 @@ function migrationLegacyReferenceDiagnostics(files) {
         message: "new project truth must not link to or cite wiki_legacy*; migrate the meaning or keep unresolved material in migration inboxes",
     }));
 }
-function collectQualityDiagnostics() {
+function collectQualityDiagnostics(corpus = (0, wiki_corpus_1.loadWikiCorpus)()) {
     const diagnostics = [];
-    const files = (0, wiki_files_1.wikiMarkdownFiles)();
+    const files = corpus.files;
     const titles = new Map();
     for (const file of files) {
-        const text = (0, workspace_1.read)(file);
+        const text = (0, wiki_corpus_1.wikiCorpusText)(corpus, file);
         const body = (0, workspace_1.stripMetadataHeader)(text);
         const title = (0, wiki_files_1.wikiTitleForFile)(file, text).toLowerCase();
         titles.set(title, [...(titles.get(title) ?? []), file]);
@@ -671,8 +695,9 @@ function collectQualityDiagnostics() {
         if (tldrExpected && !/##\s+TL;DR/.test(body)) {
             diagnostics.push({ code: "missing-tldr", severity: "warn", file, message: "add a compact TL;DR near the top" });
         }
-        if (status === "active" && updated && updated < workspace_1.today && /project-canonical|project-decisions|source-summary|wiki-meta/.test(scope)) {
-            diagnostics.push({ code: "stale-review", severity: "warn", file, message: `updated before today: ${updated}` });
+        const reviewAge = updated ? (0, wiki_diagnostics_1.staleReviewAge)(updated, workspace_1.today) : null;
+        if (status === "active" && reviewAge !== null && /project-canonical|project-decisions|source-summary|wiki-meta/.test(scope)) {
+            diagnostics.push({ code: "stale-review", severity: "warn", file, message: `updated ${reviewAge} days ago: ${updated}` });
         }
         if (status === "active" && !/inbox|migration-inbox/.test(scope) && /proposed|undecided|TODO|TBD|미정/i.test(body)) {
             diagnostics.push({ code: "unresolved-signal", severity: "warn", file, message: "contains pending/proposed/undecided language" });
@@ -700,9 +725,8 @@ function collectQualityDiagnostics() {
     }
     return diagnostics.sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code));
 }
-function collectMigrationQualityDiagnostics() {
-    const files = (0, wiki_files_1.wikiMarkdownFiles)();
-    return migrationLegacyReferenceDiagnostics(files).sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code));
+function collectMigrationQualityDiagnostics(corpus = (0, wiki_corpus_1.loadWikiCorpus)()) {
+    return migrationLegacyReferenceDiagnostics(corpus.files, corpus).sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code));
 }
 function collectMigrationLintDiagnostics() {
     if (legacyWikiRoots().length === 0)
@@ -728,23 +752,27 @@ function collectMigrationLintDiagnostics() {
         file,
         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)());
+    const migrationContext = (0, migration_1.loadMigrationUnitContext)();
+    diagnostics.push(...(0, migration_1.collectMigrationCoverageDiagnostics)(migrationContext));
+    diagnostics.push(...(0, migration_1.collectMigrationUnitMapDiagnostics)(migrationContext));
+    diagnostics.push(...(0, migration_1.collectMigrationSplitPlanDiagnostics)(migrationContext));
     return diagnostics.sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code) || a.message.localeCompare(b.message));
 }
 function runLinkCheckMode() {
-    const ok = printDiagnostics("Project wiki link-check", collectLinkDiagnostics(), (0, wiki_files_1.wikiMarkdownFiles)().length);
+    const corpus = (0, wiki_corpus_1.loadWikiCorpus)();
+    const ok = printDiagnostics("Project wiki link-check", collectLinkDiagnostics(corpus), corpus.files.length);
     if (!ok)
         process.exit(1);
 }
 function runQualityCheckMode() {
-    const ok = printDiagnostics("Project wiki quality-check", collectQualityDiagnostics(), (0, wiki_files_1.wikiMarkdownFiles)().length);
+    const corpus = (0, wiki_corpus_1.loadWikiCorpus)();
+    const ok = printDiagnostics("Project wiki quality-check", collectQualityDiagnostics(corpus), corpus.files.length);
     if (!ok)
         process.exit(1);
 }
 function runMigrationQualityCheckMode() {
-    const ok = printDiagnostics("Project wiki migration quality-check", collectMigrationQualityDiagnostics(), (0, wiki_files_1.wikiMarkdownFiles)().length);
+    const corpus = (0, wiki_corpus_1.loadWikiCorpus)();
+    const ok = printDiagnostics("Project wiki migration quality-check", collectMigrationQualityDiagnostics(corpus), corpus.files.length);
     if (!ok)
         process.exit(1);
 }
@@ -754,8 +782,9 @@ function runMigrationLintMode() {
         process.exit(1);
 }
 function runMigrationDoctorMode() {
-    const lintOk = printDiagnostics("Project wiki migration lint", collectMigrationLintDiagnostics(), (0, wiki_files_1.wikiMarkdownFiles)().length);
-    const qualityOk = printDiagnostics("Project wiki migration quality-check", collectMigrationQualityDiagnostics(), (0, wiki_files_1.wikiMarkdownFiles)().length);
+    const corpus = (0, wiki_corpus_1.loadWikiCorpus)();
+    const lintOk = printDiagnostics("Project wiki migration lint", collectMigrationLintDiagnostics(), corpus.files.length);
+    const qualityOk = printDiagnostics("Project wiki migration quality-check", collectMigrationQualityDiagnostics(corpus), corpus.files.length);
     if (!lintOk || !qualityOk)
         process.exit(1);
 }
@@ -794,11 +823,12 @@ function extractSectionBody(markdown, headingText) {
     const nextHeading = /^##\s/m.exec(afterHeading);
     return nextHeading ? afterHeading.slice(0, nextHeading.index) : afterHeading;
 }
-function collectRouterTruthDiagnostics() {
+function collectRouterTruthDiagnostics(corpus) {
     const logPath = "wiki/decisions/log.md";
-    if (!(0, workspace_1.exists)(logPath))
+    const hasLog = corpus ? corpus.fileSet.has(logPath) : (0, workspace_1.exists)(logPath);
+    if (!hasLog)
         return [];
-    const logHasDatedEntry = /\b\d{4}-\d{2}-\d{2}\b/.test((0, workspace_1.stripMetadataHeader)((0, workspace_1.read)(logPath)));
+    const logHasDatedEntry = /\b\d{4}-\d{2}-\d{2}\b/.test((0, workspace_1.stripMetadataHeader)((0, wiki_corpus_1.wikiCorpusText)(corpus, logPath)));
     if (!logHasDatedEntry)
         return [];
     const diagnostics = [];
@@ -810,9 +840,10 @@ function collectRouterTruthDiagnostics() {
         ["wiki/decisions/recent.md", "Decisions", "Decisions"],
     ];
     for (const [file, heading, surface] of routers) {
-        if (!(0, workspace_1.exists)(file))
+        const hasFile = corpus ? corpus.fileSet.has(file) : (0, workspace_1.exists)(file);
+        if (!hasFile)
             continue;
-        const section = extractSectionBody((0, workspace_1.stripMetadataHeader)((0, workspace_1.read)(file)), heading);
+        const section = extractSectionBody((0, workspace_1.stripMetadataHeader)((0, wiki_corpus_1.wikiCorpusText)(corpus, file)), heading);
         if (section === "")
             continue; // section absent — skip rather than false-positive
         if (ROUTER_TRUTH_NONE_YET_REGEX.test(section)) {
@@ -837,11 +868,11 @@ function runDoctorMode(fix) {
             console.log("skipped wiki/index.md auto-discovered pages: missing wiki/index.md");
         }
     }
-    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();
+    const corpus = (0, wiki_corpus_1.loadWikiCorpus)();
+    const linkOk = printDiagnostics("Project wiki link-check", collectLinkDiagnostics(corpus), corpus.files.length);
+    const qualityOk = printDiagnostics("Project wiki quality-check", collectQualityDiagnostics(corpus), corpus.files.length);
+    const routerTruthOk = printDiagnostics("Project wiki router-truth check", collectRouterTruthDiagnostics(corpus), corpus.files.length);
+    runLintMode(corpus);
     if (!linkOk || !qualityOk || !routerTruthOk)
         process.exit(1);
 }
@@ -872,7 +903,7 @@ function activeLintAgentSurfaces() {
     }
     return active;
 }
-function runLintMode() {
+function runLintMode(corpus) {
     const errors = [];
     const warnings = [];
     const activeAgents = activeLintAgentSurfaces();
@@ -884,10 +915,10 @@ function runLintMode() {
         if (!(0, workspace_1.exists)(file))
             errors.push(`missing required file: ${file}`);
     }
-    const files = (0, wiki_files_1.wikiMarkdownFiles)();
+    const files = corpus?.files ?? (0, wiki_files_1.wikiMarkdownFiles)();
     const requiredMetadataKeys = ["status", "updated", "scope", "read_budget", "decision_ref", "review_trigger"];
     for (const file of files) {
-        const text = (0, workspace_1.read)(file);
+        const text = (0, wiki_corpus_1.wikiCorpusText)(corpus, file);
         if (!(0, workspace_1.hasMetadataHeader)(text)) {
             errors.push(`missing metadata header: ${file}`);
             continue;
@@ -897,8 +928,8 @@ function runLintMode() {
                 errors.push(`missing metadata key ${key}: ${file}`);
         }
     }
-    const startupLength = (0, workspace_1.exists)("wiki/startup.md") ? (0, workspace_1.read)("wiki/startup.md").length : 0;
-    const indexLength = (0, workspace_1.exists)("wiki/index.md") ? (0, workspace_1.read)("wiki/index.md").length : 0;
+    const startupLength = (0, workspace_1.exists)("wiki/startup.md") ? (0, wiki_corpus_1.wikiCorpusText)(corpus, "wiki/startup.md").length : 0;
+    const indexLength = (0, workspace_1.exists)("wiki/index.md") ? (0, wiki_corpus_1.wikiCorpusText)(corpus, "wiki/index.md").length : 0;
     if (startupLength > 3500)
         warnings.push(`startup exceeds hook budget: ${startupLength}/3500 chars`);
     if (indexLength > 4500)

package/dist/path-ignore-policy.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commonIgnoredDirectories = void 0;
+exports.ignoredDirectorySet = ignoredDirectorySet;
+exports.pathContainsIgnoredDirectory = pathContainsIgnoredDirectory;
+const workspace_1 = require("./workspace");
+exports.commonIgnoredDirectories = [
+    ".git",
+    ".codex",
+    ".claude",
+    ".cursor",
+    ".gemini",
+    "node_modules",
+    ".next",
+    "dist",
+    "build",
+    "coverage",
+    "vendor",
+    "tmp",
+    "temp",
+];
+function ignoredDirectorySet(extraDirectories = []) {
+    return new Set([...exports.commonIgnoredDirectories, ...extraDirectories]);
+}
+function pathContainsIgnoredDirectory(relativePath, ignoredDirectories) {
+    return (0, workspace_1.normalizePath)(relativePath)
+        .split("/")
+        .filter(Boolean)
+        .some((part) => ignoredDirectories.has(part));
+}

package/dist/wiki-corpus.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadWikiCorpus = loadWikiCorpus;
+exports.wikiCorpusGraph = wikiCorpusGraph;
+exports.wikiCorpusText = wikiCorpusText;
+const wiki_graph_1 = require("./wiki-graph");
+const workspace_1 = require("./workspace");
+const wiki_files_1 = require("./wiki-files");
+function loadWikiCorpus() {
+    const files = (0, wiki_files_1.wikiMarkdownFiles)();
+    const pages = files.map((file) => ({ file, text: (0, workspace_1.read)(file) }));
+    return {
+        files,
+        fileSet: new Set(files),
+        pages,
+        textByFile: new Map(pages.map((page) => [page.file, page.text])),
+    };
+}
+function wikiCorpusGraph(corpus) {
+    corpus.graph ??= (0, wiki_graph_1.buildWikiGraph)(corpus.pages);
+    return corpus.graph;
+}
+function wikiCorpusText(corpus, file) {
+    return corpus?.textByFile.get(file) ?? (0, workspace_1.read)(file);
+}

package/dist/wiki-diagnostics.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.staleReviewAgeDays = void 0;
+exports.staleReviewAge = staleReviewAge;
+exports.staleReviewAgeDays = 30;
+function dateOnlyMillis(value) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return null;
+    const millis = Date.parse(`${value}T00:00:00Z`);
+    return Number.isNaN(millis) ? null : millis;
+}
+function staleReviewAge(updated, currentDate) {
+    const updatedMillis = dateOnlyMillis(updated);
+    const currentMillis = dateOnlyMillis(currentDate);
+    if (updatedMillis === null || currentMillis === null)
+        return null;
+    const ageDays = Math.floor((currentMillis - updatedMillis) / 86_400_000);
+    return ageDays > exports.staleReviewAgeDays ? ageDays : null;
+}

package/dist/wiki-files.js

@@ -54,6 +54,7 @@ exports.firstTldrBullet = firstTldrBullet;
 exports.canonicalBodyForLint = canonicalBodyForLint;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
+const path_ignore_policy_1 = require("./path-ignore-policy");
 const workspace_1 = require("./workspace");
 exports.standardWikiFiles = new Set([
     "AGENTS.md",
@@ -99,7 +100,7 @@ exports.standardWikiFiles = new Set([
     "tools/project-librarian/agents/openai.yaml",
     "tools/project-librarian/dist/init-project-wiki.js",
 ]);
-exports.ignoredDirs = new Set([".git", ".codex", ".claude", ".cursor", ".gemini", "node_modules", ".next", "dist", "build", "coverage", "vendor", "tmp", "temp"]);
+exports.ignoredDirs = (0, path_ignore_policy_1.ignoredDirectorySet)();
 function walkMarkdownFiles(dir = workspace_1.root, acc = [], baseDir = workspace_1.root) {
     for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
         const fullPath = path.join(dir, entry.name);

package/dist/wiki-graph.js

@@ -124,8 +124,7 @@ function wikiQueryGraphEvidence(graph, file, depths = wikiRouterDepths(graph), l
         parts.push(`decision_ref-by ${incomingRefs.length}: ${sampled(incomingRefs, listCap)}`);
     return parts.join("; ");
 }
-function wikiImpactAnswer(pages, term) {
-    const graph = buildWikiGraph(pages);
+function wikiImpactAnswer(pages, term, graph = buildWikiGraph(pages)) {
     const depths = wikiRouterDepths(graph);
     const textByFile = new Map(pages.map((page) => [page.file, page.text]));
     const lowered = term.toLowerCase();