@timmeck/brain-core 2.10.0 → 2.11.1

package/dist/prediction/prediction-engine.js

@@ -0,0 +1,301 @@
+// ── Prediction Engine — Proactive Forecasting ────────────────
+//
+// Records domain metrics, generates Holt-Winters / EWMA predictions,
+// resolves them against reality, and auto-calibrates confidence.
+import { randomUUID } from 'node:crypto';
+import { getLogger } from '../utils/logger.js';
+import { holtWintersForecast, ewmaForecast, calibrateConfidence } from './forecaster.js';
+import { PredictionTracker } from './tracker.js';
+// ── Migration ───────────────────────────────────────────
+export function runPredictionMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS predictions (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      prediction_id TEXT NOT NULL UNIQUE,
+      domain TEXT NOT NULL,
+      metric TEXT NOT NULL,
+      predicted_value REAL NOT NULL,
+      predicted_direction TEXT NOT NULL,
+      confidence REAL NOT NULL,
+      horizon_ms INTEGER NOT NULL,
+      reasoning TEXT NOT NULL DEFAULT '',
+      method TEXT NOT NULL,
+      status TEXT NOT NULL DEFAULT 'pending',
+      actual_value REAL,
+      error REAL,
+      created_at INTEGER NOT NULL,
+      resolved_at INTEGER,
+      expires_at INTEGER NOT NULL,
+      evidence TEXT NOT NULL DEFAULT '{}'
+    );
+    CREATE INDEX IF NOT EXISTS idx_predictions_status ON predictions(status);
+    CREATE INDEX IF NOT EXISTS idx_predictions_domain ON predictions(domain);
+    CREATE INDEX IF NOT EXISTS idx_predictions_metric ON predictions(metric);
+    CREATE INDEX IF NOT EXISTS idx_predictions_expires ON predictions(expires_at);
+
+    CREATE TABLE IF NOT EXISTS prediction_metrics (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      metric TEXT NOT NULL,
+      value REAL NOT NULL,
+      domain TEXT NOT NULL DEFAULT 'metric',
+      timestamp INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_pred_metrics_metric ON prediction_metrics(metric);
+    CREATE INDEX IF NOT EXISTS idx_pred_metrics_ts ON prediction_metrics(timestamp);
+
+    CREATE TABLE IF NOT EXISTS prediction_state (
+      id INTEGER PRIMARY KEY CHECK(id = 1),
+      total_predictions INTEGER NOT NULL DEFAULT 0,
+      total_resolved INTEGER NOT NULL DEFAULT 0,
+      total_correct INTEGER NOT NULL DEFAULT 0,
+      calibration_offset REAL NOT NULL DEFAULT 0.0,
+      updated_at TEXT DEFAULT (datetime('now'))
+    );
+    INSERT OR IGNORE INTO prediction_state (id) VALUES (1);
+  `);
+}
+// ── Engine ──────────────────────────────────────────────
+export class PredictionEngine {
+    db;
+    config;
+    tracker;
+    thoughtStream = null;
+    journal = null;
+    timer = null;
+    calibrationOffset = 0;
+    log = getLogger();
+    constructor(db, config) {
+        this.db = db;
+        this.config = {
+            brainName: config.brainName,
+            defaultHorizonMs: config.defaultHorizonMs ?? 3_600_000,
+            expirationMs: config.expirationMs ?? 86_400_000,
+            ewmaAlpha: config.ewmaAlpha ?? 0.3,
+            trendBeta: config.trendBeta ?? 0.1,
+            minDataPoints: config.minDataPoints ?? 5,
+            minConfidence: config.minConfidence ?? 0.3,
+            maxPredictionsPerCycle: config.maxPredictionsPerCycle ?? 5,
+            resolveIntervalMs: config.resolveIntervalMs ?? 60_000,
+        };
+        runPredictionMigration(db);
+        this.tracker = new PredictionTracker(db);
+        // Load calibration offset from DB
+        this.calibrationOffset = this.tracker.getCalibrationOffset();
+    }
+    /** Set the ThoughtStream for consciousness integration. */
+    setThoughtStream(stream) {
+        this.thoughtStream = stream;
+    }
+    /** Set the Research Journal for logging notable predictions. */
+    setJournal(journal) {
+        this.journal = journal;
+    }
+    /** Start periodic resolution timer. */
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => {
+            try {
+                this.cycle();
+            }
+            catch (err) {
+                this.log.error(`[prediction] Cycle error: ${err.message}`);
+            }
+        }, this.config.resolveIntervalMs);
+        this.log.info(`[prediction] Engine started (resolve interval: ${this.config.resolveIntervalMs}ms)`);
+    }
+    /** Stop the resolution timer. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Record a metric data point. Called by domain event handlers. */
+    recordMetric(metric, value, domain = 'metric') {
+        this.db.prepare(`
+      INSERT INTO prediction_metrics (metric, value, domain, timestamp) VALUES (?, ?, ?, ?)
+    `).run(metric, value, domain, Date.now());
+    }
+    /**
+     * Generate a prediction for a specific metric.
+     * Returns null if insufficient data or confidence too low.
+     */
+    predict(input) {
+        const horizonMs = input.horizon_ms ?? this.config.defaultHorizonMs;
+        const history = this.getMetricHistory(input.metric, 100);
+        if (history.length < 2)
+            return null;
+        const data = history.map(h => h.value);
+        const forecast = this.forecast(data, horizonMs);
+        // Apply calibration
+        const calibratedConfidence = this.applyCalibration(forecast.confidence);
+        if (calibratedConfidence < this.config.minConfidence)
+            return null;
+        const now = Date.now();
+        const prediction = {
+            prediction_id: randomUUID(),
+            domain: input.domain,
+            metric: input.metric,
+            predicted_value: forecast.value,
+            predicted_direction: forecast.direction,
+            confidence: calibratedConfidence,
+            horizon_ms: horizonMs,
+            reasoning: input.reasoning ?? `${forecast.method} forecast (${forecast.dataPoints} points, trend: ${forecast.trend.toFixed(4)})`,
+            method: forecast.method,
+            status: 'pending',
+            created_at: now,
+            expires_at: now + this.config.expirationMs,
+            evidence: {
+                ...input.evidence,
+                dataPoints: forecast.dataPoints,
+                trend: forecast.trend,
+                rawConfidence: forecast.confidence,
+                calibrationOffset: this.calibrationOffset,
+            },
+        };
+        this.tracker.store(prediction);
+        // Update state
+        this.db.prepare(`
+      UPDATE prediction_state SET total_predictions = total_predictions + 1, updated_at = datetime('now') WHERE id = 1
+    `).run();
+        // Emit thought
+        this.thoughtStream?.emit('prediction', 'predicting', `Predicted ${input.metric}: ${forecast.direction} to ${forecast.value.toFixed(2)} (${(calibratedConfidence * 100).toFixed(0)}% confidence)`, calibratedConfidence > 0.7 ? 'notable' : 'routine');
+        // Journal high-confidence predictions
+        if (calibratedConfidence > 0.6 && this.journal) {
+            try {
+                this.journal.recordDiscovery(`Prediction: ${input.metric} → ${forecast.direction}`, `Forecasted ${input.metric} will go ${forecast.direction} to ${forecast.value.toFixed(2)} within ${(horizonMs / 60_000).toFixed(0)}min. Method: ${forecast.method}, confidence: ${(calibratedConfidence * 100).toFixed(0)}%.`, { prediction_id: prediction.prediction_id, ...prediction.evidence }, calibratedConfidence > 0.8 ? 'notable' : 'routine');
+            }
+            catch { /* best effort */ }
+        }
+        return prediction;
+    }
+    /**
+     * Auto-predict for all tracked metrics that have enough data.
+     * Skips metrics with pending predictions. Respects maxPredictionsPerCycle.
+     */
+    autoPredictAll() {
+        const trackedMetrics = this.getTrackedMetrics();
+        const pendingMetrics = this.tracker.getMetricsWithPending();
+        const predictions = [];
+        for (const { metric, domain } of trackedMetrics) {
+            if (predictions.length >= this.config.maxPredictionsPerCycle)
+                break;
+            if (pendingMetrics.has(metric))
+                continue;
+            const prediction = this.predict({ domain, metric });
+            if (prediction)
+                predictions.push(prediction);
+        }
+        return predictions;
+    }
+    /**
+     * Resolve expired/due predictions against current metric values.
+     * Returns count of resolved predictions.
+     */
+    resolveExpired() {
+        let resolved = 0;
+        // 1. Mark truly expired (past expiration, no data)
+        const expired = this.tracker.getPendingExpired();
+        for (const pred of expired) {
+            this.tracker.markExpired(pred.prediction_id);
+            resolved++;
+        }
+        // 2. Resolve predictions past their horizon
+        const resolvable = this.tracker.getPendingResolvable();
+        for (const pred of resolvable) {
+            // Get the latest metric value after the prediction was made
+            const row = this.db.prepare(`
+        SELECT AVG(value) as avg_value FROM prediction_metrics
+        WHERE metric = ? AND timestamp > ?
+        ORDER BY timestamp DESC LIMIT 10
+      `).get(pred.metric, pred.created_at);
+            if (row?.avg_value != null) {
+                this.tracker.resolve(pred.prediction_id, row.avg_value);
+                resolved++;
+            }
+        }
+        // 3. Recalibrate if we resolved anything
+        if (resolved > 0) {
+            this.recalibrate();
+        }
+        return resolved;
+    }
+    /** List predictions with optional filters. */
+    list(domain, status, limit) {
+        return this.tracker.list(domain, status, limit);
+    }
+    /** Get accuracy statistics. */
+    getAccuracy(domain) {
+        return this.tracker.getAccuracy(domain);
+    }
+    /** Get full prediction summary. */
+    getSummary() {
+        const state = this.db.prepare('SELECT * FROM prediction_state WHERE id = 1').get();
+        const accuracy = this.tracker.getAccuracy();
+        const recent = this.tracker.list(undefined, undefined, 10);
+        const totalPredictions = state?.total_predictions ?? 0;
+        const pending = this.tracker.list(undefined, 'pending', 1000).length;
+        const resolved = totalPredictions - pending;
+        // Overall accuracy
+        const totalCorrect = accuracy.reduce((sum, a) => sum + a.correct, 0);
+        const totalResolved = accuracy.reduce((sum, a) => sum + a.total - a.expired, 0);
+        return {
+            total_predictions: totalPredictions,
+            pending,
+            resolved,
+            accuracy_rate: totalResolved > 0 ? totalCorrect / totalResolved : 0,
+            by_domain: accuracy,
+            calibration_offset: this.calibrationOffset,
+            recent,
+        };
+    }
+    /** Run a forecast on raw data. Uses Holt-Winters (≥ minDataPoints) or EWMA. */
+    forecast(data, _horizonMs) {
+        // steps = horizon / avg interval between data points (default 1)
+        const steps = 1;
+        if (data.length >= this.config.minDataPoints) {
+            return holtWintersForecast(data, steps, this.config.ewmaAlpha, this.config.trendBeta);
+        }
+        return ewmaForecast(data, this.config.ewmaAlpha);
+    }
+    /** Get metric history as time series. */
+    getMetricHistory(metric, limit = 100) {
+        return this.db.prepare(`
+      SELECT value, timestamp FROM prediction_metrics
+      WHERE metric = ?
+      ORDER BY timestamp ASC
+      LIMIT ?
+    `).all(metric, limit);
+    }
+    // ── Private ─────────────────────────────────────────────
+    /** Periodic cycle: resolve + auto-predict. */
+    cycle() {
+        const resolved = this.resolveExpired();
+        if (resolved > 0) {
+            this.log.debug(`[prediction] Resolved ${resolved} predictions`);
+        }
+    }
+    /** Recalibrate confidence offset based on historical accuracy. */
+    recalibrate() {
+        this.calibrationOffset = this.tracker.getCalibrationOffset();
+        this.db.prepare(`
+      UPDATE prediction_state SET calibration_offset = ?, updated_at = datetime('now') WHERE id = 1
+    `).run(this.calibrationOffset);
+    }
+    /** Apply calibration to raw confidence. */
+    applyCalibration(rawConfidence) {
+        const buckets = this.tracker.getCalibrationBuckets();
+        return calibrateConfidence(rawConfidence, buckets);
+    }
+    /** Get all unique tracked metrics with their domains. */
+    getTrackedMetrics() {
+        return this.db.prepare(`
+      SELECT DISTINCT metric, domain FROM prediction_metrics
+      GROUP BY metric
+      HAVING COUNT(*) >= 2
+      ORDER BY COUNT(*) DESC
+    `).all();
+    }
+}
+//# sourceMappingURL=prediction-engine.js.map

package/dist/prediction/prediction-engine.js.map

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

package/dist/prediction/tracker.d.ts

@@ -0,0 +1,27 @@
+import type Database from 'better-sqlite3';
+import type { Prediction, PredictionDomain, PredictionStatus, PredictionAccuracy, CalibrationBucket } from './types.js';
+export declare class PredictionTracker {
+    private db;
+    constructor(db: Database.Database);
+    /** Store a new prediction in the DB. */
+    store(prediction: Prediction): string;
+    /** Resolve a prediction against actual value. Returns the determined status. */
+    resolve(predictionId: string, actualValue: number): PredictionStatus;
+    /** List predictions with optional filters. */
+    list(domain?: PredictionDomain, status?: PredictionStatus, limit?: number): Prediction[];
+    /** Get accuracy statistics, optionally by domain. */
+    getAccuracy(domain?: PredictionDomain): PredictionAccuracy[];
+    /** Get calibration offset — average (confidence - actual_accuracy) across buckets. */
+    getCalibrationOffset(): number;
+    /** Get calibration buckets for confidence adjustment. */
+    getCalibrationBuckets(): CalibrationBucket[];
+    /** Get pending predictions that have expired (past expires_at). */
+    getPendingExpired(): Prediction[];
+    /** Get pending predictions that are within their horizon (ready for resolution check). */
+    getPendingResolvable(): Prediction[];
+    /** Mark a prediction as expired. */
+    markExpired(predictionId: string): void;
+    /** Get metrics with pending predictions (to skip in autoPredictAll). */
+    getMetricsWithPending(): Set<string>;
+    private rowToPrediction;
+}

package/dist/prediction/tracker.js

@@ -0,0 +1,221 @@
+// ── Prediction Tracker — DB-backed Storage + Resolution ──────
+export class PredictionTracker {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Store a new prediction in the DB. */
+    store(prediction) {
+        this.db.prepare(`
+      INSERT INTO predictions (
+        prediction_id, domain, metric, predicted_value, predicted_direction,
+        confidence, horizon_ms, reasoning, method, status,
+        created_at, expires_at, evidence
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(prediction.prediction_id, prediction.domain, prediction.metric, prediction.predicted_value, prediction.predicted_direction, prediction.confidence, prediction.horizon_ms, prediction.reasoning, prediction.method, prediction.status, prediction.created_at, prediction.expires_at, JSON.stringify(prediction.evidence));
+        return prediction.prediction_id;
+    }
+    /** Resolve a prediction against actual value. Returns the determined status. */
+    resolve(predictionId, actualValue) {
+        const row = this.db.prepare(`
+      SELECT * FROM predictions WHERE prediction_id = ?
+    `).get(predictionId);
+        if (!row)
+            return 'expired';
+        const predicted = row.predicted_value;
+        const predictedDir = row.predicted_direction;
+        // Calculate error
+        const error = predicted !== 0
+            ? Math.abs(predicted - actualValue) / Math.abs(predicted)
+            : Math.abs(actualValue);
+        // Determine actual direction
+        let actualDir;
+        if (actualValue > predicted * 1.02)
+            actualDir = 'up';
+        else if (actualValue < predicted * 0.98)
+            actualDir = 'down';
+        else
+            actualDir = 'stable';
+        const directionCorrect = predictedDir === actualDir;
+        // Determine status
+        let status;
+        if (error < 0.10 && directionCorrect) {
+            status = 'correct';
+        }
+        else if (error < 0.25 || directionCorrect) {
+            status = 'partial';
+        }
+        else {
+            status = 'wrong';
+        }
+        const now = Date.now();
+        this.db.prepare(`
+      UPDATE predictions SET
+        status = ?, actual_value = ?, error = ?, resolved_at = ?
+      WHERE prediction_id = ?
+    `).run(status, actualValue, error, now, predictionId);
+        return status;
+    }
+    /** List predictions with optional filters. */
+    list(domain, status, limit = 50) {
+        let sql = 'SELECT * FROM predictions WHERE 1=1';
+        const params = [];
+        if (domain) {
+            sql += ' AND domain = ?';
+            params.push(domain);
+        }
+        if (status) {
+            sql += ' AND status = ?';
+            params.push(status);
+        }
+        sql += ' ORDER BY created_at DESC LIMIT ?';
+        params.push(limit);
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(r => this.rowToPrediction(r));
+    }
+    /** Get accuracy statistics, optionally by domain. */
+    getAccuracy(domain) {
+        let sql = `
+      SELECT
+        domain,
+        COUNT(*) as total,
+        SUM(CASE WHEN status = 'correct' THEN 1 ELSE 0 END) as correct,
+        SUM(CASE WHEN status = 'wrong' THEN 1 ELSE 0 END) as wrong,
+        SUM(CASE WHEN status = 'partial' THEN 1 ELSE 0 END) as partial,
+        SUM(CASE WHEN status = 'expired' THEN 1 ELSE 0 END) as expired,
+        AVG(CASE WHEN error IS NOT NULL THEN error ELSE NULL END) as mean_error,
+        AVG(confidence) as avg_confidence
+      FROM predictions
+      WHERE status != 'pending'
+    `;
+        const params = [];
+        if (domain) {
+            sql += ' AND domain = ?';
+            params.push(domain);
+        }
+        sql += ' GROUP BY domain';
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(r => {
+            const total = r.total;
+            const correct = r.correct;
+            const wrong = r.wrong;
+            const partial = r.partial;
+            const expired = r.expired;
+            // Direction accuracy: correct + partial count as direction-correct
+            const resolved = total - expired;
+            const directionCorrect = correct + partial;
+            // Calibration score: how close avg confidence is to actual accuracy
+            const actualAccuracy = resolved > 0 ? correct / resolved : 0;
+            const avgConfidence = r.avg_confidence;
+            const calibrationScore = 1 - Math.abs(actualAccuracy - avgConfidence);
+            return {
+                domain: r.domain,
+                total,
+                correct,
+                wrong,
+                partial,
+                expired,
+                accuracy_rate: resolved > 0 ? correct / resolved : 0,
+                mean_absolute_error: r.mean_error ?? 0,
+                calibration_score: Math.max(0, calibrationScore),
+                direction_accuracy: resolved > 0 ? directionCorrect / resolved : 0,
+            };
+        });
+    }
+    /** Get calibration offset — average (confidence - actual_accuracy) across buckets. */
+    getCalibrationOffset() {
+        const buckets = this.getCalibrationBuckets();
+        if (buckets.length === 0)
+            return 0;
+        let totalOffset = 0;
+        let count = 0;
+        for (const b of buckets) {
+            if (b.predicted_count >= 3) {
+                const midpoint = (b.range_start + b.range_end) / 2;
+                totalOffset += midpoint - b.actual_accuracy;
+                count++;
+            }
+        }
+        return count > 0 ? totalOffset / count : 0;
+    }
+    /** Get calibration buckets for confidence adjustment. */
+    getCalibrationBuckets() {
+        const bucketRanges = [
+            [0.0, 0.2], [0.2, 0.4], [0.4, 0.6], [0.6, 0.8], [0.8, 1.01],
+        ];
+        const buckets = [];
+        for (const [start, end] of bucketRanges) {
+            const row = this.db.prepare(`
+        SELECT
+          COUNT(*) as total,
+          SUM(CASE WHEN status = 'correct' THEN 1 ELSE 0 END) as correct
+        FROM predictions
+        WHERE status != 'pending'
+          AND confidence >= ? AND confidence < ?
+      `).get(start, end);
+            const total = row.total ?? 0;
+            const correct = row.correct ?? 0;
+            buckets.push({
+                range_start: start,
+                range_end: end === 1.01 ? 1.0 : end,
+                predicted_count: total,
+                actual_accuracy: total > 0 ? correct / total : 0,
+            });
+        }
+        return buckets;
+    }
+    /** Get pending predictions that have expired (past expires_at). */
+    getPendingExpired() {
+        const now = Date.now();
+        const rows = this.db.prepare(`
+      SELECT * FROM predictions
+      WHERE status = 'pending' AND expires_at < ?
+      ORDER BY created_at ASC
+    `).all(now);
+        return rows.map(r => this.rowToPrediction(r));
+    }
+    /** Get pending predictions that are within their horizon (ready for resolution check). */
+    getPendingResolvable() {
+        const now = Date.now();
+        const rows = this.db.prepare(`
+      SELECT * FROM predictions
+      WHERE status = 'pending' AND (created_at + horizon_ms) <= ? AND expires_at >= ?
+      ORDER BY created_at ASC
+    `).all(now, now);
+        return rows.map(r => this.rowToPrediction(r));
+    }
+    /** Mark a prediction as expired. */
+    markExpired(predictionId) {
+        this.db.prepare(`
+      UPDATE predictions SET status = 'expired', resolved_at = ? WHERE prediction_id = ?
+    `).run(Date.now(), predictionId);
+    }
+    /** Get metrics with pending predictions (to skip in autoPredictAll). */
+    getMetricsWithPending() {
+        const rows = this.db.prepare(`
+      SELECT DISTINCT metric FROM predictions WHERE status = 'pending'
+    `).all();
+        return new Set(rows.map(r => r.metric));
+    }
+    rowToPrediction(r) {
+        return {
+            prediction_id: r.prediction_id,
+            domain: r.domain,
+            metric: r.metric,
+            predicted_value: r.predicted_value,
+            predicted_direction: r.predicted_direction,
+            confidence: r.confidence,
+            horizon_ms: r.horizon_ms,
+            reasoning: r.reasoning,
+            method: r.method,
+            status: r.status,
+            actual_value: r.actual_value,
+            error: r.error,
+            created_at: r.created_at,
+            resolved_at: r.resolved_at,
+            expires_at: r.expires_at,
+            evidence: typeof r.evidence === 'string' ? JSON.parse(r.evidence) : r.evidence ?? {},
+        };
+    }
+}
+//# sourceMappingURL=tracker.js.map

