specweave 0.23.10 → 0.23.14

package/dist/src/core/progress/cancelation-handler.js

@@ -0,0 +1,111 @@
+/**
+ * CancelationHandler - Graceful Ctrl+C (SIGINT) handling with state persistence
+ *
+ * Features:
+ * - Single Ctrl+C: Save state and exit gracefully
+ * - Double Ctrl+C (within 2s): Force exit immediately
+ * - Polling mechanism for cooperative cancelation
+ * - State persistence to resume later
+ *
+ * @module core/progress/cancelation-handler
+ */
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * CancelationHandler - Handles SIGINT gracefully with double Ctrl+C force exit
+ *
+ * @example
+ * ```typescript
+ * const handler = new CancelationHandler({
+ *   onSaveState: async () => {
+ *     await saveImportState();
+ *   }
+ * });
+ *
+ * handler.register();
+ *
+ * // In import loop
+ * for (const project of projects) {
+ *   if (handler.shouldCancel()) {
+ *     break;
+ *   }
+ *   await importProject(project);
+ * }
+ *
+ * handler.unregister();
+ * ```
+ */
+export class CancelationHandler {
+    constructor(options = {}) {
+        this.cancelRequested = false;
+        this.firstCtrlCTime = null;
+        this.sigintHandler = null;
+        this.logger = options.logger ?? consoleLogger;
+        this.onSaveState = options.onSaveState;
+        this.forceExitTimeout = options.forceExitTimeout ?? 2000;
+    }
+    /**
+     * Register SIGINT listener
+     */
+    register() {
+        this.sigintHandler = () => {
+            void this.handleSigint();
+        };
+        process.on('SIGINT', this.sigintHandler);
+    }
+    /**
+     * Unregister SIGINT listener
+     */
+    unregister() {
+        if (this.sigintHandler) {
+            process.off('SIGINT', this.sigintHandler);
+            this.sigintHandler = null;
+        }
+    }
+    /**
+     * Check if cancelation was requested (polling mechanism)
+     *
+     * @returns true if Ctrl+C was pressed
+     */
+    shouldCancel() {
+        return this.cancelRequested;
+    }
+    /**
+     * Handle SIGINT signal (Ctrl+C)
+     */
+    async handleSigint() {
+        const now = Date.now();
+        // Double Ctrl+C detection
+        if (this.firstCtrlCTime !== null) {
+            const elapsed = now - this.firstCtrlCTime;
+            if (elapsed < this.forceExitTimeout) {
+                // Force exit on double Ctrl+C
+                this.logger.warn('\n⚠️  Forced exit (progress may be lost)');
+                process.exit(1);
+            }
+        }
+        // First Ctrl+C
+        this.firstCtrlCTime = now;
+        this.cancelRequested = true;
+        this.logger.log('\n⏸️  Cancelation requested. Saving progress...');
+        try {
+            // Save state if callback provided
+            if (this.onSaveState) {
+                await this.onSaveState();
+            }
+            this.logger.log('✅ Progress saved. Run with --resume to continue.');
+            process.exit(0);
+        }
+        catch (error) {
+            this.logger.error('❌ Failed to save progress:', error);
+            process.exit(1);
+        }
+    }
+    /**
+     * Reset cancelation state (useful for testing)
+     */
+    reset() {
+        this.cancelRequested = false;
+        this.firstCtrlCTime = null;
+    }
+}
+//# sourceMappingURL=cancelation-handler.js.map

package/dist/src/core/progress/cancelation-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancelation-handler.js","sourceRoot":"","sources":["../../../../src/core/progress/cancelation-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AActD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,kBAAkB;IAS7B,YAAY,UAA8B,EAAE;QAJpC,oBAAe,GAAY,KAAK,CAAC;QACjC,mBAAc,GAAkB,IAAI,CAAC;QACrC,kBAAa,GAAwB,IAAI,CAAC;QAGhD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,aAAa,GAAG,GAAG,EAAE;YACxB,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;QAC3B,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,0BAA0B;QAC1B,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC;YAC1C,IAAI,OAAO,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACpC,8BAA8B;gBAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;gBAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,eAAe;QACf,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC;QAC1B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAEnE,IAAI,CAAC;YACH,kCAAkC;YAClC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3B,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;IAC7B,CAAC;CACF"}

