cmp-standards 2.8.1 → 3.1.0

package/dist/utils/resilience.js

@@ -0,0 +1,499 @@
+/**
+ * Resilience Utilities
+ *
+ * Provides fault-tolerant patterns for network operations:
+ * - Retry with exponential backoff
+ * - Timeout protection
+ * - Circuit breaker pattern
+ * - Rate limiting helpers
+ *
+ * @version 2.9.1
+ */
+export class RetryableError extends Error {
+    retryAfter;
+    constructor(message, retryAfter) {
+        super(message);
+        this.retryAfter = retryAfter;
+        this.name = 'RetryableError';
+    }
+}
+export class TimeoutError extends Error {
+    constructor(message = 'Operation timed out') {
+        super(message);
+        this.name = 'TimeoutError';
+    }
+}
+export class CircuitOpenError extends Error {
+    resetAt;
+    constructor(message = 'Circuit breaker is open', resetAt) {
+        super(message);
+        this.resetAt = resetAt;
+        this.name = 'CircuitOpenError';
+    }
+}
+// =============================================================================
+// Retry with Exponential Backoff
+// =============================================================================
+const DEFAULT_RETRY_OPTIONS = {
+    maxRetries: 3,
+    baseDelay: 1000,
+    maxDelay: 30000,
+    backoffMultiplier: 2,
+    jitter: 0.1,
+};
+/**
+ * Calculate delay with exponential backoff and jitter
+ */
+function calculateDelay(attempt, options) {
+    const exponentialDelay = options.baseDelay * Math.pow(options.backoffMultiplier, attempt - 1);
+    const cappedDelay = Math.min(exponentialDelay, options.maxDelay);
+    // Add jitter to prevent thundering herd
+    const jitterRange = cappedDelay * options.jitter;
+    const jitter = Math.random() * jitterRange * 2 - jitterRange;
+    return Math.max(0, Math.round(cappedDelay + jitter));
+}
+/**
+ * Execute operation with retry logic and exponential backoff
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetch('https://api.example.com/data'),
+ *   { maxRetries: 3, baseDelay: 1000 }
+ * )
+ * ```
+ */
+export async function withRetry(operation, options) {
+    const opts = { ...DEFAULT_RETRY_OPTIONS, ...options };
+    let lastError;
+    for (let attempt = 1; attempt <= opts.maxRetries + 1; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            // Check if we should retry
+            const isRetryable = opts.isRetryable?.(error) ?? true;
+            const isLastAttempt = attempt > opts.maxRetries;
+            if (!isRetryable || isLastAttempt) {
+                throw error;
+            }
+            // Calculate delay
+            let delay;
+            if (error instanceof RetryableError && error.retryAfter) {
+                delay = error.retryAfter;
+            }
+            else {
+                delay = calculateDelay(attempt, opts);
+            }
+            // Notify callback
+            opts.onRetry?.(attempt, error, delay);
+            // Wait before retry
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+    }
+    throw lastError;
+}
+/**
+ * Check if an HTTP status code is retryable
+ */
+export function isRetryableHttpStatus(status) {
+    return (status === 408 || // Request Timeout
+        status === 429 || // Too Many Requests
+        status === 500 || // Internal Server Error
+        status === 502 || // Bad Gateway
+        status === 503 || // Service Unavailable
+        status === 504 // Gateway Timeout
+    );
+}
+/**
+ * Check if an error is a network/transient error
+ */
+export function isTransientError(error) {
+    if (error instanceof RetryableError)
+        return true;
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        return (message.includes('econnreset') ||
+            message.includes('econnrefused') ||
+            message.includes('etimedout') ||
+            message.includes('enotfound') ||
+            message.includes('network') ||
+            message.includes('timeout') ||
+            message.includes('rate limit') ||
+            message.includes('too many requests'));
+    }
+    return false;
+}
+// =============================================================================
+// Timeout Protection
+// =============================================================================
+/**
+ * Execute operation with timeout protection
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   fetch('https://api.example.com/data'),
+ *   { timeoutMs: 5000, fallback: null }
+ * )
+ * ```
+ */
+export async function withTimeout(promise, options) {
+    const { timeoutMs, fallback, message, onTimeout } = options;
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            onTimeout?.();
+            if (fallback !== undefined) {
+                // Don't reject, resolve with fallback
+            }
+            else {
+                reject(new TimeoutError(message ?? `Operation timed out after ${timeoutMs}ms`));
+            }
+        }, timeoutMs);
+    });
+    // If fallback provided, return it on timeout instead of rejecting
+    if (fallback !== undefined) {
+        const fallbackPromise = new Promise(resolve => {
+            setTimeout(() => {
+                onTimeout?.();
+                resolve(fallback);
+            }, timeoutMs);
+        });
+        try {
+            const result = await Promise.race([promise, fallbackPromise]);
+            clearTimeout(timeoutId);
+            return result;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            throw error;
+        }
+    }
+    try {
+        const result = await Promise.race([promise, timeoutPromise]);
+        clearTimeout(timeoutId);
+        return result;
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        throw error;
+    }
+}
+/**
+ * Create an AbortController with automatic timeout
+ */
+export function createTimeoutController(timeoutMs) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    return {
+        controller,
+        cleanup: () => clearTimeout(timeoutId),
+    };
+}
+// =============================================================================
+// Circuit Breaker Pattern
+// =============================================================================
+const DEFAULT_CIRCUIT_OPTIONS = {
+    failureThreshold: 5,
+    resetTimeout: 30000,
+    successThreshold: 2,
+};
+/**
+ * Circuit Breaker for protecting against cascade failures
+ *
+ * @example
+ * ```typescript
+ * const breaker = new CircuitBreaker({ failureThreshold: 5 })
+ *
+ * try {
+ *   const result = await breaker.execute(() => riskyOperation())
+ * } catch (error) {
+ *   if (error instanceof CircuitOpenError) {
+ *     // Circuit is open, use fallback
+ *   }
+ * }
+ * ```
+ */
+export class CircuitBreaker {
+    state = 'closed';
+    failures = 0;
+    successes = 0;
+    lastFailureTime = 0;
+    options;
+    constructor(options) {
+        this.options = { ...DEFAULT_CIRCUIT_OPTIONS, ...options };
+    }
+    /**
+     * Get current circuit state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get circuit statistics
+     */
+    getStats() {
+        return {
+            state: this.state,
+            failures: this.failures,
+            successes: this.successes,
+            lastFailureTime: this.lastFailureTime,
+        };
+    }
+    /**
+     * Execute operation through circuit breaker
+     */
+    async execute(operation) {
+        // Check if circuit should transition from open to half-open
+        if (this.state === 'open') {
+            const timeSinceFailure = Date.now() - this.lastFailureTime;
+            if (timeSinceFailure >= this.options.resetTimeout) {
+                this.transitionTo('half-open');
+            }
+            else {
+                throw new CircuitOpenError(`Circuit breaker is open. Retry after ${this.options.resetTimeout - timeSinceFailure}ms`, this.lastFailureTime + this.options.resetTimeout);
+            }
+        }
+        try {
+            const result = await operation();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    /**
+     * Record successful operation
+     */
+    onSuccess() {
+        this.failures = 0;
+        if (this.state === 'half-open') {
+            this.successes++;
+            if (this.successes >= this.options.successThreshold) {
+                this.transitionTo('closed');
+            }
+        }
+    }
+    /**
+     * Record failed operation
+     */
+    onFailure() {
+        this.failures++;
+        this.lastFailureTime = Date.now();
+        this.successes = 0;
+        if (this.state === 'half-open') {
+            this.transitionTo('open');
+        }
+        else if (this.state === 'closed' && this.failures >= this.options.failureThreshold) {
+            this.transitionTo('open');
+        }
+    }
+    /**
+     * Transition to new state
+     */
+    transitionTo(newState) {
+        if (this.state !== newState) {
+            this.state = newState;
+            this.options.onStateChange?.(newState);
+            if (newState === 'closed') {
+                this.failures = 0;
+                this.successes = 0;
+            }
+            else if (newState === 'half-open') {
+                this.successes = 0;
+            }
+        }
+    }
+    /**
+     * Manually reset the circuit breaker
+     */
+    reset() {
+        this.transitionTo('closed');
+    }
+    /**
+     * Manually trip the circuit breaker
+     */
+    trip() {
+        this.lastFailureTime = Date.now();
+        this.transitionTo('open');
+    }
+}
+// =============================================================================
+// Combined Utilities
+// =============================================================================
+/**
+ * Execute operation with retry, timeout, and circuit breaker
+ *
+ * @example
+ * ```typescript
+ * const breaker = new CircuitBreaker()
+ *
+ * const result = await withResilience(
+ *   () => fetch('https://api.example.com/data'),
+ *   {
+ *     retry: { maxRetries: 3 },
+ *     timeout: { timeoutMs: 5000 },
+ *     circuitBreaker: breaker
+ *   }
+ * )
+ * ```
+ */
+export async function withResilience(operation, options) {
+    const { retry, timeout, circuitBreaker } = options;
+    // Wrap with timeout if specified
+    const timedOperation = timeout
+        ? () => withTimeout(operation(), timeout)
+        : operation;
+    // Wrap with retry if specified
+    const retriedOperation = retry
+        ? () => withRetry(timedOperation, retry)
+        : timedOperation;
+    // Wrap with circuit breaker if specified
+    if (circuitBreaker) {
+        return circuitBreaker.execute(retriedOperation);
+    }
+    return retriedOperation();
+}
+// =============================================================================
+// Mutex for Singleton Initialization
+// =============================================================================
+/**
+ * Simple mutex for protecting async initialization
+ *
+ * @example
+ * ```typescript
+ * const initMutex = new AsyncMutex()
+ * let instance: Client | null = null
+ *
+ * async function getInstance() {
+ *   if (instance) return instance
+ *   return initMutex.runExclusive(async () => {
+ *     if (instance) return instance // Double-check after acquiring lock
+ *     instance = await createClient()
+ *     return instance
+ *   })
+ * }
+ * ```
+ */
+export class AsyncMutex {
+    locked = false;
+    queue = [];
+    /**
+     * Check if mutex is currently locked
+     */
+    isLocked() {
+        return this.locked;
+    }
+    /**
+     * Acquire the mutex lock
+     */
+    async acquire() {
+        if (!this.locked) {
+            this.locked = true;
+            return;
+        }
+        return new Promise(resolve => {
+            this.queue.push(resolve);
+        });
+    }
+    /**
+     * Release the mutex lock
+     */
+    release() {
+        const next = this.queue.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.locked = false;
+        }
+    }
+    /**
+     * Run operation exclusively (acquires and releases automatically)
+     */
+    async runExclusive(operation) {
+        await this.acquire();
+        try {
+            return await operation();
+        }
+        finally {
+            this.release();
+        }
+    }
+}
+// =============================================================================
+// Safe Cache Operations
+// =============================================================================
+/**
+ * Execute cache operation safely (returns null on error instead of throwing)
+ */
+export async function safeCacheGet(operation, context) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        console.warn(`[SafeCache] Get failed${context ? ` for ${context}` : ''}:`, error);
+        return null;
+    }
+}
+/**
+ * Execute cache set operation safely (returns success boolean)
+ */
+export async function safeCacheSet(operation, context) {
+    try {
+        await operation();
+        return true;
+    }
+    catch (error) {
+        console.warn(`[SafeCache] Set failed${context ? ` for ${context}` : ''}:`, error);
+        return false;
+    }
+}
+/**
+ * Process items in batches with individual error handling
+ *
+ * @example
+ * ```typescript
+ * const result = await processBatch(
+ *   items,
+ *   async (item) => await processItem(item),
+ *   { chunkSize: 10, concurrency: 5 }
+ * )
+ * console.log(`Processed ${result.succeeded.length}/${result.total}`)
+ * ```
+ */
+export async function processBatch(items, processor, options) {
+    const { chunkSize = 10, delayBetweenChunks = 0, onProgress } = options ?? {};
+    const succeeded = [];
+    const failed = [];
+    let processed = 0;
+    for (let i = 0; i < items.length; i += chunkSize) {
+        const chunk = items.slice(i, i + chunkSize);
+        const results = await Promise.allSettled(chunk.map((item, idx) => processor(item, i + idx)));
+        for (let j = 0; j < results.length; j++) {
+            const result = results[j];
+            processed++;
+            if (result.status === 'fulfilled') {
+                succeeded.push(result.value);
+            }
+            else {
+                failed.push({ item: chunk[j], error: result.reason });
+            }
+            onProgress?.(processed, items.length);
+        }
+        if (delayBetweenChunks > 0 && i + chunkSize < items.length) {
+            await new Promise(resolve => setTimeout(resolve, delayBetweenChunks));
+        }
+    }
+    return {
+        succeeded,
+        failed,
+        total: items.length,
+        successRate: items.length > 0 ? succeeded.length / items.length : 1,
+    };
+}
+//# sourceMappingURL=resilience.js.map

