Merge branch 'main' into claude/wire-contract-api-schemas-ci

Author: JSONbored

.github/workflows/mcp-release-please.yml

@@ -178,31 +178,31 @@ jobs:
         if: ${{ steps.release.outputs['packages/loopover-mcp--release_created'] == 'true' }}
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: gh workflow run publish-mcp.yml --ref "${{ steps.release.outputs['packages/loopover-mcp--tag_name'] }}" -f released_by_release_please=true
+        run: gh workflow run publish-mcp.yml --ref "${{ steps.release.outputs['packages/loopover-mcp--tag_name'] }}" -f released_by_release_please=true -f dispatched_by_automation=true
 
       - name: Dispatch Engine publish
         if: ${{ steps.release.outputs['packages/loopover-engine--release_created'] == 'true' }}
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: gh workflow run publish-engine.yml --ref "${{ steps.release.outputs['packages/loopover-engine--tag_name'] }}" -f released_by_release_please=true
+        run: gh workflow run publish-engine.yml --ref "${{ steps.release.outputs['packages/loopover-engine--tag_name'] }}" -f released_by_release_please=true -f dispatched_by_automation=true
 
       - name: Dispatch Contract publish
         if: ${{ steps.release.outputs['packages/loopover-contract--release_created'] == 'true' }}
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: gh workflow run publish-contract.yml --ref "${{ steps.release.outputs['packages/loopover-contract--tag_name'] }}" -f released_by_release_please=true
+        run: gh workflow run publish-contract.yml --ref "${{ steps.release.outputs['packages/loopover-contract--tag_name'] }}" -f released_by_release_please=true -f dispatched_by_automation=true
 
       - name: Dispatch Miner publish
         if: ${{ steps.release.outputs['packages/loopover-miner--release_created'] == 'true' }}
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: gh workflow run publish-miner.yml --ref "${{ steps.release.outputs['packages/loopover-miner--tag_name'] }}" -f released_by_release_please=true
+        run: gh workflow run publish-miner.yml --ref "${{ steps.release.outputs['packages/loopover-miner--tag_name'] }}" -f released_by_release_please=true -f dispatched_by_automation=true
 
       - name: Dispatch UI Kit publish
         if: ${{ steps.release.outputs['packages/loopover-ui-kit--release_created'] == 'true' }}
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: gh workflow run publish-ui-kit.yml --ref "${{ steps.release.outputs['packages/loopover-ui-kit--tag_name'] }}" -f released_by_release_please=true
+        run: gh workflow run publish-ui-kit.yml --ref "${{ steps.release.outputs['packages/loopover-ui-kit--tag_name'] }}" -f released_by_release_please=true -f dispatched_by_automation=true
 
   # Self-heal for a known, reproducible, upstream googleapis/release-please limitation
   # (googleapis/release-please#1946, #1444, #1406 -- all the same "There are untagged, merged release
@@ -282,7 +282,7 @@ jobs:
             # `before_ts` only on the rare case the URL wasn't returned.
             local before_ts run_id dispatch_output
             before_ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-            dispatch_output="$(gh workflow run "$workflow" --repo "$GITHUB_REPOSITORY" 2>&1)"
+            dispatch_output="$(gh workflow run "$workflow" --repo "$GITHUB_REPOSITORY" -f dispatched_by_automation=true 2>&1)"
             echo "$dispatch_output"
             run_id="$(printf '%s' "$dispatch_output" | grep -oE '/runs/[0-9]+' | grep -oE '[0-9]+' | tail -1 || true)"
             if [ -z "$run_id" ]; then

.github/workflows/publish-contract.yml

@@ -23,6 +23,18 @@ on:
         description: "Internal: set by the release automation's dispatch so this run skips re-creating the GitHub release it already made."
         type: boolean
         default: false
