@kungfu-tech/buildchain 3.0.9-alpha.7 → 3.0.9-alpha.9

package/dist/site/schemas/dev-delivery-authority-v2.schema.json

@@ -0,0 +1,442 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.libkungfu.dev/schemas/dev-delivery-authority-v2.schema.json",
+  "title": "Buildchain Dev Delivery Authority State v2",
+  "description": "Opt-in durable state separating bounded qualification-only leases from one exclusive merge_group Landing Warrant.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "contract",
+    "authorityMode",
+    "repository",
+    "protectedBase",
+    "generation",
+    "qualificationCounter",
+    "landingCounter",
+    "policy",
+    "qualificationLeases",
+    "landingWarrant",
+    "candidates",
+    "migration",
+    "updatedAt",
+    "stateRoot"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 2
+    },
+    "contract": {
+      "const": "kungfu-buildchain-dev-delivery-authority"
+    },
+    "authorityMode": {
+      "const": "bounded-qualification-landing"
+    },
+    "repository": {
+      "type": "string",
+      "pattern": "^[^/\\s]+/[^/\\s]+$"
+    },
+    "protectedBase": {
+      "type": "string",
+      "pattern": "^dev/v[0-9]+/v[0-9]+\\.[0-9]+$"
+    },
+    "generation": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "qualificationCounter": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "landingCounter": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "maxQualificationLeases",
+        "qualificationLeaseSeconds",
+        "landingLeaseSeconds"
+      ],
+      "properties": {
+        "maxQualificationLeases": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "qualificationLeaseSeconds": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "landingLeaseSeconds": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "maxLandingOvertakes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "maxQualificationAttempts": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "qualificationLeases": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/qualificationLease"
+      }
+    },
+    "landingWarrant": {
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "$ref": "#/$defs/landingWarrant"
+        }
+      ]
+    },
+    "candidates": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/candidate"
+      }
+    },
+    "migration": {
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "$ref": "#/$defs/migration"
+        }
+      ]
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "stateRoot": {
+      "$ref": "#/$defs/root"
+    }
+  },
+  "$defs": {
+    "root": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "sha": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{40}$"
+    },
+    "qualificationLease": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "authority",
+        "mergeGroupAdmission",
+        "candidateId",
+        "token",
+        "generation",
+        "issuedAt",
+        "expiresAt"
+      ],
+      "properties": {
+        "schema": {
+          "const": "kungfu.buildchain.dev-delivery-qualification-lease/v1"
+        },
+        "authority": {
+          "const": "qualification-only"
+        },
+        "mergeGroupAdmission": {
+          "const": false
+        },
+        "candidateId": {
+          "$ref": "#/$defs/root"
+        },
+        "token": {
+          "$ref": "#/$defs/root"
+        },
+        "generation": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "issuedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "heartbeatAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "expiresAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "landingWarrant": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "authority",
+        "mergeGroupAdmission",
+        "candidateId",
+        "token",
+        "generation",
+        "issuedAt",
+        "expiresAt"
+      ],
+      "properties": {
+        "schema": {
+          "const": "kungfu.buildchain.dev-delivery-landing-warrant/v1"
+        },
+        "authority": {
+          "const": "merge-group-admission"
+        },
+        "mergeGroupAdmission": {
+          "const": true
+        },
+        "candidateId": {
+          "$ref": "#/$defs/root"
+        },
+        "token": {
+          "$ref": "#/$defs/root"
+        },
+        "generation": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "issuedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "heartbeatAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "expiresAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "qualification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "evidenceRoot",
+        "qualifiedAt"
+      ],
+      "properties": {
+        "evidenceRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "qualifiedAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "terminal": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "outcome",
+        "evidenceRoot",
+        "reason",
+        "settledAt"
+      ],
+      "properties": {
+        "outcome": {
+          "enum": [
+            "merged",
+            "terminal-failure",
+            "dequeued",
+            "cancelled"
+          ]
+        },
+        "evidenceRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "settledAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "migration": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema",
+        "legacyContract",
+        "legacyStateRoot",
+        "migratedAt"
+      ],
+      "properties": {
+        "schema": {
+          "const": "kungfu.buildchain.dev-delivery-authority-migration/v1"
+        },
+        "legacyContract": {
+          "const": "kungfu-buildchain-dev-delivery-warrant-queue"
+        },
+        "legacyStateRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "migratedAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "repository",
+        "protectedBase",
+        "pullRequestNumber",
+        "assignmentRoot",
+        "initiativeRoot",
+        "sourceIdentityRoot",
+        "deliveryClass",
+        "candidateId",
+        "sourceHead",
+        "sourcePatchRoot",
+        "sourceProofRoot",
+        "planRoot",
+        "closureRoot",
+        "dependencyRoot",
+        "toolchainRoot",
+        "enqueuedAt",
+        "updatedAt",
+        "status",
+        "qualification",
+        "terminal"
+      ],
+      "properties": {
+        "repository": {
+          "type": "string"
+        },
+        "protectedBase": {
+          "type": "string"
+        },
+        "pullRequestNumber": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "assignmentRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "initiativeRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "sourceIdentityRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "deliveryClass": {
+          "enum": [
+            "non-native-fast",
+            "native-proof-required",
+            "cross-platform",
+            "release"
+          ]
+        },
+        "identitySemantics": {
+          "const": "chained-attempt-v2"
+        },
+        "predecessorCandidateId": {
+          "$ref": "#/$defs/root"
+        },
+        "candidateId": {
+          "$ref": "#/$defs/root"
+        },
+        "sourceHead": {
+          "$ref": "#/$defs/sha"
+        },
+        "sourcePatchRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "sourceProofRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "planRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "closureRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "dependencyRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "toolchainRoot": {
+          "$ref": "#/$defs/root"
+        },
+        "qualificationDomains": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/root"
+          }
+        },
+        "qualificationAttempts": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "landingOvertakes": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "enqueuedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "updatedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "status": {
+          "enum": [
+            "queued",
+            "qualifying",
+            "qualified",
+            "landing",
+            "merged",
+            "terminal-failure",
+            "dequeued",
+            "cancelled"
+          ]
+        },
+        "qualification": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/qualification"
+            }
+          ]
+        },
+        "terminal": {
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/terminal"
+            }
+          ]
+        }
+      }
+    }
+  }
+}

