@wildo-ai/saas-backend-lib 1.1.2 → 1.1.4

package/dist/esm/guidance/services/milestone-evaluator.backend.service.js

@@ -12,31 +12,20 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 import 'reflect-metadata';
 import { injectable, inject, optional } from 'inversify';
-import { CoreWebSocketEvent, CoreResourceType, MilestoneType, MilestoneRewardType, ProgressionScope, PROGRESSION_SCOPE_TO_RESOURCE, ResourcePrimaryScope, GuidanceFlowScope, OnboardingStatus, GuidanceStateUtils, } from '@wildo-ai/saas-models';
+import { CoreWebSocketEvent, CoreResourceType, MilestoneType, MilestoneRewardType, ProgressionScope, ResourcePrimaryScope, GuidanceFlowScope, OnboardingStatus, } from '@wildo-ai/saas-models';
 import { describeCaughtError } from '../../errors/utils/error-log-level-classification.backend.utils.js';
 import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
 import { requireScopeFeaturesForeignKeyField } from '../../features/services/scope-feature-ledger-relationship.backend.utils.js';
-/**
- * Internal-only operation context for repository calls that bypass contextual
- * filtering and enrichment. Used by system-level evaluators that operate
- * outside the normal request pipeline.
- */
-function internalOpCtx(resourceType, op) {
-    return { operation: { resourceIdentifier: resourceType, operationIdentifier: op } };
-}
-function buildProgressionStateScopeFilter(resourceType, scopeId) {
-    switch (resourceType) {
-        case CoreResourceType.USER_PROGRESSION_STATE:
-            return { userId: scopeId };
-        case CoreResourceType.ORGANIZATION_PROGRESSION_STATE:
-            return { organizationId: scopeId };
-        default:
-            throw new Error(`Unsupported progression state resource type: ${resourceType}`);
-    }
-}
+import { buildProgressionStateScopeFilter, internalOpCtx } from './progression-state-store.backend.service.js';
 /**
  * Milestone Evaluator Backend Service
  *
+ * Scope resolution, the load-or-create and the scope filter moved to
+ * `ProgressionStateStoreBackendService` on 2026-09-08 (#414), when value moments became a SECOND
+ * evaluator over the same row. Nothing about them changed — they are shared rather than copied,
+ * because two implementations of a load-or-create whose duplicate-key catch is a deliberate
+ * concurrency decision is exactly how the two drift.
+ *
  * Pipeline integration entry point for milestone evaluation.
  * Called fire-and-forget after guidance trigger evaluation in the operation pipeline.
  *
@@ -53,16 +42,18 @@ let MilestoneEvaluatorBackendService = class MilestoneEvaluatorBackendService {
     repositoriesRegistry;
     resourcesRegistry;
     conditionRegistry;
+    progressionStateStore;
     featureResolution;
     lifecycleEvaluator;
     logDebug;
-    constructor(logger, milestoneRegistry, webSocketService, repositoriesRegistry, resourcesRegistry, conditionRegistry, featureResolution, lifecycleEvaluator) {
+    constructor(logger, milestoneRegistry, webSocketService, repositoriesRegistry, resourcesRegistry, conditionRegistry, progressionStateStore, featureResolution, lifecycleEvaluator) {
         this.logger = logger;
         this.milestoneRegistry = milestoneRegistry;
         this.webSocketService = webSocketService;
         this.repositoriesRegistry = repositoriesRegistry;
         this.resourcesRegistry = resourcesRegistry;
         this.conditionRegistry = conditionRegistry;
+        this.progressionStateStore = progressionStateStore;
         this.featureResolution = featureResolution;
         this.lifecycleEvaluator = lifecycleEvaluator;
         this.logDebug = this.logger.debugByType('MilestoneEvaluator');
@@ -115,13 +106,13 @@ let MilestoneEvaluatorBackendService = class MilestoneEvaluatorBackendService {
     // Scope Group Evaluation
     // =====================================================
     async evaluateScopeGroup(scope, scopeMilestones, triggerKey, userId, organizationId) {
-        const { resourceType: stateResourceType, scopeId } = this.resolveScopeTarget(scope, userId, organizationId);
+        const { resourceType: stateResourceType, scopeId } = this.progressionStateStore.resolveScopeTarget(scope, userId, organizationId);
         if (!scopeId) {
             this.logDebug('Skipping scope — no ID available', { scope });
             return;
         }
         // Ensure state document exists (auto-create on first access)
-        await this.loadOrCreateProgressionState(stateResourceType, scopeId);
+        await this.progressionStateStore.loadOrCreate(stateResourceType, scopeId);
         const stateScopeFilter = buildProgressionStateScopeFilter(stateResourceType, scopeId);
         // Atomic increment of operation count — returns document with correct count even under concurrency
         const stateAfterIncrement = await this.repositoriesRegistry.atomicGuardedMutation(stateResourceType, stateScopeFilter, { increment: { [`operationCounts.${triggerKey}`]: 1 } });
@@ -217,28 +208,6 @@ let MilestoneEvaluatorBackendService = class MilestoneEvaluatorBackendService {
         }
     }
     // =====================================================
-    // Scope Resolution
-    // =====================================================
-    /**
-     * Resolve scope to resource type + scope entity ID.
-     *
-     * Either id may be absent: an execution with no user principal has no USER
-     * scope, and one outside any organization has no ORGANIZATION scope. The
-     * caller treats an absent `scopeId` as "this scope does not apply", which is
-     * why every downstream helper takes the RESOLVED id instead of the pair —
-     * routing by scope and then re-deriving which id belongs to it is what let an
-     * inapplicable scope reach the store in the first place.
-     */
-    resolveScopeTarget(scope, userId, organizationId) {
-        const resourceType = PROGRESSION_SCOPE_TO_RESOURCE[scope];
-        switch (scope) {
-            case ProgressionScope.USER:
-                return { resourceType, scopeId: userId };
-            case ProgressionScope.ORGANIZATION:
-                return { resourceType, scopeId: organizationId };
-        }
-    }
-    // =====================================================
     // Condition Evaluation
     // =====================================================
     evaluateCondition(milestone, count, state) {
@@ -265,47 +234,6 @@ let MilestoneEvaluatorBackendService = class MilestoneEvaluatorBackendService {
         return milestone.dependencies.every(dep => !!state.milestonesAchieved[dep]);
     }
     // =====================================================
-    // State Persistence
-    // =====================================================
-    async loadOrCreateProgressionState(resourceType, scopeId) {
-        try {
-            const repository = this.repositoriesRegistry.getRepository(resourceType);
-            if (!repository) {
-                this.logDebug('No repository found for progression state', { resourceType });
-                return this.createDefaultProgressionState(resourceType, scopeId);
-            }
-            const scopeFilter = buildProgressionStateScopeFilter(resourceType, scopeId);
-            const existing = await repository.read(internalOpCtx(resourceType, 'read'), scopeFilter, { excludeContextualFilter: true });
-            if (existing) {
-                return existing;
-            }
-            // Auto-create on first access (handle concurrent create race)
-            this.logDebug('Creating new progression state', { resourceType, scopeId });
-            const defaultState = this.createDefaultProgressionState(resourceType, scopeId);
-            try {
-                await repository.create(internalOpCtx(resourceType, 'create'), defaultState, { excludeContextualFilter: true, excludeContextEnrichment: true });
-            }
-            catch {
-                // Duplicate key from concurrent create — re-read
-                const raceWinner = await repository.read(internalOpCtx(resourceType, 'read'), scopeFilter, { excludeContextualFilter: true });
-                if (raceWinner)
-                    return raceWinner;
-            }
-            return defaultState;
-        }
-        catch (error) {
-            this.logDebug('Failed to load progression state, using default', {
-                resourceType,
-                scopeId,
-                error: describeCaughtError(error),
-            });
-            return this.createDefaultProgressionState(resourceType, scopeId);
-        }
-    }
-    createDefaultProgressionState(resourceType, scopeId) {
-        return GuidanceStateUtils.createScopedProgressionState(buildProgressionStateScopeFilter(resourceType, scopeId));
-    }
-    // =====================================================
     // Reward Dispatch
     // =====================================================
     /**
@@ -522,10 +450,11 @@ MilestoneEvaluatorBackendService = __decorate([
     __param(3, inject(SAAS_SERVICE_TYPES.RepositoriesRegistryHandlerService)),
     __param(4, inject(SAAS_SERVICE_TYPES.ResourceRegistryService)),
     __param(5, inject(SAAS_SERVICE_TYPES.MilestoneConditionRegistry)),
-    __param(6, inject(SAAS_SERVICE_TYPES.FeatureResolutionService)),
-    __param(7, inject(SAAS_SERVICE_TYPES.LifecycleEvaluator)),
-    __param(7, optional()),
-    __metadata("design:paramtypes", [Function, Function, Function, Function, Function, Function, Function, Function])
+    __param(6, inject(SAAS_SERVICE_TYPES.ProgressionStateStore)),
+    __param(7, inject(SAAS_SERVICE_TYPES.FeatureResolutionService)),
+    __param(8, inject(SAAS_SERVICE_TYPES.LifecycleEvaluator)),
+    __param(8, optional()),
+    __metadata("design:paramtypes", [Function, Function, Function, Function, Function, Function, Function, Function, Function])
 ], MilestoneEvaluatorBackendService);
 export { MilestoneEvaluatorBackendService };
 //# sourceMappingURL=milestone-evaluator.backend.service.js.map

package/dist/esm/guidance/services/milestone-evaluator.backend.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"milestone-evaluator.backend.service.js","sourceRoot":"","sources":["../../../../../src/guidance/services/milestone-evaluator.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport { injectable, inject, optional } from 'inversify';\nimport {\n  CoreWebSocketEvent,\n  CoreResourceType,\n  MilestoneType,\n  MilestoneRewardType,\n  ProgressionScope,\n  PROGRESSION_SCOPE_TO_RESOURCE,\n  ResourcePrimaryScope,\n  GuidanceFlowScope,\n  OnboardingStatus,\n  GuidanceStateUtils,\n} from '@wildo-ai/saas-models';\nimport type {\n  MilestoneDefinition,\n  ProgressionState,\n  ScopeFeaturesWithOverrides,\n  WS_MilestoneAchievedPayload,\n  WS_ProgressionUpdatedPayload,\n} from '@wildo-ai/saas-models';\nimport { describeCaughtError } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport type { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport type { MilestoneDefinitionRegistryBackendService } from './milestone-definition-registry.backend.service';\nimport type { WebSocketService, WebSocketMessage } from '~wildo-backend-lib/requests/service/websocket.service';\nimport type { RepositoriesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/repositories/repositories-registry-handler.backend.service';\nimport type { LifecycleEvaluatorBackendService } from './lifecycle-evaluator.backend.service';\nimport type { MilestoneConditionRegistryBackendService } from './milestone-condition-registry.backend.service';\nimport type { FeatureResolutionBackendService } from '~wildo-backend-lib/features/services/feature-resolution.backend.service';\nimport type { ResourcesRegistryBackendService } from '~wildo-backend-lib/resources/services/resources-registry.backend.service';\nimport { requireScopeFeaturesForeignKeyField } from '~wildo-backend-lib/features/services/scope-feature-ledger-relationship.backend.utils';\n\n/**\n * Internal-only operation context for repository calls that bypass contextual\n * filtering and enrichment. Used by system-level evaluators that operate\n * outside the normal request pipeline.\n */\nfunction internalOpCtx(resourceType: CoreResourceType, op: string): { operation: { resourceIdentifier: CoreResourceType; operationIdentifier: string } } {\n  return { operation: { resourceIdentifier: resourceType, operationIdentifier: op } };\n}\n\nfunction buildProgressionStateScopeFilter(\n  resourceType: CoreResourceType,\n  scopeId: string,\n): { userId: string } | { organizationId: string } {\n  switch (resourceType) {\n    case CoreResourceType.USER_PROGRESSION_STATE:\n      return { userId: scopeId };\n    case CoreResourceType.ORGANIZATION_PROGRESSION_STATE:\n      return { organizationId: scopeId };\n    default:\n      throw new Error(`Unsupported progression state resource type: ${resourceType}`);\n  }\n}\n\n/**\n * Milestone Evaluator Backend Service\n *\n * Pipeline integration entry point for milestone evaluation.\n * Called fire-and-forget after guidance trigger evaluation in the operation pipeline.\n *\n * For each matching milestone:\n * 1. Resolve scope → load progression state from correct resource\n * 2. Increment operation counts\n * 3. Evaluate condition (FIRST_TIME, COUNT_THRESHOLD, CUSTOM_CONDITION)\n * 4. If achieved: update state, dispatch reward via WS\n */\n@injectable()\nexport class MilestoneEvaluatorBackendService {\n\n  private logDebug: (message: string, context?: Record<string, unknown>) => void;\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger) private readonly logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.MilestoneDefinitionRegistry) private readonly milestoneRegistry: MilestoneDefinitionRegistryBackendService,\n    @inject(SAAS_SERVICE_TYPES.WebSocketService) private readonly webSocketService: WebSocketService,\n    @inject(SAAS_SERVICE_TYPES.RepositoriesRegistryHandlerService) private readonly repositoriesRegistry: RepositoriesRegistryHandlerBackendService,\n    @inject(SAAS_SERVICE_TYPES.ResourceRegistryService) private readonly resourcesRegistry: ResourcesRegistryBackendService,\n    @inject(SAAS_SERVICE_TYPES.MilestoneConditionRegistry) private readonly conditionRegistry: MilestoneConditionRegistryBackendService,\n    @inject(SAAS_SERVICE_TYPES.FeatureResolutionService) private readonly featureResolution: FeatureResolutionBackendService,\n    @inject(SAAS_SERVICE_TYPES.LifecycleEvaluator) @optional() private readonly lifecycleEvaluator?: LifecycleEvaluatorBackendService,\n  ) {\n    this.logDebug = this.logger.debugByType('MilestoneEvaluator');\n    this.logger.setDebugTypeLogging('MilestoneEvaluator', false);\n  }\n\n  /**\n   * Pipeline integration entry point.\n   * Called fire-and-forget after guidance trigger evaluation.\n   */\n  public async evaluateForOperation(params: {\n    resourceType: string;\n    operationIdentifier: string;\n    /**\n     * Absent when the execution carried no user principal (machine, internal,\n     * cron, public). USER-scoped milestone groups are skipped for those; an\n     * ORGANIZATION-scoped group still evaluates on its own id.\n     */\n    userId?: string;\n    organizationId?: string;\n  }): Promise<void> {\n    try {\n      const matchingMilestones = this.milestoneRegistry.getMatchingMilestones(\n        params.resourceType, params.operationIdentifier\n      );\n      if (matchingMilestones.length === 0) return;\n\n      const triggerKey = `${params.resourceType}:${params.operationIdentifier}`;\n\n      this.logDebug('Evaluating milestones for operation', {\n        triggerKey,\n        matchCount: matchingMilestones.length,\n        milestoneRefs: matchingMilestones.map(m => m.identifier),\n      });\n\n      // Group milestones by scope — each scope has its own progression state document\n      const byScope = new Map<ProgressionScope, MilestoneDefinition[]>();\n      for (const milestone of matchingMilestones) {\n        const scope = milestone.scope ?? ProgressionScope.USER;\n        const group = byScope.get(scope) ?? [];\n        group.push(milestone);\n        byScope.set(scope, group);\n      }\n\n      // Evaluate each scope group independently — per-scope try/catch so one scope failure doesn't skip others\n      for (const [scope, scopeMilestones] of byScope) {\n        try {\n          await this.evaluateScopeGroup(\n            scope, scopeMilestones, triggerKey,\n            params.userId, params.organizationId\n          );\n        } catch (err: unknown) {\n          this.logger.warn(`Milestone evaluation failed for scope ${scope}`, {\n            error: describeCaughtError(err),\n          });\n        }\n      }\n    } catch (error) {\n      this.logger.warn('Milestone evaluation failed (non-blocking)', {\n        error: describeCaughtError(error),\n        resourceType: params.resourceType,\n        operationIdentifier: params.operationIdentifier,\n      });\n    }\n  }\n\n  // =====================================================\n  // Scope Group Evaluation\n  // =====================================================\n\n  private async evaluateScopeGroup(\n    scope: ProgressionScope,\n    scopeMilestones: MilestoneDefinition[],\n    triggerKey: string,\n    userId: string | undefined,\n    organizationId: string | undefined,\n  ): Promise<void> {\n    const { resourceType: stateResourceType, scopeId } = this.resolveScopeTarget(\n      scope, userId, organizationId\n    );\n\n    if (!scopeId) {\n      this.logDebug('Skipping scope — no ID available', { scope });\n      return;\n    }\n\n    // Ensure state document exists (auto-create on first access)\n    await this.loadOrCreateProgressionState(stateResourceType, scopeId);\n    const stateScopeFilter = buildProgressionStateScopeFilter(stateResourceType, scopeId);\n\n    // Atomic increment of operation count — returns document with correct count even under concurrency\n    const stateAfterIncrement = await this.repositoriesRegistry.atomicGuardedMutation<ProgressionState>(\n      stateResourceType,\n      stateScopeFilter,\n      { increment: { [`operationCounts.${triggerKey}`]: 1 } },\n    );\n\n    if (!stateAfterIncrement) {\n      this.logDebug('Failed to atomically increment operation count', { stateResourceType, scopeId });\n      return;\n    }\n\n    let state = stateAfterIncrement;\n    const currentCount = state.operationCounts[triggerKey] ?? 1;\n\n    // Evaluate each matching milestone in this scope\n    const achievedMilestones: MilestoneDefinition[] = [];\n    for (const milestone of scopeMilestones) {\n      // Skip already achieved\n      if (state.milestonesAchieved[milestone.identifier]) continue;\n      // Skip if dependencies not met\n      if (!this.areDependenciesMet(milestone, state)) continue;\n\n      const achieved = this.evaluateCondition(milestone, currentCount, state);\n      if (achieved) {\n        if (milestone.reward.type === MilestoneRewardType.FEATURE_UNLOCK) {\n          await this.unlockFeature(milestone.reward.featureRef!, scope, scopeId);\n        }\n\n        // Atomic conditional achievement: only set if not already achieved (prevents double-achievement under concurrency)\n        const updated = await this.repositoriesRegistry.atomicGuardedMutation<ProgressionState>(\n          stateResourceType,\n          {\n            ...stateScopeFilter,\n            [`milestonesAchieved.${milestone.identifier}`]: { $exists: false },\n          },\n          {\n            increment: {\n              totalPoints: milestone.points ?? 0,\n              [`categoriesProgress.${milestone.category}.completedCount`]: 1,\n              [`categoriesProgress.${milestone.category}.totalPoints`]: milestone.points ?? 0,\n            },\n            set: {\n              [`milestonesAchieved.${milestone.identifier}`]: {\n                achievedAt: new Date(),\n                count: currentCount,\n              },\n            },\n          },\n        );\n\n        if (updated) {\n          state = updated;\n          achievedMilestones.push(milestone);\n\n          this.logDebug('Milestone achieved', {\n            milestoneRef: milestone.identifier,\n            scope,\n            count: currentCount,\n            totalPoints: state.totalPoints,\n          });\n        } else {\n          this.logDebug('Milestone already achieved by concurrent request, skipping', {\n            milestoneRef: milestone.identifier,\n          });\n        }\n      }\n    }\n\n    // Dispatch rewards for newly achieved milestones\n    for (const milestone of achievedMilestones) {\n      await this.dispatchReward(\n        milestone, scope, scopeId, state.totalPoints\n      );\n    }\n\n    // Broadcast the incremented counts so the frontend can advance in-progress\n    // milestone bars live — even when NO milestone was achieved this operation.\n    // The evaluation is fire-and-forget (runs after the operation response), so\n    // the client cannot re-read counts race-free on its own; this pushes the\n    // authoritative post-increment `state`.\n    await this.dispatchProgressUpdate(scope, scopeId, state);\n\n    // Notify lifecycle evaluator of achieved milestones (sequential to avoid racing on same lifecycle document)\n    if (this.lifecycleEvaluator && achievedMilestones.length > 0) {\n      for (const milestone of achievedMilestones) {\n        try {\n          /**\n           * The IDENTITY PAIR, deliberately — not this group's `scopeId`. Lifecycle evaluates every\n           * scope the EXECUTION applies to, so an organization-scoped milestone still advances the\n           * achieving user's lifecycle. Narrowing this to `scopeId` would silently drop that half.\n           * Either id may be absent; the lifecycle evaluator resolves applicable scopes from what\n           * it is given.\n           */\n          await this.lifecycleEvaluator.onMilestoneAchieved({\n            milestoneIdentifier: milestone.identifier,\n            milestoneLifecycleTransition: milestone.lifecycleTransition,\n            userId,\n            organizationId,\n          });\n        } catch (err: unknown) {\n          this.logger.warn('Lifecycle milestone notification failed', {\n            milestoneRef: milestone.identifier,\n            error: describeCaughtError(err),\n          });\n        }\n      }\n    }\n  }\n\n  // =====================================================\n  // Scope Resolution\n  // =====================================================\n\n  /**\n   * Resolve scope to resource type + scope entity ID.\n   *\n   * Either id may be absent: an execution with no user principal has no USER\n   * scope, and one outside any organization has no ORGANIZATION scope. The\n   * caller treats an absent `scopeId` as \"this scope does not apply\", which is\n   * why every downstream helper takes the RESOLVED id instead of the pair —\n   * routing by scope and then re-deriving which id belongs to it is what let an\n   * inapplicable scope reach the store in the first place.\n   */\n  private resolveScopeTarget(\n    scope: ProgressionScope, userId: string | undefined, organizationId: string | undefined,\n  ): { resourceType: CoreResourceType; scopeId: string | undefined } {\n    const resourceType = PROGRESSION_SCOPE_TO_RESOURCE[scope];\n    switch (scope) {\n      case ProgressionScope.USER:\n        return { resourceType, scopeId: userId };\n      case ProgressionScope.ORGANIZATION:\n        return { resourceType, scopeId: organizationId };\n    }\n  }\n\n  // =====================================================\n  // Condition Evaluation\n  // =====================================================\n\n  private evaluateCondition(milestone: MilestoneDefinition, count: number, state: ProgressionState): boolean {\n    switch (milestone.type) {\n      case MilestoneType.FIRST_TIME:\n        return true;\n      case MilestoneType.COUNT_THRESHOLD:\n        return count >= (milestone.threshold ?? 1);\n      case MilestoneType.CUSTOM_CONDITION:\n        if (!milestone.conditionRef) {\n          this.logger.warn('CUSTOM_CONDITION milestone missing conditionRef', { milestoneRef: milestone.identifier });\n          return false;\n        }\n        return this.conditionRegistry.evaluateCondition(milestone.conditionRef, {\n          count,\n          operationCounts: state.operationCounts,\n          milestonesAchieved: state.milestonesAchieved,\n        });\n    }\n  }\n\n  private areDependenciesMet(milestone: MilestoneDefinition, state: ProgressionState): boolean {\n    if (!milestone.dependencies?.length) return true;\n    return milestone.dependencies.every(dep => !!state.milestonesAchieved[dep]);\n  }\n\n  // =====================================================\n  // State Persistence\n  // =====================================================\n\n  private async loadOrCreateProgressionState(\n    resourceType: CoreResourceType,\n    scopeId: string,\n  ): Promise<ProgressionState> {\n    try {\n      const repository = this.repositoriesRegistry.getRepository(resourceType);\n      if (!repository) {\n        this.logDebug('No repository found for progression state', { resourceType });\n        return this.createDefaultProgressionState(resourceType, scopeId);\n      }\n\n      const scopeFilter = buildProgressionStateScopeFilter(resourceType, scopeId);\n\n      const existing = await repository.read<ProgressionState>(\n        internalOpCtx(resourceType, 'read') as any,\n        scopeFilter,\n        { excludeContextualFilter: true },\n      );\n\n      if (existing) {\n        return existing;\n      }\n\n      // Auto-create on first access (handle concurrent create race)\n      this.logDebug('Creating new progression state', { resourceType, scopeId });\n      const defaultState = this.createDefaultProgressionState(resourceType, scopeId);\n      try {\n        await repository.create(\n          internalOpCtx(resourceType, 'create') as any,\n          defaultState,\n          { excludeContextualFilter: true, excludeContextEnrichment: true },\n        );\n      } catch {\n        // Duplicate key from concurrent create — re-read\n        const raceWinner = await repository.read<ProgressionState>(\n          internalOpCtx(resourceType, 'read') as any,\n          scopeFilter,\n          { excludeContextualFilter: true },\n        );\n        if (raceWinner) return raceWinner;\n      }\n      return defaultState;\n    } catch (error) {\n      this.logDebug('Failed to load progression state, using default', {\n        resourceType,\n        scopeId,\n        error: describeCaughtError(error),\n      });\n      return this.createDefaultProgressionState(resourceType, scopeId);\n    }\n  }\n\n  private createDefaultProgressionState(resourceType: CoreResourceType, scopeId: string): ProgressionState {\n    return GuidanceStateUtils.createScopedProgressionState(buildProgressionStateScopeFilter(resourceType, scopeId));\n  }\n\n  // =====================================================\n  // Reward Dispatch\n  // =====================================================\n\n  /**\n   * Push a PROGRESSION_UPDATED WS event carrying the scope's post-increment\n   * `operationCounts` + `totalPoints`. Same scope-aware channel routing as\n   * {@link dispatchReward}. Fired on every milestone-triggering operation (the\n   * evaluator already early-returns for operations with no matching milestone),\n   * so it is not chatty.\n   */\n  private async dispatchProgressUpdate(\n    scope: ProgressionScope,\n    scopeId: string,\n    state: ProgressionState,\n  ): Promise<void> {\n    const wsPayload: WS_ProgressionUpdatedPayload = {\n      scope,\n      operationCounts: state.operationCounts,\n      totalPoints: state.totalPoints,\n      updatedAt: new Date(),\n    };\n\n    const wsMessage: WebSocketMessage = {\n      type: CoreWebSocketEvent.PROGRESSION_UPDATED,\n      payload: wsPayload,\n      timestamp: new Date(),\n    };\n\n    try {\n      switch (scope) {\n        case ProgressionScope.USER:\n          await this.webSocketService.sendToUser(scopeId, wsMessage);\n          break;\n        case ProgressionScope.ORGANIZATION:\n          await this.webSocketService.sendToOrganization(scopeId, wsMessage);\n          break;\n      }\n    } catch (error) {\n      this.logger.warn('Failed to dispatch progression update', {\n        scope,\n        error: describeCaughtError(error),\n      });\n    }\n  }\n\n  private async dispatchReward(\n    milestone: MilestoneDefinition,\n    scope: ProgressionScope,\n    scopeId: string,\n    totalPoints: number,\n  ): Promise<void> {\n    // Push MILESTONE_ACHIEVED WS event — scope-aware channel routing\n    const wsPayload: WS_MilestoneAchievedPayload = {\n      milestoneRef: milestone.identifier,\n      category: milestone.category,\n      points: milestone.points,\n      scope,\n      reward: milestone.reward,\n      lifecycleTransition: milestone.lifecycleTransition,\n      achievedAt: new Date(),\n      totalPoints,\n    };\n\n    const wsMessage: WebSocketMessage = {\n      type: CoreWebSocketEvent.MILESTONE_ACHIEVED,\n      payload: wsPayload,\n      timestamp: new Date(),\n    };\n\n    try {\n      // Route WS event to the correct channel based on scope. `scopeId` is the id\n      // the scope resolved to, so no per-branch presence check is possible here —\n      // an absent id already ended the evaluation before any reward was granted.\n      switch (scope) {\n        case ProgressionScope.USER:\n          await this.webSocketService.sendToUser(scopeId, wsMessage);\n          break;\n        case ProgressionScope.ORGANIZATION:\n          await this.webSocketService.sendToOrganization(scopeId, wsMessage);\n          break;\n      }\n\n      this.logDebug('Dispatched MILESTONE_ACHIEVED event', {\n        milestoneRef: milestone.identifier,\n        scope,\n        rewardType: milestone.reward.type,\n      });\n    } catch (error) {\n      this.logger.warn('Failed to dispatch milestone reward', {\n        milestoneRef: milestone.identifier,\n        error: describeCaughtError(error),\n      });\n    }\n\n    switch (milestone.reward.type) {\n      case MilestoneRewardType.FEATURE_UNLOCK:\n        break;\n      case MilestoneRewardType.GUIDANCE_FLOW:\n        await this.activateGuidanceFlow(\n          milestone.reward.guidanceFlowRef!,\n          scopeId,\n          this.progressionScopeToGuidanceScope(scope),\n        );\n        break;\n      case MilestoneRewardType.CELEBRATION:\n        break;\n    }\n  }\n\n  /**\n   * Write feature override to scope-matched features resource.\n   */\n  private async unlockFeature(\n    featureRef: string,\n    scope: ProgressionScope,\n    scopeId: string,\n  ): Promise<void> {\n    const featureResourceType = this.getFeatureResourceType(scope);\n\n    const repository = this.repositoriesRegistry.getRepository(featureResourceType);\n    if (!repository) {\n      throw new Error(`No repository registered for ${featureResourceType}`);\n    }\n\n    try {\n      const scopeType = this.getFeatureScopeType(scope);\n      const foreignKeyField = requireScopeFeaturesForeignKeyField(this.resourcesRegistry, scopeType);\n      const scopeFilter = { [foreignKeyField]: scopeId };\n      const existingDocument = await repository.read<ScopeFeaturesWithOverrides & { _id: string }>(\n        internalOpCtx(featureResourceType, 'read') as never,\n        scopeFilter,\n        { excludeContextualFilter: true, excludeContextEnrichment: true },\n      );\n\n      const manualOverrides = this.buildUnlockedManualOverrides(\n        existingDocument?.manualOverrides,\n        featureRef,\n      );\n\n      this.logDebug('Unlocking feature via milestone reward', {\n        featureRef,\n        scope,\n        featureResourceType,\n        hasExistingDocument: Boolean(existingDocument),\n          foreignKeyField,\n      });\n\n      if (existingDocument?._id) {\n        await repository.update(\n          internalOpCtx(featureResourceType, 'update') as never,\n          existingDocument._id,\n          { manualOverrides },\n          { excludeContextualFilter: true, excludeContextEnrichment: true },\n        );\n      } else {\n        await repository.upsertByFilter(\n          internalOpCtx(featureResourceType, 'create') as never,\n          scopeFilter,\n          // Milestone rewards own only admin-style overrides. Billing sync may\n          // concurrently materialize or update `features` / `limits`.\n          {\n            ...scopeFilter,\n            manualOverrides,\n          },\n          { excludeContextualFilter: true, excludeContextEnrichment: true },\n        );\n      }\n\n      try {\n        await this.featureResolution.invalidateCache(\n          scopeType,\n          scopeId,\n        );\n      } catch (error) {\n        this.logger.warn('Failed to invalidate feature cache after milestone reward', {\n          featureRef,\n          scope,\n          error: describeCaughtError(error),\n        });\n      }\n    } catch (error) {\n      this.logger.warn('Failed to unlock feature via milestone reward', {\n        featureRef,\n        scope,\n        error: describeCaughtError(error),\n      });\n      throw error;\n    }\n  }\n\n  private getFeatureResourceType(scope: ProgressionScope): CoreResourceType {\n    switch (scope) {\n      case ProgressionScope.USER: return CoreResourceType.USER_FEATURES;\n      case ProgressionScope.ORGANIZATION: return CoreResourceType.ORGANIZATION_FEATURES;\n    }\n  }\n\n  private getFeatureScopeType(scope: ProgressionScope): ResourcePrimaryScope {\n    switch (scope) {\n      case ProgressionScope.USER:\n        return ResourcePrimaryScope.USER_SELF;\n      case ProgressionScope.ORGANIZATION:\n        return ResourcePrimaryScope.ORGANIZATIONS;\n    }\n  }\n\n  private buildUnlockedManualOverrides(\n    existingOverrides: ScopeFeaturesWithOverrides['manualOverrides'] | undefined,\n    featureRef: string,\n  ): ScopeFeaturesWithOverrides['manualOverrides'] {\n    const addedFeatures = new Set(existingOverrides?.addedFeatures ?? []);\n    addedFeatures.add(featureRef);\n\n    const removedFeatures = (existingOverrides?.removedFeatures ?? []).filter(ref => ref !== featureRef);\n\n    return {\n      addedFeatures: [...addedFeatures],\n      removedFeatures,\n      limitOverrides: { ...(existingOverrides?.limitOverrides ?? {}) },\n    };\n  }\n\n  private progressionScopeToGuidanceScope(scope: ProgressionScope): GuidanceFlowScope {\n    switch (scope) {\n      case ProgressionScope.USER: return GuidanceFlowScope.USER;\n      case ProgressionScope.ORGANIZATION: return GuidanceFlowScope.ORGANIZATION;\n    }\n  }\n\n  /**\n   * Push GUIDANCE_STATE_CHANGED to activate the referenced guidance flow.\n   */\n  private async activateGuidanceFlow(\n    guidanceFlowRef: string,\n    scopeId: string,\n    scope?: GuidanceFlowScope,\n  ): Promise<void> {\n    try {\n      const message: WebSocketMessage = {\n        type: CoreWebSocketEvent.GUIDANCE_STATE_CHANGED,\n        payload: {\n          flowRef: guidanceFlowRef,\n          status: OnboardingStatus.IN_PROGRESS,\n          triggerSource: 'backend' as const,\n          scope: scope ?? GuidanceFlowScope.USER,\n        },\n        timestamp: new Date(),\n      };\n\n      switch (scope ?? GuidanceFlowScope.USER) {\n        case GuidanceFlowScope.USER:\n          await this.webSocketService.sendToUser(scopeId, message);\n          break;\n        case GuidanceFlowScope.ORGANIZATION:\n          await this.webSocketService.sendToOrganization(scopeId, message);\n          break;\n      }\n\n      this.logDebug('Activated guidance flow via milestone reward', {\n        guidanceFlowRef,\n      });\n    } catch (error) {\n      this.logger.warn('Failed to activate guidance flow via milestone reward', {\n        guidanceFlowRef,\n        error: describeCaughtError(error),\n      });\n    }\n  }\n}\n"]}
+{"version":3,"file":"milestone-evaluator.backend.service.js","sourceRoot":"","sources":["../../../../src/guidance/services/milestone-evaluator.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport { injectable, inject, optional } from 'inversify';\nimport {\n  CoreWebSocketEvent,\n  CoreResourceType,\n  MilestoneType,\n  MilestoneRewardType,\n  ProgressionScope,\n  PROGRESSION_SCOPE_TO_RESOURCE,\n  ResourcePrimaryScope,\n  GuidanceFlowScope,\n  OnboardingStatus,\n  GuidanceStateUtils,\n} from '@wildo-ai/saas-models';\nimport type {\n  MilestoneDefinition,\n  ProgressionState,\n  ScopeFeaturesWithOverrides,\n  WS_MilestoneAchievedPayload,\n  WS_ProgressionUpdatedPayload,\n} from '@wildo-ai/saas-models';\nimport { describeCaughtError } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport type { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport type { MilestoneDefinitionRegistryBackendService } from './milestone-definition-registry.backend.service';\nimport type { WebSocketService, WebSocketMessage } from '~wildo-backend-lib/requests/service/websocket.service';\nimport type { RepositoriesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/repositories/repositories-registry-handler.backend.service';\nimport type { LifecycleEvaluatorBackendService } from './lifecycle-evaluator.backend.service';\nimport type { MilestoneConditionRegistryBackendService } from './milestone-condition-registry.backend.service';\nimport type { FeatureResolutionBackendService } from '~wildo-backend-lib/features/services/feature-resolution.backend.service';\nimport type { ResourcesRegistryBackendService } from '~wildo-backend-lib/resources/services/resources-registry.backend.service';\nimport { requireScopeFeaturesForeignKeyField } from '~wildo-backend-lib/features/services/scope-feature-ledger-relationship.backend.utils';\nimport { buildProgressionStateScopeFilter, internalOpCtx } from './progression-state-store.backend.service';\nimport type { ProgressionStateStoreBackendService } from './progression-state-store.backend.service';\n\n/**\n * Milestone Evaluator Backend Service\n *\n * Scope resolution, the load-or-create and the scope filter moved to\n * `ProgressionStateStoreBackendService` on 2026-09-08 (#414), when value moments became a SECOND\n * evaluator over the same row. Nothing about them changed — they are shared rather than copied,\n * because two implementations of a load-or-create whose duplicate-key catch is a deliberate\n * concurrency decision is exactly how the two drift.\n *\n * Pipeline integration entry point for milestone evaluation.\n * Called fire-and-forget after guidance trigger evaluation in the operation pipeline.\n *\n * For each matching milestone:\n * 1. Resolve scope → load progression state from correct resource\n * 2. Increment operation counts\n * 3. Evaluate condition (FIRST_TIME, COUNT_THRESHOLD, CUSTOM_CONDITION)\n * 4. If achieved: update state, dispatch reward via WS\n */\n@injectable()\nexport class MilestoneEvaluatorBackendService {\n\n  private logDebug: (message: string, context?: Record<string, unknown>) => void;\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger) private readonly logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.MilestoneDefinitionRegistry) private readonly milestoneRegistry: MilestoneDefinitionRegistryBackendService,\n    @inject(SAAS_SERVICE_TYPES.WebSocketService) private readonly webSocketService: WebSocketService,\n    @inject(SAAS_SERVICE_TYPES.RepositoriesRegistryHandlerService) private readonly repositoriesRegistry: RepositoriesRegistryHandlerBackendService,\n    @inject(SAAS_SERVICE_TYPES.ResourceRegistryService) private readonly resourcesRegistry: ResourcesRegistryBackendService,\n    @inject(SAAS_SERVICE_TYPES.MilestoneConditionRegistry) private readonly conditionRegistry: MilestoneConditionRegistryBackendService,\n    @inject(SAAS_SERVICE_TYPES.ProgressionStateStore) private readonly progressionStateStore: ProgressionStateStoreBackendService,\n    @inject(SAAS_SERVICE_TYPES.FeatureResolutionService) private readonly featureResolution: FeatureResolutionBackendService,\n    @inject(SAAS_SERVICE_TYPES.LifecycleEvaluator) @optional() private readonly lifecycleEvaluator?: LifecycleEvaluatorBackendService,\n  ) {\n    this.logDebug = this.logger.debugByType('MilestoneEvaluator');\n    this.logger.setDebugTypeLogging('MilestoneEvaluator', false);\n  }\n\n  /**\n   * Pipeline integration entry point.\n   * Called fire-and-forget after guidance trigger evaluation.\n   */\n  public async evaluateForOperation(params: {\n    resourceType: string;\n    operationIdentifier: string;\n    /**\n     * Absent when the execution carried no user principal (machine, internal,\n     * cron, public). USER-scoped milestone groups are skipped for those; an\n     * ORGANIZATION-scoped group still evaluates on its own id.\n     */\n    userId?: string;\n    organizationId?: string;\n  }): Promise<void> {\n    try {\n      const matchingMilestones = this.milestoneRegistry.getMatchingMilestones(\n        params.resourceType, params.operationIdentifier\n      );\n      if (matchingMilestones.length === 0) return;\n\n      const triggerKey = `${params.resourceType}:${params.operationIdentifier}`;\n\n      this.logDebug('Evaluating milestones for operation', {\n        triggerKey,\n        matchCount: matchingMilestones.length,\n        milestoneRefs: matchingMilestones.map(m => m.identifier),\n      });\n\n      // Group milestones by scope — each scope has its own progression state document\n      const byScope = new Map<ProgressionScope, MilestoneDefinition[]>();\n      for (const milestone of matchingMilestones) {\n        const scope = milestone.scope ?? ProgressionScope.USER;\n        const group = byScope.get(scope) ?? [];\n        group.push(milestone);\n        byScope.set(scope, group);\n      }\n\n      // Evaluate each scope group independently — per-scope try/catch so one scope failure doesn't skip others\n      for (const [scope, scopeMilestones] of byScope) {\n        try {\n          await this.evaluateScopeGroup(\n            scope, scopeMilestones, triggerKey,\n            params.userId, params.organizationId\n          );\n        } catch (err: unknown) {\n          this.logger.warn(`Milestone evaluation failed for scope ${scope}`, {\n            error: describeCaughtError(err),\n          });\n        }\n      }\n    } catch (error) {\n      this.logger.warn('Milestone evaluation failed (non-blocking)', {\n        error: describeCaughtError(error),\n        resourceType: params.resourceType,\n        operationIdentifier: params.operationIdentifier,\n      });\n    }\n  }\n\n  // =====================================================\n  // Scope Group Evaluation\n  // =====================================================\n\n  private async evaluateScopeGroup(\n    scope: ProgressionScope,\n    scopeMilestones: MilestoneDefinition[],\n    triggerKey: string,\n    userId: string | undefined,\n    organizationId: string | undefined,\n  ): Promise<void> {\n    const { resourceType: stateResourceType, scopeId } = this.progressionStateStore.resolveScopeTarget(\n      scope, userId, organizationId\n    );\n\n    if (!scopeId) {\n      this.logDebug('Skipping scope — no ID available', { scope });\n      return;\n    }\n\n    // Ensure state document exists (auto-create on first access)\n    await this.progressionStateStore.loadOrCreate(stateResourceType, scopeId);\n    const stateScopeFilter = buildProgressionStateScopeFilter(stateResourceType, scopeId);\n\n    // Atomic increment of operation count — returns document with correct count even under concurrency\n    const stateAfterIncrement = await this.repositoriesRegistry.atomicGuardedMutation<ProgressionState>(\n      stateResourceType,\n      stateScopeFilter,\n      { increment: { [`operationCounts.${triggerKey}`]: 1 } },\n    );\n\n    if (!stateAfterIncrement) {\n      this.logDebug('Failed to atomically increment operation count', { stateResourceType, scopeId });\n      return;\n    }\n\n    let state = stateAfterIncrement;\n    const currentCount = state.operationCounts[triggerKey] ?? 1;\n\n    // Evaluate each matching milestone in this scope\n    const achievedMilestones: MilestoneDefinition[] = [];\n    for (const milestone of scopeMilestones) {\n      // Skip already achieved\n      if (state.milestonesAchieved[milestone.identifier]) continue;\n      // Skip if dependencies not met\n      if (!this.areDependenciesMet(milestone, state)) continue;\n\n      const achieved = this.evaluateCondition(milestone, currentCount, state);\n      if (achieved) {\n        if (milestone.reward.type === MilestoneRewardType.FEATURE_UNLOCK) {\n          await this.unlockFeature(milestone.reward.featureRef!, scope, scopeId);\n        }\n\n        // Atomic conditional achievement: only set if not already achieved (prevents double-achievement under concurrency)\n        const updated = await this.repositoriesRegistry.atomicGuardedMutation<ProgressionState>(\n          stateResourceType,\n          {\n            ...stateScopeFilter,\n            [`milestonesAchieved.${milestone.identifier}`]: { $exists: false },\n          },\n          {\n            increment: {\n              totalPoints: milestone.points ?? 0,\n              [`categoriesProgress.${milestone.category}.completedCount`]: 1,\n              [`categoriesProgress.${milestone.category}.totalPoints`]: milestone.points ?? 0,\n            },\n            set: {\n              [`milestonesAchieved.${milestone.identifier}`]: {\n                achievedAt: new Date(),\n                count: currentCount,\n              },\n            },\n          },\n        );\n\n        if (updated) {\n          state = updated;\n          achievedMilestones.push(milestone);\n\n          this.logDebug('Milestone achieved', {\n            milestoneRef: milestone.identifier,\n            scope,\n            count: currentCount,\n            totalPoints: state.totalPoints,\n          });\n        } else {\n          this.logDebug('Milestone already achieved by concurrent request, skipping', {\n            milestoneRef: milestone.identifier,\n          });\n        }\n      }\n    }\n\n    // Dispatch rewards for newly achieved milestones\n    for (const milestone of achievedMilestones) {\n      await this.dispatchReward(\n        milestone, scope, scopeId, state.totalPoints\n      );\n    }\n\n    // Broadcast the incremented counts so the frontend can advance in-progress\n    // milestone bars live — even when NO milestone was achieved this operation.\n    // The evaluation is fire-and-forget (runs after the operation response), so\n    // the client cannot re-read counts race-free on its own; this pushes the\n    // authoritative post-increment `state`.\n    await this.dispatchProgressUpdate(scope, scopeId, state);\n\n    // Notify lifecycle evaluator of achieved milestones (sequential to avoid racing on same lifecycle document)\n    if (this.lifecycleEvaluator && achievedMilestones.length > 0) {\n      for (const milestone of achievedMilestones) {\n        try {\n          /**\n           * The IDENTITY PAIR, deliberately — not this group's `scopeId`. Lifecycle evaluates every\n           * scope the EXECUTION applies to, so an organization-scoped milestone still advances the\n           * achieving user's lifecycle. Narrowing this to `scopeId` would silently drop that half.\n           * Either id may be absent; the lifecycle evaluator resolves applicable scopes from what\n           * it is given.\n           */\n          await this.lifecycleEvaluator.onMilestoneAchieved({\n            milestoneIdentifier: milestone.identifier,\n            milestoneLifecycleTransition: milestone.lifecycleTransition,\n            userId,\n            organizationId,\n          });\n        } catch (err: unknown) {\n          this.logger.warn('Lifecycle milestone notification failed', {\n            milestoneRef: milestone.identifier,\n            error: describeCaughtError(err),\n          });\n        }\n      }\n    }\n  }\n\n  // =====================================================\n  // Condition Evaluation\n  // =====================================================\n\n  private evaluateCondition(milestone: MilestoneDefinition, count: number, state: ProgressionState): boolean {\n    switch (milestone.type) {\n      case MilestoneType.FIRST_TIME:\n        return true;\n      case MilestoneType.COUNT_THRESHOLD:\n        return count >= (milestone.threshold ?? 1);\n      case MilestoneType.CUSTOM_CONDITION:\n        if (!milestone.conditionRef) {\n          this.logger.warn('CUSTOM_CONDITION milestone missing conditionRef', { milestoneRef: milestone.identifier });\n          return false;\n        }\n        return this.conditionRegistry.evaluateCondition(milestone.conditionRef, {\n          count,\n          operationCounts: state.operationCounts,\n          milestonesAchieved: state.milestonesAchieved,\n        });\n    }\n  }\n\n  private areDependenciesMet(milestone: MilestoneDefinition, state: ProgressionState): boolean {\n    if (!milestone.dependencies?.length) return true;\n    return milestone.dependencies.every(dep => !!state.milestonesAchieved[dep]);\n  }\n\n  // =====================================================\n  // Reward Dispatch\n  // =====================================================\n\n  /**\n   * Push a PROGRESSION_UPDATED WS event carrying the scope's post-increment\n   * `operationCounts` + `totalPoints`. Same scope-aware channel routing as\n   * {@link dispatchReward}. Fired on every milestone-triggering operation (the\n   * evaluator already early-returns for operations with no matching milestone),\n   * so it is not chatty.\n   */\n  private async dispatchProgressUpdate(\n    scope: ProgressionScope,\n    scopeId: string,\n    state: ProgressionState,\n  ): Promise<void> {\n    const wsPayload: WS_ProgressionUpdatedPayload = {\n      scope,\n      operationCounts: state.operationCounts,\n      totalPoints: state.totalPoints,\n      updatedAt: new Date(),\n    };\n\n    const wsMessage: WebSocketMessage = {\n      type: CoreWebSocketEvent.PROGRESSION_UPDATED,\n      payload: wsPayload,\n      timestamp: new Date(),\n    };\n\n    try {\n      switch (scope) {\n        case ProgressionScope.USER:\n          await this.webSocketService.sendToUser(scopeId, wsMessage);\n          break;\n        case ProgressionScope.ORGANIZATION:\n          await this.webSocketService.sendToOrganization(scopeId, wsMessage);\n          break;\n      }\n    } catch (error) {\n      this.logger.warn('Failed to dispatch progression update', {\n        scope,\n        error: describeCaughtError(error),\n      });\n    }\n  }\n\n  private async dispatchReward(\n    milestone: MilestoneDefinition,\n    scope: ProgressionScope,\n    scopeId: string,\n    totalPoints: number,\n  ): Promise<void> {\n    // Push MILESTONE_ACHIEVED WS event — scope-aware channel routing\n    const wsPayload: WS_MilestoneAchievedPayload = {\n      milestoneRef: milestone.identifier,\n      category: milestone.category,\n      points: milestone.points,\n      scope,\n      reward: milestone.reward,\n      lifecycleTransition: milestone.lifecycleTransition,\n      achievedAt: new Date(),\n      totalPoints,\n    };\n\n    const wsMessage: WebSocketMessage = {\n      type: CoreWebSocketEvent.MILESTONE_ACHIEVED,\n      payload: wsPayload,\n      timestamp: new Date(),\n    };\n\n    try {\n      // Route WS event to the correct channel based on scope. `scopeId` is the id\n      // the scope resolved to, so no per-branch presence check is possible here —\n      // an absent id already ended the evaluation before any reward was granted.\n      switch (scope) {\n        case ProgressionScope.USER:\n          await this.webSocketService.sendToUser(scopeId, wsMessage);\n          break;\n        case ProgressionScope.ORGANIZATION:\n          await this.webSocketService.sendToOrganization(scopeId, wsMessage);\n          break;\n      }\n\n      this.logDebug('Dispatched MILESTONE_ACHIEVED event', {\n        milestoneRef: milestone.identifier,\n        scope,\n        rewardType: milestone.reward.type,\n      });\n    } catch (error) {\n      this.logger.warn('Failed to dispatch milestone reward', {\n        milestoneRef: milestone.identifier,\n        error: describeCaughtError(error),\n      });\n    }\n\n    switch (milestone.reward.type) {\n      case MilestoneRewardType.FEATURE_UNLOCK:\n        break;\n      case MilestoneRewardType.GUIDANCE_FLOW:\n        await this.activateGuidanceFlow(\n          milestone.reward.guidanceFlowRef!,\n          scopeId,\n          this.progressionScopeToGuidanceScope(scope),\n        );\n        break;\n      case MilestoneRewardType.CELEBRATION:\n        break;\n    }\n  }\n\n  /**\n   * Write feature override to scope-matched features resource.\n   */\n  private async unlockFeature(\n    featureRef: string,\n    scope: ProgressionScope,\n    scopeId: string,\n  ): Promise<void> {\n    const featureResourceType = this.getFeatureResourceType(scope);\n\n    const repository = this.repositoriesRegistry.getRepository(featureResourceType);\n    if (!repository) {\n      throw new Error(`No repository registered for ${featureResourceType}`);\n    }\n\n    try {\n      const scopeType = this.getFeatureScopeType(scope);\n      const foreignKeyField = requireScopeFeaturesForeignKeyField(this.resourcesRegistry, scopeType);\n      const scopeFilter = { [foreignKeyField]: scopeId };\n      const existingDocument = await repository.read<ScopeFeaturesWithOverrides & { _id: string }>(\n        internalOpCtx(featureResourceType, 'read') as never,\n        scopeFilter,\n        { excludeContextualFilter: true, excludeContextEnrichment: true },\n      );\n\n      const manualOverrides = this.buildUnlockedManualOverrides(\n        existingDocument?.manualOverrides,\n        featureRef,\n      );\n\n      this.logDebug('Unlocking feature via milestone reward', {\n        featureRef,\n        scope,\n        featureResourceType,\n        hasExistingDocument: Boolean(existingDocument),\n          foreignKeyField,\n      });\n\n      if (existingDocument?._id) {\n        await repository.update(\n          internalOpCtx(featureResourceType, 'update') as never,\n          existingDocument._id,\n          { manualOverrides },\n          { excludeContextualFilter: true, excludeContextEnrichment: true },\n        );\n      } else {\n        await repository.upsertByFilter(\n          internalOpCtx(featureResourceType, 'create') as never,\n          scopeFilter,\n          // Milestone rewards own only admin-style overrides. Billing sync may\n          // concurrently materialize or update `features` / `limits`.\n          {\n            ...scopeFilter,\n            manualOverrides,\n          },\n          { excludeContextualFilter: true, excludeContextEnrichment: true },\n        );\n      }\n\n      try {\n        await this.featureResolution.invalidateCache(\n          scopeType,\n          scopeId,\n        );\n      } catch (error) {\n        this.logger.warn('Failed to invalidate feature cache after milestone reward', {\n          featureRef,\n          scope,\n          error: describeCaughtError(error),\n        });\n      }\n    } catch (error) {\n      this.logger.warn('Failed to unlock feature via milestone reward', {\n        featureRef,\n        scope,\n        error: describeCaughtError(error),\n      });\n      throw error;\n    }\n  }\n\n  private getFeatureResourceType(scope: ProgressionScope): CoreResourceType {\n    switch (scope) {\n      case ProgressionScope.USER: return CoreResourceType.USER_FEATURES;\n      case ProgressionScope.ORGANIZATION: return CoreResourceType.ORGANIZATION_FEATURES;\n    }\n  }\n\n  private getFeatureScopeType(scope: ProgressionScope): ResourcePrimaryScope {\n    switch (scope) {\n      case ProgressionScope.USER:\n        return ResourcePrimaryScope.USER_SELF;\n      case ProgressionScope.ORGANIZATION:\n        return ResourcePrimaryScope.ORGANIZATIONS;\n    }\n  }\n\n  private buildUnlockedManualOverrides(\n    existingOverrides: ScopeFeaturesWithOverrides['manualOverrides'] | undefined,\n    featureRef: string,\n  ): ScopeFeaturesWithOverrides['manualOverrides'] {\n    const addedFeatures = new Set(existingOverrides?.addedFeatures ?? []);\n    addedFeatures.add(featureRef);\n\n    const removedFeatures = (existingOverrides?.removedFeatures ?? []).filter(ref => ref !== featureRef);\n\n    return {\n      addedFeatures: [...addedFeatures],\n      removedFeatures,\n      limitOverrides: { ...(existingOverrides?.limitOverrides ?? {}) },\n    };\n  }\n\n  private progressionScopeToGuidanceScope(scope: ProgressionScope): GuidanceFlowScope {\n    switch (scope) {\n      case ProgressionScope.USER: return GuidanceFlowScope.USER;\n      case ProgressionScope.ORGANIZATION: return GuidanceFlowScope.ORGANIZATION;\n    }\n  }\n\n  /**\n   * Push GUIDANCE_STATE_CHANGED to activate the referenced guidance flow.\n   */\n  private async activateGuidanceFlow(\n    guidanceFlowRef: string,\n    scopeId: string,\n    scope?: GuidanceFlowScope,\n  ): Promise<void> {\n    try {\n      const message: WebSocketMessage = {\n        type: CoreWebSocketEvent.GUIDANCE_STATE_CHANGED,\n        payload: {\n          flowRef: guidanceFlowRef,\n          status: OnboardingStatus.IN_PROGRESS,\n          triggerSource: 'backend' as const,\n          scope: scope ?? GuidanceFlowScope.USER,\n        },\n        timestamp: new Date(),\n      };\n\n      switch (scope ?? GuidanceFlowScope.USER) {\n        case GuidanceFlowScope.USER:\n          await this.webSocketService.sendToUser(scopeId, message);\n          break;\n        case GuidanceFlowScope.ORGANIZATION:\n          await this.webSocketService.sendToOrganization(scopeId, message);\n          break;\n      }\n\n      this.logDebug('Activated guidance flow via milestone reward', {\n        guidanceFlowRef,\n      });\n    } catch (error) {\n      this.logger.warn('Failed to activate guidance flow via milestone reward', {\n        guidanceFlowRef,\n        error: describeCaughtError(error),\n      });\n    }\n  }\n}\n"]}

package/dist/esm/guidance/services/progression-state-store.backend.service.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The one way to reach a scope's progression-state row.
+ *
+ * ## Why this exists
+ *
+ * `MilestoneEvaluatorBackendService` owned the scope resolution, the load-or-create and the scope
+ * filter as private methods, and they worked. Then #414 needed the same three things for value
+ * moments — a second evaluator over the SAME row — and the choice was between copying them and
+ * naming them.
+ *
+ * Copying is the defect shape `.claude/rules/invariant-call-site-enumeration.md` records fifteen
+ * times: two mechanisms for one invariant, free to drift, with the drift invisible until something
+ * behaves differently for one caller. The load-or-create in particular carries a concurrency
+ * decision that is not obvious and would not survive being re-derived — a duplicate-key from a
+ * concurrent create is CAUGHT and the row re-read, because two operations in the same instant both
+ * legitimately find no row.
+ *
+ * So: one service, injected by both evaluators. Nothing here is new behaviour; every line was moved.
+ *
+ * ## What it deliberately does NOT own
+ *
+ * The atomic mutations. `atomicGuardedMutation` is called by the evaluators directly, because the
+ * GUARD is the evaluator's own semantics — a milestone guards on `milestonesAchieved.<id>` not
+ * existing, a value moment on its own key — and a store that took a guard as a parameter would be a
+ * pass-through pretending to be a boundary.
+ */
+import 'reflect-metadata';
+import { CoreResourceType, ProgressionScope } from '@wildo-ai/saas-models';
+import type { ProgressionState } from '@wildo-ai/saas-models';
+import type { LoggerService } from '../../monitoring/logger/services/logger.service';
+import type { RepositoriesRegistryHandlerBackendService } from '../../base-classes/services/repositories/repositories-registry-handler.backend.service';
+/**
+ * The filter that selects one scope's row. Exported because both evaluators build their atomic
+ * guards by spreading it — the guard is theirs, the scope selection is not.
+ */
+export declare function buildProgressionStateScopeFilter(resourceType: CoreResourceType, scopeId: string): {
+    userId: string;
+} | {
+    organizationId: string;
+};
+/**
+ * Internal-only operation context for repository calls that bypass contextual filtering and
+ * enrichment. Used by system-level evaluators that operate outside the normal request pipeline.
+ */
+export declare function internalOpCtx(resourceType: CoreResourceType, op: string): {
+    operation: {
+        resourceIdentifier: CoreResourceType;
+        operationIdentifier: string;
+    };
+};
+export declare class ProgressionStateStoreBackendService {
+    private readonly logger;
+    private readonly repositoriesRegistry;
+    constructor(logger: LoggerService, repositoriesRegistry: RepositoriesRegistryHandlerBackendService);
+    private logDebug;
+    /**
+     * Resolve a scope to its resource type and the id of the entity being measured.
+     *
+     * Either id may be absent: an execution with no user principal has no USER scope, and one outside
+     * any organization has no ORGANIZATION scope. Callers treat an absent `scopeId` as "this scope
+     * does not apply" — which is why every downstream helper takes the RESOLVED id rather than the
+     * pair. Routing by scope and then re-deriving which id belongs to it is what let an inapplicable
+     * scope reach the store in the first place.
+     */
+    resolveScopeTarget(scope: ProgressionScope, userId: string | undefined, organizationId: string | undefined): {
+        resourceType: CoreResourceType;
+        scopeId: string | undefined;
+    };
+    /** The scope filter for a resolved target. */
+    scopeFilter(resourceType: CoreResourceType, scopeId: string): {
+        userId: string;
+    } | {
+        organizationId: string;
+    };
+    createDefaultProgressionState(resourceType: CoreResourceType, scopeId: string): ProgressionState;
+    /**
+     * Read the scope's row, creating it on first access.
+     *
+     * Never throws: every failure path returns the DEFAULT state. Both callers are fire-and-forget
+     * evaluators running after the operation's response has been decided, so an unavailable repository
+     * must degrade to "this scope has achieved nothing yet" rather than surface as an error on a
+     * request that already succeeded.
+     */
+    loadOrCreate(resourceType: CoreResourceType, scopeId: string): Promise<ProgressionState>;
+}
+//# sourceMappingURL=progression-state-store.backend.service.d.ts.map

package/dist/esm/guidance/services/progression-state-store.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progression-state-store.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/guidance/services/progression-state-store.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAGhB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,qGAAqG,CAAC;AAErK;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,MAAM,GACd;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,CASjD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE;QAAE,kBAAkB,EAAE,gBAAgB,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAE9J;AAED,qBACa,mCAAmC;IAET,OAAO,CAAC,QAAQ,CAAC,MAAM;IACK,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBADhD,MAAM,EAAE,aAAa,EACO,oBAAoB,EAAE,yCAAyC;IAKjJ,OAAO,CAAC,QAAQ;IAIhB;;;;;;;;OAQG;IACI,kBAAkB,CACvB,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC;QAAE,YAAY,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;IAUlE,8CAA8C;IACvC,WAAW,CAAC,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE;IAI7G,6BAA6B,CAAC,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB;IAIvG;;;;;;;OAOG;IACU,YAAY,CAAC,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAmDtG"}

package/dist/esm/guidance/services/progression-state-store.backend.service.js

@@ -0,0 +1,155 @@
+/**
+ * The one way to reach a scope's progression-state row.
+ *
+ * ## Why this exists
+ *
+ * `MilestoneEvaluatorBackendService` owned the scope resolution, the load-or-create and the scope
+ * filter as private methods, and they worked. Then #414 needed the same three things for value
+ * moments — a second evaluator over the SAME row — and the choice was between copying them and
+ * naming them.
+ *
+ * Copying is the defect shape `.claude/rules/invariant-call-site-enumeration.md` records fifteen
+ * times: two mechanisms for one invariant, free to drift, with the drift invisible until something
+ * behaves differently for one caller. The load-or-create in particular carries a concurrency
+ * decision that is not obvious and would not survive being re-derived — a duplicate-key from a
+ * concurrent create is CAUGHT and the row re-read, because two operations in the same instant both
+ * legitimately find no row.
+ *
+ * So: one service, injected by both evaluators. Nothing here is new behaviour; every line was moved.
+ *
+ * ## What it deliberately does NOT own
+ *
+ * The atomic mutations. `atomicGuardedMutation` is called by the evaluators directly, because the
+ * GUARD is the evaluator's own semantics — a milestone guards on `milestonesAchieved.<id>` not
+ * existing, a value moment on its own key — and a store that took a guard as a parameter would be a
+ * pass-through pretending to be a boundary.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import 'reflect-metadata';
+import { injectable, inject } from 'inversify';
+import { CoreResourceType, GuidanceStateUtils, PROGRESSION_SCOPE_TO_RESOURCE, ProgressionScope, } from '@wildo-ai/saas-models';
+import { describeCaughtError } from '../../errors/utils/error-log-level-classification.backend.utils.js';
+import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
+/**
+ * The filter that selects one scope's row. Exported because both evaluators build their atomic
+ * guards by spreading it — the guard is theirs, the scope selection is not.
+ */
+export function buildProgressionStateScopeFilter(resourceType, scopeId) {
+    switch (resourceType) {
+        case CoreResourceType.USER_PROGRESSION_STATE:
+            return { userId: scopeId };
+        case CoreResourceType.ORGANIZATION_PROGRESSION_STATE:
+            return { organizationId: scopeId };
+        default:
+            throw new Error(`Unsupported progression state resource type: ${resourceType}`);
+    }
+}
+/**
+ * Internal-only operation context for repository calls that bypass contextual filtering and
+ * enrichment. Used by system-level evaluators that operate outside the normal request pipeline.
+ */
+export function internalOpCtx(resourceType, op) {
+    return { operation: { resourceIdentifier: resourceType, operationIdentifier: op } };
+}
+let ProgressionStateStoreBackendService = class ProgressionStateStoreBackendService {
+    logger;
+    repositoriesRegistry;
+    constructor(logger, repositoriesRegistry) {
+        this.logger = logger;
+        this.repositoriesRegistry = repositoriesRegistry;
+        this.logger.setDebugTypeLogging('ProgressionStateStore', false);
+    }
+    logDebug(message, context) {
+        this.logger.debugByType('ProgressionStateStore')(message, context);
+    }
+    /**
+     * Resolve a scope to its resource type and the id of the entity being measured.
+     *
+     * Either id may be absent: an execution with no user principal has no USER scope, and one outside
+     * any organization has no ORGANIZATION scope. Callers treat an absent `scopeId` as "this scope
+     * does not apply" — which is why every downstream helper takes the RESOLVED id rather than the
+     * pair. Routing by scope and then re-deriving which id belongs to it is what let an inapplicable
+     * scope reach the store in the first place.
+     */
+    resolveScopeTarget(scope, userId, organizationId) {
+        const resourceType = PROGRESSION_SCOPE_TO_RESOURCE[scope];
+        switch (scope) {
+            case ProgressionScope.USER:
+                return { resourceType, scopeId: userId };
+            case ProgressionScope.ORGANIZATION:
+                return { resourceType, scopeId: organizationId };
+        }
+    }
+    /** The scope filter for a resolved target. */
+    scopeFilter(resourceType, scopeId) {
+        return buildProgressionStateScopeFilter(resourceType, scopeId);
+    }
+    createDefaultProgressionState(resourceType, scopeId) {
+        return GuidanceStateUtils.createScopedProgressionState(buildProgressionStateScopeFilter(resourceType, scopeId));
+    }
+    /**
+     * Read the scope's row, creating it on first access.
+     *
+     * Never throws: every failure path returns the DEFAULT state. Both callers are fire-and-forget
+     * evaluators running after the operation's response has been decided, so an unavailable repository
+     * must degrade to "this scope has achieved nothing yet" rather than surface as an error on a
+     * request that already succeeded.
+     */
+    async loadOrCreate(resourceType, scopeId) {
+        try {
+            const repository = this.repositoriesRegistry.getRepository(resourceType);
+            if (!repository) {
+                this.logDebug('No repository found for progression state', { resourceType });
+                return this.createDefaultProgressionState(resourceType, scopeId);
+            }
+            const scopeFilter = buildProgressionStateScopeFilter(resourceType, scopeId);
+            const existing = await repository.read(internalOpCtx(resourceType, 'read'), scopeFilter, { excludeContextualFilter: true });
+            if (existing) {
+                return existing;
+            }
+            this.logDebug('Creating new progression state', { resourceType, scopeId });
+            const defaultState = this.createDefaultProgressionState(resourceType, scopeId);
+            try {
+                await repository.create(internalOpCtx(resourceType, 'create'), defaultState, { excludeContextualFilter: true, excludeContextEnrichment: true });
+            }
+            catch {
+                /*
+                 * A duplicate key from a CONCURRENT create, not a failure. Two operations in the same
+                 * instant both legitimately find no row and both try to seed one; the loser re-reads the
+                 * winner's. Swallowing this is the reason the row can be self-healing at all.
+                 */
+                const raceWinner = await repository.read(internalOpCtx(resourceType, 'read'), scopeFilter, { excludeContextualFilter: true });
+                if (raceWinner)
+                    return raceWinner;
+            }
+            return defaultState;
+        }
+        catch (error) {
+            this.logDebug('Failed to load progression state, using default', {
+                resourceType,
+                scopeId,
+                error: describeCaughtError(error),
+            });
+            return this.createDefaultProgressionState(resourceType, scopeId);
+        }
+    }
+};
+ProgressionStateStoreBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.RepositoriesRegistryHandlerService)),
+    __metadata("design:paramtypes", [Function, Function])
+], ProgressionStateStoreBackendService);
+export { ProgressionStateStoreBackendService };
+//# sourceMappingURL=progression-state-store.backend.service.js.map

