specweave 0.23.10 → 0.23.12

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/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"}

package/dist/src/core/progress/progress-tracker.js

@@ -0,0 +1,223 @@
+/**
+ * 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 { consoleLogger } from '../../utils/logger.js';
+/**
+ * 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 class ProgressTracker {
+    constructor(options) {
+        this.items = new Map();
+        this.lastUpdateCount = 0;
+        this.total = options.total;
+        this.label = options.label;
+        this.showEta = options.showEta ?? true;
+        this.updateFrequency = options.updateFrequency ?? 5;
+        this.logger = options.logger ?? consoleLogger;
+        this.startTime = Date.now();
+    }
+    /**
+     * Update progress for a specific item
+     *
+     * @param itemName Item identifier (e.g., project key)
+     * @param status Item status (pending, success, error)
+     */
+    update(itemName, status) {
+        // Track item
+        this.items.set(itemName, {
+            name: itemName,
+            status,
+            timestamp: Date.now(),
+        });
+        const completed = this.getCompletedCount();
+        // Only render if we've processed enough items since last update
+        if (completed - this.lastUpdateCount >= this.updateFrequency ||
+            completed === this.total) {
+            this.render();
+            this.lastUpdateCount = completed;
+        }
+    }
+    /**
+     * 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, failed, skipped) {
+        // Final render
+        this.render();
+        // Show summary
+        console.log(''); // Blank line
+        console.log(`✅ Succeeded: ${succeeded}`);
+        if (failed > 0) {
+            console.log(`❌ Failed: ${failed}`);
+        }
+        if (skipped > 0) {
+            console.log(`⏭️  Skipped: ${skipped}`);
+        }
+        console.log(''); // Blank line
+    }
+    /**
+     * Render progress bar to console
+     */
+    render() {
+        const completed = this.getCompletedCount();
+        const percentage = Math.round((completed / this.total) * 100);
+        const progressBar = this.renderProgressBar(percentage);
+        const elapsed = this.getElapsedTime();
+        const eta = this.showEta ? this.getEta() : '';
+        // Clear current line and print progress
+        process.stdout.write('\r'); // Carriage return to beginning of line
+        process.stdout.write(`${this.label}... ${completed}/${this.total} (${percentage}%) ${progressBar} [${elapsed}${eta}]`);
+    }
+    /**
+     * 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) {
+        const barLength = 30;
+        const filledLength = Math.round((percentage / 100) * barLength);
+        const emptyLength = barLength - filledLength;
+        let bar = '[';
+        // Filled portion
+        if (filledLength > 0) {
+            bar += '='.repeat(Math.max(0, filledLength - 1));
+            bar += '>';
+            bar += ' '.repeat(Math.max(0, emptyLength));
+        }
+        else {
+            // At 0%, show cursor at start
+            bar += '>';
+            bar += ' '.repeat(Math.max(0, emptyLength - 1));
+        }
+        bar += ']';
+        return bar;
+    }
+    /**
+     * Get elapsed time in human-readable format
+     *
+     * @returns Elapsed time string (e.g., "2m 34s", "45s")
+     */
+    getElapsedTime() {
+        const elapsedMs = Date.now() - this.startTime;
+        const elapsedSeconds = Math.floor(elapsedMs / 1000);
+        if (elapsedSeconds < 60) {
+            return `${elapsedSeconds}s elapsed`;
+        }
+        const minutes = Math.floor(elapsedSeconds / 60);
+        const seconds = elapsedSeconds % 60;
+        return `${minutes}m ${seconds}s elapsed`;
+    }
+    /**
+     * Get estimated time remaining (ETA) using linear extrapolation
+     *
+     * Formula: ETA = (total - completed) * (elapsed / completed)
+     *
+     * @returns ETA string (e.g., ", ~2m remaining", ", ~45s remaining")
+     */
+    getEta() {
+        const completed = this.getCompletedCount();
+        if (completed === 0) {
+            return ', ~? remaining';
+        }
+        if (completed === this.total) {
+            return ', ~0s remaining';
+        }
+        const elapsedMs = Date.now() - this.startTime;
+        const avgTimePerItem = elapsedMs / completed;
+        const remaining = this.total - completed;
+        const etaMs = remaining * avgTimePerItem;
+        const etaSeconds = Math.floor(etaMs / 1000);
+        if (etaSeconds < 60) {
+            return `, ~${etaSeconds}s remaining`;
+        }
+        const minutes = Math.floor(etaSeconds / 60);
+        return `, ~${minutes}m remaining`;
+    }
+    /**
+     * Get count of completed items (success + error)
+     */
+    getCompletedCount() {
+        let count = 0;
+        for (const item of this.items.values()) {
+            if (item.status === 'success' || item.status === 'error') {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Get items by status
+     */
+    getItemsByStatus(status) {
+        const result = [];
+        for (const item of this.items.values()) {
+            if (item.status === status) {
+                result.push(item);
+            }
+        }
+        return result;
+    }
+    /**
+     * Get current progress statistics
+     */
+    getStats() {
+        const completed = this.getCompletedCount();
+        const succeeded = this.getItemsByStatus('success').length;
+        const failed = this.getItemsByStatus('error').length;
+        const pending = this.getItemsByStatus('pending').length;
+        const percentage = Math.round((completed / this.total) * 100);
+        const elapsedMs = Date.now() - this.startTime;
+        let etaMs = null;
+        if (completed > 0 && completed < this.total) {
+            const avgTimePerItem = elapsedMs / completed;
+            const remaining = this.total - completed;
+            etaMs = remaining * avgTimePerItem;
+        }
+        return {
+            total: this.total,
+            completed,
+            succeeded,
+            failed,
+            pending,
+            percentage,
+            elapsedMs,
+            etaMs,
+        };
+    }
+}
+//# sourceMappingURL=progress-tracker.js.map

package/dist/src/core/progress/progress-tracker.js.map

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