@open-mercato/core 0.7.1-develop.7193.1.910a5b0a1e → 0.7.1-develop.7195.1.b5efd1d51a

package/dist/modules/workflows/lib/bulk-replay.js

@@ -0,0 +1,101 @@
+import { createModuleQueue } from "@open-mercato/queue";
+import { createLogger } from "@open-mercato/shared/lib/logger";
+import { WorkflowInstance } from "../data/entities.js";
+import * as workflowExecutor from "./workflow-executor.js";
+import { isRetryableRunOutcome } from "./run-outcome.js";
+const logger = createLogger("workflows");
+const WORKFLOW_INSTANCE_BULK_REPLAY_QUEUE = "workflow-instance-bulk-replay";
+const BULK_REPLAY_MAX_IDS = 1e3;
+let queueInstance = null;
+function getBulkReplayQueue() {
+  if (!queueInstance) {
+    queueInstance = createModuleQueue(WORKFLOW_INSTANCE_BULK_REPLAY_QUEUE, {
+      // Replay re-executes real workflows; one at a time keeps a bulk retry
+      // from becoming its own load spike.
+      concurrency: 1
+    });
+  }
+  return queueInstance;
+}
+const RETRYABLE_STATUSES = /* @__PURE__ */ new Set(["FAILED", "PAUSED"]);
+const CANCELLABLE_STATUSES = /* @__PURE__ */ new Set(["RUNNING", "PAUSED", "WAITING_FOR_ACTIVITIES", "FORKED"]);
+function canApplyBulkReplay(action, status, outcome) {
+  if (action === "cancel") return CANCELLABLE_STATUSES.has(status);
+  if (!RETRYABLE_STATUSES.has(status)) return false;
+  if (outcome != null && !isRetryableRunOutcome(outcome)) return false;
+  return true;
+}
+async function retryInstance(em, container, instance) {
+  if (instance.metadata?.attention) {
+    instance.metadata = { ...instance.metadata, attention: null };
+  }
+  instance.status = "RUNNING";
+  instance.retryCount = (instance.retryCount || 0) + 1;
+  instance.errorMessage = null;
+  instance.errorDetails = null;
+  instance.updatedAt = /* @__PURE__ */ new Date();
+  await em.flush();
+  await workflowExecutor.executeWorkflow(em, container, instance.id);
+}
+async function runBulkReplay(params) {
+  const { container, progressJobId, action, ids, scope } = params;
+  const em = container.resolve("em");
+  const progressService = container.resolve("progressService");
+  const progressContext = {
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    userId: scope.userId ?? null
+  };
+  await progressService.startJob(progressJobId, progressContext);
+  await progressService.updateProgress(
+    progressJobId,
+    { totalCount: ids.length, processedCount: 0 },
+    progressContext
+  );
+  let affectedCount = 0;
+  let skippedCount = 0;
+  let failedCount = 0;
+  for (const [index, instanceId] of ids.entries()) {
+    try {
+      const instance = await em.findOne(WorkflowInstance, {
+        id: instanceId,
+        tenantId: scope.tenantId,
+        organizationId: scope.organizationId
+      });
+      if (!instance || !canApplyBulkReplay(action, instance.status, instance.outcome ?? null)) {
+        skippedCount += 1;
+      } else if (action === "retry") {
+        await retryInstance(em, container, instance);
+        affectedCount += 1;
+      } else {
+        await workflowExecutor.completeWorkflow(em, container, instance.id, "CANCELLED");
+        affectedCount += 1;
+      }
+    } catch (error) {
+      failedCount += 1;
+      logger.error("Bulk replay failed for instance", { instanceId, action, err: error });
+    }
+    await progressService.updateProgress(
+      progressJobId,
+      { totalCount: ids.length, processedCount: index + 1 },
+      progressContext
+    );
+  }
+  const summary = {
+    action,
+    requestedCount: ids.length,
+    affectedCount,
+    skippedCount,
+    failedCount
+  };
+  await progressService.completeJob(progressJobId, { resultSummary: summary }, progressContext);
+  return summary;
+}
+export {
+  BULK_REPLAY_MAX_IDS,
+  WORKFLOW_INSTANCE_BULK_REPLAY_QUEUE,
+  canApplyBulkReplay,
+  getBulkReplayQueue,
+  runBulkReplay
+};
+//# sourceMappingURL=bulk-replay.js.map

