@timmeck/brain-core 2.4.0 → 2.6.0

package/dist/research/journal.js

@@ -0,0 +1,262 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runJournalMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS research_journal (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      timestamp INTEGER NOT NULL,
+      type TEXT NOT NULL,
+      title TEXT NOT NULL,
+      content TEXT NOT NULL,
+      tags TEXT NOT NULL DEFAULT '[]',
+      ref_ids TEXT NOT NULL DEFAULT '[]',
+      significance TEXT NOT NULL DEFAULT 'routine',
+      data TEXT NOT NULL DEFAULT '{}',
+      created_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_journal_type ON research_journal(type);
+    CREATE INDEX IF NOT EXISTS idx_journal_ts ON research_journal(timestamp);
+    CREATE INDEX IF NOT EXISTS idx_journal_sig ON research_journal(significance);
+
+    CREATE VIRTUAL TABLE IF NOT EXISTS journal_fts USING fts5(
+      title, content, tags,
+      content='research_journal',
+      content_rowid='id'
+    );
+
+    CREATE TRIGGER IF NOT EXISTS journal_ai AFTER INSERT ON research_journal BEGIN
+      INSERT INTO journal_fts(rowid, title, content, tags)
+      VALUES (new.id, new.title, new.content, new.tags);
+    END;
+    CREATE TRIGGER IF NOT EXISTS journal_ad AFTER DELETE ON research_journal BEGIN
+      INSERT INTO journal_fts(journal_fts, rowid, title, content, tags)
+      VALUES ('delete', old.id, old.title, old.content, old.tags);
+    END;
+  `);
+}
+// ── Engine ──────────────────────────────────────────────
+export class ResearchJournal {
+    db;
+    config;
+    cyclesSinceReflection = 0;
+    log = getLogger();
+    constructor(db, config) {
+        this.db = db;
+        this.config = {
+            brainName: config.brainName,
+            reflectionInterval: config.reflectionInterval ?? 10,
+            maxEntries: config.maxEntries ?? 10_000,
+        };
+        runJournalMigration(db);
+    }
+    /** Write a journal entry. */
+    write(entry) {
+        const timestamp = Date.now();
+        const result = this.db.prepare(`
+      INSERT INTO research_journal (timestamp, type, title, content, tags, ref_ids, significance, data)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(timestamp, entry.type, entry.title, entry.content, JSON.stringify(entry.tags), JSON.stringify(entry.references), entry.significance, JSON.stringify(entry.data));
+        this.cleanup();
+        return { ...entry, id: Number(result.lastInsertRowid), timestamp };
+    }
+    /** Record a discovery in the journal. */
+    recordDiscovery(title, description, data, significance = 'notable') {
+        return this.write({
+            type: 'discovery',
+            title,
+            content: description,
+            tags: ['discovery', this.config.brainName],
+            references: [],
+            significance,
+            data,
+        });
+    }
+    /** Record an experiment result. */
+    recordExperiment(name, result, data, significant) {
+        return this.write({
+            type: 'experiment',
+            title: `Experiment: ${name}`,
+            content: result,
+            tags: ['experiment', significant ? 'significant' : 'not_significant'],
+            references: [],
+            significance: significant ? 'notable' : 'routine',
+            data,
+        });
+    }
+    /** Record an anomaly. */
+    recordAnomaly(title, description, severity, data) {
+        const sig = severity === 'critical' ? 'breakthrough' :
+            severity === 'high' ? 'notable' : 'routine';
+        return this.write({
+            type: 'anomaly',
+            title,
+            content: description,
+            tags: ['anomaly', severity],
+            references: [],
+            significance: sig,
+            data,
+        });
+    }
+    /** Record a strategy adaptation. */
+    recordAdaptation(parameter, oldValue, newValue, reason) {
+        return this.write({
+            type: 'adaptation',
+            title: `Adapted ${parameter}: ${oldValue.toFixed(3)} → ${newValue.toFixed(3)}`,
+            content: reason,
+            tags: ['adaptation', parameter],
+            references: [],
+            significance: 'routine',
+            data: { parameter, old_value: oldValue, new_value: newValue },
+        });
+    }
+    /** Generate automatic reflection based on recent entries. */
+    reflect() {
+        this.cyclesSinceReflection++;
+        if (this.cyclesSinceReflection < this.config.reflectionInterval)
+            return null;
+        this.cyclesSinceReflection = 0;
+        // Get recent entries since last reflection
+        const lastReflection = this.db.prepare(`
+      SELECT timestamp FROM research_journal WHERE type = 'reflection'
+      ORDER BY timestamp DESC LIMIT 1
+    `).get();
+        const since = lastReflection?.timestamp ?? 0;
+        const entries = this.db.prepare(`
+      SELECT type, significance, title FROM research_journal
+      WHERE timestamp > ? AND type != 'reflection'
+      ORDER BY timestamp DESC
+    `).all(since);
+        if (entries.length === 0)
+            return null;
+        const byType = new Map();
+        const bySignificance = new Map();
+        const highlights = [];
+        for (const e of entries) {
+            byType.set(e.type, (byType.get(e.type) ?? 0) + 1);
+            bySignificance.set(e.significance, (bySignificance.get(e.significance) ?? 0) + 1);
+            if (e.significance !== 'routine')
+                highlights.push(e.title);
+        }
+        const typeStr = [...byType.entries()].map(([k, v]) => `${v} ${k}(s)`).join(', ');
+        const content = [
+            `Reflection on ${entries.length} entries since last review:`,
+            `Types: ${typeStr}`,
+            '',
+        ];
+        if (highlights.length > 0) {
+            content.push('Key highlights:');
+            for (const h of highlights.slice(0, 5))
+                content.push(`  - ${h}`);
+            content.push('');
+        }
+        const confirmed = entries.filter(e => e.type === 'experiment' || e.type === 'discovery').length;
+        const anomalies = entries.filter(e => e.type === 'anomaly').length;
+        if (confirmed > 0)
+            content.push(`${confirmed} discoveries/experiments completed.`);
+        if (anomalies > 0)
+            content.push(`${anomalies} anomalies detected.`);
+        return this.write({
+            type: 'reflection',
+            title: `Reflection: ${entries.length} events reviewed`,
+            content: content.join('\n'),
+            tags: ['reflection', 'auto'],
+            references: [],
+            significance: highlights.length >= 3 ? 'notable' : 'routine',
+            data: { entries_count: entries.length, by_type: Object.fromEntries(byType), highlights },
+        });
+    }
+    /** Get journal entries, optionally filtered. */
+    getEntries(type, limit = 20) {
+        let sql = `SELECT * FROM research_journal`;
+        const params = [];
+        if (type) {
+            sql += ` WHERE type = ?`;
+            params.push(type);
+        }
+        sql += ` ORDER BY timestamp DESC LIMIT ?`;
+        params.push(limit);
+        return this.db.prepare(sql).all(...params).map(r => this.rowToEntry(r));
+    }
+    /** Get summary of journal contents. */
+    getSummary(limit = 5) {
+        const total = this.db.prepare(`SELECT COUNT(*) as c FROM research_journal`).get().c;
+        const byType = Object.fromEntries(this.db.prepare(`SELECT type, COUNT(*) as c FROM research_journal GROUP BY type`).all()
+            .map(r => [r.type, r.c]));
+        const bySignificance = Object.fromEntries(this.db.prepare(`SELECT significance, COUNT(*) as c FROM research_journal GROUP BY significance`).all()
+            .map(r => [r.significance, r.c]));
+        const highlights = this.db.prepare(`
+      SELECT * FROM research_journal
+      WHERE significance IN ('notable', 'breakthrough', 'paradigm_shift')
+      ORDER BY timestamp DESC LIMIT ?
+    `).all(limit).map(r => this.rowToEntry(r));
+        const dateRange = this.db.prepare(`
+      SELECT MIN(created_at) as first, MAX(created_at) as last FROM research_journal
+    `).get();
+        return {
+            total_entries: total,
+            by_type: byType,
+            by_significance: bySignificance,
+            recent_highlights: highlights,
+            date_range: dateRange.first ? { first: dateRange.first, last: dateRange.last } : null,
+        };
+    }
+    /** Get only milestones and breakthroughs. */
+    getMilestones(limit = 10) {
+        return this.db.prepare(`
+      SELECT * FROM research_journal
+      WHERE significance IN ('breakthrough', 'paradigm_shift') OR type = 'milestone'
+      ORDER BY timestamp DESC LIMIT ?
+    `).all(limit).map(r => this.rowToEntry(r));
+    }
+    /** Full-text search across journal entries. */
+    search(query, limit = 20) {
+        try {
+            const ids = this.db.prepare(`
+        SELECT rowid FROM journal_fts WHERE journal_fts MATCH ? LIMIT ?
+      `).all(query, limit);
+            if (ids.length === 0)
+                return [];
+            const placeholders = ids.map(() => '?').join(',');
+            return this.db.prepare(`
+        SELECT * FROM research_journal WHERE id IN (${placeholders})
+        ORDER BY timestamp DESC
+      `).all(...ids.map(i => i.rowid)).map(r => this.rowToEntry(r));
+        }
+        catch {
+            // FTS might fail on invalid query — fallback to LIKE
+            return this.db.prepare(`
+        SELECT * FROM research_journal
+        WHERE title LIKE ? OR content LIKE ?
+        ORDER BY timestamp DESC LIMIT ?
+      `).all(`%${query}%`, `%${query}%`, limit).map(r => this.rowToEntry(r));
+        }
+    }
+    cleanup() {
+        const count = this.db.prepare(`SELECT COUNT(*) as c FROM research_journal`).get().c;
+        if (count > this.config.maxEntries) {
+            // Keep significant entries, delete old routine ones
+            this.db.prepare(`
+        DELETE FROM research_journal WHERE id IN (
+          SELECT id FROM research_journal
+          WHERE significance = 'routine'
+          ORDER BY timestamp ASC LIMIT ?
+        )
+      `).run(count - this.config.maxEntries);
+        }
+    }
+    rowToEntry(row) {
+        return {
+            id: row.id,
+            timestamp: row.timestamp,
+            type: row.type,
+            title: row.title,
+            content: row.content,
+            tags: JSON.parse(row.tags || '[]'),
+            references: JSON.parse(row.ref_ids || '[]'),
+            significance: row.significance,
+            data: JSON.parse(row.data || '{}'),
+            created_at: row.created_at,
+        };
+    }
+}
+//# sourceMappingURL=journal.js.map

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