@higher.archi/boe 1.0.27 → 1.0.28

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/engines/decay/compiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EAQrB,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,GACpB,oBAAoB,CA0BtB"}

package/dist/engines/decay/compiler.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * Decay Engine Compiler
+ *
+ * Validates decay rulesets and resolves defaults.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileDecayRuleSet = compileDecayRuleSet;
+const errors_1 = require("../../core/errors");
+const types_1 = require("../utility/types");
+const types_2 = require("./types");
+/**
+ * Compile and validate a decay ruleset.
+ */
+function compileDecayRuleSet(ruleSet) {
+    if (!ruleSet.id) {
+        throw new errors_1.CompilationError('Decay ruleset requires an id');
+    }
+    if (ruleSet.mode !== 'decay') {
+        throw new errors_1.CompilationError(`Expected mode 'decay', got '${ruleSet.mode}'`);
+    }
+    if (!ruleSet.entityType || ruleSet.entityType.trim() === '') {
+        throw new errors_1.CompilationError('entityType is required and must be non-empty');
+    }
+    const entityIdField = ruleSet.entityIdField ?? 'id';
+    const urgencyThresholds = resolveUrgencyThresholds(ruleSet.urgencyThresholds);
+    switch (ruleSet.strategy) {
+        case 'single-dimension':
+            return compileSingleDimension(ruleSet, entityIdField, urgencyThresholds);
+        case 'multi-dimension':
+            return compileMultiDimension(ruleSet, entityIdField, urgencyThresholds);
+        case 'event-driven':
+            return compileEventDriven(ruleSet, entityIdField, urgencyThresholds);
+        default:
+            throw new errors_1.CompilationError(`Unknown decay strategy: '${ruleSet.strategy}'`);
+    }
+}
+// ========================================
+// Strategy-Specific Compilers
+// ========================================
+function compileSingleDimension(ruleSet, entityIdField, urgencyThresholds) {
+    const dimension = ruleSet.dimension;
+    if (!dimension) {
+        throw new errors_1.CompilationError('Single-dimension strategy requires a dimension');
+    }
+    validateDimension(dimension);
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'decay',
+        strategy: 'single-dimension',
+        entityType: ruleSet.entityType,
+        entityIdField,
+        urgencyThresholds,
+        dimension: compileDimension(dimension, 1.0)
+    };
+}
+function compileMultiDimension(ruleSet, entityIdField, urgencyThresholds) {
+    const { dimensions } = ruleSet;
+    if (!dimensions || !Array.isArray(dimensions) || dimensions.length === 0) {
+        throw new errors_1.CompilationError('Multi-dimension strategy requires at least one dimension');
+    }
+    validateDimensionIds(dimensions);
+    for (const dim of dimensions) {
+        validateDimension(dim);
+    }
+    const compiledDimensions = compileDimensions(dimensions);
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'decay',
+        strategy: 'multi-dimension',
+        entityType: ruleSet.entityType,
+        entityIdField,
+        urgencyThresholds,
+        dimensions: compiledDimensions,
+        aggregation: ruleSet.aggregation ?? 'weighted-average'
+    };
+}
+function compileEventDriven(ruleSet, entityIdField, urgencyThresholds) {
+    const { dimensions, reEngagementRules } = ruleSet;
+    if (!dimensions || !Array.isArray(dimensions) || dimensions.length === 0) {
+        throw new errors_1.CompilationError('Event-driven strategy requires at least one dimension');
+    }
+    validateDimensionIds(dimensions);
+    for (const dim of dimensions) {
+        validateDimension(dim);
+    }
+    if (!reEngagementRules || !Array.isArray(reEngagementRules) || reEngagementRules.length === 0) {
+        throw new errors_1.CompilationError('Event-driven strategy requires at least one re-engagement rule');
+    }
+    validateReEngagementRules(reEngagementRules);
+    const compiledDimensions = compileDimensions(dimensions);
+    return {
+        id: ruleSet.id,
+        name: ruleSet.name,
+        mode: 'decay',
+        strategy: 'event-driven',
+        entityType: ruleSet.entityType,
+        entityIdField,
+        urgencyThresholds,
+        dimensions: compiledDimensions,
+        aggregation: ruleSet.aggregation ?? 'weighted-average',
+        reEngagementRules
+    };
+}
+// ========================================
+// Validation Helpers
+// ========================================
+function validateDimension(dim) {
+    if (!dim.id) {
+        throw new errors_1.CompilationError('Each dimension requires an id');
+    }
+    if (!dim.timestampField) {
+        throw new errors_1.CompilationError(`Dimension '${dim.id}' requires a timestampField`);
+    }
+    switch (dim.curve) {
+        case 'exponential':
+            if (dim.halfLife === undefined || dim.halfLife <= 0) {
+                throw new errors_1.CompilationError(`Dimension '${dim.id}' with exponential curve requires a positive halfLife`);
+            }
+            break;
+        case 'linear':
+            if (dim.maxAge === undefined || dim.maxAge <= 0) {
+                throw new errors_1.CompilationError(`Dimension '${dim.id}' with linear curve requires a positive maxAge`);
+            }
+            break;
+        case 'step':
+            if (dim.threshold === undefined || dim.threshold <= 0) {
+                throw new errors_1.CompilationError(`Dimension '${dim.id}' with step curve requires a positive threshold`);
+            }
+            break;
+        default:
+            throw new errors_1.CompilationError(`Dimension '${dim.id}' has unknown curve: '${dim.curve}'`);
+    }
+}
+function validateDimensionIds(dimensions) {
+    const ids = new Set();
+    for (const dim of dimensions) {
+        if (!dim.id) {
+            throw new errors_1.CompilationError('Each dimension requires an id');
+        }
+        if (ids.has(dim.id)) {
+            throw new errors_1.CompilationError(`Duplicate dimension id: '${dim.id}'`);
+        }
+        ids.add(dim.id);
+    }
+}
+function validateReEngagementRules(rules) {
+    const ids = new Set();
+    for (const rule of rules) {
+        if (!rule.id) {
+            throw new errors_1.CompilationError('Each re-engagement rule requires an id');
+        }
+        if (ids.has(rule.id)) {
+            throw new errors_1.CompilationError(`Duplicate re-engagement rule id: '${rule.id}'`);
+        }
+        ids.add(rule.id);
+        if (!rule.eventType || rule.eventType.trim() === '') {
+            throw new errors_1.CompilationError(`Re-engagement rule '${rule.id}' requires a non-empty eventType`);
+        }
+        const validEffects = ['reset', 'boost', 'extend'];
+        if (!validEffects.includes(rule.effect)) {
+            throw new errors_1.CompilationError(`Re-engagement rule '${rule.id}' has invalid effect: '${rule.effect}'`);
+        }
+        if (rule.effect === 'boost' && (rule.boostAmount === undefined || rule.boostAmount <= 0)) {
+            throw new errors_1.CompilationError(`Re-engagement rule '${rule.id}' with boost effect requires a positive boostAmount`);
+        }
+        if (rule.effect === 'extend' && (rule.extensionDays === undefined || rule.extensionDays <= 0)) {
+            throw new errors_1.CompilationError(`Re-engagement rule '${rule.id}' with extend effect requires a positive extensionDays`);
+        }
+    }
+}
+// ========================================
+// Compilation Helpers
+// ========================================
+function compileDimension(dim, weight) {
+    return {
+        id: dim.id,
+        name: dim.name,
+        timestampField: dim.timestampField,
+        curve: dim.curve,
+        timeUnit: dim.timeUnit,
+        halfLife: dim.halfLife,
+        maxAge: dim.maxAge,
+        threshold: dim.threshold,
+        floor: dim.floor,
+        weight
+    };
+}
+function compileDimensions(dimensions) {
+    // Resolve semantic weights to numeric
+    const resolved = dimensions.map(dim => {
+        let weight;
+        if ((0, types_1.isSemanticPriority)(dim.weight)) {
+            weight = types_1.SEMANTIC_PRIORITY_VALUES[dim.weight];
+        }
+        else if (typeof dim.weight === 'number') {
+            weight = dim.weight;
+        }
+        else {
+            throw new errors_1.CompilationError(`Invalid weight for dimension '${dim.id}': '${dim.weight}'`);
+        }
+        return { dim, weight };
+    });
+    // Normalize weights to sum to 1.0
+    const totalWeight = resolved.reduce((sum, r) => sum + r.weight, 0);
+    if (totalWeight === 0) {
+        throw new errors_1.CompilationError('Dimension weights must not all be zero');
+    }
+    return resolved.map(r => compileDimension(r.dim, r.weight / totalWeight));
+}
+function resolveUrgencyThresholds(overrides) {
+    return { ...types_2.URGENCY_THRESHOLDS, ...overrides };
+}
+//# sourceMappingURL=compiler.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * Decay Engine
+ *
+ * Temporal decay engine that computes freshness scores for entities based
+ * on how recently their data was updated. Supports single-dimension,
+ * multi-dimension, and event-driven decay strategies.
+ *
+ * @example
+ * ```typescript
+ * const engine = new DecayEngine();
+ * engine.add({ type: 'Lead', data: { id: 'l1', lastContact: '2024-01-15' } });
+ * engine.add({ type: 'Lead', data: { id: 'l2', lastContact: '2024-03-01' } });
+ *
+ * const result = engine.execute(compiledDecay);
+ * console.log(result.entities[0]); // { entityId: 'l1', compositeFreshness: 0.42, urgencyTier: 'medium', ... }
+ * ```
+ */
+import { WorkingMemory, Fact, FactInput, FactChange } from '../../core';
+import type { CompiledDecayRuleSet, DecayOptions, DecayResult } from './types';
+export declare class DecayEngine {
+    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 decay ruleset.
+     *
+     * Computes freshness scores for all entities of the configured type
+     * and maps each to an urgency tier.
+     *
+     * @param ruleSet - Compiled decay ruleset
+     * @param options - Runtime options (asOf date, onEntity callback)
+     * @returns Decay result with per-entity freshness and tier distribution
+     */
+    execute(ruleSet: CompiledDecayRuleSet, options?: DecayOptions): DecayResult;
+    getWorkingMemory(): WorkingMemory;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engines/decay/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,aAAa,EACb,IAAI,EACJ,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACZ,MAAM,SAAS,CAAC;AAIjB,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,aAAa,CAAC,EAAE,aAAa;IASzC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAI1D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIxC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAI7D,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE;IAI/B,MAAM,IAAI,IAAI,EAAE;IAIhB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;IAIb,UAAU,IAAI,UAAU,EAAE;IAI1B,YAAY,IAAI,IAAI;IAQpB;;;;;;;;;OASG;IACH,OAAO,CACL,OAAO,EAAE,oBAAoB,EAC7B,OAAO,GAAE,YAAiB,GACzB,WAAW;IAQd,gBAAgB,IAAI,aAAa;CAGlC"}

package/dist/engines/decay/engine.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Decay Engine
+ *
+ * Temporal decay engine that computes freshness scores for entities based
+ * on how recently their data was updated. Supports single-dimension,
+ * multi-dimension, and event-driven decay strategies.
+ *
+ * @example
+ * ```typescript
+ * const engine = new DecayEngine();
+ * engine.add({ type: 'Lead', data: { id: 'l1', lastContact: '2024-01-15' } });
+ * engine.add({ type: 'Lead', data: { id: 'l2', lastContact: '2024-03-01' } });
+ *
+ * const result = engine.execute(compiledDecay);
+ * console.log(result.entities[0]); // { entityId: 'l1', compositeFreshness: 0.42, urgencyTier: 'medium', ... }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecayEngine = void 0;
+const core_1 = require("../../core");
+const strategy_1 = require("./strategy");
+class DecayEngine {
+    wm;
+    strategy;
+    constructor(workingMemory) {
+        this.wm = workingMemory ?? new core_1.WorkingMemory();
+        this.strategy = new strategy_1.DecayExecutor();
+    }
+    // ========================================
+    // 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 decay ruleset.
+     *
+     * Computes freshness scores for all entities of the configured type
+     * and maps each to an urgency tier.
+     *
+     * @param ruleSet - Compiled decay ruleset
+     * @param options - Runtime options (asOf date, onEntity callback)
+     * @returns Decay result with per-entity freshness and tier distribution
+     */
+    execute(ruleSet, options = {}) {
+        return this.strategy.run(ruleSet, this.wm, options);
+    }
+    // ========================================
+    // Utility Methods
+    // ========================================
+    getWorkingMemory() {
+        return this.wm;
+    }
+}
+exports.DecayEngine = DecayEngine;
+//# sourceMappingURL=engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/engines/decay/engine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,qCAKoB;AAQpB,yCAA2C;AAE3C,MAAa,WAAW;IACd,EAAE,CAAgB;IAClB,QAAQ,CAAgB;IAEhC,YAAY,aAA6B;QACvC,IAAI,CAAC,EAAE,GAAG,aAAa,IAAI,IAAI,oBAAa,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,wBAAa,EAAE,CAAC;IACtC,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,OAA6B,EAC7B,UAAwB,EAAE;QAE1B,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,kCAqFC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Decay Engine -- Temporal Freshness Scoring
+ */
+export type { DecayStrategy, UrgencyTier, ReEngagementEffect, DecayAggregation, DecayDimension, CompiledDecayDimension, ReEngagementRule, SingleDimensionDecayRuleSet, MultiDimensionDecayRuleSet, EventDrivenDecayRuleSet, DecayRuleSet, CompiledSingleDimensionDecayRuleSet, CompiledMultiDimensionDecayRuleSet, CompiledEventDrivenDecayRuleSet, CompiledDecayRuleSet, DimensionDecayResult, ReEngagementEvent, EntityDecayResult, DecayResult, DecayOptions } from './types';
+export { URGENCY_THRESHOLDS, resolveUrgencyTier } from './types';
+export { compileDecayRuleSet } from './compiler';
+export { DecayExecutor, decayStrategy } from './strategy';
+export { DecayEngine } from './engine';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engines/decay/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,YAAY,EACZ,mCAAmC,EACnC,kCAAkC,EAClC,+BAA+B,EAC/B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/engines/decay/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Decay Engine -- Temporal Freshness Scoring
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecayEngine = exports.decayStrategy = exports.DecayExecutor = exports.compileDecayRuleSet = exports.resolveUrgencyTier = exports.URGENCY_THRESHOLDS = void 0;
+// Constants & utilities
+var types_1 = require("./types");
+Object.defineProperty(exports, "URGENCY_THRESHOLDS", { enumerable: true, get: function () { return types_1.URGENCY_THRESHOLDS; } });
+Object.defineProperty(exports, "resolveUrgencyTier", { enumerable: true, get: function () { return types_1.resolveUrgencyTier; } });
+// Compiler
+var compiler_1 = require("./compiler");
+Object.defineProperty(exports, "compileDecayRuleSet", { enumerable: true, get: function () { return compiler_1.compileDecayRuleSet; } });
+// Strategy
+var strategy_1 = require("./strategy");
+Object.defineProperty(exports, "DecayExecutor", { enumerable: true, get: function () { return strategy_1.DecayExecutor; } });
+Object.defineProperty(exports, "decayStrategy", { enumerable: true, get: function () { return strategy_1.decayStrategy; } });
+// Engine
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "DecayEngine", { enumerable: true, get: function () { return engine_1.DecayEngine; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engines/decay/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA0BH,wBAAwB;AACxB,iCAGiB;AAFf,2GAAA,kBAAkB,OAAA;AAClB,2GAAA,kBAAkB,OAAA;AAGpB,WAAW;AACX,uCAAiD;AAAxC,+GAAA,mBAAmB,OAAA;AAE5B,WAAW;AACX,uCAA0D;AAAjD,yGAAA,aAAa,OAAA;AAAE,yGAAA,aAAa,OAAA;AAErC,SAAS;AACT,mCAAuC;AAA9B,qGAAA,WAAW,OAAA"}

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

@@ -0,0 +1,19 @@
+/**
+ * Decay Engine Strategy
+ *
+ * Core execution logic for all decay strategies:
+ * - single-dimension: One temporal axis evaluated per entity
+ * - multi-dimension: Multiple temporal axes aggregated into a composite score
+ * - event-driven: Multi-dimension with re-engagement events that reset/boost/extend decay
+ */
+import type { IWorkingMemory } from '../../core';
+import type { CompiledDecayRuleSet, DecayOptions, DecayResult } from './types';
+export declare class DecayExecutor {
+    run(ruleSet: CompiledDecayRuleSet, wm: IWorkingMemory, options?: DecayOptions): DecayResult;
+    private runSingleDimension;
+    private runMultiDimension;
+    private runEventDriven;
+}
+/** Singleton instance */
+export declare const decayStrategy: DecayExecutor;
+//# sourceMappingURL=strategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/engines/decay/strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAQ,MAAM,YAAY,CAAC;AAIvD,OAAO,KAAK,EACV,oBAAoB,EAKpB,YAAY,EACZ,WAAW,EAMZ,MAAM,SAAS,CAAC;AAKjB,qBAAa,aAAa;IACxB,GAAG,CACD,OAAO,EAAE,oBAAoB,EAC7B,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE,YAAiB,GACzB,WAAW;IA+Cd,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,iBAAiB;IA4CzB,OAAO,CAAC,cAAc;CA0IvB;AAiGD,yBAAyB;AACzB,eAAO,MAAM,aAAa,eAAsB,CAAC"}