@higher.archi/boe 1.0.17 → 1.0.19

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";
+export type RuleSetMode = "forward" | "scoring" | "backward" | "sequential" | "fuzzy" | "bayesian" | "monte-carlo" | "state-machine" | "constraint" | "utility" | "defeasible" | "expert" | "pricing" | "ensemble";
 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,CAAC;AAEtM,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,CAAC;AAEnN,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/ensemble/compiler.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ensemble Engine Compiler
+ *
+ * Validates and compiles an EnsembleRuleSet into a CompiledEnsembleRuleSet.
+ */
+import type { TierDefinition } from '../scoring/types';
+import type { EnsembleRuleSet, CompiledEnsembleRuleSet } from './types';
+/**
+ * Compile an ensemble ruleset — validates members, weights, and config,
+ * then tags each member with its type for runtime dispatch.
+ */
+export declare function compileEnsembleRuleSet<T extends TierDefinition = TierDefinition>(ruleSet: EnsembleRuleSet<T>): CompiledEnsembleRuleSet<T>;
+//# sourceMappingURL=compiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/engines/ensemble/compiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EAExB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC9E,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,uBAAuB,CAAC,CAAC,CAAC,CA2E5B"}

package/dist/engines/ensemble/compiler.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Ensemble Engine Compiler
+ *
+ * Validates and compiles an EnsembleRuleSet into a CompiledEnsembleRuleSet.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileEnsembleRuleSet = compileEnsembleRuleSet;
+const core_1 = require("../../core");
+/**
+ * Compile an ensemble ruleset — validates members, weights, and config,
+ * then tags each member with its type for runtime dispatch.
+ */
+function compileEnsembleRuleSet(ruleSet) {
+    const { members, config } = ruleSet;
+    // Members array must be non-empty
+    if (!members || members.length === 0) {
+        throw new core_1.CompilationError(`Ensemble "${ruleSet.id}": must have at least one member`);
+    }
+    // No duplicate member IDs
+    const ids = new Set();
+    for (const member of members) {
+        if (ids.has(member.id)) {
+            throw new core_1.CompilationError(`Ensemble "${ruleSet.id}": duplicate member id "${member.id}"`);
+        }
+        ids.add(member.id);
+    }
+    // All weights must be > 0
+    for (const member of members) {
+        if (member.weight <= 0) {
+            throw new core_1.CompilationError(`Ensemble "${ruleSet.id}": member "${member.id}" weight must be > 0 (got ${member.weight})`);
+        }
+    }
+    // For weighted-average and voting: weights must sum to ~1.0
+    if (config.strategy === 'weighted-average' || config.strategy === 'voting') {
+        const total = members.reduce((sum, m) => sum + m.weight, 0);
+        if (Math.abs(total - 1.0) > 0.001) {
+            throw new core_1.CompilationError(`Ensemble "${ruleSet.id}": member weights must sum to 1.0 for strategy "${config.strategy}" (got ${total})`);
+        }
+    }
+    // For stacking: config.stacking must be provided
+    if (config.strategy === 'stacking' && !config.stacking) {
+        throw new core_1.CompilationError(`Ensemble "${ruleSet.id}": strategy "stacking" requires config.stacking to be provided`);
+    }
+    // Tier IDs must be unique if tiers are configured
+    if (config.tiers && config.tiers.length > 0) {
+        const tierIds = new Set();
+        for (const tier of config.tiers) {
+            if (tierIds.has(tier.id)) {
+                throw new core_1.CompilationError(`Ensemble "${ruleSet.id}": duplicate tier id "${tier.id}"`);
+            }
+            tierIds.add(tier.id);
+        }
+    }
+    // Tag each member with type
+    const compiledMembers = members.map(member => {
+        if ('ruleset' in member) {
+            return { ...member, type: 'scoring' };
+        }
+        return { ...member, type: 'custom' };
+    });
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'ensemble',
+        members: compiledMembers,
+        config
+    };
+}
+//# sourceMappingURL=compiler.js.map

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * Ensemble Engine
+ *
+ * Self-contained engine for multi-model score fusion.
+ * Orchestrates N member executions and fuses their results
+ * using configurable strategies.
+ */
+import { WorkingMemory, Fact, FactInput, FactChange } from '../../core';
+import type { TierDefinition } from '../scoring/types';
+import type { CompiledEnsembleRuleSet, EnsembleOptions, EnsembleResult } from './types';
+/**
+ * Ensemble rule engine.
+ *
+ * Executes multiple member scoring rulesets (or custom executors) and fuses
+ * their results into a single composite score using configurable strategies.
+ *
+ * @example
+ * ```typescript
+ * const engine = new EnsembleEngine();
+ * engine.add({ type: 'Vendor', data: { revenue: 500000, compliance: true } });
+ *
+ * const result = engine.execute(compiledEnsemble);
+ * console.log(`Composite score: ${result.totalScore}`);
+ * console.log(`Agreement: ${result.agreement}`);
+ * ```
+ */
+export declare class EnsembleEngine {
+    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 an ensemble ruleset.
+     *
+     * Collects all facts from working memory, executes each member engine
+     * with its own independent working memory, and fuses results using
+     * the configured strategy.
+     *
+     * @param ruleSet - Compiled ensemble ruleset
+     * @param options - Runtime options (reserved for future use)
+     * @returns Ensemble result with fused score and per-member breakdown
+     */
+    execute<T extends TierDefinition = TierDefinition>(ruleSet: CompiledEnsembleRuleSet<T>, options?: EnsembleOptions): EnsembleResult<T>;
+    getWorkingMemory(): WorkingMemory;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engines/ensemble/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,aAAa,EACb,IAAI,EACJ,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EACf,cAAc,EACf,MAAM,SAAS,CAAC;AAIjB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,QAAQ,CAAmB;gBAEvB,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;;;;;;;;;;OAUG;IACH,OAAO,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC/C,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,EACnC,OAAO,GAAE,eAAoB,GAC5B,cAAc,CAAC,CAAC,CAAC;IAUpB,gBAAgB,IAAI,aAAa;CAGlC"}

package/dist/engines/ensemble/engine.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Ensemble Engine
+ *
+ * Self-contained engine for multi-model score fusion.
+ * Orchestrates N member executions and fuses their results
+ * using configurable strategies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnsembleEngine = void 0;
+const core_1 = require("../../core");
+const strategy_1 = require("./strategy");
+/**
+ * Ensemble rule engine.
+ *
+ * Executes multiple member scoring rulesets (or custom executors) and fuses
+ * their results into a single composite score using configurable strategies.
+ *
+ * @example
+ * ```typescript
+ * const engine = new EnsembleEngine();
+ * engine.add({ type: 'Vendor', data: { revenue: 500000, compliance: true } });
+ *
+ * const result = engine.execute(compiledEnsemble);
+ * console.log(`Composite score: ${result.totalScore}`);
+ * console.log(`Agreement: ${result.agreement}`);
+ * ```
+ */
+class EnsembleEngine {
+    wm;
+    strategy;
+    constructor(workingMemory) {
+        this.wm = workingMemory ?? new core_1.WorkingMemory();
+        this.strategy = new strategy_1.EnsembleStrategy();
+    }
+    // ========================================
+    // 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 an ensemble ruleset.
+     *
+     * Collects all facts from working memory, executes each member engine
+     * with its own independent working memory, and fuses results using
+     * the configured strategy.
+     *
+     * @param ruleSet - Compiled ensemble ruleset
+     * @param options - Runtime options (reserved for future use)
+     * @returns Ensemble result with fused score and per-member breakdown
+     */
+    execute(ruleSet, options = {}) {
+        // Collect all facts from WM as FactInput[] so each sub-engine gets its own fresh WM
+        const facts = this.wm.getAll().map(f => ({ type: f.type, data: f.data, id: f.id }));
+        return this.strategy.run(ruleSet, facts, options);
+    }
+    // ========================================
+    // Utility Methods
+    // ========================================
+    getWorkingMemory() {
+        return this.wm;
+    }
+}
+exports.EnsembleEngine = EnsembleEngine;
+//# sourceMappingURL=engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/engines/ensemble/engine.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,qCAKoB;AAUpB,yCAA8C;AAE9C;;;;;;;;;;;;;;;GAeG;AACH,MAAa,cAAc;IACjB,EAAE,CAAgB;IAClB,QAAQ,CAAmB;IAEnC,YAAY,aAA6B;QACvC,IAAI,CAAC,EAAE,GAAG,aAAa,IAAI,IAAI,oBAAa,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,2BAAgB,EAAE,CAAC;IACzC,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;;;;;;;;;;OAUG;IACH,OAAO,CACL,OAAmC,EACnC,UAA2B,EAAE;QAE7B,oFAAoF;QACpF,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,2CAA2C;IAC3C,kBAAkB;IAClB,2CAA2C;IAE3C,gBAAgB;QACd,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF;AAxFD,wCAwFC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Ensemble Engine — Multi-Model Score Fusion
+ */
+export type { FusionStrategy, ScoreExtractor, ConfidenceExtractor, ScoringMemberDef, CustomMemberDef, EnsembleMemberDef, StackingConfig, EnsembleConfig, EnsembleRuleSet, CompiledEnsembleMember, CompiledEnsembleRuleSet, EnsembleOptions, MemberResult, EnsembleResult, EnsembleSummaryOptions } from './types';
+export { compileEnsembleRuleSet } from './compiler';
+export { EnsembleStrategy, ensembleStrategy } from './strategy';
+export { EnsembleEngine } from './engine';
+export { summarizeEnsemble } from './summary';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engines/ensemble/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}

