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

package/dist/modules/workflows/lib/definition-json-locations.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/definition-json-locations.ts"],
+  "sourcesContent": ["/**\n * Workflows Module \u2014 Code-view issue locations (spec section 2.2, stage 2)\n *\n * Stage 2 is *\"two-way live sync with error squiggles that highlight the\n * corresponding node\"*. `collectValidationIssues` already carries `nodeId` /\n * `edgeId` on every issue, so the missing half is purely positional: WHERE in\n * the JSON text does the step or transition with that id live.\n *\n * The scan is a minimal JSON tokenizer rather than a regex over\n * `\"id\": \"<value>\"`, because the author is editing free text: a step id can\n * appear inside a `{{context.*}}` template, inside a transition's\n * `fromStepId`, or inside a note's markdown, and a regex would happily point\n * the squiggle at any of them. Tracking the container path is the only way to\n * mean \"the element of `steps` at index i\".\n *\n * PURE: no ORM, no DI, no React.\n */\n\nexport type JsonLineRange = {\n  /** 1-based, inclusive. */\n  startLine: number\n  /** 1-based, inclusive. */\n  endLine: number\n}\n\nexport type DefinitionJsonLocations = {\n  steps: Map<string, JsonLineRange>\n  transitions: Map<string, JsonLineRange>\n}\n\ntype ArrayElementRange = { index: number } & JsonLineRange\n\n/**\n * Line ranges of the elements of the top-level `steps` and `transitions`\n * arrays, by ARRAY INDEX. Ids are attached separately from the parsed document,\n * so a malformed id (missing, non-string, duplicated) cannot desynchronise the\n * scan.\n */\nfunction scanTopLevelArrayElements(text: string): {\n  steps: ArrayElementRange[]\n  transitions: ArrayElementRange[]\n} {\n  const steps: ArrayElementRange[] = []\n  const transitions: ArrayElementRange[] = []\n\n  let line = 1\n  let inString = false\n  let escaped = false\n  // Depth 1 is the document object. A tracked array's elements sit at depth 3.\n  let depth = 0\n  let pendingKey: string | null = null\n  let currentStringStart = -1\n  let trackedArray: 'steps' | 'transitions' | null = null\n  let trackedArrayDepth = -1\n  let elementIndex = 0\n  let elementStartLine = -1\n  let elementDepth = -1\n\n  for (let position = 0; position < text.length; position += 1) {\n    const char = text[position]\n\n    if (char === '\\n') {\n      line += 1\n      // A newline cannot appear inside a valid JSON string literal, so this\n      // also self-heals if the author is mid-edit.\n      inString = false\n      escaped = false\n      continue\n    }\n\n    if (inString) {\n      if (escaped) {\n        escaped = false\n      } else if (char === '\\\\') {\n        escaped = true\n      } else if (char === '\"') {\n        inString = false\n        const literal = text.slice(currentStringStart, position)\n        // A string immediately followed by `:` is an object key.\n        let lookahead = position + 1\n        while (lookahead < text.length && /\\s/.test(text[lookahead])) lookahead += 1\n        if (text[lookahead] === ':') pendingKey = literal\n      }\n      continue\n    }\n\n    if (char === '\"') {\n      inString = true\n      currentStringStart = position + 1\n      continue\n    }\n\n    if (char === '[') {\n      if (depth === 1 && (pendingKey === 'steps' || pendingKey === 'transitions')) {\n        trackedArray = pendingKey\n        trackedArrayDepth = depth\n        elementIndex = 0\n      }\n      depth += 1\n      pendingKey = null\n      continue\n    }\n\n    if (char === '{') {\n      if (trackedArray && depth === trackedArrayDepth + 1 && elementStartLine === -1) {\n        elementStartLine = line\n        elementDepth = depth\n      }\n      depth += 1\n      pendingKey = null\n      continue\n    }\n\n    if (char === '}') {\n      depth -= 1\n      if (trackedArray && elementStartLine !== -1 && depth === elementDepth) {\n        const range: ArrayElementRange = { index: elementIndex, startLine: elementStartLine, endLine: line }\n        if (trackedArray === 'steps') steps.push(range)\n        else transitions.push(range)\n        elementIndex += 1\n        elementStartLine = -1\n        elementDepth = -1\n      }\n      pendingKey = null\n      continue\n    }\n\n    if (char === ']') {\n      depth -= 1\n      if (trackedArray && depth === trackedArrayDepth) {\n        trackedArray = null\n        trackedArrayDepth = -1\n        elementStartLine = -1\n        elementDepth = -1\n      }\n      pendingKey = null\n      continue\n    }\n  }\n\n  return { steps, transitions }\n}\n\nfunction readIdsAt(parsed: unknown, key: 'steps' | 'transitions', idField: string): Array<string | null> {\n  if (!parsed || typeof parsed !== 'object') return []\n  const collection = (parsed as Record<string, unknown>)[key]\n  if (!Array.isArray(collection)) return []\n  return collection.map((element) => {\n    if (!element || typeof element !== 'object') return null\n    const value = (element as Record<string, unknown>)[idField]\n    return typeof value === 'string' && value.length > 0 ? value : null\n  })\n}\n\n/**\n * Map every step id and transition id in `text` to its line range.\n *\n * `parsed` must be the result of `JSON.parse(text)`; the caller already has it\n * (it cannot decide whether to apply an edit without parsing) and passing it in\n * keeps this function from parsing the same text twice.\n */\nexport function locateDefinitionJsonEntities(text: string, parsed: unknown): DefinitionJsonLocations {\n  const scanned = scanTopLevelArrayElements(text)\n  const stepIds = readIdsAt(parsed, 'steps', 'stepId')\n  const transitionIds = readIdsAt(parsed, 'transitions', 'transitionId')\n\n  const steps = new Map<string, JsonLineRange>()\n  for (const element of scanned.steps) {\n    const id = stepIds[element.index]\n    // First occurrence wins: a duplicated id is itself a validation error, and\n    // pointing at the first one is more useful than at an arbitrary later one.\n    if (id && !steps.has(id)) steps.set(id, { startLine: element.startLine, endLine: element.endLine })\n  }\n\n  const transitions = new Map<string, JsonLineRange>()\n  for (const element of scanned.transitions) {\n    const id = transitionIds[element.index]\n    if (id && !transitions.has(id)) {\n      transitions.set(id, { startLine: element.startLine, endLine: element.endLine })\n    }\n  }\n\n  return { steps, transitions }\n}\n\nexport type LocatedIssue = {\n  issueId: string\n  severity: 'error' | 'warning'\n  line: number\n}\n\n/**\n * Project issues onto lines. An issue whose node/edge is not in the text (or\n * which names neither) is simply not located \u2014 the issue list still shows it,\n * it just gets no gutter marker rather than a marker on a wrong line.\n */\nexport function locateIssues(\n  issues: Array<{ id: string; severity: 'error' | 'warning'; nodeId?: string; edgeId?: string }>,\n  locations: DefinitionJsonLocations,\n): LocatedIssue[] {\n  const located: LocatedIssue[] = []\n  for (const issue of issues) {\n    const range = issue.nodeId\n      ? locations.steps.get(issue.nodeId)\n      : issue.edgeId\n        ? locations.transitions.get(issue.edgeId)\n        : undefined\n    if (!range) continue\n    located.push({ issueId: issue.id, severity: issue.severity, line: range.startLine })\n  }\n  return located\n}\n\n/**\n * Highest severity per line, so a line carrying both an error and a warning\n * paints as an error. Errors sort before warnings for the same reason.\n */\nexport function severityByLine(located: LocatedIssue[]): Map<number, 'error' | 'warning'> {\n  const byLine = new Map<number, 'error' | 'warning'>()\n  for (const issue of located) {\n    const existing = byLine.get(issue.line)\n    if (existing === 'error') continue\n    byLine.set(issue.line, issue.severity)\n  }\n  return byLine\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/lib/definition-payload.js

@@ -0,0 +1,31 @@
+import { writeEditorAnnotations } from "./editor-annotations.js";
+import { resolveRequiredEngineVersion } from "./engine-version.js";
+function buildDefinitionPayload({ graphDefinition, triggers, contextSchema, io, interpolation, errorHandler }) {
+  return {
+    ...graphDefinition,
+    triggers: triggers.length > 0 ? triggers : void 0,
+    contextSchema: contextSchema ?? void 0,
+    io: io ?? void 0,
+    interpolation: interpolation ?? void 0,
+    errorHandler: errorHandler ?? void 0
+  };
+}
+function buildMetadataPayload({ loadedMetadata, tags, category, icon, definition, annotations }) {
+  const base = annotations === void 0 ? loadedMetadata : writeEditorAnnotations(loadedMetadata, annotations);
+  const metadata = { ...base ?? {} };
+  if (category) metadata.category = category;
+  else delete metadata.category;
+  if (tags.length > 0) metadata.tags = [...tags];
+  else delete metadata.tags;
+  if (icon) metadata.icon = icon;
+  else delete metadata.icon;
+  const requiredEngineVersion = resolveRequiredEngineVersion(definition ?? null);
+  if (requiredEngineVersion > 1) metadata.minEngineVersion = requiredEngineVersion;
+  else delete metadata.minEngineVersion;
+  return Object.keys(metadata).length > 0 ? metadata : null;
+}
+export {
+  buildDefinitionPayload,
+  buildMetadataPayload
+};
+//# sourceMappingURL=definition-payload.js.map

package/dist/modules/workflows/lib/definition-payload.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/definition-payload.ts"],
+  "sourcesContent": ["/**\n * Pure payload builders for the visual editor's save and draft round trips.\n *\n * The editor rebuilds the definition from the graph and rebuilds metadata from\n * three edited fields on every save, so anything it does not explicitly carry\n * (the declared contextSchema, the sub-workflow io port contract, future\n * metadata.editor.* keys) would be silently dropped. These helpers centralize\n * that assembly: the definition payload re-attaches triggers, contextSchema,\n * and io next to the graph output, and the metadata payload spreads the\n * metadata object loaded from the server before overlaying the edited fields\n * so unknown keys survive load \u2192 save.\n */\n\nimport type {\n  WorkflowContextSchema,\n  WorkflowDefinitionData,\n  WorkflowDefinitionTrigger,\n  WorkflowIoContract,\n} from '../data/entities'\nimport type { WorkflowErrorHandlerConfig } from '../data/validators'\nimport { writeEditorAnnotations, type WorkflowEditorAnnotations } from './editor-annotations'\nimport { resolveRequiredEngineVersion, type EngineVersionedDefinition } from './engine-version'\nimport type { WorkflowInterpolationMode } from './interpolation-pipeline'\n\nexport type DefinitionPayloadInput = {\n  graphDefinition: WorkflowDefinitionData\n  triggers: WorkflowDefinitionTrigger[]\n  contextSchema?: WorkflowContextSchema | null\n  io?: WorkflowIoContract | null\n  interpolation?: WorkflowInterpolationMode | null\n  errorHandler?: WorkflowErrorHandlerConfig | null\n}\n\nexport function buildDefinitionPayload({ graphDefinition, triggers, contextSchema, io, interpolation, errorHandler }: DefinitionPayloadInput): WorkflowDefinitionData {\n  return {\n    ...graphDefinition,\n    triggers: triggers.length > 0 ? triggers : undefined,\n    contextSchema: contextSchema ?? undefined,\n    io: io ?? undefined,\n    interpolation: interpolation ?? undefined,\n    errorHandler: errorHandler ?? undefined,\n  }\n}\n\nexport type MetadataPayloadInput = {\n  loadedMetadata: Record<string, unknown> | null\n  tags: string[]\n  category: string\n  icon: string\n  /**\n   * Definition being saved. Used to stamp `minEngineVersion` when the graph\n   * contains a step or transition capability older engines cannot execute\n   * (spec section 5.8).\n   * Definitions that need nothing beyond the baseline keep no such key, so\n   * saving an existing workflow stays byte-identical.\n   */\n  definition?: EngineVersionedDefinition | null\n  /**\n   * Sticky notes and groups (spec section 4.5). The canvas owns them as nodes,\n   * so they are derived back out of the node array on every persistence path and\n   * written to `metadata.editor.annotations` here. Omitting the field leaves\n   * whatever the loaded metadata carried untouched, which is what keeps callers\n   * that never render a canvas (tests, migrations) byte-compatible.\n   */\n  annotations?: WorkflowEditorAnnotations | null\n}\n\nexport function buildMetadataPayload({ loadedMetadata, tags, category, icon, definition, annotations }: MetadataPayloadInput): Record<string, unknown> | null {\n  const base = annotations === undefined ? loadedMetadata : writeEditorAnnotations(loadedMetadata, annotations)\n  const metadata: Record<string, unknown> = { ...(base ?? {}) }\n  if (category) metadata.category = category\n  else delete metadata.category\n  if (tags.length > 0) metadata.tags = [...tags]\n  else delete metadata.tags\n  if (icon) metadata.icon = icon\n  else delete metadata.icon\n  const requiredEngineVersion = resolveRequiredEngineVersion(definition ?? null)\n  if (requiredEngineVersion > 1) metadata.minEngineVersion = requiredEngineVersion\n  else delete metadata.minEngineVersion\n  return Object.keys(metadata).length > 0 ? metadata : null\n}\n"],
+  "mappings": "AAoBA,SAAS,8BAA8D;AACvE,SAAS,oCAAoE;AAYtE,SAAS,uBAAuB,EAAE,iBAAiB,UAAU,eAAe,IAAI,eAAe,aAAa,GAAmD;AACpK,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU,SAAS,SAAS,IAAI,WAAW;AAAA,IAC3C,eAAe,iBAAiB;AAAA,IAChC,IAAI,MAAM;AAAA,IACV,eAAe,iBAAiB;AAAA,IAChC,cAAc,gBAAgB;AAAA,EAChC;AACF;AAyBO,SAAS,qBAAqB,EAAE,gBAAgB,MAAM,UAAU,MAAM,YAAY,YAAY,GAAyD;AAC5J,QAAM,OAAO,gBAAgB,SAAY,iBAAiB,uBAAuB,gBAAgB,WAAW;AAC5G,QAAM,WAAoC,EAAE,GAAI,QAAQ,CAAC,EAAG;AAC5D,MAAI,SAAU,UAAS,WAAW;AAAA,MAC7B,QAAO,SAAS;AACrB,MAAI,KAAK,SAAS,EAAG,UAAS,OAAO,CAAC,GAAG,IAAI;AAAA,MACxC,QAAO,SAAS;AACrB,MAAI,KAAM,UAAS,OAAO;AAAA,MACrB,QAAO,SAAS;AACrB,QAAM,wBAAwB,6BAA6B,cAAc,IAAI;AAC7E,MAAI,wBAAwB,EAAG,UAAS,mBAAmB;AAAA,MACtD,QAAO,SAAS;AACrB,SAAO,OAAO,KAAK,QAAQ,EAAE,SAAS,IAAI,WAAW;AACvD;",
+  "names": []
+}

