dual-brain 3.7.2 → 3.8.0

package/README.md

@@ -1,6 +1,6 @@
 # Dual-Brain Orchestrator
 
-One command. Both brains. Auto-detected. Auto-configured.
+One command. Both brains. Auto-detected. Auto-configured. Default profile: **auto**.
 
 Dual-provider orchestration for Claude Code across Claude and OpenAI subscriptions. Routes search to cheap models, execution to mid-tier, thinking to the most capable. Dispatches work to GPT via Codex CLI. Dual-brain analysis for high-risk decisions.
 
@@ -36,9 +36,9 @@ npx -y dual-brain
 
 ## How it works
 
-**Two hooks fire automatically** (registered in `.claude/settings.json`):
+**Two advisory hooks** are registered in `.claude/settings.json` and fire on each tool use. They detect and recommend — they do not execute actions without user confirmation:
 
-- **enforce-tier.mjs** (PreToolUse on Agent): Classifies tasks, advises the correct model, detects duplicates, suggests cross-provider routing
+- **enforce-tier.mjs** (PreToolUse on Agent): Classifies tasks, recommends the correct model tier, detects duplicates, suggests cross-provider routing
 - **cost-logger.mjs** (PostToolUse on all tools): Logs usage to daily rotated files for cost tracking
 
 **Three tiers route work by complexity:**
@@ -49,7 +49,7 @@ npx -y dual-brain
 | Execute | Sonnet | GPT-5.4 | edits, tests, git ops |
 | Think | Opus | GPT-5.5 | architecture, review, planning |
 
-**Dual-brain** kicks in automatically for high-risk decisions — both providers think on the same problem independently.
+**Dual-brain** is recommended automatically for high-risk decisions — hooks detect the risk level and suggest dual-brain analysis, where both providers think on the same problem independently.
 
 ## Scripts
 
@@ -63,7 +63,7 @@ npx -y dual-brain
 | `hooks/gpt-work-dispatcher.mjs` | Dispatch execution tasks to GPT via Codex CLI |
 | `hooks/session-report.mjs` | Session-end summary: activity, compliance, quality |
 | `hooks/health-check.mjs` | Verify all hooks and dependencies are working |
-| `hooks/test-orchestrator.mjs` | Self-test harness (14 tests) |
+| `hooks/test-orchestrator.mjs` | Self-test harness (29 tests) |
 | `hooks/setup-wizard.mjs` | Interactive config (optional — for custom plans) |
 | `hooks/install-git-hooks.mjs` | Git pre-commit hook for quality gate |
 
@@ -85,6 +85,20 @@ After install, edit these files:
 - `review-rules.md` — project-specific rules for GPT code review
 - `settings.json` — hook registrations (auto-generated, safe to extend)
 
+## Profiles
+
+The active profile controls routing posture, budgets, and quality gate behavior. Default: **auto**.
+
+```bash
+npx dual-brain mode cost-saver   # switch profile
+npx dual-brain status            # check current profile and provider health
+```
+
+- **auto** (default): Adapts routing based on task risk, provider health, and outcomes. Auto-escalates tier on repeated failures.
+- **balanced**: Best model per tier, normal budgets, reviews at medium+ risk.
+- **cost-saver**: Prefer cheaper models, lower budgets, skip GPT for non-critical work.
+- **quality-first**: Dual-brain for medium+ risk, higher budgets, stricter reviews.
+
 ## Requirements
 
 - Node 20+

package/hooks/enforce-tier.mjs

@@ -10,6 +10,17 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const CONFIG_FILE = resolve(__dirname, '..', 'orchestrator.json');
 const PROFILE_FILE = resolve(__dirname, '..', 'dual-brain.profile.json');
 const DRIFT_STATE = resolve(__dirname, '.drift-warned');
