@timmeck/brain-core 2.25.1 → 2.27.0

package/dist/metacognition/teach-engine.d.ts

@@ -0,0 +1,63 @@
+import type Database from 'better-sqlite3';
+import type { ThoughtStream } from '../consciousness/thought-stream.js';
+import type { KnowledgeDistiller } from '../research/knowledge-distiller.js';
+import type { HypothesisEngine } from '../hypothesis/engine.js';
+import type { ResearchJournal } from '../research/journal.js';
+export interface TeachingPackage {
+    id?: number;
+    targetBrain: string;
+    principles: Array<{
+        statement: string;
+        confidence: number;
+    }>;
+    antiPatterns: Array<{
+        statement: string;
+        confidence: number;
+    }>;
+    strategies: Array<{
+        id: string;
+        description: string;
+    }>;
+    experiments: Array<{
+        name: string;
+        hypothesis: string;
+        conclusion: string;
+    }>;
+    journalInsights: string[];
+    principlesCount: number;
+    antipatternsCount: number;
+    strategiesCount: number;
+    experimentsCount: number;
+    createdAt: string;
+    effectivenessScore: number | null;
+}
+export interface TeachEngineStatus {
+    totalPackages: number;
+    avgEffectiveness: number;
+    recentPackages: TeachingPackage[];
+}
+export declare function runTeachEngineMigration(db: Database.Database): void;
+export declare class TeachEngine {
+    private db;
+    private log;
+    private thoughtStream;
+    private distiller;
+    private hypothesisEngine;
+    private journal;
+    constructor(db: Database.Database);
+    setThoughtStream(stream: ThoughtStream): void;
+    setKnowledgeDistiller(distiller: KnowledgeDistiller): void;
+    setHypothesisEngine(engine: HypothesisEngine): void;
+    setJournal(journal: ResearchJournal): void;
+    /** Create a teaching package for another brain. */
+    createPackage(targetBrain: string): TeachingPackage;
+    /** Get a teaching package by id. */
+    getPackage(id: number): TeachingPackage | null;
+    /** List recent teaching packages. */
+    listPackages(limit?: number): TeachingPackage[];
+    /** Rate the effectiveness of a teaching package. */
+    rateEffectiveness(id: number, score: number): void;
+    /** Get status summary. */
+    getStatus(): TeachEngineStatus;
+    private toTeachingPackage;
+}

package/dist/metacognition/teach-engine.js

