jinzd-ai-cli 0.4.75 → 0.4.77

package/README.md

@@ -29,6 +29,8 @@
 - **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
+- **Semantic Code Search** *(v0.4.77+)* — `search_code` tool finds code by meaning, not name. Local sentence embeddings (multilingual MiniLM, 117 MB one-time download) score symbols by cosine similarity against natural-language queries in English or Chinese ("where are users authenticated", "哪里做了速率限制"). No API key, runs on CPU. Manage with `/index semantic-rebuild|semantic-clear`
 - **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 +147,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 +175,10 @@ 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 |
+| `search_code` | safe | Semantic (meaning-based) code search via local sentence embeddings — bilingual, "grep by meaning" |
 
 **Safety levels**: `safe` = auto-execute, `write` = diff preview + confirmation, `destructive` = prominent warning + confirmation.
 
@@ -195,6 +201,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 symbol + semantic index (status/rebuild/clear/semantic-rebuild/semantic-clear) — powers `find_symbol` / `get_outline` / `find_references` / `search_code` (C1+C2) |
 | `/search <keyword>` | Full-text search across all sessions |
 | `/skill` | Manage agent skill packs |
 | `/mcp` | View MCP server status and tools |

package/dist/{chunk-C4MGON2N.js → chunk-5PZMIBEN.js}

@@ -2,7 +2,7 @@
 import {
   schemaToJsonSchema,
   truncateForPersist
-} from "./chunk-MPIUYP6Q.js";
+} from "./chunk-LKDX2GOW.js";
 import {
   AuthError,
   ProviderError,
@@ -18,7 +18,7 @@ import {
   MCP_PROTOCOL_VERSION,
   MCP_TOOL_PREFIX,
   VERSION
-} from "./chunk-5P4QTZBI.js";
+} from "./chunk-S4WDPHKS.js";
 
 // src/providers/claude.ts
 import Anthropic from "@anthropic-ai/sdk";

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-HPDDAXFY.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import {
+  loadIndex
+} from "./chunk-6VRJGH25.js";
+import {
+  EMBEDDING_DIM,
+  embed,
+  embedOne,
+  loadVectorStore,
+  saveVectorStore,
+  searchVectorStore
+} from "./chunk-PFYAAX2S.js";
+
+// src/symbols/semantic.ts
+function buildEmbeddingText(s) {
+  const parts = [s.kind, s.name];
+  if (s.container) parts.push(`in ${s.container}`);
+  if (s.signature) parts.push(s.signature);
+  if (s.doc) parts.push(s.doc);
+  return parts.join(" ").slice(0, 512);
+}
+async function rebuildSemanticIndex(root, opts = {}) {
+  const start = Date.now();
+  const index = loadIndex(root);
+  if (!index) {
+    throw new Error(
+      `No symbol index for ${root}. Run /index rebuild first so find_symbol has data to embed.`
+    );
+  }
+  const maxSymbols = opts.maxSymbols ?? 2e4;
+  const batchSize = opts.batchSize ?? 32;
+  const total = Math.min(index.symbols.length, maxSymbols);
+  if (total === 0) {
+    saveVectorStore(root, new Uint32Array(0), new Float32Array(0));
+    return { symbolsEmbedded: 0, durationMs: Date.now() - start };
+  }
+  const symbolIdx = new Uint32Array(total);
+  const vectors = new Float32Array(total * EMBEDDING_DIM);
+  let modelFirstLoadMs;
+  for (let i = 0; i < total; i += batchSize) {
+    const end = Math.min(i + batchSize, total);
+    const batch = [];
+    for (let j = i; j < end; j++) {
+      symbolIdx[j] = j;
+      batch.push(buildEmbeddingText(index.symbols[j]));
+    }
+    const batchStart = Date.now();
+    const rows = await embed(batch);
+    if (i === 0) modelFirstLoadMs = Date.now() - batchStart;
+    for (let r = 0; r < rows.length; r++) {
+      vectors.set(rows[r], (i + r) * EMBEDDING_DIM);
+    }
+    if (opts.onProgress) opts.onProgress(end, total);
+  }
+  saveVectorStore(root, symbolIdx, vectors);
+  return {
+    symbolsEmbedded: total,
+    durationMs: Date.now() - start,
+    modelFirstLoadMs
+  };
+}
+async function semanticSearch(root, query, k = 10) {
+  const index = loadIndex(root);
+  if (!index) return [];
+  const store = loadVectorStore(root);
+  if (!store || store.count === 0) return [];
+  const queryVec = await embedOne(query);
+  const hits = searchVectorStore(store, queryVec, k);
+  return hits.map((h) => ({
+    ...h,
+    symbol: index.symbols[h.symbolIdx]
+  })).filter((h) => h.symbol !== void 0);
+}
+function hasSemanticIndex(root) {
+  const s = loadVectorStore(root);
+  return s !== null && s.count > 0;
+}
+
+export {
+  buildEmbeddingText,
+  rebuildSemanticIndex,
+  semanticSearch,
+  hasSemanticIndex
+};

package/dist/{chunk-E6RP5DBU.js → chunk-IR5EW57V.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.77";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";
@@ -35,8 +35,16 @@ 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)
+  "search_code"
+  // C2 semantic search (read-only)
 ]);
 var PLAN_MODE_SYSTEM_ADDON = `# \u{1F50D} Plan Mode \u2014 Read-Only Planning Mode
 
@@ -76,7 +84,11 @@ var SUBAGENT_ALLOWED_TOOLS = /* @__PURE__ */ new Set([
   "web_fetch",
   "google_search",
   "write_todos",
-  "run_tests"
+  "run_tests",
+  "find_symbol",
+  "get_outline",
+  "find_references",
+  "search_code"
 ]);
 var TEST_TIMEOUT = 3e5;
 var AGENTIC_BEHAVIOR_GUIDELINE = `# Important Behavioral Guidelines