pi-shazam 0.15.3 → 0.16.0

package/README.md

@@ -43,7 +43,7 @@ Use this only if you are **not** using Pi agent. The MCP interface provides the
 	"mcpServers": {
 		"pi-shazam": {
 			"command": "npx",
-			"args": ["-y", "-p", "pi-shazam", "pi-shazam-mcp"]
+			"args": ["-y", "-p", "pi-shazam@latest", "pi-shazam-mcp"]
 		}
 	}
 }

package/dist/core/audit-log.d.ts

@@ -8,7 +8,7 @@
  *   - Max 10 MB per log file before rotation
  *   - Keep up to 5 archived copies (shazam-calls.log.1 through .5)
  *   - Max 30 days age for any single log file
- *   - On rotation: cascade-rename .4→.5, .3→.4, …, .log→.log.1
+ *   - On rotation: cascade-rename .4->.5, .3->.4, …, .log->.log.1
  *   - On age: delete the entire log file (content older than 30 days is stale)
  */
 /** Default directory for shazam audit logs. */
@@ -22,9 +22,9 @@ export declare const MAX_AUDIT_LOG_AGE_MS: number;
 /**
  * Rotate the audit log at `logPath`.
  *
- * - If file size exceeds MAX_AUDIT_LOG_SIZE → cascade-rename archived copies
- *   (log.4→log.5, …, log→log.1) and let a new log file be created on next write.
- * - If file age exceeds MAX_AUDIT_LOG_AGE_MS → delete the file (it will be
+ * - If file size exceeds MAX_AUDIT_LOG_SIZE -> cascade-rename archived copies
+ *   (log.4->log.5, …, log->log.1) and let a new log file be created on next write.
+ * - If file age exceeds MAX_AUDIT_LOG_AGE_MS -> delete the file (it will be
  *   recreated on next write with fresh content).
  */
 export declare function rotateAuditLog(logPath: string): Promise<void>;

