project-librarian 0.5.9 → 0.6.0

package/README.ko.md

@@ -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

@@ -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/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/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) {

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

@@ -29,16 +29,16 @@
       "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"
     },
     {
@@ -53,7 +53,7 @@
       "architecture": "arm64",
       "format": "pe",
       "path": "dist/native/win32-arm64/project-librarian-indexer.exe",
-      "sha256": "f8ef16c98ff97c4f1dd38e2e08a034a40bb219f114f8270d165feaddd8166d8f",
+      "sha256": "b49ad30a72a9a93ff524cc1643b141c94de4850655ce646d80579edc5b832f71",
       "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": "36a8416e4975100f89bc57281b311b45158469fb12ea37d33dac2d5855a5e47a",
       "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));
+}

package/dist/wiki-graph.js

@@ -6,6 +6,7 @@ exports.buildWikiGraph = buildWikiGraph;
 exports.wikiRouterDepths = wikiRouterDepths;
 exports.wikiQueryGraphEvidence = wikiQueryGraphEvidence;
 exports.wikiImpactAnswer = wikiImpactAnswer;
+exports.wikiNeighborhoodAnswer = wikiNeighborhoodAnswer;
 const wiki_files_1 = require("./wiki-files");
 const workspace_1 = require("./workspace");
 // Router reachability budget. The benchmark fixture A1 assert guarantees
@@ -163,3 +164,125 @@ function wikiImpactAnswer(pages, term, graph = buildWikiGraph(pages)) {
     }
     return finalizeWikiAnswer(lines.join("\n"));
 }
+const neighborhoodReadCap = 5;
+function pageClassPriority(file, scope) {
+    if (file.startsWith("wiki/decisions/") || /decision/.test(scope))
+        return 90;
+    if (file.startsWith("wiki/sources/") || /source/.test(scope))
+        return 80;
+    if (file.startsWith("wiki/canonical/") || /canonical/.test(scope))
+        return 70;
+    if (file.startsWith("wiki/plans/") || /plan/.test(scope))
+        return 50;
+    if (file.startsWith("wiki/roadmaps/") || /roadmap/.test(scope))
+        return 40;
+    if (file.startsWith("wiki/meta/") || /wiki-meta/.test(scope))
+        return 30;
+    return 10;
+}
+function neighborhoodReasonRank(reason) {
+    if (reason === "exact page match")
+        return 1000;
+    if (reason === "title/path match")
+        return 900;
+    if (reason === "decision_ref target")
+        return 800;
+    if (reason === "decision_ref citation")
+        return 760;
+    if (reason === "outgoing link target")
+        return 700;
+    if (reason === "incoming link source")
+        return 650;
+    return 0;
+}
+function isGeneratedScopedRouter(file) {
+    return /^wiki\/indexes\/auto-[a-z0-9-]+(?:-\d+)?\.md$/.test(file);
+}
+function isRouterOnlySurface(file) {
+    return file === exports.wikiRouterRoot || file === "wiki/index.md" || isGeneratedScopedRouter(file);
+}
+function addNeighborhoodCandidate(candidates, file, reason, bestFile, graph) {
+    if (!graph.files.has(file) || (file !== bestFile && isRouterOnlySurface(file)))
+        return;
+    const existing = candidates.get(file);
+    if (!existing || neighborhoodReasonRank(reason) > neighborhoodReasonRank(existing.reason)) {
+        candidates.set(file, { file, reason });
+    }
+}
+function wikiNeighborhoodAnswer(pages, term, graph = buildWikiGraph(pages)) {
+    const depths = wikiRouterDepths(graph);
+    const textByFile = new Map(pages.map((page) => [page.file, page.text]));
+    const lowered = term.toLowerCase();
+    const exactTarget = (0, wiki_files_1.normalizeWikiLinkTarget)("wiki/index.md", term.replace(/^\[\[|\]\]$/g, ""));
+    const matches = pages
+        .map((page) => ({ file: page.file, title: (0, wiki_files_1.wikiTitleForFile)(page.file, page.text), text: page.text }))
+        .filter((page) => page.file === exactTarget || page.file.toLowerCase().includes(lowered) || page.title.toLowerCase().includes(lowered))
+        .sort((a, b) => {
+        const exactDelta = Number(b.file === exactTarget) - Number(a.file === exactTarget);
+        if (exactDelta !== 0)
+            return exactDelta;
+        const titleDelta = Number(b.title.toLowerCase().includes(lowered)) - Number(a.title.toLowerCase().includes(lowered));
+        if (titleDelta !== 0)
+            return titleDelta;
+        const aScope = (0, workspace_1.metadataValue)(a.text, "scope");
+        const bScope = (0, workspace_1.metadataValue)(b.text, "scope");
+        return pageClassPriority(b.file, bScope) - pageClassPriority(a.file, aScope) || a.file.localeCompare(b.file);
+    });
+    if (matches.length === 0)
+        return `Wiki neighborhood "${term}": no matching wiki pages.`;
+    const best = matches[0];
+    const candidates = new Map();
+    addNeighborhoodCandidate(candidates, best.file, best.file === exactTarget ? "exact page match" : "title/path match", best.file, graph);
+    const outgoingRef = graph.outgoingDecisionRef.get(best.file);
+    if (outgoingRef)
+        addNeighborhoodCandidate(candidates, outgoingRef, "decision_ref target", best.file, graph);
+    for (const source of graph.incomingDecisionRefs.get(best.file) ?? [])
+        addNeighborhoodCandidate(candidates, source, "decision_ref citation", best.file, graph);
+    for (const link of graph.outgoingLinks.get(best.file) ?? [])
+        addNeighborhoodCandidate(candidates, link.normalizedTarget, "outgoing link target", best.file, graph);
+    for (const link of graph.incomingLinks.get(best.file) ?? [])
+        addNeighborhoodCandidate(candidates, link.file, "incoming link source", best.file, graph);
+    const sorted = Array.from(candidates.values()).sort((a, b) => {
+        const reasonDelta = neighborhoodReasonRank(b.reason) - neighborhoodReasonRank(a.reason);
+        if (reasonDelta !== 0)
+            return reasonDelta;
+        const aText = textByFile.get(a.file) ?? "";
+        const bText = textByFile.get(b.file) ?? "";
+        const classDelta = pageClassPriority(b.file, (0, workspace_1.metadataValue)(bText, "scope")) - pageClassPriority(a.file, (0, workspace_1.metadataValue)(aText, "scope"));
+        if (classDelta !== 0)
+            return classDelta;
+        const aDepth = depths.get(a.file) ?? Number.POSITIVE_INFINITY;
+        const bDepth = depths.get(b.file) ?? Number.POSITIVE_INFINITY;
+        return aDepth - bDepth || a.file.localeCompare(b.file);
+    }).slice(0, neighborhoodReadCap);
+    const lines = [
+        `Wiki neighborhood "${term}": best match ${best.file} — ${best.title}; read ${sorted.length} nearby page${sorted.length === 1 ? "" : "s"}.`,
+        "",
+        "Read order:",
+    ];
+    sorted.forEach((candidate, index) => {
+        const text = textByFile.get(candidate.file) ?? "";
+        const depth = depths.get(candidate.file);
+        const status = (0, workspace_1.metadataValue)(text, "status") || "unknown";
+        const scope = (0, workspace_1.metadataValue)(text, "scope") || "unknown-scope";
+        lines.push(`${index + 1}. ${candidate.file} — ${candidate.reason}; ${depth === undefined ? "router unreachable" : `router depth ${depth}`}; ${status} ${scope}`);
+    });
+    const incoming = uniqueSorted((graph.incomingLinks.get(best.file) ?? [])
+        .map((link) => link.file)
+        .filter((source) => source !== best.file && graph.files.has(source)));
+    const outgoing = uniqueSorted((graph.outgoingLinks.get(best.file) ?? [])
+        .map((link) => link.normalizedTarget)
+        .filter((target) => target !== best.file && graph.files.has(target)));
+    const incomingRefs = uniqueSorted((graph.incomingDecisionRefs.get(best.file) ?? [])
+        .filter((source) => source !== best.file && graph.files.has(source)));
+    const reviewTrigger = (0, workspace_1.metadataValue)(best.text, "review_trigger");
+    lines.push("");
+    lines.push("Why:");
+    lines.push(`- incoming links: ${sampled(incoming, impactListCap)}`);
+    lines.push(`- outgoing links: ${sampled(outgoing, impactListCap)}`);
+    lines.push(`- decision_ref: ${outgoingRef && graph.files.has(outgoingRef) ? outgoingRef : "none"}`);
+    lines.push(`- decision_ref citations: ${sampled(incomingRefs, impactListCap)}`);
+    if (reviewTrigger)
+        lines.push(`- review_trigger: ${reviewTrigger}`);
+    return finalizeWikiAnswer(lines.join("\n"));
+}