+      dispatched_by_automation:
+        description: "Internal: set by the release automation's dispatch so a hand retry is not counted as an outage. Informational -- it feeds run-name below and nothing else."
+        type: boolean
+        default: false
+
+# PROVENANCE STAMP (#10234). `run-name` is the ONLY dispatch-time signal the runs API gives back (as
+# `display_title`): the reconcile path dispatches bare against main under a PAT, so `event`, `head_branch`
+# and `triggering_actor` are identical to a human's `gh workflow run`, and run objects carry no `inputs`.
+# scripts/escalate-workflow-outage.ts recovers "was this automated?" from the marker below -- see its
+# header for the full story. The marker must stay in lockstep with that script's
+# AUTOMATION_RUN_NAME_MARKER; scripts/check-dispatch-provenance-stamped.ts fails the build if they drift.
+run-name: "Publish Contract Package${{ inputs.dispatched_by_automation && ' [automated]' || '' }}"
 
 permissions:
   contents: read

.github/workflows/publish-engine.yml

@@ -18,6 +18,18 @@ on:
         description: "Internal: set by the release automation's dispatch so this run skips re-creating the GitHub release it already made."
         type: boolean
         default: false
+      dispatched_by_automation:
+        description: "Internal: set by the release automation's dispatch so a hand retry is not counted as an outage. Informational -- it feeds run-name below and nothing else."
+        type: boolean
+        default: false
+
+# PROVENANCE STAMP (#10234). `run-name` is the ONLY dispatch-time signal the runs API gives back (as
+# `display_title`): the reconcile path dispatches bare against main under a PAT, so `event`, `head_branch`
+# and `triggering_actor` are identical to a human's `gh workflow run`, and run objects carry no `inputs`.
+# scripts/escalate-workflow-outage.ts recovers "was this automated?" from the marker below -- see its
+# header for the full story. The marker must stay in lockstep with that script's
+# AUTOMATION_RUN_NAME_MARKER; scripts/check-dispatch-provenance-stamped.ts fails the build if they drift.
+run-name: "Publish Engine Package${{ inputs.dispatched_by_automation && ' [automated]' || '' }}"
 
 permissions:
   contents: read

.github/workflows/publish-mcp.yml

@@ -12,6 +12,18 @@ on:
         description: "Internal: set by the release automation's dispatch so this run skips re-creating the GitHub release it already made."
         type: boolean
         default: false
+      dispatched_by_automation:
+        description: "Internal: set by the release automation's dispatch so a hand retry is not counted as an outage. Informational -- it feeds run-name below and nothing else."
+        type: boolean
+        default: false
+
+# PROVENANCE STAMP (#10234). `run-name` is the ONLY dispatch-time signal the runs API gives back (as
+# `display_title`): the reconcile path dispatches bare against main under a PAT, so `event`, `head_branch`
+# and `triggering_actor` are identical to a human's `gh workflow run`, and run objects carry no `inputs`.
+# scripts/escalate-workflow-outage.ts recovers "was this automated?" from the marker below -- see its
+# header for the full story. The marker must stay in lockstep with that script's
+# AUTOMATION_RUN_NAME_MARKER; scripts/check-dispatch-provenance-stamped.ts fails the build if they drift.
+run-name: "Publish MCP Package${{ inputs.dispatched_by_automation && ' [automated]' || '' }}"
 
 permissions:
   contents: read

.github/workflows/publish-miner.yml

@@ -18,6 +18,18 @@ on:
         description: "Internal: set by the release automation's dispatch so this run skips re-creating the GitHub release it already made."
         type: boolean
         default: false
+      dispatched_by_automation:
+        description: "Internal: set by the release automation's dispatch so a hand retry is not counted as an outage. Informational -- it feeds run-name below and nothing else."
+        type: boolean
+        default: false
+
+# PROVENANCE STAMP (#10234). `run-name` is the ONLY dispatch-time signal the runs API gives back (as
+# `display_title`): the reconcile path dispatches bare against main under a PAT, so `event`, `head_branch`
+# and `triggering_actor` are identical to a human's `gh workflow run`, and run objects carry no `inputs`.
+# scripts/escalate-workflow-outage.ts recovers "was this automated?" from the marker below -- see its
+# header for the full story. The marker must stay in lockstep with that script's
+# AUTOMATION_RUN_NAME_MARKER; scripts/check-dispatch-provenance-stamped.ts fails the build if they drift.
+run-name: "Publish Miner Package${{ inputs.dispatched_by_automation && ' [automated]' || '' }}"
 
 permissions:
   contents: read

