@fluidgrids/workflows 2026.1029.1 → 2026.1030.1

package/fixtures/histories/update-accepted-completed.history.json

@@ -2,24 +2,27 @@
   "format": "fluidgrids.history",
   "formatVersion": 1,
   "name": "update-accepted-completed",
-  "description": "Phase C: an update accepted and completed by a handler (UPDATE_ACCEPTED, UPDATE_COMPLETED). Parsed and projected, not replayed.",
-  "source": "src/signals.ts",
-  "replay": false,
+  "description": "An update accepted and completed by its handler (UPDATE_ACCEPTED carries the request, UPDATE_COMPLETED the result); a signal then ends the run. Replayable from C-R1: replay re-delivers the accepted update without its validator.",
+  "source": "src/phase-c-updates.ts",
   "info": {
-    "runId": "run-1",
     "workspaceId": "test-workspace",
-    "taskQueue": "managed"
+    "taskQueue": "managed",
+    "attempt": 1,
+    "startedAt": "2026-01-01T00:00:00.000Z",
+    "runStartedAt": "2026-01-01T00:00:00.000Z",
+    "runId": "run-1"
   },
   "nowMs": 1767225900000,
-  "workflowFn": "waitForApproval",
+  "workflowFn": "addressBook",
   "events": [
     {
       "seq": 1,
       "type": "WORKFLOW_STARTED",
       "payload": {
-        "workflowFn": "waitForApproval",
+        "workflowFn": "addressBook",
         "input": null,
-        "taskQueue": "managed"
+        "taskQueue": "managed",
+        "randomnessSeed": "run-1"
       },
       "createdAt": "2026-01-01T00:00:00.000Z"
     },
@@ -27,7 +30,7 @@
       "seq": 2,
       "type": "WORKFLOW_TASK_SCHEDULED",
       "payload": {
-        "taskId": "t1"
+        "taskId": "run-1-task-1"
       },
       "createdAt": "2026-01-01T00:00:00.000Z"
     },
@@ -35,7 +38,7 @@
       "seq": 3,
       "type": "WORKFLOW_TASK_STARTED",
       "payload": {
-        "taskId": "t1",
+        "taskId": "run-1-task-1",
         "attempt": 1
       },
       "createdAt": "2026-01-01T00:00:00.000Z"
@@ -44,15 +47,16 @@
       "seq": 4,
       "type": "WORKFLOW_TASK_COMPLETED",
       "payload": {
-        "taskId": "t1"
+        "taskId": "run-1-task-1"
       },
-      "createdAt": "2026-01-01T00:00:00.000Z"
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
     },
     {
       "seq": 5,
       "type": "WORKFLOW_TASK_SCHEDULED",
       "payload": {
-        "taskId": "t2"
+        "taskId": "run-1-task-2"
       },
       "createdAt": "2026-01-01T00:05:00.000Z"
     },
@@ -60,7 +64,7 @@
       "seq": 6,
       "type": "WORKFLOW_TASK_STARTED",
       "payload": {
-        "taskId": "t2",
+        "taskId": "run-1-task-2",
         "attempt": 1
       },
       "createdAt": "2026-01-01T00:05:00.000Z"
@@ -69,14 +73,14 @@
       "seq": 7,
       "type": "WORKFLOW_TASK_COMPLETED",
       "payload": {
-        "taskId": "t2"
+        "taskId": "run-1-task-2"
       },
-      "createdAt": "2026-01-01T00:05:00.000Z"
+      "createdAt": "2026-01-01T00:05:00.000Z",
+      "taskId": "run-1-task-2"
     },
     {
       "seq": 8,
       "type": "UPDATE_ACCEPTED",
-      "taskId": "t2",
       "payload": {
         "updateId": "u1",
         "name": "changeAddress",
@@ -84,19 +88,21 @@
           "address": "1 Main St"
         }
       },