package/dist/modules/workflows/lib/bulk-replay.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/bulk-replay.ts"],
+  "sourcesContent": ["/**\n * Failure-queue bulk replay (spec \u00A78.4) \u2014 \"bulk retry/cancel runs through the\n * progress module\".\n *\n * The work runs in a queue worker rather than in the request, per\n * `progress/AGENTS.md` MUST rules: replaying 500 parked instances re-executes\n * 500 workflows, which cannot happen inside an HTTP handler and must survive\n * the operator navigating away.\n *\n * One instance failing must NEVER abort the batch \u2014 that is the whole point of\n * a triage surface. Every outcome is counted and the summary reports how many\n * were replayed, skipped and errored.\n */\n\nimport type { AwilixContainer } from 'awilix'\nimport type { EntityManager } from '@mikro-orm/core'\nimport { createModuleQueue, type Queue } from '@open-mercato/queue'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { WorkflowInstance } from '../data/entities'\nimport * as workflowExecutor from './workflow-executor'\nimport { isRetryableRunOutcome, type WorkflowRunOutcome } from './run-outcome'\nimport type { ProgressService, ProgressServiceContext } from '../../progress/lib/progressService'\n\nconst logger = createLogger('workflows')\n\nexport const WORKFLOW_INSTANCE_BULK_REPLAY_QUEUE = 'workflow-instance-bulk-replay'\n\n/** Bound on one batch. Larger sets are triaged by narrowing the error group. */\nexport const BULK_REPLAY_MAX_IDS = 1000\n\nexport type BulkReplayAction = 'retry' | 'cancel'\n\nexport type BulkReplayScope = {\n  tenantId: string\n  organizationId: string\n  userId?: string | null\n}\n\nexport type BulkReplayJobPayload = {\n  progressJobId: string\n  action: BulkReplayAction\n  ids: string[]\n  scope: BulkReplayScope\n}\n\nexport type BulkReplaySummary = {\n  action: BulkReplayAction\n  requestedCount: number\n  affectedCount: number\n  skippedCount: number\n  failedCount: number\n}\n\nlet queueInstance: Queue<Record<string, unknown>> | null = null\n\nexport function getBulkReplayQueue(): Queue<Record<string, unknown>> {\n  if (!queueInstance) {\n    queueInstance = createModuleQueue<Record<string, unknown>>(WORKFLOW_INSTANCE_BULK_REPLAY_QUEUE, {\n      // Replay re-executes real workflows; one at a time keeps a bulk retry\n      // from becoming its own load spike.\n      concurrency: 1,\n    })\n  }\n  return queueInstance\n}\n\n/** Statuses each action is allowed to act on, mirroring the single-instance routes. */\nconst RETRYABLE_STATUSES = new Set(['FAILED', 'PAUSED'])\nconst CANCELLABLE_STATUSES = new Set(['RUNNING', 'PAUSED', 'WAITING_FOR_ACTIVITIES', 'FORKED'])\n\n/**\n * `outcome` is optional so every existing caller keeps compiling; passing it is\n * what makes the \"a `partial_failure` is not retryable as a whole run\" decision\n * (maintainer, 2026-07-30) EXPLICIT here rather than incidental. A\n * `partial_failure` is COMPLETED, so the status gate already refuses it \u2014 but a\n * later widening of `RETRYABLE_STATUSES` must not silently start replaying a\n * run whose successful half the replay would duplicate. Recovery is\n * rerun-from-step on the specific failed step.\n *\n * A null outcome (still running, or a row written before outcomes existed) is\n * never read as a refusal \u2014 only the status decides for those.\n */\nexport function canApplyBulkReplay(\n  action: BulkReplayAction,\n  status: string,\n  outcome?: WorkflowRunOutcome | null\n): boolean {\n  if (action === 'cancel') return CANCELLABLE_STATUSES.has(status)\n  if (!RETRYABLE_STATUSES.has(status)) return false\n  if (outcome != null && !isRetryableRunOutcome(outcome)) return false\n  return true\n}\n\nasync function retryInstance(\n  em: EntityManager,\n  container: AwilixContainer,\n  instance: WorkflowInstance\n): Promise<void> {\n  // A parked instance carries an engine-owned attention marker; clearing it is\n  // what takes it out of the failure queue. It is deliberately cleared BEFORE\n  // execution so a replay that parks again re-marks it honestly.\n  if (instance.metadata?.attention) {\n    instance.metadata = { ...instance.metadata, attention: null }\n  }\n  instance.status = 'RUNNING'\n  instance.retryCount = (instance.retryCount || 0) + 1\n  instance.errorMessage = null\n  instance.errorDetails = null\n  instance.updatedAt = new Date()\n  await em.flush()\n\n  await workflowExecutor.executeWorkflow(em, container, instance.id)\n}\n\nexport async function runBulkReplay(params: {\n  container: AwilixContainer\n  progressJobId: string\n  action: BulkReplayAction\n  ids: readonly string[]\n  scope: BulkReplayScope\n}): Promise<BulkReplaySummary> {\n  const { container, progressJobId, action, ids, scope } = params\n  const em = container.resolve('em') as EntityManager\n  const progressService = container.resolve('progressService') as ProgressService\n  const progressContext: ProgressServiceContext = {\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n    userId: scope.userId ?? null,\n  }\n\n  await progressService.startJob(progressJobId, progressContext)\n  await progressService.updateProgress(\n    progressJobId,\n    { totalCount: ids.length, processedCount: 0 },\n    progressContext\n  )\n\n  let affectedCount = 0\n  let skippedCount = 0\n  let failedCount = 0\n\n  for (const [index, instanceId] of ids.entries()) {\n    try {\n      // Re-read under the caller's tenant + organization on every iteration:\n      // an id that belongs to another tenant resolves to nothing and is\n      // skipped, never acted on.\n      const instance = await em.findOne(WorkflowInstance, {\n        id: instanceId,\n        tenantId: scope.tenantId,\n        organizationId: scope.organizationId,\n      })\n\n      if (!instance || !canApplyBulkReplay(action, instance.status, instance.outcome ?? null)) {\n        skippedCount += 1\n      } else if (action === 'retry') {\n        await retryInstance(em, container, instance)\n        affectedCount += 1\n      } else {\n        await workflowExecutor.completeWorkflow(em, container, instance.id, 'CANCELLED')\n        affectedCount += 1\n      }\n    } catch (error) {\n      // One bad instance must not abort a triage batch.\n      failedCount += 1\n      logger.error('Bulk replay failed for instance', { instanceId, action, err: error })\n    }\n\n    await progressService.updateProgress(\n      progressJobId,\n      { totalCount: ids.length, processedCount: index + 1 },\n      progressContext\n    )\n  }\n\n  const summary: BulkReplaySummary = {\n    action,\n    requestedCount: ids.length,\n    affectedCount,\n    skippedCount,\n    failedCount,\n  }\n\n  await progressService.completeJob(progressJobId, { resultSummary: summary }, progressContext)\n  return summary\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/lib/business-rule-usage.js

@@ -0,0 +1,91 @@
+function readConditionRuleIds(raw) {
+  if (!Array.isArray(raw)) return [];
+  const ids = [];
+  for (const entry of raw) {
+    if (typeof entry === "string") {
+      ids.push(entry);
+      continue;
+    }
+    if (entry && typeof entry === "object") {
+      const ruleId = entry.ruleId;
+      if (typeof ruleId === "string" && ruleId.length > 0) ids.push(ruleId);
+    }
+  }
+  return ids;
+}
+function collectBusinessRuleUsage(definitions, ruleId) {
+  if (!ruleId) return [];
+  const references = [];
+  for (const candidate of definitions) {
+    const data = candidate.definition ?? {};
+    const steps = Array.isArray(data.steps) ? data.steps : [];
+    const transitions = Array.isArray(data.transitions) ? data.transitions : [];
+    for (const step of steps) {
+      const stepId = step?.stepId;
+      if (typeof stepId !== "string") continue;
+      if (readConditionRuleIds(step.preConditions).includes(ruleId)) {
+        references.push({
+          workflowId: candidate.workflowId,
+          version: candidate.version,
+          ...candidate.name ? { workflowName: candidate.name } : {},
+          kind: "startPreCondition",
+          locationId: stepId
+        });
+      }
+    }
+    for (const transition of transitions) {
+      const transitionId = transition?.transitionId;
+      if (typeof transitionId !== "string") continue;
+      if (readConditionRuleIds(transition.preConditions).includes(ruleId)) {
+        references.push({
+          workflowId: candidate.workflowId,
+          version: candidate.version,
+          ...candidate.name ? { workflowName: candidate.name } : {},
+          kind: "transitionPreCondition",
+          locationId: transitionId
+        });
+      }
+      if (readConditionRuleIds(transition.postConditions).includes(ruleId)) {
+        references.push({
+          workflowId: candidate.workflowId,
+          version: candidate.version,
+          ...candidate.name ? { workflowName: candidate.name } : {},
+          kind: "transitionPostCondition",
+          locationId: transitionId
+        });
+      }
+    }
+  }
+  return references;
+}
+function countReferencingWorkflows(references) {
+  return new Set(references.map((reference) => reference.workflowId)).size;
+}
+async function findBusinessRuleUsage(em, options) {
+  const { ruleId, tenantId, organizationId } = options;
+  if (!ruleId) return [];
+  const containments = [
+    JSON.stringify({ steps: [{ preConditions: [{ ruleId }] }] }),
+    JSON.stringify({ transitions: [{ preConditions: [{ ruleId }] }] }),
+    JSON.stringify({ transitions: [{ postConditions: [{ ruleId }] }] })
+  ];
+  const rows = await em.getConnection().execute(
+    `select workflow_id, version, workflow_name, definition from workflow_definitions
+     where tenant_id = ? and organization_id = ? and deleted_at is null
+       and (definition @> ?::jsonb or definition @> ?::jsonb or definition @> ?::jsonb)`,
+    [tenantId, organizationId, ...containments]
+  );
+  const definitions = rows.map((row) => ({
+    workflowId: row.workflow_id,
+    version: row.version,
+    ...row.workflow_name ? { name: row.workflow_name } : {},
+    definition: typeof row.definition === "string" ? JSON.parse(row.definition) : row.definition
+  }));
+  return collectBusinessRuleUsage(definitions, ruleId);
+}
+export {
+  collectBusinessRuleUsage,
+  countReferencingWorkflows,
+  findBusinessRuleUsage
+};
+//# sourceMappingURL=business-rule-usage.js.map

package/dist/modules/workflows/lib/business-rule-usage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/business-rule-usage.ts"],
+  "sourcesContent": ["/**\n * Workflows Module - Business Rule Usage Lookup\n *\n * Answers \"which workflows reference this business rule?\" for the dependency\n * visibility panel that ships with the inline BR editor (spec\n * 2026-07-26-workflows-ux-redesign.md team decision #5, issue #4236).\n *\n * The direction matters: `business_rules` owns the editor and exposes a slot,\n * and every consuming module resolves its OWN usage. So this lookup lives here,\n * scans workflow definitions, and never asks business_rules for anything \u2014\n * business_rules stays free of a workflows import (core AGENTS.md \u00A7\n * Cross-Module Coupling).\n *\n * `collectBusinessRuleUsage` is PURE (plain definition JSON in, references out)\n * so it is unit-testable without a database; `findBusinessRuleUsage` is the\n * tenant-scoped query wrapper, modelled on `caller-graph.ts`.\n */\n\nimport type { EntityManager } from '@mikro-orm/core'\n\nexport type BusinessRuleUsageKind = 'startPreCondition' | 'transitionPreCondition' | 'transitionPostCondition'\n\nexport interface BusinessRuleUsageReference {\n  workflowId: string\n  version: number\n  workflowName?: string\n  kind: BusinessRuleUsageKind\n  /** Step id for START pre-conditions, transition id for transition conditions. */\n  locationId: string\n}\n\nexport interface BusinessRuleUsageDefinition {\n  workflowId: string\n  version: number\n  name?: string\n  definition: unknown\n}\n\nfunction readConditionRuleIds(raw: unknown): string[] {\n  if (!Array.isArray(raw)) return []\n  const ids: string[] = []\n  for (const entry of raw) {\n    if (typeof entry === 'string') {\n      ids.push(entry)\n      continue\n    }\n    if (entry && typeof entry === 'object') {\n      const ruleId = (entry as { ruleId?: unknown }).ruleId\n      if (typeof ruleId === 'string' && ruleId.length > 0) ids.push(ruleId)\n    }\n  }\n  return ids\n}\n\n/**\n * Every place a definition can name a business rule: START step pre-conditions\n * and transition pre/post-conditions (`data/validators.ts`\n * `startPreConditionSchema` / `transitionConditionSchema`). Inline\n * `transition.condition` expressions are NOT rule references \u2014 they are\n * embedded expressions with no rule identity \u2014 so they are deliberately absent.\n */\nexport function collectBusinessRuleUsage(\n  definitions: BusinessRuleUsageDefinition[],\n  ruleId: string,\n): BusinessRuleUsageReference[] {\n  if (!ruleId) return []\n  const references: BusinessRuleUsageReference[] = []\n\n  for (const candidate of definitions) {\n    const data = (candidate.definition ?? {}) as { steps?: unknown; transitions?: unknown }\n    const steps = Array.isArray(data.steps) ? data.steps : []\n    const transitions = Array.isArray(data.transitions) ? data.transitions : []\n\n    for (const step of steps) {\n      const stepId = (step as { stepId?: unknown })?.stepId\n      if (typeof stepId !== 'string') continue\n      if (readConditionRuleIds((step as { preConditions?: unknown }).preConditions).includes(ruleId)) {\n        references.push({\n          workflowId: candidate.workflowId,\n          version: candidate.version,\n          ...(candidate.name ? { workflowName: candidate.name } : {}),\n          kind: 'startPreCondition',\n          locationId: stepId,\n        })\n      }\n    }\n\n    for (const transition of transitions) {\n      const transitionId = (transition as { transitionId?: unknown })?.transitionId\n      if (typeof transitionId !== 'string') continue\n      if (readConditionRuleIds((transition as { preConditions?: unknown }).preConditions).includes(ruleId)) {\n        references.push({\n          workflowId: candidate.workflowId,\n          version: candidate.version,\n          ...(candidate.name ? { workflowName: candidate.name } : {}),\n          kind: 'transitionPreCondition',\n          locationId: transitionId,\n        })\n      }\n      if (readConditionRuleIds((transition as { postConditions?: unknown }).postConditions).includes(ruleId)) {\n        references.push({\n          workflowId: candidate.workflowId,\n          version: candidate.version,\n          ...(candidate.name ? { workflowName: candidate.name } : {}),\n          kind: 'transitionPostCondition',\n          locationId: transitionId,\n        })\n      }\n    }\n  }\n\n  return references\n}\n\n/** Distinct workflows (by `workflowId`) touched by the supplied references. */\nexport function countReferencingWorkflows(references: BusinessRuleUsageReference[]): number {\n  return new Set(references.map((reference) => reference.workflowId)).size\n}\n\n/**\n * Tenant/org-scoped scan of workflow definitions for `ruleId`. Uses jsonb `@>`\n * containment (GIN-indexed on `workflow_definitions.definition`) so only rows\n * that actually name the rule are materialised, then re-checks them with the\n * pure collector to attach exact locations.\n */\nexport async function findBusinessRuleUsage(\n  em: EntityManager,\n  options: { ruleId: string; tenantId: string; organizationId: string },\n): Promise<BusinessRuleUsageReference[]> {\n  const { ruleId, tenantId, organizationId } = options\n  if (!ruleId) return []\n\n  const containments = [\n    JSON.stringify({ steps: [{ preConditions: [{ ruleId }] }] }),\n    JSON.stringify({ transitions: [{ preConditions: [{ ruleId }] }] }),\n    JSON.stringify({ transitions: [{ postConditions: [{ ruleId }] }] }),\n  ]\n\n  const rows = (await em.getConnection().execute(\n    `select workflow_id, version, workflow_name, definition from workflow_definitions\n     where tenant_id = ? and organization_id = ? and deleted_at is null\n       and (definition @> ?::jsonb or definition @> ?::jsonb or definition @> ?::jsonb)`,\n    [tenantId, organizationId, ...containments],\n  )) as Array<{ workflow_id: string; version: number; workflow_name: string | null; definition: unknown }>\n\n  const definitions: BusinessRuleUsageDefinition[] = rows.map((row) => ({\n    workflowId: row.workflow_id,\n    version: row.version,\n    ...(row.workflow_name ? { name: row.workflow_name } : {}),\n    definition: typeof row.definition === 'string' ? JSON.parse(row.definition) : row.definition,\n  }))\n\n  return collectBusinessRuleUsage(definitions, ruleId)\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/lib/caller-graph.js

@@ -0,0 +1,53 @@
+function computeCallerImpacts(callers, subWorkflowId, ports) {
+  const inputNames = new Set((ports.inputs || []).map((port) => port.name));
+  const outputNames = new Set((ports.outputs || []).map((port) => port.name));
+  const impacts = [];
+  for (const caller of callers) {
+    const steps = Array.isArray(caller.definition?.steps) ? caller.definition.steps : [];
+    for (const step of steps) {
+      if (step?.stepType !== "SUB_WORKFLOW") continue;
+      if (step?.config?.subWorkflowId !== subWorkflowId) continue;
+      const broken = [];
+      const inputMapping = step.config?.inputMapping || {};
+      for (const childPortKey of Object.keys(inputMapping)) {
+        if (!inputNames.has(childPortKey)) broken.push(`input:${childPortKey}`);
+      }
+      const outputMapping = step.config?.outputMapping || {};
+      for (const childPath of Object.values(outputMapping)) {
+        const portName = String(childPath).split(".")[0];
+        if (!outputNames.has(portName)) broken.push(`output:${childPath}`);
+      }
+      if (broken.length > 0) {
+        impacts.push({
+          workflowId: caller.workflowId,
+          version: caller.version,
+          stepId: step.stepId,
+          brokenMappings: broken
+        });
+      }
+    }
+  }
+  return impacts;
+}
+async function findSubWorkflowCallers(em, options) {
+  const { subWorkflowId, tenantId, organizationId, ports } = options;
+  const containment = JSON.stringify({
+    steps: [{ stepType: "SUB_WORKFLOW", config: { subWorkflowId } }]
+  });
+  const rows = await em.getConnection().execute(
+    `select workflow_id, version, definition from workflow_definitions
+     where tenant_id = ? and organization_id = ? and deleted_at is null and definition @> ?::jsonb`,
+    [tenantId, organizationId, containment]
+  );
+  const callers = rows.map((row) => ({
+    workflowId: row.workflow_id,
+    version: row.version,
+    definition: typeof row.definition === "string" ? JSON.parse(row.definition) : row.definition
+  }));
+  return computeCallerImpacts(callers, subWorkflowId, ports);
+}
+export {
+  computeCallerImpacts,
+  findSubWorkflowCallers
+};
+//# sourceMappingURL=caller-graph.js.map

package/dist/modules/workflows/lib/caller-graph.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/caller-graph.ts"],
+  "sourcesContent": ["/**\n * Workflows Module - Sub-workflow Caller Graph\n *\n * Finds the parent definitions that invoke a given sub-workflow and computes\n * which of their field mappings a port-schema change would break. Used by the\n * publish flow and the breaking-change preview endpoint.\n *\n * The caller scan uses a tenant-scoped jsonb `@>` containment query (backed by\n * the GIN index on `workflow_definitions.definition`); the impact diff is a pure\n * function so it can be unit-tested without a database.\n */\n\nimport type { EntityManager } from '@mikro-orm/core'\nimport { WorkflowDefinition } from '../data/entities'\nimport type { PortField, WorkflowIoContract } from '../data/validators'\n\nexport interface CallerImpact {\n  workflowId: string\n  version: number\n  stepId: string\n  brokenMappings: string[]\n}\n\ninterface CallerDefinition {\n  workflowId: string\n  version: number\n  definition: any\n}\n\n/**\n * Compute, for each caller, the mappings that reference a port no longer present\n * in `ports`. Input mappings are keyed by child INPUT port name; output mappings\n * are keyed by parent key with values that are dot-paths whose first segment is a\n * child OUTPUT port name.\n */\nexport function computeCallerImpacts(\n  callers: CallerDefinition[],\n  subWorkflowId: string,\n  ports: WorkflowIoContract,\n): CallerImpact[] {\n  const inputNames = new Set((ports.inputs || []).map((port: PortField) => port.name))\n  const outputNames = new Set((ports.outputs || []).map((port: PortField) => port.name))\n  const impacts: CallerImpact[] = []\n\n  for (const caller of callers) {\n    const steps: any[] = Array.isArray(caller.definition?.steps) ? caller.definition.steps : []\n    for (const step of steps) {\n      if (step?.stepType !== 'SUB_WORKFLOW') continue\n      if (step?.config?.subWorkflowId !== subWorkflowId) continue\n\n      const broken: string[] = []\n\n      const inputMapping: Record<string, string> = step.config?.inputMapping || {}\n      for (const childPortKey of Object.keys(inputMapping)) {\n        if (!inputNames.has(childPortKey)) broken.push(`input:${childPortKey}`)\n      }\n\n      const outputMapping: Record<string, string> = step.config?.outputMapping || {}\n      for (const childPath of Object.values(outputMapping)) {\n        const portName = String(childPath).split('.')[0]\n        if (!outputNames.has(portName)) broken.push(`output:${childPath}`)\n      }\n\n      if (broken.length > 0) {\n        impacts.push({\n          workflowId: caller.workflowId,\n          version: caller.version,\n          stepId: step.stepId,\n          brokenMappings: broken,\n        })\n      }\n    }\n  }\n\n  return impacts\n}\n\n/**\n * Find parent definitions that invoke `subWorkflowId` and compute their breaking\n * mappings against the supplied published port contract. Tenant/org scoped.\n */\nexport async function findSubWorkflowCallers(\n  em: EntityManager,\n  options: { subWorkflowId: string; tenantId: string; organizationId: string; ports: WorkflowIoContract },\n): Promise<CallerImpact[]> {\n  const { subWorkflowId, tenantId, organizationId, ports } = options\n  const containment = JSON.stringify({\n    steps: [{ stepType: 'SUB_WORKFLOW', config: { subWorkflowId } }],\n  })\n\n  const rows = (await em.getConnection().execute(\n    `select workflow_id, version, definition from workflow_definitions\n     where tenant_id = ? and organization_id = ? and deleted_at is null and definition @> ?::jsonb`,\n    [tenantId, organizationId, containment],\n  )) as Array<{ workflow_id: string; version: number; definition: any }>\n\n  const callers: CallerDefinition[] = rows.map((row) => ({\n    workflowId: row.workflow_id,\n    version: row.version,\n    definition: typeof row.definition === 'string' ? JSON.parse(row.definition) : row.definition,\n  }))\n\n  return computeCallerImpacts(callers, subWorkflowId, ports)\n}\n"],
+  "mappings": "AAmCO,SAAS,qBACd,SACA,eACA,OACgB;AAChB,QAAM,aAAa,IAAI,KAAK,MAAM,UAAU,CAAC,GAAG,IAAI,CAAC,SAAoB,KAAK,IAAI,CAAC;AACnF,QAAM,cAAc,IAAI,KAAK,MAAM,WAAW,CAAC,GAAG,IAAI,CAAC,SAAoB,KAAK,IAAI,CAAC;AACrF,QAAM,UAA0B,CAAC;AAEjC,aAAW,UAAU,SAAS;AAC5B,UAAM,QAAe,MAAM,QAAQ,OAAO,YAAY,KAAK,IAAI,OAAO,WAAW,QAAQ,CAAC;AAC1F,eAAW,QAAQ,OAAO;AACxB,UAAI,MAAM,aAAa,eAAgB;AACvC,UAAI,MAAM,QAAQ,kBAAkB,cAAe;AAEnD,YAAM,SAAmB,CAAC;AAE1B,YAAM,eAAuC,KAAK,QAAQ,gBAAgB,CAAC;AAC3E,iBAAW,gBAAgB,OAAO,KAAK,YAAY,GAAG;AACpD,YAAI,CAAC,WAAW,IAAI,YAAY,EAAG,QAAO,KAAK,SAAS,YAAY,EAAE;AAAA,MACxE;AAEA,YAAM,gBAAwC,KAAK,QAAQ,iBAAiB,CAAC;AAC7E,iBAAW,aAAa,OAAO,OAAO,aAAa,GAAG;AACpD,cAAM,WAAW,OAAO,SAAS,EAAE,MAAM,GAAG,EAAE,CAAC;AAC/C,YAAI,CAAC,YAAY,IAAI,QAAQ,EAAG,QAAO,KAAK,UAAU,SAAS,EAAE;AAAA,MACnE;AAEA,UAAI,OAAO,SAAS,GAAG;AACrB,gBAAQ,KAAK;AAAA,UACX,YAAY,OAAO;AAAA,UACnB,SAAS,OAAO;AAAA,UAChB,QAAQ,KAAK;AAAA,UACb,gBAAgB;AAAA,QAClB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAMA,eAAsB,uBACpB,IACA,SACyB;AACzB,QAAM,EAAE,eAAe,UAAU,gBAAgB,MAAM,IAAI;AAC3D,QAAM,cAAc,KAAK,UAAU;AAAA,IACjC,OAAO,CAAC,EAAE,UAAU,gBAAgB,QAAQ,EAAE,cAAc,EAAE,CAAC;AAAA,EACjE,CAAC;AAED,QAAM,OAAQ,MAAM,GAAG,cAAc,EAAE;AAAA,IACrC;AAAA;AAAA,IAEA,CAAC,UAAU,gBAAgB,WAAW;AAAA,EACxC;AAEA,QAAM,UAA8B,KAAK,IAAI,CAAC,SAAS;AAAA,IACrD,YAAY,IAAI;AAAA,IAChB,SAAS,IAAI;AAAA,IACb,YAAY,OAAO,IAAI,eAAe,WAAW,KAAK,MAAM,IAAI,UAAU,IAAI,IAAI;AAAA,EACpF,EAAE;AAEF,SAAO,qBAAqB,SAAS,eAAe,KAAK;AAC3D;",
+  "names": []
+}

package/dist/modules/workflows/lib/code-view-apply.js

@@ -0,0 +1,86 @@
+function parseErrorLine(message, text) {
+  const lineMatch = /line (\d+)/i.exec(message);
+  if (lineMatch) {
+    const parsed = Number.parseInt(lineMatch[1], 10);
+    if (Number.isFinite(parsed) && parsed > 0) return parsed;
+  }
+  const positionMatch = /position (\d+)/i.exec(message);
+  if (positionMatch) {
+    const offset = Number.parseInt(positionMatch[1], 10);
+    if (!Number.isFinite(offset) || offset < 0) return null;
+    let line = 1;
+    for (let index = 0; index < Math.min(offset, text.length); index += 1) {
+      if (text[index] === "\n") line += 1;
+    }
+    return line;
+  }
+  return null;
+}
+function evaluateCodeViewDraft(input) {
+  const { draftText, canvasText, parseDefinition, validateGraph } = input;
+  if (canvasText !== void 0 && draftText === canvasText) {
+    return { ok: false, reason: "unchanged" };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(draftText);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return { ok: false, reason: "parseError", message, line: parseErrorLine(message, draftText) };
+  }
+  const definitionResult = parseDefinition(parsed);
+  if (!definitionResult.ok) {
+    return { ok: false, reason: "schemaError", messages: definitionResult.messages };
+  }
+  const graphErrors = validateGraph(definitionResult.definition);
+  if (graphErrors.length > 0) {
+    return { ok: false, reason: "graphError", messages: graphErrors };
+  }
+  return { ok: true, definition: definitionResult.definition };
+}
+function describeCodeViewDraft(decision) {
+  if (decision.ok) {
+    return {
+      dirty: true,
+      canApply: true,
+      parseErrorLine: null,
+      parseErrorMessage: null,
+      blockingMessages: [],
+      blockingSeverity: null
+    };
+  }
+  if (decision.reason === "unchanged") {
+    return {
+      dirty: false,
+      canApply: false,
+      parseErrorLine: null,
+      parseErrorMessage: null,
+      blockingMessages: [],
+      blockingSeverity: null
+    };
+  }
+  if (decision.reason === "parseError") {
+    return {
+      dirty: true,
+      canApply: false,
+      parseErrorLine: decision.line,
+      parseErrorMessage: decision.message,
+      blockingMessages: [decision.message],
+      blockingSeverity: "error"
+    };
+  }
+  return {
+    dirty: true,
+    canApply: false,
+    parseErrorLine: null,
+    parseErrorMessage: null,
+    blockingMessages: decision.messages,
+    blockingSeverity: "error"
+  };
+}
+export {
+  describeCodeViewDraft,
+  evaluateCodeViewDraft,
+  parseErrorLine
+};
+//# sourceMappingURL=code-view-apply.js.map

package/dist/modules/workflows/lib/code-view-apply.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/code-view-apply.ts"],
+  "sourcesContent": ["/**\n * Workflows Module \u2014 Code view stage 2, the apply gate (spec section 2.2)\n *\n * ## The safety model, and why this one\n *\n * Stage 2 asks for *\"two-way live sync\"*. Taken literally \u2014 mutate the canvas\n * on every keystroke \u2014 it is unimplementable safely: deleting the `s` of\n * `\"steps\"` momentarily produces a document with no steps, and applying it\n * would delete every node, blow away the arrangement and push an undo entry\n * per character. So the two directions get the treatment each can actually\n * support:\n *\n * - **canvas \u2192 code is LIVE.** The panel re-renders from the canvas whenever\n *   the author has not started editing. This is the direction with no risk:\n *   the canvas is already the source of truth.\n * - **code \u2192 canvas is EXPLICIT.** The textarea is a local draft; the author\n *   presses Apply (or Cmd/Ctrl+Enter). Parsing and validation are still LIVE \u2014\n *   squiggles, the issue list and the Apply button's enabled state all update\n *   as you type \u2014 so the feedback loop is immediate even though the commit is\n *   not.\n *\n * `evaluateCodeViewDraft` is that gate, and it is PURE so the rule is testable\n * without a canvas. It refuses in four escalating ways, each with a distinct\n * reason the UI can explain:\n *\n * 1. `unchanged` \u2014 nothing to apply.\n * 2. `parseError` \u2014 not JSON. Carries the line so the editor can point at it.\n * 3. `schemaError` \u2014 parses, but is not a workflow definition.\n * 4. `graphError` \u2014 a valid definition whose GRAPH is broken (no START, an\n *    unreachable step, a route to nowhere). Warnings do NOT block, exactly as\n *    they do not block a Save.\n *\n * Refusing on graph errors is the difference between this and a \"just apply\n * whatever parses\" design. A canvas holding a graph the engine would reject is\n * a canvas the author has to repair by hand, and they no longer have the JSON\n * they typed \u2014 the textarea now mirrors the broken result.\n */\n\nimport type { WorkflowValidationIssueSeverity } from './collect-validation-issues'\n\nexport type CodeViewApplyRefusal =\n  | { ok: false; reason: 'unchanged' }\n  | { ok: false; reason: 'parseError'; message: string; line: number | null }\n  | { ok: false; reason: 'schemaError'; messages: string[] }\n  | { ok: false; reason: 'graphError'; messages: string[] }\n\nexport type CodeViewApplyDecision<TDefinition> =\n  | { ok: true; definition: TDefinition }\n  | CodeViewApplyRefusal\n\nexport type CodeViewDraftInput<TDefinition> = {\n  draftText: string\n  /**\n   * The JSON the canvas currently serializes to.\n   *\n   * OMIT it when there is no such text to compare against \u2014 an AI-generated\n   * draft (spec section 9) is a document the author asked for, so \"identical to\n   * the canvas\" is not a refusal, it is a coincidence. Every other refusal\n   * still applies, which is the point: a generated definition passes the same\n   * gate a pasted one does.\n   */\n  canvasText?: string\n  parseDefinition: (parsed: unknown) => { ok: true; definition: TDefinition } | { ok: false; messages: string[] }\n  /**\n   * Graph-level validation of the parsed definition. Return only ERRORS \u2014\n   * warnings never block an apply, for the same reason they never block a save.\n   */\n  validateGraph: (definition: TDefinition) => string[]\n}\n\n/**\n * Extract the 1-based line number from a `JSON.parse` error message.\n *\n * Engines disagree on the wording, and some report only a character position,\n * so this is deliberately best-effort: a missing line means \"no gutter marker\",\n * never a marker on the wrong line.\n */\nexport function parseErrorLine(message: string, text: string): number | null {\n  const lineMatch = /line (\\d+)/i.exec(message)\n  if (lineMatch) {\n    const parsed = Number.parseInt(lineMatch[1], 10)\n    if (Number.isFinite(parsed) && parsed > 0) return parsed\n  }\n  const positionMatch = /position (\\d+)/i.exec(message)\n  if (positionMatch) {\n    const offset = Number.parseInt(positionMatch[1], 10)\n    if (!Number.isFinite(offset) || offset < 0) return null\n    let line = 1\n    for (let index = 0; index < Math.min(offset, text.length); index += 1) {\n      if (text[index] === '\\n') line += 1\n    }\n    return line\n  }\n  return null\n}\n\nexport function evaluateCodeViewDraft<TDefinition>(\n  input: CodeViewDraftInput<TDefinition>,\n): CodeViewApplyDecision<TDefinition> {\n  const { draftText, canvasText, parseDefinition, validateGraph } = input\n\n  if (canvasText !== undefined && draftText === canvasText) {\n    return { ok: false, reason: 'unchanged' }\n  }\n\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(draftText)\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error)\n    return { ok: false, reason: 'parseError', message, line: parseErrorLine(message, draftText) }\n  }\n\n  const definitionResult = parseDefinition(parsed)\n  if (!definitionResult.ok) {\n    return { ok: false, reason: 'schemaError', messages: definitionResult.messages }\n  }\n\n  const graphErrors = validateGraph(definitionResult.definition)\n  if (graphErrors.length > 0) {\n    return { ok: false, reason: 'graphError', messages: graphErrors }\n  }\n\n  return { ok: true, definition: definitionResult.definition }\n}\n\nexport type CodeViewDraftStatus = {\n  dirty: boolean\n  canApply: boolean\n  /** Line the editor should mark as the parse failure, when there is one. */\n  parseErrorLine: number | null\n  parseErrorMessage: string | null\n  blockingMessages: string[]\n  blockingSeverity: WorkflowValidationIssueSeverity | null\n}\n\nexport function describeCodeViewDraft<TDefinition>(\n  decision: CodeViewApplyDecision<TDefinition>,\n): CodeViewDraftStatus {\n  if (decision.ok) {\n    return {\n      dirty: true,\n      canApply: true,\n      parseErrorLine: null,\n      parseErrorMessage: null,\n      blockingMessages: [],\n      blockingSeverity: null,\n    }\n  }\n  if (decision.reason === 'unchanged') {\n    return {\n      dirty: false,\n      canApply: false,\n      parseErrorLine: null,\n      parseErrorMessage: null,\n      blockingMessages: [],\n      blockingSeverity: null,\n    }\n  }\n  if (decision.reason === 'parseError') {\n    return {\n      dirty: true,\n      canApply: false,\n      parseErrorLine: decision.line,\n      parseErrorMessage: decision.message,\n      blockingMessages: [decision.message],\n      blockingSeverity: 'error',\n    }\n  }\n  return {\n    dirty: true,\n    canApply: false,\n    parseErrorLine: null,\n    parseErrorMessage: null,\n    blockingMessages: decision.messages,\n    blockingSeverity: 'error',\n  }\n}\n"],
+  "mappings": "AA6EO,SAAS,eAAe,SAAiB,MAA6B;AAC3E,QAAM,YAAY,cAAc,KAAK,OAAO;AAC5C,MAAI,WAAW;AACb,UAAM,SAAS,OAAO,SAAS,UAAU,CAAC,GAAG,EAAE;AAC/C,QAAI,OAAO,SAAS,MAAM,KAAK,SAAS,EAAG,QAAO;AAAA,EACpD;AACA,QAAM,gBAAgB,kBAAkB,KAAK,OAAO;AACpD,MAAI,eAAe;AACjB,UAAM,SAAS,OAAO,SAAS,cAAc,CAAC,GAAG,EAAE;AACnD,QAAI,CAAC,OAAO,SAAS,MAAM,KAAK,SAAS,EAAG,QAAO;AACnD,QAAI,OAAO;AACX,aAAS,QAAQ,GAAG,QAAQ,KAAK,IAAI,QAAQ,KAAK,MAAM,GAAG,SAAS,GAAG;AACrE,UAAI,KAAK,KAAK,MAAM,KAAM,SAAQ;AAAA,IACpC;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,SAAS,sBACd,OACoC;AACpC,QAAM,EAAE,WAAW,YAAY,iBAAiB,cAAc,IAAI;AAElE,MAAI,eAAe,UAAa,cAAc,YAAY;AACxD,WAAO,EAAE,IAAI,OAAO,QAAQ,YAAY;AAAA,EAC1C;AAEA,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,SAAS;AAAA,EAC/B,SAAS,OAAO;AACd,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,WAAO,EAAE,IAAI,OAAO,QAAQ,cAAc,SAAS,MAAM,eAAe,SAAS,SAAS,EAAE;AAAA,EAC9F;AAEA,QAAM,mBAAmB,gBAAgB,MAAM;AAC/C,MAAI,CAAC,iBAAiB,IAAI;AACxB,WAAO,EAAE,IAAI,OAAO,QAAQ,eAAe,UAAU,iBAAiB,SAAS;AAAA,EACjF;AAEA,QAAM,cAAc,cAAc,iBAAiB,UAAU;AAC7D,MAAI,YAAY,SAAS,GAAG;AAC1B,WAAO,EAAE,IAAI,OAAO,QAAQ,cAAc,UAAU,YAAY;AAAA,EAClE;AAEA,SAAO,EAAE,IAAI,MAAM,YAAY,iBAAiB,WAAW;AAC7D;AAYO,SAAS,sBACd,UACqB;AACrB,MAAI,SAAS,IAAI;AACf,WAAO;AAAA,MACL,OAAO;AAAA,MACP,UAAU;AAAA,MACV,gBAAgB;AAAA,MAChB,mBAAmB;AAAA,MACnB,kBAAkB,CAAC;AAAA,MACnB,kBAAkB;AAAA,IACpB;AAAA,EACF;AACA,MAAI,SAAS,WAAW,aAAa;AACnC,WAAO;AAAA,MACL,OAAO;AAAA,MACP,UAAU;AAAA,MACV,gBAAgB;AAAA,MAChB,mBAAmB;AAAA,MACnB,kBAAkB,CAAC;AAAA,MACnB,kBAAkB;AAAA,IACpB;AAAA,EACF;AACA,MAAI,SAAS,WAAW,cAAc;AACpC,WAAO;AAAA,MACL,OAAO;AAAA,MACP,UAAU;AAAA,MACV,gBAAgB,SAAS;AAAA,MACzB,mBAAmB,SAAS;AAAA,MAC5B,kBAAkB,CAAC,SAAS,OAAO;AAAA,MACnC,kBAAkB;AAAA,IACpB;AAAA,EACF;AACA,SAAO;AAAA,IACL,OAAO;AAAA,IACP,UAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,mBAAmB;AAAA,IACnB,kBAAkB,SAAS;AAAA,IAC3B,kBAAkB;AAAA,EACpB;AACF;",
+  "names": []
+}

