@timmeck/brain-core 2.26.0 → 2.28.0

package/dist/metacognition/simulation-engine.js

@@ -0,0 +1,267 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runSimulationMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS simulations (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      scenario TEXT NOT NULL,
+      parameters TEXT NOT NULL DEFAULT '{}',
+      predicted_outcomes TEXT NOT NULL DEFAULT '[]',
+      actual_outcomes TEXT DEFAULT NULL,
+      accuracy REAL DEFAULT NULL,
+      simulated_at TEXT DEFAULT (datetime('now')),
+      validated_at TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_simulations_accuracy ON simulations(accuracy);
+  `);
+}
+// ── SimulationEngine ───────────────────────────────────
+export class SimulationEngine {
+    db;
+    thoughtStream = null;
+    predictionEngine = null;
+    causalGraph = null;
+    metaCognition = null;
+    log = getLogger();
+    constructor(db) {
+        this.db = db;
+        runSimulationMigration(db);
+    }
+    setThoughtStream(stream) {
+        this.thoughtStream = stream;
+    }
+    setPredictionEngine(engine) {
+        this.predictionEngine = engine;
+    }
+    setCausalGraph(graph) {
+        this.causalGraph = graph;
+    }
+    setMetaCognitionLayer(layer) {
+        this.metaCognition = layer;
+    }
+    /**
+     * Simulate a scenario: parse key metrics, find downstream causal effects,
+     * predict directions and magnitudes, persist and return.
+     */
+    simulate(scenario) {
+        const parsed = this.parseScenario(scenario);
+        const predictedOutcomes = [];
+        // Gather baseline from PredictionEngine if available
+        const baselineMetrics = {};
+        if (this.predictionEngine) {
+            try {
+                const summary = this.predictionEngine.getSummary();
+                if (summary.recent) {
+                    for (const pred of summary.recent) {
+                        baselineMetrics[pred.metric] = pred.predicted_value;
+                    }
+                }
+            }
+            catch {
+                // No baseline available
+            }
+        }
+        // For each parsed scenario component, find downstream causal effects
+        for (const { metric, multiplier } of parsed) {
+            if (this.causalGraph) {
+                const effects = this.causalGraph.getEffects(metric);
+                for (const edge of effects) {
+                    // Predict direction based on edge direction and multiplier
+                    const effectiveDirection = edge.direction * (multiplier >= 1 ? 1 : -1);
+                    const direction = effectiveDirection > 0 ? 'increase' : effectiveDirection < 0 ? 'decrease' : 'stable';
+                    // Predict magnitude based on multiplier and edge strength
+                    const baseline = baselineMetrics[edge.effect] ?? 1;
+                    const delta = (multiplier - 1) * edge.strength;
+                    const predicted = baseline * (1 + delta * edge.direction);
+                    // Confidence is based on edge strength, confidence, and sample size
+                    const sampleFactor = Math.min(1, edge.sample_size / 20);
+                    const confidence = edge.strength * edge.confidence * sampleFactor;
+                    predictedOutcomes.push({
+                        metric: edge.effect,
+                        predicted: Math.round(predicted * 1000) / 1000,
+                        direction,
+                        confidence: Math.round(confidence * 1000) / 1000,
+                    });
+                }
+            }
+            // Also add the direct metric itself
+            const baseline = baselineMetrics[metric] ?? 1;
+            const predicted = baseline * multiplier;
+            predictedOutcomes.push({
+                metric,
+                predicted: Math.round(predicted * 1000) / 1000,
+                direction: multiplier > 1 ? 'increase' : multiplier < 1 ? 'decrease' : 'stable',
+                confidence: 0.8, // Direct metric — high confidence
+            });
+        }
+        // If no causal graph and no parsed metrics, generate a generic outcome
+        if (predictedOutcomes.length === 0) {
+            predictedOutcomes.push({
+                metric: 'unknown',
+                predicted: 0,
+                direction: 'stable',
+                confidence: 0.1,
+            });
+        }
+        const parameters = {
+            parsedMetrics: parsed,
+            baselineAvailable: Object.keys(baselineMetrics).length > 0,
+            causalEdgesUsed: predictedOutcomes.length - parsed.length,
+        };
+        // Persist
+        const result = this.db.prepare(`
+      INSERT INTO simulations (scenario, parameters, predicted_outcomes)
+      VALUES (?, ?, ?)
+    `).run(scenario, JSON.stringify(parameters), JSON.stringify(predictedOutcomes));
+        const simulation = {
+            id: result.lastInsertRowid,
+            scenario,
+            parameters,
+            predictedOutcomes,
+            actualOutcomes: null,
+            accuracy: null,
+            simulatedAt: new Date().toISOString(),
+            validatedAt: null,
+        };
+        this.log.info(`[simulation] Simulated "${scenario}": ${predictedOutcomes.length} predicted outcomes`);
+        this.thoughtStream?.emit('simulation-engine', 'analyzing', `Simulated scenario: "${scenario}" → ${predictedOutcomes.length} outcomes predicted`, predictedOutcomes.length >= 3 ? 'notable' : 'routine', { simulationId: simulation.id, outcomes: predictedOutcomes.length });
+        return simulation;
+    }
+    /** Shortcut: simulate what happens when a metric changes by a multiplier. */
+    whatIf(metric, multiplier) {
+        const scenario = multiplier >= 1
+            ? `${metric} increases by ${Math.round((multiplier - 1) * 100)}%`
+            : `${metric} decreases by ${Math.round((1 - multiplier) * 100)}%`;
+        return this.simulate(scenario);
+    }
+    /** Validate a simulation against actual outcomes. */
+    validateSimulation(id, actualOutcomes) {
+        const row = this.db.prepare('SELECT * FROM simulations WHERE id = ?').get(id);
+        if (!row)
+            return null;
+        const sim = this.toSimulation(row);
+        const predicted = sim.predictedOutcomes;
+        // Compute accuracy: matching directions / total predicted
+        let matches = 0;
+        let compared = 0;
+        for (const pred of predicted) {
+            const actual = actualOutcomes.find(a => a.metric === pred.metric);
+            if (actual) {
+                compared++;
+                if (actual.direction === pred.direction) {
+                    matches++;
+                }
+            }
+        }
+        const accuracy = compared > 0 ? matches / compared : 0;
+        this.db.prepare(`
+      UPDATE simulations SET actual_outcomes = ?, accuracy = ?, validated_at = datetime('now')
+      WHERE id = ?
+    `).run(JSON.stringify(actualOutcomes), accuracy, id);
+        this.log.info(`[simulation] Validated #${id}: accuracy=${(accuracy * 100).toFixed(1)}% (${matches}/${compared} correct)`);
+        this.thoughtStream?.emit('simulation-engine', 'analyzing', `Simulation #${id} validated: ${(accuracy * 100).toFixed(1)}% accuracy`, accuracy >= 0.7 ? 'notable' : 'routine', { simulationId: id, accuracy, matches, compared });
+        return {
+            ...sim,
+            actualOutcomes,
+            accuracy,
+            validatedAt: new Date().toISOString(),
+        };
+    }
+    /** List recent simulations. */
+    listSimulations(limit = 20) {
+        const rows = this.db.prepare('SELECT * FROM simulations ORDER BY id DESC LIMIT ?').all(limit);
+        return rows.map(r => this.toSimulation(r));
+    }
+    /** Get overall accuracy metrics. */
+    getAccuracy() {
+        const total = this.db.prepare('SELECT COUNT(*) as c FROM simulations').get().c;
+        const validated = this.db.prepare('SELECT COUNT(*) as c, AVG(accuracy) as avg FROM simulations WHERE accuracy IS NOT NULL').get();
+        return {
+            avgAccuracy: validated.avg ?? 0,
+            validatedCount: validated.c,
+            totalSimulations: total,
+        };
+    }
+    /** Get status summary. */
+    getStatus() {
+        const accuracy = this.getAccuracy();
+        const recent = this.listSimulations(10);
+        return {
+            totalSimulations: accuracy.totalSimulations,
+            validatedCount: accuracy.validatedCount,
+            avgAccuracy: accuracy.avgAccuracy,
+            recentSimulations: recent,
+        };
+    }
+    // ── Private ──────────────────────────────────────────────
+    toSimulation(row) {
+        return {
+            id: row.id,
+            scenario: row.scenario,
+            parameters: JSON.parse(row.parameters || '{}'),
+            predictedOutcomes: JSON.parse(row.predicted_outcomes || '[]'),
+            actualOutcomes: row.actual_outcomes ? JSON.parse(row.actual_outcomes) : null,
+            accuracy: row.accuracy,
+            simulatedAt: row.simulated_at,
+            validatedAt: row.validated_at ?? null,
+        };
+    }
+    /**
+     * Parse a scenario string into metric+multiplier pairs.
+     * Supports patterns like:
+     *   "error_rate doubles"       → { metric: 'error_rate', multiplier: 2 }
+     *   "error_rate triples"       → { metric: 'error_rate', multiplier: 3 }
+     *   "error_rate halves"        → { metric: 'error_rate', multiplier: 0.5 }
+     *   "error_rate increases by 50%"  → { metric: 'error_rate', multiplier: 1.5 }
+     *   "error_rate decreases by 30%"  → { metric: 'error_rate', multiplier: 0.7 }
+     */
+    parseScenario(scenario) {
+        const results = [];
+        const lower = scenario.toLowerCase();
+        // Pattern: "X doubles/triples/halves"
+        const simpleMatch = lower.match(/(\w[\w._-]*)\s+(doubles?|triples?|halves?)/g);
+        if (simpleMatch) {
+            for (const m of simpleMatch) {
+                const parts = m.match(/(\w[\w._-]*)\s+(doubles?|triples?|halves?)/);
+                if (parts) {
+                    const metric = parts[1];
+                    const verb = parts[2];
+                    let multiplier = 1;
+                    if (verb.startsWith('double'))
+                        multiplier = 2;
+                    else if (verb.startsWith('triple'))
+                        multiplier = 3;
+                    else if (verb.startsWith('halv'))
+                        multiplier = 0.5;
+                    results.push({ metric, multiplier });
+                }
+            }
+        }
+        // Pattern: "X increases/decreases by N%"
+        const pctMatch = lower.match(/(\w[\w._-]*)\s+(increases?|decreases?)\s+by\s+(\d+)%/g);
+        if (pctMatch) {
+            for (const m of pctMatch) {
+                const parts = m.match(/(\w[\w._-]*)\s+(increases?|decreases?)\s+by\s+(\d+)%/);
+                if (parts) {
+                    const metric = parts[1];
+                    const dir = parts[2];
+                    const pct = parseInt(parts[3], 10);
+                    const multiplier = dir.startsWith('increase')
+                        ? 1 + pct / 100
+                        : 1 - pct / 100;
+                    results.push({ metric, multiplier });
+                }
+            }
+        }
+        // Fallback: treat entire scenario as a single metric with no change
+        if (results.length === 0) {
+            // Try to extract any word-like metric name
+            const words = scenario.replace(/[^a-zA-Z0-9_.-]/g, ' ').split(/\s+/).filter(w => w.length > 2);
+            if (words.length > 0) {
+                results.push({ metric: words[0], multiplier: 1.5 }); // Default: assume 50% increase
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=simulation-engine.js.map

package/dist/metacognition/simulation-engine.js.map

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

package/dist/metacognition/teach-engine.d.ts

@@ -0,0 +1,63 @@
+import type Database from 'better-sqlite3';
+import type { ThoughtStream } from '../consciousness/thought-stream.js';
+import type { KnowledgeDistiller } from '../research/knowledge-distiller.js';
+import type { HypothesisEngine } from '../hypothesis/engine.js';
+import type { ResearchJournal } from '../research/journal.js';
+export interface TeachingPackage {
+    id?: number;
+    targetBrain: string;
+    principles: Array<{
+        statement: string;
+        confidence: number;
+    }>;
+    antiPatterns: Array<{
+        statement: string;
+        confidence: number;
+    }>;
+    strategies: Array<{
+        id: string;
+        description: string;
+    }>;
+    experiments: Array<{
+        name: string;
+        hypothesis: string;
+        conclusion: string;
+    }>;
+    journalInsights: string[];
+    principlesCount: number;
+    antipatternsCount: number;
+    strategiesCount: number;
+    experimentsCount: number;
+    createdAt: string;
+    effectivenessScore: number | null;
+}
+export interface TeachEngineStatus {
+    totalPackages: number;
+    avgEffectiveness: number;
+    recentPackages: TeachingPackage[];
+}
+export declare function runTeachEngineMigration(db: Database.Database): void;
+export declare class TeachEngine {
+    private db;
+    private log;
+    private thoughtStream;
+    private distiller;
+    private hypothesisEngine;
+    private journal;
+    constructor(db: Database.Database);
+    setThoughtStream(stream: ThoughtStream): void;
+    setKnowledgeDistiller(distiller: KnowledgeDistiller): void;
+    setHypothesisEngine(engine: HypothesisEngine): void;
+    setJournal(journal: ResearchJournal): void;
+    /** Create a teaching package for another brain. */
+    createPackage(targetBrain: string): TeachingPackage;
+    /** Get a teaching package by id. */
+    getPackage(id: number): TeachingPackage | null;
+    /** List recent teaching packages. */
+    listPackages(limit?: number): TeachingPackage[];
+    /** Rate the effectiveness of a teaching package. */
+    rateEffectiveness(id: number, score: number): void;
+    /** Get status summary. */
+    getStatus(): TeachEngineStatus;
+    private toTeachingPackage;
+}

package/dist/metacognition/teach-engine.js

@@ -0,0 +1,185 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runTeachEngineMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS teaching_packages (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      target_brain TEXT NOT NULL,
+      package_json TEXT NOT NULL DEFAULT '{}',
+      principles_count INTEGER NOT NULL DEFAULT 0,
+      antipatterns_count INTEGER NOT NULL DEFAULT 0,
+      strategies_count INTEGER NOT NULL DEFAULT 0,
+      experiments_count INTEGER NOT NULL DEFAULT 0,
+      created_at TEXT DEFAULT (datetime('now')),
+      effectiveness_score REAL DEFAULT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_teaching_packages_target ON teaching_packages(target_brain);
+  `);
+}
+// ── Engine ──────────────────────────────────────────────
+export class TeachEngine {
+    db;
+    log = getLogger();
+    thoughtStream = null;
+    distiller = null;
+    hypothesisEngine = null;
+    journal = null;
+    constructor(db) {
+        this.db = db;
+        runTeachEngineMigration(db);
+    }
+    setThoughtStream(stream) {
+        this.thoughtStream = stream;
+    }
+    setKnowledgeDistiller(distiller) {
+        this.distiller = distiller;
+    }
+    setHypothesisEngine(engine) {
+        this.hypothesisEngine = engine;
+    }
+    setJournal(journal) {
+        this.journal = journal;
+    }
+    /** Create a teaching package for another brain. */
+    createPackage(targetBrain) {
+        // 1. Top 20 Principles (by confidence) from KnowledgeDistiller
+        const principles = [];
+        if (this.distiller) {
+            const ps = this.distiller.getPrinciples(undefined, 20);
+            for (const p of ps) {
+                principles.push({ statement: p.statement, confidence: p.confidence });
+            }
+        }
+        // 2. Top 10 Anti-Patterns from KnowledgeDistiller
+        const antiPatterns = [];
+        if (this.distiller) {
+            const aps = this.distiller.getAntiPatterns(undefined, 10);
+            for (const ap of aps) {
+                antiPatterns.push({ statement: ap.statement, confidence: ap.confidence });
+            }
+        }
+        // 3. Top 5 Strategies from KnowledgeDistiller (query DB directly)
+        const strategies = [];
+        try {
+            const rows = this.db.prepare(`
+        SELECT id, description FROM knowledge_strategies
+        ORDER BY effectiveness DESC LIMIT 5
+      `).all();
+            for (const r of rows) {
+                strategies.push({ id: r.id, description: r.description });
+            }
+        }
+        catch { /* knowledge_strategies table might not exist */ }
+        // 4. Top 5 experiment results from HypothesisEngine (confirmed with evidence)
+        const experiments = [];
+        if (this.hypothesisEngine) {
+            try {
+                const confirmed = this.hypothesisEngine.list('confirmed', 5);
+                for (const h of confirmed) {
+                    experiments.push({
+                        name: `Hypothesis #${h.id}`,
+                        hypothesis: h.statement,
+                        conclusion: `Confirmed with confidence ${h.confidence.toFixed(2)} (evidence: ${h.evidence_for} for, ${h.evidence_against} against)`,
+                    });
+                }
+            }
+            catch { /* hypotheses table might not exist */ }
+        }
+        // 5. Key Journal insights (search for 'breakthrough' significance entries, take top 5 titles)
+        const journalInsights = [];
+        if (this.journal) {
+            try {
+                const entries = this.journal.getEntries(undefined, 100);
+                const breakthroughs = entries.filter(e => e.significance === 'breakthrough' || e.significance === 'paradigm_shift');
+                for (const e of breakthroughs.slice(0, 5)) {
+                    journalInsights.push(e.title);
+                }
+            }
+            catch { /* journal table might not exist */ }
+        }
+        // 6. Package everything
+        const pkg = {
+            targetBrain,
+            principles,
+            antiPatterns,
+            strategies,
+            experiments,
+            journalInsights,
+            principlesCount: principles.length,
+            antipatternsCount: antiPatterns.length,
+            strategiesCount: strategies.length,
+            experimentsCount: experiments.length,
+            createdAt: new Date().toISOString(),
+            effectivenessScore: null,
+        };
+        const packageJson = JSON.stringify({
+            principles: pkg.principles,
+            antiPatterns: pkg.antiPatterns,
+            strategies: pkg.strategies,
+            experiments: pkg.experiments,
+            journalInsights: pkg.journalInsights,
+        });
+        const result = this.db.prepare(`
+      INSERT INTO teaching_packages (target_brain, package_json, principles_count, antipatterns_count, strategies_count, experiments_count)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(targetBrain, packageJson, pkg.principlesCount, pkg.antipatternsCount, pkg.strategiesCount, pkg.experimentsCount);
+        pkg.id = result.lastInsertRowid;
+        // 7. Emit thought
+        this.thoughtStream?.emit('teach', 'reflecting', `Created teaching package for "${targetBrain}": ${principles.length} principles, ${antiPatterns.length} anti-patterns, ${strategies.length} strategies, ${experiments.length} experiments`, principles.length > 5 ? 'notable' : 'routine');
+        this.log.info(`[teach] Created package #${pkg.id} for ${targetBrain}: ${principles.length}P, ${antiPatterns.length}AP, ${strategies.length}S, ${experiments.length}E`);
+        return pkg;
+    }
+    /** Get a teaching package by id. */
+    getPackage(id) {
+        const row = this.db.prepare('SELECT * FROM teaching_packages WHERE id = ?').get(id);
+        if (!row)
+            return null;
+        return this.toTeachingPackage(row);
+    }
+    /** List recent teaching packages. */
+    listPackages(limit = 20) {
+        const rows = this.db.prepare(`
+      SELECT * FROM teaching_packages ORDER BY id DESC LIMIT ?
+    `).all(limit);
+        return rows.map(r => this.toTeachingPackage(r));
+    }
+    /** Rate the effectiveness of a teaching package. */
+    rateEffectiveness(id, score) {
+        const clamped = Math.max(0, Math.min(1, score));
+        this.db.prepare(`
+      UPDATE teaching_packages SET effectiveness_score = ? WHERE id = ?
+    `).run(clamped, id);
+        this.log.debug(`[teach] Rated package #${id} effectiveness: ${clamped.toFixed(2)}`);
+    }
+    /** Get status summary. */
+    getStatus() {
+        const total = this.db.prepare('SELECT COUNT(*) as c FROM teaching_packages').get().c;
+        const avgRow = this.db.prepare('SELECT AVG(effectiveness_score) as avg FROM teaching_packages WHERE effectiveness_score IS NOT NULL').get();
+        const recentPackages = this.listPackages(5);
+        return {
+            totalPackages: total,
+            avgEffectiveness: avgRow.avg ?? 0,
+            recentPackages,
+        };
+    }
+    // ── Private ─────────────────────────────────────────────
+    toTeachingPackage(row) {
+        const packageData = JSON.parse(row.package_json || '{}');
+        return {
+            id: row.id,
+            targetBrain: row.target_brain,
+            principles: packageData.principles ?? [],
+            antiPatterns: packageData.antiPatterns ?? [],
+            strategies: packageData.strategies ?? [],
+            experiments: packageData.experiments ?? [],
+            journalInsights: packageData.journalInsights ?? [],
+            principlesCount: row.principles_count,
+            antipatternsCount: row.antipatterns_count,
+            strategiesCount: row.strategies_count,
+            experimentsCount: row.experiments_count,
+            createdAt: row.created_at,
+            effectivenessScore: row.effectiveness_score,
+        };
+    }
+}
+//# sourceMappingURL=teach-engine.js.map