.github/workflows/publish-ui-kit.yml

@@ -18,6 +18,18 @@ on:
         description: "Internal: set by the release automation's dispatch so this run skips re-creating the GitHub release it already made."
         type: boolean
         default: false
+      dispatched_by_automation:
+        description: "Internal: set by the release automation's dispatch so a hand retry is not counted as an outage. Informational -- it feeds run-name below and nothing else."
+        type: boolean
+        default: false
+
+# PROVENANCE STAMP (#10234). `run-name` is the ONLY dispatch-time signal the runs API gives back (as
+# `display_title`): the reconcile path dispatches bare against main under a PAT, so `event`, `head_branch`
+# and `triggering_actor` are identical to a human's `gh workflow run`, and run objects carry no `inputs`.
+# scripts/escalate-workflow-outage.ts recovers "was this automated?" from the marker below -- see its
+# header for the full story. The marker must stay in lockstep with that script's
+# AUTOMATION_RUN_NAME_MARKER; scripts/check-dispatch-provenance-stamped.ts fails the build if they drift.
+run-name: "Publish UI Kit Package${{ inputs.dispatched_by_automation && ' [automated]' || '' }}"
 
 permissions:
   contents: read

.release-please-manifest.json

@@ -1,7 +1,7 @@
 {
-  "packages/loopover-contract": "3.21.0",
-  "packages/loopover-mcp": "3.21.0",
-  "packages/loopover-engine": "3.21.0",
-  "packages/loopover-miner": "3.21.0",
+  "packages/loopover-contract": "3.21.1",
+  "packages/loopover-mcp": "3.21.1",
+  "packages/loopover-engine": "3.21.1",
+  "packages/loopover-miner": "3.21.1",
   "packages/loopover-ui-kit": "1.5.1"
 }

package-lock.json

@@ -101,6 +101,8 @@
     "regate-sort-key:check": "node --experimental-strip-types scripts/check-regate-sort-key.ts",
     "command-redelivery-guards:check": "node --experimental-strip-types scripts/check-command-redelivery-guards.ts",
     "dispatch-gate-reasons:check": "node --experimental-strip-types scripts/check-dispatch-gate-reasons.ts",
+    "dispatch-provenance:check": "tsx scripts/check-dispatch-provenance-stamped.ts",
+    "record-mapper-fields:check": "node --experimental-strip-types scripts/check-record-mapper-fields.ts",
     "replay-runner-manifest": "tsx scripts/replay-runner-image-manifest.ts",
     "replay-runner-manifest:write": "tsx scripts/replay-runner-image-manifest.ts --write",
     "replay-runner-manifest:check": "tsx scripts/replay-runner-image-manifest.ts --check",
@@ -149,7 +151,7 @@
     "test:smoke:browser:install": "playwright install chromium",
     "test:smoke:browser": "node --experimental-strip-types scripts/smoke-ui-browser.ts",
     "pretest:ci": "npm run check-node-version",