@@ -0,0 +1,185 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runTeachEngineMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS teaching_packages (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      target_brain TEXT NOT NULL,
+      package_json TEXT NOT NULL DEFAULT '{}',
+      principles_count INTEGER NOT NULL DEFAULT 0,
+      antipatterns_count INTEGER NOT NULL DEFAULT 0,
+      strategies_count INTEGER NOT NULL DEFAULT 0,
+      experiments_count INTEGER NOT NULL DEFAULT 0,
+      created_at TEXT DEFAULT (datetime('now')),
+      effectiveness_score REAL DEFAULT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_teaching_packages_target ON teaching_packages(target_brain);
+  `);
+}
+// ── Engine ──────────────────────────────────────────────
+export class TeachEngine {
+    db;
+    log = getLogger();
+    thoughtStream = null;
+    distiller = null;
+    hypothesisEngine = null;
+    journal = null;
+    constructor(db) {
+        this.db = db;
+        runTeachEngineMigration(db);
+    }
+    setThoughtStream(stream) {
+        this.thoughtStream = stream;
+    }
+    setKnowledgeDistiller(distiller) {
+        this.distiller = distiller;
+    }
+    setHypothesisEngine(engine) {
+        this.hypothesisEngine = engine;
+    }
+    setJournal(journal) {
+        this.journal = journal;
+    }
+    /** Create a teaching package for another brain. */
+    createPackage(targetBrain) {
+        // 1. Top 20 Principles (by confidence) from KnowledgeDistiller
+        const principles = [];
+        if (this.distiller) {
+            const ps = this.distiller.getPrinciples(undefined, 20);
+            for (const p of ps) {
+                principles.push({ statement: p.statement, confidence: p.confidence });
+            }
+        }
+        // 2. Top 10 Anti-Patterns from KnowledgeDistiller
+        const antiPatterns = [];
+        if (this.distiller) {
+            const aps = this.distiller.getAntiPatterns(undefined, 10);
+            for (const ap of aps) {
+                antiPatterns.push({ statement: ap.statement, confidence: ap.confidence });
+            }
+        }
+        // 3. Top 5 Strategies from KnowledgeDistiller (query DB directly)
+        const strategies = [];
+        try {
+            const rows = this.db.prepare(`
+        SELECT id, description FROM knowledge_strategies
+        ORDER BY effectiveness DESC LIMIT 5
+      `).all();
+            for (const r of rows) {
+                strategies.push({ id: r.id, description: r.description });
+            }
+        }
+        catch { /* knowledge_strategies table might not exist */ }
+        // 4. Top 5 experiment results from HypothesisEngine (confirmed with evidence)
+        const experiments = [];
+        if (this.hypothesisEngine) {
+            try {
+                const confirmed = this.hypothesisEngine.list('confirmed', 5);
+                for (const h of confirmed) {
+                    experiments.push({
+                        name: `Hypothesis #${h.id}`,
+                        hypothesis: h.statement,
+                        conclusion: `Confirmed with confidence ${h.confidence.toFixed(2)} (evidence: ${h.evidence_for} for, ${h.evidence_against} against)`,
+                    });
+                }
+            }
+            catch { /* hypotheses table might not exist */ }
+        }
+        // 5. Key Journal insights (search for 'breakthrough' significance entries, take top 5 titles)
+        const journalInsights = [];
+        if (this.journal) {
+            try {
+                const entries = this.journal.getEntries(undefined, 100);
+                const breakthroughs = entries.filter(e => e.significance === 'breakthrough' || e.significance === 'paradigm_shift');
+                for (const e of breakthroughs.slice(0, 5)) {
+                    journalInsights.push(e.title);
+                }
+            }
+            catch { /* journal table might not exist */ }
+        }
+        // 6. Package everything
+        const pkg = {
+            targetBrain,
+            principles,
+            antiPatterns,
+            strategies,
+            experiments,
+            journalInsights,
+            principlesCount: principles.length,
+            antipatternsCount: antiPatterns.length,
+            strategiesCount: strategies.length,
+            experimentsCount: experiments.length,
+            createdAt: new Date().toISOString(),
+            effectivenessScore: null,
+        };
+        const packageJson = JSON.stringify({
+            principles: pkg.principles,
+            antiPatterns: pkg.antiPatterns,
+            strategies: pkg.strategies,
+            experiments: pkg.experiments,
+            journalInsights: pkg.journalInsights,
+        });
+        const result = this.db.prepare(`
+      INSERT INTO teaching_packages (target_brain, package_json, principles_count, antipatterns_count, strategies_count, experiments_count)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(targetBrain, packageJson, pkg.principlesCount, pkg.antipatternsCount, pkg.strategiesCount, pkg.experimentsCount);
+        pkg.id = result.lastInsertRowid;
+        // 7. Emit thought
+        this.thoughtStream?.emit('teach', 'reflecting', `Created teaching package for "${targetBrain}": ${principles.length} principles, ${antiPatterns.length} anti-patterns, ${strategies.length} strategies, ${experiments.length} experiments`, principles.length > 5 ? 'notable' : 'routine');
+        this.log.info(`[teach] Created package #${pkg.id} for ${targetBrain}: ${principles.length}P, ${antiPatterns.length}AP, ${strategies.length}S, ${experiments.length}E`);
+        return pkg;
+    }
+    /** Get a teaching package by id. */
+    getPackage(id) {
+        const row = this.db.prepare('SELECT * FROM teaching_packages WHERE id = ?').get(id);
+        if (!row)
+            return null;
+        return this.toTeachingPackage(row);
+    }
+    /** List recent teaching packages. */
+    listPackages(limit = 20) {
+        const rows = this.db.prepare(`
+      SELECT * FROM teaching_packages ORDER BY id DESC LIMIT ?
+    `).all(limit);
+        return rows.map(r => this.toTeachingPackage(r));
+    }
+    /** Rate the effectiveness of a teaching package. */
+    rateEffectiveness(id, score) {
+        const clamped = Math.max(0, Math.min(1, score));
+        this.db.prepare(`
+      UPDATE teaching_packages SET effectiveness_score = ? WHERE id = ?
+    `).run(clamped, id);
+        this.log.debug(`[teach] Rated package #${id} effectiveness: ${clamped.toFixed(2)}`);
+    }
+    /** Get status summary. */
+    getStatus() {
+        const total = this.db.prepare('SELECT COUNT(*) as c FROM teaching_packages').get().c;
+        const avgRow = this.db.prepare('SELECT AVG(effectiveness_score) as avg FROM teaching_packages WHERE effectiveness_score IS NOT NULL').get();
+        const recentPackages = this.listPackages(5);
+        return {
+            totalPackages: total,
+            avgEffectiveness: avgRow.avg ?? 0,
+            recentPackages,
+        };
+    }
+    // ── Private ─────────────────────────────────────────────
+    toTeachingPackage(row) {
+        const packageData = JSON.parse(row.package_json || '{}');
+        return {
+            id: row.id,
+            targetBrain: row.target_brain,
+            principles: packageData.principles ?? [],
+            antiPatterns: packageData.antiPatterns ?? [],
+            strategies: packageData.strategies ?? [],
+            experiments: packageData.experiments ?? [],
+            journalInsights: packageData.journalInsights ?? [],
+            principlesCount: row.principles_count,
+            antipatternsCount: row.antipatterns_count,
+            strategiesCount: row.strategies_count,
+            experimentsCount: row.experiments_count,
+            createdAt: row.created_at,
+            effectivenessScore: row.effectiveness_score,
+        };
+    }
+}
+//# sourceMappingURL=teach-engine.js.map

