pi-shazam 0.1.0

package/dist/core/cache.d.ts

@@ -0,0 +1,50 @@
+/**
+ * pi-shazam core/cache — Graph baseline save/diff for incremental analysis.
+ *
+ * Ported from repomap/src/__init__.py (get_project_cache_dir, compare_graph_snapshots,
+ * IncrementalCache).
+ *
+ * Uses Node.js fs + path for file I/O, matching repomap's convention of
+ * storing cache under ~/.cache/repomap/<project-slug>.
+ */
+import { serializeGraph, serializeSymbol, serializeEdge, compareGraphSnapshots } from "./graph.js";
+import type { RepoGraph, SerializedGraph, GraphDiff } from "./graph.js";
+/**
+ * Get the cache directory for a specific project.
+ * Uses MD5 hash of canonical path for isolation.
+ */
+export declare function getProjectCacheDir(projectPath: string): string;
+/**
+ * Get the standard cache file paths for a project.
+ */
+export declare function getCachePaths(projectPath: string): {
+    symbols: string;
+    git: string;
+    lastSnapshot: string;
+};
+/**
+ * Save the current graph as a baseline snapshot.
+ */
+export declare function saveBaseline(graph: RepoGraph, projectPath: string): string;
+/**
+ * Load a previously saved baseline snapshot.
+ */
+export declare function loadBaseline(projectPath: string): SerializedGraph | null;
+/**
+ * Save the last snapshot (timestamp + metadata only, not full graph).
+ */
+export declare function saveLastSnapshot(projectPath: string, metadata: Record<string, unknown>): string;
+/**
+ * Load the last snapshot metadata.
+ */
+export declare function loadLastSnapshot(projectPath: string): Record<string, unknown> | null;
+/**
+ * Compute the difference between the current graph and a saved baseline.
+ * Returns a structured diff with added/removed/modified symbols and edges.
+ */
+export declare function diffBaseline(graph: RepoGraph, projectPath: string): GraphDiff | null;
+/**
+ * Re-export serialization helpers for convenience.
+ */
+export { serializeGraph, serializeSymbol, serializeEdge, compareGraphSnapshots, };
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../core/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EACN,cAAc,EACd,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACX,SAAS,EACT,eAAe,EACf,SAAS,EAGT,MAAM,YAAY,CAAC;AAMpB;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAO9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACrB,CAOA;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAM1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CASxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,WAAW,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAShC;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAC3B,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,GACjB,SAAS,GAAG,IAAI,CAkBlB;AAED;;GAEG;AACH,OAAO,EACN,cAAc,EACd,eAAe,EACf,aAAa,EACb,qBAAqB,GACrB,CAAC"}

package/dist/core/cache.js

