project-librarian 0.3.0 → 0.4.0

package/dist/code-index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CodeEvidenceIndexUnavailableError = void 0;
+exports.CodeEvidenceIndexUnavailableError = exports.codeContextPackTruncationNotice = exports.codeContextPackCharCap = void 0;
 exports.codeIndexStaleness = codeIndexStaleness;
 exports.codeownerRules = codeownerRules;
 exports.matchedCodeownerRules = matchedCodeownerRules;
@@ -43,8 +43,10 @@ exports.evidenceCoverage = evidenceCoverage;
 exports.workspaceSummary = workspaceSummary;
 exports.workspaceDependencyGraph = workspaceDependencyGraph;
 exports.codeReportMetadata = codeReportMetadata;
-exports.codeImpact = codeImpact;
 exports.searchSymbols = searchSymbols;
+exports.codeImpact = codeImpact;
+exports.codeContextPack = codeContextPack;
+exports.codeIndexSnapshot = codeIndexSnapshot;
 exports.openCodeEvidenceDatabaseForServing = openCodeEvidenceDatabaseForServing;
 exports.runCodeIndexMode = runCodeIndexMode;
 exports.runCodeQueryMode = runCodeQueryMode;
@@ -52,6 +54,7 @@ exports.runCodeReportMode = runCodeReportMode;
 exports.runCodeStatusMode = runCodeStatusMode;
 exports.runCodeFilesMode = runCodeFilesMode;
 exports.runCodeImpactMode = runCodeImpactMode;
+exports.runCodeContextPackMode = runCodeContextPackMode;
 exports.runCodeSearchSymbolMode = runCodeSearchSymbolMode;
 exports.isCodeEvidenceMode = isCodeEvidenceMode;
 exports.isCodeEvidenceModeFor = isCodeEvidenceModeFor;
@@ -64,6 +67,8 @@ const code_index_db_1 = require("./code-index-db");
 const code_index_file_policy_1 = require("./code-index-file-policy");
 const code_index_sql_1 = require("./code-index-sql");
 const workspace_1 = require("./workspace");
+exports.codeContextPackCharCap = 4000;
+exports.codeContextPackTruncationNotice = "[truncated - refine the query]";
 const codeIndexSchemaVersion = "3";
 const httpMethods = new Set(["all", "delete", "get", "patch", "post", "put"]);
 const treeSitterGrammarPackages = {
@@ -1576,14 +1581,138 @@ function codeReportForRequestedSection(database) {
         data: codeReportSectionData(database, section),
     };
 }
