project-librarian 0.2.0 → 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;
@@ -42,8 +43,14 @@ exports.runIssueCreateMode = runIssueCreateMode;
 exports.runPruneCheckMode = runPruneCheckMode;
 exports.collectLinkDiagnostics = collectLinkDiagnostics;
 exports.collectQualityDiagnostics = collectQualityDiagnostics;
+exports.collectMigrationQualityDiagnostics = collectMigrationQualityDiagnostics;
+exports.collectMigrationLintDiagnostics = collectMigrationLintDiagnostics;
 exports.runLinkCheckMode = runLinkCheckMode;
 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"));
@@ -53,7 +60,9 @@ const path = __importStar(require("node:path"));
 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 scopedAutoIndexThreshold = 40;
 const scopedAutoIndexMarker = "<!-- PROJECT-WIKI-SCOPED-AUTO-INDEX -->";
 function isScopedAutoIndex(file) {
@@ -161,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")}
@@ -262,6 +291,7 @@ function issueDraftMarkdown() {
     const generatedFiles = existingFileList([
         "AGENTS.md",
         "CLAUDE.md",
+        "GEMINI.md",
         "wiki/AGENTS.md",
         "wiki/startup.md",
         "wiki/index.md",
@@ -269,6 +299,11 @@ function issueDraftMarkdown() {
         ".codex/hooks/wiki-session-start.js",
         ".claude/settings.json",
         ".claude/hooks/wiki-session-start.js",
+        ".cursor/rules/project-librarian.mdc",
+        ".cursor/hooks.json",
+        ".cursor/hooks/wiki-session-start.js",
+        ".gemini/settings.json",
+        ".gemini/hooks/wiki-session-start.js",
         ".githooks/prepare-commit-msg",
         ".githooks/wiki-commit-trailers.js",
     ]);
@@ -444,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",
@@ -462,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))
@@ -494,117 +530,75 @@ function collectLinkDiagnostics() {
             });
         }
     }