package/docs/cli-reference.md

@@ -19,7 +19,7 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 | `update --agents <list>` | Refresh an existing setup and existing project-scoped skill copies; selected surfaces can be `codex`, `claude`, `cursor`, `gemini`, or `all`. |
 | `--migrate`, `--adopt-existing` | Preserve an existing wiki as `wiki_legacy*`, create migration inboxes, and generate unit-map/split-plan/coverage review files. |
 | `--lint` | Validate generated setup without editing files. |
-| `--link-check` | Report broken wiki links, duplicate routes, orphan pages, and pages the startup router cannot reach within the depth budget. |
+| `--link-check` | Report broken wiki links, duplicate routes, orphan pages, router reachability, and warning-only topology signals. |
 | `--quality-check` | Report stale, conflicting, and low-quality wiki document signals. |
 | `--doctor` | Run lint, link-check, and quality-check together. |
 | `--doctor --fix` | Safely refresh generated index routing before diagnostics. `--fix` is only a modifier for `--doctor`. |
@@ -28,8 +28,7 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 | `--migration-doctor` | Run migration-lint and migration-quality-check together. |
 | `--query <terms>` | Search wiki paths, metadata, titles, and bodies; answer-first output with per-page TL;DR lines under a hard size cap. |
 | `--wiki-impact <page-or-term>` | Show wiki backlinks, `decision_ref` citations, outgoing links, and router depth for matching pages. |
-| `--wiki-visualize` | Write a self-contained static wiki graph visualizer to `.project-wiki/wiki-graph.html`. |
-| `--wiki-visualize-out <path>` | With `--wiki-visualize`, write to a custom repository-relative path under `.project-wiki/`. |
+| `--wiki-neighborhood <page-or-term>` | Show a bounded read order for nearby wiki pages using links, `decision_ref`, metadata, page class, and router depth. |
 | `--refresh-index` | Update generated auto-discovered wiki routing. |
 | `--capture-inbox --title <title> --content <content> --category <category>` | Append a candidate note to the wiki inbox; category defaults to `project-candidate`. |
 | `--handoff-save --goal <goal> --state <state> --next <action>` | Save generated local session handoff state under `.project-wiki/session/`. Repeat `--next`, `--decision`, `--blocked`, `--open-question`, `--verification`, `--last-success-command`, and `--last-failure-command` as needed. |
@@ -59,3 +58,14 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 | `--code-context-pack <term>` | Print a budgeted first-pass context pack with structural file, symbol, route, import, edge, and ownership evidence. |
 | `--code-search-symbol <term>` | Search indexed symbols. |
 | `--code-query <sql>` | Run conservative read-only SQL over the evidence index. |
+
+### Topology Warnings
+
+`--link-check` keeps topology findings warning-only so they can guide cleanup without blocking bootstrap, update, or release flows.
+
+| Code | Meaning |
+| --- | --- |
+| `hub-overload` | A hand-maintained router or meta page links to too many wiki pages and should be split or scoped. |
+| `weak-authority-route` | An active canonical page with decision or evidence authority signals is reachable only through generated auto-index routing. |
+| `missing-evidence-link` | An active canonical page makes a source-backed claim without a source link or `decision_ref`. |
+| `stale-fanout` | A heavily linked active page has a broad review trigger that is too weak for topology-sensitive edits. |

package/docs/ko/cli-reference.md

@@ -19,7 +19,7 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 | `update --agents <list>` | 기존 설정과 기존 프로젝트 범위 스킬 복사본을 갱신합니다. 표면은 `codex`, `claude`, `cursor`, `gemini`, `all` 중 하나입니다. |
 | `--migrate`, `--adopt-existing` | 기존 위키를 `wiki_legacy*`로 보존하고 migration inbox, unit-map, split-plan, coverage 검토 파일을 만듭니다. |
 | `--lint` | 파일을 수정하지 않고 생성된 설정을 검증합니다. |
-| `--link-check` | 깨진 위키 링크, 중복 route, orphan page, 시작 라우터 depth 예산 안에서 닿지 않는 페이지를 보고합니다. |
+| `--link-check` | 깨진 위키 링크, 중복 route, orphan page, router reachability, warning-only topology 신호를 보고합니다. |
 | `--quality-check` | 오래되었거나 충돌하거나 품질이 낮은 위키 문서 신호를 보고합니다. |
 | `--doctor` | lint, link-check, quality-check를 함께 실행합니다. |
 | `--doctor --fix` | 진단 전에 생성된 index routing을 안전하게 갱신합니다. `--fix`는 `--doctor`의 modifier입니다. |
@@ -28,8 +28,7 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 | `--migration-doctor` | migration-lint와 migration-quality-check를 함께 실행합니다. |
 | `--query <terms>` | 위키 경로, 메타데이터, 제목, 본문을 검색하고 크기 제한이 있는 answer-first 출력을 제공합니다. |
 | `--wiki-impact <page-or-term>` | 일치하는 페이지의 backlinks, `decision_ref` 인용, outgoing link, router depth를 보여줍니다. |
-| `--wiki-visualize` | `.project-wiki/wiki-graph.html`에 독립 실행형 정적 위키 그래프를 작성합니다. |
-| `--wiki-visualize-out <path>` | `--wiki-visualize`와 함께 사용해 `.project-wiki/` 아래 사용자 지정 저장소 상대 경로에 작성합니다. |
+| `--wiki-neighborhood <page-or-term>` | link, `decision_ref`, metadata, page class, router depth를 사용해 가까운 위키 페이지의 제한된 읽기 순서를 보여줍니다. |
 | `--refresh-index` | 자동 발견된 위키 routing을 갱신합니다. |
 | `--capture-inbox --title <title> --content <content> --category <category>` | 후보 메모를 위키 inbox에 추가합니다. category 기본값은 `project-candidate`입니다. |
 | `--handoff-save --goal <goal> --state <state> --next <action>` | `.project-wiki/session/` 아래에 생성형 로컬 세션 핸드오프를 저장합니다. 필요하면 `--next`, `--decision`, `--blocked`, `--open-question`, `--verification`, `--last-success-command`, `--last-failure-command`를 반복합니다. |
