@higher.archi/boe 1.0.0

package/dist/core/compilers/condition.compiler.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Core condition compiler - shared across all engines
+ */
+import { Condition, Operand, PropertyRef, CompiledCondition, CompiledOperand, CompiledPath } from '../types';
+export declare function parsePath(ref: PropertyRef): CompiledPath;
+export declare function compileOperand(operand: Operand): CompiledOperand;
+/**
+ * Compiles a condition into an optimized internal representation.
+ *
+ * Supports the ['expr', string] format for human-readable expressions.
+ *
+ * @example
+ * // Standard S-expression format
+ * compileCondition(['greaterThan', '$age', 18])
+ *
+ * @example
+ * // Human-readable expression format
+ * compileCondition(['expr', '$age > 18'])
+ *
+ * @example
+ * // Complex expression with multi-value shorthand
+ * compileCondition(['expr', '$status == "a" or "b" or "c"'])
+ * // Parses to: ['in', '$status', ['a', 'b', 'c']]
+ */
+export declare function compileCondition(condition: Condition | ['expr', string]): CompiledCondition;
+//# sourceMappingURL=condition.compiler.d.ts.map

package/dist/core/compilers/condition.compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.compiler.d.ts","sourceRoot":"","sources":["../../../src/core/compilers/condition.compiler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,SAAS,EACT,OAAO,EACP,WAAW,EAEX,iBAAiB,EACjB,eAAe,EACf,YAAY,EACb,MAAM,UAAU,CAAC;AAyBlB,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAOxD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CA+BhE;AAkBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,iBAAiB,CA8D3F"}