package/dist/modules/workflows/lib/collect-validation-issues.js

@@ -0,0 +1,164 @@
+import {
+  collectFlowLogicWarnings
+} from "./flow-logic-warnings.js";
+const FLOW_LOGIC_MESSAGE_KEYS = {
+  errorRouteUnknownSource: {
+    key: "workflows.visualEditor.problems.errorRouteUnknownSource",
+    fallback: 'Error route "{transitionId}" starts at unknown step "{stepId}"'
+  },
+  errorRouteUnknownTarget: {
+    key: "workflows.visualEditor.problems.errorRouteUnknownTarget",
+    fallback: 'Error route "{transitionId}" targets unknown step "{stepId}"'
+  },
+  errorRouteDuplicateTarget: {
+    key: "workflows.visualEditor.problems.errorRouteDuplicateTarget",
+    fallback: 'Error route "{transitionId}" shares its source and target with a normal route; the engine cannot tell them apart'
+  },
+  branchingWithoutOtherwise: {
+    key: "workflows.visualEditor.problems.branchingWithoutOtherwise",
+    fallback: 'Branching step "{stepId}" has no unconditioned route; add an otherwise route so the workflow cannot stall when no condition matches'
+  },
+  duplicateBranchingCase: {
+    key: "workflows.visualEditor.problems.duplicateBranchingCase",
+    fallback: 'Branching step "{stepId}" has more than one route for {caseValue}; only the highest-priority one can ever match'
+  },
+  conditionUnknownPath: {
+    key: "workflows.visualEditor.problems.conditionUnknownPath",
+    fallback: 'Condition path "{path}" is not provided by any earlier step, trigger, or input'
+  },
+  unmappedStepConfig: {
+    key: "workflows.visualEditor.problems.unmappedStepConfig",
+    fallback: 'Step "{stepId}" keeps unmapped configuration from an earlier type change ({keys}); it is stored but no longer executed'
+  },
+  taskDecisionUnknownRoute: {
+    key: "workflows.visualEditor.problems.taskDecisionUnknownRoute",
+    fallback: 'Decision "{decisionId}" on task "{stepId}" points at route "{transitionId}", which no longer leaves this step'
+  },
+  taskDecisionDuplicateId: {
+    key: "workflows.visualEditor.problems.taskDecisionDuplicateId",
+    fallback: 'Task "{stepId}" has more than one decision with the id "{decisionId}"; only one of them can ever be recorded'
+  },
+  taskWithoutOwner: {
+    key: "workflows.visualEditor.problems.taskWithoutOwner",
+    fallback: 'Task "{stepId}" names neither an assignee nor a role queue, so nobody can complete it and the workflow will stall there'
+  },
+  taskPortalWithoutBinding: {
+    key: "workflows.visualEditor.problems.taskPortalWithoutBinding",
+    fallback: 'Task "{stepId}" is addressed to a customer but is about no record; a portal task is only visible to the customer whose record it is linked to, so nobody in the portal would see it'
+  },
+  taskBindingUnknownEntityType: {
+    key: "workflows.visualEditor.problems.taskBindingUnknownEntityType",
+    fallback: 'Task "{stepId}" is about "{entityType}", which is not a known record type; the task would be hidden from its own assignee'
+  },
+  outcomeRouteUnknownKind: {
+    key: "workflows.visualEditor.problems.outcomeRouteUnknownKind",
+    fallback: 'Outcome route "{transitionId}" claims outcome "{outcomeKind}", which the platform does not define; it can never be selected'
+  },
+  outcomeRouteDuplicateKind: {
+    key: "workflows.visualEditor.problems.outcomeRouteDuplicateKind",
+    fallback: 'Agent step "{stepId}" has more than one route for the "{outcomeKind}" outcome; only the highest-priority one can ever be taken'
+  },
+  taskBindingAssigneeCannotView: {
+    key: "workflows.visualEditor.problems.taskBindingAssigneeCannotView",
+    fallback: 'Task "{stepId}" is about "{entityType}", which {roles} may not view; assignees holding only those roles would not see the task'
+  }
+};
+function interpolateFallback(template, params) {
+  return template.replace(/\{(\w+)\}/g, (match, name) => params[name] ?? match);
+}
+const defaultTranslator = (_key, fallback, params) => interpolateFallback(fallback, params);
+function resolveNodeLabel(node) {
+  if (!node) return void 0;
+  const label = node.data?.label;
+  return typeof label === "string" && label.length > 0 ? label : node.id;
+}
+function mapZodPathToGraph(path, nodes, edges) {
+  const [collection, index] = path;
+  if (typeof index !== "number") return {};
+  if (collection === "steps") {
+    const node = nodes[index];
+    if (!node) return {};
+    return { nodeId: node.id, nodeLabel: resolveNodeLabel(node) };
+  }
+  if (collection === "transitions") {
+    const edge = edges[index];
+    if (!edge) return {};
+    return { edgeId: edge.id };
+  }
+  return {};
+}
+function formatZodPath(path) {
+  return path.map((segment) => String(segment)).join(".");
+}
+function collectValidationIssues(input) {
+  const {
+    graphErrors,
+    zodIssues = [],
+    configWarnings = [],
+    nodes,
+    edges,
+    definition,
+    ledger,
+    knownEntityIds = null,
+    assigneeEntityAccess = null,
+    translate = defaultTranslator
+  } = input;
+  const graphIssues = graphErrors.map((error, index) => ({
+    id: `graph-${index}`,
+    severity: error.type,
+    message: error.message,
+    ...error.nodeId ? { nodeId: error.nodeId } : {},
+    ...error.edgeId ? { edgeId: error.edgeId } : {},
+    ...error.nodeId ? { nodeLabel: resolveNodeLabel(nodes.find((node) => node.id === error.nodeId)) } : {}
+  }));
+  const schemaIssues = zodIssues.map((issue, index) => {
+    const pathText = formatZodPath(issue.path);
+    return {
+      id: `schema-${index}`,
+      severity: "error",
+      message: pathText ? `${pathText} - ${issue.message}` : issue.message,
+      ...mapZodPathToGraph(issue.path, nodes, edges)
+    };
+  });
+  const configWarningIssues = configWarnings.map((issue, index) => {
+    const pathText = formatZodPath(issue.path);
+    return {
+      id: `config-${index}`,
+      severity: "warning",
+      message: pathText ? `${pathText} - ${issue.message}` : issue.message,
+      ...mapZodPathToGraph(issue.path, nodes, edges)
+    };
+  });
+  const flowLogicIssues = collectFlowLogicWarnings(definition, {
+    ledger,
+    knownEntityIds,
+    assigneeEntityAccess
+  }).map((warning, index) => {
+    const message = FLOW_LOGIC_MESSAGE_KEYS[warning.code];
+    return {
+      id: `flow-${warning.code}-${index}`,
+      severity: warning.severity ?? "warning",
+      message: translate(message.key, message.fallback, warning.params),
+      ...mapZodPathToGraph(warning.path, nodes, edges)
+    };
+  });
+  const all = [...graphIssues, ...schemaIssues, ...configWarningIssues, ...flowLogicIssues];
+  const errors = all.filter((issue) => issue.severity === "error");
+  const warnings = all.filter((issue) => issue.severity === "warning");
+  return [...errors, ...warnings];
+}
+function countIssuesBySeverity(issues) {
+  let errors = 0;
+  let warnings = 0;
+  for (const issue of issues) {
+    if (issue.severity === "error") errors += 1;
+    else warnings += 1;
+  }
+  return { errors, warnings };
+}
+export {
+  FLOW_LOGIC_MESSAGE_KEYS,
+  collectValidationIssues,
+  countIssuesBySeverity
+};
+//# sourceMappingURL=collect-validation-issues.js.map

