dartmind 17.0.0

package/dist/state/CheckpointManager.js

@@ -0,0 +1,294 @@
+/**
+ * CheckpointManager - Save and restore project state
+ *
+ * Features:
+ * - Create checkpoints before risky operations
+ * - Restore to any checkpoint
+ * - Auto-checkpoint on file changes
+ * - Checkpoint cleanup and retention
+ */
+import { EventEmitter } from 'events';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { createHash } from 'crypto';
+import { secureRandomString } from '../utils/random.js';
+export class CheckpointManager extends EventEmitter {
+    static instance;
+    checkpoints = new Map();
+    config;
+    currentCheckpointId = null;
+    constructor(config) {
+        super();
+        this.config = {
+            maxCheckpoints: 50,
+            autoCheckpoint: true,
+            checkpointDir: '.flutterai/checkpoints',
+            retentionHours: 24,
+            ...config,
+        };
+    }
+    static getInstance(config) {
+        if (!CheckpointManager.instance) {
+            CheckpointManager.instance = new CheckpointManager(config);
+        }
+        return CheckpointManager.instance;
+    }
+    /**
+     * Create a checkpoint from specified files
+     */
+    async createCheckpoint(name, filePaths, description = '', metadata = {}) {
+        const id = this.generateCheckpointId();
+        const files = [];
+        for (const filePath of filePaths) {
+            const snapshot = await this.snapshotFile(filePath);
+            files.push(snapshot);
+        }
+        const checkpoint = {
+            id,
+            name,
+            description,
+            timestamp: Date.now(),
+            files,
+            metadata,
+        };
+        this.checkpoints.set(id, checkpoint);
+        this.currentCheckpointId = id;
+        // Enforce max checkpoints
+        await this.enforceRetention();
+        this.emit('checkpoint:created', checkpoint);
+        return checkpoint;
+    }
+    /**
+     * Create a quick checkpoint with auto-generated name
+     */
+    async quickCheckpoint(filePaths, reason = 'auto') {
+        const name = `${reason}-${Date.now()}`;
+        return this.createCheckpoint(name, filePaths, `Auto checkpoint: ${reason}`);
+    }
+    /**
+     * Restore files from a checkpoint
+     */
+    async restoreCheckpoint(checkpointId) {
+        const checkpoint = this.checkpoints.get(checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint not found: ${checkpointId}`);
+        }
+        const restored = [];
+        const errors = [];
+        for (const snapshot of checkpoint.files) {
+            try {
+                await this.restoreFile(snapshot);
+                restored.push(snapshot.path);
+            }
+            catch (error) {
+                errors.push(`${snapshot.path}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+        }
+        this.emit('checkpoint:restored', { checkpoint, restored, errors });
+        return { restored, errors };
+    }
+    /**
+     * Restore a single file from a checkpoint
+     */
+    async restoreFile(snapshot) {
+        const dirPath = path.dirname(snapshot.path);
+        if (snapshot.exists) {
+            // Ensure directory exists
+            await fs.mkdir(dirPath, { recursive: true });
+            await fs.writeFile(snapshot.path, snapshot.content, 'utf-8');
+        }
+        else {
+            // File didn't exist at checkpoint time - delete if it exists now
+            try {
+                await fs.unlink(snapshot.path);
+            }
+            catch {
+                // File doesn't exist, that's fine
+            }
+        }
+    }
+    /**
+     * Snapshot a single file
+     */
+    async snapshotFile(filePath) {
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const hash = createHash('sha256').update(content).digest('hex').slice(0, 16);
+            return {
+                path: filePath,
+                content,
+                hash,
+                exists: true,
+                timestamp: Date.now(),
+            };
+        }
+        catch (error) {
+            // File doesn't exist
+            return {
+                path: filePath,
+                content: '',
+                hash: '',
+                exists: false,
+                timestamp: Date.now(),
+            };
+        }
+    }
+    /**
+     * Get a checkpoint by ID
+     */
+    getCheckpoint(checkpointId) {
+        return this.checkpoints.get(checkpointId);
+    }
+    /**
+     * Get all checkpoints
+     */
+    getAllCheckpoints() {
+        return Array.from(this.checkpoints.values())
+            .sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * Get recent checkpoints
+     */
+    getRecentCheckpoints(limit = 10) {
+        return this.getAllCheckpoints().slice(0, limit);
+    }
+    /**
+     * Delete a checkpoint
+     */
+    deleteCheckpoint(checkpointId) {
+        const checkpoint = this.checkpoints.get(checkpointId);
+        if (checkpoint) {
+            this.checkpoints.delete(checkpointId);
+            this.emit('checkpoint:deleted', checkpoint);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get current checkpoint ID
+     */
+    getCurrentCheckpointId() {
+        return this.currentCheckpointId;
+    }
+    /**
+     * Compare a file with its checkpoint version
+     */
+    async compareWithCheckpoint(checkpointId, filePath) {
+        const checkpoint = this.checkpoints.get(checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint not found: ${checkpointId}`);
+        }
+        const snapshot = checkpoint.files.find(f => f.path === filePath);
+        if (!snapshot) {
+            throw new Error(`File not in checkpoint: ${filePath}`);
+        }
+        const currentSnapshot = await this.snapshotFile(filePath);
+        return {
+            hasChanged: currentSnapshot.hash !== snapshot.hash,
+            currentHash: currentSnapshot.hash,
+            checkpointHash: snapshot.hash,
+        };
+    }
+    /**
+     * Get files changed since a checkpoint
+     */
+    async getChangedFiles(checkpointId) {
+        const checkpoint = this.checkpoints.get(checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint not found: ${checkpointId}`);
+        }
+        const changed = [];
+        for (const snapshot of checkpoint.files) {
+            const comparison = await this.compareWithCheckpoint(checkpointId, snapshot.path);
+            if (comparison.hasChanged) {
+                changed.push(snapshot.path);
+            }
+        }
+        return changed;
+    }
+    /**
+     * Save checkpoints to disk
+     */
+    async persistCheckpoints() {
+        const checkpointDir = this.config.checkpointDir;
+        await fs.mkdir(checkpointDir, { recursive: true });
+        const data = {
+            version: 1,
+            checkpoints: Array.from(this.checkpoints.values()),
+        };
+        const filePath = path.join(checkpointDir, 'checkpoints.json');
+        await fs.writeFile(filePath, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    /**
+     * Load checkpoints from disk
+     */
+    async loadCheckpoints() {
+        const filePath = path.join(this.config.checkpointDir, 'checkpoints.json');
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const data = JSON.parse(content);
+            if (data.version === 1 && Array.isArray(data.checkpoints)) {
+                this.checkpoints.clear();
+                for (const checkpoint of data.checkpoints) {
+                    this.checkpoints.set(checkpoint.id, checkpoint);
+                }
+            }
+        }
+        catch {
+            // No saved checkpoints or invalid format
+        }
+    }
+    /**
+     * Enforce checkpoint retention policy
+     */
+    async enforceRetention() {
+        const checkpoints = this.getAllCheckpoints();
+        // Remove checkpoints beyond max limit
+        if (checkpoints.length > this.config.maxCheckpoints) {
+            const toRemove = checkpoints.slice(this.config.maxCheckpoints);
+            for (const checkpoint of toRemove) {
+                this.checkpoints.delete(checkpoint.id);
+            }
+        }
+        // Remove checkpoints older than retention period
+        const cutoffTime = Date.now() - (this.config.retentionHours * 60 * 60 * 1000);
+        for (const checkpoint of this.checkpoints.values()) {
+            if (checkpoint.timestamp < cutoffTime) {
+                this.checkpoints.delete(checkpoint.id);
+            }
+        }
+    }
+    /**
+     * Clear all checkpoints
+     */
+    clearAll() {
+        this.checkpoints.clear();
+        this.currentCheckpointId = null;
+        this.emit('checkpoints:cleared');
+    }
+    /**
+     * Generate unique checkpoint ID
+     */
+    generateCheckpointId() {
+        const timestamp = Date.now().toString(36);
+        const random = secureRandomString(6);
+        return `cp-${timestamp}-${random}`;
+    }
+    /**
+     * Get checkpoint stats
+     */
+    getStats() {
+        const checkpoints = this.getAllCheckpoints();
+        const totalFiles = checkpoints.reduce((sum, cp) => sum + cp.files.length, 0);
+        return {
+            totalCheckpoints: checkpoints.length,
+            totalFiles,
+            oldestCheckpoint: checkpoints.length > 0 ? checkpoints[checkpoints.length - 1].timestamp : null,
+            newestCheckpoint: checkpoints.length > 0 ? checkpoints[0].timestamp : null,
+        };
+    }
+}
+// Export singleton getter
+export const getCheckpointManager = CheckpointManager.getInstance;
+export default CheckpointManager;
+//# sourceMappingURL=CheckpointManager.js.map

package/dist/state/CheckpointManager.js.map

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

package/dist/state/FileTracker.d.ts

@@ -0,0 +1,155 @@
+/**
+ * FileTracker - Track all file operations
+ *
+ * Features:
+ * - Track file reads, writes, deletes
+ * - Monitor file changes
+ * - Detect external modifications
+ * - File operation history
+ */
+import { EventEmitter } from 'events';
+export type FileOperationType = 'read' | 'write' | 'create' | 'delete' | 'rename';
+export interface TrackedFile {
+    path: string;
+    hash: string;
+    size: number;
+    lastRead: number | null;
+    lastWrite: number | null;
+    readCount: number;
+    writeCount: number;
+    isNew: boolean;
+    isDeleted: boolean;
+    externallyModified: boolean;
+}
+export interface FileOperationLog {
+    id: string;
+    type: FileOperationType;
+    path: string;
+    timestamp: number;
+    hash?: string;
+    size?: number;
+    success: boolean;
+    error?: string;
+}
+export interface FileTrackerConfig {
+    watchForExternalChanges: boolean;
+    hashAlgorithm: 'md5' | 'sha256';
+    maxTrackedFiles: number;
+    maxOperationLogs: number;
+}
+export declare class FileTracker extends EventEmitter {
+    private static instance;
+    private trackedFiles;
+    private operationLogs;
+    private config;
+    private watchedDirectories;
+    private constructor();
+    static getInstance(config?: Partial<FileTrackerConfig>): FileTracker;
+    /**
+     * Track a file read operation
+     */
+    trackRead(filePath: string): Promise<TrackedFile>;
+    /**
+     * Track a file write operation
+     */
+    trackWrite(filePath: string, content: string, isNew?: boolean): Promise<TrackedFile>;
+    /**
+     * Track a file deletion
+     */
+    trackDelete(filePath: string): Promise<void>;
+    /**
+     * Track a file rename
+     */
+    trackRename(oldPath: string, newPath: string): Promise<TrackedFile | undefined>;
+    /**
+     * Check if a file has been externally modified
+     */
+    checkForExternalChanges(filePath: string): Promise<boolean>;
+    /**
+     * Get tracked file info
+     */
+    getTrackedFile(filePath: string): TrackedFile | undefined;
+    /**
+     * Get all tracked files
+     */
+    getAllTrackedFiles(): TrackedFile[];
+    /**
+     * Get modified files (written during this session)
+     */
+    getModifiedFiles(): TrackedFile[];
+    /**
+     * Get new files (created during this session)
+     */
+    getNewFiles(): TrackedFile[];
+    /**
+     * Get deleted files
+     */
+    getDeletedFiles(): TrackedFile[];
+    /**
+     * Get files with external modifications
+     */
+    getExternallyModifiedFiles(): TrackedFile[];
+    /**
+     * Get operation logs
+     */
+    getOperationLogs(limit?: number): FileOperationLog[];
+    /**
+     * Get operations for a specific file
+     */
+    getFileOperations(filePath: string): FileOperationLog[];
+    /**
+     * Clear tracking for a file
+     */
+    clearFile(filePath: string): boolean;
+    /**
+     * Clear all tracking
+     */
+    clearAll(): void;
+    /**
+     * Get tracking stats
+     */
+    getStats(): {
+        totalTracked: number;
+        modified: number;
+        created: number;
+        deleted: number;
+        externallyModified: number;
+        totalReads: number;
+        totalWrites: number;
+    };
+    /**
+     * Compute hash of content
+     */
+    private computeHash;
+    /**
+     * Log an operation
+     */
+    private logOperation;
+    /**
+     * Enforce max tracked files
+     */
+    private enforceMaxTracked;
+    /**
+     * Generate unique log ID
+     */
+    private generateLogId;
+    /**
+     * Export tracking data
+     */
+    exportData(): {
+        files: TrackedFile[];
+        logs: FileOperationLog[];
+        stats: ReturnType<FileTracker['getStats']>;
+    };
+    /**
+     * Check if file is tracked
+     */
+    isTracked(filePath: string): boolean;
+    /**
+     * Reset external modification flag
+     */
+    acknowledgeExternalChange(filePath: string): void;
+}
+export declare const getFileTracker: typeof FileTracker.getInstance;
+export default FileTracker;
+//# sourceMappingURL=FileTracker.d.ts.map

package/dist/state/FileTracker.d.ts.map

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