@higher.archi/boe 1.0.0

package/dist/engines/scoring/types.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Scoring Engine Types
+ */
+import { BaseRule, BaseRuleSet, CompiledBaseRule, CompiledBaseRuleSet, CompiledCondition, Expression, BindingContext } from '../../core';
+/**
+ * Scoring methods control how scores are normalized and combined
+ *
+ * Methods are applied in sequence:
+ * - Per-rule methods (normalized, capped, adaptive): Applied to each rule's score
+ * - Global methods (weighted-percent): Applied across all rules
+ */
+export type ScoringMethod = 'raw' | 'normalized' | 'adaptive' | 'weighted-percent' | 'capped';
+/**
+ * Max contribution caps for each rule
+ * Maps ruleId -> max score to prevent any single rule from dominating
+ */
+export type ScoringCaps = {
+    [ruleId: string]: number;
+};
+/**
+ * Output bounds for scaling final score to a target range
+ *
+ * Common presets:
+ * - 'percentage': 0-100 (e.g., 75%)
+ * - 'points': 0-1000 (e.g., 750 points)
+ * - 'rating': 0-10 (e.g., 7.5/10)
+ * - 'stars': 0-5 (e.g., 3.75/5 stars)
+ * - 'normalized': 0-1 (e.g., 0.75 - same as no outputBounds)
+ *
+ * Or specify custom range:
+ * - { min: 300, max: 850 } (e.g., FICO score)
+ */
+export type OutputBounds = {
+    min: number;
+    max: number;
+} | 'percentage' | 'points' | 'rating' | 'stars' | 'normalized';
+/**
+ * Tier definition for classifying scores into categories
+ *
+ * Tiers are matched in descending threshold order - the first tier
+ * where totalScore >= threshold is selected.
+ *
+ * Use '-Infinity' (string) for a catch-all tier that matches any score.
+ *
+ * @example
+ * ```typescript
+ * const tiers: TierDefinition[] = [
+ *   { id: 'preferred', name: 'Preferred', threshold: 80, description: 'Best rates' },
+ *   { id: 'standard', name: 'Standard', threshold: 60, description: 'Normal rates' },
+ *   { id: 'high-risk', name: 'High Risk', threshold: '-Infinity', description: 'Catch-all' }
+ * ];
+ * ```
+ */
+export type TierDefinition = {
+    id: string;
+    name?: string;
+    description?: string;
+    threshold: number | '-Infinity';
+};
+/**
+ * Matched tier in scoring result
+ */
+export type ScoringTierMatch = {
+    id: string;
+    name?: string;
+    description?: string;
+    threshold: number;
+};
+/**
+ * Scoring action - contributes a score when rule matches
+ */
+export type ScoringAction = {
+    score: number | string | Expression;
+    weight?: number;
+    normalize?: {
+        min: number;
+        max: number;
+    };
+    reason?: string;
+};
+/**
+ * Scoring rule - uses 'then' for scoring properties
+ */
+export type ScoringRule = BaseRule & {
+    then: ScoringAction;
+};
+/**
+ * Scoring ruleset
+ */
+export type ScoringRuleSet = BaseRuleSet & {
+    mode: 'scoring';
+    rules: ScoringRule[];
+    config?: Partial<ScoringConfig>;
+};
+/**
+ * Scoring configuration
+ */
+export type ScoringConfig = {
+    mode: 'scoring';
+    strategies: ScoringMethod[];
+    caps?: ScoringCaps;
+    outputBounds?: OutputBounds;
+    baseScore?: number;
+    tiers?: TierDefinition[];
+};
+/**
+ * Compiled scoring action
+ */
+export type CompiledScoringAction = {
+    mode: 'scoring';
+    score: number | string | CompiledCondition;
+    weight?: number;
+    normalize?: {
+        min: number;
+        max: number;
+    };
+    reason?: string;
+};
+/**
+ * Compiled scoring rule
+ */
+export type CompiledScoringRule = CompiledBaseRule & {
+    action: CompiledScoringAction;
+};
+/**
+ * Compiled scoring ruleset
+ */
+export type CompiledScoringRuleSet = CompiledBaseRuleSet & {
+    mode: 'scoring';
+    rules: CompiledScoringRule[];
+    config: ScoringConfig;
+};
+/**
+ * Score function for dynamic scoring
+ */
+export type ScoreFunction = (context: BindingContext) => number;
+/**
+ * Registry of score functions
+ */
+export type ScoreFunctionRegistry = Record<string, ScoreFunction>;
+/**
+ * Runtime options for scoring execution
+ */
+export type ScoringOptions = {
+    scoreFunctions?: ScoreFunctionRegistry;
+    onFire?: (ruleId: string, context: BindingContext, score: number) => void;
+};
+/**
+ * Execution result
+ */
+export type ScoringResult = {
+    totalScore: number;
+    contributions: Record<string, number>;
+    fired: string[];
+    iterations: 1;
+    tier?: ScoringTierMatch;
+    executionTimeMs: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/engines/scoring/types.d.ts.map

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

package/dist/engines/scoring/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Scoring Engine Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/engines/scoring/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engines/scoring/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

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

@@ -0,0 +1,7 @@
+/**
+ * Sequential Engine Compiler
+ */
+import { SequentialRule, SequentialRuleSet, CompiledSequentialRule, CompiledSequentialRuleSet } from './types';
+export declare function compileSequentialRule(rule: SequentialRule, index?: number): CompiledSequentialRule;
+export declare function compileSequentialRuleSet(ruleSet: SequentialRuleSet): CompiledSequentialRuleSet;
+//# sourceMappingURL=compiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/engines/sequential/compiler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,EACL,cAAc,EACd,iBAAiB,EAEjB,sBAAsB,EACtB,yBAAyB,EAE1B,MAAM,SAAS,CAAC;AAkJjB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,GAAE,MAAU,GAAG,sBAAsB,CAcrG;AAMD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,GAAG,yBAAyB,CAc9F"}

package/dist/engines/sequential/compiler.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * Sequential Engine Compiler
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileSequentialRule = compileSequentialRule;
+exports.compileSequentialRuleSet = compileSequentialRuleSet;
+const core_1 = require("../../core");
+// ========================================
+// Helper Functions
+// ========================================
+function countConditions(condition) {
+    if (!condition)
+        return 0;
+    if (condition.children) {
+        return 1 + condition.children.reduce((sum, c) => sum + countConditions(c), 0);
+    }
+    return 1;
+}
+function calculateComplexity(inputs, where) {
+    let score = 0;
+    score += inputs.length * 10;
+    score += countConditions(where) * 5;
+    for (const input of inputs) {
+        score += countConditions(input.where) * 2;
+    }
+    return score;
+}
+function compilePath(from) {
+    const str = from.startsWith('$') ? from.slice(1) : from;
+    const parts = str.split('.');
+    return {
+        param: parts[0],
+        path: parts.slice(1)
+    };
+}
+function isPropertyRef(value) {
+    return typeof value === 'string' && value.startsWith('$');
+}
+function isExpression(value) {
+    return Array.isArray(value) && value.length >= 2 && typeof value[0] === 'string';
+}
+// ========================================
+// Action Compilation
+// ========================================
+function compileActionItem(item) {
+    // Set action
+    if ('set' in item) {
+        const compiledSets = [];
+        for (const [targetPath, value] of Object.entries(item.set)) {
+            if (!isPropertyRef(targetPath)) {
+                throw new Error(`Set target must be a property reference, got: ${targetPath}`);
+            }
+            if (isExpression(value)) {
+                compiledSets.push({
+                    target: (0, core_1.parsePath)(targetPath),
+                    value: { type: 'constant', value: null },
+                    expr: (0, core_1.compileCondition)(value)
+                });
+            }
+            else {
+                compiledSets.push({
+                    target: (0, core_1.parsePath)(targetPath),
+                    value: (0, core_1.compileOperand)(value)
+                });
+            }
+        }
+        return { set: compiledSets };
+    }
+    // Retract action
+    if ('retract' in item) {
+        const ref = item.retract;
+        if (!isPropertyRef(ref)) {
+            throw new Error(`Retract must be a property reference, got: ${ref}`);
+        }
+        const paramName = ref.slice(1).split('.')[0];
+        return { retract: paramName };
+    }
+    // Call action
+    if ('call' in item) {
+        return { call: item.call };
+    }
+    // Halt action
+    if ('halt' in item) {
+        return { halt: true };
+    }
+    throw new Error(`Unknown action item type: ${JSON.stringify(item)}`);
+}
+function normalizeThenValue(value) {
+    if (typeof value === 'string') {
+        return [{ call: value }];
+    }
+    if (Array.isArray(value)) {
+        return value;
+    }
+    return [value];
+}
+function compileThenAction(thenValue) {
+    const items = normalizeThenValue(thenValue);
+    return {
+        mode: 'sequential',
+        actions: items.map(compileActionItem)
+    };
+}
+// ========================================
+// Parameter Compilation
+// ========================================
+function compileInputParameter(input) {
+    const compiled = {
+        name: input.name,
+        type: input.type,
+        schema: input.shape ? (0, core_1.normalizeShape)(input.shape) : { type: 'object' }
+    };
+    if (input.where) {
+        compiled.where = (0, core_1.compileCondition)(input.where);
+    }
+    if (input.from) {
+        compiled.from = compilePath(input.from);
+    }
+    return compiled;
+}
+// ========================================
+// Rule Compilation
+// ========================================
+function compileSequentialRule(rule, index = 0) {
+    const inputs = rule.inputs.map(compileInputParameter);
+    const when = rule.when ? (0, core_1.compileCondition)(rule.when) : undefined;
+    return {
+        id: rule.id,
+        name: rule.name,
+        salience: rule.salience ?? 0,
+        complexity: calculateComplexity(inputs, when),
+        index,
+        inputs,
+        when,
+        action: compileThenAction(rule.then)
+    };
+}
+// ========================================
+// RuleSet Compilation
+// ========================================
+function compileSequentialRuleSet(ruleSet) {
+    const config = {
+        mode: 'sequential',
+        strategies: ruleSet.config?.strategies ?? ['salience', 'ruleOrder']
+    };
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'sequential',
+        schema: ruleSet.shape ? (0, core_1.normalizeShape)(ruleSet.shape) : { type: 'object' },
+        rules: ruleSet.rules.map((rule, index) => compileSequentialRule(rule, index)),
+        config
+    };
+}
+//# sourceMappingURL=compiler.js.map

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

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

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

