@higher.archi/boe 1.0.23 → 1.0.25

package/dist/core/types/rule.d.ts

@@ -21,7 +21,7 @@ export type ValidityDuration = {
     months?: number;
     from: string;
 };
-export type RuleSetMode = "forward" | "scoring" | "backward" | "sequential" | "fuzzy" | "bayesian" | "monte-carlo" | "state-machine" | "constraint" | "utility" | "defeasible" | "expert" | "pricing" | "ensemble" | "ranking";
+export type RuleSetMode = "forward" | "scoring" | "backward" | "sequential" | "fuzzy" | "bayesian" | "monte-carlo" | "state-machine" | "constraint" | "utility" | "defeasible" | "expert" | "pricing" | "ensemble" | "ranking" | "prediction";
 export type BaseRule = {
     id: string;
     name?: string;

package/dist/core/types/rule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../../src/core/types/rule.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAM7C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAMF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAMF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/N,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC;IAGjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IAGd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAMF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,CAAC;AAMF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAGzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IAGnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../../src/core/types/rule.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAM7C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAMF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAMF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAE9O,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC;IAGjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IAGd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAMF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,CAAC;AAMF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAGzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IAGnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/engines/prediction/compiler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Prediction Engine Compiler
+ *
+ * Validates prediction rulesets and resolves defaults.
+ */
+import type { PredictionRuleSet, CompiledPredictionRuleSet } from './types';
+/**
+ * Compile and validate a prediction ruleset.
+ */
+export declare function compilePredictionRuleSet(ruleSet: PredictionRuleSet): CompiledPredictionRuleSet;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/engines/prediction/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/engines/prediction/compiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EAI1B,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,iBAAiB,GACzB,yBAAyB,CA0E3B"}

package/dist/engines/prediction/compiler.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Prediction Engine Compiler
+ *
+ * Validates prediction rulesets and resolves defaults.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compilePredictionRuleSet = compilePredictionRuleSet;
+const errors_1 = require("../../core/errors");
+const types_1 = require("./types");
+/**
+ * Compile and validate a prediction ruleset.
+ */
+function compilePredictionRuleSet(ruleSet) {
+    // ---- Common validation ----
+    if (!ruleSet.id) {
+        throw new errors_1.CompilationError('Prediction ruleset requires an id');
+    }
+    if (ruleSet.mode !== 'prediction') {
+        throw new errors_1.CompilationError(`Expected mode 'prediction', got '${ruleSet.mode}'`);
+    }
+    if (!ruleSet.snapshotType || ruleSet.snapshotType.trim() === '') {
+        throw new errors_1.CompilationError('snapshotType is required and must be non-empty');
+    }
+    // Fields validation
+    if (!ruleSet.fields) {
+        throw new errors_1.CompilationError('fields mapping is required');
+    }
+    if (!ruleSet.fields.entityId || typeof ruleSet.fields.entityId !== 'string' || ruleSet.fields.entityId.trim() === '') {
+        throw new errors_1.CompilationError('fields.entityId is required and must be a non-empty string');
+    }
+    if (!ruleSet.fields.score || typeof ruleSet.fields.score !== 'string' || ruleSet.fields.score.trim() === '') {
+        throw new errors_1.CompilationError('fields.score is required and must be a non-empty string');
+    }
+    if (!ruleSet.fields.timestamp || typeof ruleSet.fields.timestamp !== 'string' || ruleSet.fields.timestamp.trim() === '') {
+        throw new errors_1.CompilationError('fields.timestamp is required and must be a non-empty string');
+    }
+    // Horizon
+    let horizonMs;
+    if ((0, types_1.isHorizonPreset)(ruleSet.horizon)) {
+        horizonMs = types_1.HORIZON_PRESET_VALUES[ruleSet.horizon];
+    }
+    else if (typeof ruleSet.horizon === 'number') {
+        if (ruleSet.horizon <= 0) {
+            throw new errors_1.CompilationError('horizon must be a positive number (milliseconds)');
+        }
+        horizonMs = ruleSet.horizon;
+    }
+    else {
+        throw new errors_1.CompilationError(`Invalid horizon: '${ruleSet.horizon}'`);
+    }
+    // Thresholds
+    const thresholds = ruleSet.thresholds ?? [];
+    if (thresholds.length > 0) {
+        const thresholdIds = new Set();
+        for (const t of thresholds) {
+            if (!t.id) {
+                throw new errors_1.CompilationError('Each threshold requires an id');
+            }
+            if (thresholdIds.has(t.id)) {
+                throw new errors_1.CompilationError(`Duplicate threshold id: '${t.id}'`);
+            }
+            thresholdIds.add(t.id);
+        }
+    }
+    // defaultTrend
+    if (ruleSet.defaultTrend !== undefined && typeof ruleSet.defaultTrend !== 'number') {
+        throw new errors_1.CompilationError('defaultTrend must be a number (score units per month)');
+    }
+    // ---- Strategy-specific ----
+    switch (ruleSet.strategy) {
+        case 'linear-regression':
+            return compileLinearRegression(ruleSet, horizonMs, thresholds);
+        case 'exponential-smoothing':
+            return compileExponentialSmoothing(ruleSet, horizonMs, thresholds);
+        case 'weighted-moving-average':
+            return compileWeightedMovingAverage(ruleSet, horizonMs, thresholds);
+        default:
+            throw new errors_1.CompilationError(`Unknown prediction strategy: '${ruleSet.strategy}'`);
+    }
+}
+function compileLinearRegression(ruleSet, horizonMs, thresholds) {
+    const stableThreshold = ruleSet.config?.stableThreshold ?? 0.001;
+    if (stableThreshold < 0) {
+        throw new errors_1.CompilationError('stableThreshold must be non-negative');
+    }
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'prediction',
+        strategy: 'linear-regression',
+        snapshotType: ruleSet.snapshotType,
+        fields: ruleSet.fields,
+        horizonMs,
+        thresholds: thresholds,
+        defaultTrend: ruleSet.defaultTrend,
+        config: { stableThreshold }
+    };
+}
+function compileExponentialSmoothing(ruleSet, horizonMs, thresholds) {
+    let alpha;
+    let beta;
+    const smoothing = ruleSet.config?.smoothing ?? 'balanced';
+    if ((0, types_1.isSmoothingPreset)(smoothing)) {
+        const preset = types_1.SMOOTHING_PRESET_VALUES[smoothing];
+        alpha = preset.alpha;
+        beta = preset.beta;
+    }
+    else if (typeof smoothing === 'object' && smoothing !== null) {
+        alpha = smoothing.alpha;
+        beta = smoothing.beta;
+        if (typeof alpha !== 'number' || alpha <= 0 || alpha > 1) {
+            throw new errors_1.CompilationError('smoothing.alpha must be a number in (0, 1]');
+        }
+        if (typeof beta !== 'number' || beta <= 0 || beta > 1) {
+            throw new errors_1.CompilationError('smoothing.beta must be a number in (0, 1]');
+        }
+    }
+    else {
+        throw new errors_1.CompilationError(`Invalid smoothing value: '${smoothing}'`);
+    }
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'prediction',
+        strategy: 'exponential-smoothing',
+        snapshotType: ruleSet.snapshotType,
+        fields: ruleSet.fields,
+        horizonMs,
+        thresholds: thresholds,
+        defaultTrend: ruleSet.defaultTrend,
+        config: { alpha, beta }
+    };
+}
+function compileWeightedMovingAverage(ruleSet, horizonMs, thresholds) {
+    const window = ruleSet.config?.window ?? 5;
+    if (!Number.isInteger(window) || window < 2) {
+        throw new errors_1.CompilationError('window must be a positive integer >= 2');
+    }
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'prediction',
+        strategy: 'weighted-moving-average',
+        snapshotType: ruleSet.snapshotType,
+        fields: ruleSet.fields,
+        horizonMs,
+        thresholds: thresholds,
+        defaultTrend: ruleSet.defaultTrend,
+        config: { window }
+    };
+}
+//# sourceMappingURL=compiler.js.map