package/dist/metacognition/teach-engine.js.map

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

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

@@ -0,0 +1,68 @@
+import type Database from 'better-sqlite3';
+import type { ThoughtStream } from '../consciousness/thought-stream.js';
+export interface ScoutDiscovery {
+    id?: number;
+    source: string;
+    title: string;
+    url: string;
+    description: string;
+    relevanceScore: number;
+    metadata: Record<string, unknown>;
+    discoveredAt: string;
+    imported: boolean;
+}
+export interface ScoutAdapter {
+    name: string;
+    scout(): Promise<ScoutDiscovery[]>;
+    isEnabled(): boolean;
+}
+export interface DataScoutStatus {
+    totalDiscoveries: number;
+    importedCount: number;
+    bySource: Record<string, number>;
+    recentDiscoveries: ScoutDiscovery[];
+}
+export declare function runDataScoutMigration(db: Database.Database): void;
+export declare class DataScout {
+    private db;
+    private adapters;
+    private thoughtStream;
+    private log;
+    constructor(db: Database.Database, adapters?: ScoutAdapter[]);
+    setThoughtStream(stream: ThoughtStream): void;
+    addAdapter(adapter: ScoutAdapter): void;
+    /** Run all enabled adapters, deduplicate, persist new discoveries. */
+    scout(): Promise<ScoutDiscovery[]>;
+    /** Get discoveries, optionally filtered by source. */
+    getDiscoveries(source?: string, limit?: number): ScoutDiscovery[];
+    /** Mark a discovery as imported. */
+    markImported(id: number): void;
+    /** Get status summary. */
+    getStatus(): DataScoutStatus;
+    private isDuplicate;
+    private toDiscovery;
+}
+/**
+ * GitHubTrendingAdapter — Discovers trending GitHub repositories.
+ */
+export declare class GitHubTrendingAdapter implements ScoutAdapter {
+    readonly name = "github-trending";
+    isEnabled(): boolean;
+    scout(): Promise<ScoutDiscovery[]>;
+}
+/**
+ * NpmStatsAdapter — Discovers trending npm packages.
+ */
+export declare class NpmStatsAdapter implements ScoutAdapter {
+    readonly name = "npm-stats";
+    isEnabled(): boolean;
+    scout(): Promise<ScoutDiscovery[]>;
+}
+/**
+ * HackerNewsAdapter — Discovers top Hacker News stories.
+ */
+export declare class HackerNewsAdapter implements ScoutAdapter {
+    readonly name = "hackernews";
+    isEnabled(): boolean;
+    scout(): Promise<ScoutDiscovery[]>;
+}