nova-terminal-ai 0.3.4

package/dist/packages/core/src/utils/CheckpointManager.js

@@ -0,0 +1,255 @@
+// ============================================================================
+// CheckpointManager - File snapshot and rollback system
+// ============================================================================
+import { promises as fs } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { createHash } from 'node:crypto';
+/**
+ * CheckpointManager - Manages file snapshots for rollback capability
+ *
+ * Features:
+ * - Create snapshots before destructive operations
+ * - Rollback to previous states
+ * - List and manage checkpoints
+ * - Automatic cleanup of old checkpoints
+ */
+export class CheckpointManager {
+    workspaceRoot;
+    checkpointsDir;
+    config;
+    maxCheckpoints;
+    maxAgeMs;
+    constructor(workspaceRoot, config) {
+        this.workspaceRoot = workspaceRoot;
+        this.config = config;
+        this.checkpointsDir = join(workspaceRoot, '.nova', 'checkpoints');
+        this.maxCheckpoints = config.core.maxCheckpoints || 10;
+        this.maxAgeMs = (config.core.checkpointMaxAgeDays || 7) * 24 * 60 * 60 * 1000;
+    }
+    /**
+     * Initialize checkpoint directory
+     */
+    async initialize() {
+        try {
+            await fs.mkdir(this.checkpointsDir, { recursive: true });
+        }
+        catch (err) {
+            // Directory might already exist
+        }
+    }
+    /**
+     * Create a checkpoint of specified files
+     */
+    async create(name, filePatterns, description) {
+        await this.initialize();
+        const checkpointId = this.generateId();
+        const checkpointDir = join(this.checkpointsDir, checkpointId);
+        await fs.mkdir(checkpointDir, { recursive: true });
+        const files = [];
+        const matchedFiles = await this.findFiles(filePatterns);
+        for (const filePath of matchedFiles) {
+            const fullPath = join(this.workspaceRoot, filePath);
+            try {
+                const stats = await fs.stat(fullPath);
+                if (!stats.isFile())
+                    continue;
+                // Read file content
+                const content = await fs.readFile(fullPath);
+                // Calculate hash
+                const hash = createHash('sha256').update(content).digest('hex');
+                // Copy file to checkpoint
+                const checkpointFilePath = join(checkpointDir, filePath);
+                await fs.mkdir(dirname(checkpointFilePath), { recursive: true });
+                await fs.writeFile(checkpointFilePath, content);
+                files.push({
+                    path: filePath,
+                    hash,
+                    size: content.length,
+                    mtime: stats.mtimeMs,
+                });
+            }
+            catch (err) {
+                // File might not exist or be readable
+                console.warn(`Warning: Could not checkpoint ${filePath}: ${err}`);
+            }
+        }
+        const checkpoint = {
+            id: checkpointId,
+            name,
+            timestamp: Date.now(),
+            files,
+            description,
+        };
+        // Save checkpoint metadata
+        await fs.writeFile(join(checkpointDir, 'metadata.json'), JSON.stringify(checkpoint, null, 2));
+        // Cleanup old checkpoints
+        await this.cleanupOldCheckpoints();
+        return checkpoint;
+    }
+    /**
+     * Restore a checkpoint
+     */
+    async restore(checkpointId) {
+        const checkpoint = await this.load(checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint not found: ${checkpointId}`);
+        }
+        const checkpointDir = join(this.checkpointsDir, checkpointId);
+        for (const file of checkpoint.files) {
+            const sourcePath = join(checkpointDir, file.path);
+            const destPath = join(this.workspaceRoot, file.path);
+            try {
+                await fs.mkdir(dirname(destPath), { recursive: true });
+                const content = await fs.readFile(sourcePath);
+                await fs.writeFile(destPath, content);
+            }
+            catch (err) {
+                throw new Error(`Failed to restore ${file.path}: ${err}`);
+            }
+        }
+    }
+    /**
+     * List all checkpoints
+     */
+    async list() {
+        await this.initialize();
+        try {
+            const entries = await fs.readdir(this.checkpointsDir, { withFileTypes: true });
+            const checkpoints = [];
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    try {
+                        const metadataPath = join(this.checkpointsDir, entry.name, 'metadata.json');
+                        const metadata = await fs.readFile(metadataPath, 'utf-8');
+                        const checkpoint = JSON.parse(metadata);
+                        checkpoints.push(checkpoint);
+                    }
+                    catch (err) {
+                        // Skip invalid checkpoints
+                    }
+                }
+            }
+            // Sort by timestamp (newest first)
+            return checkpoints.sort((a, b) => b.timestamp - a.timestamp);
+        }
+        catch (err) {
+            return [];
+        }
+    }
+    /**
+     * Get checkpoint by ID
+     */
+    async load(checkpointId) {
+        try {
+            const metadataPath = join(this.checkpointsDir, checkpointId, 'metadata.json');
+            const metadata = await fs.readFile(metadataPath, 'utf-8');
+            return JSON.parse(metadata);
+        }
+        catch (err) {
+            return null;
+        }
+    }
+    /**
+     * Delete a checkpoint
+     */
+    async delete(checkpointId) {
+        try {
+            const checkpointDir = join(this.checkpointsDir, checkpointId);
+            await fs.rm(checkpointDir, { recursive: true, force: true });
+            return true;
+        }
+        catch (err) {
+            return false;
+        }
+    }
+    /**
+     * Get checkpoint statistics
+     */
+    async stats() {
+        const checkpoints = await this.list();
+        let totalSize = 0;
+        for (const checkpoint of checkpoints) {
+            totalSize += checkpoint.files.reduce((sum, file) => sum + file.size, 0);
+        }
+        return {
+            totalCheckpoints: checkpoints.length,
+            totalSize,
+            oldest: checkpoints.length > 0 ? checkpoints[checkpoints.length - 1].timestamp : undefined,
+            newest: checkpoints.length > 0 ? checkpoints[0].timestamp : undefined,
+        };
+    }
+    /**
+     * Compare current files with checkpoint
+     */
+    async diff(checkpointId) {
+        const checkpoint = await this.load(checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint not found: ${checkpointId}`);
+        }
+        const differences = [];
+        // Check files in checkpoint
+        for (const file of checkpoint.files) {
+            const currentPath = join(this.workspaceRoot, file.path);
+            try {
+                const currentContent = await fs.readFile(currentPath);
+                const currentHash = createHash('sha256').update(currentContent).digest('hex');
+                if (currentHash !== file.hash) {
+                    differences.push({ path: file.path, status: 'modified' });
+                }
+            }
+            catch (err) {
+                // File doesn't exist (deleted)
+                differences.push({ path: file.path, status: 'deleted' });
+            }
+        }
+        return differences;
+    }
+    /**
+     * Cleanup old checkpoints based on age and count limits
+     */
+    async cleanupOldCheckpoints() {
+        const checkpoints = await this.list();
+        const now = Date.now();
+        const toDelete = [];
+        // Find checkpoints to delete
+        for (let i = 0; i < checkpoints.length; i++) {
+            const checkpoint = checkpoints[i];
+            const age = now - checkpoint.timestamp;
+            // Delete if too old or if we have too many
+            if (age > this.maxAgeMs || i >= this.maxCheckpoints) {
+                toDelete.push(checkpoint.id);
+            }
+        }
+        // Delete old checkpoints
+        for (const id of toDelete) {
+            await this.delete(id);
+        }
+    }
+    /**
+     * Find files matching patterns
+     */
+    async findFiles(patterns) {
+        const files = new Set();
+        for (const pattern of patterns) {
+            if (pattern.includes('*')) {
+                // Simple glob pattern - in real implementation use a glob library
+                // For now, just add the pattern as-is
+                files.add(pattern);
+            }
+            else {
+                // Single file or directory
+                files.add(pattern);
+            }
+        }
+        return Array.from(files);
+    }
+    /**
+     * Generate unique checkpoint ID
+     */
+    generateId() {
+        const timestamp = Date.now().toString(36);
+        const random = Math.random().toString(36).substr(2, 6);
+        return `cp-${timestamp}-${random}`;
+    }
+}
+//# sourceMappingURL=CheckpointManager.js.map

