dual-brain 0.2.30 → 0.3.1

package/dist/src/provider-manager.js

@@ -0,0 +1,428 @@
+/**
+ * provider-manager.ts — Provider health, failover, and rate-limit management
+ *
+ * The "invisible failover" layer: when Claude is rate-limited, work seamlessly
+ * continues on GPT. When GPT is down, Claude handles everything.
+ *
+ * State storage:
+ *   - Provider states: .dual-brain/providers/{provider}.json (atomic writes)
+ *   - Global dispatch log: .dual-brain/dispatch-log.ndjson (append-only)
+ */
+import { existsSync, readFileSync, appendFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { atomicWriteJson, readJsonSafe } from './integrity.js';
+// ─── Constants ──────────────────────────────────────────────────────────────
+/** Maximum dispatches allowed per rolling window (default: 30 per 5 min). */
+export const MAX_DISPATCHES_PER_WINDOW = 30;
+/** Default rolling window in minutes. */
+export const DEFAULT_WINDOW_MINUTES = 5;
+/** Cooldown duration in ms when rate-limited without a known reset time. */
+const DEFAULT_COOLDOWN_MS = 5 * 60 * 1000;
+/** Consecutive failures before marking a provider as "down". */
+const DOWN_THRESHOLD = 5;
+/** Consecutive failures before marking a provider as "degraded". */
+const DEGRADED_THRESHOLD = 2;
+/** Known providers. */
+const KNOWN_PROVIDERS = ['anthropic', 'openai'];
+// ─── Path helpers ───────────────────────────────────────────────────────────
+function providersDir(cwd) {
+    return join(cwd || process.cwd(), '.dual-brain', 'providers');
+}
+function providerFile(provider, cwd) {
+    return join(providersDir(cwd), `${provider}.json`);
+}
+function dispatchLogPath(cwd) {
+    return join(cwd || process.cwd(), '.dual-brain', 'dispatch-log.ndjson');
+}
+// ─── Default state ──────────────────────────────────────────────────────────
+function defaultState(provider) {
+    const now = new Date().toISOString();
+    return {
+        provider,
+        status: 'healthy',
+        lastCheck: now,
+        lastSuccess: now,
+        remainingCapacity: 1,
+        recentDispatches: 0,
+        consecutiveFailures: 0,
+    };
+}
+// ─── Tier-to-model mapping (for failover) ───────────────────────────────────
+const TIER_MODELS = {
+    // tier 1: cheap/fast search
+    1: { anthropic: 'claude-haiku', openai: 'gpt-4.1-mini' },
+    // tier 2: routine execution
+    2: { anthropic: 'claude-sonnet', openai: 'gpt-4.1' },
+    // tier 3: complex reasoning
+    3: { anthropic: 'claude-sonnet', openai: 'o4-mini' },
+    // tier 4: heavy thinking / architecture
+    4: { anthropic: 'claude-opus', openai: 'o3' },
+};
+function modelForTier(tier, provider) {
+    const clamped = Math.max(1, Math.min(4, tier));
+    return TIER_MODELS[clamped]?.[provider] ?? (provider === 'anthropic' ? 'claude-sonnet' : 'gpt-4.1');
+}
+// Map a model name back to an approximate tier
+function tierForModel(model) {
+    const lower = model.toLowerCase();
+    if (lower.includes('haiku') || lower.includes('mini'))
+        return 1;
+    if (lower.includes('opus') || lower === 'o3')
+        return 4;
+    if (lower.includes('o4-mini'))
+        return 3;
+    return 2;
+}
+// ─── Provider state I/O ─────────────────────────────────────────────────────
+/**
+ * Get the current health state for a provider.
+ */
+export function getProviderState(provider, cwd) {
+    const p = provider === 'claude' ? 'anthropic' : provider;
+    const filePath = providerFile(p, cwd);
+    if (!existsSync(filePath)) {
+        return defaultState(p);
+    }
+    const raw = readJsonSafe(filePath);
+    if (!raw || typeof raw !== 'object') {
+        return defaultState(p);
+    }
+    const state = raw;
+    // Re-evaluate cooldown: if cooldownUntil has passed, transition to healthy
+    if (state.status === 'rate-limited' && state.cooldownUntil) {
+        const cooldownEnd = new Date(state.cooldownUntil).getTime();
+        if (Date.now() >= cooldownEnd) {
+            const updated = {
+                ...state,
+                status: 'healthy',
+                cooldownUntil: undefined,
+                consecutiveFailures: 0,
+                remainingCapacity: 0.5, // conservative after cooldown
+                lastCheck: new Date().toISOString(),
+            };
+            atomicWriteJson(filePath, updated);
+            return updated;
+        }
+    }
+    // Attach recent dispatch count from the log
+    const dispatches = countRecentDispatches(p, DEFAULT_WINDOW_MINUTES, cwd);
+    return {
+        provider: p,
+        status: state.status || 'healthy',
+        lastCheck: state.lastCheck || new Date().toISOString(),
+        lastSuccess: state.lastSuccess || new Date().toISOString(),
+        lastFailure: state.lastFailure,
+        cooldownUntil: state.cooldownUntil,
+        remainingCapacity: typeof state.remainingCapacity === 'number' ? state.remainingCapacity : 1,
+        recentDispatches: dispatches,
+        consecutiveFailures: typeof state.consecutiveFailures === 'number' ? state.consecutiveFailures : 0,
+    };
+}
+/**
+ * Get health states for all known providers.
+ */
+export function getAllProviderStates(cwd) {
+    return KNOWN_PROVIDERS.map(p => getProviderState(p, cwd));
+}
+// ─── State mutations ────────────────────────────────────────────────────────
+function saveState(state, cwd) {
+    const filePath = providerFile(state.provider, cwd);
+    atomicWriteJson(filePath, state);
+}
+/**
+ * Record a successful dispatch to a provider.
+ */
+export function recordSuccess(provider, model, cwd) {
+    const p = (provider === 'claude' ? 'anthropic' : provider);
+    const current = getProviderState(p, cwd);
+    const updated = {
+        ...current,
+        status: 'healthy',
+        lastCheck: new Date().toISOString(),
+        lastSuccess: new Date().toISOString(),
+        cooldownUntil: undefined,
+        consecutiveFailures: 0,
+        // Nudge capacity up on success, cap at 1
+        remainingCapacity: Math.min(1, current.remainingCapacity + 0.1),
+    };
+    saveState(updated, cwd);
+}
+/**
+ * Record a dispatch failure. Detects rate limits automatically.
+ */
+export function recordFailure(provider, model, error, cwd) {
+    const p = (provider === 'claude' ? 'anthropic' : provider);
+    // Check if this is a rate limit
+    const rl = detectRateLimit(error);
+    if (rl.isRateLimit) {
+        recordRateLimit(p, rl.resetTime, cwd);
+        return;
+    }
+    const current = getProviderState(p, cwd);
+    const failures = current.consecutiveFailures + 1;
+    let status = current.status;
+    if (failures >= DOWN_THRESHOLD) {
+        status = 'down';
+    }
+    else if (failures >= DEGRADED_THRESHOLD) {
+        status = 'degraded';
+    }
+    const updated = {
+        ...current,
+        status,
+        lastCheck: new Date().toISOString(),
+        lastFailure: new Date().toISOString(),
+        consecutiveFailures: failures,
+        remainingCapacity: Math.max(0, current.remainingCapacity - 0.2),
+    };
+    saveState(updated, cwd);
+}
+/**
+ * Explicitly record a rate limit event.
+ */
+export function recordRateLimit(provider, resetTime, cwd) {
+    const p = (provider === 'claude' ? 'anthropic' : provider);
+    const current = getProviderState(p, cwd);
+    const cooldownUntil = resetTime
+        ? new Date(resetTime).toISOString()
+        : new Date(Date.now() + DEFAULT_COOLDOWN_MS).toISOString();
+    const updated = {
+        ...current,
+        status: 'rate-limited',
+        lastCheck: new Date().toISOString(),
+        lastFailure: new Date().toISOString(),
+        cooldownUntil,
+        remainingCapacity: 0,
+        consecutiveFailures: current.consecutiveFailures + 1,
+    };
+    saveState(updated, cwd);
+}
+// ─── Pre-dispatch checks ────────────────────────────────────────────────────
+/**
+ * Check whether dispatching to a provider is allowed right now.
+ */
+export function canDispatch(provider, cwd) {
+    const p = provider === 'claude' ? 'anthropic' : provider;
+    const state = getProviderState(p, cwd);
+    const other = p === 'anthropic' ? 'openai' : 'anthropic';
+    // 1. Rate-limited with active cooldown
+    if (state.status === 'rate-limited' && state.cooldownUntil) {
+        const remaining = new Date(state.cooldownUntil).getTime() - Date.now();
+        if (remaining > 0) {
+            return {
+                allowed: false,
+                reason: `${p} is rate-limited, cooldown expires in ${Math.ceil(remaining / 1000)}s`,
+                suggestedDelay: remaining,
+                alternativeProvider: other,
+            };
+        }
+        // Cooldown expired — allow but note it
+    }
+    // 2. Provider is down
+    if (state.status === 'down') {
+        return {
+            allowed: false,
+            reason: `${p} is down (${state.consecutiveFailures} consecutive failures)`,
+            alternativeProvider: other,
+        };
+    }
+    // 3. Global dispatch budget check
+    if (!isWithinBudget(MAX_DISPATCHES_PER_WINDOW, DEFAULT_WINDOW_MINUTES, cwd)) {
+        return {
+            allowed: false,
+            reason: `Global dispatch limit reached (${MAX_DISPATCHES_PER_WINDOW} per ${DEFAULT_WINDOW_MINUTES}min)`,
+            suggestedDelay: 60_000,
+        };
+    }
+    // 4. Degraded — allow but warn
+    if (state.status === 'degraded') {
+        return {
+            allowed: true,
+            reason: `${p} is degraded (${state.consecutiveFailures} failures), proceeding with caution`,
+        };
+    }
+    return { allowed: true, reason: `${p} is healthy` };
+}
+// ─── Failover ───────────────────────────────────────────────────────────────
+/**
+ * If the preferred provider cannot handle work right now, find the best alternative.
+ */
+export function getFailoverTarget(preferredProvider, preferredModel, cwd) {
+    const p = preferredProvider === 'claude' ? 'anthropic' : preferredProvider;
+    const permission = canDispatch(p, cwd);
+    if (permission.allowed) {
+        return {
+            provider: p,
+            model: preferredModel,
+            reason: permission.reason,
+            wasFailover: false,
+        };
+    }
+    // Attempt failover to the other provider
+    const other = p === 'anthropic' ? 'openai' : 'anthropic';
+    const otherPermission = canDispatch(other, cwd);
+    if (otherPermission.allowed) {
+        // Map the model to an equivalent tier on the other provider
+        const tier = tierForModel(preferredModel);
+        const altModel = modelForTier(tier, other);
+        return {
+            provider: other,
+            model: altModel,
+            reason: `Failover from ${p} (${permission.reason}). Using ${other}:${altModel}`,
+            wasFailover: true,
+        };
+    }
+    // Both providers unavailable — return the preferred with a warning
+    return {
+        provider: p,
+        model: preferredModel,
+        reason: `Both providers unavailable. ${p}: ${permission.reason}. ${other}: ${otherPermission.reason}`,
+        wasFailover: false,
+    };
+}
+/**
+ * Choose the best provider right now based on health + task tier.
+ */
+export function selectProvider(taskTier, preferredProvider, cwd) {
+    // If a preference is given, try it first
+    if (preferredProvider) {
+        const model = modelForTier(taskTier, preferredProvider === 'claude' ? 'anthropic' : preferredProvider);
+        return getFailoverTarget(preferredProvider, model, cwd);
+    }
+    // No preference: pick the healthiest provider
+    const states = getAllProviderStates(cwd);
+    // Sort by: healthy > degraded > rate-limited > down, then by remaining capacity
+    const statusOrder = {
+        healthy: 0,
+        degraded: 1,
+        'rate-limited': 2,
+        down: 3,
+    };
+    states.sort((a, b) => {
+        const sDiff = (statusOrder[a.status] ?? 9) - (statusOrder[b.status] ?? 9);
+        if (sDiff !== 0)
+            return sDiff;
+        return b.remainingCapacity - a.remainingCapacity;
+    });
+    const best = states[0];
+    const model = modelForTier(taskTier, best.provider);
+    return {
+        provider: best.provider,
+        model,
+        reason: `Selected ${best.provider} (status: ${best.status}, capacity: ${Math.round(best.remainingCapacity * 100)}%)`,
+        wasFailover: false,
+    };
+}
+// ─── Global dispatch counter ────────────────────────────────────────────────
+function countRecentDispatches(provider, windowMinutes, cwd) {
+    const logPath = dispatchLogPath(cwd);
+    if (!existsSync(logPath))
+        return 0;
+    const cutoff = Date.now() - windowMinutes * 60 * 1000;
+    let count = 0;
+    try {
+        const lines = readFileSync(logPath, 'utf8').split('\n');
+        for (const line of lines) {
+            if (!line.trim())
+                continue;
+            try {
+                const entry = JSON.parse(line);
+                const ts = new Date(entry.timestamp).getTime();
+                if (ts >= cutoff) {
+                    if (!provider || entry.provider === provider) {
+                        count++;
+                    }
+                }
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+    }
+    catch {
+        return 0;
+    }
+    return count;
+}
+/**
+ * Get the total number of dispatches across all providers in the given window.
+ */
+export function getGlobalDispatchCount(windowMinutes, cwd) {
+    return countRecentDispatches(undefined, windowMinutes ?? DEFAULT_WINDOW_MINUTES, cwd);
+}
+/**
+ * Append a dispatch attempt to the global log (file-based, shared across processes).
+ */
+export function recordDispatchAttempt(provider, model, taskId, cwd) {
+    const logPath = dispatchLogPath(cwd);
+    const dir = join(cwd || process.cwd(), '.dual-brain');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const entry = {
+        provider: provider === 'claude' ? 'anthropic' : provider,
+        model,
+        taskId,
+        timestamp: new Date().toISOString(),
+    };
+    appendFileSync(logPath, JSON.stringify(entry) + '\n', 'utf8');
+}
+/**
+ * Check whether dispatch rate is within budget.
+ */
+export function isWithinBudget(maxPerWindow, windowMinutes, cwd) {
+    const max = maxPerWindow ?? MAX_DISPATCHES_PER_WINDOW;
+    const window = windowMinutes ?? DEFAULT_WINDOW_MINUTES;
+    return getGlobalDispatchCount(window, cwd) < max;
+}
+// ─── Rate limit detection ───────────────────────────────────────────────────
+const RATE_LIMIT_PATTERNS = [
+    /429/i,
+    /rate.?limit/i,
+    /too many requests/i,
+    /capacity/i,
+    /quota/i,
+    /exceeded/i,
+    /throttl/i,
+    /overloaded/i,
+];
+/**
+ * Parse an error message for rate limit signals.
+ */
+export function detectRateLimit(error) {
+    if (!error)
+        return { isRateLimit: false };
+    const isRateLimit = RATE_LIMIT_PATTERNS.some(p => p.test(error));
+    if (!isRateLimit)
+        return { isRateLimit: false };
+    // Try to extract a reset time from the error
+    // Common patterns: "retry after 123s", "Retry-After: 123", "reset at 2024-..."
+    let resetTime;
+    const retryAfterMatch = error.match(/retry.?after:?\s*(\d+)/i);
+    if (retryAfterMatch) {
+        const seconds = parseInt(retryAfterMatch[1], 10);
+        resetTime = new Date(Date.now() + seconds * 1000).toISOString();
+    }
+    const isoMatch = error.match(/reset.+?(20\d{2}-\d{2}-\d{2}T[\d:.]+Z?)/i);
+    if (!resetTime && isoMatch) {
+        resetTime = new Date(isoMatch[1]).toISOString();
+    }
+    return { isRateLimit, resetTime };
+}
+// ─── Health summary ─────────────────────────────────────────────────────────
+/**
+ * One-line health status string for TUI display.
+ */
+export function getHealthSummary(cwd) {
+    const states = getAllProviderStates(cwd);
+    const dispatches = getGlobalDispatchCount(DEFAULT_WINDOW_MINUTES, cwd);
+    const parts = states.map(s => {
+        const icon = s.status === 'healthy' ? 'OK'
+            : s.status === 'degraded' ? 'WARN'
+                : s.status === 'rate-limited' ? 'LIMIT'
+                    : 'DOWN';
+        return `${s.provider}:${icon}`;
+    });
+    parts.push(`${dispatches}/${MAX_DISPATCHES_PER_WINDOW} dispatches`);
+    return parts.join(' | ');
+}
+//# sourceMappingURL=provider-manager.js.map

package/dist/src/provider-manager.js.map

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

package/dist/src/receipt.d.ts

@@ -0,0 +1,87 @@
+interface ReceiptPlan {
+    risk?: string;
+    tier?: string;
+    challengerPolicy?: string;
+    useChallenger?: boolean;
+    primaryModel?: string;
+    reasoningDepth?: string;
+    workStyle?: string;
+    primaryProvider?: string;
+    approvalRequired?: boolean;
+}
+interface ReceiptResult {
+    success?: boolean;
+    filesChanged?: string[];
+    error?: string | null;
+    duration?: number;
+    output?: string | null;
+    provider?: string;
+    model?: string;
+}
+interface ReceiptVerification {
+    filesVerified?: boolean;
+    testsRun?: boolean;
+    testsPassed?: boolean | null;
+    ok?: boolean;
+    notes?: string[];
+}
+interface Receipt {
+    changed: string;
+    verified: string;
+    risk: string;
+    challenger: string;
+    next: string;
+    success: boolean;
+}
+interface SessionReceipt {
+    timestamp: string;
+    goal: string;
+    filesChanged: string[];
+    decisions: string[];
+    testsRun: string | null;
+    risksUnresolved: string[];
+    blockers: string[];
+    nextAction: string;
+    provider: string | null;
+    model: string | null;
+    duration: number | null;
+    status: string;
+}
+interface PipelineRun {
+    prompt?: string;
+    result?: ReceiptResult;
+    verification?: ReceiptVerification;
+    plan?: ReceiptPlan;
+    outcome?: {
+        approved?: boolean;
+    };
+    gates?: Record<string, {
+        passed?: boolean;
+        reason?: string;
+    } | null>;
+    completedAt?: number;
+    startedAt?: number;
+}
+interface OutcomeInput {
+    success?: boolean;
+    result?: ReceiptResult;
+    filesChanged?: string[];
+    error?: string;
+    duration?: number;
+    output?: string;
+    primaryModel?: string;
+    reasoningDepth?: string;
+    challengerPolicy?: string;
+    tier?: string;
+    workStyle?: string;
+    risk?: string;
+    verification?: ReceiptVerification;
+}
+export declare function buildReceipt(result: ReceiptResult, plan: ReceiptPlan, verification: ReceiptVerification): Receipt;
+export declare function formatReceipt(receipt: Receipt): string;
+export declare function formatFailureReceipt(receipt: Receipt, failureContext?: string): string;
+export declare function generateReceipt(run?: PipelineRun, cwd?: string): SessionReceipt;
+export declare function buildResumeBrief(cwd?: string): string | null;
+export declare function getLatestReceipt(cwd?: string): SessionReceipt | null;
+export declare function buildReceiptFromOutcome(outcome?: OutcomeInput): Receipt;
+export {};