dual-brain 0.2.14 → 0.2.15

package/hooks/session-end.mjs

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+// session-end.mjs — Stop hook for dual-brain. Runs when Claude session ends.
+// Generates receipt, records metrics, cleans up stale locks.
+
+import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const WORKSPACE = join(new URL(import.meta.url).pathname, '..', '..', '..');
+const DUALBRAIN = join(WORKSPACE, '.dualbrain');
+const RECEIPTS_DIR = join(DUALBRAIN, 'receipts');
+
+// Read hook input from stdin
+let input = {};
+try {
+  input = JSON.parse(readFileSync('/dev/stdin', 'utf8'));
+} catch {
+  // Stop hook may not always get structured input
+}
+
+async function run() {
+  mkdirSync(RECEIPTS_DIR, { recursive: true });
+
+  // 1. Generate session receipt
+  const receipt = {
+    timestamp: new Date().toISOString(),
+    sessionId: input.session_id || 'unknown',
+    reason: input.stop_hook_reason || 'session_end',
+    metrics: {},
+    cleanup: [],
+  };
+
+  // 2. Collect metrics from audit log
+  const auditFile = join(DUALBRAIN, 'audit', 'head-audit.jsonl');
+  if (existsSync(auditFile)) {
+    try {
+      const lines = readFileSync(auditFile, 'utf8').trim().split('\n').filter(Boolean);
+      const entries = lines.map(l => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
+
+      // Filter to this session (last 2 hours as proxy)
+      const cutoff = Date.now() - 2 * 60 * 60 * 1000;
+      const sessionEntries = entries.filter(e => (e.timestamp || 0) > cutoff);
+
+      receipt.metrics.toolCalls = sessionEntries.length;
+      receipt.metrics.blocked = sessionEntries.filter(e => e.decision === 'block').length;
+      receipt.metrics.allowed = sessionEntries.filter(e => e.decision === 'allow').length;
+      receipt.metrics.agentDispatches = sessionEntries.filter(e => e.tool === 'Agent').length;
+    } catch {}
+  }
+
+  // 3. Check for cost log
+  const costLog = join(DUALBRAIN, 'cost-log.jsonl');
+  if (existsSync(costLog)) {
+    try {
+      const lines = readFileSync(costLog, 'utf8').trim().split('\n').filter(Boolean);
+      const cutoff = Date.now() - 2 * 60 * 60 * 1000;
+      const recent = lines.map(l => { try { return JSON.parse(l); } catch { return null; } })
+        .filter(e => e && (e.timestamp || 0) > cutoff);
+
+      receipt.metrics.costEntries = recent.length;
+    } catch {}
+  }
+
+  // 4. Clean up stale lock files
+  try {
+    const scanDirs = [DUALBRAIN, join(DUALBRAIN, 'doctor'), join(DUALBRAIN, 'receipts')];
+    for (const dir of scanDirs) {
+      if (!existsSync(dir)) continue;
+      const files = readdirSync(dir).filter(f => f.endsWith('.lock'));
+      for (const f of files) {
+        const lockPath = join(dir, f);
+        try {
+          const lockData = JSON.parse(readFileSync(lockPath, 'utf8'));
+          const age = Date.now() - (lockData.createdAt || 0);
+          if (age > 60000) { // older than 1 minute = stale
+            unlinkSync(lockPath);
+            receipt.cleanup.push(`removed stale lock: ${f}`);
+          }
+        } catch {
+          // Corrupt lock — remove
+          try { unlinkSync(lockPath); receipt.cleanup.push(`removed corrupt lock: ${f}`); } catch {}
+        }
+      }
+    }
+  } catch {}
+
+  // 5. Record git state for next session
+  try {
+    const { execSync } = await import('node:child_process');
+    receipt.gitState = {
+      branch: execSync('git rev-parse --abbrev-ref HEAD', { cwd: WORKSPACE, encoding: 'utf8', timeout: 3000 }).trim(),
+      uncommitted: parseInt(execSync('git status --porcelain | wc -l', { cwd: WORKSPACE, encoding: 'utf8', timeout: 3000 }).trim()) || 0,
+      lastCommit: execSync('git log --oneline -1', { cwd: WORKSPACE, encoding: 'utf8', timeout: 3000 }).trim(),
+    };
+  } catch {}
+
+  // 6. Persist immersion state and release session lock
+  try {
+    const { persist } = await import('../src/narrative.mjs');
+    const { prune } = await import('../src/simmer.mjs');
+    const { release } = await import('../src/session-lock.mjs');
+    persist();
+    prune();
+    release();
+    receipt.immersion = { narrativePersisted: true };
+  } catch {}
+
+  // 7. Save receipt
+  const receiptFile = join(RECEIPTS_DIR, `receipt-${Date.now()}.json`);
+  writeFileSync(receiptFile, JSON.stringify(receipt, null, 2) + '\n');
+
+  // 8. Print summary to stderr (visible to user)
+  const summary = [];
+  if (receipt.metrics.toolCalls) summary.push(`${receipt.metrics.toolCalls} tool calls`);
+  if (receipt.metrics.agentDispatches) summary.push(`${receipt.metrics.agentDispatches} agents dispatched`);
+  if (receipt.cleanup.length) summary.push(`${receipt.cleanup.length} locks cleaned`);
+
+  if (summary.length) {
+    process.stderr.write(`[dual-brain] Session end: ${summary.join(', ')}\n`);
+  }
+}
+
+run().then(() => process.exit(0)).catch(() => process.exit(0));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dual-brain",
-  "version": "0.2.14",
+  "version": "0.2.15",
   "description": "AI orchestration across Claude + OpenAI subscriptions — smart routing, budget awareness, and dual-brain collaboration",
   "type": "module",
   "bin": {
@@ -34,7 +34,18 @@
     "./templates": "./src/templates.mjs",
     "./agents": "./src/agents/registry.mjs",
     "./collaboration": "./src/collaboration.mjs",
-    "./provider-context": "./src/provider-context.mjs"
+    "./provider-context": "./src/provider-context.mjs",
+    "./cognitive-loop": "./src/cognitive-loop.mjs",
+    "./debrief": "./src/debrief.mjs",
+    "./wave-planner": "./src/wave-planner.mjs",
+    "./predictive": "./src/predictive.mjs",
+    "./inbox": "./src/inbox.mjs",
+    "./head-protocol": "./src/head-protocol.mjs",
+    "./narrative": "./src/narrative.mjs",
+    "./simmer": "./src/simmer.mjs",
+    "./memory-tiers": "./src/memory-tiers.mjs",
+    "./envelope": "./src/envelope.mjs",
+    "./session-lock": "./src/session-lock.mjs"
   },
   "keywords": [
     "claude-code",
@@ -108,6 +119,17 @@
     "src/agents/registry.mjs",
     "src/collaboration.mjs",
     "src/provider-context.mjs",
+    "src/cognitive-loop.mjs",
+    "src/debrief.mjs",
+    "src/wave-planner.mjs",
+    "src/predictive.mjs",
+    "src/inbox.mjs",
+    "src/head-protocol.mjs",
+    "src/narrative.mjs",
+    "src/simmer.mjs",
+    "src/memory-tiers.mjs",
+    "src/envelope.mjs",
+    "src/session-lock.mjs",
     "bin/*.mjs",
     "hooks/enforce-tier.mjs",
     "hooks/cost-logger.mjs",
@@ -136,6 +158,8 @@
     "hooks/model-registry.mjs",
     "hooks/auto-update-wrapper.mjs",
     "hooks/session-end.mjs",
+    "hooks/diagnostic-companion.mjs",
+    "hooks/precompact.mjs",
     "hooks/head-guard.mjs",
     "hooks/auto-update.sh",
     "mcp-server/*.mjs",