@timmeck/brain-core 2.6.0 → 2.8.0

package/dist/research/adapters/trading-adapter.js

@@ -0,0 +1,165 @@
+/**
+ * DataMiner adapter for Trading Brain.
+ * Mines: trades (win/loss, profit, regime, pair), rules (confidence, win-rate),
+ *        chains (streak patterns), calibration.
+ */
+export class TradingDataMinerAdapter {
+    name = 'trading-brain';
+    mineObservations(db, since) {
+        const observations = [];
+        // Trade outcomes by pair
+        const trades = safeAll(db, `SELECT pair, COUNT(*) as cnt, SUM(CASE WHEN win = 1 THEN 1 ELSE 0 END) as wins,
+              SUM(COALESCE(profit, 0)) as total_profit
+       FROM trades WHERE created_at > ? GROUP BY pair`, [isoFromTs(since)]);
+        for (const t of trades) {
+            observations.push({
+                category: 'tool_usage',
+                event_type: 'trade:pair_stats',
+                metrics: { pair: t.pair, count: t.cnt, wins: t.wins, win_rate: t.cnt > 0 ? t.wins / t.cnt : 0, total_profit: t.total_profit },
+            });
+        }
+        // Trade outcomes by regime
+        const regimes = safeAll(db, `SELECT COALESCE(regime, 'unknown') as regime, COUNT(*) as cnt,
+              SUM(CASE WHEN win = 1 THEN 1 ELSE 0 END) as wins
+       FROM trades WHERE created_at > ? GROUP BY regime`, [isoFromTs(since)]);
+        for (const r of regimes) {
+            observations.push({
+                category: 'tool_usage',
+                event_type: 'trade:regime_stats',
+                metrics: { regime: r.regime, count: r.cnt, wins: r.wins, win_rate: r.cnt > 0 ? r.wins / r.cnt : 0 },
+            });
+        }
+        // Rule confidence distribution
+        const rules = safeAll(db, `SELECT id, pattern, confidence, COALESCE(win_rate, 0) as win_rate FROM rules WHERE updated_at > ?`, [isoFromTs(since)]);
+        for (const r of rules) {
+            observations.push({
+                category: 'query_quality',
+                event_type: 'rule:confidence',
+                metrics: { rule_id: r.id, pattern: r.pattern, confidence: r.confidence, win_rate: r.win_rate },
+            });
+        }
+        // Chain/streak patterns
+        const chains = safeAll(db, `SELECT pair, type, length FROM chains WHERE created_at > ?`, [isoFromTs(since)]);
+        for (const c of chains) {
+            observations.push({
+                category: 'tool_usage',
+                event_type: 'chain:streak',
+                metrics: { pair: c.pair, type: c.type, length: c.length },
+            });
+        }
+        return observations;
+    }
+    mineCausalEvents(db, since) {
+        const events = [];
+        // Individual trades as causal events
+        const trades = safeAll(db, `SELECT id, pair, win, COALESCE(profit, 0) as profit, COALESCE(regime, 'unknown') as regime, fingerprint
+       FROM trades WHERE created_at > ? ORDER BY created_at LIMIT 500`, [isoFromTs(since)]);
+        for (const t of trades) {
+            events.push({
+                source: 'trading-brain',
+                type: t.win ? 'trade:win' : 'trade:loss',
+                data: { tradeId: t.id, pair: t.pair, profit: t.profit, regime: t.regime, fingerprint: t.fingerprint },
+            });
+        }
+        // Rule learning events
+        const rules = safeAll(db, `SELECT id, pattern, confidence FROM rules WHERE created_at > ?`, [isoFromTs(since)]);
+        for (const r of rules) {
+            events.push({
+                source: 'trading-brain',
+                type: 'rule:learned',
+                data: { ruleId: r.id, pattern: r.pattern, confidence: r.confidence },
+            });
+        }
+        return events;
+    }
+    mineMetrics(db, since) {
+        const metrics = [];
+        // Overall win rate
+        const winRate = safeGet(db, `SELECT COUNT(*) as total, SUM(CASE WHEN win = 1 THEN 1 ELSE 0 END) as wins FROM trades WHERE created_at > ?`, [isoFromTs(since)]);
+        if (winRate && winRate.total > 0) {
+            metrics.push({ name: 'win_rate', value: winRate.wins / winRate.total });
+            metrics.push({ name: 'trade_count', value: winRate.total });
+        }
+        // Average profit per trade
+        const profit = safeGet(db, `SELECT AVG(COALESCE(profit, 0)) as avg_profit FROM trades WHERE created_at > ?`, [isoFromTs(since)]);
+        if (profit?.avg_profit != null) {
+            metrics.push({ name: 'avg_profit', value: profit.avg_profit });
+        }
+        // Average rule confidence
+        const ruleConf = safeGet(db, `SELECT AVG(confidence) as avg_confidence FROM rules WHERE confidence IS NOT NULL AND updated_at > ?`, [isoFromTs(since)]);
+        if (ruleConf?.avg_confidence != null) {
+            metrics.push({ name: 'avg_rule_confidence', value: ruleConf.avg_confidence });
+        }
+        // Max streak length
+        const maxStreak = safeGet(db, `SELECT MAX(length) as max_length FROM chains WHERE created_at > ?`, [isoFromTs(since)]);
+        if (maxStreak?.max_length != null) {
+            metrics.push({ name: 'max_streak_length', value: maxStreak.max_length });
+        }
+        // Calibration score
+        const calibration = safeGet(db, `SELECT overall_accuracy FROM calibration ORDER BY updated_at DESC LIMIT 1`, []);
+        if (calibration?.overall_accuracy != null) {
+            metrics.push({ name: 'calibration_accuracy', value: calibration.overall_accuracy });
+        }
+        return metrics;
+    }
+    mineHypothesisObservations(db, since) {
+        const observations = [];
+        // Trade wins/losses per pair
+        const trades = safeAll(db, `SELECT pair, win, COUNT(*) as cnt FROM trades WHERE created_at > ? GROUP BY pair, win`, [isoFromTs(since)]);
+        for (const t of trades) {
+            observations.push({
+                source: 'trading-brain',
+                type: t.win ? 'trade:win' : 'trade:loss',
+                value: t.cnt,
+                metadata: { pair: t.pair },
+            });
+        }
+        // Chain detections
+        const chains = safeAll(db, `SELECT pair, type, length FROM chains WHERE created_at > ?`, [isoFromTs(since)]);
+        for (const c of chains) {
+            observations.push({
+                source: 'trading-brain',
+                type: 'chain:detected',
+                value: c.length,
+                metadata: { pair: c.pair, streakType: c.type },
+            });
+        }
+        return observations;
+    }
+    mineCrossDomainEvents(db, since) {
+        const events = [];
+        // Trade batch summary for cross-domain
+        const summary = safeGet(db, `SELECT COUNT(*) as total, SUM(CASE WHEN win = 1 THEN 1 ELSE 0 END) as wins,
+              SUM(COALESCE(profit, 0)) as total_profit
+       FROM trades WHERE created_at > ?`, [isoFromTs(since)]);
+        if (summary && summary.total > 0) {
+            events.push({
+                brain: 'trading-brain',
+                eventType: 'trade:batch',
+                data: { count: summary.total, wins: summary.wins, win_rate: summary.wins / summary.total, total_profit: summary.total_profit },
+            });
+        }
+        return events;
+    }
+}
+// ── Helpers ─────────────────────────────────────────────
+function isoFromTs(ts) {
+    return ts > 0 ? new Date(ts).toISOString() : '1970-01-01T00:00:00.000Z';
+}
+function safeAll(db, sql, params) {
+    try {
+        return db.prepare(sql).all(...params);
+    }
+    catch {
+        return [];
+    }
+}
+function safeGet(db, sql, params) {
+    try {
+        return db.prepare(sql).get(...params);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=trading-adapter.js.map

package/dist/research/adapters/trading-adapter.js.map

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

package/dist/research/data-miner.d.ts

@@ -0,0 +1,84 @@
+import type Database from 'better-sqlite3';
+import type { SelfObserver } from './self-observer.js';
+import type { AnomalyDetective } from './anomaly-detective.js';
+import type { CrossDomainEngine } from './cross-domain-engine.js';
+import type { CausalGraph } from '../causal/engine.js';
+import type { HypothesisEngine } from '../hypothesis/engine.js';
+export interface MinedObservation {
+    category: 'tool_usage' | 'query_quality' | 'resolution_rate' | 'latency' | 'cross_brain';
+    event_type: string;
+    metrics: Record<string, unknown>;
+}
+export interface MinedCausalEvent {
+    source: string;
+    type: string;
+    data?: unknown;
+}
+export interface MinedMetric {
+    name: string;
+    value: number;
+}
+export interface MinedHypothesisObservation {
+    source: string;
+    type: string;
+    value: number;
+    metadata?: Record<string, unknown>;
+}
+export interface MinedCrossDomainEvent {
+    brain: string;
+    eventType: string;
+    data?: Record<string, unknown>;
+}
+export interface MineResult {
+    observations: MinedObservation[];
+    causalEvents: MinedCausalEvent[];
+    metrics: MinedMetric[];
+    hypothesisObservations: MinedHypothesisObservation[];
+    crossDomainEvents: MinedCrossDomainEvent[];
+}
+export interface DataMinerAdapter {
+    /** Human-readable name for logging. */
+    readonly name: string;
+    /** Mine observations for SelfObserver from domain tables. */
+    mineObservations(db: Database.Database, since: number): MinedObservation[];
+    /** Mine causal events for CausalGraph from domain tables. */
+    mineCausalEvents(db: Database.Database, since: number): MinedCausalEvent[];
+    /** Mine metric values for AnomalyDetective from domain tables. */
+    mineMetrics(db: Database.Database, since: number): MinedMetric[];
+    /** Mine observations for HypothesisEngine from domain tables. */
+    mineHypothesisObservations(db: Database.Database, since: number): MinedHypothesisObservation[];
+    /** Mine cross-domain events for CrossDomainEngine from domain tables. */
+    mineCrossDomainEvents(db: Database.Database, since: number): MinedCrossDomainEvent[];
+}
+export interface DataMinerEngines {
+    selfObserver: SelfObserver;
+    anomalyDetective: AnomalyDetective;
+    crossDomain: CrossDomainEngine;
+    causalGraph?: CausalGraph;
+    hypothesisEngine?: HypothesisEngine;
+}
+export interface DataMinerState {
+    last_mined_at: number;
+    bootstrap_complete: boolean;
+    total_observations_mined: number;
+    total_causal_events_mined: number;
+    total_metrics_mined: number;
+}
+export declare function runDataMinerMigration(db: Database.Database): void;
+export declare class DataMiner {
+    private db;
+    private adapter;
+    private engines;
+    private log;
+    private state;
+    constructor(db: Database.Database, adapter: DataMinerAdapter, engines: DataMinerEngines);
+    /** Bootstrap: scan ALL historical data and feed into engines. Only runs once. */
+    bootstrap(): void;
+    /** Incremental mine: fetch new data since last run and feed into engines. */
+    mine(): void;
+    /** Get current miner state. */
+    getState(): DataMinerState;
+    private mineFrom;
+    private loadState;
+    private saveState;
+}

package/dist/research/data-miner.js

@@ -0,0 +1,174 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runDataMinerMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS data_miner_state (
+      id INTEGER PRIMARY KEY CHECK (id = 1),
+      last_mined_at INTEGER NOT NULL DEFAULT 0,
+      bootstrap_complete INTEGER NOT NULL DEFAULT 0,
+      total_observations_mined INTEGER NOT NULL DEFAULT 0,
+      total_causal_events_mined INTEGER NOT NULL DEFAULT 0,
+      total_metrics_mined INTEGER NOT NULL DEFAULT 0,
+      updated_at TEXT DEFAULT (datetime('now'))
+    );
+    INSERT OR IGNORE INTO data_miner_state (id) VALUES (1);
+  `);
+}
+// ── DataMiner ───────────────────────────────────────────
+export class DataMiner {
+    db;
+    adapter;
+    engines;
+    log = getLogger();
+    state;
+    constructor(db, adapter, engines) {
+        this.db = db;
+        this.adapter = adapter;
+        this.engines = engines;
+        runDataMinerMigration(db);
+        this.state = this.loadState();
+    }
+    /** Bootstrap: scan ALL historical data and feed into engines. Only runs once. */
+    bootstrap() {
+        if (this.state.bootstrap_complete) {
+            this.log.info(`[data-miner] Bootstrap already complete for ${this.adapter.name}`);
+            return;
+        }
+        this.log.info(`[data-miner] Bootstrapping ${this.adapter.name} — scanning all historical data...`);
+        const start = Date.now();
+        // Mine everything from epoch
+        const result = this.mineFrom(0);
+        this.state.bootstrap_complete = true;
+        this.state.last_mined_at = Date.now();
+        this.saveState();
+        const duration = Date.now() - start;
+        this.log.info(`[data-miner] Bootstrap complete for ${this.adapter.name} in ${duration}ms — ` +
+            `${result.observations} observations, ${result.causalEvents} causal events, ` +
+            `${result.metrics} metrics, ${result.hypothesisObs} hypothesis observations, ` +
+            `${result.crossDomain} cross-domain events`);
+    }
+    /** Incremental mine: fetch new data since last run and feed into engines. */
+    mine() {
+        const since = this.state.last_mined_at;
+        const now = Date.now();
+        const result = this.mineFrom(since);
+        this.state.last_mined_at = now;
+        this.saveState();
+        if (result.total > 0) {
+            this.log.info(`[data-miner] Mined ${result.total} items from ${this.adapter.name} ` +
+                `(obs: ${result.observations}, causal: ${result.causalEvents}, ` +
+                `metrics: ${result.metrics}, hypo: ${result.hypothesisObs}, cross: ${result.crossDomain})`);
+        }
+    }
+    /** Get current miner state. */
+    getState() {
+        return { ...this.state };
+    }
+    // ── Internal ─────────────────────────────────────────
+    mineFrom(since) {
+        let observations = 0;
+        let causalEvents = 0;
+        let metrics = 0;
+        let hypothesisObs = 0;
+        let crossDomain = 0;
+        // 1. Mine observations → SelfObserver
+        try {
+            const obs = this.adapter.mineObservations(this.db, since);
+            for (const o of obs) {
+                this.engines.selfObserver.record({
+                    category: o.category,
+                    event_type: o.event_type,
+                    metrics: o.metrics,
+                });
+            }
+            observations = obs.length;
+            this.state.total_observations_mined += observations;
+        }
+        catch (err) {
+            this.log.error(`[data-miner] Error mining observations: ${err.message}`);
+        }
+        // 2. Mine causal events → CausalGraph
+        try {
+            const events = this.adapter.mineCausalEvents(this.db, since);
+            if (this.engines.causalGraph) {
+                for (const e of events) {
+                    this.engines.causalGraph.recordEvent(e.source, e.type, e.data);
+                }
+            }
+            causalEvents = events.length;
+            this.state.total_causal_events_mined += causalEvents;
+        }
+        catch (err) {
+            this.log.error(`[data-miner] Error mining causal events: ${err.message}`);
+        }
+        // 3. Mine metrics → AnomalyDetective
+        try {
+            const m = this.adapter.mineMetrics(this.db, since);
+            for (const metric of m) {
+                this.engines.anomalyDetective.recordMetric(metric.name, metric.value);
+            }
+            metrics = m.length;
+        }
+        catch (err) {
+            this.log.error(`[data-miner] Error mining metrics: ${err.message}`);
+        }
+        // 4. Mine hypothesis observations → HypothesisEngine
+        try {
+            const hypo = this.adapter.mineHypothesisObservations(this.db, since);
+            if (this.engines.hypothesisEngine) {
+                for (const h of hypo) {
+                    this.engines.hypothesisEngine.observe({
+                        source: h.source,
+                        type: h.type,
+                        value: h.value,
+                        timestamp: Date.now(),
+                        metadata: h.metadata,
+                    });
+                }
+            }
+            hypothesisObs = hypo.length;
+        }
+        catch (err) {
+            this.log.error(`[data-miner] Error mining hypothesis observations: ${err.message}`);
+        }
+        // 5. Mine cross-domain events → CrossDomainEngine
+        try {
+            const cd = this.adapter.mineCrossDomainEvents(this.db, since);
+            for (const c of cd) {
+                this.engines.crossDomain.recordEvent(c.brain, c.eventType, c.data);
+            }
+            crossDomain = cd.length;
+        }
+        catch (err) {
+            this.log.error(`[data-miner] Error mining cross-domain events: ${err.message}`);
+        }
+        const total = observations + causalEvents + metrics + hypothesisObs + crossDomain;
+        return { observations, causalEvents, metrics, hypothesisObs, crossDomain, total };
+    }
+    loadState() {
+        const row = this.db.prepare('SELECT * FROM data_miner_state WHERE id = 1').get();
+        if (!row) {
+            return { last_mined_at: 0, bootstrap_complete: false, total_observations_mined: 0, total_causal_events_mined: 0, total_metrics_mined: 0 };
+        }
+        return {
+            last_mined_at: row.last_mined_at,
+            bootstrap_complete: row.bootstrap_complete === 1,
+            total_observations_mined: row.total_observations_mined,
+            total_causal_events_mined: row.total_causal_events_mined,
+            total_metrics_mined: row.total_metrics_mined,
+        };
+    }
+    saveState() {
+        this.db.prepare(`
+      UPDATE data_miner_state SET
+        last_mined_at = ?,
+        bootstrap_complete = ?,
+        total_observations_mined = ?,
+        total_causal_events_mined = ?,
+        total_metrics_mined = ?,
+        updated_at = datetime('now')
+      WHERE id = 1
+    `).run(this.state.last_mined_at, this.state.bootstrap_complete ? 1 : 0, this.state.total_observations_mined, this.state.total_causal_events_mined, this.state.total_metrics_mined);
+    }
+}
+//# sourceMappingURL=data-miner.js.map

package/dist/research/data-miner.js.map

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

package/dist/research/research-orchestrator.d.ts

@@ -0,0 +1,72 @@
+import type Database from 'better-sqlite3';
+import { SelfObserver } from './self-observer.js';
+import { AdaptiveStrategyEngine } from './adaptive-strategy.js';
+import { ExperimentEngine } from './experiment-engine.js';
+import { CrossDomainEngine } from './cross-domain-engine.js';
+import { CounterfactualEngine } from './counterfactual-engine.js';
+import { KnowledgeDistiller } from './knowledge-distiller.js';
+import { ResearchAgendaEngine } from './agenda-engine.js';
+import { AnomalyDetective } from './anomaly-detective.js';
+import { ResearchJournal } from './journal.js';
+import type { CausalGraph } from '../causal/engine.js';
+import type { ResearchCycleReport } from './autonomous-scheduler.js';
+import type { DataMiner } from './data-miner.js';
+export interface ResearchOrchestratorConfig {
+    brainName: string;
+    /** Feedback loop interval in ms. Default: 300_000 (5 min) */
+    feedbackIntervalMs?: number;
+    /** Knowledge distillation every N cycles. Default: 5 */
+    distillEvery?: number;
+    /** Research agenda regeneration every N cycles. Default: 3 */
+    agendaEvery?: number;
+    /** Journal reflection every N cycles. Default: 10 */
+    reflectEvery?: number;
+}
+export declare class ResearchOrchestrator {
+    readonly selfObserver: SelfObserver;
+    readonly adaptiveStrategy: AdaptiveStrategyEngine;
+    readonly experimentEngine: ExperimentEngine;
+    readonly crossDomain: CrossDomainEngine;
+    readonly counterfactual: CounterfactualEngine;
+    readonly knowledgeDistiller: KnowledgeDistiller;
+    readonly researchAgenda: ResearchAgendaEngine;
+    readonly anomalyDetective: AnomalyDetective;
+    readonly journal: ResearchJournal;
+    private dataMiner;
+    private brainName;
+    private feedbackTimer;
+    private cycleCount;
+    private distillEvery;
+    private agendaEvery;
+    private reflectEvery;
+    private log;
+    constructor(db: Database.Database, config: ResearchOrchestratorConfig, causalGraph?: CausalGraph);
+    /** Set the DataMiner instance for DB-driven engine feeding. */
+    setDataMiner(miner: DataMiner): void;
+    /** Start the autonomous feedback loop timer. */
+    start(intervalMs?: number): void;
+    /** Stop the feedback loop. */
+    stop(): void;
+    /**
+     * Feed a domain event from the brain's EventBus.
+     * Routes to: SelfObserver, AnomalyDetective, CrossDomain.
+     */
+    onEvent(eventType: string, data?: Record<string, unknown>): void;
+    /**
+     * Feed a cross-brain event from CrossBrainSubscription.
+     * Routes to: CrossDomainEngine, AnomalyDetective.
+     */
+    onCrossBrainEvent(sourceBrain: string, eventType: string, data?: Record<string, unknown>): void;
+    /**
+     * Hook into AutonomousResearchScheduler cycle completion.
+     * Records discoveries in journal and feeds metrics to anomaly detection.
+     */
+    onResearchCycleComplete(report: ResearchCycleReport): void;
+    /**
+     * Run one autonomous feedback cycle.
+     * This is where the engines talk to each other.
+     */
+    runFeedbackCycle(): void;
+    /** Get a comprehensive research summary for dashboards/API. */
+    getSummary(): Record<string, unknown>;
+}