package/dist/core/compilers/condition.compiler.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Core condition compiler - shared across all engines
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePath = parsePath;
+exports.compileOperand = compileOperand;
+exports.compileCondition = compileCondition;
+const operators_1 = require("../operators");
+const parser_1 = require("../parser");
+function isPropertyRef(value) {
+    return typeof value === 'string' && value.startsWith('$');
+}
+function isFunctionExpr(value) {
+    return typeof value === 'object' && value !== null && 'fn' in value;
+}
+/**
+ * Check if an array looks like an expression/condition.
+ * An expression is an array where the first element is a known operator name.
+ * e.g., ['multiply', '$app.amount', 1.5] or ['add', 5, 3]
+ */
+function isExpression(value) {
+    if (!Array.isArray(value) || value.length < 2)
+        return false;
+    const op = value[0];
+    if (typeof op !== 'string')
+        return false;
+    return operators_1.operators.has(op);
+}
+function parsePath(ref) {
+    const str = ref.slice(1);
+    const parts = str.split('.');
+    return {
+        param: parts[0],
+        path: parts.slice(1)
+    };
+}
+function compileOperand(operand) {
+    if (isPropertyRef(operand)) {
+        return {
+            type: 'property',
+            ref: parsePath(operand)
+        };
+    }
+    if (isFunctionExpr(operand)) {
+        return {
+            type: 'function',
+            fn: operand.fn,
+            args: operand.args.map(compileOperand)
+        };
+    }
+    // Check if array is an expression (first element is a known operator)
+    // This allows expressions like ['multiply', '$amount', 1.5] to work in operand positions
+    if (isExpression(operand)) {
+        // Compile as an expression - use 'expression' type with compiled condition
+        // This reuses the condition compiler infrastructure
+        return {
+            type: 'expression',
+            compiled: compileCondition(operand)
+        };
+    }
+    return {
+        type: 'constant',
+        value: operand
+    };
+}
+const TERNARY_OPS = ['substring', 'replace', 'replaceAll', 'padStart', 'padEnd'];
+// Operators that support variadic "any of" matching when given more than 2 operands
+const VARIADIC_ANY_OPS = ['equals', 'notEquals'];
+function getArity(op, condition) {
+    if (op === 'and' || op === 'or')
+        return 'variadic';
+    if (TERNARY_OPS.includes(op))
+        return 'ternary';
+    // equals/notEquals with 3+ operands becomes variadic (any-of matching)
+    if (VARIADIC_ANY_OPS.includes(op) && condition.length > 3)
+        return 'variadic';
+    if (condition.length === 2)
+        return 'unary';
+    if (condition.length === 3)
+        return 'binary';
+    if (condition.length === 4)
+        return 'ternary';
+    return 'binary';
+}
+/**
+ * Compiles a condition into an optimized internal representation.
+ *
+ * Supports the ['expr', string] format for human-readable expressions.
+ *
+ * @example
+ * // Standard S-expression format
+ * compileCondition(['greaterThan', '$age', 18])
+ *
+ * @example
+ * // Human-readable expression format
+ * compileCondition(['expr', '$age > 18'])
+ *
+ * @example
+ * // Complex expression with multi-value shorthand
+ * compileCondition(['expr', '$status == "a" or "b" or "c"'])
+ * // Parses to: ['in', '$status', ['a', 'b', 'c']]
+ */
+function compileCondition(condition) {
+    // Handle expression tuple format: ['expr', '$age > 18']
+    if ((0, parser_1.isExpressionTuple)(condition)) {
+        const parsedCondition = (0, parser_1.parseExpression)(condition[1]);
+        return compileCondition(parsedCondition);
+    }
+    const op = condition[0];
+    const arity = getArity(op, condition);
+    if (op === 'and' || op === 'or') {
+        const children = condition.slice(1).map(compileCondition);
+        return { op, arity, children };
+    }
+    if (op === 'not') {
+        const child = compileCondition(condition[1]);
+        return { op, arity, children: [child] };
+    }
+    if (op === 'xor') {
+        const children = [
+            compileCondition(condition[1]),
+            compileCondition(condition[2])
+        ];
+        return { op, arity, children };
+    }
+    // Variadic equals/notEquals: ['equals', x, a, b, c] means x == a OR x == b OR x == c
+    if (arity === 'variadic' && VARIADIC_ANY_OPS.includes(op)) {
+        const operands = condition.slice(1).map(compileOperand);
+        return { op, arity, operands };
+    }
+    if (arity === 'unary') {
+        return {
+            op,
+            arity,
+            operands: [compileOperand(condition[1])]
+        };
+    }
+    if (arity === 'ternary') {
+        return {
+            op,
+            arity,
+            operands: [
+                compileOperand(condition[1]),
+                compileOperand(condition[2]),
+                compileOperand(condition[3])
+            ]
+        };
+    }
+    return {
+        op,
+        arity,
+        operands: [
+            compileOperand(condition[1]),
+            compileOperand(condition[2])
+        ]
+    };
+}
+//# sourceMappingURL=condition.compiler.js.map

package/dist/core/compilers/condition.compiler.js.map

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

package/dist/core/compilers/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Core compilers module - shared across engines
+ */
+export { compileCondition, compileOperand, parsePath } from './condition.compiler';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/compilers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/compilers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,SAAS,EACV,MAAM,sBAAsB,CAAC"}

package/dist/core/compilers/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Core compilers module - shared across engines
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePath = exports.compileOperand = exports.compileCondition = void 0;
+var condition_compiler_1 = require("./condition.compiler");
+Object.defineProperty(exports, "compileCondition", { enumerable: true, get: function () { return condition_compiler_1.compileCondition; } });
+Object.defineProperty(exports, "compileOperand", { enumerable: true, get: function () { return condition_compiler_1.compileOperand; } });
+Object.defineProperty(exports, "parsePath", { enumerable: true, get: function () { return condition_compiler_1.parsePath; } });
+//# sourceMappingURL=index.js.map

package/dist/core/compilers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/compilers/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,2DAI8B;AAH5B,sHAAA,gBAAgB,OAAA;AAChB,oHAAA,cAAc,OAAA;AACd,+GAAA,SAAS,OAAA"}

