pi-shazam 0.1.0

package/dist/lsp/setup.js

@@ -0,0 +1,140 @@
+/**
+ * pi-shazam lsp/setup — /shazam-setup command: detect + install guidance.
+ *
+ * Scans the project for supported languages, detects installed LSP servers,
+ * and outputs install instructions for missing ones.
+ *
+ * Ported from repomap/src/lsp.py (detect_lsp_servers and CLI output formatting).
+ */
+import { detectLspServer, detectProjectLanguages } from "./manager.js";
+const INSTALL_INSTRUCTIONS = [
+    {
+        language: "python",
+        serverName: "pyright-langserver",
+        packages: ["pyright"],
+        commands: ["npm install -g pyright", "pip install pyright"],
+    },
+    {
+        language: "python",
+        serverName: "pylsp",
+        packages: ["python-lsp-server"],
+        commands: [
+            "pip install python-lsp-server",
+            "pipx install python-lsp-server",
+        ],
+    },
+    {
+        language: "typescript",
+        serverName: "typescript-language-server",
+        packages: ["typescript-language-server", "typescript"],
+        commands: [
+            "npm install -g typescript-language-server typescript",
+        ],
+    },
+    {
+        language: "go",
+        serverName: "gopls",
+        packages: ["golang.org/x/tools/gopls"],
+        commands: ["go install golang.org/x/tools/gopls@latest"],
+    },
+    {
+        language: "json",
+        serverName: "vscode-json-languageserver",
+        packages: ["vscode-langservers-extracted"],
+        commands: ["npm install -g vscode-langservers-extracted"],
+    },
+    {
+        language: "yaml",
+        serverName: "yaml-language-server",
+        packages: ["yaml-language-server"],
+        commands: [
+            "npm install -g yaml-language-server",
+        ],
+    },
+    {
+        language: "rust",
+        serverName: "rust-analyzer",
+        packages: ["rust-analyzer"],
+        commands: [
+            "rustup component add rust-analyzer",
+            "brew install rust-analyzer",
+        ],
+    },
+];
+// ── Detection ────────────────────────────────────────────────────────────────
+/**
+ * Detect LSP servers for specified languages or auto-detect from project.
+ */
+export function detectLspServers(projectRoot, languages) {
+    const detected = languages ?? detectProjectLanguages(projectRoot);
+    return detected.map((lang) => detectLspServer(projectRoot, lang));
+}
+// ── Setup command handler ────────────────────────────────────────────────────
+/**
+ * Generate the /shazam-setup output as a formatted string.
+ */
+export function generateSetupReport(projectRoot, languages) {
+    const detections = detectLspServers(projectRoot, languages);
+    const available = [];
+    const missing = [];
+    for (const d of detections) {
+        if (d.status === "available") {
+            available.push(d);
+        }
+        else {
+            missing.push(d);
+        }
+    }
+    const lines = [];
+    lines.push("## Shazam LSP Setup");
+    lines.push("");
+    lines.push(`Project: ${projectRoot}`);
+    lines.push(`Detected languages: ${detections.map((d) => d.language).join(", ") || "none"}`);
+    lines.push("");
+    // Available servers
+    if (available.length > 0) {
+        lines.push("### ✅ Available LSP Servers");
+        lines.push("");
+        for (const d of available) {
+            lines.push(`- **${d.language}**: \`${d.serverName}\` (${d.source}: \`${d.command.join(" ")}\`)`);
+        }
+        lines.push("");
+    }
+    // Missing servers with install instructions
+    if (missing.length > 0) {
+        lines.push("### ❌ Missing LSP Servers");
+        lines.push("");
+        for (const d of missing) {
+            const instruction = INSTALL_INSTRUCTIONS.find((i) => i.language === d.language &&
+                i.serverName === d.serverName);
+            lines.push(`#### ${d.language} — ${d.serverName}`);
+            if (d.reason) {
+                lines.push(`  Reason: ${d.reason}`);
+            }
+            if (instruction) {
+                lines.push("  Install:");
+                for (const cmd of instruction.commands) {
+                    lines.push(`    ${cmd}`);
+                }
+            }
+            lines.push("");
+        }
+    }
+    if (detections.length === 0) {
+        lines.push("No supported languages detected in this project. LSP features will be unavailable.");
+    }
+    return lines.join("\n");
+}
+/**
+ * Get the install instructions as a simple key-value map
+ * for use in tool outputs.
+ */
+export function getInstallInstructions() {
+    const map = {};
+    for (const inst of INSTALL_INSTRUCTIONS) {
+        const key = `${inst.language}:${inst.serverName}`;
+        map[key] = inst.commands;
+    }
+    return map;
+}
+//# sourceMappingURL=setup.js.map