package/dist/metacognition/teach-engine.js.map

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

package/dist/research/data-scout.d.ts

@@ -0,0 +1,68 @@
+import type Database from 'better-sqlite3';
+import type { ThoughtStream } from '../consciousness/thought-stream.js';
+export interface ScoutDiscovery {
+    id?: number;
+    source: string;
+    title: string;
+    url: string;
+    description: string;
+    relevanceScore: number;
+    metadata: Record<string, unknown>;
+    discoveredAt: string;
+    imported: boolean;
+}
+export interface ScoutAdapter {
+    name: string;
+    scout(): Promise<ScoutDiscovery[]>;
+    isEnabled(): boolean;
+}
+export interface DataScoutStatus {
+    totalDiscoveries: number;
+    importedCount: number;
+    bySource: Record<string, number>;
+    recentDiscoveries: ScoutDiscovery[];
+}
+export declare function runDataScoutMigration(db: Database.Database): void;
+export declare class DataScout {
+    private db;
+    private adapters;
+    private thoughtStream;
+    private log;
+    constructor(db: Database.Database, adapters?: ScoutAdapter[]);
+    setThoughtStream(stream: ThoughtStream): void;
+    addAdapter(adapter: ScoutAdapter): void;
+    /** Run all enabled adapters, deduplicate, persist new discoveries. */
+    scout(): Promise<ScoutDiscovery[]>;
+    /** Get discoveries, optionally filtered by source. */
+    getDiscoveries(source?: string, limit?: number): ScoutDiscovery[];
+    /** Mark a discovery as imported. */
+    markImported(id: number): void;
+    /** Get status summary. */
+    getStatus(): DataScoutStatus;
+    private isDuplicate;
+    private toDiscovery;
+}
+/**
+ * GitHubTrendingAdapter — Discovers trending GitHub repositories.
+ */
+export declare class GitHubTrendingAdapter implements ScoutAdapter {
+    readonly name = "github-trending";
+    isEnabled(): boolean;
+    scout(): Promise<ScoutDiscovery[]>;
+}
+/**
+ * NpmStatsAdapter — Discovers trending npm packages.
+ */
+export declare class NpmStatsAdapter implements ScoutAdapter {
+    readonly name = "npm-stats";
+    isEnabled(): boolean;
+    scout(): Promise<ScoutDiscovery[]>;
+}
+/**
+ * HackerNewsAdapter — Discovers top Hacker News stories.
+ */
+export declare class HackerNewsAdapter implements ScoutAdapter {
+    readonly name = "hackernews";
+    isEnabled(): boolean;
+    scout(): Promise<ScoutDiscovery[]>;
+}