package/dist/src/core/progress/error-logger.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Error Logger - Comprehensive error logging for batch operations
+ *
+ * Features:
+ * - File-based error logging
+ * - Timestamped error records
+ * - Structured error format
+ * - Automatic log directory creation
+ *
+ * @module core/progress/error-logger
+ */
+/**
+ * Error log entry
+ */
+export interface ErrorLogEntry {
+    timestamp: string;
+    projectKey: string;
+    error: string;
+    suggestion?: string;
+}
+/**
+ * Error logger options
+ */
+export interface ErrorLoggerOptions {
+    /** Log file path (default: .specweave/logs/import-errors.log) */
+    logFile?: string;
+    /** Project root directory */
+    projectRoot?: string;
+}
+/**
+ * Log error to file
+ *
+ * @param projectKey Project identifier
+ * @param error Error object or message
+ * @param options Logger options
+ */
+export declare function logError(projectKey: string, error: Error | string, options?: ErrorLoggerOptions): Promise<void>;
+/**
+ * Read error log
+ *
+ * @param options Logger options
+ * @returns Array of error log entries
+ */
+export declare function readErrorLog(options?: ErrorLoggerOptions): Promise<ErrorLogEntry[]>;
+/**
+ * Clear error log
+ *
+ * @param options Logger options
+ */
+export declare function clearErrorLog(options?: ErrorLoggerOptions): Promise<void>;
+/**
+ * Get error count from log
+ *
+ * @param options Logger options
+ * @returns Number of errors in log
+ */
+export declare function getErrorCount(options?: ErrorLoggerOptions): Promise<number>;
+//# sourceMappingURL=error-logger.d.ts.map

package/dist/src/core/progress/error-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-logger.d.ts","sourceRoot":"","sources":["../../../../src/core/progress/error-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AASD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA4B7F;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOnF;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrF"}

package/dist/src/core/progress/error-logger.js

@@ -0,0 +1,99 @@
+/**
+ * Error Logger - Comprehensive error logging for batch operations
+ *
+ * Features:
+ * - File-based error logging
+ * - Timestamped error records
+ * - Structured error format
+ * - Automatic log directory creation
+ *
+ * @module core/progress/error-logger
+ */
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { existsSync } from 'fs';
+import { mkdirpSync } from '../../utils/fs-native.js';
+/**
+ * Get default error log file path
+ */
+function getDefaultLogPath(projectRoot) {
+    return join(projectRoot, '.specweave', 'logs', 'import-errors.log');
+}
+/**
+ * Log error to file
+ *
+ * @param projectKey Project identifier
+ * @param error Error object or message
+ * @param options Logger options
+ */
+export async function logError(projectKey, error, options = {}) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const logFile = options.logFile ?? getDefaultLogPath(projectRoot);
+    const logDir = join(projectRoot, '.specweave', 'logs');
+    // Ensure log directory exists
+    mkdirpSync(logDir);
+    // Create error entry
+    const entry = {
+        timestamp: new Date().toISOString(),
+        projectKey,
+        error: error instanceof Error ? error.message : error
+    };
+    // Format log line
+    const logLine = `[${entry.timestamp}] ${entry.projectKey}: ${entry.error}\n`;
+    // Append to log file
+    await fs.appendFile(logFile, logLine, 'utf-8');
+}
+/**
+ * Read error log
+ *
+ * @param options Logger options
+ * @returns Array of error log entries
+ */
+export async function readErrorLog(options = {}) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const logFile = options.logFile ?? getDefaultLogPath(projectRoot);
+    if (!existsSync(logFile)) {
+        return [];
+    }
+    const content = await fs.readFile(logFile, 'utf-8');
+    const lines = content.split('\n').filter(line => line.trim());
+    return lines.map(line => {
+        // Parse log line: [timestamp] projectKey: error
+        const match = line.match(/^\[([^\]]+)\]\s+([^:]+):\s+(.+)$/);
+        if (!match) {
+            return {
+                timestamp: new Date().toISOString(),
+                projectKey: 'UNKNOWN',
+                error: line
+            };
+        }
+        return {
+            timestamp: match[1],
+            projectKey: match[2].trim(),
+            error: match[3].trim()
+        };
+    });
+}
+/**
+ * Clear error log
+ *
+ * @param options Logger options
+ */
+export async function clearErrorLog(options = {}) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const logFile = options.logFile ?? getDefaultLogPath(projectRoot);
+    if (existsSync(logFile)) {
+        await fs.unlink(logFile);
+    }
+}
+/**
+ * Get error count from log
+ *
+ * @param options Logger options
+ * @returns Number of errors in log
+ */
+export async function getErrorCount(options = {}) {
+    const entries = await readErrorLog(options);
+    return entries.length;
+}
+//# sourceMappingURL=error-logger.js.map