package/dist/engines/prediction/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../../../src/engines/prediction/compiler.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAgBH,4DA4EC;AA1FD,8CAAqD;AASrD,mCAA6G;AAE7G;;GAEG;AACH,SAAgB,wBAAwB,CACtC,OAA0B;IAE1B,8BAA8B;IAE9B,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,yBAAgB,CAAC,mCAAmC,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAClC,MAAM,IAAI,yBAAgB,CAAC,oCAAoC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChE,MAAM,IAAI,yBAAgB,CAAC,gDAAgD,CAAC,CAAC;IAC/E,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,yBAAgB,CAAC,4BAA4B,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrH,MAAM,IAAI,yBAAgB,CAAC,4DAA4D,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5G,MAAM,IAAI,yBAAgB,CAAC,yDAAyD,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxH,MAAM,IAAI,yBAAgB,CAAC,6DAA6D,CAAC,CAAC;IAC5F,CAAC;IAED,UAAU;IACV,IAAI,SAAiB,CAAC;IACtB,IAAI,IAAA,uBAAe,EAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,SAAS,GAAG,6BAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;SAAM,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC/C,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,yBAAgB,CAAC,kDAAkD,CAAC,CAAC;QACjF,CAAC;QACD,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,yBAAgB,CAAC,qBAAqB,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;IACtE,CAAC;IAED,aAAa;IACb,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;IAC5C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACV,MAAM,IAAI,yBAAgB,CAAC,+BAA+B,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,yBAAgB,CAAC,4BAA4B,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAClE,CAAC;YACD,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnF,MAAM,IAAI,yBAAgB,CAAC,uDAAuD,CAAC,CAAC;IACtF,CAAC;IAED,8BAA8B;IAE9B,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,mBAAmB;YACtB,OAAO,uBAAuB,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACjE,KAAK,uBAAuB;YAC1B,OAAO,2BAA2B,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACrE,KAAK,yBAAyB;YAC5B,OAAO,4BAA4B,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACtE;YACE,MAAM,IAAI,yBAAgB,CAAC,iCAAkC,OAAe,CAAC,QAAQ,GAAG,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAC9B,OAA8D,EAC9D,SAAiB,EACjB,UAAgD;IAEhD,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,EAAE,eAAe,IAAI,KAAK,CAAC;IACjE,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,yBAAgB,CAAC,sCAAsC,CAAC,CAAC;IACrE,CAAC;IAED,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,mBAAmB;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS;QACT,UAAU,EAAE,UAAiB;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,EAAE,eAAe,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,OAAkE,EAClE,SAAiB,EACjB,UAAgD;IAEhD,IAAI,KAAa,CAAC;IAClB,IAAI,IAAY,CAAC;IAEjB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,IAAI,UAAU,CAAC;IAE1D,IAAI,IAAA,yBAAiB,EAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,+BAAuB,CAAC,SAAS,CAAC,CAAC;QAClD,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACrB,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;SAAM,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/D,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;QACxB,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,yBAAgB,CAAC,4CAA4C,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,yBAAgB,CAAC,2CAA2C,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,yBAAgB,CAAC,6BAA6B,SAAS,GAAG,CAAC,CAAC;IACxE,CAAC;IAED,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,uBAAuB;QACjC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS;QACT,UAAU,EAAE,UAAiB;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,OAAoE,EACpE,SAAiB,EACjB,UAAgD;IAEhD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,yBAAgB,CAAC,wCAAwC,CAAC,CAAC;IACvE,CAAC;IAED,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,yBAAyB;QACnC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS;QACT,UAAU,EAAE,UAAiB;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,EAAE,MAAM,EAAE;KACnB,CAAC;AACJ,CAAC"}