package/dist/modules/workflows/lib/draft-restore.js

@@ -0,0 +1,49 @@
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isServerDraftEligible(definitionId) {
+  if (!definitionId) return false;
+  return UUID_PATTERN.test(definitionId);
+}
+function stableSerializeValue(value) {
+  if (value === void 0) return void 0;
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value)) {
+    const items = value.map((item) => stableSerializeValue(item) ?? "null");
+    return `[${items.join(",")}]`;
+  }
+  const record = value;
+  const entries = Object.keys(record).sort((left, right) => left.localeCompare(right)).map((key) => {
+    const serialized = stableSerializeValue(record[key]);
+    return serialized === void 0 ? void 0 : `${JSON.stringify(key)}:${serialized}`;
+  }).filter((entry) => entry !== void 0);
+  return `{${entries.join(",")}}`;
+}
+function stableSerializeDefinition(value) {
+  return stableSerializeValue(value) ?? "null";
+}
+function timestampsDiffer(base, current) {
+  if (!base || !current) return false;
+  const baseMs = Date.parse(base);
+  const currentMs = Date.parse(current);
+  if (Number.isNaN(baseMs) || Number.isNaN(currentMs)) return base !== current;
+  return baseMs !== currentMs;
+}
+function decideDraftRestore(input) {
+  if (input.draftDefinition === null || input.draftDefinition === void 0) {
+    return { offerRestore: false };
+  }
+  const draftSerialized = stableSerializeDefinition(input.draftDefinition);
+  const loadedSerialized = stableSerializeDefinition(input.loadedDefinition);
+  if (draftSerialized === loadedSerialized) {
+    return { offerRestore: false };
+  }
+  return {
+    offerRestore: true,
+    baseMismatch: timestampsDiffer(input.draftBaseUpdatedAt, input.definitionUpdatedAt)
+  };
+}
+export {
+  decideDraftRestore,
+  isServerDraftEligible,
+  stableSerializeDefinition
+};
+//# sourceMappingURL=draft-restore.js.map

package/dist/modules/workflows/lib/draft-restore.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/draft-restore.ts"],
+  "sourcesContent": ["/**\n * Draft restore decision helpers (spec \u00A74.7 save model, Step 8.3).\n *\n * Pure logic behind the visual editor's per-user draft layer: whether a\n * definition id can have a server draft at all, a stable (key-order\n * insensitive) serialization used to compare editor state against persisted\n * drafts, and the restore-banner decision (draft exists? differs from the\n * loaded definition? was it based on an older definition version?).\n */\n\nconst UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\n\nexport function isServerDraftEligible(definitionId: string | null | undefined): boolean {\n  if (!definitionId) return false\n  return UUID_PATTERN.test(definitionId)\n}\n\nfunction stableSerializeValue(value: unknown): string | undefined {\n  if (value === undefined) return undefined\n  if (value === null || typeof value !== 'object') return JSON.stringify(value)\n  if (Array.isArray(value)) {\n    const items = value.map((item) => stableSerializeValue(item) ?? 'null')\n    return `[${items.join(',')}]`\n  }\n  const record = value as Record<string, unknown>\n  const entries = Object.keys(record)\n    .sort((left, right) => left.localeCompare(right))\n    .map((key) => {\n      const serialized = stableSerializeValue(record[key])\n      return serialized === undefined ? undefined : `${JSON.stringify(key)}:${serialized}`\n    })\n    .filter((entry): entry is string => entry !== undefined)\n  return `{${entries.join(',')}}`\n}\n\nexport function stableSerializeDefinition(value: unknown): string {\n  return stableSerializeValue(value) ?? 'null'\n}\n\nexport type DraftRestoreDecision =\n  | { offerRestore: false }\n  | { offerRestore: true; baseMismatch: boolean }\n\nexport type DraftRestoreInput = {\n  draftDefinition: unknown\n  draftBaseUpdatedAt: string | null\n  loadedDefinition: unknown\n  definitionUpdatedAt: string | null\n}\n\nfunction timestampsDiffer(base: string | null, current: string | null): boolean {\n  if (!base || !current) return false\n  const baseMs = Date.parse(base)\n  const currentMs = Date.parse(current)\n  if (Number.isNaN(baseMs) || Number.isNaN(currentMs)) return base !== current\n  return baseMs !== currentMs\n}\n\nexport function decideDraftRestore(input: DraftRestoreInput): DraftRestoreDecision {\n  if (input.draftDefinition === null || input.draftDefinition === undefined) {\n    return { offerRestore: false }\n  }\n  const draftSerialized = stableSerializeDefinition(input.draftDefinition)\n  const loadedSerialized = stableSerializeDefinition(input.loadedDefinition)\n  if (draftSerialized === loadedSerialized) {\n    return { offerRestore: false }\n  }\n  return {\n    offerRestore: true,\n    baseMismatch: timestampsDiffer(input.draftBaseUpdatedAt, input.definitionUpdatedAt),\n  }\n}\n"],
+  "mappings": "AAUA,MAAM,eAAe;AAEd,SAAS,sBAAsB,cAAkD;AACtF,MAAI,CAAC,aAAc,QAAO;AAC1B,SAAO,aAAa,KAAK,YAAY;AACvC;AAEA,SAAS,qBAAqB,OAAoC;AAChE,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO,KAAK,UAAU,KAAK;AAC5E,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,UAAM,QAAQ,MAAM,IAAI,CAAC,SAAS,qBAAqB,IAAI,KAAK,MAAM;AACtE,WAAO,IAAI,MAAM,KAAK,GAAG,CAAC;AAAA,EAC5B;AACA,QAAM,SAAS;AACf,QAAM,UAAU,OAAO,KAAK,MAAM,EAC/B,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC,EAC/C,IAAI,CAAC,QAAQ;AACZ,UAAM,aAAa,qBAAqB,OAAO,GAAG,CAAC;AACnD,WAAO,eAAe,SAAY,SAAY,GAAG,KAAK,UAAU,GAAG,CAAC,IAAI,UAAU;AAAA,EACpF,CAAC,EACA,OAAO,CAAC,UAA2B,UAAU,MAAS;AACzD,SAAO,IAAI,QAAQ,KAAK,GAAG,CAAC;AAC9B;AAEO,SAAS,0BAA0B,OAAwB;AAChE,SAAO,qBAAqB,KAAK,KAAK;AACxC;AAaA,SAAS,iBAAiB,MAAqB,SAAiC;AAC9E,MAAI,CAAC,QAAQ,CAAC,QAAS,QAAO;AAC9B,QAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,QAAM,YAAY,KAAK,MAAM,OAAO;AACpC,MAAI,OAAO,MAAM,MAAM,KAAK,OAAO,MAAM,SAAS,EAAG,QAAO,SAAS;AACrE,SAAO,WAAW;AACpB;AAEO,SAAS,mBAAmB,OAAgD;AACjF,MAAI,MAAM,oBAAoB,QAAQ,MAAM,oBAAoB,QAAW;AACzE,WAAO,EAAE,cAAc,MAAM;AAAA,EAC/B;AACA,QAAM,kBAAkB,0BAA0B,MAAM,eAAe;AACvE,QAAM,mBAAmB,0BAA0B,MAAM,gBAAgB;AACzE,MAAI,oBAAoB,kBAAkB;AACxC,WAAO,EAAE,cAAc,MAAM;AAAA,EAC/B;AACA,SAAO;AAAA,IACL,cAAc;AAAA,IACd,cAAc,iBAAiB,MAAM,oBAAoB,MAAM,mBAAmB;AAAA,EACpF;AACF;",
+  "names": []
+}

