@defai.digital/ax-cli 2.5.2 → 2.6.4

package/dist/utils/file-cache.js

@@ -0,0 +1,412 @@
+/**
+ * File Cache System for Analysis Results
+ *
+ * Implements intelligent caching to avoid re-analyzing unchanged files:
+ * - Multi-level change detection (mtime, size, hash)
+ * - Automatic cache invalidation
+ * - Git integration for change detection
+ * - Configurable TTL and size limits
+ *
+ * Best practices:
+ * - Uses SHA-256 for content hashing
+ * - Stores cache in user directory (~/.ax-cli/cache/)
+ * - Includes cache versioning for schema changes
+ * - Provides statistics and cache management
+ */
+import { createHash } from 'crypto';
+import { readFile, writeFile, mkdir, stat } from 'fs/promises';
+import { join, relative } from 'path';
+import { existsSync } from 'fs';
+import { execSync } from 'child_process';
+/**
+ * File Cache Manager
+ *
+ * Provides intelligent file caching with multiple change detection strategies
+ */
+export class FileCache {
+    config;
+    cache = new Map();
+    metadata;
+    stats = {
+        hits: 0,
+        misses: 0,
+        invalidations: 0,
+        totalEntries: 0,
+        cacheSize: 0,
+        hitRate: 0,
+    };
+    gitChangedFiles;
+    cacheLoaded = false;
+    cacheDirty = false;
+    constructor(config = {}) {
+        // Default configuration
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '/tmp';
+        this.config = {
+            cacheDir: config.cacheDir || join(homeDir, '.ax-cli', 'cache'),
+            namespace: config.namespace || 'default',
+            ttl: config.ttl || 7 * 24 * 60 * 60 * 1000, // 7 days
+            maxEntries: config.maxEntries || 10000,
+            maxSize: config.maxSize || 100 * 1024 * 1024, // 100MB
+            useGit: config.useGit !== false,
+            toolVersion: config.toolVersion || '1.0.0',
+        };
+        this.metadata = {
+            version: 1,
+            createdAt: Date.now(),
+            lastAccessedAt: Date.now(),
+            toolVersion: this.config.toolVersion,
+            totalEntries: 0,
+            totalSize: 0,
+        };
+    }
+    /**
+     * Initialize cache (load from disk)
+     */
+    async init() {
+        if (this.cacheLoaded)
+            return;
+        // Ensure cache directory exists
+        await mkdir(this.config.cacheDir, { recursive: true });
+        // Load cache from disk
+        await this.loadCache();
+        // Load git changed files if enabled
+        if (this.config.useGit) {
+            this.gitChangedFiles = await this.getGitChangedFiles();
+        }
+        this.cacheLoaded = true;
+    }
+    /**
+     * Get cached result for a file, or compute if not cached/invalid
+     */
+    async get(filePath, computer) {
+        await this.init();
+        const relativePath = this.getRelativePath(filePath);
+        // Check if file has changed via git (fast check)
+        if (this.gitChangedFiles && this.gitChangedFiles.has(relativePath)) {
+            this.stats.misses++;
+            return this.computeAndCache(filePath, computer);
+        }
+        // Check cache
+        const cached = this.cache.get(relativePath);
+        if (!cached) {
+            this.stats.misses++;
+            return this.computeAndCache(filePath, computer);
+        }
+        // Validate cache entry
+        const isValid = await this.isCacheValid(filePath, cached);
+        if (!isValid) {
+            this.stats.invalidations++;
+            this.stats.misses++;
+            return this.computeAndCache(filePath, computer);
+        }
+        // Cache hit!
+        this.stats.hits++;
+        this.updateStats();
+        return cached.result;
+    }
+    /**
+     * Set cache entry directly
+     */
+    async set(filePath, result) {
+        await this.init();
+        const relativePath = this.getRelativePath(filePath);
+        const fileStat = await stat(filePath);
+        const hash = await this.hashFile(filePath);
+        const entry = {
+            path: relativePath,
+            mtime: fileStat.mtimeMs,
+            size: fileStat.size,
+            hash,
+            result,
+            cachedAt: Date.now(),
+            version: this.metadata.version,
+        };
+        this.cache.set(relativePath, entry);
+        this.cacheDirty = true;
+        // Enforce limits
+        await this.enforceLimits();
+        // Update stats
+        this.updateStats();
+    }
+    /**
+     * Check if a file has changed
+     */
+    async hasChanged(filePath) {
+        await this.init();
+        const relativePath = this.getRelativePath(filePath);
+        // Git check (fastest)
+        if (this.gitChangedFiles && this.gitChangedFiles.has(relativePath)) {
+            return true;
+        }
+        const cached = this.cache.get(relativePath);
+        if (!cached)
+            return true;
+        return !(await this.isCacheValid(filePath, cached));
+    }
+    /**
+     * Invalidate cache for a specific file
+     */
+    invalidate(filePath) {
+        const relativePath = this.getRelativePath(filePath);
+        const deleted = this.cache.delete(relativePath);
+        if (deleted) {
+            this.stats.invalidations++;
+            this.cacheDirty = true;
+        }
+    }
+    /**
+     * Clear entire cache
+     */
+    async clear() {
+        this.cache.clear();
+        this.stats = {
+            hits: 0,
+            misses: 0,
+            invalidations: 0,
+            totalEntries: 0,
+            cacheSize: 0,
+            hitRate: 0,
+        };
+        this.cacheDirty = true;
+        await this.saveCache();
+    }
+    /**
+     * Save cache to disk
+     */
+    async save() {
+        if (!this.cacheDirty)
+            return;
+        await this.saveCache();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Get cache metadata
+     */
+    getMetadata() {
+        return { ...this.metadata };
+    }
+    /**
+     * Prune expired entries
+     */
+    async prune() {
+        const now = Date.now();
+        let pruned = 0;
+        for (const [path, entry] of this.cache.entries()) {
+            if (now - entry.cachedAt > this.config.ttl) {
+                this.cache.delete(path);
+                pruned++;
+            }
+        }
+        if (pruned > 0) {
+            this.cacheDirty = true;
+            this.updateStats();
+            await this.saveCache();
+        }
+        return pruned;
+    }
+    // Private methods
+    async computeAndCache(filePath, computer) {
+        const result = await computer(filePath);
+        await this.set(filePath, result);
+        return result;
+    }
+    async isCacheValid(filePath, cached) {
+        try {
+            // Check if file exists
+            if (!existsSync(filePath)) {
+                return false;
+            }
+            // Check version compatibility
+            if (cached.version !== this.metadata.version) {
+                return false;
+            }
+            // Check tool version
+            if (cached.version === 1 && this.config.toolVersion !== this.metadata.toolVersion) {
+                return false;
+            }
+            // Check TTL
+            if (Date.now() - cached.cachedAt > this.config.ttl) {
+                return false;
+            }
+            // Fast checks: mtime and size
+            const fileStat = await stat(filePath);
+            if (fileStat.mtimeMs !== cached.mtime) {
+                return false;
+            }
+            if (fileStat.size !== cached.size) {
+                return false;
+            }
+            // Slow but accurate: content hash
+            const currentHash = await this.hashFile(filePath);
+            return currentHash === cached.hash;
+        }
+        catch {
+            return false;
+        }
+    }
+    async hashFile(filePath) {
+        const content = await readFile(filePath);
+        return createHash('sha256').update(content).digest('hex');
+    }
+    getRelativePath(filePath) {
+        const cwd = process.cwd();
+        return relative(cwd, filePath);
+    }
+    async getGitChangedFiles() {
+        try {
+            // Check if we're in a git repo
+            execSync('git rev-parse --git-dir', {
+                stdio: 'ignore',
+                cwd: process.cwd(),
+            });
+            // Get changed files (modified, added, untracked)
+            const output = execSync('git status --porcelain --untracked-files=all', {
+                encoding: 'utf-8',
+                cwd: process.cwd(),
+            });
+            const changedFiles = new Set();
+            for (const line of output.split('\n')) {
+                if (!line.trim())
+                    continue;
+                // Parse git status output
+                const status = line.substring(0, 2);
+                const filePath = line.substring(3);
+                // Include modified, added, deleted, renamed, untracked files
+                if (status.trim()) {
+                    changedFiles.add(filePath);
+                }
+            }
+            return changedFiles;
+        }
+        catch {
+            // Not a git repo or git not available
+            return undefined;
+        }
+    }
+    getCacheFilePath() {
+        return join(this.config.cacheDir, `${this.config.namespace}.json`);
+    }
+    async loadCache() {
+        const cacheFile = this.getCacheFilePath();
+        if (!existsSync(cacheFile)) {
+            return;
+        }
+        try {
+            const content = await readFile(cacheFile, 'utf-8');
+            const data = JSON.parse(content);
+            // Load metadata
+            if (data.metadata) {
+                this.metadata = data.metadata;
+                this.metadata.lastAccessedAt = Date.now();
+            }
+            // Load entries
+            if (data.entries && Array.isArray(data.entries)) {
+                for (const entry of data.entries) {
+                    this.cache.set(entry.path, entry);
+                }
+            }
+            // Update stats
+            this.stats.totalEntries = this.cache.size;
+            this.updateStats();
+        }
+        catch (error) {
+            // Cache corrupted, start fresh
+            console.warn(`Cache corrupted, starting fresh: ${error}`);
+        }
+    }
+    async saveCache() {
+        const cacheFile = this.getCacheFilePath();
+        // Update metadata
+        this.metadata.totalEntries = this.cache.size;
+        this.metadata.lastAccessedAt = Date.now();
+        // Calculate total size
+        let totalSize = 0;
+        for (const entry of this.cache.values()) {
+            totalSize += entry.size;
+        }
+        this.metadata.totalSize = totalSize;
+        const data = {
+            metadata: this.metadata,
+            entries: Array.from(this.cache.values()),
+        };
+        await writeFile(cacheFile, JSON.stringify(data, null, 2));
+        this.cacheDirty = false;
+    }
+    async enforceLimits() {
+        // Enforce max entries
+        if (this.cache.size > this.config.maxEntries) {
+            // Remove oldest entries
+            const entries = Array.from(this.cache.entries());
+            entries.sort((a, b) => a[1].cachedAt - b[1].cachedAt);
+            const toRemove = entries.slice(0, entries.length - this.config.maxEntries);
+            for (const [path] of toRemove) {
+                this.cache.delete(path);
+            }
+        }
+        // Enforce max size
+        let totalSize = 0;
+        for (const entry of this.cache.values()) {
+            totalSize += entry.size;
+        }
+        if (totalSize > this.config.maxSize) {
+            // Remove oldest entries until under limit
+            const entries = Array.from(this.cache.entries());
+            entries.sort((a, b) => a[1].cachedAt - b[1].cachedAt);
+            let currentSize = totalSize;
+            for (const [path, entry] of entries) {
+                if (currentSize <= this.config.maxSize)
+                    break;
+                this.cache.delete(path);
+                currentSize -= entry.size;
+            }
+        }
+    }
+    updateStats() {
+        this.stats.totalEntries = this.cache.size;
+        let totalSize = 0;
+        for (const entry of this.cache.values()) {
+            totalSize += entry.size;
+        }
+        this.stats.cacheSize = totalSize;
+        const total = this.stats.hits + this.stats.misses;
+        this.stats.hitRate = total > 0 ? this.stats.hits / total : 0;
+    }
+}
+/**
+ * Create a file cache instance
+ */
+export function createFileCache(config) {
+    return new FileCache(config);
+}
+/**
+ * Global cache instances by namespace
+ */
+const cacheInstances = new Map();
+/**
+ * Get or create a cache instance for a namespace
+ */
+export function getFileCache(namespace, config) {
+    if (!cacheInstances.has(namespace)) {
+        cacheInstances.set(namespace, new FileCache({ ...config, namespace }));
+    }
+    return cacheInstances.get(namespace);
+}
+/**
+ * Save all cache instances
+ */
+export async function saveAllCaches() {
+    await Promise.all(Array.from(cacheInstances.values()).map(cache => cache.save()));
+}
+/**
+ * Clear all cache instances
+ */
+export async function clearAllCaches() {
+    await Promise.all(Array.from(cacheInstances.values()).map(cache => cache.clear()));
+    cacheInstances.clear();
+}
+//# sourceMappingURL=file-cache.js.map

package/dist/utils/file-cache.js.map

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

package/dist/utils/incremental-analyzer.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Incremental Analyzer
+ *
+ * Analyzes only changed files and their dependencies using git integration.
+ * Provides 10-50x speedup by avoiding analysis of unchanged files.
+ *
+ * Quick Win #2: Git-Based Incremental Analysis (Est. time: 1 hour)
+ * Impact: 10-50x reduction in files to analyze
+ */
+/**
+ * Configuration for incremental analysis
+ */
+export interface IncrementalConfig {
+    /** Base directory for git operations (default: cwd) */
+    baseDir?: string;
+    /** File patterns to include (default: all) */
+    include?: string[];
+    /** File patterns to exclude (default: none) */
+    exclude?: string[];
+    /** Compare against specific commit/branch (default: HEAD) */
+    compareWith?: string;
+    /** Include untracked files (default: true) */
+    includeUntracked?: boolean;
+    /** Build dependency graph (default: false, for future use) */
+    trackDependencies?: boolean;
+}
+/**
+ * Changed file info
+ */
+export interface ChangedFile {
+    /** File path relative to base directory */
+    path: string;
+    /** Type of change */
+    status: 'modified' | 'added' | 'deleted' | 'renamed' | 'untracked';
+    /** Previous path (for renamed files) */
+    oldPath?: string;
+}
+/**
+ * Result of incremental analysis
+ */
+export interface IncrementalResult {
+    /** Files that need analysis */
+    filesToAnalyze: string[];
+    /** Files that are cached */
+    cachedFiles: string[];
+    /** Changed files detected */
+    changedFiles: ChangedFile[];
+    /** Total files in project */
+    totalFiles: number;
+    /** Estimated speedup */
+    speedup: number;
+}
+/**
+ * Check if directory is a git repository
+ */
+export declare function isGitRepo(dir?: string): boolean;
+/**
+ * Get changed files from git
+ *
+ * @param config - Configuration options
+ * @returns Array of changed files
+ *
+ * @example
+ * ```typescript
+ * const changed = await getChangedFiles({
+ *   compareWith: 'main',
+ *   include: ['*.ts', '*.tsx'],
+ * });
+ *
+ * console.log(`${changed.length} files changed`);
+ * ```
+ */
+export declare function getChangedFiles(config?: IncrementalConfig): Promise<ChangedFile[]>;
+/**
+ * Get files to analyze incrementally
+ *
+ * Returns only files that need analysis based on git changes.
+ *
+ * @param allFiles - All files in project
+ * @param config - Configuration options
+ * @returns Incremental analysis result
+ *
+ * @example
+ * ```typescript
+ * const allFiles = await glob('src/** /*.ts');
+ * const result = await getFilesToAnalyze(allFiles);
+ *
+ * console.log(`Analyzing ${result.filesToAnalyze.length} of ${result.totalFiles} files`);
+ * console.log(`Speedup: ${result.speedup.toFixed(1)}x`);
+ * ```
+ */
+export declare function getFilesToAnalyze(allFiles: string[], config?: IncrementalConfig): Promise<IncrementalResult>;
+/**
+ * Get git repository info
+ *
+ * @param baseDir - Base directory (default: cwd)
+ * @returns Repository information
+ */
+export declare function getGitInfo(baseDir?: string): {
+    branch: string;
+    commit: string;
+    isDirty: boolean;
+    ahead: number;
+    behind: number;
+} | null;
+/**
+ * Simple dependency tracker (for future use)
+ *
+ * Parses import/require statements to build a dependency graph.
+ */
+export declare class DependencyTracker {
+    private graph;
+    private reverseGraph;
+    /**
+     * Add a file and its dependencies
+     */
+    addFile(filePath: string): Promise<void>;
+    /**
+     * Get files that depend on the given file
+     */
+    getDependents(filePath: string): string[];
+    /**
+     * Get all affected files (transitive dependencies)
+     */
+    getAffectedFiles(changedFiles: string[]): string[];
+    /**
+     * Parse import statements from file content
+     */
+    private parseImports;
+    /**
+     * Resolve import path to absolute path
+     */
+    private resolveImport;
+}