package/dist/engines/ensemble/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Ensemble Engine — Multi-Model Score Fusion
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeEnsemble = exports.EnsembleEngine = exports.ensembleStrategy = exports.EnsembleStrategy = exports.compileEnsembleRuleSet = void 0;
+// Compiler
+var compiler_1 = require("./compiler");
+Object.defineProperty(exports, "compileEnsembleRuleSet", { enumerable: true, get: function () { return compiler_1.compileEnsembleRuleSet; } });
+// Strategy
+var strategy_1 = require("./strategy");
+Object.defineProperty(exports, "EnsembleStrategy", { enumerable: true, get: function () { return strategy_1.EnsembleStrategy; } });
+Object.defineProperty(exports, "ensembleStrategy", { enumerable: true, get: function () { return strategy_1.ensembleStrategy; } });
+// Engine
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "EnsembleEngine", { enumerable: true, get: function () { return engine_1.EnsembleEngine; } });
+// Summary
+var summary_1 = require("./summary");
+Object.defineProperty(exports, "summarizeEnsemble", { enumerable: true, get: function () { return summary_1.summarizeEnsemble; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engines/ensemble/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAqBH,WAAW;AACX,uCAAoD;AAA3C,kHAAA,sBAAsB,OAAA;AAE/B,WAAW;AACX,uCAAgE;AAAvD,4GAAA,gBAAgB,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAE3C,SAAS;AACT,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AAEvB,UAAU;AACV,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA"}

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

@@ -0,0 +1,14 @@
+/**
+ * Ensemble Engine Strategy
+ *
+ * Executes N member engines and fuses their results using configurable
+ * fusion strategies (weighted-average, median, min, max, voting, stacking).
+ */
+import type { TierDefinition } from '../scoring/types';
+import type { FactInput } from '../../core';
+import type { CompiledEnsembleRuleSet, EnsembleOptions, EnsembleResult } from './types';
+export declare class EnsembleStrategy {
+    run<T extends TierDefinition = TierDefinition>(ruleSet: CompiledEnsembleRuleSet<T>, facts: FactInput[], _options: EnsembleOptions): EnsembleResult<T>;
+}
+export declare const ensembleStrategy: EnsembleStrategy;
+//# sourceMappingURL=strategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/engines/ensemble/strategy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAoB,cAAc,EAAgB,MAAM,kBAAkB,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EACf,cAAc,EAEf,MAAM,SAAS,CAAC;AAqBjB,qBAAa,gBAAgB;IAC3B,GAAG,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC3C,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,EACnC,KAAK,EAAE,SAAS,EAAE,EAClB,QAAQ,EAAE,eAAe,GACxB,cAAc,CAAC,CAAC,CAAC;CA2LrB;AAiCD,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/engines/ensemble/strategy.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * Ensemble Engine Strategy
+ *
+ * Executes N member engines and fuses their results using configurable
+ * fusion strategies (weighted-average, median, min, max, voting, stacking).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensembleStrategy = exports.EnsembleStrategy = void 0;
+const engine_1 = require("../scoring/engine");
+// ========================================
+// Output Bounds (reused from scoring)
+// ========================================
+function resolveOutputBounds(bounds) {
+    if (typeof bounds === 'object')
+        return bounds;
+    switch (bounds) {
+        case 'percentage': return { min: 0, max: 100 };
+        case 'points': return { min: 0, max: 1000 };
+        case 'rating': return { min: 0, max: 10 };
+        case 'stars': return { min: 0, max: 5 };
+        case 'normalized': return { min: 0, max: 1 };
+    }
+}
+// ========================================
+// Strategy
+// ========================================
+class EnsembleStrategy {
+    run(ruleSet, facts, _options) {
+        const startTime = performance.now();
+        const { members, config } = ruleSet;
+        // 1. Execute all members
+        const memberResults = [];
+        const allFired = [];
+        for (const member of members) {
+            const memberStart = performance.now();
+            let score;
+            let confidence;
+            if (member.type === 'scoring') {
+                const engine = new engine_1.ScoringEngine();
+                for (const fact of facts) {
+                    engine.add(fact);
+                }
+                const result = engine.execute(member.ruleset, member.options);
+                score = result.totalScore;
+                confidence = result.confidence;
+                // Collect fired rules
+                for (const ruleId of result.fired) {
+                    if (!allFired.includes(ruleId)) {
+                        allFired.push(ruleId);
+                    }
+                }
+            }
+            else {
+                const result = member.execute(facts);
+                score = member.extractScore(result);
+                confidence = member.extractConfidence ? member.extractConfidence(result) : 1.0;
+            }
+            const memberTime = Math.round((performance.now() - memberStart) * 100) / 100;
+            memberResults.push({
+                memberId: member.id,
+                memberName: member.name,
+                score,
+                confidence,
+                weight: member.weight,
+                weightedScore: score * member.weight,
+                executionTimeMs: memberTime
+            });
+        }
+        // 2. Fuse by strategy
+        let fusedScore;
+        let fusedConfidence;
+        switch (config.strategy) {
+            case 'weighted-average': {
+                fusedScore = memberResults.reduce((sum, m) => sum + m.score * m.weight, 0);
+                fusedConfidence = memberResults.reduce((sum, m) => sum + m.confidence * m.weight, 0);
+                break;
+            }
+            case 'median': {
+                const sortedScores = [...memberResults].sort((a, b) => a.score - b.score);
+                const sortedConfidences = [...memberResults].sort((a, b) => a.confidence - b.confidence);
+                const mid = Math.floor(sortedScores.length / 2);
+                if (sortedScores.length % 2 === 0) {
+                    fusedScore = (sortedScores[mid - 1].score + sortedScores[mid].score) / 2;
+                    fusedConfidence = (sortedConfidences[mid - 1].confidence + sortedConfidences[mid].confidence) / 2;
+                }
+                else {
+                    fusedScore = sortedScores[mid].score;
+                    fusedConfidence = sortedConfidences[mid].confidence;
+                }
+                break;
+            }
+            case 'min': {
+                let minIdx = 0;
+                for (let i = 1; i < memberResults.length; i++) {
+                    if (memberResults[i].score < memberResults[minIdx].score) {
+                        minIdx = i;
+                    }
+                }
+                fusedScore = memberResults[minIdx].score;
+                fusedConfidence = memberResults[minIdx].confidence;
+                break;
+            }
+            case 'max': {
+                let maxIdx = 0;
+                for (let i = 1; i < memberResults.length; i++) {
+                    if (memberResults[i].score > memberResults[maxIdx].score) {
+                        maxIdx = i;
+                    }
+                }
+                fusedScore = memberResults[maxIdx].score;
+                fusedConfidence = memberResults[maxIdx].confidence;
+                break;
+            }
+            case 'voting': {
+                let winnerIdx = 0;
+                let maxProduct = memberResults[0].confidence * memberResults[0].weight;
+                for (let i = 1; i < memberResults.length; i++) {
+                    const product = memberResults[i].confidence * memberResults[i].weight;
+                    if (product > maxProduct) {
+                        maxProduct = product;
+                        winnerIdx = i;
+                    }
+                }
+                fusedScore = memberResults[winnerIdx].score;
+                fusedConfidence = memberResults[winnerIdx].confidence;
+                break;
+            }
+            case 'stacking': {
+                const stackingConfig = config.stacking;
+                const stackEngine = new engine_1.ScoringEngine();
+                // Add member scores as facts
+                for (const mr of memberResults) {
+                    stackEngine.add({
+                        type: 'EnsembleMemberScore',
+                        data: {
+                            memberId: mr.memberId,
+                            score: mr.score,
+                            confidence: mr.confidence
+                        }
+                    });
+                }
+                const stackResult = stackEngine.execute(stackingConfig.ruleset, stackingConfig.options);
+                fusedScore = stackResult.totalScore;
+                fusedConfidence = stackResult.confidence;
+                break;
+            }
+        }
+        // 3. Compute agreement: 1 - (stddev / (range / 2)), clamped to [0, 1]
+        const scores = memberResults.map(m => m.score);
+        const agreement = computeAgreement(scores, config.outputBounds);
+        // 4. Apply output bounds
+        if (config.outputBounds) {
+            const bounds = resolveOutputBounds(config.outputBounds);
+            fusedScore = Math.max(bounds.min, Math.min(bounds.max, fusedScore));
+        }
+        // 5. Match tier
+        let tier;
+        if (config.tiers && config.tiers.length > 0) {
+            const resolveThreshold = (t) => t === '-Infinity' ? Number.NEGATIVE_INFINITY : t;
+            const sortedTiers = [...config.tiers].sort((a, b) => resolveThreshold(b.threshold) - resolveThreshold(a.threshold));
+            for (const tierDef of sortedTiers) {
+                const threshold = resolveThreshold(tierDef.threshold);
+                if (fusedScore >= threshold) {
+                    tier = {
+                        ...tierDef,
+                        threshold
+                    };
+                    break;
+                }
+            }
+        }
+        // 6. Build contributions map
+        const contributions = {};
+        for (const mr of memberResults) {
+            contributions[mr.memberId] = mr.score;
+        }
+        const executionTimeMs = Math.round((performance.now() - startTime) * 100) / 100;
+        return {
+            totalScore: fusedScore,
+            confidence: fusedConfidence,
+            tier,
+            strategy: config.strategy,
+            memberResults,
+            agreement,
+            fired: allFired,
+            contributions,
+            executionTimeMs
+        };
+    }
+}
+exports.EnsembleStrategy = EnsembleStrategy;
+// ========================================
+// Agreement Calculation
+// ========================================
+function computeAgreement(scores, outputBounds) {
+    if (scores.length <= 1)
+        return 1;
+    // Compute stddev
+    const mean = scores.reduce((sum, s) => sum + s, 0) / scores.length;
+    const variance = scores.reduce((sum, s) => sum + (s - mean) ** 2, 0) / scores.length;
+    const stddev = Math.sqrt(variance);
+    // Determine range
+    let range;
+    if (outputBounds) {
+        const bounds = resolveOutputBounds(outputBounds);
+        range = bounds.max - bounds.min;
+    }
+    else {
+        const minScore = Math.min(...scores);
+        const maxScore = Math.max(...scores);
+        range = maxScore - minScore;
+    }
+    // Avoid division by zero — all scores identical
+    if (range === 0)
+        return 1;
+    const halfRange = range / 2;
+    return Math.max(0, Math.min(1, 1 - (stddev / halfRange)));
+}
+// Export a singleton instance for convenience
+exports.ensembleStrategy = new EnsembleStrategy();
+//# sourceMappingURL=strategy.js.map

package/dist/engines/ensemble/strategy.js.map

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

package/dist/engines/ensemble/summary.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Ensemble Summary
+ *
+ * Generates human-readable summary strings from ensemble results.
+ */
+import type { EnsembleResult, EnsembleSummaryOptions } from './types';
+/**
+ * Generate a human-readable summary string from an EnsembleResult.
+ *
+ * @param result - The ensemble result to summarize
+ * @param options - Optional display settings
+ * @returns Formatted multi-line summary string
+ *
+ * @example
+ * ```typescript
+ * const result = engine.execute(compiledEnsemble);
+ * console.log(summarizeEnsemble(result));
+ * ```
+ */
+export declare function summarizeEnsemble(result: EnsembleResult, options?: EnsembleSummaryOptions): string;
+//# sourceMappingURL=summary.d.ts.map

package/dist/engines/ensemble/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/engines/ensemble/summary.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,CAiCR"}