package/dist/packages/core/src/utils/CheckpointManager.js.map

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

package/dist/packages/core/src/utils/Logger.d.ts

@@ -0,0 +1,29 @@
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    data?: unknown;
+    timestamp: string;
+    source: string;
+}
+export declare class Logger {
+    private level;
+    private source;
+    private history;
+    private maxHistory;
+    constructor(source: string, level?: LogLevel, maxHistory?: number);
+    setLevel(level: LogLevel): void;
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, data?: unknown): void;
+    private log;
+    private shouldLog;
+    private output;
+    getHistory(level?: LogLevel): LogEntry[];
+    clearHistory(): void;
+}
+/** Create a named logger */
+export declare function createLogger(source: string, level?: LogLevel): Logger;
+export {};
+//# sourceMappingURL=Logger.d.ts.map

package/dist/packages/core/src/utils/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../../../../core/src/utils/Logger.ts"],"names":[],"mappings":"AAIA,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,QAAiB,EAAE,UAAU,GAAE,MAAa;IAM/E,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI5C,OAAO,CAAC,GAAG;IAiBX,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,MAAM;IAgBd,UAAU,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE;IAKxC,YAAY,IAAI,IAAI;CAGrB;AAED,4BAA4B;AAC5B,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAErE"}

package/dist/packages/core/src/utils/Logger.js

