erosolar-cli 1.7.195 → 1.7.196

package/dist/ui/treeVisualizer.js

@@ -0,0 +1,247 @@
+/**
+ * Tree Visualizer - Claude Code style
+ * ASCII tree visualization for hierarchical data
+ */
+import { theme } from './theme.js';
+/**
+ * Format hierarchical data as ASCII tree
+ * Example:
+ *   src/
+ *   ├── components/
+ *   │   ├── Header.tsx
+ *   │   └── Footer.tsx
+ *   └── utils/
+ *       └── helpers.ts
+ */
+export function formatTree(node, options = {}, prefix = '', isLast = true, depth = 0) {
+    const showLines = options.showLines ?? true;
+    const maxDepth = options.maxDepth ?? Infinity;
+    const compact = options.compact ?? false;
+    if (depth > maxDepth) {
+        return '';
+    }
+    const lines = [];
+    // Build current line
+    const connector = showLines ? (isLast ? '└── ' : '├── ') : '  ';
+    const icon = node.icon ? `${node.icon} ` : '';
+    const metadata = node.metadata ? theme.ui.muted(` ${node.metadata}`) : '';
+    let label = node.label;
+    if (node.highlighted) {
+        label = theme.info(label);
+    }
+    else if (options.colorizeDepth) {
+        const colors = [theme.info, theme.success, theme.warning, theme.accent];
+        const colorFn = colors[depth % colors.length];
+        if (colorFn) {
+            label = colorFn(label);
+        }
+    }
+    const currentLine = `${prefix}${showLines ? theme.ui.muted(connector) : ''}${icon}${label}${metadata}`;
+    lines.push(currentLine);
+    // Process children
+    if (node.children && node.children.length > 0) {
+        const childPrefix = showLines
+            ? prefix + (isLast ? '    ' : '│   ')
+            : `${prefix}  `;
+        node.children.forEach((child, index) => {
+            const isLastChild = index === node.children.length - 1;
+            const childTree = formatTree(child, options, childPrefix, isLastChild, depth + 1);
+            if (childTree) {
+                if (!compact || index === 0) {
+                    lines.push(childTree);
+                }
+                else {
+                    lines.push(childTree);
+                }
+            }
+        });
+    }
+    return lines.join('\n');
+}
+/**
+ * Format file system tree
+ */
+export function formatFileTree(paths, options = {}) {
+    const tree = buildFileTree(paths);
+    return formatTree(tree, options);
+}
+/**
+ * Build tree structure from file paths
+ */
+function buildFileTree(paths) {
+    const root = { label: '.', children: [] };
+    const map = new Map();
+    map.set('', root);
+    // Sort paths for better display
+    const sortedPaths = [...paths].sort();
+    for (const path of sortedPaths) {
+        const parts = path.split('/').filter(p => p);
+        let currentPath = '';
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            if (!part)
+                continue;
+            const parentPath = currentPath;
+            currentPath = currentPath ? `${currentPath}/${part}` : part;
+            if (!map.has(currentPath)) {
+                const isFile = i === parts.length - 1 && !part.endsWith('/');
+                const icon = isFile ? getFileIcon(part) : '📁';
+                const node = {
+                    label: part,
+                    icon,
+                    children: isFile ? undefined : []
+                };
+                const parent = map.get(parentPath);
+                if (parent?.children) {
+                    parent.children.push(node);
+                }
+                map.set(currentPath, node);
+            }
+        }
+    }
+    return root;
+}
+/**
+ * Get icon for file based on extension
+ */
+function getFileIcon(filename) {
+    const ext = filename.split('.').pop()?.toLowerCase();
+    const iconMap = {
+        ts: '📘',
+        tsx: '⚛️',
+        js: '📜',
+        jsx: '⚛️',
+        json: '📋',
+        md: '📝',
+        txt: '📄',
+        css: '🎨',
+        scss: '🎨',
+        html: '🌐',
+        py: '🐍',
+        java: '☕',
+        go: '🔵',
+        rs: '🦀',
+        rb: '💎',
+        php: '🐘',
+        sh: '⚙️',
+        yml: '⚙️',
+        yaml: '⚙️',
+        xml: '📰',
+        svg: '🖼️',
+        png: '🖼️',
+        jpg: '🖼️',
+        gif: '🖼️'
+    };
+    return iconMap[ext || ''] || '📄';
+}
+/**
+ * Format dependency tree
+ */
+export function formatDependencyTree(packageName, dependencies, options = {}) {
+    const visited = new Set();
+    function buildNode(pkg, depth = 0) {
+        const deps = dependencies[pkg] || [];
+        const circular = visited.has(pkg);
+        if (circular) {
+            return {
+                label: pkg,
+                metadata: '(circular)',
+                icon: '🔄'
+            };
+        }
+        visited.add(pkg);
+        const children = depth < (options.maxDepth || 5)
+            ? deps.map(dep => buildNode(dep, depth + 1))
+            : [];
+        return {
+            label: pkg,
+            icon: '📦',
+            children: children.length > 0 ? children : undefined
+        };
+    }
+    const tree = buildNode(packageName);
+    return formatTree(tree, options);
+}
+/**
+ * Format simple bulleted list as tree
+ */
+export function formatBulletTree(items, indent = 0) {
+    return items.map((item) => {
+        const bullet = indent === 0 ? '•' : '◦';
+        const prefix = '  '.repeat(indent);
+        const line = `${prefix}${theme.info(bullet)} ${item.label}`;
+        if (item.items && item.items.length > 0) {
+            const children = formatBulletTree(item.items, indent + 1);
+            return `${line}\n${children}`;
+        }
+        return line;
+    }).join('\n');
+}
+/**
+ * Format git branch tree
+ */
+export function formatBranchTree(branches) {
+    // Build tree structure
+    const branchMap = new Map();
+    const roots = [];
+    branches.forEach(branch => {
+        const node = {
+            label: branch.name,
+            icon: branch.current ? '●' : '○',
+            highlighted: branch.current,
+            children: []
+        };
+        branchMap.set(branch.name, node);
+    });
+    branches.forEach(branch => {
+        const node = branchMap.get(branch.name);
+        if (!node)
+            return;
+        if (branch.parent) {
+            const parent = branchMap.get(branch.parent);
+            if (parent?.children) {
+                parent.children.push(node);
+            }
+            else {
+                roots.push(node);
+            }
+        }
+        else {
+            roots.push(node);
+        }
+    });
+    return roots.map(root => formatTree(root, { showLines: true })).join('\n\n');
+}
+/**
+ * Format directory summary with counts
+ */
+export function formatDirectorySummary(paths) {
+    const stats = {
+        directories: 0,
+        files: 0,
+        byType: new Map()
+    };
+    paths.forEach(path => {
+        if (path.endsWith('/')) {
+            stats.directories++;
+        }
+        else {
+            stats.files++;
+            const ext = path.split('.').pop()?.toLowerCase() || 'no-ext';
+            stats.byType.set(ext, (stats.byType.get(ext) || 0) + 1);
+        }
+    });
+    const lines = [];
+    lines.push(theme.info(`📁 ${stats.directories} directories, 📄 ${stats.files} files`));
+    if (stats.byType.size > 0) {
+        const types = Array.from(stats.byType.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5);
+        const typeStr = types
+            .map(([ext, count]) => `${ext}: ${count}`)
+            .join(theme.ui.muted(' · '));
+        lines.push(theme.ui.muted(`  ${typeStr}`));
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=treeVisualizer.js.map

package/dist/ui/treeVisualizer.js.map

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

package/dist/utils/asyncUtils.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Async Utilities Module
+ *
+ * Production-ready async patterns for rate limiting, throttling,
+ * concurrency control, and caching with TTL.
+ *
+ * Principal Investigator: Bo Shang
+ * Framework: erosolar-cli
+ */
+export interface RateLimiterConfig {
+    maxRequests: number;
+    windowMs: number;
+}
+export interface ThrottleConfig {
+    intervalMs: number;
+    leading?: boolean;
+    trailing?: boolean;
+}
+export interface CacheEntry<T> {
+    value: T;
+    expiresAt: number;
+}
+export interface CacheConfig {
+    ttlMs: number;
+    maxSize?: number;
+}
+export interface ConcurrencyConfig {
+    maxConcurrent: number;
+    timeout?: number;
+}
+export declare class RateLimiter {
+    private tokens;
+    private lastRefill;
+    private readonly maxTokens;
+    private readonly refillRate;
+    constructor(config: RateLimiterConfig);
+    private refill;
+    acquire(): Promise<void>;
+    tryAcquire(): boolean;
+    get availableTokens(): number;
+}
+export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, config: ThrottleConfig): (...args: Parameters<T>) => ReturnType<T> | undefined;
+export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delayMs: number): (...args: Parameters<T>) => void;
+export declare class TTLCache<K, V> {
+    private cache;
+    private readonly ttlMs;
+    private readonly maxSize;
+    constructor(config: CacheConfig);
+    get(key: K): V | undefined;
+    set(key: K, value: V, ttlMs?: number): void;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    clear(): void;
+    get size(): number;
+    private prune;
+}
+export declare function memoize<T extends (...args: unknown[]) => unknown>(fn: T, config: CacheConfig & {
+    keyFn?: (...args: Parameters<T>) => string;
+}): T;
+export declare class ConcurrencyPool {
+    private running;
+    private queue;
+    private readonly maxConcurrent;
+    private readonly timeout;
+    constructor(config: ConcurrencyConfig);
+    run<T>(fn: () => Promise<T>): Promise<T>;
+    private acquire;
+    private release;
+    get pending(): number;
+    get active(): number;
+}
+export declare function parallelMap<T, R>(items: T[], fn: (item: T, index: number) => Promise<R>, concurrency?: number): Promise<R[]>;
+export declare function sleep(ms: number): Promise<void>;
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, errorMessage?: string): Promise<T>;
+export declare function retry<T>(fn: () => Promise<T>, config?: {
+    maxRetries?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    backoffMultiplier?: number;
+    shouldRetry?: (error: unknown) => boolean;
+}): Promise<T>;
+declare const _default: {
+    RateLimiter: typeof RateLimiter;
+    TTLCache: typeof TTLCache;
+    ConcurrencyPool: typeof ConcurrencyPool;
+    throttle: typeof throttle;
+    debounce: typeof debounce;
+    memoize: typeof memoize;
+    parallelMap: typeof parallelMap;
+    sleep: typeof sleep;
+    withTimeout: typeof withTimeout;
+    retry: typeof retry;
+};
+export default _default;
+//# sourceMappingURL=asyncUtils.d.ts.map

