opencode-codebase-index 0.18.0 → 0.18.1

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "codebase-index",
       "description": "Semantic code search and codebase graph tools for Claude Code",
       "source": "./",
-      "version": "0.18.0"
+      "version": "0.18.1"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codebase-index",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "Semantic code search and codebase graph tools for Claude Code",
   "displayName": "Codebase Index",
   "author": {

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codebase-index",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "Semantic code search and codebase graph tools for Codex",
   "author": {
     "name": "Kenneth",

package/dist/index.cjs

@@ -13120,11 +13120,12 @@ function getConfigPaths(projectRoot, host, options) {
   ].map((configPath) => pathNormalize(configPath));
 }
 
-// src/tools/index.ts
-var import_plugin2 = require("@opencode-ai/plugin");
-
-// src/tools/pr-impact.ts
-var import_plugin = require("@opencode-ai/plugin");
+// node_modules/@opencode-ai/plugin/dist/tool.js
+var import_zod = require("zod");
+function tool(input) {
+  return input;
+}
+tool.schema = import_zod.z;
 
 // src/tools/format-pr-impact.ts
 function formatPrImpact(result) {
@@ -13178,16 +13179,16 @@ function formatPrImpact(result) {
 }
 
 // src/tools/pr-impact.ts
-var z = import_plugin.tool.schema;
-var pr_impact = (0, import_plugin.tool)({
+var z2 = tool.schema;
+var pr_impact = tool({
   description: "Analyze the impact of a pull request or branch by examining changed files, affected symbols, transitive callers, communities touched, hub nodes, and risk level. Use to understand blast radius before merging.",
   args: {
-    pr: z.number().optional().describe("Pull request number to analyze"),
-    branch: z.string().optional().describe("Branch name to analyze (defaults to current branch)"),
-    maxDepth: z.number().optional().default(5).describe("Maximum traversal depth for transitive callers (default: 5)"),
-    hubThreshold: z.number().optional().default(10).describe("Minimum caller count to flag a symbol as a hub node (default: 10)"),
-    checkConflicts: z.boolean().optional().default(false).describe("Check for conflicting open PRs touching the same communities (default: false)"),
-    direction: z.enum(["callers", "callees", "both"]).optional().default("both").describe("Call-graph traversal direction: 'callers' for upstream, 'callees' for downstream, 'both' for union (default: both)")
+    pr: z2.number().optional().describe("Pull request number to analyze"),
+    branch: z2.string().optional().describe("Branch name to analyze (defaults to current branch)"),
+    maxDepth: z2.number().optional().default(5).describe("Maximum traversal depth for transitive callers (default: 5)"),
+    hubThreshold: z2.number().optional().default(10).describe("Minimum caller count to flag a symbol as a hub node (default: 10)"),
+    checkConflicts: z2.boolean().optional().default(false).describe("Check for conflicting open PRs touching the same communities (default: false)"),
+    direction: z2.enum(["callers", "callees", "both"]).optional().default("both").describe("Call-graph traversal direction: 'callers' for upstream, 'callees' for downstream, 'both' for union (default: both)")
   },
   async execute(args, context) {
     const indexer = getIndexerForProject2(context?.worktree);
@@ -14164,7 +14165,7 @@ function transformForVisualization(symbols, edges, options = {}) {
 }
 
 // src/tools/index.ts
-var z2 = import_plugin2.tool.schema;
+var z3 = tool.schema;
 var DEFAULT_HOST = "opencode";
 var CHUNK_TYPE_VALUES = [
   "function",
@@ -14186,34 +14187,34 @@ function initializeTools2(projectRoot, config) {
 function getIndexerForProject2(directory) {
   return getIndexerForProject(directory, DEFAULT_HOST);
 }
-var codebase_context = (0, import_plugin2.tool)({
+var codebase_context = tool({
   description: "PREFERRED FIRST TOOL for repository questions. Returns a deduplicated, file-diverse evidence pack within tokenBudget. Provide from and to for dependency paths, symbol for definitions, or only query for conceptual discovery.",
   args: {
-    query: z2.string().describe("The repository question or behavior to locate"),
-    from: z2.string().nullable().optional().describe("Source symbol for a dependency path"),
-    to: z2.string().nullable().optional().describe("Target symbol for a dependency path"),
-    symbol: z2.string().nullable().optional().describe("Exact symbol for authoritative definition lookup"),
-    limit: z2.number().int().min(MIN_CONTEXT_RESULT_LIMIT).max(MAX_CONTEXT_RESULT_LIMIT).nullable().optional().default(10).describe(`Maximum number of results (${MIN_CONTEXT_RESULT_LIMIT}-${MAX_CONTEXT_RESULT_LIMIT})`),
-    maxDepth: z2.number().int().min(MIN_CONTEXT_PATH_DEPTH).max(MAX_CONTEXT_PATH_DEPTH).nullable().optional().default(10).describe(`Maximum call-path traversal depth (${MIN_CONTEXT_PATH_DEPTH}-${MAX_CONTEXT_PATH_DEPTH})`),
-    fileType: z2.string().nullable().optional().describe("Filter by file extension"),
-    directory: z2.string().nullable().optional().describe("Filter by directory path"),
-    tokenBudget: z2.number().int().min(MIN_CONTEXT_PACK_TOKEN_BUDGET).max(MAX_CONTEXT_PACK_TOKEN_BUDGET).nullable().optional().default(DEFAULT_CONTEXT_PACK_TOKEN_BUDGET).describe(`Maximum response tokens (${MIN_CONTEXT_PACK_TOKEN_BUDGET}-${MAX_CONTEXT_PACK_TOKEN_BUDGET})`)
+    query: z3.string().describe("The repository question or behavior to locate"),
+    from: z3.string().nullable().optional().describe("Source symbol for a dependency path"),
+    to: z3.string().nullable().optional().describe("Target symbol for a dependency path"),
+    symbol: z3.string().nullable().optional().describe("Exact symbol for authoritative definition lookup"),
+    limit: z3.number().int().min(MIN_CONTEXT_RESULT_LIMIT).max(MAX_CONTEXT_RESULT_LIMIT).nullable().optional().default(10).describe(`Maximum number of results (${MIN_CONTEXT_RESULT_LIMIT}-${MAX_CONTEXT_RESULT_LIMIT})`),
+    maxDepth: z3.number().int().min(MIN_CONTEXT_PATH_DEPTH).max(MAX_CONTEXT_PATH_DEPTH).nullable().optional().default(10).describe(`Maximum call-path traversal depth (${MIN_CONTEXT_PATH_DEPTH}-${MAX_CONTEXT_PATH_DEPTH})`),
+    fileType: z3.string().nullable().optional().describe("Filter by file extension"),
+    directory: z3.string().nullable().optional().describe("Filter by directory path"),
+    tokenBudget: z3.number().int().min(MIN_CONTEXT_PACK_TOKEN_BUDGET).max(MAX_CONTEXT_PACK_TOKEN_BUDGET).nullable().optional().default(DEFAULT_CONTEXT_PACK_TOKEN_BUDGET).describe(`Maximum response tokens (${MIN_CONTEXT_PACK_TOKEN_BUDGET}-${MAX_CONTEXT_PACK_TOKEN_BUDGET})`)
   },
   async execute(args, context) {
     return (await resolveCodebaseContext(context?.worktree, DEFAULT_HOST, args)).text;
   }
 });
-var codebase_peek = (0, import_plugin2.tool)({
+var codebase_peek = tool({
   description: "Quick lookup of code locations by meaning. Returns only metadata (file, line, name, type) WITHOUT code content. Use this first to find WHERE code is, then use Read tool to examine specific files. Saves tokens by not returning full code blocks. Best for: discovery, navigation, finding multiple related locations.",
   args: {
-    query: z2.string().describe("Natural language description of what code you're looking for."),
-    limit: z2.number().optional().default(10).describe("Maximum number of results to return"),
-    fileType: z2.string().optional().describe("Filter by file extension (e.g., 'ts', 'py', 'rs')"),
-    directory: z2.string().optional().describe("Filter by directory path (e.g., 'src/utils', 'lib')"),
-    chunkType: z2.enum(CHUNK_TYPE_VALUES).optional().describe("Filter by code chunk type"),
-    blameAuthor: z2.string().optional().describe("Filter by git blame author name or email"),
-    blameSha: z2.string().optional().describe("Filter by git blame commit SHA or prefix"),
-    blameSince: z2.string().optional().describe("Filter to chunks last changed on or after this date (e.g., 2025-01-01)")
+    query: z3.string().describe("Natural language description of what code you're looking for."),
+    limit: z3.number().optional().default(10).describe("Maximum number of results to return"),
+    fileType: z3.string().optional().describe("Filter by file extension (e.g., 'ts', 'py', 'rs')"),
+    directory: z3.string().optional().describe("Filter by directory path (e.g., 'src/utils', 'lib')"),
+    chunkType: z3.enum(CHUNK_TYPE_VALUES).optional().describe("Filter by code chunk type"),
+    blameAuthor: z3.string().optional().describe("Filter by git blame author name or email"),
+    blameSha: z3.string().optional().describe("Filter by git blame commit SHA or prefix"),
+    blameSince: z3.string().optional().describe("Filter to chunks last changed on or after this date (e.g., 2025-01-01)")
   },
   async execute(args, context) {
     const results = await searchCodebase(context?.worktree, DEFAULT_HOST, args.query, {
@@ -14229,12 +14230,12 @@ var codebase_peek = (0, import_plugin2.tool)({
     return formatCodebasePeek(results);
   }
 });
-var index_codebase = (0, import_plugin2.tool)({
+var index_codebase = tool({
   description: "Index the codebase for semantic search. Creates vector embeddings of code chunks. Incremental - only re-indexes changed files (~50ms when nothing changed). Run before first codebase_search.",
   args: {
-    force: z2.boolean().optional().default(false).describe("Force reindex even if already indexed"),
-    estimateOnly: z2.boolean().optional().default(false).describe("Only show cost estimate without indexing"),
-    verbose: z2.boolean().optional().default(false).describe("Show detailed info about skipped files and parsing failures")
+    force: z3.boolean().optional().default(false).describe("Force reindex even if already indexed"),
+    estimateOnly: z3.boolean().optional().default(false).describe("Only show cost estimate without indexing"),
+    verbose: z3.boolean().optional().default(false).describe("Show detailed info about skipped files and parsing failures")
   },
   async execute(args, context) {
     const result = await runIndexCodebase(context?.worktree, DEFAULT_HOST, args, (title, metadata) => {
@@ -14245,14 +14246,14 @@ var index_codebase = (0, import_plugin2.tool)({
     return formatIndexStats(result.stats, args.verbose ?? false);
   }
 });
-var index_status = (0, import_plugin2.tool)({
+var index_status = tool({
   description: "Check the status of the codebase index. Shows whether the codebase is indexed, how many chunks are stored, and the embedding provider being used.",
   args: {},
   async execute(_args, context) {
     return formatStatus(await getIndexStatus(context?.worktree, DEFAULT_HOST));
   }
 });
-var index_health_check = (0, import_plugin2.tool)({
+var index_health_check = tool({
   description: "Check index health and remove stale entries from deleted files. Run this to clean up the index after files have been deleted.",
   args: {},
   async execute(_args, context) {
@@ -14261,33 +14262,33 @@ var index_health_check = (0, import_plugin2.tool)({
     return formatHealthCheck(result.health);
   }
 });
-var index_metrics = (0, import_plugin2.tool)({
+var index_metrics = tool({
   description: "Get metrics and performance statistics for the codebase index. Shows indexing stats, search timings, cache hit rates, and API usage. Requires debug.enabled=true and debug.metrics=true in config.",
   args: {},
   async execute(_args, context) {
     return (await getIndexMetrics(context?.worktree, DEFAULT_HOST)).text;
   }
 });
-var index_logs = (0, import_plugin2.tool)({
+var index_logs = tool({
   description: "Get recent debug logs from the codebase indexer. Shows timestamped log entries with level and category. Requires debug.enabled=true in config.",
   args: {
-    limit: z2.number().optional().default(20).describe("Maximum number of log entries to return"),
-    category: z2.enum(["search", "embedding", "cache", "gc", "branch", "general"]).optional().describe("Filter by log category"),
-    level: z2.enum(["error", "warn", "info", "debug"]).optional().describe("Filter by minimum log level")
+    limit: z3.number().optional().default(20).describe("Maximum number of log entries to return"),
+    category: z3.enum(["search", "embedding", "cache", "gc", "branch", "general"]).optional().describe("Filter by log category"),
+    level: z3.enum(["error", "warn", "info", "debug"]).optional().describe("Filter by minimum log level")
   },
   async execute(args, context) {
     return (await getIndexLogs(context?.worktree, DEFAULT_HOST, args)).text;
   }
 });
-var find_similar = (0, import_plugin2.tool)({
+var find_similar = tool({
   description: "Find code similar to a given snippet. Use for duplicate detection, pattern discovery, or refactoring prep. Paste code and find semantically similar implementations elsewhere in the codebase.",
   args: {
-    code: z2.string().describe("The code snippet to find similar code for"),
-    limit: z2.number().optional().default(10).describe("Maximum number of results to return"),
-    fileType: z2.string().optional().describe("Filter by file extension (e.g., 'ts', 'py', 'rs')"),
-    directory: z2.string().optional().describe("Filter by directory path (e.g., 'src/utils', 'lib')"),
-    chunkType: z2.enum(CHUNK_TYPE_VALUES).optional().describe("Filter by code chunk type"),
-    excludeFile: z2.string().optional().describe("Exclude results from this file path (useful when searching for duplicates of code from a specific file)")
+    code: z3.string().describe("The code snippet to find similar code for"),
+    limit: z3.number().optional().default(10).describe("Maximum number of results to return"),
+    fileType: z3.string().optional().describe("Filter by file extension (e.g., 'ts', 'py', 'rs')"),
+    directory: z3.string().optional().describe("Filter by directory path (e.g., 'src/utils', 'lib')"),
+    chunkType: z3.enum(CHUNK_TYPE_VALUES).optional().describe("Filter by code chunk type"),
+    excludeFile: z3.string().optional().describe("Exclude results from this file path (useful when searching for duplicates of code from a specific file)")
   },
   async execute(args, context) {
     const results = await findSimilarCode(context?.worktree, DEFAULT_HOST, args.code, {
@@ -14303,18 +14304,18 @@ var find_similar = (0, import_plugin2.tool)({
     return formatSearchResults(results);
   }
 });
-var codebase_search = (0, import_plugin2.tool)({
+var codebase_search = tool({
   description: "Search codebase by MEANING, not keywords. Returns full code content. Use when you need to see actual implementation. For just finding WHERE code is (saves ~90% tokens), use codebase_peek instead. For known identifiers like 'validateToken', use grep - it's faster.",
   args: {
-    query: z2.string().describe("Natural language description of what code you're looking for. Describe behavior, not syntax."),
-    limit: z2.number().optional().default(5).describe("Maximum number of results to return"),
-    fileType: z2.string().optional().describe("Filter by file extension (e.g., 'ts', 'py', 'rs')"),
-    directory: z2.string().optional().describe("Filter by directory path (e.g., 'src/utils', 'lib')"),
-    chunkType: z2.enum(CHUNK_TYPE_VALUES).optional().describe("Filter by code chunk type"),
-    contextLines: z2.number().optional().describe("Number of extra lines to include before/after each match (default: 0)"),
-    blameAuthor: z2.string().optional().describe("Filter by git blame author name or email"),
-    blameSha: z2.string().optional().describe("Filter by git blame commit SHA or prefix"),
-    blameSince: z2.string().optional().describe("Filter to chunks last changed on or after this date (e.g., 2025-01-01)")
+    query: z3.string().describe("Natural language description of what code you're looking for. Describe behavior, not syntax."),
+    limit: z3.number().optional().default(5).describe("Maximum number of results to return"),
+    fileType: z3.string().optional().describe("Filter by file extension (e.g., 'ts', 'py', 'rs')"),
+    directory: z3.string().optional().describe("Filter by directory path (e.g., 'src/utils', 'lib')"),
+    chunkType: z3.enum(CHUNK_TYPE_VALUES).optional().describe("Filter by code chunk type"),
+    contextLines: z3.number().optional().describe("Number of extra lines to include before/after each match (default: 0)"),
+    blameAuthor: z3.string().optional().describe("Filter by git blame author name or email"),
+    blameSha: z3.string().optional().describe("Filter by git blame commit SHA or prefix"),
+    blameSince: z3.string().optional().describe("Filter to chunks last changed on or after this date (e.g., 2025-01-01)")
   },
   async execute(args, context) {
     const results = await searchCodebase(context?.worktree, DEFAULT_HOST, args.query, {
@@ -14333,13 +14334,13 @@ var codebase_search = (0, import_plugin2.tool)({
     return formatSearchResults(results, "score");
   }
 });
-var implementation_lookup = (0, import_plugin2.tool)({
+var implementation_lookup = tool({
   description: "Jump to symbol definition. Find WHERE something is defined. Returns the authoritative source location(s) for a function, class, method, type, or variable. Prefers real implementation files over tests, docs, examples, and fixtures. Use when you need the definition site, not all usages.",
   args: {
-    query: z2.string().describe("Symbol name or natural language description (e.g., 'validateToken', 'where is the payment handler defined')"),
-    limit: z2.number().optional().default(5).describe("Maximum number of results"),
-    fileType: z2.string().optional().describe("Filter by file extension (e.g., 'ts', 'py')"),
-    directory: z2.string().optional().describe("Filter by directory path (e.g., 'src/utils')")
+    query: z3.string().describe("Symbol name or natural language description (e.g., 'validateToken', 'where is the payment handler defined')"),
+    limit: z3.number().optional().default(5).describe("Maximum number of results"),
+    fileType: z3.string().optional().describe("Filter by file extension (e.g., 'ts', 'py')"),
+    directory: z3.string().optional().describe("Filter by directory path (e.g., 'src/utils')")
   },
   async execute(args, context) {
     const results = await implementationLookup(context?.worktree, DEFAULT_HOST, args.query, {
@@ -14350,13 +14351,13 @@ var implementation_lookup = (0, import_plugin2.tool)({
     return formatDefinitionLookup(results, args.query);
   }
 });
-var call_graph = (0, import_plugin2.tool)({
+var call_graph = tool({
   description: "Query the call graph to find callers or callees of a function/method. Use to understand code flow and dependencies between functions. Supports relationship types: Call, MethodCall, Constructor, Import, Inherits, Implements.",
   args: {
-    name: z2.string().describe("Function or method name to query"),
-    direction: z2.enum(["callers", "callees"]).default("callers").describe("Direction: 'callers' finds who calls this function, 'callees' finds what this function calls"),
-    symbolId: z2.string().optional().describe("Symbol ID (required for 'callees' direction, returned by previous call_graph queries)"),
-    relationshipType: z2.enum(RELATIONSHIP_TYPE_VALUES).optional().describe("Filter by relationship type. Omit to show all.")
+    name: z3.string().describe("Function or method name to query"),
+    direction: z3.enum(["callers", "callees"]).default("callers").describe("Direction: 'callers' finds who calls this function, 'callees' finds what this function calls"),
+    symbolId: z3.string().optional().describe("Symbol ID (required for 'callees' direction, returned by previous call_graph queries)"),
+    relationshipType: z3.enum(RELATIONSHIP_TYPE_VALUES).optional().describe("Filter by relationship type. Omit to show all.")
   },
   async execute(args, context) {
     if (args.direction === "callees") {
@@ -14370,49 +14371,49 @@ var call_graph = (0, import_plugin2.tool)({
     return formatCallGraphCallers(args.name, callers, args.relationshipType);
   }
 });
-var call_graph_path = (0, import_plugin2.tool)({
+var call_graph_path = tool({
   description: "Find the shortest connection path between two symbols in the call graph. Given a source and target function/method name, returns the chain of calls connecting them.",
   args: {
-    from: z2.string().describe("Source function/method name (starting point)"),
-    to: z2.string().describe("Target function/method name (destination)"),
-    maxDepth: z2.number().optional().default(10).describe("Maximum traversal depth (default: 10)")
+    from: z3.string().describe("Source function/method name (starting point)"),
+    to: z3.string().describe("Target function/method name (destination)"),
+    maxDepth: z3.number().optional().default(10).describe("Maximum traversal depth (default: 10)")
   },
   async execute(args, context) {
     const path24 = await getCallGraphPath(context?.worktree, DEFAULT_HOST, args.from, args.to, args.maxDepth);
     return formatCallGraphPath(args.from, args.to, path24);
   }
 });
-var add_knowledge_base = (0, import_plugin2.tool)({
+var add_knowledge_base = tool({
   description: "Add a folder as a knowledge base to the semantic search index. The folder will be indexed alongside the main project code. Supports absolute paths or relative paths (relative to the project root).",
   args: {
-    path: z2.string().describe("Path to the folder to add as a knowledge base (absolute or relative to the project root)")
+    path: z3.string().describe("Path to the folder to add as a knowledge base (absolute or relative to the project root)")
   },
   async execute(args, context) {
     return addKnowledgeBase(context?.worktree, DEFAULT_HOST, args.path);
   }
 });
-var list_knowledge_bases = (0, import_plugin2.tool)({
+var list_knowledge_bases = tool({
   description: "List all configured knowledge base folders that are indexed alongside the main project.",
   args: {},
   async execute(_args, context) {
     return listKnowledgeBases(context?.worktree, DEFAULT_HOST);
   }
 });
-var remove_knowledge_base = (0, import_plugin2.tool)({
+var remove_knowledge_base = tool({
   description: "Remove a knowledge base folder from the semantic search index.",
   args: {
-    path: z2.string().describe("Path of the knowledge base to remove (must match the configured path exactly)")
+    path: z3.string().describe("Path of the knowledge base to remove (must match the configured path exactly)")
   },
   async execute(args, context) {
     return removeKnowledgeBase(context?.worktree, DEFAULT_HOST, args.path.trim());
   }
 });
-var index_visualize = (0, import_plugin2.tool)({
+var index_visualize = tool({
   description: "Generate an interactive HTML visualization of recent code movement and the call graph. Starts with temporal onboarding context from Git history, then supports module, symbol, hotspot, and cycle drill-down.",
   args: {
-    directory: z2.string().optional().describe("Filter to symbols in this directory (e.g., 'src/services')"),
-    maxNodes: z2.number().optional().default(5e3).describe("Maximum nodes to include (default 5000)"),
-    includeOrphans: z2.boolean().optional().default(false).describe("Include symbols with no call relationships")
+    directory: z3.string().optional().describe("Filter to symbols in this directory (e.g., 'src/services')"),
+    maxNodes: z3.number().optional().default(5e3).describe("Maximum nodes to include (default 5000)"),
+    includeOrphans: z3.boolean().optional().default(false).describe("Include symbols with no call relationships")
   },
   async execute(args, context) {
     const projectRoot = context?.worktree ?? process.cwd();