@autodev/codebase 1.0.0 → 1.0.1

package/README.md

@@ -140,33 +140,33 @@ codebase outline --clear-summarize-cache
 
 ### 🔗 Call Graph Analysis
 ```bash
-# Analyze function call relationships
-codebase call --query="functionA,functionB"
-
-# Analyze specific directory
-codebase call src/commands
-
-# Export analysis results
-codebase call --output=graph.json
-
-# Open interactive graph viewer
-codebase call --open
-
-# Set analysis depth
-codebase call --query="main" --depth=3
-
-# Specify workspace path
-codebase call --path=/my/project
+# 📊 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"
 ```
 
 **Query Patterns:**
-- **Exact match**: `--query="functionName"` or `--query="ClassName.methodName"`
+- **Exact match**: `--query="functionName"` or `--query="*ClassName.methodName"`
 - **Wildcards**: `*` (any characters), `?` (single character)
   - Examples: `--query="get*"`, `--query="*User*"`, `--query="*.*.get*"`
-- **Single pattern**: `--query="main"` - Shows dependency tree (what it calls, who calls it)
-  - Use `--depth` to control tree depth (default: 10)
-- **Multiple patterns**: `--query="main,helper"` - Analyzes connections between functions
-  - Connection search depth is fixed at 10 (--depth is ignored)
+- **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)
@@ -327,7 +327,7 @@ codebase search "auth" --json
 - `--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)
-- `--output <file>` - Export analysis results to JSON file
+- `--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

package/dist/cli.js

@@ -52907,7 +52907,7 @@ function parseMarkdown(content) {
 }
 
 // Private constant
