jinzd-ai-cli 0.4.75 → 0.4.76

package/README.md

@@ -29,6 +29,7 @@
 - **Anthropic Batches API** *(v0.4.73+)* — `aicli batch submit/list/status/results/cancel` for 50%-off, 24-hour async processing — ideal for offline analysis and bulk evals
 - **Web UI Session Replay** *(v0.4.71+)* — 🎬 button on every saved session opens a timeline replay: every message, tool call, reasoning, and cache-aware token usage at a glance
 - **Conversation Branching** *(v0.4.74+)* — `/branch list/new/switch/delete/rename` inside the REPL, plus a 🌿 "fork here" button on every replay step — explore alternate directions without losing the original thread
+- **Symbol Index** *(v0.4.76+)* — persistent tree-sitter index for TS/JS/TSX/Python powers three new AI tools: `find_symbol`, `get_outline`, `find_references`. Orders of magnitude faster than grep for definition lookups; background refresh on REPL startup, `/index status|rebuild|clear` to manage
 - **Streaming Tool Use** — Real-time streaming of AI reasoning and tool calls as they happen
 - **Sub-Agents** — Delegate complex subtasks to isolated child agents with independent tool loops
 - **Extended Thinking** — Claude deep reasoning mode with `/think` toggle
@@ -145,7 +146,7 @@ aicli
 
 ## Built-in Tools (Agentic)
 
-AI autonomously invokes these 24 tools during conversations:
+AI autonomously invokes these 27 tools during conversations:
 
 | Tool | Safety | Description |
 |------|--------|-------------|
@@ -173,6 +174,9 @@ AI autonomously invokes these 24 tools during conversations:
 | `git_log` | safe | Show commit history (oneline/full, filter by file/author) |
 | `git_commit` | write | Create a git commit (stage files, message) |
 | `notebook_edit` | write | Edit Jupyter notebook cells (add/edit/delete/move) |
+| `find_symbol` | safe | Locate symbol definitions via persistent tree-sitter index (TS/JS/TSX/Python) |
+| `get_outline` | safe | Enumerate all top-level declarations in one source file |
+| `find_references` | safe | Search indexed files for references to a symbol name |
 
 **Safety levels**: `safe` = auto-execute, `write` = diff preview + confirmation, `destructive` = prominent warning + confirmation.
 
@@ -195,6 +199,7 @@ AI autonomously invokes these 24 tools during conversations:
 | `/checkpoint` | Save/restore conversation checkpoints |
 | `/fork` | Fork the current session into a new session file |
 | `/branch` | Create/switch/delete branches *within* the current session (B2) |
+| `/index` | Manage tree-sitter symbol index (status/rebuild/clear) — powers `find_symbol` / `get_outline` / `find_references` (C1) |
 | `/search <keyword>` | Full-text search across all sessions |
 | `/skill` | Manage agent skill packs |
 | `/mcp` | View MCP server status and tools |

