project-librarian 0.5.9 → 0.6.1

package/README.ko.md

@@ -41,7 +41,7 @@ npx project-librarian@latest install --scope project --agents all
 npx project-librarian@latest update
 ```
 
-이 명령은 관리 설정 파일, 에이전트 훅, 위키 운영/메타 파일, 기존 프로젝트 범위 스킬 복사본을 갱신합니다. 현재 `wiki/`는 보존하고 migration flag는 거부하므로 위키를 `wiki_legacy*`로 바꾸지 않습니다.
+이 명령은 관리 설정 파일, 에이전트 훅, 위키 운영/메타 파일, 기존 프로젝트 범위 스킬 복사본을 갱신합니다. 기존 공유 `.agents/skills/project-librarian/` 복사본도 특정 에이전트 설정 표면을 암묵적으로 추가하지 않고 갱신합니다. 현재 `wiki/`는 보존하고 migration flag는 거부하므로 위키를 `wiki_legacy*`로 바꾸지 않습니다.
 
 특정 프로젝트 표면을 의도적으로 추가하거나 갱신할 때는 `--agents`를 명시합니다.
 
@@ -77,9 +77,9 @@ Project Librarian은 작은 첫 읽기와 더 깊은 정본으로 가는 경로
 - **첫 읽기를 작게.** 시작 훅은 `wiki/startup.md`와 `wiki/index.md`만 주입하고, 에이전트는 필요할 때 더 깊은 페이지로 이동합니다.
 - **한 번 설정, 네 에이전트.** Codex, Claude Code, Cursor, Gemini CLI가 같은 저장소 로컬 기억 계약을 공유합니다.
 - **구조적인 위키 작성.** 새 프로젝트 내용은 작성하거나 취합하기 전에 분류하므로 PRD, 정책, UX, 데이터, API, QA, 릴리즈, 운영 메모가 하나의 잡다한 페이지로 합쳐지지 않습니다.
-- **검토 가능한 위키 그래프.** `--wiki-visualize`는 시작 컨텍스트를 늘리지 않고 `.project-wiki/` 아래에 정적 HTML 그래프를 작성합니다.
 - **측정된 주장.** 벤치마크에서 이긴 경우와 손해를 본 경우를 주장 경계와 함께 공개합니다.
 - **로컬 세션 핸드오프.** `--handoff-save`는 `.project-wiki/session/` 아래에 생성형 재개 메모를 저장하되 실행 기억을 프로젝트 정본으로 바꾸지 않습니다.
+- **답변형 위키 토폴로지.** `--wiki-impact`, `--wiki-neighborhood`, topology diagnostics가 graph visualizer 없이 backlinks, decision 근거, router depth, 가까운 읽기 순서를 노출합니다.
 - **선택적 코드 근거.** SQLite 인덱스와 답변 형태 MCP 도구가 큰 저장소의 비싼 탐색 질문에 답하며, MCP SDK 의존성은 추가하지 않습니다.
 - **다시 실행해도 안전.** 부트스트랩은 멱등하고 기존 내용 보존을 우선합니다.
 
@@ -94,6 +94,7 @@ Project Librarian은 작은 첫 읽기와 더 깊은 정본으로 가는 경로
 | 기존 문서/위키 마이그레이션 | "Project Librarian으로 기존 docs/wiki 내용을 마이그레이션해줘." |
 | 진단 실행 | "Project Librarian 진단을 실행해줘." |
 | 프로젝트 기억 검색 | "Project Librarian 위키에서 authentication decisions를 찾아줘." |
+| 가까운 위키 맥락 찾기 | "canonical/project-brief의 Project Librarian wiki neighborhood를 보여줘." |
 | 코드 근거 구축 | "Project Librarian 코드 근거를 `src`에 대해 구축해줘." |
 | 코드 영향 확인 | "`healthHandler`에 대한 Project Librarian 영향 근거를 보여줘." |
 | 세션 핸드오프 저장 | "현재 작업에 대한 Project Librarian 세션 핸드오프를 저장해줘." |

package/README.md

@@ -41,7 +41,7 @@ To refresh an existing setup without migrating the wiki, run:
 npx project-librarian@latest update
 ```
 