package/dist/lsp/setup.js.map

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

package/dist/tools/call_chain.d.ts

@@ -0,0 +1,9 @@
+/**
+ * pi-shazam tools/call_chain — Call graph traversal.
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph } from "../core/graph.js";
+export declare function registerCallChain(pi: ExtensionAPI): void;
+export declare function executeCallChain(graph: RepoGraph, symbolName: string, depth?: number): string;
+export declare function executeCallChainJson(graph: RepoGraph, symbolName: string, depth: number): string;
+//# sourceMappingURL=call_chain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"call_chain.d.ts","sourceRoot":"","sources":["../../tools/call_chain.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,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAsCxD;AAED,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAU,GACf,MAAM,CA0CR;AAED,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACX,MAAM,CAwBR"}

package/dist/tools/call_chain.js

@@ -0,0 +1,151 @@
+import { scanProject } from "../core/scanner.js";
+export function registerCallChain(pi) {
+    pi.registerTool({
+        name: "shazam_call_chain",
+        label: "Call Chain Analysis",
+        description: `\
+MUST call before changing a function signature, deleting code, or
+refactoring. Traces ALL upstream callers and downstream callees for a
+symbol. Without this, you cannot know the blast radius. Every caller
+you miss is a bug you will ship.
+
+Returns: incoming calls (who calls this), outgoing calls (what this
+calls), and full reference list. Pass --depth to control traversal
+depth (default 2).
+
+Scenario: changing parameter order. Removing a function. Renaming an
+exported symbol. Changing return type. Adding required parameters.`,
+        parameters: pi.typebox.Object({
+            symbol: pi.typebox.String(),
+            depth: 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 depth = params.depth ?? 2;
+            const result = executeCallChain(graph, params.symbol, depth);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: json
+                            ? executeCallChainJson(graph, params.symbol, depth)
+                            : result,
+                    },
+                ],
+            };
+        },
+    });
+}
+export function executeCallChain(graph, symbolName, depth = 2) {
+    const targets = findSymbolsByName(graph, symbolName);
+    if (targets.length === 0) {
+        return `Symbol not found: ${symbolName}`;
+    }
+    const lines = [];
+    for (const target of targets) {
+        lines.push(`## Call Chain for ${target.kind} \`${target.name}\` (${target.file}:${target.line})`);
+        lines.push("");
+        // Incoming callers (upstream) — BFS
+        const incomingChain = traceIncoming(graph, target.id, depth);
+        if (incomingChain.length > 0) {
+            lines.push(`### Incoming Calls (${incomingChain.length} callers in ${depth} levels)`);
+            for (const [level, sym, edge] of incomingChain) {
+                const indent = "  ".repeat(level);
+                lines.push(`${indent}L${level}: ${sym.kind} \`${sym.name}\` — ${sym.file}:${sym.line} (${edge.kind})`);
+            }
+        }
+        // Outgoing callees (downstream) — BFS
+        const outgoingChain = traceOutgoing(graph, target.id, depth);
+        if (outgoingChain.length > 0) {
+            lines.push("");
+            lines.push(`### Outgoing Calls (${outgoingChain.length} callees in ${depth} levels)`);
+            for (const [level, sym, edge] of outgoingChain) {
+                const indent = "  ".repeat(level);
+                lines.push(`${indent}L${level}: ${sym.kind} \`${sym.name}\` — ${sym.file}:${sym.line} (${edge.kind})`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n").trim();
+}
+export function executeCallChainJson(graph, symbolName, depth) {
+    const targets = findSymbolsByName(graph, symbolName);
+    const result = targets.map((target) => ({
+        symbol: { id: target.id, name: target.name, kind: target.kind, file: target.file, line: target.line },
+        incoming: traceIncoming(graph, target.id, depth).map(([level, sym, edge]) => ({
+            level,
+            symbol: sym.name,
+            file: sym.file,
+            kind: edge.kind,
+        })),
+        outgoing: traceOutgoing(graph, target.id, depth).map(([level, sym, edge]) => ({
+            level,
+            symbol: sym.name,
+            file: sym.file,
+            kind: edge.kind,
+        })),
+    }));
+    return JSON.stringify({
+        schema_version: "1.0",
+        command: "call_chain",
+        status: "ok",
+        result,
+    });
+}
+function findSymbolsByName(graph, name) {
+    const results = [];
+    for (const sym of graph.symbols.values()) {
+        if (sym.name === name)
+            results.push(sym);
+    }
+    return results;
+}
+function traceIncoming(graph, startId, maxDepth) {
+    const visited = new Set();
+    const result = [];
+    const queue = [{ id: startId, depth: 0 }];
+    visited.add(startId);
+    while (queue.length > 0) {
+        const { id, depth } = queue.shift();
+        if (depth >= maxDepth)
+            continue;
+        const incoming = graph.incoming.get(id);
+        if (!incoming)
+            continue;
+        for (const edge of incoming) {
+            const srcSym = graph.symbols.get(edge.source);
+            if (!srcSym || visited.has(edge.source))
+                continue;
+            visited.add(edge.source);
+            result.push([depth + 1, srcSym, edge]);
+            queue.push({ id: edge.source, depth: depth + 1 });
+        }
+    }
+    return result;
+}
+function traceOutgoing(graph, startId, maxDepth) {
+    const visited = new Set();
+    const result = [];
+    const queue = [{ id: startId, depth: 0 }];
+    visited.add(startId);
+    while (queue.length > 0) {
+        const { id, depth } = queue.shift();
+        if (depth >= maxDepth)
+            continue;
+        const outgoing = graph.outgoing.get(id);
+        if (!outgoing)
+            continue;
+        for (const edge of outgoing) {
+            const tgtSym = graph.symbols.get(edge.target);
+            if (!tgtSym || visited.has(edge.target))
+                continue;
+            visited.add(edge.target);
+            result.push([depth + 1, tgtSym, edge]);
+            queue.push({ id: edge.target, depth: depth + 1 });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=call_chain.js.map

package/dist/tools/call_chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call_chain.js","sourceRoot":"","sources":["../../tools/call_chain.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,UAAU,iBAAiB,CAAC,EAAgB;IACjD,EAAE,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE;;;;;;;;;;;mEAWoD;QACjE,UAAU,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;YAC7B,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE;YAC3B,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/C,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;SAC/C,CAAC;QACF,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI;YAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC;YAClC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC7D,OAAO;gBACN,OAAO,EAAE;oBACR;wBACC,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI;4BACT,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;4BACnD,CAAC,CAAC,MAAM;qBACT;iBACD;aACD,CAAC;QACH,CAAC;KACD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,KAAgB,EAChB,UAAkB,EAClB,QAAgB,CAAC;IAEjB,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,qBAAqB,UAAU,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CACT,qBAAqB,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,GAAG,CACrF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,oCAAoC;QACpC,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7D,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,uBAAuB,aAAa,CAAC,MAAM,eAAe,KAAK,UAAU,CAAC,CAAC;YACtF,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,aAAa,EAAE,CAAC;gBAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClC,KAAK,CAAC,IAAI,CACT,GAAG,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,CAC1F,CAAC;YACH,CAAC;QACF,CAAC;QAED,sCAAsC;QACtC,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7D,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,uBAAuB,aAAa,CAAC,MAAM,eAAe,KAAK,UAAU,CAAC,CAAC;YACtF,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,aAAa,EAAE,CAAC;gBAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAClC,KAAK,CAAC,IAAI,CACT,GAAG,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,CAC1F,CAAC;YACH,CAAC;QACF,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,oBAAoB,CACnC,KAAgB,EAChB,UAAkB,EAClB,KAAa;IAEb,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;QACrG,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7E,KAAK;YACL,MAAM,EAAE,GAAG,CAAC,IAAI;YAChB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,IAAI,CAAC,IAAI;SACf,CAAC,CAAC;QACH,QAAQ,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7E,KAAK;YACL,MAAM,EAAE,GAAG,CAAC,IAAI;YAChB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,IAAI,CAAC,IAAI;SACf,CAAC,CAAC;KACH,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAI,CAAC,SAAS,CAAC;QACrB,cAAc,EAAE,KAAK;QACrB,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,IAAI;QACZ,MAAM;KACN,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAgB,EAAE,IAAY;IACxD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CACrB,KAAgB,EAChB,OAAe,EACf,QAAgB;IAEhB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,MAAM,GAAyC,EAAE,CAAC;IACxD,MAAM,KAAK,GAAoC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAErB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;QACrC,IAAI,KAAK,IAAI,QAAQ;YAAE,SAAS;QAEhC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;gBAAE,SAAS;YAClD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CACrB,KAAgB,EAChB,OAAe,EACf,QAAgB;IAEhB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,MAAM,GAAyC,EAAE,CAAC;IACxD,MAAM,KAAK,GAAoC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAErB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;QACrC,IAAI,KAAK,IAAI,QAAQ;YAAE,SAAS;QAEhC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;gBAAE,SAAS;YAClD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/tools/check.d.ts

@@ -0,0 +1,18 @@
+/**
+ * pi-shazam tools/check — Compiler/lint diagnostics.
+ *
+ * Validates project files using tree-sitter parsing and reports issues.
+ * Falls back to tree-sitter only when LSP is unavailable, annotated in output.
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph } from "../core/graph.js";
+export declare function registerCheck(pi: ExtensionAPI): void;
+/**
+ * Run diagnostics check against the current graph.
+ */
+export declare function executeCheck(graph: RepoGraph, _projectRoot: string, file?: string): string;
+/**
+ * Run diagnostics and return structured JSON.
+ */
+export declare function executeCheckJson(graph: RepoGraph, _projectRoot: string, file?: string): string;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../tools/check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA6CpD;AAID;;GAEG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CAwER;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,CA8BR"}

