@timmeck/brain-core 2.4.0 → 2.6.0

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;
+}