package/dist/core/engine/engine.interface.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Rule Engine Interface
+ *
+ * Base interface for all rule engine implementations.
+ * Each engine type (forward, backward, scoring, etc.) implements this
+ * with its specific ruleset, options, and result types.
+ */
+import { IWorkingMemory } from '../memory';
+import { CompiledBaseRuleSet } from '../types';
+/**
+ * Base rule engine interface.
+ *
+ * Extends IWorkingMemory to provide fact management alongside rule execution.
+ * Each engine implementation is strongly typed for its specific:
+ * - TRuleSet: The compiled ruleset type (e.g., CompiledForwardRuleSet)
+ * - TOptions: Runtime options (e.g., ForwardOptions)
+ * - TResult: Execution result (e.g., ForwardResult)
+ *
+ * @example
+ * ```typescript
+ * const engine = new ForwardEngine();
+ * engine.add({ type: 'Order', data: { amount: 100 } });
+ * const result = engine.execute(compiledRules, { actions });
+ * ```
+ *
+ * @example Shared WorkingMemory
+ * ```typescript
+ * const wm = new WorkingMemory();
+ * const forward = new ForwardEngine(wm);
+ * const scoring = new ScoringEngine(wm);
+ * // Both engines operate on the same facts
+ * ```
+ */
+export interface IRuleEngine<TRuleSet extends CompiledBaseRuleSet, TOptions, TResult> extends IWorkingMemory {
+    /**
+     * Execute the compiled ruleset against the current working memory.
+     *
+     * @param ruleSet - The compiled ruleset to execute
+     * @param options - Optional runtime options (actions, callbacks, etc.)
+     * @returns Execution result specific to the engine type
+     */
+    execute(ruleSet: TRuleSet, options?: TOptions): TResult;
+}
+//# sourceMappingURL=engine.interface.d.ts.map

package/dist/core/engine/engine.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.interface.d.ts","sourceRoot":"","sources":["../../../src/core/engine/engine.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,WAAW,CAC1B,QAAQ,SAAS,mBAAmB,EACpC,QAAQ,EACR,OAAO,CACP,SAAQ,cAAc;IACtB;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACzD"}

package/dist/core/engine/engine.interface.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Rule Engine Interface
+ *
+ * Base interface for all rule engine implementations.
+ * Each engine type (forward, backward, scoring, etc.) implements this
+ * with its specific ruleset, options, and result types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=engine.interface.js.map

package/dist/core/engine/engine.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.interface.js","sourceRoot":"","sources":["../../../src/core/engine/engine.interface.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/core/engine/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Core engine module
+ */
+export { IRuleEngine } from './engine.interface';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/core/engine/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core engine module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/core/engine/index.js.map

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

package/dist/core/evaluation/condition.evaluator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Core condition evaluator - shared across all engines
+ */
+import { CompiledCondition, CompiledOperand, BindingContext } from '../types';
+/**
+ * Set a value at a nested path, auto-creating intermediate objects
+ */
+export declare function setValueAtPath(obj: any, path: string[], value: any): void;
+export declare function resolveOperand(operand: CompiledOperand, context: BindingContext): any;
+export declare function evaluateCondition(condition: CompiledCondition, context: BindingContext): boolean;
+/**
+ * Evaluate an expression (CompiledCondition used in value context)
+ * Returns the computed value (number, string, etc.) rather than boolean
+ *
+ * This handles arithmetic operators like 'add', 'multiply', 'subtract', etc.
+ */
+export declare function evaluateExpression(expr: CompiledCondition, context: BindingContext): any;
+//# sourceMappingURL=condition.evaluator.d.ts.map

package/dist/core/evaluation/condition.evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.evaluator.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/condition.evaluator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAe9E;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAazE;AAMD,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,GAAG,GAAG,CAqBrF;AAUD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAmEhG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,GAAG,GAAG,CAoCxF"}