package/dist/src/core/progress/error-logger.js.map

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

package/dist/src/core/progress/import-state.d.ts

@@ -0,0 +1,71 @@
+/**
+ * ImportState - State persistence for resumable imports
+ *
+ * Features:
+ * - Save/load import progress
+ * - 24-hour TTL for stale state cleanup
+ * - Error tracking for retry logic
+ *
+ * @module core/progress/import-state
+ */
+/**
+ * Import error record
+ */
+export interface ImportError {
+    /** Item identifier (e.g., project key) */
+    id: string;
+    /** Error message */
+    error: string;
+    /** Timestamp when error occurred */
+    timestamp: number;
+}
+/**
+ * Import state structure
+ */
+export interface ImportState {
+    /** Total number of items to import */
+    total: number;
+    /** Number of items completed (success + failed) */
+    completed: number;
+    /** Number of successful imports */
+    succeeded: number;
+    /** Number of failed imports */
+    failed: number;
+    /** Array of import errors */
+    errors: ImportError[];
+    /** Timestamp when state was saved */
+    timestamp: number;
+    /** Whether import was canceled by user */
+    canceled: boolean;
+    /** Optional: Last successfully processed item ID */
+    lastProcessedId?: string;
+}
+/**
+ * Save import state to disk
+ *
+ * @param state Import state to save
+ * @param projectRoot Project root directory
+ */
+export declare function saveImportState(state: ImportState, projectRoot?: string): Promise<void>;
+/**
+ * Load import state from disk with TTL validation
+ *
+ * @param projectRoot Project root directory
+ * @param ttlMs Time-to-live in milliseconds (default: 24 hours)
+ * @returns Import state if valid, null if expired or missing
+ */
+export declare function loadImportState(projectRoot?: string, ttlMs?: number): Promise<ImportState | null>;
+/**
+ * Delete import state file
+ *
+ * @param projectRoot Project root directory
+ */
+export declare function deleteImportState(projectRoot?: string): Promise<void>;
+/**
+ * Check if import state exists (without loading)
+ *
+ * @param projectRoot Project root directory
+ * @returns true if state file exists
+ */
+export declare function hasImportState(projectRoot?: string): boolean;
+//# sourceMappingURL=import-state.d.ts.map

package/dist/src/core/progress/import-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-state.d.ts","sourceRoot":"","sources":["../../../../src/core/progress/import-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAYD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,WAAW,EAClB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,WAAW,GAAE,MAAsB,EACnC,KAAK,GAAE,MAA4B,GAClC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA0B7B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAG3E"}

package/dist/src/core/progress/import-state.js

