@defai.digital/ax-cli 4.4.6 → 4.4.10

package/dist/checkpoint/manager.js

@@ -1,407 +0,0 @@
-/**
- * Checkpoint Manager
- *
- * High-level API for checkpoint operations:
- * - Creating checkpoints
- * - Listing checkpoints
- * - Restoring checkpoints
- * - Pruning old checkpoints
- * - Automatic checkpoint scheduling
- */
-import crypto from 'crypto';
-import * as fs from 'fs/promises';
-import path from 'path';
-import { CheckpointStorage, calculateHash, verifyFileSnapshot } from './storage.js';
-import { validatePathSecure } from '../utils/path-security.js';
-import { DEFAULT_CHECKPOINT_CONFIG } from './types.js';
-import { extractErrorMessage } from '../utils/error-handler.js';
-export class CheckpointManager {
-    storage;
-    config;
-    maintenanceRunning = false; // CONCURRENCY FIX: Prevent concurrent maintenance
-    constructor(config, baseDir) {
-        this.config = { ...DEFAULT_CHECKPOINT_CONFIG, ...config };
-        // Use config.storageDir if provided, otherwise use baseDir parameter
-        const storageDir = this.config.storageDir || baseDir;
-        this.storage = new CheckpointStorage(storageDir);
-    }
-    async initialize() {
-        await this.storage.initialize();
-    }
-    /**
-     * Create a new checkpoint
-     */
-    async createCheckpoint(options) {
-        if (!this.config.enabled) {
-            throw new Error('Checkpoint system is disabled');
-        }
-        const checkpointId = crypto.randomUUID();
-        const timestamp = new Date();
-        // Create file snapshots
-        const fileSnapshots = [];
-        for (const file of options.files) {
-            const validation = await validatePathSecure(file.path).catch(() => ({ success: false }));
-            const safePath = validation.success && validation.path ? validation.path : path.resolve(file.path);
-            if (!validation.success) {
-                // Warn but continue so checkpoints can still be created for reporting; restoration will re-validate
-                console.warn(`Skipped path security validation for checkpoint file ${file.path}: ${'error' in validation ? validation.error : 'validation failed'}`);
-            }
-            const hash = calculateHash(file.content);
-            fileSnapshots.push({
-                path: safePath,
-                content: file.content,
-                hash,
-                size: Buffer.byteLength(file.content, 'utf-8'),
-            });
-        }
-        // Limit conversation depth
-        // INPUT VALIDATION FIX: Validate conversationState and conversationDepth
-        if (!options.conversationState) {
-            throw new Error('conversationState is required for checkpoint creation');
-        }
-        // Validate conversationDepth is positive
-        const depth = this.config.conversationDepth;
-        if (!depth || depth <= 0) {
-            throw new Error(`Invalid conversationDepth: ${depth}. Must be positive integer.`);
-        }
-        const conversationState = options.conversationState.slice(-depth);
-        // Generate default description if not provided
-        const defaultDescription = options.files.length > 0
-            ? `Before modifying ${options.files.length === 1 ? options.files[0].path : `${options.files.length} files`}`
-            : 'Auto-generated checkpoint';
-        const checkpoint = {
-            id: checkpointId,
-            timestamp,
-            description: options.description || defaultDescription,
-            files: fileSnapshots,
-            conversationState,
-            metadata: {
-                model: options.metadata?.model || 'unknown',
-                triggeredBy: options.metadata?.triggeredBy || 'manual',
-                ...options.metadata,
-            },
-        };
-        await this.storage.save(checkpoint);
-        // Run maintenance
-        await this.runMaintenance();
-        return checkpoint;
-    }
-    /**
-     * Restore a checkpoint
-     */
-    async restoreCheckpoint(checkpointId) {
-        const checkpoint = await this.storage.load(checkpointId);
-        if (!checkpoint) {
-            return {
-                success: false,
-                filesRestored: [],
-                filesFailed: [],
-                error: `Checkpoint ${checkpointId} not found`,
-            };
-        }
-        const filesRestored = [];
-        const filesFailed = [];
-        // Restore files
-        for (const snapshot of checkpoint.files) {
-            try {
-                // Verify file integrity before restoring
-                if (!verifyFileSnapshot(snapshot)) {
-                    filesFailed.push(snapshot.path);
-                    console.error(`Hash verification failed for ${snapshot.path}: checkpoint may be corrupted`);
-                    continue;
-                }
-                const validation = await validatePathSecure(snapshot.path);
-                if (!validation.success || !validation.path) {
-                    filesFailed.push(snapshot.path);
-                    console.warn(`Skipped restoring ${snapshot.path}: ${validation.error || 'path validation failed'}`);
-                    continue;
-                }
-                const safePath = validation.path;
-                // Ensure parent directory exists before writing
-                const parentDir = path.dirname(safePath);
-                await fs.mkdir(parentDir, { recursive: true });
-                await fs.writeFile(safePath, snapshot.content, 'utf-8');
-                filesRestored.push(safePath);
-            }
-            catch (error) {
-                filesFailed.push(snapshot.path);
-                console.error(`Failed to restore ${snapshot.path}: ${extractErrorMessage(error)}`);
-            }
-        }
-        return {
-            success: filesFailed.length === 0,
-            filesRestored,
-            filesFailed,
-            conversationIndex: checkpoint.conversationState.length,
-            error: filesFailed.length > 0
-                ? `Failed to restore ${filesFailed.length} file(s)`
-                : undefined,
-        };
-    }
-    /**
-     * Apply a checkpoint (restore files and return conversation state)
-     * Alias for restoreCheckpoint for backward compatibility
-     */
-    async applyCheckpoint(checkpointId) {
-        return await this.restoreCheckpoint(checkpointId);
-    }
-    /**
-     * List checkpoints with optional filtering
-     */
-    async listCheckpoints(filter) {
-        let checkpoints = await this.storage.listInfo();
-        // Apply filters
-        // Support both beforeDate/until (before this date, i.e., <=)
-        const beforeDate = filter?.beforeDate || filter?.until;
-        if (beforeDate) {
-            checkpoints = checkpoints.filter(c => c.timestamp <= beforeDate);
-        }
-        // Support both afterDate/since (after this date, i.e., >=)
-        const afterDate = filter?.afterDate || filter?.since;
-        if (afterDate) {
-            checkpoints = checkpoints.filter(c => c.timestamp >= afterDate);
-        }
-        if (filter?.filesChanged) {
-            const searchPaths = filter.filesChanged;
-            checkpoints = checkpoints.filter(c => searchPaths.some(searchPath => c.filesChanged.some(filePath => filePath.includes(searchPath))));
-        }
-        // Apply limit
-        if (filter?.limit) {
-            checkpoints = checkpoints.slice(0, filter.limit);
-        }
-        return checkpoints;
-    }
-    /**
-     * Get checkpoint by ID
-     */
-    async getCheckpoint(checkpointId) {
-        return await this.storage.load(checkpointId);
-    }
-    /**
-     * Get checkpoint info
-     */
-    async getCheckpointInfo(checkpointId) {
-        return await this.storage.getCheckpointInfo(checkpointId);
-    }
-    /**
-     * Delete a checkpoint
-     */
-    async deleteCheckpoint(checkpointId) {
-        await this.storage.delete(checkpointId);
-    }
-    /**
-     * Get checkpoint statistics
-     */
-    async getStats() {
-        return await this.storage.getStats();
-    }
-    /**
-     * Prune old checkpoints based on config
-     */
-    async pruneOldCheckpoints() {
-        if (!this.config.enabled) {
-            return 0;
-        }
-        // Validate pruneAfterDays is a positive finite number
-        const pruneAfterDays = this.config.pruneAfterDays;
-        if (!Number.isFinite(pruneAfterDays) || pruneAfterDays <= 0) {
-            console.warn(`Invalid pruneAfterDays config: ${pruneAfterDays}. Must be a positive number.`);
-            return 0;
-        }
-        const pruneDate = new Date();
-        pruneDate.setDate(pruneDate.getDate() - pruneAfterDays);
-        return await this.storage.pruneOlderThan(pruneDate);
-    }
-    /**
-     * Compress old checkpoints based on config
-     */
-    async compressOldCheckpoints() {
-        if (!this.config.enabled) {
-            return 0;
-        }
-        // Validate compressAfterDays is a positive finite number
-        const compressAfterDays = this.config.compressAfterDays;
-        if (!Number.isFinite(compressAfterDays) || compressAfterDays <= 0) {
-            console.warn(`Invalid compressAfterDays config: ${compressAfterDays}. Must be a positive number.`);
-            return 0;
-        }
-        const compressDate = new Date();
-        compressDate.setDate(compressDate.getDate() - compressAfterDays);
-        const checkpoints = await this.storage.listInfo();
-        let compressed = 0;
-        for (const checkpoint of checkpoints) {
-            if (checkpoint.timestamp < compressDate && !checkpoint.compressed) {
-                await this.storage.compress(checkpoint.id);
-                compressed++;
-            }
-        }
-        return compressed;
-    }
-    /**
-     * Run maintenance (pruning, compression, limit enforcement)
-     */
-    async runMaintenance() {
-        // Skip maintenance if checkpoints are disabled
-        if (!this.config.enabled) {
-            return;
-        }
-        // CONCURRENCY FIX: Prevent concurrent maintenance operations
-        if (this.maintenanceRunning) {
-            console.warn('Maintenance already running, skipping concurrent execution');
-            return; // Skip if already running
-        }
-        this.maintenanceRunning = true;
-        try {
-            // Compress old checkpoints - catch errors to continue with other stages
-            try {
-                await this.compressOldCheckpoints();
-            }
-            catch (error) {
-                console.error(`Failed to compress old checkpoints: ${extractErrorMessage(error)}`);
-            }
-            // Prune very old checkpoints - catch errors to continue with other stages
-            try {
-                await this.pruneOldCheckpoints();
-            }
-            catch (error) {
-                console.error(`Failed to prune old checkpoints: ${extractErrorMessage(error)}`);
-            }
-            // Enforce max checkpoints limit - catch errors to continue with other stages
-            try {
-                await this.enforceCheckpointLimit();
-            }
-            catch (error) {
-                console.error(`Failed to enforce checkpoint limit: ${extractErrorMessage(error)}`);
-            }
-            // Enforce storage limit - catch errors to continue with other stages
-            try {
-                await this.enforceStorageLimit();
-            }
-            catch (error) {
-                console.error(`Failed to enforce storage limit: ${extractErrorMessage(error)}`);
-            }
-        }
-        finally {
-            // Always reset flag, even if operations fail
-            this.maintenanceRunning = false;
-        }
-    }
-    /**
-     * Enforce maximum number of checkpoints
-     */
-    async enforceCheckpointLimit() {
-        // Validate maxCheckpoints is a positive finite number
-        const maxCheckpoints = this.config.maxCheckpoints;
-        if (!Number.isFinite(maxCheckpoints) || maxCheckpoints < 0) {
-            console.warn(`Invalid maxCheckpoints config: ${maxCheckpoints}. Must be a non-negative number.`);
-            return;
-        }
-        const checkpoints = await this.storage.listInfo();
-        const limit = Math.max(0, Math.floor(maxCheckpoints));
-        if (checkpoints.length > limit) {
-            const toDelete = checkpoints
-                .slice(limit)
-                .map(c => c.id);
-            for (const id of toDelete) {
-                await this.storage.delete(id);
-            }
-        }
-    }
-    /**
-     * Enforce storage size limit (in MB)
-     */
-    async enforceStorageLimit() {
-        const stats = await this.storage.getStats();
-        const limitBytes = this.config.storageLimit * 1024 * 1024;
-        if (stats.totalSize > limitBytes) {
-            const checkpoints = await this.storage.listInfo();
-            // Sort by timestamp ascending (oldest first) to ensure we delete oldest checkpoints first
-            // This prevents issues if the index is ever unsorted or corrupted
-            checkpoints.sort((a, b) => a.timestamp.getTime() - b.timestamp.getTime());
-            let currentSize = stats.totalSize;
-            // LOGIC FIX: Add safeguards against infinite loop
-            // Guard against infinite loop if checkpoint.size is 0, undefined, or corrupted
-            const MAX_ITERATIONS = checkpoints.length + 10; // Allow some margin
-            let iterations = 0;
-            // Delete oldest checkpoints (from start of sorted array) until under limit
-            for (let i = 0; i < checkpoints.length && currentSize > limitBytes; i++) {
-                // Safety: prevent infinite loop from corrupted data
-                if (++iterations > MAX_ITERATIONS) {
-                    console.error(`Storage limit enforcement exceeded ${MAX_ITERATIONS} iterations, aborting to prevent infinite loop`);
-                    break;
-                }
-                const checkpoint = checkpoints[i];
-                // Validate checkpoint.size before using it
-                if (!checkpoint.size || checkpoint.size <= 0) {
-                    console.warn(`Invalid checkpoint size for ${checkpoint.id} (size: ${checkpoint.size}), skipping deletion`);
-                    continue; // Skip this checkpoint, try next one
-                }
-                await this.storage.delete(checkpoint.id);
-                currentSize -= checkpoint.size;
-                // Safety: prevent negative size from arithmetic errors
-                if (currentSize < 0) {
-                    currentSize = 0;
-                }
-            }
-        }
-    }
-    /**
-     * Get conversation state from a checkpoint
-     */
-    async getConversationState(checkpointId) {
-        const checkpoint = await this.storage.load(checkpointId);
-        return checkpoint?.conversationState || null;
-    }
-    /**
-     * Check if checkpoint should be created before an operation
-     */
-    shouldCreateCheckpoint(operation) {
-        return (this.config.enabled &&
-            this.config.createBeforeOperations.includes(operation));
-    }
-    /**
-     * Update configuration
-     * Note: storageDir changes are rejected as they require re-initialization
-     */
-    updateConfig(config) {
-        // Reject storageDir changes - would require re-initializing storage
-        if (config.storageDir && config.storageDir !== this.config.storageDir) {
-            console.warn(`Cannot change storageDir at runtime. Current: ${this.config.storageDir}, requested: ${config.storageDir}. Use initCheckpointManager() to change storage location.`);
-            const { storageDir: _ignored, ...safeConfig } = config;
-            this.config = { ...this.config, ...safeConfig };
-            return;
-        }
-        this.config = { ...this.config, ...config };
-    }
-    /**
-     * Get current configuration
-     */
-    getConfig() {
-        return { ...this.config };
-    }
-}
-// Singleton instance
-let checkpointManagerInstance = null;
-/**
- * Get the singleton checkpoint manager instance
- */
-export function getCheckpointManager(config, baseDir) {
-    if (!checkpointManagerInstance) {
-        checkpointManagerInstance = new CheckpointManager(config, baseDir);
-    }
-    return checkpointManagerInstance;
-}
-/**
- * Initialize a new checkpoint manager instance (creates new singleton)
- */
-export function initCheckpointManager(config, baseDir) {
-    checkpointManagerInstance = new CheckpointManager(config, baseDir);
-    return checkpointManagerInstance;
-}
-/**
- * Reset the singleton instance (for testing)
- */
-export function resetCheckpointManager() {
-    checkpointManagerInstance = null;
-}
-//# sourceMappingURL=manager.js.map