@@ -0,0 +1,55 @@
+/**
+ * Sequential Engine
+ *
+ * Self-contained engine for sequential (first-match-wins) rule execution.
+ * Implements IRuleEngine with strongly-typed ruleset, options, and result.
+ */
+import { IRuleEngine, WorkingMemory, Fact, FactInput, FactChange } from '../../core';
+import { CompiledSequentialRuleSet, SequentialOptions, SequentialResult } from './types';
+/**
+ * Sequential rule engine.
+ *
+ * Evaluates rules in order (by salience, then definition order) and fires
+ * only the first matching rule. Similar to routing or firewall rules.
+ *
+ * @example
+ * ```typescript
+ * const engine = new SequentialEngine();
+ * engine.add({ type: 'Request', data: { path: '/api/users/123', method: 'GET' } });
+ *
+ * const result = engine.execute(compiledRules, {
+ *   actions: { handleApiUsers: (ctx) => { ... } }
+ * });
+ *
+ * console.log(`Matched route: ${result.fired}`);
+ * ```
+ */
+export declare class SequentialEngine implements IRuleEngine<CompiledSequentialRuleSet, SequentialOptions, SequentialResult> {
+    private wm;
+    private strategy;
+    constructor(workingMemory?: WorkingMemory);
+    add(input: FactInput): Fact;
+    remove(factId: string): Fact | undefined;
+    update(input: FactInput): Fact;
+    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 sequential ruleset.
+     *
+     * Rules are evaluated in priority order. The first matching rule fires
+     * and execution stops (first-match-wins semantics).
+     *
+     * @param ruleSet - Compiled sequential ruleset
+     * @param options - Runtime options (actions, callbacks)
+     * @returns Result with the fired rule (if any)
+     */
+    execute(ruleSet: CompiledSequentialRuleSet, options: SequentialOptions): SequentialResult;
+    getWorkingMemory(): WorkingMemory;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engines/sequential/engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,IAAI,EACJ,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAIjB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAiB,YAAW,WAAW,CAAC,yBAAyB,EAAE,iBAAiB,EAAE,gBAAgB,CAAC;IAClH,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,aAAa,CAAC,EAAE,aAAa;IASzC,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI3B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIxC,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI9B,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,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;IAQzF,gBAAgB,IAAI,aAAa;CAGlC"}

package/dist/engines/sequential/engine.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Sequential Engine
+ *
+ * Self-contained engine for sequential (first-match-wins) rule execution.
+ * Implements IRuleEngine with strongly-typed ruleset, options, and result.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SequentialEngine = void 0;
+const core_1 = require("../../core");
+const strategy_1 = require("./strategy");
+/**
+ * Sequential rule engine.
+ *
+ * Evaluates rules in order (by salience, then definition order) and fires
+ * only the first matching rule. Similar to routing or firewall rules.
+ *
+ * @example
+ * ```typescript
+ * const engine = new SequentialEngine();
+ * engine.add({ type: 'Request', data: { path: '/api/users/123', method: 'GET' } });
+ *
+ * const result = engine.execute(compiledRules, {
+ *   actions: { handleApiUsers: (ctx) => { ... } }
+ * });
+ *
+ * console.log(`Matched route: ${result.fired}`);
+ * ```
+ */
+class SequentialEngine {
+    wm;
+    strategy;
+    constructor(workingMemory) {
+        this.wm = workingMemory ?? new core_1.WorkingMemory();
+        this.strategy = new strategy_1.SequentialStrategy();
+    }
+    // ========================================
+    // 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();
+    }
+    // ========================================
+    // IRuleEngine Implementation
+    // ========================================
+    /**
+     * Execute a sequential ruleset.
+     *
+     * Rules are evaluated in priority order. The first matching rule fires
+     * and execution stops (first-match-wins semantics).
+     *
+     * @param ruleSet - Compiled sequential ruleset
+     * @param options - Runtime options (actions, callbacks)
+     * @returns Result with the fired rule (if any)
+     */
+    execute(ruleSet, options) {
+        return this.strategy.run(ruleSet, this.wm, options);
+    }
+    // ========================================
+    // Utility Methods
+    // ========================================
+    getWorkingMemory() {
+        return this.wm;
+    }
+}
+exports.SequentialEngine = SequentialEngine;
+//# sourceMappingURL=engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/engines/sequential/engine.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qCAMoB;AAQpB,yCAAgD;AAEhD;;;;;;;;;;;;;;;;;GAiBG;AACH,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,CAAC,KAAgB;QAClB,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,CAAC,KAAgB;QACrB,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,6BAA6B;IAC7B,2CAA2C;IAE3C;;;;;;;;;OASG;IACH,OAAO,CAAC,OAAkC,EAAE,OAA0B;QACpE,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;AAlFD,4CAkFC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Sequential Engine
+ *
+ * Provides sequential rule execution where rules are evaluated in order
+ * and only the first matching rule executes.
+ */
+export { SequentialRule, SequentialRuleSet, SequentialConfig, CompiledSequentialAction, CompiledSequentialRule, CompiledSequentialRuleSet, ActionHandler, ActionRegistry, SequentialOptions, SequentialResult } from './types';
+export { compileSequentialRule, compileSequentialRuleSet } from './compiler';
+export { SequentialStrategy, sequentialStrategy } from './strategy';
+export { SequentialEngine } from './engine';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engines/sequential/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAEhB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EAEzB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/engines/sequential/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Sequential Engine
+ *
+ * Provides sequential rule execution where rules are evaluated in order
+ * and only the first matching rule executes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SequentialEngine = exports.sequentialStrategy = exports.SequentialStrategy = exports.compileSequentialRuleSet = exports.compileSequentialRule = void 0;
+// Compiler
+var compiler_1 = require("./compiler");
+Object.defineProperty(exports, "compileSequentialRule", { enumerable: true, get: function () { return compiler_1.compileSequentialRule; } });
+Object.defineProperty(exports, "compileSequentialRuleSet", { enumerable: true, get: function () { return compiler_1.compileSequentialRuleSet; } });
+// Strategy
+var strategy_1 = require("./strategy");
+Object.defineProperty(exports, "SequentialStrategy", { enumerable: true, get: function () { return strategy_1.SequentialStrategy; } });
+Object.defineProperty(exports, "sequentialStrategy", { enumerable: true, get: function () { return strategy_1.sequentialStrategy; } });
+// Engine
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "SequentialEngine", { enumerable: true, get: function () { return engine_1.SequentialEngine; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engines/sequential/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAmBH,WAAW;AACX,uCAGoB;AAFlB,iHAAA,qBAAqB,OAAA;AACrB,oHAAA,wBAAwB,OAAA;AAG1B,WAAW;AACX,uCAGoB;AAFlB,8GAAA,kBAAkB,OAAA;AAClB,8GAAA,kBAAkB,OAAA;AAGpB,SAAS;AACT,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA"}

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

@@ -0,0 +1,13 @@
+/**
+ * Sequential Engine Strategy
+ *
+ * Evaluates rules in order (based on conflict resolution strategies)
+ * and executes the first matching rule only.
+ */
+import { IWorkingMemory } from '../../core/memory';
+import { CompiledSequentialRuleSet, SequentialOptions, SequentialResult } from './types';
+export declare class SequentialStrategy {
+    run(ruleSet: CompiledSequentialRuleSet, wm: IWorkingMemory, options: SequentialOptions): SequentialResult;
+}
+export declare const sequentialStrategy: SequentialStrategy;
+//# sourceMappingURL=strategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/engines/sequential/strategy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EACL,yBAAyB,EAGzB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAuCjB,qBAAa,kBAAkB;IAC7B,GAAG,CACD,OAAO,EAAE,yBAAyB,EAClC,EAAE,EAAE,cAAc,EAClB,OAAO,EAAE,iBAAiB,GACzB,gBAAgB;CA6DpB;AAGD,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}