package/dist/site/site-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "contract": "kungfu-buildchain-site-manifest",
-  "generatedAt": "2026-08-12T01:33:49.000Z",
-  "publishedAt": "2026-08-12T01:33:49.000Z",
+  "generatedAt": "2026-08-12T16:18:50.000Z",
+  "publishedAt": "2026-08-12T16:18:50.000Z",
   "reproducible": true,
   "timestampPolicy": "ci-injected",
   "deterministicInputs": [
@@ -19,7 +19,7 @@
     "declared Buildchain surface manifest contract"
   ],
   "sourceDateEpoch": "0",
-  "sourceRevision": "1080aeadc49281f991bde9a0b53dc399242702ff",
+  "sourceRevision": "5e0811cdf6385c0441b5ea41d57cdafc7ba11310",
   "timestampPolicyDetails": {
     "contract": "kungfu-buildchain-surface-timestamp-policy",
     "timestampFields": [
@@ -37,7 +37,7 @@
   },
   "package": {
     "name": "@kungfu-tech/buildchain",
-    "version": "3.0.9-alpha.7",
+    "version": "3.0.9-alpha.9",
     "versionSource": "package.json#version"
   },
   "entrypoint": "buildchain-site.json",
@@ -53,7 +53,7 @@
       "path": "docs/MAP.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:a1c408b13658f225113ede0ee4f4309cbae466178e8f248f4290a616ce39194c"
+      "digest": "sha256:8db720e4ee53e816aa6c0bb3b36dbe9382649dfb8fcd723d708ce12bcaf5015d"
     },
     {
       "id": "getting-started",
@@ -245,7 +245,7 @@
       "path": "docs/cli-reference.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:f77310bb6cbfca2aefbf25c02c5ee01a6c093548e5cc4d1db6b44e742e5d30d8"
+      "digest": "sha256:d6fd9d704376e47a281ce337f6c5d6346e117effe8851d43a9b370955ac07204"
     },
     {
       "id": "node-api-reference",
@@ -253,7 +253,7 @@
       "path": "docs/node-api-reference.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:37102c168f1eb23f2e9d5a86a4e2df366a755ef102626088232c8599d9cdf91e"
+      "digest": "sha256:a99695c87ba95ef44ef4c761399e26558659b879f23211adb729d265e6e24758"
     },
     {
       "id": "build-facts",
@@ -357,7 +357,7 @@
       "path": "docs/versioning.md",
       "plane": "why",
       "exists": true,
-      "digest": "sha256:0b1485e9e87a5f185041746e6ce8068373b3a6483fa7d1123f60702de471849b"
+      "digest": "sha256:af1be0d4b9f110807534f1111e5003b2454908993183215badcf7a33b9f48461"
     },
     {
       "id": "web-surface-deployments",

package/dist/site/workflow-registry.json

@@ -428,9 +428,10 @@
       ],
       "inputCount": 37,
       "secrets": [
+        "BUILDCHAIN_GOVERNANCE_READ_TOKEN",
         "KUNGFU_GOVERNANCE_AUDITOR_APP_PRIVATE_KEY"
       ],
