@defai.digital/ax-cli 3.4.5 → 3.5.2

package/LICENSE

@@ -1,12 +1,8 @@
 MIT License
 
-This software is based on grok-cli (MIT License)
-Copyright (c) 2023 GrokCLI Authors https://github.com/superagent-ai/grok-cli
-
-Modifications Copyright (c) 2025 DEFAI Private Limited
+Copyright (c) 2025 DEFAI Private Limited
 Licensed under the MIT License https://github.com/defai-digital/ax-cli
 
-
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights
@@ -14,7 +10,7 @@ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission statement shall be included in all
+The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

package/README.md

@@ -1,10 +1,10 @@
 # AX CLI - Enterprise-Class GLM AI CLI
 
-[![Tests](https://img.shields.io/badge/tests-562%20passing-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli/actions/workflows/test.yml)
-[![Coverage](https://img.shields.io/badge/coverage-98.29%25-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli)
 [![npm](https://img.shields.io/npm/dt/@defai.digital/ax-cli?style=flat-square&logo=npm&label=downloads)](https://npm-stat.com/charts.html?package=%40defai.digital%2Fax-cli)
-[![Node.js Version](https://img.shields.io/badge/node-%3E%3D24.0.0-blue?style=flat-square)](https://nodejs.org/)
+[![Tests](https://img.shields.io/badge/tests-1017%20passing-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli/actions/workflows/test.yml)
+[![Coverage](https://img.shields.io/badge/coverage-98%2B%25-brightgreen?style=flat-square)](https://github.com/defai-digital/ax-cli)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9%2B-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D24.0.0-blue?style=flat-square)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
 [![macOS](https://img.shields.io/badge/macOS-26-blue?style=flat-square&logo=apple)](https://www.apple.com/macos/)
 [![Windows](https://img.shields.io/badge/Windows-11-blue?style=flat-square&logo=windows)](https://www.microsoft.com/windows/)
@@ -82,6 +82,13 @@ ax-cli
   - Support for technical docs, code examples, news, and general queries
   - Configurable search depth and freshness filters
 - **🔄 Auto-Update**: Built-in update checker and installer
+- **📊 Advanced Code Analysis** (NEW in v2.4.0): Professional-grade static analysis tools
+  - **Dependency Analyzer**: Detect circular dependencies, calculate coupling metrics, identify orphan and hub files
+  - **Code Smell Detector**: Find 10+ anti-patterns (long methods, large classes, duplicates, dead code, etc.)
+  - **Hotspot Analyzer**: Identify frequently changing, complex code using git history analysis
+  - **Metrics Calculator**: Cyclomatic complexity, Halstead metrics, Maintainability Index (MI)
+  - **Security Scanner**: Detect SQL injection, XSS, path traversal, hardcoded secrets, and more
+  - **[Complete Guide](docs/analysis-tools.md)** and **[API Documentation](docs/api/analyzers.md)**
 
 ### Max Tokens Configuration
 
@@ -350,6 +357,60 @@ ax-cli usage reset
 
 [CLI Reference →](docs/cli-reference.md) | [Usage Guide →](docs/usage.md)
 
+## 📋 Working with Large Content
+
+When working with large amounts of text (logs, code files, documentation), use **file-based workflows** instead of pasting directly into the terminal.
+
+### ⚠️ Terminal Paste Limitations
+
+**Avoid pasting large content directly** into the interactive terminal:
+
+- ❌ **DON'T**: Paste large code files, logs, or documents (>2000 characters)
+- ⚠️ Some terminals may have paste limitations
+- ⚠️ Character counter shows visual warning: Gray (0-999) → Cyan (1000-1599) → Yellow (1600-1999) → **Red (2000+)**
+
+### ✅ Recommended Approaches
+
+**Option 1: File Reference (Interactive Mode)**
+```bash
+# Save your content to a file first
+cat > context.txt
+# (paste content, then Ctrl+D)
+
+# Then use memory commands
+ax-cli
+> /memory add context.txt
+> analyze the content I just added
+```
+
+**Option 2: Headless Mode with File Input**
+```bash
+# Direct file processing
+ax-cli --prompt "analyze this: $(cat large-file.txt)"
+
+# Or use the --file flag
+ax-cli --file path/to/code.ts --prompt "review this code"
+```
+
+**Option 3: Use `/memory` Commands**
+```bash
+# In interactive mode
+> /memory add src/
+> /memory add logs/error.log
+> analyze the errors in the log file
+```
+
+### Character Count Guide
+
+The interactive terminal shows a character counter `[count/2000]` with color-coded warnings:
+
+| Color | Range | Recommendation |
+|-------|-------|----------------|
+| **Gray** | 0-999 | ✅ Optimal length |
+| **Cyan** | 1000-1599 | ⚠️ Getting long |
+| **Yellow** | 1600-1999 | ⚠️ Consider using files |
+| **Red** | 2000+ | ❌ Use file-based workflow |
+
 ## 🏥 Health Check & Diagnostics (NEW)
 
 Run comprehensive diagnostics to verify your AX CLI configuration:
@@ -679,6 +740,33 @@ AX CLI implements enterprise-grade architecture with:
 - [Development](docs/development.md) - Development and contribution guide
 - [Troubleshooting](docs/troubleshooting.md) - Common issues and solutions
 
+## 📋 Changelog
+
+### v3.5.2 (2025-11-22)
+
+**Bug Fixes - Resource Leak Prevention:**
+- Fixed uncleaned nested timeout in bash tool that held process references after exit
+- Fixed uncleaned timeout in MCP URL validation causing 3-second memory leaks
+- Added `.unref()` to background cleanup timers to prevent GC blocking
+- Added try-finally blocks for guaranteed timeout cleanup in error scenarios
+
+**Bug Fixes - Platform Compatibility:**
+- Fixed Windows home directory bug in command history (used `os.homedir()` instead of `"~"` fallback)
+
+**Code Quality:**
+- Comprehensive resource leak analysis across 78+ potential issues
+- Improved timeout cleanup patterns following Node.js best practices
+- Enhanced memory management for better garbage collection
+
+### v3.5.0
+
+**Features:**
+- Multi-phase task planner with automatic complexity detection
+- Enhanced MCP integration with production-ready templates
+- Project memory system with intelligent context caching
+- Web search capabilities with Tavily AI and Brave Search
+- Advanced code analysis tools (dependency, security, metrics)
+
 ## 📄 License
 
 MIT License - see [LICENSE](LICENSE) for details

package/dist/analyzers/ast/parser.d.ts

@@ -0,0 +1,59 @@
+/**
+ * AST Parser
+ *
+ * Provides TypeScript/JavaScript AST parsing using ts-morph
+ */
+import { SourceFile } from 'ts-morph';
+import type { FileASTInfo } from './types.js';
+export declare class ASTParser {
+    private project;
+    constructor();
+    /**
+     * Parse a TypeScript/JavaScript file
+     */
+    parseFile(filePath: string): FileASTInfo;
+    /**
+     * Parse file content directly
+     */
+    parseContent(content: string, filePath?: string): FileASTInfo;
+    /**
+     * Extract all functions from source file
+     */
+    private extractFunctions;
+    /**
+     * Extract all classes from source file
+     */
+    private extractClasses;
+    /**
+     * Extract methods from a class
+     */
+    private extractMethods;
+    /**
+     * Extract properties from a class
+     */
+    private extractProperties;
+    /**
+     * Extract parameters from a function or method
+     */
+    private extractParameters;
+    /**
+     * Extract imports from source file
+     */
+    private extractImports;
+    /**
+     * Extract exports from source file
+     */
+    private extractExports;
+    /**
+     * Calculate cyclomatic complexity (simplified)
+     */
+    private calculateCyclomaticComplexity;
+    /**
+     * Get raw source file for advanced operations
+     */
+    getSourceFile(filePath: string): SourceFile;
+    /**
+     * Clear project cache
+     */
+    clear(): void;
+}

package/dist/analyzers/ast/parser.js

@@ -0,0 +1,293 @@
+/**
+ * AST Parser
+ *
+ * Provides TypeScript/JavaScript AST parsing using ts-morph
+ */
+import { Project, ScriptTarget, ModuleKind, SyntaxKind } from 'ts-morph';
+export class ASTParser {
+    project;
+    constructor() {
+        this.project = new Project({
+            compilerOptions: {
+                target: ScriptTarget.Latest,
+                module: ModuleKind.CommonJS,
+                allowJs: true,
+                skipLibCheck: true,
+            },
+            skipAddingFilesFromTsConfig: true,
+        });
+    }
+    /**
+     * Parse a TypeScript/JavaScript file
+     */
+    parseFile(filePath) {
+        const sourceFile = this.project.addSourceFileAtPath(filePath);
+        try {
+            const functions = this.extractFunctions(sourceFile);
+            const classes = this.extractClasses(sourceFile);
+            const imports = this.extractImports(sourceFile);
+            const exports = this.extractExports(sourceFile);
+            return Object.freeze({
+                filePath,
+                functions: Object.freeze(functions),
+                classes: Object.freeze(classes),
+                imports: Object.freeze(imports),
+                exports: Object.freeze(exports),
+                totalLines: sourceFile.getEndLineNumber(),
+            });
+        }
+        finally {
+            // Clean up to prevent memory leaks
+            this.project.removeSourceFile(sourceFile);
+        }
+    }
+    /**
+     * Parse file content directly
+     */
+    parseContent(content, filePath = 'temp.ts') {
+        const sourceFile = this.project.createSourceFile(filePath, content, { overwrite: true });
+        try {
+            const functions = this.extractFunctions(sourceFile);
+            const classes = this.extractClasses(sourceFile);
+            const imports = this.extractImports(sourceFile);
+            const exports = this.extractExports(sourceFile);
+            return Object.freeze({
+                filePath,
+                functions: Object.freeze(functions),
+                classes: Object.freeze(classes),
+                imports: Object.freeze(imports),
+                exports: Object.freeze(exports),
+                totalLines: sourceFile.getEndLineNumber(),
+            });
+        }
+        finally {
+            this.project.removeSourceFile(sourceFile);
+        }
+    }
+    /**
+     * Extract all functions from source file
+     */
+    extractFunctions(sourceFile) {
+        const functions = [];
+        sourceFile.getFunctions().forEach(func => {
+            const name = func.getName() || '<anonymous>';
+            const parameters = this.extractParameters(func);
+            const startLine = func.getStartLineNumber();
+            const endLine = func.getEndLineNumber();
+            functions.push(Object.freeze({
+                name,
+                parameters: Object.freeze(parameters),
+                returnType: func.getReturnType().getText(),
+                startLine,
+                endLine,
+                complexity: this.calculateCyclomaticComplexity(func.getBody()?.getText() || ''),
+                length: endLine - startLine + 1,
+                isAsync: func.isAsync(),
+                isExported: func.isExported(),
+            }));
+        });
+        return functions;
+    }
+    /**
+     * Extract all classes from source file
+     */
+    extractClasses(sourceFile) {
+        const classes = [];
+        sourceFile.getClasses().forEach(cls => {
+            const name = cls.getName() || '<anonymous>';
+            const methods = this.extractMethods(cls);
+            const properties = this.extractProperties(cls);
+            const startLine = cls.getStartLineNumber();
+            const endLine = cls.getEndLineNumber();
+            classes.push(Object.freeze({
+                name,
+                methods: Object.freeze(methods),
+                properties: Object.freeze(properties),
+                startLine,
+                endLine,
+                length: endLine - startLine + 1,
+                isExported: cls.isExported(),
+                extendsClass: cls.getExtends()?.getText(),
+                implementsInterfaces: Object.freeze(cls.getImplements().map(i => i.getText())),
+            }));
+        });
+        return classes;
+    }
+    /**
+     * Extract methods from a class
+     */
+    extractMethods(cls) {
+        const methods = [];
+        cls.getMethods().forEach((method) => {
+            const name = method.getName();
+            const parameters = this.extractParameters(method);
+            const startLine = method.getStartLineNumber();
+            const endLine = method.getEndLineNumber();
+            // Determine visibility
+            let visibility = 'public';
+            if (method.hasModifier(SyntaxKind.PrivateKeyword)) {
+                visibility = 'private';
+            }
+            else if (method.hasModifier(SyntaxKind.ProtectedKeyword)) {
+                visibility = 'protected';
+            }
+            methods.push(Object.freeze({
+                name,
+                parameters: Object.freeze(parameters),
+                returnType: method.getReturnType().getText(),
+                visibility,
+                isStatic: method.isStatic(),
+                isAsync: method.isAsync(),
+                complexity: this.calculateCyclomaticComplexity(method.getBody()?.getText() || ''),
+                length: endLine - startLine + 1,
+                startLine,
+                endLine,
+            }));
+        });
+        return methods;
+    }
+    /**
+     * Extract properties from a class
+     */
+    extractProperties(cls) {
+        const properties = [];
+        cls.getProperties().forEach((prop) => {
+            const name = prop.getName();
+            // Determine visibility
+            let visibility = 'public';
+            if (prop.hasModifier(SyntaxKind.PrivateKeyword)) {
+                visibility = 'private';
+            }
+            else if (prop.hasModifier(SyntaxKind.ProtectedKeyword)) {
+                visibility = 'protected';
+            }
+            properties.push(Object.freeze({
+                name,
+                type: prop.getType().getText(),
+                visibility,
+                isReadonly: prop.isReadonly(),
+                isStatic: prop.isStatic(),
+                hasInitializer: prop.hasInitializer(),
+            }));
+        });
+        return properties;
+    }
+    /**
+     * Extract parameters from a function or method
+     */
+    extractParameters(func) {
+        const parameters = [];
+        func.getParameters().forEach((param) => {
+            parameters.push(Object.freeze({
+                name: param.getName(),
+                type: param.getType().getText(),
+                isOptional: param.isOptional(),
+                hasDefault: param.hasInitializer(),
+            }));
+        });
+        return parameters;
+    }
+    /**
+     * Extract imports from source file
+     */
+    extractImports(sourceFile) {
+        const imports = [];
+        sourceFile.getImportDeclarations().forEach(imp => {
+            const moduleSpecifier = imp.getModuleSpecifierValue();
+            const namedImports = imp.getNamedImports().map(n => n.getName());
+            const defaultImport = imp.getDefaultImport()?.getText();
+            const namespaceImport = imp.getNamespaceImport()?.getText();
+            // Determine if external (starts with letter, not './' or '../')
+            const isExternal = !moduleSpecifier.startsWith('.') && !moduleSpecifier.startsWith('/');
+            // Check if type-only import
+            const isTypeOnly = imp.isTypeOnly();
+            imports.push(Object.freeze({
+                moduleSpecifier,
+                namedImports: Object.freeze(namedImports),
+                defaultImport,
+                namespaceImport,
+                isExternal,
+                isTypeOnly,
+            }));
+        });
+        return imports;
+    }
+    /**
+     * Extract exports from source file
+     */
+    extractExports(sourceFile) {
+        const exports = [];
+        // Named exports
+        sourceFile.getExportDeclarations().forEach(exp => {
+            exp.getNamedExports().forEach(named => {
+                exports.push(Object.freeze({
+                    name: named.getName(),
+                    isDefault: false,
+                    type: 'variable',
+                }));
+            });
+        });
+        // Exported functions
+        sourceFile.getFunctions().forEach(func => {
+            if (func.isExported()) {
+                exports.push(Object.freeze({
+                    name: func.getName() || '<anonymous>',
+                    isDefault: func.isDefaultExport(),
+                    type: 'function',
+                }));
+            }
+        });
+        // Exported classes
+        sourceFile.getClasses().forEach(cls => {
+            if (cls.isExported()) {
+                exports.push(Object.freeze({
+                    name: cls.getName() || '<anonymous>',
+                    isDefault: cls.isDefaultExport(),
+                    type: 'class',
+                }));
+            }
+        });
+        return exports;
+    }
+    /**
+     * Calculate cyclomatic complexity (simplified)
+     */
+    calculateCyclomaticComplexity(code) {
+        let complexity = 1;
+        // Count decision points
+        const patterns = [
+            /\bif\b/g,
+            /\belse\s+if\b/g,
+            /\bfor\b/g,
+            /\bwhile\b/g,
+            /\bcase\b/g,
+            /\bcatch\b/g,
+            /&&/g,
+            /\|\|/g,
+            /\?/g,
+        ];
+        for (const pattern of patterns) {
+            const matches = code.match(pattern);
+            if (matches) {
+                complexity += matches.length;
+            }
+        }
+        return complexity;
+    }
+    /**
+     * Get raw source file for advanced operations
+     */
+    getSourceFile(filePath) {
+        return this.project.addSourceFileAtPath(filePath);
+    }
+    /**
+     * Clear project cache
+     */
+    clear() {
+        const sourceFiles = this.project.getSourceFiles();
+        for (const sourceFile of sourceFiles) {
+            this.project.removeSourceFile(sourceFile);
+        }
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/analyzers/ast/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/analyzers/ast/parser.ts"],"names":[],"mappings":"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"}

package/dist/analyzers/ast/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * AST Parser Types
+ *
+ * Type definitions for AST-based analysis
+ */
+import type { SourceFile, FunctionDeclaration, ClassDeclaration, MethodDeclaration, ImportDeclaration, ExportDeclaration } from 'ts-morph';
+/**
+ * Function information extracted from AST
+ */
+export interface FunctionInfo {
+    readonly name: string;
+    readonly parameters: ReadonlyArray<ParameterInfo>;
+    readonly returnType?: string;
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly complexity: number;
+    readonly length: number;
+    readonly isAsync: boolean;
+    readonly isExported: boolean;
+}
+/**
+ * Parameter information
+ */
+export interface ParameterInfo {
+    readonly name: string;
+    readonly type?: string;
+    readonly isOptional: boolean;
+    readonly hasDefault: boolean;
+}
+/**
+ * Class information extracted from AST
+ */
+export interface ClassInfo {
+    readonly name: string;
+    readonly methods: ReadonlyArray<MethodInfo>;
+    readonly properties: ReadonlyArray<PropertyInfo>;
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly length: number;
+    readonly isExported: boolean;
+    readonly extendsClass?: string;
+    readonly implementsInterfaces: ReadonlyArray<string>;
+}
+/**
+ * Method information
+ */
+export interface MethodInfo {
+    readonly name: string;
+    readonly parameters: ReadonlyArray<ParameterInfo>;
+    readonly returnType?: string;
+    readonly visibility: 'public' | 'private' | 'protected';
+    readonly isStatic: boolean;
+    readonly isAsync: boolean;
+    readonly complexity: number;
+    readonly length: number;
+    readonly startLine: number;
+    readonly endLine: number;
+}
+/**
+ * Property information
+ */
+export interface PropertyInfo {
+    readonly name: string;
+    readonly type?: string;
+    readonly visibility: 'public' | 'private' | 'protected';
+    readonly isReadonly: boolean;
+    readonly isStatic: boolean;
+    readonly hasInitializer: boolean;
+}
+/**
+ * Import information
+ */
+export interface ImportInfo {
+    readonly moduleSpecifier: string;
+    readonly namedImports: ReadonlyArray<string>;
+    readonly defaultImport?: string;
+    readonly namespaceImport?: string;
+    readonly isExternal: boolean;
+    readonly isTypeOnly: boolean;
+}
+/**
+ * Export information
+ */
+export interface ExportInfo {
+    readonly name: string;
+    readonly isDefault: boolean;
+    readonly type: 'function' | 'class' | 'variable' | 'type';
+}
+/**
+ * File AST information
+ */
+export interface FileASTInfo {
+    readonly filePath: string;
+    readonly functions: ReadonlyArray<FunctionInfo>;
+    readonly classes: ReadonlyArray<ClassInfo>;
+    readonly imports: ReadonlyArray<ImportInfo>;
+    readonly exports: ReadonlyArray<ExportInfo>;
+    readonly totalLines: number;
+}
+/**
+ * AST node visitor callback
+ */
+export type NodeVisitor<T> = (node: T) => void | boolean;
+/**
+ * Re-export ts-morph types for convenience
+ */
+export type { SourceFile, FunctionDeclaration, ClassDeclaration, MethodDeclaration, ImportDeclaration, ExportDeclaration };

package/dist/analyzers/ast/types.js

@@ -0,0 +1,7 @@
+/**
+ * AST Parser Types
+ *
+ * Type definitions for AST-based analysis
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/analyzers/ast/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/analyzers/ast/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/analyzers/code-smells/base-smell-detector.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Base Smell Detector
+ *
+ * Abstract base class for all smell detectors
+ */
+import { ASTParser } from '../ast/parser.js';
+import type { SmellDetector, CodeSmell, SmellType, DetectorConfig } from './types.js';
+import { SmellSeverity } from './types.js';
+export declare abstract class BaseSmellDetector implements SmellDetector {
+    readonly type: SmellType;
+    readonly config: DetectorConfig;
+    protected astParser: ASTParser;
+    constructor(type: SmellType, config: DetectorConfig);
+    /**
+     * Detect smells in a file
+     */
+    abstract detect(filePath: string): Promise<CodeSmell[]>;
+    /**
+     * Check if detector is enabled
+     */
+    protected isEnabled(): boolean;
+    /**
+     * Get threshold value
+     */
+    protected getThreshold(key: string, defaultValue: number): number;
+    /**
+     * Create a code smell object
+     */
+    protected createSmell(filePath: string, startLine: number, endLine: number, message: string, suggestion: string, severity: SmellSeverity, metadata?: Record<string, unknown>): CodeSmell;
+}