package/dist/tools/check.js

@@ -0,0 +1,141 @@
+import { scanProject } from "../core/scanner.js";
+export function registerCheck(pi) {
+    pi.registerTool({
+        name: "shazam_check",
+        label: "Compiler & Lint Diagnostics",
+        description: `\
+Call when shazam_verify reports errors or you need compiler/linter
+diagnostics independent of git state. Runs tsc/eslint/pyright/go-vet/
+rustc directly and returns file:line:code:message for every issue.
+
+Fix ALL errors before proceeding — a red check means broken code, not
+"warnings to ignore later." Unlike verify, check does NOT depend on git
+diff state — it runs on the entire project.
+
+Scenario: CI failed, need local reproduction. verify says "run check
+for details." Mid-refactor before all files are saved. After npm install
+to confirm no type regressions.`,
+        parameters: pi.typebox.Object({
+            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(".");
+            if (json) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: executeCheckJson(graph, ".", params.file),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: executeCheck(graph, ".", params.file),
+                    },
+                ],
+            };
+        },
+    });
+}
+// ── Execute functions (testable without Pi) ────────────────────────────────
+/**
+ * Run diagnostics check against the current graph.
+ */
+export function executeCheck(graph, _projectRoot, file) {
+    const lines = [];
+    lines.push("## Check Diagnostics");
+    lines.push("");
+    // ── Filter to target file if specified ─────────────────────────────
+    const targetFiles = file
+        ? [file]
+        : [...graph.fileSymbols.keys()];
+    if (targetFiles.length === 0) {
+        lines.push("No files to check.");
+        return lines.join("\n");
+    }
+    // ── Parse validation ────────────────────────────────────────────────
+    lines.push("### Tree-sitter Parse Status");
+    lines.push("");
+    const failedFiles = [];
+    const successfulFiles = [];
+    for (const filePath of targetFiles) {
+        const symIds = graph.fileSymbols.get(filePath);
+        if (!symIds || symIds.length === 0) {
+            failedFiles.push(filePath);
+        }
+        else {
+            successfulFiles.push(filePath);
+        }
+    }
+    lines.push(`✅ ${successfulFiles.length} files parsed successfully`);
+    if (failedFiles.length > 0) {
+        lines.push(`⚠️ ${failedFiles.length} files have no symbols (possible parse failure)`);
+        for (const f of failedFiles.slice(0, 10)) {
+            lines.push(`  - ${f}`);
+        }
+    }
+    lines.push("");
+    // ── Symbol statistics ───────────────────────────────────────────────
+    lines.push("### Symbol Summary");
+    lines.push("");
+    let totalSymbols = 0;
+    let totalEdges = 0;
+    for (const filePath of targetFiles) {
+        const symIds = graph.fileSymbols.get(filePath);
+        if (symIds) {
+            totalSymbols += symIds.length;
+            for (const id of symIds) {
+                const out = graph.outgoing.get(id);
+                if (out)
+                    totalEdges += out.length;
+            }
+        }
+    }
+    lines.push(`Files: ${successfulFiles.length}`);
+    lines.push(`Symbols: ${totalSymbols}`);
+    lines.push(`Edges: ${totalEdges}`);
+    lines.push("");
+    // ── LSP note ────────────────────────────────────────────────────────
+    lines.push("*LSP diagnostics not available in direct tool mode. Run `npx tsc --noEmit` for TypeScript type checking, or use repomap check for full LSP diagnostics.*");
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Run diagnostics and return structured JSON.
+ */
+export function executeCheckJson(graph, _projectRoot, file) {
+    const targetFiles = file
+        ? [file]
+        : [...graph.fileSymbols.keys()];
+    const successfulFiles = [];
+    const failedFiles = [];
+    for (const filePath of targetFiles) {
+        const symIds = graph.fileSymbols.get(filePath);
+        if (!symIds || symIds.length === 0) {
+            failedFiles.push(filePath);
+        }
+        else {
+            successfulFiles.push(filePath);
+        }
+    }
+    return JSON.stringify({
+        schema_version: "1.0",
+        command: "check",
+        project: _projectRoot,
+        status: "ok",
+        result: {
+            totalFiles: targetFiles.length,
+            parsedFiles: successfulFiles.length,
+            failedFiles: failedFiles.length,
+            failedFileList: failedFiles.slice(0, 20),
+            symbolCount: graph.symbols.size,
+        },
+    });
+}
+//# sourceMappingURL=check.js.map

package/dist/tools/check.js.map

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

package/dist/tools/codequery.d.ts

@@ -0,0 +1,19 @@
+/**
+ * pi-shazam tools/codequery — Unified symbol/file query.
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph, Symbol } from "../core/graph.js";
+export declare function registerCodequery(pi: ExtensionAPI): void;
+interface CodequeryParams {
+    symbol?: string;
+    file?: string;
+    query?: string;
+}
+interface CodequeryResult {
+    symbols: Symbol[];
+    fileSymbols: Symbol[];
+    searchResults: Symbol[];
+}
+export declare function executeCodequery(graph: RepoGraph, params: CodequeryParams): CodequeryResult;
+export {};
+//# sourceMappingURL=codequery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codequery.d.ts","sourceRoot":"","sources":["../../tools/codequery.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1D,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAmDxD;AAED,UAAU,eAAe;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,eAAe;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,eAAe,GACrB,eAAe,CAmCjB"}

package/dist/tools/codequery.js

@@ -0,0 +1,128 @@
+import { scanProject } from "../core/scanner.js";
+export function registerCodequery(pi) {
+    pi.registerTool({
+        name: "shazam_codequery",
+        label: "Symbol & File Query",
+        description: `\
+MUST call to locate a symbol or inspect a file BEFORE reading or
+editing it. Uses LSP precision + tree-sitter parsing. Faster and more
+accurate than grep/read — returns definition site, references, callers,
+and type info in one call.
+
+Supports: --symbol <name> (find definition + references), --file <path>
+(list all symbols in file with signatures), --query <keyword> (BM25
+search with synonym expansion).
+
+If this returns empty or "not found", the symbol does not exist — do
+not guess or invent it. Use --file to verify the file's actual contents.
+
+Scenario: before editing any function/class. Before renaming. Before
+deleting. When you need to find where something is defined. When grep
+returns too many results.`,
+        parameters: pi.typebox.Object({
+            symbol: pi.typebox.Optional(pi.typebox.String()),
+            file: pi.typebox.Optional(pi.typebox.String()),
+            query: 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 = executeCodequery(graph, {
+                symbol: params.symbol,
+                file: params.file,
+                query: params.query,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: json
+                            ? JSON.stringify({
+                                schema_version: "1.0",
+                                command: "codequery",
+                                status: "ok",
+                                result: result,
+                            })
+                            : formatCodequeryResult(result, params),
+                    },
+                ],
+            };
+        },
+    });
+}
+export function executeCodequery(graph, params) {
+    const result = {
+        symbols: [],
+        fileSymbols: [],
+        searchResults: [],
+    };
+    if (params.symbol) {
+        for (const sym of graph.symbols.values()) {
+            if (sym.name === params.symbol) {
+                result.symbols.push(sym);
+            }
+        }
+    }
+    if (params.file) {
+        const symIds = graph.fileSymbols.get(params.file) || [];
+        for (const id of symIds) {
+            const sym = graph.symbols.get(id);
+            if (sym)
+                result.fileSymbols.push(sym);
+        }
+    }
+    if (params.query) {
+        const lower = params.query.toLowerCase();
+        for (const sym of graph.symbols.values()) {
+            if (sym.name.toLowerCase().includes(lower)) {
+                result.searchResults.push(sym);
+            }
+        }
+        // Sort by PageRank
+        result.searchResults.sort((a, b) => b.pagerank - a.pagerank);
+    }
+    return result;
+}
+function formatCodequeryResult(result, params) {
+    const lines = [];
+    if (result.symbols.length > 0) {
+        lines.push(`## Symbol: ${params.symbol}`);
+        lines.push("");
+        for (const sym of result.symbols) {
+            lines.push(`- ${sym.kind} \`${sym.name}\` — ${sym.file}:${sym.line}`);
+            lines.push(`  visibility: ${sym.visibility}`);
+            lines.push(`  signature: ${sym.signature}`);
+            lines.push(`  PageRank: ${sym.pagerank.toFixed(4)}`);
+        }
+    }
+    else if (params.symbol) {
+        lines.push(`Symbol not found: ${params.symbol}`);
+    }
+    if (result.fileSymbols.length > 0) {
+        if (lines.length > 0)
+            lines.push("");
+        lines.push(`## File: ${params.file} (${result.fileSymbols.length} symbols)`);
+        lines.push("");
+        for (const sym of result.fileSymbols) {
+            lines.push(`- ${sym.kind} \`${sym.name}\` (L${sym.line}) — ${sym.signature.slice(0, 80)}`);
+        }
+    }
+    else if (params.file) {
+        lines.push(`File not in graph: ${params.file}`);
+    }
+    if (result.searchResults.length > 0) {
+        if (lines.length > 0)
+            lines.push("");
+        lines.push(`## Search: "${params.query}" (${result.searchResults.length} results)`);
+        lines.push("");
+        for (const sym of result.searchResults.slice(0, 20)) {
+            lines.push(`- ${sym.kind} \`${sym.name}\` — ${sym.file}:${sym.line} (PR ${sym.pagerank.toFixed(3)})`);
+        }
+        if (result.searchResults.length > 20) {
+            lines.push(`  ... and ${result.searchResults.length - 20} more`);
+        }
+    }
+    return lines.length > 0 ? lines.join("\n") : "No results found.";
+}
+//# sourceMappingURL=codequery.js.map

package/dist/tools/codequery.js.map

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