package/dist/engines/prediction/engine.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Prediction Engine
+ *
+ * Trajectory forecasting engine that takes historical score snapshots,
+ * fits a model, and projects forward. Supports linear regression,
+ * exponential smoothing, and weighted moving average strategies.
+ *
+ * @example
+ * ```typescript
+ * const engine = new PredictionEngine();
+ * engine.add({ type: 'VendorScore', data: { vendorId: 'acme', totalScore: 520, evaluatedAt: '2025-09-01' } });
+ * engine.add({ type: 'VendorScore', data: { vendorId: 'acme', totalScore: 580, evaluatedAt: '2025-12-01' } });
+ * engine.add({ type: 'VendorScore', data: { vendorId: 'acme', totalScore: 640, evaluatedAt: '2026-03-01' } });
+ *
+ * const result = engine.execute(compiledRuleset);
+ * console.log(result.predictions[0]); // { entityId: 'acme', trend: 'rising', trendSlope: 20, ... }
+ * ```
+ */
+import { WorkingMemory, Fact, FactInput, FactChange } from '../../core';
+import type { CompiledPredictionRuleSet, PredictionOptions, PredictionResult } from './types';
+export declare class PredictionEngine {
+    private wm;
+    private strategy;
+    constructor(workingMemory?: WorkingMemory);
+    add<T = Record<string, any>>(input: FactInput<T>): Fact<T>;
+    remove(factId: string): Fact | undefined;
+    update<T = Record<string, any>>(input: FactInput<T>): Fact<T>;
+    get(factId: string): Fact | undefined;
+    getByType(type: string): Fact[];
+    getAll(): Fact[];
+    has(factId: string): boolean;
+    size(): number;
+    clear(): void;
+    getChanges(): FactChange[];
+    clearChanges(): void;
+    /**
+     * Execute a prediction ruleset.
+     *
+     * Groups all snapshots of the configured type by entity,
+     * fits a trajectory model, and projects forward to the horizon.
+     *
+     * @param ruleSet - Compiled prediction ruleset
+     * @param options - Runtime options (onPredict callback, asOf for testing)
+     * @returns Prediction result with forecasts per entity
+     */
+    execute(ruleSet: CompiledPredictionRuleSet, options?: PredictionOptions): PredictionResult;
+    getWorkingMemory(): WorkingMemory;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engines/prediction/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engines/prediction/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,aAAa,EACb,IAAI,EACJ,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAIjB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,aAAa,CAAC,EAAE,aAAa;IASzC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAI1D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIxC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAI7D,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE;IAI/B,MAAM,IAAI,IAAI,EAAE;IAIhB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;IAIb,UAAU,IAAI,UAAU,EAAE;IAI1B,YAAY,IAAI,IAAI;IAQpB;;;;;;;;;OASG;IACH,OAAO,CACL,OAAO,EAAE,yBAAyB,EAClC,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB;IAQnB,gBAAgB,IAAI,aAAa;CAGlC"}

package/dist/engines/prediction/engine.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Prediction Engine
+ *
+ * Trajectory forecasting engine that takes historical score snapshots,
+ * fits a model, and projects forward. Supports linear regression,
+ * exponential smoothing, and weighted moving average strategies.
+ *
+ * @example
+ * ```typescript
+ * const engine = new PredictionEngine();
+ * engine.add({ type: 'VendorScore', data: { vendorId: 'acme', totalScore: 520, evaluatedAt: '2025-09-01' } });
+ * engine.add({ type: 'VendorScore', data: { vendorId: 'acme', totalScore: 580, evaluatedAt: '2025-12-01' } });
+ * engine.add({ type: 'VendorScore', data: { vendorId: 'acme', totalScore: 640, evaluatedAt: '2026-03-01' } });
+ *
+ * const result = engine.execute(compiledRuleset);
+ * console.log(result.predictions[0]); // { entityId: 'acme', trend: 'rising', trendSlope: 20, ... }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PredictionEngine = void 0;
+const core_1 = require("../../core");
+const strategy_1 = require("./strategy");
+class PredictionEngine {
+    wm;
+    strategy;
+    constructor(workingMemory) {
+        this.wm = workingMemory ?? new core_1.WorkingMemory();
+        this.strategy = new strategy_1.PredictionExecutor();
+    }
+    // ========================================
+    // IWorkingMemory Implementation
+    // ========================================
+    add(input) {
+        return this.wm.add(input);
+    }
+    remove(factId) {
+        return this.wm.remove(factId);
+    }
+    update(input) {
+        return this.wm.update(input);
+    }
+    get(factId) {
+        return this.wm.get(factId);
+    }
+    getByType(type) {
+        return this.wm.getByType(type);
+    }
+    getAll() {
+        return this.wm.getAll();
+    }
+    has(factId) {
+        return this.wm.has(factId);
+    }
+    size() {
+        return this.wm.size();
+    }
+    clear() {
+        this.wm.clear();
+    }
+    getChanges() {
+        return this.wm.getChanges();
+    }
+    clearChanges() {
+        this.wm.clearChanges();
+    }
+    // ========================================
+    // Engine Execution
+    // ========================================
+    /**
+     * Execute a prediction ruleset.
+     *
+     * Groups all snapshots of the configured type by entity,
+     * fits a trajectory model, and projects forward to the horizon.
+     *
+     * @param ruleSet - Compiled prediction ruleset
+     * @param options - Runtime options (onPredict callback, asOf for testing)
+     * @returns Prediction result with forecasts per entity
+     */
+    execute(ruleSet, options = {}) {
+        return this.strategy.run(ruleSet, this.wm, options);
+    }
+    // ========================================
+    // Utility Methods
+    // ========================================
+    getWorkingMemory() {
+        return this.wm;
+    }
+}
+exports.PredictionEngine = PredictionEngine;
+//# sourceMappingURL=engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/engines/prediction/engine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,qCAKoB;AAQpB,yCAAgD;AAEhD,MAAa,gBAAgB;IACnB,EAAE,CAAgB;IAClB,QAAQ,CAAqB;IAErC,YAAY,aAA6B;QACvC,IAAI,CAAC,EAAE,GAAG,aAAa,IAAI,IAAI,oBAAa,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,6BAAkB,EAAE,CAAC;IAC3C,CAAC;IAED,2CAA2C;IAC3C,gCAAgC;IAChC,2CAA2C;IAE3C,GAAG,CAA0B,KAAmB;QAC9C,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAA0B,KAAmB;QACjD,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED,YAAY;QACV,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC;IACzB,CAAC;IAED,2CAA2C;IAC3C,mBAAmB;IACnB,2CAA2C;IAE3C;;;;;;;;;OASG;IACH,OAAO,CACL,OAAkC,EAClC,UAA6B,EAAE;QAE/B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,2CAA2C;IAC3C,kBAAkB;IAClB,2CAA2C;IAE3C,gBAAgB;QACd,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF;AArFD,4CAqFC"}

package/dist/engines/prediction/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Prediction Engine — Trajectory Forecasting
+ */
+export type { PredictionStrategy, TrendDirection, SmoothingPreset, HorizonPreset, ConfidenceBracket, FieldMapping, ThresholdDefinition, LinearRegressionConfig, ExponentialSmoothingConfig, WeightedMovingAverageConfig, LinearRegressionRuleSet, ExponentialSmoothingRuleSet, WeightedMovingAverageRuleSet, PredictionRuleSet, CompiledLinearRegressionRuleSet, CompiledExponentialSmoothingRuleSet, CompiledWeightedMovingAverageRuleSet, CompiledPredictionRuleSet, ThresholdCrossing, Forecast, EntityPrediction, PredictionResult, PredictionOptions } from './types';
+export { SMOOTHING_PRESET_VALUES, HORIZON_PRESET_VALUES, isSmoothingPreset, isHorizonPreset, resolveConfidenceBracket, resolveTrendDirection } from './types';
+export { compilePredictionRuleSet } from './compiler';
+export { PredictionExecutor, predictionStrategy } from './strategy';
+export { PredictionEngine } from './engine';
+//# sourceMappingURL=index.d.ts.map

package/dist/engines/prediction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engines/prediction/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,iBAAiB,EACjB,+BAA+B,EAC/B,mCAAmC,EACnC,oCAAoC,EACpC,yBAAyB,EACzB,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGtD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/engines/prediction/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Prediction Engine — Trajectory Forecasting
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PredictionEngine = exports.predictionStrategy = exports.PredictionExecutor = exports.compilePredictionRuleSet = exports.resolveTrendDirection = exports.resolveConfidenceBracket = exports.isHorizonPreset = exports.isSmoothingPreset = exports.HORIZON_PRESET_VALUES = exports.SMOOTHING_PRESET_VALUES = void 0;
+// Constants & utilities
+var types_1 = require("./types");
+Object.defineProperty(exports, "SMOOTHING_PRESET_VALUES", { enumerable: true, get: function () { return types_1.SMOOTHING_PRESET_VALUES; } });
+Object.defineProperty(exports, "HORIZON_PRESET_VALUES", { enumerable: true, get: function () { return types_1.HORIZON_PRESET_VALUES; } });
+Object.defineProperty(exports, "isSmoothingPreset", { enumerable: true, get: function () { return types_1.isSmoothingPreset; } });
+Object.defineProperty(exports, "isHorizonPreset", { enumerable: true, get: function () { return types_1.isHorizonPreset; } });
+Object.defineProperty(exports, "resolveConfidenceBracket", { enumerable: true, get: function () { return types_1.resolveConfidenceBracket; } });
+Object.defineProperty(exports, "resolveTrendDirection", { enumerable: true, get: function () { return types_1.resolveTrendDirection; } });
+// Compiler
+var compiler_1 = require("./compiler");
+Object.defineProperty(exports, "compilePredictionRuleSet", { enumerable: true, get: function () { return compiler_1.compilePredictionRuleSet; } });
+// Strategy
+var strategy_1 = require("./strategy");
+Object.defineProperty(exports, "PredictionExecutor", { enumerable: true, get: function () { return strategy_1.PredictionExecutor; } });
+Object.defineProperty(exports, "predictionStrategy", { enumerable: true, get: function () { return strategy_1.predictionStrategy; } });
+// Engine
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "PredictionEngine", { enumerable: true, get: function () { return engine_1.PredictionEngine; } });
+//# sourceMappingURL=index.js.map

package/dist/engines/prediction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engines/prediction/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA6BH,wBAAwB;AACxB,iCAOiB;AANf,gHAAA,uBAAuB,OAAA;AACvB,8GAAA,qBAAqB,OAAA;AACrB,0GAAA,iBAAiB,OAAA;AACjB,wGAAA,eAAe,OAAA;AACf,iHAAA,wBAAwB,OAAA;AACxB,8GAAA,qBAAqB,OAAA;AAGvB,WAAW;AACX,uCAAsD;AAA7C,oHAAA,wBAAwB,OAAA;AAEjC,WAAW;AACX,uCAAoE;AAA3D,8GAAA,kBAAkB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAE/C,SAAS;AACT,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA"}

package/dist/engines/prediction/strategy.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Prediction Engine Strategy
+ *
+ * Core execution logic for all prediction strategies:
+ * - linear-regression: Least-squares line fit with R² confidence
+ * - exponential-smoothing: Holt's double exponential (level + trend)
+ * - weighted-moving-average: Rolling window with recency weighting
+ */
+import type { IWorkingMemory } from '../../core';
+import type { CompiledPredictionRuleSet, PredictionOptions, PredictionResult } from './types';
+export declare class PredictionExecutor {
+    run(ruleSet: CompiledPredictionRuleSet, wm: IWorkingMemory, options?: PredictionOptions): PredictionResult;
+    private runLinearRegression;
+    private runExponentialSmoothing;
+    private runWeightedMovingAverage;
+    private buildSinglePointPrediction;
+}
+/** Singleton instance */
+export declare const predictionStrategy: PredictionExecutor;
+//# sourceMappingURL=strategy.d.ts.map

package/dist/engines/prediction/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/engines/prediction/strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAQ,MAAM,YAAY,CAAC;AAEvD,OAAO,KAAK,EACV,yBAAyB,EAIzB,iBAAiB,EACjB,gBAAgB,EAIjB,MAAM,SAAS,CAAC;AAajB,qBAAa,kBAAkB;IAC7B,GAAG,CACD,OAAO,EAAE,yBAAyB,EAClC,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB;IAyDnB,OAAO,CAAC,mBAAmB;IAwH3B,OAAO,CAAC,uBAAuB;IAwH/B,OAAO,CAAC,wBAAwB;IAqFhC,OAAO,CAAC,0BAA0B;CA0CnC;AA4GD,yBAAyB;AACzB,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}