@timmeck/brain-core 2.5.0 → 2.6.0

package/dist/research/journal.js.map

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

package/dist/research/knowledge-distiller.d.ts

@@ -0,0 +1,95 @@
+import type Database from 'better-sqlite3';
+export interface Principle {
+    id: string;
+    domain: string;
+    statement: string;
+    success_rate: number;
+    sample_size: number;
+    confidence: number;
+    source: string;
+}
+export interface AntiPattern {
+    id: string;
+    domain: string;
+    statement: string;
+    failure_rate: number;
+    sample_size: number;
+    confidence: number;
+    alternative: string;
+}
+export interface Strategy {
+    id: string;
+    domain: string;
+    description: string;
+    conditions: string[];
+    effectiveness: number;
+    evidence_count: number;
+}
+export interface KnowledgePackage {
+    id: string;
+    created: number;
+    domain: string;
+    principles: Principle[];
+    anti_patterns: AntiPattern[];
+    strategies: Strategy[];
+    confidence: number;
+    evidence_summary: string;
+    applicable_when: string[];
+    transferable_to: string[];
+}
+export interface KnowledgeEvolution {
+    domain: string;
+    period: string;
+    principles_added: number;
+    principles_removed: number;
+    anti_patterns_discovered: number;
+    strategies_changed: number;
+    confidence_trend: 'rising' | 'stable' | 'falling';
+    highlights: string[];
+}
+export interface KnowledgeDistillerConfig {
+    brainName: string;
+    /** Minimum evidence to extract a principle. Default: 5 */
+    minEvidence?: number;
+    /** Minimum success rate for a principle. Default: 0.7 */
+    minSuccessRate?: number;
+    /** Minimum failure rate for an anti-pattern. Default: 0.6 */
+    minFailureRate?: number;
+}
+export declare function runKnowledgeDistillerMigration(db: Database.Database): void;
+export declare class KnowledgeDistiller {
+    private db;
+    private config;
+    private log;
+    constructor(db: Database.Database, config: KnowledgeDistillerConfig);
+    /** Distill knowledge from confirmed hypotheses, research discoveries, and strategy adaptations. */
+    distill(): {
+        principles: Principle[];
+        antiPatterns: AntiPattern[];
+        strategies: Strategy[];
+    };
+    /** Get summary of all distilled knowledge. */
+    getSummary(): {
+        principles: number;
+        antiPatterns: number;
+        strategies: number;
+        topPrinciples: Principle[];
+        avgConfidence: number;
+    };
+    /** Get principles, optionally filtered by domain. */
+    getPrinciples(domain?: string, limit?: number): Principle[];
+    /** Get anti-patterns. */
+    getAntiPatterns(domain?: string, limit?: number): AntiPattern[];
+    /** Build a transferable knowledge package for a domain. */
+    getPackage(domain: string): KnowledgePackage;
+    /** Track how knowledge has evolved over time. */
+    getEvolution(domain?: string, periods?: number): KnowledgeEvolution[];
+    private extractPrinciples;
+    private extractAntiPatterns;
+    private extractStrategies;
+    private suggestTransferDomains;
+    private upsertPrinciple;
+    private upsertAntiPattern;
+    private upsertStrategy;
+    private hashString;
+}

package/dist/research/knowledge-distiller.js

