@higher.archi/boe 1.0.21 → 1.0.22

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";
+export type RuleSetMode = "forward" | "scoring" | "backward" | "sequential" | "fuzzy" | "bayesian" | "monte-carlo" | "state-machine" | "constraint" | "utility" | "defeasible" | "expert" | "pricing" | "ensemble" | "ranking";
 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,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"}
+{"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"}

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

@@ -0,0 +1,12 @@
+/**
+ * Ranking Engine Compiler
+ *
+ * Validates ranking rulesets and resolves defaults.
+ */
+import type { TierDefinition } from '../scoring/types';
+import type { RankingRuleSet, CompiledRankingRuleSet } from './types';
+/**
+ * Compile and validate a ranking ruleset.
+ */
+export declare function compileRankingRuleSet<T extends TierDefinition = TierDefinition>(ruleSet: RankingRuleSet<T>): CompiledRankingRuleSet<T>;
+//# sourceMappingURL=compiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/engines/ranking/compiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EAMvB,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC7E,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,sBAAsB,CAAC,CAAC,CAAC,CAuB3B"}

package/dist/engines/ranking/compiler.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Ranking Engine Compiler
+ *
+ * Validates ranking rulesets and resolves defaults.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileRankingRuleSet = compileRankingRuleSet;
+const errors_1 = require("../../core/errors");
+const types_1 = require("../utility/types");
+const types_2 = require("./types");
+/**
+ * Compile and validate a ranking ruleset.
+ */
+function compileRankingRuleSet(ruleSet) {
+    if (!ruleSet.id) {
+        throw new errors_1.CompilationError('Ranking ruleset requires an id');
+    }
+    if (ruleSet.mode !== 'ranking') {
+        throw new errors_1.CompilationError(`Expected mode 'ranking', got '${ruleSet.mode}'`);
+    }
+    if (!ruleSet.entityType || ruleSet.entityType.trim() === '') {
+        throw new errors_1.CompilationError('entityType is required and must be non-empty');
+    }
+    switch (ruleSet.strategy) {
+        case 'score':
+            return compileScore(ruleSet);
+        case 'elo':
+            return compileElo(ruleSet);
+        case 'head-to-head':
+            return compileHeadToHead(ruleSet);
+        default:
+            throw new errors_1.CompilationError(`Unknown ranking strategy: '${ruleSet.strategy}'`);
+    }
+}
+function compileScore(ruleSet) {
+    if (!ruleSet.scoringRuleset) {
+        throw new errors_1.CompilationError('Score strategy requires a scoringRuleset');
+    }
+    if (ruleSet.scoringRuleset.mode !== 'scoring') {
+        throw new errors_1.CompilationError(`scoringRuleset must have mode 'scoring', got '${ruleSet.scoringRuleset.mode}'`);
+    }
+    // Validate tier IDs are unique
+    const tiers = ruleSet.config?.tiers;
+    if (tiers) {
+        const tierIds = new Set();
+        for (const tier of tiers) {
+            if (tierIds.has(tier.id)) {
+                throw new errors_1.CompilationError(`Duplicate tier id: '${tier.id}'`);
+            }
+            tierIds.add(tier.id);
+        }
+    }
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'ranking',
+        strategy: 'score',
+        scoringRuleset: ruleSet.scoringRuleset,
+        scoringOptions: ruleSet.scoringOptions,
+        entityType: ruleSet.entityType,
+        config: {
+            direction: ruleSet.config?.direction ?? 'highest-first',
+            tiers: ruleSet.config?.tiers
+        }
+    };
+}
+function compileElo(ruleSet) {
+    const config = ruleSet.config ?? {};
+    // Resolve kFactor
+    let kFactor;
+    if (config.kFactor === undefined) {
+        kFactor = types_2.K_FACTOR_VALUES['standard'];
+    }
+    else if ((0, types_2.isKFactorPreset)(config.kFactor)) {
+        kFactor = types_2.K_FACTOR_VALUES[config.kFactor];
+    }
+    else if (typeof config.kFactor === 'number') {
+        if (config.kFactor <= 0) {
+            throw new errors_1.CompilationError('kFactor must be a positive number');
+        }
+        kFactor = config.kFactor;
+    }
+    else {
+        throw new errors_1.CompilationError(`Invalid kFactor: '${config.kFactor}'`);
+    }
+    const initialRating = config.initialRating ?? 1500;
+    if (initialRating <= 0) {
+        throw new errors_1.CompilationError('initialRating must be a positive number');
+    }
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'ranking',
+        strategy: 'elo',
+        entityType: ruleSet.entityType,
+        matchType: ruleSet.matchType ?? 'MatchResult',
+        config: {
+            initialRating,
+            kFactor,
+            direction: config.direction ?? 'highest-first'
+        }
+    };
+}
+function compileHeadToHead(ruleSet) {
+    const criteria = ruleSet.criteria;
+    if (!criteria || !Array.isArray(criteria) || criteria.length === 0) {
+        throw new errors_1.CompilationError('Head-to-head strategy requires at least one criterion');
+    }
+    // Validate no duplicate criterion IDs
+    const criterionIds = new Set();
+    for (const c of criteria) {
+        if (!c.id) {
+            throw new errors_1.CompilationError('Each criterion requires an id');
+        }
+        if (criterionIds.has(c.id)) {
+            throw new errors_1.CompilationError(`Duplicate criterion id: '${c.id}'`);
+        }
+        criterionIds.add(c.id);
+    }
+    // Resolve semantic weights to numeric
+    const resolvedCriteria = criteria.map((c) => {
+        let weight;
+        if ((0, types_1.isSemanticPriority)(c.weight)) {
+            weight = types_1.SEMANTIC_PRIORITY_VALUES[c.weight];
+        }
+        else if (typeof c.weight === 'number') {
+            weight = c.weight;
+        }
+        else {
+            throw new errors_1.CompilationError(`Invalid weight for criterion '${c.id}': '${c.weight}'`);
+        }
+        if (!c.direction) {
+            throw new errors_1.CompilationError(`Criterion '${c.id}' requires a direction`);
+        }
+        return {
+            id: c.id,
+            name: c.name,
+            weight,
+            direction: c.direction
+        };
+    });
+    // Normalize weights to sum to 1.0
+    const totalWeight = resolvedCriteria.reduce((sum, c) => sum + c.weight, 0);
+    if (totalWeight === 0) {
+        throw new errors_1.CompilationError('Criteria weights must not all be zero');
+    }
+    for (const c of resolvedCriteria) {
+        c.weight = c.weight / totalWeight;
+    }
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'ranking',
+        strategy: 'head-to-head',
+        entityType: ruleSet.entityType,
+        criteria: resolvedCriteria,
+        config: {
+            direction: ruleSet.config?.direction ?? 'highest-first'
+        }
+    };
+}
+//# sourceMappingURL=compiler.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * Ranking Engine
+ *
+ * Comparative scoring engine that ranks N entities relative to each other.
+ * Supports score-based ranking, Elo ratings, and head-to-head comparison.
+ *
+ * @example
+ * ```typescript
+ * const engine = new RankingEngine();
+ * engine.add({ type: 'Vendor', data: { id: 'v1', revenue: 500000 } });
+ * engine.add({ type: 'Vendor', data: { id: 'v2', revenue: 120000 } });
+ *
+ * const result = engine.execute(compiledRanking);
+ * console.log(result.rankings[0]); // { rank: 1, entityId: 'v1', percentileLabel: 'top-1%', ... }
+ * ```
+ */
+import { WorkingMemory, Fact, FactInput, FactChange } from '../../core';
+import type { TierDefinition } from '../scoring/types';
+import type { CompiledRankingRuleSet, RankingOptions, RankingResult } from './types';
+export declare class RankingEngine {
+    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 ranking ruleset.
+     *
+     * Scores all entities of the configured type and produces
+     * a ranked list with percentiles and optional tier/movement tracking.
+     *
+     * @param ruleSet - Compiled ranking ruleset
+     * @param options - Runtime options (previousRankings for movement, onRank callback)
+     * @returns Ranking result with sorted entities
+     */
+    execute<T extends TierDefinition = TierDefinition>(ruleSet: CompiledRankingRuleSet<T>, options?: RankingOptions): RankingResult<T>;
+    getWorkingMemory(): WorkingMemory;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engines/ranking/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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,sBAAsB,EACtB,cAAc,EACd,aAAa,EACd,MAAM,SAAS,CAAC;AAIjB,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,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,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC/C,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAClC,OAAO,GAAE,cAAmB,GAC3B,aAAa,CAAC,CAAC,CAAC;IAQnB,gBAAgB,IAAI,aAAa;CAGlC"}

package/dist/engines/ranking/engine.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Ranking Engine
+ *
+ * Comparative scoring engine that ranks N entities relative to each other.
+ * Supports score-based ranking, Elo ratings, and head-to-head comparison.
+ *
+ * @example
+ * ```typescript
+ * const engine = new RankingEngine();
+ * engine.add({ type: 'Vendor', data: { id: 'v1', revenue: 500000 } });
+ * engine.add({ type: 'Vendor', data: { id: 'v2', revenue: 120000 } });
+ *
+ * const result = engine.execute(compiledRanking);
+ * console.log(result.rankings[0]); // { rank: 1, entityId: 'v1', percentileLabel: 'top-1%', ... }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RankingEngine = void 0;
+const core_1 = require("../../core");
+const strategy_1 = require("./strategy");
+class RankingEngine {
+    wm;
+    strategy;
+    constructor(workingMemory) {
+        this.wm = workingMemory ?? new core_1.WorkingMemory();
+        this.strategy = new strategy_1.RankingExecutor();
+    }
+    // ========================================
+    // 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 ranking ruleset.
+     *
+     * Scores all entities of the configured type and produces
+     * a ranked list with percentiles and optional tier/movement tracking.
+     *
+     * @param ruleSet - Compiled ranking ruleset
+     * @param options - Runtime options (previousRankings for movement, onRank callback)
+     * @returns Ranking result with sorted entities
+     */
+    execute(ruleSet, options = {}) {
+        return this.strategy.run(ruleSet, this.wm, options);
+    }
+    // ========================================
+    // Utility Methods
+    // ========================================
+    getWorkingMemory() {
+        return this.wm;
+    }
+}
+exports.RankingEngine = RankingEngine;
+//# sourceMappingURL=engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/engines/ranking/engine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,qCAKoB;AAUpB,yCAA6C;AAE7C,MAAa,aAAa;IAChB,EAAE,CAAgB;IAClB,QAAQ,CAAkB;IAElC,YAAY,aAA6B;QACvC,IAAI,CAAC,EAAE,GAAG,aAAa,IAAI,IAAI,oBAAa,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,0BAAe,EAAE,CAAC;IACxC,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,UAA0B,EAAE;QAE5B,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,sCAqFC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Ranking Engine — Comparative Entity Ranking
+ */
+export type { RankingStrategy, RankingDirection, PercentileLabel, Movement, KFactorPreset, RankingCriterion, CompiledRankingCriterion, ScoreRankingConfig, EloConfig, HeadToHeadConfig, ScoreRankingRuleSet, EloRankingRuleSet, HeadToHeadRankingRuleSet, RankingRuleSet, CompiledScoreRankingRuleSet, CompiledEloRankingRuleSet, CompiledHeadToHeadRankingRuleSet, CompiledRankingRuleSet, PreviousRanking, RankingOptions, RankedEntity, RankingResult } from './types';
+export { K_FACTOR_VALUES, isKFactorPreset, resolvePercentileLabel, resolveMovement } from './types';
+export { compileRankingRuleSet } from './compiler';
+export { RankingExecutor, rankingStrategy } from './strategy';
+export { RankingEngine } from './engine';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engines/ranking/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,2BAA2B,EAC3B,yBAAyB,EACzB,gCAAgC,EAChC,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,aAAa,EACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,eAAe,EAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/engines/ranking/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Ranking Engine — Comparative Entity Ranking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RankingEngine = exports.rankingStrategy = exports.RankingExecutor = exports.compileRankingRuleSet = exports.resolveMovement = exports.resolvePercentileLabel = exports.isKFactorPreset = exports.K_FACTOR_VALUES = void 0;
+// Constants & utilities
+var types_1 = require("./types");
+Object.defineProperty(exports, "K_FACTOR_VALUES", { enumerable: true, get: function () { return types_1.K_FACTOR_VALUES; } });
+Object.defineProperty(exports, "isKFactorPreset", { enumerable: true, get: function () { return types_1.isKFactorPreset; } });
+Object.defineProperty(exports, "resolvePercentileLabel", { enumerable: true, get: function () { return types_1.resolvePercentileLabel; } });
+Object.defineProperty(exports, "resolveMovement", { enumerable: true, get: function () { return types_1.resolveMovement; } });
+// Compiler
+var compiler_1 = require("./compiler");
+Object.defineProperty(exports, "compileRankingRuleSet", { enumerable: true, get: function () { return compiler_1.compileRankingRuleSet; } });
+// Strategy
+var strategy_1 = require("./strategy");
+Object.defineProperty(exports, "RankingExecutor", { enumerable: true, get: function () { return strategy_1.RankingExecutor; } });
+Object.defineProperty(exports, "rankingStrategy", { enumerable: true, get: function () { return strategy_1.rankingStrategy; } });
+// Engine
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "RankingEngine", { enumerable: true, get: function () { return engine_1.RankingEngine; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engines/ranking/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA4BH,wBAAwB;AACxB,iCAKiB;AAJf,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,+GAAA,sBAAsB,OAAA;AACtB,wGAAA,eAAe,OAAA;AAGjB,WAAW;AACX,uCAAmD;AAA1C,iHAAA,qBAAqB,OAAA;AAE9B,WAAW;AACX,uCAA8D;AAArD,2GAAA,eAAe,OAAA;AAAE,2GAAA,eAAe,OAAA;AAEzC,SAAS;AACT,mCAAyC;AAAhC,uGAAA,aAAa,OAAA"}

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

@@ -0,0 +1,21 @@
+/**
+ * Ranking Engine Strategy
+ *
+ * Core execution logic for all ranking strategies:
+ * - score: Delegates to ScoringEngine, ranks by totalScore
+ * - elo: Processes match history, computes Elo ratings
+ * - head-to-head: Pairwise comparison on weighted criteria
+ */
+import type { IWorkingMemory } from '../../core';
+import type { TierDefinition } from '../scoring/types';
+import type { CompiledRankingRuleSet, RankingOptions, RankingResult } from './types';
+export declare class RankingExecutor {
+    run<T extends TierDefinition = TierDefinition>(ruleSet: CompiledRankingRuleSet<T>, wm: IWorkingMemory, options?: RankingOptions): RankingResult<T>;
+    private runScore;
+    private runElo;
+    private runHeadToHead;
+    private buildRankedEntities;
+}
+/** Singleton instance */
+export declare const rankingStrategy: RankingExecutor;
+//# sourceMappingURL=strategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/engines/ranking/strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAQ,MAAM,YAAY,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,kBAAkB,CAAC;AAEzE,OAAO,KAAK,EACV,sBAAsB,EAItB,cAAc,EACd,aAAa,EAId,MAAM,SAAS,CAAC;AAGjB,qBAAa,eAAe;IAC1B,GAAG,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAC3C,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAClC,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE,cAAmB,GAC3B,aAAa,CAAC,CAAC,CAAC;IAiCnB,OAAO,CAAC,QAAQ;IA0ChB,OAAO,CAAC,MAAM;IAuDd,OAAO,CAAC,aAAa;IAiErB,OAAO,CAAC,mBAAmB;CAoF5B;AAqBD,yBAAyB;AACzB,eAAO,MAAM,eAAe,iBAAwB,CAAC"}