@@ -0,0 +1,96 @@
+/**
+ * ImportState - State persistence for resumable imports
+ *
+ * Features:
+ * - Save/load import progress
+ * - 24-hour TTL for stale state cleanup
+ * - Error tracking for retry logic
+ *
+ * @module core/progress/import-state
+ */
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { existsSync } from 'fs';
+import { mkdirpSync } from '../../utils/fs-native.js';
+/**
+ * Get import state file path
+ *
+ * @param projectRoot Project root directory
+ * @returns Path to import-state.json
+ */
+function getStateFilePath(projectRoot = process.cwd()) {
+    return join(projectRoot, '.specweave', 'cache', 'import-state.json');
+}
+/**
+ * Save import state to disk
+ *
+ * @param state Import state to save
+ * @param projectRoot Project root directory
+ */
+export async function saveImportState(state, projectRoot = process.cwd()) {
+    const stateFilePath = getStateFilePath(projectRoot);
+    const cacheDir = join(projectRoot, '.specweave', 'cache');
+    // Ensure cache directory exists
+    mkdirpSync(cacheDir);
+    // Add timestamp
+    const stateWithTimestamp = {
+        ...state,
+        timestamp: Date.now(),
+    };
+    // Write to file
+    await fs.writeFile(stateFilePath, JSON.stringify(stateWithTimestamp, null, 2), 'utf-8');
+}
+/**
+ * Load import state from disk with TTL validation
+ *
+ * @param projectRoot Project root directory
+ * @param ttlMs Time-to-live in milliseconds (default: 24 hours)
+ * @returns Import state if valid, null if expired or missing
+ */
+export async function loadImportState(projectRoot = process.cwd(), ttlMs = 24 * 60 * 60 * 1000 // 24 hours
+) {
+    const stateFilePath = getStateFilePath(projectRoot);
+    // Check if file exists
+    if (!existsSync(stateFilePath)) {
+        return null;
+    }
+    try {
+        // Read and parse file
+        const content = await fs.readFile(stateFilePath, 'utf-8');
+        const state = JSON.parse(content);
+        // Validate TTL
+        const age = Date.now() - state.timestamp;
+        if (age > ttlMs) {
+            // State is expired, delete it
+            await deleteImportState(projectRoot);
+            return null;
+        }
+        return state;
+    }
+    catch (error) {
+        // Invalid JSON or read error
+        return null;
+    }
+}
+/**
+ * Delete import state file
+ *
+ * @param projectRoot Project root directory
+ */
+export async function deleteImportState(projectRoot = process.cwd()) {
+    const stateFilePath = getStateFilePath(projectRoot);
+    if (existsSync(stateFilePath)) {
+        await fs.unlink(stateFilePath);
+    }
+}
+/**
+ * Check if import state exists (without loading)
+ *
+ * @param projectRoot Project root directory
+ * @returns true if state file exists
+ */
+export function hasImportState(projectRoot = process.cwd()) {
+    const stateFilePath = getStateFilePath(projectRoot);
+    return existsSync(stateFilePath);
+}
+//# sourceMappingURL=import-state.js.map

package/dist/src/core/progress/import-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-state.js","sourceRoot":"","sources":["../../../../src/core/progress/import-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAoCtD;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAC3D,OAAO,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAkB,EAClB,cAAsB,OAAO,CAAC,GAAG,EAAE;IAEnC,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAE1D,gCAAgC;IAChC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAErB,gBAAgB;IAChB,MAAM,kBAAkB,GAAgB;QACtC,GAAG,KAAK;QACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,gBAAgB;IAChB,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,cAAsB,OAAO,CAAC,GAAG,EAAE,EACnC,QAAgB,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW;;IAE/C,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEpD,uBAAuB;IACvB,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,sBAAsB;QACtB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE/C,eAAe;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;QACzC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;YAChB,8BAA8B;YAC9B,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,6BAA6B;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IACzE,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAEpD,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC"}

package/dist/src/core/progress/progress-tracker.d.ts