+function escapeLikeTerm(term) {
+    return term.replace(/[\\%_]/g, (match) => `\\${match}`);
+}
+function containsLikePattern(term) {
+    return `%${escapeLikeTerm(term)}%`;
+}
+function prefixLikePattern(term) {
+    return `${escapeLikeTerm(term)}%`;
+}
+function ftsPrefixQuery(term) {
+    const tokens = Array.from(new Set(term.match(/[\p{L}\p{N}_]+/gu) ?? []));
+    return tokens.slice(0, 8).map((token) => `"${token.replace(/"/g, "\"\"")}"*`).join(" AND ");
+}
+function stringValue(row, key) {
+    const value = row[key];
+    return typeof value === "string" || typeof value === "number" ? String(value) : "";
+}
+function addRankedRow(rowsByKey, row, key, score) {
+    const current = rowsByKey.get(key);
+    if (!current || score > current.score)
+        rowsByKey.set(key, { row, score });
+}
+function rankedRows(rowsByKey, limit, stableKeys) {
+    return Array.from(rowsByKey.values())
+        .sort((left, right) => {
+        const scoreDelta = right.score - left.score;
+        if (scoreDelta !== 0)
+            return scoreDelta;
+        for (const key of stableKeys) {
+            const compared = stringValue(left.row, key).localeCompare(stringValue(right.row, key));
+            if (compared !== 0)
+                return compared;
+        }
+        return 0;
+    })
+        .slice(0, limit)
+        .map((ranked) => ranked.row);
+}
+function searchFiles(database, term, limit = 25) {
+    const normalized = term.trim();
+    if (!normalized)
+        return [];
+    const contains = containsLikePattern(normalized);
+    const prefix = prefixLikePattern(normalized);
+    const rowsByKey = new Map();
+    const exactRows = database.prepare("SELECT path, language, profile, lines, bytes FROM files WHERE path = ? ORDER BY path LIMIT ?").all(normalized, limit);
+    exactRows.forEach((row) => addRankedRow(rowsByKey, row, stringValue(row, "path"), 900));
+    const prefixRows = database.prepare("SELECT path, language, profile, lines, bytes FROM files WHERE path LIKE ? ESCAPE '\\' ORDER BY path LIMIT ?").all(prefix, limit);
+    prefixRows.forEach((row) => addRankedRow(rowsByKey, row, stringValue(row, "path"), 750));
+    const ftsQuery = ftsPrefixQuery(normalized);
+    if (ftsQuery) {
+        const ftsRows = database.prepare(`
+      SELECT files.path, files.language, files.profile, files.lines, files.bytes
+      FROM files_fts
+      JOIN files ON files.path = files_fts.path
+      WHERE files_fts MATCH ?
+      ORDER BY bm25(files_fts, 8.0, 1.0, 1.0, 0.25), files.path
+      LIMIT ?
+    `).all(ftsQuery, limit);
+        ftsRows.forEach((row, index) => addRankedRow(rowsByKey, row, stringValue(row, "path"), 650 - index));
+    }
+    const containsRows = database.prepare("SELECT path, language, profile, lines, bytes FROM files WHERE path LIKE ? ESCAPE '\\' ORDER BY path LIMIT ?").all(contains, limit);
+    containsRows.forEach((row) => addRankedRow(rowsByKey, row, stringValue(row, "path"), 500));
+    return rankedRows(rowsByKey, limit, ["path"]);
+}
+function symbolKey(row) {
+    return [
+        stringValue(row, "file_path"),
+        stringValue(row, "line"),
+        stringValue(row, "kind"),
+        stringValue(row, "name"),
+        stringValue(row, "signature"),
+    ].join("\u0000");
+}
+function searchSymbols(database, term, limit = 50) {
+    const normalized = term.trim();
+    if (!normalized)
+        return [];
+    const contains = containsLikePattern(normalized);
+    const prefix = prefixLikePattern(normalized);
+    const rowsByKey = new Map();
+    const exactRows = database.prepare(`
+    SELECT name, kind, file_path, line, signature
+    FROM symbols
+    WHERE name = ? OR signature = ?
+    ORDER BY file_path, line
+    LIMIT ?
+  `).all(normalized, normalized, limit);
+    exactRows.forEach((row) => addRankedRow(rowsByKey, row, symbolKey(row), 1000));
+    const prefixRows = database.prepare(`
+    SELECT name, kind, file_path, line, signature
+    FROM symbols
+    WHERE name LIKE ? ESCAPE '\\' OR signature LIKE ? ESCAPE '\\'
+    ORDER BY file_path, line
+    LIMIT ?
+  `).all(prefix, prefix, limit);
+    prefixRows.forEach((row) => addRankedRow(rowsByKey, row, symbolKey(row), 850));
+    const ftsQuery = ftsPrefixQuery(normalized);
+    if (ftsQuery) {
+        const ftsRows = database.prepare(`
+      SELECT symbols.name, symbols.kind, symbols.file_path, symbols.line, symbols.signature
+      FROM symbols_fts
+      JOIN symbols
+        ON symbols.name = symbols_fts.name
+       AND symbols.kind = symbols_fts.kind
+       AND symbols.file_path = symbols_fts.file_path
+       AND symbols.signature = symbols_fts.signature
+      WHERE symbols_fts MATCH ?
+      ORDER BY bm25(symbols_fts, 8.0, 1.0, 4.0, 2.0), symbols.file_path, symbols.line
+      LIMIT ?
+    `).all(ftsQuery, limit);
+        ftsRows.forEach((row, index) => addRankedRow(rowsByKey, row, symbolKey(row), 700 - index));
+    }
+    const containsRows = database.prepare(`
+    SELECT name, kind, file_path, line, signature
+    FROM symbols
+    WHERE name LIKE ? ESCAPE '\\' OR signature LIKE ? ESCAPE '\\' OR file_path LIKE ? ESCAPE '\\'
+    ORDER BY file_path, line
+    LIMIT ?
+  `).all(contains, contains, contains, limit);
+    containsRows.forEach((row) => addRankedRow(rowsByKey, row, symbolKey(row), 500));
+    return rankedRows(rowsByKey, limit, ["file_path", "line", "kind", "name", "signature"]);
+}
 function codeImpact(database, target) {
-    const like = `%${target}%`;
-    const fileMatches = database.prepare("SELECT path, language, profile, lines, bytes FROM files WHERE path LIKE ? ORDER BY path LIMIT 25").all(like);
-    const symbolMatches = database.prepare("SELECT name, kind, file_path, line, signature FROM symbols WHERE name LIKE ? OR signature LIKE ? OR file_path LIKE ? ORDER BY file_path, line LIMIT 50").all(like, like, like);
-    const routeMatches = database.prepare("SELECT method, route, file_path, line, handler FROM routes WHERE route LIKE ? OR handler LIKE ? OR file_path LIKE ? ORDER BY file_path, line LIMIT 50").all(like, like, like);
-    const importMatches = database.prepare("SELECT from_file, to_ref, imported, line, raw FROM imports WHERE from_file LIKE ? OR to_ref LIKE ? OR imported LIKE ? ORDER BY from_file, line LIMIT 75").all(like, like, like);
-    const outgoingEdges = database.prepare("SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE file_path LIKE ? OR source LIKE ? ORDER BY file_path, line LIMIT 100").all(like, like);
-    const incomingEdges = database.prepare("SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE target LIKE ? ORDER BY file_path, line LIMIT 100").all(like);
+    const normalized = target.trim();
+    const like = containsLikePattern(normalized);
+    const fileMatches = searchFiles(database, normalized, 25);
+    const symbolMatches = searchSymbols(database, normalized, 50);
+    const routeMatches = database.prepare("SELECT method, route, file_path, line, handler FROM routes WHERE route LIKE ? ESCAPE '\\' OR handler LIKE ? ESCAPE '\\' OR file_path LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT 50").all(like, like, like);
+    const importMatches = database.prepare("SELECT from_file, to_ref, imported, line, raw FROM imports WHERE from_file LIKE ? ESCAPE '\\' OR to_ref LIKE ? ESCAPE '\\' OR imported LIKE ? ESCAPE '\\' ORDER BY from_file, line LIMIT 75").all(like, like, like);
+    const outgoingEdges = database.prepare("SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE file_path LIKE ? ESCAPE '\\' OR source LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT 100").all(like, like);
+    const incomingEdges = database.prepare("SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE target LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT 100").all(like);
     const routeTargets = routeMatches.map((row) => `${String(row.method)} ${String(row.route)}`);
     const routeEdges = routeTargets.length === 0 ? [] : database.prepare(`SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE source IN (${routeTargets.map(() => "?").join(", ")}) ORDER BY file_path, line LIMIT 100`).all(...routeTargets);
     const relatedFilePaths = Array.from(new Set([
@@ -1638,11 +1767,117 @@ function codeImpact(database, target) {
         })).sort((left, right) => right.files - left.files || left.owner.localeCompare(right.owner)),
     };
 }
