project-librarian 0.4.0 → 0.4.2

package/dist/modes.js

@@ -57,13 +57,17 @@ const fs = __importStar(require("node:fs"));
 const childProcess = __importStar(require("node:child_process"));
 const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
+const agent_surfaces_1 = require("./agent-surfaces");
 const args_1 = require("./args");
 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 wiki_corpus_1 = require("./wiki-corpus");
+const wiki_diagnostics_1 = require("./wiki-diagnostics");
 const scopedAutoIndexThreshold = 40;
+const scopedAutoIndexCharLimit = 7600;
 const scopedAutoIndexMarker = "<!-- PROJECT-WIKI-SCOPED-AUTO-INDEX -->";
 function isScopedAutoIndex(file) {
     return /^wiki\/indexes\/auto-[a-z0-9-]+\.md$/.test(file);
@@ -87,16 +91,18 @@ function routeAreaForWikiFile(file) {
         return slugPart(directory);
     return "misc";
 }
-function scopedIndexPath(area) {
-    return `wiki/indexes/auto-${slugPart(area)}.md`;
+function scopedIndexPath(area, partIndex = 0, partCount = 1) {
+    const slug = slugPart(area);
+    return partCount <= 1 ? `wiki/indexes/auto-${slug}.md` : `wiki/indexes/auto-${slug}-${partIndex + 1}.md`;
 }
-function scopedIndexContent(area, files) {
+function scopedIndexContent(area, files, partIndex = 0, partCount = 1) {
+    const title = partCount <= 1 ? area : `${area} (${partIndex + 1}/${partCount})`;
     const rows = files.map((file) => {
         const meta = (0, wiki_files_1.metadataSummary)(file, (0, workspace_1.read)(file));
         return `| ${(0, wiki_files_1.wikiLinkForFile)(file)} | ${meta.scope} | ${meta.status} | ${meta.budget} |`;
     }).join("\n");
     return `${(0, templates_1.metadata)("wiki-router", "medium", "wiki/meta/wiki-ops-v1-decisions.md", "auto-discovered scoped routes change")}${scopedAutoIndexMarker}
-# Auto Index: ${area}
+# Auto Index: ${title}
 
 ## TL;DR
 
@@ -108,6 +114,23 @@ function scopedIndexContent(area, files) {
 ${rows}
 `;
 }
+function splitScopedIndexFiles(area, files) {
+    const parts = [];
+    let current = [];
+    for (const file of files) {
+        const candidate = [...current, file];
+        if (current.length > 0 && scopedIndexContent(area, candidate).length > scopedAutoIndexCharLimit) {
+            parts.push(current);
+            current = [file];
+        }
+        else {
+            current = candidate;
+        }
+    }
+    if (current.length > 0)
+        parts.push(current);
+    return parts;
+}
 function removeStaleScopedAutoIndexes(keepPaths) {
     if (!(0, workspace_1.exists)("wiki/indexes"))
         return;
@@ -124,16 +147,23 @@ function syncScopedAutoIndexes(files) {
         const area = routeAreaForWikiFile(file);
         groups.set(area, [...(groups.get(area) ?? []), file]);
     }
-    const summaries = Array.from(groups.entries()).map(([area, areaFiles]) => ({
-        area,
-        count: areaFiles.length,
-        file: scopedIndexPath(area),
-        files: areaFiles.sort(),
-    })).sort((left, right) => right.count - left.count || left.area.localeCompare(right.area));
+    const summaries = Array.from(groups.entries()).flatMap(([area, areaFiles]) => {
+        const sortedFiles = areaFiles.sort();
+        const parts = splitScopedIndexFiles(area, sortedFiles);
+        return parts.map((files, partIndex) => ({
+            area: parts.length <= 1 ? area : `${area} ${partIndex + 1}`,
+            baseArea: area,
+            count: files.length,
+            file: scopedIndexPath(area, partIndex, parts.length),
+            files,
+            partIndex,
+            partCount: parts.length,
+        }));
+    }).sort((left, right) => right.count - left.count || left.area.localeCompare(right.area));
     const keepPaths = new Set(summaries.map((summary) => summary.file));
     removeStaleScopedAutoIndexes(keepPaths);
     for (const summary of summaries)
-        (0, workspace_1.write)(summary.file, scopedIndexContent(summary.area, summary.files));
+        (0, workspace_1.write)(summary.file, scopedIndexContent(summary.baseArea, summary.files, summary.partIndex, summary.partCount));
     return summaries.map(({ area, count, file }) => ({ area, count, file }));
 }
 function buildRefreshIndexBlock() {
@@ -147,8 +177,6 @@ function buildRefreshIndexBlock() {
         return `<!-- PROJECT-WIKI-AUTO-INDEX:START -->
 ## Auto-Discovered Pages
 
-This block is managed by \`--refresh-index\`. Large route sets are split into scoped generated routers to keep \`wiki/index.md\` within startup-hook budget.
-
 | Scoped Router | Area | Pages |
 | --- | --- | ---: |
 ${rows}
@@ -187,6 +215,34 @@ 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 hasDeepReferenceQueryIntent(terms) {
+    return hasMigrationQueryIntent(terms)
+        || terms.some((term) => /^(archive|audit|decision|detail|history|ledger|raw|record|source|trace|verification)/.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 (meta.budget === "on-demand" && !hasDeepReferenceQueryIntent(terms)) {
+        score = Math.max(1, Math.min(Math.floor(score * 0.5), 24));
+    }
+    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 +253,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 +269,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 +319,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 +590,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 +700,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 +711,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 +728,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 +758,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 +785,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 +815,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 +856,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 +873,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 +901,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);
 }
@@ -858,36 +922,30 @@ const commonLintRequiredFiles = [
     ".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)) {
+    for (const [agent, files] of Object.entries(agent_surfaces_1.agentSurfaceRequiredFiles)) {
         if (files.some((file) => (0, workspace_1.exists)(file)))
             active.add(agent);
     }
     return active;
 }
-function runLintMode() {
+function runLintMode(corpus) {
     const errors = [];
     const warnings = [];
     const activeAgents = activeLintAgentSurfaces();
     const requiredFiles = [
         ...commonLintRequiredFiles,
-        ...Array.from(activeAgents).flatMap((agent) => agentLintRequiredFiles[agent]),
+        ...Array.from(activeAgents).flatMap((agent) => agent_surfaces_1.agentSurfaceRequiredFiles[agent]),
     ];
     for (const file of requiredFiles) {
         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 +955,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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-librarian",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Create and maintain compact project context for humans and LLM coding agents.",
   "license": "MIT",
   "type": "commonjs",
@@ -41,18 +41,31 @@
     "benchmark:ci": "npm run benchmark:ci-smoke",
     "benchmark:ci-smoke": "npm run benchmark:llm:parse-smoke && npm run benchmark:llm:dry-run",
     "benchmark:llm": "npm run build && node benchmarks/codex-llm-metrics.js",
+    "benchmark:llm:delta-analysis": "node benchmarks/tools/analyze-llm-deltas.js",
     "benchmark:llm:dry-run": "npm run build && node benchmarks/codex-llm-metrics.js --dry-run",
     "benchmark:llm:parse-smoke": "node tests/validators/codex-llm-benchmark-smoke.js",
+    "benchmark:llm:prune-raw": "node benchmarks/tools/prune-llm-raw.js",
+    "benchmark:llm:raw-audit": "node benchmarks/tools/audit-llm-raw.js",
     "benchmark:injection-sentinel": "node benchmarks/tools/injection-sentinel.js",
+    "benchmark:agent-surface-smoke": "node benchmarks/tools/agent-surface-smoke.js",
+    "benchmark:claim-ledger": "node benchmarks/tools/benchmark-claim-ledger.js benchmarks/llm/samples/codex-measured-report.json benchmarks/reports/llm/payload-preview.json",
     "benchmark:real-corpus:demo": "npm run build && node benchmarks/tools/real-corpus-offline-demo.js",
     "benchmark:release:preview": "npm run benchmark:llm -- --payload-preview benchmarks/reports/llm/payload-preview.json --sanitized-pack --full-matrix --runs 3 --warmup-runs 1 --min-runs-for-claim 3 --require-clean --require-claimable --model gpt-5.5",
+    "benchmark:release:diagnose": "npm run benchmark:llm -- --sanitized-pack --runs 1 --warmup-runs 0 --model gpt-5.5 --out benchmarks/reports/llm/diagnostic-current.json --markdown benchmarks/reports/llm/diagnostic-current.md",
     "benchmark:release": "npm run benchmark:llm -- --sanitized-pack --full-matrix --runs 3 --warmup-runs 1 --min-runs-for-claim 3 --require-clean --require-claimable --model gpt-5.5 --out benchmarks/reports/llm/current.json --markdown benchmarks/reports/llm/current.md",
     "build": "tsc && chmod +x dist/init-project-wiki.js",
+    "perf:code-efficiency": "node benchmarks/tools/code-performance-efficiency.js --full",
+    "release:check": "node benchmarks/tools/release-readiness.js",
     "typecheck": "tsc --noEmit",
+    "typecheck:ts7": "npx --yes -p typescript@rc tsc --noEmit --project tsconfig.json",
     "unit": "node --test tests/unit/*.test.js",
+    "test:coverage": "node --test --experimental-test-coverage --test-coverage-include=dist/**/*.js --test-coverage-include=benchmarks/**/*.js --test-coverage-lines=65 --test-coverage-branches=65 --test-coverage-functions=65 tests/unit/*.test.js",
     "test": "npm run build && npm run typecheck && npm run unit && bash tests/smoke.sh",
     "prepack": "npm run build"
   },
+  "dependencies": {
+    "typescript": "^6.0.3"
+  },
   "optionalDependencies": {
     "@sengac/tree-sitter": "^0.25.15",
     "@sengac/tree-sitter-c": "^0.25.15",
@@ -69,7 +82,6 @@
     "@sengac/tree-sitter-typescript": "^0.25.15"
   },
   "devDependencies": {
-    "@types/node": "^25.9.2",
-    "typescript": "^6.0.3"
+    "@types/node": "^25.9.2"
   }
 }