@defai.digital/ax-cli 3.4.6 → 3.5.4

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,8 +1,8 @@
 # AX CLI - Enterprise-Class GLM AI 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)
-[![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)
+[![Tests](https://img.shields.io/badge/tests-1036%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)
@@ -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,52 @@ 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.3 (2025-11-22)
+
+**Bug Fixes - Test Quality & Reliability:**
+- Fixed unhandled promise rejection in subagent tests that caused Node.js warnings
+- Replaced meaningless test assertions (`expect(true).toBe(true)`) with real validation
+- Properly skipped untestable tests with clear TODO documentation
+- Fixed flaky performance test by adjusting timing threshold (0.9x instead of 0.7x)
+
+**Test Suite Improvements:**
+- Improved test isolation and error handling patterns
+- Enhanced performance test reliability for CI/CD environments
+- Better documentation of test limitations
+- All 1,038 tests passing (1,036 passed + 2 properly skipped)
+
+**Code Quality:**
+- Comprehensive test quality analysis across all test files
+- Eliminated false confidence from placeholder tests
+- Maintained 98%+ test coverage with genuine validation
+
+### 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/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * AST Analysis Module
+ *
+ * Provides TypeScript/JavaScript AST parsing and traversal utilities
+ */
+export { ASTParser } from './parser.js';
+export * from './types.js';
+export * from './node-helpers.js';
+export * from './traverser.js';

package/dist/analyzers/ast/index.js

@@ -0,0 +1,10 @@
+/**
+ * AST Analysis Module
+ *
+ * Provides TypeScript/JavaScript AST parsing and traversal utilities
+ */
+export { ASTParser } from './parser.js';
+export * from './types.js';
+export * from './node-helpers.js';
+export * from './traverser.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyzers/ast/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}

package/dist/analyzers/ast/node-helpers.d.ts

@@ -0,0 +1,81 @@
+/**
+ * AST Node Helper Utilities
+ *
+ * Type guards and utility functions for working with AST nodes
+ */
+import type { FunctionInfo, ClassInfo, MethodInfo, ImportInfo } from './types.js';
+/**
+ * Check if function is a high-complexity function
+ */
+export declare function isHighComplexity(func: FunctionInfo, threshold?: number): boolean;
+/**
+ * Check if function is a long function
+ */
+export declare function isLongFunction(func: FunctionInfo, threshold?: number): boolean;
+/**
+ * Check if class is a large class (God Object indicator)
+ */
+export declare function isLargeClass(cls: ClassInfo, methodThreshold?: number, lineThreshold?: number): boolean;
+/**
+ * Check if method has too many parameters
+ */
+export declare function hasTooManyParameters(method: MethodInfo | FunctionInfo, threshold?: number): boolean;
+/**
+ * Get all external imports (from node_modules)
+ */
+export declare function getExternalImports(imports: readonly ImportInfo[]): ImportInfo[];
+/**
+ * Get all internal imports (relative paths)
+ */
+export declare function getInternalImports(imports: readonly ImportInfo[]): ImportInfo[];
+/**
+ * Calculate class coupling (number of external dependencies)
+ */
+export declare function calculateClassCoupling(imports: readonly ImportInfo[]): number;
+/**
+ * Find all async functions in a list
+ */
+export declare function getAsyncFunctions(functions: readonly FunctionInfo[]): FunctionInfo[];
+/**
+ * Find all exported functions
+ */
+export declare function getExportedFunctions(functions: readonly FunctionInfo[]): FunctionInfo[];
+/**
+ * Get average complexity of functions
+ */
+export declare function getAverageComplexity(functions: readonly FunctionInfo[]): number;
+/**
+ * Get average function length
+ */
+export declare function getAverageFunctionLength(functions: readonly FunctionInfo[]): number;
+/**
+ * Find all private methods in a class
+ */
+export declare function getPrivateMethods(cls: ClassInfo): MethodInfo[];
+/**
+ * Find all public methods in a class
+ */
+export declare function getPublicMethods(cls: ClassInfo): MethodInfo[];
+/**
+ * Find all static methods in a class
+ */
+export declare function getStaticMethods(cls: ClassInfo): MethodInfo[];
+/**
+ * Calculate method density (methods per line)
+ */
+export declare function calculateMethodDensity(cls: ClassInfo): number;
+/**
+ * Check if import is a type-only import
+ */
+export declare function isTypeOnlyImport(imp: ImportInfo): boolean;
+/**
+ * Group imports by external/internal
+ */
+export declare function groupImportsByType(imports: readonly ImportInfo[]): {
+    external: ImportInfo[];
+    internal: ImportInfo[];
+};
+/**
+ * Calculate cognitive complexity score for a file
+ */
+export declare function calculateFileCognitiveComplexity(functions: readonly FunctionInfo[], classes: readonly ClassInfo[]): number;

package/dist/analyzers/ast/node-helpers.js

@@ -0,0 +1,128 @@
+/**
+ * AST Node Helper Utilities
+ *
+ * Type guards and utility functions for working with AST nodes
+ */
+/**
+ * Check if function is a high-complexity function
+ */
+export function isHighComplexity(func, threshold = 10) {
+    return func.complexity > threshold;
+}
+/**
+ * Check if function is a long function
+ */
+export function isLongFunction(func, threshold = 50) {
+    return func.length > threshold;
+}
+/**
+ * Check if class is a large class (God Object indicator)
+ */
+export function isLargeClass(cls, methodThreshold = 20, lineThreshold = 300) {
+    return cls.methods.length > methodThreshold || cls.length > lineThreshold;
+}
+/**
+ * Check if method has too many parameters
+ */
+export function hasTooManyParameters(method, threshold = 5) {
+    return method.parameters.length > threshold;
+}
+/**
+ * Get all external imports (from node_modules)
+ */
+export function getExternalImports(imports) {
+    return imports.filter(imp => imp.isExternal);
+}
+/**
+ * Get all internal imports (relative paths)
+ */
+export function getInternalImports(imports) {
+    return imports.filter(imp => !imp.isExternal);
+}
+/**
+ * Calculate class coupling (number of external dependencies)
+ */
+export function calculateClassCoupling(imports) {
+    const external = getExternalImports(imports);
+    return external.length;
+}
+/**
+ * Find all async functions in a list
+ */
+export function getAsyncFunctions(functions) {
+    return functions.filter(f => f.isAsync);
+}
+/**
+ * Find all exported functions
+ */
+export function getExportedFunctions(functions) {
+    return functions.filter(f => f.isExported);
+}
+/**
+ * Get average complexity of functions
+ */
+export function getAverageComplexity(functions) {
+    if (functions.length === 0)
+        return 0;
+    const total = functions.reduce((sum, f) => sum + f.complexity, 0);
+    return total / functions.length;
+}
+/**
+ * Get average function length
+ */
+export function getAverageFunctionLength(functions) {
+    if (functions.length === 0)
+        return 0;
+    const total = functions.reduce((sum, f) => sum + f.length, 0);
+    return total / functions.length;
+}
+/**
+ * Find all private methods in a class
+ */
+export function getPrivateMethods(cls) {
+    return cls.methods.filter(m => m.visibility === 'private');
+}
+/**
+ * Find all public methods in a class
+ */
+export function getPublicMethods(cls) {
+    return cls.methods.filter(m => m.visibility === 'public');
+}
+/**
+ * Find all static methods in a class
+ */
+export function getStaticMethods(cls) {
+    return cls.methods.filter(m => m.isStatic);
+}
+/**
+ * Calculate method density (methods per line)
+ */
+export function calculateMethodDensity(cls) {
+    if (cls.length === 0)
+        return 0;
+    return cls.methods.length / cls.length;
+}
+/**
+ * Check if import is a type-only import
+ */
+export function isTypeOnlyImport(imp) {
+    return imp.namedImports.every(name => name.startsWith('type ') || name.includes('Type'));
+}
+/**
+ * Group imports by external/internal
+ */
+export function groupImportsByType(imports) {
+    return {
+        external: getExternalImports(imports),
+        internal: getInternalImports(imports),
+    };
+}
+/**
+ * Calculate cognitive complexity score for a file
+ */
+export function calculateFileCognitiveComplexity(functions, classes) {
+    const funcComplexity = functions.reduce((sum, f) => sum + f.complexity, 0);
+    const methodComplexity = classes.reduce((sum, c) => sum + c.methods.reduce((mSum, m) => mSum + m.complexity, 0), 0);
+    return funcComplexity + methodComplexity;
+}
+//# sourceMappingURL=node-helpers.js.map

package/dist/analyzers/ast/node-helpers.js.map

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

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;
+}