@timmeck/brain-core 2.5.0 → 2.6.0

package/dist/research/cross-domain-engine.js

@@ -0,0 +1,283 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runCrossDomainMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS cross_domain_events (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      brain TEXT NOT NULL,
+      event_type TEXT NOT NULL,
+      timestamp INTEGER NOT NULL,
+      data TEXT,
+      created_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_xd_events_brain ON cross_domain_events(brain);
+    CREATE INDEX IF NOT EXISTS idx_xd_events_ts ON cross_domain_events(timestamp);
+
+    CREATE TABLE IF NOT EXISTS cross_domain_correlations (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      timestamp INTEGER NOT NULL,
+      source_brain TEXT NOT NULL,
+      source_event TEXT NOT NULL,
+      target_brain TEXT NOT NULL,
+      target_event TEXT NOT NULL,
+      correlation REAL NOT NULL,
+      lag_seconds INTEGER NOT NULL,
+      p_value REAL NOT NULL,
+      effect_size REAL NOT NULL,
+      direction TEXT NOT NULL,
+      narrative TEXT NOT NULL,
+      sample_size INTEGER NOT NULL,
+      confirmed INTEGER DEFAULT 0,
+      created_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_xd_corr_brains ON cross_domain_correlations(source_brain, target_brain);
+  `);
+}
+// ── Engine ──────────────────────────────────────────────
+export class CrossDomainEngine {
+    db;
+    config;
+    log = getLogger();
+    constructor(db, config) {
+        this.db = db;
+        this.config = {
+            windowMs: config?.windowMs ?? 7_200_000,
+            minCorrelation: config?.minCorrelation ?? 0.3,
+            alpha: config?.alpha ?? 0.05,
+            maxEvents: config?.maxEvents ?? 10_000,
+        };
+        runCrossDomainMigration(db);
+    }
+    /** Record an event from a brain. */
+    recordEvent(brain, eventType, data) {
+        this.db.prepare(`
+      INSERT INTO cross_domain_events (brain, event_type, timestamp, data)
+      VALUES (?, ?, ?, ?)
+    `).run(brain, eventType, Date.now(), data ? JSON.stringify(data) : null);
+        // Cleanup old events
+        const count = this.db.prepare(`SELECT COUNT(*) as c FROM cross_domain_events`).get().c;
+        if (count > this.config.maxEvents) {
+            this.db.prepare(`
+        DELETE FROM cross_domain_events WHERE id IN (
+          SELECT id FROM cross_domain_events ORDER BY timestamp ASC LIMIT ?
+        )
+      `).run(count - this.config.maxEvents);
+        }
+    }
+    /** Run cross-domain correlation analysis. */
+    analyze() {
+        const brains = this.db.prepare(`
+      SELECT DISTINCT brain FROM cross_domain_events
+    `).all();
+        if (brains.length < 2)
+            return [];
+        const cutoff = Date.now() - this.config.windowMs * 10; // Analyze 10 windows of data
+        const discoveries = [];
+        // Get all event types per brain
+        const brainEvents = new Map();
+        for (const { brain } of brains) {
+            const types = this.db.prepare(`
+        SELECT DISTINCT event_type FROM cross_domain_events
+        WHERE brain = ? AND timestamp > ?
+      `).all(brain, cutoff);
+            brainEvents.set(brain, types.map(t => t.event_type));
+        }
+        // Cross-correlate every pair from different brains
+        const brainList = [...brainEvents.keys()];
+        for (let i = 0; i < brainList.length; i++) {
+            for (let j = i + 1; j < brainList.length; j++) {
+                const brainA = brainList[i];
+                const brainB = brainList[j];
+                const typesA = brainEvents.get(brainA) ?? [];
+                const typesB = brainEvents.get(brainB) ?? [];
+                for (const typeA of typesA) {
+                    for (const typeB of typesB) {
+                        const corr = this.computeCorrelation(brainA, typeA, brainB, typeB, cutoff);
+                        if (corr && Math.abs(corr.correlation) >= this.config.minCorrelation && corr.p_value < this.config.alpha) {
+                            discoveries.push(corr);
+                        }
+                    }
+                }
+            }
+        }
+        // Persist new discoveries
+        for (const d of discoveries) {
+            this.persistCorrelation(d);
+        }
+        return discoveries;
+    }
+    /** Get all found correlations. */
+    getCorrelations(limit = 20) {
+        return this.db.prepare(`
+      SELECT * FROM cross_domain_correlations
+      ORDER BY ABS(correlation) DESC LIMIT ?
+    `).all(limit).map(r => this.rowToCorrelation(r));
+    }
+    /** Generate a narrative summary of the most important cross-domain findings. */
+    getNarrative() {
+        const correlations = this.getCorrelations(10);
+        if (correlations.length === 0)
+            return 'No cross-domain correlations discovered yet.';
+        const lines = ['Cross-Domain Research Narrative:\n'];
+        for (const c of correlations) {
+            lines.push(`- ${c.narrative}`);
+            lines.push(`  (r=${c.correlation.toFixed(2)}, p=${c.p_value.toFixed(3)}, d=${c.effect_size.toFixed(2)}, lag=${c.lag_seconds}s, n=${c.sample_size})`);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    computeCorrelation(brainA, typeA, brainB, typeB, since) {
+        // Get event timestamps for both
+        const eventsA = this.db.prepare(`
+      SELECT timestamp FROM cross_domain_events
+      WHERE brain = ? AND event_type = ? AND timestamp > ?
+      ORDER BY timestamp
+    `).all(brainA, typeA, since);
+        const eventsB = this.db.prepare(`
+      SELECT timestamp FROM cross_domain_events
+      WHERE brain = ? AND event_type = ? AND timestamp > ?
+      ORDER BY timestamp
+    `).all(brainB, typeB, since);
+        if (eventsA.length < 3 || eventsB.length < 3)
+            return null;
+        // Compute temporal cross-correlation with varying lag
+        // Bin events into time windows
+        const binSize = this.config.windowMs;
+        const minTs = Math.min(eventsA[0].timestamp, eventsB[0].timestamp);
+        const maxTs = Math.max(eventsA[eventsA.length - 1].timestamp, eventsB[eventsB.length - 1].timestamp);
+        const numBins = Math.ceil((maxTs - minTs) / binSize);
+        if (numBins < 3)
+            return null;
+        const binsA = new Array(numBins).fill(0);
+        const binsB = new Array(numBins).fill(0);
+        for (const e of eventsA) {
+            const bin = Math.min(numBins - 1, Math.floor((e.timestamp - minTs) / binSize));
+            binsA[bin]++;
+        }
+        for (const e of eventsB) {
+            const bin = Math.min(numBins - 1, Math.floor((e.timestamp - minTs) / binSize));
+            binsB[bin]++;
+        }
+        // Pearson correlation at different lags (-2 to +2 bins)
+        let bestCorr = 0;
+        let bestLag = 0;
+        for (let lag = -2; lag <= 2; lag++) {
+            const r = pearsonCorrelation(binsA, binsB, lag);
+            if (Math.abs(r) > Math.abs(bestCorr)) {
+                bestCorr = r;
+                bestLag = lag;
+            }
+        }
+        if (Math.abs(bestCorr) < this.config.minCorrelation)
+            return null;
+        // Approximate p-value for Pearson correlation
+        const n = Math.min(binsA.length, binsB.length) - Math.abs(bestLag);
+        const t = bestCorr * Math.sqrt((n - 2) / (1 - bestCorr * bestCorr));
+        const pValue = n > 2 ? approxPValue(Math.abs(t), n - 2) : 1;
+        const narrative = this.generateNarrative(brainA, typeA, brainB, typeB, bestCorr, bestLag * binSize / 1000);
+        return {
+            timestamp: Date.now(),
+            source_brain: brainA,
+            source_event: typeA,
+            target_brain: brainB,
+            target_event: typeB,
+            correlation: bestCorr,
+            lag_seconds: Math.round(bestLag * binSize / 1000),
+            p_value: pValue,
+            effect_size: Math.abs(bestCorr), // r as effect size
+            direction: bestCorr > 0 ? 'positive' : 'negative',
+            narrative,
+            sample_size: eventsA.length + eventsB.length,
+            confirmed: false,
+        };
+    }
+    generateNarrative(brainA, typeA, brainB, typeB, correlation, lagSeconds) {
+        const direction = correlation > 0 ? 'increases' : 'decreases';
+        const strength = Math.abs(correlation) > 0.7 ? 'strongly' : Math.abs(correlation) > 0.5 ? 'moderately' : 'weakly';
+        const lagStr = lagSeconds === 0 ? 'simultaneously' :
+            lagSeconds > 0 ? `${lagSeconds}s later` : `${Math.abs(lagSeconds)}s before`;
+        return `When ${brainA} reports "${typeA}", ${brainB}'s "${typeB}" ${strength} ${direction} (${lagStr}).`;
+    }
+    persistCorrelation(corr) {
+        // Upsert: update if same pair exists
+        const existing = this.db.prepare(`
+      SELECT id FROM cross_domain_correlations
+      WHERE source_brain = ? AND source_event = ? AND target_brain = ? AND target_event = ?
+    `).get(corr.source_brain, corr.source_event, corr.target_brain, corr.target_event);
+        if (existing) {
+            this.db.prepare(`
+        UPDATE cross_domain_correlations
+        SET correlation = ?, lag_seconds = ?, p_value = ?, effect_size = ?,
+            direction = ?, narrative = ?, sample_size = ?, timestamp = ?
+        WHERE source_brain = ? AND source_event = ? AND target_brain = ? AND target_event = ?
+      `).run(corr.correlation, corr.lag_seconds, corr.p_value, corr.effect_size, corr.direction, corr.narrative, corr.sample_size, corr.timestamp, corr.source_brain, corr.source_event, corr.target_brain, corr.target_event);
+        }
+        else {
+            this.db.prepare(`
+        INSERT INTO cross_domain_correlations
+        (timestamp, source_brain, source_event, target_brain, target_event,
+         correlation, lag_seconds, p_value, effect_size, direction, narrative, sample_size)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(corr.timestamp, corr.source_brain, corr.source_event, corr.target_brain, corr.target_event, corr.correlation, corr.lag_seconds, corr.p_value, corr.effect_size, corr.direction, corr.narrative, corr.sample_size);
+        }
+    }
+    rowToCorrelation(row) {
+        return {
+            id: row.id,
+            timestamp: row.timestamp,
+            source_brain: row.source_brain,
+            source_event: row.source_event,
+            target_brain: row.target_brain,
+            target_event: row.target_event,
+            correlation: row.correlation,
+            lag_seconds: row.lag_seconds,
+            p_value: row.p_value,
+            effect_size: row.effect_size,
+            direction: row.direction,
+            narrative: row.narrative,
+            sample_size: row.sample_size,
+            confirmed: row.confirmed === 1,
+        };
+    }
+}
+// ── Helper Functions ────────────────────────────────────
+function pearsonCorrelation(a, b, lag = 0) {
+    const n = Math.min(a.length, b.length) - Math.abs(lag);
+    if (n < 3)
+        return 0;
+    let sumA = 0, sumB = 0;
+    const offsetA = lag > 0 ? lag : 0;
+    const offsetB = lag < 0 ? -lag : 0;
+    for (let i = 0; i < n; i++) {
+        sumA += a[i + offsetA];
+        sumB += b[i + offsetB];
+    }
+    const meanA = sumA / n;
+    const meanB = sumB / n;
+    let cov = 0, varA = 0, varB = 0;
+    for (let i = 0; i < n; i++) {
+        const dA = a[i + offsetA] - meanA;
+        const dB = b[i + offsetB] - meanB;
+        cov += dA * dB;
+        varA += dA * dA;
+        varB += dB * dB;
+    }
+    const denom = Math.sqrt(varA * varB);
+    return denom === 0 ? 0 : cov / denom;
+}
+function approxPValue(t, df) {
+    if (df <= 0)
+        return 1;
+    // Normal approximation for large df
+    const z = t * (1 - 1 / (4 * df)) / Math.sqrt(1 + t * t / (2 * df));
+    return 2 * (1 - normalCDF(z));
+}
+function normalCDF(x) {
+    const a1 = 0.254829592, a2 = -0.284496736, a3 = 1.421413741, a4 = -1.453152027, a5 = 1.061405429;
+    const p = 0.3275911;
+    const sign = x < 0 ? -1 : 1;
+    const t = 1.0 / (1.0 + p * Math.abs(x));
+    const y = 1.0 - ((((a5 * t + a4) * t + a3) * t + a2) * t + a1) * t * Math.exp(-x * x / 2);
+    return 0.5 * (1.0 + sign * y);
+}
+//# sourceMappingURL=cross-domain-engine.js.map

package/dist/research/cross-domain-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-domain-engine.js","sourceRoot":"","sources":["../../src/research/cross-domain-engine.ts"],"names":[],"mappings":"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"}

package/dist/research/experiment-engine.d.ts

@@ -0,0 +1,77 @@
+import type Database from 'better-sqlite3';
+export type ExperimentStatus = 'planned' | 'running_control' | 'running_treatment' | 'analyzing' | 'complete' | 'aborted';
+export interface Experiment {
+    id?: number;
+    name: string;
+    hypothesis: string;
+    independent_variable: string;
+    dependent_variable: string;
+    control_value: number;
+    treatment_value: number;
+    duration_cycles: number;
+    status: ExperimentStatus;
+    control_results: number[];
+    treatment_results: number[];
+    current_cycle: number;
+    conclusion: ExperimentConclusion | null;
+    created_at?: string;
+    completed_at?: string;
+}
+export interface ExperimentConclusion {
+    significant: boolean;
+    p_value: number;
+    effect_size: number;
+    direction: 'positive' | 'negative' | 'neutral';
+    recommendation: 'adopt_treatment' | 'keep_control' | 'inconclusive_extend';
+    control_mean: number;
+    treatment_mean: number;
+    control_std: number;
+    treatment_std: number;
+}
+export interface ExperimentProposal {
+    name: string;
+    hypothesis: string;
+    independent_variable: string;
+    dependent_variable: string;
+    control_value: number;
+    treatment_value: number;
+    duration_cycles?: number;
+}
+export interface ExperimentEngineConfig {
+    brainName: string;
+    /** Default experiment duration in cycles. Default: 10 */
+    defaultDuration?: number;
+    /** Significance level for hypothesis testing. Default: 0.05 */
+    alpha?: number;
+    /** Maximum concurrent experiments. Default: 3 */
+    maxConcurrent?: number;
+}
+export declare function runExperimentMigration(db: Database.Database): void;
+export declare class ExperimentEngine {
+    private db;
+    private config;
+    private log;
+    constructor(db: Database.Database, config: ExperimentEngineConfig);
+    /** Propose a new experiment. */
+    propose(proposal: ExperimentProposal): Experiment;
+    /** Start an experiment (transitions from planned to running_control). */
+    start(experimentId: number): Experiment | null;
+    /** Record a measurement for the current phase of an experiment. */
+    recordMeasurement(experimentId: number, value: number): Experiment | null;
+    /** Analyze a completed experiment. */
+    analyze(experimentId: number): Experiment | null;
+    /** Abort a running experiment. */
+    abort(experimentId: number): boolean;
+    /** Get a single experiment by ID. */
+    get(id: number): Experiment | null;
+    /** List experiments by status. */
+    list(status?: ExperimentStatus, limit?: number): Experiment[];
+    /** Get currently running experiments. */
+    getRunning(): Experiment[];
+    /** Get results of completed experiments. */
+    getResults(limit?: number): Experiment[];
+    /** Calculate minimum required sample size for a desired effect size. */
+    getMinimumSampleSize(expectedEffectSize: number): number;
+    private completeExperiment;
+    private rowToExperiment;
+}