@@ -0,0 +1,77 @@
+// ============================================================================
+// Logger - Simple structured logging
+// ============================================================================
+export class Logger {
+    level;
+    source;
+    history = [];
+    maxHistory;
+    constructor(source, level = 'info', maxHistory = 1000) {
+        this.source = source;
+        this.level = level;
+        this.maxHistory = maxHistory;
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    debug(message, data) {
+        this.log('debug', message, data);
+    }
+    info(message, data) {
+        this.log('info', message, data);
+    }
+    warn(message, data) {
+        this.log('warn', message, data);
+    }
+    error(message, data) {
+        this.log('error', message, data);
+    }
+    log(level, message, data) {
+        if (!this.shouldLog(level))
+            return;
+        const entry = {
+            level,
+            message,
+            data,
+            timestamp: new Date().toISOString(),
+            source: this.source,
+        };
+        this.history.push(entry);
+        if (this.history.length > this.maxHistory)
+            this.history.shift();
+        this.output(entry);
+    }
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error', 'silent'];
+        return levels.indexOf(level) >= levels.indexOf(this.level);
+    }
+    output(entry) {
+        const colors = {
+            debug: '\x1b[36m', info: '\x1b[37m', warn: '\x1b[33m', error: '\x1b[31m', silent: '',
+        };
+        const reset = '\x1b[0m';
+        const color = colors[entry.level];
+        const prefix = `${entry.timestamp} [${entry.level.toUpperCase()}] [${entry.source}]`;
+        if (entry.level === 'error') {
+            console.error(`${color}${prefix}${reset} ${entry.message}`);
+            if (entry.data)
+                console.error(`${color}  Data: ${JSON.stringify(entry.data)}${reset}`);
+        }
+        else {
+            console.log(`${color}${prefix}${reset} ${entry.message}`);
+        }
+    }
+    getHistory(level) {
+        if (level)
+            return this.history.filter((e) => e.level === level);
+        return [...this.history];
+    }
+    clearHistory() {
+        this.history = [];
+    }
+}
+/** Create a named logger */
+export function createLogger(source, level) {
+    return new Logger(source, level);
+}
+//# sourceMappingURL=Logger.js.map

package/dist/packages/core/src/utils/Logger.js.map

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

