@aiassesstech/nole 0.4.15 → 0.6.0

package/dist/resilience/circuit-breaker.js

@@ -0,0 +1,102 @@
+/**
+ * Circuit Breaker — Three-state pattern for external service protection.
+ *
+ * CLOSED → requests pass through, failures counted
+ * OPEN → requests rejected immediately, cooldown timer running
+ * HALF-OPEN → single probe request allowed, success closes, failure reopens
+ *
+ * @see SPEC-nole-operational-resilience.md §3
+ */
+export class CircuitBreaker {
+    config;
+    state = 'closed';
+    failures = [];
+    lastStateChange = Date.now();
+    currentCooldownMs;
+    consecutiveOpenings = 0;
+    probeAllowed = false;
+    constructor(config) {
+        this.config = config;
+        this.currentCooldownMs = config.cooldownMs;
+    }
+    canExecute() {
+        this.pruneOldFailures();
+        switch (this.state) {
+            case 'closed':
+                return true;
+            case 'open': {
+                const elapsed = Date.now() - this.lastStateChange;
+                if (elapsed >= this.currentCooldownMs) {
+                    this.transition('half-open');
+                    this.probeAllowed = false;
+                    return true;
+                }
+                return false;
+            }
+            case 'half-open':
+                return false;
+        }
+    }
+    recordSuccess() {
+        if (this.state === 'half-open') {
+            this.consecutiveOpenings = 0;
+            this.currentCooldownMs = this.config.cooldownMs;
+            this.transition('closed');
+            this.failures = [];
+        }
+    }
+    recordFailure(error) {
+        const ts = Date.now();
+        switch (this.state) {
+            case 'closed':
+                this.failures.push({ timestamp: ts, error });
+                this.pruneOldFailures();
+                if (this.failures.length >= this.config.failureThreshold) {
+                    this.consecutiveOpenings++;
+                    this.currentCooldownMs = Math.min(this.config.cooldownMs * Math.pow(this.config.cooldownMultiplier, this.consecutiveOpenings - 1), this.config.maxCooldownMs);
+                    this.transition('open');
+                }
+                break;
+            case 'half-open':
+                this.consecutiveOpenings++;
+                this.currentCooldownMs = Math.min(this.currentCooldownMs * this.config.cooldownMultiplier, this.config.maxCooldownMs);
+                this.transition('open');
+                break;
+        }
+    }
+    isFailureStatus(status) {
+        return this.config.failureStatusCodes.includes(status);
+    }
+    getState() {
+        if (this.state === 'open') {
+            const elapsed = Date.now() - this.lastStateChange;
+            if (elapsed >= this.currentCooldownMs) {
+                this.transition('half-open');
+            }
+        }
+        return this.state;
+    }
+    getStatus() {
+        this.pruneOldFailures();
+        return {
+            state: this.getState(),
+            failureCount: this.failures.length,
+            consecutiveOpenings: this.consecutiveOpenings,
+            currentCooldownMs: this.currentCooldownMs,
+            lastStateChange: this.lastStateChange,
+            recentFailures: this.failures.slice(-3).map(f => f.error),
+        };
+    }
+    transition(to) {
+        const from = this.state;
+        this.state = to;
+        this.lastStateChange = Date.now();
+        this.probeAllowed = false;
+        this.config.onStateChange?.(from, to, this.config.name);
+    }
+    pruneOldFailures() {
+        const cutoff = Date.now() - this.config.failureWindowMs;
+        this.failures = this.failures.filter(f => f.timestamp > cutoff);
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/resilience/circuit-breaker.js.map

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

package/dist/resilience/index.d.ts

@@ -0,0 +1,8 @@
+export { CircuitBreaker, type CircuitBreakerConfig, type CircuitState } from './circuit-breaker.js';
+export { type RetryConfig, DEFAULT_RETRY_CONFIG, calculateDelay, isRetryable, extractRetryAfter, sleep, } from './retry.js';
+export { ResilientClient, CircuitOpenError, type ResilientClientConfig, type ResilientResponse, } from './resilient-client.js';
+export { ServiceRegistry, type ServiceHealth, type ServiceStatus, type RegistrySnapshot, } from './service-registry.js';
+export { PostQueue, type QueuedPost, type PostPlatform, type PostQueueConfig, DEFAULT_QUEUE_CONFIG, } from './post-queue.js';
+export { QueueDrain, type PostSender, type QueueDrainConfig, DEFAULT_DRAIN_CONFIG, } from './queue-drain.js';
+export { PLATFORM_API_BREAKER, X_API_BREAKER, MOLTBOOK_API_BREAKER, BLOCKCHAIN_BREAKER, } from './service-configs.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/resilience/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resilience/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpG,OAAO,EACL,KAAK,WAAW,EAChB,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,SAAS,EACT,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,UAAU,EACV,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/resilience/index.js

@@ -0,0 +1,8 @@
+export { CircuitBreaker } from './circuit-breaker.js';
+export { DEFAULT_RETRY_CONFIG, calculateDelay, isRetryable, extractRetryAfter, sleep, } from './retry.js';
+export { ResilientClient, CircuitOpenError, } from './resilient-client.js';
+export { ServiceRegistry, } from './service-registry.js';
+export { PostQueue, DEFAULT_QUEUE_CONFIG, } from './post-queue.js';
+export { QueueDrain, DEFAULT_DRAIN_CONFIG, } from './queue-drain.js';
+export { PLATFORM_API_BREAKER, X_API_BREAKER, MOLTBOOK_API_BREAKER, BLOCKCHAIN_BREAKER, } from './service-configs.js';
+//# sourceMappingURL=index.js.map

package/dist/resilience/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resilience/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgD,MAAM,sBAAsB,CAAC;AAEpG,OAAO,EAEL,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,gBAAgB,GAGjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,eAAe,GAIhB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,SAAS,EAIT,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,UAAU,EAGV,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/resilience/post-queue.d.ts

@@ -0,0 +1,41 @@
+/**
+ * PostQueue — Durable queue for social media posts during outages.
+ *
+ * When X/Twitter or MoltBook circuit is open, posts are queued to
+ * a JSON file and drained when the service recovers.
+ *
+ * @see SPEC-nole-operational-resilience.md §7
+ */
+export type PostPlatform = 'x-twitter' | 'moltbook';
+export interface QueuedPost {
+    id: string;
+    platform: PostPlatform;
+    content: string;
+    metadata: Record<string, unknown>;
+    queuedAt: number;
+    retries: number;
+    lastRetryAt: number | null;
+    error: string | null;
+}
+export interface PostQueueConfig {
+    dataDir: string;
+    maxQueueSize: number;
+    maxRetries: number;
+    maxAgeMs: number;
+}
+export declare const DEFAULT_QUEUE_CONFIG: PostQueueConfig;
+export declare class PostQueue {
+    private config;
+    private queue;
+    private filePath;
+    constructor(config: PostQueueConfig);
+    enqueue(platform: PostPlatform, content: string, metadata?: Record<string, unknown>): QueuedPost;
+    dequeue(platform: PostPlatform): QueuedPost | null;
+    requeue(post: QueuedPost, error: string): void;
+    peek(platform: PostPlatform): QueuedPost[];
+    size(platform?: PostPlatform): number;
+    private pruneExpired;
+    private load;
+    private save;
+}
+//# sourceMappingURL=post-queue.d.ts.map

package/dist/resilience/post-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-queue.d.ts","sourceRoot":"","sources":["../../src/resilience/post-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,oBAAoB,EAAE,eAKlC,CAAC;AAEF,qBAAa,SAAS;IAIR,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,QAAQ,CAAS;gBAEL,MAAM,EAAE,eAAe;IAK3C,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,UAAU;IAuBpG,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,GAAG,IAAI;IAclD,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAY9C,IAAI,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU,EAAE;IAK1C,IAAI,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM;IAQrC,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,IAAI;CAWb"}

package/dist/resilience/post-queue.js

@@ -0,0 +1,106 @@
+/**
+ * PostQueue — Durable queue for social media posts during outages.
+ *
+ * When X/Twitter or MoltBook circuit is open, posts are queued to
+ * a JSON file and drained when the service recovers.
+ *
+ * @see SPEC-nole-operational-resilience.md §7
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export const DEFAULT_QUEUE_CONFIG = {
+    dataDir: '',
+    maxQueueSize: 100,
+    maxRetries: 5,
+    maxAgeMs: 24 * 60 * 60 * 1000, // 24h
+};
+export class PostQueue {
+    config;
+    queue = [];
+    filePath;
+    constructor(config) {
+        this.config = config;
+        this.filePath = path.join(config.dataDir, 'post-queue.json');
+        this.load();
+    }
+    enqueue(platform, content, metadata = {}) {
+        this.pruneExpired();
+        if (this.queue.length >= this.config.maxQueueSize) {
+            throw new Error(`Post queue full (${this.config.maxQueueSize} items) — cannot enqueue`);
+        }
+        const post = {
+            id: `post_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+            platform,
+            content,
+            metadata,
+            queuedAt: Date.now(),
+            retries: 0,
+            lastRetryAt: null,
+            error: null,
+        };
+        this.queue.push(post);
+        this.save();
+        return post;
+    }
+    dequeue(platform) {
+        this.pruneExpired();
+        const idx = this.queue.findIndex(p => p.platform === platform && p.retries < this.config.maxRetries);
+        if (idx === -1)
+            return null;
+        const [post] = this.queue.splice(idx, 1);
+        this.save();
+        return post;
+    }
+    requeue(post, error) {
+        post.retries++;
+        post.lastRetryAt = Date.now();
+        post.error = error;
+        if (post.retries < this.config.maxRetries) {
+            this.queue.push(post);
+        }
+        this.save();
+    }
+    peek(platform) {
+        this.pruneExpired();
+        return this.queue.filter(p => p.platform === platform);
+    }
+    size(platform) {
+        this.pruneExpired();
+        if (platform) {
+            return this.queue.filter(p => p.platform === platform).length;
+        }
+        return this.queue.length;
+    }
+    pruneExpired() {
+        const cutoff = Date.now() - this.config.maxAgeMs;
+        const before = this.queue.length;
+        this.queue = this.queue.filter(p => p.queuedAt > cutoff && p.retries < this.config.maxRetries);
+        if (this.queue.length !== before) {
+            this.save();
+        }
+    }
+    load() {
+        try {
+            if (fs.existsSync(this.filePath)) {
+                const data = fs.readFileSync(this.filePath, 'utf-8');
+                this.queue = JSON.parse(data);
+            }
+        }
+        catch {
+            this.queue = [];
+        }
+    }
+    save() {
+        try {
+            const dir = path.dirname(this.filePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(this.filePath, JSON.stringify(this.queue, null, 2), 'utf-8');
+        }
+        catch {
+            // Non-fatal — queue is best-effort durable
+        }
+    }
+}
+//# sourceMappingURL=post-queue.js.map

package/dist/resilience/post-queue.js.map

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

package/dist/resilience/queue-drain.d.ts

@@ -0,0 +1,35 @@
+/**
+ * QueueDrain — Periodic processor that drains the PostQueue when
+ * service circuits recover to closed or half-open.
+ *
+ * @see SPEC-nole-operational-resilience.md §7.2
+ */
+import type { PostQueue, PostPlatform } from './post-queue.js';
+import type { ServiceRegistry } from './service-registry.js';
+export type PostSender = (platform: PostPlatform, content: string, metadata: Record<string, unknown>) => Promise<void>;
+export interface QueueDrainConfig {
+    intervalMs: number;
+    batchSize: number;
+    interPostDelayMs: number;
+    logger?: {
+        debug: (msg: string, meta?: Record<string, unknown>) => void;
+        warn: (msg: string, meta?: Record<string, unknown>) => void;
+        error: (msg: string, meta?: Record<string, unknown>) => void;
+    };
+}
+export declare const DEFAULT_DRAIN_CONFIG: QueueDrainConfig;
+export declare class QueueDrain {
+    private queue;
+    private registry;
+    private sender;
+    private config;
+    private timer;
+    private running;
+    private logger;
+    constructor(queue: PostQueue, registry: ServiceRegistry, sender: PostSender, config?: QueueDrainConfig);
+    start(): void;
+    stop(): void;
+    drain(): Promise<number>;
+    isRunning(): boolean;
+}
+//# sourceMappingURL=queue-drain.d.ts.map

package/dist/resilience/queue-drain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-drain.d.ts","sourceRoot":"","sources":["../../src/resilience/queue-drain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC7D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC5D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAC9D,CAAC;CACH;AAED,eAAO,MAAM,oBAAoB,EAAE,gBAIlC,CAAC;AAEF,qBAAa,UAAU;IAMnB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IARhB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAA0C;gBAG9C,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,UAAU,EAClB,MAAM,GAAE,gBAAuC;IASzD,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAQN,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAgD9B,SAAS,IAAI,OAAO;CAGrB"}

package/dist/resilience/queue-drain.js

@@ -0,0 +1,92 @@
+/**
+ * QueueDrain — Periodic processor that drains the PostQueue when
+ * service circuits recover to closed or half-open.
+ *
+ * @see SPEC-nole-operational-resilience.md §7.2
+ */
+export const DEFAULT_DRAIN_CONFIG = {
+    intervalMs: 60_000,
+    batchSize: 5,
+    interPostDelayMs: 5_000,
+};
+export class QueueDrain {
+    queue;
+    registry;
+    sender;
+    config;
+    timer = null;
+    running = false;
+    logger;
+    constructor(queue, registry, sender, config = DEFAULT_DRAIN_CONFIG) {
+        this.queue = queue;
+        this.registry = registry;
+        this.sender = sender;
+        this.config = config;
+        this.logger = config.logger ?? {
+            debug: () => { },
+            warn: () => { },
+            error: () => { },
+        };
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => void this.drain(), this.config.intervalMs);
+        this.logger.debug('Queue drain started', { intervalMs: this.config.intervalMs });
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.logger.debug('Queue drain stopped');
+    }
+    async drain() {
+        if (this.running)
+            return 0;
+        this.running = true;
+        let sent = 0;
+        try {
+            const platforms = ['x-twitter', 'moltbook'];
+            for (const platform of platforms) {
+                if (!this.registry.isAvailable(platform)) {
+                    this.logger.debug(`${platform}: circuit still open, skipping drain`);
+                    continue;
+                }
+                const queued = this.queue.size(platform);
+                if (queued === 0)
+                    continue;
+                this.logger.debug(`${platform}: draining ${queued} queued posts`);
+                for (let i = 0; i < this.config.batchSize; i++) {
+                    const post = this.queue.dequeue(platform);
+                    if (!post)
+                        break;
+                    try {
+                        await this.sender(platform, post.content, post.metadata);
+                        sent++;
+                        this.registry.recordSuccess(platform);
+                        this.logger.debug(`${platform}: sent queued post ${post.id}`);
+                        if (i < this.config.batchSize - 1) {
+                            await new Promise(r => setTimeout(r, this.config.interPostDelayMs));
+                        }
+                    }
+                    catch (err) {
+                        const error = err instanceof Error ? err.message : String(err);
+                        this.queue.requeue(post, error);
+                        this.registry.recordFailure(platform);
+                        this.logger.warn(`${platform}: failed to send ${post.id}, requeued`, { error });
+                        break;
+                    }
+                }
+            }
+        }
+        finally {
+            this.running = false;
+        }
+        return sent;
+    }
+    isRunning() {
+        return this.timer !== null;
+    }
+}
+//# sourceMappingURL=queue-drain.js.map

package/dist/resilience/queue-drain.js.map

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

package/dist/resilience/resilient-client.d.ts

@@ -0,0 +1,54 @@
+/**
+ * ResilientClient — Unified wrapper combining circuit breaker + retry.
+ *
+ * Replaces raw fetch() calls in Nole's service clients with
+ * protection against transient failures and cascading outages.
+ *
+ * @see SPEC-nole-operational-resilience.md §5
+ */
+import { type CircuitBreakerConfig, type CircuitState } from './circuit-breaker.js';
+import { type RetryConfig } from './retry.js';
+export declare class CircuitOpenError extends Error {
+    readonly service: string;
+    readonly state: CircuitState;
+    readonly cooldownRemainingMs: number;
+    constructor(service: string, cooldownRemainingMs: number);
+}
+export interface ResilientClientConfig {
+    circuitBreaker: CircuitBreakerConfig;
+    retry?: RetryConfig;
+    timeoutMs: number;
+    logger?: {
+        debug: (msg: string, meta?: Record<string, unknown>) => void;
+        warn: (msg: string, meta?: Record<string, unknown>) => void;
+        error: (msg: string, meta?: Record<string, unknown>) => void;
+    };
+    fetchFn?: typeof globalThis.fetch;
+}
+export interface ResilientResponse {
+    status: number;
+    headers: Headers;
+    body: string;
+    attempts: number;
+    totalDurationMs: number;
+}
+export declare class ResilientClient {
+    private config;
+    private breaker;
+    private retryConfig;
+    private timeoutMs;
+    private logger;
+    private fetchFn;
+    constructor(config: ResilientClientConfig);
+    execute(url: string, init?: RequestInit): Promise<ResilientResponse>;
+    getCircuitStatus(): {
+        state: CircuitState;
+        failureCount: number;
+        consecutiveOpenings: number;
+        currentCooldownMs: number;
+        lastStateChange: number;
+        recentFailures: string[];
+    };
+    get serviceName(): string;
+}
+//# sourceMappingURL=resilient-client.d.ts.map

package/dist/resilience/resilient-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilient-client.d.ts","sourceRoot":"","sources":["../../src/resilience/resilient-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAkB,KAAK,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EACL,KAAK,WAAW,EAMjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;gBAEzB,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM;CAOzD;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,oBAAoB,CAAC;IACrC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC7D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAC5D,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAC9D,CAAC;IACF,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,eAAe;IAOd,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,OAAO,CAA0B;gBAErB,MAAM,EAAE,qBAAqB;IAY3C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyF1E,gBAAgB;;;;;;;;IAIhB,IAAI,WAAW,IAAI,MAAM,CAExB;CACF"}

package/dist/resilience/resilient-client.js

@@ -0,0 +1,120 @@
+/**
+ * ResilientClient — Unified wrapper combining circuit breaker + retry.
+ *
+ * Replaces raw fetch() calls in Nole's service clients with
+ * protection against transient failures and cascading outages.
+ *
+ * @see SPEC-nole-operational-resilience.md §5
+ */
+import { CircuitBreaker } from './circuit-breaker.js';
+import { DEFAULT_RETRY_CONFIG, calculateDelay, isRetryable, extractRetryAfter, sleep, } from './retry.js';
+export class CircuitOpenError extends Error {
+    service;
+    state;
+    cooldownRemainingMs;
+    constructor(service, cooldownRemainingMs) {
+        super(`Circuit breaker OPEN for ${service} — next probe in ${Math.ceil(cooldownRemainingMs / 1000)}s`);
+        this.name = 'CircuitOpenError';
+        this.service = service;
+        this.state = 'open';
+        this.cooldownRemainingMs = cooldownRemainingMs;
+    }
+}
+export class ResilientClient {
+    config;
+    breaker;
+    retryConfig;
+    timeoutMs;
+    logger;
+    fetchFn;
+    constructor(config) {
+        this.config = config;
+        this.breaker = new CircuitBreaker(config.circuitBreaker);
+        this.retryConfig = config.retry ?? DEFAULT_RETRY_CONFIG;
+        this.timeoutMs = config.timeoutMs;
+        this.fetchFn = config.fetchFn ?? globalThis.fetch;
+        this.logger = config.logger ?? {
+            debug: () => { },
+            warn: () => { },
+            error: () => { },
+        };
+    }
+    async execute(url, init) {
+        const startTime = Date.now();
+        const service = this.config.circuitBreaker.name;
+        if (!this.breaker.canExecute()) {
+            const status = this.breaker.getStatus();
+            const remaining = status.currentCooldownMs - (Date.now() - status.lastStateChange);
+            throw new CircuitOpenError(service, Math.max(0, remaining));
+        }
+        let lastError = null;
+        const maxAttempts = 1 + this.retryConfig.maxRetries;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            try {
+                this.logger.debug(`${service}: attempt ${attempt + 1}/${maxAttempts}`, { url });
+                const controller = new AbortController();
+                const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+                const resp = await this.fetchFn(url, {
+                    ...init,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                if (this.breaker.isFailureStatus(resp.status)) {
+                    const body = await resp.text().catch(() => '');
+                    this.breaker.recordFailure(`HTTP ${resp.status}: ${body.slice(0, 200)}`);
+                    if (isRetryable(resp.status, this.retryConfig) && attempt < maxAttempts - 1) {
+                        const delay = resp.status === 429
+                            ? (extractRetryAfter(resp.headers) ?? calculateDelay(attempt, this.retryConfig))
+                            : calculateDelay(attempt, this.retryConfig);
+                        this.logger.warn(`${service}: HTTP ${resp.status}, retrying in ${delay}ms`, {
+                            attempt: attempt + 1, url,
+                        });
+                        await sleep(delay);
+                        continue;
+                    }
+                    throw new Error(`${service}: HTTP ${resp.status} after ${attempt + 1} attempts`);
+                }
+                if (resp.status >= 200 && resp.status < 500) {
+                    this.breaker.recordSuccess();
+                }
+                if (resp.status === 429 && attempt < maxAttempts - 1) {
+                    const delay = extractRetryAfter(resp.headers) ?? calculateDelay(attempt, this.retryConfig);
+                    this.logger.warn(`${service}: rate limited (429), waiting ${delay}ms`, { url });
+                    await sleep(delay);
+                    continue;
+                }
+                const body = await resp.text();
+                return {
+                    status: resp.status,
+                    headers: resp.headers,
+                    body,
+                    attempts: attempt + 1,
+                    totalDurationMs: Date.now() - startTime,
+                };
+            }
+            catch (err) {
+                if (err instanceof CircuitOpenError)
+                    throw err;
+                const error = err instanceof Error ? err : new Error(String(err));
+                lastError = error;
+                this.breaker.recordFailure(error.message.slice(0, 200));
+                if (isRetryable(error, this.retryConfig) && attempt < maxAttempts - 1) {
+                    const delay = calculateDelay(attempt, this.retryConfig);
+                    this.logger.warn(`${service}: network error, retrying in ${delay}ms`, {
+                        attempt: attempt + 1, error: error.message.slice(0, 100),
+                    });
+                    await sleep(delay);
+                    continue;
+                }
+            }
+        }
+        throw lastError ?? new Error(`${service}: all ${maxAttempts} attempts failed`);
+    }
+    getCircuitStatus() {
+        return this.breaker.getStatus();
+    }
+    get serviceName() {
+        return this.config.circuitBreaker.name;
+    }
+}
+//# sourceMappingURL=resilient-client.js.map

package/dist/resilience/resilient-client.js.map

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

package/dist/resilience/retry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Retry logic — exponential backoff with jitter, Retry-After support.
+ *
+ * Retry is separate from the circuit breaker: the breaker decides whether
+ * to attempt at all, retry decides how many times to reattempt on failure.
+ *
+ * @see SPEC-nole-operational-resilience.md §4
+ */
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    jitterFactor: number;
+    retryableStatusCodes: number[];
+    retryOnNetworkError: boolean;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+export declare function calculateDelay(attempt: number, config: RetryConfig): number;
+export declare function isRetryable(statusOrError: number | Error, config: RetryConfig): boolean;
+export declare function extractRetryAfter(headers: Headers | Record<string, string>): number | null;
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=retry.d.ts.map