@@ -0,0 +1,139 @@
+/**
+ * ProgressTracker - Real-time progress tracking with ETA calculation
+ *
+ * Features:
+ * - ASCII progress bar (30 characters)
+ * - Linear ETA extrapolation
+ * - Elapsed time tracking
+ * - Project-level status display (✅ ❌ ⏳)
+ * - Configurable update frequency
+ *
+ * @module core/progress/progress-tracker
+ */
+import { Logger } from '../../utils/logger.js';
+/**
+ * Item status types
+ */
+export type ItemStatus = 'pending' | 'success' | 'error';
+/**
+ * Progress tracker options
+ */
+export interface ProgressTrackerOptions {
+    /** Total number of items to process */
+    total: number;
+    /** Label for the operation (e.g., "Importing projects") */
+    label: string;
+    /** Show ETA calculation */
+    showEta?: boolean;
+    /** Update frequency (update every N items, default: 5) */
+    updateFrequency?: number;
+    /** Logger instance */
+    logger?: Logger;
+}
+/**
+ * Item with status
+ */
+interface TrackedItem {
+    name: string;
+    status: ItemStatus;
+    timestamp: number;
+}
+/**
+ * ProgressTracker - Real-time progress tracking with ASCII progress bar and ETA
+ *
+ * @example
+ * ```typescript
+ * const tracker = new ProgressTracker({
+ *   total: 127,
+ *   label: 'Importing projects',
+ *   showEta: true,
+ *   updateFrequency: 5
+ * });
+ *
+ * for (const project of projects) {
+ *   await importProject(project);
+ *   tracker.update(project.key, 'success');
+ * }
+ *
+ * tracker.finish(120, 5, 2);
+ * ```
+ */
+export declare class ProgressTracker {
+    private total;
+    private label;
+    private showEta;
+    private updateFrequency;
+    private logger;
+    private items;
+    private startTime;
+    private lastUpdateCount;
+    constructor(options: ProgressTrackerOptions);
+    /**
+     * Update progress for a specific item
+     *
+     * @param itemName Item identifier (e.g., project key)
+     * @param status Item status (pending, success, error)
+     */
+    update(itemName: string, status: ItemStatus): void;
+    /**
+     * Finish progress tracking and show final summary
+     *
+     * @param succeeded Count of successful items
+     * @param failed Count of failed items
+     * @param skipped Count of skipped items
+     */
+    finish(succeeded: number, failed: number, skipped: number): void;
+    /**
+     * Render progress bar to console
+     */
+    private render;
+    /**
+     * Render ASCII progress bar
+     *
+     * @param percentage Completion percentage (0-100)
+     * @returns ASCII progress bar (30 characters)
+     *
+     * @example
+     * renderProgressBar(0)   => "[>                             ]"
+     * renderProgressBar(37)  => "[==========>                   ]"
+     * renderProgressBar(100) => "[==============================]"
+     */
+    renderProgressBar(percentage: number): string;
+    /**
+     * Get elapsed time in human-readable format
+     *
+     * @returns Elapsed time string (e.g., "2m 34s", "45s")
+     */
+    getElapsedTime(): string;
+    /**
+     * Get estimated time remaining (ETA) using linear extrapolation
+     *
+     * Formula: ETA = (total - completed) * (elapsed / completed)
+     *
+     * @returns ETA string (e.g., ", ~2m remaining", ", ~45s remaining")
+     */
+    getEta(): string;
+    /**
+     * Get count of completed items (success + error)
+     */
+    private getCompletedCount;
+    /**
+     * Get items by status
+     */
+    getItemsByStatus(status: ItemStatus): TrackedItem[];
+    /**
+     * Get current progress statistics
+     */
+    getStats(): {
+        total: number;
+        completed: number;
+        succeeded: number;
+        failed: number;
+        pending: number;
+        percentage: number;
+        elapsedMs: number;
+        etaMs: number | null;
+    };
+}
+export {};
+//# sourceMappingURL=progress-tracker.d.ts.map

package/dist/src/core/progress/progress-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-tracker.d.ts","sourceRoot":"","sources":["../../../../src/core/progress/progress-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAa;gBAExB,OAAO,EAAE,sBAAsB;IAS3C;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAoBlD;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAgBhE;;OAEG;IACH,OAAO,CAAC,MAAM;IAcd;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAuB7C;;;;OAIG;IACH,cAAc,IAAI,MAAM;IAaxB;;;;;;OAMG;IACH,MAAM,IAAI,MAAM;IAyBhB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,EAAE;IAUnD;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB;CA0BF"}