@defai.digital/ax-cli 4.4.7 → 4.4.10

package/dist/utils/file-cache.js

@@ -1,413 +0,0 @@
-/**
- * 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';
-import { homedir } from 'os';
-import { CONFIG_DIR_NAME } from '../constants.js';
-/**
- * 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 = homedir();
-        this.config = {
-            cacheDir: config.cacheDir || join(homeDir, CONFIG_DIR_NAME, '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();
-    }
-    /**
-     * Calculate total size of all cached entries
-     */
-    calculateTotalSize() {
-        let total = 0;
-        for (const entry of this.cache.values()) {
-            total += entry.size;
-        }
-        return total;
-    }
-    /**
-     * 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 {
-            // Fast checks first (no I/O)
-            if (cached.version !== this.metadata.version)
-                return false;
-            if (Date.now() - cached.cachedAt > this.config.ttl)
-                return false;
-            // Check tool version - invalidate on tool upgrades
-            if (this.metadata.toolVersion && this.config.toolVersion !== this.metadata.toolVersion) {
-                return false;
-            }
-            // File existence check (minimal I/O)
-            if (!existsSync(filePath))
-                return false;
-            // Fast I/O 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 (only if fast checks pass)
-            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;
-                // BUG FIX: Validate line length before parsing git status output
-                // Git status format: "XY filename" where XY is 2-char status code
-                if (line.length < 4)
-                    continue; // Minimum: "X  f" (status + space + 1 char filename)
-                // Parse git status output
-                const status = line.substring(0, 2);
-                const filePath = line.substring(3).trim(); // BUG FIX: trim to handle extra spaces
-                // BUG FIX: Skip if filePath is empty (edge case protection)
-                if (!filePath)
-                    continue;
-                // 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();
-        this.metadata.totalSize = this.calculateTotalSize();
-        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
-        const totalSize = this.calculateTotalSize();
-        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;
-        this.stats.cacheSize = this.calculateTotalSize();
-        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

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

package/dist/utils/file-lock.d.ts

@@ -1,141 +0,0 @@
-/**
- * File Locking Utility - Cross-process file locking for concurrent access
- *
- * This module provides file-level locking to prevent race conditions when
- * multiple ax-glm and ax-grok instances access the same files.
- *
- * Features:
- * - Cross-process locking using lock files
- * - Automatic stale lock cleanup
- * - Configurable timeouts
- * - Read/write lock semantics
- * - Safe atomic operations
- *
- * @example
- * ```typescript
- * // Exclusive lock for writes
- * await withFileLock('/path/to/file.json', async () => {
- *   const data = JSON.parse(fs.readFileSync('/path/to/file.json', 'utf-8'));
- *   data.count++;
- *   fs.writeFileSync('/path/to/file.json', JSON.stringify(data));
- * });
- *
- * // Read lock (shared)
- * const data = await withFileLock('/path/to/file.json', async () => {
- *   return JSON.parse(fs.readFileSync('/path/to/file.json', 'utf-8'));
- * }, { type: 'read' });
- * ```
- */
-/**
- * Lock types
- */
-export type LockType = 'read' | 'write';
-/**
- * Lock options
- */
-export interface LockOptions {
-    /** Lock type (default: 'write') */
-    type?: LockType;
-    /** Maximum time to wait for lock in ms (default: 10000) */
-    timeout?: number;
-    /** Time between lock attempts in ms (default: 50) */
-    retryInterval?: number;
-    /** Maximum age of lock file before considered stale in ms (default: 30000) */
-    staleThreshold?: number;
-    /** Whether to throw on timeout (default: true) */
-    throwOnTimeout?: boolean;
-}
-/**
- * Get the lock file path for a given file
- */
-export declare function getLockPath(filePath: string): string;
-/**
- * Acquire a file lock with retry
- */
-export declare function acquireLock(filePath: string, options?: LockOptions): Promise<boolean>;
-/**
- * Acquire a file lock synchronously (blocking)
- */
-export declare function acquireLockSync(filePath: string, options?: LockOptions): boolean;
-/**
- * Execute a function with an exclusive file lock
- *
- * @example
- * ```typescript
- * await withFileLock('/path/to/config.json', async () => {
- *   const config = JSON.parse(fs.readFileSync('/path/to/config.json', 'utf-8'));
- *   config.lastAccess = Date.now();
- *   fs.writeFileSync('/path/to/config.json', JSON.stringify(config));
- * });
- * ```
- */
-export declare function withFileLock<T>(filePath: string, fn: () => T | Promise<T>, options?: LockOptions): Promise<T>;
-/**
- * Execute a function with an exclusive file lock (synchronous)
- */
-export declare function withFileLockSync<T>(filePath: string, fn: () => T, options?: LockOptions): T;
-/**
- * Lock guard class for manual lock management
- *
- * @example
- * ```typescript
- * const guard = await LockGuard.acquire('/path/to/file');
- * try {
- *   // ... do work ...
- * } finally {
- *   guard.release();
- * }
- * ```
- */
-export declare class LockGuard {
-    readonly filePath: string;
-    readonly type: LockType;
-    private released;
-    private constructor();
-    /**
-     * Acquire a lock and return a guard
-     */
-    static acquire(filePath: string, options?: LockOptions): Promise<LockGuard>;
-    /**
-     * Acquire a lock synchronously and return a guard
-     */
-    static acquireSync(filePath: string, options?: LockOptions): LockGuard;
-    /**
-     * Release the lock
-     */
-    release(): void;
-    /**
-     * Check if lock has been released
-     */
-    get isReleased(): boolean;
-}
-/**
- * Safe JSON file operations with locking
- */
-export declare const SafeJsonFile: {
-    /**
-     * Read a JSON file with lock protection
-     */
-    read<T>(filePath: string, options?: LockOptions): Promise<T | null>;
-    /**
-     * Write a JSON file with lock protection
-     */
-    write<T>(filePath: string, data: T, options?: LockOptions): Promise<void>;
-    /**
-     * Update a JSON file with lock protection
-     * Reads, modifies, and writes atomically
-     */
-    update<T>(filePath: string, updater: (current: T | null) => T, options?: LockOptions): Promise<T>;
-    /**
-     * Synchronous read with lock
-     */
-    readSync<T>(filePath: string, options?: LockOptions): T | null;
-    /**
-     * Synchronous write with lock
-     */
-    writeSync<T>(filePath: string, data: T, options?: LockOptions): void;
-};
-/**
- * Clean up any stale lock files in a directory
- */
-export declare function cleanupStaleLocks(directory: string, staleThreshold?: number): number;