-// Symbol search reusing the exact SELECT behind --code-search-symbol so the MCP
-// code_search tool returns identical rows without duplicating the query string.
-function searchSymbols(database, term) {
-    const like = `%${term}%`;
-    return database.prepare("SELECT name, kind, file_path, line, signature FROM symbols WHERE name LIKE ? OR signature LIKE ? ORDER BY file_path, line LIMIT 50").all(like, like);
+function sampleLines(items, limit, render) {
+    const lines = items.slice(0, limit).map(render);
+    if (items.length > limit)
+        lines.push(`  ...+${items.length - limit} more`);
+    return lines;
+}
+function pushBudgetedLine(lines, line) {
+    const candidate = [...lines, line].join("\n");
+    if (candidate.length > exports.codeContextPackCharCap)
+        return false;
+    lines.push(line);
+    return true;
+}
+function pushBudgetedSection(lines, title, items, limit, render) {
+    if (items.length === 0)
+        return;
+    if (!pushBudgetedLine(lines, title))
+        return;
+    for (const line of sampleLines(items, limit, render)) {
+        if (!pushBudgetedLine(lines, line)) {
+            pushBudgetedLine(lines, "  ...more omitted; refine the query");
+            return;
+        }
+    }
+}
+function finalizeCodeContextPack(body) {
+    if (body.length <= exports.codeContextPackCharCap)
+        return body;
+    const budget = exports.codeContextPackCharCap - exports.codeContextPackTruncationNotice.length - 1;
+    return `${body.slice(0, budget > 0 ? budget : 0).trimEnd()}\n${exports.codeContextPackTruncationNotice}`;
+}
+function codeContextScaleLine(fileCount) {
+    return fileCount < code_index_file_policy_1.SMALL_REPO_FILE_THRESHOLD
+        ? `scale small (${fileCount} indexed files < ${code_index_file_policy_1.SMALL_REPO_FILE_THRESHOLD}); direct reads are usually cheaper for simple lookups`
+        : `scale large (${fileCount} indexed files >= ${code_index_file_policy_1.SMALL_REPO_FILE_THRESHOLD}); indexed traversal is useful for impact-style context`;
+}
+function structuralSignature(value) {
+    const signature = oneLine(String(value ?? ""));
+    const bodyStart = signature.indexOf("{");
+    return bodyStart >= 0 ? signature.slice(0, bodyStart).trimEnd() : signature;
+}
+function sortedUnique(values) {
+    return Array.from(new Set(values.filter(Boolean))).sort();
+}
+function codeContextPack(database, query) {
+    const normalized = query.trim();
+    if (!normalized)
+        return 'Code context pack: missing query; use --code-context-pack "path-or-symbol-or-route".';
+    const like = containsLikePattern(normalized);
+    const files = searchFiles(database, normalized, 12);
+    const symbols = searchSymbols(database, normalized, 20);
+    const routes = database.prepare("SELECT method, route, file_path, line, handler FROM routes WHERE route LIKE ? ESCAPE '\\' OR handler LIKE ? ESCAPE '\\' OR file_path LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT 20").all(like, like, like);
+    const imports = database.prepare("SELECT from_file, to_ref, imported, line, raw FROM imports WHERE from_file LIKE ? ESCAPE '\\' OR to_ref LIKE ? ESCAPE '\\' OR imported LIKE ? ESCAPE '\\' ORDER BY from_file, line LIMIT 30").all(like, like, like);
+    const outgoingEdges = database.prepare("SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE file_path LIKE ? ESCAPE '\\' OR source LIKE ? ESCAPE '\\' OR evidence LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT 30").all(like, like, like);
+    const incomingEdges = database.prepare("SELECT kind, source_kind, source, target_kind, target, file_path, line, evidence FROM edges WHERE target LIKE ? ESCAPE '\\' OR evidence LIKE ? ESCAPE '\\' ORDER BY file_path, line LIMIT 30").all(like, like);
+    const relatedFilePaths = sortedUnique([
+        ...files.map((row) => String(row.path ?? "")),
+        ...symbols.map((row) => String(row.file_path ?? "")),
+        ...routes.map((row) => String(row.file_path ?? "")),
+        ...imports.map((row) => String(row.from_file ?? "")),
+        ...outgoingEdges.map((row) => String(row.file_path ?? "")),
+        ...incomingEdges.map((row) => String(row.file_path ?? "")),
+    ]);
+    const ownership = ownershipContext();
+    const ownerRows = new Map();
+    for (const filePath of relatedFilePaths) {
+        const info = ownershipInfo(filePath, ownership);
+        const current = ownerRows.get(info.owner) ?? { files: 0, owner: info.owner, owner_source: info.owner_source, sample_files: [] };
+        current.files += 1;
+        if (current.sample_files.length < 4)
+            current.sample_files.push(filePath);
+        ownerRows.set(info.owner, current);
+    }
+    const owners = Array.from(ownerRows.values()).sort((left, right) => right.files - left.files || left.owner.localeCompare(right.owner));
+    const staleness = codeIndexStaleness(database);
+    const coverage = evidenceCoverage(database);
+    const staleLabel = staleness.stale
+        ? `STALE ${staleness.changed} changed, ${staleness.added} added, ${staleness.deleted} deleted`
+        : "fresh";
+    const lines = [
+        `Code context pack "${normalized}": ${files.length} file matches, ${symbols.length} symbols, ${routes.length} routes, ${imports.length} imports, ${incomingEdges.length} incoming / ${outgoingEdges.length} outgoing edges; index ${staleLabel}; ${codeContextScaleLine(Number(coverage.files ?? 0))}.`,
+        "Evidence is structural only: paths, lines, signatures, routes, imports, edges, and owners; no source snippets are included.",
+    ];
+    pushBudgetedSection(lines, "Files:", files, 8, (row) => `  file-match ${String(row.path)} (${String(row.language)}, ${String(row.profile)}, ${Number(row.lines ?? 0)} lines)`);
+    pushBudgetedSection(lines, "Symbols:", symbols, 12, (row) => `  symbol-match ${String(row.file_path)}:${String(row.line)} ${String(row.kind)} ${String(row.name)} - ${structuralSignature(row.signature)}`);
+    pushBudgetedSection(lines, "Routes:", routes, 8, (row) => `  route-match ${String(row.method)} ${String(row.route)} -> ${String(row.handler)} (${String(row.file_path)}:${String(row.line)})`);
+    pushBudgetedSection(lines, "Imports:", imports, 8, (row) => `  import-match ${String(row.from_file)}:${String(row.line)} -> ${String(row.to_ref)}${row.imported ? ` (${String(row.imported)})` : ""}`);
+    pushBudgetedSection(lines, "Incoming edges:", incomingEdges, 8, (row) => `  edge-in ${String(row.kind)} ${String(row.source)} -> ${String(row.target)} (${String(row.file_path)}:${String(row.line)})`);
+    pushBudgetedSection(lines, "Outgoing edges:", outgoingEdges, 8, (row) => `  edge-out ${String(row.kind)} ${String(row.source)} -> ${String(row.target)} (${String(row.file_path)}:${String(row.line)})`);
+    pushBudgetedSection(lines, "Owners:", owners, 6, (row) => `  owner ${row.owner} (${row.owner_source}, ${row.files} files): ${row.sample_files.join(", ")}`);
+    return finalizeCodeContextPack(lines.join("\n"));
+}
+function snapshotRows(database, sql) {
+    return database.prepare(sql).all().map((row) => {
+        const normalized = {};
+        for (const key of Object.keys(row).sort()) {
+            const value = row[key];
+            normalized[key] = typeof value === "string" || typeof value === "number" || value === null ? value : String(value);
+        }
+        return normalized;
+    });
+}
+function codeIndexSnapshot(database) {
+    return {
+        configs: snapshotRows(database, "SELECT file_path, line, key, value FROM configs ORDER BY file_path, line, key, value"),
+        edges: snapshotRows(database, "SELECT file_path, line, kind, source_kind, source, target_kind, target, evidence FROM edges ORDER BY file_path, line, kind, source, target, evidence"),
+        files: snapshotRows(database, "SELECT path, language, profile, kind, lines, bytes FROM files ORDER BY path"),
+        imports: snapshotRows(database, "SELECT from_file, line, to_ref, imported, raw FROM imports ORDER BY from_file, line, to_ref, imported, raw"),
+        routes: snapshotRows(database, "SELECT file_path, line, method, route, handler FROM routes ORDER BY file_path, line, method, route, handler"),
+        symbols: snapshotRows(database, "SELECT file_path, line, kind, name, signature FROM symbols ORDER BY file_path, line, kind, name, signature"),
+    };
 }
 // Error thrown when the code-evidence index is missing or schema-incompatible.
 // The MCP server catches this to return an isError tool result (tools/list still
@@ -1844,6 +2079,21 @@ function runCodeImpactMode() {
         database.close();
     }
 }