package/dist/research/data-scout.js

@@ -0,0 +1,254 @@
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runDataScoutMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS scout_discoveries (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      source TEXT NOT NULL,
+      title TEXT NOT NULL,
+      url TEXT NOT NULL DEFAULT '',
+      description TEXT NOT NULL DEFAULT '',
+      relevance_score REAL NOT NULL DEFAULT 0,
+      metadata TEXT NOT NULL DEFAULT '{}',
+      discovered_at TEXT DEFAULT (datetime('now')),
+      imported INTEGER NOT NULL DEFAULT 0
+    );
+    CREATE INDEX IF NOT EXISTS idx_scout_source ON scout_discoveries(source);
+    CREATE INDEX IF NOT EXISTS idx_scout_relevance ON scout_discoveries(relevance_score DESC);
+  `);
+}
+// ── DataScout ───────────────────────────────────────────
+export class DataScout {
+    db;
+    adapters;
+    thoughtStream = null;
+    log = getLogger();
+    constructor(db, adapters = []) {
+        this.db = db;
+        this.adapters = adapters;
+        runDataScoutMigration(db);
+    }
+    setThoughtStream(stream) {
+        this.thoughtStream = stream;
+    }
+    addAdapter(adapter) {
+        this.adapters.push(adapter);
+        this.log.info(`[data-scout] Added adapter: ${adapter.name}`);
+    }
+    /** Run all enabled adapters, deduplicate, persist new discoveries. */
+    async scout() {
+        const allDiscoveries = [];
+        for (const adapter of this.adapters) {
+            if (!adapter.isEnabled())
+                continue;
+            try {
+                const discoveries = await adapter.scout();
+                let newCount = 0;
+                for (const discovery of discoveries) {
+                    if (this.isDuplicate(discovery.source, discovery.title))
+                        continue;
+                    this.db.prepare(`
+            INSERT INTO scout_discoveries (source, title, url, description, relevance_score, metadata)
+            VALUES (?, ?, ?, ?, ?, ?)
+          `).run(discovery.source, discovery.title, discovery.url, discovery.description, discovery.relevanceScore, JSON.stringify(discovery.metadata));
+                    allDiscoveries.push(discovery);
+                    newCount++;
+                }
+                if (newCount > 0) {
+                    this.log.info(`[data-scout] ${adapter.name}: ${newCount} new discoveries`);
+                    this.thoughtStream?.emit('data-scout', 'discovering', `DataScout ${adapter.name}: found ${newCount} new items`, newCount >= 5 ? 'notable' : 'routine', { adapter: adapter.name, count: newCount });
+                }
+            }
+            catch (err) {
+                this.log.error(`[data-scout] Error in adapter ${adapter.name}: ${err.message}`);
+            }
+        }
+        return allDiscoveries;
+    }
+    /** Get discoveries, optionally filtered by source. */
+    getDiscoveries(source, limit = 20) {
+        if (source) {
+            return this.db.prepare('SELECT * FROM scout_discoveries WHERE source = ? ORDER BY relevance_score DESC LIMIT ?').all(source, limit).map(r => this.toDiscovery(r));
+        }
+        return this.db.prepare('SELECT * FROM scout_discoveries ORDER BY relevance_score DESC LIMIT ?').all(limit).map(r => this.toDiscovery(r));
+    }
+    /** Mark a discovery as imported. */
+    markImported(id) {
+        this.db.prepare('UPDATE scout_discoveries SET imported = 1 WHERE id = ?').run(id);
+    }
+    /** Get status summary. */
+    getStatus() {
+        const total = this.db.prepare('SELECT COUNT(*) as c FROM scout_discoveries').get().c;
+        const imported = this.db.prepare('SELECT COUNT(*) as c FROM scout_discoveries WHERE imported = 1').get().c;
+        const sourceRows = this.db.prepare('SELECT source, COUNT(*) as c FROM scout_discoveries GROUP BY source').all();
+        const bySource = {};
+        for (const row of sourceRows) {
+            bySource[row.source] = row.c;
+        }
+        const recent = this.getDiscoveries(undefined, 10);
+        return {
+            totalDiscoveries: total,
+            importedCount: imported,
+            bySource,
+            recentDiscoveries: recent,
+        };
+    }
+    // ── Private ──────────────────────────────────────────────
+    isDuplicate(source, title) {
+        const row = this.db.prepare('SELECT id FROM scout_discoveries WHERE source = ? AND title = ? LIMIT 1').get(source, title);
+        return !!row;
+    }
+    toDiscovery(row) {
+        return {
+            id: row.id,
+            source: row.source,
+            title: row.title,
+            url: row.url,
+            description: row.description,
+            relevanceScore: row.relevance_score,
+            metadata: JSON.parse(row.metadata || '{}'),
+            discoveredAt: row.discovered_at,
+            imported: row.imported === 1,
+        };
+    }
+}
+// ── Adapters ──────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * GitHubTrendingAdapter — Discovers trending GitHub repositories.
+ */
+export class GitHubTrendingAdapter {
+    name = 'github-trending';
+    isEnabled() {
+        return true;
+    }
+    async scout() {
+        try {
+            const res = await fetch('https://api.github.com/search/repositories?q=stars:>100+pushed:>2024-01-01&sort=stars&order=desc&per_page=10', {
+                headers: {
+                    'Accept': 'application/vnd.github+json',
+                    'User-Agent': 'brain-ecosystem',
+                },
+            });
+            if (!res.ok)
+                return [];
+            const data = await res.json();
+            if (!data.items)
+                return [];
+            return data.items.map(repo => ({
+                source: this.name,
+                title: repo.full_name,
+                url: repo.html_url,
+                description: repo.description || '',
+                relevanceScore: Math.min(1, repo.stargazers_count / 50000),
+                metadata: {
+                    stars: repo.stargazers_count,
+                    language: repo.language,
+                    topics: repo.topics ?? [],
+                },
+                discoveredAt: new Date().toISOString(),
+                imported: false,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+/**
+ * NpmStatsAdapter — Discovers trending npm packages.
+ */
+export class NpmStatsAdapter {
+    name = 'npm-stats';
+    isEnabled() {
+        return true;
+    }
+    async scout() {
+        try {
+            const res = await fetch('https://registry.npmjs.org/-/v1/search?text=typescript+ai&size=10', {
+                headers: {
+                    'Accept': 'application/json',
+                    'User-Agent': 'brain-ecosystem',
+                },
+            });
+            if (!res.ok)
+                return [];
+            const data = await res.json();
+            if (!data.objects)
+                return [];
+            return data.objects.map(obj => ({
+                source: this.name,
+                title: obj.package.name,
+                url: obj.package.links?.npm || `https://www.npmjs.com/package/${obj.package.name}`,
+                description: obj.package.description || '',
+                relevanceScore: Math.min(1, obj.searchScore ?? 0),
+                metadata: {
+                    version: obj.package.version,
+                    searchScore: obj.searchScore,
+                },
+                discoveredAt: new Date().toISOString(),
+                imported: false,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+/**
+ * HackerNewsAdapter — Discovers top Hacker News stories.
+ */
+export class HackerNewsAdapter {
+    name = 'hackernews';
+    isEnabled() {
+        return true;
+    }
+    async scout() {
+        try {
+            const topRes = await fetch('https://hacker-news.firebaseio.com/v0/topstories.json');
+            if (!topRes.ok)
+                return [];
+            const ids = await topRes.json();
+            if (!Array.isArray(ids))
+                return [];
+            const topIds = ids.slice(0, 10);
+            const discoveries = [];
+            for (const id of topIds) {
+                try {
+                    await sleep(200);
+                    const itemRes = await fetch(`https://hacker-news.firebaseio.com/v0/item/${id}.json`);
+                    if (!itemRes.ok)
+                        continue;
+                    const item = await itemRes.json();
+                    if (!item || !item.title)
+                        continue;
+                    discoveries.push({
+                        source: this.name,
+                        title: item.title,
+                        url: item.url || `https://news.ycombinator.com/item?id=${id}`,
+                        description: `Score: ${item.score ?? 0} | By: ${item.by ?? 'unknown'}`,
+                        relevanceScore: Math.min(1, (item.score ?? 0) / 500),
+                        metadata: {
+                            hnId: id,
+                            score: item.score,
+                            by: item.by,
+                            type: item.type,
+                        },
+                        discoveredAt: new Date().toISOString(),
+                        imported: false,
+                    });
+                }
+                catch {
+                    // Skip individual item failures
+                }
+            }
+            return discoveries;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=data-scout.js.map

package/dist/research/data-scout.js.map

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

package/dist/research/research-orchestrator.d.ts

@@ -24,6 +24,13 @@ import type { NarrativeEngine } from '../narrative/narrative-engine.js';
 import type { CuriosityEngine } from '../curiosity/curiosity-engine.js';
 import type { EmergenceEngine } from '../emergence/emergence-engine.js';
 import type { DebateEngine } from '../debate/debate-engine.js';
+import type { ParameterRegistry } from '../metacognition/parameter-registry.js';
+import type { MetaCognitionLayer } from '../metacognition/meta-cognition-layer.js';
+import type { AutoExperimentEngine } from '../metacognition/auto-experiment-engine.js';
+import type { SelfTestEngine } from '../metacognition/self-test-engine.js';
+import type { TeachEngine } from '../metacognition/teach-engine.js';
+import type { DataScout } from './data-scout.js';
+import type { SimulationEngine } from '../metacognition/simulation-engine.js';
 import { AutoResponder } from './auto-responder.js';
 export interface ResearchOrchestratorConfig {
     brainName: string;
@@ -61,6 +68,13 @@ export declare class ResearchOrchestrator {
     private curiosityEngine;
     private emergenceEngine;
     private debateEngine;
+    private parameterRegistry;
+    private metaCognitionLayer;
+    private autoExperimentEngine;
+    private selfTestEngine;
+    private teachEngine;
+    private dataScout;
+    private simulationEngine;
     private brainName;
     private feedbackTimer;
     private cycleCount;
@@ -72,6 +86,8 @@ export declare class ResearchOrchestrator {
     private suggestionHistory;
     /** Max repeats before trying an alternative. */
     private readonly stalledThreshold;
+    /** Hash of last written suggestions to prevent duplicate file writes. */
+    private lastSuggestionsHash;
     constructor(db: Database.Database, config: ResearchOrchestratorConfig, causalGraph?: CausalGraph);
     /** Set the DataMiner instance for DB-driven engine feeding. */
     setDataMiner(miner: DataMiner): void;
@@ -96,6 +112,20 @@ export declare class ResearchOrchestrator {
     /** Set the EmergenceEngine — tracks emergent behaviors and complexity metrics. */
     setEmergenceEngine(engine: EmergenceEngine): void;
     setDebateEngine(engine: DebateEngine): void;
+    /** Set the ParameterRegistry — central tunable parameter store. */
+    setParameterRegistry(registry: ParameterRegistry): void;
+    /** Set the MetaCognitionLayer — engine evaluation and frequency adjustment. */
+    setMetaCognitionLayer(layer: MetaCognitionLayer): void;
+    /** Set the AutoExperimentEngine — autonomous parameter tuning. */
+    setAutoExperimentEngine(engine: AutoExperimentEngine): void;
+    /** Set the SelfTestEngine — tests understanding depth of principles. */
+    setSelfTestEngine(engine: SelfTestEngine): void;
+    /** Set the TeachEngine — generates onboarding packages for new brains. */
+    setTeachEngine(engine: TeachEngine): void;
+    /** Set the DataScout — actively scouts external data sources. */
+    setDataScout(scout: DataScout): void;
+    /** Set the SimulationEngine — runs what-if scenarios. */
+    setSimulationEngine(engine: SimulationEngine): void;
     /** Set the PredictionEngine — wires journal into it. */
     setPredictionEngine(engine: PredictionEngine): void;
     /** Start the autonomous feedback loop timer. */
@@ -132,7 +162,8 @@ export declare class ResearchOrchestrator {
     private proposeAutoExperiment;
     /** Feed cycle measurements into running experiments. */
     private feedExperimentMeasurements;
-    /** Append improvement suggestions to ~/.brain/improvement-requests.md */
+    /** Append improvement suggestions to ~/.brain/improvement-requests.md.
+     *  Skips writing if suggestions are identical to the last write (dedup). */
     private writeSuggestionsToFile;
     /** Get a comprehensive research summary for dashboards/API. */
     getSummary(): Record<string, unknown>;