dual-brain 3.2.0 → 3.4.0

package/install.mjs

@@ -39,34 +39,34 @@ if (flag('--version') || flag('-v')) {
 
 if (flag('--help') || flag('-h')) {
   console.log(`
-  dual-brain v${VERSION} — Dual-provider orchestrator for Claude Code
+  🧠 dual-brain v${VERSION} — Dual-provider orchestrator for Claude Code
 
   Usage:  npx -y dual-brain [command] [options]
 
-  Commands:
-    (none)       Auto-detect and install/update orchestrator
-    status       Live view of mode, spend, pressure, profile
-    mode         Show or switch profile (balanced, cost-saver, quality-first)
-    budget       Set session/daily spend limits
-    explain      Show why the last routing decision was made
-    init         Alias for default install (backward compat)
+  ⌨️  Commands:
+    (none)       🧠 Auto-detect and install/update orchestrator
+    status       🟢 Open live control panel
+    mode         🎛️  Show or switch profile
+    budget       💵 Set session/daily spend limits
+    explain      🧭 Explain last routing decision
+    init         Alias for default install
 
   Options:
-    --force      Overwrite all existing config (keeps review-rules.md)
-    --dry-run    Detect environment only, don't install
-    --json       Output detection as JSON (implies --dry-run)
+    --force      Overwrite all existing config
+    --dry-run    Detect environment only
+    --json       Output detection as JSON
     --help       Show this help
 
-  Profiles:
-    balanced       Standard routing — best model for each tier
-    cost-saver     Minimize spend — prefer cheaper models
-    quality-first  Maximum quality — dual-brain for medium+ risk
+  🎛️  Profiles:
+    ⚖️  balanced       Standard routing — best model per tier
+    💸 cost-saver     Minimize spend — prefer cheaper models
+    💎 quality-first  Maximum quality — dual-brain for medium+
 
-  Examples:
+  🚀 Examples:
     ${cmd('npx dual-brain')}                  # install or update
-    ${cmd('npx dual-brain status')}           # live dashboard
+    ${cmd('npx dual-brain status')}           # open control panel
     ${cmd('npx dual-brain mode cost-saver')}  # switch profile
-    ${cmd('npx dual-brain budget 8 25')}      # $8 session / $25 daily
+    ${cmd('npx dual-brain budget 8 25')}      # \$8 session / \$25 daily
     ${cmd('npx dual-brain explain')}          # last routing decision
   `);
   process.exit(0);
@@ -334,7 +334,7 @@ function install(workspace, env, mode) {
     'test-orchestrator.mjs', 'setup-wizard.mjs', 'health-check.mjs',
     'install-git-hooks.mjs', 'session-report.mjs', 'budget-balancer.mjs',
     'gpt-work-dispatcher.mjs', 'profiles.mjs',
-    'summary-checkpoint.mjs', 'decision-ledger.mjs',
+    'summary-checkpoint.mjs', 'decision-ledger.mjs', 'control-panel.mjs',
   ];
   for (const h of HOOKS) cpSync(join(__dirname, 'hooks', h), join(target, 'hooks', h));
   actions.push(`✓ ${HOOKS.length} hook scripts`);
@@ -381,106 +381,36 @@ function install(workspace, env, mode) {
 
 // ─── Status Report ──────────────────────────────────────────────────────────
 
-function statusIcon(val) { return val ? '✓' : '✗'; }
-
-function printReport(env, mode, actions) {
+function printReport(env, mode, actions, isDryRun) {
   const lines = [];
 
   lines.push(br('╔', '╗'));
-  lines.push(ln(`Dual-Brain Orchestrator v${VERSION}`));
+  lines.push(ln(`🧠 Dual-Brain v${VERSION}`));
   lines.push(sep());
 
-  lines.push(ln('Environment'));
+  const cAuth = env.claude.authed ? '✅' : env.claude.installed ? '⚠️' : '❌';
+  const xAuth = env.codex.authed ? '✅' : env.codex.installed ? '⚠️' : '❌';
+  lines.push(ln(`  🟠 Claude ${cAuth}   🟢 Codex ${xAuth}`));
+
   if (env.isReplit) {
-    lines.push(ln(`  Platform:    Replit${env.hasReplitTools ? ' (replit-tools detected)' : ''}`));
-  } else {
-    lines.push(ln('  Platform:    standalone'));
+    lines.push(ln(`  🌀 Replit${env.hasReplitTools ? ' + replit-tools' : ''}`));
   }
 
-  const cVer = env.claude.version ? ` ${env.claude.version}` : '';
-  const cAuth = env.claude.authed ? 'authenticated' : env.claude.installed ? 'not authenticated' : 'not found';
-  lines.push(ln(`  Claude CLI:  ${statusIcon(env.claude.authed)} ${cAuth}${cVer}`));
-
-  const xVer = env.codex.version ? ` ${env.codex.version}` : '';
-  const xAuth = env.codex.authed ? 'authenticated' : env.codex.installed ? 'not authenticated' : 'not found';
-  lines.push(ln(`  Codex CLI:   ${statusIcon(env.codex.authed)} ${xAuth}${xVer}`));
-
-  lines.push(sep());
-  lines.push(ln(`Mode: ${MODE_LABELS[mode.mode]}`));
-
   if (actions) {
     lines.push(sep());
-    lines.push(ln('Installed'));
     for (const a of actions) lines.push(ln(`  ${a}`));
-  }
-
-  const needsAction = !env.claude.authed || !env.codex.authed;
-  if (needsAction && mode.mode !== 'dual') {
     lines.push(sep());
-    lines.push(ln('To unlock full features:'));
-    if (!env.claude.installed) {
-      lines.push(ln('  curl -fsSL https://claude.ai/install.sh | sh'));
-    }
-    if (!env.claude.authed) {
-      lines.push(ln('  claude login'));
-    }
-    if (!env.codex.installed) {
-      lines.push(ln('  npm i -g @openai/codex'));
-    }
-    if (!env.codex.authed && env.codex.installed) {
-      lines.push(ln('  codex login'));
-    }
-    lines.push(ln('  Then run: npx dual-brain'));
-  }
-
-  lines.push(sep());
-  if (actions) {
-    lines.push(ln(mode.mode === 'dual'
-      ? 'Ready — both providers active, no restart needed'
-      : 'Ready — hooks active, run commands above for full power'));
-  } else {
+    lines.push(ln('✅ Installed — launching session manager...'));
+  } else if (isDryRun) {
+    lines.push(sep());
     lines.push(ln('Dry run — no files written'));
   }
+
   lines.push(br('╚', '╝'));
 
   console.log('');
   for (const l of lines) console.log(`  ${l}`);
   console.log('');
-
-  if (actions) {
-    console.log('  What just happened:');
-    console.log('  Every Claude Code session in this project now auto-routes');
-    console.log('  agent work by complexity — cheap models for search, mid-tier');
-    console.log('  for execution, best models for thinking. Cost is tracked.');
-    if (mode.mode === 'dual') {
-      console.log('  Both Claude and GPT are available as work providers.');
-    }
-    console.log('');
-    if (IS_REPLIT) {
-      console.log('  Try these in your Replit shell (paste with ! prefix):');
-      console.log(`    ${cmd('npx dual-brain status')}              # live dashboard`);
-      console.log(`    ${cmd('npx dual-brain mode cost-saver')}     # switch profile`);
-      console.log(`    ${cmd('npx dual-brain budget 8 25')}         # set limits`);
-    } else {
-      console.log('  Try these in your next Claude Code session:');
-      console.log('    npx dual-brain status              # live dashboard');
-      console.log('    npx dual-brain mode cost-saver     # switch profile');
-      console.log('    npx dual-brain budget 8 25         # set limits');
-    }
-    console.log('');
-    console.log('  In-session tools (ask Claude to run these):');
-    console.log('    node .claude/hooks/health-check.mjs     # verify setup');
-    console.log('    node .claude/hooks/cost-report.mjs      # see activity');
-    console.log('    node .claude/hooks/budget-balancer.mjs   # provider balance');
-    if (mode.openaiEnabled) {
-      console.log('    node .claude/hooks/dual-brain-review.mjs # GPT code review');
-    }
-    console.log('');
-    console.log('  Customize:');
-    console.log('    .claude/review-rules.md     # your project\'s review rules');
-    console.log('    .claude/orchestrator.json   # routing, budgets, tiers');
-    console.log('');
-  }
 }
 
 // ─── Profile System ────────────────────────────────────────────────────────
@@ -541,70 +471,13 @@ function saveProfile(workspace, name, customOverrides) {
 
 // ─── Subcommand: status ────────────────────────────────────────────────────
 
-function cmdStatus() {
-  const workspace = resolve(process.cwd());
-  const env = detectEnvironment();
-  const mode = resolveMode(env);
-  const profile = loadProfile(workspace);
-
-  const lines = [];
-  lines.push(br('╔', '╗'));
-  lines.push(ln(`Dual-Brain Status — v${VERSION}`));
-  lines.push(sep());
-
-  lines.push(ln(`Mode:    ${MODE_LABELS[mode.mode]}`));
-  lines.push(ln(`Profile: ${profile.name}`));
-  lines.push(ln(`  ${PROFILES[profile.name]?.description || ''}`));
-  if (profile.switched_at) {
-    lines.push(ln(`  Set:   ${profile.switched_at.slice(0, 16).replace('T', ' ')}`));
-  }
-
-  lines.push(sep());
-
-  lines.push(ln('Budget Limits'));
-  lines.push(ln(`  Session: warn $${profile.budgets.session_warn_usd} / limit $${profile.budgets.session_limit_usd}`));
-  lines.push(ln(`  Daily:   warn $${profile.budgets.daily_warn_usd} / limit $${profile.budgets.daily_limit_usd}`));
-
-  lines.push(sep());
-
-  lines.push(ln('Providers'));
-  const cAuth = env.claude.authed ? 'authenticated' : 'not authenticated';
-  const xAuth = env.codex.authed ? 'authenticated' : env.codex.installed ? 'not authenticated' : 'not found';
-  lines.push(ln(`  Claude: ${statusIcon(env.claude.authed)} ${cAuth}`));
-  lines.push(ln(`  Codex:  ${statusIcon(env.codex.authed)} ${xAuth}`));
-
-  lines.push(sep());
-
-  lines.push(ln('Quality Gate'));
-  lines.push(ln(`  Reviews from:  ${profile.quality_gate.sensitivity_floor} risk+`));
-  lines.push(ln(`  Dual-brain at: ${profile.quality_gate.dual_brain_minimum} risk+`));
-
-  const balancer = join(workspace, '.claude', 'hooks', 'budget-balancer.mjs');
-  if (existsSync(balancer)) {
-    const proc = run(process.execPath, [balancer]);
-    if (proc.status === 0 && proc.stdout.trim()) {
-      lines.push(sep());
-      lines.push(ln('Provider Pressure (5hr rolling)'));
-      for (const l of proc.stdout.trim().split('\n')) {
-        if (l.includes('█') || l.includes('░') || l.includes('Recommendation')) {
-          const cleaned = l.replace(/[║╔╗╠╣╚╝═]/g, '').trim();
-          if (cleaned) lines.push(ln(`  ${cleaned}`));
-        }
-      }
-    }
-  }
-
-  lines.push(br('╚', '╝'));
-
-  console.log('');
-  for (const l of lines) console.log(`  ${l}`);
-  console.log('');
-
-  if (IS_REPLIT) {
-    console.log('  Quick actions (paste into shell):');
-    console.log(`    ${cmd('npx dual-brain mode cost-saver')}   # switch profile`);
-    console.log(`    ${cmd('npx dual-brain budget 8 25')}       # set limits`);
-    console.log('');
+function launchPanel() {
+  const panelPath = join(resolve(process.cwd()), '.claude', 'hooks', 'control-panel.mjs');
+  const pkgPanel = join(__dirname, 'hooks', 'control-panel.mjs');
+  const panel = existsSync(panelPath) ? panelPath : existsSync(pkgPanel) ? pkgPanel : null;
+  if (panel) {
+    const { status } = spawnSync(process.execPath, [panel], { stdio: 'inherit' });
+    process.exit(status || 0);
   }
 }
 
@@ -616,12 +489,13 @@ function cmdMode() {
 
   if (!modeArg || modeArg === 'list') {
     const current = loadProfile(workspace);
+    const PEMOJIS = { balanced: '⚖️ ', 'cost-saver': '💸', 'quality-first': '💎' };
     console.log('');
-    console.log('  Available profiles:');
+    console.log('  🎛️  Profiles:');
     console.log('');
     for (const [name, p] of Object.entries(PROFILES)) {
-      const active = name === current.name ? ' ← active' : '';
-      console.log(`    ${name.padEnd(15)} ${p.description}${active}`);
+      const active = name === current.name ? ' ✅ active' : '';
+      console.log(`    ${PEMOJIS[name] || '  '} ${name.padEnd(15)} ${p.description}${active}`);
     }
     console.log('');
     console.log(`  Switch: ${cmd('npx dual-brain mode <profile>')}`);
@@ -647,17 +521,18 @@ function cmdMode() {
 
   saveProfile(workspace, modeArg, customOverrides);
 
+  const PEMOJIS = { balanced: '⚖️ ', 'cost-saver': '💸', 'quality-first': '💎' };
   console.log('');
-  console.log(`  Profile switched to: ${modeArg}`);
+  console.log(`  ✅ Profile switched: ${PEMOJIS[modeArg] || ''} ${modeArg}`);
   console.log(`  ${profile.description}`);
   console.log('');
-  console.log('  What changed:');
-  console.log(`    Routing:      ${profile.routing.prefer_provider}`);
-  console.log(`    Budget:       $${profile.budgets.session_limit_usd}/session, $${profile.budgets.daily_limit_usd}/day`);
-  console.log(`    Reviews from: ${profile.quality_gate.sensitivity_floor} risk+`);
-  console.log(`    Dual-brain:   ${profile.quality_gate.dual_brain_minimum} risk+`);
+  console.log('  🧭 Routing changes:');
+  console.log(`    Provider:     ${profile.routing.prefer_provider}`);
+  console.log(`    💵 Budget:    $${profile.budgets.session_limit_usd}/session, $${profile.budgets.daily_limit_usd}/day`);
+  console.log(`    🛡️  Reviews:   ${profile.quality_gate.sensitivity_floor} risk+`);
+  console.log(`    🧠 Dual-brain: ${profile.quality_gate.dual_brain_minimum} risk+`);
   console.log('');
-  console.log('  Active immediately — no restart needed.');
+  console.log('  🟢 Active immediately, no restart needed.');
   console.log('');
 }
 
@@ -671,9 +546,9 @@ function cmdBudget() {
   if (sessionArg == null) {
     const profile = loadProfile(workspace);
     console.log('');
-    console.log('  Current budget limits:');
-    console.log(`    Session: warn $${profile.budgets.session_warn_usd} / limit $${profile.budgets.session_limit_usd}`);
-    console.log(`    Daily:   warn $${profile.budgets.daily_warn_usd} / limit $${profile.budgets.daily_limit_usd}`);
+    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('');
     console.log(`  Set limits: ${cmd('npx dual-brain budget <session$> [daily$]')}`);
     console.log(`  Example:    ${cmd('npx dual-brain budget 8 25')}`);
@@ -710,11 +585,11 @@ function cmdBudget() {
   renameSync(budgetTmp, budgetTarget);
 
   console.log('');
-  console.log('  Budget limits updated:');
-  console.log(`    Session: warn $${customOverrides.budgets.session_warn_usd} / limit $${sessionArg}`);
-  console.log(`    Daily:   warn $${customOverrides.budgets.daily_warn_usd} / limit $${daily}`);
+  console.log('  ✅ Budget updated:');
+  console.log(`    Session: ⚠️  $${customOverrides.budgets.session_warn_usd} warn · 🛑 $${sessionArg} limit`);
+  console.log(`    Daily:   ⚠️  $${customOverrides.budgets.daily_warn_usd} warn · 🛑 $${daily} limit`);
   console.log('');
-  console.log('  Active immediately — no restart needed.');
+  console.log('  🟢 Active immediately, no restart needed.');
   console.log('');
 }
 
@@ -728,7 +603,7 @@ function cmdExplain() {
 
   if (!existsSync(logFile)) {
     console.log('');
-    console.log('  No routing decisions recorded today.');
+    console.log('  💤 No routing decisions recorded today.');
     console.log('  Start a Claude Code session and the tier enforcer will log decisions.');
     console.log('');
     return;
@@ -752,7 +627,7 @@ function cmdExplain() {
 
   if (!lastRec) {
     console.log('');
-    console.log('  No routing decisions found in today\'s log.');
+    console.log('  💤 No routing decisions found in today\'s log.');
     console.log('  The tier enforcer logs decisions when Agent tool is used.');
     console.log('');
     return;
@@ -761,23 +636,23 @@ function cmdExplain() {
   const profile = loadProfile(workspace);
 
   console.log('');
-  console.log('  Last Routing Decision');
+  console.log('  🧭 Last Routing Decision');
   console.log('  ' + '─'.repeat(40));
-  console.log(`  Time:        ${lastRec.timestamp?.slice(11, 19) || 'unknown'}`);
-  console.log(`  Detected:    ${lastRec.detected_tier || 'unknown'} tier`);
-  console.log(`  Recommended: ${lastRec.recommended_model || 'unknown'}`);
-  console.log(`  Actual:      ${lastRec.actual_model || 'unknown'}`);
-  console.log(`  Followed:    ${lastRec.followed ? 'yes' : 'no'}`);
-  console.log(`  Profile:     ${profile.name}`);
+  console.log(`  🕐 Time:         ${lastRec.timestamp?.slice(11, 19) || 'unknown'}`);
+  console.log(`  🔎 Detected:     ${lastRec.detected_tier || 'unknown'} tier`);
+  console.log(`  🧠 Recommended:  ${lastRec.recommended_model || 'unknown'}`);
+  console.log(`  🎯 Actual:       ${lastRec.actual_model || 'unknown'}`);
+  console.log(`  ${lastRec.followed ? '✅' : '⚠️'}  Followed:     ${lastRec.followed ? 'yes' : 'no'}`);
+  console.log(`  🎛️  Profile:      ${profile.name}`);
   console.log('');
 
   if (!lastRec.followed) {
-    console.log('  The recommendation was not followed. This may mean:');
+    console.log('  ⚠️  Recommendation was overridden. This may mean:');
     console.log('  - The task needed a different model (valid override)');
     console.log('  - The subagent_type forced a specific tier');
     console.log(`  - Profile "${profile.name}" adjusted the threshold`);
   } else {
-    console.log('  The recommendation was followed — routing worked as expected.');
+    console.log('  ✅ Routing matched the recommendation.');
   }
 
   let total = 0, followed = 0;
@@ -796,7 +671,10 @@ function cmdExplain() {
 // ─── Main ───────────────────────────────────────────────────────────────────
 
 function main() {
-  if (subcommand === 'status')  { cmdStatus();  return; }
+  if (subcommand === 'status') {
+    launchPanel();
+    return;
+  }
   if (subcommand === 'mode')    { cmdMode();    return; }
   if (subcommand === 'budget')  { cmdBudget();  return; }
   if (subcommand === 'explain') { cmdExplain(); return; }
@@ -808,13 +686,29 @@ function main() {
     if (jsonOut) {
       console.log(JSON.stringify({ version: VERSION, env, mode }, null, 2));
     } else {
-      printReport(env, mode, null);
+      printReport(env, mode, null, true);
     }
     process.exit(0);
   }
 
+  // Check for replit-tools on Replit
+  if (env.isReplit && !env.hasReplitTools) {
+    console.log('');
+    console.log('  ⚠️  replit-tools not found — recommended for Replit environments.');
+    console.log('  Dual-brain works best alongside replit-tools for persistent auth,');
+    console.log('  session management, and shell integration.');
+    console.log('');
+    console.log(`  Install: ${cmd('npx -y data-tools')}`);
+    console.log('');
+  }
+
   const actions = install(env.workspace, env, mode);
   printReport(env, mode, actions);
+
+  // After install, launch the session manager (interactive TTY only)
+  if (process.stdin.isTTY && process.stdout.isTTY && !process.env.CI) {
+    launchPanel();
+  }
 }
 
 main();

package/package.json

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