npm - @open-mercato/core - Versions diffs - 0.6.5-develop.4498.1.55dc06a57c → 0.6.5-develop.4534.1.b459babe6d - Mend

@open-mercato/core 0.6.5-develop.4498.1.55dc06a57c → 0.6.5-develop.4534.1.b459babe6d

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (105) hide show

package/dist/modules/workflows/lib/workflow-executor.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/workflow-executor.ts"],
-  "sourcesContent": ["/**\n * Workflows Module - Workflow Executor Service\n *\n * Main orchestrator for workflow execution. Handles workflow lifecycle:\n * - Starting workflow instances from definitions\n * - Executing workflow steps and transitions\n * - Completing workflows with final status\n * - Triggering compensation on failure\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager, LockMode } from '@mikro-orm/core'\nimport type { AwilixContainer } from 'awilix'\nimport {\n  WorkflowDefinition,\n  WorkflowInstance,\n  WorkflowEvent,\n  type WorkflowInstanceStatus,\n} from '../data/entities'\nimport { compensateWorkflow } from './compensation-handler'\nimport { findWorkflowDefinition } from './find-definition'\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport interface StartWorkflowOptions {\n  workflowId: string\n  version?: number // Default to latest enabled version\n  initialContext?: Record<string, any>\n  correlationKey?: string\n  metadata?: {\n    entityType?: string\n    entityId?: string\n    initiatedBy?: string\n    labels?: Record<string, string>\n  }\n  tenantId: string\n  organizationId: string\n}\n\nexport interface ExecutionContext {\n  userId?: string\n  dryRun?: boolean\n  timeout?: number\n}\n\nexport interface ExecutionResult {\n  status: WorkflowInstanceStatus\n  currentStep: string\n  context: Record<string, any>\n  events: WorkflowEventSummary[]\n  errors?: string[]\n  executionTime: number\n}\n\nexport interface WorkflowEventSummary {\n  eventType: string\n  occurredAt: Date\n  data?: any\n}\n\nexport class WorkflowExecutionError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'WorkflowExecutionError'\n  }\n}\n\n// ============================================================================\n// Main Orchestration Functions\n// ============================================================================\n\n/**\n * Start a new workflow instance from a definition\n *\n * @param em - Entity manager for database operations\n * @param options - Workflow start options\n * @returns Created workflow instance\n * @throws WorkflowExecutionError if definition not found or validation fails\n */\nexport async function startWorkflow(\n  em: EntityManager,\n  options: StartWorkflowOptions\n): Promise<WorkflowInstance> {\n  const {\n    workflowId,\n    version,\n    initialContext = {},\n    correlationKey,\n    metadata,\n    tenantId,\n    organizationId,\n  } = options\n\n  // Find workflow definition\n  const definition = await findWorkflowDefinition(em, {\n    workflowId,\n    version,\n    tenantId,\n    organizationId,\n  })\n\n  if (!definition) {\n    throw new WorkflowExecutionError(\n      `Workflow definition not found: ${workflowId}${version ? ` v${version}` : ''}`,\n      'DEFINITION_NOT_FOUND',\n      { workflowId, version }\n    )\n  }\n\n  if (!definition.enabled) {\n    throw new WorkflowExecutionError(\n      `Workflow definition is disabled: ${workflowId}`,\n      'DEFINITION_DISABLED',\n      { workflowId, version: definition.version }\n    )\n  }\n\n  // Validate definition has required steps\n  const { steps, transitions } = definition.definition\n  if (!steps || steps.length < 2) {\n    throw new WorkflowExecutionError(\n      'Workflow definition must have at least START and END steps',\n      'INVALID_DEFINITION',\n      { workflowId, stepsCount: steps?.length || 0 }\n    )\n  }\n\n  if (!transitions || transitions.length < 1) {\n    throw new WorkflowExecutionError(\n      'Workflow definition must have at least one transition',\n      'INVALID_DEFINITION',\n      { workflowId, transitionsCount: transitions?.length || 0 }\n    )\n  }\n\n  // Find START step\n  const startStep = steps.find((s: any) => s.stepType === 'START')\n  if (!startStep) {\n    throw new WorkflowExecutionError(\n      'Workflow definition must have a START step',\n      'INVALID_DEFINITION',\n      { workflowId }\n    )\n  }\n\n  // Validate START step pre-conditions if defined\n  if (startStep.preConditions && startStep.preConditions.length > 0) {\n    const { validateWorkflowStart } = await import('./start-validator')\n\n    const validationResult = await validateWorkflowStart(em, {\n      workflowId,\n      version: definition.version,\n      context: initialContext,\n      tenantId,\n      organizationId,\n    })\n\n    if (!validationResult.canStart) {\n      throw new WorkflowExecutionError(\n        `Workflow start pre-conditions failed: ${validationResult.errors.map(e => e.message).join('; ')}`,\n        'START_PRE_CONDITIONS_FAILED',\n        {\n          workflowId,\n          errors: validationResult.errors,\n          validatedRules: validationResult.validatedRules,\n        }\n      )\n    }\n  }\n\n  // Create workflow instance\n  const now = new Date()\n  const instance = em.create(WorkflowInstance, {\n    definitionId: definition.id,\n    workflowId: definition.workflowId,\n    version: definition.version,\n    status: 'RUNNING',\n    currentStepId: startStep.stepId,\n    context: initialContext,\n    correlationKey,\n    metadata,\n    startedAt: now,\n    retryCount: 0,\n    tenantId,\n    organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  await em.persist(instance).flush()\n\n  // Log WORKFLOW_STARTED event\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    eventType: 'WORKFLOW_STARTED',\n    eventData: {\n      workflowId: instance.workflowId,\n      version: instance.version,\n      startStepId: startStep.stepId,\n      initialContext,\n      metadata,\n    },\n    userId: metadata?.initiatedBy,\n    tenantId,\n    organizationId,\n  })\n\n  return instance\n}\n\n/**\n * Execute a workflow instance\n *\n * Main execution loop that processes steps and transitions until:\n * - Workflow completes (reaches END step)\n * - Workflow waits (USER_TASK, SIGNAL, TIMER)\n * - Workflow fails (error occurs)\n * - Timeout is reached\n *\n * @param em - Entity manager\n * @param container - DI container (for activity execution and other services)\n * @param instanceId - Workflow instance ID\n * @param context - Execution context (userId, dryRun, timeout)\n * @returns Execution result with status and events\n */\nexport async function executeWorkflow(\n  em: EntityManager,\n  container: AwilixContainer,\n  instanceId: string,\n  context?: ExecutionContext\n): Promise<ExecutionResult> {\n  const startTime = Date.now()\n  const transactionalEm = em as EntityManager & {\n    transactional?: <TResult>(\n      callback: (trx: EntityManager) => Promise<TResult>,\n    ) => Promise<TResult>\n  }\n\n  const runExecution = async (trx: EntityManager): Promise<ExecutionResult> => {\n    const events: WorkflowEventSummary[] = []\n    const errors: string[] = []\n\n    try {\n      const instance = await getWorkflowInstanceForExecution(trx, instanceId)\n      if (!instance) {\n        throw new WorkflowExecutionError(\n          `Workflow instance not found: ${instanceId}`,\n          'INSTANCE_NOT_FOUND',\n          { instanceId }\n        )\n      }\n\n      if (instance.status === 'COMPLETED') {\n        return {\n          status: 'COMPLETED',\n          currentStep: instance.currentStepId,\n          context: instance.context,\n          events: [],\n          executionTime: 0,\n        }\n      }\n\n      if (instance.status === 'CANCELLED') {\n        throw new WorkflowExecutionError(\n          'Cannot execute cancelled workflow',\n          'WORKFLOW_CANCELLED',\n          { instanceId, status: instance.status }\n        )\n      }\n\n      const definition = await trx.findOne(WorkflowDefinition, {\n        id: instance.definitionId,\n      })\n\n      if (!definition) {\n        throw new WorkflowExecutionError(\n          `Workflow definition not found: ${instance.definitionId}`,\n          'DEFINITION_NOT_FOUND',\n          { definitionId: instance.definitionId }\n        )\n      }\n\n      const maxIterations = 100\n      let iterations = 0\n\n      while (iterations < maxIterations) {\n        iterations++\n\n        const currentInstance = await getWorkflowInstanceForExecution(trx, instanceId, { refresh: iterations > 1 })\n        if (!currentInstance) {\n          throw new WorkflowExecutionError(\n            'Instance not found during execution',\n            'INSTANCE_NOT_FOUND',\n            { instanceId }\n          )\n        }\n\n        const currentStep = definition.definition.steps.find(\n          (s: any) => s.stepId === currentInstance.currentStepId\n        )\n\n        if (currentStep?.stepType === 'END') {\n          await completeWorkflow(trx, container, instanceId, 'COMPLETED')\n          events.push({\n            eventType: 'WORKFLOW_COMPLETED',\n            occurredAt: new Date(),\n          })\n\n          return {\n            status: 'COMPLETED',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            executionTime: Date.now() - startTime,\n          }\n        }\n\n        if (\n          currentStep?.stepType === 'USER_TASK' ||\n          currentStep?.stepType === 'WAIT_FOR_SIGNAL' ||\n          currentStep?.stepType === 'WAIT_FOR_TIMER'\n        ) {\n          return {\n            status: 'RUNNING',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            executionTime: Date.now() - startTime,\n          }\n        }\n\n        const transitions = definition.definition.transitions.filter(\n          (t: any) =>\n            t.fromStepId === currentInstance.currentStepId &&\n            t.trigger === 'auto'\n        )\n\n        if (transitions.length === 0) {\n          return {\n            status: 'RUNNING',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            executionTime: Date.now() - startTime,\n          }\n        }\n\n        const transitionHandler = await import('./transition-handler')\n        const evalContext: any = {\n          workflowContext: currentInstance.context,\n          userId: context?.userId,\n        }\n\n        const validTransitions = await transitionHandler.findValidTransitions(\n          trx,\n          currentInstance,\n          currentInstance.currentStepId!,\n          evalContext\n        )\n\n        const validAutoTransitions = validTransitions.filter(\n          (vt) => vt.isValid && vt.transition?.trigger === 'auto'\n        )\n\n        if (validAutoTransitions.length === 0) {\n          return {\n            status: 'RUNNING',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            executionTime: Date.now() - startTime,\n          }\n        }\n\n        const selectedTransition = validAutoTransitions[0].transition\n\n        try {\n          const transitionResult = await transitionHandler.executeTransition(\n            trx,\n            container,\n            currentInstance,\n            selectedTransition.fromStepId,\n            selectedTransition.toStepId,\n            evalContext\n          )\n\n          if (!transitionResult.success) {\n            const rejectionMessage = transitionResult.error || 'Transition failed'\n            console.error(`[WORKFLOW] Transition rejected (instance: ${currentInstance.id}, workflow: ${currentInstance.workflowId}, step: ${currentInstance.currentStepId} \u2192 ${selectedTransition.toStepId}): ${rejectionMessage}`)\n            errors.push(rejectionMessage)\n\n            return {\n              status: 'FAILED',\n              currentStep: currentInstance.currentStepId,\n              context: currentInstance.context,\n              events,\n              errors,\n              executionTime: Date.now() - startTime,\n            }\n          }\n\n          events.push({\n            eventType: 'TRANSITION_EXECUTED',\n            occurredAt: new Date(),\n            data: {\n              fromStepId: selectedTransition.fromStepId,\n              toStepId: selectedTransition.toStepId,\n              transitionId: selectedTransition.transitionId,\n            },\n          })\n\n          if (transitionResult.pausedForActivities) {\n            await logWorkflowEvent(trx, {\n              workflowInstanceId: currentInstance.id,\n              eventType: 'WORKFLOW_WAITING_FOR_ACTIVITIES',\n              eventData: {\n                pendingActivities: transitionResult.activitiesExecuted?.filter(a => a.async),\n                pausedAtTransition: {\n                  fromStepId: selectedTransition.fromStepId,\n                  toStepId: selectedTransition.toStepId,\n                },\n              },\n              tenantId: currentInstance.tenantId,\n              organizationId: currentInstance.organizationId,\n            })\n\n            events.push({\n              eventType: 'WORKFLOW_WAITING_FOR_ACTIVITIES',\n              occurredAt: new Date(),\n              data: {\n                pendingActivities: transitionResult.activitiesExecuted?.filter(a => a.async),\n              },\n            })\n\n            return {\n              status: 'WAITING_FOR_ACTIVITIES',\n              currentStep: currentInstance.currentStepId,\n              context: currentInstance.context,\n              events,\n              executionTime: Date.now() - startTime,\n            }\n          }\n\n          await trx.flush()\n        } catch (error) {\n          const errorMessage = error instanceof Error ? error.message : String(error)\n          console.error(`[WORKFLOW] Transition execution failed (instance: ${currentInstance.id}, workflow: ${currentInstance.workflowId}, step: ${currentInstance.currentStepId} \u2192 ${selectedTransition.toStepId}):`, error)\n          console.error('[WORKFLOW] Error stack:', error instanceof Error ? error.stack : 'No stack trace')\n          errors.push(errorMessage)\n\n          events.push({\n            eventType: 'TRANSITION_FAILED',\n            occurredAt: new Date(),\n            data: {\n              transitionId: selectedTransition.transitionId,\n              error: errorMessage,\n            },\n          })\n\n          return {\n            status: 'FAILED',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            errors,\n            executionTime: Date.now() - startTime,\n          }\n        }\n      }\n\n      errors.push('Maximum execution iterations reached - possible infinite loop')\n      return {\n        status: 'RUNNING',\n        currentStep: instance.currentStepId,\n        context: instance.context,\n        events,\n        errors,\n        executionTime: Date.now() - startTime,\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error)\n      console.error(`[WORKFLOW] Execution failed (instance: ${instanceId}):`, error)\n      if (error instanceof Error && error.stack) {\n        console.error('[WORKFLOW] Error stack:', error.stack)\n      }\n      errors.push(errorMessage)\n\n      try {\n        const instance = await getWorkflowInstanceForExecution(trx, instanceId, { refresh: true })\n        if (instance && instance.status === 'RUNNING') {\n          instance.status = 'FAILED'\n          instance.errorMessage = errorMessage\n          instance.errorDetails = error instanceof WorkflowExecutionError ? error.details : undefined\n          instance.updatedAt = new Date()\n          await trx.flush()\n\n          await logWorkflowEvent(trx, {\n            workflowInstanceId: instanceId,\n            eventType: 'WORKFLOW_FAILED',\n            eventData: { error: errorMessage },\n            tenantId: instance.tenantId,\n            organizationId: instance.organizationId,\n          })\n        }\n      } catch (updateError) {\n        console.error(`[WORKFLOW] Failed to update instance ${instanceId} with error state:`, updateError)\n      }\n\n      throw error\n    }\n  }\n\n  return typeof transactionalEm.transactional === 'function'\n    ? transactionalEm.transactional((trx) => runExecution(trx))\n    : runExecution(em)\n}\n\n/**\n * Complete a workflow instance with final status\n *\n * @param em - Entity manager\n * @param container\n * @param instanceId - Workflow instance ID\n * @param status - Final status (COMPLETED, FAILED, CANCELLED)\n * @param result - Optional result data\n */\nexport async function completeWorkflow(\n  em: EntityManager,\n  container: AwilixContainer,\n  instanceId: string,\n  status: 'COMPLETED' | 'FAILED' | 'CANCELLED',\n  result?: any\n): Promise<void> {\n  const instance = await getWorkflowInstance(em, instanceId)\n  if (!instance) {\n    throw new WorkflowExecutionError(\n      `Workflow instance not found: ${instanceId}`,\n      'INSTANCE_NOT_FOUND',\n      { instanceId }\n    )\n  }\n\n  // Trigger compensation if workflow failed and has compensatable activities (Phase 8.2)\n  if (status === 'FAILED') {\n    const definition = await em.findOne(WorkflowDefinition, { id: instance.definitionId })\n\n    if (definition && checkIfCompensationNeeded(definition)) {\n      try {\n\n        // Set error message before compensation\n        if (result?.error) {\n          instance.errorMessage = result.error\n          instance.errorDetails = result.details\n          await em.flush()\n        }\n\n        const compensationResult = await compensateWorkflow(\n          em,\n          container,\n          instance,\n          definition,\n          {\n            continueOnError: true // Best-effort compensation\n          }\n        )\n\n        console.log(\n          `[Workflow] Compensation ${compensationResult.status}: ${compensationResult.compensatedActivities}/${compensationResult.totalActivities} activities`\n        )\n\n        // Note: instance status already updated by compensateWorkflow\n        // It will be COMPENSATED or remain FAILED\n        return\n      } catch (error: any) {\n        console.error(`[Workflow] Compensation failed with exception:`, error)\n        // Continue to mark workflow as failed\n      }\n    }\n  }\n\n  // Original completion logic (no compensation needed or status is COMPLETED/CANCELLED)\n  const now = new Date()\n  instance.status = status\n  instance.updatedAt = now\n\n  switch (status) {\n    case 'COMPLETED':\n      instance.completedAt = now\n      if (result) {\n        instance.context = { ...instance.context, __result: result }\n      }\n      break\n\n    case 'FAILED':\n      instance.completedAt = now\n      if (result?.error) {\n        instance.errorMessage = result.error\n        instance.errorDetails = result.details\n      }\n      break\n\n    case 'CANCELLED':\n      instance.cancelledAt = now\n      break\n  }\n\n  await em.flush()\n\n  // Log completion event\n  const eventType =\n    status === 'COMPLETED'\n      ? 'WORKFLOW_COMPLETED'\n      : status === 'FAILED'\n        ? 'WORKFLOW_FAILED'\n        : 'WORKFLOW_CANCELLED'\n\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instanceId,\n    eventType,\n    eventData: result || {},\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n}\n\n/**\n * Resume workflow after async activities complete\n *\n * Called by the activity worker after all async activities finish execution.\n * Checks if all activities are done, merges outputs into context, and resumes execution.\n *\n * @param em - Entity manager\n * @param container - DI container\n * @param instanceId - Workflow instance ID\n */\nexport async function resumeWorkflowAfterActivities(\n  em: EntityManager,\n  container: AwilixContainer,\n  instanceId: string\n): Promise<void> {\n  const transactionalEm = em as EntityManager & {\n    transactional?: <TResult>(callback: (trx: EntityManager) => Promise<TResult>) => Promise<TResult>\n  }\n\n  const runResume = async (trx: EntityManager): Promise<{ continueExecution: boolean }> => {\n    const instance = await trx.findOne(WorkflowInstance, {\n      id: instanceId,\n      status: 'WAITING_FOR_ACTIVITIES',\n    }, { lockMode: LockMode.PESSIMISTIC_WRITE })\n\n    if (!instance) {\n      throw new Error('Workflow instance not waiting for activities')\n    }\n\n    const pendingJobIds = (instance.context._pendingAsyncActivities as any[]) || []\n\n    const completedActivities = await trx.count(WorkflowEvent, {\n      workflowInstanceId: instanceId,\n      eventType: 'ACTIVITY_COMPLETED',\n      eventData: { async: true },\n    })\n\n    const failedActivities = await trx.count(WorkflowEvent, {\n      workflowInstanceId: instanceId,\n      eventType: 'ACTIVITY_FAILED',\n      eventData: { async: true },\n    })\n\n    const totalProcessed = completedActivities + failedActivities\n\n    if (totalProcessed < pendingJobIds.length) {\n      throw new Error('Activities still pending')\n    }\n\n    if (failedActivities > 0) {\n      const failedEvents = await trx.find(WorkflowEvent, {\n        workflowInstanceId: instanceId,\n        eventType: 'ACTIVITY_FAILED',\n        eventData: { async: true },\n      })\n\n      instance.status = 'FAILED'\n      instance.errorMessage = `${failedActivities} async activities failed`\n      instance.errorDetails = {\n        failedActivities: failedEvents.map(e => ({\n          activityId: e.eventData.activityId,\n          error: e.eventData.error,\n          jobId: e.eventData.jobId,\n        })),\n      }\n      await trx.flush()\n\n      await logWorkflowEvent(trx, {\n        workflowInstanceId: instanceId,\n        eventType: 'WORKFLOW_FAILED',\n        eventData: {\n          reason: 'Async activities failed',\n          failedActivities: instance.errorDetails.failedActivities,\n        },\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return { continueExecution: false }\n    }\n\n    const completedEvents = await trx.find(WorkflowEvent, {\n      workflowInstanceId: instanceId,\n      eventType: 'ACTIVITY_COMPLETED',\n      eventData: { async: true },\n    })\n\n    for (const event of completedEvents) {\n      if (event.eventData.output) {\n        instance.context = {\n          ...instance.context,\n          [`${event.eventData.activityId}_result`]: event.eventData.output,\n        }\n      }\n    }\n\n    delete instance.context._pendingAsyncActivities\n\n    const pendingTransition = instance.pendingTransition\n\n    if (!pendingTransition) {\n      console.warn('[WORKFLOW] No pending transition found during resume')\n      instance.status = 'RUNNING'\n      await trx.flush()\n\n      await logWorkflowEvent(trx, {\n        workflowInstanceId: instanceId,\n        eventType: 'WORKFLOW_RESUMED',\n        eventData: {\n          reason: 'All async activities completed',\n          completedActivities: completedActivities,\n        },\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return { continueExecution: true }\n    }\n\n    console.log('[WORKFLOW] Completing pending transition:', {\n      toStepId: pendingTransition.toStepId,\n      from: instance.currentStepId,\n    })\n\n    const definition = await trx.findOneOrFail(WorkflowDefinition, {\n      id: instance.definitionId,\n    })\n\n    const step = definition.definition.steps.find(s => s.stepId === pendingTransition.toStepId)\n\n    instance.currentStepId = pendingTransition.toStepId\n    instance.status = 'RUNNING'\n    instance.pendingTransition = null\n    instance.updatedAt = new Date()\n    await trx.flush()\n\n    await logWorkflowEvent(trx, {\n      workflowInstanceId: instance.id,\n      eventType: 'STEP_ENTERED',\n      eventData: {\n        stepId: pendingTransition.toStepId,\n        stepName: step?.stepName,\n        stepType: step?.stepType,\n      },\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    await logWorkflowEvent(trx, {\n      workflowInstanceId: instanceId,\n      eventType: 'WORKFLOW_RESUMED',\n      eventData: {\n        reason: 'Async activities completed, resuming pending transition',\n        completedActivities: completedActivities,\n        completedTransitionTo: pendingTransition.toStepId,\n      },\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    const { executeStep } = await import('./step-handler')\n    await executeStep(\n      trx,\n      instance,\n      pendingTransition.toStepId,\n      {\n        workflowContext: instance.context || {},\n        userId: undefined,\n      },\n      container\n    )\n\n    return { continueExecution: true }\n  }\n\n  const resumeResult = typeof transactionalEm.transactional === 'function'\n    ? await transactionalEm.transactional((trx) => runResume(trx))\n    : await runResume(em)\n\n  if (resumeResult.continueExecution) {\n    await executeWorkflow(em, container, instanceId)\n  }\n}\n\n/**\n * Check if workflow definition has any compensatable activities\n */\nfunction checkIfCompensationNeeded(definition: WorkflowDefinition): boolean {\n  // Check if any activities have compensation defined\n  for (const transition of definition.definition.transitions) {\n    if (transition.activities) {\n      for (const activity of transition.activities) {\n        if (activity.compensation?.activityId) {\n          return true\n        }\n      }\n    }\n  }\n\n  // Check root-level activities (legacy)\n  if (definition.definition.activities) {\n    for (const activity of definition.definition.activities) {\n      if (activity.compensation?.activityId) {\n        return true\n      }\n    }\n  }\n\n  return false\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Get workflow instance by ID\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @returns Workflow instance or null if not found\n */\nexport async function getWorkflowInstance(\n  em: EntityManager,\n  instanceId: string\n): Promise<WorkflowInstance | null> {\n  return em.findOne(WorkflowInstance, { id: instanceId })\n}\n\nasync function getWorkflowInstanceForExecution(\n  em: EntityManager,\n  instanceId: string,\n  options?: { refresh?: boolean }\n): Promise<WorkflowInstance | null> {\n  return em.findOne(\n    WorkflowInstance,\n    { id: instanceId },\n    {\n      lockMode: LockMode.PESSIMISTIC_WRITE,\n      ...(options?.refresh ? { refresh: true } : {}),\n    }\n  )\n}\n\n/**\n * Update workflow context with new data\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @param updates - Context updates (merged with existing context)\n */\nexport async function updateWorkflowContext(\n  em: EntityManager,\n  instanceId: string,\n  updates: Record<string, any>\n): Promise<void> {\n  const instance = await getWorkflowInstance(em, instanceId)\n  if (!instance) {\n    throw new WorkflowExecutionError(\n      `Workflow instance not found: ${instanceId}`,\n      'INSTANCE_NOT_FOUND',\n      { instanceId }\n    )\n  }\n\n  instance.context = {\n    ...instance.context,\n    ...updates,\n  }\n  instance.updatedAt = new Date()\n\n  await em.flush()\n}\n\n// findWorkflowDefinition is imported from ./find-definition\n\n/**\n * Log workflow event to event sourcing table\n *\n * @param em - Entity manager\n * @param event - Event data\n */\nasync function logWorkflowEvent(\n  em: EntityManager,\n  event: {\n    workflowInstanceId: string\n    stepInstanceId?: string\n    eventType: string\n    eventData: any\n    userId?: string\n    tenantId: string\n    organizationId: string\n  }\n): Promise<WorkflowEvent> {\n  const workflowEvent = em.create(WorkflowEvent, {\n    ...event,\n    occurredAt: new Date(),\n  })\n\n  await em.persist(workflowEvent).flush()\n  return workflowEvent\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Workflows Module - Workflow Executor Service\n *\n * Main orchestrator for workflow execution. Handles workflow lifecycle:\n * - Starting workflow instances from definitions\n * - Executing workflow steps and transitions\n * - Completing workflows with final status\n * - Triggering compensation on failure\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager, LockMode } from '@mikro-orm/core'\nimport type { AwilixContainer } from 'awilix'\nimport {\n  WorkflowDefinition,\n  WorkflowInstance,\n  WorkflowEvent,\n  type WorkflowInstanceStatus,\n} from '../data/entities'\nimport { compensateWorkflow } from './compensation-handler'\nimport { findWorkflowDefinition } from './find-definition'\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport interface StartWorkflowOptions {\n  workflowId: string\n  version?: number // Default to latest enabled version\n  initialContext?: Record<string, any>\n  correlationKey?: string\n  metadata?: {\n    entityType?: string\n    entityId?: string\n    initiatedBy?: string\n    labels?: Record<string, string>\n  }\n  tenantId: string\n  organizationId: string\n}\n\nexport interface ExecutionContext {\n  userId?: string\n  dryRun?: boolean\n  timeout?: number\n}\n\nexport interface ExecutionResult {\n  status: WorkflowInstanceStatus\n  currentStep: string\n  context: Record<string, any>\n  events: WorkflowEventSummary[]\n  errors?: string[]\n  executionTime: number\n}\n\nexport interface WorkflowEventSummary {\n  eventType: string\n  occurredAt: Date\n  data?: any\n}\n\nexport class WorkflowExecutionError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'WorkflowExecutionError'\n  }\n}\n\n// ============================================================================\n// Main Orchestration Functions\n// ============================================================================\n\n/**\n * Start a new workflow instance from a definition\n *\n * @param em - Entity manager for database operations\n * @param options - Workflow start options\n * @returns Created workflow instance\n * @throws WorkflowExecutionError if definition not found or validation fails\n */\nexport async function startWorkflow(\n  em: EntityManager,\n  options: StartWorkflowOptions\n): Promise<WorkflowInstance> {\n  const {\n    workflowId,\n    version,\n    initialContext = {},\n    correlationKey,\n    metadata,\n    tenantId,\n    organizationId,\n  } = options\n\n  // Find workflow definition\n  const definition = await findWorkflowDefinition(em, {\n    workflowId,\n    version,\n    tenantId,\n    organizationId,\n  })\n\n  if (!definition) {\n    throw new WorkflowExecutionError(\n      `Workflow definition not found: ${workflowId}${version ? ` v${version}` : ''}`,\n      'DEFINITION_NOT_FOUND',\n      { workflowId, version }\n    )\n  }\n\n  if (!definition.enabled) {\n    throw new WorkflowExecutionError(\n      `Workflow definition is disabled: ${workflowId}`,\n      'DEFINITION_DISABLED',\n      { workflowId, version: definition.version }\n    )\n  }\n\n  // Validate definition has required steps\n  const { steps, transitions } = definition.definition\n  if (!steps || steps.length < 2) {\n    throw new WorkflowExecutionError(\n      'Workflow definition must have at least START and END steps',\n      'INVALID_DEFINITION',\n      { workflowId, stepsCount: steps?.length || 0 }\n    )\n  }\n\n  if (!transitions || transitions.length < 1) {\n    throw new WorkflowExecutionError(\n      'Workflow definition must have at least one transition',\n      'INVALID_DEFINITION',\n      { workflowId, transitionsCount: transitions?.length || 0 }\n    )\n  }\n\n  // Find START step\n  const startStep = steps.find((s: any) => s.stepType === 'START')\n  if (!startStep) {\n    throw new WorkflowExecutionError(\n      'Workflow definition must have a START step',\n      'INVALID_DEFINITION',\n      { workflowId }\n    )\n  }\n\n  // Validate START step pre-conditions if defined\n  if (startStep.preConditions && startStep.preConditions.length > 0) {\n    const { validateWorkflowStart } = await import('./start-validator')\n\n    const validationResult = await validateWorkflowStart(em, {\n      workflowId,\n      version: definition.version,\n      context: initialContext,\n      tenantId,\n      organizationId,\n    })\n\n    if (!validationResult.canStart) {\n      throw new WorkflowExecutionError(\n        `Workflow start pre-conditions failed: ${validationResult.errors.map(e => e.message).join('; ')}`,\n        'START_PRE_CONDITIONS_FAILED',\n        {\n          workflowId,\n          errors: validationResult.errors,\n          validatedRules: validationResult.validatedRules,\n        }\n      )\n    }\n  }\n\n  // Create workflow instance\n  const now = new Date()\n  const instance = em.create(WorkflowInstance, {\n    definitionId: definition.id,\n    workflowId: definition.workflowId,\n    version: definition.version,\n    status: 'RUNNING',\n    currentStepId: startStep.stepId,\n    context: initialContext,\n    correlationKey,\n    metadata,\n    startedAt: now,\n    retryCount: 0,\n    tenantId,\n    organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  await em.persist(instance).flush()\n\n  // Log WORKFLOW_STARTED event\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    eventType: 'WORKFLOW_STARTED',\n    eventData: {\n      workflowId: instance.workflowId,\n      version: instance.version,\n      startStepId: startStep.stepId,\n      initialContext,\n      metadata,\n    },\n    userId: metadata?.initiatedBy,\n    tenantId,\n    organizationId,\n  })\n\n  return instance\n}\n\n/**\n * Execute a workflow instance\n *\n * Main execution loop that processes steps and transitions until:\n * - Workflow completes (reaches END step)\n * - Workflow waits (USER_TASK, SIGNAL, TIMER)\n * - Workflow fails (error occurs)\n * - Timeout is reached\n *\n * @param em - Entity manager\n * @param container - DI container (for activity execution and other services)\n * @param instanceId - Workflow instance ID\n * @param context - Execution context (userId, dryRun, timeout)\n * @returns Execution result with status and events\n */\nexport async function executeWorkflow(\n  em: EntityManager,\n  container: AwilixContainer,\n  instanceId: string,\n  context?: ExecutionContext\n): Promise<ExecutionResult> {\n  const startTime = Date.now()\n  const transactionalEm = em as EntityManager & {\n    transactional?: <TResult>(\n      callback: (trx: EntityManager) => Promise<TResult>,\n    ) => Promise<TResult>\n  }\n\n  const runExecution = async (trx: EntityManager): Promise<ExecutionResult> => {\n    const events: WorkflowEventSummary[] = []\n    const errors: string[] = []\n\n    try {\n      const instance = await getWorkflowInstanceForExecution(trx, instanceId)\n      if (!instance) {\n        throw new WorkflowExecutionError(\n          `Workflow instance not found: ${instanceId}`,\n          'INSTANCE_NOT_FOUND',\n          { instanceId }\n        )\n      }\n\n      if (instance.status === 'COMPLETED') {\n        return {\n          status: 'COMPLETED',\n          currentStep: instance.currentStepId,\n          context: instance.context,\n          events: [],\n          executionTime: 0,\n        }\n      }\n\n      if (instance.status === 'CANCELLED') {\n        throw new WorkflowExecutionError(\n          'Cannot execute cancelled workflow',\n          'WORKFLOW_CANCELLED',\n          { instanceId, status: instance.status }\n        )\n      }\n\n      const definition = await trx.findOne(WorkflowDefinition, {\n        id: instance.definitionId,\n      })\n\n      if (!definition) {\n        throw new WorkflowExecutionError(\n          `Workflow definition not found: ${instance.definitionId}`,\n          'DEFINITION_NOT_FOUND',\n          { definitionId: instance.definitionId }\n        )\n      }\n\n      const maxIterations = 100\n      let iterations = 0\n\n      while (iterations < maxIterations) {\n        iterations++\n\n        const currentInstance = await getWorkflowInstanceForExecution(trx, instanceId, { refresh: iterations > 1 })\n        if (!currentInstance) {\n          throw new WorkflowExecutionError(\n            'Instance not found during execution',\n            'INSTANCE_NOT_FOUND',\n            { instanceId }\n          )\n        }\n\n        // Parallel execution: while the instance is FORKED, drive the branches.\n        if (currentInstance.status === 'FORKED') {\n          const { advanceBranches } = await import('./parallel-handler')\n          const branchResult = await advanceBranches(trx, container, currentInstance, definition, {\n            userId: context?.userId,\n          })\n\n          if (branchResult.outcome === 'joined') {\n            // Instance resumed at the post-join step; continue single-token.\n            continue\n          }\n\n          if (branchResult.outcome === 'failed') {\n            errors.push(branchResult.error || 'Parallel branch failed')\n            await completeWorkflow(trx, container, instanceId, 'FAILED', {\n              error: branchResult.error || 'Parallel branch failed',\n            })\n            return {\n              status: 'FAILED',\n              currentStep: currentInstance.currentStepId,\n              context: currentInstance.context,\n              events,\n              errors,\n              executionTime: Date.now() - startTime,\n            }\n          }\n\n          // 'waiting' \u2014 all branches paused for external resume (task/signal/timer/async).\n          return {\n            status: 'RUNNING',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            executionTime: Date.now() - startTime,\n          }\n        }\n\n        const currentStep = definition.definition.steps.find(\n          (s: any) => s.stepId === currentInstance.currentStepId\n        )\n\n        if (currentStep?.stepType === 'END') {\n          await completeWorkflow(trx, container, instanceId, 'COMPLETED')\n          events.push({\n            eventType: 'WORKFLOW_COMPLETED',\n            occurredAt: new Date(),\n          })\n\n          return {\n            status: 'COMPLETED',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            executionTime: Date.now() - startTime,\n          }\n        }\n\n        if (\n          currentStep?.stepType === 'USER_TASK' ||\n          currentStep?.stepType === 'WAIT_FOR_SIGNAL' ||\n          currentStep?.stepType === 'WAIT_FOR_TIMER'\n        ) {\n          return {\n            status: 'RUNNING',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            executionTime: Date.now() - startTime,\n          }\n        }\n\n        const transitions = definition.definition.transitions.filter(\n          (t: any) =>\n            t.fromStepId === currentInstance.currentStepId &&\n            t.trigger === 'auto'\n        )\n\n        if (transitions.length === 0) {\n          return {\n            status: 'RUNNING',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            executionTime: Date.now() - startTime,\n          }\n        }\n\n        const transitionHandler = await import('./transition-handler')\n        const evalContext: any = {\n          workflowContext: currentInstance.context,\n          userId: context?.userId,\n        }\n\n        const validTransitions = await transitionHandler.findValidTransitions(\n          trx,\n          currentInstance,\n          currentInstance.currentStepId!,\n          evalContext\n        )\n\n        const validAutoTransitions = validTransitions.filter(\n          (vt) => vt.isValid && vt.transition?.trigger === 'auto'\n        )\n\n        if (validAutoTransitions.length === 0) {\n          return {\n            status: 'RUNNING',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            executionTime: Date.now() - startTime,\n          }\n        }\n\n        const selectedTransition = validAutoTransitions[0].transition\n\n        try {\n          const transitionResult = await transitionHandler.executeTransition(\n            trx,\n            container,\n            currentInstance,\n            selectedTransition.fromStepId,\n            selectedTransition.toStepId,\n            evalContext\n          )\n\n          if (!transitionResult.success) {\n            const rejectionMessage = transitionResult.error || 'Transition failed'\n            console.error(`[WORKFLOW] Transition rejected (instance: ${currentInstance.id}, workflow: ${currentInstance.workflowId}, step: ${currentInstance.currentStepId} \u2192 ${selectedTransition.toStepId}): ${rejectionMessage}`)\n            errors.push(rejectionMessage)\n\n            return {\n              status: 'FAILED',\n              currentStep: currentInstance.currentStepId,\n              context: currentInstance.context,\n              events,\n              errors,\n              executionTime: Date.now() - startTime,\n            }\n          }\n\n          events.push({\n            eventType: 'TRANSITION_EXECUTED',\n            occurredAt: new Date(),\n            data: {\n              fromStepId: selectedTransition.fromStepId,\n              toStepId: selectedTransition.toStepId,\n              transitionId: selectedTransition.transitionId,\n            },\n          })\n\n          if (transitionResult.pausedForActivities) {\n            await logWorkflowEvent(trx, {\n              workflowInstanceId: currentInstance.id,\n              eventType: 'WORKFLOW_WAITING_FOR_ACTIVITIES',\n              eventData: {\n                pendingActivities: transitionResult.activitiesExecuted?.filter(a => a.async),\n                pausedAtTransition: {\n                  fromStepId: selectedTransition.fromStepId,\n                  toStepId: selectedTransition.toStepId,\n                },\n              },\n              tenantId: currentInstance.tenantId,\n              organizationId: currentInstance.organizationId,\n            })\n\n            events.push({\n              eventType: 'WORKFLOW_WAITING_FOR_ACTIVITIES',\n              occurredAt: new Date(),\n              data: {\n                pendingActivities: transitionResult.activitiesExecuted?.filter(a => a.async),\n              },\n            })\n\n            return {\n              status: 'WAITING_FOR_ACTIVITIES',\n              currentStep: currentInstance.currentStepId,\n              context: currentInstance.context,\n              events,\n              executionTime: Date.now() - startTime,\n            }\n          }\n\n          await trx.flush()\n        } catch (error) {\n          const errorMessage = error instanceof Error ? error.message : String(error)\n          console.error(`[WORKFLOW] Transition execution failed (instance: ${currentInstance.id}, workflow: ${currentInstance.workflowId}, step: ${currentInstance.currentStepId} \u2192 ${selectedTransition.toStepId}):`, error)\n          console.error('[WORKFLOW] Error stack:', error instanceof Error ? error.stack : 'No stack trace')\n          errors.push(errorMessage)\n\n          events.push({\n            eventType: 'TRANSITION_FAILED',\n            occurredAt: new Date(),\n            data: {\n              transitionId: selectedTransition.transitionId,\n              error: errorMessage,\n            },\n          })\n\n          return {\n            status: 'FAILED',\n            currentStep: currentInstance.currentStepId,\n            context: currentInstance.context,\n            events,\n            errors,\n            executionTime: Date.now() - startTime,\n          }\n        }\n      }\n\n      errors.push('Maximum execution iterations reached - possible infinite loop')\n      return {\n        status: 'RUNNING',\n        currentStep: instance.currentStepId,\n        context: instance.context,\n        events,\n        errors,\n        executionTime: Date.now() - startTime,\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error)\n      console.error(`[WORKFLOW] Execution failed (instance: ${instanceId}):`, error)\n      if (error instanceof Error && error.stack) {\n        console.error('[WORKFLOW] Error stack:', error.stack)\n      }\n      errors.push(errorMessage)\n\n      try {\n        const instance = await getWorkflowInstanceForExecution(trx, instanceId, { refresh: true })\n        if (instance && instance.status === 'RUNNING') {\n          instance.status = 'FAILED'\n          instance.errorMessage = errorMessage\n          instance.errorDetails = error instanceof WorkflowExecutionError ? error.details : undefined\n          instance.updatedAt = new Date()\n          await trx.flush()\n\n          await logWorkflowEvent(trx, {\n            workflowInstanceId: instanceId,\n            eventType: 'WORKFLOW_FAILED',\n            eventData: { error: errorMessage },\n            tenantId: instance.tenantId,\n            organizationId: instance.organizationId,\n          })\n        }\n      } catch (updateError) {\n        console.error(`[WORKFLOW] Failed to update instance ${instanceId} with error state:`, updateError)\n      }\n\n      throw error\n    }\n  }\n\n  return typeof transactionalEm.transactional === 'function'\n    ? transactionalEm.transactional((trx) => runExecution(trx))\n    : runExecution(em)\n}\n\n/**\n * Complete a workflow instance with final status\n *\n * @param em - Entity manager\n * @param container\n * @param instanceId - Workflow instance ID\n * @param status - Final status (COMPLETED, FAILED, CANCELLED)\n * @param result - Optional result data\n */\nexport async function completeWorkflow(\n  em: EntityManager,\n  container: AwilixContainer,\n  instanceId: string,\n  status: 'COMPLETED' | 'FAILED' | 'CANCELLED',\n  result?: any\n): Promise<void> {\n  const instance = await getWorkflowInstance(em, instanceId)\n  if (!instance) {\n    throw new WorkflowExecutionError(\n      `Workflow instance not found: ${instanceId}`,\n      'INSTANCE_NOT_FOUND',\n      { instanceId }\n    )\n  }\n\n  // Trigger compensation if workflow failed and has compensatable activities (Phase 8.2)\n  if (status === 'FAILED') {\n    const definition = await em.findOne(WorkflowDefinition, { id: instance.definitionId })\n\n    if (definition && checkIfCompensationNeeded(definition)) {\n      try {\n\n        // Set error message before compensation\n        if (result?.error) {\n          instance.errorMessage = result.error\n          instance.errorDetails = result.details\n          await em.flush()\n        }\n\n        const compensationResult = await compensateWorkflow(\n          em,\n          container,\n          instance,\n          definition,\n          {\n            continueOnError: true // Best-effort compensation\n          }\n        )\n\n        console.log(\n          `[Workflow] Compensation ${compensationResult.status}: ${compensationResult.compensatedActivities}/${compensationResult.totalActivities} activities`\n        )\n\n        // Note: instance status already updated by compensateWorkflow\n        // It will be COMPENSATED or remain FAILED\n        return\n      } catch (error: any) {\n        console.error(`[Workflow] Compensation failed with exception:`, error)\n        // Continue to mark workflow as failed\n      }\n    }\n  }\n\n  // Original completion logic (no compensation needed or status is COMPLETED/CANCELLED)\n  const now = new Date()\n  instance.status = status\n  instance.updatedAt = now\n\n  switch (status) {\n    case 'COMPLETED':\n      instance.completedAt = now\n      if (result) {\n        instance.context = { ...instance.context, __result: result }\n      }\n      break\n\n    case 'FAILED':\n      instance.completedAt = now\n      if (result?.error) {\n        instance.errorMessage = result.error\n        instance.errorDetails = result.details\n      }\n      break\n\n    case 'CANCELLED':\n      instance.cancelledAt = now\n      break\n  }\n\n  await em.flush()\n\n  // Log completion event\n  const eventType =\n    status === 'COMPLETED'\n      ? 'WORKFLOW_COMPLETED'\n      : status === 'FAILED'\n        ? 'WORKFLOW_FAILED'\n        : 'WORKFLOW_CANCELLED'\n\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instanceId,\n    eventType,\n    eventData: result || {},\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n}\n\n/**\n * Resume workflow after async activities complete\n *\n * Called by the activity worker after all async activities finish execution.\n * Checks if all activities are done, merges outputs into context, and resumes execution.\n *\n * @param em - Entity manager\n * @param container - DI container\n * @param instanceId - Workflow instance ID\n */\nexport async function resumeWorkflowAfterActivities(\n  em: EntityManager,\n  container: AwilixContainer,\n  instanceId: string,\n  branchInstanceId?: string | null\n): Promise<void> {\n  const transactionalEm = em as EntityManager & {\n    transactional?: <TResult>(callback: (trx: EntityManager) => Promise<TResult>) => Promise<TResult>\n  }\n\n  // Branch-scoped async resume: the instance is FORKED and the branch (not the\n  // instance) is WAITING_FOR_ACTIVITIES. Resume just that branch, then let the\n  // interleaved loop continue. Missing branchInstanceId \u2192 legacy instance path.\n  if (branchInstanceId) {\n    const { resumeBranchAfterActivities } = await import('./parallel-handler')\n    const branchResume = typeof transactionalEm.transactional === 'function'\n      ? await transactionalEm.transactional((trx) => resumeBranchAfterActivities(trx, container, instanceId, branchInstanceId))\n      : await resumeBranchAfterActivities(em, container, instanceId, branchInstanceId)\n    if (branchResume.continueExecution) {\n      await executeWorkflow(em, container, instanceId)\n    }\n    return\n  }\n\n  const runResume = async (trx: EntityManager): Promise<{ continueExecution: boolean }> => {\n    const instance = await trx.findOne(WorkflowInstance, {\n      id: instanceId,\n      status: 'WAITING_FOR_ACTIVITIES',\n    }, { lockMode: LockMode.PESSIMISTIC_WRITE })\n\n    if (!instance) {\n      throw new Error('Workflow instance not waiting for activities')\n    }\n\n    const pendingJobIds = (instance.context._pendingAsyncActivities as any[]) || []\n\n    const completedActivities = await trx.count(WorkflowEvent, {\n      workflowInstanceId: instanceId,\n      eventType: 'ACTIVITY_COMPLETED',\n      eventData: { async: true },\n    })\n\n    const failedActivities = await trx.count(WorkflowEvent, {\n      workflowInstanceId: instanceId,\n      eventType: 'ACTIVITY_FAILED',\n      eventData: { async: true },\n    })\n\n    const totalProcessed = completedActivities + failedActivities\n\n    if (totalProcessed < pendingJobIds.length) {\n      throw new Error('Activities still pending')\n    }\n\n    if (failedActivities > 0) {\n      const failedEvents = await trx.find(WorkflowEvent, {\n        workflowInstanceId: instanceId,\n        eventType: 'ACTIVITY_FAILED',\n        eventData: { async: true },\n      })\n\n      instance.status = 'FAILED'\n      instance.errorMessage = `${failedActivities} async activities failed`\n      instance.errorDetails = {\n        failedActivities: failedEvents.map(e => ({\n          activityId: e.eventData.activityId,\n          error: e.eventData.error,\n          jobId: e.eventData.jobId,\n        })),\n      }\n      await trx.flush()\n\n      await logWorkflowEvent(trx, {\n        workflowInstanceId: instanceId,\n        eventType: 'WORKFLOW_FAILED',\n        eventData: {\n          reason: 'Async activities failed',\n          failedActivities: instance.errorDetails.failedActivities,\n        },\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return { continueExecution: false }\n    }\n\n    const completedEvents = await trx.find(WorkflowEvent, {\n      workflowInstanceId: instanceId,\n      eventType: 'ACTIVITY_COMPLETED',\n      eventData: { async: true },\n    })\n\n    for (const event of completedEvents) {\n      if (event.eventData.output) {\n        instance.context = {\n          ...instance.context,\n          [`${event.eventData.activityId}_result`]: event.eventData.output,\n        }\n      }\n    }\n\n    delete instance.context._pendingAsyncActivities\n\n    const pendingTransition = instance.pendingTransition\n\n    if (!pendingTransition) {\n      console.warn('[WORKFLOW] No pending transition found during resume')\n      instance.status = 'RUNNING'\n      await trx.flush()\n\n      await logWorkflowEvent(trx, {\n        workflowInstanceId: instanceId,\n        eventType: 'WORKFLOW_RESUMED',\n        eventData: {\n          reason: 'All async activities completed',\n          completedActivities: completedActivities,\n        },\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return { continueExecution: true }\n    }\n\n    console.log('[WORKFLOW] Completing pending transition:', {\n      toStepId: pendingTransition.toStepId,\n      from: instance.currentStepId,\n    })\n\n    const definition = await trx.findOneOrFail(WorkflowDefinition, {\n      id: instance.definitionId,\n    })\n\n    const step = definition.definition.steps.find(s => s.stepId === pendingTransition.toStepId)\n\n    instance.currentStepId = pendingTransition.toStepId\n    instance.status = 'RUNNING'\n    instance.pendingTransition = null\n    instance.updatedAt = new Date()\n    await trx.flush()\n\n    await logWorkflowEvent(trx, {\n      workflowInstanceId: instance.id,\n      eventType: 'STEP_ENTERED',\n      eventData: {\n        stepId: pendingTransition.toStepId,\n        stepName: step?.stepName,\n        stepType: step?.stepType,\n      },\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    await logWorkflowEvent(trx, {\n      workflowInstanceId: instanceId,\n      eventType: 'WORKFLOW_RESUMED',\n      eventData: {\n        reason: 'Async activities completed, resuming pending transition',\n        completedActivities: completedActivities,\n        completedTransitionTo: pendingTransition.toStepId,\n      },\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    const { executeStep } = await import('./step-handler')\n    await executeStep(\n      trx,\n      instance,\n      pendingTransition.toStepId,\n      {\n        workflowContext: instance.context || {},\n        userId: undefined,\n      },\n      container\n    )\n\n    return { continueExecution: true }\n  }\n\n  const resumeResult = typeof transactionalEm.transactional === 'function'\n    ? await transactionalEm.transactional((trx) => runResume(trx))\n    : await runResume(em)\n\n  if (resumeResult.continueExecution) {\n    await executeWorkflow(em, container, instanceId)\n  }\n}\n\n/**\n * Check if workflow definition has any compensatable activities\n */\nfunction checkIfCompensationNeeded(definition: WorkflowDefinition): boolean {\n  // Check if any activities have compensation defined\n  for (const transition of definition.definition.transitions) {\n    if (transition.activities) {\n      for (const activity of transition.activities) {\n        if (activity.compensation?.activityId) {\n          return true\n        }\n      }\n    }\n  }\n\n  // Check root-level activities (legacy)\n  if (definition.definition.activities) {\n    for (const activity of definition.definition.activities) {\n      if (activity.compensation?.activityId) {\n        return true\n      }\n    }\n  }\n\n  return false\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Get workflow instance by ID\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @returns Workflow instance or null if not found\n */\nexport async function getWorkflowInstance(\n  em: EntityManager,\n  instanceId: string\n): Promise<WorkflowInstance | null> {\n  return em.findOne(WorkflowInstance, { id: instanceId })\n}\n\nasync function getWorkflowInstanceForExecution(\n  em: EntityManager,\n  instanceId: string,\n  options?: { refresh?: boolean }\n): Promise<WorkflowInstance | null> {\n  return em.findOne(\n    WorkflowInstance,\n    { id: instanceId },\n    {\n      lockMode: LockMode.PESSIMISTIC_WRITE,\n      ...(options?.refresh ? { refresh: true } : {}),\n    }\n  )\n}\n\n/**\n * Update workflow context with new data\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @param updates - Context updates (merged with existing context)\n */\nexport async function updateWorkflowContext(\n  em: EntityManager,\n  instanceId: string,\n  updates: Record<string, any>\n): Promise<void> {\n  const instance = await getWorkflowInstance(em, instanceId)\n  if (!instance) {\n    throw new WorkflowExecutionError(\n      `Workflow instance not found: ${instanceId}`,\n      'INSTANCE_NOT_FOUND',\n      { instanceId }\n    )\n  }\n\n  instance.context = {\n    ...instance.context,\n    ...updates,\n  }\n  instance.updatedAt = new Date()\n\n  await em.flush()\n}\n\n// findWorkflowDefinition is imported from ./find-definition\n\n/**\n * Log workflow event to event sourcing table\n *\n * @param em - Entity manager\n * @param event - Event data\n */\nasync function logWorkflowEvent(\n  em: EntityManager,\n  event: {\n    workflowInstanceId: string\n    stepInstanceId?: string\n    eventType: string\n    eventData: any\n    userId?: string\n    tenantId: string\n    organizationId: string\n  }\n): Promise<WorkflowEvent> {\n  const workflowEvent = em.create(WorkflowEvent, {\n    ...event,\n    occurredAt: new Date(),\n  })\n\n  await em.persist(workflowEvent).flush()\n  return workflowEvent\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/workflows/migrations/Migration20260602120000.js ADDED Viewed

@@ -0,0 +1,24 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260602120000 extends Migration {
+  async up() {
+    this.addSql(`create table "workflow_branch_instances" ("id" uuid not null default gen_random_uuid(), "workflow_instance_id" uuid not null, "fork_step_id" varchar(100) not null, "join_step_id" varchar(100) not null, "branch_key" varchar(100) not null, "parent_branch_id" uuid null, "current_step_id" varchar(100) not null, "status" varchar(30) not null, "context_namespace" jsonb not null, "pending_transition" jsonb null, "error_message" text null, "error_details" jsonb null, "started_at" timestamptz null, "completed_at" timestamptz null, "tenant_id" uuid not null, "organization_id" uuid not null, "created_at" timestamptz not null, "updated_at" timestamptz not null, constraint "workflow_branch_instances_pkey" primary key ("id"));`);
+    this.addSql(`create index "workflow_branch_instances_tenant_org_idx" on "workflow_branch_instances" ("tenant_id", "organization_id");`);
+    this.addSql(`create index "workflow_branch_instances_instance_fork_idx" on "workflow_branch_instances" ("workflow_instance_id", "fork_step_id");`);
+    this.addSql(`create index "workflow_branch_instances_instance_status_idx" on "workflow_branch_instances" ("workflow_instance_id", "status");`);
+    this.addSql(`alter table "workflow_instances" add column "active_fork_step_id" varchar(100) null;`);
+    this.addSql(`alter table "step_instances" add column "branch_instance_id" uuid null;`);
+    this.addSql(`alter table "user_tasks" add column "branch_instance_id" uuid null;`);
+    this.addSql(`alter table "workflow_events" add column "branch_instance_id" uuid null;`);
+  }
+  async down() {
+    this.addSql(`alter table "workflow_events" drop column "branch_instance_id";`);
+    this.addSql(`alter table "user_tasks" drop column "branch_instance_id";`);
+    this.addSql(`alter table "step_instances" drop column "branch_instance_id";`);
+    this.addSql(`alter table "workflow_instances" drop column "active_fork_step_id";`);
+    this.addSql(`drop table if exists "workflow_branch_instances" cascade;`);
+  }
+}
+export {
+  Migration20260602120000
+};
+//# sourceMappingURL=Migration20260602120000.js.map

package/dist/modules/workflows/migrations/Migration20260602120000.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/migrations/Migration20260602120000.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\nexport class Migration20260602120000 extends Migration {\n\n  override async up(): Promise<void> {\n    this.addSql(`create table \"workflow_branch_instances\" (\"id\" uuid not null default gen_random_uuid(), \"workflow_instance_id\" uuid not null, \"fork_step_id\" varchar(100) not null, \"join_step_id\" varchar(100) not null, \"branch_key\" varchar(100) not null, \"parent_branch_id\" uuid null, \"current_step_id\" varchar(100) not null, \"status\" varchar(30) not null, \"context_namespace\" jsonb not null, \"pending_transition\" jsonb null, \"error_message\" text null, \"error_details\" jsonb null, \"started_at\" timestamptz null, \"completed_at\" timestamptz null, \"tenant_id\" uuid not null, \"organization_id\" uuid not null, \"created_at\" timestamptz not null, \"updated_at\" timestamptz not null, constraint \"workflow_branch_instances_pkey\" primary key (\"id\"));`);\n    this.addSql(`create index \"workflow_branch_instances_tenant_org_idx\" on \"workflow_branch_instances\" (\"tenant_id\", \"organization_id\");`);\n    this.addSql(`create index \"workflow_branch_instances_instance_fork_idx\" on \"workflow_branch_instances\" (\"workflow_instance_id\", \"fork_step_id\");`);\n    this.addSql(`create index \"workflow_branch_instances_instance_status_idx\" on \"workflow_branch_instances\" (\"workflow_instance_id\", \"status\");`);\n\n    this.addSql(`alter table \"workflow_instances\" add column \"active_fork_step_id\" varchar(100) null;`);\n    this.addSql(`alter table \"step_instances\" add column \"branch_instance_id\" uuid null;`);\n    this.addSql(`alter table \"user_tasks\" add column \"branch_instance_id\" uuid null;`);\n    this.addSql(`alter table \"workflow_events\" add column \"branch_instance_id\" uuid null;`);\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`alter table \"workflow_events\" drop column \"branch_instance_id\";`);\n    this.addSql(`alter table \"user_tasks\" drop column \"branch_instance_id\";`);\n    this.addSql(`alter table \"step_instances\" drop column \"branch_instance_id\";`);\n    this.addSql(`alter table \"workflow_instances\" drop column \"active_fork_step_id\";`);\n    this.addSql(`drop table if exists \"workflow_branch_instances\" cascade;`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,gCAAgC,UAAU;AAAA,EAErD,MAAe,KAAoB;AACjC,SAAK,OAAO,otBAAotB;AAChuB,SAAK,OAAO,0HAA0H;AACtI,SAAK,OAAO,qIAAqI;AACjJ,SAAK,OAAO,iIAAiI;AAE7I,SAAK,OAAO,sFAAsF;AAClG,SAAK,OAAO,yEAAyE;AACrF,SAAK,OAAO,qEAAqE;AACjF,SAAK,OAAO,0EAA0E;AAAA,EACxF;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,iEAAiE;AAC7E,SAAK,OAAO,4DAA4D;AACxE,SAAK,OAAO,gEAAgE;AAC5E,SAAK,OAAO,qEAAqE;AACjF,SAAK,OAAO,2DAA2D;AAAA,EACzE;AAEF;",
+  "names": []
+}

package/dist/modules/workflows/workers/workflow-activities.worker.js CHANGED Viewed

@@ -29,6 +29,7 @@ async function handle(job, ctx) {
     await fireTimer(em, container, {
       instanceId: payload.workflowInstanceId,
       stepInstanceId: payload.stepInstanceId,
+      branchInstanceId: payload.branchInstanceId,
       tenantId: payload.tenantId,
       organizationId: payload.organizationId,
       userId: payload.userId
@@ -54,6 +55,7 @@ async function handle(job, ctx) {
       workflowContext: payload.workflowContext,
       stepContext: payload.stepContext,
       stepInstanceId: payload.stepInstanceId,
+      branchInstanceId: payload.branchInstanceId,
       userId: payload.userId
     };
     const executeActivityByType = async (signal) => {
@@ -113,6 +115,7 @@ async function handle(job, ctx) {
     await logWorkflowEvent(em, {
       workflowInstanceId: payload.workflowInstanceId,
       stepInstanceId: payload.stepInstanceId,
+      branchInstanceId: payload.branchInstanceId,
       eventType: "ACTIVITY_COMPLETED",
       eventData: {
         activityId: payload.activityId,
@@ -131,7 +134,7 @@ async function handle(job, ctx) {
     console.log(
       `[workflows:activity-worker] Activity ${payload.activityId} (${payload.activityType}) completed successfully for workflow instance ${payload.workflowInstanceId} in ${executionTimeMs}ms`
     );
-    await checkAndResumeWorkflow(em, ctx, payload.workflowInstanceId);
+    await checkAndResumeWorkflow(em, ctx, payload.workflowInstanceId, payload.branchInstanceId);
   } catch (error) {
     const executionTimeMs = Date.now() - startTime;
     console.error(
@@ -141,6 +144,7 @@ async function handle(job, ctx) {
     await logWorkflowEvent(em, {
       workflowInstanceId: payload.workflowInstanceId,
       stepInstanceId: payload.stepInstanceId,
+      branchInstanceId: payload.branchInstanceId,
       eventType: "ACTIVITY_FAILED",
       eventData: {
         activityId: payload.activityId,
@@ -162,16 +166,16 @@ async function handle(job, ctx) {
       console.error(
         `[workflows:activity-worker] Activity ${payload.activityId} (${payload.activityType}) failed after ${maxAttempts} attempts for workflow instance ${payload.workflowInstanceId} - triggering workflow failure handling`
       );
-      await checkAndResumeWorkflow(em, ctx, payload.workflowInstanceId);
+      await checkAndResumeWorkflow(em, ctx, payload.workflowInstanceId, payload.branchInstanceId);
     }
     throw error;
   }
 }
-async function checkAndResumeWorkflow(em, ctx, workflowInstanceId) {
+async function checkAndResumeWorkflow(em, ctx, workflowInstanceId, branchInstanceId) {
   const { resumeWorkflowAfterActivities } = await import("../lib/workflow-executor.js");
   const container = ctx;
   try {
-    await resumeWorkflowAfterActivities(em, container, workflowInstanceId);
+    await resumeWorkflowAfterActivities(em, container, workflowInstanceId, branchInstanceId);
   } catch (error) {
     if (!error.message?.includes("Activities still pending")) {
       console.error(

package/dist/modules/workflows/workers/workflow-activities.worker.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/workers/workflow-activities.worker.ts"],
-  "sourcesContent": ["/**\n * Workflow Activity Worker\n *\n * Background worker that processes async activities from the workflow queue.\n * Executes activities with timeout, logs events, and triggers workflow resume.\n *\n * This worker is auto-discovered by the queue system and processes jobs from\n * the 'workflow-activities' queue.\n */\n\nimport type { QueuedJob, JobContext, WorkerMeta } from '@open-mercato/queue'\nimport type { WorkflowActivityJob } from '../lib/activity-queue-types'\nimport type { EntityManager } from '@mikro-orm/core'\nimport type { AwilixContainer } from 'awilix'\nimport { WorkflowInstance } from '../data/entities'\nimport { logWorkflowEvent } from '../lib/event-logger'\nimport {\n  executeSendEmail,\n  executeCallApi,\n  executeEmitEvent,\n  executeUpdateEntity,\n  executeCallWebhook,\n  executeFunction,\n} from '../lib/activity-executor'\n\n// Worker metadata for auto-discovery.\n// NOTE: `queue` MUST be a string literal (or locally-declared const) so the\n// generator's AST-based extractor can resolve it when Node cannot import the\n// .ts source file directly. Importing `WORKFLOW_ACTIVITIES_QUEUE_NAME` from\n// another module breaks auto-discovery and silently drops the worker from\n// `modules.generated.ts`.\nconst WORKFLOW_ACTIVITIES_QUEUE = 'workflow-activities'\nconst DEFAULT_CONCURRENCY = 1\nconst envConcurrency = process.env.WORKERS_WORKFLOW_ACTIVITIES_CONCURRENCY\n\nexport const metadata: WorkerMeta = {\n  queue: WORKFLOW_ACTIVITIES_QUEUE,\n  id: 'workflows:workflow-activities',\n  concurrency: envConcurrency ? parseInt(envConcurrency, 10) : DEFAULT_CONCURRENCY,\n}\n\ntype HandlerContext = { resolve: <T = unknown>(name: string) => T }\n\n/**\n * Process a workflow activity job.\n *\n * This handler:\n * 1. Fetches the workflow instance\n * 2. Executes the activity by type with timeout support\n * 3. Logs success/failure events to workflow event log\n * 4. Attempts to resume the workflow if all activities complete\n *\n * @param job - The queued job containing activity payload\n * @param ctx - Job context with DI container access\n */\nexport default async function handle(\n  job: QueuedJob<WorkflowActivityJob>,\n  ctx: JobContext & HandlerContext\n): Promise<void> {\n  const { payload } = job\n  const startTime = Date.now()\n\n  // Resolve services from DI container\n  const em = ctx.resolve<EntityManager>('em')\n\n  // Create a container-like object from ctx.resolve for activity executors\n  // The ctx already has the resolve method we need, we just need to cast it\n  const container = ctx as unknown as AwilixContainer\n\n  // Timer jobs (kind: 'timer') are a distinct flow \u2014 they resume a paused\n  // workflow at a WAIT_FOR_TIMER step rather than running an activity.\n  if (payload.kind === 'timer') {\n    console.log(\n      `[workflows:activity-worker] Firing timer for instance ${payload.workflowInstanceId} (job ${ctx.jobId})`\n    )\n    const { fireTimer } = await import('../lib/timer-handler')\n    await fireTimer(em, container, {\n      instanceId: payload.workflowInstanceId,\n      stepInstanceId: payload.stepInstanceId,\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n      userId: payload.userId,\n    })\n    return\n  }\n\n  console.log(\n    `[workflows:activity-worker] Processing activity ${payload.activityId} (${payload.activityType}) for workflow instance ${payload.workflowInstanceId} (job ${ctx.jobId}, attempt ${ctx.attemptNumber})`\n  )\n\n  try {\n    // Fetch workflow instance with tenant/org scoping\n    const instance = await em.findOne(WorkflowInstance, {\n      id: payload.workflowInstanceId,\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n    })\n\n    if (!instance) {\n      throw new Error(\n        `Workflow instance ${payload.workflowInstanceId} not found (tenant: ${payload.tenantId}, org: ${payload.organizationId})`\n      )\n    }\n\n    // Build activity execution context\n    const activityContext = {\n      workflowInstance: instance,\n      workflowContext: payload.workflowContext,\n      stepContext: payload.stepContext,\n      stepInstanceId: payload.stepInstanceId,\n      userId: payload.userId,\n    }\n\n    // Execute activity by type\n    const executeActivityByType = async (signal?: AbortSignal) => {\n      switch (payload.activityType) {\n        case 'SEND_EMAIL':\n          return await executeSendEmail(payload.activityConfig, activityContext, container)\n        case 'CALL_API':\n          return await executeCallApi(\n            em,\n            payload.activityConfig,\n            activityContext,\n            container,\n            signal\n          )\n        case 'EMIT_EVENT':\n          return await executeEmitEvent(payload.activityConfig, activityContext, container)\n        case 'UPDATE_ENTITY':\n          return await executeUpdateEntity(\n            em,\n            payload.activityConfig,\n            activityContext,\n            container\n          )\n        case 'CALL_WEBHOOK':\n          return await executeCallWebhook(payload.activityConfig, activityContext, { signal })\n        case 'EXECUTE_FUNCTION':\n          return await executeFunction(payload.activityConfig, activityContext, container)\n        case 'WAIT':\n          // Delay already handled by queue's delayMs \u2014 return success immediately\n          return { waited: true }\n        default:\n          throw new Error(`Unsupported activity type: ${payload.activityType}`)\n      }\n    }\n\n    // Execute with optional timeout. AbortController aborts in-flight fetches\n    // when the timeout wins the race, preventing phantom executions.\n    let result: any\n    if (payload.timeoutMs && payload.timeoutMs > 0) {\n      const abortController = new AbortController()\n      const timeoutId = setTimeout(() => {\n        abortController.abort()\n      }, payload.timeoutMs)\n\n      try {\n        result = await Promise.race([\n          executeActivityByType(abortController.signal),\n          new Promise((_, reject) =>\n            setTimeout(\n              () => reject(new Error(`Activity timeout after ${payload.timeoutMs}ms`)),\n              payload.timeoutMs\n            )\n          ),\n        ])\n      } finally {\n        clearTimeout(timeoutId)\n      }\n    } else {\n      result = await executeActivityByType()\n    }\n\n    const executionTimeMs = Date.now() - startTime\n\n    // Log success event to workflow event log\n    await logWorkflowEvent(em, {\n      workflowInstanceId: payload.workflowInstanceId,\n      stepInstanceId: payload.stepInstanceId,\n      eventType: 'ACTIVITY_COMPLETED',\n      eventData: {\n        activityId: payload.activityId,\n        activityName: payload.activityName,\n        activityType: payload.activityType,\n        async: true,\n        jobId: ctx.jobId,\n        attemptNumber: ctx.attemptNumber,\n        executionTimeMs,\n        output: result,\n      },\n      userId: payload.userId,\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n    })\n\n    console.log(\n      `[workflows:activity-worker] Activity ${payload.activityId} (${payload.activityType}) completed successfully for workflow instance ${payload.workflowInstanceId} in ${executionTimeMs}ms`\n    )\n\n    // Attempt to resume workflow if all activities complete\n    await checkAndResumeWorkflow(em, ctx, payload.workflowInstanceId)\n  } catch (error: any) {\n    const executionTimeMs = Date.now() - startTime\n\n    console.error(\n      `[workflows:activity-worker] Activity ${payload.activityId} (${payload.activityType}) failed for workflow instance ${payload.workflowInstanceId} (attempt ${ctx.attemptNumber}):`,\n      error.message\n    )\n\n    // Log failure event to workflow event log\n    await logWorkflowEvent(em, {\n      workflowInstanceId: payload.workflowInstanceId,\n      stepInstanceId: payload.stepInstanceId,\n      eventType: 'ACTIVITY_FAILED',\n      eventData: {\n        activityId: payload.activityId,\n        activityName: payload.activityName,\n        activityType: payload.activityType,\n        async: true,\n        jobId: ctx.jobId,\n        attemptNumber: ctx.attemptNumber,\n        error: error.message,\n        errorStack: error.stack,\n        executionTimeMs,\n      },\n      userId: payload.userId,\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n    })\n\n    // Check if this was final attempt (BullMQ handles retries automatically)\n    const maxAttempts = payload.retryPolicy?.maxAttempts || 1\n    if (ctx.attemptNumber >= maxAttempts) {\n      console.error(\n        `[workflows:activity-worker] Activity ${payload.activityId} (${payload.activityType}) failed after ${maxAttempts} attempts for workflow instance ${payload.workflowInstanceId} - triggering workflow failure handling`\n      )\n      // Final failure - attempt to resume workflow (may transition to FAILED state)\n      await checkAndResumeWorkflow(em, ctx, payload.workflowInstanceId)\n    }\n\n    // Re-throw to let BullMQ handle retry logic\n    throw error\n  }\n}\n\n/**\n * Helper to check if workflow can resume after activities complete/fail.\n *\n * This function is called after each activity completes or fails.\n * It checks if all pending activities are done and resumes workflow execution.\n *\n * @param em - Entity manager\n * @param ctx - Handler context with resolve method for DI\n * @param workflowInstanceId - Workflow instance ID to resume\n */\nasync function checkAndResumeWorkflow(\n  em: EntityManager,\n  ctx: HandlerContext,\n  workflowInstanceId: string\n): Promise<void> {\n  // Import here to avoid circular dependency\n  const { resumeWorkflowAfterActivities } = await import('../lib/workflow-executor')\n\n  // Cast ctx to AwilixContainer for the resume function\n  const container = ctx as unknown as AwilixContainer\n\n  try {\n    await resumeWorkflowAfterActivities(em, container, workflowInstanceId)\n  } catch (error: any) {\n    // Ignore error if workflow not ready to resume yet (activities still pending)\n    if (!error.message?.includes('Activities still pending')) {\n      console.error(\n        `[workflows:activity-worker] Failed to resume workflow instance ${workflowInstanceId}:`,\n        error.message\n      )\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Workflow Activity Worker\n *\n * Background worker that processes async activities from the workflow queue.\n * Executes activities with timeout, logs events, and triggers workflow resume.\n *\n * This worker is auto-discovered by the queue system and processes jobs from\n * the 'workflow-activities' queue.\n */\n\nimport type { QueuedJob, JobContext, WorkerMeta } from '@open-mercato/queue'\nimport type { WorkflowActivityJob } from '../lib/activity-queue-types'\nimport type { EntityManager } from '@mikro-orm/core'\nimport type { AwilixContainer } from 'awilix'\nimport { WorkflowInstance } from '../data/entities'\nimport { logWorkflowEvent } from '../lib/event-logger'\nimport {\n  executeSendEmail,\n  executeCallApi,\n  executeEmitEvent,\n  executeUpdateEntity,\n  executeCallWebhook,\n  executeFunction,\n} from '../lib/activity-executor'\n\n// Worker metadata for auto-discovery.\n// NOTE: `queue` MUST be a string literal (or locally-declared const) so the\n// generator's AST-based extractor can resolve it when Node cannot import the\n// .ts source file directly. Importing `WORKFLOW_ACTIVITIES_QUEUE_NAME` from\n// another module breaks auto-discovery and silently drops the worker from\n// `modules.generated.ts`.\nconst WORKFLOW_ACTIVITIES_QUEUE = 'workflow-activities'\nconst DEFAULT_CONCURRENCY = 1\nconst envConcurrency = process.env.WORKERS_WORKFLOW_ACTIVITIES_CONCURRENCY\n\nexport const metadata: WorkerMeta = {\n  queue: WORKFLOW_ACTIVITIES_QUEUE,\n  id: 'workflows:workflow-activities',\n  concurrency: envConcurrency ? parseInt(envConcurrency, 10) : DEFAULT_CONCURRENCY,\n}\n\ntype HandlerContext = { resolve: <T = unknown>(name: string) => T }\n\n/**\n * Process a workflow activity job.\n *\n * This handler:\n * 1. Fetches the workflow instance\n * 2. Executes the activity by type with timeout support\n * 3. Logs success/failure events to workflow event log\n * 4. Attempts to resume the workflow if all activities complete\n *\n * @param job - The queued job containing activity payload\n * @param ctx - Job context with DI container access\n */\nexport default async function handle(\n  job: QueuedJob<WorkflowActivityJob>,\n  ctx: JobContext & HandlerContext\n): Promise<void> {\n  const { payload } = job\n  const startTime = Date.now()\n\n  // Resolve services from DI container\n  const em = ctx.resolve<EntityManager>('em')\n\n  // Create a container-like object from ctx.resolve for activity executors\n  // The ctx already has the resolve method we need, we just need to cast it\n  const container = ctx as unknown as AwilixContainer\n\n  // Timer jobs (kind: 'timer') are a distinct flow \u2014 they resume a paused\n  // workflow at a WAIT_FOR_TIMER step rather than running an activity.\n  if (payload.kind === 'timer') {\n    console.log(\n      `[workflows:activity-worker] Firing timer for instance ${payload.workflowInstanceId} (job ${ctx.jobId})`\n    )\n    const { fireTimer } = await import('../lib/timer-handler')\n    await fireTimer(em, container, {\n      instanceId: payload.workflowInstanceId,\n      stepInstanceId: payload.stepInstanceId,\n      branchInstanceId: payload.branchInstanceId,\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n      userId: payload.userId,\n    })\n    return\n  }\n\n  console.log(\n    `[workflows:activity-worker] Processing activity ${payload.activityId} (${payload.activityType}) for workflow instance ${payload.workflowInstanceId} (job ${ctx.jobId}, attempt ${ctx.attemptNumber})`\n  )\n\n  try {\n    // Fetch workflow instance with tenant/org scoping\n    const instance = await em.findOne(WorkflowInstance, {\n      id: payload.workflowInstanceId,\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n    })\n\n    if (!instance) {\n      throw new Error(\n        `Workflow instance ${payload.workflowInstanceId} not found (tenant: ${payload.tenantId}, org: ${payload.organizationId})`\n      )\n    }\n\n    // Build activity execution context\n    const activityContext = {\n      workflowInstance: instance,\n      workflowContext: payload.workflowContext,\n      stepContext: payload.stepContext,\n      stepInstanceId: payload.stepInstanceId,\n      branchInstanceId: payload.branchInstanceId,\n      userId: payload.userId,\n    }\n\n    // Execute activity by type\n    const executeActivityByType = async (signal?: AbortSignal) => {\n      switch (payload.activityType) {\n        case 'SEND_EMAIL':\n          return await executeSendEmail(payload.activityConfig, activityContext, container)\n        case 'CALL_API':\n          return await executeCallApi(\n            em,\n            payload.activityConfig,\n            activityContext,\n            container,\n            signal\n          )\n        case 'EMIT_EVENT':\n          return await executeEmitEvent(payload.activityConfig, activityContext, container)\n        case 'UPDATE_ENTITY':\n          return await executeUpdateEntity(\n            em,\n            payload.activityConfig,\n            activityContext,\n            container\n          )\n        case 'CALL_WEBHOOK':\n          return await executeCallWebhook(payload.activityConfig, activityContext, { signal })\n        case 'EXECUTE_FUNCTION':\n          return await executeFunction(payload.activityConfig, activityContext, container)\n        case 'WAIT':\n          // Delay already handled by queue's delayMs \u2014 return success immediately\n          return { waited: true }\n        default:\n          throw new Error(`Unsupported activity type: ${payload.activityType}`)\n      }\n    }\n\n    // Execute with optional timeout. AbortController aborts in-flight fetches\n    // when the timeout wins the race, preventing phantom executions.\n    let result: any\n    if (payload.timeoutMs && payload.timeoutMs > 0) {\n      const abortController = new AbortController()\n      const timeoutId = setTimeout(() => {\n        abortController.abort()\n      }, payload.timeoutMs)\n\n      try {\n        result = await Promise.race([\n          executeActivityByType(abortController.signal),\n          new Promise((_, reject) =>\n            setTimeout(\n              () => reject(new Error(`Activity timeout after ${payload.timeoutMs}ms`)),\n              payload.timeoutMs\n            )\n          ),\n        ])\n      } finally {\n        clearTimeout(timeoutId)\n      }\n    } else {\n      result = await executeActivityByType()\n    }\n\n    const executionTimeMs = Date.now() - startTime\n\n    // Log success event to workflow event log\n    await logWorkflowEvent(em, {\n      workflowInstanceId: payload.workflowInstanceId,\n      stepInstanceId: payload.stepInstanceId,\n      branchInstanceId: payload.branchInstanceId,\n      eventType: 'ACTIVITY_COMPLETED',\n      eventData: {\n        activityId: payload.activityId,\n        activityName: payload.activityName,\n        activityType: payload.activityType,\n        async: true,\n        jobId: ctx.jobId,\n        attemptNumber: ctx.attemptNumber,\n        executionTimeMs,\n        output: result,\n      },\n      userId: payload.userId,\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n    })\n\n    console.log(\n      `[workflows:activity-worker] Activity ${payload.activityId} (${payload.activityType}) completed successfully for workflow instance ${payload.workflowInstanceId} in ${executionTimeMs}ms`\n    )\n\n    // Attempt to resume workflow if all activities complete\n    await checkAndResumeWorkflow(em, ctx, payload.workflowInstanceId, payload.branchInstanceId)\n  } catch (error: any) {\n    const executionTimeMs = Date.now() - startTime\n\n    console.error(\n      `[workflows:activity-worker] Activity ${payload.activityId} (${payload.activityType}) failed for workflow instance ${payload.workflowInstanceId} (attempt ${ctx.attemptNumber}):`,\n      error.message\n    )\n\n    // Log failure event to workflow event log\n    await logWorkflowEvent(em, {\n      workflowInstanceId: payload.workflowInstanceId,\n      stepInstanceId: payload.stepInstanceId,\n      branchInstanceId: payload.branchInstanceId,\n      eventType: 'ACTIVITY_FAILED',\n      eventData: {\n        activityId: payload.activityId,\n        activityName: payload.activityName,\n        activityType: payload.activityType,\n        async: true,\n        jobId: ctx.jobId,\n        attemptNumber: ctx.attemptNumber,\n        error: error.message,\n        errorStack: error.stack,\n        executionTimeMs,\n      },\n      userId: payload.userId,\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n    })\n\n    // Check if this was final attempt (BullMQ handles retries automatically)\n    const maxAttempts = payload.retryPolicy?.maxAttempts || 1\n    if (ctx.attemptNumber >= maxAttempts) {\n      console.error(\n        `[workflows:activity-worker] Activity ${payload.activityId} (${payload.activityType}) failed after ${maxAttempts} attempts for workflow instance ${payload.workflowInstanceId} - triggering workflow failure handling`\n      )\n      // Final failure - attempt to resume workflow (may transition to FAILED state)\n      await checkAndResumeWorkflow(em, ctx, payload.workflowInstanceId, payload.branchInstanceId)\n    }\n\n    // Re-throw to let BullMQ handle retry logic\n    throw error\n  }\n}\n\n/**\n * Helper to check if workflow can resume after activities complete/fail.\n *\n * This function is called after each activity completes or fails.\n * It checks if all pending activities are done and resumes workflow execution.\n *\n * @param em - Entity manager\n * @param ctx - Handler context with resolve method for DI\n * @param workflowInstanceId - Workflow instance ID to resume\n */\nasync function checkAndResumeWorkflow(\n  em: EntityManager,\n  ctx: HandlerContext,\n  workflowInstanceId: string,\n  branchInstanceId?: string | null\n): Promise<void> {\n  // Import here to avoid circular dependency\n  const { resumeWorkflowAfterActivities } = await import('../lib/workflow-executor')\n\n  // Cast ctx to AwilixContainer for the resume function\n  const container = ctx as unknown as AwilixContainer\n\n  try {\n    await resumeWorkflowAfterActivities(em, container, workflowInstanceId, branchInstanceId)\n  } catch (error: any) {\n    // Ignore error if workflow not ready to resume yet (activities still pending)\n    if (!error.message?.includes('Activities still pending')) {\n      console.error(\n        `[workflows:activity-worker] Failed to resume workflow instance ${workflowInstanceId}:`,\n        error.message\n      )\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/generated/entities/step_instance/index.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 export const id = "id";
 export const workflow_instance_id = "workflow_instance_id";
+export const branch_instance_id = "branch_instance_id";
 export const step_id = "step_id";
 export const step_name = "step_name";
 export const step_type = "step_type";

package/generated/entities/user_task/index.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 export const id = "id";
 export const workflow_instance_id = "workflow_instance_id";
 export const step_instance_id = "step_instance_id";
+export const branch_instance_id = "branch_instance_id";
 export const task_name = "task_name";
 export const description = "description";
 export const status = "status";

package/generated/entities/workflow_branch_instance/index.ts ADDED Viewed

@@ -0,0 +1,18 @@
+export const id = "id";
+export const workflow_instance_id = "workflow_instance_id";
+export const fork_step_id = "fork_step_id";
+export const join_step_id = "join_step_id";
+export const branch_key = "branch_key";
+export const parent_branch_id = "parent_branch_id";
+export const current_step_id = "current_step_id";
+export const status = "status";
+export const context_namespace = "context_namespace";
+export const pending_transition = "pending_transition";
+export const error_message = "error_message";
+export const error_details = "error_details";
+export const started_at = "started_at";
+export const completed_at = "completed_at";
+export const tenant_id = "tenant_id";
+export const organization_id = "organization_id";
+export const created_at = "created_at";
+export const updated_at = "updated_at";

package/generated/entities/workflow_event/index.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 export const id = "id";
 export const workflow_instance_id = "workflow_instance_id";
 export const step_instance_id = "step_instance_id";
+export const branch_instance_id = "branch_instance_id";
 export const event_type = "event_type";
 export const event_data = "event_data";
 export const occurred_at = "occurred_at";

package/generated/entities/workflow_instance/index.ts CHANGED Viewed

@@ -14,6 +14,7 @@ export const cancelled_at = "cancelled_at";
 export const error_message = "error_message";
 export const error_details = "error_details";
 export const pending_transition = "pending_transition";
+export const active_fork_step_id = "active_fork_step_id";
 export const retry_count = "retry_count";
 export const tenant_id = "tenant_id";
 export const organization_id = "organization_id";

package/generated/entities.ids.generated.ts CHANGED Viewed

@@ -180,6 +180,7 @@ export const M = {
     "workflows": {
       "workflow_definition": "workflows:workflow_definition",
       "workflow_instance": "workflows:workflow_instance",
+      "workflow_branch_instance": "workflows:workflow_branch_instance",
       "step_instance": "workflows:step_instance",
       "user_task": "workflows:user_task",
       "workflow_event": "workflows:workflow_event",

package/generated/entity-fields-registry.ts CHANGED Viewed

@@ -2666,6 +2666,7 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
     "step_instance": {
       "id": "id",
       "workflow_instance_id": "workflow_instance_id",
+      "branch_instance_id": "branch_instance_id",
       "step_id": "step_id",
       "step_name": "step_name",
       "step_type": "step_type",
@@ -2856,6 +2857,7 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
       "id": "id",
       "workflow_instance_id": "workflow_instance_id",
       "step_instance_id": "step_instance_id",
+      "branch_instance_id": "branch_instance_id",
       "task_name": "task_name",
       "description": "description",
       "status": "status",
@@ -2885,6 +2887,26 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
       "tenant_id": "tenant_id",
       "processed_at": "processed_at"
     },
+    "workflow_branch_instance": {
+      "id": "id",
+      "workflow_instance_id": "workflow_instance_id",
+      "fork_step_id": "fork_step_id",
+      "join_step_id": "join_step_id",
+      "branch_key": "branch_key",
+      "parent_branch_id": "parent_branch_id",
+      "current_step_id": "current_step_id",
+      "status": "status",
+      "context_namespace": "context_namespace",
+      "pending_transition": "pending_transition",
+      "error_message": "error_message",
+      "error_details": "error_details",
+      "started_at": "started_at",
+      "completed_at": "completed_at",
+      "tenant_id": "tenant_id",
+      "organization_id": "organization_id",
+      "created_at": "created_at",
+      "updated_at": "updated_at"
+    },
     "workflow_definition": {
       "id": "id",
       "workflow_id": "workflow_id",
@@ -2909,6 +2931,7 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
       "id": "id",
       "workflow_instance_id": "workflow_instance_id",
       "step_instance_id": "step_instance_id",
+      "branch_instance_id": "branch_instance_id",
       "event_type": "event_type",
       "event_data": "event_data",
       "occurred_at": "occurred_at",
@@ -2950,6 +2973,7 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
       "error_message": "error_message",
       "error_details": "error_details",
       "pending_transition": "pending_transition",
+      "active_fork_step_id": "active_fork_step_id",
       "retry_count": "retry_count",
       "tenant_id": "tenant_id",
       "organization_id": "organization_id",

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.6.5-develop.4498.1.55dc06a57c",
+  "version": "0.6.5-develop.4534.1.b459babe6d",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
@@ -244,16 +244,16 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/ai-assistant": "0.6.5-develop.4498.1.55dc06a57c",
-    "@open-mercato/shared": "0.6.5-develop.4498.1.55dc06a57c",
-    "@open-mercato/ui": "0.6.5-develop.4498.1.55dc06a57c",
+    "@open-mercato/ai-assistant": "0.6.5-develop.4534.1.b459babe6d",
+    "@open-mercato/shared": "0.6.5-develop.4534.1.b459babe6d",
+    "@open-mercato/ui": "0.6.5-develop.4534.1.b459babe6d",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/ai-assistant": "0.6.5-develop.4498.1.55dc06a57c",
-    "@open-mercato/shared": "0.6.5-develop.4498.1.55dc06a57c",
-    "@open-mercato/ui": "0.6.5-develop.4498.1.55dc06a57c",
+    "@open-mercato/ai-assistant": "0.6.5-develop.4534.1.b459babe6d",
+    "@open-mercato/shared": "0.6.5-develop.4534.1.b459babe6d",
+    "@open-mercato/ui": "0.6.5-develop.4534.1.b459babe6d",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.1",

package/src/helpers/integration/currenciesFixtures.ts CHANGED Viewed

@@ -18,6 +18,65 @@ export async function createCurrencyFixture(
   return body.id as string;
 }
+// Codes seeded by the currencies module (seedExampleCurrencies). Generated test
+// codes avoid these so fixtures never collide with seeded rows.
+const SEEDED_CURRENCY_CODES = new Set([
+  'USD', 'EUR', 'JPY', 'GBP', 'CHF', 'CAD', 'AUD', 'CNY', 'CNH', 'PLN',
+]);
+// Reserved across the worker so two fixtures never draw the same code in one run.
+const reservedCurrencyCodes = new Set<string>();
+/** Draws an ISO-style three-letter code unused by seeds or earlier fixtures. */
+export function generateUniqueCurrencyCode(): string {
+  const letter = () => String.fromCharCode(65 + Math.floor(Math.random() * 26));
+  for (let attempt = 0; attempt < 200; attempt += 1) {
+    const code = `${letter()}${letter()}${letter()}`;
+    if (!SEEDED_CURRENCY_CODES.has(code) && !reservedCurrencyCodes.has(code)) {
+      reservedCurrencyCodes.add(code);
+      return code;
+    }
+  }
+  throw new Error('[internal] exhausted unique currency code space');
+}
+/**
+ * Creates a currency with a generated unique code and returns its id and code.
+ *
+ * Currency DELETE is a soft delete, but the (organization, tenant, code) unique
+ * constraint still counts soft-deleted rows — re-using a code an earlier test
+ * soft-deleted makes the create fail. Drawing from the full three-letter space
+ * (minus seeds) and retrying with a fresh code on an accidental collision keeps
+ * fixture setup deterministic across runs that share a database.
+ */
+export async function createRandomCurrencyFixture(
+  request: APIRequestContext,
+  token: string,
+  input: { name: string; symbol?: string; isActive?: boolean },
+): Promise<{ id: string; code: string }> {
+  const { organizationId, tenantId } = getTokenContext(token);
+  let lastStatus = 0;
+  for (let attempt = 0; attempt < 8; attempt += 1) {
+    const code = generateUniqueCurrencyCode();
+    const data: Record<string, unknown> = {
+      organizationId,
+      tenantId,
+      code,
+      name: input.name,
+      symbol: input.symbol ?? null,
+    };
+    if (typeof input.isActive === 'boolean') data.isActive = input.isActive;
+    const response = await apiRequest(request, 'POST', '/api/currencies/currencies', { token, data });
+    if (response.status() === 201) {
+      const body = (await response.json()) as { id?: string };
+      if (typeof body.id === 'string' && body.id.length > 0) {
+        return { id: body.id, code };
+      }
+    }
+    lastStatus = response.status();
+  }
+  throw new Error(`[internal] failed to create currency fixture after retries (last status ${lastStatus})`);
+}
 export async function createFetchConfigFixture(
   request: APIRequestContext,
   token: string,