package/dist/checkpoint/manager.js.map

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

package/dist/checkpoint/storage.d.ts

@@ -1,39 +0,0 @@
-/**
- * Checkpoint Storage Layer
- */
-import type { Checkpoint, CheckpointInfo, CheckpointStats, FileSnapshot } from './types.js';
-export declare class CheckpointStorage {
-    private storageDir;
-    private indexPath;
-    private index;
-    /** Lock to prevent concurrent index operations */
-    private indexLock;
-    /** Serialize mutations to index to avoid lost updates */
-    private mutationLock;
-    constructor(baseDir?: string);
-    /**
-     * Ensure only one mutation updates the index at a time
-     */
-    private withMutationLock;
-    initialize(): Promise<void>;
-    save(checkpoint: Checkpoint): Promise<void>;
-    load(checkpointId: string): Promise<Checkpoint | null>;
-    delete(checkpointId: string): Promise<void>;
-    compress(checkpointId: string): Promise<void>;
-    getStats(): Promise<CheckpointStats>;
-    listInfo(): Promise<CheckpointInfo[]>;
-    list(): Promise<string[]>;
-    getCheckpointInfo(checkpointId: string): Promise<CheckpointInfo | null>;
-    getTotalSize(): Promise<number>;
-    private loadIndex;
-    private saveIndex;
-    private addToIndex;
-    private removeFromIndex;
-    private updateCompressionStatus;
-    private updateStats;
-    private getDateDir;
-    private findCheckpointFile;
-    pruneOlderThan(date: Date): Promise<number>;
-}
-export declare function calculateHash(content: string): string;
-export declare function verifyFileSnapshot(snapshot: FileSnapshot): boolean;