-      "createdAt": "2026-01-01T00:05:00.000Z"
+      "createdAt": "2026-01-01T00:05:00.000Z",
+      "taskId": "run-1-task-2"
     },
     {
       "seq": 9,
       "type": "UPDATE_COMPLETED",
-      "taskId": "t2",
       "payload": {
         "updateId": "u1",
         "result": {
-          "accepted": true
+          "accepted": true,
+          "address": "1 Main St"
         }
       },
-      "createdAt": "2026-01-01T00:05:00.000Z"
+      "createdAt": "2026-01-01T00:05:00.000Z",
+      "taskId": "run-1-task-2"
     },
     {
       "seq": 10,
@@ -105,7 +111,8 @@
         "name": "approve",
         "payload": {
           "by": "dee"
-        }
+        },
+        "receivedAt": "2026-01-01T00:05:00.000Z"
       },
       "createdAt": "2026-01-01T00:05:00.000Z"
     },
@@ -113,7 +120,7 @@
       "seq": 11,
       "type": "WORKFLOW_TASK_SCHEDULED",
       "payload": {
-        "taskId": "t3"
+        "taskId": "run-1-task-3"
       },
       "createdAt": "2026-01-01T00:05:00.000Z"
     },
@@ -121,7 +128,7 @@
       "seq": 12,
       "type": "WORKFLOW_TASK_STARTED",
       "payload": {
-        "taskId": "t3",
+        "taskId": "run-1-task-3",
         "attempt": 1
       },
       "createdAt": "2026-01-01T00:05:00.000Z"
@@ -130,20 +137,28 @@
       "seq": 13,
       "type": "WORKFLOW_TASK_COMPLETED",
       "payload": {
-        "taskId": "t3"
+        "taskId": "run-1-task-3"
       },
-      "createdAt": "2026-01-01T00:05:00.000Z"
+      "createdAt": "2026-01-01T00:05:00.000Z",
+      "taskId": "run-1-task-3"
     },
     {
       "seq": 14,
       "type": "WORKFLOW_COMPLETED",
-      "taskId": "t3",
       "payload": {
         "output": {
-          "approvedBy": "dee"
+          "approvedBy": "dee",
+          "address": "1 Main St"
         }
       },
-      "createdAt": "2026-01-01T00:05:00.000Z"
+      "createdAt": "2026-01-01T00:05:00.000Z",
+      "taskId": "run-1-task-3"
     }
-  ]
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
 }

package/fixtures/histories/update-default-handler.history.json