@@ -59,3 +58,14 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 | `--code-context-pack <term>` | 구조 파일, 심볼, route, import, edge, 소유권 근거를 담은 예산 제한 first-pass context pack을 출력합니다. |
 | `--code-search-symbol <term>` | 인덱싱된 심볼을 검색합니다. |
 | `--code-query <sql>` | 근거 인덱스에서 보수적 읽기 전용 SQL을 실행합니다. |
+
+### Topology Warnings
+
+`--link-check`의 topology finding은 warning-only입니다. 그래서 bootstrap, update, release 흐름을 막지 않으면서 정리 방향을 알려줍니다.
+
+| 코드 | 의미 |
+| --- | --- |
+| `hub-overload` | 사람이 관리하는 router 또는 meta 페이지가 너무 많은 위키 페이지를 링크하므로 분리하거나 범위를 좁혀야 합니다. |
+| `weak-authority-route` | decision 또는 evidence 권위 신호가 있는 active canonical page가 generated auto-index routing으로만 도달 가능합니다. |
+| `missing-evidence-link` | active canonical page가 source-backed claim을 하지만 source link 또는 `decision_ref`가 없습니다. |
+| `stale-fanout` | 많이 링크된 active page가 topology-sensitive edit에 비해 너무 넓은 review trigger를 갖고 있습니다. |

package/docs/ko/usage.md

@@ -69,7 +69,7 @@ npx project-librarian@latest install --scope project --agents all
 | 진단 전 라우팅 갱신 | "Project Librarian 라우팅을 갱신한 뒤 진단을 실행해줘." | `--doctor --fix` |
 | 위키 내용 검색 | "Project Librarian 위키에서 authentication decisions를 찾아줘." | `--query "authentication decisions"` |
 | 페이지 영향도 확인 | "decisions/release-policy의 Project Librarian 위키 영향도를 보여줘." | `--wiki-impact "decisions/release-policy"` |
-| 위키 그래프 생성 | "Project Librarian 위키 그래프 시각화를 생성해줘." | `--wiki-visualize` |
+| 가까운 위키 맥락 찾기 | "canonical/project-brief의 Project Librarian wiki neighborhood를 보여줘." | `--wiki-neighborhood "canonical/project-brief"` |
 | 후보 메모 저장 | "이 내용을 Project Librarian 후보 메모로 저장해줘: <내용>." | `--capture-inbox --title "Candidate" --content "Details"` |
 | 세션 핸드오프 저장 | "현재 작업을 Project Librarian 세션 핸드오프로 저장해줘." | `--handoff-save --goal "..." --state "..." --next "..."` |
 | 핸드오프 보기 | "마지막 Project Librarian 세션 핸드오프를 보여줘." | `--handoff-show` |
@@ -160,9 +160,7 @@ MCP 서버 등록은 Claude Code(`.mcp.json`), Cursor(`.cursor/mcp.json`), Gemin
 6. `--refresh-index`는 새로 발견한 위키 페이지를 라우팅합니다. route가 많으면 `wiki/indexes/auto-*.md` 범위별 라우터로 나눕니다.
 7. `--code-index`는 `.project-wiki/` 아래 폐기 가능한 SQLite 근거 캐시를 만듭니다.
 8. `--code-report`, `--code-impact`, `--code-context-pack`, `--code-search-symbol`, `--code-query`는 계획 업데이트에 쓸 코드 기반 근거를 노출합니다.
-9. 읽기 전용 위키 소비자는 경로와 frontmatter에서 사용자-facing page type을 파생하는 concept read model을 공유합니다.
-10. 위키 생산자는 canonical markdown/YAML 스키마를 계속 쓰고, 진단/MCP/시각화 같은 읽기 전용 소비자는 파생 projection을 사용합니다.
-11. `--wiki-visualize`는 데이터베이스나 서버 없이 `.project-wiki/` 아래 정적 그래프 산출물을 작성합니다.
-12. 진단은 깨진 링크, 중복 route, orphan page, stale page, TL;DR 누락, 근거 공백, 마이그레이션 정책 위반을 보고합니다.
+9. 위키 생산자는 canonical markdown/YAML 스키마를 계속 쓰고, 진단/MCP 같은 읽기 전용 소비자는 원본 문서를 변경하지 않고 검사합니다.
+10. 진단은 깨진 링크, 중복 route, orphan page, topology warning, stale page, TL;DR 누락, 근거 공백, 마이그레이션 정책 위반을 보고합니다.
 
 마이그레이션은 검토 우선입니다. `--migrate`는 기존 `wiki/`를 `wiki_legacy*`로 보존하고, 양식 전용 파일은 건너뛰며, 여러 성격이 섞인 기존 페이지를 의미 단위로 나눕니다. 이후 각 단위를 분류해 `wiki/migration/` 아래 검토 파일을 작성합니다.

package/docs/usage.md

@@ -67,7 +67,7 @@ Wiki setup and maintenance:
 | Refresh generated routing before diagnostics | "Refresh Project Librarian routing and then run diagnostics." | `--doctor --fix` |
 | Search project wiki content | "Search the Project Librarian wiki for authentication decisions." | `--query "authentication decisions"` |
 | Show backlinks and decision citations for a page | "Show Project Librarian wiki impact for decisions/release-policy." | `--wiki-impact "decisions/release-policy"` |
-| Generate a wiki graph visualizer | "Generate the Project Librarian wiki graph visualizer." | `--wiki-visualize` |
+| Find nearby wiki context | "Show Project Librarian wiki neighborhood for canonical/project-brief." | `--wiki-neighborhood "canonical/project-brief"` |
 | Capture a candidate note | "Capture this as a Project Librarian candidate note: <details>." | `--capture-inbox --title "Candidate" --content "Details"` |
 | Save a session handoff | "Save a Project Librarian session handoff for the current work." | `--handoff-save --goal "..." --state "..." --next "..."` |
 | Resume from a handoff | "Show the last Project Librarian session handoff." | `--handoff-show` |
@@ -158,10 +158,8 @@ MCP server registration is a preservation-first merge into `mcpServers` for Clau
 6. `--refresh-index` routes newly discovered wiki pages; large route sets are split into `wiki/indexes/auto-*.md` scoped routers.
 7. `--code-index` creates a disposable SQLite evidence cache under `.project-wiki/`.
 8. `--code-report`, `--code-impact`, `--code-context-pack`, `--code-search-symbol`, and `--code-query` expose code-backed evidence for planning updates.
-9. Read-only wiki consumers share a concept read model that derives user-facing page types from paths and frontmatter without rewriting the canonical wiki schema.
-10. Wiki producers keep writing the canonical markdown/YAML schema, while read-only consumers such as diagnostics, MCP, and the visualizer use derived projections instead of mutating source documents.
-11. `--wiki-visualize` writes a static graph artifact to `.project-wiki/`, reusing the wiki graph and concept read model instead of introducing a database or server.
-12. Diagnostics report broken links, duplicate routes, orphan pages, stale pages, missing TL;DRs, evidence gaps, and migration policy violations.
+9. Wiki producers keep writing the canonical markdown/YAML schema, while read-only consumers such as diagnostics and MCP inspect source documents without mutating them.
+10. Diagnostics report broken links, duplicate routes, orphan pages, topology warnings, stale pages, missing TL;DRs, evidence gaps, and migration policy violations.
 
 Migration is intentionally review-first. `--migrate` preserves an existing `wiki/` as `wiki_legacy*`, skips form-only/template legacy files, splits mixed legacy pages into meaning units, classifies each unit through the document taxonomy, and writes review files under `wiki/migration/`:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-librarian",