-    "test:ci": "git diff --check && npm run actionlint && npm run lint:composite-actions && npm run db:migrations:check && npm run db:migrations:immutable:check && npm run turbo-inputs:check && npm run workspace-dep-ranges:check && npm run db:schema-drift:check && npm run selfhost:env-reference:check && npm run miner:env-reference:check && npm run selfhost:validate-observability && npm run cf-typegen:check && npm run build --workspace @loopover/engine && npm run build --workspace @loopover/discovery-index && npm run build:mcp && npm run build:miner && npm run build --workspace @loopover/ui-kit && npm run typecheck && npm run test:coverage && npm run test:engine-parity && npm run test:live-gate-parity && npm run test:driver-parity && npm run validate:mcp && npm run test --workspace @loopover/engine && npm run test:workers && npm run test:mcp-pack && npm run test:contract-pack && npm run test:miner-pack && npm run test:engine-pack && npm run test:ui-kit-pack && npm run test:miner-deployment-docs-audit && npm run rees:test && npm run ui:openapi:check && npm run control-plane:contract:check && npm run control-plane:openapi:check && npm run ui:version-audit && npm run docs:drift-check && npm run coverage-boltons:check && npm run import-specifiers:check && npm run ui-derived-types:check && npm run server-manifest:check && npm run dead-source-files:check && npm run dead-exports:check && npm run publishable-deps:check && npm run fixture-clock-races:check && npm run typecheck-coverage:check && npm run test-wiring:check && npm run checkers-wired:check && npm run focus-manifest-fields:check && npm run release-commit-parsing:check && npm run releasable-commit-types:check && npm run regate-sort-key:check && npm run maintainer-associations:check && npm run command-redelivery-guards:check && npm run dispatch-gate-reasons:check && npm run validate:no-hand-written-js && npm run replay-runner-manifest:check && npm run coco-dev-versions:check && npm run branding-drift:check && npm run manifest:drift-check && npm run engine-parity:drift-check && npm run engines-nvmrc:check && npm run release-manifest:sync:check && npm run release-linked-versions:check && npm run command-reference:check && npm run mcp:tool-reference:check && npm run mcp:client-config:check && npm run contract:api-schemas:check && npm run ui:lint && npm run ui:typecheck && npm run ui:test && npm run ui:build",
+    "test:ci": "git diff --check && npm run actionlint && npm run lint:composite-actions && npm run db:migrations:check && npm run db:migrations:immutable:check && npm run turbo-inputs:check && npm run workspace-dep-ranges:check && npm run db:schema-drift:check && npm run selfhost:env-reference:check && npm run miner:env-reference:check && npm run selfhost:validate-observability && npm run cf-typegen:check && npm run build --workspace @loopover/engine && npm run build --workspace @loopover/discovery-index && npm run build:mcp && npm run build:miner && npm run build --workspace @loopover/ui-kit && npm run typecheck && npm run test:coverage && npm run test:engine-parity && npm run test:live-gate-parity && npm run test:driver-parity && npm run validate:mcp && npm run test --workspace @loopover/engine && npm run test:workers && npm run test:mcp-pack && npm run test:contract-pack && npm run test:miner-pack && npm run test:engine-pack && npm run test:ui-kit-pack && npm run test:miner-deployment-docs-audit && npm run rees:test && npm run ui:openapi:check && npm run control-plane:contract:check && npm run control-plane:openapi:check && npm run ui:version-audit && npm run docs:drift-check && npm run coverage-boltons:check && npm run import-specifiers:check && npm run ui-derived-types:check && npm run server-manifest:check && npm run dead-source-files:check && npm run dead-exports:check && npm run publishable-deps:check && npm run fixture-clock-races:check && npm run typecheck-coverage:check && npm run test-wiring:check && npm run checkers-wired:check && npm run focus-manifest-fields:check && npm run release-commit-parsing:check && npm run releasable-commit-types:check && npm run regate-sort-key:check && npm run maintainer-associations:check && npm run command-redelivery-guards:check && npm run dispatch-gate-reasons:check && npm run record-mapper-fields:check && npm run dispatch-provenance:check && npm run validate:no-hand-written-js && npm run replay-runner-manifest:check && npm run coco-dev-versions:check && npm run branding-drift:check && npm run manifest:drift-check && npm run engine-parity:drift-check && npm run engines-nvmrc:check && npm run release-manifest:sync:check && npm run release-linked-versions:check && npm run command-reference:check && npm run mcp:tool-reference:check && npm run mcp:client-config:check && npm run contract:api-schemas:check && npm run ui:lint && npm run ui:typecheck && npm run ui:test && npm run ui:build",
     "test:release": "npm run test:ci && npm run changelog:check",
     "test:release:mcp": "npm run test:ci",
     "test:watch": "vitest",

package.json

@@ -1,5 +1,12 @@
 # Changelog
 
+## [3.21.1](https://github.com/JSONbored/loopover/compare/contract-v3.21.0...contract-v3.21.1) (2026-07-31)
+
+
+### Chores
+
+* **contract:** Synchronize engine-and-dependents versions
+
 ## [3.21.0](https://github.com/JSONbored/loopover/compare/contract-v3.20.0...contract-v3.21.0) (2026-07-31)