-      "secretCount": 1,
+      "secretCount": 2,
       "outputs": [
         "capability-artifact",
         "capability-digest",
@@ -1849,6 +1850,7 @@
         "dependency-root",
         "diagnostic-context",
         "dry-run",
+        "environment-root",
         "expected-head-sha",
         "expected-pr-number",
         "handoff-workflow-id",
@@ -1875,7 +1877,7 @@
         "toolchain-root",
         "warrant-lease-seconds"
       ],
-      "inputCount": 39,
+      "inputCount": 40,
       "secrets": [
         "github-token"
       ],
@@ -1967,7 +1969,7 @@
       "status": "preview",
       "owner": "buildchain-workflows",
       "maturity": "preview",
-      "introducedVersion": "3.0.9-alpha.7",
+      "introducedVersion": "3.0.9-alpha.9",
       "compatibilityPromise": "preserved-through-the-v3-major-line",
       "deprecationReplacement": "",
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -1988,7 +1990,7 @@
       "status": "preview",
       "owner": "buildchain-workflows",
       "maturity": "preview",
-      "introducedVersion": "3.0.9-alpha.7",
+      "introducedVersion": "3.0.9-alpha.9",
       "compatibilityPromise": "preserved-through-the-v3-major-line",
       "deprecationReplacement": "",
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -2009,7 +2011,7 @@
       "status": "preview",
       "owner": "buildchain-workflows",
       "maturity": "preview",
-      "introducedVersion": "3.0.9-alpha.7",
+      "introducedVersion": "3.0.9-alpha.9",
       "compatibilityPromise": "preserved-through-the-v3-major-line",
       "deprecationReplacement": "",
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -2059,7 +2061,7 @@
       "status": "preview",
       "owner": "buildchain-workflows",
       "maturity": "preview",
-      "introducedVersion": "3.0.9-alpha.7",
+      "introducedVersion": "3.0.9-alpha.9",
       "compatibilityPromise": "preserved-through-the-v3-major-line",
       "deprecationReplacement": "",
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",

package/docs/MAP.md

@@ -107,6 +107,7 @@ replace them.
 | How do I install a standalone binary or npm package? | [`install.md`](install.md) | use | stable |
 | How do I run or look up the `buildchain` CLI? | [`cli-reference.md`](cli-reference.md) + [`cli.md`](cli.md) | use | stable |
 | How do I import Buildchain toolkit APIs from JavaScript build code? | [`node-api-reference.md`](node-api-reference.md) + [`../packages/core/README.md`](../packages/core/README.md) | use | stable |
+| How are bounded Qualification Leases separated from exclusive merge-group Landing authority? | [`dev-delivery-qualification-landing-adr.md`](dev-delivery-qualification-landing-adr.md) + [`dev-delivery-warrant.md`](dev-delivery-warrant.md) | govern | accepted |
 | How do I initialize a new repository? | [`getting-started.md`](getting-started.md) + [`lifecycle-protocol.md`](lifecycle-protocol.md) | use | stable |
 | Why does Buildchain use branch-driven release governance? | [`release-governance.md`](release-governance.md) | why | stable |
 | What freezes the v4 dependency direction, writer authority, complexity budgets, exceptions, and N-1 qualification? | [`../architecture/v4-architecture-constitution.md`](../architecture/v4-architecture-constitution.md) | why/verify | preview |