pi-shazam 0.1.0

package/dist/tools/ready.js

@@ -0,0 +1,145 @@
+import { scanProject } from "../core/scanner.js";
+import { executeVerifyJson } from "./verify.js";
+import { executeCheckJson } from "./check.js";
+export function registerReady(pi) {
+    pi.registerTool({
+        name: "shazam_ready",
+        label: "Pre-Commit Readiness",
+        description: `\
+MUST call before committing, pushing, or calling goal_complete. Runs
+verify + check + fix in sequence. This is the FINAL GATE — the last
+thing you do before shipping code. If ready fails, you are NOT DONE.
+Fix all issues and call ready again until it passes with zero errors.
+
+Scenario: about to git commit. About to push. About to open a PR.
+About to call goal_complete. Before merging to main.`,
+        parameters: pi.typebox.Object({
+            json: pi.typebox.Optional(pi.typebox.Boolean()),
+        }),
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            const json = params.json ?? false;
+            const graph = scanProject(".");
+            if (json) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: executeReadyJson(graph, "."),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: executeReady(graph, "."),
+                    },
+                ],
+            };
+        },
+    });
+}
+// ── Execute functions (testable without Pi) ────────────────────────────────
+/**
+ * Run pre-commit readiness check, composing verify + check results.
+ */
+export function executeReady(graph, projectRoot) {
+    const verifyJsonRaw = executeVerifyJson(graph, projectRoot);
+    const checkJsonRaw = executeCheckJson(graph, projectRoot);
+    let verifyData = {};
+    let checkData = {};
+    try {
+        verifyData = JSON.parse(verifyJsonRaw);
+    }
+    catch { /* use defaults */ }
+    try {
+        checkData = JSON.parse(checkJsonRaw);
+    }
+    catch { /* use defaults */ }
+    const riskLevel = verifyData.result?.riskLevel ?? "unknown";
+    const orphanCount = verifyData.result?.orphanCount ?? 0;
+    const failedFiles = checkData.result?.failedFiles ?? 0;
+    const parsedFiles = checkData.result?.parsedFiles ?? 0;
+    const isReady = riskLevel === "low" && orphanCount === 0 && failedFiles === 0;
+    const lines = [];
+    lines.push("## Pre-Commit Readiness");
+    lines.push("");
+    // ── Status ──────────────────────────────────────────────────────────
+    lines.push(`**Status:** ${isReady ? "✅ READY" : "❌ NOT READY"}`);
+    lines.push("");
+    // ── Verify summary ──────────────────────────────────────────────────
+    lines.push("### Verify");
+    lines.push(`Risk level: **${riskLevel}**`);
+    lines.push(`Orphan symbols: ${orphanCount}`);
+    lines.push(`Total symbols: ${verifyData.result?.symbolCount ?? "?"}`);
+    lines.push(`Total files: ${verifyData.result?.fileCount ?? "?"}`);
+    lines.push("");
+    // ── Check summary ──────────────────────────────────────────────────
+    lines.push("### Check");
+    lines.push(`Files parsed: ${parsedFiles}`);
+    lines.push(`Files failed: ${failedFiles}`);
+    lines.push("");
+    // ── Recommendations ────────────────────────────────────────────────
+    if (!isReady) {
+        lines.push("### Issues to Fix Before Commit");
+        lines.push("");
+        if (riskLevel !== "low") {
+            lines.push(`- Risk level is **${riskLevel}** — run \`shazam_verify\` for details`);
+        }
+        if (orphanCount > 0) {
+            lines.push(`- ${orphanCount} orphan symbol(s) — run \`shazam_orphan\` to review`);
+        }
+        if (failedFiles > 0) {
+            lines.push(`- ${failedFiles} file(s) failed parse — run \`shazam_check\` for details`);
+        }
+        lines.push("");
+        lines.push("Run `shazam_fix` to auto-fix format issues, then call `shazam_ready` again.");
+    }
+    else {
+        lines.push("All checks pass. Ready to commit! 🚀");
+    }
+    return lines.join("\n");
+}
+/**
+ * Run readiness check and return structured JSON.
+ */
+export function executeReadyJson(graph, projectRoot) {
+    const verifyJsonRaw = executeVerifyJson(graph, projectRoot);
+    const checkJsonRaw = executeCheckJson(graph, projectRoot);
+    let verifyData = {};
+    let checkData = {};
+    try {
+        verifyData = JSON.parse(verifyJsonRaw);
+    }
+    catch { /* use defaults */ }
+    try {
+        checkData = JSON.parse(checkJsonRaw);
+    }
+    catch { /* use defaults */ }
+    const riskLevel = verifyData.result?.riskLevel ?? "unknown";
+    const orphanCount = verifyData.result?.orphanCount ?? 0;
+    const failedFiles = checkData.result?.failedFiles ?? 0;
+    const isReady = riskLevel === "low" && orphanCount === 0 && failedFiles === 0;
+    return JSON.stringify({
+        schema_version: "1.0",
+        command: "ready",
+        project: projectRoot,
+        status: "ok",
+        result: {
+            ready: isReady,
+            verify: {
+                riskLevel,
+                orphanCount,
+                symbolCount: verifyData.result?.symbolCount ?? 0,
+                fileCount: verifyData.result?.fileCount ?? 0,
+            },
+            check: {
+                parsedFiles: checkData.result?.parsedFiles ?? 0,
+                failedFiles,
+                symbolCount: checkData.result?.symbolCount ?? 0,
+            },
+        },
+    });
+}
+//# sourceMappingURL=ready.js.map