package/dist/core/evaluation/condition.evaluator.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Core condition evaluator - shared across all engines
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setValueAtPath = setValueAtPath;
+exports.resolveOperand = resolveOperand;
+exports.evaluateCondition = evaluateCondition;
+exports.evaluateExpression = evaluateExpression;
+const adapters_1 = require("../operators/adapters");
+// ========================================
+// Path Utilities
+// ========================================
+function getValueAtPath(obj, path) {
+    let current = obj;
+    for (const key of path) {
+        if (current === null || current === undefined)
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Set a value at a nested path, auto-creating intermediate objects
+ */
+function setValueAtPath(obj, path, value) {
+    if (path.length === 0)
+        return;
+    let current = obj;
+    for (let i = 0; i < path.length - 1; i++) {
+        const key = path[i];
+        if (current[key] === null || current[key] === undefined) {
+            current[key] = {}; // Auto-create intermediate objects
+        }
+        current = current[key];
+    }
+    current[path[path.length - 1]] = value;
+}
+// ========================================
+// Operand Resolution
+// ========================================
+function resolveOperand(operand, context) {
+    switch (operand.type) {
+        case 'constant':
+            return operand.value;
+        case 'property': {
+            const fact = context[operand.ref.param];
+            if (!fact)
+                return undefined;
+            if (operand.ref.path.length === 0)
+                return fact.data;
+            return getValueAtPath(fact.data, operand.ref.path);
+        }
+        case 'function':
+            // TODO: implement function registry
+            throw new Error(`Function expressions not yet implemented: ${operand.fn}`);
+        case 'expression':
+            // Recursively evaluate the compiled expression
+            // This handles nested expressions like ['multiply', '$app.amount', 1.5]
+            return evaluateExpression(operand.compiled, context);
+    }
+}
+function getValueType(value) {
+    if (value === null)
+        return 'any';
+    if (value === undefined)
+        return 'any';
+    if (Array.isArray(value))
+        return 'array';
+    if (value instanceof Date)
+        return 'date';
+    return typeof value;
+}
+function evaluateCondition(condition, context) {
+    const { op, arity, operands, children } = condition;
+    // Logical operators
+    if (op === 'and') {
+        return children.every(child => evaluateCondition(child, context));
+    }
+    if (op === 'or') {
+        return children.some(child => evaluateCondition(child, context));
+    }
+    if (op === 'not') {
+        return !evaluateCondition(children[0], context);
+    }
+    if (op === 'xor') {
+        const a = evaluateCondition(children[0], context);
+        const b = evaluateCondition(children[1], context);
+        return (a || b) && !(a && b);
+    }
+    // Variadic equals: ['equals', x, a, b, c] means x == a OR x == b OR x == c
+    if (arity === 'variadic' && op === 'equals') {
+        const values = operands.map(o => resolveOperand(o, context));
+        const target = values[0];
+        const candidates = values.slice(1);
+        return candidates.some(c => target === c);
+    }
+    // Variadic notEquals: ['notEquals', x, a, b, c] means x != a AND x != b AND x != c
+    if (arity === 'variadic' && op === 'notEquals') {
+        const values = operands.map(o => resolveOperand(o, context));
+        const target = values[0];
+        const candidates = values.slice(1);
+        return candidates.every(c => target !== c);
+    }
+    // Value operators
+    if (arity === 'unary') {
+        const value = resolveOperand(operands[0], context);
+        const type = getValueType(value);
+        const fn = (0, adapters_1.getOperator)(type, op);
+        if (!fn)
+            throw new Error(`No operator '${op}' for type '${type}'`);
+        return fn(value);
+    }
+    if (arity === 'binary') {
+        const left = resolveOperand(operands[0], context);
+        const right = resolveOperand(operands[1], context);
+        const type = getValueType(left);
+        const fn = (0, adapters_1.getOperator)(type, op);
+        if (!fn)
+            throw new Error(`No operator '${op}' for type '${type}'`);
+        return fn(left, right);
+    }
+    if (arity === 'ternary') {
+        const first = resolveOperand(operands[0], context);
+        const second = resolveOperand(operands[1], context);
+        const third = resolveOperand(operands[2], context);
+        const type = getValueType(first);
+        const fn = (0, adapters_1.getOperator)(type, op);
+        if (!fn)
+            throw new Error(`No operator '${op}' for type '${type}'`);
+        return fn(first, second, third);
+    }
+    throw new Error(`Unknown arity: ${arity}`);
+}
+/**
+ * Evaluate an expression (CompiledCondition used in value context)
+ * Returns the computed value (number, string, etc.) rather than boolean
+ *
+ * This handles arithmetic operators like 'add', 'multiply', 'subtract', etc.
+ */
+function evaluateExpression(expr, context) {
+    const { op, arity, operands } = expr;
+    // For arithmetic/value operators, resolve operands and apply operator
+    if (arity === 'unary' && operands) {
+        const value = resolveOperand(operands[0], context);
+        const fn = (0, adapters_1.getArithmeticOperator)(op);
+        if (fn)
+            return fn(value);
+        // Fall back to regular operator if no arithmetic operator found
+        const opFn = (0, adapters_1.getOperator)(getValueType(value), op);
+        if (opFn)
+            return opFn(value);
+        throw new Error(`No operator '${op}' found`);
+    }
+    if (arity === 'binary' && operands) {
+        const left = resolveOperand(operands[0], context);
+        const right = resolveOperand(operands[1], context);
+        const fn = (0, adapters_1.getArithmeticOperator)(op);
+        if (fn)
+            return fn(left, right);
+        // Fall back to regular operator if no arithmetic operator found
+        const opFn = (0, adapters_1.getOperator)(getValueType(left), op);
+        if (opFn)
+            return opFn(left, right);
+        throw new Error(`No operator '${op}' found`);
+    }
+    if (arity === 'ternary' && operands) {
+        const first = resolveOperand(operands[0], context);
+        const second = resolveOperand(operands[1], context);
+        const third = resolveOperand(operands[2], context);
+        // Fall back to regular operator
+        const opFn = (0, adapters_1.getOperator)(getValueType(first), op);
+        if (opFn)
+            return opFn(first, second, third);
+        throw new Error(`No operator '${op}' found`);
+    }
+    throw new Error(`Cannot evaluate expression with op='${op}' and arity='${arity}'`);
+}
+//# sourceMappingURL=condition.evaluator.js.map

package/dist/core/evaluation/condition.evaluator.js.map

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

package/dist/core/evaluation/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Core evaluation module - shared across all engines
+ */
+export { evaluateCondition, evaluateExpression, resolveOperand, setValueAtPath } from './condition.evaluator';
+export { injectRulesetContext, injectTemporalContext, // deprecated, use injectRulesetContext
+isRuleTemporallyValid, filterTemporallyValidRules, getRuleTemporalInfo, RulesetMetadata } from './temporal';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/evaluation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EAAG,uCAAuC;AAC/D,qBAAqB,EACrB,0BAA0B,EAC1B,mBAAmB,EACnB,eAAe,EAChB,MAAM,YAAY,CAAC"}

package/dist/core/evaluation/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Core evaluation module - shared across all engines
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRuleTemporalInfo = exports.filterTemporallyValidRules = exports.isRuleTemporallyValid = exports.injectTemporalContext = exports.injectRulesetContext = exports.setValueAtPath = exports.resolveOperand = exports.evaluateExpression = exports.evaluateCondition = void 0;
+var condition_evaluator_1 = require("./condition.evaluator");
+Object.defineProperty(exports, "evaluateCondition", { enumerable: true, get: function () { return condition_evaluator_1.evaluateCondition; } });
+Object.defineProperty(exports, "evaluateExpression", { enumerable: true, get: function () { return condition_evaluator_1.evaluateExpression; } });
+Object.defineProperty(exports, "resolveOperand", { enumerable: true, get: function () { return condition_evaluator_1.resolveOperand; } });
+Object.defineProperty(exports, "setValueAtPath", { enumerable: true, get: function () { return condition_evaluator_1.setValueAtPath; } });
+// Temporal validity utilities
+var temporal_1 = require("./temporal");
+Object.defineProperty(exports, "injectRulesetContext", { enumerable: true, get: function () { return temporal_1.injectRulesetContext; } });
+Object.defineProperty(exports, "injectTemporalContext", { enumerable: true, get: function () { return temporal_1.injectTemporalContext; } });
+Object.defineProperty(exports, "isRuleTemporallyValid", { enumerable: true, get: function () { return temporal_1.isRuleTemporallyValid; } });
+Object.defineProperty(exports, "filterTemporallyValidRules", { enumerable: true, get: function () { return temporal_1.filterTemporallyValidRules; } });
+Object.defineProperty(exports, "getRuleTemporalInfo", { enumerable: true, get: function () { return temporal_1.getRuleTemporalInfo; } });
+//# sourceMappingURL=index.js.map

package/dist/core/evaluation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/evaluation/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6DAK+B;AAJ7B,wHAAA,iBAAiB,OAAA;AACjB,yHAAA,kBAAkB,OAAA;AAClB,qHAAA,cAAc,OAAA;AACd,qHAAA,cAAc,OAAA;AAGhB,8BAA8B;AAC9B,uCAOoB;AANlB,gHAAA,oBAAoB,OAAA;AACpB,iHAAA,qBAAqB,OAAA;AACrB,iHAAA,qBAAqB,OAAA;AACrB,sHAAA,0BAA0B,OAAA;AAC1B,+GAAA,mBAAmB,OAAA"}

package/dist/core/evaluation/temporal.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Temporal validity utilities for rule evaluation
+ *
+ * Provides:
+ * - $ruleset meta-variable injection
+ * - $now built-in variable injection
+ * - Rule filtering based on validFrom/validUntil/validFor
+ */
+import { BindingContext } from '../types/fact';
+import { CompiledBaseRuleSet, CompiledBaseRule } from '../types/rule';
+/**
+ * Ruleset metadata fact for $ruleset variable access
+ */
+export type RulesetMetadata = {
+    id: string;
+    name?: string;
+    mode: string;
+    version?: string;
+    lastModified?: string;
+    createdAt?: string;
+};
+/**
+ * Inject $ruleset into the binding context
+ * This allows rules to reference $ruleset.lastModified, $ruleset.version, etc.
+ *
+ * Note: For current time, use $temporal.now (see temporal.md documentation)
+ */
+export declare function injectRulesetContext(context: BindingContext, ruleset: CompiledBaseRuleSet): BindingContext;
+/**
+ * @deprecated Use injectRulesetContext instead. For time access, use $temporal.now
+ */
+export declare function injectTemporalContext(context: BindingContext, ruleset: CompiledBaseRuleSet, _now?: Date): BindingContext;
+/**
+ * Check if a rule is currently valid based on temporal constraints
+ */
+export declare function isRuleTemporallyValid<T extends CompiledBaseRule>(rule: T, ruleset: CompiledBaseRuleSet, now?: Date): boolean;
+/**
+ * Filter rules to only include those that are temporally valid
+ * Returns a new array with only active rules
+ */
+export declare function filterTemporallyValidRules<T extends CompiledBaseRule>(rules: T[], ruleset: CompiledBaseRuleSet, now?: Date): T[];
+/**
+ * Get temporal validity info for a rule (useful for debugging/introspection)
+ */
+export declare function getRuleTemporalInfo<T extends CompiledBaseRule>(rule: T, ruleset: CompiledBaseRuleSet, now?: Date): {
+    isValid: boolean;
+    validFrom?: string;
+    validUntil?: string;
+    expiresAt?: string;
+    reason?: string;
+};
+//# sourceMappingURL=temporal.d.ts.map

package/dist/core/evaluation/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../../src/core/evaluation/temporal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAQ,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAoB,MAAM,eAAe,CAAC;AAMxF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,GAC3B,cAAc,CAmBhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,CAAC,EAAE,IAAI,GACV,cAAc,CAEhB;AAwCD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,gBAAgB,EAC9D,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,mBAAmB,EAC5B,GAAG,CAAC,EAAE,IAAI,GACT,OAAO,CA4BT;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,gBAAgB,EACnE,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,mBAAmB,EAC5B,GAAG,CAAC,EAAE,IAAI,GACT,CAAC,EAAE,CAEL;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,gBAAgB,EAC5D,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,mBAAmB,EAC5B,GAAG,CAAC,EAAE,IAAI,GACT;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAoDA"}