-That updates managed setup files, agent hooks, wiki operating/meta files, and existing project-scoped skill copies. It preserves the current `wiki/` and rejects migration flags, so it will not rename the wiki to `wiki_legacy*`.
+That updates managed setup files, agent hooks, wiki operating/meta files, and existing project-scoped skill copies. Existing shared `.agents/skills/project-librarian/` copies are refreshed without implying any agent-specific setup surface. It preserves the current `wiki/` and rejects migration flags, so it will not rename the wiki to `wiki_legacy*`.
 
 Use `--agents` when you intentionally want to add or refresh a specific project surface:
 
@@ -77,9 +77,9 @@ The core idea is not "write more docs." It is "keep the first agent read small,
 - **Small first read.** Startup hooks inject only `wiki/startup.md` and `wiki/index.md`; agents route to deeper pages on demand.
 - **One setup, four agents.** Codex, Claude Code, Cursor, and Gemini CLI share the same repo-local memory contract.
 - **Structured wiki writing.** New project content is classified before it is written or consolidated, so PRDs, policies, UX, data, APIs, QA, release, and operations notes do not collapse into one catch-all page.
-- **Inspectable wiki graph.** `--wiki-visualize` writes a static HTML graph under `.project-wiki/` without adding to startup context.
 - **Measured claims.** Benchmark wins and losses are published together, with claim boundaries attached.
 - **Local session handoff.** `--handoff-save` stores generated resume notes under `.project-wiki/session/` without turning execution memory into canonical project truth.
+- **Answer-shaped wiki topology.** `--wiki-impact`, `--wiki-neighborhood`, and topology diagnostics expose backlinks, decision evidence, router depth, and nearby read order without a graph visualizer.
 - **Optional code evidence.** A SQLite index plus answer-shaped MCP tools answer expensive traversal questions on large repositories without adding an MCP SDK dependency.
 - **Safe to re-run.** Bootstrap is idempotent and preservation-first.
 
@@ -94,6 +94,7 @@ Ask your agent for the outcome you want; the installed skill maps the request to
 | Migrate existing docs/wiki content | "Use Project Librarian to migrate the existing docs/wiki content." |
 | Run diagnostics | "Run Project Librarian diagnostics." |
 | Search project memory | "Search the Project Librarian wiki for authentication decisions." |
+| Find nearby wiki context | "Show Project Librarian wiki neighborhood for canonical/project-brief." |
 | Build code evidence | "Build Project Librarian code evidence for `src`." |
 | Inspect code impact | "Show Project Librarian impact evidence for `healthHandler`." |
 | Save a handoff | "Save a Project Librarian session handoff for the current work." |

package/SKILL.md

@@ -37,6 +37,7 @@ Supported actions:
 Prefer an already installed local runner over network package execution:
 
 - In the project-librarian source repository, use `node dist/init-project-wiki.js` when `dist/init-project-wiki.js` exists.
+- In a target repository with a shared project-scoped skill install, use `node .agents/skills/project-librarian/dist/init-project-wiki.js`.
 - In a target repository with a project-scoped Codex skill install, use `node .codex/skills/project-librarian/dist/init-project-wiki.js`.
 - In a target repository with a project-scoped Claude skill install, use `node .claude/skills/project-librarian/dist/init-project-wiki.js`.
 - In a target repository with a project-scoped Cursor skill install, use `node .cursor/skills/project-librarian/dist/init-project-wiki.js`.

package/dist/agent-surfaces.js

