@timmeck/brain-core 2.4.0 → 2.6.0

package/dist/index.d.ts

@@ -59,9 +59,29 @@ export { ExportService } from './export/service.js';
 export type { ExportOptions, ExportResult } from './export/service.js';
 export { BackupService } from './backup/service.js';
 export type { BackupConfig, BackupRecord, RestoreResult } from './backup/service.js';
+export { AutonomousResearchScheduler, runResearchDiscoveryMigration } from './research/autonomous-scheduler.js';
+export type { ResearchDiscovery, ResearchCycleReport, AutonomousResearchConfig } from './research/autonomous-scheduler.js';
 export { MetaLearningEngine, runMetaLearningMigration } from './meta-learning/engine.js';
 export type { HyperParameter, LearningSnapshot, ParameterRecommendation, MetaLearningStatus } from './meta-learning/engine.js';
 export { CausalGraph, runCausalMigration } from './causal/engine.js';
 export type { CausalEvent, CausalEdge, CausalPath, CausalAnalysis } from './causal/engine.js';
 export { HypothesisEngine, runHypothesisMigration } from './hypothesis/engine.js';
 export type { Hypothesis, HypothesisStatus, HypothesisCondition, HypothesisTestResult, Observation } from './hypothesis/engine.js';
+export { SelfObserver, runSelfObserverMigration } from './research/self-observer.js';
+export type { SelfObservation, SelfInsight, ImprovementSuggestion, SelfObserverConfig, ObservationCategory, InsightType } from './research/self-observer.js';
+export { AdaptiveStrategyEngine, runAdaptiveStrategyMigration } from './research/adaptive-strategy.js';
+export type { StrategyAdaptation, StrategyStatus, StrategyDomain, AdaptiveStrategyConfig } from './research/adaptive-strategy.js';
+export { ExperimentEngine, runExperimentMigration } from './research/experiment-engine.js';
+export type { Experiment, ExperimentConclusion, ExperimentProposal, ExperimentStatus, ExperimentEngineConfig } from './research/experiment-engine.js';
+export { CrossDomainEngine, runCrossDomainMigration } from './research/cross-domain-engine.js';
+export type { CrossDomainCorrelation, CrossDomainEvent, CrossDomainConfig } from './research/cross-domain-engine.js';
+export { CounterfactualEngine, runCounterfactualMigration } from './research/counterfactual-engine.js';
+export type { CounterfactualQuery, CounterfactualResult, InterventionImpact, CounterfactualConfig } from './research/counterfactual-engine.js';
+export { KnowledgeDistiller, runKnowledgeDistillerMigration } from './research/knowledge-distiller.js';
+export type { Principle, AntiPattern, Strategy, KnowledgePackage, KnowledgeEvolution, KnowledgeDistillerConfig } from './research/knowledge-distiller.js';
+export { ResearchAgendaEngine, runAgendaMigration } from './research/agenda-engine.js';
+export type { ResearchAgendaItem, AgendaItemType, AgendaConfig } from './research/agenda-engine.js';
+export { AnomalyDetective, runAnomalyDetectiveMigration } from './research/anomaly-detective.js';
+export type { Anomaly, AnomalyType, AnomalySeverity, DriftReport, AnomalyDetectiveConfig } from './research/anomaly-detective.js';
+export { ResearchJournal, runJournalMigration } from './research/journal.js';
+export type { JournalEntry, JournalEntryType, Significance, JournalSummary, JournalConfig } from './research/journal.js';

package/dist/index.js

@@ -51,10 +51,30 @@ export { WebhookService, runWebhookMigration } from './webhooks/service.js';
 export { ExportService } from './export/service.js';
 // ── Backup ────────────────────────────────────────────────
 export { BackupService } from './backup/service.js';
+// ── Autonomous Research ──────────────────────────────────
+export { AutonomousResearchScheduler, runResearchDiscoveryMigration } from './research/autonomous-scheduler.js';
 // ── Meta-Learning ────────────────────────────────────────
 export { MetaLearningEngine, runMetaLearningMigration } from './meta-learning/engine.js';
 // ── Causal Inference ─────────────────────────────────────
 export { CausalGraph, runCausalMigration } from './causal/engine.js';
 // ── Hypothesis Engine ────────────────────────────────────
 export { HypothesisEngine, runHypothesisMigration } from './hypothesis/engine.js';