package/dist/modules/workflows/lib/dry-run.js

@@ -0,0 +1,106 @@
+function isDryRunInstance(instance) {
+  return instance?.isDryRun === true;
+}
+class WorkflowDryRunRefusalError extends Error {
+  constructor(activityType, reason, activityName) {
+    super(`[internal] dry run cannot simulate activity type ${activityType} (${reason})`);
+    this.activityType = activityType;
+    this.reason = reason;
+    this.activityName = activityName;
+    this.dryRunRefused = true;
+    this.name = "WorkflowDryRunRefusalError";
+  }
+}
+function isDryRunRefusal(error) {
+  if (!error || typeof error !== "object") return false;
+  return error.dryRunRefused === true;
+}
+const DRY_RUN_EVENT_TYPES = {
+  started: "DRY_RUN_STARTED",
+  activitySimulated: "ACTIVITY_SIMULATED",
+  activityRefused: "ACTIVITY_SIMULATION_REFUSED",
+  userTaskSimulated: "USER_TASK_SIMULATED",
+  businessRuleActionsSuppressed: "BUSINESS_RULE_ACTIONS_SUPPRESSED"
+};
+const asRecord = (value) => typeof value === "object" && value !== null ? value : {};
+const asText = (value, fallback) => typeof value === "string" && value.length > 0 ? value : fallback;
+function toIsoString(value) {
+  return value instanceof Date ? value.toISOString() : value;
+}
+function describeEvent(event) {
+  const data = asRecord(event.eventData);
+  switch (event.eventType) {
+    case DRY_RUN_EVENT_TYPES.activitySimulated:
+      return {
+        kind: "activity",
+        severity: "info",
+        subject: asText(data.activityType, "ACTIVITY"),
+        detail: {
+          activityName: data.activityName ?? null,
+          output: data.output ?? null
+        }
+      };
+    case DRY_RUN_EVENT_TYPES.activityRefused:
+      return {
+        kind: "refusal",
+        severity: "error",
+        subject: asText(data.activityType, "ACTIVITY"),
+        detail: { reason: asText(data.reason, "noMock") }
+      };
+    case DRY_RUN_EVENT_TYPES.userTaskSimulated:
+      return {
+        kind: "userTask",
+        severity: "warning",
+        subject: asText(data.taskName, "USER_TASK"),
+        detail: {
+          assignedTo: data.assignedTo ?? null,
+          assignedToRoles: data.assignedToRoles ?? null,
+          decisions: data.decisions ?? []
+        }
+      };
+    case DRY_RUN_EVENT_TYPES.businessRuleActionsSuppressed:
+      return {
+        kind: "businessRule",
+        severity: "warning",
+        subject: asText(data.ruleId, "BUSINESS_RULE"),
+        detail: { phase: asText(data.phase, "pre_transition") }
+      };
+    default:
+      return null;
+  }
+}
+function buildWouldDoReport(events) {
+  const decorated = [];
+  events.forEach((event, index) => {
+    const described = describeEvent(event);
+    if (!described) return;
+    decorated.push({
+      index,
+      entry: {
+        ...described,
+        id: event.id,
+        stepId: event.stepId ?? null,
+        occurredAt: toIsoString(event.occurredAt)
+      }
+    });
+  });
+  decorated.sort((left, right) => {
+    if (left.entry.occurredAt !== right.entry.occurredAt) {
+      return left.entry.occurredAt < right.entry.occurredAt ? -1 : 1;
+    }
+    return left.index - right.index;
+  });
+  const entries = decorated.map((item) => item.entry);
+  return {
+    entries,
+    stoppedByRefusal: entries.some((entry) => entry.kind === "refusal")
+  };
+}
+export {
+  DRY_RUN_EVENT_TYPES,
+  WorkflowDryRunRefusalError,
+  buildWouldDoReport,
+  isDryRunInstance,
+  isDryRunRefusal
+};
+//# sourceMappingURL=dry-run.js.map

