@higher.archi/boe 1.0.27 → 1.0.29

package/dist/engines/decay/strategy.js

@@ -0,0 +1,308 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decayStrategy = exports.DecayExecutor = void 0;
+const decay_1 = require("../../core/evaluation/decay");
+const types_1 = require("./types");
+const MS_PER_DAY = 86_400_000;
+class DecayExecutor {
+    /** Score a single entity fact directly (no WorkingMemory scan) */
+    scoreEntity(fact, ruleSet, asOf = new Date()) {
+        const entityId = resolveEntityId(fact, ruleSet.entityIdField);
+        if (ruleSet.strategy === 'single-dimension') {
+            const dimResult = computeDimensionDecay(fact, ruleSet.dimension, asOf);
+            return {
+                entityId,
+                compositeFreshness: dimResult.freshnessScore,
+                urgencyTier: (0, types_1.resolveUrgencyTier)(dimResult.freshnessScore, ruleSet.urgencyThresholds),
+                dimensions: [dimResult]
+            };
+        }
+        // multi-dimension or event-driven (without WM-based re-engagement events)
+        const dimensions = ruleSet.strategy === 'event-driven' ? ruleSet.dimensions : ruleSet.dimensions;
+        const aggregation = ruleSet.aggregation;
+        const dimResults = dimensions.map(dim => computeDimensionDecay(fact, dim, asOf));
+        const compositeFreshness = aggregateFreshness(dimResults, dimensions, aggregation);
+        return {
+            entityId,
+            compositeFreshness,
+            urgencyTier: (0, types_1.resolveUrgencyTier)(compositeFreshness, ruleSet.urgencyThresholds),
+            dimensions: dimResults
+        };
+    }
+    run(ruleSet, wm, options = {}) {
+        const startTime = performance.now();
+        const asOf = options.asOf ?? new Date();
+        let entities;
+        switch (ruleSet.strategy) {
+            case 'single-dimension':
+                entities = this.runSingleDimension(ruleSet, wm, asOf, options);
+                break;
+            case 'multi-dimension':
+                entities = this.runMultiDimension(ruleSet, wm, asOf, options);
+                break;
+            case 'event-driven':
+                entities = this.runEventDriven(ruleSet, wm, asOf, options);
+                break;
+            default:
+                throw new Error(`Unknown decay strategy: '${ruleSet.strategy}'`);
+        }
+        const executionTimeMs = Math.round((performance.now() - startTime) * 100) / 100;
+        // Build tier distribution
+        const tierDistribution = {
+            critical: 0,
+            high: 0,
+            medium: 0,
+            low: 0,
+            stale: 0
+        };
+        for (const entity of entities) {
+            tierDistribution[entity.urgencyTier]++;
+        }
+        return {
+            entities,
+            totalEntities: entities.length,
+            strategy: ruleSet.strategy,
+            tierDistribution,
+            executionTimeMs
+        };
+    }
+    // ========================================
+    // Single-Dimension Strategy
+    // ========================================
+    runSingleDimension(ruleSet, wm, asOf, options) {
+        const entityFacts = wm.getByType(ruleSet.entityType);
+        if (entityFacts.length === 0)
+            return [];
+        const results = [];
+        for (const fact of entityFacts) {
+            const entityId = resolveEntityId(fact, ruleSet.entityIdField);
+            const dimResult = computeDimensionDecay(fact, ruleSet.dimension, asOf);
+            const entity = {
+                entityId,
+                compositeFreshness: dimResult.freshnessScore,
+                urgencyTier: (0, types_1.resolveUrgencyTier)(dimResult.freshnessScore, ruleSet.urgencyThresholds),
+                dimensions: [dimResult]
+            };
+            if (options.onEntity) {
+                options.onEntity(entity);
+            }
+            results.push(entity);
+        }
+        return results;
+    }
+    // ========================================
+    // Multi-Dimension Strategy
+    // ========================================
+    runMultiDimension(ruleSet, wm, asOf, options) {
+        const entityFacts = wm.getByType(ruleSet.entityType);
+        if (entityFacts.length === 0)
+            return [];
+        const results = [];
+        for (const fact of entityFacts) {
+            const entityId = resolveEntityId(fact, ruleSet.entityIdField);
+            const dimResults = ruleSet.dimensions.map(dim => computeDimensionDecay(fact, dim, asOf));
+            const compositeFreshness = aggregateFreshness(dimResults, ruleSet.dimensions, ruleSet.aggregation);
+            const entity = {
+                entityId,
+                compositeFreshness,
+                urgencyTier: (0, types_1.resolveUrgencyTier)(compositeFreshness, ruleSet.urgencyThresholds),
+                dimensions: dimResults
+            };
+            if (options.onEntity) {
+                options.onEntity(entity);
+            }
+            results.push(entity);
+        }
+        return results;
+    }
+    // ========================================
+    // Event-Driven Strategy
+    // ========================================
+    runEventDriven(ruleSet, wm, asOf, options) {
+        const entityFacts = wm.getByType(ruleSet.entityType);
+        if (entityFacts.length === 0)
+            return [];
+        const results = [];
+        for (const fact of entityFacts) {
+            const entityId = resolveEntityId(fact, ruleSet.entityIdField);
+            const reEngagements = [];
+            // Build adjusted fact data by applying re-engagement rules
+            const adjustedData = { ...fact.data };
+            for (const rule of ruleSet.reEngagementRules) {
+                // Scan WM for events matching this rule's eventType that reference this entity
+                const events = wm.getByType(rule.eventType);
+                const matchingEvents = events.filter(e => e.data?.entityId === entityId || e.data?.targetId === entityId);
+                if (matchingEvents.length === 0)
+                    continue;
+                // Use the most recent matching event
+                const latestEvent = matchingEvents.reduce((latest, e) => {
+                    const latestTime = latest.data?.timestamp ? new Date(latest.data.timestamp).getTime() : 0;
+                    const currentTime = e.data?.timestamp ? new Date(e.data.timestamp).getTime() : 0;
+                    return currentTime > latestTime ? e : latest;
+                });
+                const eventTimestamp = latestEvent.data?.timestamp
+                    ? new Date(latestEvent.data.timestamp).toISOString()
+                    : asOf.toISOString();
+                // Apply effect to each dimension's timestamp field
+                for (const dim of ruleSet.dimensions) {
+                    const originalTimestamp = adjustedData[dim.timestampField];
+                    if (!originalTimestamp)
+                        continue;
+                    const originalDate = new Date(originalTimestamp);
+                    const config = {
+                        curve: dim.curve,
+                        timeUnit: dim.timeUnit,
+                        halfLife: dim.halfLife,
+                        maxAge: dim.maxAge,
+                        threshold: dim.threshold,
+                        floor: dim.floor
+                    };
+                    const baseFreshness = (0, decay_1.calculateDecayMultiplier)(originalDate, asOf, config).multiplier;
+                    let adjustedFreshness = baseFreshness;
+                    switch (rule.effect) {
+                        case 'reset':
+                            // Use the event timestamp instead of the original
+                            adjustedData[dim.timestampField] = eventTimestamp;
+                            adjustedFreshness = (0, decay_1.calculateDecayMultiplier)(new Date(eventTimestamp), asOf, config).multiplier;
+                            break;
+                        case 'boost':
+                            // Add boost amount, clamp to 1.0
+                            adjustedFreshness = Math.min(1.0, baseFreshness + (rule.boostAmount ?? 0));
+                            break;
+                        case 'extend':
+                            // Push original timestamp forward by extensionDays
+                            const extendedDate = new Date(originalDate.getTime() + (rule.extensionDays ?? 0) * MS_PER_DAY);
+                            adjustedData[dim.timestampField] = extendedDate.toISOString();
+                            adjustedFreshness = (0, decay_1.calculateDecayMultiplier)(extendedDate, asOf, config).multiplier;
+                            break;
+                    }
+                    reEngagements.push({
+                        ruleId: rule.id,
+                        eventType: rule.eventType,
+                        effect: rule.effect,
+                        appliedAt: eventTimestamp,
+                        freshnessBeforeBoost: baseFreshness,
+                        freshnessAfterBoost: adjustedFreshness
+                    });
+                }
+            }
+            // Compute dimension decay using adjusted data
+            const adjustedFact = { ...fact, data: adjustedData };
+            const dimResults = ruleSet.dimensions.map(dim => computeDimensionDecay(adjustedFact, dim, asOf));
+            // For boost effect, override freshness from re-engagement records
+            for (const reEng of reEngagements) {
+                if (reEng.effect === 'boost') {
+                    // Find the matching dimension result and override its freshness
+                    for (const dimResult of dimResults) {
+                        // Apply the boosted freshness to the dimension
+                        const originalFreshness = dimResult.freshnessScore;
+                        if (originalFreshness === reEng.freshnessBeforeBoost) {
+                            dimResult.freshnessScore = reEng.freshnessAfterBoost;
+                            dimResult.fullyDecayed = dimResult.freshnessScore <= 0;
+                        }
+                    }
+                }
+            }
+            const compositeFreshness = aggregateFreshness(dimResults, ruleSet.dimensions, ruleSet.aggregation);
+            const entity = {
+                entityId,
+                compositeFreshness,
+                urgencyTier: (0, types_1.resolveUrgencyTier)(compositeFreshness, ruleSet.urgencyThresholds),
+                dimensions: dimResults,
+                reEngagements: reEngagements.length > 0 ? reEngagements : undefined
+            };
+            if (options.onEntity) {
+                options.onEntity(entity);
+            }
+            results.push(entity);
+        }
+        return results;
+    }
+}
+exports.DecayExecutor = DecayExecutor;
+// ========================================
+// Module-Level Helpers
+// ========================================
+function resolveEntityId(fact, entityIdField) {
+    return fact.data?.[entityIdField] ?? fact.id;
+}
+function computeDimensionDecay(fact, dimension, asOf) {
+    const timestampValue = fact.data?.[dimension.timestampField];
+    // If no timestamp found, treat as fully decayed
+    if (timestampValue === null || timestampValue === undefined) {
+        return {
+            dimensionId: dimension.id,
+            dimensionName: dimension.name,
+            freshnessScore: dimension.floor ?? 0,
+            ageInUnits: Infinity,
+            curve: dimension.curve,
+            timestamp: '',
+            fullyDecayed: true
+        };
+    }
+    const dataTimestamp = new Date(timestampValue);
+    if (isNaN(dataTimestamp.getTime())) {
+        return {
+            dimensionId: dimension.id,
+            dimensionName: dimension.name,
+            freshnessScore: dimension.floor ?? 0,
+            ageInUnits: Infinity,
+            curve: dimension.curve,
+            timestamp: String(timestampValue),
+            fullyDecayed: true
+        };
+    }
+    const config = {
+        curve: dimension.curve,
+        timeUnit: dimension.timeUnit,
+        halfLife: dimension.halfLife,
+        maxAge: dimension.maxAge,
+        threshold: dimension.threshold,
+        floor: dimension.floor
+    };
+    const decayInfo = (0, decay_1.calculateDecayMultiplier)(dataTimestamp, asOf, config);
+    return {
+        dimensionId: dimension.id,
+        dimensionName: dimension.name,
+        freshnessScore: decayInfo.multiplier,
+        ageInUnits: decayInfo.ageInUnits,
+        curve: decayInfo.curve,
+        timestamp: decayInfo.timestamp,
+        fullyDecayed: decayInfo.fullyDecayed
+    };
+}
+function aggregateFreshness(dimResults, dimensions, aggregation) {
+    switch (aggregation) {
+        case 'weighted-average': {
+            let sum = 0;
+            for (let i = 0; i < dimResults.length; i++) {
+                sum += dimResults[i].freshnessScore * dimensions[i].weight;
+            }
+            return sum;
+        }
+        case 'minimum':
+            return Math.min(...dimResults.map(d => d.freshnessScore));
+        case 'geometric-mean': {
+            // Weighted geometric mean: exp(sum(weight * ln(freshness)))
+            let weightedLogSum = 0;
+            for (let i = 0; i < dimResults.length; i++) {
+                const freshness = Math.max(dimResults[i].freshnessScore, 1e-10); // avoid log(0)
+                weightedLogSum += dimensions[i].weight * Math.log(freshness);
+            }
+            return Math.exp(weightedLogSum);
+        }
+        default:
+            throw new Error(`Unknown aggregation: '${aggregation}'`);
+    }
+}
+/** Singleton instance */
+exports.decayStrategy = new DecayExecutor();
+//# sourceMappingURL=strategy.js.map

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

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

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