package/dist/packages/core/src/utils/RetryManager.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Retry configuration options
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts */
+    maxAttempts: number;
+    /** Initial delay in milliseconds */
+    initialDelay: number;
+    /** Maximum delay in milliseconds */
+    maxDelay: number;
+    /** Backoff multiplier (default 2) */
+    backoffMultiplier?: number;
+    /** Jitter factor (0-1, default 0.1) */
+    jitterFactor?: number;
+    /** Errors that should trigger retry */
+    retryableErrors?: string[];
+    /** HTTP status codes that should trigger retry */
+    retryableStatusCodes?: number[];
+}
+/**
+ * Execute a function with retry logic
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+/**
+ * Create a retry wrapper for a function
+ */
+export declare function createRetryWrapper<TArgs extends any[], TResult>(fn: (...args: TArgs) => Promise<TResult>, config?: Partial<RetryConfig>): (...args: TArgs) => Promise<TResult>;
+/**
+ * Rate limiter configuration
+ */
+export interface RateLimiterConfig {
+    /** Maximum tokens in bucket */
+    maxTokens: number;
+    /** Tokens replenished per second */
+    tokensPerSecond: number;
+    /** Maximum wait time in milliseconds (default 60000) */
+    maxWaitTime?: number;
+}
+/**
+ * Token bucket rate limiter
+ */
+export declare class RateLimiter {
+    private tokens;
+    private lastRefill;
+    private config;
+    private waitQueue;
+    constructor(config: RateLimiterConfig);
+    /**
+     * Refill tokens based on elapsed time
+     */
+    private refill;
+    /**
+     * Try to acquire tokens without waiting
+     * @returns true if tokens were acquired, false otherwise
+     */
+    tryAcquire(tokens: number): boolean;
+    /**
+     * Acquire tokens, waiting if necessary
+     */
+    acquire(tokens: number): Promise<void>;
+    /**
+     * Process waiting requests
+     */
+    private processQueue;
+    /**
+     * Get current token count
+     */
+    getTokens(): number;
+    /**
+     * Get estimated wait time for a given number of tokens
+     */
+    getWaitTime(tokens: number): number;
+}
+/**
+ * Create a rate-limited wrapper for a function
+ */
+export declare function withRateLimit<TArgs extends any[], TResult>(fn: (...args: TArgs) => Promise<TResult>, limiter: RateLimiter, tokensPerCall?: number): (...args: TArgs) => Promise<TResult>;
+/**
+ * Concurrency limiter using semaphore pattern
+ */
+export declare class ConcurrencyLimiter {
+    private maxConcurrent;
+    private running;
+    private queue;
+    constructor(maxConcurrent: number);
+    /**
+     * Acquire a slot
+     */
+    acquire(): Promise<void>;
+    /**
+     * Release a slot
+     */
+    release(): void;
+    /**
+     * Execute a function with concurrency limit
+     */
+    run<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get current state
+     */
+    getState(): {
+        running: number;
+        queued: number;
+        available: number;
+    };
+}
+/**
+ * Create a resilient function with retry, rate limiting, and concurrency control
+ */
+export declare function createResilientFunction<TArgs extends any[], TResult>(fn: (...args: TArgs) => Promise<TResult>, options?: {
+    retry?: Partial<RetryConfig>;
+    rateLimit?: RateLimiterConfig;
+    maxConcurrent?: number;
+}): (...args: TArgs) => Promise<TResult>;
+/**
+ * Default rate limiter for API calls
+ * - 60 requests per minute (1 per second)
+ * - Burst of up to 10 requests
+ */
+export declare function createDefaultApiRateLimiter(): RateLimiter;
+/**
+ * Default concurrency limiter for API calls
+ */
+export declare function createDefaultConcurrencyLimiter(): ConcurrencyLimiter;
+//# sourceMappingURL=RetryManager.d.ts.map

package/dist/packages/core/src/utils/RetryManager.d.ts.map

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