package/dist/{chunk-5P4QTZBI.js → chunk-2Q77FT3F.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/core/constants.ts
-var VERSION = "0.4.75";
+var VERSION = "0.4.76";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";
@@ -30,8 +30,14 @@ var PLAN_MODE_READONLY_TOOLS = /* @__PURE__ */ new Set([
   "google_search",
   "ask_user",
   // 允许：可向用户澄清需求
-  "write_todos"
+  "write_todos",
   // 允许：可输出任务列表作为实施计划
+  "find_symbol",
+  // C1 symbol index (read-only)
+  "get_outline",
+  // C1 symbol index (read-only)
+  "find_references"
+  // C1 symbol index (read-only)
 ]);
 var PLAN_MODE_SYSTEM_ADDON = `# \u{1F50D} Plan Mode \u2014 Read-Only Planning Mode
 
@@ -71,7 +77,10 @@ var SUBAGENT_ALLOWED_TOOLS = /* @__PURE__ */ new Set([
   "web_fetch",
   "google_search",
   "write_todos",
-  "run_tests"
+  "run_tests",
+  "find_symbol",
+  "get_outline",
+  "find_references"
 ]);
 var CONTEXT_PRESSURE_THRESHOLD = 0.8;
 var TEST_TIMEOUT = 3e5;

package/dist/{chunk-E6RP5DBU.js → chunk-34NJTPWZ.js}

@@ -6,7 +6,7 @@ import { platform } from "os";
 import chalk from "chalk";
 
 // src/core/constants.ts
-var VERSION = "0.4.75";
+var VERSION = "0.4.76";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";
@@ -35,8 +35,14 @@ var PLAN_MODE_READONLY_TOOLS = /* @__PURE__ */ new Set([
   "google_search",
   "ask_user",
   // 允许：可向用户澄清需求
-  "write_todos"
+  "write_todos",
   // 允许：可输出任务列表作为实施计划
+  "find_symbol",
+  // C1 symbol index (read-only)
+  "get_outline",
+  // C1 symbol index (read-only)
+  "find_references"
+  // C1 symbol index (read-only)
 ]);
 var PLAN_MODE_SYSTEM_ADDON = `# \u{1F50D} Plan Mode \u2014 Read-Only Planning Mode
 
@@ -76,7 +82,10 @@ var SUBAGENT_ALLOWED_TOOLS = /* @__PURE__ */ new Set([
   "web_fetch",
   "google_search",
   "write_todos",
-  "run_tests"
+  "run_tests",
+  "find_symbol",
+  "get_outline",
+  "find_references"
 ]);
 var TEST_TIMEOUT = 3e5;
 var AGENTIC_BEHAVIOR_GUIDELINE = `# Important Behavioral Guidelines

package/dist/chunk-6VRJGH25.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+// src/symbols/store.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+import crypto from "crypto";
+
+// src/symbols/types.ts
+var SYMBOL_INDEX_VERSION = 1;
+function detectLanguage(ext) {
+  switch (ext.toLowerCase()) {
+    case "ts":
+    case "mts":
+    case "cts":
+      return "typescript";
+    case "tsx":
+      return "tsx";
+    case "js":
+    case "mjs":
+    case "cjs":
+    case "jsx":
+      return "javascript";
+    case "py":
+    case "pyi":
+      return "python";
+    default:
+      return null;
+  }
+}
+
+// src/symbols/store.ts
+var INDEX_DIR_NAME = "index";
+function indexDir() {
+  return path.join(os.homedir(), ".aicli", INDEX_DIR_NAME);
+}
+function projectHash(root) {
+  const normalized = path.resolve(root).toLowerCase();
+  return crypto.createHash("sha1").update(normalized).digest("hex").slice(0, 16);
+}
+function indexPath(root) {
+  return path.join(indexDir(), `${projectHash(root)}.json`);
+}
+function loadIndex(root) {
+  const p = indexPath(root);
+  try {
+    if (!fs.existsSync(p)) return null;
+    const raw = fs.readFileSync(p, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== SYMBOL_INDEX_VERSION) return null;
+    if (parsed.root && path.resolve(parsed.root) !== path.resolve(root)) {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function saveIndex(index) {
+  const dir = indexDir();
+  fs.mkdirSync(dir, { recursive: true });
+  const target = indexPath(index.root);
+  const tmp = `${target}.tmp`;
+  fs.writeFileSync(tmp, JSON.stringify(index), "utf-8");
+  fs.renameSync(tmp, target);
+}
+function clearIndex(root) {
+  const p = indexPath(root);
+  try {
+    if (fs.existsSync(p)) fs.unlinkSync(p);
+  } catch {
+  }
+}
+function emptyIndex(root) {
+  return {
+    version: SYMBOL_INDEX_VERSION,
+    root: path.resolve(root),
+    generated: (/* @__PURE__ */ new Date()).toISOString(),
+    fileCount: 0,
+    symbolCount: 0,
+    files: {},
+    symbols: []
+  };
+}
+function upsertFileSymbols(index, file, mtime, symbols) {
+  const absFile = path.resolve(file);
+  const had = absFile in index.files;
+  index.symbols = index.symbols.filter((s) => s.location.file !== absFile);
+  index.symbols.push(...symbols);
+  index.files[absFile] = mtime;
+  index.symbolCount = index.symbols.length;
+  if (!had) index.fileCount = Object.keys(index.files).length;
+  index.generated = (/* @__PURE__ */ new Date()).toISOString();
+  return index;
+}
+function removeFile(index, file) {
+  const absFile = path.resolve(file);
+  if (!(absFile in index.files)) return index;
+  index.symbols = index.symbols.filter((s) => s.location.file !== absFile);
+  delete index.files[absFile];
+  index.symbolCount = index.symbols.length;
+  index.fileCount = Object.keys(index.files).length;
+  index.generated = (/* @__PURE__ */ new Date()).toISOString();
+  return index;
+}
+
+export {
+  detectLanguage,
+  loadIndex,
+  saveIndex,
+  clearIndex,
+  emptyIndex,
+  upsertFileSymbols,
+  removeFile
+};

package/dist/chunk-BJAT4GNC.js

@@ -0,0 +1,113 @@
+// src/symbols/store.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+import crypto from "crypto";
+
+// src/symbols/types.ts
+var SYMBOL_INDEX_VERSION = 1;
+function detectLanguage(ext) {
+  switch (ext.toLowerCase()) {
+    case "ts":
+    case "mts":
+    case "cts":
+      return "typescript";
+    case "tsx":
+      return "tsx";
+    case "js":
+    case "mjs":
+    case "cjs":
+    case "jsx":
+      return "javascript";
+    case "py":
+    case "pyi":
+      return "python";
+    default:
+      return null;
+  }
+}
+
+// src/symbols/store.ts
+var INDEX_DIR_NAME = "index";
+function indexDir() {
+  return path.join(os.homedir(), ".aicli", INDEX_DIR_NAME);
+}
+function projectHash(root) {
+  const normalized = path.resolve(root).toLowerCase();
+  return crypto.createHash("sha1").update(normalized).digest("hex").slice(0, 16);
+}
+function indexPath(root) {
+  return path.join(indexDir(), `${projectHash(root)}.json`);
+}
+function loadIndex(root) {
+  const p = indexPath(root);
+  try {
+    if (!fs.existsSync(p)) return null;
+    const raw = fs.readFileSync(p, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== SYMBOL_INDEX_VERSION) return null;
+    if (parsed.root && path.resolve(parsed.root) !== path.resolve(root)) {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function saveIndex(index) {
+  const dir = indexDir();
+  fs.mkdirSync(dir, { recursive: true });
+  const target = indexPath(index.root);
+  const tmp = `${target}.tmp`;
+  fs.writeFileSync(tmp, JSON.stringify(index), "utf-8");
+  fs.renameSync(tmp, target);
+}
+function clearIndex(root) {
+  const p = indexPath(root);
+  try {
+    if (fs.existsSync(p)) fs.unlinkSync(p);
+  } catch {
+  }
+}
+function emptyIndex(root) {
+  return {
+    version: SYMBOL_INDEX_VERSION,
+    root: path.resolve(root),
+    generated: (/* @__PURE__ */ new Date()).toISOString(),
+    fileCount: 0,
+    symbolCount: 0,
+    files: {},
+    symbols: []
+  };
+}
+function upsertFileSymbols(index, file, mtime, symbols) {
+  const absFile = path.resolve(file);
+  const had = absFile in index.files;
+  index.symbols = index.symbols.filter((s) => s.location.file !== absFile);
+  index.symbols.push(...symbols);
+  index.files[absFile] = mtime;
+  index.symbolCount = index.symbols.length;
+  if (!had) index.fileCount = Object.keys(index.files).length;
+  index.generated = (/* @__PURE__ */ new Date()).toISOString();
+  return index;
+}
+function removeFile(index, file) {
+  const absFile = path.resolve(file);
+  if (!(absFile in index.files)) return index;
+  index.symbols = index.symbols.filter((s) => s.location.file !== absFile);
+  delete index.files[absFile];
+  index.symbolCount = index.symbols.length;
+  index.fileCount = Object.keys(index.files).length;
+  index.generated = (/* @__PURE__ */ new Date()).toISOString();
+  return index;
+}
+
+export {
+  detectLanguage,
+  loadIndex,
+  saveIndex,
+  clearIndex,
+  emptyIndex,
+  upsertFileSymbols,
+  removeFile
+};

package/dist/{chunk-ASNDBI5R.js → chunk-H4DQNZZ6.js}

@@ -8,7 +8,7 @@ import {
   CONFIG_FILE_NAME,
   HISTORY_DIR_NAME,
   PLUGINS_DIR_NAME
-} from "./chunk-5P4QTZBI.js";
+} from "./chunk-2Q77FT3F.js";
 
 // src/config/config-manager.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";

package/dist/{chunk-3BHGEPIT.js → chunk-K3JJX2Z5.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   TEST_TIMEOUT
-} from "./chunk-5P4QTZBI.js";
+} from "./chunk-2Q77FT3F.js";
 
 // src/tools/builtin/run-tests.ts
 import { execSync } from "child_process";

package/dist/{chunk-MPIUYP6Q.js → chunk-KR4FTJWB.js}

@@ -2,9 +2,15 @@
 import {
   fileCheckpoints
 } from "./chunk-4BKXL7SM.js";
+import {
+  indexProject
+} from "./chunk-NHNWUBXB.js";
+import {
+  loadIndex
+} from "./chunk-6VRJGH25.js";
 import {
   runTestsTool
-} from "./chunk-3BHGEPIT.js";
+} from "./chunk-K3JJX2Z5.js";
 import {
   EnvLoader,
   NetworkError,
@@ -17,7 +23,7 @@ import {
   SUBAGENT_ALLOWED_TOOLS,
   SUBAGENT_DEFAULT_MAX_ROUNDS,
   SUBAGENT_MAX_ROUNDS_LIMIT
-} from "./chunk-5P4QTZBI.js";
+} from "./chunk-2Q77FT3F.js";
 
 // src/tools/builtin/bash.ts
 import { execSync } from "child_process";
@@ -1028,8 +1034,8 @@ function checkPermission(toolName, args, dangerLevel, rules, defaultAction = "co
     if (rule.when) {
       if (rule.when.dangerLevel && rule.when.dangerLevel !== dangerLevel) continue;
       if (rule.when.pathPattern) {
-        const path = String(args["path"] ?? args["command"] ?? "");
-        if (!path.includes(rule.when.pathPattern)) continue;
+        const path3 = String(args["path"] ?? args["command"] ?? "");
+        if (!path3.includes(rule.when.pathPattern)) continue;
       }
     }
     return rule.action;
@@ -1729,6 +1735,13 @@ Important: For long content (over 500 lines or 3000 chars), you MUST split into
     }
     const lines = content.split("\n").length;
     const mode = appendMode ? "appended" : "written";
+    void (async () => {
+      try {
+        const { updateFile } = await import("./indexer-C7QYYHSZ.js");
+        await updateFile(process.cwd(), filePath);
+      } catch {
+      }
+    })();
     return `File ${mode}: ${filePath} (${lines} lines, ${content.length} bytes)`;
   }
 };
@@ -4286,6 +4299,220 @@ var notebookEditTool = {
   }
 };
 
+// src/tools/builtin/symbol-tools.ts
+import path2 from "path";
+
+// src/symbols/queries.ts
+import path from "path";
+import fs from "fs";
+function findSymbol(index, opts) {
+  const name = opts.name.toLowerCase();
+  const exact = opts.exact !== false;
+  const kinds = opts.kind ? new Set(Array.isArray(opts.kind) ? opts.kind : [opts.kind]) : null;
+  const limit = opts.limit ?? 50;
+  const out = [];
+  for (const s of index.symbols) {
+    if (kinds && !kinds.has(s.kind)) continue;
+    const lower = s.name.toLowerCase();
+    if (exact ? lower === name : lower.includes(name)) {
+      out.push(s);
+      if (out.length >= limit) break;
+    }
+  }
+  return out;
+}
+function getOutline(index, file) {
+  const abs = path.resolve(file);
+  return index.symbols.filter((s) => s.location.file === abs).sort((a, b) => a.location.line - b.location.line).map((s) => ({
+    name: s.name,
+    kind: s.kind,
+    line: s.location.line,
+    signature: s.signature,
+    container: s.container,
+    exported: s.exported
+  }));
+}
+function findReferences(index, name, opts = {}) {
+  const maxFiles = opts.maxFiles ?? 2e3;
+  const maxHits = opts.maxHits ?? 500;
+  const re = new RegExp(`\\b${name.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\$&")}\\b`);
+  const hits = [];
+  const files = Object.keys(index.files).slice(0, maxFiles);
+  for (const file of files) {
+    let content;
+    try {
+      content = fs.readFileSync(file, "utf-8");
+    } catch {
+      continue;
+    }
+    if (!re.test(content)) continue;
+    const lines = content.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+      const m = re.exec(lines[i]);
+      if (m) {
+        hits.push({
+          file,
+          line: i + 1,
+          column: m.index,
+          text: lines[i].trim().slice(0, 200)
+        });
+        if (hits.length >= maxHits) return hits;
+      }
+    }
+  }
+  return hits;
+}
+
+// src/tools/builtin/symbol-tools.ts
+var NO_INDEX_HINT = "No symbol index exists for this project yet. Ask the user to run `/index rebuild`, or call indexProject() first. Alternatively, use grep_files for a slower fallback.";
+async function ensureIndex(root, autoBuild) {
+  let index = loadIndex(root);
+  if (!index && autoBuild) {
+    const result = await indexProject(root);
+    index = result.index;
+  }
+  return index;
+}
+var findSymbolTool = {
+  definition: {
+    name: "find_symbol",
+    description: "Locate symbol definitions (functions, classes, methods, interfaces, types, variables) across the project using the pre-built symbol index. Orders of magnitude faster than grep_files for definition lookups. Returns file:line locations plus a one-line signature.",
+    parameters: {
+      name: {
+        type: "string",
+        description: 'Symbol name to find (e.g. "handleChat", "ProviderRegistry")',
+        required: true
+      },
+      exact: {
+        type: "boolean",
+        description: "Exact match (default true). When false, substring match (case-insensitive).",
+        required: false
+      },
+      kind: {
+        type: "string",
+        description: "Restrict to one kind: function, method, class, interface, type, enum, variable, property. Omit to search all.",
+        required: false
+      },
+      path: {
+        type: "string",
+        description: "Project root (defaults to current working directory).",
+        required: false
+      },
+      limit: {
+        type: "number",
+        description: "Max results (default 50).",
+        required: false
+      }
+    }
+  },
+  async execute(args) {
+    const name = String(args.name ?? "").trim();
+    if (!name) return "Error: `name` is required.";
+    const root = path2.resolve(String(args.path ?? process.cwd()));
+    const index = await ensureIndex(root, true);
+    if (!index) return NO_INDEX_HINT;
+    const kindArg = args.kind ? String(args.kind) : void 0;
+    const hits = findSymbol(index, {
+      name,
+      exact: args.exact !== false,
+      kind: kindArg,
+      limit: typeof args.limit === "number" ? args.limit : 50
+    });
+    if (hits.length === 0) {
+      return `No symbol matching "${name}" found (index has ${index.symbolCount} symbols across ${index.fileCount} files).`;
+    }
+    const lines = hits.map((s) => {
+      const rel = path2.relative(index.root, s.location.file) || s.location.file;
+      const container = s.container ? ` (in ${s.container})` : "";
+      const exp = s.exported ? " [exported]" : "";
+      const sig = s.signature ? `
+    ${s.signature}` : "";
+      return `${s.kind} ${s.name}${container}${exp} \u2014 ${rel}:${s.location.line}${sig}`;
+    });
+    return `Found ${hits.length} symbol(s):
+${lines.join("\n")}`;
+  }
+};
+var getOutlineTool = {
+  definition: {
+    name: "get_outline",
+    description: "Return the complete list of top-level declarations in a single source file (classes, functions, methods, types), sorted by line number. Use this to understand file structure without reading its full contents.",
+    parameters: {
+      file: {
+        type: "string",
+        description: "Path to the source file (absolute, or relative to project root).",
+        required: true
+      },
+      path: {
+        type: "string",
+        description: "Project root (defaults to current working directory).",
+        required: false
+      }
+    }
+  },
+  async execute(args) {
+    const file = String(args.file ?? "").trim();
+    if (!file) return "Error: `file` is required.";
+    const root = path2.resolve(String(args.path ?? process.cwd()));
+    const absFile = path2.isAbsolute(file) ? file : path2.resolve(root, file);
+    const index = await ensureIndex(root, true);
+    if (!index) return NO_INDEX_HINT;
+    const outline = getOutline(index, absFile);
+    if (outline.length === 0) {
+      return `No indexed symbols found for ${path2.relative(root, absFile) || absFile}. The file may be of an unsupported language (supported: TS/JS/TSX/JSX/Python), unreadable, or not yet re-indexed.`;
+    }
+    const rel = path2.relative(root, absFile) || absFile;
+    const lines = outline.map((o) => {
+      const container = o.container ? ` (in ${o.container})` : "";
+      const exp = o.exported ? " [exported]" : "";
+      return `  ${String(o.line).padStart(5)}: ${o.kind} ${o.name}${container}${exp}`;
+    });
+    return `Outline of ${rel} (${outline.length} symbols):
+${lines.join("\n")}`;
+  }
+};
+var findReferencesTool = {
+  definition: {
+    name: "find_references",
+    description: "Find all textual references to a symbol name across indexed files (whole-word match). MVP: regex-based \u2014 may include unrelated identifiers with the same name. Pair with find_symbol to locate the definition.",
+    parameters: {
+      name: {
+        type: "string",
+        description: "Symbol name to find references for.",
+        required: true
+      },
+      path: {
+        type: "string",
+        description: "Project root (defaults to current working directory).",
+        required: false
+      },
+      max_hits: {
+        type: "number",
+        description: "Max reference hits to return (default 200).",
+        required: false
+      }
+    }
+  },
+  async execute(args) {
+    const name = String(args.name ?? "").trim();
+    if (!name) return "Error: `name` is required.";
+    const root = path2.resolve(String(args.path ?? process.cwd()));
+    const index = await ensureIndex(root, true);
+    if (!index) return NO_INDEX_HINT;
+    const maxHits = typeof args.max_hits === "number" ? args.max_hits : 200;
+    const hits = findReferences(index, name, { maxHits });
+    if (hits.length === 0) {
+      return `No references to "${name}" found in ${index.fileCount} indexed files.`;
+    }
+    const lines = hits.map((h) => {
+      const rel = path2.relative(index.root, h.file) || h.file;
+      return `${rel}:${h.line}:${h.column}  ${h.text}`;
+    });
+    return `Found ${hits.length} reference(s) to "${name}":
+${lines.join("\n")}`;
+  }
+};
+
 // src/core/token-estimator.ts
 var CJK_REGEX = /[\u2E80-\u9FFF\uA000-\uA4FF\uAC00-\uD7FF\uF900-\uFAFF\uFE30-\uFE4F\uFF00-\uFFEF]/g;
 function estimateTokens(text) {
@@ -4341,6 +4568,9 @@ var ToolRegistry = class {
     this.register(gitLogTool);
     this.register(gitCommitTool);
     this.register(notebookEditTool);
+    this.register(findSymbolTool);
+    this.register(getOutlineTool);
+    this.register(findReferencesTool);
   }
   register(tool) {
     this.tools.set(tool.definition.name, tool);