package/dist/utils/resilience.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cmp-standards",
-  "version": "2.8.1",
+  "version": "3.1.0",
   "type": "module",
   "description": "Collective Memory Protocol - Persistent memory, cross-project learning, and multi-agent collaboration",
   "main": "dist/index.js",
@@ -53,6 +53,8 @@
     "express": "^4.18.2",
     "glob": "^10.3.10",
     "gray-matter": "^4.0.3",
+    "ora": "^8.0.0",
+    "inquirer": "^9.2.0",
     "mysql2": ">=3.0.0",
     "open": "^10.0.0",
     "simple-git": "^3.30.0",
@@ -72,6 +74,7 @@
     "@types/cors": "^2.8.17",
     "@types/eslint": "^8.56.0",
     "@types/express": "^4.17.21",
+    "@types/inquirer": "^9.0.7",
     "@types/node": "^20.11.0",
     "@typescript-eslint/eslint-plugin": "^6.19.0",
     "@typescript-eslint/parser": "^6.19.0",
@@ -100,6 +103,14 @@
     "./eslint": {
       "import": "./dist/eslint/index.js",
       "types": "./dist/eslint/index.d.ts"
+    },
+    "./testing": {
+      "import": "./dist/testing/index.js",
+      "types": "./dist/testing/index.d.ts"
+    },
+    "./plugins": {
+      "import": "./dist/plugins/index.js",
+      "types": "./dist/plugins/index.d.ts"
     }
   }
 }