dual-brain 3.0.0 → 3.1.0

package/hooks/cost-report.mjs

@@ -200,6 +200,8 @@ function allOpusCost(records, rateMap, datePrefix = null) {
 // Formatting helpers
 // ---------------------------------------------------------------------------
 
+const W = 50;
+
 const TIER_ORDER = ["search", "execute", "think"];
 
 const TIER_LABELS = {
@@ -224,8 +226,6 @@ function renderTable(title, aggregated, allOpus, records = []) {
   const savings    = allOpus - totalCost;
   const savingsPct = allOpus > 0 ? Math.round((savings / allOpus) * 100) : 0;
 
-  const W = 50; // total inner width (between ║ chars)
-
   const line   = (s)      => `║ ${pad(s, W - 2)} ║`;
   const border = (l, r, m) => l + "═".repeat(W) + r;
   const sep    = ()        => "╠" + "═".repeat(W) + "╣";

package/hooks/dual-brain-review.mjs

@@ -14,7 +14,7 @@
 
 import { execSync, spawnSync } from 'child_process';
 import { readFileSync } from 'fs';
-import { dirname, resolve } from 'path';
+import { dirname, join, resolve } from 'path';
 import { fileURLToPath } from 'url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));

package/hooks/setup-wizard.mjs

@@ -119,7 +119,7 @@ async function main() {
 
   console.log(`  ║ Quality gate: ${gateEnabled ? 'enabled' : 'disabled'}`.padEnd(53) + '║');
   console.log('  ╠══════════════════════════════════════════════════╣');
-  console.log('  ║ Restart Claude Code to activate the orchestrator ║');
+  console.log('  ║ Hooks are active — no restart needed              ║');
   console.log('  ╚══════════════════════════════════════════════════╝');
   console.log('');
 

package/hooks/usage-2026-05-14.jsonl

@@ -0,0 +1,5 @@
+{"timestamp":"2026-05-14T00:33:17.462Z","type":"tier_recommendation","detected_tier":"search","recommended_model":"haiku","actual_model":"opus","prompt_hash":"9990d6fd8943","followed":false}
+{"timestamp":"2026-05-14T00:33:17.501Z","type":"tier_recommendation","detected_tier":"execute","recommended_model":"sonnet","actual_model":"sonnet","prompt_hash":"c636a5e74cdc","followed":true}
+{"timestamp":"2026-05-14T00:33:17.536Z","type":"tier_recommendation","detected_tier":"think","recommended_model":"opus","actual_model":"haiku","prompt_hash":"bd666c33402c","followed":false}
+{"timestamp":"2026-05-14T00:33:17.606Z","type":"tier_recommendation","detected_tier":"execute","recommended_model":"sonnet","actual_model":"unknown-model-xyz","prompt_hash":"913203af69f8","followed":false}
+{"timestamp":"2026-05-14T00:33:17.746Z","type":"tier_recommendation","detected_tier":"think","recommended_model":"opus","actual_model":"gpt-4.1-mini","prompt_hash":"7196103e6569","followed":false}

package/install.mjs

@@ -24,6 +24,11 @@ const force = flag('--force');
 const dryRun = flag('--dry-run');
 const jsonOut = flag('--json');
 
+if (flag('--version') || flag('-v')) {
+  console.log(`dual-brain v${VERSION}`);
+  process.exit(0);
+}
+
 if (flag('--help') || flag('-h')) {
   console.log(`
   dual-brain v${VERSION} — Dual-provider orchestrator for Claude Code
@@ -240,7 +245,20 @@ function generateSettings(workspace) {
     ],
   };
 
-  return { ...existing, hooks };
+  const DUAL_BRAIN_CMDS = [
+    'node .claude/hooks/enforce-tier.mjs',
+    'node .claude/hooks/cost-logger.mjs',
+  ];
+
+  const merged = { ...(existing.hooks || {}) };
+  for (const [event, entries] of Object.entries(hooks)) {
+    const existingEntries = (merged[event] || []).filter(e =>
+      !e.hooks?.some(h => DUAL_BRAIN_CMDS.includes(h.command))
+    );
+    merged[event] = [...existingEntries, ...entries];
+  }
+
+  return { ...existing, hooks: merged };
 }
 
 function generateClaudeMd(mode) {
@@ -322,7 +340,7 @@ function install(workspace, env, mode) {
   if (needed.length > 0) {
     writeFileSync(
       join(workspace, '.gitignore'),
-      gi + '\n# Dual-Brain Orchestrator\n' + needed.join('\n') + '\n'
+      (gi && !gi.endsWith('\n') ? gi + '\n' : gi) + '\n# Dual-Brain Orchestrator\n' + needed.join('\n') + '\n'
     );
     actions.push('✓ .gitignore updated');
   }
@@ -397,6 +415,29 @@ function printReport(env, mode, actions) {
   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('');
+    console.log('  Try these in your next Claude Code session:');
+    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('');
+  }
 }
 
 // ─── Main ───────────────────────────────────────────────────────────────────

package/package.json

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