@timmeck/brain-core 2.5.0 → 2.7.0

package/dist/research/experiment-engine.js

@@ -0,0 +1,328 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runExperimentMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS experiments (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      name TEXT NOT NULL,
+      hypothesis TEXT NOT NULL,
+      independent_variable TEXT NOT NULL,
+      dependent_variable TEXT NOT NULL,
+      control_value REAL NOT NULL,
+      treatment_value REAL NOT NULL,
+      duration_cycles INTEGER NOT NULL,
+      status TEXT NOT NULL DEFAULT 'planned',
+      control_results TEXT NOT NULL DEFAULT '[]',
+      treatment_results TEXT NOT NULL DEFAULT '[]',
+      current_cycle INTEGER NOT NULL DEFAULT 0,
+      conclusion TEXT,
+      created_at TEXT DEFAULT (datetime('now')),
+      completed_at TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_experiments_status ON experiments(status);
+  `);
+}
+// ── Statistics ──────────────────────────────────────────
+function mean(arr) {
+    if (arr.length === 0)
+        return 0;
+    return arr.reduce((a, b) => a + b, 0) / arr.length;
+}
+function stddev(arr) {
+    if (arr.length < 2)
+        return 0;
+    const m = mean(arr);
+    const variance = arr.reduce((sum, x) => sum + (x - m) ** 2, 0) / (arr.length - 1);
+    return Math.sqrt(variance);
+}
+/** Welch's t-test for two independent samples with unequal variances. */
+function welchTTest(a, b) {
+    const nA = a.length;
+    const nB = b.length;
+    if (nA < 2 || nB < 2)
+        return { t: 0, df: 0, pValue: 1 };
+    const meanA = mean(a);
+    const meanB = mean(b);
+    const varA = stddev(a) ** 2;
+    const varB = stddev(b) ** 2;
+    const se = Math.sqrt(varA / nA + varB / nB);
+    if (se === 0)
+        return { t: 0, df: nA + nB - 2, pValue: 1 };
+    const t = (meanA - meanB) / se;
+    // Welch–Satterthwaite degrees of freedom
+    const num = (varA / nA + varB / nB) ** 2;
+    const den = (varA / nA) ** 2 / (nA - 1) + (varB / nB) ** 2 / (nB - 1);
+    const df = den === 0 ? nA + nB - 2 : num / den;
+    // Approximate two-tailed p-value using t-distribution approximation
+    const pValue = approxTwoTailedP(Math.abs(t), df);
+    return { t, df, pValue };
+}
+/** Approximate two-tailed p-value for t-distribution. Uses normal approximation for large df. */
+function approxTwoTailedP(t, df) {
+    if (df <= 0)
+        return 1;
+    // For large df, t ≈ normal
+    if (df > 100) {
+        return 2 * normalCDF(-Math.abs(t));
+    }
+    // Incomplete beta function approximation for Student's t
+    const x = df / (df + t * t);
+    const a = df / 2;
+    const b = 0.5;
+    return incompleteBetaApprox(x, a, b);
+}
+/** Standard normal CDF approximation (Abramowitz and Stegun). */
+function normalCDF(x) {
+    const a1 = 0.254829592;
+    const a2 = -0.284496736;
+    const a3 = 1.421413741;
+    const a4 = -1.453152027;
+    const a5 = 1.061405429;
+    const p = 0.3275911;
+    const sign = x < 0 ? -1 : 1;
+    const absX = Math.abs(x);
+    const t = 1.0 / (1.0 + p * absX);
+    const y = 1.0 - ((((a5 * t + a4) * t + a3) * t + a2) * t + a1) * t * Math.exp(-absX * absX / 2);
+    return 0.5 * (1.0 + sign * y);
+}
+/** Rough approximation of the regularized incomplete beta function. */
+function incompleteBetaApprox(x, a, b) {
+    // Use a continued fraction approximation (Lentz's method, simplified)
+    if (x <= 0)
+        return 0;
+    if (x >= 1)
+        return 1;
+    // For our purposes (t-test p-values), use a simpler approximation
+    // Convert to normal approximation: t → z
+    const z = Math.sqrt(-2 * Math.log(x)) * Math.sqrt(a);
+    return Math.min(1, Math.max(0, 2 * normalCDF(-z)));
+}
+/** Cohen's d effect size. */
+function cohensD(a, b) {
+    const pooledStd = Math.sqrt(((a.length - 1) * stddev(a) ** 2 + (b.length - 1) * stddev(b) ** 2) /
+        (a.length + b.length - 2));
+    if (pooledStd === 0)
+        return 0;
+    return (mean(a) - mean(b)) / pooledStd;
+}
+/** Minimum sample size for power 0.8, two-tailed. Simplified. */
+function minimumSampleSize(effectSize, alpha = 0.05) {
+    if (effectSize <= 0)
+        return 100;
+    // Approximate: n ≈ 16/d² for power=0.8, alpha=0.05
+    const zAlpha = alpha === 0.05 ? 1.96 : 2.576;
+    const zBeta = 0.842; // power 0.8
+    const n = Math.ceil(2 * ((zAlpha + zBeta) / effectSize) ** 2);
+    return Math.max(5, Math.min(n, 1000));
+}
+// ── Engine ──────────────────────────────────────────────
+export class ExperimentEngine {
+    db;
+    config;
+    log = getLogger();
+    constructor(db, config) {
+        this.db = db;
+        this.config = {
+            brainName: config.brainName,
+            defaultDuration: config.defaultDuration ?? 10,
+            alpha: config.alpha ?? 0.05,
+            maxConcurrent: config.maxConcurrent ?? 3,
+        };
+        runExperimentMigration(db);
+    }
+    /** Propose a new experiment. */
+    propose(proposal) {
+        const running = this.getRunning().length;
+        if (running >= this.config.maxConcurrent) {
+            throw new Error(`Maximum ${this.config.maxConcurrent} concurrent experiments. ${running} currently running.`);
+        }
+        const duration = proposal.duration_cycles ?? this.config.defaultDuration;
+        const result = this.db.prepare(`
+      INSERT INTO experiments (name, hypothesis, independent_variable, dependent_variable,
+        control_value, treatment_value, duration_cycles, status)
+      VALUES (?, ?, ?, ?, ?, ?, ?, 'planned')
+    `).run(proposal.name, proposal.hypothesis, proposal.independent_variable, proposal.dependent_variable, proposal.control_value, proposal.treatment_value, duration);
+        return this.get(Number(result.lastInsertRowid));
+    }
+    /** Start an experiment (transitions from planned to running_control). */
+    start(experimentId) {
+        const exp = this.get(experimentId);
+        if (!exp || exp.status !== 'planned')
+            return null;
+        this.db.prepare(`UPDATE experiments SET status = 'running_control' WHERE id = ?`).run(experimentId);
+        return this.get(experimentId);
+    }
+    /** Record a measurement for the current phase of an experiment. */
+    recordMeasurement(experimentId, value) {
+        const exp = this.get(experimentId);
+        if (!exp)
+            return null;
+        if (exp.status === 'running_control') {
+            exp.control_results.push(value);
+            this.db.prepare(`
+        UPDATE experiments SET control_results = ?, current_cycle = ?
+        WHERE id = ?
+      `).run(JSON.stringify(exp.control_results), exp.current_cycle + 1, experimentId);
+            // Check if control phase complete
+            if (exp.control_results.length >= exp.duration_cycles) {
+                this.db.prepare(`UPDATE experiments SET status = 'running_treatment', current_cycle = 0 WHERE id = ?`).run(experimentId);
+            }
+        }
+        else if (exp.status === 'running_treatment') {
+            exp.treatment_results.push(value);
+            this.db.prepare(`
+        UPDATE experiments SET treatment_results = ?, current_cycle = ?
+        WHERE id = ?
+      `).run(JSON.stringify(exp.treatment_results), exp.current_cycle + 1, experimentId);
+            // Check if treatment phase complete
+            if (exp.treatment_results.length >= exp.duration_cycles) {
+                this.db.prepare(`UPDATE experiments SET status = 'analyzing' WHERE id = ?`).run(experimentId);
+                return this.analyze(experimentId);
+            }
+        }
+        return this.get(experimentId);
+    }
+    /** Analyze a completed experiment. */
+    analyze(experimentId) {
+        const exp = this.get(experimentId);
+        if (!exp || (exp.status !== 'analyzing' && exp.status !== 'complete'))
+            return null;
+        const control = exp.control_results;
+        const treatment = exp.treatment_results;
+        if (control.length < 2 || treatment.length < 2) {
+            const conclusion = {
+                significant: false,
+                p_value: 1,
+                effect_size: 0,
+                direction: 'neutral',
+                recommendation: 'inconclusive_extend',
+                control_mean: mean(control),
+                treatment_mean: mean(treatment),
+                control_std: stddev(control),
+                treatment_std: stddev(treatment),
+            };
+            this.completeExperiment(experimentId, conclusion);
+            return this.get(experimentId);
+        }
+        // Welch's t-test
+        const test = welchTTest(treatment, control);
+        // Apply Bonferroni correction if multiple experiments running
+        const runningCount = Math.max(1, this.getRunning().length + 1);
+        const correctedAlpha = this.config.alpha / runningCount;
+        const significant = test.pValue < correctedAlpha;
+        // Cohen's d
+        const d = cohensD(treatment, control);
+        // Direction
+        const treatmentMean = mean(treatment);
+        const controlMean = mean(control);
+        let direction;
+        if (!significant)
+            direction = 'neutral';
+        else if (treatmentMean > controlMean)
+            direction = 'positive';
+        else
+            direction = 'negative';
+        // Recommendation
+        let recommendation;
+        if (!significant) {
+            recommendation = 'inconclusive_extend';
+        }
+        else if (direction === 'positive') {
+            recommendation = 'adopt_treatment';
+        }
+        else {
+            recommendation = 'keep_control';
+        }
+        const conclusion = {
+            significant,
+            p_value: test.pValue,
+            effect_size: Math.abs(d),
+            direction,
+            recommendation,
+            control_mean: controlMean,
+            treatment_mean: treatmentMean,
+            control_std: stddev(control),
+            treatment_std: stddev(treatment),
+        };
+        this.completeExperiment(experimentId, conclusion);
+        return this.get(experimentId);
+    }
+    /** Abort a running experiment. */
+    abort(experimentId) {
+        const exp = this.get(experimentId);
+        if (!exp || exp.status === 'complete' || exp.status === 'aborted')
+            return false;
+        this.db.prepare(`
+      UPDATE experiments SET status = 'aborted', completed_at = datetime('now') WHERE id = ?
+    `).run(experimentId);
+        return true;
+    }
+    /** Get a single experiment by ID. */
+    get(id) {
+        const row = this.db.prepare(`SELECT * FROM experiments WHERE id = ?`).get(id);
+        if (!row)
+            return null;
+        return this.rowToExperiment(row);
+    }
+    /** List experiments by status. */
+    list(status, limit = 20) {
+        let sql = `SELECT * FROM experiments`;
+        const params = [];
+        if (status) {
+            sql += ` WHERE status = ?`;
+            params.push(status);
+        }
+        sql += ` ORDER BY CASE status
+      WHEN 'running_control' THEN 0
+      WHEN 'running_treatment' THEN 1
+      WHEN 'analyzing' THEN 2
+      WHEN 'planned' THEN 3
+      WHEN 'complete' THEN 4
+      WHEN 'aborted' THEN 5
+    END, id DESC LIMIT ?`;
+        params.push(limit);
+        return this.db.prepare(sql).all(...params).map(r => this.rowToExperiment(r));
+    }
+    /** Get currently running experiments. */
+    getRunning() {
+        return this.db.prepare(`
+      SELECT * FROM experiments WHERE status IN ('running_control', 'running_treatment')
+    `).all().map(r => this.rowToExperiment(r));
+    }
+    /** Get results of completed experiments. */
+    getResults(limit = 10) {
+        return this.db.prepare(`
+      SELECT * FROM experiments WHERE status = 'complete' ORDER BY completed_at DESC LIMIT ?
+    `).all(limit).map(r => this.rowToExperiment(r));
+    }
+    /** Calculate minimum required sample size for a desired effect size. */
+    getMinimumSampleSize(expectedEffectSize) {
+        return minimumSampleSize(expectedEffectSize, this.config.alpha);
+    }
+    completeExperiment(id, conclusion) {
+        this.db.prepare(`
+      UPDATE experiments SET status = 'complete', conclusion = ?, completed_at = datetime('now')
+      WHERE id = ?
+    `).run(JSON.stringify(conclusion), id);
+    }
+    rowToExperiment(row) {
+        return {
+            id: row.id,
+            name: row.name,
+            hypothesis: row.hypothesis,
+            independent_variable: row.independent_variable,
+            dependent_variable: row.dependent_variable,
+            control_value: row.control_value,
+            treatment_value: row.treatment_value,
+            duration_cycles: row.duration_cycles,
+            status: row.status,
+            control_results: JSON.parse(row.control_results || '[]'),
+            treatment_results: JSON.parse(row.treatment_results || '[]'),
+            current_cycle: row.current_cycle,
+            conclusion: row.conclusion ? JSON.parse(row.conclusion) : null,
+            created_at: row.created_at,
+            completed_at: row.completed_at,
+        };
+    }
+}
+//# sourceMappingURL=experiment-engine.js.map

package/dist/research/experiment-engine.js.map

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

package/dist/research/journal.d.ts

@@ -0,0 +1,62 @@
+import type Database from 'better-sqlite3';
+export type JournalEntryType = 'discovery' | 'experiment' | 'anomaly' | 'adaptation' | 'insight' | 'reflection' | 'milestone';
+export type Significance = 'routine' | 'notable' | 'breakthrough' | 'paradigm_shift';
+export interface JournalEntry {
+    id?: number;
+    timestamp: number;
+    type: JournalEntryType;
+    title: string;
+    content: string;
+    tags: string[];
+    references: string[];
+    significance: Significance;
+    data: Record<string, unknown>;
+    created_at?: string;
+}
+export interface JournalSummary {
+    total_entries: number;
+    by_type: Record<string, number>;
+    by_significance: Record<string, number>;
+    recent_highlights: JournalEntry[];
+    date_range: {
+        first: string;
+        last: string;
+    } | null;
+}
+export interface JournalConfig {
+    brainName: string;
+    /** Auto-reflect every N cycles. Default: 10 */
+    reflectionInterval?: number;
+    /** Maximum journal entries before cleanup. Default: 10000 */
+    maxEntries?: number;
+}
+export declare function runJournalMigration(db: Database.Database): void;
+export declare class ResearchJournal {
+    private db;
+    private config;
+    private cyclesSinceReflection;
+    private log;
+    constructor(db: Database.Database, config: JournalConfig);
+    /** Write a journal entry. */
+    write(entry: Omit<JournalEntry, 'id' | 'timestamp' | 'created_at'>): JournalEntry;
+    /** Record a discovery in the journal. */
+    recordDiscovery(title: string, description: string, data: Record<string, unknown>, significance?: Significance): JournalEntry;
+    /** Record an experiment result. */
+    recordExperiment(name: string, result: string, data: Record<string, unknown>, significant: boolean): JournalEntry;
+    /** Record an anomaly. */
+    recordAnomaly(title: string, description: string, severity: string, data: Record<string, unknown>): JournalEntry;
+    /** Record a strategy adaptation. */
+    recordAdaptation(parameter: string, oldValue: number, newValue: number, reason: string): JournalEntry;
+    /** Generate automatic reflection based on recent entries. */
+    reflect(): JournalEntry | null;
+    /** Get journal entries, optionally filtered. */
+    getEntries(type?: JournalEntryType, limit?: number): JournalEntry[];
+    /** Get summary of journal contents. */
+    getSummary(limit?: number): JournalSummary;
+    /** Get only milestones and breakthroughs. */
+    getMilestones(limit?: number): JournalEntry[];
+    /** Full-text search across journal entries. */
+    search(query: string, limit?: number): JournalEntry[];
+    private cleanup;
+    private rowToEntry;
+}

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