feat(workflows): compare deployment versions across UI and API

.github/workflows/test-build.yml

@@ -195,7 +195,7 @@ jobs:
       # immediately, and either way the server log tail lands in the job log. No
       # step timeout: the job's bound covers a hang without cutting a slow but
       # healthy suite short of writing its report.
-      - name: Verify SCIM and administration over real HTTP
+      - name: Verify SCIM, administration and workflow comparisons over real HTTP
         working-directory: apps/sim
         env:
           NEXT_PUBLIC_APP_URL: http://127.0.0.1:3017
@@ -247,6 +247,11 @@ jobs:
           SCIM_E2E_AUTH_SECRET="$BETTER_AUTH_SECRET" \
           SCIM_E2E_REPORT_PATH="$report_dir/scim-e2e-report.json" \
             bun run test:scim:e2e
+          VERSION_COMPARE_E2E_BASE_URL="$NEXT_PUBLIC_APP_URL" \
+          VERSION_COMPARE_E2E_DATABASE_URL="$DATABASE_URL" \
+          VERSION_COMPARE_E2E_AUTH_SECRET="$BETTER_AUTH_SECRET" \
+          VERSION_COMPARE_E2E_REPORT_PATH="$report_dir/version-compare-http-report.json" \
+            bun run test:workflow-version-compare:e2e
 
       - name: Upload end-to-end reports and server logs
         if: failure()

apps/docs/content/docs/api-reference/(generated)/workflows/meta.json

@@ -14,6 +14,7 @@
     "applyWorkflowVariables",
     "listWorkflowVersionsV2",
     "getWorkflowVersionV2",
+    "compareWorkflowVersionsV2",
     "updateWorkflowVersionV2",
     "activateWorkflowVersion",
     "revertWorkflowVersion",

apps/docs/content/docs/cli/reference.mdx

@@ -6277,6 +6277,113 @@ sim workflows runs wait <runId> [options]
 
 </CommandTable>
 
+### sim workflows versions compare
+
+Compare Workflow Versions
+
+```bash
+sim workflows versions compare <workflowId> [options]
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `workflowId` | Yes | Unique workflow identifier. |
+
+</CommandTable>
+
+**Options**
+
+<CommandTable>
+
+| Option | Required | Description |
+| --- | --- | --- |
+| `--base <value>` | Yes | Deployment version to compare from. |
+| `--target <value>` | Yes | Deployment version to compare to, in the same workflow. |
+
+</CommandTable>
+
+### sim workflows versions get
+
+Get Workflow Version
+
+```bash
+sim workflows versions get <workflowId> <version>
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `workflowId` | Yes | Unique workflow identifier. |
+| `version` | Yes | Numeric deployment version. |
+
+</CommandTable>
+
+### sim workflows versions list
+
+List Workflow Versions
+
+```bash
+sim workflows versions list <workflowId> [options]
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `workflowId` | Yes | Unique workflow identifier. |
+
+</CommandTable>
+
+**Options**
+
+<CommandTable>
+
+| Option | Required | Description |
+| --- | --- | --- |
+| `--limit <n>` | No | Maximum items to return (0 for everything). Defaults to `100`. |
+| `--cursor <value>` | No | Continue from nextCursor returned by a previous result. |
+
+</CommandTable>
+
+### sim workflows versions update
+
+Update Workflow Version
+
+```bash
+sim workflows versions update <workflowId> <version> [options]
+```
+
+**Arguments**
+
+<CommandTable>
+
+| Argument | Required | Description |
+| --- | --- | --- |
+| `workflowId` | Yes | Unique workflow identifier. |
+| `version` | Yes | Numeric deployment version. |
+
+</CommandTable>
+
+**Options**
+
+<CommandTable>
+
+| Option | Required | Description |
+| --- | --- | --- |
+| `--name <value>` | No | New label for the deployment version. |
+| `--description <value>` | No | New release note for the deployment version, or null to clear it. (--description null sends the word, not JSON null). |
+
+</CommandTable>
+
 ### sim workflows create
 
 Create Workflow
@@ -6750,84 +6857,6 @@ sim workflows state replace <workflowId> [options]
 
 </CommandTable>
 
-### sim workflows versions get
-
-Get Workflow Version
-
-```bash
-sim workflows versions get <workflowId> <version>
-```
-
-**Arguments**
-
-<CommandTable>
-
-| Argument | Required | Description |
-| --- | --- | --- |
-| `workflowId` | Yes | Unique workflow identifier. |
-| `version` | Yes | Numeric deployment version. |
-
-</CommandTable>
-
-### sim workflows versions list
-
-List Workflow Versions
-
-```bash
-sim workflows versions list <workflowId> [options]
-```
-
-**Arguments**
-
-<CommandTable>
-
-| Argument | Required | Description |
-| --- | --- | --- |
-| `workflowId` | Yes | Unique workflow identifier. |
-
-</CommandTable>
-
-**Options**
-
-<CommandTable>
-
-| Option | Required | Description |
-| --- | --- | --- |
-| `--limit <n>` | No | Maximum items to return (0 for everything). Defaults to `100`. |
-| `--cursor <value>` | No | Continue from nextCursor returned by a previous result. |
-
-</CommandTable>
-
-### sim workflows versions update
-
-Update Workflow Version
-
-```bash
-sim workflows versions update <workflowId> <version> [options]
-```
-
-**Arguments**
-
-<CommandTable>
-
-| Argument | Required | Description |
-| --- | --- | --- |
-| `workflowId` | Yes | Unique workflow identifier. |
-| `version` | Yes | Numeric deployment version. |
-
-</CommandTable>
-
-**Options**
-
-<CommandTable>
-
-| Option | Required | Description |
-| --- | --- | --- |
-| `--name <value>` | No | New label for the deployment version. |
-| `--description <value>` | No | New release note for the deployment version, or null to clear it. (--description null sends the word, not JSON null). |
-
-</CommandTable>
-
 ### sim workflows import
 
 Import Workflow