@@ -0,0 +1,157 @@
+/**
+ * Decay Engine Types
+ *
+ * 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.
+ */
+import type { DecayCurve, DecayTimeUnit } from '../../core/evaluation/decay';
+import type { SemanticPriority } from '../utility/types';
+/** Decay strategy to use */
+export type DecayStrategy = 'single-dimension' | 'multi-dimension' | 'event-driven';
+/** Urgency tier based on freshness score */
+export type UrgencyTier = 'critical' | 'high' | 'medium' | 'low' | 'stale';
+/** Effect applied when a re-engagement event is detected */
+export type ReEngagementEffect = 'reset' | 'boost' | 'extend';
+/** Aggregation method for combining multi-dimension freshness scores */
+export type DecayAggregation = 'weighted-average' | 'minimum' | 'geometric-mean';
+/** Default urgency tier thresholds (freshness score boundaries) */
+export declare const URGENCY_THRESHOLDS: Record<UrgencyTier, number>;
+/** Map a freshness score (0-1) to an urgency tier */
+export declare function resolveUrgencyTier(freshness: number, thresholds?: Partial<Record<UrgencyTier, number>>): UrgencyTier;
+/** A decay dimension -- a single temporal axis to evaluate */
+export type DecayDimension = {
+    id: string;
+    name?: string;
+    timestampField: string;
+    curve: DecayCurve;
+    timeUnit: DecayTimeUnit;
+    halfLife?: number;
+    maxAge?: number;
+    threshold?: number;
+    floor?: number;
+    weight: number | SemanticPriority;
+};
+/** Compiled dimension with resolved numeric weight */
+export type CompiledDecayDimension = {
+    id: string;
+    name?: string;
+    timestampField: string;
+    curve: DecayCurve;
+    timeUnit: DecayTimeUnit;
+    halfLife?: number;
+    maxAge?: number;
+    threshold?: number;
+    floor?: number;
+    weight: number;
+};
+/** A rule that adjusts decay when a re-engagement event is detected */
+export type ReEngagementRule = {
+    id: string;
+    eventType: string;
+    effect: ReEngagementEffect;
+    boostAmount?: number;
+    extensionDays?: number;
+};
+type DecayRuleSetBase = {
+    id: string;
+    name?: string;
+    mode: 'decay';
+    entityType: string;
+    entityIdField?: string;
+    urgencyThresholds?: Partial<Record<UrgencyTier, number>>;
+};
+/** Single-dimension strategy: one temporal axis */
+export type SingleDimensionDecayRuleSet = DecayRuleSetBase & {
+    strategy: 'single-dimension';
+    dimension: DecayDimension;
+};
+/** Multi-dimension strategy: multiple temporal axes aggregated together */
+export type MultiDimensionDecayRuleSet = DecayRuleSetBase & {
+    strategy: 'multi-dimension';
+    dimensions: DecayDimension[];
+    aggregation?: DecayAggregation;
+};
+/** Event-driven strategy: multi-dimension with re-engagement rules */
+export type EventDrivenDecayRuleSet = DecayRuleSetBase & {
+    strategy: 'event-driven';
+    dimensions: DecayDimension[];
+    aggregation?: DecayAggregation;
+    reEngagementRules: ReEngagementRule[];
+};
+export type DecayRuleSet = SingleDimensionDecayRuleSet | MultiDimensionDecayRuleSet | EventDrivenDecayRuleSet;
+type CompiledDecayRuleSetBase = {
+    id: string;
+    name?: string;
+    mode: 'decay';
+    entityType: string;
+    entityIdField: string;
+    urgencyThresholds: Record<UrgencyTier, number>;
+};
+export type CompiledSingleDimensionDecayRuleSet = CompiledDecayRuleSetBase & {
+    strategy: 'single-dimension';
+    dimension: CompiledDecayDimension;
+};
+export type CompiledMultiDimensionDecayRuleSet = CompiledDecayRuleSetBase & {
+    strategy: 'multi-dimension';
+    dimensions: CompiledDecayDimension[];
+    aggregation: DecayAggregation;
+};
+export type CompiledEventDrivenDecayRuleSet = CompiledDecayRuleSetBase & {
+    strategy: 'event-driven';
+    dimensions: CompiledDecayDimension[];
+    aggregation: DecayAggregation;
+    reEngagementRules: ReEngagementRule[];
+};
+export type CompiledDecayRuleSet = CompiledSingleDimensionDecayRuleSet | CompiledMultiDimensionDecayRuleSet | CompiledEventDrivenDecayRuleSet;
+/** Per-dimension decay result */
+export type DimensionDecayResult = {
+    dimensionId: string;
+    dimensionName?: string;
+    freshnessScore: number;
+    ageInUnits: number;
+    curve: DecayCurve;
+    timestamp: string;
+    fullyDecayed: boolean;
+};
+/** Record of a re-engagement event that was applied */
+export type ReEngagementEvent = {
+    ruleId: string;
+    eventType: string;
+    effect: ReEngagementEffect;
+    appliedAt: string;
+    freshnessBeforeBoost: number;
+    freshnessAfterBoost: number;
+};
+/** Per-entity decay result */
+export type EntityDecayResult = {
+    entityId: string;
+    compositeFreshness: number;
+    urgencyTier: UrgencyTier;
+    dimensions: DimensionDecayResult[];
+    reEngagements?: ReEngagementEvent[];
+};
+/** Full decay execution result */
+export type DecayResult = {
+    entities: EntityDecayResult[];
+    totalEntities: number;
+    strategy: DecayStrategy;
+    tierDistribution: Record<UrgencyTier, number>;
+    executionTimeMs: number;
+};
+/** Runtime options for decay execution */
+export type DecayOptions = {
+    asOf?: Date;
+    onEntity?: (entity: EntityDecayResult) => void;
+};
+/** Result from ingest() -- includes individual entity result and running aggregate */
+export type DecayIngestResult = EntityDecayResult & {
+    /** Running tier distribution across all ingested entities */
+    tierDistribution: Record<UrgencyTier, number>;
+    /** Running average freshness across all ingested entities */
+    averageFreshness: number;
+    /** Total number of entities ingested so far */
+    totalIngested: number;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/engines/decay/types.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Decay Engine Types
+ *
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.URGENCY_THRESHOLDS = void 0;
+exports.resolveUrgencyTier = resolveUrgencyTier;
+// ========================================
+// Constants
+// ========================================
+/** Default urgency tier thresholds (freshness score boundaries) */
+exports.URGENCY_THRESHOLDS = {
+    'critical': 0.8,
+    'high': 0.6,
+    'medium': 0.4,
+    'low': 0.2,
+    'stale': 0
+};
+// ========================================
+// Resolver Functions
+// ========================================
+/** Map a freshness score (0-1) to an urgency tier */
+function resolveUrgencyTier(freshness, thresholds) {
+    const t = { ...exports.URGENCY_THRESHOLDS, ...thresholds };
+    if (freshness >= t.critical)
+        return 'critical';
+    if (freshness >= t.high)
+        return 'high';
+    if (freshness >= t.medium)
+        return 'medium';
+    if (freshness >= t.low)
+        return 'low';
+    return 'stale';
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engines/decay/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAuCH,gDAUC;AA5BD,2CAA2C;AAC3C,YAAY;AACZ,2CAA2C;AAE3C,mEAAmE;AACtD,QAAA,kBAAkB,GAAgC;IAC7D,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,GAAG;IACb,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,CAAC;CACX,CAAC;AAEF,2CAA2C;AAC3C,qBAAqB;AACrB,2CAA2C;AAE3C,qDAAqD;AACrD,SAAgB,kBAAkB,CAChC,SAAiB,EACjB,UAAiD;IAEjD,MAAM,CAAC,GAAG,EAAE,GAAG,0BAAkB,EAAE,GAAG,UAAU,EAAE,CAAC;IACnD,IAAI,SAAS,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,UAAU,CAAC;IAC/C,IAAI,SAAS,IAAI,CAAC,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,SAAS,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC3C,IAAI,SAAS,IAAI,CAAC,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/engines/negotiation/compiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAO3B,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,GAC1B,0BAA0B,CAkG5B"}