+// ── Self-Observer ───────────────────────────────────────
+export { SelfObserver, runSelfObserverMigration } from './research/self-observer.js';
+// ── Adaptive Strategy ──────────────────────────────────
+export { AdaptiveStrategyEngine, runAdaptiveStrategyMigration } from './research/adaptive-strategy.js';
+// ── Experiment Engine ──────────────────────────────────
+export { ExperimentEngine, runExperimentMigration } from './research/experiment-engine.js';
+// ── Cross-Domain Engine ────────────────────────────────
+export { CrossDomainEngine, runCrossDomainMigration } from './research/cross-domain-engine.js';
+// ── Counterfactual Engine ──────────────────────────────
+export { CounterfactualEngine, runCounterfactualMigration } from './research/counterfactual-engine.js';
+// ── Knowledge Distiller ────────────────────────────────
+export { KnowledgeDistiller, runKnowledgeDistillerMigration } from './research/knowledge-distiller.js';
+// ── Research Agenda ────────────────────────────────────
+export { ResearchAgendaEngine, runAgendaMigration } from './research/agenda-engine.js';
+// ── Anomaly Detective ──────────────────────────────────
+export { AnomalyDetective, runAnomalyDetectiveMigration } from './research/anomaly-detective.js';
+// ── Research Journal ───────────────────────────────────
+export { ResearchJournal, runJournalMigration } from './research/journal.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/research/adaptive-strategy.d.ts

@@ -0,0 +1,56 @@
+import type Database from 'better-sqlite3';
+export type StrategyDomain = 'recall' | 'learning' | 'research';
+export interface StrategyAdaptation {
+    id?: number;
+    timestamp: number;
+    strategy: StrategyDomain;
+    parameter: string;
+    old_value: number;
+    new_value: number;
+    reason: string;
+    evidence: Record<string, unknown>;
+    reverted: boolean;
+}
+export interface StrategyStatus {
+    totalAdaptations: number;
+    activeAdaptations: number;
+    revertedAdaptations: number;
+    revertRate: number;
+    strategies: Record<StrategyDomain, StrategyDomainStatus>;
+}
+export interface StrategyDomainStatus {
+    parameters: Record<string, number>;
+    recentChanges: number;
+    lastChange?: string;
+}
+export interface AdaptiveStrategyConfig {
+    brainName: string;
+    /** Maximum percentage change per adaptation (0-1). Default: 0.2 (20%) */
+    maxChangeRate?: number;
+    /** Cycles to observe before evaluating an adaptation. Default: 5 */
+    observationCycles?: number;
+    /** Performance drop threshold for auto-revert (0-1). Default: 0.1 (10%) */
+    revertThreshold?: number;
+}
+export declare function runAdaptiveStrategyMigration(db: Database.Database): void;
+export declare class AdaptiveStrategyEngine {
+    private db;
+    private config;
+    private log;
+    constructor(db: Database.Database, config: AdaptiveStrategyConfig);
+    /** Get current status of all strategies. */
+    getStatus(): StrategyStatus;
+    /** Get a parameter value. */
+    getParam(strategy: StrategyDomain, parameter: string): number | null;
+    /** Adapt a strategy parameter based on evidence. Applies stability guard. */
+    adapt(strategy: StrategyDomain, parameter: string, newValue: number, reason: string, evidence: Record<string, unknown>): StrategyAdaptation | null;
+    /** Check recent adaptations and revert if performance dropped. */
+    checkAndRevert(currentPerformance: number): StrategyAdaptation[];
+    /** Manually revert an adaptation. */
+    revert(adaptationId: number, reason?: string): boolean;
+    /** Get adaptation history. */
+    getAdaptations(strategy?: StrategyDomain, limit?: number): StrategyAdaptation[];
+    /** Record performance score for the most recent adaptation. */
+    recordPerformance(adaptationId: number, performance: number, phase: 'before' | 'after'): void;
+    private initializeDefaults;
+}

package/dist/research/adaptive-strategy.js