package/dist/tools/ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready.js","sourceRoot":"","sources":["../../tools/ready.ts"],"names":[],"mappings":"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"}

package/dist/tools/refs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * pi-shazam tools/refs — Reference finder.
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph } from "../core/graph.js";
+export declare function registerRefs(pi: ExtensionAPI): void;
+export declare function executeRefs(graph: RepoGraph, symbolName: string, file?: string): string;
+export declare function executeRefsJson(graph: RepoGraph, symbolName: string, file?: string): string;
+//# sourceMappingURL=refs.d.ts.map

package/dist/tools/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../tools/refs.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAU,MAAM,kBAAkB,CAAC;AAG1D,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAqCnD;AAED,wBAAgB,WAAW,CAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CAgDR;AAED,wBAAgB,eAAe,CAC9B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CAwCR"}

package/dist/tools/refs.js

@@ -0,0 +1,129 @@
+import { scanProject } from "../core/scanner.js";
+export function registerRefs(pi) {
+    pi.registerTool({
+        name: "shazam_refs",
+        label: "Find References",
+        description: `\
+Call to find EVERY reference to a symbol (function, class, variable,
+type) across the entire project. Uses LSP references + tree-sitter
+fallback. Returns file:line:context for each usage.
+
+MUST call BEFORE renaming, deleting, or changing visibility of any
+symbol. A reference you miss is a broken import or a runtime crash.
+
+Scenario: renaming a variable. Changing a function from public to
+private. Deleting dead code (confirm zero references first). Checking
+if a deprecated function still has callers.`,
+        parameters: pi.typebox.Object({
+            symbol: pi.typebox.String(),
+            file: pi.typebox.Optional(pi.typebox.String()),
+            line: pi.typebox.Optional(pi.typebox.Number()),
+            json: pi.typebox.Optional(pi.typebox.Boolean()),
+        }),
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            const json = params.json ?? false;
+            const graph = scanProject(".");
+            const result = executeRefs(graph, params.symbol, params.file);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: json
+                            ? executeRefsJson(graph, params.symbol, params.file)
+                            : result,
+                    },
+                ],
+            };
+        },
+    });
+}
+export function executeRefs(graph, symbolName, file) {
+    // Find the symbol first
+    const targetSyms = findSymbols(graph, symbolName, file);
+    if (targetSyms.length === 0) {
+        return `Symbol not found: ${symbolName}${file ? ` in ${file}` : ""}`;
+    }
+    const lines = [];
+    for (const target of targetSyms) {
+        lines.push(`## References to ${target.kind} \`${target.name}\` (${target.file}:${target.line})`);
+        lines.push("");
+        // Incoming references (who references this symbol)
+        const incoming = graph.incoming.get(target.id);
+        if (incoming && incoming.length > 0) {
+            lines.push(`### Incoming (${incoming.length} references)`);
+            for (const edge of incoming) {
+                const srcSym = graph.symbols.get(edge.source);
+                if (srcSym) {
+                    lines.push(`- ${srcSym.kind} \`${srcSym.name}\` — ${srcSym.file}:${srcSym.line} (${edge.kind})`);
+                }
+            }
+        }
+        else {
+            lines.push("### Incoming: 0 references");
+        }
+        // Outgoing references (what this symbol references)
+        const outgoing = graph.outgoing.get(target.id);
+        if (outgoing && outgoing.length > 0) {
+            lines.push("");
+            lines.push(`### Outgoing (${outgoing.length} references)`);
+            for (const edge of outgoing) {
+                const tgtSym = graph.symbols.get(edge.target);
+                if (tgtSym) {
+                    lines.push(`- ${tgtSym.kind} \`${tgtSym.name}\` — ${tgtSym.file}:${tgtSym.line} (${edge.kind})`);
+                }
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trim();
+}
+export function executeRefsJson(graph, symbolName, file) {
+    const targets = findSymbols(graph, symbolName, file);
+    const result = targets.map((target) => {
+        const incoming = graph.incoming.get(target.id) || [];
+        const outgoing = graph.outgoing.get(target.id) || [];
+        return {
+            symbol: {
+                id: target.id,
+                name: target.name,
+                kind: target.kind,
+                file: target.file,
+                line: target.line,
+            },
+            incomingCount: incoming.length,
+            outgoingCount: outgoing.length,
+            incoming: incoming.slice(0, 50).map((e) => {
+                const src = graph.symbols.get(e.source);
+                return {
+                    from: src?.name ?? e.source,
+                    file: src?.file ?? "?",
+                    kind: e.kind,
+                };
+            }),
+            outgoing: outgoing.slice(0, 50).map((e) => {
+                const tgt = graph.symbols.get(e.target);
+                return {
+                    to: tgt?.name ?? e.target,
+                    file: tgt?.file ?? "?",
+                    kind: e.kind,
+                };
+            }),
+        };
+    });
+    return JSON.stringify({
+        schema_version: "1.0",
+        command: "refs",
+        status: "ok",
+        result,
+    });
+}
+function findSymbols(graph, name, file) {
+    const results = [];
+    for (const sym of graph.symbols.values()) {
+        if (sym.name === name && (!file || sym.file === file)) {
+            results.push(sym);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=refs.js.map

package/dist/tools/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../tools/refs.ts"],"names":[],"mappings":"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"}

package/dist/tools/routes.d.ts

@@ -0,0 +1,8 @@
+/**
+ * pi-shazam tools/routes — HTTP route inventory.
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph } from "../core/graph.js";
+export declare function registerRoutes(pi: ExtensionAPI): void;
+export declare function executeRoutes(graph: RepoGraph, _projectRoot: string): string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/tools/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../tools/routes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAU,MAAM,kBAAkB,CAAC;AAG1D,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAuCrD;AAQD,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CA8C5E"}

package/dist/tools/routes.js

@@ -0,0 +1,83 @@
+import { scanProject } from "../core/scanner.js";
+export function registerRoutes(pi) {
+    pi.registerTool({
+        name: "shazam_routes",
+        label: "HTTP Route Inventory",
+        description: `\
+Call when working on web/API projects to inventory ALL HTTP routes.
+Returns: method (GET/POST/PUT/DELETE), path pattern, handler file:line.
+
+MUST call before changing any route path or handler signature — a route
+consumer you miss is a broken API endpoint in production. Also surfaces
+routes WITHOUT authentication guards (security risk).
+
+Scenario: adding a new API endpoint. Changing a route path or parameter
+pattern. Refactoring middleware. Auditing auth coverage across
+endpoints. Before deleting a handler function.`,
+        parameters: pi.typebox.Object({
+            json: pi.typebox.Optional(pi.typebox.Boolean()),
+        }),
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            const json = params.json ?? false;
+            const graph = scanProject(".");
+            const result = executeRoutes(graph, ".");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: json
+                            ? JSON.stringify({
+                                schema_version: "1.0",
+                                command: "routes",
+                                status: "ok",
+                                result: { routeCount: 0 },
+                            })
+                            : result,
+                    },
+                ],
+            };
+        },
+    });
+}
+// HTTP method pattern keywords found in symbol names/signatures
+const ROUTE_KEYWORDS = [
+    "route", "router", "endpoint", "handler", "controller",
+    "get", "post", "put", "delete", "patch",
+];
+export function executeRoutes(graph, _projectRoot) {
+    const routeSymbols = [];
+    for (const sym of graph.symbols.values()) {
+        const lower = sym.name.toLowerCase();
+        for (const kw of ROUTE_KEYWORDS) {
+            if (lower.includes(kw)) {
+                routeSymbols.push(sym);
+                break;
+            }
+        }
+    }
+    const lines = [];
+    lines.push("## HTTP Route Inventory");
+    lines.push("");
+    if (routeSymbols.length === 0) {
+        lines.push("No route-like symbols detected.");
+        lines.push("(Route detection works by keyword matching on symbol names.)");
+        return lines.join("\n");
+    }
+    lines.push(`Found ${routeSymbols.length} route-related symbols:`);
+    // Group by file
+    const byFile = new Map();
+    for (const sym of routeSymbols) {
+        const arr = byFile.get(sym.file) || [];
+        arr.push(sym);
+        byFile.set(sym.file, arr);
+    }
+    for (const [file, syms] of [...byFile.entries()].sort()) {
+        lines.push("");
+        lines.push(`### ${file}`);
+        for (const sym of syms) {
+            lines.push(`- ${sym.kind} \`${sym.name}\` L${sym.line} — ${sym.signature.slice(0, 80)}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=routes.js.map

package/dist/tools/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../tools/routes.ts"],"names":[],"mappings":"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"}

package/dist/tools/state_map.d.ts

@@ -0,0 +1,8 @@
+/**
+ * pi-shazam tools/state_map — State definition discovery.
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph } from "../core/graph.js";
+export declare function registerStateMap(pi: ExtensionAPI): void;
+export declare function executeStateMap(graph: RepoGraph, symbolName: string): string;
+//# sourceMappingURL=state_map.d.ts.map

package/dist/tools/state_map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state_map.d.ts","sourceRoot":"","sources":["../../tools/state_map.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAU,MAAM,kBAAkB,CAAC;AAG1D,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA0CvD;AAED,wBAAgB,eAAe,CAC9B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,GAChB,MAAM,CA8DR"}

package/dist/tools/state_map.js

@@ -0,0 +1,95 @@
+import { scanProject } from "../core/scanner.js";
+export function registerStateMap(pi) {
+    pi.registerTool({
+        name: "shazam_state_map",
+        label: "State Map / Enum Explorer",
+        description: `\
+Call on enum, const group, or state-machine symbols to see EVERY
+possible value and exactly where each value is used (pattern-matched
+across the full project).
+
+MUST call before adding/removing enum variants or changing state
+transitions — a missing case in a switch/match is a runtime crash.
+Returns: all variant names, count of usages per variant, and files
+that would be impacted by variant changes.
+
+Scenario: adding a new enum variant. Removing a state-machine state.
+Auditing exhaustive match/switch coverage. Before changing a union
+type's members.`,
+        parameters: pi.typebox.Object({
+            symbol: pi.typebox.String(),
+            json: pi.typebox.Optional(pi.typebox.Boolean()),
+        }),
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            const json = params.json ?? false;
+            const graph = scanProject(".");
+            const result = executeStateMap(graph, params.symbol);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: json
+                            ? JSON.stringify({
+                                schema_version: "1.0",
+                                command: "state_map",
+                                status: "ok",
+                                result: { symbol: params.symbol, found: result.includes(params.symbol) },
+                            })
+                            : result,
+                    },
+                ],
+            };
+        },
+    });
+}
+export function executeStateMap(graph, symbolName) {
+    const targets = [];
+    for (const sym of graph.symbols.values()) {
+        if (sym.name === symbolName) {
+            targets.push(sym);
+        }
+    }
+    if (targets.length === 0) {
+        return `Symbol not found: ${symbolName}`;
+    }
+    const lines = [];
+    for (const target of targets) {
+        lines.push(`## State Map: ${target.kind} \`${target.name}\` (${target.file}:${target.line})`);
+        lines.push("");
+        // Members: search for symbols that reference this one
+        const incoming = graph.incoming.get(target.id) || [];
+        const outgoing = graph.outgoing.get(target.id) || [];
+        if (incoming.length > 0) {
+            lines.push(`### Usages (${incoming.length} references from other symbols)`);
+            // Group by file
+            const byFile = new Map();
+            for (const edge of incoming) {
+                const sym = graph.symbols.get(edge.source);
+                if (sym) {
+                    const arr = byFile.get(sym.file) || [];
+                    arr.push(sym);
+                    byFile.set(sym.file, arr);
+                }
+            }
+            for (const [file, syms] of [...byFile.entries()].sort()) {
+                lines.push(`  **${file}**: ${syms.map((s) => s.name).join(", ")}`);
+            }
+        }
+        if (outgoing.length > 0) {
+            lines.push("");
+            lines.push(`### Dependencies (${outgoing.length} symbols this depends on)`);
+            for (const edge of outgoing) {
+                const sym = graph.symbols.get(edge.target);
+                if (sym) {
+                    lines.push(`- ${sym.kind} \`${sym.name}\` — ${sym.file}:${sym.line}`);
+                }
+            }
+        }
+        lines.push("");
+        lines.push(`Visibility: ${target.visibility}`);
+        lines.push(`PageRank: ${target.pagerank.toFixed(4)}`);
+        lines.push(`Signature: ${target.signature}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=state_map.js.map

package/dist/tools/state_map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state_map.js","sourceRoot":"","sources":["../../tools/state_map.ts"],"names":[],"mappings":"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"}

package/dist/tools/symbol.d.ts

@@ -0,0 +1,9 @@
+/**
+ * pi-shazam tools/symbol — Symbol lookup.
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph } from "../core/graph.js";
+export declare function registerSymbol(pi: ExtensionAPI): void;
+export declare function executeSymbol(graph: RepoGraph, name: string, file?: string): string;
+export declare function executeSymbolJson(graph: RepoGraph, name: string, file?: string): string;
+//# sourceMappingURL=symbol.d.ts.map

package/dist/tools/symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol.d.ts","sourceRoot":"","sources":["../../tools/symbol.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAU,MAAM,kBAAkB,CAAC;AAG1D,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAgCrD;AAED,wBAAgB,aAAa,CAC5B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CA0BR;AAED,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CAiBR"}

package/dist/tools/symbol.js

@@ -0,0 +1,84 @@
+import { scanProject } from "../core/scanner.js";
+export function registerSymbol(pi) {
+    pi.registerTool({
+        name: "shazam_symbol",
+        label: "Symbol Lookup",
+        description: `\
+Call to look up a symbol by name and get its definition, kind,
+signature, file location, PageRank score, callers, and callees.
+Faster than grep for precise symbol lookup.
+
+Scenario: finding where a function is defined, checking a symbol's
+type signature, verifying a symbol exists before referencing it.`,
+        parameters: pi.typebox.Object({
+            name: pi.typebox.String(),
+            file: pi.typebox.Optional(pi.typebox.String()),
+            json: pi.typebox.Optional(pi.typebox.Boolean()),
+        }),
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            const json = params.json ?? false;
+            const graph = scanProject(".");
+            const result = executeSymbol(graph, params.name, params.file);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: json
+                            ? executeSymbolJson(graph, params.name, params.file)
+                            : result,
+                    },
+                ],
+            };
+        },
+    });
+}
+export function executeSymbol(graph, name, file) {
+    const matches = findSymbols(graph, name, file);
+    if (matches.length === 0) {
+        return `Symbol not found: ${name}${file ? ` in ${file}` : ""}`;
+    }
+    const lines = [];
+    for (const sym of matches) {
+        lines.push(`${sym.kind} ${sym.name} — ${sym.file}:${sym.line}`, `  visibility: ${sym.visibility}`, `  PageRank: ${sym.pagerank.toFixed(4)}`, `  signature: ${sym.signature}`);
+        const incoming = graph.incoming.get(sym.id);
+        const outgoing = graph.outgoing.get(sym.id);
+        if (incoming && incoming.length > 0) {
+            lines.push(`  incoming refs: ${incoming.length}`);
+        }
+        if (outgoing && outgoing.length > 0) {
+            lines.push(`  outgoing refs: ${outgoing.length}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trim();
+}
+export function executeSymbolJson(graph, name, file) {
+    const matches = findSymbols(graph, name, file);
+    return JSON.stringify({
+        schema_version: "1.0",
+        command: "symbol",
+        status: "ok",
+        result: matches.map((s) => ({
+            id: s.id,
+            name: s.name,
+            kind: s.kind,
+            file: s.file,
+            line: s.line,
+            visibility: s.visibility,
+            pagerank: s.pagerank,
+            signature: s.signature,
+        })),
+    });
+}
+function findSymbols(graph, name, file) {
+    const results = [];
+    for (const sym of graph.symbols.values()) {
+        if (sym.name === name) {
+            if (!file || sym.file === file) {
+                results.push(sym);
+            }
+        }
+    }
+    return results.sort((a, b) => a.pagerank - b.pagerank);
+}
+//# sourceMappingURL=symbol.js.map

package/dist/tools/symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol.js","sourceRoot":"","sources":["../../tools/symbol.ts"],"names":[],"mappings":"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"}