dual-brain 0.3.1 → 0.3.3

package/bin/dual-brain.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// dual-brain — CLI entry point. Commands: init, go, think, review, status, remember, forget
+// dual-brain — CLI entry point. Commands: init, go, think, review, status, handoff, remember, forget
 
 import { appendFileSync, existsSync, readFileSync, mkdirSync, writeFileSync, statSync, readdirSync, unlinkSync, watch as fsWatch } from 'node:fs';
 import { join, dirname, basename, extname } from 'node:path';
@@ -294,6 +294,9 @@ Commands:
     --dry-run               Show routing decision without executing
     --files a.mjs,b.mjs     Provide file context for risk classification
     --verbose, -v           Print routing trace (intent, risk, health, model selection)
+  handoff                   Cross-provider switch (auto-detect limited provider)
+    --to claude|codex       Force handoff to a specific provider
+    --show                  Show current handoff context without switching
   think "question"          Multi-round architecture decision with dual-brain
   pr                        Show PR status for current branch
   pr create                 Create PR from current branch with auto-generated description
@@ -1138,6 +1141,98 @@ const PROVIDER_MODEL_CLASSES = {
   openai: ['gpt-4.1-mini', 'gpt-4.1', 'gpt-5.2', 'gpt-5.4-mini', 'gpt-5.3-codex', 'gpt-5.4', 'gpt-5.5'],
 };
 
