dual-brain 3.4.0 → 3.6.0

package/hooks/control-panel.mjs

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 /**
- * control-panel.mjs — Session manager + control panel for Dual-Brain.
+ * control-panel.mjs — Session launcher for Dual-Brain.
  *
- * Data-tools-style interactive menu: recent sessions, continue/resume/new,
- * profile switching, budget editing. Loops until user exits to shell.
+ * Progressive disclosure: first-run shows minimal menu (new/shell + auth).
+ * Returning users see recent sessions, profile mode, cost alert settings.
+ * Loops until user exits to shell.
  */
 
 import readline from 'readline';
@@ -14,6 +15,7 @@ import { spawnSync } from 'child_process';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PROFILE_FILE = join(__dirname, '..', 'dual-brain.profile.json');
+const LAUNCHED_MARKER = join(__dirname, '..', '.launched');
 const VERSION = (() => {
   try { return JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8')).version; } catch {}
   return '?';
@@ -32,16 +34,15 @@ const dim = s => e('2', s);
 const cyan = s => e('36', s);
 const green = s => e('32', s);
 const yellow = s => e('33', s);
-const magenta = s => e('95', s);
 const orange = s => e('1;38;5;208', s);
 const blue = s => e('1;38;5;33', s);
 
 // ─── Profiles ──────────────────────────────────────────────────────────────
 
 const PROFILES = {
-  balanced:        { emoji: '⚖️',  label: 'Balanced',      desc: 'Best model per tier, normal budgets' },
-  'cost-saver':    { emoji: '💸', label: 'Cost-saver',    desc: 'Prefer cheaper models, lower budgets' },
-  'quality-first': { emoji: '💎', label: 'Quality-first', desc: 'Dual-brain for medium+, strict reviews' },
+  balanced:        { emoji: '⚖️',  uiLabel: 'Default',       desc: 'Auto-routes by complexity, uses both providers evenly' },
+  'cost-saver':    { emoji: '🛡️', uiLabel: 'Conservative',  desc: 'Fewer GPT dispatches, sticks to Claude for most work' },
+  'quality-first': { emoji: '🚀', uiLabel: 'Aggressive',    desc: 'Maximizes both subscriptions, dual-brain for medium+ risk' },
 };
 
 const PROFILE_BUDGETS = {
@@ -55,9 +56,9 @@ function loadProfile() {
     const data = JSON.parse(readFileSync(PROFILE_FILE, 'utf8'));
     const name = data.active && PROFILES[data.active] ? data.active : 'balanced';
     const custom = data.custom_overrides || {};
-    return { name, budgets: { ...PROFILE_BUDGETS[name], ...custom.budgets } };
+    return { name, budgets: { ...PROFILE_BUDGETS[name], ...custom.budgets }, hasCustomBudget: !!custom.budgets };
   } catch {
-    return { name: 'balanced', budgets: PROFILE_BUDGETS.balanced };
+    return { name: 'balanced', budgets: PROFILE_BUDGETS.balanced, hasCustomBudget: false };
   }
 }
 
@@ -69,6 +70,25 @@ function saveProfile(name, customOverrides) {
   renameSync(tmp, PROFILE_FILE);
 }
 
+// ─── First-Run Detection ──────────────────────────────────────────────────
+
+function isFirstRun() {
+  if (existsSync(LAUNCHED_MARKER)) return false;
+  // Also check Claude history for any session in this workspace
+  const historyFile = join(HOME, '.claude', 'history.jsonl');
+  if (existsSync(historyFile)) {
+    try {
+      const content = readFileSync(historyFile, 'utf8');
+      if (content.includes('"sessionId"')) return false;
+    } catch {}
+  }
+  return true;
+}
+
+function markLaunched() {
+  try { writeFileSync(LAUNCHED_MARKER, new Date().toISOString() + '\n'); } catch {}
+}
+
 // ─── Provider Detection ───────────────────────────────────────────────────
 
 function detectProviders() {
@@ -122,17 +142,13 @@ function getRecentSessions() {
     return true;
   };
 
-  // Claude sessions
   const historyFile = join(HOME, '.claude', 'history.jsonl');
   if (existsSync(historyFile)) {
     try {
       const lines = readFileSync(historyFile, 'utf8').trim().split('\n');
       const entries = [];
       for (const line of lines) {
-        try {
-          const j = JSON.parse(line);
-          if (j.sessionId && j.timestamp) entries.push(j);
-        } catch {}
+        try { const j = JSON.parse(line); if (j.sessionId && j.timestamp) entries.push(j); } catch {}
       }
       entries.sort((a, b) => a.timestamp - b.timestamp);
       for (const j of entries) {
@@ -151,7 +167,6 @@ function getRecentSessions() {
     } catch {}
   }
 
-  // Codex sessions
   const codexDir = join(HOME, '.codex', 'sessions');
   if (existsSync(codexDir)) {
     const walk = (dir) => {
@@ -230,68 +245,125 @@ function countRunning() {
   return { claude, codex };
 }
 
-// ─── Replit-Tools Check ───────────────────────────────────────────────────
+// ─── Provider Balance ─────────────────────────────────────────────────────
+
+function loadProviderBalance() {
+  const today = new Date().toISOString().slice(0, 10);
+  const logFile = join(__dirname, `usage-${today}.jsonl`);
+  if (!existsSync(logFile)) return { claude: 0, openai: 0, total: 0, label: 'No activity yet' };
+
+  let claude = 0, openai = 0;
+  try {
+    const lines = readFileSync(logFile, 'utf8').split('\n').filter(Boolean);
+    for (const line of lines) {
+      try {
+        const e = JSON.parse(line);
+        if (e.provider === 'claude') claude++;
+        else if (e.provider === 'openai') openai++;
+      } catch {}
+    }
+  } catch {}
+
+  const total = claude + openai;
+  if (total === 0) return { claude: 0, openai: 0, total: 0, label: 'No activity yet' };
 
-function checkReplitTools() {
-  if (!IS_REPLIT) return true;
-  return existsSync(join(CWD, '.replit-tools'));
+  const claudePct = Math.round((claude / total) * 100);
+  const openaiPct = 100 - claudePct;
+
+  let label;
+  if (openaiPct === 0) label = 'Claude only — GPT subscription unused';
+  else if (claudePct === 0) label = 'GPT only — Claude subscription unused';
+  else if (Math.abs(claudePct - openaiPct) <= 20) label = 'Well balanced';
+  else if (claudePct > openaiPct) label = `Claude-heavy — GPT has capacity`;
+  else label = `GPT-heavy — Claude has capacity`;
+
+  return { claude: claudePct, openai: openaiPct, total, label };
 }
 
-// ─── Menu Renderer ────────────────────────────────────────────────────────
+function balanceBar(claudePct, openaiPct, width = 20) {
+  if (claudePct === 0 && openaiPct === 0) return dim('░'.repeat(width) + '  no activity');
+  const cFill = Math.round((claudePct / 100) * width);
+  const oFill = width - cFill;
+  const cBar = noColor ? '█'.repeat(cFill) : `\x1b[38;5;208m${'█'.repeat(cFill)}\x1b[0m`;
+  const oBar = noColor ? '▓'.repeat(oFill) : `\x1b[32m${'▓'.repeat(oFill)}\x1b[0m`;
+  return `${cBar}${oBar}  ${orange(claudePct + '%')} Claude · ${green(openaiPct + '%')} GPT`;
+}
 
-function renderMenu() {
-  const providers = detectProviders();
-  const profile = loadProfile();
-  const sessions = getRecentSessions();
-  const running = countRunning();
-  const pf = PROFILES[profile.name];
-  const hasReplitTools = checkReplitTools();
+// ─── Menu Renderers ───────────────────────────────────────────────────────
 
+function renderFirstRunMenu(providers) {
   const lines = [];
 
   lines.push('');
   lines.push(`  🧠 ${bold(`Dual-Brain v${VERSION}`)}`);
   lines.push('');
 
-  // Quick reference box
-  lines.push('  ┌─────────────────────────────┐');
-  if (IS_REPLIT) {
-    lines.push(`  │ ${magenta('At')} ${blue('~/workspace')}${magenta('$ prompt:')}     │`);
-    lines.push(`  │ ${cyan('! npx dual-brain')} = this menu│`);
+  // Provider status
+  const cStat = providers.claude.authed ? '✅' : providers.claude.installed ? '⚠️' : '❌';
+  const xStat = providers.codex.authed ? '✅' : providers.codex.installed ? '⚠️' : '❌';
+  lines.push(`  🟠 Claude ${cStat}  🟢 Codex ${xStat}`);
+
+  if (providers.claude.authed && providers.codex.authed) {
+    lines.push(`  ${green('Both providers ready — full dual-brain mode')}`);
+  } else if (providers.claude.authed) {
+    lines.push(`  ${dim('Claude ready. Add Codex for dual-brain features.')}`);
+  } else if (!providers.claude.installed) {
+    lines.push(`  ${yellow('Claude not found — needed to start.')}`);
   } else {
-    lines.push(`  │ ${magenta('At shell prompt:')}             │`);
-    lines.push(`  │ ${cyan('npx dual-brain')} = this menu   │`);
+    lines.push(`  ${yellow('Claude needs login to start.')}`);
   }
-  lines.push(`  │ ${cyan('j')}  = login to Claude        │`);
-  lines.push(`  │ ${cyan('k')}  = login to Codex         │`);
-  lines.push('  ├─────────────────────────────┤');
-  lines.push(`  │ ${orange('In Claude session:')}           │`);
-  lines.push(`  │ ${green('Ctrl+C x2')} = back to menu    │`);
-  lines.push(`  │ ${green('Ctrl+C x3')} = exit to shell   │`);
-  lines.push('  └─────────────────────────────┘');
-  lines.push('');
 
-  // Provider status line
-  const cStat = providers.claude.authed ? '✅' : providers.claude.installed ? '⚠️' : '❌';
-  const xStat = providers.codex.authed ? '✅' : providers.codex.installed ? '⚠️' : '❌';
-  lines.push(`  🟠 Claude ${cStat}  🟢 Codex ${xStat}  ${pf.emoji}  ${bold(pf.label)}  ${dim('$' + profile.budgets.session_limit_usd + '/session')}`);
+  lines.push('');
 
-  // Missing provider nudge
+  // Auth actions if needed
   if (!providers.claude.authed || !providers.codex.authed) {
+    if (!providers.claude.installed) {
+      lines.push(`  ${dim('Install Claude:')} ${cyan('curl -fsSL https://claude.ai/install.sh | sh')}`);
+    }
+    if (!providers.claude.authed && providers.claude.installed) {
+      lines.push(`  ${bold('[j]')} Sign in to Claude`);
+    }
+    if (!providers.codex.installed) {
+      lines.push(`  ${dim('Install Codex:')} ${cyan('npm i -g @openai/codex')}`);
+    } else if (!providers.codex.authed) {
+      lines.push(`  ${bold('[k]')} Sign in to Codex ${dim('(optional — enables GPT collaboration)')}`);
+    }
     lines.push('');
-    if (!providers.claude.installed) lines.push(`  ${dim('└')} Install Claude: ${cyan('curl -fsSL https://claude.ai/install.sh | sh')}`);
-    else if (!providers.claude.authed) lines.push(`  ${dim('└')} Auth Claude: press ${bold('j')} below`);
-    if (!providers.codex.installed) lines.push(`  ${dim('└')} Install Codex: ${cyan('npm i -g @openai/codex')}`);
-    else if (!providers.codex.authed) lines.push(`  ${dim('└')} Auth Codex: press ${bold('k')} below`);
   }
 
   // Replit-tools check
-  if (IS_REPLIT && !hasReplitTools) {
-    lines.push('');
-    lines.push(`  ⚠️  ${yellow('replit-tools not found')} — recommended for Replit environments`);
-    lines.push(`  ${dim('└')} Press ${bold('t')} to install replit-tools`);
+  if (IS_REPLIT && !existsSync(join(CWD, '.replit-tools'))) {
+    lines.push(`  ${bold('[t]')} Install replit-tools ${dim('(recommended for Replit)')}`);
   }
 
+  // Primary actions
+  lines.push(`  ${bold('[n]')} Start new session`);
+  lines.push(`  ${bold('[s]')} Skip — just shell`);
+  lines.push('');
+
+  return lines;
+}
+
+function renderReturningMenu(providers, sessions) {
+  const profile = loadProfile();
+  const pf = PROFILES[profile.name];
+  const running = countRunning();
+  const balance = loadProviderBalance();
+  const lines = [];
+
+  lines.push('');
+  lines.push(`  🧠 ${bold(`Dual-Brain v${VERSION}`)}`);
+  lines.push('');
+
+  // Provider status
+  const cStat = providers.claude.authed ? '✅' : '⚠️';
+  const xStat = providers.codex.authed ? '✅' : providers.codex.installed ? '⚠️' : '❌';
+  lines.push(`  🟠 Claude ${cStat}  🟢 Codex ${xStat}  ${pf.emoji}  ${bold(pf.uiLabel)}`);
+
+  // Provider balance bar
+  lines.push(`  ${balanceBar(balance.claude, balance.openai)}`);
+  if (balance.total > 0) lines.push(`  ${dim(balance.label + ' · ' + balance.total + ' calls today')}`);
+
   // Recent sessions
   if (sessions.length > 0) {
     lines.push('');
@@ -305,31 +377,28 @@ function renderMenu() {
     }
   }
 
-  // Session manager box
   lines.push('');
-  lines.push('  ┌─────────────────────────────┐');
-  lines.push('  │  🧠 Dual-Brain Session Mgr   │');
-  lines.push('  └─────────────────────────────┘');
 
   const runParts = [];
   if (running.claude > 0) runParts.push(`${running.claude} claude`);
   if (running.codex > 0) runParts.push(`${running.codex} codex`);
   if (runParts.length > 0) lines.push(`  ${dim('(' + runParts.join(', ') + ' running)')}`);
-  lines.push('');
 
   // Menu options
   lines.push(`  ${bold('[c]')} Continue last session`);
   if (sessions.length > 0) lines.push(`  ${bold('[1-9]')} Resume numbered above`);
   lines.push(`  ${bold('[n]')} New session`);
-  lines.push(`  ${bold('[p]')} Profile ${dim('(' + pf.emoji + ' ' + profile.name + ')')}`);
-  lines.push(`  ${bold('[b]')} Budget ${dim('($' + profile.budgets.session_limit_usd + ' session / $' + profile.budgets.daily_limit_usd + ' daily)')}`);
-  lines.push(`  ${bold('[j]')} Login to Claude`);
-  lines.push(`  ${bold('[k]')} Login to Codex`);
-  if (IS_REPLIT && !hasReplitTools) lines.push(`  ${bold('[t]')} Install replit-tools`);
-  lines.push(`  ${bold('[s]')} Skip — just shell`);
+  lines.push(`  ${bold('[p]')} Mode: ${dim(pf.uiLabel)}`);
+
+  // Auth if needed
+  if (!providers.claude.authed) lines.push(`  ${bold('[j]')} Sign in to Claude`);
+  if (providers.codex.installed && !providers.codex.authed) lines.push(`  ${bold('[k]')} Sign in to Codex`);
+  if (IS_REPLIT && !existsSync(join(CWD, '.replit-tools'))) lines.push(`  ${bold('[t]')} Install replit-tools`);
+
+  lines.push(`  ${bold('[s]')} Shell`);
   lines.push('');
 
-  return { lines, sessions, providers };
+  return lines;
 }
 
 // ─── Profile Picker ───────────────────────────────────────────────────────
@@ -337,12 +406,16 @@ function renderMenu() {
 function showProfilePicker(rl) {
   return new Promise((resolve) => {
     const current = loadProfile();
+    const balance = loadProviderBalance();
     console.log('');
-    console.log(`  ${bold('🎛️  Switch Profile:')}`);
+    console.log(`  ${bold('Switch routing mode:')}`);
+    if (balance.total > 0) {
+      console.log(`  ${dim('Current balance: Claude ' + balance.claude + '% / GPT ' + balance.openai + '% · ' + balance.label)}`);
+    }
     console.log('');
     for (const [i, [name, pf]] of Object.entries(PROFILES).entries()) {
       const active = name === current.name ? ' ✅' : '';
-      console.log(`  ${bold('[' + (i + 1) + ']')} ${pf.emoji}  ${name.padEnd(15)} ${dim(pf.desc)}${active}`);
+      console.log(`  ${bold('[' + (i + 1) + ']')} ${pf.emoji}  ${pf.uiLabel.padEnd(15)} ${dim(pf.desc)}${active}`);
     }
     console.log(`  ${bold('[q]')} Cancel`);
     console.log('');
@@ -358,63 +431,26 @@ function showProfilePicker(rl) {
         } catch {}
         saveProfile(names[idx], customOverrides);
         const pf = PROFILES[names[idx]];
-        console.log(`  ✅ Switched to ${pf.emoji}  ${pf.label}`);
+        console.log(`  ✅ Switched to ${pf.emoji}  ${pf.uiLabel}`);
       }
       resolve();
     });
   });
 }
 
-// ─── Budget Editor ────────────────────────────────────────────────────────
-
-function showBudgetEditor(rl) {
-  return new Promise((resolve) => {
-    const profile = loadProfile();
-    console.log('');
-    console.log(`  ${bold('💵 Edit Budget')}`);
-    console.log(`  ${dim('Current: $' + profile.budgets.session_limit_usd + ' session / $' + profile.budgets.daily_limit_usd + ' daily')}`);
-    console.log('');
-
-    rl.question('  Session limit ($): ', (sessionStr) => {
-      const session = parseFloat(sessionStr);
-      if (isNaN(session) || session <= 0) {
-        console.log('  Cancelled.');
-        return resolve();
-      }
-      rl.question('  Daily limit ($, Enter = auto): ', (dailyStr) => {
-        const daily = parseFloat(dailyStr);
-        const finalDaily = (isNaN(daily) || daily <= 0) ? session * 3 : daily;
-
-        let existing = {};
-        try { existing = JSON.parse(readFileSync(PROFILE_FILE, 'utf8')); } catch {}
-        const custom = existing.custom_overrides || {};
-        custom.budgets = {
-          session_warn_usd: +(session * 0.6).toFixed(2),
-          session_limit_usd: session,
-          daily_warn_usd: +(finalDaily * 0.6).toFixed(2),
-          daily_limit_usd: finalDaily,
-        };
-        const data = { active: existing.active || 'balanced', switched_at: existing.switched_at || new Date().toISOString(), custom_overrides: custom };
-        const tmp = PROFILE_FILE + '.tmp.' + process.pid;
-        writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n');
-        renameSync(tmp, PROFILE_FILE);
-
-        console.log(`  ✅ Budget: $${session}/session · $${finalDaily}/daily`);
-        resolve();
-      });
-    });
-  });
-}
+// (Cost alert editor removed — replaced by provider balance + mode switching)
 
 // ─── Session Runner ───────────────────────────────────────────────────────
 
 function runSession(cmd, args, label) {
   console.log('');
-  console.log(`  ${label}...`);
+  console.log(`  ${label}`);
+  console.log(`  ${dim('Inside Claude: press Ctrl+C twice to return here.')}`);
   console.log('');
+  markLaunched();
   const result = spawnSync(cmd, args, { stdio: 'inherit' });
   console.log('');
-  console.log('  Exited. Returning to menu...');
+  console.log('  Returned to Dual-Brain.');
   return result.status || 0;
 }
 
@@ -422,11 +458,17 @@ function runSession(cmd, args, label) {
 
 async function mainLoop() {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-
   const ask = () => new Promise(resolve => rl.question('  Choice: ', resolve));
 
   while (true) {
-    const { lines, sessions } = renderMenu();
+    const firstRun = isFirstRun();
+    const providers = detectProviders();
+    const sessions = firstRun ? [] : getRecentSessions();
+
+    const lines = firstRun
+      ? renderFirstRunMenu(providers)
+      : renderReturningMenu(providers, sessions);
+
     for (const l of lines) console.log(l);
 
     const choice = (await ask()).trim().toLowerCase();
@@ -438,16 +480,15 @@ async function mainLoop() {
     }
 
     if (choice === 'c' || choice === '') {
-      // Continue most recent session
       if (sessions.length > 0) {
         const s = sessions[0];
         if (s.tool === 'codex') {
-          runSession('codex', ['--dangerously-bypass-approvals-and-sandbox', 'resume', s.id], `Resuming codex session ${s.id.slice(0, 8)}`);
+          runSession('codex', ['--dangerously-bypass-approvals-and-sandbox', 'resume', s.id], `Resuming codex ${s.id.slice(0, 8)}...`);
         } else {
-          runSession('claude', ['-r', s.id, '--dangerously-skip-permissions'], `Resuming session ${s.id.slice(0, 8)}`);
+          runSession('claude', ['-r', s.id, '--dangerously-skip-permissions'], `Resuming session ${s.id.slice(0, 8)}...`);
         }
       } else {
-        runSession('claude', ['--dangerously-skip-permissions'], 'Starting new session');
+        runSession('claude', ['--dangerously-skip-permissions'], 'Starting new session...');
       }
       continue;
     }
@@ -456,15 +497,15 @@ async function mainLoop() {
     if (num >= 1 && num <= 9 && sessions[num - 1]) {
       const s = sessions[num - 1];
       if (s.tool === 'codex') {
-        runSession('codex', ['--dangerously-bypass-approvals-and-sandbox', 'resume', s.id], `Resuming codex session ${s.id.slice(0, 8)}`);
+        runSession('codex', ['--dangerously-bypass-approvals-and-sandbox', 'resume', s.id], `Resuming codex ${s.id.slice(0, 8)}...`);
       } else {
-        runSession('claude', ['-r', s.id, '--dangerously-skip-permissions'], `Resuming session ${s.id.slice(0, 8)}`);
+        runSession('claude', ['-r', s.id, '--dangerously-skip-permissions'], `Resuming session ${s.id.slice(0, 8)}...`);
       }
       continue;
     }
 
     if (choice === 'n') {
-      runSession('claude', ['--dangerously-skip-permissions'], 'Starting new session');
+      runSession('claude', ['--dangerously-skip-permissions'], 'Starting new session...');
       continue;
     }
 
@@ -473,11 +514,6 @@ async function mainLoop() {
       continue;
     }
 
-    if (choice === 'b') {
-      await showBudgetEditor(rl);
-      continue;
-    }
-
     if (choice === 'j') {
       console.log('');
       console.log('  Starting Claude login...');
@@ -508,7 +544,7 @@ async function mainLoop() {
       console.log('');
       spawnSync('npx', ['-y', 'data-tools'], { stdio: 'inherit', cwd: CWD });
       console.log('');
-      console.log('  ✅ replit-tools installed. You may need to restart your shell.');
+      console.log('  ✅ replit-tools installed.');
       console.log('');
       await ask();
       continue;
@@ -521,7 +557,11 @@ async function mainLoop() {
 // ─── Non-Interactive Fallback ─────────────────────────────────────────────
 
 function renderStatic() {
-  const { lines } = renderMenu();
+  const providers = detectProviders();
+  const sessions = getRecentSessions();
+  const lines = sessions.length > 0
+    ? renderReturningMenu(providers, sessions)
+    : renderFirstRunMenu(providers);
   for (const l of lines) console.log(l);
 }
 

package/hooks/profiles.mjs

@@ -22,7 +22,7 @@ const CONFIG_FILE = join(__dirname, '..', 'orchestrator.json');
 
 const PROFILES = {
   balanced: {
-    description: 'Standard routing — best model for each tier, normal budgets',
+    description: 'Auto-routes by complexity, uses both providers evenly',
     routing: {
       prefer_provider: 'auto',
       think_threshold: 'normal',
@@ -42,7 +42,7 @@ const PROFILES = {
   },
 
   'cost-saver': {
-    description: 'Minimize spend — prefer cheaper models, skip GPT for low risk',
+    description: 'Conservative — fewer GPT dispatches, sticks to Claude',
     routing: {
       prefer_provider: 'cheapest',
       think_threshold: 'strict',
@@ -65,7 +65,7 @@ const PROFILES = {
   },
 
   'quality-first': {
-    description: 'Maximum quality — dual-brain for medium+, stricter reviews',
+    description: 'Aggressive — maximizes both subscriptions, dual-brain for medium+',
     routing: {
       prefer_provider: 'most-capable',
       think_threshold: 'relaxed',

package/install.mjs

@@ -57,10 +57,10 @@ if (flag('--help') || flag('-h')) {
     --json       Output detection as JSON
     --help       Show this help
 
-  🎛️  Profiles:
-    ⚖️  balanced       Standard routing — best model per tier
-    💸 cost-saver     Minimize spend — prefer cheaper models
-    💎 quality-first  Maximum quality — dual-brain for medium+
+  🎛️  Routing modes:
+    ⚖️  Default        Auto-routes, uses both providers evenly
+    🛡️  Conservative   Fewer GPT dispatches, sticks to Claude
+    🚀 Aggressive     Maximizes both subscriptions, dual-brain for medium+
 
   🚀 Examples:
     ${cmd('npx dual-brain')}                  # install or update
@@ -313,6 +313,7 @@ function generateGitignoreEntries(workspace) {
     '.claude/dual-brain.profile.json',
     '.claude/hooks/usage-summary-*.json',
     '.claude/hooks/decision-ledger.jsonl',
+    '.claude/.launched',
   ];
   let existing = '';
   try { existing = readFileSync(join(workspace, '.gitignore'), 'utf8'); } catch {}
@@ -423,19 +424,19 @@ function profilePath(workspace) {
 
 const PROFILES = {
   balanced: {
-    description: 'Standard routing — best model for each tier, normal budgets',
+    description: 'Auto-routes by complexity, uses both providers evenly',
     routing: { prefer_provider: 'auto', think_threshold: 'normal', gpt_dispatch_bias: 0 },
     budgets: { session_warn_usd: 5, session_limit_usd: 10, daily_warn_usd: 20, daily_limit_usd: 50 },
     quality_gate: { sensitivity_floor: 'medium', dual_brain_minimum: 'high' },
   },
   'cost-saver': {
-    description: 'Minimize spend — prefer cheaper models, skip GPT for low risk',
+    description: 'Conservative — fewer GPT dispatches, sticks to Claude',
     routing: { prefer_provider: 'cheapest', think_threshold: 'strict', gpt_dispatch_bias: -20 },
     budgets: { session_warn_usd: 2, session_limit_usd: 5, daily_warn_usd: 8, daily_limit_usd: 20 },
     quality_gate: { sensitivity_floor: 'high', dual_brain_minimum: 'critical' },
   },
   'quality-first': {
-    description: 'Maximum quality — dual-brain for medium+, stricter reviews',
+    description: 'Aggressive — maximizes both subscriptions, dual-brain for medium+',
     routing: { prefer_provider: 'most-capable', think_threshold: 'relaxed', gpt_dispatch_bias: 10 },
     budgets: { session_warn_usd: 15, session_limit_usd: 30, daily_warn_usd: 50, daily_limit_usd: 100 },
     quality_gate: { sensitivity_floor: 'low', dual_brain_minimum: 'medium' },
@@ -489,16 +490,18 @@ function cmdMode() {
 
   if (!modeArg || modeArg === 'list') {
     const current = loadProfile(workspace);
-    const PEMOJIS = { balanced: '⚖️ ', 'cost-saver': '💸', 'quality-first': '💎' };
+    const PEMOJIS = { balanced: '⚖️ ', 'cost-saver': '🛡️', 'quality-first': '🚀' };
+    const UI_NAMES = { balanced: 'Default', 'cost-saver': 'Conservative', 'quality-first': 'Aggressive' };
     console.log('');
-    console.log('  🎛️  Profiles:');
+    console.log('  🎛️  Routing modes:');
     console.log('');
     for (const [name, p] of Object.entries(PROFILES)) {
       const active = name === current.name ? ' ✅ active' : '';
-      console.log(`    ${PEMOJIS[name] || '  '} ${name.padEnd(15)} ${p.description}${active}`);
+      const label = UI_NAMES[name] || name;
+      console.log(`    ${PEMOJIS[name] || '  '} ${label.padEnd(15)} ${p.description}${active}`);
     }
     console.log('');
-    console.log(`  Switch: ${cmd('npx dual-brain mode <profile>')}`);
+    console.log(`  Switch: ${cmd('npx dual-brain mode <name>')}`);
     console.log('');
     return;
   }
@@ -521,9 +524,10 @@ function cmdMode() {
 
   saveProfile(workspace, modeArg, customOverrides);
 
-  const PEMOJIS = { balanced: '⚖️ ', 'cost-saver': '💸', 'quality-first': '💎' };
+  const PEMOJIS = { balanced: '⚖️ ', 'cost-saver': '🛡️', 'quality-first': '🚀' };
+  const UI_NAMES = { balanced: 'Default', 'cost-saver': 'Conservative', 'quality-first': 'Aggressive' };
   console.log('');
-  console.log(`  ✅ Profile switched: ${PEMOJIS[modeArg] || ''} ${modeArg}`);
+  console.log(`  ✅ Mode switched: ${PEMOJIS[modeArg] || ''} ${UI_NAMES[modeArg] || modeArg}`);
   console.log(`  ${profile.description}`);
   console.log('');
   console.log('  🧭 Routing changes:');
@@ -546,12 +550,12 @@ function cmdBudget() {
   if (sessionArg == null) {
     const profile = loadProfile(workspace);
     console.log('');
-    console.log('  💵 Current budget:');
-    console.log(`    Session: ⚠️  $${profile.budgets.session_warn_usd} warn · 🛑 $${profile.budgets.session_limit_usd} limit`);
-    console.log(`    Daily:   ⚠️  $${profile.budgets.daily_warn_usd} warn · 🛑 $${profile.budgets.daily_limit_usd} limit`);
+    console.log('  📊 Usage alert thresholds (estimated, not billing caps):');
+    console.log(`    Session: ⚠️  $${profile.budgets.session_warn_usd} warn · 🛑 $${profile.budgets.session_limit_usd} alert`);
+    console.log(`    Daily:   ⚠️  $${profile.budgets.daily_warn_usd} warn · 🛑 $${profile.budgets.daily_limit_usd} alert`);
     console.log('');
-    console.log(`  Set limits: ${cmd('npx dual-brain budget <session$> [daily$]')}`);
-    console.log(`  Example:    ${cmd('npx dual-brain budget 8 25')}`);
+    console.log(`  Adjust: ${cmd('npx dual-brain budget <session$> [daily$]')}`);
+    console.log(`  Example: ${cmd('npx dual-brain budget 8 25')}`);
     console.log('');
     return;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dual-brain",
-  "version": "3.4.0",
+  "version": "3.6.0",
   "description": "Dual-provider orchestration for Claude Code — tiered routing, budget balancing, and GPT dual-brain review across Claude + OpenAI subscriptions",
   "type": "module",
   "bin": {