npm - @open-mercato/core - Versions diffs - 0.6.7-develop.6580.1.39ab1d9e62 → 0.6.7-develop.6582.1.04cac61287 - Mend

@open-mercato/core 0.6.7-develop.6580.1.39ab1d9e62 → 0.6.7-develop.6582.1.04cac61287

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 (29) 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, findDefinitionForInstance } from './find-definition'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\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 findDefinitionForInstance(trx, instance)\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            logger.error('Transition rejected', {\n              instanceId: currentInstance.id,\n              workflowId: currentInstance.workflowId,\n              fromStepId: currentInstance.currentStepId,\n              toStepId: selectedTransition.toStepId,\n              err: rejectionMessage,\n            })\n            errors.push(rejectionMessage)\n\n            await completeWorkflow(trx, container, instanceId, 'FAILED', {\n              error: rejectionMessage,\n            })\n            events.push({\n              eventType: 'WORKFLOW_FAILED',\n              occurredAt: new Date(),\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          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          logger.error('Transition execution failed', {\n            instanceId: currentInstance.id,\n            workflowId: currentInstance.workflowId,\n            fromStepId: currentInstance.currentStepId,\n            toStepId: selectedTransition.toStepId,\n            err: error,\n          })\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          await completeWorkflow(trx, container, instanceId, 'FAILED', {\n            error: errorMessage,\n            details: error instanceof WorkflowExecutionError ? error.details : undefined,\n          })\n          events.push({\n            eventType: 'WORKFLOW_FAILED',\n            occurredAt: new Date(),\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      logger.error('Execution failed', { instanceId, err: error })\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        logger.error('Failed to update instance with error state', { instanceId, err: 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 findDefinitionForInstance(em, instance)\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        logger.info('Compensation finished', {\n          status: compensationResult.status,\n          compensatedActivities: compensationResult.compensatedActivities,\n          totalActivities: compensationResult.totalActivities,\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        logger.error('Compensation failed with exception', { err: 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      logger.warn('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    logger.debug('Completing pending transition', {\n      toStepId: pendingTransition.toStepId,\n      fromStepId: instance.currentStepId,\n    })\n\n    const definition = await findDefinitionForInstance(trx, instance)\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 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, findDefinitionForInstance } from './find-definition'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\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\nfunction normalizeWorkflowUserId(value: unknown): string | null {\n  if (typeof value !== 'string') return null\n  const trimmed = value.trim()\n  if (!trimmed || trimmed.startsWith('trigger:')) return null\n  return trimmed\n}\n\nfunction resolveWorkflowExecutionUserId(\n  context: ExecutionContext | undefined,\n  instance: WorkflowInstance,\n): string | undefined {\n  return (\n    normalizeWorkflowUserId(context?.userId) ??\n    normalizeWorkflowUserId(instance.metadata?.initiatedBy) ??\n    undefined\n  )\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 findDefinitionForInstance(trx, instance)\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      const executionUserId = resolveWorkflowExecutionUserId(context, instance)\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: executionUserId,\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: executionUserId,\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            logger.error('Transition rejected', {\n              instanceId: currentInstance.id,\n              workflowId: currentInstance.workflowId,\n              fromStepId: currentInstance.currentStepId,\n              toStepId: selectedTransition.toStepId,\n              err: rejectionMessage,\n            })\n            errors.push(rejectionMessage)\n\n            await completeWorkflow(trx, container, instanceId, 'FAILED', {\n              error: rejectionMessage,\n            })\n            events.push({\n              eventType: 'WORKFLOW_FAILED',\n              occurredAt: new Date(),\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          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          logger.error('Transition execution failed', {\n            instanceId: currentInstance.id,\n            workflowId: currentInstance.workflowId,\n            fromStepId: currentInstance.currentStepId,\n            toStepId: selectedTransition.toStepId,\n            err: error,\n          })\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          await completeWorkflow(trx, container, instanceId, 'FAILED', {\n            error: errorMessage,\n            details: error instanceof WorkflowExecutionError ? error.details : undefined,\n          })\n          events.push({\n            eventType: 'WORKFLOW_FAILED',\n            occurredAt: new Date(),\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      logger.error('Execution failed', { instanceId, err: error })\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        logger.error('Failed to update instance with error state', { instanceId, err: 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 findDefinitionForInstance(em, instance)\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        logger.info('Compensation finished', {\n          status: compensationResult.status,\n          compensatedActivities: compensationResult.compensatedActivities,\n          totalActivities: compensationResult.totalActivities,\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        logger.error('Compensation failed with exception', { err: 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      logger.warn('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    logger.debug('Completing pending transition', {\n      toStepId: pendingTransition.toStepId,\n      fromStepId: instance.currentStepId,\n    })\n\n    const definition = await findDefinitionForInstance(trx, instance)\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 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: resolveWorkflowExecutionUserId(undefined, instance),\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/lib/workflow-safe-commands.js ADDED Viewed

@@ -0,0 +1,42 @@
+const workflowSafeCommands = /* @__PURE__ */ new Map();
+function normalizeCommandId(commandId) {
+  if (typeof commandId !== "string") return null;
+  const trimmed = commandId.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function normalizeFeatures(features) {
+  const normalized = features.map((feature) => feature.trim()).filter((feature) => feature.length > 0);
+  if (normalized.length === 0) return null;
+  return normalized;
+}
+function registerWorkflowSafeCommands(commands) {
+  for (const command of commands) {
+    const commandId = normalizeCommandId(command.commandId);
+    const requiredFeatures = normalizeFeatures(command.requiredFeatures);
+    if (!commandId || !requiredFeatures) {
+      throw new Error("[internal] Workflow-safe commands require a commandId and requiredFeatures");
+    }
+    workflowSafeCommands.set(commandId, { commandId, requiredFeatures });
+  }
+}
+function getWorkflowSafeCommand(commandId) {
+  const normalized = normalizeCommandId(commandId);
+  if (!normalized) return null;
+  return workflowSafeCommands.get(normalized) ?? null;
+}
+function isWorkflowSafeCommandId(commandId) {
+  return getWorkflowSafeCommand(commandId) !== null;
+}
+function clearWorkflowSafeCommandsForTests() {
+  if (process.env.NODE_ENV !== "test") {
+    throw new Error("[internal] clearWorkflowSafeCommandsForTests is test-only");
+  }
+  workflowSafeCommands.clear();
+}
+export {
+  clearWorkflowSafeCommandsForTests,
+  getWorkflowSafeCommand,
+  isWorkflowSafeCommandId,
+  registerWorkflowSafeCommands
+};
+//# sourceMappingURL=workflow-safe-commands.js.map

package/dist/modules/workflows/lib/workflow-safe-commands.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/workflow-safe-commands.ts"],
+  "sourcesContent": ["export type WorkflowSafeCommandDefinition = {\n  commandId: string\n  requiredFeatures: readonly [string, ...string[]]\n}\n\nconst workflowSafeCommands = new Map<string, WorkflowSafeCommandDefinition>()\n\nfunction normalizeCommandId(commandId: unknown): string | null {\n  if (typeof commandId !== 'string') return null\n  const trimmed = commandId.trim()\n  return trimmed.length > 0 ? trimmed : null\n}\n\nfunction normalizeFeatures(features: readonly string[]): [string, ...string[]] | null {\n  const normalized = features\n    .map((feature) => feature.trim())\n    .filter((feature) => feature.length > 0)\n  if (normalized.length === 0) return null\n  return normalized as [string, ...string[]]\n}\n\nexport function registerWorkflowSafeCommands(commands: readonly WorkflowSafeCommandDefinition[]): void {\n  for (const command of commands) {\n    const commandId = normalizeCommandId(command.commandId)\n    const requiredFeatures = normalizeFeatures(command.requiredFeatures)\n    if (!commandId || !requiredFeatures) {\n      throw new Error('[internal] Workflow-safe commands require a commandId and requiredFeatures')\n    }\n    workflowSafeCommands.set(commandId, { commandId, requiredFeatures })\n  }\n}\n\nexport function getWorkflowSafeCommand(commandId: unknown): WorkflowSafeCommandDefinition | null {\n  const normalized = normalizeCommandId(commandId)\n  if (!normalized) return null\n  return workflowSafeCommands.get(normalized) ?? null\n}\n\nexport function isWorkflowSafeCommandId(commandId: unknown): boolean {\n  return getWorkflowSafeCommand(commandId) !== null\n}\n\nexport function clearWorkflowSafeCommandsForTests(): void {\n  if (process.env.NODE_ENV !== 'test') {\n    throw new Error('[internal] clearWorkflowSafeCommandsForTests is test-only')\n  }\n  workflowSafeCommands.clear()\n}\n"],
+  "mappings": "AAKA,MAAM,uBAAuB,oBAAI,IAA2C;AAE5E,SAAS,mBAAmB,WAAmC;AAC7D,MAAI,OAAO,cAAc,SAAU,QAAO;AAC1C,QAAM,UAAU,UAAU,KAAK;AAC/B,SAAO,QAAQ,SAAS,IAAI,UAAU;AACxC;AAEA,SAAS,kBAAkB,UAA2D;AACpF,QAAM,aAAa,SAChB,IAAI,CAAC,YAAY,QAAQ,KAAK,CAAC,EAC/B,OAAO,CAAC,YAAY,QAAQ,SAAS,CAAC;AACzC,MAAI,WAAW,WAAW,EAAG,QAAO;AACpC,SAAO;AACT;AAEO,SAAS,6BAA6B,UAA0D;AACrG,aAAW,WAAW,UAAU;AAC9B,UAAM,YAAY,mBAAmB,QAAQ,SAAS;AACtD,UAAM,mBAAmB,kBAAkB,QAAQ,gBAAgB;AACnE,QAAI,CAAC,aAAa,CAAC,kBAAkB;AACnC,YAAM,IAAI,MAAM,4EAA4E;AAAA,IAC9F;AACA,yBAAqB,IAAI,WAAW,EAAE,WAAW,iBAAiB,CAAC;AAAA,EACrE;AACF;AAEO,SAAS,uBAAuB,WAA0D;AAC/F,QAAM,aAAa,mBAAmB,SAAS;AAC/C,MAAI,CAAC,WAAY,QAAO;AACxB,SAAO,qBAAqB,IAAI,UAAU,KAAK;AACjD;AAEO,SAAS,wBAAwB,WAA6B;AACnE,SAAO,uBAAuB,SAAS,MAAM;AAC/C;AAEO,SAAS,oCAA0C;AACxD,MAAI,QAAQ,IAAI,aAAa,QAAQ;AACnC,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC7E;AACA,uBAAqB,MAAM;AAC7B;",
+  "names": []
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.6.7-develop.6580.1.39ab1d9e62",
+  "version": "0.6.7-develop.6582.1.04cac61287",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -253,16 +253,16 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/ai-assistant": "0.6.7-develop.6580.1.39ab1d9e62",
-    "@open-mercato/shared": "0.6.7-develop.6580.1.39ab1d9e62",
-    "@open-mercato/ui": "0.6.7-develop.6580.1.39ab1d9e62",
+    "@open-mercato/ai-assistant": "0.6.7-develop.6582.1.04cac61287",
+    "@open-mercato/shared": "0.6.7-develop.6582.1.04cac61287",
+    "@open-mercato/ui": "0.6.7-develop.6582.1.04cac61287",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/ai-assistant": "0.6.7-develop.6580.1.39ab1d9e62",
-    "@open-mercato/shared": "0.6.7-develop.6580.1.39ab1d9e62",
-    "@open-mercato/ui": "0.6.7-develop.6580.1.39ab1d9e62",
+    "@open-mercato/ai-assistant": "0.6.7-develop.6582.1.04cac61287",
+    "@open-mercato/shared": "0.6.7-develop.6582.1.04cac61287",
+    "@open-mercato/ui": "0.6.7-develop.6582.1.04cac61287",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.1",

package/src/modules/sales/commands/documents.ts CHANGED Viewed

@@ -151,6 +151,7 @@ const orderCrudEvents: CrudEventsConfig<SalesOrder> = {
     id: ctx.identifiers.id,
     organizationId: ctx.identifiers.organizationId,
     tenantId: ctx.identifiers.tenantId,
+    userId: ctx.actorUserId ?? null,
   }),
 };
@@ -162,6 +163,7 @@ const quoteCrudEvents: CrudEventsConfig<SalesQuote> = {
     id: ctx.identifiers.id,
     organizationId: ctx.identifiers.organizationId,
     tenantId: ctx.identifiers.tenantId,
+    userId: ctx.actorUserId ?? null,
   }),
 };
@@ -4766,6 +4768,7 @@ const createQuoteCommand: CommandHandler<
       },
       events: quoteCrudEvents,
       indexer: { entityType: E.sales.sales_quote },
+      actorUserId: ctx.auth?.sub ?? null,
     });
     // Invalidate cache
@@ -5773,6 +5776,7 @@ const createOrderCommand: CommandHandler<
       },
       events: orderCrudEvents,
       indexer: { entityType: E.sales.sales_order },
+      actorUserId: ctx.auth?.sub ?? null,
     });
     // Invalidate cache

package/src/modules/sales/workflows.ts CHANGED Viewed

@@ -5,6 +5,11 @@
  */
 import { defineWorkflow, createWorkflowsModuleConfig } from '@open-mercato/shared/modules/workflows'
+import { registerWorkflowSafeCommands } from '@open-mercato/core/modules/workflows/lib/workflow-safe-commands'
+registerWorkflowSafeCommands([
+  { commandId: 'sales.orders.update', requiredFeatures: ['sales.orders.manage'] },
+])
 const orderApproval = defineWorkflow({
   workflowId: 'sales.order-approval',

package/src/modules/workflows/api/instances/route.ts CHANGED Viewed

@@ -196,7 +196,7 @@ export async function POST(request: NextRequest) {
     const input: StartWorkflowApiInput = validation.data
-    // User-started instances must always record the authenticated caller.
+    // Server-authoritative actor; do not trust client-supplied metadata.initiatedBy.
     const metadata = {
       ...input.metadata,
       initiatedBy: auth.sub,
@@ -220,7 +220,9 @@ export async function POST(request: NextRequest) {
         // Create new container and EM for background execution
         const bgContainer = await createRequestContainer()
         const bgEm = bgContainer.resolve('em')
-        await workflowExecutor.executeWorkflow(bgEm, bgContainer, instance.id)
+        await workflowExecutor.executeWorkflow(bgEm, bgContainer, instance.id, {
+          userId: auth.sub,
+        })
       } catch (error) {
         logger.error('Background workflow execution error', { err: error })
       }

package/src/modules/workflows/lib/activity-executor.ts CHANGED Viewed

@@ -22,10 +22,12 @@ import {
   type HostLookup,
 } from '@open-mercato/shared/lib/url-safety'
 import { parseBooleanWithDefault } from '@open-mercato/shared/lib/boolean'
+import { hasAllFeatures } from '@open-mercato/shared/security/features'
 import { callWebhookConfigSchema } from '../data/validators'
 import { WorkflowActivityJob, WORKFLOW_ACTIVITIES_QUEUE_NAME } from './activity-queue-types'
 import { logWorkflowEvent } from './event-logger'
 import { parseDuration } from './duration'
+import { getWorkflowSafeCommand } from './workflow-safe-commands'
 export { isPrivateUrl } from '@open-mercato/shared/lib/network'
 import { createLogger } from '@open-mercato/shared/lib/logger'
@@ -127,6 +129,30 @@ export interface ActivityContext {
   userId?: string
 }
+type RbacFeatureResolver = {
+  getGrantedFeatures: (
+    userId: string,
+    opts: { tenantId: string | null; organizationId: string | null }
+  ) => Promise<string[]>
+}
+async function resolveWorkflowUserFeatures(
+  container: AwilixContainer,
+  userId: string,
+  tenantId: string | null,
+  organizationId: string | null
+): Promise<string[]> {
+  try {
+    const rbac = container.resolve('rbacService') as RbacFeatureResolver | undefined
+    if (rbac?.getGrantedFeatures) {
+      return await rbac.getGrantedFeatures(userId, { tenantId, organizationId })
+    }
+  } catch {
+    // Fail closed below when the workflow executor cannot prove the actor's grants.
+  }
+  return []
+}
 export interface ActivityExecutionResult {
   activityId: string
   activityName?: string
@@ -606,10 +632,30 @@ export async function executeUpdateEntity(
     throw new Error('UPDATE_ENTITY requires "commandId" field (e.g., "sales.documents.update")')
   }
+  const workflowSafeCommand = getWorkflowSafeCommand(commandId)
+  if (!workflowSafeCommand) {
+    throw new Error('UPDATE_ENTITY command is not allowed')
+  }
   if (!input || typeof input !== 'object') {
     throw new Error('UPDATE_ENTITY requires "input" object with entity data')
   }
+  const actorUserId = typeof context.userId === 'string' ? context.userId.trim() : ''
+  if (!actorUserId) {
+    throw new Error('UPDATE_ENTITY requires an authenticated workflow user')
+  }
+  const userFeatures = await resolveWorkflowUserFeatures(
+    container,
+    actorUserId,
+    context.workflowInstance.tenantId,
+    context.workflowInstance.organizationId
+  )
+  if (!hasAllFeatures(userFeatures, workflowSafeCommand.requiredFeatures)) {
+    throw new Error('UPDATE_ENTITY command is not authorized')
+  }
   // Resolve CommandBus from container
   const commandBus = container.resolve('commandBus') as any
@@ -636,12 +682,10 @@ export async function executeUpdateEntity(
   }
   // Build synthetic CommandRuntimeContext for workflow execution
-  // Use nil UUID for system actions when no user context is available
-  const SYSTEM_USER_ID = '00000000-0000-0000-0000-000000000000'
   const ctx = {
     container,
     auth: {
-      sub: context.userId || SYSTEM_USER_ID,
+      sub: actorUserId,
       tenantId: context.workflowInstance.tenantId,
       orgId: context.workflowInstance.organizationId,
       isSuperAdmin: false,

package/src/modules/workflows/lib/code-registry.ts CHANGED Viewed

@@ -1,24 +1,33 @@
 /**
- * In-Memory Code Workflow Registry
+ * Code Workflow Registry (validating bridge)
  *
- * Stores code-based workflow definitions populated at bootstrap from
- * the generated workflows.generated.ts. Definitions live purely in memory —
- * no DB row is created until a user customizes the definition.
+ * The registry store itself lives in `@open-mercato/shared` so all bootstrap
+ * contexts (Next.js app, CLI, `mercato workers`) share one process-wide map —
+ * see `@open-mercato/shared/modules/workflows/code-registry`. This module
+ * keeps the workflows engine's import path stable and adds Zod validation on
+ * top of the raw registration used by the shared bootstrap factory.
  */
 import type { CodeWorkflowDefinition } from '@open-mercato/shared/modules/workflows'
+import { registerCodeWorkflowEntries } from '@open-mercato/shared/modules/workflows/code-registry'
 import { workflowDefinitionDataSchema } from '../data/validators'
 import { createLogger } from '@open-mercato/shared/lib/logger'
 const logger = createLogger('workflows')
-const codeWorkflowRegistry = new Map<string, CodeWorkflowDefinition>()
+export {
+  getCodeWorkflow,
+  getAllCodeWorkflows,
+  isCodeWorkflow,
+  clearCodeWorkflowRegistry,
+} from '@open-mercato/shared/modules/workflows/code-registry'
 /**
  * Register code-based workflow definitions at bootstrap time.
  * Validates each definition against the Zod schema and warns on failures.
  */
 export function registerCodeWorkflows(workflows: CodeWorkflowDefinition[]): void {
+  const valid: CodeWorkflowDefinition[] = []
   for (const wf of workflows) {
     const validation = workflowDefinitionDataSchema.safeParse(wf.definition)
     if (!validation.success) {
@@ -28,39 +37,7 @@ export function registerCodeWorkflows(workflows: CodeWorkflowDefinition[]): void
       })
       continue
     }
-    if (codeWorkflowRegistry.has(wf.workflowId)) {
-      logger.warn('Duplicate code workflow ID — overwriting', { workflowId: wf.workflowId, moduleId: wf.moduleId })
-    }
-    codeWorkflowRegistry.set(wf.workflowId, wf)
+    valid.push(wf)
   }
-}
-/**
- * Get a single code workflow definition by workflowId.
- */
-export function getCodeWorkflow(workflowId: string): CodeWorkflowDefinition | undefined {
-  return codeWorkflowRegistry.get(workflowId)
-}
-/**
- * Get all registered code workflow definitions.
- */
-export function getAllCodeWorkflows(): CodeWorkflowDefinition[] {
-  return Array.from(codeWorkflowRegistry.values())
-}
-/**
- * Check if a workflowId is a code-based definition.
- */
-export function isCodeWorkflow(workflowId: string): boolean {
-  return codeWorkflowRegistry.has(workflowId)
-}
-/**
- * Clear the registry (for testing).
- */
-export function clearCodeWorkflowRegistry(): void {
-  codeWorkflowRegistry.clear()
+  registerCodeWorkflowEntries(valid)
 }

package/src/modules/workflows/lib/event-trigger-service.ts CHANGED Viewed

@@ -72,6 +72,13 @@ interface CachedTriggers {
 // Cache TTL: 5 minutes
 const TRIGGER_CACHE_TTL = 5 * 60 * 1000
+function readEventActorUserId(payload: Record<string, unknown>): string | null {
+  const candidate = payload.userId ?? payload.actorUserId
+  if (typeof candidate !== 'string') return null
+  const trimmed = candidate.trim()
+  return trimmed.length > 0 && !trimmed.startsWith('trigger:') ? trimmed : null
+}
 // ============================================================================
 // Pattern Matching
 // ============================================================================
@@ -616,6 +623,7 @@ export async function processEventTriggers(
       // Extract entity info from payload for metadata
       const payloadId = context.payload?.id as string | undefined
       const payloadEntityType = context.payload?.entityType as string | undefined
+      const actorUserId = readEventActorUserId(context.payload)
       // Include event metadata and payload in context
       const initialContext = {
@@ -639,7 +647,7 @@ export async function processEventTriggers(
         version: trigger.workflowVersion,
         initialContext,
         metadata: {
-          initiatedBy: `trigger:${trigger.id}`,
+          initiatedBy: actorUserId ?? `trigger:${trigger.id}`,
           // Include entityId and entityType for widget discovery
           entityId: payloadId,
           entityType: payloadEntityType || trigger.config?.entityType,
@@ -661,7 +669,12 @@ export async function processEventTriggers(
       })
       // Execute workflow asynchronously (don't wait)
-      executeWorkflow(em.fork(), container, instance.id).catch(err => {
+      executeWorkflow(
+        em.fork(),
+        container,
+        instance.id,
+        actorUserId ? { userId: actorUserId } : undefined
+      ).catch(err => {
         logger.error('Error executing workflow', { instanceId: instance.id, err })
       })

package/src/modules/workflows/lib/parallel-handler.ts CHANGED Viewed

@@ -104,6 +104,13 @@ interface ParallelContext {
   userId?: string
 }
+function normalizeWorkflowUserId(value: unknown): string | null {
+  if (typeof value !== 'string') return null
+  const trimmed = value.trim()
+  if (!trimmed || trimmed.startsWith('trigger:')) return null
+  return trimmed
+}
 function getNestedValue(obj: any, path: string): any {
   return path.split('.').reduce((current, key) => (current == null ? undefined : current[key]), obj)
 }
@@ -251,7 +258,10 @@ export async function resumeBranchAfterActivities(
         em,
         instance,
         pending.toStepId,
-        { workflowContext: { ...(instance.context || {}), ...(branch.contextNamespace || {}) } },
+        {
+          workflowContext: { ...(instance.context || {}), ...(branch.contextNamespace || {}) },
+          userId: normalizeWorkflowUserId(instance.metadata?.initiatedBy) ?? undefined,
+        },
         container,
         branch,
       )