+function runCodeContextPackMode() {
+    if (!args_1.codeContextPackTarget.trim()) {
+        console.error("missing context pack query: use --code-context-pack \"path-or-symbol-or-route\"");
+        process.exit(1);
+    }
+    requireExistingIndex();
+    const database = openDatabase(codeEvidenceDatabasePath().absolutePath);
+    try {
+        warnIfCodeIndexStale(database);
+        console.log(codeContextPack(database, args_1.codeContextPackTarget.trim()));
+    }
+    finally {
+        database.close();
+    }
+}
 function runCodeSearchSymbolMode() {
     if (!args_1.codeSearchSymbol.trim()) {
         console.error("missing symbol search term: use --code-search-symbol \"term\"");
@@ -1853,18 +2103,18 @@ function runCodeSearchSymbolMode() {
     const database = openDatabase(codeEvidenceDatabasePath().absolutePath);
     try {
         warnIfCodeIndexStale(database);
-        const like = `%${args_1.codeSearchSymbol}%`;
-        printRows(database.prepare("SELECT name, kind, file_path, line, signature FROM symbols WHERE name LIKE ? OR signature LIKE ? ORDER BY file_path, line LIMIT 50").all(like, like));
+        printRows(searchSymbols(database, args_1.codeSearchSymbol.trim()));
     }
     finally {
         database.close();
     }
 }
 function isCodeEvidenceMode() {
-    return isCodeEvidenceModeFor({ codeFilesMode: args_1.codeFilesMode, codeImpactMode: args_1.codeImpactMode, codeIndexMode: args_1.codeIndexMode, codeQuerySql: args_1.codeQuerySql, codeReportMode: args_1.codeReportMode, codeSearchSymbol: args_1.codeSearchSymbol, codeStatusMode: args_1.codeStatusMode });
+    return isCodeEvidenceModeFor({ codeContextPackTarget: args_1.codeContextPackTarget, codeFilesMode: args_1.codeFilesMode, codeImpactMode: args_1.codeImpactMode, codeIndexMode: args_1.codeIndexMode, codeQuerySql: args_1.codeQuerySql, codeReportMode: args_1.codeReportMode, codeSearchSymbol: args_1.codeSearchSymbol, codeStatusMode: args_1.codeStatusMode });
 }
 function isCodeEvidenceModeFor(flags) {
-    return flags.codeIndexMode
+    return Boolean(flags.codeContextPackTarget)
+        || flags.codeIndexMode
         || Boolean(flags.codeQuerySql)
         || flags.codeReportMode
         || flags.codeStatusMode

package/dist/init-project-wiki.js

@@ -7,13 +7,14 @@ const install_skill_1 = require("./install-skill");
 const modes_1 = require("./modes");
 const migration_1 = require("./migration");
 const templates_1 = require("./templates");
+const wiki_visualizer_1 = require("./wiki-visualizer");
 const workspace_1 = require("./workspace");
 function codeIndex() {
     return require("./code-index");
 }
 function printUsage() {
     console.log(`Usage:
-  project-librarian [init] [options]
+  project-librarian [init|update] [options]
   project-librarian install-skill [--scope user|project] [--agents codex|claude|cursor|gemini|all]
   project-librarian mcp
 
@@ -33,6 +34,8 @@ Options:
   --issue-title <title>            Override the generated issue draft title.
   --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.
   --refresh-index                  Update the managed auto-discovered wiki index block.
   --capture-inbox                  Append a candidate note with --title, --content, and optional --category.
   --glossary-init                  Create and route the optional glossary page.
@@ -49,10 +52,12 @@ Options:
   --code-report                    Print architecture and ownership summaries from the code evidence index.
   --code-report-section <section>  With --code-report, print one section: coverage, ownership, languages, parsers, workspaces, workspace-graph, routes, hotspots, configs, or edges.
   --code-impact <term>             Show file, symbol, route, import, and edge impact evidence for a term.
+  --code-context-pack <term>       Print a budgeted first-pass code context pack for a path, symbol, route, or module term.
   --code-search-symbol <term>      Search indexed symbols.
 
 Commands:
-  mcp                              Run the stdio MCP server exposing answer-shaped code-evidence tools (code_impact, code_ownership, code_workspace_graph, code_search, code_status) over the existing .project-wiki index.
+  update                           Run the idempotent wiki/setup update path; rejects migration flags.
+  mcp                              Run the stdio MCP server exposing answer-shaped code-evidence tools (code_context_pack, code_impact, code_ownership, code_workspace_graph, code_search, code_status) over the existing .project-wiki index.
 
   --help                           Show this help.`);
 }
@@ -87,6 +92,10 @@ if (args_1.missingValueOptions.length > 0) {
     printUsage();
     process.exit(1);
 }
+if (args_1.command === "update" && args_1.migrateMode) {
+    console.error("update cannot be combined with --migrate or --adopt-existing; use project-librarian --migrate for migration.");
+    process.exit(1);
+}
 if (args_1.fixMode && !args_1.doctorMode) {
     console.error("--fix is only supported with --doctor.");
     process.exit(1);
@@ -99,6 +108,10 @@ 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.codeIndexIncrementalMode && !args_1.codeIndexMode) {
     console.error("--incremental is only supported with --code-index.");
     process.exit(1);
@@ -134,9 +147,9 @@ else {
     runInitCommand();
 }
 function runInitCommand() {
-    const activeCodeModes = [args_1.codeQueryMode, args_1.codeReportMode, args_1.codeStatusMode, args_1.codeFilesMode, args_1.codeImpactMode, args_1.codeSearchSymbolMode, args_1.codeIndexMode].filter(Boolean).length;
+    const activeCodeModes = [args_1.codeQueryMode, args_1.codeReportMode, args_1.codeStatusMode, args_1.codeFilesMode, args_1.codeImpactMode, args_1.codeContextPackMode, args_1.codeSearchSymbolMode, args_1.codeIndexMode].filter(Boolean).length;
     if (activeCodeModes > 1) {
-        console.error("Use one code evidence mode at a time: --code-index, --code-query, --code-report, --code-status, --code-files, --code-impact, or --code-search-symbol.");
+        console.error("Use one code evidence mode at a time: --code-index, --code-query, --code-report, --code-status, --code-files, --code-impact, --code-context-pack, or --code-search-symbol.");
         process.exit(1);
     }
     if (args_1.codeQueryMode) {
@@ -164,6 +177,11 @@ function runInitCommand() {
         exitAfterStdoutDrain(0);
         return;
     }
+    if (args_1.codeContextPackMode) {
+        codeIndex().runCodeContextPackMode();
+        exitAfterStdoutDrain(0);
+        return;
+    }
     if (args_1.codeSearchSymbolMode) {
         codeIndex().runCodeSearchSymbolMode();
         exitAfterStdoutDrain(0);
@@ -178,6 +196,18 @@ 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);
+        }
+        return;
+    }
     if (args_1.queryTerm) {
         (0, modes_1.runQueryMode)();
         exitAfterStdoutDrain(0);