@defai.digital/ax-cli 3.4.5 → 3.5.2

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

@@ -0,0 +1,105 @@
+/**
+ * Dependency Analyzer Types
+ */
+/**
+ * Dependency node representing a file
+ */
+export interface DependencyNode {
+    readonly filePath: string;
+    readonly imports: ReadonlyArray<ImportEdge>;
+    readonly exports: ReadonlyArray<ExportEdge>;
+    readonly size: number;
+    readonly loc: number;
+}
+/**
+ * Import edge in dependency graph
+ */
+export interface ImportEdge {
+    readonly from: string;
+    readonly to: string;
+    readonly importedSymbols: ReadonlyArray<string>;
+    readonly isDynamic: boolean;
+    readonly isTypeOnly: boolean;
+}
+/**
+ * Export edge
+ */
+export interface ExportEdge {
+    readonly from: string;
+    readonly symbols: ReadonlyArray<string>;
+    readonly isDefault: boolean;
+    readonly isReExport: boolean;
+}
+/**
+ * Circular dependency cycle
+ */
+export interface CircularDependency {
+    readonly cycle: ReadonlyArray<string>;
+    readonly length: number;
+    readonly severity: 'critical' | 'high' | 'medium' | 'low';
+    readonly impact: number;
+    readonly description: string;
+}
+/**
+ * Coupling metrics for a file
+ */
+export interface CouplingMetrics {
+    readonly file: string;
+    readonly afferentCoupling: number;
+    readonly efferentCoupling: number;
+    readonly instability: number;
+    readonly abstractness: number;
+    readonly distanceFromMainSequence: number;
+    readonly zone: 'useless' | 'painful' | 'balanced';
+}
+/**
+ * Dependency analysis result
+ */
+export interface DependencyAnalysisResult {
+    readonly graph: DependencyGraph;
+    readonly circularDependencies: ReadonlyArray<CircularDependency>;
+    readonly couplingMetrics: ReadonlyArray<CouplingMetrics>;
+    readonly orphanedFiles: ReadonlyArray<string>;
+    readonly hubFiles: ReadonlyArray<string>;
+    readonly summary: DependencySummary;
+    readonly timestamp: Date;
+}
+/**
+ * Summary statistics
+ */
+export interface DependencySummary {
+    readonly totalFiles: number;
+    readonly totalDependencies: number;
+    readonly averageAfferentCoupling: number;
+    readonly averageEfferentCoupling: number;
+    readonly averageInstability: number;
+    readonly circularDependencyCount: number;
+    readonly maxCycleLength: number;
+    readonly healthScore: number;
+}
+/**
+ * Dependency graph interface
+ */
+export interface DependencyGraph {
+    addNode(node: DependencyNode): void;
+    addEdge(from: string, to: string): void;
+    getNode(file: string): DependencyNode | undefined;
+    getNodes(): DependencyNode[];
+    getAfferentDependencies(file: string): string[];
+    getEfferentDependencies(file: string): string[];
+    getTotalEdges(): number;
+    hasPath(from: string, to: string): boolean;
+    topologicalSort(): {
+        sorted: string[];
+        hasCycle: boolean;
+    };
+    getStronglyConnectedComponents(): string[][];
+}
+/**
+ * Analysis options
+ */
+export interface DependencyAnalysisOptions {
+    readonly includeNodeModules?: boolean;
+    readonly maxDepth?: number;
+    readonly ignorePatterns?: readonly string[];
+}

package/dist/analyzers/dependency/types.js

@@ -0,0 +1,5 @@
+/**
+ * Dependency Analyzer Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/analyzers/git/churn-calculator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Git Churn Calculator
+ *
+ * Calculates file churn metrics from git history
+ */
+import type { FileChurn, GitAnalysisOptions, ContributorStats } from './types.js';
+export declare class ChurnCalculator {
+    private repositoryPath;
+    constructor(repositoryPath: string);
+    /**
+     * Calculate churn for all files
+     */
+    calculateChurn(options?: GitAnalysisOptions): Promise<FileChurn[]>;
+    /**
+     * Calculate contributor statistics
+     */
+    calculateContributorStats(options?: GitAnalysisOptions): Promise<ContributorStats[]>;
+    /**
+     * Get git log with file stats
+     */
+    private getGitLog;
+    /**
+     * Parse git log output
+     */
+    private parseGitLog;
+    /**
+     * Check if file should be included based on patterns
+     */
+    private shouldIncludeFile;
+    /**
+     * Simple pattern matching (supports * wildcard)
+     */
+    private matchPattern;
+}

