@soleri/core 2.0.2 → 2.1.0

package/dist/runtime/runtime.js

@@ -10,6 +10,7 @@ import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { Vault } from '../vault/vault.js';
 import { Brain } from '../brain/brain.js';
+import { BrainIntelligence } from '../brain/intelligence.js';
 import { Planner } from '../planning/planner.js';
 import { Curator } from '../curator/curator.js';
 import { KeyPool, loadKeyPoolConfig } from '../llm/key-pool.js';
@@ -41,6 +42,8 @@ export function createAgentRuntime(config) {
     const planner = new Planner(plansPath);
     // Brain — intelligence layer (TF-IDF scoring, auto-tagging, dedup)
     const brain = new Brain(vault);
+    // Brain Intelligence — pattern strengths, session knowledge, intelligence pipeline
+    const brainIntelligence = new BrainIntelligence(vault, brain);
     // Curator — vault self-maintenance (dedup, contradictions, grooming, health)
     const curator = new Curator(vault);
     // LLM key pools and client
@@ -52,6 +55,7 @@ export function createAgentRuntime(config) {
         config,
         vault,
         brain,
+        brainIntelligence,
         planner,
         curator,
         keyPool: { openai: openaiKeyPool, anthropic: anthropicKeyPool },

package/dist/runtime/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEpE,4CAA4C;IAC5C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAEnC,6CAA6C;IAC7C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAEvC,mEAAmE;IACnE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAE/B,6EAA6E;IAC7E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnC,2BAA2B;IAC3B,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,aAAa,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAE1E,OAAO;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,OAAO;QACP,OAAO;QACP,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE;QAC/D,SAAS;QACT,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE;KAC3B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEpE,4CAA4C;IAC5C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAEnC,6CAA6C;IAC7C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAEvC,mEAAmE;IACnE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAE/B,mFAAmF;IACnF,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAE9D,6EAA6E;IAC7E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnC,2BAA2B;IAC3B,MAAM,YAAY,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,aAAa,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAE1E,OAAO;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,iBAAiB;QACjB,OAAO;QACP,OAAO;QACP,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE;QAC/D,SAAS;QACT,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE;KAC3B,CAAC;AACJ,CAAC"}

package/dist/runtime/types.d.ts

@@ -1,5 +1,6 @@
 import type { Vault } from '../vault/vault.js';
 import type { Brain } from '../brain/brain.js';
+import type { BrainIntelligence } from '../brain/intelligence.js';
 import type { Planner } from '../planning/planner.js';
 import type { Curator } from '../curator/curator.js';
 import type { KeyPool } from '../llm/key-pool.js';
@@ -26,6 +27,7 @@ export interface AgentRuntime {
     config: AgentRuntimeConfig;
     vault: Vault;
     brain: Brain;
+    brainIntelligence: BrainIntelligence;
     planner: Planner;
     curator: Curator;
     keyPool: {

package/dist/runtime/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,SAAS,EAAE,SAAS,CAAC;IACrB,6DAA6D;IAC7D,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,SAAS,EAAE,SAAS,CAAC;IACrB,6DAA6D;IAC7D,KAAK,IAAI,IAAI,CAAC;CACf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/core",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "Shared engine for Soleri agents — vault, brain, planner, LLM utilities, and facade infrastructure.",
   "keywords": [
     "agent",

package/src/__tests__/brain-intelligence.test.ts

@@ -0,0 +1,623 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdirSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { createAgentRuntime } from '../runtime/runtime.js';
+import type { AgentRuntime } from '../runtime/types.js';
+import type { BrainExportData } from '../brain/types.js';
+
+describe('BrainIntelligence', () => {
+  let runtime: AgentRuntime;
+  let plannerDir: string;
+
+  beforeEach(() => {
+    plannerDir = join(tmpdir(), 'brain-intel-test-' + Date.now());
+    mkdirSync(plannerDir, { recursive: true });
+    runtime = createAgentRuntime({
+      agentId: 'test-brain-intel',
+      vaultPath: ':memory:',
+      plansPath: join(plannerDir, 'plans.json'),
+    });
+  });
+
+  afterEach(() => {
+    runtime.close();
+    rmSync(plannerDir, { recursive: true, force: true });
+  });
+
+  // ─── Initialization ─────────────────────────────────────────────
+
+  it('should initialize with empty stats', () => {
+    const stats = runtime.brainIntelligence.getStats();
+    expect(stats.strengths).toBe(0);
+    expect(stats.sessions).toBe(0);
+    expect(stats.activeSessions).toBe(0);
+    expect(stats.proposals).toBe(0);
+    expect(stats.promotedProposals).toBe(0);
+    expect(stats.globalPatterns).toBe(0);
+    expect(stats.domainProfiles).toBe(0);
+  });
+
+  it('should be accessible from runtime', () => {
+    expect(runtime.brainIntelligence).toBeDefined();
+    expect(typeof runtime.brainIntelligence.getStats).toBe('function');
+  });
+
+  // ─── Session Lifecycle ──────────────────────────────────────────
+
+  it('should start a session', () => {
+    const session = runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      domain: 'testing',
+      context: 'unit tests',
+    });
+    expect(session.id).toBeDefined();
+    expect(session.domain).toBe('testing');
+    expect(session.context).toBe('unit tests');
+    expect(session.endedAt).toBeNull();
+  });
+
+  it('should start a session with custom id', () => {
+    const session = runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'custom-123',
+      domain: 'dev',
+    });
+    expect(session.id).toBe('custom-123');
+  });
+
+  it('should end a session', () => {
+    const started = runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'end-test',
+      domain: 'testing',
+    });
+
+    const ended = runtime.brainIntelligence.lifecycle({
+      action: 'end',
+      sessionId: started.id,
+      toolsUsed: ['search', 'edit'],
+      filesModified: ['a.ts', 'b.ts'],
+      planOutcome: 'completed',
+    });
+
+    expect(ended.endedAt).not.toBeNull();
+    expect(ended.toolsUsed).toEqual(['search', 'edit']);
+    expect(ended.filesModified).toEqual(['a.ts', 'b.ts']);
+    expect(ended.planOutcome).toBe('completed');
+  });
+
+  it('should throw when ending session without sessionId', () => {
+    expect(() => {
+      runtime.brainIntelligence.lifecycle({ action: 'end' });
+    }).toThrow('sessionId required');
+  });
+
+  it('should track active sessions in stats', () => {
+    runtime.brainIntelligence.lifecycle({ action: 'start', sessionId: 'active-1' });
+    runtime.brainIntelligence.lifecycle({ action: 'start', sessionId: 'active-2' });
+    runtime.brainIntelligence.lifecycle({
+      action: 'end',
+      sessionId: 'active-1',
+    });
+
+    const stats = runtime.brainIntelligence.getStats();
+    expect(stats.sessions).toBe(2);
+    expect(stats.activeSessions).toBe(1);
+  });
+
+  // ─── Session Context ────────────────────────────────────────────
+
+  it('should return session context with frequencies', () => {
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'ctx-1',
+      toolsUsed: ['search', 'edit', 'search'],
+      filesModified: ['a.ts'],
+    });
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'ctx-2',
+      toolsUsed: ['search', 'write'],
+      filesModified: ['a.ts', 'b.ts'],
+    });
+
+    const ctx = runtime.brainIntelligence.getSessionContext();
+    expect(ctx.recentSessions.length).toBe(2);
+    expect(ctx.toolFrequency.length).toBeGreaterThan(0);
+    expect(ctx.fileFrequency.length).toBeGreaterThan(0);
+
+    const searchFreq = ctx.toolFrequency.find((t) => t.tool === 'search');
+    expect(searchFreq).toBeDefined();
+    expect(searchFreq!.count).toBe(3);
+  });
+
+  it('should limit session context results', () => {
+    for (let i = 0; i < 5; i++) {
+      runtime.brainIntelligence.lifecycle({
+        action: 'start',
+        sessionId: `limit-${i}`,
+      });
+    }
+    const ctx = runtime.brainIntelligence.getSessionContext(2);
+    expect(ctx.recentSessions.length).toBe(2);
+  });
+
+  // ─── Archive Sessions ────────────────────────────────────────────
+
+  it('should archive old sessions', () => {
+    const db = runtime.vault.getDb();
+    // Insert an old session directly
+    db.prepare(
+      `INSERT INTO brain_sessions (id, started_at, ended_at, tools_used, files_modified)
+       VALUES (?, datetime('now', '-60 days'), datetime('now', '-59 days'), '[]', '[]')`,
+    ).run('old-session');
+
+    runtime.brainIntelligence.lifecycle({ action: 'start', sessionId: 'new-session' });
+    runtime.brainIntelligence.lifecycle({ action: 'end', sessionId: 'new-session' });
+
+    const result = runtime.brainIntelligence.archiveSessions(30);
+    expect(result.archived).toBe(1);
+
+    const stats = runtime.brainIntelligence.getStats();
+    expect(stats.sessions).toBe(1); // only new-session remains
+  });
+
+  it('should not archive active sessions', () => {
+    runtime.brainIntelligence.lifecycle({ action: 'start', sessionId: 'active' });
+    const result = runtime.brainIntelligence.archiveSessions(0);
+    expect(result.archived).toBe(0);
+  });
+
+  // ─── Strength Scoring ──────────────────────────────────────────
+
+  it('should compute strengths from feedback', () => {
+    // Seed vault and record feedback
+    runtime.vault.seed([
+      {
+        id: 's-1',
+        type: 'pattern',
+        domain: 'testing',
+        title: 'Test pattern',
+        severity: 'warning',
+        description: 'A test pattern.',
+        tags: ['test'],
+      },
+    ]);
+
+    runtime.brain.recordFeedback('test query', 's-1', 'accepted');
+    runtime.brain.recordFeedback('test query 2', 's-1', 'accepted');
+    runtime.brain.recordFeedback('test query 3', 's-1', 'dismissed');
+
+    const strengths = runtime.brainIntelligence.computeStrengths();
+    expect(strengths.length).toBe(1);
+    expect(strengths[0].pattern).toBe('Test pattern');
+    expect(strengths[0].domain).toBe('testing');
+    expect(strengths[0].usageCount).toBe(3);
+    expect(strengths[0].successRate).toBeCloseTo(2 / 3, 2);
+    expect(strengths[0].strength).toBeGreaterThan(0);
+  });
+
+  it('should return empty strengths with no feedback', () => {
+    const strengths = runtime.brainIntelligence.computeStrengths();
+    expect(strengths).toEqual([]);
+  });
+
+  it('should get strengths with filters', () => {
+    runtime.vault.seed([
+      {
+        id: 'sf-1',
+        type: 'pattern',
+        domain: 'd1',
+        title: 'P1',
+        severity: 'warning',
+        description: 'D',
+        tags: [],
+      },
+      {
+        id: 'sf-2',
+        type: 'pattern',
+        domain: 'd2',
+        title: 'P2',
+        severity: 'warning',
+        description: 'D',
+        tags: [],
+      },
+    ]);
+    runtime.brain.recordFeedback('q', 'sf-1', 'accepted');
+    runtime.brain.recordFeedback('q', 'sf-2', 'accepted');
+    runtime.brainIntelligence.computeStrengths();
+
+    const d1 = runtime.brainIntelligence.getStrengths({ domain: 'd1' });
+    expect(d1.length).toBe(1);
+    expect(d1[0].domain).toBe('d1');
+  });
+
+  // ─── Recommendations ──────────────────────────────────────────
+
+  it('should recommend patterns', () => {
+    runtime.vault.seed([
+      {
+        id: 'r-1',
+        type: 'pattern',
+        domain: 'testing',
+        title: 'Test pattern',
+        severity: 'warning',
+        description: 'D',
+        tags: [],
+      },
+    ]);
+    // Need enough feedback to reach minStrength threshold of 30
+    for (let i = 0; i < 10; i++) {
+      runtime.brain.recordFeedback(`q${i}`, 'r-1', 'accepted');
+    }
+    runtime.brainIntelligence.computeStrengths();
+
+    const recommendations = runtime.brainIntelligence.recommend({ domain: 'testing' });
+    expect(recommendations.length).toBeGreaterThan(0);
+  });
+
+  it('should boost recommendations by task context', () => {
+    runtime.vault.seed([
+      {
+        id: 'rb-1',
+        type: 'pattern',
+        domain: 'd',
+        title: 'Database migration pattern',
+        severity: 'warning',
+        description: 'D',
+        tags: [],
+      },
+      {
+        id: 'rb-2',
+        type: 'pattern',
+        domain: 'd',
+        title: 'API endpoint pattern',
+        severity: 'warning',
+        description: 'D',
+        tags: [],
+      },
+    ]);
+    for (let i = 0; i < 10; i++) {
+      runtime.brain.recordFeedback(`q${i}`, 'rb-1', 'accepted');
+      runtime.brain.recordFeedback(`q${i}`, 'rb-2', 'accepted');
+    }
+    runtime.brainIntelligence.computeStrengths();
+
+    const recs = runtime.brainIntelligence.recommend({ task: 'database migration' });
+    if (recs.length >= 2) {
+      // Database pattern should be boosted
+      expect(recs[0].pattern).toContain('Database');
+    }
+  });
+
+  // ─── Knowledge Extraction ─────────────────────────────────────
+
+  it('should extract knowledge from session with repeated tools', () => {
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'extract-1',
+      toolsUsed: ['search', 'search', 'search', 'edit'],
+    });
+    runtime.brainIntelligence.lifecycle({
+      action: 'end',
+      sessionId: 'extract-1',
+    });
+
+    const result = runtime.brainIntelligence.extractKnowledge('extract-1');
+    expect(result.sessionId).toBe('extract-1');
+    expect(result.rulesApplied).toContain('repeated_tool_usage');
+    expect(result.proposals.length).toBeGreaterThan(0);
+    expect(result.proposals[0].rule).toBe('repeated_tool_usage');
+  });
+
+  it('should extract multi-file edit pattern', () => {
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'extract-2',
+      filesModified: ['a.ts', 'b.ts', 'c.ts'],
+    });
+    runtime.brainIntelligence.lifecycle({
+      action: 'end',
+      sessionId: 'extract-2',
+    });
+
+    const result = runtime.brainIntelligence.extractKnowledge('extract-2');
+    expect(result.rulesApplied).toContain('multi_file_edit');
+  });
+
+  it('should extract plan completed workflow', () => {
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'extract-3',
+      planId: 'plan-1',
+    });
+    runtime.brainIntelligence.lifecycle({
+      action: 'end',
+      sessionId: 'extract-3',
+      planOutcome: 'completed',
+    });
+
+    const result = runtime.brainIntelligence.extractKnowledge('extract-3');
+    expect(result.rulesApplied).toContain('plan_completed');
+  });
+
+  it('should extract plan abandoned anti-pattern', () => {
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'extract-4',
+      planId: 'plan-2',
+    });
+    runtime.brainIntelligence.lifecycle({
+      action: 'end',
+      sessionId: 'extract-4',
+      planOutcome: 'abandoned',
+    });
+
+    const result = runtime.brainIntelligence.extractKnowledge('extract-4');
+    expect(result.rulesApplied).toContain('plan_abandoned');
+  });
+
+  it('should throw for non-existent session', () => {
+    expect(() => {
+      runtime.brainIntelligence.extractKnowledge('non-existent');
+    }).toThrow('Session not found');
+  });
+
+  // ─── Proposals ─────────────────────────────────────────────────
+
+  it('should list proposals', () => {
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'prop-1',
+      toolsUsed: ['a', 'a', 'a'],
+    });
+    runtime.brainIntelligence.lifecycle({ action: 'end', sessionId: 'prop-1' });
+    runtime.brainIntelligence.extractKnowledge('prop-1');
+
+    const proposals = runtime.brainIntelligence.getProposals();
+    expect(proposals.length).toBeGreaterThan(0);
+    expect(proposals[0].promoted).toBe(false);
+  });
+
+  it('should filter proposals by session', () => {
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'prop-s1',
+      toolsUsed: ['x', 'x', 'x'],
+    });
+    runtime.brainIntelligence.lifecycle({ action: 'end', sessionId: 'prop-s1' });
+    runtime.brainIntelligence.extractKnowledge('prop-s1');
+
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'prop-s2',
+      toolsUsed: ['y', 'y', 'y'],
+    });
+    runtime.brainIntelligence.lifecycle({ action: 'end', sessionId: 'prop-s2' });
+    runtime.brainIntelligence.extractKnowledge('prop-s2');
+
+    const s1 = runtime.brainIntelligence.getProposals({ sessionId: 'prop-s1' });
+    const s2 = runtime.brainIntelligence.getProposals({ sessionId: 'prop-s2' });
+    expect(s1.every((p) => p.sessionId === 'prop-s1')).toBe(true);
+    expect(s2.every((p) => p.sessionId === 'prop-s2')).toBe(true);
+  });
+
+  it('should promote proposals to vault', () => {
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'promo-1',
+      toolsUsed: ['z', 'z', 'z'],
+    });
+    runtime.brainIntelligence.lifecycle({ action: 'end', sessionId: 'promo-1' });
+    runtime.brainIntelligence.extractKnowledge('promo-1');
+
+    const proposals = runtime.brainIntelligence.getProposals({ sessionId: 'promo-1' });
+    expect(proposals.length).toBeGreaterThan(0);
+
+    const result = runtime.brainIntelligence.promoteProposals([proposals[0].id]);
+    expect(result.promoted).toBe(1);
+    expect(result.failed).toEqual([]);
+
+    // Check vault has the entry
+    const entry = runtime.vault.get(`proposal-${proposals[0].id}`);
+    expect(entry).not.toBeNull();
+    expect(entry!.domain).toBe('brain-intelligence');
+  });
+
+  it('should handle promoting non-existent proposal', () => {
+    const result = runtime.brainIntelligence.promoteProposals(['non-existent']);
+    expect(result.promoted).toBe(0);
+    expect(result.failed).toContain('non-existent');
+  });
+
+  // ─── Build Intelligence ────────────────────────────────────────
+
+  it('should build intelligence pipeline', () => {
+    runtime.vault.seed([
+      {
+        id: 'bi-1',
+        type: 'pattern',
+        domain: 'd1',
+        title: 'Pattern A',
+        severity: 'warning',
+        description: 'D',
+        tags: [],
+      },
+    ]);
+    runtime.brain.recordFeedback('q', 'bi-1', 'accepted');
+
+    const result = runtime.brainIntelligence.buildIntelligence();
+    expect(result.strengthsComputed).toBe(1);
+    expect(result.globalPatterns).toBe(1);
+    expect(result.domainProfiles).toBe(1);
+  });
+
+  it('should build with empty data', () => {
+    const result = runtime.brainIntelligence.buildIntelligence();
+    expect(result.strengthsComputed).toBe(0);
+    expect(result.globalPatterns).toBe(0);
+    expect(result.domainProfiles).toBe(0);
+  });
+
+  // ─── Global Patterns ──────────────────────────────────────────
+
+  it('should return global patterns after build', () => {
+    runtime.vault.seed([
+      {
+        id: 'gp-1',
+        type: 'pattern',
+        domain: 'd1',
+        title: 'Cross Pattern',
+        severity: 'warning',
+        description: 'D',
+        tags: [],
+      },
+    ]);
+    runtime.brain.recordFeedback('q', 'gp-1', 'accepted');
+    runtime.brainIntelligence.buildIntelligence();
+
+    const patterns = runtime.brainIntelligence.getGlobalPatterns();
+    expect(patterns.length).toBe(1);
+    expect(patterns[0].pattern).toBe('Cross Pattern');
+    expect(patterns[0].domains).toContain('d1');
+  });
+
+  // ─── Domain Profiles ──────────────────────────────────────────
+
+  it('should return domain profile after build', () => {
+    runtime.vault.seed([
+      {
+        id: 'dp-1',
+        type: 'pattern',
+        domain: 'security',
+        title: 'Security Pattern',
+        severity: 'warning',
+        description: 'D',
+        tags: [],
+      },
+    ]);
+    runtime.brain.recordFeedback('q', 'dp-1', 'accepted');
+    runtime.brainIntelligence.buildIntelligence();
+
+    const profile = runtime.brainIntelligence.getDomainProfile('security');
+    expect(profile).not.toBeNull();
+    expect(profile!.domain).toBe('security');
+    expect(profile!.topPatterns.length).toBe(1);
+  });
+
+  it('should return null for unknown domain', () => {
+    const profile = runtime.brainIntelligence.getDomainProfile('nonexistent');
+    expect(profile).toBeNull();
+  });
+
+  // ─── Export / Import ──────────────────────────────────────────
+
+  it('should export all data', () => {
+    runtime.brainIntelligence.lifecycle({
+      action: 'start',
+      sessionId: 'exp-1',
+      domain: 'testing',
+    });
+    runtime.brainIntelligence.lifecycle({
+      action: 'end',
+      sessionId: 'exp-1',
+    });
+
+    const data = runtime.brainIntelligence.exportData();
+    expect(data.sessions.length).toBe(1);
+    expect(data.exportedAt).toBeDefined();
+  });
+
+  it('should import data', () => {
+    const data: BrainExportData = {
+      strengths: [
+        {
+          pattern: 'Imported Pattern',
+          domain: 'testing',
+          strength: 75,
+          usageScore: 20,
+          spreadScore: 15,
+          successScore: 20,
+          recencyScore: 20,
+          usageCount: 8,
+          uniqueContexts: 3,
+          successRate: 0.8,
+          lastUsed: new Date().toISOString(),
+        },
+      ],
+      sessions: [
+        {
+          id: 'imp-s1',
+          startedAt: new Date().toISOString(),
+          endedAt: new Date().toISOString(),
+          domain: 'testing',
+          context: 'import test',
+          toolsUsed: ['search'],
+          filesModified: [],
+          planId: null,
+          planOutcome: null,
+        },
+      ],
+      proposals: [],
+      globalPatterns: [
+        {
+          pattern: 'Imported Global',
+          domains: ['testing'],
+          totalStrength: 75,
+          avgStrength: 75,
+          domainCount: 1,
+        },
+      ],
+      domainProfiles: [
+        {
+          domain: 'testing',
+          topPatterns: [{ pattern: 'Imported', strength: 75 }],
+          sessionCount: 1,
+          avgSessionDuration: 5,
+          lastActivity: new Date().toISOString(),
+        },
+      ],
+      exportedAt: new Date().toISOString(),
+    };
+
+    const result = runtime.brainIntelligence.importData(data);
+    expect(result.imported.strengths).toBe(1);
+    expect(result.imported.sessions).toBe(1);
+    expect(result.imported.globalPatterns).toBe(1);
+    expect(result.imported.domainProfiles).toBe(1);
+
+    // Verify imported data is accessible
+    const strengths = runtime.brainIntelligence.getStrengths();
+    expect(strengths.length).toBe(1);
+    expect(strengths[0].pattern).toBe('Imported Pattern');
+  });
+
+  it('should handle duplicate session import gracefully', () => {
+    runtime.brainIntelligence.lifecycle({ action: 'start', sessionId: 'dup-1' });
+
+    const data: BrainExportData = {
+      strengths: [],
+      sessions: [
+        {
+          id: 'dup-1',
+          startedAt: new Date().toISOString(),
+          endedAt: null,
+          domain: null,
+          context: null,
+          toolsUsed: [],
+          filesModified: [],
+          planId: null,
+          planOutcome: null,
+        },
+      ],
+      proposals: [],
+      globalPatterns: [],
+      domainProfiles: [],
+      exportedAt: new Date().toISOString(),
+    };
+
+    const result = runtime.brainIntelligence.importData(data);
+    expect(result.imported.sessions).toBe(0); // Duplicate ignored
+  });
+});