erosolar-cli 1.5.3 → 1.5.5

package/dist/bin/ui/interrupts/InterruptManager.js

@@ -0,0 +1,437 @@
+/**
+ * InterruptManager - Manages user interruptions with priority queuing
+ * Handles interrupt prioritization, deferred execution, and smooth transitions
+ */
+import { EventEmitter } from 'events';
+export var InterruptPriority;
+(function (InterruptPriority) {
+    InterruptPriority[InterruptPriority["CRITICAL"] = 100] = "CRITICAL";
+    InterruptPriority[InterruptPriority["HIGH"] = 75] = "HIGH";
+    InterruptPriority[InterruptPriority["NORMAL"] = 50] = "NORMAL";
+    InterruptPriority[InterruptPriority["LOW"] = 25] = "LOW";
+    InterruptPriority[InterruptPriority["BACKGROUND"] = 0] = "BACKGROUND";
+})(InterruptPriority || (InterruptPriority = {}));
+export class InterruptManager extends EventEmitter {
+    constructor(policy = {}) {
+        super();
+        this.pendingQueue = [];
+        this.activeInterrupts = new Map();
+        this.deferredInterrupts = new Map();
+        this.isProcessing = false;
+        this.transitionTimer = null;
+        this.policy = {
+            maxQueueSize: 100,
+            maxDeferrals: 3,
+            defaultTTL: 30000, // 30 seconds default TTL
+            allowConcurrent: false,
+            transitionDuration: 200,
+            ...policy,
+        };
+    }
+    /**
+     * Queue a new interrupt
+     */
+    queue(config) {
+        const id = this.generateId();
+        const interrupt = {
+            ...config,
+            id,
+            timestamp: Date.now(),
+            ttl: config.ttl || this.policy.defaultTTL,
+            deferrable: config.deferrable ?? true,
+            blocking: config.blocking ?? false,
+            status: 'pending',
+            deferredCount: 0,
+        };
+        // Check queue size limit
+        if (this.pendingQueue.length >= this.policy.maxQueueSize) {
+            // Remove lowest priority expired or old interrupts
+            this.pruneQueue();
+            if (this.pendingQueue.length >= this.policy.maxQueueSize) {
+                this.emit('interrupt:rejected', {
+                    interrupt,
+                    reason: 'queue-full',
+                });
+                return '';
+            }
+        }
+        // Insert based on priority
+        const insertIndex = this.findInsertIndex(interrupt.priority);
+        this.pendingQueue.splice(insertIndex, 0, interrupt);
+        this.emit('interrupt:queued', interrupt);
+        // Start expiry timer if TTL is set
+        if (interrupt.ttl && interrupt.ttl > 0) {
+            this.scheduleExpiry(interrupt);
+        }
+        // Process queue
+        this.processQueue();
+        return id;
+    }
+    /**
+     * Process the interrupt queue
+     */
+    async processQueue() {
+        if (this.isProcessing) {
+            return;
+        }
+        this.isProcessing = true;
+        try {
+            while (this.pendingQueue.length > 0) {
+                const interrupt = this.pendingQueue[0];
+                if (!interrupt)
+                    break;
+                // Check if interrupt has expired
+                if (this.isExpired(interrupt)) {
+                    this.expireInterrupt(interrupt);
+                    continue;
+                }
+                // Check if we can activate this interrupt
+                if (!this.canActivate(interrupt)) {
+                    // If it's deferrable and hasn't exceeded max deferrals, defer it
+                    if (interrupt.deferrable && interrupt.deferredCount < this.policy.maxDeferrals) {
+                        this.deferInterrupt(interrupt);
+                    }
+                    break; // Wait for active interrupts to complete
+                }
+                // Remove from queue and activate
+                this.pendingQueue.shift();
+                await this.activateInterrupt(interrupt);
+                // If this interrupt is blocking, wait for it to complete
+                if (interrupt.blocking) {
+                    await this.waitForCompletion(interrupt.id);
+                }
+            }
+        }
+        finally {
+            this.isProcessing = false;
+        }
+        // Process deferred interrupts if queue is empty
+        if (this.pendingQueue.length === 0 && this.deferredInterrupts.size > 0) {
+            this.restoreDeferredInterrupts();
+            this.processQueue();
+        }
+    }
+    /**
+     * Check if interrupt can be activated
+     */
+    canActivate(interrupt) {
+        // If no concurrent interrupts allowed and there are active ones
+        if (!this.policy.allowConcurrent && this.activeInterrupts.size > 0) {
+            // Check if this interrupt has higher priority than all active ones
+            for (const active of this.activeInterrupts.values()) {
+                if (active.priority >= interrupt.priority) {
+                    return false;
+                }
+            }
+            // Higher priority interrupt can preempt if active ones are deferrable
+            for (const active of this.activeInterrupts.values()) {
+                if (!active.deferrable) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Activate an interrupt
+     */
+    async activateInterrupt(interrupt) {
+        interrupt.status = 'active';
+        interrupt.activatedAt = Date.now();
+        this.activeInterrupts.set(interrupt.id, interrupt);
+        // Handle smooth transition
+        if (this.policy.transitionDuration > 0) {
+            await this.smoothTransition('in', interrupt);
+        }
+        this.emit('interrupt:activated', interrupt);
+        // Execute handler if provided
+        if (interrupt.handler) {
+            try {
+                await interrupt.handler(interrupt);
+                this.completeInterrupt(interrupt.id);
+            }
+            catch (error) {
+                this.emit('interrupt:error', {
+                    interrupt,
+                    error,
+                });
+                this.cancelInterrupt(interrupt.id);
+            }
+        }
+    }
+    /**
+     * Complete an interrupt
+     */
+    completeInterrupt(id) {
+        const interrupt = this.activeInterrupts.get(id);
+        if (!interrupt)
+            return;
+        interrupt.status = 'completed';
+        interrupt.completedAt = Date.now();
+        this.activeInterrupts.delete(id);
+        // Handle smooth transition
+        if (this.policy.transitionDuration > 0) {
+            this.smoothTransition('out', interrupt);
+        }
+        this.emit('interrupt:completed', interrupt);
+        // Process next in queue
+        this.processQueue();
+    }
+    /**
+     * Cancel an interrupt
+     */
+    cancelInterrupt(id) {
+        // Check in queue
+        const queueIndex = this.pendingQueue.findIndex((i) => i.id === id);
+        if (queueIndex !== -1) {
+            const interrupt = this.pendingQueue[queueIndex];
+            if (interrupt) {
+                interrupt.status = 'cancelled';
+                this.pendingQueue.splice(queueIndex, 1);
+                this.emit('interrupt:cancelled', interrupt);
+            }
+            return;
+        }
+        // Check in active
+        const active = this.activeInterrupts.get(id);
+        if (active) {
+            active.status = 'cancelled';
+            this.activeInterrupts.delete(id);
+            this.emit('interrupt:cancelled', active);
+            this.processQueue();
+            return;
+        }
+        // Check in deferred
+        const deferred = this.deferredInterrupts.get(id);
+        if (deferred) {
+            deferred.status = 'cancelled';
+            this.deferredInterrupts.delete(id);
+            this.emit('interrupt:cancelled', deferred);
+        }
+    }
+    /**
+     * Defer an interrupt
+     */
+    deferInterrupt(interrupt) {
+        this.pendingQueue.shift(); // Remove from queue
+        interrupt.status = 'deferred';
+        interrupt.deferredCount++;
+        this.deferredInterrupts.set(interrupt.id, interrupt);
+        this.emit('interrupt:deferred', interrupt);
+    }
+    /**
+     * Restore deferred interrupts to queue
+     */
+    restoreDeferredInterrupts() {
+        const deferred = Array.from(this.deferredInterrupts.values());
+        this.deferredInterrupts.clear();
+        for (const interrupt of deferred) {
+            interrupt.status = 'pending';
+            const insertIndex = this.findInsertIndex(interrupt.priority);
+            this.pendingQueue.splice(insertIndex, 0, interrupt);
+            this.emit('interrupt:restored', interrupt);
+        }
+    }
+    /**
+     * Expire an interrupt
+     */
+    expireInterrupt(interrupt) {
+        interrupt.status = 'expired';
+        this.pendingQueue.shift();
+        this.emit('interrupt:expired', interrupt);
+    }
+    /**
+     * Check if interrupt has expired
+     */
+    isExpired(interrupt) {
+        if (!interrupt.ttl || interrupt.ttl <= 0) {
+            return false;
+        }
+        const age = Date.now() - interrupt.timestamp;
+        return age > interrupt.ttl;
+    }
+    /**
+     * Schedule interrupt expiry
+     */
+    scheduleExpiry(interrupt) {
+        if (!interrupt.ttl || interrupt.ttl <= 0)
+            return;
+        setTimeout(() => {
+            if (interrupt.status === 'pending') {
+                const index = this.pendingQueue.indexOf(interrupt);
+                if (index !== -1) {
+                    this.expireInterrupt(interrupt);
+                    this.processQueue();
+                }
+            }
+        }, interrupt.ttl);
+    }
+    /**
+     * Wait for interrupt completion
+     */
+    waitForCompletion(id) {
+        return new Promise((resolve) => {
+            const checkCompletion = () => {
+                if (!this.activeInterrupts.has(id)) {
+                    resolve();
+                }
+                else {
+                    setTimeout(checkCompletion, 50);
+                }
+            };
+            checkCompletion();
+        });
+    }
+    /**
+     * Handle smooth transitions
+     */
+    async smoothTransition(direction, interrupt) {
+        return new Promise((resolve) => {
+            this.emit('interrupt:transition', {
+                direction,
+                interrupt,
+                duration: this.policy.transitionDuration,
+            });
+            setTimeout(resolve, this.policy.transitionDuration);
+        });
+    }
+    /**
+     * Find insertion index based on priority
+     */
+    findInsertIndex(priority) {
+        for (let i = 0; i < this.pendingQueue.length; i++) {
+            const item = this.pendingQueue[i];
+            if (item && item.priority < priority) {
+                return i;
+            }
+        }
+        return this.pendingQueue.length;
+    }
+    /**
+     * Prune expired and low-priority interrupts from queue
+     */
+    pruneQueue() {
+        // Remove expired interrupts
+        this.pendingQueue = this.pendingQueue.filter((interrupt) => {
+            if (this.isExpired(interrupt)) {
+                interrupt.status = 'expired';
+                this.emit('interrupt:expired', interrupt);
+                return false;
+            }
+            return true;
+        });
+        // If still over limit, remove lowest priority
+        while (this.pendingQueue.length >= this.policy.maxQueueSize) {
+            const removed = this.pendingQueue.pop();
+            if (removed) {
+                removed.status = 'cancelled';
+                this.emit('interrupt:cancelled', removed);
+            }
+        }
+    }
+    /**
+     * Generate unique interrupt ID
+     */
+    generateId() {
+        return `interrupt-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Get interrupt by ID
+     */
+    getInterrupt(id) {
+        // Check active
+        if (this.activeInterrupts.has(id)) {
+            return this.activeInterrupts.get(id);
+        }
+        // Check queue
+        const queued = this.pendingQueue.find((i) => i.id === id);
+        if (queued)
+            return queued;
+        // Check deferred
+        return this.deferredInterrupts.get(id);
+    }
+    /**
+     * Get all interrupts with a specific status
+     */
+    getInterruptsByStatus(status) {
+        const results = [];
+        if (status === 'active') {
+            results.push(...this.activeInterrupts.values());
+        }
+        else if (status === 'pending') {
+            results.push(...this.pendingQueue);
+        }
+        else if (status === 'deferred') {
+            results.push(...this.deferredInterrupts.values());
+        }
+        return results;
+    }
+    /**
+     * Get queue statistics
+     */
+    getStatistics() {
+        const allInterrupts = [
+            ...this.pendingQueue,
+            ...this.activeInterrupts.values(),
+            ...this.deferredInterrupts.values(),
+        ];
+        const avgPriority = allInterrupts.length > 0
+            ? allInterrupts.reduce((sum, i) => sum + i.priority, 0) / allInterrupts.length
+            : 0;
+        const oldestTimestamp = allInterrupts.length > 0
+            ? Math.min(...allInterrupts.map((i) => i.timestamp))
+            : null;
+        return {
+            queueLength: this.pendingQueue.length,
+            activeCount: this.activeInterrupts.size,
+            deferredCount: this.deferredInterrupts.size,
+            averagePriority: avgPriority,
+            oldestTimestamp,
+        };
+    }
+    /**
+     * Clear all interrupts
+     */
+    clearAll() {
+        // Cancel all active
+        for (const interrupt of this.activeInterrupts.values()) {
+            interrupt.status = 'cancelled';
+            this.emit('interrupt:cancelled', interrupt);
+        }
+        this.activeInterrupts.clear();
+        // Cancel all queued
+        for (const interrupt of this.pendingQueue) {
+            interrupt.status = 'cancelled';
+            this.emit('interrupt:cancelled', interrupt);
+        }
+        this.pendingQueue = [];
+        // Cancel all deferred
+        for (const interrupt of this.deferredInterrupts.values()) {
+            interrupt.status = 'cancelled';
+            this.emit('interrupt:cancelled', interrupt);
+        }
+        this.deferredInterrupts.clear();
+        this.emit('interrupt:cleared');
+    }
+    /**
+     * Update interrupt policy
+     */
+    updatePolicy(policy) {
+        this.policy = {
+            ...this.policy,
+            ...policy,
+        };
+        this.emit('policy:updated', this.policy);
+    }
+    /**
+     * Dispose of the manager
+     */
+    dispose() {
+        this.clearAll();
+        this.removeAllListeners();
+        if (this.transitionTimer) {
+            clearTimeout(this.transitionTimer);
+            this.transitionTimer = null;
+        }
+    }
+}

package/dist/bin/ui/layout.js

@@ -0,0 +1,139 @@
+import { theme } from './theme.js';
+import { isPlainOutputMode } from './outputMode.js';
+const MIN_WIDTH = 42;
+const MAX_WIDTH = 110;
+const ANSI_REGEX = /\u001B\[[0-9;]*m/g;
+export function getTerminalColumns(defaultWidth = 80) {
+    if (typeof process.stdout.columns === 'number' &&
+        Number.isFinite(process.stdout.columns) &&
+        process.stdout.columns > 0) {
+        return process.stdout.columns;
+    }
+    return defaultWidth;
+}
+export function getContentWidth() {
+    const columns = getTerminalColumns();
+    const usable = typeof columns === 'number' && Number.isFinite(columns) ? columns - 6 : MAX_WIDTH;
+    return clampWidth(usable, columns);
+}
+export function wrapParagraph(text, width) {
+    const words = text.split(/\s+/).filter(Boolean);
+    if (!words.length) {
+        return [''];
+    }
+    const lines = [];
+    let current = words.shift();
+    for (const word of words) {
+        if (measure(`${current} ${word}`) > width) {
+            lines.push(current);
+            current = word;
+        }
+        else {
+            current += ` ${word}`;
+        }
+    }
+    lines.push(current);
+    return lines;
+}
+export function wrapPreformatted(text, width) {
+    if (!text) {
+        return [''];
+    }
+    const result = [];
+    let remaining = text;
+    while (measure(remaining) > width) {
+        result.push(remaining.slice(0, width));
+        remaining = remaining.slice(width);
+    }
+    if (remaining) {
+        result.push(remaining);
+    }
+    return result.length ? result : [''];
+}
+export function normalizePanelWidth(width) {
+    if (typeof width === 'number' && Number.isFinite(width)) {
+        return clampWidth(width, getTerminalColumns());
+    }
+    return clampWidth(getContentWidth(), getTerminalColumns());
+}
+export function renderPanel(lines, options = {}) {
+    // Check if plain output mode is enabled for clipboard-friendly text
+    if (isPlainOutputMode()) {
+        return renderPlainPanel(lines, options);
+    }
+    const width = normalizePanelWidth(options.width);
+    const accent = options.accentColor ?? theme.primary;
+    const iconSegment = options.icon ? `${options.icon} ` : '';
+    const titleText = options.title ? `${iconSegment}${options.title}` : '';
+    const output = [];
+    // Add empty line for spacing
+    output.push('');
+    if (titleText) {
+        const paddedTitle = padLine(accent(truncate(titleText, width)), width);
+        output.push(paddedTitle);
+        output.push('');
+    }
+    if (!lines.length) {
+        lines = [''];
+    }
+    for (const line of lines) {
+        const padded = padLine(line, width);
+        output.push(padded);
+    }
+    // Add empty line for spacing
+    output.push('');
+    return output.join('\n');
+}
+/**
+ * Renders a panel in plain text mode without box-drawing characters.
+ * Outputs clean text that's clipboard-friendly.
+ */
+function renderPlainPanel(lines, options = {}) {
+    const accent = options.accentColor ?? theme.primary;
+    const iconSegment = options.icon ? `${options.icon} ` : '';
+    const titleText = options.title ? `${iconSegment}${options.title}` : '';
+    const output = [];
+    if (titleText) {
+        output.push(`[${accent(titleText)}]`);
+        output.push('');
+    }
+    if (!lines.length) {
+        lines = [''];
+    }
+    for (const line of lines) {
+        output.push(line.trimEnd());
+    }
+    return output.join('\n');
+}
+export function measure(text) {
+    return stripAnsi(text).length;
+}
+export function stripAnsi(text) {
+    return text.replace(ANSI_REGEX, '');
+}
+function clampWidth(value, columns) {
+    const maxWidth = typeof columns === 'number' && Number.isFinite(columns) && columns > 0
+        ? Math.max(10, Math.floor(columns - 6))
+        : MAX_WIDTH;
+    const minWidth = Math.min(MIN_WIDTH, maxWidth);
+    const normalized = Math.min(MAX_WIDTH, Math.floor(value));
+    return Math.max(minWidth, Math.min(normalized, maxWidth));
+}
+function padLine(text, width) {
+    const visible = measure(text);
+    if (visible === width) {
+        return text;
+    }
+    if (visible > width) {
+        return truncate(text, width);
+    }
+    return `${text}${' '.repeat(width - visible)}`;
+}
+function truncate(text, width) {
+    const visible = stripAnsi(text);
+    if (visible.length <= width) {
+        return text;
+    }
+    const truncated = visible.slice(0, Math.max(1, width - 1));
+    return `${truncated}…`;
+}