@@ -0,0 +1,116 @@
+/**
+ * pi-shazam core/cache — Graph baseline save/diff for incremental analysis.
+ *
+ * Ported from repomap/src/__init__.py (get_project_cache_dir, compare_graph_snapshots,
+ * IncrementalCache).
+ *
+ * Uses Node.js fs + path for file I/O, matching repomap's convention of
+ * storing cache under ~/.cache/repomap/<project-slug>.
+ */
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { createHash } from "node:crypto";
+import { serializeGraph, serializeSymbol, serializeEdge, compareGraphSnapshots, } from "./graph.js";
+// ── Cache directory management ───────────────────────────────────────────────
+const CACHE_ROOT = join(homedir(), ".cache", "repomap");
+/**
+ * Get the cache directory for a specific project.
+ * Uses MD5 hash of canonical path for isolation.
+ */
+export function getProjectCacheDir(projectPath) {
+    const canonical = projectPath.replace(/\/$/, "");
+    const hash = createHash("md5").update(canonical).digest("hex").slice(0, 8);
+    const projectName = canonical.split("/").pop() || "unknown";
+    const cacheDir = join(CACHE_ROOT, `${projectName}_${hash}`);
+    mkdirSync(cacheDir, { recursive: true });
+    return cacheDir;
+}
+/**
+ * Get the standard cache file paths for a project.
+ */
+export function getCachePaths(projectPath) {
+    const dir = getProjectCacheDir(projectPath);
+    return {
+        symbols: join(dir, "symbols.json"),
+        git: join(dir, "git.json"),
+        lastSnapshot: join(dir, "last_snapshot.json"),
+    };
+}
+// ── Baseline save/load ───────────────────────────────────────────────────────
+/**
+ * Save the current graph as a baseline snapshot.
+ */
+export function saveBaseline(graph, projectPath) {
+    const { symbols } = getCachePaths(projectPath);
+    const serialized = serializeGraph(graph);
+    mkdirSync(dirname(symbols), { recursive: true });
+    writeFileSync(symbols, JSON.stringify(serialized, null, 2), "utf-8");
+    return symbols;
+}
+/**
+ * Load a previously saved baseline snapshot.
+ */
+export function loadBaseline(projectPath) {
+    const { symbols } = getCachePaths(projectPath);
+    if (!existsSync(symbols))
+        return null;
+    try {
+        const raw = readFileSync(symbols, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save the last snapshot (timestamp + metadata only, not full graph).
+ */
+export function saveLastSnapshot(projectPath, metadata) {
+    const { lastSnapshot } = getCachePaths(projectPath);
+    const data = {
+        timestamp: Date.now(),
+        ...metadata,
+    };
+    mkdirSync(dirname(lastSnapshot), { recursive: true });
+    writeFileSync(lastSnapshot, JSON.stringify(data, null, 2), "utf-8");
+    return lastSnapshot;
+}
+/**
+ * Load the last snapshot metadata.
+ */
+export function loadLastSnapshot(projectPath) {
+    const { lastSnapshot } = getCachePaths(projectPath);
+    if (!existsSync(lastSnapshot))
+        return null;
+    try {
+        const raw = readFileSync(lastSnapshot, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// ── Graph diff (current vs baseline) ─────────────────────────────────────────
+/**
+ * Compute the difference between the current graph and a saved baseline.
+ * Returns a structured diff with added/removed/modified symbols and edges.
+ */
+export function diffBaseline(graph, projectPath) {
+    const baseline = loadBaseline(projectPath);
+    if (!baseline)
+        return null;
+    const currentSymbols = [...graph.symbols.values()];
+    const currentEdges = [];
+    for (const [, edges] of graph.outgoing) {
+        for (const e of edges) {
+            currentEdges.push(e);
+        }
+    }
+    return compareGraphSnapshots(currentSymbols, currentEdges, baseline.symbols, baseline.edges);
+}
+/**
+ * Re-export serialization helpers for convenience.
+ */
+export { serializeGraph, serializeSymbol, serializeEdge, compareGraphSnapshots, };
+//# sourceMappingURL=cache.js.map

package/dist/core/cache.js.map

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

package/dist/core/encoding.d.ts

@@ -0,0 +1,25 @@
+/**
+ * pi-shazam core/encoding — Adaptive file encoding reader.
+ *
+ * Reads files with UTF-8 → GBK → GB2312 fallback.
+ * Ported from repomap's encoding detection pattern.
+ */
+/**
+ * Read a file with adaptive encoding fallback:
+ * 1. Try UTF-8
+ * 2. Try GBK (cp936)
+ * 3. Try GB2312
+ *
+ * Returns the decoded string content.
+ */
+export declare function readFileAdaptive(filePath: string): string;
+/**
+ * Detect the most likely encoding for a buffer.
+ * Returns one of: "utf-8", "gbk", "gb2312", "unknown".
+ */
+export declare function detectEncoding(buffer: Buffer): string;
+/**
+ * Read a file with specific encoding.
+ */
+export declare function readFileWithEncoding(filePath: string, encoding: string): string;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/core/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../core/encoding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBzD;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiCrD;AAiCD;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACd,MAAM,CAMR"}

package/dist/core/encoding.js

@@ -0,0 +1,109 @@
+/**
+ * pi-shazam core/encoding — Adaptive file encoding reader.
+ *
+ * Reads files with UTF-8 → GBK → GB2312 fallback.
+ * Ported from repomap's encoding detection pattern.
+ */
+import { readFileSync } from "node:fs";
+import * as iconv from "iconv-lite";
+// ── Encoding detection and reading ───────────────────────────────────────────
+/**
+ * Read a file with adaptive encoding fallback:
+ * 1. Try UTF-8
+ * 2. Try GBK (cp936)
+ * 3. Try GB2312
+ *
+ * Returns the decoded string content.
+ */
+export function readFileAdaptive(filePath) {
+    const buffer = readFileSync(filePath);
+    // Try UTF-8 first
+    const utf8Result = tryDecode(buffer, "utf-8");
+    if (utf8Result !== null)
+        return utf8Result;
+    // Try GBK
+    const gbkResult = tryDecode(buffer, "gbk");
+    if (gbkResult !== null)
+        return gbkResult;
+    // Try GB2312
+    const gbResult = tryDecode(buffer, "gb2312");
+    if (gbResult !== null)
+        return gbResult;
+    // Last resort: UTF-8 with replacement
+    return buffer.toString("utf-8");
+}
+// ── Encoding detection ───────────────────────────────────────────────────────
+/**
+ * Detect the most likely encoding for a buffer.
+ * Returns one of: "utf-8", "gbk", "gb2312", "unknown".
+ */
+export function detectEncoding(buffer) {
+    // UTF-8 BOM check
+    if (buffer.length >= 3 &&
+        buffer[0] === 0xef &&
+        buffer[1] === 0xbb &&
+        buffer[2] === 0xbf) {
+        return "utf-8";
+    }
+    // Try UTF-8 validation
+    const utf8Result = tryDecode(buffer, "utf-8");
+    if (utf8Result !== null)
+        return "utf-8";
+    // Check for GBK/GB2312 patterns (high bytes 0x81-0xfe)
+    let gbkBytes = 0;
+    for (let i = 0; i < buffer.length; i++) {
+        const byte = buffer[i];
+        if (byte !== undefined && byte >= 0x81 && byte <= 0xfe) {
+            gbkBytes++;
+        }
+    }
+    if (gbkBytes > buffer.length * 0.3) {
+        const gbkResult = tryDecode(buffer, "gbk");
+        if (gbkResult !== null)
+            return "gbk";
+        const gbResult = tryDecode(buffer, "gb2312");
+        if (gbResult !== null)
+            return "gb2312";
+    }
+    return "unknown";
+}
+// ── Internal helpers ─────────────────────────────────────────────────────────
+/**
+ * Try to decode a buffer with a given encoding.
+ * Returns the decoded string if successful, or null if invalid.
+ */
+function tryDecode(buffer, encoding) {
+    try {
+        if (encoding === "utf-8") {
+            // Validate UTF-8 by decoding and checking for replacement characters
+            const str = buffer.toString("utf-8");
+            // Check for common UTF-8 decode failure marker
+            if (str.includes("\ufffd") && buffer.length > 16) {
+                return null;
+            }
+            return str;
+        }
+        // For iconv-lite encodings, decode and check for errors
+        const str = iconv.decode(buffer, encoding);
+        // iconv-lite uses replacement chars, so check if the result seems valid
+        // by verifying the decoded content doesn't have too many unknown chars
+        if (str.length === 0 && buffer.length > 0)
+            return null;
+        return str;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Convenience ──────────────────────────────────────────────────────────────
+/**
+ * Read a file with specific encoding.
+ */
+export function readFileWithEncoding(filePath, encoding) {
+    const buffer = readFileSync(filePath);
+    if (encoding === "utf-8") {
+        return buffer.toString("utf-8");
+    }
+    return iconv.decode(buffer, encoding);
+}
+//# sourceMappingURL=encoding.js.map

package/dist/core/encoding.js.map

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

package/dist/core/graph.d.ts

@@ -0,0 +1,146 @@
+/**
+ * pi-shazam core/graph — Symbol dependency graph data model.
+ *
+ * Ported from repomap/src/__init__.py (Symbol, Edge, RepoGraph dataclasses).
+ * All other core/ modules depend on these types.
+ */
+/** A code symbol (function, class, interface, etc.) */
+export interface Symbol {
+    id: string;
+    name: string;
+    kind: string;
+    file: string;
+    line: number;
+    endLine: number;
+    col: number;
+    visibility: "public" | "private" | "exported";
+    docstring: string;
+    signature: string;
+    returnType: string;
+    params: string;
+    pagerank: number;
+}
+/** A directed edge in the dependency graph */
+export interface Edge {
+    source: string;
+    target: string;
+    weight: number;
+    kind: string;
+    confidence: number;
+}
+/** Full symbol dependency graph */
+export interface RepoGraph {
+    symbols: Map<string, Symbol>;
+    outgoing: Map<string, Edge[]>;
+    incoming: Map<string, Edge[]>;
+    fileSymbols: Map<string, string[]>;
+    fileImports: Map<string, string[]>;
+    fileCalls: Map<string, [string, number, string][]>;
+    fileImportBindings: Map<string, JSImportBinding[]>;
+    fileExports: Map<string, JSExportBinding[]>;
+}
+/** A JS/TS import binding */
+export interface JSImportBinding {
+    localName: string;
+    importedName: string;
+    module: string;
+    line: number;
+    kind: "default" | "named" | "namespace";
+}
+/** A JS/TS export binding */
+export interface JSExportBinding {
+    exportedName: string;
+    sourceName: string | null;
+    module: string | null;
+    line: number;
+    kind: "local" | "reexport" | "namespace" | "wildcard";
+}
+export declare function createRepoGraph(): RepoGraph;
+export declare function createSymbol(id: string, name: string, kind: string, file: string, line: number, overrides?: Partial<Symbol>): Symbol;
+export declare function createEdge(source: string, target: string, weight: number, kind: string, confidence?: number): Edge;
+export interface SerializedSymbol {
+    id: string;
+    name: string;
+    kind: string;
+    file: string;
+    line: number;
+    endLine: number;
+    col: number;
+    visibility: string;
+    signature: string;
+    returnType: string;
+    params: string;
+    docstring: string;
+    pagerank: number;
+}
+export interface SerializedEdge {
+    source: string;
+    target: string;
+    weight: number;
+    kind: string;
+}
+export interface SerializedGraph {
+    symbols: SerializedSymbol[];
+    edges: SerializedEdge[];
+    version: number;
+    timestamp: number;
+}
+export declare function serializeSymbol(sym: Symbol): SerializedSymbol;
+export declare function serializeEdge(edge: Edge): SerializedEdge;
+export declare function serializeGraph(graph: RepoGraph): SerializedGraph;
+export interface GraphDiff {
+    summary: {
+        added: number;
+        removed: number;
+        modified: number;
+        edgesAdded: number;
+        edgesRemoved: number;
+    };
+    addedSymbols: {
+        id: string;
+        name: string;
+        file: string;
+        line: number;
+    }[];
+    removedSymbols: {
+        id: string;
+        name: string;
+        file: string;
+        line: number;
+    }[];
+    modifiedSymbols: ModifiedSymbol[];
+    callChainChanges: {
+        newCalls: {
+            from: string;
+            to: string;
+            kind: string;
+        }[];
+        removedCalls: {
+            from: string;
+            to: string;
+            kind: string;
+        }[];
+    };
+}
+export interface ModifiedSymbol {
+    id: string;
+    name: string;
+    file: string;
+    visibility: string;
+    kind: string;
+    lineChange: string;
+    oldSignature: string;
+    newSignature: string;
+    signatureChanged: boolean;
+    affectedCallers?: {
+        symbolId: string;
+        kind: string;
+    }[];
+    affectedCallerCount?: number;
+    risk?: "HIGH" | "MEDIUM" | "LOW";
+}
+export declare function compareGraphSnapshots(currentSymbols: Symbol[], currentEdges: Edge[], previousSymbols: SerializedSymbol[], previousEdges: SerializedEdge[]): GraphDiff;
+export declare const LOW_SIGNAL_KINDS: Set<string>;
+export declare const BOILERPLATE_NAMES: Set<string>;
+export declare function signalWeightForSymbol(kind: string, name: string, visibility: string): number;
+//# sourceMappingURL=graph.d.ts.map

package/dist/core/graph.d.ts.map

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