@@ -0,0 +1,246 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "update-default-handler",
+  "description": "setDefaultUpdateHandler takes names the workflow does not declare; its validator rejects one (no event).",
+  "source": "src/phase-c-updates.ts",
+  "info": {
+    "workspaceId": "test-workspace",
+    "taskQueue": "managed",
+    "attempt": 1,
+    "startedAt": "2026-01-01T00:00:00.000Z",
+    "runStartedAt": "2026-01-01T00:00:00.000Z",
+    "runId": "run-1"
+  },
+  "nowMs": 1767225600000,
+  "workflowFn": "anyUpdate",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "anyUpdate",
+        "input": null,
+        "taskQueue": "managed",
+        "randomnessSeed": "run-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 5,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 6,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 7,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 8,
+      "type": "UPDATE_ACCEPTED",
+      "payload": {
+        "updateId": "u1",
+        "name": "setColour",
+        "args": {
+          "colour": "teal"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 9,
+      "type": "UPDATE_COMPLETED",
+      "payload": {
+        "updateId": "u1",
+        "result": {
+          "name": "setColour",
+          "args": {
+            "colour": "teal"
+          }
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 10,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 11,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-3",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 13,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-4"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 14,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-4",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 15,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-4"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-4"
+    },
+    {
+      "seq": 16,
+      "type": "UPDATE_ACCEPTED",
+      "payload": {
+        "updateId": "u3",
+        "name": "setSize",
+        "args": {
+          "size": 3
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-4"
+    },
+    {
+      "seq": 17,
+      "type": "UPDATE_COMPLETED",
+      "payload": {
+        "updateId": "u3",
+        "result": {
+          "name": "setSize",
+          "args": {
+            "size": 3
+          }
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-4"
+    },
+    {
+      "seq": 18,
+      "type": "SIGNAL_RECEIVED",
+      "payload": {
+        "name": "stop",
+        "payload": null,
+        "receivedAt": "2026-01-01T00:00:00.000Z"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 19,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-5"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 20,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-5",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 21,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-5"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-5"
+    },
+    {
+      "seq": 22,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "seen": [
+            "setColour",
+            "setSize"
+          ]
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-5"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}

package/fixtures/histories/update-handler-awaits-activity.history.json

@@ -0,0 +1,196 @@
+{
+  "format": "fluidgrids.history",
+  "formatVersion": 1,
+  "name": "update-handler-awaits-activity",
+  "description": "The update handler awaits an activity: UPDATE_ACCEPTED in the delivering task, UPDATE_COMPLETED in the task after ACTIVITY_COMPLETED; the run waits for its handlers.",
+  "source": "src/phase-c-updates.ts",
+  "info": {
+    "workspaceId": "test-workspace",
+    "taskQueue": "managed",
+    "attempt": 1,
+    "startedAt": "2026-01-01T00:00:00.000Z",
+    "runStartedAt": "2026-01-01T00:00:00.000Z",
+    "runId": "run-1"
+  },
+  "nowMs": 1767225600000,
+  "workflowFn": "slowUpdate",
+  "events": [
+    {
+      "seq": 1,
+      "type": "WORKFLOW_STARTED",
+      "payload": {
+        "workflowFn": "slowUpdate",
+        "input": null,
+        "taskQueue": "managed",
+        "randomnessSeed": "run-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 2,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 3,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 4,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-1"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-1"
+    },
+    {
+      "seq": 5,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 6,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-2",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 7,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-2"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 8,
+      "type": "UPDATE_ACCEPTED",
+      "payload": {
+        "updateId": "u1",
+        "name": "lookup",
+        "args": {
+          "id": "i-9"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 9,
+      "type": "ACTIVITY_SCHEDULED",
+      "payload": {
+        "activityId": "a1",
+        "kind": "node",
+        "nodeType": "internal:http",
+        "operation": "execute",
+        "args": {
+          "url": "https://example.test/items/i-9"
+        },
+        "retry": {
+          "retryDelay": 1000,
+          "backoffMultiplier": 2,
+          "maxDelay": 100000
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-2"
+    },
+    {
+      "seq": 10,
+      "type": "ACTIVITY_STARTED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 11,
+      "type": "ACTIVITY_COMPLETED",
+      "payload": {
+        "activityId": "a1",
+        "attempt": 1,
+        "result": {
+          "status": 200,
+          "url": "https://example.test/items/i-9"
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 12,
+      "type": "WORKFLOW_TASK_SCHEDULED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 13,
+      "type": "WORKFLOW_TASK_STARTED",
+      "payload": {
+        "taskId": "run-1-task-3",
+        "attempt": 1
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z"
+    },
+    {
+      "seq": 14,
+      "type": "WORKFLOW_TASK_COMPLETED",
+      "payload": {
+        "taskId": "run-1-task-3"
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 15,
+      "type": "UPDATE_COMPLETED",
+      "payload": {
+        "updateId": "u1",
+        "result": {
+          "id": "i-9",
+          "response": {
+            "status": 200,
+            "url": "https://example.test/items/i-9"
+          }
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    },
+    {
+      "seq": 16,
+      "type": "WORKFLOW_COMPLETED",
+      "payload": {
+        "output": {
+          "done": true
+        }
+      },
+      "createdAt": "2026-01-01T00:00:00.000Z",
+      "taskId": "run-1-task-3"
+    }
+  ],
+  "expected": {
+    "protocol": 1,
+    "outcome": "commands",
+    "commands": [],
+    "logs": []
+  }
+}