package/dist/esm/guidance/services/progression-state-store.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progression-state-store.backend.service.js","sourceRoot":"","sources":["../../../../src/guidance/services/progression-state-store.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The one way to reach a scope's progression-state row.\n *\n * ## Why this exists\n *\n * `MilestoneEvaluatorBackendService` owned the scope resolution, the load-or-create and the scope\n * filter as private methods, and they worked. Then #414 needed the same three things for value\n * moments — a second evaluator over the SAME row — and the choice was between copying them and\n * naming them.\n *\n * Copying is the defect shape `.claude/rules/invariant-call-site-enumeration.md` records fifteen\n * times: two mechanisms for one invariant, free to drift, with the drift invisible until something\n * behaves differently for one caller. The load-or-create in particular carries a concurrency\n * decision that is not obvious and would not survive being re-derived — a duplicate-key from a\n * concurrent create is CAUGHT and the row re-read, because two operations in the same instant both\n * legitimately find no row.\n *\n * So: one service, injected by both evaluators. Nothing here is new behaviour; every line was moved.\n *\n * ## What it deliberately does NOT own\n *\n * The atomic mutations. `atomicGuardedMutation` is called by the evaluators directly, because the\n * GUARD is the evaluator's own semantics — a milestone guards on `milestonesAchieved.<id>` not\n * existing, a value moment on its own key — and a store that took a guard as a parameter would be a\n * pass-through pretending to be a boundary.\n */\n\nimport 'reflect-metadata';\nimport { injectable, inject } from 'inversify';\nimport {\n  CoreResourceType,\n  GuidanceStateUtils,\n  PROGRESSION_SCOPE_TO_RESOURCE,\n  ProgressionScope,\n} from '@wildo-ai/saas-models';\nimport type { ProgressionState } from '@wildo-ai/saas-models';\n\nimport { describeCaughtError } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport type { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport type { RepositoriesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/repositories/repositories-registry-handler.backend.service';\n\n/**\n * The filter that selects one scope's row. Exported because both evaluators build their atomic\n * guards by spreading it — the guard is theirs, the scope selection is not.\n */\nexport function buildProgressionStateScopeFilter(\n  resourceType: CoreResourceType,\n  scopeId: string,\n): { userId: string } | { organizationId: string } {\n  switch (resourceType) {\n    case CoreResourceType.USER_PROGRESSION_STATE:\n      return { userId: scopeId };\n    case CoreResourceType.ORGANIZATION_PROGRESSION_STATE:\n      return { organizationId: scopeId };\n    default:\n      throw new Error(`Unsupported progression state resource type: ${resourceType}`);\n  }\n}\n\n/**\n * Internal-only operation context for repository calls that bypass contextual filtering and\n * enrichment. Used by system-level evaluators that operate outside the normal request pipeline.\n */\nexport function internalOpCtx(resourceType: CoreResourceType, op: string): { operation: { resourceIdentifier: CoreResourceType; operationIdentifier: string } } {\n  return { operation: { resourceIdentifier: resourceType, operationIdentifier: op } };\n}\n\n@injectable()\nexport class ProgressionStateStoreBackendService {\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger) private readonly logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.RepositoriesRegistryHandlerService) private readonly repositoriesRegistry: RepositoriesRegistryHandlerBackendService,\n  ) {\n    this.logger.setDebugTypeLogging('ProgressionStateStore', false);\n  }\n\n  private logDebug(message: string, context?: Record<string, unknown>): void {\n    this.logger.debugByType('ProgressionStateStore')(message, context);\n  }\n\n  /**\n   * Resolve a scope to its resource type and the id of the entity being measured.\n   *\n   * Either id may be absent: an execution with no user principal has no USER scope, and one outside\n   * any organization has no ORGANIZATION scope. Callers treat an absent `scopeId` as \"this scope\n   * does not apply\" — which is why every downstream helper takes the RESOLVED id rather than the\n   * pair. Routing by scope and then re-deriving which id belongs to it is what let an inapplicable\n   * scope reach the store in the first place.\n   */\n  public resolveScopeTarget(\n    scope: ProgressionScope,\n    userId: string | undefined,\n    organizationId: string | undefined,\n  ): { resourceType: CoreResourceType; scopeId: string | undefined } {\n    const resourceType = PROGRESSION_SCOPE_TO_RESOURCE[scope];\n    switch (scope) {\n      case ProgressionScope.USER:\n        return { resourceType, scopeId: userId };\n      case ProgressionScope.ORGANIZATION:\n        return { resourceType, scopeId: organizationId };\n    }\n  }\n\n  /** The scope filter for a resolved target. */\n  public scopeFilter(resourceType: CoreResourceType, scopeId: string): { userId: string } | { organizationId: string } {\n    return buildProgressionStateScopeFilter(resourceType, scopeId);\n  }\n\n  public createDefaultProgressionState(resourceType: CoreResourceType, scopeId: string): ProgressionState {\n    return GuidanceStateUtils.createScopedProgressionState(buildProgressionStateScopeFilter(resourceType, scopeId));\n  }\n\n  /**\n   * Read the scope's row, creating it on first access.\n   *\n   * Never throws: every failure path returns the DEFAULT state. Both callers are fire-and-forget\n   * evaluators running after the operation's response has been decided, so an unavailable repository\n   * must degrade to \"this scope has achieved nothing yet\" rather than surface as an error on a\n   * request that already succeeded.\n   */\n  public async loadOrCreate(resourceType: CoreResourceType, scopeId: string): Promise<ProgressionState> {\n    try {\n      const repository = this.repositoriesRegistry.getRepository(resourceType);\n      if (!repository) {\n        this.logDebug('No repository found for progression state', { resourceType });\n        return this.createDefaultProgressionState(resourceType, scopeId);\n      }\n\n      const scopeFilter = buildProgressionStateScopeFilter(resourceType, scopeId);\n\n      const existing = await repository.read<ProgressionState>(\n        internalOpCtx(resourceType, 'read') as never,\n        scopeFilter,\n        { excludeContextualFilter: true },\n      );\n\n      if (existing) {\n        return existing;\n      }\n\n      this.logDebug('Creating new progression state', { resourceType, scopeId });\n      const defaultState = this.createDefaultProgressionState(resourceType, scopeId);\n      try {\n        await repository.create(\n          internalOpCtx(resourceType, 'create') as never,\n          defaultState,\n          { excludeContextualFilter: true, excludeContextEnrichment: true },\n        );\n      } catch {\n        /*\n         * A duplicate key from a CONCURRENT create, not a failure. Two operations in the same\n         * instant both legitimately find no row and both try to seed one; the loser re-reads the\n         * winner's. Swallowing this is the reason the row can be self-healing at all.\n         */\n        const raceWinner = await repository.read<ProgressionState>(\n          internalOpCtx(resourceType, 'read') as never,\n          scopeFilter,\n          { excludeContextualFilter: true },\n        );\n        if (raceWinner) return raceWinner;\n      }\n      return defaultState;\n    } catch (error) {\n      this.logDebug('Failed to load progression state, using default', {\n        resourceType,\n        scopeId,\n        error: describeCaughtError(error),\n      });\n      return this.createDefaultProgressionState(resourceType, scopeId);\n    }\n  }\n}\n"]}

package/dist/esm/guidance/services/scoped-state-read-custom-implementations.backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoped-state-read-custom-implementations.backend.d.ts","sourceRoot":"","sources":["../../../../../src/guidance/services/scoped-state-read-custom-implementations.backend.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,0CAA0C,EAChD,MAAM,4GAA4G,CAAC;AAuQpH,eAAO,MAAM,oCAAoC,EAAE,0CAA0C,EAE5F,CAAC"}
+{"version":3,"file":"scoped-state-read-custom-implementations.backend.d.ts","sourceRoot":"","sources":["../../../../src/guidance/services/scoped-state-read-custom-implementations.backend.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,0CAA0C,EAChD,MAAM,4GAA4G,CAAC;AAuQpH,eAAO,MAAM,oCAAoC,EAAE,0CAA0C,EAE5F,CAAC"}