package/dist/core/audit-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-log.d.ts","sourceRoot":"","sources":["../../core/audit-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,+CAA+C;AAC/C,eAAO,MAAM,aAAa,QAA2C,CAAC;AAEtE,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAEnD,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,QAA2B,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BnE"}
+{"version":3,"file":"audit-log.d.ts","sourceRoot":"","sources":["../../core/audit-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,+CAA+C;AAC/C,eAAO,MAAM,aAAa,QAA2C,CAAC;AAEtE,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAEnD,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,QAA2B,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BnE"}

package/dist/core/audit-log.js

@@ -8,7 +8,7 @@
  *   - Max 10 MB per log file before rotation
  *   - Keep up to 5 archived copies (shazam-calls.log.1 through .5)
  *   - Max 30 days age for any single log file
- *   - On rotation: cascade-rename .4→.5, .3→.4, …, .log→.log.1
+ *   - On rotation: cascade-rename .4->.5, .3->.4, …, .log->.log.1
  *   - On age: delete the entire log file (content older than 30 days is stale)
  */
 import { stat, rename, unlink } from "node:fs/promises";
@@ -25,9 +25,9 @@ export const MAX_AUDIT_LOG_AGE_MS = 30 * 24 * 60 * 60 * 1000;
 /**
  * Rotate the audit log at `logPath`.
  *
- * - If file size exceeds MAX_AUDIT_LOG_SIZE → cascade-rename archived copies
- *   (log.4→log.5, …, log→log.1) and let a new log file be created on next write.
- * - If file age exceeds MAX_AUDIT_LOG_AGE_MS → delete the file (it will be
+ * - If file size exceeds MAX_AUDIT_LOG_SIZE -> cascade-rename archived copies
+ *   (log.4->log.5, …, log->log.1) and let a new log file be created on next write.
+ * - If file age exceeds MAX_AUDIT_LOG_AGE_MS -> delete the file (it will be
  *   recreated on next write with fresh content).
  */
 export async function rotateAuditLog(logPath) {
@@ -43,8 +43,9 @@ export async function rotateAuditLog(logPath) {
                 try {
                     await rename(src, dst);
                 }
-                catch {
+                catch (err) {
                     // file may not exist yet
+                    console.warn(`[pi-shazam] rotateAuditLog: rename ${src} -> ${dst} failed`, err);
                 }
             }
             // Move current log to .1
@@ -55,8 +56,9 @@ export async function rotateAuditLog(logPath) {
             await unlink(logPath);
         }
     }
-    catch {
+    catch (err) {
         // File may not exist yet — first write creates it
+        console.warn(`[pi-shazam] rotateAuditLog: stat/unlink failed for ${logPath}`, err);
     }
 }
 //# sourceMappingURL=audit-log.js.map

package/dist/core/audit-log.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit-log.js","sourceRoot":"","sources":["../../core/audit-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEtE,iDAAiD;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnD,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IACnD,IAAI,CAAC;QACJ,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,GAAG,oBAAoB,CAAC;QAE9D,IAAI,MAAM,EAAE,CAAC;YACZ,2CAA2C;YAC3C,KAAK,IAAI,CAAC,GAAG,mBAAmB,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnD,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACJ,MAAM,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACR,yBAAyB;gBAC1B,CAAC;YACF,CAAC;YACD,yBAAyB;YACzB,MAAM,MAAM,CAAC,OAAO,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YACnB,6DAA6D;YAC7D,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,kDAAkD;IACnD,CAAC;AACF,CAAC"}
+{"version":3,"file":"audit-log.js","sourceRoot":"","sources":["../../core/audit-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEtE,iDAAiD;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnD,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IACnD,IAAI,CAAC;QACJ,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,GAAG,oBAAoB,CAAC;QAE9D,IAAI,MAAM,EAAE,CAAC;YACZ,2CAA2C;YAC3C,KAAK,IAAI,CAAC,GAAG,mBAAmB,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnD,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACJ,MAAM,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACxB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,yBAAyB;oBACzB,OAAO,CAAC,IAAI,CAAC,sCAAsC,GAAG,OAAO,GAAG,SAAS,EAAE,GAAG,CAAC,CAAC;gBACjF,CAAC;YACF,CAAC;YACD,yBAAyB;YACzB,MAAM,MAAM,CAAC,OAAO,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YACnB,6DAA6D;YAC7D,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,kDAAkD;QAClD,OAAO,CAAC,IAAI,CAAC,sDAAsD,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;IACpF,CAAC;AACF,CAAC"}

package/dist/core/baseline.js

@@ -11,7 +11,7 @@
  */
 import { getGraphEdgeCount } from "./graph.js";
 import { findOrphans } from "./filter.js";
-// ── Session baseline state (in-memory) ────────────────────────────────────────
+// -- Session baseline state (in-memory) ----------------------------------------
 let _baseline = null;
 let _previousOrphans = new Map();
 /**

package/dist/core/cache.js

@@ -10,7 +10,7 @@ import { join, dirname } from "node:path";
 import { homedir } from "node:os";
 import { createHash } from "node:crypto";
 import { serializeGraphV2, deserializeGraphV2 } from "./graph.js";
-// ── Cache directory management ───────────────────────────────────────────────
+// -- Cache directory management -----------------------------------------------
 const CACHE_ROOT = join(homedir(), ".cache", "repomap");
 /**
  * Get the cache directory for a specific project.
@@ -24,7 +24,7 @@ export function getProjectCacheDir(projectPath) {
     mkdirSync(cacheDir, { recursive: true });
     return cacheDir;
 }
-// ── Persistent graph cache (V2) ──────────────────────────────────────────────
+// -- Persistent graph cache (V2) ----------------------------------------------
 /** Max age for a cached graph file before it is considered stale. */
 const CACHE_MAX_AGE_MS = 24 * 60 * 60 * 1000; // 1 day — prevents stale cache in active projects (fixes #100)
 /**

package/dist/core/encoding.d.ts

@@ -1,7 +1,7 @@
 /**
  * pi-shazam core/encoding — Adaptive file encoding reader.
  *
- * Reads files with UTF-8 → GBK → GB2312 fallback.
+ * Reads files with UTF-8 -> GBK -> GB2312 fallback.
  * Includes OOM protection via file size limits (2MB max) and
  * encoding validation on first 64KB chunk to reduce memory pressure.
  */
@@ -30,7 +30,7 @@ export declare class FileTooLargeError extends Error {
 export declare function readFileAdaptive(filePath: string): string;
 /**
  * Async variant of readFileAdaptive using fs.promises.
- * Same encoding fallback logic (UTF-8 → GBK → GB2312) but non-blocking.
+ * Same encoding fallback logic (UTF-8 -> GBK -> GB2312) but non-blocking.
  * Use this in async contexts (e.g., LSP enrichment) to avoid blocking the event loop.
  */
 export declare function readFileAdaptiveAsync(filePath: string): Promise<string>;

package/dist/core/encoding.js

@@ -1,7 +1,7 @@
 /**
  * pi-shazam core/encoding — Adaptive file encoding reader.
  *
- * Reads files with UTF-8 → GBK → GB2312 fallback.
+ * Reads files with UTF-8 -> GBK -> GB2312 fallback.
  * Includes OOM protection via file size limits (2MB max) and
  * encoding validation on first 64KB chunk to reduce memory pressure.
  */
@@ -32,7 +32,7 @@ export class FileTooLargeError extends Error {
 // Chunk size for encoding validation — only validate first 64KB
 // to avoid allocating huge strings for large files
 const VALIDATION_CHUNK_SIZE = 64 * 1024;
-// ── Encoding detection and reading ───────────────────────────────────────────
+// -- Encoding detection and reading -------------------------------------------
 /**
  * Read a file with adaptive encoding fallback:
  * 1. Try UTF-8
@@ -86,7 +86,7 @@ export function readFileAdaptive(filePath) {
 }
 /**
  * Async variant of readFileAdaptive using fs.promises.
- * Same encoding fallback logic (UTF-8 → GBK → GB2312) but non-blocking.
+ * Same encoding fallback logic (UTF-8 -> GBK -> GB2312) but non-blocking.
  * Use this in async contexts (e.g., LSP enrichment) to avoid blocking the event loop.
  */
 export async function readFileAdaptiveAsync(filePath) {
@@ -126,7 +126,7 @@ export async function readFileAdaptiveAsync(filePath) {
     // Last resort: UTF-8 with replacement
     return buffer.toString("utf-8");
 }
-// ── Internal helpers ─────────────────────────────────────────────────────────
+// -- Internal helpers ---------------------------------------------------------
 /**
  * Validate that a buffer contains only valid UTF-8 byte sequences.
  * Performs byte-level validation: rejects overlong encodings, lone continuation

package/dist/core/git-hooks.js

@@ -44,7 +44,7 @@ echo "[shazam] Checking $CHANGED_FILES changed file(s)..."
 
 ERRORS=0
 
-# ── TypeScript/JavaScript ──────────────────────────────────────────────
+# -- TypeScript/JavaScript ----------------------------------------------
 if [ -f "tsconfig.json" ] || [ -f "package.json" ]; then
   # Type check
   if command -v npx &>/dev/null; then
@@ -73,7 +73,7 @@ if [ -f "tsconfig.json" ] || [ -f "package.json" ]; then
   fi
 fi
 
-# ── Rust ───────────────────────────────────────────────────────────────
+# -- Rust ---------------------------------------------------------------
 if [ -f "Cargo.toml" ]; then
   if command -v cargo &>/dev/null; then
     echo "[shazam] Running cargo check..."
@@ -93,7 +93,7 @@ if [ -f "Cargo.toml" ]; then
   fi
 fi
 
-# ── Go ─────────────────────────────────────────────────────────────────
+# -- Go -----------------------------------------------------------------
 if [ -f "go.mod" ]; then
   if command -v go &>/dev/null; then
     echo "[shazam] Running go vet..."
@@ -113,7 +113,7 @@ if [ -f "go.mod" ]; then
   fi
 fi
 
-# ── Python ─────────────────────────────────────────────────────────────
+# -- Python -------------------------------------------------------------
 if [ -f "pyproject.toml" ] || [ -f "setup.py" ] || [ -f "requirements.txt" ]; then
   # Type check (pyright or mypy)
   if command -v pyright &>/dev/null; then
@@ -140,7 +140,7 @@ if [ -f "pyproject.toml" ] || [ -f "setup.py" ] || [ -f "requirements.txt" ]; th
   fi
 fi
 
-# ── Summary ────────────────────────────────────────────────────────────
+# -- Summary ------------------------------------------------------------
 if [ $ERRORS -gt 0 ]; then
   echo "[shazam] FAIL: $ERRORS check(s) failed."
   echo "[shazam] Fix errors or use 'git commit --no-verify' to bypass."
@@ -291,7 +291,7 @@ export function runPreCommitVerify(projectRoot) {
         }
         const changedFiles = changedOutput.split("\n").filter(Boolean);
         const errors = [];
-        // ── TypeScript/JavaScript ──────────────────────────────────────────
+        // -- TypeScript/JavaScript ------------------------------------------
         if (existsSync(join(projectRoot, "tsconfig.json"))) {
             try {
                 execFileSync("npx", ["--no-install", "tsc", "--noEmit"], {
@@ -306,7 +306,7 @@ export function runPreCommitVerify(projectRoot) {
                 errors.push(`TypeScript typecheck failed: ${String(stderr).slice(0, 500)}`);
             }
         }
-        // ── Rust ───────────────────────────────────────────────────────────
+        // -- Rust -----------------------------------------------------------
         if (existsSync(join(projectRoot, "Cargo.toml"))) {
             try {
                 execFileSync("cargo", ["check"], {
@@ -321,7 +321,7 @@ export function runPreCommitVerify(projectRoot) {
                 errors.push(`cargo check failed: ${String(stderr).slice(0, 500)}`);
             }
         }
-        // ── Go ─────────────────────────────────────────────────────────────
+        // -- Go -------------------------------------------------------------
         if (existsSync(join(projectRoot, "go.mod"))) {
             try {
                 execFileSync("go", ["vet", "./..."], {
@@ -336,7 +336,7 @@ export function runPreCommitVerify(projectRoot) {
                 errors.push(`go vet failed: ${String(stderr).slice(0, 500)}`);
             }
         }
-        // ── Python ─────────────────────────────────────────────────────────
+        // -- Python ---------------------------------------------------------
         if (existsSync(join(projectRoot, "pyproject.toml")) || existsSync(join(projectRoot, "setup.py"))) {
             // Try pyright first, then mypy
             let pyrightAvailable = false;
@@ -376,7 +376,7 @@ export function runPreCommitVerify(projectRoot) {
                 }
             }
         }
-        // ── Summary ────────────────────────────────────────────────────────
+        // -- Summary --------------------------------------------------------
         if (errors.length > 0) {
             return {
                 verdict: "FAIL",

package/dist/core/git-utils.d.ts

@@ -1,63 +1,65 @@
 /**
- * pi-shazam core/git-utils — 共享 git 工具函数。
+ * pi-shazam core/git-utils — Shared git utility functions.
  *
- * 解决 issue #350：在非 git 仓库目录下，扩展会输出 git 的 stderr 错误
- * （"fatal: not a git repository"），污染用户终端/UI。
+ * Fixes issue #350: in non-git-repo directories, the extension would output
+ * git's stderr errors ("fatal: not a git repository"), polluting the user's terminal/UI.
  *
- * 本模块提供：
- * - isGitRepo: 一次性检测目录是否为 git 仓库，结果缓存，避免反复 spawn git 进程
- * - isProjectDir: 检测目录是否为项目目录（有标记文件或 git 仓库），用于快速短路
- * - safeGitExec: 安全执行 git 命令，自动抑制 stderr，非 git 仓库直接返回 null
+ * This module provides:
+ * - isGitRepo: one-time check whether a directory is a git repo, cached to avoid repeated git process spawns
+ * - isProjectDir: check whether a directory is a project directory (has marker files or git repo), for fast short-circuit
+ * - safeGitExec: safely execute git commands, auto-suppress stderr, return null for non-git repos
  */
 /**
- * 检测目录是否为 git 仓库。
- * 结果缓存到进程生命周期，同一目录只检测一次。
+ * Check whether a directory is a git repository.
+ * Result is cached for the process lifetime; each directory is checked only once.
  *
- * 使用 `git rev-parse --is-inside-work-tree` 检测，
- * stderr 被完全抑制（stdio: ["ignore", "pipe", "ignore"]），
- * 避免 "fatal: not a git repository" 泄漏到用户终端。
+ * Uses `git rev-parse --is-inside-work-tree` for detection,
+ * with stderr fully suppressed (stdio: ["ignore", "pipe", "ignore"]),
+ * preventing "fatal: not a git repository" from leaking to the user's terminal.
  */
 export declare function isGitRepo(projectRoot: string): boolean;
 /**
- * 检测目录是否为项目目录（有标记文件或 git 仓库）。
- * 用于 before_agent_start hook 的快速短路判断。
+ * Check whether a directory is a project directory (has marker files or is a git repo).
+ * Used for fast short-circuit in the before_agent_start hook.
  *
- * 非项目目录（如 /tmp、/var、/home）跳过 scanProject，
- * 避免在大型临时目录下同步扫描导致阻塞。
+ * Non-project directories (e.g., /tmp, /var, /home) skip scanProject,
+ * avoiding synchronous blocking on large temporary directories.
  */
 export declare function isProjectDir(projectRoot: string): boolean;
 /**
- * 安全执行 git 命令。
- * - 非 git 仓库：直接返回 null（不 spawn git 进程）
- * - git 仓库：执行命令，抑制 stderr，返回 stdout；失败返回 null
- *
- * @param args - git 子命令参数（如 ["log", "--oneline", "-10"]）
- * @param cwd - 工作目录
- * @param timeout - 超时毫秒数（默认 5000）
- * @returns stdout 字符串，或 null（非 git 仓库/执行失败）
+ * Safely execute a git command.
+ * - Non-git repo: returns null immediately (no git process spawned)
+ * - Git repo: executes command, suppresses stderr, returns stdout; returns null on failure
+ *
+ * @param args - git subcommand arguments (e.g., ["log", "--oneline", "-10"])
+ * @param cwd - working directory
+ * @param timeout - timeout in milliseconds (default 5000)
+ * @returns stdout string, or null (non-git repo / execution failure)
  */
 export declare function safeGitExec(args: string[], cwd: string, timeout?: number): string | null;
 /**
- * 解析 git 工作目录的实际路径。
+ * Resolve the actual path of the git working directory.
  *
- * 使用 `git rev-parse --show-toplevel` 解析，在 git worktree 中会返回
- * worktree 根目录而非主仓库目录（issue #226）。
+ * Uses `git rev-parse --show-toplevel` for resolution. In a git worktree,
+ * this returns the worktree root directory rather than the main repo
+ * directory (issue #226).
  *
- * 当路径不在 git 仓库中时返回 `cwd`。
+ * Returns `cwd` when the path is not inside a git repository.
  */
 export declare function resolveGitWorkdir(cwd: string): string;
 /**
- * 获取 git 工作树中已变更的文件列表。
+ * Get the list of changed files in the git working tree.
  *
- * 同时检查未暂存 (`git diff`) 和已暂存 (`git diff --cached`) 的变更，
- * 仅包含新增、修改、复制、重命名类型的变更（ACMR），自动去重。
+ * Checks both unstaged (`git diff`) and staged (`git diff --cached`) changes,
+ * including only added, modified, copied, and renamed change types (ACMR),
+ * with automatic deduplication.
  *
- * @param projectRoot - 项目根目录（会内部解析 git 工作目录）
- * @returns 已变更文件的相对路径数组
+ * @param projectRoot - project root directory (internally resolves git working directory)
+ * @returns array of relative paths of changed files
  */
 export declare function getGitChangedFiles(projectRoot: string): string[];
 /**
- * 重置 git 缓存。仅在测试中使用。
+ * Reset git cache. Used only in tests.
  */
 export declare function _resetGitCache(): void;
 //# sourceMappingURL=git-utils.d.ts.map

package/dist/core/git-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../core/git-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqCH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAqBtD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,MAAM,GAAG,IAAI,CAetF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}
+{"version":3,"file":"git-utils.d.ts","sourceRoot":"","sources":["../../core/git-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqCH;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAqBtD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,MAAM,GAAG,IAAI,CAgBtF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/core/git-utils.js

@@ -1,21 +1,21 @@
 /**
- * pi-shazam core/git-utils — 共享 git 工具函数。
+ * pi-shazam core/git-utils — Shared git utility functions.
  *
- * 解决 issue #350：在非 git 仓库目录下，扩展会输出 git 的 stderr 错误
- * （"fatal: not a git repository"），污染用户终端/UI。
+ * Fixes issue #350: in non-git-repo directories, the extension would output
+ * git's stderr errors ("fatal: not a git repository"), polluting the user's terminal/UI.
  *
- * 本模块提供：
- * - isGitRepo: 一次性检测目录是否为 git 仓库，结果缓存，避免反复 spawn git 进程
- * - isProjectDir: 检测目录是否为项目目录（有标记文件或 git 仓库），用于快速短路
- * - safeGitExec: 安全执行 git 命令，自动抑制 stderr，非 git 仓库直接返回 null
+ * This module provides:
+ * - isGitRepo: one-time check whether a directory is a git repo, cached to avoid repeated git process spawns
+ * - isProjectDir: check whether a directory is a project directory (has marker files or git repo), for fast short-circuit
+ * - safeGitExec: safely execute git commands, auto-suppress stderr, return null for non-git repos
  */
 import { execFileSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
-// ── 项目标记文件列表 ────────────────────────────────────────────────────────
+// -- Project marker file list ------------------------------------------------
 /**
- * 判断目录是否为项目根目录的标记文件。
- * 任一文件存在即视为项目目录。
+ * Marker files that indicate a directory is a project root.
+ * If any of these files exist, the directory is treated as a project directory.
  */
 const PROJECT_MARKERS = [
     "package.json",
@@ -31,20 +31,20 @@ const PROJECT_MARKERS = [
     "pubspec.yaml", // Dart/Flutter
     ".git",
 ];
-// ── Git 可用性缓存 ──────────────────────────────────────────────────────────
+// -- Git availability cache --------------------------------------------------
 /**
- * 缓存已检测的 git 仓库状态。key = 目录绝对路径，value = 是否为 git 仓库。
- * 进程生命周期内缓存，避免对同一目录反复 spawn git 进程。
+ * Cache of git repo detection results. key = directory absolute path, value = whether it's a git repo.
+ * Cached for the process lifetime to avoid repeatedly spawning git processes for the same directory.
  */
 const gitRepoCache = new Map();
-// ── 核心函数 ────────────────────────────────────────────────────────────────
+// -- Core functions ----------------------------------------------------------
 /**
- * 检测目录是否为 git 仓库。
- * 结果缓存到进程生命周期，同一目录只检测一次。
+ * Check whether a directory is a git repository.
+ * Result is cached for the process lifetime; each directory is checked only once.
  *
- * 使用 `git rev-parse --is-inside-work-tree` 检测，
- * stderr 被完全抑制（stdio: ["ignore", "pipe", "ignore"]），
- * 避免 "fatal: not a git repository" 泄漏到用户终端。
+ * Uses `git rev-parse --is-inside-work-tree` for detection,
+ * with stderr fully suppressed (stdio: ["ignore", "pipe", "ignore"]),
+ * preventing "fatal: not a git repository" from leaking to the user's terminal.
  */
 export function isGitRepo(projectRoot) {
     const cached = gitRepoCache.get(projectRoot);
@@ -56,24 +56,24 @@ export function isGitRepo(projectRoot) {
             cwd: projectRoot,
             encoding: "utf-8",
             timeout: 3000,
-            // 抑制 stderr，防止 "fatal: not a git repository" 泄漏到用户终端
+            // Suppress stderr to prevent "fatal: not a git repository" from leaking to user's terminal
             stdio: ["ignore", "pipe", "ignore"],
         });
         result = output.trim() === "true";
     }
-    catch {
-        // git 不可用或非 git 仓库 — 正常情况，不报错
+    catch (err) {
+        console.warn(`[pi-shazam] isGitRepo: git rev-parse failed for ${projectRoot}`, err);
         result = false;
     }
     gitRepoCache.set(projectRoot, result);
     return result;
 }
 /**
- * 检测目录是否为项目目录（有标记文件或 git 仓库）。
- * 用于 before_agent_start hook 的快速短路判断。
+ * Check whether a directory is a project directory (has marker files or is a git repo).
+ * Used for fast short-circuit in the before_agent_start hook.
  *
- * 非项目目录（如 /tmp、/var、/home）跳过 scanProject，
- * 避免在大型临时目录下同步扫描导致阻塞。
+ * Non-project directories (e.g., /tmp, /var, /home) skip scanProject,
+ * avoiding synchronous blocking on large temporary directories.
  */
 export function isProjectDir(projectRoot) {
     for (const marker of PROJECT_MARKERS) {
@@ -84,17 +84,17 @@ export function isProjectDir(projectRoot) {
     return false;
 }
 /**
- * 安全执行 git 命令。
- * - 非 git 仓库：直接返回 null（不 spawn git 进程）
- * - git 仓库：执行命令，抑制 stderr，返回 stdout；失败返回 null
+ * Safely execute a git command.
+ * - Non-git repo: returns null immediately (no git process spawned)
+ * - Git repo: executes command, suppresses stderr, returns stdout; returns null on failure
  *
- * @param args - git 子命令参数（如 ["log", "--oneline", "-10"]）
- * @param cwd - 工作目录
- * @param timeout - 超时毫秒数（默认 5000）
- * @returns stdout 字符串，或 null（非 git 仓库/执行失败）
+ * @param args - git subcommand arguments (e.g., ["log", "--oneline", "-10"])
+ * @param cwd - working directory
+ * @param timeout - timeout in milliseconds (default 5000)
+ * @returns stdout string, or null (non-git repo / execution failure)
  */
 export function safeGitExec(args, cwd, timeout = 5000) {
-    // 非 git 仓库直接返回，避免 spawn 注定失败的 git 进程
+    // Non-git repo: return early to avoid spawning a git process that will fail
     if (!isGitRepo(cwd))
         return null;
     try {
@@ -102,34 +102,37 @@ export function safeGitExec(args, cwd, timeout = 5000) {
             cwd,
             encoding: "utf-8",
             timeout,
-            // 抑制 stderr，防止 git 错误信息泄漏到用户终端
+            // Suppress stderr to prevent git error messages from leaking to user's terminal
             stdio: ["ignore", "pipe", "ignore"],
         }).trim();
     }
-    catch {
+    catch (err) {
+        console.warn(`[pi-shazam] safeGitExec: git ${args.join(" ")} failed for ${cwd}`, err);
         return null;
     }
 }
 /**
- * 解析 git 工作目录的实际路径。
+ * Resolve the actual path of the git working directory.
  *
- * 使用 `git rev-parse --show-toplevel` 解析，在 git worktree 中会返回
- * worktree 根目录而非主仓库目录（issue #226）。
+ * Uses `git rev-parse --show-toplevel` for resolution. In a git worktree,
+ * this returns the worktree root directory rather than the main repo
+ * directory (issue #226).
  *
- * 当路径不在 git 仓库中时返回 `cwd`。
+ * Returns `cwd` when the path is not inside a git repository.
  */
 export function resolveGitWorkdir(cwd) {
     const result = safeGitExec(["rev-parse", "--show-toplevel"], cwd, 5000);
     return result || cwd;
 }
 /**
- * 获取 git 工作树中已变更的文件列表。
+ * Get the list of changed files in the git working tree.
  *
- * 同时检查未暂存 (`git diff`) 和已暂存 (`git diff --cached`) 的变更，
- * 仅包含新增、修改、复制、重命名类型的变更（ACMR），自动去重。
+ * Checks both unstaged (`git diff`) and staged (`git diff --cached`) changes,
+ * including only added, modified, copied, and renamed change types (ACMR),
+ * with automatic deduplication.
  *
- * @param projectRoot - 项目根目录（会内部解析 git 工作目录）
- * @returns 已变更文件的相对路径数组
+ * @param projectRoot - project root directory (internally resolves git working directory)
+ * @returns array of relative paths of changed files
  */
 export function getGitChangedFiles(projectRoot) {
     const gitDir = resolveGitWorkdir(projectRoot);
@@ -141,7 +144,7 @@ export function getGitChangedFiles(projectRoot) {
     return [...new Set(combined.split("\n").filter(Boolean))];
 }
 /**
- * 重置 git 缓存。仅在测试中使用。
+ * Reset git cache. Used only in tests.
  */
 export function _resetGitCache() {
     gitRepoCache.clear();

package/dist/core/git-utils.js.map

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

package/dist/core/graph.d.ts

@@ -39,7 +39,7 @@ export interface RepoGraph {
     fileImportBindings: Map<string, JSImportBinding[]>;
     /** Index symbols by name for O(1) lookup in findCalleeSymbols / findSymbolByNameInFile */
     nameIndex: Map<string, Symbol[]>;
-    /** Reverse edge index: target symbol ID → set of source symbol IDs pointing to it, speeds up cross-file edge cleanup in removeEdgesForFile */
+    /** Reverse edge index: target symbol ID -> set of source symbol IDs pointing to it, speeds up cross-file edge cleanup in removeEdgesForFile */
     targetToSources: Map<string, Set<string>>;
 }
 /** A JS/TS import binding */

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

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