package/dist/analyzers/git/churn-calculator.js

@@ -0,0 +1,214 @@
+/**
+ * Git Churn Calculator
+ *
+ * Calculates file churn metrics from git history
+ */
+import { execSync } from 'child_process';
+export class ChurnCalculator {
+    repositoryPath;
+    constructor(repositoryPath) {
+        this.repositoryPath = repositoryPath;
+    }
+    /**
+     * Calculate churn for all files
+     */
+    async calculateChurn(options = {}) {
+        const gitLogOutput = this.getGitLog(options);
+        const fileChurnMap = new Map();
+        // Parse git log output
+        const commits = this.parseGitLog(gitLogOutput);
+        for (const commit of commits) {
+            for (const file of commit.files) {
+                if (!this.shouldIncludeFile(file.path, options))
+                    continue;
+                if (!fileChurnMap.has(file.path)) {
+                    fileChurnMap.set(file.path, {
+                        commits: 0,
+                        additions: 0,
+                        deletions: 0,
+                        lastModified: commit.date,
+                        authors: new Set(),
+                    });
+                }
+                const churn = fileChurnMap.get(file.path);
+                churn.commits++;
+                churn.additions += file.additions;
+                churn.deletions += file.deletions;
+                churn.authors.add(commit.author);
+                // Update last modified date
+                if (commit.date > churn.lastModified) {
+                    churn.lastModified = commit.date;
+                }
+            }
+        }
+        // Convert to FileChurn array
+        const result = [];
+        for (const [filePath, data] of fileChurnMap.entries()) {
+            result.push(Object.freeze({
+                filePath,
+                commitCount: data.commits,
+                additions: data.additions,
+                deletions: data.deletions,
+                totalChurn: data.additions + data.deletions,
+                lastModified: data.lastModified,
+                authors: Object.freeze(Array.from(data.authors)),
+            }));
+        }
+        // Sort by total churn (descending)
+        return result.sort((a, b) => b.totalChurn - a.totalChurn);
+    }
+    /**
+     * Calculate contributor statistics
+     */
+    async calculateContributorStats(options = {}) {
+        const gitLogOutput = this.getGitLog(options);
+        const commits = this.parseGitLog(gitLogOutput);
+        const contributorMap = new Map();
+        for (const commit of commits) {
+            if (!contributorMap.has(commit.author)) {
+                contributorMap.set(commit.author, {
+                    commits: 0,
+                    files: new Set(),
+                    added: 0,
+                    deleted: 0,
+                    firstCommit: commit.date,
+                    lastCommit: commit.date,
+                });
+            }
+            const stats = contributorMap.get(commit.author);
+            stats.commits++;
+            for (const file of commit.files) {
+                if (this.shouldIncludeFile(file.path, options)) {
+                    stats.files.add(file.path);
+                    stats.added += file.additions;
+                    stats.deleted += file.deletions;
+                }
+            }
+            // Update date range
+            if (commit.date < stats.firstCommit) {
+                stats.firstCommit = commit.date;
+            }
+            if (commit.date > stats.lastCommit) {
+                stats.lastCommit = commit.date;
+            }
+        }
+        // Convert to ContributorStats array
+        const result = [];
+        for (const [author, data] of contributorMap.entries()) {
+            result.push(Object.freeze({
+                author,
+                commitCount: data.commits,
+                filesChanged: data.files.size,
+                linesAdded: data.added,
+                linesDeleted: data.deleted,
+                firstCommit: data.firstCommit,
+                lastCommit: data.lastCommit,
+            }));
+        }
+        // Sort by commit count (descending)
+        return result.sort((a, b) => b.commitCount - a.commitCount);
+    }
+    /**
+     * Get git log with file stats
+     */
+    getGitLog(options) {
+        const args = ['log', '--numstat', '--pretty=format:%H|%an|%ad|%s'];
+        if (options.since) {
+            args.push(`--since="${options.since}"`);
+        }
+        if (options.until) {
+            args.push(`--until="${options.until}"`);
+        }
+        if (options.branch) {
+            args.push(options.branch);
+        }
+        try {
+            return execSync(`git ${args.join(' ')}`, {
+                cwd: this.repositoryPath,
+                encoding: 'utf-8',
+                maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+                stdio: ['pipe', 'pipe', 'ignore'], // Ignore stderr to suppress shell warnings
+            });
+        }
+        catch (error) {
+            // If git command fails, return empty string
+            return '';
+        }
+    }
+    /**
+     * Parse git log output
+     */
+    parseGitLog(output) {
+        const commits = [];
+        const lines = output.split('\n');
+        let currentCommit = null;
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            // Commit line: hash|author|date|message
+            if (line.includes('|')) {
+                const parts = line.split('|');
+                if (parts.length >= 4) {
+                    // Save previous commit
+                    if (currentCommit) {
+                        commits.push(currentCommit);
+                    }
+                    // Start new commit
+                    currentCommit = {
+                        hash: parts[0],
+                        author: parts[1],
+                        date: new Date(parts[2]),
+                        message: parts[3],
+                        files: [],
+                    };
+                }
+            }
+            else if (currentCommit) {
+                // File stat line: additions deletions filename
+                const parts = line.split('\t');
+                if (parts.length >= 3) {
+                    const additions = parts[0] === '-' ? 0 : parseInt(parts[0], 10);
+                    const deletions = parts[1] === '-' ? 0 : parseInt(parts[1], 10);
+                    const path = parts[2];
+                    currentCommit.files.push({ path, additions, deletions });
+                }
+            }
+        }
+        // Add last commit
+        if (currentCommit) {
+            commits.push(currentCommit);
+        }
+        return commits;
+    }
+    /**
+     * Check if file should be included based on patterns
+     */
+    shouldIncludeFile(filePath, options) {
+        // Check exclude patterns
+        if (options.excludePatterns) {
+            for (const pattern of options.excludePatterns) {
+                if (this.matchPattern(filePath, pattern)) {
+                    return false;
+                }
+            }
+        }
+        // Check include patterns
+        if (options.includePatterns && options.includePatterns.length > 0) {
+            for (const pattern of options.includePatterns) {
+                if (this.matchPattern(filePath, pattern)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Simple pattern matching (supports * wildcard)
+     */
+    matchPattern(filePath, pattern) {
+        const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+        return regex.test(filePath);
+    }
+}
+//# sourceMappingURL=churn-calculator.js.map

package/dist/analyzers/git/churn-calculator.js.map

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

package/dist/analyzers/git/git-analyzer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Git Analyzer
+ *
+ * Main orchestrator for Git history analysis
+ */
+import type { GitAnalysisResult, GitAnalysisOptions } from './types.js';
+export declare class GitAnalyzer {
+    private churnCalculator;
+    private hotspotDetector;
+    constructor(repositoryPath: string);
+    /**
+     * Perform complete Git analysis
+     */
+    analyze(options?: GitAnalysisOptions): Promise<GitAnalysisResult>;
+    /**
+     * Calculate summary statistics
+     */
+    private calculateSummary;
+}

package/dist/analyzers/git/git-analyzer.js

@@ -0,0 +1,71 @@
+/**
+ * Git Analyzer
+ *
+ * Main orchestrator for Git history analysis
+ */
+import { ChurnCalculator } from './churn-calculator.js';
+import { HotspotDetector } from './hotspot-detector.js';
+export class GitAnalyzer {
+    churnCalculator;
+    hotspotDetector;
+    constructor(repositoryPath) {
+        this.churnCalculator = new ChurnCalculator(repositoryPath);
+        this.hotspotDetector = new HotspotDetector();
+    }
+    /**
+     * Perform complete Git analysis
+     */
+    async analyze(options = {}) {
+        const timestamp = new Date();
+        // Calculate churn metrics
+        const churnMetrics = await this.churnCalculator.calculateChurn(options);
+        // Calculate contributor statistics
+        const contributors = await this.churnCalculator.calculateContributorStats(options);
+        // Detect hotspots
+        const hotspots = await this.hotspotDetector.detectHotspots(churnMetrics, options);
+        // Calculate summary
+        const summary = this.calculateSummary(churnMetrics, hotspots, contributors);
+        return Object.freeze({
+            hotspots: Object.freeze(hotspots),
+            churnMetrics: Object.freeze(churnMetrics),
+            contributors: Object.freeze(contributors),
+            summary: Object.freeze(summary),
+            timestamp,
+        });
+    }
+    /**
+     * Calculate summary statistics
+     */
+    calculateSummary(churnMetrics, hotspots, contributors) {
+        const totalCommits = contributors.reduce((sum, c) => sum + c.commitCount, 0);
+        const averageChurn = churnMetrics.length > 0
+            ? churnMetrics.reduce((sum, c) => sum + c.totalChurn, 0) / churnMetrics.length
+            : 0;
+        const topContributor = contributors.length > 0
+            ? contributors[0].author
+            : 'Unknown';
+        // Determine date range
+        let earliestDate = new Date();
+        let latestDate = new Date(0);
+        for (const contributor of contributors) {
+            if (contributor.firstCommit < earliestDate) {
+                earliestDate = contributor.firstCommit;
+            }
+            if (contributor.lastCommit > latestDate) {
+                latestDate = contributor.lastCommit;
+            }
+        }
+        return {
+            totalCommits,
+            filesAnalyzed: churnMetrics.length,
+            hotspotCount: hotspots.length,
+            averageChurn: Math.round(averageChurn),
+            topContributor,
+            dateRange: {
+                from: earliestDate,
+                to: latestDate,
+            },
+        };
+    }
+}
+//# sourceMappingURL=git-analyzer.js.map

package/dist/analyzers/git/git-analyzer.js.map

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

package/dist/analyzers/git/hotspot-detector.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Hotspot Detector
+ *
+ * Identifies code hotspots using churn × complexity formula
+ */
+import type { FileChurn, CodeHotspot, GitAnalysisOptions } from './types.js';
+export declare class HotspotDetector {
+    private astParser;
+    constructor();
+    /**
+     * Detect hotspots from churn metrics
+     */
+    detectHotspots(churnMetrics: readonly FileChurn[], options?: GitAnalysisOptions): Promise<CodeHotspot[]>;
+    /**
+     * Get complexity metrics from file
+     */
+    private getComplexityMetrics;
+    /**
+     * Normalize complexity to 0-100 scale
+     */
+    private normalizeComplexity;
+    /**
+     * Calculate severity based on hotspot score
+     */
+    private calculateSeverity;
+    /**
+     * Generate reason for hotspot
+     */
+    private generateReason;
+    /**
+     * Generate recommendation
+     */
+    private generateRecommendation;
+}

package/dist/analyzers/git/hotspot-detector.js

@@ -0,0 +1,170 @@
+/**
+ * Hotspot Detector
+ *
+ * Identifies code hotspots using churn × complexity formula
+ */
+import { ASTParser } from '../ast/parser.js';
+export class HotspotDetector {
+    astParser;
+    constructor() {
+        this.astParser = new ASTParser();
+    }
+    /**
+     * Detect hotspots from churn metrics
+     */
+    async detectHotspots(churnMetrics, options = {}) {
+        const threshold = options.hotspotThreshold ?? 70;
+        const hotspots = [];
+        // Calculate max values for normalization
+        const maxChurn = Math.max(...churnMetrics.map(c => c.totalChurn), 1);
+        const maxCommits = Math.max(...churnMetrics.map(c => c.commitCount), 1);
+        for (const churn of churnMetrics) {
+            try {
+                // Get complexity metrics from AST
+                const complexity = await this.getComplexityMetrics(churn.filePath);
+                if (!complexity)
+                    continue;
+                // Normalize churn (0-100)
+                const normalizedChurn = (churn.totalChurn / maxChurn) * 100;
+                const normalizedCommits = (churn.commitCount / maxCommits) * 100;
+                const churnScore = (normalizedChurn * 0.6 + normalizedCommits * 0.4);
+                // Normalize complexity (0-100)
+                const complexityScore = this.normalizeComplexity(complexity.average, complexity.max);
+                // Calculate hotspot score using weighted formula
+                // Churn: 40%, Complexity: 30%, Commit Frequency: 30%
+                const hotspotScore = Math.round(churnScore * 0.4 +
+                    complexityScore * 0.3 +
+                    normalizedCommits * 0.3);
+                // Only include if above threshold
+                if (hotspotScore >= threshold) {
+                    const severity = this.calculateSeverity(hotspotScore);
+                    const reason = this.generateReason(churn, complexity, hotspotScore);
+                    const recommendation = this.generateRecommendation(churn, complexity, severity);
+                    hotspots.push(Object.freeze({
+                        filePath: churn.filePath,
+                        hotspotScore,
+                        churnScore: Math.round(churnScore),
+                        complexityScore: Math.round(complexityScore),
+                        commitCount: churn.commitCount,
+                        totalChurn: churn.totalChurn,
+                        averageComplexity: complexity.average,
+                        maxComplexity: complexity.max,
+                        severity,
+                        reason,
+                        recommendation,
+                    }));
+                }
+            }
+            catch (error) {
+                // Skip files that can't be analyzed
+                continue;
+            }
+        }
+        // Sort by hotspot score (descending)
+        return hotspots.sort((a, b) => b.hotspotScore - a.hotspotScore);
+    }
+    /**
+     * Get complexity metrics from file
+     */
+    async getComplexityMetrics(filePath) {
+        try {
+            const ast = this.astParser.parseFile(filePath);
+            const complexities = [];
+            // Collect function complexities
+            for (const func of ast.functions) {
+                complexities.push(func.complexity);
+            }
+            // Collect method complexities
+            for (const cls of ast.classes) {
+                for (const method of cls.methods) {
+                    complexities.push(method.complexity);
+                }
+            }
+            if (complexities.length === 0) {
+                return null;
+            }
+            const average = complexities.reduce((sum, c) => sum + c, 0) / complexities.length;
+            const max = Math.max(...complexities);
+            return { average, max };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    /**
+     * Normalize complexity to 0-100 scale
+     */
+    normalizeComplexity(average, max) {
+        // McCabe complexity thresholds:
+        // 1-10: Simple
+        // 11-20: Moderate
+        // 21-50: Complex
+        // 50+: Very complex
+        const avgScore = Math.min(100, (average / 20) * 100);
+        const maxScore = Math.min(100, (max / 50) * 100);
+        // Weight average more than max
+        return avgScore * 0.7 + maxScore * 0.3;
+    }
+    /**
+     * Calculate severity based on hotspot score
+     */
+    calculateSeverity(score) {
+        if (score >= 90)
+            return 'CRITICAL';
+        if (score >= 80)
+            return 'HIGH';
+        if (score >= 70)
+            return 'MEDIUM';
+        return 'LOW';
+    }
+    /**
+     * Generate reason for hotspot
+     */
+    generateReason(churn, complexity, score) {
+        const reasons = [];
+        if (churn.commitCount > 20) {
+            reasons.push(`high change frequency (${churn.commitCount} commits)`);
+        }
+        if (churn.totalChurn > 500) {
+            reasons.push(`high churn (${churn.totalChurn} lines changed)`);
+        }
+        if (complexity.average > 10) {
+            reasons.push(`high average complexity (${complexity.average.toFixed(1)})`);
+        }
+        if (complexity.max > 20) {
+            reasons.push(`very complex functions (max: ${complexity.max})`);
+        }
+        if (churn.authors.length > 5) {
+            reasons.push(`many contributors (${churn.authors.length})`);
+        }
+        return `Hotspot (score: ${score}/100): ${reasons.join(', ')}`;
+    }
+    /**
+     * Generate recommendation
+     */
+    generateRecommendation(churn, complexity, severity) {
+        const recommendations = [];
+        if (complexity.max > 20) {
+            recommendations.push('Reduce complexity by breaking down complex functions');
+        }
+        if (churn.commitCount > 30) {
+            recommendations.push('Stabilize this file - consider refactoring to reduce change frequency');
+        }
+        if (churn.authors.length > 8) {
+            recommendations.push('Establish clear ownership and coding standards');
+        }
+        if (complexity.average > 15) {
+            recommendations.push('Simplify logic and improve code structure');
+        }
+        if (recommendations.length === 0) {
+            recommendations.push('Monitor this file for further changes and consider refactoring');
+        }
+        const prefix = severity === 'CRITICAL' || severity === 'HIGH'
+            ? 'URGENT: '
+            : severity === 'MEDIUM'
+                ? 'Important: '
+                : '';
+        return prefix + recommendations.join('. ') + '.';
+    }
+}
+//# sourceMappingURL=hotspot-detector.js.map