-  "version": "0.5.9",
+  "version": "0.6.0",
   "description": "Create and maintain compact project context for humans and LLM coding agents.",
   "license": "MIT",
   "type": "commonjs",
@@ -97,6 +97,6 @@
     "@sengac/tree-sitter-typescript": "^0.25.15"
   },
   "devDependencies": {
-    "@types/node": "^22.20.0"
+    "@types/node": "^26.1.0"
   }
 }

package/dist/wiki-concepts.js

@@ -1,49 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.conceptIdForFile = conceptIdForFile;
-exports.wikiConceptType = wikiConceptType;
-exports.conceptFromPage = conceptFromPage;
-exports.readWikiConcepts = readWikiConcepts;
-const wiki_files_1 = require("./wiki-files");
-const workspace_1 = require("./workspace");
-function conceptIdForFile(file) {
-    return file.replace(/^wiki\//, "").replace(/\.(md|mdx)$/i, "");
-}
-function wikiConceptType(file, scope) {
-    if (scope === "startup-router" || file === "wiki/startup.md")
-        return "Startup Router";
-    if (scope === "wiki-router" || file === "wiki/index.md" || /^wiki\/indexes\//.test(file))
-        return "Wiki Router";
-    if (scope === "project-canonical" || /^wiki\/canonical\//.test(file))
-        return "Project Canonical Concept";
-    if (scope === "project-decisions" || /^wiki\/decisions\//.test(file))
-        return "Project Decision";
-    if (scope === "source-summary" || /^wiki\/sources\//.test(file))
-        return "Source Summary";
-    if (scope === "wiki-meta" || /^wiki\/meta\//.test(file))
-        return "Wiki Operations Concept";
-    if (/^migration-/.test(scope) || /^wiki\/migration\//.test(file))
-        return "Migration Ledger";
-    if (scope === "inbox" || /^wiki\/inbox\//.test(file))
-        return "Project Candidate";
-    return "Wiki Concept";
-}
-function conceptFromPage(file, text) {
-    const scope = (0, workspace_1.metadataValue)(text, "scope") || "-";
-    const tldr = (0, wiki_files_1.firstTldrBullet)(text);
-    return {
-        budget: (0, workspace_1.metadataValue)(text, "read_budget") || "-",
-        conceptId: conceptIdForFile(file),
-        description: tldr || (0, wiki_files_1.compactSummary)(text),
-        file,
-        reviewTrigger: (0, workspace_1.metadataValue)(text, "review_trigger"),
-        scope,
-        status: (0, workspace_1.metadataValue)(text, "status") || "-",
-        timestamp: (0, workspace_1.metadataValue)(text, "updated"),
-        title: (0, wiki_files_1.wikiTitleForFile)(file, text),
-        type: wikiConceptType(file, scope),
-    };
-}
-function readWikiConcepts(files = (0, wiki_files_1.wikiMarkdownFiles)()) {
-    return files.map((file) => conceptFromPage(file, (0, workspace_1.read)(file)));
-}

package/dist/wiki-visualizer.js

@@ -1,558 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultWikiVisualizerOutput = void 0;
-exports.buildWikiVisualizerPayload = buildWikiVisualizerPayload;
-exports.writeWikiVisualizer = writeWikiVisualizer;
-const path = __importStar(require("node:path"));
-const wiki_concepts_1 = require("./wiki-concepts");
-const wiki_graph_1 = require("./wiki-graph");
-const wiki_files_1 = require("./wiki-files");
-const workspace_1 = require("./workspace");
-exports.defaultWikiVisualizerOutput = ".project-wiki/wiki-graph.html";
-function uniqueSorted(values) {
-    return Array.from(new Set(values)).sort();
-}
-function visualizerEdges(graph, pages) {
-    const linkEdges = graph.links
-        .filter((link) => graph.files.has(link.normalizedTarget))
-        .map((link) => ({ kind: "link", source: link.file, target: link.normalizedTarget }));
-    const decisionRefEdges = [];
-    for (const page of pages) {
-        const ref = graph.outgoingDecisionRef.get(page.file);
-        if (ref && graph.files.has(ref))
-            decisionRefEdges.push({ kind: "decision_ref", source: page.file, target: ref });
-    }
-    return [...linkEdges, ...decisionRefEdges].sort((a, b) => a.source.localeCompare(b.source) || a.target.localeCompare(b.target) || a.kind.localeCompare(b.kind));
-}
-function brokenLinksFor(graph, file) {
-    return uniqueSorted((graph.outgoingLinks.get(file) ?? []).map((link) => link.normalizedTarget).filter((target) => !graph.files.has(target)));
-}
-function buildWikiVisualizerPayload(pages, generatedAt = new Date().toISOString()) {
-    const graph = (0, wiki_graph_1.buildWikiGraph)(pages);
-    const depths = (0, wiki_graph_1.wikiRouterDepths)(graph);
-    const conceptByFile = new Map(pages.map((page) => [page.file, (0, wiki_concepts_1.conceptFromPage)(page.file, page.text)]));
-    const edges = visualizerEdges(graph, pages);
-    const nodes = pages.map((page) => {
-        const concept = conceptByFile.get(page.file);
-        const incomingCount = uniqueSorted((graph.incomingLinks.get(page.file) ?? []).map((link) => link.file)).length;
-        const outgoingCount = uniqueSorted((graph.outgoingLinks.get(page.file) ?? []).map((link) => link.normalizedTarget).filter((target) => graph.files.has(target))).length;
-        return {
-            brokenLinks: brokenLinksFor(graph, page.file),
-            budget: concept.budget,
-            decisionRefCount: graph.incomingDecisionRefs.get(page.file)?.length ?? 0,
-            description: concept.description,
-            file: page.file,
-            incomingCount,
-            outgoingCount,
-            reviewTrigger: concept.reviewTrigger,
-            routerDepth: depths.get(page.file) ?? null,
-            scope: concept.scope,
-            status: concept.status,
-            timestamp: concept.timestamp,
-            title: concept.title,
-            type: concept.type,
-        };
-    }).sort((a, b) => a.file.localeCompare(b.file));
-    return {
-        generatedAt,
-        nodes,
-        edges,
-        summary: {
-            brokenCount: nodes.filter((node) => node.brokenLinks.length > 0).length,
-            edgeCount: edges.length,
-            nodeCount: nodes.length,
-            orphanCount: nodes.filter((node) => node.incomingCount === 0 && node.outgoingCount === 0).length,
-            typeCount: new Set(nodes.map((node) => node.type)).size,
-            unreachableCount: nodes.filter((node) => node.routerDepth === null).length,
-        },
-    };
-}
-function jsonForHtml(value) {
-    return JSON.stringify(value).replace(/[<\u2028\u2029]/g, (ch) => "\\u" + ch.charCodeAt(0).toString(16).padStart(4, "0"));
-}
-function renderWikiVisualizerHtml(payload) {
-    const payloadJson = jsonForHtml(payload);
-    return `<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Project Librarian Wiki Graph</title>
-  <style>
-    :root { color-scheme: light; font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: #f7f8fa; color: #16202a; }
-    * { box-sizing: border-box; }
-    body { margin: 0; min-height: 100vh; }
-    header { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 16px 20px; border-bottom: 1px solid #d9dee7; background: #ffffff; }
-    h1 { margin: 0; font-size: 18px; font-weight: 700; }
-    main { display: grid; grid-template-columns: minmax(280px, 360px) 1fr minmax(280px, 380px); height: calc(100vh - 65px); }
-    aside, section { min-width: 0; }
-    .panel { border-right: 1px solid #d9dee7; background: #ffffff; padding: 16px; overflow: auto; }
-    .detail { border-left: 1px solid #d9dee7; border-right: 0; }
-    .summary { display: flex; flex-wrap: wrap; gap: 8px; font-size: 12px; color: #516070; }
-    .summary span { padding: 4px 7px; border: 1px solid #cfd6e1; border-radius: 6px; background: #f4f6f9; }
-    .summary span.alert { border-color: #e0a3a3; background: #fbecec; color: #9a3b3b; }
-    label { display: block; margin: 14px 0 6px; font-size: 12px; font-weight: 700; color: #394756; }
-    input, select { width: 100%; padding: 8px 10px; border: 1px solid #bdc7d4; border-radius: 6px; background: #ffffff; font: inherit; font-size: 14px; }
-    .list-meta { margin-top: 16px; font-size: 12px; color: #667484; }
-    .panel.nav { overflow: hidden; display: flex; flex-direction: column; }
-    .list { margin-top: 10px; display: grid; gap: 8px; flex: 1 1 auto; min-height: 0; overflow-y: auto; }
-    button.node { width: 100%; text-align: left; border: 1px solid #d8dee8; border-radius: 8px; background: #ffffff; padding: 10px; cursor: pointer; }
-    button.node[aria-current="true"] { border-color: #2474b7; box-shadow: 0 0 0 2px rgba(36, 116, 183, 0.14); }
-    .node-title { display: block; font-size: 14px; font-weight: 700; color: #152436; overflow-wrap: anywhere; }
-    .node-meta { display: block; margin-top: 4px; font-size: 12px; color: #667484; overflow-wrap: anywhere; }
-    .tags { display: flex; flex-wrap: wrap; gap: 4px; margin-top: 6px; }
-    .tag { font-size: 10px; font-weight: 700; padding: 2px 6px; border-radius: 999px; border: 1px solid; }
-    .tag.unreachable { color: #9a3b3b; border-color: #e0a3a3; background: #fbecec; }
-    .tag.orphan { color: #8a6d1b; border-color: #e3cd8f; background: #faf3df; }
-    .tag.broken { color: #9a3b3b; border-color: #e0a3a3; background: #fbecec; }
-    .graph-wrap { position: relative; overflow: hidden; background: #f7f8fa; }
-    svg { width: 100%; height: calc(100vh - 65px); display: block; touch-action: none; cursor: grab; }
-    svg.panning { cursor: grabbing; }
-    .node { cursor: pointer; }
-    .edge { stroke: #aeb8c5; stroke-width: 1.2; marker-end: url(#arrow); vector-effect: non-scaling-stroke; }
-    .edge.decision_ref { stroke: #9b5c8f; stroke-dasharray: 5 4; }
-    .edge.dim { opacity: 0.1; }
-    .edge.hi { stroke: #17212b; stroke-width: 2; opacity: 1; }
-    .edge.path { stroke: #d08700; stroke-width: 2.6; opacity: 1; }
-    .point { stroke: #ffffff; stroke-width: 2; cursor: pointer; }
-    .point.selected { stroke: #17212b; stroke-width: 3; }
-    .point.unreachable { stroke: #cc4b4b; stroke-dasharray: 3 2; }
-    .point.dim { opacity: 0.18; }
-    .badge { fill: #cc4b4b; pointer-events: none; }
-    .label { font-size: 11px; fill: #2b3848; paint-order: stroke; stroke: #f7f8fa; stroke-width: 4; stroke-linejoin: round; pointer-events: none; }
-    .label.hidden { display: none; }
-    .controls { position: absolute; right: 12px; top: 12px; display: flex; gap: 6px; }
-    .controls button { width: 30px; height: 30px; border: 1px solid #cfd6e1; border-radius: 6px; background: #ffffff; cursor: pointer; font-size: 16px; line-height: 1; color: #2b3848; }
-    .controls button:hover { border-color: #2474b7; }
-    .topbar { position: absolute; top: 12px; left: 12px; z-index: 2; display: flex; align-items: center; gap: 8px; background: rgba(255, 255, 255, 0.93); border: 1px solid #d9dee7; border-radius: 8px; padding: 6px 10px; }
-    .topbar label { display: inline; margin: 0; font-size: 12px; color: #394756; }
-    .topbar select { width: auto; }
-    .legend { position: absolute; left: 12px; bottom: 12px; max-width: calc(100% - 24px); background: rgba(255, 255, 255, 0.93); border: 1px solid #d9dee7; border-radius: 8px; padding: 8px 10px; display: flex; flex-wrap: wrap; gap: 6px 12px; font-size: 11px; color: #435367; }
-    .legend .k { display: flex; align-items: center; gap: 5px; }
-    .legend .sw { width: 10px; height: 10px; border-radius: 50%; box-shadow: 0 0 0 1px #cfd6e1; }
-    .legend .sw.ring { background: #ffffff; border: 1.5px dashed #cc4b4b; box-shadow: none; }
-    .legend .sw.dot { background: #cc4b4b; }
-    .empty { position: absolute; inset: 0; display: grid; place-items: center; color: #617083; pointer-events: none; }
-    .empty[hidden] { display: none; }
-    .detail h2 { margin: 0 0 8px; font-size: 18px; overflow-wrap: anywhere; }
-    .detail dl { display: grid; grid-template-columns: 92px 1fr; gap: 8px 10px; margin: 16px 0; font-size: 13px; }
-    .detail dt { font-weight: 700; color: #435367; }
-    .detail dd { margin: 0; color: #1d2a36; overflow-wrap: anywhere; }
-    .links { margin: 8px 0 0; padding: 0; list-style: none; display: grid; gap: 6px; }
-    button.link { display: block; width: 100%; text-align: left; padding: 6px 8px; border: 1px solid #d9dee7; border-radius: 6px; background: #f8fafc; cursor: pointer; font: inherit; font-size: 13px; overflow-wrap: anywhere; }
-    button.link:hover { border-color: #2474b7; }
-    .kind { color: #7a8696; font-size: 11px; }
-    .links li { padding: 6px 8px; border: 1px solid #e0a3a3; border-radius: 6px; background: #fbecec; font-size: 13px; overflow-wrap: anywhere; }
-    @media (max-width: 960px) { main { grid-template-columns: 1fr; height: auto; } .panel, .detail { border: 0; border-bottom: 1px solid #d9dee7; max-height: 44vh; } .panel.nav { display: block; overflow: auto; } .list { flex: none; overflow: visible; } svg { height: 56vh; } }
-  </style>
-</head>
-<body>
-  <header>
-    <h1>Project Librarian Wiki Graph</h1>
-    <div class="summary" id="summary"></div>
-  </header>
-  <main>
-    <aside class="panel nav">
-      <label for="search">Search</label>
-      <input id="search" autocomplete="off" placeholder="Title, path, type, scope">
-      <label for="group">Group by</label>
-      <select id="group">
-        <option value="type">Concept type</option>
-        <option value="section">Section / folder</option>
-        <option value="depth">Router depth</option>
-        <option value="community">Link community</option>
-      </select>
-      <label for="type">Type</label>
-      <select id="type"></select>
-      <label for="hygiene">Hygiene</label>
-      <select id="hygiene">
-        <option value="all">All pages</option>
-        <option value="unreachable">Unreachable</option>
-        <option value="orphan">Orphan (no links)</option>
-        <option value="broken">Broken links</option>
-      </select>
-      <div class="list-meta" id="list-meta"></div>
-      <div class="list" id="list"></div>
-    </aside>
-    <section class="graph-wrap">
-      <div class="topbar">
-        <label for="depth">Router depth</label>
-        <select id="depth">
-          <option value="all">All depths</option>
-          <option value="reachable">Reachable</option>
-          <option value="unreachable">Unreachable</option>
-        </select>
-      </div>
-      <svg id="graph" role="img" aria-label="Wiki graph"></svg>
-      <div class="controls">
-        <button id="zoom-in" title="Zoom in" aria-label="Zoom in">+</button>
-        <button id="zoom-out" title="Zoom out" aria-label="Zoom out">&#8722;</button>
-        <button id="zoom-reset" title="Reset view" aria-label="Reset view">&#8853;</button>
-      </div>
-      <div class="legend" id="legend"></div>
-      <div class="empty" id="empty" hidden>No matching nodes</div>
-    </section>
-    <aside class="panel detail" id="detail"></aside>
-  </main>
-  <script id="wiki-graph-data" type="application/json">${payloadJson}</script>
-  <script>
-    var payload = JSON.parse(document.getElementById("wiki-graph-data").textContent);
-    var state = { selected: "", query: "", type: "all", depth: "all", group: "type", hygiene: "all" };
-    var view = { x: 0, y: 0, k: 1 };
-    var neighborSet = new Set();
-    var dragging = false, last = null, down = null, moved = false, downOnPoint = false;
-    var HUB = 8;
-
-    function escapeHtml(value) { return String(value == null ? "" : value).replace(/[&<>"']/g, function (char) { return ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[char]; }); }
-    function escapeAttr(value) { return escapeHtml(value).replace(/"/g, "&quot;"); }
-
-    var colorByType = new Map();
-    var palette = ["#2f6f9f", "#5b7f3a", "#9a5f27", "#7b5aa6", "#bd4b4b", "#327d77", "#5d6f86", "#8b6f2b", "#6d7892"];
-    function color(type) { if (!colorByType.has(type)) colorByType.set(type, palette[colorByType.size % palette.length]); return colorByType.get(type); }
-    var sortedTypes = Array.from(new Set(payload.nodes.map(function (n) { return n.type; }))).sort();
-    sortedTypes.forEach(function (t) { color(t); });
-
-    var byFile = new Map(payload.nodes.map(function (n) { return [n.file, n]; }));
-
-    function isUnreachable(n) { return n.routerDepth === null; }
-    function isOrphan(n) { return n.incomingCount === 0 && n.outgoingCount === 0; }
-    function isBroken(n) { return (n.brokenLinks || []).length > 0; }
-    function degreeOf(n) { return n.incomingCount + n.outgoingCount; }
-    function sectionOf(file) { var parts = String(file).split("/"); return parts.length > 2 ? parts[1] : "(root)"; }
-
-    function computeCommunities(nodes, edges) {
-      var adj = new Map();
-      nodes.forEach(function (n) { adj.set(n.file, []); });
-      edges.forEach(function (e) { if (adj.has(e.source) && adj.has(e.target)) { adj.get(e.source).push(e.target); adj.get(e.target).push(e.source); } });
-      var label = new Map();
-      nodes.forEach(function (n) { label.set(n.file, n.file); });
-      var order = nodes.map(function (n) { return n.file; }).sort();
-      for (var iter = 0; iter < 12; iter++) {
-        var changed = false;
-        for (var oi = 0; oi < order.length; oi++) {
-          var f = order[oi];
-          var nb = adj.get(f);
-          if (!nb.length) continue;
-          var counts = new Map();
-          for (var j = 0; j < nb.length; j++) { var l = label.get(nb[j]); counts.set(l, (counts.get(l) || 0) + 1); }
-          var pairs = Array.from(counts.keys()).sort().map(function (k) { return [k, counts.get(k)]; });
-          var best = label.get(f), bestC = -1;
-          for (var p = 0; p < pairs.length; p++) { if (pairs[p][1] > bestC) { bestC = pairs[p][1]; best = pairs[p][0]; } }
-          if (best !== label.get(f)) { label.set(f, best); changed = true; }
-        }
-        if (!changed) break;
-      }
-      return label;
-    }
-    var community = computeCommunities(payload.nodes, payload.edges);
-    function groupKey(n) {
-      if (state.group === "section") return sectionOf(n.file);
-      if (state.group === "depth") return isUnreachable(n) ? "unreachable" : "depth " + n.routerDepth;
-      if (state.group === "community") return community.get(n.file) || "-";
-      return n.type;
-    }
-
-    var summary = document.getElementById("summary");
-    function chip(text, alert) { return '<span class="' + (alert ? "alert" : "") + '">' + escapeHtml(text) + "</span>"; }
-    summary.innerHTML = [
-      chip(payload.summary.nodeCount + " nodes", false),
-      chip(payload.summary.edgeCount + " edges", false),
-      chip(payload.summary.typeCount + " types", false),
-      chip(payload.summary.unreachableCount + " unreachable", payload.summary.unreachableCount > 0),
-      chip(payload.summary.orphanCount + " orphan", payload.summary.orphanCount > 0),
-      chip(payload.summary.brokenCount + " broken", payload.summary.brokenCount > 0),
-      chip("Generated " + payload.generatedAt, false)
-    ].join("");
-
-    var typeSelect = document.getElementById("type");
-    typeSelect.innerHTML = '<option value="all">All types</option>' + sortedTypes.map(function (type) { return '<option value="' + escapeAttr(type) + '">' + escapeHtml(type) + "</option>"; }).join("");
-
-    var legend = document.getElementById("legend");
-    legend.innerHTML = sortedTypes.map(function (t) { return '<span class="k"><span class="sw" style="background:' + color(t) + '"></span>' + escapeHtml(t) + "</span>"; }).join("") +
-      '<span class="k"><span class="sw ring"></span>unreachable</span>' +
-      '<span class="k"><span class="sw dot"></span>broken link</span>';
-
-    document.getElementById("search").addEventListener("input", function (event) { state.query = event.target.value.toLowerCase(); render(); });
-    typeSelect.addEventListener("change", function (event) { state.type = event.target.value; render(); });
-    document.getElementById("depth").addEventListener("change", function (event) { state.depth = event.target.value; render(); });
-    document.getElementById("group").addEventListener("change", function (event) { state.group = event.target.value; view = { x: 0, y: 0, k: 1 }; render(); });
-    document.getElementById("hygiene").addEventListener("change", function (event) { state.hygiene = event.target.value; render(); });
-    document.getElementById("zoom-in").addEventListener("click", function () { zoomAtCenter(1.25); });
-    document.getElementById("zoom-out").addEventListener("click", function () { zoomAtCenter(1 / 1.25); });
-    document.getElementById("zoom-reset").addEventListener("click", function () { view = { x: 0, y: 0, k: 1 }; applyView(); });
-
-    function matchHygiene(n) {
-      if (state.hygiene === "unreachable") return isUnreachable(n);
-      if (state.hygiene === "orphan") return isOrphan(n);
-      if (state.hygiene === "broken") return isBroken(n);
-      return true;
-    }
-    function filteredNodes() {
-      return payload.nodes.filter(function (node) {
-        var haystack = [node.file, node.title, node.type, node.scope, node.description].join(" ").toLowerCase();
-        var typeOk = state.type === "all" || node.type === state.type;
-        var depthOk = state.depth === "all" || (state.depth === "reachable" ? node.routerDepth !== null : node.routerDepth === null);
-        return typeOk && depthOk && matchHygiene(node) && (!state.query || haystack.includes(state.query));
-      });
-    }
-
-    function ringLayout(nodes, width, height) {
-      var centerX = width / 2, centerY = height / 2;
-      var byDepth = new Map();
-      nodes.forEach(function (node) { var key = node.routerDepth === null ? "unreachable" : String(node.routerDepth); byDepth.set(key, (byDepth.get(key) || []).concat([node])); });
-      var positions = new Map();
-      var rings = Array.from(byDepth.keys()).sort(function (a, b) { return (a === "unreachable" ? 999 : Number(a)) - (b === "unreachable" ? 999 : Number(b)); });
-      rings.forEach(function (ring, ringIndex) {
-        var items = byDepth.get(ring);
-        var radius = ring === "0" ? 0 : Math.min(width, height) * (0.13 + ringIndex * 0.09);
-        items.forEach(function (node, index) {
-          var angle = items.length === 1 ? -Math.PI / 2 : (Math.PI * 2 * index) / items.length - Math.PI / 2;
-          positions.set(node.file, { x: centerX + Math.cos(angle) * radius, y: centerY + Math.sin(angle) * radius });
-        });
-      });
-      return positions;
-    }
-    function clusterLayout(nodes, width, height) {
-      var groups = new Map();
-      nodes.forEach(function (n) { var k = groupKey(n); if (!groups.has(k)) groups.set(k, []); groups.get(k).push(n); });
-      var keys = Array.from(groups.keys()).sort();
-      var cx = width / 2, cy = height / 2;
-      var R = Math.min(width, height) * 0.38;
-      var positions = new Map();
-      keys.forEach(function (k, gi) {
-        var items = groups.get(k).slice().sort(function (a, b) { return a.file < b.file ? -1 : 1; });
-        var ga = keys.length === 1 ? 0 : (Math.PI * 2 * gi) / keys.length - Math.PI / 2;
-        var gx = keys.length === 1 ? cx : cx + Math.cos(ga) * R;
-        var gy = keys.length === 1 ? cy : cy + Math.sin(ga) * R;
-        items.forEach(function (n, i) { var a = i * 2.399963229; var rr = 15 * Math.sqrt(i); positions.set(n.file, { x: gx + Math.cos(a) * rr, y: gy + Math.sin(a) * rr }); });
-      });
-      return positions;
-    }
-    function layout(nodes, width, height) { return state.group === "depth" ? ringLayout(nodes, width, height) : clusterLayout(nodes, width, height); }
-
-    function rootFile() { var r = payload.nodes.find(function (n) { return n.routerDepth === 0; }); return r ? r.file : "wiki/startup.md"; }
-    function pathTo(target) {
-      var root = rootFile();
-      if (!target || !byFile.has(target) || target === root) return [];
-      var adj = new Map();
-      payload.edges.forEach(function (e) { if (!adj.has(e.source)) adj.set(e.source, []); adj.get(e.source).push(e.target); });
-      var queue = [root], prev = new Map([[root, null]]);
-      while (queue.length) { var c = queue.shift(); if (c === target) break; var nx = adj.get(c) || []; for (var i = 0; i < nx.length; i++) { if (!prev.has(nx[i])) { prev.set(nx[i], c); queue.push(nx[i]); } } }
-      if (!prev.has(target)) return [];
-      var pathNodes = [], cur = target;
-      while (cur != null) { pathNodes.unshift(cur); cur = prev.get(cur); }
-      return pathNodes;
-    }
-
-    function applyView() {
-      var vp = document.getElementById("viewport");
-      if (!vp) return;
-      vp.setAttribute("transform", "translate(" + view.x + "," + view.y + ") scale(" + view.k + ")");
-      var inv = 1 / view.k;
-      var groups = vp.querySelectorAll("g.node");
-      for (var i = 0; i < groups.length; i++) {
-        var g = groups[i];
-        g.setAttribute("transform", "translate(" + g.getAttribute("data-x") + "," + g.getAttribute("data-y") + ") scale(" + inv + ")");
-      }
-      updateLOD();
-    }
-    function updateLOD() {
-      var showAll = view.k >= 1.8;
-      var labels = document.querySelectorAll("text.label");
-      for (var i = 0; i < labels.length; i++) {
-        var t = labels[i];
-        var deg = Number(t.getAttribute("data-deg")) || 0;
-        var f = t.getAttribute("data-file");
-        var keep = showAll || deg >= HUB || f === state.selected || neighborSet.has(f);
-        t.classList.toggle("hidden", !keep);
-      }
-    }
-    function zoomAtCenter(factor) {
-      var svg = document.getElementById("graph");
-      var rect = svg.getBoundingClientRect();
-      zoomAt(rect.width / 2, rect.height / 2, factor);
-    }
-    function zoomAt(mx, my, factor) {
-      var nk = Math.min(6, Math.max(0.3, view.k * factor));
-      var r = nk / view.k;
-      view.x = mx - r * (mx - view.x);
-      view.y = my - r * (my - view.y);
-      view.k = nk;
-      applyView();
-    }
-
-    function renderGraph(nodes) {
-      var svg = document.getElementById("graph");
-      var empty = document.getElementById("empty");
-      var width = svg.clientWidth || 900;
-      var height = svg.clientHeight || 640;
-      var files = new Set(nodes.map(function (node) { return node.file; }));
-      var positions = layout(nodes, width, height);
-      var edges = payload.edges.filter(function (edge) { return files.has(edge.source) && files.has(edge.target); });
-      empty.hidden = nodes.length > 0;
-
-      var focusOn = state.selected && byFile.has(state.selected) && files.has(state.selected);
-      neighborSet = new Set();
-      var pathSet = new Set();
-      if (focusOn) {
-        edges.forEach(function (e) { if (e.source === state.selected) neighborSet.add(e.target); if (e.target === state.selected) neighborSet.add(e.source); });
-        neighborSet.add(state.selected);
-        var p = pathTo(state.selected);
-        for (var i = 0; i + 1 < p.length; i++) pathSet.add(p[i] + "->" + p[i + 1]);
-      }
-
-      var defs = '<defs><marker id="arrow" markerWidth="8" markerHeight="8" refX="7" refY="3" orient="auto"><path d="M0,0 L7,3 L0,6 Z" fill="#aeb8c5"></path></marker></defs>';
-      var edgeMarkup = edges.map(function (edge) {
-        var source = positions.get(edge.source), target = positions.get(edge.target);
-        if (!source || !target) return "";
-        var cls = "edge " + edge.kind;
-        if (focusOn) {
-          if (pathSet.has(edge.source + "->" + edge.target)) cls += " path";
-          else if (edge.source === state.selected || edge.target === state.selected) cls += " hi";
-          else cls += " dim";
-        }
-        return '<line class="' + cls + '" x1="' + source.x + '" y1="' + source.y + '" x2="' + target.x + '" y2="' + target.y + '"></line>';
-      }).join("");
-      var nodeMarkup = nodes.map(function (node) {
-        var point = positions.get(node.file);
-        if (!point) return "";
-        var cls = "point";
-        if (node.file === state.selected) cls += " selected";
-        if (isUnreachable(node)) cls += " unreachable";
-        if (focusOn && !neighborSet.has(node.file)) cls += " dim";
-        var markup = '<g class="node" data-file="' + escapeAttr(node.file) + '" data-x="' + point.x + '" data-y="' + point.y + '">';
-        markup += '<circle class="' + cls + '" r="8" fill="' + color(node.type) + '"></circle>';
-        if (isBroken(node)) markup += '<circle class="badge" cx="6" cy="-6" r="3"></circle>';
-        markup += '<text class="label" data-file="' + escapeAttr(node.file) + '" data-deg="' + degreeOf(node) + '" x="11" y="4">' + escapeHtml(node.title.slice(0, 34)) + "</text></g>";
-        return markup;
-      }).join("");
-      svg.innerHTML = defs + '<g id="viewport">' + edgeMarkup + nodeMarkup + "</g>";
-      svg.querySelectorAll("g.node").forEach(function (g) { g.addEventListener("click", function () { state.selected = g.dataset.file; render(); }); });
-      applyView();
-    }
-
-    function tagsFor(node) {
-      var tags = "";
-      if (isUnreachable(node)) tags += '<span class="tag unreachable">unreachable</span>';
-      if (isOrphan(node)) tags += '<span class="tag orphan">orphan</span>';
-      if (isBroken(node)) tags += '<span class="tag broken">broken ' + node.brokenLinks.length + "</span>";
-      return tags ? '<span class="tags">' + tags + "</span>" : "";
-    }
-    function renderList(nodes) {
-      var list = document.getElementById("list");
-      var meta = document.getElementById("list-meta");
-      meta.textContent = nodes.length + " / " + payload.nodes.length + " pages" + (nodes.length > 200 ? " (showing first 200)" : "");
-      list.innerHTML = nodes.slice(0, 200).map(function (node) {
-        return '<button class="node" aria-current="' + (node.file === state.selected ? "true" : "false") + '" data-file="' + escapeAttr(node.file) + '"><span class="node-title">' + escapeHtml(node.title) + '</span><span class="node-meta">' + escapeHtml(node.type + " - " + node.file) + "</span>" + tagsFor(node) + "</button>";
-      }).join("");
-      list.querySelectorAll("button.node").forEach(function (button) { button.addEventListener("click", function () { state.selected = button.dataset.file; render(); }); });
-    }
-    function renderDetail() {
-      var node = byFile.get(state.selected) || payload.nodes[0];
-      var detail = document.getElementById("detail");
-      if (!node) { detail.innerHTML = ""; return; }
-      function linkRow(file, kind) { var n = byFile.get(file); return '<button class="link" data-file="' + escapeAttr(file) + '">' + escapeHtml(n ? n.title : file) + ' <span class="kind">' + escapeHtml(kind) + "</span></button>"; }
-      var incoming = payload.edges.filter(function (edge) { return edge.target === node.file; }).map(function (edge) { return linkRow(edge.source, edge.kind); });
-      var outgoing = payload.edges.filter(function (edge) { return edge.source === node.file; }).map(function (edge) { return linkRow(edge.target, edge.kind); });
-      var brokenHtml = (node.brokenLinks || []).length ? '<strong>Broken links</strong><ul class="links">' + node.brokenLinks.map(function (b) { return "<li>" + escapeHtml(b) + "</li>"; }).join("") + "</ul>" : "";
-      detail.innerHTML = "<h2>" + escapeHtml(node.title) + "</h2>" + tagsFor(node) + "<p>" + escapeHtml(node.description || "No description") + "</p>" +
-        "<dl>" +
-        "<dt>Path</dt><dd>" + escapeHtml(node.file) + "</dd>" +
-        "<dt>Type</dt><dd>" + escapeHtml(node.type) + "</dd>" +
-        "<dt>Scope</dt><dd>" + escapeHtml(node.scope) + "</dd>" +
-        "<dt>Status</dt><dd>" + escapeHtml(node.status) + "</dd>" +
-        "<dt>Budget</dt><dd>" + escapeHtml(node.budget) + "</dd>" +
-        "<dt>Router</dt><dd>" + escapeHtml(node.routerDepth === null ? "unreachable" : "depth " + node.routerDepth) + "</dd>" +
-        "<dt>Updated</dt><dd>" + escapeHtml(node.timestamp || "-") + "</dd>" +
-        "<dt>Trigger</dt><dd>" + escapeHtml(node.reviewTrigger || "-") + "</dd>" +
-        "</dl>" +
-        "<strong>Incoming</strong><ul class=\\"links\\">" + (incoming.length ? incoming.join("") : "<li>none</li>") + "</ul>" +
-        "<strong>Outgoing</strong><ul class=\\"links\\">" + (outgoing.length ? outgoing.join("") : "<li>none</li>") + "</ul>" +
-        brokenHtml;
-      detail.querySelectorAll("button.link").forEach(function (button) { button.addEventListener("click", function () { state.selected = button.dataset.file; render(); }); });
-    }
-    function render() {
-      var nodes = filteredNodes();
-      if (state.selected && !nodes.some(function (node) { return node.file === state.selected; })) state.selected = "";
-      renderList(nodes);
-      renderGraph(nodes);
-      renderDetail();
-    }
-
-    var svgEl = document.getElementById("graph");
-    svgEl.addEventListener("wheel", function (e) { e.preventDefault(); var rect = svgEl.getBoundingClientRect(); zoomAt(e.clientX - rect.left, e.clientY - rect.top, e.deltaY < 0 ? 1.12 : 1 / 1.12); }, { passive: false });
-    svgEl.addEventListener("pointerdown", function (e) {
-      down = { x: e.clientX, y: e.clientY }; moved = false;
-      downOnPoint = !!(e.target.closest && e.target.closest("g.node"));
-      if (!downOnPoint) { dragging = true; last = { x: e.clientX, y: e.clientY }; svgEl.classList.add("panning"); }
-    });
-    svgEl.addEventListener("pointermove", function (e) {
-      if (down && (Math.abs(e.clientX - down.x) + Math.abs(e.clientY - down.y)) > 4) moved = true;
-      if (dragging) { view.x += e.clientX - last.x; view.y += e.clientY - last.y; last = { x: e.clientX, y: e.clientY }; applyView(); }
-    });
-    svgEl.addEventListener("pointerup", function () {
-      if (dragging) { dragging = false; svgEl.classList.remove("panning"); }
-      if (!moved && !downOnPoint && state.selected) { state.selected = ""; render(); }
-      down = null;
-    });
-    svgEl.addEventListener("pointerleave", function () { if (dragging) { dragging = false; svgEl.classList.remove("panning"); } });
-    window.addEventListener("resize", render);
-    render();
-  </script>
-</body>
-</html>
-`;
-}
-function normalizedVisualizerOutput(outputPath) {
-    const normalized = (0, workspace_1.normalizePath)(path.normalize(outputPath || exports.defaultWikiVisualizerOutput));
-    if (path.isAbsolute(outputPath) || normalized.startsWith("../") || normalized === "..") {
-        throw new Error(`--wiki-visualize-out must be a repository-relative path under .project-wiki/: ${outputPath}`);
-    }
-    if (!normalized.startsWith(".project-wiki/")) {
-        throw new Error(`--wiki-visualize-out must stay under .project-wiki/: ${outputPath}`);
-    }
-    return normalized;
-}
-function writeWikiVisualizer(outputPath = exports.defaultWikiVisualizerOutput) {
-    const files = (0, wiki_files_1.wikiMarkdownFiles)();
-    if (files.length === 0)
-        throw new Error("wiki directory has no markdown files; run Project Librarian before --wiki-visualize.");
-    const pages = files.map((file) => ({ file, text: (0, workspace_1.read)(file) }));
-    const payload = buildWikiVisualizerPayload(pages);
-    const relativeOutput = normalizedVisualizerOutput(outputPath);
-    (0, workspace_1.write)(relativeOutput, renderWikiVisualizerHtml(payload));
-    return (0, workspace_1.normalizePath)(path.relative(workspace_1.root, path.join(workspace_1.root, relativeOutput)));
-}