package/dist/utils/asyncUtils.d.ts.map

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

package/dist/utils/asyncUtils.js

@@ -0,0 +1,286 @@
+/**
+ * Async Utilities Module
+ *
+ * Production-ready async patterns for rate limiting, throttling,
+ * concurrency control, and caching with TTL.
+ *
+ * Principal Investigator: Bo Shang
+ * Framework: erosolar-cli
+ */
+// ============================================================================
+// Rate Limiter (Token Bucket)
+// ============================================================================
+export class RateLimiter {
+    tokens;
+    lastRefill;
+    maxTokens;
+    refillRate;
+    constructor(config) {
+        this.maxTokens = config.maxRequests;
+        this.tokens = config.maxRequests;
+        this.refillRate = config.maxRequests / config.windowMs;
+        this.lastRefill = Date.now();
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const tokensToAdd = elapsed * this.refillRate;
+        this.tokens = Math.min(this.maxTokens, this.tokens + tokensToAdd);
+        this.lastRefill = now;
+    }
+    async acquire() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return;
+        }
+        // Wait for a token to become available
+        const waitTime = (1 - this.tokens) / this.refillRate;
+        await sleep(waitTime);
+        this.refill();
+        this.tokens -= 1;
+    }
+    tryAcquire() {
+        this.refill();
+        if (this.tokens >= 1) {
+            this.tokens -= 1;
+            return true;
+        }
+        return false;
+    }
+    get availableTokens() {
+        this.refill();
+        return Math.floor(this.tokens);
+    }
+}
+// ============================================================================
+// Throttle & Debounce
+// ============================================================================
+export function throttle(fn, config) {
+    let lastCall = 0;
+    let lastResult;
+    let pendingCall = null;
+    let pendingArgs = null;
+    const { intervalMs, leading = true, trailing = true } = config;
+    return function throttled(...args) {
+        const now = Date.now();
+        const elapsed = now - lastCall;
+        if (elapsed >= intervalMs) {
+            // Enough time has passed
+            if (leading || lastCall !== 0) {
+                lastCall = now;
+                lastResult = fn(...args);
+                return lastResult;
+            }
+        }
+        // Store args for potential trailing call
+        if (trailing) {
+            pendingArgs = args;
+            if (!pendingCall) {
+                pendingCall = setTimeout(() => {
+                    if (pendingArgs) {
+                        lastCall = Date.now();
+                        lastResult = fn(...pendingArgs);
+                        pendingArgs = null;
+                    }
+                    pendingCall = null;
+                }, intervalMs - elapsed);
+            }
+        }
+        return lastResult;
+    };
+}
+export function debounce(fn, delayMs) {
+    let timeoutId = null;
+    return function debounced(...args) {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => {
+            fn(...args);
+            timeoutId = null;
+        }, delayMs);
+    };
+}
+// ============================================================================
+// TTL Cache
+// ============================================================================
+export class TTLCache {
+    cache = new Map();
+    ttlMs;
+    maxSize;
+    constructor(config) {
+        this.ttlMs = config.ttlMs;
+        this.maxSize = config.maxSize ?? Infinity;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    set(key, value, ttlMs) {
+        // Evict oldest if at capacity
+        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.cache.delete(oldestKey);
+            }
+        }
+        this.cache.set(key, {
+            value,
+            expiresAt: Date.now() + (ttlMs ?? this.ttlMs),
+        });
+    }
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        this.prune();
+        return this.cache.size;
+    }
+    prune() {
+        const now = Date.now();
+        const keysToDelete = [];
+        this.cache.forEach((entry, key) => {
+            if (now > entry.expiresAt) {
+                keysToDelete.push(key);
+            }
+        });
+        keysToDelete.forEach(key => this.cache.delete(key));
+    }
+}
+// ============================================================================
+// Memoize with TTL
+// ============================================================================
+export function memoize(fn, config) {
+    const cache = new TTLCache(config);
+    const keyFn = config.keyFn ?? ((...args) => JSON.stringify(args));
+    return function memoized(...args) {
+        const key = keyFn(...args);
+        const cached = cache.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const result = fn(...args);
+        cache.set(key, result);
+        return result;
+    };
+}
+// ============================================================================
+// Concurrency Pool
+// ============================================================================
+export class ConcurrencyPool {
+    running = 0;
+    queue = [];
+    maxConcurrent;
+    timeout;
+    constructor(config) {
+        this.maxConcurrent = config.maxConcurrent;
+        this.timeout = config.timeout;
+    }
+    async run(fn) {
+        await this.acquire();
+        try {
+            if (this.timeout) {
+                return await withTimeout(fn(), this.timeout);
+            }
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+    async acquire() {
+        if (this.running < this.maxConcurrent) {
+            this.running++;
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            this.queue.push({ resolve, reject });
+        });
+    }
+    release() {
+        this.running--;
+        const next = this.queue.shift();
+        if (next) {
+            this.running++;
+            next.resolve();
+        }
+    }
+    get pending() {
+        return this.queue.length;
+    }
+    get active() {
+        return this.running;
+    }
+}
+// ============================================================================
+// Parallel Map with Concurrency Limit
+// ============================================================================
+export async function parallelMap(items, fn, concurrency = 5) {
+    const pool = new ConcurrencyPool({ maxConcurrent: concurrency });
+    return Promise.all(items.map((item, index) => pool.run(() => fn(item, index))));
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export async function withTimeout(promise, timeoutMs, errorMessage = 'Operation timed out') {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => reject(new Error(errorMessage)), timeoutMs);
+    });
+    try {
+        return await Promise.race([promise, timeoutPromise]);
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+export async function retry(fn, config = {}) {
+    const { maxRetries = 3, baseDelayMs = 1000, maxDelayMs = 30000, backoffMultiplier = 2, shouldRetry = () => true, } = config;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt === maxRetries || !shouldRetry(error)) {
+                throw error;
+            }
+            const delay = Math.min(baseDelayMs * Math.pow(backoffMultiplier, attempt), maxDelayMs);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+// ============================================================================
+// Exports
+// ============================================================================
+export default {
+    RateLimiter,
+    TTLCache,
+    ConcurrencyPool,
+    throttle,
+    debounce,
+    memoize,
+    parallelMap,
+    sleep,
+    withTimeout,
+    retry,
+};
+//# sourceMappingURL=asyncUtils.js.map

package/dist/utils/asyncUtils.js.map

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

package/dist/utils/errorUtils.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Enhanced error utilities for better debugging and error reporting
+ */
+import type { ErrorContext } from '../core/errors.js';
+export interface ErrorDetails {
+    message: string;
+    code?: string;
+    context?: ErrorContext;
+    stack?: string;
+    timestamp: string;
+}
+export declare function createErrorDetails(error: unknown, context?: ErrorContext, code?: string): ErrorDetails;
+export declare function formatErrorForLogging(error: unknown, context?: ErrorContext): string;
+export declare function isRetryableError(error: unknown): boolean;
+export declare function withRetry<T>(operation: () => Promise<T>, maxRetries?: number, delayMs?: number): Promise<T>;
+//# sourceMappingURL=errorUtils.d.ts.map