package/dist/modules/workflows/lib/dry-run.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/dry-run.ts"],
+  "sourcesContent": ["/**\n * Workflows Module \u2014 Dry-run (spec section 8.2)\n *\n * A dry run is a REAL instance (`WorkflowInstance.isDryRun`) executed by the\n * ordinary engine loop with every effector replaced by its registry `mock`.\n * There is deliberately no second simulation path: a parallel interpreter would\n * drift from the engine and the report would stop being evidence about the\n * workflow that actually runs.\n *\n * This module is PURE \u2014 no ORM, no DI, no React \u2014 so the isolation rules and\n * the \"Would do\" report are unit-testable without a database.\n */\n\nimport type { WorkflowValidationIssueSeverity } from './collect-validation-issues'\n\n/**\n * The subset of `WorkflowInstance` every isolation decision reads. Taking the\n * shape rather than the entity keeps this module free of the ORM import and\n * lets the engine pass a branch-scoped view where it has one.\n */\nexport type DryRunAwareInstance = {\n  isDryRun?: boolean | null\n}\n\nexport function isDryRunInstance(instance: DryRunAwareInstance | null | undefined): boolean {\n  return instance?.isDryRun === true\n}\n\n/**\n * Raised when a dry run reaches an activity type that refuses simulation\n * (`mock: 'refuse'`) or declares no mock at all.\n *\n * Spec section 8.2: *\"`mock: 'refuse'` types stop the dry-run at that node with\n * an explicit marker.\"* A refusal is NOT an activity failure \u2014 nothing was\n * attempted \u2014 so it must never be routed down the step's error route or\n * absorbed by its `errorDirective`. `isDryRunRefusal` is what the failure paths\n * check to keep that promise, and it is structural (a marker property) for the\n * same reason `isRetryableError` is: the check must survive an error crossing a\n * module boundary.\n */\nexport class WorkflowDryRunRefusalError extends Error {\n  readonly dryRunRefused = true\n\n  constructor(\n    readonly activityType: string,\n    readonly reason: DryRunRefusalReason,\n    readonly activityName?: string,\n  ) {\n    super(`[internal] dry run cannot simulate activity type ${activityType} (${reason})`)\n    this.name = 'WorkflowDryRunRefusalError'\n  }\n}\n\nexport type DryRunRefusalReason = 'refused' | 'noMock'\n\nexport function isDryRunRefusal(error: unknown): error is WorkflowDryRunRefusalError {\n  if (!error || typeof error !== 'object') return false\n  return (error as { dryRunRefused?: unknown }).dryRunRefused === true\n}\n\n// ============================================================================\n// \"Would do\" report\n// ============================================================================\n\n/**\n * Event types a dry run writes in addition to the ordinary run log. They ride\n * the same `WorkflowEvent` table because the module's event-sourcing rule\n * already makes that the audit trail, and because the report then inherits the\n * run views' ordering, scoping and retention for free.\n */\nexport const DRY_RUN_EVENT_TYPES = {\n  started: 'DRY_RUN_STARTED',\n  activitySimulated: 'ACTIVITY_SIMULATED',\n  activityRefused: 'ACTIVITY_SIMULATION_REFUSED',\n  userTaskSimulated: 'USER_TASK_SIMULATED',\n  businessRuleActionsSuppressed: 'BUSINESS_RULE_ACTIONS_SUPPRESSED',\n} as const\n\nexport type DryRunEventType = typeof DRY_RUN_EVENT_TYPES[keyof typeof DRY_RUN_EVENT_TYPES]\n\nexport type WouldDoEntryKind =\n  | 'activity'\n  | 'refusal'\n  | 'userTask'\n  | 'businessRule'\n\nexport type WouldDoEntry = {\n  id: string\n  kind: WouldDoEntryKind\n  /** `error` marks the refusal that stopped the run; everything else is informational. */\n  severity: WorkflowValidationIssueSeverity | 'info'\n  stepId: string | null\n  occurredAt: string\n  /** Machine label \u2014 `SEND_EMAIL`, `INVOKE_AGENT`, `USER_TASK`, a rule id. */\n  subject: string\n  detail: Record<string, unknown>\n}\n\nexport type WouldDoSourceEvent = {\n  id: string\n  eventType: string\n  stepId?: string | null\n  occurredAt: string | Date\n  eventData?: Record<string, unknown> | null\n}\n\nexport type WouldDoReport = {\n  entries: WouldDoEntry[]\n  /** True once a refusal stopped the run \u2014 the report is then not the whole graph. */\n  stoppedByRefusal: boolean\n}\n\nconst asRecord = (value: unknown): Record<string, unknown> =>\n  typeof value === 'object' && value !== null ? (value as Record<string, unknown>) : {}\n\nconst asText = (value: unknown, fallback: string): string =>\n  typeof value === 'string' && value.length > 0 ? value : fallback\n\nfunction toIsoString(value: string | Date): string {\n  return value instanceof Date ? value.toISOString() : value\n}\n\nfunction describeEvent(event: WouldDoSourceEvent): Omit<WouldDoEntry, 'id' | 'stepId' | 'occurredAt'> | null {\n  const data = asRecord(event.eventData)\n  switch (event.eventType) {\n    case DRY_RUN_EVENT_TYPES.activitySimulated:\n      return {\n        kind: 'activity',\n        severity: 'info',\n        subject: asText(data.activityType, 'ACTIVITY'),\n        detail: {\n          activityName: data.activityName ?? null,\n          output: data.output ?? null,\n        },\n      }\n    case DRY_RUN_EVENT_TYPES.activityRefused:\n      return {\n        kind: 'refusal',\n        severity: 'error',\n        subject: asText(data.activityType, 'ACTIVITY'),\n        detail: { reason: asText(data.reason, 'noMock') },\n      }\n    case DRY_RUN_EVENT_TYPES.userTaskSimulated:\n      return {\n        kind: 'userTask',\n        severity: 'warning',\n        subject: asText(data.taskName, 'USER_TASK'),\n        detail: {\n          assignedTo: data.assignedTo ?? null,\n          assignedToRoles: data.assignedToRoles ?? null,\n          decisions: data.decisions ?? [],\n        },\n      }\n    case DRY_RUN_EVENT_TYPES.businessRuleActionsSuppressed:\n      return {\n        kind: 'businessRule',\n        severity: 'warning',\n        subject: asText(data.ruleId, 'BUSINESS_RULE'),\n        detail: { phase: asText(data.phase, 'pre_transition') },\n      }\n    default:\n      return null\n  }\n}\n\n/**\n * Build the ordered \"Would do\" report from a run's events.\n *\n * Callers pass events in ANY order; the report sorts by `occurredAt` and falls\n * back to the caller's order for ties (an activity and its refusal can share a\n * millisecond), which is why the sort is explicit and stable rather than a bare\n * `.sort()`.\n */\nexport function buildWouldDoReport(events: WouldDoSourceEvent[]): WouldDoReport {\n  const decorated: Array<{ entry: WouldDoEntry; index: number }> = []\n\n  events.forEach((event, index) => {\n    const described = describeEvent(event)\n    if (!described) return\n    decorated.push({\n      index,\n      entry: {\n        ...described,\n        id: event.id,\n        stepId: event.stepId ?? null,\n        occurredAt: toIsoString(event.occurredAt),\n      },\n    })\n  })\n\n  decorated.sort((left, right) => {\n    if (left.entry.occurredAt !== right.entry.occurredAt) {\n      return left.entry.occurredAt < right.entry.occurredAt ? -1 : 1\n    }\n    return left.index - right.index\n  })\n\n  const entries = decorated.map((item) => item.entry)\n  return {\n    entries,\n    stoppedByRefusal: entries.some((entry) => entry.kind === 'refusal'),\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/lib/duration.js

@@ -1,31 +1,76 @@
+const ISO_8601_DURATION_PATTERN = /^P(?=\d|T\d)(?:(\d+)Y)?(?:(\d+)M)?(?:(\d+)W)?(?:(\d+)D)?(?:T(?=\d)(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?$/;
+const SIMPLE_DURATION_PATTERN = /^(\d+)(d|h|m|s)$/;
+const MS_PER_SECOND = 1e3;
+const MS_PER_MINUTE = 60 * MS_PER_SECOND;
+const MS_PER_HOUR = 60 * MS_PER_MINUTE;
+const MS_PER_DAY = 24 * MS_PER_HOUR;
+function parseIso8601Duration(duration) {
+  const match = duration.match(ISO_8601_DURATION_PATTERN);
+  if (!match) return null;
+  return {
+    years: parseInt(match[1] || "0", 10),
+    months: parseInt(match[2] || "0", 10),
+    weeks: parseInt(match[3] || "0", 10),
+    days: parseInt(match[4] || "0", 10),
+    hours: parseInt(match[5] || "0", 10),
+    minutes: parseInt(match[6] || "0", 10),
+    seconds: parseInt(match[7] || "0", 10)
+  };
+}
+function addIso8601Duration(from, parts) {
+  const result = new Date(from.getTime());
+  if (parts.years) result.setFullYear(result.getFullYear() + parts.years);
+  if (parts.months) result.setMonth(result.getMonth() + parts.months);
+  const days = parts.weeks * 7 + parts.days;
+  if (days) result.setDate(result.getDate() + days);
+  const elapsedMs = parts.hours * MS_PER_HOUR + parts.minutes * MS_PER_MINUTE + parts.seconds * MS_PER_SECOND;
+  return elapsedMs ? new Date(result.getTime() + elapsedMs) : result;
+}
 function parseDuration(duration) {
-  const iso8601Regex = /P(?:(\d+)D)?(?:T(?:(\d+)H)?(?:(\d+)M)?(?:(\d+)S)?)?/;
-  const iso8601Match = duration.match(iso8601Regex);
-  if (iso8601Match && iso8601Match[0] === duration) {
-    const days = parseInt(iso8601Match[1] || "0");
-    const hours = parseInt(iso8601Match[2] || "0");
-    const minutes = parseInt(iso8601Match[3] || "0");
-    const seconds = parseInt(iso8601Match[4] || "0");
-    return days * 24 * 60 * 60 * 1e3 + hours * 60 * 60 * 1e3 + minutes * 60 * 1e3 + seconds * 1e3;
+  const parts = parseIso8601Duration(duration);
+  if (parts) {
+    if (parts.years || parts.months) {
+      throw new Error(
+        `Duration ${duration} uses years or months, which have no fixed length in milliseconds`
+      );
+    }
+    return (parts.weeks * 7 + parts.days) * MS_PER_DAY + parts.hours * MS_PER_HOUR + parts.minutes * MS_PER_MINUTE + parts.seconds * MS_PER_SECOND;
   }
-  const simpleRegex = /^(\d+)(d|h|m|s)$/;
-  const simpleMatch = duration.match(simpleRegex);
+  const simpleMatch = duration.match(SIMPLE_DURATION_PATTERN);
   if (simpleMatch) {
-    const value = parseInt(simpleMatch[1]);
-    const unit = simpleMatch[2];
-    switch (unit) {
+    const value = parseInt(simpleMatch[1], 10);
+    switch (simpleMatch[2]) {
       case "d":
-        return value * 24 * 60 * 60 * 1e3;
+        return value * MS_PER_DAY;
       case "h":
-        return value * 60 * 60 * 1e3;
+        return value * MS_PER_HOUR;
       case "m":
-        return value * 60 * 1e3;
+        return value * MS_PER_MINUTE;
       case "s":
-        return value * 1e3;
+        return value * MS_PER_SECOND;
     }
   }
   throw new Error(`Invalid duration format: ${duration}`);
 }
+function calculateDueDate(duration, from = /* @__PURE__ */ new Date()) {
+  const parts = parseIso8601Duration(duration);
+  if (parts) return addIso8601Duration(from, parts);
+  return new Date(from.getTime() + parseDuration(duration));
+}
+function calculateWaitDelayMs(config) {
+  if (config.until) {
+    const targetDate = new Date(config.until);
+    if (isNaN(targetDate.getTime())) {
+      throw new Error(`WAIT activity: invalid "until" datetime: ${config.until}`);
+    }
+    const delayMs = targetDate.getTime() - Date.now();
+    return Math.max(0, delayMs);
+  }
+  if (config.duration) {
+    return parseDuration(config.duration);
+  }
+  throw new Error('WAIT activity requires "duration" (e.g., "PT5M", "1h") or "until" (ISO 8601 datetime)');
+}
 function toTimeoutMs(value) {
   if (typeof value === "number") {
     return Number.isFinite(value) && value > 0 ? value : void 0;
@@ -45,7 +90,11 @@ function toTimeoutMs(value) {
   }
 }
 export {
+  addIso8601Duration,
+  calculateDueDate,
+  calculateWaitDelayMs,
   parseDuration,
+  parseIso8601Duration,
   toTimeoutMs
 };
 //# sourceMappingURL=duration.js.map

package/dist/modules/workflows/lib/duration.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/duration.ts"],
-  "sourcesContent": ["/**\n * Parse ISO 8601 duration to milliseconds\n *\n * Supports:\n * - ISO 8601: PT5M (5 minutes), PT1H (1 hour), P1D (1 day), P3D (3 days)\n * - Simple formats: 5m, 1h, 3d, 30s\n *\n * @param duration - Duration string\n * @returns Duration in milliseconds\n */\nexport function parseDuration(duration: string): number {\n  // Try ISO 8601 format first: P[n]DT[n]H[n]M[n]S\n  const iso8601Regex = /P(?:(\\d+)D)?(?:T(?:(\\d+)H)?(?:(\\d+)M)?(?:(\\d+)S)?)?/\n  const iso8601Match = duration.match(iso8601Regex)\n\n  if (iso8601Match && iso8601Match[0] === duration) {\n    const days = parseInt(iso8601Match[1] || '0')\n    const hours = parseInt(iso8601Match[2] || '0')\n    const minutes = parseInt(iso8601Match[3] || '0')\n    const seconds = parseInt(iso8601Match[4] || '0')\n\n    return (\n      days * 24 * 60 * 60 * 1000 +\n      hours * 60 * 60 * 1000 +\n      minutes * 60 * 1000 +\n      seconds * 1000\n    )\n  }\n\n  // Try simple format: 1d, 5h, 30m, 45s\n  const simpleRegex = /^(\\d+)(d|h|m|s)$/\n  const simpleMatch = duration.match(simpleRegex)\n\n  if (simpleMatch) {\n    const value = parseInt(simpleMatch[1])\n    const unit = simpleMatch[2]\n\n    switch (unit) {\n      case 'd':\n        return value * 24 * 60 * 60 * 1000\n      case 'h':\n        return value * 60 * 60 * 1000\n      case 'm':\n        return value * 60 * 1000\n      case 's':\n        return value * 1000\n    }\n  }\n\n  throw new Error(`Invalid duration format: ${duration}`)\n}\n\n/**\n * Normalize a timeout value to milliseconds\n *\n * Accepts every shape the activity editors and stored definitions carry:\n * - a millisecond number (30000)\n * - a millisecond string (\"30000\") \u2014 what the CrudForm activity editor writes,\n *   and what its own placeholder (\"PT30S or 30000\") tells the user to type\n * - a duration string (\"PT30S\", \"5m\")\n *\n * Returns undefined for an absent or unusable value rather than throwing, so a\n * malformed timeout never fails an activity that would otherwise succeed.\n *\n * @param value - Raw timeout value\n * @returns Milliseconds, or undefined when the value is absent or unusable\n */\nexport function toTimeoutMs(value: unknown): number | undefined {\n  if (typeof value === 'number') {\n    return Number.isFinite(value) && value > 0 ? value : undefined\n  }\n  if (typeof value !== 'string') return undefined\n\n  const trimmed = value.trim()\n  if (!trimmed) return undefined\n\n  if (/^\\d+$/.test(trimmed)) {\n    const milliseconds = Number(trimmed)\n    return milliseconds > 0 ? milliseconds : undefined\n  }\n\n  try {\n    const milliseconds = parseDuration(trimmed)\n    return Number.isFinite(milliseconds) && milliseconds > 0 ? milliseconds : undefined\n  } catch {\n    return undefined\n  }\n}\n"],
-  "mappings": "AAUO,SAAS,cAAc,UAA0B;AAEtD,QAAM,eAAe;AACrB,QAAM,eAAe,SAAS,MAAM,YAAY;AAEhD,MAAI,gBAAgB,aAAa,CAAC,MAAM,UAAU;AAChD,UAAM,OAAO,SAAS,aAAa,CAAC,KAAK,GAAG;AAC5C,UAAM,QAAQ,SAAS,aAAa,CAAC,KAAK,GAAG;AAC7C,UAAM,UAAU,SAAS,aAAa,CAAC,KAAK,GAAG;AAC/C,UAAM,UAAU,SAAS,aAAa,CAAC,KAAK,GAAG;AAE/C,WACE,OAAO,KAAK,KAAK,KAAK,MACtB,QAAQ,KAAK,KAAK,MAClB,UAAU,KAAK,MACf,UAAU;AAAA,EAEd;AAGA,QAAM,cAAc;AACpB,QAAM,cAAc,SAAS,MAAM,WAAW;AAE9C,MAAI,aAAa;AACf,UAAM,QAAQ,SAAS,YAAY,CAAC,CAAC;AACrC,UAAM,OAAO,YAAY,CAAC;AAE1B,YAAQ,MAAM;AAAA,MACZ,KAAK;AACH,eAAO,QAAQ,KAAK,KAAK,KAAK;AAAA,MAChC,KAAK;AACH,eAAO,QAAQ,KAAK,KAAK;AAAA,MAC3B,KAAK;AACH,eAAO,QAAQ,KAAK;AAAA,MACtB,KAAK;AACH,eAAO,QAAQ;AAAA,IACnB;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,4BAA4B,QAAQ,EAAE;AACxD;AAiBO,SAAS,YAAY,OAAoC;AAC9D,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,SAAS,KAAK,KAAK,QAAQ,IAAI,QAAQ;AAAA,EACvD;AACA,MAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,QAAM,UAAU,MAAM,KAAK;AAC3B,MAAI,CAAC,QAAS,QAAO;AAErB,MAAI,QAAQ,KAAK,OAAO,GAAG;AACzB,UAAM,eAAe,OAAO,OAAO;AACnC,WAAO,eAAe,IAAI,eAAe;AAAA,EAC3C;AAEA,MAAI;AACF,UAAM,eAAe,cAAc,OAAO;AAC1C,WAAO,OAAO,SAAS,YAAY,KAAK,eAAe,IAAI,eAAe;AAAA,EAC5E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;",
+  "sourcesContent": ["export type Iso8601DurationParts = {\n  years: number\n  months: number\n  weeks: number\n  days: number\n  hours: number\n  minutes: number\n  seconds: number\n}\n\n/**\n * Full ISO 8601 duration grammar: `P[nY][nM][nW][nD][T[nH][nM][nS]]`.\n *\n * The lookaheads reject the designator-only forms `P`, `PT` and `P1DT`, and the\n * anchors reject anything with trailing junk. `M` before `T` is months, `M`\n * after it is minutes \u2014 the distinction the hand-rolled parsers this replaces\n * could not make.\n */\nconst ISO_8601_DURATION_PATTERN =\n  /^P(?=\\d|T\\d)(?:(\\d+)Y)?(?:(\\d+)M)?(?:(\\d+)W)?(?:(\\d+)D)?(?:T(?=\\d)(?:(\\d+)H)?(?:(\\d+)M)?(?:(\\d+)S)?)?$/\n\nconst SIMPLE_DURATION_PATTERN = /^(\\d+)(d|h|m|s)$/\n\nconst MS_PER_SECOND = 1000\nconst MS_PER_MINUTE = 60 * MS_PER_SECOND\nconst MS_PER_HOUR = 60 * MS_PER_MINUTE\nconst MS_PER_DAY = 24 * MS_PER_HOUR\n\n/**\n * Parse an ISO 8601 duration into its calendar components.\n *\n * Pure and total: returns `null` for anything that is not a valid ISO 8601\n * duration, so callers decide how to surface the problem.\n *\n * @param duration - Duration string (e.g. \"PT30M\", \"P1W\", \"P1DT12H\")\n * @returns Parsed components, or `null` when the string is not ISO 8601\n */\nexport function parseIso8601Duration(duration: string): Iso8601DurationParts | null {\n  const match = duration.match(ISO_8601_DURATION_PATTERN)\n  if (!match) return null\n\n  return {\n    years: parseInt(match[1] || '0', 10),\n    months: parseInt(match[2] || '0', 10),\n    weeks: parseInt(match[3] || '0', 10),\n    days: parseInt(match[4] || '0', 10),\n    hours: parseInt(match[5] || '0', 10),\n    minutes: parseInt(match[6] || '0', 10),\n    seconds: parseInt(match[7] || '0', 10),\n  }\n}\n\n/**\n * Add an ISO 8601 duration to a date using calendar arithmetic.\n *\n * Years, months, weeks and days advance the calendar (so \"P1M\" lands on the\n * same day of the next month whatever its length), while hours, minutes and\n * seconds are added as elapsed time.\n *\n * @param from - Anchor date\n * @param parts - Parsed duration components\n * @returns A new date; `from` is never mutated\n */\nexport function addIso8601Duration(from: Date, parts: Iso8601DurationParts): Date {\n  const result = new Date(from.getTime())\n\n  if (parts.years) result.setFullYear(result.getFullYear() + parts.years)\n  if (parts.months) result.setMonth(result.getMonth() + parts.months)\n\n  const days = parts.weeks * 7 + parts.days\n  if (days) result.setDate(result.getDate() + days)\n\n  const elapsedMs =\n    parts.hours * MS_PER_HOUR + parts.minutes * MS_PER_MINUTE + parts.seconds * MS_PER_SECOND\n\n  return elapsedMs ? new Date(result.getTime() + elapsedMs) : result\n}\n\n/**\n * Parse a duration to milliseconds\n *\n * Supports:\n * - ISO 8601: PT30M (30 minutes), PT1H (1 hour), P1D (1 day), P1W (1 week), P1DT12H\n * - Simple formats: 5m, 1h, 3d, 30s\n *\n * Years and months are rejected here because they have no fixed millisecond\n * length \u2014 use `parseIso8601Duration` + `addIso8601Duration` when the duration\n * is anchored to a date.\n *\n * @param duration - Duration string\n * @returns Duration in milliseconds\n */\nexport function parseDuration(duration: string): number {\n  const parts = parseIso8601Duration(duration)\n\n  if (parts) {\n    if (parts.years || parts.months) {\n      throw new Error(\n        `Duration ${duration} uses years or months, which have no fixed length in milliseconds`\n      )\n    }\n\n    return (\n      (parts.weeks * 7 + parts.days) * MS_PER_DAY +\n      parts.hours * MS_PER_HOUR +\n      parts.minutes * MS_PER_MINUTE +\n      parts.seconds * MS_PER_SECOND\n    )\n  }\n\n  const simpleMatch = duration.match(SIMPLE_DURATION_PATTERN)\n\n  if (simpleMatch) {\n    const value = parseInt(simpleMatch[1], 10)\n\n    switch (simpleMatch[2]) {\n      case 'd':\n        return value * MS_PER_DAY\n      case 'h':\n        return value * MS_PER_HOUR\n      case 'm':\n        return value * MS_PER_MINUTE\n      case 's':\n        return value * MS_PER_SECOND\n    }\n  }\n\n  throw new Error(`Invalid duration format: ${duration}`)\n}\n\n/**\n * Resolve a deadline from a duration anchored to a point in time.\n *\n * Accepts every format `parseDuration` accepts plus the calendar-only ISO 8601\n * components (years, months), which are applied as calendar arithmetic. Throws\n * on an unparseable duration \u2014 a deadline the author got wrong must surface,\n * never quietly become some default.\n *\n * @param duration - Duration string (e.g. \"PT30M\", \"P3D\", \"P1DT12H\")\n * @param from - Anchor date, defaults to now\n * @returns The resolved deadline\n */\nexport function calculateDueDate(duration: string, from: Date = new Date()): Date {\n  const parts = parseIso8601Duration(duration)\n  if (parts) return addIso8601Duration(from, parts)\n\n  return new Date(from.getTime() + parseDuration(duration))\n}\n\nexport function calculateWaitDelayMs(config: { duration?: string; until?: string }): number {\n  if (config.until) {\n    const targetDate = new Date(config.until)\n    if (isNaN(targetDate.getTime())) {\n      throw new Error(`WAIT activity: invalid \"until\" datetime: ${config.until}`)\n    }\n    const delayMs = targetDate.getTime() - Date.now()\n    return Math.max(0, delayMs)\n  }\n\n  if (config.duration) {\n    return parseDuration(config.duration)\n  }\n\n  throw new Error('WAIT activity requires \"duration\" (e.g., \"PT5M\", \"1h\") or \"until\" (ISO 8601 datetime)')\n}\n\n/**\n * Normalize a timeout value to milliseconds\n *\n * Accepts every shape the activity editors and stored definitions carry:\n * - a millisecond number (30000)\n * - a millisecond string (\"30000\") \u2014 what the CrudForm activity editor writes,\n *   and what its own placeholder (\"PT30S or 30000\") tells the user to type\n * - a duration string (\"PT30S\", \"5m\")\n *\n * Returns undefined for an absent or unusable value rather than throwing, so a\n * malformed timeout never fails an activity that would otherwise succeed.\n *\n * @param value - Raw timeout value\n * @returns Milliseconds, or undefined when the value is absent or unusable\n */\nexport function toTimeoutMs(value: unknown): number | undefined {\n  if (typeof value === 'number') {\n    return Number.isFinite(value) && value > 0 ? value : undefined\n  }\n  if (typeof value !== 'string') return undefined\n\n  const trimmed = value.trim()\n  if (!trimmed) return undefined\n\n  if (/^\\d+$/.test(trimmed)) {\n    const milliseconds = Number(trimmed)\n    return milliseconds > 0 ? milliseconds : undefined\n  }\n\n  try {\n    const milliseconds = parseDuration(trimmed)\n    return Number.isFinite(milliseconds) && milliseconds > 0 ? milliseconds : undefined\n  } catch {\n    return undefined\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/workflows/lib/edge-reattachment.js

@@ -0,0 +1,79 @@
+import { graphToDefinition, validateWorkflowGraph } from "./graph-utils.js";
+import { isDataMappingEdge } from "./data-edge-mapping.js";
+import { ERROR_TRANSITION_KIND } from "./error-routing.js";
+import { SLA_BREACH_TRANSITION_KIND } from "./breach-routing.js";
+import { OUTCOME_TRANSITION_KIND } from "./outcome-routing.js";
+import { resolveEdgeRouteKind } from "./route-kinds.js";
+import { validateParallelForkJoin } from "../data/validators.js";
+const ERROR_ROUTE_SOURCE_NODE_TYPES = /* @__PURE__ */ new Set(["automated", "userTask", "subWorkflow", "invokeAgent"]);
+const SLA_BREACH_ROUTE_SOURCE_NODE_TYPES = /* @__PURE__ */ new Set(["userTask"]);
+const OUTCOME_ROUTE_SOURCE_NODE_TYPES = /* @__PURE__ */ new Set(["invokeAgent"]);
+const ROUTE_KIND_SOURCE_NODE_TYPES = {
+  [ERROR_TRANSITION_KIND]: ERROR_ROUTE_SOURCE_NODE_TYPES,
+  [SLA_BREACH_TRANSITION_KIND]: SLA_BREACH_ROUTE_SOURCE_NODE_TYPES,
+  [OUTCOME_TRANSITION_KIND]: OUTCOME_ROUTE_SOURCE_NODE_TYPES
+};
+function routeKindOfEdge(edge) {
+  const data = edge.data;
+  return resolveEdgeRouteKind(data?.kind, edge.sourceHandle);
+}
+function sameHandle(left, right) {
+  return (left || null) === (right || null);
+}
+function errorMessages(nodes, edges) {
+  return new Set(
+    validateWorkflowGraph(nodes, edges).filter((issue) => issue.type === "error").map((issue) => issue.message)
+  );
+}
+function forkJoinMessages(nodes, edges) {
+  return new Set(validateParallelForkJoin(graphToDefinition(nodes, edges)).map((issue) => issue.message));
+}
+function firstAddition(before, after) {
+  for (const message of after) {
+    if (!before.has(message)) return message;
+  }
+  return void 0;
+}
+function reattachWorkflowEdge(nodes, edges, edgeId, connection) {
+  const existing = edges.find((edge) => edge.id === edgeId);
+  if (!existing) return { ok: false, code: "unknownRoute" };
+  if (isDataMappingEdge(existing)) return { ok: false, code: "dataMappingRoute" };
+  const source = connection.source ?? null;
+  const target = connection.target ?? null;
+  if (!source || !target) return { ok: false, code: "incompleteConnection" };
+  const sourceNode = nodes.find((node) => node.id === source);
+  const targetNode = nodes.find((node) => node.id === target);
+  if (!sourceNode || !targetNode) return { ok: false, code: "unknownStep" };
+  if (source === target) return { ok: false, code: "selfLoop" };
+  const routeKind = routeKindOfEdge(existing);
+  const allowedSourceTypes = routeKind ? ROUTE_KIND_SOURCE_NODE_TYPES[routeKind.kind] : void 0;
+  if (allowedSourceTypes && !allowedSourceTypes.has(sourceNode.type ?? "")) {
+    return {
+      ok: false,
+      code: routeKind?.kind === ERROR_TRANSITION_KIND ? "errorHandleUnsupported" : "kindHandleUnsupported"
+    };
+  }
+  const sourceHandle = routeKind ? routeKind.resolveSourceHandle(existing.data ?? {}) : connection.sourceHandle ?? null;
+  const targetHandle = connection.targetHandle ?? null;
+  const duplicate = edges.some(
+    (edge) => edge.id !== edgeId && !isDataMappingEdge(edge) && edge.source === source && edge.target === target && sameHandle(edge.sourceHandle, sourceHandle) && sameHandle(edge.targetHandle, targetHandle)
+  );
+  if (duplicate) return { ok: false, code: "duplicateRoute" };
+  const nextEdge = {
+    ...existing,
+    source,
+    target,
+    sourceHandle,
+    targetHandle
+  };
+  const nextEdges = edges.map((edge) => edge.id === edgeId ? nextEdge : edge);
+  const newGraphError = firstAddition(errorMessages(nodes, edges), errorMessages(nodes, nextEdges));
+  if (newGraphError) return { ok: false, code: "graphInvalid", detail: newGraphError };
+  const newForkJoinIssue = firstAddition(forkJoinMessages(nodes, edges), forkJoinMessages(nodes, nextEdges));
+  if (newForkJoinIssue) return { ok: false, code: "forkJoinInvalid", detail: newForkJoinIssue };
+  return { ok: true, edges: nextEdges, edge: nextEdge };
+}
+export {
+  reattachWorkflowEdge
+};
+//# sourceMappingURL=edge-reattachment.js.map

package/dist/modules/workflows/lib/edge-reattachment.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/edge-reattachment.ts"],
+  "sourcesContent": ["/**\n * Route reattachment (spec section 4.1, issue #4233).\n *\n * Dragging a route endpoint onto another node re-targets the route instead of\n * forcing the author to delete and redraw it. The route keeps its identity \u2014\n * the durable opaque `transitionId` minted by `generateTransitionId` \u2014 plus its\n * label, condition, activities, priority and kind, so nothing an author\n * configured is lost by moving an endpoint.\n *\n * Pure: the decision is taken over plain graph data and returns either the next\n * edge list or a machine-readable rejection code the editor translates. An\n * unaccepted reattachment simply leaves the edge list untouched, which is what\n * makes React Flow snap the dragged endpoint back to where it started.\n */\n\nimport type { Node, Edge } from '@xyflow/react'\nimport { graphToDefinition, validateWorkflowGraph } from './graph-utils'\nimport { isDataMappingEdge } from './data-edge-mapping'\nimport { ERROR_TRANSITION_KIND } from './error-routing'\nimport { SLA_BREACH_TRANSITION_KIND } from './breach-routing'\nimport { OUTCOME_TRANSITION_KIND } from './outcome-routing'\nimport { resolveEdgeRouteKind, type RouteKindDescriptor } from './route-kinds'\nimport { validateParallelForkJoin } from '../data/validators'\n\n/**\n * Node types that render an error output handle\n * (`components/nodes/ErrorOutputHandle.tsx`). An error route can only start at\n * one of them, so moving its source endpoint elsewhere is refused rather than\n * silently downgraded to a normal route.\n */\nconst ERROR_ROUTE_SOURCE_NODE_TYPES = new Set(['automated', 'userTask', 'subWorkflow', 'invokeAgent'])\n\n/**\n * Node types that can raise an SLA breach \u2014 only a USER_TASK carries a deadline,\n * so a breach route moved anywhere else would never be reachable.\n */\nconst SLA_BREACH_ROUTE_SOURCE_NODE_TYPES = new Set(['userTask'])\n\n/**\n * Only an agent step resolves a disposition, so an outcome route (spec 7.2) can\n * source nowhere else.\n */\nconst OUTCOME_ROUTE_SOURCE_NODE_TYPES = new Set(['invokeAgent'])\n\n/**\n * Which node types may source each kinded route. A kind absent from this table\n * is unrestricted; a kind present in it refuses a reattachment onto a node type\n * that cannot reach the route, rather than leaving a dead route behind.\n */\nconst ROUTE_KIND_SOURCE_NODE_TYPES: Record<string, Set<string>> = {\n  [ERROR_TRANSITION_KIND]: ERROR_ROUTE_SOURCE_NODE_TYPES,\n  [SLA_BREACH_TRANSITION_KIND]: SLA_BREACH_ROUTE_SOURCE_NODE_TYPES,\n  [OUTCOME_TRANSITION_KIND]: OUTCOME_ROUTE_SOURCE_NODE_TYPES,\n}\n\nexport type EdgeReattachRejectionCode =\n  | 'unknownRoute'\n  | 'incompleteConnection'\n  | 'unknownStep'\n  | 'selfLoop'\n  | 'duplicateRoute'\n  | 'dataMappingRoute'\n  | 'errorHandleUnsupported'\n  | 'kindHandleUnsupported'\n  | 'graphInvalid'\n  | 'forkJoinInvalid'\n\nexport type EdgeReattachRejection = {\n  ok: false\n  code: EdgeReattachRejectionCode\n  detail?: string\n}\n\nexport type EdgeReattachResult =\n  | { ok: true; edges: Edge[]; edge: Edge }\n  | EdgeReattachRejection\n\nexport interface EdgeReattachConnection {\n  source?: string | null\n  target?: string | null\n  sourceHandle?: string | null\n  targetHandle?: string | null\n}\n\nfunction routeKindOfEdge(edge: Edge): RouteKindDescriptor | null {\n  const data = edge.data as { kind?: unknown } | undefined\n  return resolveEdgeRouteKind(data?.kind, edge.sourceHandle)\n}\n\nfunction sameHandle(left: string | null | undefined, right: string | null | undefined): boolean {\n  return (left || null) === (right || null)\n}\n\nfunction errorMessages(nodes: Node[], edges: Edge[]): Set<string> {\n  return new Set(\n    validateWorkflowGraph(nodes, edges)\n      .filter((issue) => issue.type === 'error')\n      .map((issue) => issue.message),\n  )\n}\n\nfunction forkJoinMessages(nodes: Node[], edges: Edge[]): Set<string> {\n  return new Set(validateParallelForkJoin(graphToDefinition(nodes, edges)).map((issue) => issue.message))\n}\n\nfunction firstAddition(before: Set<string>, after: Set<string>): string | undefined {\n  for (const message of after) {\n    if (!before.has(message)) return message\n  }\n  return undefined\n}\n\n/**\n * Re-target one route onto a new source and/or target step.\n *\n * Route identity and every configured field survive: only the endpoints (and\n * the handles they were dropped on) change. A reattachment is refused when it\n * would create a self-loop, duplicate an existing route, move an error route\n * off a step that can raise one, or introduce a graph or fork/join violation\n * the current graph does not already have.\n */\nexport function reattachWorkflowEdge(\n  nodes: Node[],\n  edges: Edge[],\n  edgeId: string,\n  connection: EdgeReattachConnection,\n): EdgeReattachResult {\n  const existing = edges.find((edge) => edge.id === edgeId)\n  if (!existing) return { ok: false, code: 'unknownRoute' }\n  if (isDataMappingEdge(existing)) return { ok: false, code: 'dataMappingRoute' }\n\n  const source = connection.source ?? null\n  const target = connection.target ?? null\n  if (!source || !target) return { ok: false, code: 'incompleteConnection' }\n\n  const sourceNode = nodes.find((node) => node.id === source)\n  const targetNode = nodes.find((node) => node.id === target)\n  if (!sourceNode || !targetNode) return { ok: false, code: 'unknownStep' }\n  if (source === target) return { ok: false, code: 'selfLoop' }\n\n  const routeKind = routeKindOfEdge(existing)\n  const allowedSourceTypes = routeKind ? ROUTE_KIND_SOURCE_NODE_TYPES[routeKind.kind] : undefined\n  if (allowedSourceTypes && !allowedSourceTypes.has(sourceNode.type ?? '')) {\n    return {\n      ok: false,\n      code: routeKind?.kind === ERROR_TRANSITION_KIND\n        ? 'errorHandleUnsupported'\n        : 'kindHandleUnsupported',\n    }\n  }\n\n  // A kinded route keeps its own handle: dropping the endpoint on a node's\n  // default port must not downgrade it to a normal route.\n  const sourceHandle = routeKind\n    ? routeKind.resolveSourceHandle((existing.data ?? {}) as Record<string, unknown>)\n    : connection.sourceHandle ?? null\n  const targetHandle = connection.targetHandle ?? null\n\n  const duplicate = edges.some(\n    (edge) =>\n      edge.id !== edgeId &&\n      !isDataMappingEdge(edge) &&\n      edge.source === source &&\n      edge.target === target &&\n      sameHandle(edge.sourceHandle, sourceHandle) &&\n      sameHandle(edge.targetHandle, targetHandle),\n  )\n  if (duplicate) return { ok: false, code: 'duplicateRoute' }\n\n  const nextEdge: Edge = {\n    ...existing,\n    source,\n    target,\n    sourceHandle,\n    targetHandle,\n  }\n  const nextEdges = edges.map((edge) => (edge.id === edgeId ? nextEdge : edge))\n\n  const newGraphError = firstAddition(errorMessages(nodes, edges), errorMessages(nodes, nextEdges))\n  if (newGraphError) return { ok: false, code: 'graphInvalid', detail: newGraphError }\n\n  const newForkJoinIssue = firstAddition(forkJoinMessages(nodes, edges), forkJoinMessages(nodes, nextEdges))\n  if (newForkJoinIssue) return { ok: false, code: 'forkJoinInvalid', detail: newForkJoinIssue }\n\n  return { ok: true, edges: nextEdges, edge: nextEdge }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/lib/edgeFormTransforms.js

@@ -1,5 +1,4 @@
-import { createLogger } from "@open-mercato/shared/lib/logger";
-const logger = createLogger("workflows");
+import { parseAdvancedConfigValue } from "./advanced-config.js";
 function generateNameFromId(edgeId) {
   return edgeId.split("_to_").map((part) => part.split("_").map(
     (word) => word.charAt(0).toUpperCase() + word.slice(1)
@@ -32,8 +31,9 @@ function edgeToFormValues(edge) {
     continueOnActivityFailure: edgeData?.continueOnActivityFailure !== void 0 ? edgeData.continueOnActivityFailure : false,
     preConditions: normalizeConditions(edgeData?.preConditions || []),
     postConditions: normalizeConditions(edgeData?.postConditions || []),
+    condition: edgeData?.condition ?? null,
     activities: edgeData?.activities || [],
-    advancedConfig: ""
+    advancedConfig: void 0
     // Advanced config is empty initially (can be populated from edgeData if needed)
   };
 }
@@ -47,16 +47,12 @@ function formValuesToEdgeUpdates(values, edge) {
     continueOnActivityFailure: values.continueOnActivityFailure,
     preConditions: values.preConditions.length > 0 ? values.preConditions : void 0,
     postConditions: values.postConditions.length > 0 ? values.postConditions : void 0,
+    condition: values.condition ?? void 0,
     activities: values.activities.length > 0 ? values.activities : void 0
   };
-  if (values.advancedConfig && values.advancedConfig.trim()) {
-    try {
-      const parsed = JSON.parse(values.advancedConfig);
-      Object.assign(updates, parsed);
-    } catch (error) {
-      logger.error("Invalid JSON in Advanced Configuration", { err: error });
-      throw new Error("Invalid JSON in Advanced Configuration. Please check your syntax.");
-    }
+  const advanced = parseAdvancedConfigValue(values.advancedConfig);
+  if (advanced) {
+    Object.assign(updates, advanced);
   }
   return updates;
 }

package/dist/modules/workflows/lib/edgeFormTransforms.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/edgeFormTransforms.ts"],
-  "sourcesContent": ["/**\n * Edge Form Transforms\n *\n * Utilities to convert between React Flow edge data structures and CrudForm field values.\n * Handles bidirectional transformation for transitions/edges with proper type safety.\n */\n\nimport type { Edge } from '@xyflow/react'\nimport type { Activity } from '../components/fields/ActivityArrayEditor'\nimport type { TransitionCondition } from '../components/fields/BusinessRuleConditionsEditor'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\n\n/**\n * Normalized condition format (object only, no string)\n */\nexport interface NormalizedCondition {\n  ruleId: string\n  required: boolean\n}\n\n/**\n * Form values interface matching CrudForm field structure\n */\nexport interface EdgeFormValues {\n  transitionName: string\n  trigger: string\n  priority: string // Number as string in form\n  continueOnActivityFailure: boolean\n  preConditions: NormalizedCondition[]\n  postConditions: NormalizedCondition[]\n  activities: Activity[]\n  advancedConfig?: string\n}\n\n/**\n * Generate a readable name from edge ID\n * Example: \"start_to_cart\" -> \"Start \u2192 Cart\"\n */\nfunction generateNameFromId(edgeId: string): string {\n  return edgeId\n    .split('_to_')\n    .map(part => part.split('_').map(word =>\n      word.charAt(0).toUpperCase() + word.slice(1)\n    ).join(' '))\n    .join(' \u2192 ')\n}\n\n/**\n * Normalize legacy string format to object format\n */\nexport function normalizeCondition(raw: string | TransitionCondition): NormalizedCondition {\n  if (typeof raw === 'string') {\n    return { ruleId: raw, required: true }\n  }\n  return raw as NormalizedCondition\n}\n\n/**\n * Normalize array of conditions (handles both string and object formats)\n */\nexport function normalizeConditions(raw: any[]): NormalizedCondition[] {\n  if (!Array.isArray(raw)) return []\n  return raw.map(normalizeCondition)\n}\n\n/**\n * Convert Edge data to CrudForm values\n */\nexport function edgeToFormValues(edge: Edge): EdgeFormValues {\n  const edgeData = edge.data as any\n\n  // Try to get transition name from various sources\n  let transitionName = ''\n  if (edgeData?.transitionName && edgeData.transitionName !== '') {\n    transitionName = edgeData.transitionName\n  } else if (edgeData?.label && edgeData.label !== '' && edgeData.label !== undefined) {\n    transitionName = edgeData.label\n  } else {\n    // Generate a name from the edge ID as fallback\n    transitionName = generateNameFromId(edge.id)\n  }\n\n  return {\n    transitionName,\n    trigger: edgeData?.trigger || 'auto',\n    priority: (edgeData?.priority || 100).toString(),\n    continueOnActivityFailure: edgeData?.continueOnActivityFailure !== undefined\n      ? edgeData.continueOnActivityFailure\n      : false,\n    preConditions: normalizeConditions(edgeData?.preConditions || []),\n    postConditions: normalizeConditions(edgeData?.postConditions || []),\n    activities: edgeData?.activities || [],\n    advancedConfig: '', // Advanced config is empty initially (can be populated from edgeData if needed)\n  }\n}\n\n/**\n * Convert CrudForm values back to Edge data updates\n *\n * Returns partial edge data to be merged with existing edge data.\n */\nexport function formValuesToEdgeUpdates(\n  values: EdgeFormValues,\n  edge: Edge\n): Partial<Edge['data']> {\n  const updates: Partial<Edge['data']> = {\n    transitionName: values.transitionName,\n    label: values.transitionName, // Keep label for backward compatibility\n    trigger: values.trigger,\n    priority: parseInt(values.priority) || 100,\n    continueOnActivityFailure: values.continueOnActivityFailure,\n    preConditions: values.preConditions.length > 0 ? values.preConditions : undefined,\n    postConditions: values.postConditions.length > 0 ? values.postConditions : undefined,\n    activities: values.activities.length > 0 ? values.activities : undefined,\n  }\n\n  // Parse advanced config (JSON) and merge\n  if (values.advancedConfig && values.advancedConfig.trim()) {\n    try {\n      const parsed = JSON.parse(values.advancedConfig)\n      Object.assign(updates, parsed)\n    } catch (error) {\n      logger.error('Invalid JSON in Advanced Configuration', { err: error })\n      throw new Error('Invalid JSON in Advanced Configuration. Please check your syntax.')\n    }\n  }\n\n  return updates\n}\n\n/**\n * Get excluded rule IDs for business rule selector\n * (to avoid selecting the same rule twice)\n */\nexport function getExcludedPreConditionRuleIds(values: EdgeFormValues): string[] {\n  return values.preConditions.map(c => {\n    const normalized = normalizeCondition(c)\n    return normalized.ruleId\n  })\n}\n\n/**\n * Get excluded rule IDs for business rule selector\n * (to avoid selecting the same rule twice)\n */\nexport function getExcludedPostConditionRuleIds(values: EdgeFormValues): string[] {\n  return values.postConditions.map(c => {\n    const normalized = normalizeCondition(c)\n    return normalized.ruleId\n  })\n}\n"],
-  "mappings": "AAUA,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,WAAW;AA4BvC,SAAS,mBAAmB,QAAwB;AAClD,SAAO,OACJ,MAAM,MAAM,EACZ,IAAI,UAAQ,KAAK,MAAM,GAAG,EAAE;AAAA,IAAI,UAC/B,KAAK,OAAO,CAAC,EAAE,YAAY,IAAI,KAAK,MAAM,CAAC;AAAA,EAC7C,EAAE,KAAK,GAAG,CAAC,EACV,KAAK,UAAK;AACf;AAKO,SAAS,mBAAmB,KAAwD;AACzF,MAAI,OAAO,QAAQ,UAAU;AAC3B,WAAO,EAAE,QAAQ,KAAK,UAAU,KAAK;AAAA,EACvC;AACA,SAAO;AACT;AAKO,SAAS,oBAAoB,KAAmC;AACrE,MAAI,CAAC,MAAM,QAAQ,GAAG,EAAG,QAAO,CAAC;AACjC,SAAO,IAAI,IAAI,kBAAkB;AACnC;AAKO,SAAS,iBAAiB,MAA4B;AAC3D,QAAM,WAAW,KAAK;AAGtB,MAAI,iBAAiB;AACrB,MAAI,UAAU,kBAAkB,SAAS,mBAAmB,IAAI;AAC9D,qBAAiB,SAAS;AAAA,EAC5B,WAAW,UAAU,SAAS,SAAS,UAAU,MAAM,SAAS,UAAU,QAAW;AACnF,qBAAiB,SAAS;AAAA,EAC5B,OAAO;AAEL,qBAAiB,mBAAmB,KAAK,EAAE;AAAA,EAC7C;AAEA,SAAO;AAAA,IACL;AAAA,IACA,SAAS,UAAU,WAAW;AAAA,IAC9B,WAAW,UAAU,YAAY,KAAK,SAAS;AAAA,IAC/C,2BAA2B,UAAU,8BAA8B,SAC/D,SAAS,4BACT;AAAA,IACJ,eAAe,oBAAoB,UAAU,iBAAiB,CAAC,CAAC;AAAA,IAChE,gBAAgB,oBAAoB,UAAU,kBAAkB,CAAC,CAAC;AAAA,IAClE,YAAY,UAAU,cAAc,CAAC;AAAA,IACrC,gBAAgB;AAAA;AAAA,EAClB;AACF;AAOO,SAAS,wBACd,QACA,MACuB;AACvB,QAAM,UAAiC;AAAA,IACrC,gBAAgB,OAAO;AAAA,IACvB,OAAO,OAAO;AAAA;AAAA,IACd,SAAS,OAAO;AAAA,IAChB,UAAU,SAAS,OAAO,QAAQ,KAAK;AAAA,IACvC,2BAA2B,OAAO;AAAA,IAClC,eAAe,OAAO,cAAc,SAAS,IAAI,OAAO,gBAAgB;AAAA,IACxE,gBAAgB,OAAO,eAAe,SAAS,IAAI,OAAO,iBAAiB;AAAA,IAC3E,YAAY,OAAO,WAAW,SAAS,IAAI,OAAO,aAAa;AAAA,EACjE;AAGA,MAAI,OAAO,kBAAkB,OAAO,eAAe,KAAK,GAAG;AACzD,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,OAAO,cAAc;AAC/C,aAAO,OAAO,SAAS,MAAM;AAAA,IAC/B,SAAS,OAAO;AACd,aAAO,MAAM,0CAA0C,EAAE,KAAK,MAAM,CAAC;AACrE,YAAM,IAAI,MAAM,mEAAmE;AAAA,IACrF;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,+BAA+B,QAAkC;AAC/E,SAAO,OAAO,cAAc,IAAI,OAAK;AACnC,UAAM,aAAa,mBAAmB,CAAC;AACvC,WAAO,WAAW;AAAA,EACpB,CAAC;AACH;AAMO,SAAS,gCAAgC,QAAkC;AAChF,SAAO,OAAO,eAAe,IAAI,OAAK;AACpC,UAAM,aAAa,mBAAmB,CAAC;AACvC,WAAO,WAAW;AAAA,EACpB,CAAC;AACH;",
+  "sourcesContent": ["/**\n * Edge Form Transforms\n *\n * Utilities to convert between React Flow edge data structures and CrudForm field values.\n * Handles bidirectional transformation for transitions/edges with proper type safety.\n */\n\nimport type { Edge } from '@xyflow/react'\nimport type { GroupCondition } from '@open-mercato/core/modules/business_rules/components/utils/conditionValidation'\nimport type { Activity } from '../components/fields/ActivityArrayEditor'\nimport type { TransitionCondition } from '../components/fields/BusinessRuleConditionsEditor'\nimport { parseAdvancedConfigValue } from './advanced-config'\n\n/**\n * Normalized condition format (object only, no string)\n */\nexport interface NormalizedCondition {\n  ruleId: string\n  required: boolean\n}\n\n/**\n * Form values interface matching CrudForm field structure\n */\nexport interface EdgeFormValues {\n  transitionName: string\n  trigger: string\n  priority: string // Number as string in form\n  continueOnActivityFailure: boolean\n  preConditions: NormalizedCondition[]\n  postConditions: NormalizedCondition[]\n  // Inline routing condition in the business_rules expression language. Edited\n  // through the same ConditionBuilder the branching inspectors use, so the\n  // condition chip on the canvas has an editor to open.\n  condition?: GroupCondition | null\n  activities: Activity[]\n  // JsonBuilder emits the parsed object; legacy callers may still provide a JSON string.\n  advancedConfig?: Record<string, unknown> | string\n}\n\n/**\n * Generate a readable name from edge ID\n * Example: \"start_to_cart\" -> \"Start \u2192 Cart\"\n */\nfunction generateNameFromId(edgeId: string): string {\n  return edgeId\n    .split('_to_')\n    .map(part => part.split('_').map(word =>\n      word.charAt(0).toUpperCase() + word.slice(1)\n    ).join(' '))\n    .join(' \u2192 ')\n}\n\n/**\n * Normalize legacy string format to object format\n */\nexport function normalizeCondition(raw: string | TransitionCondition): NormalizedCondition {\n  if (typeof raw === 'string') {\n    return { ruleId: raw, required: true }\n  }\n  return raw as NormalizedCondition\n}\n\n/**\n * Normalize array of conditions (handles both string and object formats)\n */\nexport function normalizeConditions(raw: any[]): NormalizedCondition[] {\n  if (!Array.isArray(raw)) return []\n  return raw.map(normalizeCondition)\n}\n\n/**\n * Convert Edge data to CrudForm values\n */\nexport function edgeToFormValues(edge: Edge): EdgeFormValues {\n  const edgeData = edge.data as any\n\n  // Try to get transition name from various sources\n  let transitionName = ''\n  if (edgeData?.transitionName && edgeData.transitionName !== '') {\n    transitionName = edgeData.transitionName\n  } else if (edgeData?.label && edgeData.label !== '' && edgeData.label !== undefined) {\n    transitionName = edgeData.label\n  } else {\n    // Generate a name from the edge ID as fallback\n    transitionName = generateNameFromId(edge.id)\n  }\n\n  return {\n    transitionName,\n    trigger: edgeData?.trigger || 'auto',\n    priority: (edgeData?.priority || 100).toString(),\n    continueOnActivityFailure: edgeData?.continueOnActivityFailure !== undefined\n      ? edgeData.continueOnActivityFailure\n      : false,\n    preConditions: normalizeConditions(edgeData?.preConditions || []),\n    postConditions: normalizeConditions(edgeData?.postConditions || []),\n    condition: (edgeData?.condition as GroupCondition | undefined) ?? null,\n    activities: edgeData?.activities || [],\n    advancedConfig: undefined, // Advanced config is empty initially (can be populated from edgeData if needed)\n  }\n}\n\n/**\n * Convert CrudForm values back to Edge data updates\n *\n * Returns partial edge data to be merged with existing edge data.\n */\nexport function formValuesToEdgeUpdates(\n  values: EdgeFormValues,\n  edge: Edge\n): Partial<Edge['data']> {\n  const updates: Partial<Edge['data']> = {\n    transitionName: values.transitionName,\n    label: values.transitionName, // Keep label for backward compatibility\n    trigger: values.trigger,\n    priority: parseInt(values.priority) || 100,\n    continueOnActivityFailure: values.continueOnActivityFailure,\n    preConditions: values.preConditions.length > 0 ? values.preConditions : undefined,\n    postConditions: values.postConditions.length > 0 ? values.postConditions : undefined,\n    condition: values.condition ?? undefined,\n    activities: values.activities.length > 0 ? values.activities : undefined,\n  }\n\n  // Merge the advanced config (object from JsonBuilder, or legacy JSON string)\n  const advanced = parseAdvancedConfigValue(values.advancedConfig)\n  if (advanced) {\n    Object.assign(updates, advanced)\n  }\n\n  return updates\n}\n\n/**\n * Get excluded rule IDs for business rule selector\n * (to avoid selecting the same rule twice)\n */\nexport function getExcludedPreConditionRuleIds(values: EdgeFormValues): string[] {\n  return values.preConditions.map(c => {\n    const normalized = normalizeCondition(c)\n    return normalized.ruleId\n  })\n}\n\n/**\n * Get excluded rule IDs for business rule selector\n * (to avoid selecting the same rule twice)\n */\nexport function getExcludedPostConditionRuleIds(values: EdgeFormValues): string[] {\n  return values.postConditions.map(c => {\n    const normalized = normalizeCondition(c)\n    return normalized.ruleId\n  })\n}\n"],
+  "mappings": "AAWA,SAAS,gCAAgC;AAiCzC,SAAS,mBAAmB,QAAwB;AAClD,SAAO,OACJ,MAAM,MAAM,EACZ,IAAI,UAAQ,KAAK,MAAM,GAAG,EAAE;AAAA,IAAI,UAC/B,KAAK,OAAO,CAAC,EAAE,YAAY,IAAI,KAAK,MAAM,CAAC;AAAA,EAC7C,EAAE,KAAK,GAAG,CAAC,EACV,KAAK,UAAK;AACf;AAKO,SAAS,mBAAmB,KAAwD;AACzF,MAAI,OAAO,QAAQ,UAAU;AAC3B,WAAO,EAAE,QAAQ,KAAK,UAAU,KAAK;AAAA,EACvC;AACA,SAAO;AACT;AAKO,SAAS,oBAAoB,KAAmC;AACrE,MAAI,CAAC,MAAM,QAAQ,GAAG,EAAG,QAAO,CAAC;AACjC,SAAO,IAAI,IAAI,kBAAkB;AACnC;AAKO,SAAS,iBAAiB,MAA4B;AAC3D,QAAM,WAAW,KAAK;AAGtB,MAAI,iBAAiB;AACrB,MAAI,UAAU,kBAAkB,SAAS,mBAAmB,IAAI;AAC9D,qBAAiB,SAAS;AAAA,EAC5B,WAAW,UAAU,SAAS,SAAS,UAAU,MAAM,SAAS,UAAU,QAAW;AACnF,qBAAiB,SAAS;AAAA,EAC5B,OAAO;AAEL,qBAAiB,mBAAmB,KAAK,EAAE;AAAA,EAC7C;AAEA,SAAO;AAAA,IACL;AAAA,IACA,SAAS,UAAU,WAAW;AAAA,IAC9B,WAAW,UAAU,YAAY,KAAK,SAAS;AAAA,IAC/C,2BAA2B,UAAU,8BAA8B,SAC/D,SAAS,4BACT;AAAA,IACJ,eAAe,oBAAoB,UAAU,iBAAiB,CAAC,CAAC;AAAA,IAChE,gBAAgB,oBAAoB,UAAU,kBAAkB,CAAC,CAAC;AAAA,IAClE,WAAY,UAAU,aAA4C;AAAA,IAClE,YAAY,UAAU,cAAc,CAAC;AAAA,IACrC,gBAAgB;AAAA;AAAA,EAClB;AACF;AAOO,SAAS,wBACd,QACA,MACuB;AACvB,QAAM,UAAiC;AAAA,IACrC,gBAAgB,OAAO;AAAA,IACvB,OAAO,OAAO;AAAA;AAAA,IACd,SAAS,OAAO;AAAA,IAChB,UAAU,SAAS,OAAO,QAAQ,KAAK;AAAA,IACvC,2BAA2B,OAAO;AAAA,IAClC,eAAe,OAAO,cAAc,SAAS,IAAI,OAAO,gBAAgB;AAAA,IACxE,gBAAgB,OAAO,eAAe,SAAS,IAAI,OAAO,iBAAiB;AAAA,IAC3E,WAAW,OAAO,aAAa;AAAA,IAC/B,YAAY,OAAO,WAAW,SAAS,IAAI,OAAO,aAAa;AAAA,EACjE;AAGA,QAAM,WAAW,yBAAyB,OAAO,cAAc;AAC/D,MAAI,UAAU;AACZ,WAAO,OAAO,SAAS,QAAQ;AAAA,EACjC;AAEA,SAAO;AACT;AAMO,SAAS,+BAA+B,QAAkC;AAC/E,SAAO,OAAO,cAAc,IAAI,OAAK;AACnC,UAAM,aAAa,mBAAmB,CAAC;AACvC,WAAO,WAAW;AAAA,EACpB,CAAC;AACH;AAMO,SAAS,gCAAgC,QAAkC;AAChF,SAAO,OAAO,eAAe,IAAI,OAAK;AACpC,UAAM,aAAa,mBAAmB,CAAC;AACvC,WAAO,WAAW;AAAA,EACpB,CAAC;AACH;",
   "names": []
 }