-    return diagnostics.sort((a, b) => a.severity.localeCompare(b.severity) || a.file.localeCompare(b.file) || a.code.localeCompare(b.code));
-}
-function legacyWikiRoots() {
-    if (!fs.existsSync(workspace_1.root))
-        return [];
-    return fs.readdirSync(workspace_1.root, { withFileTypes: true })
-        .filter((entry) => entry.isDirectory() && /^wiki_legacy(?:_|$)/.test(entry.name))
-        .map((entry) => entry.name)
-        .sort();
-}
-function normalizeMigrationCopyText(text) {
-    return (0, workspace_1.stripMetadataHeader)(text)
-        .replace(/<!--[\s\S]*?-->/g, " ")
-        .replace(/\r?\n/g, " ")
-        .replace(/\s+/g, " ")
-        .trim()
-        .toLowerCase();
-}
-function migrationCopyTokens(text) {
-    return normalizeMigrationCopyText(text).match(/[\p{L}\p{N}_./-]+/gu) ?? [];
-}
-function tokenOverlapScore(left, right) {
-    if (left.length === 0 || right.length === 0)
-        return 0;
-    const counts = new Map();
-    for (const token of right)
-        counts.set(token, (counts.get(token) ?? 0) + 1);
-    let overlap = 0;
-    for (const token of left) {
-        const count = counts.get(token) ?? 0;
-        if (count <= 0)
-            continue;
-        overlap += 1;
-        if (count === 1)
-            counts.delete(token);
-        else
-            counts.set(token, count - 1);
-    }
-    return overlap / Math.max(left.length, right.length);
-}
-function shouldGuardAgainstMigrationCopy(file, text) {
-    if (!/^wiki\/(?:canonical|decisions|sources)\//.test(file))
-        return false;
-    if (file.endsWith("/migration-inbox.md"))
-        return false;
-    const starter = templates_1.starterFiles[file];
-    return !starter || normalizeMigrationCopyText(starter) !== normalizeMigrationCopyText(text);
-}
-function migrationCopyDiagnostics(files) {
-    const roots = legacyWikiRoots();
-    if (roots.length === 0)
-        return [];
-    const guardedFiles = files.filter((file) => shouldGuardAgainstMigrationCopy(file, (0, workspace_1.read)(file)));
-    if (guardedFiles.length === 0)
-        return [];
-    const legacyEntries = roots
-        .flatMap((legacyRoot) => (0, wiki_files_1.walkMarkdownFiles)((0, workspace_1.abs)(legacyRoot), [], (0, workspace_1.abs)(legacyRoot)))
-        .map((legacyFile) => {
-        const text = (0, workspace_1.read)(legacyFile.path);
-        return {
-            file: legacyFile.path,
-            basePath: legacyFile.basePath,
-            basename: path.basename(legacyFile.basePath).toLowerCase(),
-            normalized: normalizeMigrationCopyText(text),
-            tokens: migrationCopyTokens(text),
-        };
-    })
-        .filter((entry) => entry.normalized.length >= 200);
-    const diagnostics = [];
-    for (const file of guardedFiles) {
-        const text = (0, workspace_1.read)(file);
-        const normalized = normalizeMigrationCopyText(text);
-        if (normalized.length < 200)
-            continue;
-        const tokens = migrationCopyTokens(text);
-        const basename = path.basename(file).toLowerCase();
-        const relativeWithinWiki = file.replace(/^wiki\//, "");
-        for (const legacy of legacyEntries) {
-            if (normalized === legacy.normalized) {
-                diagnostics.push({
-                    code: "migration-copy-risk",
-                    severity: "error",
-                    file,
-                    message: `body matches legacy document ${legacy.file}; rewrite project truth instead of copying legacy files`,
-                });
-                break;
-            }
-            if (tokens.length >= 80 && legacy.tokens.length >= 80) {
-                const score = tokenOverlapScore(tokens, legacy.tokens);
-                if (score >= 0.92) {
+    // 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: "migration-copy-risk",
-                        severity: "error",
+                        code: "router-unreachable",
+                        severity: "warn",
                         file,
-                        message: `body is ${Math.round(score * 100)}% token-similar to legacy document ${legacy.file}; rewrite and cite current-project evidence`,
+                        message: `linked only from pages that never connect to ${wiki_graph_1.wikiRouterRoot}; route it from wiki/index.md or a scoped router`,
                     });
-                    break;
                 }
             }
-            if (relativeWithinWiki === legacy.basePath || basename === legacy.basename) {
+            else if (depth > wiki_graph_1.wikiRouterDepthBudget) {
                 diagnostics.push({
-                    code: "migration-filename-reuse",
+                    code: "router-depth-exceeded",
                     severity: "warn",
                     file,
-                    message: `filename also exists in legacy document ${legacy.file}; verify this is a rewrite, not a file copy`,
+                    message: `reachable from ${wiki_graph_1.wikiRouterRoot} only at depth ${depth} (budget ${wiki_graph_1.wikiRouterDepthBudget}); add a shorter route`,
                 });
-                break;
             }
         }
     }
-    return diagnostics;
+    return diagnostics.sort((a, b) => a.severity.localeCompare(b.severity) || a.file.localeCompare(b.file) || a.code.localeCompare(b.code));
+}
+function legacyWikiRoots() {
+    if (!fs.existsSync(workspace_1.root))
+        return [];
+    return fs.readdirSync(workspace_1.root, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && /^wiki_legacy(?:_|$)/.test(entry.name))
+        .map((entry) => entry.name)
+        .sort();
+}
+function shouldGuardAgainstLegacyReference(file) {
+    if (!/^wiki\/(?:canonical|decisions|sources)\//.test(file))
+        return false;
+    return !file.endsWith("/migration-inbox.md");
+}
+function migrationLegacyReferenceDiagnostics(files) {
+    return files
+        .filter(shouldGuardAgainstLegacyReference)
+        .filter((file) => /\bwiki_legacy(?:_|\b|\/)/.test((0, workspace_1.stripMetadataHeader)((0, workspace_1.read)(file))))
+        .map((file) => ({
+        code: "migration-legacy-reference",
+        severity: "error",
+        file,
+        message: "new project truth must not link to or cite wiki_legacy*; migrate the meaning or keep unresolved material in migration inboxes",
+    }));
 }
 function collectQualityDiagnostics() {
     const diagnostics = [];
@@ -650,9 +644,41 @@ function collectQualityDiagnostics() {
             }
         }
     }
-    diagnostics.push(...migrationCopyDiagnostics(files));
     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 collectMigrationLintDiagnostics() {
+    if (legacyWikiRoots().length === 0)
+        return [];
+    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/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) => ({
+        code: "migration-missing-file",
+        severity: "error",
+        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)());
+    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);
     if (!ok)
@@ -663,6 +689,89 @@ function runQualityCheckMode() {
     if (!ok)
         process.exit(1);
 }
