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

package/bin/buildchain.mjs

@@ -1378,6 +1378,10 @@ async function handleDevCommand(args) {
       runScript("dev-delivery-warrant.mjs", devArgs);
       return;
     }
+    if (subcommand === "authority") {
+      runScript("dev-delivery-authority.mjs", devArgs);
+      return;
+    }
     if (subcommand === "proof") {
       runScript("dev-delivery-proof.mjs", devArgs);
       return;
@@ -1387,7 +1391,7 @@ async function handleDevCommand(args) {
       return;
     }
     if (subcommand !== "merge-queue") {
-      throw new Error("usage: buildchain dev <pr-admit|merge-queue|warrant|proof|two-phase> [options]");
+      throw new Error("usage: buildchain dev <pr-admit|merge-queue|warrant|authority|proof|two-phase> [options]");
     }
     runScript("dev-merge-queue.mjs", devArgs);
     return;

package/contracts/dev-delivery-authority-v2.schema.json

@@ -0,0 +1,253 @@
+{
+  "$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/agent-index.json

@@ -22,6 +22,7 @@
     "schemas/release-tail-provider-bindings-v1.schema.json",
     "schemas/kfd-agent-hub-adoption.schema.json",
     "schemas/kfd-product-gate-input-v1.schema.json",
+    "schemas/dev-delivery-authority-v2.schema.json",
     "buildchain-contract.json",
     "kfd-upstream-aggregate.json",
     "kfd-claims.json",

package/dist/site/artifact-schemas.json

@@ -10,6 +10,7 @@
     "schemas/release-tail-provider-bindings-v1.schema.json",
     "schemas/kfd-agent-hub-adoption.schema.json",
     "schemas/kfd-product-gate-input-v1.schema.json",
+    "schemas/dev-delivery-authority-v2.schema.json",
     "kfd-support.json",
     "artifact-evidence.json",
     "product-mechanism.json",
@@ -47,6 +48,7 @@
     "schemas/release-tail-provider-bindings-v1.schema.json",
     "schemas/kfd-agent-hub-adoption.schema.json",
     "schemas/kfd-product-gate-input-v1.schema.json",
+    "schemas/dev-delivery-authority-v2.schema.json",
     "buildchain-contract.json",
     "kfd-claims.json",
     "product-mechanism.json",

package/dist/site/buildchain-contract.json

@@ -4,7 +4,7 @@
   "product": {
     "name": "Buildchain",
     "package": "@kungfu-tech/buildchain",
-    "version": "3.0.9-alpha.8",
+    "version": "3.0.9-alpha.9",
     "repository": "https://github.com/kungfu-systems/buildchain"
   },
   "majorLine": "v3",
@@ -575,7 +575,7 @@
         "resume-from-candidate-run is fail-closed and uses a fresh caller event instead of rerunning a frozen startup graph"
       ],
       "breakingDigest": "sha256:9db8dd07152855d03ff30f9c571438593c689d3e8139fa45431d000f548242f5",
-      "auditDigest": "sha256:d58c6ca74c7ac1defb9dcc35e26b6dde097b82f6aaea4e2c71e90ea15887158e",
+      "auditDigest": "sha256:27d35c025cbf7b5c87af599da3559657fc1aea88cf9d912a8035ccc1e7057c07",
       "compatibleBreakingDigests": [
         "sha256:aa30f22e3af0a89841310bdbdc900844dd95a66974db173fa140a71bbd7e82c0"
       ],
@@ -1035,7 +1035,7 @@
         "README badge block checks and writes are generated from machine-readable repository facts"
       ],
       "breakingDigest": "sha256:90a73892b2d6c214048448d5f45df75639bdf7b7e8fefd9c596e04b087407bcc",
-      "auditDigest": "sha256:eb793611ddb1463f4e9414a6d861d9573f737485b4a57ac6e86cc4ed8a928b35"
+      "auditDigest": "sha256:856e79ff668877e0b366850bb0e37fa193206f8dc5a51091bc74dd1c2240f8e2"
     },
     {
       "contractVersion": 1,
@@ -1125,7 +1125,7 @@
         "manual entries carry source file digests so downstream sites and agents can detect stale hand-written documentation"
       ],
       "breakingDigest": "sha256:7d0d2819e3a3e72989d9c57b5efe9d0bc0a79bc0f2c82a0c7b9d6c5a211a91f2",
-      "auditDigest": "sha256:68a70c70463b5a5baa36201e17b487c266a3945306eaa90f2afc9f9bc09c76ca"
+      "auditDigest": "sha256:76c7533430e36b4675b960be6a9bfa027db80638f87fb1a760ccd47c149531bb"
     },
     {
       "contractVersion": 1,
@@ -1147,7 +1147,7 @@
         "agents can discover supported Node APIs without importing internal file paths"
       ],
       "breakingDigest": "sha256:48f925608d3e2131d90936b07dc2a30341204cae3e6e785c0f77d61ad755c945",
-      "auditDigest": "sha256:60c1db203ba2c8b505bb5dfead664eb1d4c2384958b6f83a66e082a3ab3b64c9"
+      "auditDigest": "sha256:77d83706fea0f37219e8dbb5c84db17e2caac44a568caa7085dfef4a8548d6b1"
     },
     {
       "contractVersion": 1,
@@ -3869,7 +3869,7 @@
         "missing receipts are non-qualifying and must not be represented as a successful controller run"
       ],
       "breakingDigest": "sha256:015d8de793adbd4c539416be7d7512e18cc92097e629b0203fa06d2c183e98bd",
-      "auditDigest": "sha256:d58c6ca74c7ac1defb9dcc35e26b6dde097b82f6aaea4e2c71e90ea15887158e"
+      "auditDigest": "sha256:27d35c025cbf7b5c87af599da3559657fc1aea88cf9d912a8035ccc1e7057c07"
     },
     {
       "contractVersion": 1,
@@ -4084,5 +4084,5 @@
   ],
   "compatibilityProofRegistryRoot": "sha256:aec674d174461493e3493b3fe3164d62745a9ce18cb6a560f94bd99f2759eb53",
   "compatibilityDigest": "sha256:eb2fafb181b33002f81102a966f0a801ab1798101446635703ab6acfea51d9aa",
-  "contractDigest": "sha256:bfc0e67dd0efac270aabe73b19183d410da62d3ea446d55fe90ab4c919451dfa"
+  "contractDigest": "sha256:68b34e019870d326f662de17cdf959bd916d9c04ae3b5040f2836af569bb8e10"
 }