@kungfu-tech/buildchain 4.1.6-alpha.0 → 4.1.7-alpha.0

package/contracts/fixtures/consumer-upgrade/dev-pr-auto-merge-v4.0.0.json

@@ -0,0 +1,256 @@
+{
+  "inputs": {
+    "buildchain-repository": {
+      "description": "Buildchain runtime repository",
+      "default": "kungfu-systems/buildchain",
+      "type": "string",
+      "required": false
+    },
+    "buildchain-ref": {
+      "description": "Optional Buildchain runtime ref. Empty uses v3.",
+      "default": "v3",
+      "type": "string",
+      "required": false
+    },
+    "target-branch": {
+      "description": "Protected dev branch to merge ready PRs into",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "expected-pr-number": {
+      "description": "Optional exact PR number for targeted Agent admission; requires expected-head-sha",
+      "default": 0,
+      "type": "number",
+      "required": false
+    },
+    "expected-head-sha": {
+      "description": "Exact 40-character PR head required for targeted Agent admission",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "diagnostic-context": {
+      "description": "Commit-status context used for PR-visible targeted admission state",
+      "default": "Buildchain delivery intent",
+      "type": "string",
+      "required": false
+    },
+    "delivery-warrant-mode": {
+      "description": "Delivery Warrant rollout: off, shadow (read-only queue plan), or required",
+      "default": "off",
+      "type": "string",
+      "required": false
+    },
+    "assignment-root": {
+      "description": "Exact native Assignment content root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "initiative-root": {
+      "description": "Exact parent Initiative content root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "source-identity-root": {
+      "description": "Immutable semantic source identity root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "source-patch-root": {
+      "description": "Immutable source patch or tree-intent root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "project-cut-proof-json": {
+      "description": "Optional exact rooted Project Cut replay proof required when GitHub reports the PR behind the current protected base",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "plan-root": {
+      "description": "Exact qualification plan root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "closure-root": {
+      "description": "Exact affected-closure root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "dependency-root": {
+      "description": "Exact dependency-graph root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "toolchain-root": {
+      "description": "Exact qualification toolchain root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "affected-paths-json": {
+      "description": "JSON array of paths covered by source qualification",
+      "default": "[]",
+      "type": "string",
+      "required": false
+    },
+    "shard-evidence-roots-json": {
+      "description": "JSON array of additional source-shard evidence roots",
+      "default": "[]",
+      "type": "string",
+      "required": false
+    },
+    "delivery-class": {
+      "description": "Bounded delivery class",
+      "default": "native-proof-required",
+      "type": "string",
+      "required": false
+    },
+    "delivery-priority": {
+      "description": "Reviewed priority: ordinary, expedited, or emergency",
+      "default": "ordinary",
+      "type": "string",
+      "required": false
+    },
+    "warrant-lease-seconds": {
+      "description": "Delivery Warrant lease TTL",
+      "default": 3600,
+      "type": "number",
+      "required": false
+    },
+    "required-status-checks": {
+      "description": "Comma or newline separated required status/check-run name fragments",
+      "default": "check / check",
+      "type": "string",
+      "required": false
+    },
+    "queue-admission-context": {
+      "description": "Temporary exact-head commit status required before native queue admission",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "ready-label": {
+      "description": "Required label for PRs eligible to merge. Empty disables the label gate.",
+      "default": "ready",
+      "type": "string",
+      "required": false
+    },
+    "block-labels": {
+      "description": "Comma or newline separated labels that block merging",
+      "default": "blocked,do-not-merge,work-in-progress",
+      "type": "string",
+      "required": false
+    },
+    "allowed-head-prefixes": {
+      "description": "Comma or newline separated allowed source branch prefixes",
+      "default": "feature/,fix/,chore/,docs/,ci/,refactor/",
+      "type": "string",
+      "required": false
+    },
+    "require-approval": {
+      "description": "Require at least one current approval and no latest changes-requested review",
+      "default": true,
+      "type": "boolean",
+      "required": false
+    },
+    "same-repository-only": {
+      "description": "Reject fork/cross-repository PR heads by default",
+      "default": true,
+      "type": "boolean",
+      "required": false
+    },
+    "max-merges": {
+      "description": "Maximum PRs to merge in one run",
+      "default": 1,
+      "type": "number",
+      "required": false
+    },
+    "merge-method": {
+      "description": "GitHub merge method: merge, squash, or rebase",
+      "default": "merge",
+      "type": "string",
+      "required": false
+    },
+    "landing-mode": {
+      "description": "Landing mode: auto selects native queue when enabled; queue fails closed without one",
+      "default": "auto",
+      "type": "string",
+      "required": false
+    },
+    "dry-run": {
+      "description": "Plan only; do not merge PRs",
+      "default": true,
+      "type": "boolean",
+      "required": false
+    }
+  },
+  "secrets": {
+    "github-token": {
+      "description": "Optional token for reading and merging PRs. Defaults to github.token.",
+      "required": false
+    }
+  },
+  "outputs": {
+    "evaluated-count": {
+      "description": "Number of PRs evaluated",
+      "value": "${{ jobs.merge-dev-prs.outputs.evaluated-count }}"
+    },
+    "merged-count": {
+      "description": "Number of PRs directly merged, or directly eligible in dry-run mode",
+      "value": "${{ jobs.merge-dev-prs.outputs.merged-count }}"
+    },
+    "enqueued-count": {
+      "description": "Number of PRs admitted into the native merge queue",
+      "value": "${{ jobs.merge-dev-prs.outputs.enqueued-count }}"
+    },
+    "action-count": {
+      "description": "Number of direct merges, queue admissions, or planned actions",
+      "value": "${{ jobs.merge-dev-prs.outputs.action-count }}"
+    },
+    "skipped-count": {
+      "description": "Number of PRs skipped",
+      "value": "${{ jobs.merge-dev-prs.outputs.skipped-count }}"
+    },
+    "final-base-sha": {
+      "description": "Final target branch SHA after the run",
+      "value": "${{ jobs.merge-dev-prs.outputs.final-base-sha }}"
+    },
+    "admission-state": {
+      "description": "Typed targeted admission state; empty for cadence patrol",
+      "value": "${{ jobs.merge-dev-prs.outputs.admission-state }}"
+    },
+    "admission-receipt-root": {
+      "description": "Content root of the targeted exact-head admission receipt",
+      "value": "${{ jobs.merge-dev-prs.outputs.admission-receipt-root }}"
+    },
+    "source-proof-root": {
+      "description": "Content root of the reusable Source Qualification Proof",
+      "value": "${{ jobs.merge-dev-prs.outputs.source-proof-root }}"
+    },
+    "warrant-receipt-root": {
+      "description": "Content root of the selected Delivery Warrant receipt",
+      "value": "${{ jobs.merge-dev-prs.outputs.warrant-receipt-root }}"
+    },
+    "warrant-state-root": {
+      "description": "Exact readback root of the durable Warrant queue",
+      "value": "${{ jobs.merge-dev-prs.outputs.warrant-state-root }}"
+    },
+    "warrant-state-commit": {
+      "description": "Immutable queue commit containing the active Warrant readback",
+      "value": "${{ jobs.merge-dev-prs.outputs.warrant-state-commit }}"
+    },
+    "project-cut-proof-root": {
+      "description": "Verified exact Project Cut replay proof root, when supplied",
+      "value": "${{ jobs.merge-dev-prs.outputs.project-cut-proof-root }}"
+    }
+  }
+}

package/contracts/fixtures/consumer-upgrade/dev-pr-auto-merge-v4.0.9.json

@@ -0,0 +1,358 @@
+{
+  "inputs": {
+    "universal-request-json": {
+      "description": "Versioned exact-candidate request envelope; empty preserves the compatibility path",
+      "default": "",
+      "required": false,
+      "type": "string"
+    },
+    "buildchain-repository": {
+      "description": "Buildchain runtime repository",
+      "default": "kungfu-systems/buildchain",
+      "type": "string",
+      "required": false
+    },
+    "buildchain-ref": {
+      "description": "Explicit Buildchain v4 runtime ref; empty and v3 selectors are rejected.",
+      "default": "v4",
+      "type": "string",
+      "required": false
+    },
+    "target-branch": {
+      "description": "Protected dev branch to merge ready PRs into",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "expected-pr-number": {
+      "description": "Optional exact PR number for targeted Agent admission; requires expected-head-sha",
+      "default": 0,
+      "type": "number",
+      "required": false
+    },
+    "expected-head-sha": {
+      "description": "Exact 40-character PR head required for targeted Agent admission",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "source-workflow-run-id": {
+      "description": "Exact successful source workflow run retained for immediate Warrant handoff",
+      "default": 0,
+      "type": "number",
+      "required": false
+    },
+    "handoff-workflow-id": {
+      "description": "Optional consumer workflow file to dispatch when another candidate owns the active Warrant",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "source-workflow-id": {
+      "description": "Optional consumer source workflow file used to recover a legacy active candidate's exact successful run",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "legacy-active-owner-binding-json": {
+      "description": "Explicit legacy-safe handoff path carrying the exact phase-less queue root, fence, and generation",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "diagnostic-context": {
+      "description": "Commit-status context used for PR-visible targeted admission state",
+      "default": "Buildchain delivery intent",
+      "type": "string",
+      "required": false
+    },
+    "delivery-warrant-mode": {
+      "description": "Delivery Warrant rollout: off, shadow (read-only queue plan), or required",
+      "default": "off",
+      "type": "string",
+      "required": false
+    },
+    "assignment-root": {
+      "description": "Exact native Assignment content root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "initiative-root": {
+      "description": "Exact parent Initiative content root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "source-identity-root": {
+      "description": "Immutable semantic source identity root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "source-patch-root": {
+      "description": "Immutable source patch or tree-intent root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "project-cut-proof-json": {
+      "description": "Optional exact rooted Project Cut replay proof required when GitHub reports the PR behind the current protected base",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "plan-root": {
+      "description": "Exact qualification plan root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "closure-root": {
+      "description": "Exact affected-closure root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "dependency-root": {
+      "description": "Exact dependency-graph root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "toolchain-root": {
+      "description": "Exact qualification toolchain root",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "environment-root": {
+      "description": "Exact native execution environment contract root; required for required native qualification",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "affected-paths-json": {
+      "description": "JSON array of paths covered by source qualification",
+      "default": "[]",
+      "type": "string",
+      "required": false
+    },
+    "shard-evidence-roots-json": {
+      "description": "JSON array of additional native-shard evidence roots",
+      "default": "[]",
+      "type": "string",
+      "required": false
+    },
+    "native-proof-json": {
+      "description": "Optional reusable semantic native proof; base-only drift is classified before use",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "native-command": {
+      "description": "Native qualification command run after provisional Warrant selection when proof reuse is unavailable",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "native-command-root": {
+      "description": "Optional exact root of native-command; when supplied it must match before admission or spawn",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "release-blocker-priority-json": {
+      "description": "Optional exact rooted release-blocker priority claim",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "native-heartbeat-seconds": {
+      "description": "Heartbeat cadence while native qualification is running",
+      "default": 300,
+      "type": "number",
+      "required": false
+    },
+    "delivery-class": {
+      "description": "Bounded delivery class",
+      "default": "native-proof-required",
+      "type": "string",
+      "required": false
+    },
+    "delivery-priority": {
+      "description": "Reviewed priority: ordinary, expedited, or emergency",
+      "default": "ordinary",
+      "type": "string",
+      "required": false
+    },
+    "warrant-lease-seconds": {
+      "description": "Delivery Warrant lease TTL",
+      "default": 3600,
+      "type": "number",
+      "required": false
+    },
+    "required-status-checks": {
+      "description": "Comma or newline separated required status/check-run name fragments",
+      "default": "check / check",
+      "type": "string",
+      "required": false
+    },
+    "queue-admission-context": {
+      "description": "Exact-head status written and read back before native queue admission; required in Warrant mode",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "active-lease-context": {
+      "description": "Exact-head lease status written and read back as pending before enqueue; required in Warrant mode",
+      "default": "",
+      "type": "string",
+      "required": false
+    },
+    "ready-label": {
+      "description": "Required label for PRs eligible to merge. Empty disables the label gate.",
+      "default": "ready",
+      "type": "string",
+      "required": false
+    },
+    "block-labels": {
+      "description": "Comma or newline separated labels that block merging",
+      "default": "blocked,do-not-merge,work-in-progress",
+      "type": "string",
+      "required": false
+    },
+    "allowed-head-prefixes": {
+      "description": "Comma or newline separated allowed source branch prefixes",
+      "default": "feature/,fix/,chore/,docs/,ci/,refactor/",
+      "type": "string",
+      "required": false
+    },
+    "require-approval": {
+      "description": "Require at least one current approval and no latest changes-requested review",
+      "default": true,
+      "type": "boolean",
+      "required": false
+    },
+    "same-repository-only": {
+      "description": "Reject fork/cross-repository PR heads by default",
+      "default": true,
+      "type": "boolean",
+      "required": false
+    },
+    "max-merges": {
+      "description": "Maximum PRs to merge in one run",
+      "default": 1,
+      "type": "number",
+      "required": false
+    },
+    "merge-method": {
+      "description": "GitHub merge method: merge, squash, or rebase",
+      "default": "merge",
+      "type": "string",
+      "required": false
+    },
+    "landing-mode": {
+      "description": "Landing mode: auto selects native queue when enabled; queue fails closed without one",
+      "default": "auto",
+      "type": "string",
+      "required": false
+    },
+    "defer-landing": {
+      "description": "Qualify the exact required Warrant and publish its evidence without landing the PR",
+      "default": false,
+      "type": "boolean",
+      "required": false
+    },
+    "dry-run": {
+      "description": "Plan only; do not merge PRs",
+      "default": true,
+      "type": "boolean",
+      "required": false
+    }
+  },
+  "secrets": {
+    "github-token": {
+      "description": "Optional token for reading and merging PRs. Defaults to github.token.",
+      "required": false
+    }
+  },
+  "outputs": {
+    "evaluated-count": {
+      "description": "Number of PRs evaluated",
+      "value": "${{ jobs.merge-dev-prs.outputs.evaluated-count }}"
+    },
+    "merged-count": {
+      "description": "Number of PRs directly merged, or directly eligible in dry-run mode",
+      "value": "${{ jobs.merge-dev-prs.outputs.merged-count }}"
+    },
+    "enqueued-count": {
+      "description": "Number of PRs admitted into the native merge queue",
+      "value": "${{ jobs.merge-dev-prs.outputs.enqueued-count }}"
+    },
+    "action-count": {
+      "description": "Number of direct merges, queue admissions, or planned actions",
+      "value": "${{ jobs.merge-dev-prs.outputs.action-count }}"
+    },
+    "skipped-count": {
+      "description": "Number of PRs skipped",
+      "value": "${{ jobs.merge-dev-prs.outputs.skipped-count }}"
+    },
+    "final-base-sha": {
+      "description": "Final target branch SHA after the run",
+      "value": "${{ jobs.merge-dev-prs.outputs.final-base-sha }}"
+    },
+    "admission-state": {
+      "description": "Typed targeted admission state; empty for cadence patrol",
+      "value": "${{ jobs.merge-dev-prs.outputs.admission-state }}"
+    },
+    "admission-receipt-root": {
+      "description": "Content root of the targeted exact-head admission receipt",
+      "value": "${{ jobs.merge-dev-prs.outputs.admission-receipt-root }}"
+    },
+    "source-proof-root": {
+      "description": "Content root of the reusable Source Qualification Proof",
+      "value": "${{ jobs.merge-dev-prs.outputs.source-proof-root }}"
+    },
+    "warrant-receipt-root": {
+      "description": "Content root of the selected Delivery Warrant receipt",
+      "value": "${{ jobs.merge-dev-prs.outputs.warrant-receipt-root }}"
+    },
+    "warrant-state-root": {
+      "description": "Exact readback root of the durable Warrant queue",
+      "value": "${{ jobs.merge-dev-prs.outputs.warrant-state-root }}"
+    },
+    "warrant-state-commit": {
+      "description": "Immutable queue commit containing the active Warrant readback",
+      "value": "${{ jobs.merge-dev-prs.outputs.warrant-state-commit }}"
+    },
+    "project-cut-proof-root": {
+      "description": "Verified exact Project Cut replay proof root, when supplied",
+      "value": "${{ jobs.merge-dev-prs.outputs.project-cut-proof-root }}"
+    },
+    "native-proof-root": {
+      "description": "Fresh or reused semantic native proof root",
+      "value": "${{ jobs.merge-dev-prs.outputs.native-proof-root }}"
+    },
+    "native-reuse-decision-root": {
+      "description": "Rooted fail-closed native proof reuse decision",
+      "value": "${{ jobs.merge-dev-prs.outputs.native-reuse-decision-root }}"
+    },
+    "qualified-warrant-receipt-root": {
+      "description": "Atomic provisional-to-qualified Warrant receipt root",
+      "value": "${{ jobs.merge-dev-prs.outputs.qualified-warrant-receipt-root }}"
+    },
+    "native-execution-transfer-root": {
+      "description": "Content root of the cross-job native proof and state transfer",
+      "value": "${{ jobs.merge-dev-prs.outputs.native-execution-transfer-root }}"
+    },
+    "provider-finalizer-boundary-root": {
+      "description": "Live provider readback root proving pairwise-distinct hosted native, seal, and finalizer domains",
+      "value": "${{ jobs.merge-dev-prs.outputs.provider-finalizer-boundary-root }}"
+    },
+    "provider-heartbeat-receipt-root": {
+      "description": "Rooted independent durable heartbeat continuity receipt",
+      "value": "${{ jobs.merge-dev-prs.outputs.provider-heartbeat-receipt-root }}"
+    }
+  }
+}