+function runMigrationQualityCheckMode() {
+    const ok = printDiagnostics("Project wiki migration quality-check", collectMigrationQualityDiagnostics(), (0, wiki_files_1.wikiMarkdownFiles)().length);
+    if (!ok)
+        process.exit(1);
+}
+function runMigrationLintMode() {
+    const ok = printDiagnostics("Project wiki migration lint", collectMigrationLintDiagnostics(), (0, wiki_files_1.wikiMarkdownFiles)().length);
+    if (!ok)
+        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);
+    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");
@@ -677,34 +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",
-        "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",
+        ...commonLintRequiredFiles,
+        ...Array.from(activeAgents).flatMap((agent) => agentLintRequiredFiles[agent]),
     ];
     for (const file of requiredFiles) {
         if (!(0, workspace_1.exists)(file))
@@ -735,6 +855,13 @@ function runLintMode() {
         warnings.push("root AGENTS.md should point detailed wiki editing rules to wiki/AGENTS.md");
     if ((0, workspace_1.exists)("CLAUDE.md") && !(0, workspace_1.read)("CLAUDE.md").includes("@AGENTS.md"))
         errors.push("CLAUDE.md should import AGENTS.md for Claude Code compatibility");
+    if ((0, workspace_1.exists)("GEMINI.md") && !(0, workspace_1.read)("GEMINI.md").includes("@AGENTS.md"))
+        errors.push("GEMINI.md should import AGENTS.md for Gemini CLI compatibility");
+    if ((0, workspace_1.exists)(".cursor/rules/project-librarian.mdc")) {
+        const cursorRule = (0, workspace_1.read)(".cursor/rules/project-librarian.mdc");
+        if (!cursorRule.includes("alwaysApply: true") || !cursorRule.includes("@AGENTS.md"))
+            errors.push("Cursor project rule should always apply and reference AGENTS.md");
+    }
     if ((0, workspace_1.exists)("wiki/AGENTS.md") && !(0, workspace_1.read)("wiki/AGENTS.md").includes("Language policy"))
         warnings.push("wiki/AGENTS.md is missing language policy");
     for (const legacyFile of ["wiki/canonical/wiki-operating-model.md", "wiki/canonical/decision-policy.md", "wiki/decisions/wiki-v1-decisions.md"]) {
@@ -751,6 +878,16 @@ function runLintMode() {
         if (!hook.includes('["wiki/startup.md", 3500]') || !hook.includes('["wiki/index.md", 4500]'))
             errors.push("Claude startup hook does not clearly inject only startup/index with expected budgets");
     }
+    if ((0, workspace_1.exists)(".cursor/hooks/wiki-session-start.js")) {
+        const hook = (0, workspace_1.read)(".cursor/hooks/wiki-session-start.js");
+        if (!hook.includes('["wiki/startup.md", 3500]') || !hook.includes('["wiki/index.md", 4500]') || !hook.includes("additional_context"))
+            errors.push("Cursor startup hook does not clearly inject startup/index through additional_context");
+    }
+    if ((0, workspace_1.exists)(".gemini/hooks/wiki-session-start.js")) {
+        const hook = (0, workspace_1.read)(".gemini/hooks/wiki-session-start.js");
+        if (!hook.includes('["wiki/startup.md", 3500]') || !hook.includes('["wiki/index.md", 4500]') || !hook.includes("hookSpecificOutput"))
+            errors.push("Gemini startup hook does not clearly inject startup/index through hookSpecificOutput");
+    }
     if ((0, workspace_1.exists)(".claude/settings.json")) {
         const command = "node .claude/hooks/wiki-session-start.js";
         try {
@@ -772,6 +909,44 @@ function runLintMode() {
             errors.push(message);
         }
     }
+    if ((0, workspace_1.exists)(".cursor/hooks.json")) {
+        const command = "node .cursor/hooks/wiki-session-start.js";
+        try {
+            const settings = (0, workspace_1.parseJson)(".cursor/hooks.json", { version: 1, hooks: {} });
+            if (!settings.hooks || typeof settings.hooks !== "object" || Array.isArray(settings.hooks)) {
+                throw new Error(".cursor/hooks.json has invalid hooks object");
+            }
+            const sessionStart = settings.hooks.sessionStart ?? [];
+            if (!Array.isArray(sessionStart) || !sessionStart.some((hook) => hook?.command === command)) {
+                errors.push(".cursor/hooks.json is missing the project wiki sessionStart hook");
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            errors.push(message);
+        }
+    }
+    if ((0, workspace_1.exists)(".gemini/settings.json")) {
+        const command = 'node "$GEMINI_PROJECT_DIR/.gemini/hooks/wiki-session-start.js"';
+        try {
+            const settings = (0, workspace_1.parseJson)(".gemini/settings.json", { hooks: {} });
+            if (!settings.hooks || typeof settings.hooks !== "object" || Array.isArray(settings.hooks)) {
+                throw new Error(".gemini/settings.json has invalid hooks object");
+            }
+            const sessionStart = settings.hooks.SessionStart ?? [];
+            const configuredMatchers = new Set(sessionStart
+                .filter((entry) => Array.isArray(entry.hooks) && entry.hooks.some((hook) => hook.command === command))
+                .map((entry) => entry.matcher));
+            for (const matcher of ["startup", "resume", "clear"]) {
+                if (!configuredMatchers.has(matcher))
+                    errors.push(`.gemini/settings.json is missing the project wiki SessionStart hook for ${matcher}`);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            errors.push(message);
+        }
+    }
     for (const file of [".githooks/prepare-commit-msg", ".githooks/wiki-commit-trailers.js"]) {
         if ((0, workspace_1.exists)(file) && (fs.statSync((0, workspace_1.abs)(file)).mode & 0o111) === 0)
             errors.push(`${file} is not executable`);