@autodev/codebase 0.0.7 → 1.0.1

package/README.md

@@ -1,17 +1,20 @@
 # @autodev/codebase
 
-<div align="center">
+<p align="center">
 
 [![npm version](https://img.shields.io/npm/v/@autodev/codebase)](https://www.npmjs.com/package/@autodev/codebase)
 [![GitHub stars](https://img.shields.io/github/stars/anrgct/autodev-codebase)](https://github.com/anrgct/autodev-codebase)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-</div>
+</p>
+
+A vector embedding-based code semantic search tool with MCP server and multi-model integration. Can be used as a pure CLI tool. Supports Ollama for fully local embedding and reranking, enabling complete offline operation and privacy protection for your code repository.
 
 ```sh
+# Semantic code search - Find code by meaning, not just keywords
 ╭─ ~/workspace/autodev-codebase 
-╰─❯ codebase --demo --search="user manage"
-Found 3 results in 2 files for: "user manage"
+╰─❯ codebase search "user manage" --demo
+Found 20 results in 5 files for: "user manage"
 
 ==================================================
 File: "hello.js"
@@ -31,36 +34,44 @@ class UserManager {
     return this.users;
   }
 }
+……
 
-==================================================
-File: "README.md" | 2 snippets
-==================================================
-< md_h1 Demo Project > md_h2 Usage > md_h3 JavaScript Functions > (L16-20)
-### JavaScript Functions
-
-- greetUser(name) - Greets a user by name
-- UserManager - Class for managing user data
-
-─────
-< md_h1 Demo Project > md_h2 Search Examples > (L27-38)
-## Search Examples
-
-Try searching for:
-- "greet user"
-- "process data"
-- "user management"
-- "batch processing"
-- "YOLO model"
-- "computer vision"
-- "object detection"
-- "model training"
+# Call graph analysis - Trace function call relationships and execution paths
+╭─ ~/workspace/autodev-codebase 
+╰─❯ codebase call --demo --query="app,addUser"
+Connections between app, addUser:
+
+Found 2 matching node(s):
+  - demo/app:L1-29
+  - demo/hello.UserManager.addUser:L12-15
+
+Direct connections:
+  - demo/app:L1-29 → demo/hello.UserManager.addUser:L12-15
 
+Chains found:
+  - demo/app:L1-29 → demo/hello.UserManager.addUser:L12-15
+
+# Code outline with AI summaries - Understand code structure at a glance
+╭─ ~/workspace/autodev-codebase 
+╰─❯ codebase outline 'hello.js' --demo --summarize
+# hello.js (23 lines)
+└─ Defines a greeting function that logs a personalized hello message and returns a welcome string. Implements a UserManager class managing an array of users with methods to add users and retrieve the current user list. Exports both components for external use.
+
+   2--5 | function greetUser
+   └─ Implements user greeting logic by logging a personalized hello message and returning a welcome message
+
+   7--20 | class UserManager
+   └─ Manages user data with methods to add users to a list and retrieve all stored users
+
+   12--15 | method addUser
+   └─ Adds a user to the users array and logs a confirmation message with the user's name.
 ```
-A vector embedding-based code semantic search tool with MCP server and multi-model integration. Can be used as a pure CLI tool. Supports Ollama for fully local embedding and reranking, enabling complete offline operation and privacy protection for your code repository.
+
 
 ## 🚀 Features
 
 - **🔍 Semantic Code Search**: Vector-based search using advanced embedding models
+- **🔗 Call Graph Analysis**: Trace function call relationships and execution paths
 - **🌐 MCP Server**: HTTP-based MCP server with SSE and stdio adapters
 - **💻 Pure CLI Tool**: Standalone command-line interface without GUI dependencies
 - **⚙️ Layered Configuration**: CLI, project, and global config management
@@ -71,6 +82,7 @@ A vector embedding-based code semantic search tool with MCP server and multi-mod
 - **📊 Real-time Watching**: Automatic index updates
 - **⚡ Batch Processing**: Efficient parallel processing
 - **📝 Code Outline Extraction**: Generate structured code outlines with AI summaries
+- **💨 Dependency Analysis Cache**: Intelligent caching for 10-50x faster re-analysis
 
 ## 📦 Installation
 
@@ -89,7 +101,7 @@ docker run -d -p 6333:6333 -p 6334:6334 --name qdrant qdrant/qdrant
 ### 3. Install
 ```bash
 npm install -g @autodev/codebase
-codebase --set-config embedderProvider=ollama,embedderModelId=nomic-embed-text
+codebase config --set embedderProvider=ollama,embedderModelId=nomic-embed-text
 ```
 
 ## 🛠️ Quick Start
@@ -99,108 +111,125 @@ codebase --set-config embedderProvider=ollama,embedderModelId=nomic-embed-text
 # Creates a demo directory in current working directory for testing
 
 # Index & search
-codebase --demo --index
-codebase --demo --search="user greet"
+codebase index --demo
+codebase search "user greet" --demo
+
+# Call graph analysis
+codebase call --demo --query="app,addUser"
 
 # MCP server
-codebase --demo --serve
+codebase index --serve --demo
 ```
 
 ## 📋 Commands
 
-### 📝 AI-Powered Code Outlines
-
-Generate intelligent code summaries with one command:
-
+### 📝 Code Outlines
 ```bash
-codebase --outline "src/**/*.ts" --summarize
-```
-
-**Output Example:**
-```
-# src/cli.ts (1902 lines)
-└─ Implements a simplified CLI for @autodev/codebase using Node.js native parseArgs. 
-   Manages codebase indexing, searching, and MCP server operations.
+# Extract code structure (functions, classes, methods)
+codebase outline "src/**/*.ts"
 
-   27--35 | function initGlobalLogger
-   └─ Initializes a global logger instance with specified log level and timestamps.
+# Generate code structure with AI summaries
+codebase outline "src/**/*.ts" --summarize
 
-   45--54 | interface SearchResult
-   └─ Defines the structure for search result payloads, including file path, code chunk, 
-      and relevance score.
+# View only file-level summaries
+codebase outline "src/**/*.ts" --summarize --title
 
-   ... (full outline with AI summaries)
+# Clear summary cache
+codebase outline --clear-summarize-cache
 ```
 
-**Benefits:**
-- 🧠 **Understand code fast** - Get function-level summaries without reading every line
-- 💾 **Smart caching** - Only summarizes changed code blocks
-- 🌐 **Multi-language** - English/Chinese summaries supported
-- ⚡ **Batch processing** - Efficiently handles large codebases
-
-**Quick Setup:**
+### 🔗 Call Graph Analysis
 ```bash
-# Configure Ollama (recommended for free, local AI)
-codebase --set-config summarizerProvider=ollama,summarizerOllamaModelId=qwen3-vl:4b-instruct
-
-# Or use DeepSeek (cost-effective API)
-codebase --set-config summarizerProvider=openai-compatible,summarizerOpenAiCompatibleBaseUrl=https://api.deepseek.com/v1,summarizerOpenAiCompatibleModelId=deepseek-chat,summarizerOpenAiCompatibleApiKey=sk-your-key
+# 📊 Statistics Overview (no --query)
+codebase call                           # Show statistics overview
+codebase call --json                    # JSON format
+codebase call src/commands              # Analyze specific directory
+
+# 🔍 Function Query (with --query)
+codebase call --query="getUser"         # Single function call tree (default depth: 3)
+codebase call --query="main" --depth=5  # Custom depth
+codebase call --query="getUser,validateUser"  # Multi-function connections (default depth: 10)
+
+# 🎨 Visualization
+codebase call --viz graph.json          # Export Cytoscape.js format
+codebase call --open                    # Open interactive viewer
+codebase call --viz graph.json --open   # Export and open
+
+# Specify workspace (works for both modes)
+codebase call --path=/my/project --query="main"
 ```
 
-
-### Indexing & Search
+**Query Patterns:**
+- **Exact match**: `--query="functionName"` or `--query="*ClassName.methodName"`
+- **Wildcards**: `*` (any characters), `?` (single character)
+  - Examples: `--query="get*"`, `--query="*User*"`, `--query="*.*.get*"`
+- **Single function**: `--query="main"` - Shows call tree (upward + downward)
+  - Default depth: **3** (avoids excessive output)
+- **Multiple functions**: `--query="main,helper"` - Analyzes connection paths between functions
+  - Default depth: **10** (deeper search needed for path finding)
+
+**Supported Languages:**
+- **TypeScript/JavaScript** (.ts, .tsx, .js, .jsx)
+- **Python** (.py)
+- **Java** (.java)
+- **C/C++** (.c, .h, .cpp, .cc, .cxx, .hpp, .hxx, .c++)
+- **C#** (.cs)
+- **Rust** (.rs)
+- **Go** (.go)
+
+### 🔍 Indexing & Search
 ```bash
 # Index the codebase
-codebase --index --path=/my/project --force
+codebase index --path=/my/project --force
 
 # Search with filters
-codebase --search="error handling" --path-filters="src/**/*.ts"
+codebase search "error handling" --path-filters="src/**/*.ts"
 
 # Search with custom limit and minimum score
-codebase --search="authentication" --limit=20 --min-score=0.7
-codebase --search="API" -l 30 -S 0.5
+codebase search "authentication" --limit=20 --min-score=0.7
+codebase search "API" -l 30 -S 0.5
 
 # Search in JSON format
-codebase --search="authentication" --json
+codebase search "authentication" --json
 
 # Clear index data
-codebase --clear --path=/my/project
+codebase index --clear-cache --path=/my/project
 ```
 
-### MCP Server
+### 🌐 MCP Server
 ```bash
 # HTTP mode (recommended)
-codebase --serve --port=3001 --path=/my/project
+codebase index --serve --port=3001 --path=/my/project
 
 # Stdio adapter
-codebase --stdio-adapter --server-url=http://localhost:3001/mcp
+codebase stdio --server-url=http://localhost:3001/mcp
 ```
 
-### Configuration
+### ⚙️ Configuration
 ```bash
 # View config
-codebase --get-config
-codebase --get-config embedderProvider --json
+codebase config --get
+codebase config --get embedderProvider --json
 
 # Set config
-codebase --set-config embedderProvider=ollama,embedderModelId=nomic-embed-text
-codebase --set-config --global qdrantUrl=http://localhost:6333
+codebase config --set embedderProvider=ollama,embedderModelId=nomic-embed-text
+codebase config --set --global qdrantUrl=http://localhost:6333
 ```
 
-### Advanced Features
+### 🚀 Advanced Features
 
 #### 🔍 LLM-Powered Search Reranking
 Enable LLM reranking to dramatically improve search relevance:
 
 ```bash
 # Enable reranking with Ollama (recommended)
-codebase --set-config rerankerEnabled=true,rerankerProvider=ollama,rerankerOllamaModelId=qwen3-vl:4b-instruct
+codebase config --set rerankerEnabled=true,rerankerProvider=ollama,rerankerOllamaModelId=qwen3-vl:4b-instruct
 
 # Or use OpenAI-compatible providers
-codebase --set-config rerankerEnabled=true,rerankerProvider=openai-compatible,rerankerOpenAiCompatibleModelId=deepseek-chat
+codebase config --set rerankerEnabled=true,rerankerProvider=openai-compatible,rerankerOpenAiCompatibleModelId=deepseek-chat
 
 # Search with automatic reranking
-codebase --search="user authentication"  # Results are automatically reranked by LLM
+codebase search "user authentication"  # Results are automatically reranked by LLM
 ```
 
 **Benefits:**
@@ -212,36 +241,24 @@ codebase --search="user authentication"  # Results are automatically reranked by
 #### Path Filtering & Export
 ```bash
 # Path filtering with brace expansion and exclusions
-codebase --search="API" --path-filters="src/**/*.ts,lib/**/*.js"
-codebase --search="utils" --path-filters="{src,test}/**/*.ts"
+codebase search "API" --path-filters="src/**/*.ts,lib/**/*.js"
+codebase search "utils" --path-filters="{src,test}/**/*.ts"
 
 # Export results in JSON format for scripts
-codebase --search="auth" --json
+codebase search "auth" --json
 ```
 
-#### 📝 AI-Powered Code Outlines
-Generate intelligent code summaries and outlines:
+#### Path Filtering & Export
 
 ```bash
-# Extract code structure
-codebase --outline src/index.ts
-
-# With AI summaries (recommended)
-codebase --outline "src/**/*.ts" --summarize
-
-# Preview before processing
-codebase --outline "src/**/*.ts" --dry-run
+# Path filtering with brace expansion and exclusions
+codebase search "API" --path-filters="src/**/*.ts,lib/**/*.js"
+codebase search "utils" --path-filters="{src,test}/**/*.ts"
 
-# Clear cache and regenerate
-codebase --outline src/index.ts --summarize --clear-summarize-cache
+# Export results in JSON format for scripts
+codebase search "auth" --json
 ```
 
-**Key Benefits:**
-- 🎯 **Function-level summaries**: Understand code purpose at a glance
-- 💾 **Smart caching**: Avoid redundant LLM calls
-- 🌐 **Multi-language**: English / Chinese support
-- ⚡ **Batch processing**: Efficiently handle large codebases
-
 ## ⚙️ Configuration
 
 ### Config Layers (Priority Order)
@@ -250,7 +267,7 @@ codebase --outline src/index.ts --summarize --clear-summarize-cache
 3. **Global Config** - `~/.autodev-cache/autodev-config.json`
 4. **Built-in Defaults** - Fallback values
 
-**Note:** CLI arguments provide runtime override for paths, logging, and operational behavior. For persistent configuration (embedderProvider, API keys, search parameters), use `--set-config` to save to config files.
+**Note:** CLI arguments provide runtime override for paths, logging, and operational behavior. For persistent configuration (embedderProvider, API keys, search parameters), use `config --set` to save to config files.
 
 ### Common Config Examples
 
@@ -295,36 +312,42 @@ codebase --outline src/index.ts --summarize --clear-summarize-cache
 | **Summarizer** | `summarizerProvider`, `summarizerLanguage`, `summarizerBatchSize` | AI summary generation |
 
 **Key CLI Arguments:**
-- `--serve` / `--index` / `--search` - Core operations
-- `--outline <pattern>` - Extract code outlines (supports glob patterns)
+- `index` - Index the codebase
+- `search <query>` - Search the codebase (required positional argument)
+- `outline <pattern>` - Extract code outlines (supports glob patterns)
+- `call` - Analyze function call relationships and dependency graphs
+- `stdio` - Start stdio adapter for MCP
+- `config` - Manage configuration (use with --get or --set)
+- `--serve` - Start MCP HTTP server (use with `index` command)
 - `--summarize` - Generate AI summaries for code outlines
 - `--dry-run` - Preview operations before execution
 - `--title` - Show only file-level summaries
 - `--clear-summarize-cache` - Clear all summary caches
-- `--get-config` / `--set-config` - Configuration management  
 - `--path`, `--demo`, `--force` - Common options
 - `--limit` / `-l <number>` - Maximum number of search results (default: from config, max 50)
 - `--min-score` / `-S <number>` - Minimum similarity score for search results (0-1, default: from config)
+- `--query <patterns>` - Query patterns for call graph analysis (comma-separated)
+- `--viz <file>` - Export full dependency data for visualization (cannot use with --query)
+- `--open` - Open interactive graph viewer
+- `--depth <number>` - Set analysis depth for call graphs
 - `--help` - Show all available options
 
-For complete CLI reference, see [CONFIG.md](CONFIG.md).
-
 **Configuration Commands:**
 ```bash
 # View config
-codebase --get-config
-codebase --get-config --json
+codebase config --get
+codebase config --get --json
 
 # Set config (saves to file)
-codebase --set-config embedderProvider=ollama,embedderModelId=nomic-embed-text
-codebase --set-config --global embedderProvider=openai,embedderOpenAiApiKey=sk-xxx
+codebase config --set embedderProvider=ollama,embedderModelId=nomic-embed-text
+codebase config --set --global embedderProvider=openai,embedderOpenAiApiKey=sk-xxx
 
 # Use custom config file
-codebase --config=/path/to/config.json --get-config
-codebase --config=/path/to/config.json --set-config embedderProvider=ollama
+codebase --config=/path/to/config.json config --get
+codebase --config=/path/to/config.json config --set embedderProvider=ollama
 
 # Runtime override (paths, logging, etc.)
-codebase --index --path=/my/project --log-level=info --force
+codebase index --path=/my/project --log-level=info --force
 ```
 
 For complete configuration reference, see [CONFIG.md](CONFIG.md).
@@ -333,7 +356,7 @@ For complete configuration reference, see [CONFIG.md](CONFIG.md).
 
 ### HTTP Streamable Mode (Recommended)
 ```bash
-codebase --serve --port=3001
+codebase index --serve --port=3001
 ```
 
 **IDE Config:**
@@ -350,10 +373,10 @@ codebase --serve --port=3001
 ### Stdio Adapter
 ```bash
 # First start the MCP server in one terminal
-codebase --serve --port=3001
+codebase index --serve --port=3001
 
 # Then connect via stdio adapter in another terminal (for IDEs that require stdio)
-codebase --stdio-adapter --server-url=http://localhost:3001/mcp
+codebase stdio --server-url=http://localhost:3001/mcp
 ```
 
 **IDE Config:**
@@ -362,7 +385,7 @@ codebase --stdio-adapter --server-url=http://localhost:3001/mcp
   "mcpServers": {
     "codebase": {
       "command": "codebase",
-      "args": ["stdio-adapter", "--server-url=http://localhost:3001/mcp"]
+      "args": ["stdio", "--server-url=http://localhost:3001/mcp"]
     }
   }
 }