@@ -0,0 +1,236 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runAdaptiveStrategyMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS strategy_adaptations (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      timestamp INTEGER NOT NULL,
+      strategy TEXT NOT NULL,
+      parameter TEXT NOT NULL,
+      old_value REAL NOT NULL,
+      new_value REAL NOT NULL,
+      reason TEXT NOT NULL,
+      evidence TEXT NOT NULL,
+      reverted INTEGER DEFAULT 0,
+      revert_reason TEXT,
+      performance_before REAL,
+      performance_after REAL,
+      created_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_strat_adapt_strategy ON strategy_adaptations(strategy);
+    CREATE INDEX IF NOT EXISTS idx_strat_adapt_param ON strategy_adaptations(parameter);
+
+    CREATE TABLE IF NOT EXISTS strategy_parameters (
+      strategy TEXT NOT NULL,
+      parameter TEXT NOT NULL,
+      value REAL NOT NULL,
+      min_value REAL NOT NULL,
+      max_value REAL NOT NULL,
+      updated_at TEXT DEFAULT (datetime('now')),
+      PRIMARY KEY (strategy, parameter)
+    );
+  `);
+}
+// ── Engine ──────────────────────────────────────────────
+const DEFAULT_PARAMS = {
+    recall: {
+        fts_weight: { value: 0.5, min: 0.0, max: 1.0 },
+        semantic_weight: { value: 0.5, min: 0.0, max: 1.0 },
+        time_window_hours: { value: 168, min: 1, max: 720 },
+        min_match_score: { value: 0.3, min: 0.05, max: 0.9 },
+    },
+    learning: {
+        min_sample_size: { value: 5, min: 2, max: 50 },
+        synapse_decay_rate: { value: 0.05, min: 0.001, max: 0.3 },
+        confidence_threshold: { value: 0.6, min: 0.3, max: 0.95 },
+        learning_interval_ms: { value: 1_800_000, min: 60_000, max: 7_200_000 },
+    },
+    research: {
+        hypothesis_min_confidence: { value: 0.5, min: 0.1, max: 0.9 },
+        causal_min_strength: { value: 0.3, min: 0.05, max: 0.8 },
+        meta_step_size: { value: 0.1, min: 0.01, max: 0.5 },
+        research_interval_ms: { value: 600_000, min: 60_000, max: 3_600_000 },
+    },
+};
+export class AdaptiveStrategyEngine {
+    db;
+    config;
+    log = getLogger();
+    constructor(db, config) {
+        this.db = db;
+        this.config = {
+            brainName: config.brainName,
+            maxChangeRate: config.maxChangeRate ?? 0.2,
+            observationCycles: config.observationCycles ?? 5,
+            revertThreshold: config.revertThreshold ?? 0.1,
+        };
+        runAdaptiveStrategyMigration(db);
+        this.initializeDefaults();
+    }
+    /** Get current status of all strategies. */
+    getStatus() {
+        const total = this.db.prepare(`SELECT COUNT(*) as c FROM strategy_adaptations`).get().c;
+        const reverted = this.db.prepare(`SELECT COUNT(*) as c FROM strategy_adaptations WHERE reverted = 1`).get().c;
+        const strategies = {};
+        for (const domain of ['recall', 'learning', 'research']) {
+            const params = this.db.prepare(`
+        SELECT parameter, value FROM strategy_parameters WHERE strategy = ?
+      `).all(domain);
+            const recentChanges = this.db.prepare(`
+        SELECT COUNT(*) as c FROM strategy_adaptations
+        WHERE strategy = ? AND timestamp > ?
+      `).get(domain, Date.now() - 86_400_000).c;
+            const lastChange = this.db.prepare(`
+        SELECT created_at FROM strategy_adaptations
+        WHERE strategy = ? ORDER BY timestamp DESC LIMIT 1
+      `).get(domain);
+            strategies[domain] = {
+                parameters: Object.fromEntries(params.map(p => [p.parameter, p.value])),
+                recentChanges,
+                lastChange: lastChange?.created_at,
+            };
+        }
+        return {
+            totalAdaptations: total,
+            activeAdaptations: total - reverted,
+            revertedAdaptations: reverted,
+            revertRate: total > 0 ? reverted / total : 0,
+            strategies,
+        };
+    }
+    /** Get a parameter value. */
+    getParam(strategy, parameter) {
+        const row = this.db.prepare(`
+      SELECT value FROM strategy_parameters WHERE strategy = ? AND parameter = ?
+    `).get(strategy, parameter);
+        return row?.value ?? null;
+    }
+    /** Adapt a strategy parameter based on evidence. Applies stability guard. */
+    adapt(strategy, parameter, newValue, reason, evidence) {
+        const current = this.db.prepare(`
+      SELECT value, min_value, max_value FROM strategy_parameters
+      WHERE strategy = ? AND parameter = ?
+    `).get(strategy, parameter);
+        if (!current) {
+            this.log.warn(`Unknown parameter: ${strategy}.${parameter}`);
+            return null;
+        }
+        // Stability guard: limit change to maxChangeRate
+        const maxDelta = Math.abs(current.value) * this.config.maxChangeRate;
+        const delta = newValue - current.value;
+        const clampedDelta = Math.max(-maxDelta, Math.min(maxDelta, delta));
+        let finalValue = current.value + clampedDelta;
+        // Enforce bounds
+        finalValue = Math.max(current.min_value, Math.min(current.max_value, finalValue));
+        if (Math.abs(finalValue - current.value) < 1e-10)
+            return null; // No effective change
+        const timestamp = Date.now();
+        this.db.prepare(`
+      INSERT INTO strategy_adaptations (timestamp, strategy, parameter, old_value, new_value, reason, evidence)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(timestamp, strategy, parameter, current.value, finalValue, reason, JSON.stringify(evidence));
+        this.db.prepare(`
+      UPDATE strategy_parameters SET value = ?, updated_at = datetime('now')
+      WHERE strategy = ? AND parameter = ?
+    `).run(finalValue, strategy, parameter);
+        return {
+            timestamp,
+            strategy,
+            parameter,
+            old_value: current.value,
+            new_value: finalValue,
+            reason,
+            evidence,
+            reverted: false,
+        };
+    }
+    /** Check recent adaptations and revert if performance dropped. */
+    checkAndRevert(currentPerformance) {
+        const recentUnreverted = this.db.prepare(`
+      SELECT * FROM strategy_adaptations
+      WHERE reverted = 0 AND performance_before IS NOT NULL
+      AND timestamp > ?
+      ORDER BY timestamp DESC
+    `).all(Date.now() - 86_400_000 * 7);
+        const reverted = [];
+        for (const row of recentUnreverted) {
+            const perfBefore = row.performance_before;
+            if (currentPerformance < perfBefore * (1 - this.config.revertThreshold)) {
+                // Performance dropped — revert
+                this.revert(row.id, `Performance dropped from ${perfBefore.toFixed(3)} to ${currentPerformance.toFixed(3)}`);
+                reverted.push({
+                    id: row.id,
+                    timestamp: row.timestamp,
+                    strategy: row.strategy,
+                    parameter: row.parameter,
+                    old_value: row.old_value,
+                    new_value: row.new_value,
+                    reason: row.reason,
+                    evidence: JSON.parse(row.evidence),
+                    reverted: true,
+                });
+            }
+        }
+        return reverted;
+    }
+    /** Manually revert an adaptation. */
+    revert(adaptationId, reason) {
+        const row = this.db.prepare(`
+      SELECT * FROM strategy_adaptations WHERE id = ? AND reverted = 0
+    `).get(adaptationId);
+        if (!row)
+            return false;
+        // Restore old value
+        this.db.prepare(`
+      UPDATE strategy_parameters SET value = ?, updated_at = datetime('now')
+      WHERE strategy = ? AND parameter = ?
+    `).run(row.old_value, row.strategy, row.parameter);
+        // Mark as reverted
+        this.db.prepare(`
+      UPDATE strategy_adaptations SET reverted = 1, revert_reason = ?
+      WHERE id = ?
+    `).run(reason ?? 'Manual revert', adaptationId);
+        return true;
+    }
+    /** Get adaptation history. */
+    getAdaptations(strategy, limit = 20) {
+        let sql = `SELECT * FROM strategy_adaptations`;
+        const params = [];
+        if (strategy) {
+            sql += ` WHERE strategy = ?`;
+            params.push(strategy);
+        }
+        sql += ` ORDER BY timestamp DESC LIMIT ?`;
+        params.push(limit);
+        return this.db.prepare(sql).all(...params).map(row => ({
+            id: row.id,
+            timestamp: row.timestamp,
+            strategy: row.strategy,
+            parameter: row.parameter,
+            old_value: row.old_value,
+            new_value: row.new_value,
+            reason: row.reason,
+            evidence: JSON.parse(row.evidence),
+            reverted: row.reverted === 1,
+        }));
+    }
+    /** Record performance score for the most recent adaptation. */
+    recordPerformance(adaptationId, performance, phase) {
+        const col = phase === 'before' ? 'performance_before' : 'performance_after';
+        this.db.prepare(`
+      UPDATE strategy_adaptations SET ${col} = ? WHERE id = ?
+    `).run(performance, adaptationId);
+    }
+    initializeDefaults() {
+        const insert = this.db.prepare(`
+      INSERT OR IGNORE INTO strategy_parameters (strategy, parameter, value, min_value, max_value)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        for (const [strategy, params] of Object.entries(DEFAULT_PARAMS)) {
+            for (const [param, def] of Object.entries(params)) {
+                insert.run(strategy, param, def.value, def.min, def.max);
+            }
+        }
+    }
+}
+//# sourceMappingURL=adaptive-strategy.js.map

package/dist/research/adaptive-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-strategy.js","sourceRoot":"","sources":["../../src/research/adaptive-strategy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA0C/C,2DAA2D;AAE3D,MAAM,UAAU,4BAA4B,CAAC,EAAqB;IAChE,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BP,CAAC,CAAC;AACL,CAAC;AAED,2DAA2D;AAE3D,MAAM,cAAc,GAAwF;IAC1G,MAAM,EAAE;QACN,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;QAC9C,eAAe,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;QACnD,iBAAiB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;QACnD,eAAe,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE;KACrD;IACD,QAAQ,EAAE;QACR,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QAC9C,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;QACzD,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE;QACzD,oBAAoB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE;KACxE;IACD,QAAQ,EAAE;QACR,yBAAyB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;QAC7D,mBAAmB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE;QACxD,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE;QACnD,oBAAoB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE;KACtE;CACF,CAAC;AAEF,MAAM,OAAO,sBAAsB;IACzB,EAAE,CAAoB;IACtB,MAAM,CAAmC;IACzC,GAAG,GAAG,SAAS,EAAE,CAAC;IAE1B,YAAY,EAAqB,EAAE,MAA8B;QAC/D,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG;YACZ,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,GAAG;YAC1C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,CAAC;YAChD,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,GAAG;SAC/C,CAAC;QACF,4BAA4B,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAED,4CAA4C;IAC5C,SAAS;QACP,MAAM,KAAK,GAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;QAC3G,MAAM,QAAQ,GAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,mEAAmE,CAAC,CAAC,GAAG,EAAoB,CAAC,CAAC,CAAC;QAEjI,MAAM,UAAU,GAAG,EAAkD,CAAC;QACtE,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAqB,EAAE,CAAC;YAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;OAE9B,CAAC,CAAC,GAAG,CAAC,MAAM,CAAgD,CAAC;YAE9D,MAAM,aAAa,GAAI,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;OAGtC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAmB,CAAC,CAAC,CAAC;YAE5D,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;OAGlC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAuC,CAAC;YAErD,UAAU,CAAC,MAAM,CAAC,GAAG;gBACnB,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBACvE,aAAa;gBACb,UAAU,EAAE,UAAU,EAAE,UAAU;aACnC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,gBAAgB,EAAE,KAAK;YACvB,iBAAiB,EAAE,KAAK,GAAG,QAAQ;YACnC,mBAAmB,EAAE,QAAQ;YAC7B,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5C,UAAU;SACX,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,QAAQ,CAAC,QAAwB,EAAE,SAAiB;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;KAE3B,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAkC,CAAC;QAC7D,OAAO,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC;IAC5B,CAAC;IAED,6EAA6E;IAC7E,KAAK,CACH,QAAwB,EACxB,SAAiB,EACjB,QAAgB,EAChB,MAAc,EACd,QAAiC;QAEjC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;KAG/B,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAwE,CAAC;QAEnG,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,QAAQ,IAAI,SAAS,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,iDAAiD;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;QACrE,MAAM,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QACpE,IAAI,UAAU,GAAG,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC;QAE9C,iBAAiB;QACjB,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;QAElF,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK;YAAE,OAAO,IAAI,CAAC,CAAC,sBAAsB;QAErF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;KAGf,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEpG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;KAGf,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAExC,OAAO;YACL,SAAS;YACT,QAAQ;YACR,SAAS;YACT,SAAS,EAAE,OAAO,CAAC,KAAK;YACxB,SAAS,EAAE,UAAU;YACrB,MAAM;YACN,QAAQ;YACR,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAED,kEAAkE;IAClE,cAAc,CAAC,kBAA0B;QACvC,MAAM,gBAAgB,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;KAKxC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,CAAC,CAAmC,CAAC;QAEtE,MAAM,QAAQ,GAAyB,EAAE,CAAC;QAE1C,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,GAAG,CAAC,kBAA4B,CAAC;YACpD,IAAI,kBAAkB,GAAG,UAAU,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;gBACxE,+BAA+B;gBAC/B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAY,EAAE,4BAA4B,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACvH,QAAQ,CAAC,IAAI,CAAC;oBACZ,EAAE,EAAE,GAAG,CAAC,EAAY;oBACpB,SAAS,EAAE,GAAG,CAAC,SAAmB;oBAClC,QAAQ,EAAE,GAAG,CAAC,QAA0B;oBACxC,SAAS,EAAE,GAAG,CAAC,SAAmB;oBAClC,SAAS,EAAE,GAAG,CAAC,SAAmB;oBAClC,SAAS,EAAE,GAAG,CAAC,SAAmB;oBAClC,MAAM,EAAE,GAAG,CAAC,MAAgB;oBAC5B,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAkB,CAAC;oBAC5C,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qCAAqC;IACrC,MAAM,CAAC,YAAoB,EAAE,MAAe;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;KAE3B,CAAC,CAAC,GAAG,CAAC,YAAY,CAAwC,CAAC;QAE5D,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QAEvB,oBAAoB;QACpB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;KAGf,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QAEnD,mBAAmB;QACnB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;KAGf,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,eAAe,EAAE,YAAY,CAAC,CAAC;QAEhD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8BAA8B;IAC9B,cAAc,CAAC,QAAyB,EAAE,KAAK,GAAG,EAAE;QAClD,IAAI,GAAG,GAAG,oCAAoC,CAAC;QAC/C,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,QAAQ,EAAE,CAAC;YACb,GAAG,IAAI,qBAAqB,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QACD,GAAG,IAAI,kCAAkC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEnB,OAAQ,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAoC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzF,EAAE,EAAE,GAAG,CAAC,EAAY;YACpB,SAAS,EAAE,GAAG,CAAC,SAAmB;YAClC,QAAQ,EAAE,GAAG,CAAC,QAA0B;YACxC,SAAS,EAAE,GAAG,CAAC,SAAmB;YAClC,SAAS,EAAE,GAAG,CAAC,SAAmB;YAClC,SAAS,EAAE,GAAG,CAAC,SAAmB;YAClC,MAAM,EAAE,GAAG,CAAC,MAAgB;YAC5B,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAkB,CAAC;YAC5C,QAAQ,EAAG,GAAG,CAAC,QAAmB,KAAK,CAAC;SACzC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,+DAA+D;IAC/D,iBAAiB,CAAC,YAAoB,EAAE,WAAmB,EAAE,KAAyB;QACpF,MAAM,GAAG,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,mBAAmB,CAAC;QAC5E,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;wCACoB,GAAG;KACtC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACpC,CAAC;IAEO,kBAAkB;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;KAG9B,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAChE,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/research/agenda-engine.d.ts

@@ -0,0 +1,46 @@
+import type Database from 'better-sqlite3';
+export type AgendaItemType = 'hypothesis_test' | 'correlation_search' | 'parameter_sweep' | 'knowledge_gap' | 'anomaly_investigation';
+export interface ResearchAgendaItem {
+    id?: number;
+    priority: number;
+    question: string;
+    type: AgendaItemType;
+    estimated_cycles: number;
+    expected_impact: string;
+    prerequisites: string[];
+    auto_executable: boolean;
+    status: 'open' | 'in_progress' | 'completed' | 'dismissed';
+    created_at?: string;
+}
+export interface AgendaConfig {
+    brainName: string;
+    /** Maximum agenda items. Default: 50 */
+    maxItems?: number;
+}
+export declare function runAgendaMigration(db: Database.Database): void;
+export declare class ResearchAgendaEngine {
+    private db;
+    private config;
+    private log;
+    constructor(db: Database.Database, config: AgendaConfig);
+    /** Generate research agenda from current state of knowledge. */
+    generate(): ResearchAgendaItem[];
+    /** Get the prioritized research agenda. */
+    getAgenda(limit?: number): ResearchAgendaItem[];
+    /** Get the single most important next research question. */
+    getNext(): ResearchAgendaItem | null;
+    /** Reprioritize an agenda item. */
+    setPriority(id: number, priority: number): boolean;
+    /** Add a user-defined research question. */
+    ask(question: string, type?: AgendaItemType): ResearchAgendaItem;
+    /** Mark an item as completed or dismissed. */
+    resolve(id: number, status: 'completed' | 'dismissed'): boolean;
+    private getById;
+    private findOpenHypotheses;
+    private findKnowledgeGaps;
+    private findUnexploredCorrelations;
+    private findOpenAnomalies;
+    private findParameterSweeps;
+    private upsertItem;
+    private rowToItem;
+}