package/dist/prediction/tracker.js.map

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

package/dist/prediction/types.d.ts

@@ -0,0 +1,85 @@
+export type PredictionDomain = 'error' | 'trade' | 'engagement' | 'metric' | 'custom';
+export type PredictionStatus = 'pending' | 'correct' | 'wrong' | 'expired' | 'partial';
+export interface PredictionEngineConfig {
+    brainName: string;
+    /** Default forecast horizon in ms. Default: 3_600_000 (1h) */
+    defaultHorizonMs?: number;
+    /** Max time before prediction expires in ms. Default: 86_400_000 (24h) */
+    expirationMs?: number;
+    /** EWMA smoothing factor (0–1). Default: 0.3 */
+    ewmaAlpha?: number;
+    /** Holt-Winters trend smoothing factor (0–1). Default: 0.1 */
+    trendBeta?: number;
+    /** Min data points for Holt-Winters (falls back to EWMA below). Default: 5 */
+    minDataPoints?: number;
+    /** Predictions below this confidence are suppressed. Default: 0.3 */
+    minConfidence?: number;
+    /** Max predictions generated per autoPredictAll cycle. Default: 5 */
+    maxPredictionsPerCycle?: number;
+    /** Interval for resolving expired predictions in ms. Default: 60_000 (1 min) */
+    resolveIntervalMs?: number;
+}
+export interface Prediction {
+    prediction_id: string;
+    domain: PredictionDomain;
+    metric: string;
+    predicted_value: number;
+    predicted_direction: 'up' | 'down' | 'stable';
+    confidence: number;
+    horizon_ms: number;
+    reasoning: string;
+    method: 'ewma' | 'holt_winters';
+    status: PredictionStatus;
+    actual_value?: number;
+    error?: number;
+    created_at: number;
+    resolved_at?: number;
+    expires_at: number;
+    evidence: Record<string, unknown>;
+}
+export interface PredictionAccuracy {
+    domain: PredictionDomain;
+    total: number;
+    correct: number;
+    wrong: number;
+    partial: number;
+    expired: number;
+    accuracy_rate: number;
+    mean_absolute_error: number;
+    calibration_score: number;
+    direction_accuracy: number;
+}
+export interface PredictionSummary {
+    total_predictions: number;
+    pending: number;
+    resolved: number;
+    accuracy_rate: number;
+    by_domain: PredictionAccuracy[];
+    calibration_offset: number;
+    recent: Prediction[];
+}
+export interface ForecastResult {
+    value: number;
+    trend: number;
+    confidence: number;
+    direction: 'up' | 'down' | 'stable';
+    method: 'ewma' | 'holt_winters';
+    dataPoints: number;
+}
+export interface PredictionInput {
+    domain: PredictionDomain;
+    metric: string;
+    horizon_ms?: number;
+    reasoning?: string;
+    evidence?: Record<string, unknown>;
+}
+export interface MetricDataPoint {
+    value: number;
+    timestamp: number;
+}
+export interface CalibrationBucket {
+    range_start: number;
+    range_end: number;
+    predicted_count: number;
+    actual_accuracy: number;
+}

package/dist/prediction/types.js

@@ -0,0 +1,3 @@
+// ── Prediction Engine Types ─────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/prediction/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/prediction/types.ts"],"names":[],"mappings":"AAAA,+DAA+D"}