+const BURST_FILE = resolve(__dirname, '.burst-state');
+
+function detectBurst() {
+  const now = Date.now();
+  let state = { count: 0, window_start: now };
+  try { state = JSON.parse(readFileSync(BURST_FILE, 'utf8')); } catch {}
+  if (now - state.window_start > 90_000) state = { count: 0, window_start: now };
+  state.count++;
+  try { writeFileSync(BURST_FILE, JSON.stringify(state)); } catch {}
+  return state.count >= 3;
+}
 
 function loadProfile() {
   try {
@@ -205,12 +216,23 @@ try {
   // Compute prompt hash early for duplicate detection and logging
   const promptHash = createHash('sha256').update(text).digest('hex').slice(0, 12);
 
+  // Burst detection — suppress noise during wave launches (3+ agents in 90s)
+  const burstMode = detectBurst();
+
   // Check for duplicate agent dispatch before tier classification
   const duplicate = checkDuplicate(promptHash);
   let duplicateWarning = null;
   if (duplicate) {
     const minutesAgo = Math.round((Date.now() - Date.parse(duplicate.timestamp)) / 60000);
-    duplicateWarning = `**[Duplicate Warning]** A similar agent task was dispatched ${minutesAgo} minute${minutesAgo !== 1 ? 's' : ''} ago. Reuse the prior result unless the scope changed.`;
+    if (burstMode) {
+      // In burst mode, only warn on exact hash matches (same description+prompt)
+      if (duplicate.prompt_hash === promptHash) {
+        duplicateWarning = `**[Wave] [Duplicate Warning]** A similar agent task was dispatched ${minutesAgo} minute${minutesAgo !== 1 ? 's' : ''} ago. Reuse the prior result unless the scope changed.`;
+      }
+      // Otherwise suppress — similar-but-different agents in a wave are expected
+    } else {
+      duplicateWarning = `**[Duplicate Warning]** A similar agent task was dispatched ${minutesAgo} minute${minutesAgo !== 1 ? 's' : ''} ago. Reuse the prior result unless the scope changed.`;
+    }
   }
 
   let config;
@@ -315,7 +337,8 @@ try {
   }
 
   // Compute balance hint now that tier is resolved
-  {
+  // In burst mode, skip balance hints — one hint per wave is enough
+  if (!burstMode) {
     const currentProvider = detectProvider(currentModel);
     if (currentProvider === 'claude') {
       const balance = quickPressureCheck(tier);

package/hooks/test-orchestrator.mjs

@@ -27,6 +27,7 @@ const COST_LOGGER   = resolve(HOOKS, 'cost-logger.mjs');
 const DUAL_BRAIN    = resolve(HOOKS, 'dual-brain-review.mjs');
 const ORCHESTRATOR  = resolve(HOOKS, '..', 'orchestrator.json');
 const USAGE_JSONL   = resolve(HOOKS, `usage-${new Date().toISOString().slice(0, 10)}.jsonl`);
+const BURST_FILE    = resolve(HOOKS, '.burst-state');
 
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 
@@ -649,6 +650,84 @@ test('adaptive: cost-logger records Agent errors', () => {
   }
 });
 
+// ─── Test 30: enforce-tier: burst detection activates on 3+ agents ─────────
+test('enforce-tier: burst detection activates on 3+ agents', () => {
+  try {
+    // Write burst state at count 2, within window
+    writeFileSync(BURST_FILE, JSON.stringify({ count: 2, window_start: Date.now() }));
+    const payload = JSON.stringify({
+      tool_name: 'Agent',
+      tool_input: { prompt: `burst activation test ${Date.now()}`, model: 'sonnet' },
+    });
+    const { parsed, status } = run(ENFORCE_TIER, payload);
+    if (status !== 0) return `non-zero exit: ${status}`;
+    if (!parsed) return 'no valid JSON output';
+
+    // Read burst state — count should have incremented to >= 3
+    if (!existsSync(BURST_FILE)) return '.burst-state file was removed unexpectedly';
+    let state;
+    try { state = JSON.parse(readFileSync(BURST_FILE, 'utf8')); } catch (e) { return `.burst-state not valid JSON: ${e.message}`; }
+    if (state.count < 3) return `expected count >= 3, got: ${state.count}`;
+    return true;
+  } finally {
+    try { unlinkSync(BURST_FILE); } catch {}
+  }
+});
+
+// ─── Test 31: enforce-tier: burst mode suppresses duplicate warnings ───────
+test('enforce-tier: burst mode suppresses duplicate warnings', () => {
+  try {
+    // Pre-set burst mode (count=5, active window)
+    writeFileSync(BURST_FILE, JSON.stringify({ count: 5, window_start: Date.now() }));
+    const payload = JSON.stringify({
+      tool_name: 'Agent',
+      tool_input: { prompt: 'burst duplicate test identical prompt', model: 'sonnet' },
+    });
+
+    // First call — establishes the prompt hash
+    run(ENFORCE_TIER, payload);
+    // Second identical call — in burst mode, duplicate warning should be suppressed or [Wave]-prefixed
+    const { parsed, status } = run(ENFORCE_TIER, payload);
+    if (status !== 0) return `non-zero exit: ${status}`;
+    if (!parsed) return 'no valid JSON output';
+
+    // In burst mode: either no duplicate warning at all, or a [Wave]-prefixed one
+    const msg = parsed.systemMessage || '';
+    const hasDuplicateWarning = msg.toLowerCase().includes('duplicate');
+    if (hasDuplicateWarning && !msg.includes('[Wave]'))
+      return `expected no duplicate warning or [Wave]-prefixed in burst mode, got: ${msg}`;
+    return true;
+  } finally {
+    try { unlinkSync(BURST_FILE); } catch {}
+  }
+});
+
+// ─── Test 32: enforce-tier: non-burst mode still warns on duplicates ───────
+test('enforce-tier: non-burst mode still warns on duplicates', () => {
+  try {
+    // Expire burst state by setting window_start to 0 (well outside 90s window)
+    writeFileSync(BURST_FILE, JSON.stringify({ count: 0, window_start: 0 }));
+    const payload = JSON.stringify({
+      tool_name: 'Agent',
+      tool_input: { prompt: 'non-burst duplicate test identical prompt', model: 'sonnet' },
+    });
+
+    // First call — establishes the prompt hash
+    run(ENFORCE_TIER, payload);
+    // Second identical call — should trigger duplicate warning
+    const { parsed, status } = run(ENFORCE_TIER, payload);
+    if (status !== 0) return `non-zero exit: ${status}`;
+    if (!parsed) return 'no valid JSON output';
+
+    const msg = parsed.systemMessage || '';
+    if (!msg.toLowerCase().includes('duplicate'))
+      return `expected duplicate warning in non-burst mode, got: ${msg || '(empty)'}`;
+    return true;
+  } finally {
+    try { unlinkSync(BURST_FILE); } catch {}
+  }
+});
+
 // ─── Summary ─────────────────────────────────────────────────────────────────
 const total = passed + failed;
 console.log(`\n${passed}/${total} tests passed`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dual-brain",
-  "version": "3.7.2",
+  "version": "3.8.0",
   "description": "Dual-provider orchestration for Claude Code — tiered routing, budget balancing, and GPT dual-brain review across Claude + OpenAI subscriptions",
   "type": "module",
   "bin": {
@@ -22,6 +22,9 @@
     "type": "git",
     "url": "https://github.com/1xmint/dual-brain.git"
   },
+  "scripts": {
+    "test": "node hooks/test-orchestrator.mjs"
+  },
   "engines": {
     "node": ">=20.0.0"
   },