package/dist/modules/workflows/lib/collect-validation-issues.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/collect-validation-issues.ts"],
+  "sourcesContent": ["import type { Node, Edge } from '@xyflow/react'\nimport type { ValidationError } from './graph-utils'\nimport type { ContextLedger } from './context-ledger'\nimport {\n  collectFlowLogicWarnings,\n  type FlowLogicDefinition,\n  type FlowLogicWarningCode,\n  type TaskAssigneeEntityAccess,\n} from './flow-logic-warnings'\n\nexport type WorkflowValidationIssueSeverity = 'error' | 'warning'\n\nexport interface WorkflowValidationIssue {\n  id: string\n  severity: WorkflowValidationIssueSeverity\n  message: string\n  nodeId?: string\n  edgeId?: string\n  nodeLabel?: string\n}\n\nexport interface ZodIssueLike {\n  path: Array<string | number | symbol>\n  message: string\n}\n\n/**\n * Message keys for the Phase 3a flow-logic warnings. English fallbacks live with\n * the translator so a caller without an i18n dictionary still gets readable\n * text.\n */\nexport const FLOW_LOGIC_MESSAGE_KEYS: Record<FlowLogicWarningCode, { key: string; fallback: string }> = {\n  errorRouteUnknownSource: {\n    key: 'workflows.visualEditor.problems.errorRouteUnknownSource',\n    fallback: 'Error route \"{transitionId}\" starts at unknown step \"{stepId}\"',\n  },\n  errorRouteUnknownTarget: {\n    key: 'workflows.visualEditor.problems.errorRouteUnknownTarget',\n    fallback: 'Error route \"{transitionId}\" targets unknown step \"{stepId}\"',\n  },\n  errorRouteDuplicateTarget: {\n    key: 'workflows.visualEditor.problems.errorRouteDuplicateTarget',\n    fallback: 'Error route \"{transitionId}\" shares its source and target with a normal route; the engine cannot tell them apart',\n  },\n  branchingWithoutOtherwise: {\n    key: 'workflows.visualEditor.problems.branchingWithoutOtherwise',\n    fallback: 'Branching step \"{stepId}\" has no unconditioned route; add an otherwise route so the workflow cannot stall when no condition matches',\n  },\n  duplicateBranchingCase: {\n    key: 'workflows.visualEditor.problems.duplicateBranchingCase',\n    fallback: 'Branching step \"{stepId}\" has more than one route for {caseValue}; only the highest-priority one can ever match',\n  },\n  conditionUnknownPath: {\n    key: 'workflows.visualEditor.problems.conditionUnknownPath',\n    fallback: 'Condition path \"{path}\" is not provided by any earlier step, trigger, or input',\n  },\n  unmappedStepConfig: {\n    key: 'workflows.visualEditor.problems.unmappedStepConfig',\n    fallback: 'Step \"{stepId}\" keeps unmapped configuration from an earlier type change ({keys}); it is stored but no longer executed',\n  },\n  taskDecisionUnknownRoute: {\n    key: 'workflows.visualEditor.problems.taskDecisionUnknownRoute',\n    fallback: 'Decision \"{decisionId}\" on task \"{stepId}\" points at route \"{transitionId}\", which no longer leaves this step',\n  },\n  taskDecisionDuplicateId: {\n    key: 'workflows.visualEditor.problems.taskDecisionDuplicateId',\n    fallback: 'Task \"{stepId}\" has more than one decision with the id \"{decisionId}\"; only one of them can ever be recorded',\n  },\n  taskWithoutOwner: {\n    key: 'workflows.visualEditor.problems.taskWithoutOwner',\n    fallback: 'Task \"{stepId}\" names neither an assignee nor a role queue, so nobody can complete it and the workflow will stall there',\n  },\n  taskPortalWithoutBinding: {\n    key: 'workflows.visualEditor.problems.taskPortalWithoutBinding',\n    fallback: 'Task \"{stepId}\" is addressed to a customer but is about no record; a portal task is only visible to the customer whose record it is linked to, so nobody in the portal would see it',\n  },\n  taskBindingUnknownEntityType: {\n    key: 'workflows.visualEditor.problems.taskBindingUnknownEntityType',\n    fallback: 'Task \"{stepId}\" is about \"{entityType}\", which is not a known record type; the task would be hidden from its own assignee',\n  },\n  outcomeRouteUnknownKind: {\n    key: 'workflows.visualEditor.problems.outcomeRouteUnknownKind',\n    fallback: 'Outcome route \"{transitionId}\" claims outcome \"{outcomeKind}\", which the platform does not define; it can never be selected',\n  },\n  outcomeRouteDuplicateKind: {\n    key: 'workflows.visualEditor.problems.outcomeRouteDuplicateKind',\n    fallback: 'Agent step \"{stepId}\" has more than one route for the \"{outcomeKind}\" outcome; only the highest-priority one can ever be taken',\n  },\n  taskBindingAssigneeCannotView: {\n    key: 'workflows.visualEditor.problems.taskBindingAssigneeCannotView',\n    fallback: 'Task \"{stepId}\" is about \"{entityType}\", which {roles} may not view; assignees holding only those roles would not see the task',\n  },\n}\n\nexport type WorkflowIssueTranslator = (\n  key: string,\n  fallback: string,\n  params: Record<string, string>,\n) => string\n\nfunction interpolateFallback(template: string, params: Record<string, string>): string {\n  return template.replace(/\\{(\\w+)\\}/g, (match, name: string) => params[name] ?? match)\n}\n\nconst defaultTranslator: WorkflowIssueTranslator = (_key, fallback, params) =>\n  interpolateFallback(fallback, params)\n\nexport interface CollectValidationIssuesInput {\n  graphErrors: ValidationError[]\n  zodIssues?: ZodIssueLike[]\n  configWarnings?: ZodIssueLike[]\n  nodes: Node[]\n  edges: Edge[]\n  /**\n   * Definition JSON for the Phase 3a checks (error routes, branching routes,\n   * condition paths). Omit it and only the legacy channels run.\n   */\n  definition?: FlowLogicDefinition | null\n  /** Context ledger enabling the condition-path resolution check. */\n  ledger?: ContextLedger\n  /**\n   * Generated entity ids that exist. Without it the unknown-binding check falls\n   * back to a shape test rather than flagging every id it cannot enumerate.\n   */\n  knownEntityIds?: ReadonlySet<string> | null\n  /** Tenant role features + entity view requirements, when the caller has them. */\n  assigneeEntityAccess?: TaskAssigneeEntityAccess | null\n  translate?: WorkflowIssueTranslator\n}\n\nfunction resolveNodeLabel(node: Node | undefined): string | undefined {\n  if (!node) return undefined\n  const label = node.data?.label\n  return typeof label === 'string' && label.length > 0 ? label : node.id\n}\n\nfunction mapZodPathToGraph(\n  path: Array<string | number | symbol>,\n  nodes: Node[],\n  edges: Edge[],\n): { nodeId?: string; edgeId?: string; nodeLabel?: string } {\n  const [collection, index] = path\n  if (typeof index !== 'number') return {}\n  if (collection === 'steps') {\n    const node = nodes[index]\n    if (!node) return {}\n    return { nodeId: node.id, nodeLabel: resolveNodeLabel(node) }\n  }\n  if (collection === 'transitions') {\n    const edge = edges[index]\n    if (!edge) return {}\n    return { edgeId: edge.id }\n  }\n  return {}\n}\n\nfunction formatZodPath(path: Array<string | number | symbol>): string {\n  return path.map((segment) => String(segment)).join('.')\n}\n\nexport function collectValidationIssues(input: CollectValidationIssuesInput): WorkflowValidationIssue[] {\n  const {\n    graphErrors,\n    zodIssues = [],\n    configWarnings = [],\n    nodes,\n    edges,\n    definition,\n    ledger,\n    knownEntityIds = null,\n    assigneeEntityAccess = null,\n    translate = defaultTranslator,\n  } = input\n\n  const graphIssues: WorkflowValidationIssue[] = graphErrors.map((error, index) => ({\n    id: `graph-${index}`,\n    severity: error.type,\n    message: error.message,\n    ...(error.nodeId ? { nodeId: error.nodeId } : {}),\n    ...(error.edgeId ? { edgeId: error.edgeId } : {}),\n    ...(error.nodeId\n      ? { nodeLabel: resolveNodeLabel(nodes.find((node) => node.id === error.nodeId)) }\n      : {}),\n  }))\n\n  const schemaIssues: WorkflowValidationIssue[] = zodIssues.map((issue, index) => {\n    const pathText = formatZodPath(issue.path)\n    return {\n      id: `schema-${index}`,\n      severity: 'error',\n      message: pathText ? `${pathText} - ${issue.message}` : issue.message,\n      ...mapZodPathToGraph(issue.path, nodes, edges),\n    }\n  })\n\n  const configWarningIssues: WorkflowValidationIssue[] = configWarnings.map((issue, index) => {\n    const pathText = formatZodPath(issue.path)\n    return {\n      id: `config-${index}`,\n      severity: 'warning',\n      message: pathText ? `${pathText} - ${issue.message}` : issue.message,\n      ...mapZodPathToGraph(issue.path, nodes, edges),\n    }\n  })\n\n  // Phase 3a flow-logic + ledger checks default to WARNINGS: flow logic is\n  // transition sugar and a path a later edit will provide must never make the\n  // definition unsaveable. The \u00A76.4 task checks opt into `error` because they\n  // describe a step the engine can never advance past \u2014 the same class as the\n  // structural problems `graphErrors` carries.\n  const flowLogicIssues: WorkflowValidationIssue[] = collectFlowLogicWarnings(definition, {\n    ledger,\n    knownEntityIds,\n    assigneeEntityAccess,\n  }).map((warning, index) => {\n    const message = FLOW_LOGIC_MESSAGE_KEYS[warning.code]\n    return {\n      id: `flow-${warning.code}-${index}`,\n      severity: warning.severity ?? 'warning',\n      message: translate(message.key, message.fallback, warning.params),\n      ...mapZodPathToGraph(warning.path, nodes, edges),\n    }\n  })\n\n  const all = [...graphIssues, ...schemaIssues, ...configWarningIssues, ...flowLogicIssues]\n  const errors = all.filter((issue) => issue.severity === 'error')\n  const warnings = all.filter((issue) => issue.severity === 'warning')\n  return [...errors, ...warnings]\n}\n\nexport function countIssuesBySeverity(issues: WorkflowValidationIssue[]): { errors: number; warnings: number } {\n  let errors = 0\n  let warnings = 0\n  for (const issue of issues) {\n    if (issue.severity === 'error') errors += 1\n    else warnings += 1\n  }\n  return { errors, warnings }\n}\n"],
+  "mappings": "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",
+  "names": []
+}