@@ -20,6 +20,7 @@ const agentSurfaceProjectSkillFiles = {
     gemini: [".gemini/skills/project-librarian/SKILL.md"],
 };
 const projectLibrarianCommonInstallFiles = [
+    ".agents/skills/project-librarian/SKILL.md",
     "wiki/startup.md",
     "wiki/index.md",
     "wiki/AGENTS.md",

package/dist/args.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.codeIndexMode = exports.acknowledgeSmallRepoMode = exports.noGitConfigMode = exports.reviewMigrationMode = exports.pruneCheckStrictMode = exports.pruneCheckMode = exports.captureInboxMode = exports.refreshIndexMode = exports.issueDraftMode = exports.issueCreateMode = exports.handoffVerification = exports.handoffStatusMode = exports.handoffState = exports.handoffShowMode = exports.handoffSaveMode = exports.handoffPromoteInboxMode = exports.handoffInjectionStatusMode = exports.handoffInjectionEnableMode = exports.handoffInjectionDisableMode = exports.handoffOpenQuestions = exports.handoffNextActions = exports.handoffLastSuccessCommand = exports.handoffLastFailureCommand = exports.handoffInputMode = exports.handoffGoal = exports.handoffDecisions = exports.handoffClearMode = exports.handoffBlocked = exports.glossaryMode = exports.fixMode = exports.doctorMode = exports.qualityCheckMode = exports.linkCheckMode = exports.migrationQualityCheckMode = exports.migrationLintMode = exports.migrationDoctorMode = exports.lintMode = exports.migrateMode = exports.invalidAgentTargets = exports.missingValueOptions = exports.unexpectedValueOptions = exports.unknownOptions = exports.args = exports.commandArgs = exports.command = exports.unknownCommand = exports.helpMode = exports.agentTargets = exports.parsedArgs = exports.rawArgs = void 0;
-exports.issueDraftTitle = exports.issueBodyFile = exports.captureCategory = exports.captureContent = exports.captureTitle = exports.codeIndexScopes = exports.codeParser = exports.codeIndexOutput = exports.codeSearchSymbol = exports.codeReportSection = exports.codeQuerySql = exports.codeImpactTarget = exports.codeContextPackTarget = exports.wikiVisualizeOutput = exports.wikiVisualizeMode = exports.wikiImpactTarget = exports.wikiImpactMode = exports.queryTerm = exports.codeSearchSymbolMode = exports.codeQueryMode = exports.codeImpactMode = exports.codeParserMode = exports.codeContextPackMode = exports.codeFilesMode = exports.codeStatusMode = exports.codeReportMode = exports.codeIndexHealthMode = exports.codeIndexFullMode = exports.codeIndexMigrateMode = exports.codeIndexIncrementalMode = exports.codeIndexEngineMode = exports.codeIndexEngine = void 0;
+exports.issueDraftTitle = exports.issueBodyFile = exports.captureCategory = exports.captureContent = exports.captureTitle = exports.codeIndexScopes = exports.codeParser = exports.codeIndexOutput = exports.codeSearchSymbol = exports.codeReportSection = exports.codeQuerySql = exports.codeImpactTarget = exports.codeContextPackTarget = exports.wikiNeighborhoodTarget = exports.wikiNeighborhoodMode = exports.wikiImpactTarget = exports.wikiImpactMode = exports.queryTerm = exports.codeSearchSymbolMode = exports.codeQueryMode = exports.codeImpactMode = exports.codeParserMode = exports.codeContextPackMode = exports.codeFilesMode = exports.codeStatusMode = exports.codeReportMode = exports.codeIndexHealthMode = exports.codeIndexFullMode = exports.codeIndexMigrateMode = exports.codeIndexIncrementalMode = exports.codeIndexEngineMode = exports.codeIndexEngine = void 0;
 exports.parseArgs = parseArgs;
 exports.argValue = argValue;
 exports.argValues = argValues;
@@ -72,10 +72,8 @@ const flagDefinitions = [
     { name: "--review-migration", value: "none", aliases: ["--semantic-migrate"] },
     { name: "--scope", value: "value" },
     { name: "--title", value: "value" },
-    { name: "--wiki-graph-html", value: "none" },
     { name: "--wiki-impact", value: "value" },
-    { name: "--wiki-visualize", value: "none" },
-    { name: "--wiki-visualize-out", value: "value" },
+    { name: "--wiki-neighborhood", value: "value" },
 ];
 function definitionNames(definition) {
     return [definition.name, ...(definition.aliases ?? [])];
@@ -156,6 +154,7 @@ function parseArgs(argv) {
     const codeContextPackTarget = argValueFromAny("--code-context-pack");
     const codeQuerySql = argValueFromAny("--code-query");
     const codeSearchSymbol = argValueFromAny("--code-search-symbol");
+    const wikiNeighborhoodTarget = argValue("--wiki-neighborhood");
     const parsedAgentTargets = (0, agent_surfaces_1.parseAgentSurfaceValues)(argValues("--agents"));
     const handoffInputMode = [
         "--blocked",
@@ -254,8 +253,8 @@ function parseArgs(argv) {
             .filter((arg) => !knownFlags.has(arg)))),
         wikiImpactMode: hasFlag("--wiki-impact"),
         wikiImpactTarget: argValue("--wiki-impact"),
-        wikiVisualizeMode: hasFlag("--wiki-visualize") || hasFlag("--wiki-graph-html"),
-        wikiVisualizeOutput: argValue("--wiki-visualize-out"),
+        wikiNeighborhoodMode: hasFlag("--wiki-neighborhood"),
+        wikiNeighborhoodTarget,
     };
 }
 exports.parsedArgs = parseArgs(exports.rawArgs);
@@ -330,8 +329,8 @@ function argValues(name) {
 exports.queryTerm = exports.parsedArgs.queryTerm;
 exports.wikiImpactMode = exports.parsedArgs.wikiImpactMode;
 exports.wikiImpactTarget = exports.parsedArgs.wikiImpactTarget;
-exports.wikiVisualizeMode = exports.parsedArgs.wikiVisualizeMode;
-exports.wikiVisualizeOutput = exports.parsedArgs.wikiVisualizeOutput;
+exports.wikiNeighborhoodMode = exports.parsedArgs.wikiNeighborhoodMode;
+exports.wikiNeighborhoodTarget = exports.parsedArgs.wikiNeighborhoodTarget;
 exports.codeContextPackTarget = exports.parsedArgs.codeContextPackTarget;
 exports.codeImpactTarget = exports.parsedArgs.codeImpactTarget;
 exports.codeQuerySql = exports.parsedArgs.codeQuerySql;

package/dist/hooks.js

@@ -149,6 +149,7 @@ const mcpServerName = "project-librarian";
 // runner wins; absent any local install we register the published binary.
 const localRunnerCandidates = [
     "tools/project-librarian/dist/init-project-wiki.js",
+    ".agents/skills/project-librarian/dist/init-project-wiki.js",
     ".codex/skills/project-librarian/dist/init-project-wiki.js",
     ".claude/skills/project-librarian/dist/init-project-wiki.js",
     ".cursor/skills/project-librarian/dist/init-project-wiki.js",
@@ -458,7 +459,7 @@ function wikiScope(files) {
     else if (file.startsWith(".gemini/hooks/") || file === ".gemini/settings.json") add("gemini-hooks");
     else if (file === "AGENTS.md" || file === "CLAUDE.md" || file === "GEMINI.md") add("agents");
     else if (file.startsWith(".githooks/")) add("git-hooks");
-    else if (file.startsWith("tools/project-librarian/")) add("skill");
+    else if (file.startsWith("tools/project-librarian/") || file.startsWith(".agents/skills/project-librarian/")) add("skill");
   }
   return scopes.length === 0 ? "none" : scopes.join(", ");
 }
@@ -467,6 +468,7 @@ function validationTrailers() {
   const home = process.env.HOME || "";
   const lintScript = [
     "tools/project-librarian/dist/init-project-wiki.js",
+    ".agents/skills/project-librarian/dist/init-project-wiki.js",
     path.join(home, ".codex/skills/project-librarian/dist/init-project-wiki.js"),
     path.join(home, ".claude/skills/project-librarian/dist/init-project-wiki.js"),
     path.join(home, ".cursor/skills/project-librarian/dist/init-project-wiki.js"),
@@ -517,7 +519,8 @@ const wikiFiles = staged.filter((file) => {
     || file === ".gemini/settings.json"
     || file.startsWith(".gemini/hooks/")
     || file.startsWith(".githooks/")
-    || file.startsWith("tools/project-librarian/");
+    || file.startsWith("tools/project-librarian/")
+    || file.startsWith(".agents/skills/project-librarian/");
 });
 
 if (wikiFiles.length === 0) process.exit(0);

package/dist/init-project-wiki.js

@@ -9,7 +9,6 @@ const modes_1 = require("./modes");
 const migration_1 = require("./migration");
 const session_handoff_1 = require("./session-handoff");
 const templates_1 = require("./templates");
-const wiki_visualizer_1 = require("./wiki-visualizer");
 const workspace_1 = require("./workspace");
 function codeIndex() {
     return require("./code-index");
@@ -37,8 +36,8 @@ Options:
   --dry-run                        With install, preview copied skill files without writing them.
   --query <terms>                  Search wiki paths, metadata, titles, and bodies (answer-shaped, capped output).
   --wiki-impact <page-or-term>     Show wiki backlinks, decision_ref citations, and router depth for matching pages.
-  --wiki-visualize                 Write a static wiki graph visualizer to .project-wiki/wiki-graph.html.
-  --wiki-visualize-out <path>      With --wiki-visualize, write under a custom .project-wiki/ path.
+  --wiki-neighborhood <page-or-term>
+                                    Show a bounded read order for nearby wiki pages.
   --refresh-index                  Update the managed auto-discovered wiki index block.
   --capture-inbox                  Append a candidate note with --title, --content, and optional --category.
   --handoff-save                   Save local generated session handoff state under .project-wiki/session/.
@@ -147,10 +146,6 @@ if (args_1.codeReportSection && !args_1.codeReportMode) {
     console.error("--code-report-section is only supported with --code-report.");
     process.exit(1);
 }
-if (args_1.wikiVisualizeOutput && !args_1.wikiVisualizeMode) {
-    console.error("--wiki-visualize-out is only supported with --wiki-visualize.");
-    process.exit(1);
-}
 if (args_1.pruneCheckStrictMode && !args_1.pruneCheckMode) {
     console.error("--prune-check-strict is only supported with --prune-check.");
     process.exit(1);
@@ -266,16 +261,9 @@ function runInitCommand() {
         exitAfterStdoutDrain(0);
         return;
     }
-    if (args_1.wikiVisualizeMode) {
-        try {
-            const output = (0, wiki_visualizer_1.writeWikiVisualizer)(args_1.wikiVisualizeOutput);
-            console.log(`Project wiki visualizer written: ${output}`);
-            exitAfterStdoutDrain(0);
-        }
-        catch (error) {
-            console.error(error instanceof Error ? error.message : String(error));
-            process.exit(1);
-        }
+    if (args_1.wikiNeighborhoodMode) {
+        (0, modes_1.runWikiNeighborhoodMode)();
+        exitAfterStdoutDrain(0);
         return;
     }
     if (args_1.queryTerm) {
@@ -340,6 +328,7 @@ function runInitCommand() {
     const projectSkillSyncSurfaces = args_1.command === "update"
         ? (0, install_skill_1.installedProjectSkillSurfaces)().filter((surface) => (0, agent_surfaces_1.includesAgentSurface)(selectedAgentSurfaces, surface))
         : [];
+    const syncSharedProjectSkill = args_1.command === "update" && (0, install_skill_1.hasSharedProjectSkillInstall)();
     const shouldWriteSurface = (surface) => (0, agent_surfaces_1.includesAgentSurface)(selectedAgentSurfaces, surface);
     const writeCodexSurface = shouldWriteSurface("codex");
     const writeClaudeSurface = shouldWriteSurface("claude");
@@ -369,6 +358,10 @@ function runInitCommand() {
         for (const result of (0, install_skill_1.syncProjectSkillInstall)(surface))
             results.push(result);
     }
+    if (syncSharedProjectSkill) {
+        for (const result of (0, install_skill_1.syncSharedProjectSkillInstall)())
+            results.push(result);
+    }
     // B1 fallback: sync the CURRENT startup.md TL;DR into the managed AGENTS.md block
     // so non-interactive `codex exec` (which does not run SessionStart hooks) still
     // gets compact startup context. Routers are starter files written later in this

package/dist/install-skill.js

@@ -34,8 +34,11 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.projectSkillTarget = projectSkillTarget;
+exports.sharedProjectSkillTarget = sharedProjectSkillTarget;
 exports.installedProjectSkillSurfaces = installedProjectSkillSurfaces;
+exports.hasSharedProjectSkillInstall = hasSharedProjectSkillInstall;
 exports.syncProjectSkillInstall = syncProjectSkillInstall;
+exports.syncSharedProjectSkillInstall = syncSharedProjectSkillInstall;
 exports.runInstallSkillMode = runInstallSkillMode;
 const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
@@ -43,6 +46,7 @@ const path = __importStar(require("node:path"));
 const agent_surfaces_1 = require("./agent-surfaces");
 const args_1 = require("./args");
 const skillName = "project-librarian";
+const sharedProjectSkillRelativeRoot = path.join(".agents", "skills", skillName);
 const packageFiles = [
     "SKILL.md",
     "dist",
@@ -121,6 +125,9 @@ function projectSkillRelativeRoot(agent) {
 function projectSkillTarget(agent) {
     return path.join(process.cwd(), projectSkillRelativeRoot(agent));
 }
+function sharedProjectSkillTarget() {
+    return path.join(process.cwd(), sharedProjectSkillRelativeRoot);
+}
 function installTarget(agent, scope) {
     const base = scope === "user" ? userAgentRoot(agent) : path.join(process.cwd(), projectAgentRoot(agent));
     return path.join(base, "skills", skillName);
@@ -247,6 +254,9 @@ function copyPath(source, target, targetRoot, dryRun) {
 function installedProjectSkillSurfaces() {
     return agent_surfaces_1.allAgentSurfaces.filter((agent) => fs.existsSync(path.join(projectSkillTarget(agent), "SKILL.md")));
 }
+function hasSharedProjectSkillInstall() {
+    return fs.existsSync(path.join(sharedProjectSkillTarget(), "SKILL.md"));
+}
 function copyPackageFiles(targetRoot, dryRun, labelRoot = targetRoot) {
     const root = packageRoot();
     const packageRows = packageFiles.map((relativePath) => {
@@ -269,6 +279,13 @@ function syncProjectSkillInstall(agent) {
         return [label, status];
     });
 }
+function syncSharedProjectSkillInstall() {
+    return copyPackageFiles(sharedProjectSkillTarget(), false, sharedProjectSkillRelativeRoot).map(([label, status]) => {
+        if (status === "dry-run")
+            throw new Error("shared project skill sync does not support dry-run status");
+        return [label, status];
+    });
+}
 function runInstallSkillMode() {
     const scope = installScope();
     const agents = installAgents();

package/dist/modes.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildRefreshIndexBlock = buildRefreshIndexBlock;
 exports.runQueryMode = runQueryMode;
 exports.runWikiImpactMode = runWikiImpactMode;
+exports.runWikiNeighborhoodMode = runWikiNeighborhoodMode;
 exports.projectCandidatesContent = projectCandidatesContent;
 exports.appendProjectCandidate = appendProjectCandidate;
 exports.appendCaptureInbox = appendCaptureInbox;
@@ -325,6 +326,14 @@ function runWikiImpactMode() {
     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 runWikiNeighborhoodMode() {
+    if (!args_1.wikiNeighborhoodTarget.trim()) {
+        console.error("missing wiki neighborhood target: use --wiki-neighborhood \"page-or-term\"");
+        process.exit(1);
+    }
+    const corpus = (0, wiki_corpus_1.loadWikiCorpus)();
+    console.log((0, wiki_graph_1.wikiNeighborhoodAnswer)(corpus.pages, args_1.wikiNeighborhoodTarget.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")}
 # Project Candidates Inbox
@@ -699,6 +708,7 @@ function collectLinkDiagnostics(corpus = (0, wiki_corpus_1.loadWikiCorpus)()) {
             }
         }
     }
+    diagnostics.push(...(0, wiki_diagnostics_1.collectTopologyDiagnostics)(corpus));
     return diagnostics.sort((a, b) => a.severity.localeCompare(b.severity) || a.file.localeCompare(b.file) || a.code.localeCompare(b.code));
 }
 function legacyWikiRoots() {
@@ -725,9 +735,10 @@ function migrationLegacyReferenceDiagnostics(files, corpus) {
         message: "new project truth must not link to or cite wiki_legacy*; migrate the meaning or keep unresolved material in migration inboxes",
     }));
 }
-function collectQualityDiagnostics(corpus = (0, wiki_corpus_1.loadWikiCorpus)()) {
+function collectQualityDiagnostics(corpus = (0, wiki_corpus_1.loadWikiCorpus)(), options = {}) {
     const diagnostics = [];
     const files = corpus.files;
+    const currentDate = options.today ?? workspace_1.today;
     const titles = new Map();
     for (const file of files) {
         const text = (0, wiki_corpus_1.wikiCorpusText)(corpus, file);
@@ -742,7 +753,7 @@ function collectQualityDiagnostics(corpus = (0, wiki_corpus_1.loadWikiCorpus)())
         if (tldrExpected && !/##\s+TL;DR/.test(body)) {
             diagnostics.push({ code: "missing-tldr", severity: "warn", file, message: "add a compact TL;DR near the top" });
         }
-        const reviewAge = updated ? (0, wiki_diagnostics_1.staleReviewAge)(updated, workspace_1.today) : null;
+        const reviewAge = updated ? (0, wiki_diagnostics_1.staleReviewAge)(updated, currentDate) : 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}` });
         }

package/dist/native/project-librarian-indexer-manifest.json

@@ -21,39 +21,39 @@
       "architecture": "arm64",
       "format": "elf",
       "path": "dist/native/linux-arm64/project-librarian-indexer",
-      "sha256": "f3cc884acca4f5863fb6a6545a4a9f9a37a67872bfe780f4b14f0c4a8a667f16",
-      "size": 3065520,
+      "sha256": "88146d5bbe5b77bb53e2cbe872ad6d2a8a93a58fa1b53671841cc94463443f46",
+      "size": 3065568,
       "triple": "linux-arm64"
     },
     {
       "architecture": "arm64",
       "format": "elf",
       "path": "dist/native/linux-arm64-musl/project-librarian-indexer",
-      "sha256": "80f7440c4d115d05805b63b8118a172ddeb5a374b7154593e5b1d0b804a938ae",
-      "size": 3100816,
+      "sha256": "bcb48020ae87fe3e5ebd6a8d986a91f83e67e5d69c4df9357a7c3a6c78c232b0",
+      "size": 3101344,
       "triple": "linux-arm64-musl"
     },
     {
       "architecture": "x64",
       "format": "elf",
       "path": "dist/native/linux-x64/project-librarian-indexer",
-      "sha256": "3d93408db344567d7de6f477b58fdaf6aba19c943336fb7ab9720e3e9fa68c31",
-      "size": 3110832,
+      "sha256": "22d32884276c23c4597bd611facd5880936b29600c8331bb3d585d2ab370a206",
+      "size": 3110688,
       "triple": "linux-x64"
     },
     {
       "architecture": "x64",
       "format": "elf",
       "path": "dist/native/linux-x64-musl/project-librarian-indexer",
-      "sha256": "0055ec9fefa385d6d637fa1e457308c38f892e0fbdb389db3fcbdf546f0daca8",
-      "size": 3247400,
+      "sha256": "811221a87fe5d8ef9f67f4eafe4386ef7aa03bdc1601e89fa191c0e0d7b0dcd5",
+      "size": 3247424,
       "triple": "linux-x64-musl"
     },
     {
       "architecture": "arm64",
       "format": "pe",
       "path": "dist/native/win32-arm64/project-librarian-indexer.exe",
-      "sha256": "f8ef16c98ff97c4f1dd38e2e08a034a40bb219f114f8270d165feaddd8166d8f",
+      "sha256": "69aeecd89d8ec8e7e4e85adfdf15cd682df9eaa14b8e6d0e99f445eeb70e6267",
       "size": 2098688,
       "triple": "win32-arm64"
     },
@@ -61,7 +61,7 @@
       "architecture": "x64",
       "format": "pe",
       "path": "dist/native/win32-x64/project-librarian-indexer.exe",
-      "sha256": "5a81b330741f11d10ab5d296e8cbc8c60f1596c30a45c5f31e41fab49e5b2603",
+      "sha256": "ae493dbea6ddd4cd6831ad9a21db07df0c6e2989602e6048dfbfa9aa1eb80ee5",
       "size": 2375680,
       "triple": "win32-x64"
     }

package/dist/wiki-diagnostics.js

@@ -1,8 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.staleReviewAgeDays = void 0;
+exports.topologyFanoutThreshold = exports.topologyHubOverloadThreshold = exports.staleReviewAgeDays = void 0;
 exports.staleReviewAge = staleReviewAge;
+exports.collectTopologyDiagnostics = collectTopologyDiagnostics;
+const wiki_corpus_1 = require("./wiki-corpus");
+const wiki_graph_1 = require("./wiki-graph");
+const workspace_1 = require("./workspace");
 exports.staleReviewAgeDays = 30;
+exports.topologyHubOverloadThreshold = 60;
+exports.topologyFanoutThreshold = 8;
 function dateOnlyMillis(value) {
     if (!/^\d{4}-\d{2}-\d{2}$/.test(value))
         return null;
@@ -17,3 +23,107 @@ function staleReviewAge(updated, currentDate) {
     const ageDays = Math.floor((currentMillis - updatedMillis) / 86_400_000);
     return ageDays > exports.staleReviewAgeDays ? ageDays : null;
 }
+function uniqueExisting(values, fileSet) {
+    return Array.from(new Set(values.filter((value) => fileSet.has(value)))).sort();
+}
+function isGeneratedScopedRouter(file) {
+    return /^wiki\/indexes\/auto-[a-z0-9-]+(?:-\d+)?\.md$/.test(file);
+}
+function isCanonicalTruthPage(file, text) {
+    return file.startsWith("wiki/canonical/") && (0, workspace_1.metadataValue)(text, "status") === "active";
+}
+function hasEvidenceClaimSignal(body) {
+    return /\b(source-backed|source backed|research-backed|external research|paper-backed|evidence-backed)\b/i.test(body);
+}
+function hasDecisionRefSignal(text) {
+    const decisionRef = (0, workspace_1.metadataValue)(text, "decision_ref").trim().toLowerCase();
+    return decisionRef !== "" && decisionRef !== "none";
+}
+function hasFocusedAuthoritySignal(text, body) {
+    return hasDecisionRefSignal(text) || hasEvidenceClaimSignal(body);
+}
+function hasEvidenceLink(file, corpus, graph = (0, wiki_corpus_1.wikiCorpusGraph)(corpus)) {
+    const outgoingLinks = graph.outgoingLinks.get(file) ?? [];
+    const sourceLink = outgoingLinks.some((link) => link.normalizedTarget.startsWith("wiki/sources/") && corpus.fileSet.has(link.normalizedTarget));
+    const decisionRef = graph.outgoingDecisionRef.get(file);
+    return sourceLink || Boolean(decisionRef && corpus.fileSet.has(decisionRef));
+}
+function isBroadReviewTrigger(trigger) {
+    const normalized = trigger.toLowerCase().trim();
+    if (!normalized)
+        return false;
+    return normalized === "changes"
+        || normalized === "project changes"
+        || normalized === "routine review"
+        || /^any\b.*changes$/.test(normalized)
+        || /^general\b.*changes$/.test(normalized);
+}
+function isTopologyHub(file) {
+    return file === "wiki/index.md"
+        || file.startsWith("wiki/meta/")
+        || /^wiki\/indexes\/(?!auto-)[^/]+\.md$/.test(file);
+}
+function collectTopologyDiagnostics(corpus) {
+    const diagnostics = [];
+    const graph = (0, wiki_corpus_1.wikiCorpusGraph)(corpus);
+    for (const file of corpus.files) {
+        if (isGeneratedScopedRouter(file))
+            continue;
+        const outgoing = uniqueExisting((graph.outgoingLinks.get(file) ?? [])
+            .map((link) => link.normalizedTarget)
+            .filter((target) => target !== file), corpus.fileSet);
+        if (isTopologyHub(file) && outgoing.length > exports.topologyHubOverloadThreshold) {
+            diagnostics.push({
+                code: "hub-overload",
+                severity: "warn",
+                file,
+                message: `${outgoing.length} outgoing wiki links exceed the topology hub threshold ${exports.topologyHubOverloadThreshold}; split or scope the route surface`,
+            });
+        }
+    }
+    for (const file of corpus.files) {
+        const text = (0, wiki_corpus_1.wikiCorpusText)(corpus, file);
+        if (isCanonicalTruthPage(file, text)) {
+            const body = (0, workspace_1.stripMetadataHeader)(text);
+            const incoming = uniqueExisting((graph.incomingLinks.get(file) ?? [])
+                .map((link) => link.file)
+                .filter((source) => source !== file), corpus.fileSet);
+            if (incoming.length > 0 && incoming.every(isGeneratedScopedRouter) && hasFocusedAuthoritySignal(text, body)) {
+                diagnostics.push({
+                    code: "weak-authority-route",
+                    severity: "warn",
+                    file,
+                    message: "active canonical page with authority signals is routed only by generated auto-index pages; add a focused route when this truth is durable",
+                });
+            }
+            if (hasEvidenceClaimSignal(body) && !hasEvidenceLink(file, corpus, graph)) {
+                diagnostics.push({
+                    code: "missing-evidence-link",
+                    severity: "warn",
+                    file,
+                    message: "canonical page makes a source-backed claim but has no source link or decision_ref evidence link",
+                });
+            }
+        }
+    }
+    for (const file of corpus.files) {
+        if (file === wiki_graph_1.wikiRouterRoot || isGeneratedScopedRouter(file))
+            continue;
+        const text = (0, wiki_corpus_1.wikiCorpusText)(corpus, file);
+        if ((0, workspace_1.metadataValue)(text, "status") !== "active")
+            continue;
+        const incoming = uniqueExisting((graph.incomingLinks.get(file) ?? [])
+            .map((link) => link.file)
+            .filter((source) => source !== file), corpus.fileSet);
+        const reviewTrigger = (0, workspace_1.metadataValue)(text, "review_trigger");
+        if (incoming.length >= exports.topologyFanoutThreshold && isBroadReviewTrigger(reviewTrigger)) {
+            diagnostics.push({
+                code: "stale-fanout",
+                severity: "warn",
+                file,
+                message: `${incoming.length} incoming links with broad review_trigger "${reviewTrigger}"; tighten review trigger before broad edits`,
+            });
+        }
+    }
+    return diagnostics.sort((a, b) => a.file.localeCompare(b.file) || a.code.localeCompare(b.code));
+}