-const DEFAULT_MIN_COMPONENT_LINES_VALUE = 4;
+const DEFAULT_MIN_COMPONENT_LINES_VALUE = 2;
 // Getter function for MIN_COMPONENT_LINES (for easier testing)
 let currentMinComponentLines = DEFAULT_MIN_COMPONENT_LINES_VALUE;
 /**
@@ -63955,10 +63955,10 @@ function parsePathFilters(filtersString) {
     return filters;
 }
 /**
- * Check whether a string contains glob pattern characters.
+ * Check whether a string contains glob pattern characters or comma-separated patterns.
  */
 function isGlobPattern(input) {
-    return /[*?{}\[\]]/.test(input);
+    return /[*?{}\[\],]/.test(input);
 }
 
 /**
@@ -131821,8 +131821,6 @@ class BaseAnalyzer {
     // ═══════════════════════════════════════════════════════
     async analyze() {
         try {
-            // 0. Create module node for tracking top-level calls
-            this.createModuleNode();
             const tree = this.parser.parse(this.content);
             const root = tree.rootNode;
             // 1. Extract imports first (for resolution)
@@ -131890,8 +131888,8 @@ class BaseAnalyzer {
             if (calleeInfo) {
                 // 使用 CallInfo 进行过滤判断
                 if (!this.shouldFilterCall(node, calleeInfo)) {
-                    // Use currentFunc if inside a function, otherwise use module node ID
-                    const caller = currentFunc || this.getModuleNodeId();
+                    // Use currentFunc if inside a function, otherwise ensure module node exists
+                    const caller = currentFunc || this.ensureModuleNode();
                     // 根据调用类型决定如何传递 callee 参数
                     if (calleeInfo.isGlobalCall) {
                         // 全局直接调用（如 setTimeout）：尝试用 importMap 解析
@@ -132003,6 +132001,24 @@ class BaseAnalyzer {
     getModuleNodeId() {
         return this.getModulePath();
     }
+    /**
+     * Ensure module node exists, creating it lazily if needed.
+     * Returns the module node ID.
+     *
+     * This method is called when a top-level call is detected.
+     * By creating module nodes on-demand, we avoid creating nodes for files
+     * that don't have any top-level calls, reducing graph noise.
+     */
+    ensureModuleNode() {
+        const moduleId = this.getModuleNodeId();
+        // If module node already exists, return its ID
+        if (this.nodes.has(moduleId)) {
+            return moduleId;
+        }
+        // Otherwise, create the module node now
+        this.createModuleNode();
+        return moduleId;
+    }
     addEdge(caller, calleeName, line) {
         let resolved;
         // 1. 尝试直接匹配（命名导入：import { foo } from './module'）
@@ -133305,14 +133321,15 @@ function buildCalleeTree(nodes, rootNode, visited, currentDepth, maxDepth) {
         const depNode = nodes.get(depId);
         if (!depNode)
             continue;
+        const childDepth = currentDepth + 1;
         const treeNode = {
             id: depNode.id,
             name: depNode.name,
             filePath: depNode.filePath,
             line: depNode.startLine,
             endLine: depNode.endLine,
-            depth: currentDepth,
-            children: buildCalleeTree(nodes, depNode, visited, currentDepth + 1, maxDepth)
+            depth: childDepth,
+            children: buildCalleeTree(nodes, depNode, visited, childDepth, maxDepth)
         };
         children.push(treeNode);
     }
@@ -133330,14 +133347,15 @@ function buildCallerTree(nodes, targetNodeId, visited, currentDepth, maxDepth) {
     // Find all nodes that depend on the target node
     for (const node of nodes.values()) {
         if (node.dependsOn.has(targetNodeId)) {
+            const childDepth = currentDepth + 1;
             const treeNode = {
                 id: node.id,
                 name: node.name,
                 filePath: node.filePath,
                 line: node.startLine,
                 endLine: node.endLine,
-                depth: currentDepth,
-                children: buildCallerTree(nodes, node.id, visited, currentDepth + 1, maxDepth)
+                depth: childDepth,
+                children: buildCallerTree(nodes, node.id, visited, childDepth, maxDepth)
             };
             children.push(treeNode);
         }
@@ -133400,7 +133418,7 @@ function findDirectConnections(matchedNodes, adj) {
 /**
  * BFS to find shortest path between two nodes
  */
-function findShortestPath(adj, startId, endId, maxLength = 10) {
+function findShortestPath(adj, startId, endId, maxLength) {
     if (startId === endId) {
         return [startId];
     }
@@ -133427,13 +133445,13 @@ function findShortestPath(adj, startId, endId, maxLength = 10) {
 /**
  * Find all chains connecting queried nodes
  */
-function findChains(matchedNodes, adj) {
+function findChains(matchedNodes, adj, maxDepth) {
     const chains = [];
     const n = matchedNodes.length;
     // Find paths between all pairs
     for (let i = 0; i < n; i++) {
         for (let j = i + 1; j < n; j++) {
-            const path = findShortestPath(adj, matchedNodes[i].id, matchedNodes[j].id);
+            const path = findShortestPath(adj, matchedNodes[i].id, matchedNodes[j].id, maxDepth);
             if (path && path.length > 1) {
                 chains.push({
                     path,
@@ -133450,9 +133468,10 @@ function findChains(matchedNodes, adj) {
  *
  * @param nodes - Node map
  * @param query - Comma-separated function names/patterns
+ * @param maxDepth - Maximum depth for path finding
  * @returns Connection analysis result
  */
-function analyzeConnections(nodes, query) {
+function analyzeConnections(nodes, query, maxDepth) {
     // Find matching nodes
     const matchedNodes = findMatchingNodes(nodes, query);
     if (matchedNodes.length === 0) {
@@ -133469,7 +133488,7 @@ function analyzeConnections(nodes, query) {
     // Find direct connections
     const directConnections = findDirectConnections(matchedNodes);
     // Find chains
-    const chains = findChains(matchedNodes, adj);
+    const chains = findChains(matchedNodes, adj, maxDepth);
     // Collect all involved nodes
     const involvedIds = new Set();
     for (const conn of directConnections) {
@@ -134745,7 +134764,7 @@ async function openGraphViewer(fileSystem) {
 /**
  * Format and display dependency analysis summary
  */
-function displaySummary(result) {
+function displaySummary(result, asJson = false) {
     const { summary, nodes, relationships, cycles } = result;
     // Maximum number of examples to display for each category
     const MAX_EXAMPLES = 20;
@@ -134780,7 +134799,49 @@ function displaySummary(result) {
         .sort((a, b) => b[1] - a[1])
         .slice(0, MAX_EXAMPLES)
         .filter(([_, count]) => count > 0);
-    // Output summary
+    // JSON output mode
+    if (asJson) {
+        const componentTypesObj = {};
+        for (const [type, count] of componentTypes.entries()) {
+            const examples = Array.from(nodes.entries())
+                .filter(([_, node]) => node.componentType === type)
+                .slice(0, MAX_EXAMPLES)
+                .map(([id, _]) => id);
+            componentTypesObj[type] = { count, examples };
+        }
+        const jsonOutput = {
+            summary: {
+                totalFiles: summary.totalFiles,
+                totalNodes: summary.totalNodes,
+                totalRelationships: summary.totalRelationships,
+                languages: summary.languages,
+                cycleCount: cycles.length,
+            },
+            componentTypes: componentTypesObj,
+            topModules: topModules.map(([module, count]) => ({ module, dependencies: count })),
+            relationships: {
+                resolved: {
+                    count: resolvedEdges.length,
+                    examples: resolvedEdges.slice(0, MAX_EXAMPLES).map(edge => ({
+                        caller: edge.caller,
+                        callee: edge.callee,
+                        callLine: edge.callLine,
+                    })),
+                },
+                unresolved: {
+                    count: unresolvedEdges.length,
+                    examples: unresolvedEdges.slice(0, MAX_EXAMPLES).map(edge => ({
+                        caller: edge.caller,
+                        callee: edge.callee,
+                        callLine: edge.callLine,
+                    })),
+                },
+            },
+        };
+        console.log(JSON.stringify(jsonOutput, null, 2));
+        return;
+    }
+    // Text output
     console.log('\nDependency Analysis Summary');
     console.log('==========================');
     console.log(`Files:         ${summary.totalFiles}`);
@@ -134832,14 +134893,32 @@ function displaySummary(result) {
 /**
  * Export dependency data to JSON file
  */
-async function exportData(result, outputPath, openInBrowser, fileSystem) {
+function validateOptions(hasQuery, hasJson, hasViz, hasOpen) {
+    if (hasQuery && hasViz) {
+        console.error('\n❌ Error: --viz cannot be used with --query\n');
+        console.error('   Query results are for quick inspection, not visualization.\n');
+        console.error('   To export full dependency data:\n');
+        console.error('     codebase call --viz graph.json\n');
+        console.error('   To query dependencies:\n');
+        console.error('     codebase call --query "functionName"\n');
+        process.exit(1);
+    }
+    if (hasQuery && hasOpen) {
+        console.error('\n❌ Error: --open cannot be used with --query\n');
+        console.error('   Use --open without --query to visualize the full dependency graph.\n');
+        console.error('   To open the viewer:\n');
+        console.error('     codebase call --open\n');
+        process.exit(1);
+    }
+}
+async function exportViz(result, outputPath, openInBrowser, fileSystem) {
     // Generate visualization data
     const viz = generateVisualizationData(result.nodes, result.relationships, result.summary);
     // Resolve output path (support relative paths)
     const resolvedPath = outputPath.startsWith('/') ? outputPath : `${process.cwd()}/${outputPath}`;
     // Write to file
     await promises.writeFile(resolvedPath, JSON.stringify(viz.cytoscape.elements, null, 2), 'utf-8');
-    console.log(`\nDependency data exported to: ${resolvedPath}`);
+    console.log(`\n✓ Visualization data exported to: ${resolvedPath}`);
     console.log(`  Nodes: ${viz.summary.total_nodes}`);
     console.log(`  Edges: ${viz.summary.total_edges}`);
     console.log(`  Languages: ${viz.summary.languages.join(', ')}`);
@@ -134889,8 +134968,8 @@ function querySingleFunction(result, query, depth, asJson) {
 /**
  * Query mode - multiple functions (connection analysis)
  */
-function queryMultipleFunctions(result, query, asJson) {
-    const analysisResult = analyzeConnections(result.nodes, query);
+function queryMultipleFunctions(result, query, depth, asJson) {
+    const analysisResult = analyzeConnections(result.nodes, query, depth);
     if (asJson) {
         console.log(JSON.stringify(analysisResult, null, 2));
     }
@@ -134903,30 +134982,48 @@ function queryMultipleFunctions(result, query, asJson) {
  * Query mode handler
  */
 function queryMode(result, query, depthStr, asJson) {
-    const depth = parseInt(depthStr, 10) || 10;
     const patterns = query.split(',').map(p => p.trim()).filter(p => p.length > 0);
     if (patterns.length === 0) {
         console.log('\nError: Empty query pattern');
         return;
     }
-    // Single pattern or wildcard pattern -> single function query
-    // Multiple patterns -> connection analysis
-    const hasWildcard = patterns.some(p => p.includes('*') || p.includes('?'));
-    if (patterns.length === 1 || hasWildcard) {
-        querySingleFunction(result, query, depth, asJson);
+    // Determine depth based on query type
+    let depth;
+    if (depthStr) {
+        // User explicitly provided depth
+        depth = parseInt(depthStr, 10);
     }
     else {
-        queryMultipleFunctions(result, query, asJson);
+        // Use different defaults based on query type
+        depth = patterns.length > 1 ? 10 : 3;
+    }
+    // Multiple patterns (comma-separated) -> connection analysis
+    // Single pattern -> single function query with depth
+    if (patterns.length > 1) {
+        queryMultipleFunctions(result, query, depth, asJson);
+    }
+    else {
+        querySingleFunction(result, query, depth, asJson);
     }
 }
 /**
  * Call command handler
  *
- * Provides dependency analysis with multiple output modes:
- * - Summary mode (default): Display statistics overview
- * - Export mode (--output): Export data to JSON file
- * - Query mode (--query): Query specific dependencies
- * - Open mode (--open): Open HTML visualization
+ * Provides dependency analysis with two modes:
+ *
+ * 1. Full Data Mode (no --query):
+ *    - Summary mode (default): Display statistics overview
+ *    - JSON mode (--json): Display statistics in JSON format
+ *    - Export mode (--viz): Export visualization data to file
+ *    - Open mode (--open): Open HTML visualization viewer
+ *
+ * 2. Query Mode (with --query):
+ *    - Tree format (default): Display dependency tree
+ *    - JSON format (--json): Output query results in JSON
+ *
+ * Option constraints:
+ *    - --viz/--open cannot be used with --query
+ *    - --json works in both summary and query modes
  */
 async function callHandler(targetPath, options) {
     // Initialize logger
@@ -135037,9 +135134,12 @@ async function callHandler(targetPath, options) {
         workspace: fullDeps.workspace,
     };
     // Determine output mode
-    const hasOutput = !!options.output;
+    const hasViz = !!options.viz;
     const hasQuery = !!options.query;
+    const hasJson = !!options.json;
     const hasOpen = !!options.open;
+    // Validate option combinations
+    validateOptions(hasQuery, hasJson, hasViz, hasOpen);
     try {
         // Perform analysis
         logger.info('Analyzing dependencies...');
@@ -135048,13 +135148,13 @@ async function callHandler(targetPath, options) {
             cacheBaseDir: options.cache,
         });
         // Mode selection
-        if (hasOutput) {
-            // Export mode - Task 3
-            await exportData(result, options.output, hasOpen, fullDeps.fileSystem);
-        }
-        else if (hasQuery) {
+        if (hasQuery) {
             // Query mode - Task 4
-            queryMode(result, options.query, options.depth || '10', options.json);
+            queryMode(result, options.query, options.depth, hasJson);
+        }
+        else if (hasViz) {
+            // Export mode - Task 3
+            await exportViz(result, options.viz, hasOpen, fullDeps.fileSystem);
         }
         else if (hasOpen) {
             // Open mode - directly open viewer without exporting
@@ -135074,7 +135174,7 @@ async function callHandler(targetPath, options) {
         }
         else {
             // Summary mode (default) - Task 2
-            displaySummary(result);
+            displaySummary(result, options.json);
         }
         // Display errors if any
         if (result.errors && result.errors.length > 0) {
@@ -135117,8 +135217,8 @@ function createCallCommand() {
         .option('-p, --path <path>', 'Working directory path', '.')
         .option('-c, --config <path>', 'Configuration file path')
         .option('--demo', 'Use demo workspace')
-        .option('--output <file>', 'Export dependency data to JSON file')
-        .option('--open', 'Open HTML visualization in browser')
+        .option('--viz <file>', 'Export full dependency data for visualization (cannot use with --query)')
+        .option('--open', 'Open HTML visualization viewer (cannot use with --query)')
         .option('--query <names>', [
         'Query dependencies for specific names',
         '',
@@ -135133,8 +135233,8 @@ function createCallCommand() {
         '  - Multiple patterns (comma-separated): --query="main,helper"',
         '    → Analyzes connections: how "main" connects to "helper"'
     ].join('\n                       '))
-        .option('--depth <number>', 'Query depth for dependency traversal', '10')
-        .option('--json', 'Output query results in JSON format')
+        .option('--depth <number>', 'Query depth for dependency traversal (default: 3 for single query, 10 for multi-query)')
+        .option('--json', 'Output in JSON format (works in both summary and query modes)')
         .option('--clear-cache', 'Clear dependency analysis cache')
         .option('--log-level <level>', 'Log level: debug|info|warn|error', 'error')
         .option('--storage <path>', 'Custom storage path')