@@ -0,0 +1,426 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runKnowledgeDistillerMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS knowledge_principles (
+      id TEXT PRIMARY KEY,
+      domain TEXT NOT NULL,
+      statement TEXT NOT NULL,
+      success_rate REAL NOT NULL,
+      sample_size INTEGER NOT NULL,
+      confidence REAL NOT NULL,
+      source TEXT NOT NULL,
+      created_at TEXT DEFAULT (datetime('now')),
+      updated_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_kp_domain ON knowledge_principles(domain);
+
+    CREATE TABLE IF NOT EXISTS knowledge_anti_patterns (
+      id TEXT PRIMARY KEY,
+      domain TEXT NOT NULL,
+      statement TEXT NOT NULL,
+      failure_rate REAL NOT NULL,
+      sample_size INTEGER NOT NULL,
+      confidence REAL NOT NULL,
+      alternative TEXT NOT NULL,
+      created_at TEXT DEFAULT (datetime('now')),
+      updated_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_kap_domain ON knowledge_anti_patterns(domain);
+
+    CREATE TABLE IF NOT EXISTS knowledge_strategies (
+      id TEXT PRIMARY KEY,
+      domain TEXT NOT NULL,
+      description TEXT NOT NULL,
+      conditions TEXT NOT NULL,
+      effectiveness REAL NOT NULL,
+      evidence_count INTEGER NOT NULL,
+      created_at TEXT DEFAULT (datetime('now')),
+      updated_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_ks_domain ON knowledge_strategies(domain);
+
+    CREATE TABLE IF NOT EXISTS knowledge_snapshots (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      timestamp INTEGER NOT NULL,
+      domain TEXT NOT NULL,
+      principles_count INTEGER NOT NULL,
+      anti_patterns_count INTEGER NOT NULL,
+      strategies_count INTEGER NOT NULL,
+      avg_confidence REAL NOT NULL,
+      created_at TEXT DEFAULT (datetime('now'))
+    );
+  `);
+}
+// ── Engine ──────────────────────────────────────────────
+export class KnowledgeDistiller {
+    db;
+    config;
+    log = getLogger();
+    constructor(db, config) {
+        this.db = db;
+        this.config = {
+            brainName: config.brainName,
+            minEvidence: config.minEvidence ?? 5,
+            minSuccessRate: config.minSuccessRate ?? 0.7,
+            minFailureRate: config.minFailureRate ?? 0.6,
+        };
+        runKnowledgeDistillerMigration(db);
+    }
+    /** Distill knowledge from confirmed hypotheses, research discoveries, and strategy adaptations. */
+    distill() {
+        const principles = this.extractPrinciples();
+        const antiPatterns = this.extractAntiPatterns();
+        const strategies = this.extractStrategies();
+        // Take snapshot for evolution tracking
+        this.db.prepare(`
+      INSERT INTO knowledge_snapshots (timestamp, domain, principles_count, anti_patterns_count, strategies_count, avg_confidence)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(Date.now(), this.config.brainName, principles.length, antiPatterns.length, strategies.length, principles.length > 0 ? principles.reduce((s, p) => s + p.confidence, 0) / principles.length : 0);
+        return { principles, antiPatterns, strategies };
+    }
+    /** Get summary of all distilled knowledge. */
+    getSummary() {
+        const pCount = this.db.prepare(`SELECT COUNT(*) as c FROM knowledge_principles`).get().c;
+        const apCount = this.db.prepare(`SELECT COUNT(*) as c FROM knowledge_anti_patterns`).get().c;
+        const sCount = this.db.prepare(`SELECT COUNT(*) as c FROM knowledge_strategies`).get().c;
+        const topPrinciples = this.getPrinciples(undefined, 5);
+        const avgConf = topPrinciples.length > 0 ? topPrinciples.reduce((s, p) => s + p.confidence, 0) / topPrinciples.length : 0;
+        return {
+            principles: pCount,
+            antiPatterns: apCount,
+            strategies: sCount,
+            topPrinciples,
+            avgConfidence: avgConf,
+        };
+    }
+    /** Get principles, optionally filtered by domain. */
+    getPrinciples(domain, limit = 20) {
+        let sql = `SELECT * FROM knowledge_principles`;
+        const params = [];
+        if (domain) {
+            sql += ` WHERE domain = ?`;
+            params.push(domain);
+        }
+        sql += ` ORDER BY confidence DESC, success_rate DESC LIMIT ?`;
+        params.push(limit);
+        return this.db.prepare(sql).all(...params).map(r => ({
+            id: r.id,
+            domain: r.domain,
+            statement: r.statement,
+            success_rate: r.success_rate,
+            sample_size: r.sample_size,
+            confidence: r.confidence,
+            source: r.source,
+        }));
+    }
+    /** Get anti-patterns. */
+    getAntiPatterns(domain, limit = 20) {
+        let sql = `SELECT * FROM knowledge_anti_patterns`;
+        const params = [];
+        if (domain) {
+            sql += ` WHERE domain = ?`;
+            params.push(domain);
+        }
+        sql += ` ORDER BY failure_rate DESC LIMIT ?`;
+        params.push(limit);
+        return this.db.prepare(sql).all(...params).map(r => ({
+            id: r.id,
+            domain: r.domain,
+            statement: r.statement,
+            failure_rate: r.failure_rate,
+            sample_size: r.sample_size,
+            confidence: r.confidence,
+            alternative: r.alternative,
+        }));
+    }
+    /** Build a transferable knowledge package for a domain. */
+    getPackage(domain) {
+        const principles = this.getPrinciples(domain, 15);
+        const antiPatterns = this.getAntiPatterns(domain, 10);
+        const strategies = this.db.prepare(`
+      SELECT * FROM knowledge_strategies WHERE domain = ? ORDER BY effectiveness DESC LIMIT 10
+    `).all(domain).map(r => ({
+            id: r.id,
+            domain: r.domain,
+            description: r.description,
+            conditions: JSON.parse(r.conditions),
+            effectiveness: r.effectiveness,
+            evidence_count: r.evidence_count,
+        }));
+        const allConf = [...principles.map(p => p.confidence), ...antiPatterns.map(a => a.confidence)];
+        const avgConf = allConf.length > 0 ? allConf.reduce((a, b) => a + b, 0) / allConf.length : 0;
+        return {
+            id: `${domain}-${Date.now()}`,
+            created: Date.now(),
+            domain,
+            principles,
+            anti_patterns: antiPatterns,
+            strategies,
+            confidence: avgConf,
+            evidence_summary: `${principles.length} principles, ${antiPatterns.length} anti-patterns, ${strategies.length} strategies from ${this.config.brainName}`,
+            applicable_when: [`Working with ${domain} tasks`, `Debugging ${domain} issues`],
+            transferable_to: this.suggestTransferDomains(domain),
+        };
+    }
+    /** Track how knowledge has evolved over time. */
+    getEvolution(domain, periods = 5) {
+        const snapshots = this.db.prepare(`
+      SELECT * FROM knowledge_snapshots
+      ${domain ? 'WHERE domain = ?' : ''}
+      ORDER BY timestamp DESC LIMIT ?
+    `).all(...(domain ? [domain, periods * 2] : [periods * 2]));
+        if (snapshots.length < 2)
+            return [];
+        const evolutions = [];
+        for (let i = 0; i < snapshots.length - 1; i++) {
+            const current = snapshots[i];
+            const previous = snapshots[i + 1];
+            const principlesDelta = current.principles_count - previous.principles_count;
+            const antiPatternsDelta = current.anti_patterns_count - previous.anti_patterns_count;
+            const strategyDelta = current.strategies_count - previous.strategies_count;
+            const confCurrent = current.avg_confidence;
+            const confPrev = previous.avg_confidence;
+            const confTrend = confCurrent > confPrev + 0.02 ? 'rising' :
+                confCurrent < confPrev - 0.02 ? 'falling' : 'stable';
+            const highlights = [];
+            if (principlesDelta > 0)
+                highlights.push(`+${principlesDelta} new principles`);
+            if (principlesDelta < 0)
+                highlights.push(`${principlesDelta} principles removed (outdated)`);
+            if (antiPatternsDelta > 0)
+                highlights.push(`+${antiPatternsDelta} anti-patterns discovered`);
+            if (strategyDelta !== 0)
+                highlights.push(`${strategyDelta > 0 ? '+' : ''}${strategyDelta} strategy changes`);
+            evolutions.push({
+                domain: current.domain,
+                period: new Date(current.timestamp).toLocaleDateString(),
+                principles_added: Math.max(0, principlesDelta),
+                principles_removed: Math.abs(Math.min(0, principlesDelta)),
+                anti_patterns_discovered: Math.max(0, antiPatternsDelta),
+                strategies_changed: Math.abs(strategyDelta),
+                confidence_trend: confTrend,
+                highlights,
+            });
+        }
+        return evolutions;
+    }
+    extractPrinciples() {
+        const principles = [];
+        // Extract from confirmed hypotheses
+        try {
+            const confirmed = this.db.prepare(`
+        SELECT statement, type, variables, confidence, evidence_for, evidence_against
+        FROM hypotheses
+        WHERE status = 'confirmed' AND evidence_for >= ?
+        ORDER BY confidence DESC
+      `).all(this.config.minEvidence);
+            for (const h of confirmed) {
+                const total = h.evidence_for + h.evidence_against;
+                const successRate = h.evidence_for / Math.max(total, 1);
+                if (successRate < this.config.minSuccessRate)
+                    continue;
+                const id = `hyp-${this.hashString(h.statement)}`;
+                const principle = {
+                    id,
+                    domain: h.type || this.config.brainName,
+                    statement: h.statement,
+                    success_rate: successRate,
+                    sample_size: total,
+                    confidence: h.confidence,
+                    source: 'confirmed_hypothesis',
+                };
+                this.upsertPrinciple(principle);
+                principles.push(principle);
+            }
+        }
+        catch { /* hypotheses table might not exist */ }
+        // Extract from research discoveries
+        try {
+            const discoveries = this.db.prepare(`
+        SELECT title, description, confidence, type, data
+        FROM research_discoveries
+        WHERE confidence >= 0.6 AND type IN ('confirmed_hypothesis', 'causal_chain')
+        ORDER BY confidence DESC LIMIT 20
+      `).all();
+            for (const d of discoveries) {
+                const id = `disc-${this.hashString(d.title)}`;
+                const principle = {
+                    id,
+                    domain: this.config.brainName,
+                    statement: d.title,
+                    success_rate: d.confidence,
+                    sample_size: 1,
+                    confidence: d.confidence,
+                    source: `research_discovery:${d.type}`,
+                };
+                this.upsertPrinciple(principle);
+                principles.push(principle);
+            }
+        }
+        catch { /* research_discoveries table might not exist */ }
+        return principles;
+    }
+    extractAntiPatterns() {
+        const antiPatterns = [];
+        // Extract from rejected hypotheses (things that don't work)
+        try {
+            const rejected = this.db.prepare(`
+        SELECT statement, type, evidence_for, evidence_against, confidence
+        FROM hypotheses
+        WHERE status = 'rejected' AND evidence_against >= ?
+        ORDER BY evidence_against DESC
+      `).all(this.config.minEvidence);
+            for (const h of rejected) {
+                const total = h.evidence_for + h.evidence_against;
+                const failureRate = h.evidence_against / Math.max(total, 1);
+                if (failureRate < this.config.minFailureRate)
+                    continue;
+                const id = `anti-${this.hashString(h.statement)}`;
+                const anti = {
+                    id,
+                    domain: h.type || this.config.brainName,
+                    statement: `NOT: ${h.statement}`,
+                    failure_rate: failureRate,
+                    sample_size: total,
+                    confidence: h.confidence,
+                    alternative: 'See confirmed principles for what works instead.',
+                };
+                this.upsertAntiPattern(anti);
+                antiPatterns.push(anti);
+            }
+        }
+        catch { /* hypotheses table might not exist */ }
+        // Extract from reverted strategy adaptations
+        try {
+            const reverted = this.db.prepare(`
+        SELECT strategy, parameter, old_value, new_value, reason, revert_reason
+        FROM strategy_adaptations
+        WHERE reverted = 1
+        ORDER BY timestamp DESC LIMIT 20
+      `).all();
+            for (const r of reverted) {
+                const id = `revert-${r.strategy}-${r.parameter}`;
+                const anti = {
+                    id,
+                    domain: r.strategy,
+                    statement: `Changing ${r.parameter} from ${r.old_value} to ${r.new_value} degrades performance`,
+                    failure_rate: 1.0,
+                    sample_size: 1,
+                    confidence: 0.7,
+                    alternative: `Keep ${r.parameter} at ${r.old_value}. Reason: ${r.revert_reason ?? r.reason}`,
+                };
+                this.upsertAntiPattern(anti);
+                antiPatterns.push(anti);
+            }
+        }
+        catch { /* strategy_adaptations table might not exist */ }
+        return antiPatterns;
+    }
+    extractStrategies() {
+        const strategies = [];
+        // Extract from successful strategy adaptations
+        try {
+            const successful = this.db.prepare(`
+        SELECT strategy, parameter, old_value, new_value, reason, evidence,
+               performance_before, performance_after
+        FROM strategy_adaptations
+        WHERE reverted = 0 AND performance_after IS NOT NULL
+        AND performance_after > performance_before
+        ORDER BY (performance_after - performance_before) DESC LIMIT 20
+      `).all();
+            for (const s of successful) {
+                const improvement = s.performance_after - s.performance_before;
+                const id = `strat-${s.strategy}-${s.parameter}-${Date.now()}`;
+                const strategy = {
+                    id,
+                    domain: s.strategy,
+                    description: `Set ${s.parameter} to ${s.new_value} (from ${s.old_value}) for ${(improvement * 100).toFixed(1)}% improvement`,
+                    conditions: [s.reason],
+                    effectiveness: improvement,
+                    evidence_count: 1,
+                };
+                this.upsertStrategy(strategy);
+                strategies.push(strategy);
+            }
+        }
+        catch { /* strategy_adaptations table might not exist */ }
+        // Extract from meta-learning optimizations
+        try {
+            const optimizations = this.db.prepare(`
+        SELECT param_name, old_value, new_value, reason, improvement
+        FROM meta_learning_optimizations
+        WHERE improvement > 0
+        ORDER BY improvement DESC LIMIT 10
+      `).all();
+            for (const o of optimizations) {
+                const id = `meta-${o.param_name}`;
+                const strategy = {
+                    id,
+                    domain: 'meta_learning',
+                    description: `Optimize ${o.param_name} to ${o.new_value} for ${(o.improvement * 100).toFixed(1)}% gain`,
+                    conditions: [o.reason],
+                    effectiveness: o.improvement,
+                    evidence_count: 1,
+                };
+                this.upsertStrategy(strategy);
+                strategies.push(strategy);
+            }
+        }
+        catch { /* meta_learning_optimizations table might not exist */ }
+        return strategies;
+    }
+    suggestTransferDomains(domain) {
+        const allDomains = new Set();
+        try {
+            const rows = this.db.prepare(`SELECT DISTINCT domain FROM knowledge_principles`).all();
+            for (const r of rows)
+                allDomains.add(r.domain);
+        }
+        catch { /* ignore */ }
+        allDomains.delete(domain);
+        return [...allDomains].slice(0, 5);
+    }
+    upsertPrinciple(p) {
+        this.db.prepare(`
+      INSERT INTO knowledge_principles (id, domain, statement, success_rate, sample_size, confidence, source)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        success_rate = excluded.success_rate,
+        sample_size = excluded.sample_size,
+        confidence = excluded.confidence,
+        updated_at = datetime('now')
+    `).run(p.id, p.domain, p.statement, p.success_rate, p.sample_size, p.confidence, p.source);
+    }
+    upsertAntiPattern(a) {
+        this.db.prepare(`
+      INSERT INTO knowledge_anti_patterns (id, domain, statement, failure_rate, sample_size, confidence, alternative)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        failure_rate = excluded.failure_rate,
+        sample_size = excluded.sample_size,
+        confidence = excluded.confidence,
+        updated_at = datetime('now')
+    `).run(a.id, a.domain, a.statement, a.failure_rate, a.sample_size, a.confidence, a.alternative);
+    }
+    upsertStrategy(s) {
+        this.db.prepare(`
+      INSERT INTO knowledge_strategies (id, domain, description, conditions, effectiveness, evidence_count)
+      VALUES (?, ?, ?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        effectiveness = excluded.effectiveness,
+        evidence_count = knowledge_strategies.evidence_count + 1,
+        updated_at = datetime('now')
+    `).run(s.id, s.domain, s.description, JSON.stringify(s.conditions), s.effectiveness, s.evidence_count);
+    }
+    hashString(s) {
+        let hash = 0;
+        for (let i = 0; i < s.length; i++) {
+            const char = s.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return Math.abs(hash).toString(36);
+    }
+}
+//# sourceMappingURL=knowledge-distiller.js.map

package/dist/research/knowledge-distiller.js.map

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

package/dist/research/self-observer.d.ts

@@ -0,0 +1,55 @@
+import type Database from 'better-sqlite3';
+export type ObservationCategory = 'tool_usage' | 'query_quality' | 'resolution_rate' | 'latency' | 'cross_brain';
+export type InsightType = 'usage_pattern' | 'quality_issue' | 'optimization_opportunity' | 'anomaly';
+export interface SelfObservation {
+    id?: number;
+    timestamp: number;
+    category: ObservationCategory;
+    event_type: string;
+    metrics: Record<string, unknown>;
+    context?: Record<string, unknown>;
+}
+export interface SelfInsight {
+    id?: number;
+    timestamp: number;
+    type: InsightType;
+    title: string;
+    description: string;
+    evidence: Record<string, unknown>;
+    confidence: number;
+    actionable: boolean;
+}
+export interface ImprovementSuggestion {
+    area: string;
+    problem: string;
+    suggestion: string;
+    evidence: Record<string, unknown>;
+    priority: number;
+    estimated_impact: string;
+}
+export interface SelfObserverConfig {
+    brainName: string;
+    /** Minimum observations before generating insights. Default: 10 */
+    minObservationsForInsight?: number;
+    /** How many recent observations to analyze. Default: 500 */
+    analysisWindow?: number;
+}
+export declare function runSelfObserverMigration(db: Database.Database): void;
+export declare class SelfObserver {
+    private db;
+    private config;
+    private log;
+    constructor(db: Database.Database, config: SelfObserverConfig);
+    /** Record a self-observation about tool usage, query quality, etc. */
+    record(obs: Omit<SelfObservation, 'id' | 'timestamp'>): void;
+    /** Get observation statistics grouped by category and event type. */
+    getStats(): Record<string, unknown>;
+    /** Analyze observations and generate insights. */
+    analyze(): SelfInsight[];
+    /** Get all insights, optionally filtered by type. */
+    getInsights(type?: InsightType, limit?: number): SelfInsight[];
+    /** Generate an improvement plan based on insights. */
+    getImprovementPlan(): ImprovementSuggestion[];
+    private createInsight;
+    private persistInsight;
+}