+async function cmdHandoff(args = []) {
+  const cwd = process.cwd();
+  const fxH = await getFx();
+  const toProvider = flag(args, '--to');
+  const showOnly = args.includes('--show');
+
+  let autoHandoff;
+  try {
+    autoHandoff = await import('../dist/src/auto-handoff.js');
+  } catch (e) {
+    err(`Could not load auto-handoff module: ${e.message}`);
+  }
+
+  const { executeHandoff, detectLimitReached, exportSessionContext, getHandoffUX } = autoHandoff;
+
+  // --show: display current handoff context without switching
+  if (showOnly) {
+    const context = exportSessionContext(cwd);
+    console.log(box('Handoff Context'));
+    console.log('');
+    if (context) {
+      console.log(JSON.stringify(context, null, 2));
+    } else {
+      fxH.info('No active session context to export.');
+    }
+    return;
+  }
+
+  const profile = loadProfile(cwd);
+  const providers = getAvailableProviders(profile);
+
+  if (providers.length < 2 && !toProvider) {
+    fxH.warn('Only one provider configured — nothing to hand off to.');
+    fxH.info('Run: dual-brain init  to configure a second provider.');
+    return;
+  }
+
+  // Detect which provider is limited
+  const limitStatus = detectLimitReached(cwd);
+  const ux = getHandoffUX(limitStatus, toProvider || null);
+
+  // Display UX message
+  if (ux.title) console.log(box(ux.title));
+  if (ux.message) {
+    console.log('');
+    fxH.info(ux.message);
+  }
+  if (ux.detail) {
+    fxH.dim(ux.detail);
+  }
+  console.log('');
+
+  // If --to is specified, force handoff regardless of limit status
+  if (toProvider) {
+    const target = toProvider.toLowerCase();
+    if (target !== 'claude' && target !== 'codex') {
+      err('--to must be "claude" or "codex"');
+    }
+    const result = executeHandoff(cwd, target);
+    if (result.success) {
+      fxH.success(`Handed off to ${target}.`);
+      if (result.command) {
+        console.log('');
+        fxH.info(`Resume with: ${result.command}`);
+      }
+    } else {
+      fxH.error(result.error || `Handoff to ${target} failed.`);
+    }
+    return;
+  }
+
+  // Auto-detect: if a provider is limited, switch to the other
+  if (limitStatus.limited) {
+    const target = limitStatus.switchTo;
+    fxH.warn(`${limitStatus.provider} is limited — switching to ${target}`);
+    console.log('');
+    const result = executeHandoff(cwd, target);
+    if (result.success) {
+      fxH.success(`Handed off to ${target}.`);
+      if (result.command) {
+        console.log('');
+        fxH.info(`Resume with: ${result.command}`);
+      }
+    } else {
+      fxH.error(result.error || `Handoff to ${target} failed.`);
+    }
+  } else {
+    fxH.success('No provider is currently limited. No handoff needed.');
+    fxH.dim('Use --to claude or --to codex to force a switch.');
+  }
+}
+
 function cmdHot(providerArg) {
   if (!providerArg) err('Usage: dual-brain hot <provider>  (claude | openai)');
   const provider = providerArg.toLowerCase();
@@ -6769,6 +6864,7 @@ async function main() {
   if (cmd === 'ship')     { await cmdShip(); return; }
   if (cmd === 'pr')       { await cmdPR(args.slice(1)); return; }
   if (cmd === 'status')   { await cmdStatus(args.slice(1)); return; }
+  if (cmd === 'handoff')  { await cmdHandoff(args.slice(1)); return; }
   if (cmd === 'hot')      { cmdHot(args[1]); return; }
   if (cmd === 'cool')     { cmdCool(args[1]); return; }
   if (cmd === 'remember')    { cmdRemember(args[1]); return; }
@@ -6832,7 +6928,7 @@ fi
   // If cmd is not a recognized subcommand, treat the entire arg list as a task.
   // e.g. `dual-brain fix failing tests` → same as `dual-brain go "fix failing tests"`
   const KNOWN_COMMANDS = new Set([
-    'init', 'install', 'uninstall', 'auth', 'go', 'do', 'plan', 'ship', 'think', 'review', 'pr', 'status', 'hot', 'cool',
+    'init', 'install', 'uninstall', 'auth', 'go', 'do', 'plan', 'ship', 'think', 'review', 'pr', 'status', 'handoff', 'hot', 'cool',
     'remember', 'forget', 'break-glass', 'specialists', 'search', 'shell-hook', 'watch',
     '--help', '-h', '--version', '-v',
     ...Object.keys(loadSpecialistRegistry()),

package/dist/src/auto-handoff.d.ts

@@ -0,0 +1,68 @@
+/**
+ * auto-handoff.ts — Automatic cross-provider handoff system.
+ *
+ * When one provider hits its rate limit, this module exports the conversation
+ * context and switches to the other provider seamlessly.
+ */
+export interface LimitStatus {
+    limited: boolean;
+    provider: string;
+    resetsAt?: string;
+    otherAvailable: boolean;
+    otherProvider?: string;
+}
+export interface HandoffContext {
+    objective: string;
+    filesChanged: string[];
+    recentDecisions: Array<{
+        model: string;
+        tier: string;
+        timestamp: string;
+    }>;
+    conversationSummary: string;
+    currentPhase: string;
+    exportedAt: string;
+}
+export interface HandoffOpts {
+    fromProvider: string;
+    cwd?: string;
+    auto?: boolean;
+}
+export interface HandoffResult {
+    success: boolean;
+    command?: string[];
+    contextFile?: string;
+    message: string;
+}
+export interface HandoffUXMessage {
+    text: string;
+    action: 'auto-switch' | 'prompt-setup' | 'wait';
+    command?: string;
+}
+/**
+ * Check if a provider is rate-limited.
+ * Reads from provider-manager state and checks for common rate limit patterns.
+ */
+export declare function detectLimitReached(provider: string, cwd?: string): LimitStatus;
+/**
+ * Read the current session state and produce a portable context object.
+ */
+export declare function exportSessionContext(cwd?: string): HandoffContext;
+/**
+ * Generate a prompt string that can be fed to the other provider to resume work.
+ */
+export declare function buildHandoffPrompt(context: HandoffContext): string;
+/**
+ * Execute the full handoff flow:
+ * 1. Detect which provider to switch TO
+ * 2. Export context
+ * 3. Build the handoff prompt
+ * 4. Return the command to launch the other CLI
+ *
+ * Does NOT actually spawn the process (caller decides).
+ */
+export declare function executeHandoff(opts: HandoffOpts): HandoffResult;
+/**
+ * Return the user-facing message for a rate limit situation.
+ */
+export declare function getHandoffUX(status: LimitStatus): HandoffUXMessage;

package/dist/src/auto-handoff.js

@@ -0,0 +1,309 @@
+/**
+ * auto-handoff.ts — Automatic cross-provider handoff system.
+ *
+ * When one provider hits its rate limit, this module exports the conversation
+ * context and switches to the other provider seamlessly.
+ */
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { atomicWriteJson } from './integrity.js';
+import { getProviderState } from './provider-manager.js';
+import { loadSession } from './session.js';
+// ─── Constants ──────────────────────────────────────────────────────────────
+const HANDOFF_DIR = '.dual-brain/handoff';
+const HANDOFF_FILE = 'latest.json';
+const DISPATCH_LOG = '.dual-brain/dispatch-log.ndjson';
+/** Map provider names to CLI commands. */
+const PROVIDER_CLI = {
+    anthropic: 'claude',
+    openai: 'codex',
+};
+/** Map provider names to their "other". */
+const OTHER_PROVIDER = {
+    anthropic: 'openai',
+    openai: 'anthropic',
+    claude: 'openai',
+};
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function normalizeProvider(provider) {
+    return provider === 'claude' ? 'anthropic' : provider;
+}
+function handoffDir(cwd) {
+    return join(cwd || process.cwd(), HANDOFF_DIR);
+}
+function handoffFile(cwd) {
+    return join(handoffDir(cwd), HANDOFF_FILE);
+}
+function ensureHandoffDir(cwd) {
+    const dir = handoffDir(cwd);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Read recent routing decisions from the dispatch log.
+ */
+function readRecentDecisions(cwd, limit = 5) {
+    try {
+        const logPath = join(cwd || process.cwd(), DISPATCH_LOG);
+        if (!existsSync(logPath))
+            return [];
+        const content = readFileSync(logPath, 'utf8');
+        const lines = content.trim().split('\n').filter(Boolean);
+        // Take the last N entries
+        const recent = lines.slice(-limit);
+        const decisions = [];
+        for (const line of recent) {
+            try {
+                const entry = JSON.parse(line);
+                decisions.push({
+                    model: entry.model || 'unknown',
+                    tier: entry.tier || entry.provider || 'unknown',
+                    timestamp: entry.timestamp || new Date().toISOString(),
+                });
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        return decisions;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Format a relative time string for when the limit resets.
+ */
+function formatResetTime(resetsAt) {
+    const delta = new Date(resetsAt).getTime() - Date.now();
+    if (delta <= 0)
+        return 'now';
+    const minutes = Math.ceil(delta / 60_000);
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.ceil(minutes / 60);
+    return `${hours}h`;
+}
+// ─── Exported Functions ─────────────────────────────────────────────────────
+/**
+ * Check if a provider is rate-limited.
+ * Reads from provider-manager state and checks for common rate limit patterns.
+ */
+export function detectLimitReached(provider, cwd) {
+    try {
+        const normalized = normalizeProvider(provider);
+        const state = getProviderState(normalized, cwd);
+        const other = OTHER_PROVIDER[normalized] || (normalized === 'anthropic' ? 'openai' : 'anthropic');
+        const limited = state.status === 'rate-limited' || state.status === 'down';
+        let otherAvailable = false;
+        if (limited) {
+            const otherState = getProviderState(other, cwd);
+            otherAvailable = otherState.status === 'healthy' || otherState.status === 'degraded';
+        }
+        return {
+            limited,
+            provider: normalized,
+            resetsAt: state.cooldownUntil || undefined,
+            otherAvailable,
+            otherProvider: other,
+        };
+    }
+    catch {
+        return {
+            limited: false,
+            provider: normalizeProvider(provider),
+            otherAvailable: false,
+        };
+    }
+}
+/**
+ * Read the current session state and produce a portable context object.
+ */
+export function exportSessionContext(cwd) {
+    try {
+        const session = loadSession(cwd || process.cwd());
+        const decisions = readRecentDecisions(cwd);
+        const objective = session?.objective || '(no objective recorded)';
+        const filesChanged = session?.filesChanged || [];
+        const currentPhase = session?.nextAction || 'unknown';
+        // Build a conversation summary from session state
+        const summaryParts = [];
+        if (session?.objective) {
+            summaryParts.push(`Working on: ${session.objective}`);
+        }
+        if (session?.lastResult?.summary) {
+            summaryParts.push(`Last result: ${session.lastResult.summary}`);
+        }
+        if (session?.commandsRun?.length) {
+            const recentCmds = session.commandsRun.slice(-3);
+            summaryParts.push(`Recent commands: ${recentCmds.join(', ')}`);
+        }
+        if (session?.branch) {
+            summaryParts.push(`Branch: ${session.branch}`);
+        }
+        const conversationSummary = summaryParts.length > 0
+            ? summaryParts.join('. ')
+            : '(no session context available)';
+        return {
+            objective,
+            filesChanged,
+            recentDecisions: decisions,
+            conversationSummary,
+            currentPhase,
+            exportedAt: new Date().toISOString(),
+        };
+    }
+    catch {
+        return {
+            objective: '(failed to export context)',
+            filesChanged: [],
+            recentDecisions: [],
+            conversationSummary: '(export error)',
+            currentPhase: 'unknown',
+            exportedAt: new Date().toISOString(),
+        };
+    }
+}
+/**
+ * Generate a prompt string that can be fed to the other provider to resume work.
+ */
+export function buildHandoffPrompt(context) {
+    const lines = [
+        '# Handoff Context — Resuming Work From Another Provider',
+        '',
+        '## Objective',
+        context.objective,
+        '',
+    ];
+    if (context.filesChanged.length > 0) {
+        lines.push('## Files Changed');
+        for (const f of context.filesChanged) {
+            lines.push(`- ${f}`);
+        }
+        lines.push('');
+    }
+    if (context.conversationSummary && context.conversationSummary !== '(no session context available)') {
+        lines.push('## Session Summary');
+        lines.push(context.conversationSummary);
+        lines.push('');
+    }
+    if (context.recentDecisions.length > 0) {
+        lines.push('## Recent Routing Decisions');
+        for (const d of context.recentDecisions) {
+            lines.push(`- ${d.model} (${d.tier}) at ${d.timestamp}`);
+        }
+        lines.push('');
+    }
+    if (context.currentPhase && context.currentPhase !== 'unknown') {
+        lines.push('## Current Phase');
+        lines.push(context.currentPhase);
+        lines.push('');
+    }
+    lines.push('## Instructions');
+    lines.push('Continue working on the objective above. The previous provider hit its rate limit.');
+    lines.push('Pick up where it left off — do not ask the user to repeat themselves.');
+    lines.push(`Context exported at: ${context.exportedAt}`);
+    return lines.join('\n');
+}
+/**
+ * Execute the full handoff flow:
+ * 1. Detect which provider to switch TO
+ * 2. Export context
+ * 3. Build the handoff prompt
+ * 4. Return the command to launch the other CLI
+ *
+ * Does NOT actually spawn the process (caller decides).
+ */
+export function executeHandoff(opts) {
+    try {
+        const { fromProvider, cwd, auto } = opts;
+        const normalized = normalizeProvider(fromProvider);
+        const other = OTHER_PROVIDER[normalized] || (normalized === 'anthropic' ? 'openai' : 'anthropic');
+        // Check that the other provider is available
+        const otherState = getProviderState(other, cwd);
+        if (otherState.status === 'rate-limited' || otherState.status === 'down') {
+            return {
+                success: false,
+                message: `Cannot handoff: ${other} is also ${otherState.status}. Both providers unavailable.`,
+            };
+        }
+        // Export session context
+        const context = exportSessionContext(cwd);
+        // Build handoff prompt
+        const prompt = buildHandoffPrompt(context);
+        // Write context to handoff file
+        ensureHandoffDir(cwd);
+        const contextFilePath = handoffFile(cwd);
+        const handoffData = {
+            context,
+            prompt,
+            fromProvider: normalized,
+            toProvider: other,
+            auto: auto ?? false,
+            createdAt: new Date().toISOString(),
+        };
+        atomicWriteJson(contextFilePath, handoffData);
+        // Build the CLI command
+        const cli = PROVIDER_CLI[other] || other;
+        const command = [cli, '--resume', contextFilePath];
+        const autoLabel = auto ? ' (auto)' : '';
+        return {
+            success: true,
+            command,
+            contextFile: contextFilePath,
+            message: `Handoff${autoLabel}: ${normalized} → ${other}. Context saved to ${contextFilePath}`,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            message: `Handoff failed: ${message}`,
+        };
+    }
+}
+/**
+ * Return the user-facing message for a rate limit situation.
+ */
+export function getHandoffUX(status) {
+    const providerLabel = PROVIDER_CLI[status.provider] || status.provider;
+    const otherLabel = status.otherProvider ? (PROVIDER_CLI[status.otherProvider] || status.otherProvider) : 'other';
+    // Both providers limited
+    if (status.limited && !status.otherAvailable) {
+        // Check if we have a reset time
+        if (status.resetsAt) {
+            const timeStr = formatResetTime(status.resetsAt);
+            return {
+                text: `⚡ Both providers at limit. Resets in ${timeStr}.`,
+                action: 'wait',
+            };
+        }
+        return {
+            text: `⚡ Both providers at limit. Resets in ~5m.`,
+            action: 'wait',
+        };
+    }
+    // Limited but other is available
+    if (status.limited && status.otherAvailable && status.otherProvider) {
+        return {
+            text: `⚡ ${providerLabel} limit reached → switching to ${otherLabel}`,
+            action: 'auto-switch',
+            command: `dual-brain handoff --to ${status.otherProvider}`,
+        };
+    }
+    // Limited but other provider not configured
+    if (status.limited && !status.otherAvailable) {
+        return {
+            text: `⚡ ${providerLabel} limit reached. Set up ${otherLabel} to continue? Run: dual-brain init`,
+            action: 'prompt-setup',
+            command: 'dual-brain init',
+        };
+    }
+    // Not limited (shouldn't normally be called, but handle gracefully)
+    return {
+        text: `${providerLabel} is operating normally.`,
+        action: 'wait',
+    };
+}
+//# sourceMappingURL=auto-handoff.js.map

package/dist/src/auto-handoff.js.map

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

package/install.mjs

@@ -916,7 +916,10 @@ function install(workspace, env, mode) {
     'auto-update-wrapper.mjs',
     'head-guard.mjs',
   ];
-  for (const h of HOOKS) cpSync(join(__dirname, 'hooks', h), join(target, 'hooks', h));
+  for (const h of HOOKS) {
+    const hSrc = join(__dirname, 'hooks', h);
+    if (existsSync(hSrc)) cpSync(hSrc, join(target, 'hooks', h));
+  }
 
   // Copy bash hooks (auto-update.sh lives alongside .mjs hooks in the package)
   const BASH_HOOKS = ['auto-update.sh'];
@@ -935,8 +938,12 @@ function install(workspace, env, mode) {
     'hookify.orchestrator-gate.local.md',
     'hookify.orchestrator-cost.local.md',
   ];
-  for (const r of RULES) cpSync(join(__dirname, r), join(target, r));
-  actions.push(`✓ ${RULES.length} hookify rules`);
+  let rulesInstalled = 0;
+  for (const r of RULES) {
+    const rSrc = join(__dirname, r);
+    if (existsSync(rSrc)) { cpSync(rSrc, join(target, r)); rulesInstalled++; }
+  }
+  if (rulesInstalled) actions.push(`✓ ${rulesInstalled} hookify rules`);
 
   const orch = generateOrchestrator(mode, workspace);
   writeFileSync(join(target, 'orchestrator.json'), JSON.stringify(orch, null, 2) + '\n');
@@ -954,8 +961,9 @@ function install(workspace, env, mode) {
   actions.push('✓ CLAUDE.md (session instructions)');
 
   const rulesTarget = join(target, 'review-rules.md');
-  if (!existsSync(rulesTarget) || force) {
-    cpSync(join(__dirname, 'review-rules.md'), rulesTarget);
+  const rulesSrc = join(__dirname, 'review-rules.md');
+  if (existsSync(rulesSrc) && (!existsSync(rulesTarget) || force)) {
+    cpSync(rulesSrc, rulesTarget);
     actions.push('✓ review-rules.md template');
   } else {
     actions.push('⊘ review-rules.md (kept yours)');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dual-brain",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "AI orchestration across Claude + OpenAI subscriptions — smart routing, budget awareness, and dual-brain collaboration",
   "type": "module",
   "bin": {
@@ -18,7 +18,8 @@
     "./model-profiles": { "types": "./dist/src/model-profiles.d.ts", "default": "./dist/src/model-profiles.js" },
     "./signal": { "types": "./dist/src/signal.d.ts", "default": "./dist/src/signal.js" },
     "./routing-advisor": { "types": "./dist/src/routing-advisor.d.ts", "default": "./dist/src/routing-advisor.js" },
-    "./types": { "types": "./dist/src/types.d.ts", "default": "./dist/src/types.js" }
+    "./types": { "types": "./dist/src/types.d.ts", "default": "./dist/src/types.js" },
+    "./auto-handoff": { "types": "./dist/src/auto-handoff.d.ts", "default": "./dist/src/auto-handoff.js" }
   },
   "keywords": [
     "claude-code",