@kungfu-tech/buildchain 4.0.1-alpha.5 → 4.0.1-alpha.6

package/dist/site/public-surface-audit.json

@@ -3,15 +3,20 @@
   "contract": "kungfu-buildchain-public-surface-reverse-audit",
   "status": "passed",
   "summary": {
-    "cliCommandCount": 116,
-    "workflowCount": 72,
+    "cliCommandCount": 117,
+    "workflowCount": 75,
     "actionCount": 7,
-    "sitePageCount": 80,
-    "docCommandRefCount": 1025,
+    "sitePageCount": 82,
+    "docCommandRefCount": 1049,
     "failureCount": 0
   },
   "enumerated": {
     "cliCommands": [
+      {
+        "id": "adopter-delivery",
+        "source": "bin/buildchain.mjs",
+        "usage": "buildchain adopter-delivery run --input <json-or-path> [--output <path>]"
+      },
       {
         "id": "architecture",
         "source": "bin/buildchain.mjs",
@@ -2803,22 +2808,28 @@
         "reusable": true,
         "inputs": [
           "buildchain-ref",
+          "candidate-root",
           "declaration-path",
           "execute",
           "provider-bindings-path",
+          "rehearsal-authority-path",
+          "rehearsal-capsule-path",
+          "rehearsal-evidence-path",
+          "rehearsal-mode",
           "state-path"
         ],
-        "inputCount": 5,
+        "inputCount": 10,
         "secrets": [
           "http-token"
         ],
         "secretCount": 1,
         "outputs": [
+          "rehearsal-evidence-root",
           "state-root",
           "transaction-root",
           "transaction-state"
         ],
-        "outputCount": 3
+        "outputCount": 4
       },
       {
         "id": "release-verify",
@@ -2891,6 +2902,34 @@
         ],
         "outputCount": 6
       },
+      {
+        "id": "v4-adopter-delivery-dogfood",
+        "path": ".github/workflows/v4-adopter-delivery-dogfood.yml",
+        "reusable": false,
+        "inputs": [],
+        "inputCount": 0,
+        "secrets": [],
+        "secretCount": 0,
+        "outputs": [],
+        "outputCount": 0
+      },
+      {
+        "id": "v4-adopter-delivery",
+        "path": ".github/workflows/v4-adopter-delivery.yml",
+        "reusable": true,
+        "inputs": [
+          "archive-path",
+          "bootstrap-path",
+          "consumer",
+          "input-path",
+          "node-version"
+        ],
+        "inputCount": 5,
+        "secrets": [],
+        "secretCount": 0,
+        "outputs": [],
+        "outputCount": 0
+      },
       {
         "id": "v4-public-consumer-dogfood",
         "path": ".github/workflows/v4-public-consumer-dogfood.yml",
@@ -2902,6 +2941,17 @@
         "outputs": [],
         "outputCount": 0
       },
+      {
+        "id": "v4-publication-rehearsal-dogfood",
+        "path": ".github/workflows/v4-publication-rehearsal-dogfood.yml",
+        "reusable": false,
+        "inputs": [],
+        "inputCount": 0,
+        "secrets": [],
+        "secretCount": 0,
+        "outputs": [],
+        "outputCount": 0
+      },
       {
         "id": "v4-stage-capsule-canary",
         "path": ".github/workflows/v4-stage-capsule-canary.yml",
@@ -3077,6 +3127,7 @@
           "release-passport-promotion-routing-json",
           "release-passport-v4-consumer-policy-certification-json",
           "release-passport-v4-consumer-policy-certification-root",
+          "release-passport-v4-runtime-resume-evidence-command",
           "release-passport-v4-runtime-resume-evidence-json",
           "release-tail-state-path",
           "require-governance",
@@ -3091,20 +3142,25 @@
           "transaction-state-path",
           "verification-command"
         ],
-        "inputCount": 83
+        "inputCount": 84
       },
       {
         "id": "release-tail",
         "path": "actions/release-tail/action.yml",
         "inputs": [
+          "candidate-root",
           "declaration",
           "execute",
           "github-token",
           "http-token",
           "provider-bindings",
+          "rehearsal-authority",
+          "rehearsal-capsule",
+          "rehearsal-evidence-path",
+          "rehearsal-mode",
           "state-path"
         ],
-        "inputCount": 6
+        "inputCount": 11
       },
       {
         "id": "report-buildchain-issue",
@@ -3473,6 +3529,10 @@
         "id": "manual:toolkit-observability",
         "category": "manual"
       },
+      {
+        "id": "manual:v4-adopter-delivery",
+        "category": "manual"
+      },
       {
         "id": "manual:v4-canonical-contracts",
         "category": "manual"
@@ -3493,6 +3553,10 @@
         "id": "manual:v4-production-release",
         "category": "manual"
       },
+      {
+        "id": "manual:v4-publication-rehearsal",
+        "category": "manual"
+      },
       {
         "id": "manual:v4-runtime-ref-resume-authority",
         "category": "manual"
@@ -3519,6 +3583,106 @@
       }
     ],
     "docCommandRefs": [
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery archive --input"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery bootstrap --input"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery run --input"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery verify --input"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery --help"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery archive"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery archive --help"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery bootstrap"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery bootstrap --help"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery run"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery run --help"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery verify"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain adopter-delivery verify --help"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/cli.md",
+        "command": "buildchain adopter-delivery"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/v4-adopter-delivery.md",
+        "command": "buildchain adopter-delivery run"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/v4-adopter-delivery.md",
+        "command": "buildchain adopter-delivery verify"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/v4-adopter-delivery.md",
+        "command": "buildchain adopter-delivery bootstrap"
+      },
+      {
+        "id": "adopter-delivery",
+        "path": "docs/v4-adopter-delivery.md",
+        "command": "buildchain adopter-delivery archive"
+      },
       {
         "id": "architecture",
         "path": "docs/cli-reference.md",
@@ -7839,6 +8003,11 @@
         "path": "docs/cli-reference.md",
         "command": "buildchain release-tail plan --declaration"
       },
+      {
+        "id": "release-tail",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain release-tail rehearse --capsule"
+      },
       {
         "id": "release-tail",
         "path": "docs/cli-reference.md",
@@ -7889,6 +8058,16 @@
         "path": "docs/cli-reference.md",
         "command": "buildchain release-tail plan --help"
       },
+      {
+        "id": "release-tail",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain release-tail rehearse"
+      },
+      {
+        "id": "release-tail",
+        "path": "docs/cli-reference.md",
+        "command": "buildchain release-tail rehearse --help"
+      },
       {
         "id": "release-tail",
         "path": "docs/cli-reference.md",
@@ -7929,6 +8108,11 @@
         "path": "docs/release-tail-provider-plane.md",
         "command": "buildchain release-tail plan"
       },
+      {
+        "id": "release-tail",
+        "path": "docs/v4-publication-rehearsal.md",
+        "command": "buildchain release-tail rehearse"
+      },
       {
         "id": "release-transaction",
         "path": "docs/cli-reference.md",
@@ -8650,9 +8834,9 @@
     "cliRegistryPath": "dist/site/cli-registry.json",
     "workflowRegistryPath": "dist/site/workflow-registry.json",
     "pageRegistryPath": "dist/site/page-registry.json",
-    "cliRegistryDigest": "c240837b7885defa68e300e6b6178557824f7bd4dce8f258115b990516bf63c7",
-    "workflowRegistryDigest": "732b7a2a25f9b9b6beda4158da29240c186df7eb45a14fb12cb285423b5c9831",
-    "pageRegistryDigest": "d0893422eaf356b36a0439e573beaa4da56466293d2a47a5f7769ec82844ffb3"
+    "cliRegistryDigest": "ea47a31ce7ef3577f23e22055ab7be7715c3af494bcef63f76b426f2883086aa",
+    "workflowRegistryDigest": "2cdcfbc918836acb525f7d7cc84fcae983a4efcc77e81c786eb8b60ebe753b7c",
+    "pageRegistryDigest": "5b124e74cf384db9c91e0a1738e2cf3f7673ced3ca5020933069dead54858c71"
   },
   "comparison": {
     "missingCliRegistry": [],

package/dist/site/publication-authority-registry.json

@@ -1152,9 +1152,7 @@
     },
     {
       "path": ".github/workflows/release-tail.yml",
-      "signals": [
-        "write-permission"
-      ],
+      "signals": [],
       "classified": true
     },
     {
@@ -1181,11 +1179,26 @@
       ],
       "classified": true
     },
+    {
+      "path": ".github/workflows/v4-adopter-delivery-dogfood.yml",
+      "signals": [],
+      "classified": false
+    },
+    {
+      "path": ".github/workflows/v4-adopter-delivery.yml",
+      "signals": [],
+      "classified": false
+    },
     {
       "path": ".github/workflows/v4-public-consumer-dogfood.yml",
       "signals": [],
       "classified": false
     },
+    {
+      "path": ".github/workflows/v4-publication-rehearsal-dogfood.yml",
+      "signals": [],
+      "classified": false
+    },
     {
       "path": ".github/workflows/v4-stage-capsule-canary.yml",
       "signals": [],
@@ -1202,5 +1215,5 @@
       "classified": false
     }
   ],
-  "registryDigest": "95e7d88ca3d3492b7852d715c24d3f4f2cec59f3c3fbb8665aa781d15afd6b63"
+  "registryDigest": "2a7f4639a659489a0ef229983fff39d1c7880fb464411761f9debcbbd93bd336"
 }

package/dist/site/publication-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "contract": "kungfu-buildchain-publication-release-registry",
-  "generatedAt": "2026-08-16T06:14:57.817Z",
-  "publishedAt": "2026-08-16T06:14:57.817Z",
+  "generatedAt": "2026-08-16T16:19:04.257Z",
+  "publishedAt": "2026-08-16T16:19:04.257Z",
   "reproducible": true,
   "timestampPolicy": "ci-injected",
   "deterministicInputs": [
@@ -19,7 +19,7 @@
     "declared Buildchain surface manifest contract"
   ],
   "sourceDateEpoch": "0",
-  "sourceRevision": "358df2d1ab42465111896a42cde85dcca08549d5",
+  "sourceRevision": "71350662d0ab74d154a80fe1384b6ff6c82fc7c2",
   "timestampPolicyDetails": {
     "contract": "kungfu-buildchain-surface-timestamp-policy",
     "timestampFields": [
@@ -32,7 +32,7 @@
   },
   "package": {
     "name": "@kungfu-tech/buildchain",
-    "version": "4.0.1-alpha.5",
+    "version": "4.0.1-alpha.6",
     "versionSource": "package.json#version"
   },
   "sourceKind": "package-site-bundle",

package/dist/site/release-provenance.json

@@ -43,6 +43,17 @@
       "./v4-runtime-ref-resume-authority": "./packages/core/v4-runtime-ref-resume-authority.js",
       "./v4-tail-reseal": "./packages/core/v4-tail-reseal.js",
       "./v4-tail-reseal-receipt": "./packages/core/v4-tail-reseal-receipt.js",
+      "./v4-publication-rehearsal": "./packages/core/v4-publication-rehearsal.js",
+      "./adopter-delivery-gate": "./packages/core/adopter-delivery-gate.js",
+      "./kfd-adopter-category-driver": "./packages/core/kfd-adopter-category-driver.js",
+      "./buildchain-delivery-infrastructure": "./packages/core/buildchain-delivery-infrastructure.js",
+      "./buildchain-delivery-bootstrap": "./packages/core/buildchain-delivery-bootstrap.js",
+      "./buildchain-delivery-self-dogfood": "./packages/core/buildchain-delivery-self-dogfood.js",
+      "./published-delivery-authority": "./packages/core/published-delivery-authority.js",
+      "./legacy-kfd-adopter-driver": "./packages/core/legacy-kfd-adopter-driver.js",
+      "./adopter-delivery-passport": "./packages/core/adopter-delivery-passport.js",
+      "./adopter-delivery-vectors": "./packages/core/adopter-delivery-vectors.js",
+      "./v4-adopter-delivery": "./packages/core/v4-adopter-delivery.js",
       "./logging": "./packages/core/logging.js",
       "./portable-dev-cache": "./packages/core/portable-dev-cache.js",
       "./publication-artifact": "./packages/core/publication-artifact.js",
@@ -96,6 +107,9 @@
       "./site/schemas/kfd-support-projection-v1.schema.json": "./dist/site/schemas/kfd-support-projection-v1.schema.json",
       "./site/schemas/dev-delivery-authority-v2.schema.json": "./dist/site/schemas/dev-delivery-authority-v2.schema.json",
       "./site/schemas/v4-compatibility-facts-v1.schema.json": "./dist/site/schemas/v4-compatibility-facts-v1.schema.json",
+      "./site/schemas/v4-publication-rehearsal-capsule-v1.schema.json": "./dist/site/schemas/v4-publication-rehearsal-capsule-v1.schema.json",
+      "./site/schemas/v4-adopter-delivery-v1.schema.json": "./dist/site/schemas/v4-adopter-delivery-v1.schema.json",
+      "./site/schemas/release-tail-capabilities-v1.schema.json": "./dist/site/schemas/release-tail-capabilities-v1.schema.json",
       "./site/buildchain-contract.json": "./dist/site/buildchain-contract.json",
       "./site/product-mechanism.json": "./dist/site/product-mechanism.json",
       "./site/release-provenance.json": "./dist/site/release-provenance.json",

package/dist/site/schemas/release-tail-capabilities-v1.schema.json

@@ -0,0 +1,199 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://buildchain.kungfu.ai/contracts/release-tail-capabilities-v1.schema.json",
+  "title": "Buildchain release-tail capability declaration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contract",
+    "schemaVersion",
+    "transactionPolicy",
+    "subject",
+    "capabilities"
+  ],
+  "properties": {
+    "contract": {
+      "const": "kungfu-buildchain-release-tail-capabilities"
+    },
+    "schemaVersion": {
+      "const": 1
+    },
+    "transactionPolicy": {
+      "const": "buildchain.release-tail/v1"
+    },
+    "subject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repository", "sourceSha", "version", "tag", "channel"],
+      "properties": {
+        "repository": { "type": "string", "minLength": 1 },
+        "sourceSha": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
+        "version": { "type": "string", "minLength": 1 },
+        "tag": { "type": "string", "minLength": 1 },
+        "channel": { "enum": ["alpha", "release", "stable"] }
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/capability" }
+    }
+  },
+  "$defs": {
+    "root": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "capability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "executor",
+        "adapter",
+        "artifactRoles",
+        "destination",
+        "channelPolicy",
+        "activationPolicy",
+        "readbackPredicates",
+        "effect",
+        "observation",
+        "receipt",
+        "operationIdentity",
+        "idempotency",
+        "retry",
+        "evidenceRequirements"
+      ],
+      "properties": {
+        "id": {
+          "enum": [
+            "artifact.publish",
+            "signed-channel.commit",
+            "release.activate",
+            "released-evidence.synthesize"
+          ]
+        },
+        "executor": { "enum": ["buildchain-core", "provider-adapter"] },
+        "adapter": { "type": "string", "minLength": 1 },
+        "artifactRoles": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["role", "root"],
+            "properties": {
+              "role": { "type": "string", "minLength": 1 },
+              "root": { "$ref": "#/$defs/root" }
+            }
+          }
+        },
+        "destination": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "locator"],
+          "properties": {
+            "kind": { "type": "string", "minLength": 1 },
+            "locator": { "type": "string", "minLength": 1 }
+          }
+        },
+        "channelPolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["channel", "tagPattern", "authorityMove"],
+          "properties": {
+            "channel": { "enum": ["alpha", "release", "stable"] },
+            "tagPattern": { "type": "string", "minLength": 1 },
+            "authorityMove": { "enum": ["none", "signed-cas", "verified-ref"] }
+          }
+        },
+        "activationPolicy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["mode", "environment"],
+          "properties": {
+            "mode": { "enum": ["none", "receipt-set", "receipt-only"] },
+            "environment": { "enum": ["none", "shadow", "production"] }
+          }
+        },
+        "readbackPredicates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "kind", "expected"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "kind": { "type": "string", "minLength": 1 },
+              "expected": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "effect": { "$ref": "#/$defs/message" },
+        "observation": { "$ref": "#/$defs/message" },
+        "receipt": { "$ref": "#/$defs/message" },
+        "operationIdentity": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "transactionRoot",
+            "capabilityId",
+            "subjectRoot",
+            "targetRoot",
+            "attemptKey"
+          ],
+          "properties": {
+            "transactionRoot": { "$ref": "#/$defs/root" },
+            "capabilityId": {
+              "enum": [
+                "artifact.publish",
+                "signed-channel.commit",
+                "release.activate",
+                "released-evidence.synthesize"
+              ]
+            },
+            "subjectRoot": { "$ref": "#/$defs/root" },
+            "targetRoot": { "$ref": "#/$defs/root" },
+            "attemptKey": { "type": "string", "minLength": 1 }
+          }
+        },
+        "idempotency": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["scope", "duplicate"],
+          "properties": {
+            "scope": { "enum": ["operation", "subject-target"] },
+            "duplicate": {
+              "enum": ["return-observed-receipt", "readback-before-retry"]
+            }
+          }
+        },
+        "retry": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["class", "localAttempts", "exhausted"],
+          "properties": {
+            "class": { "enum": ["never", "readback", "provider-transient"] },
+            "localAttempts": { "type": "integer", "minimum": 0, "maximum": 3 },
+            "exhausted": {
+              "enum": ["blocked", "repair-required", "terminal-failure"]
+            }
+          }
+        },
+        "evidenceRequirements": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "message": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "schema"],
+      "properties": {
+        "kind": { "type": "string", "minLength": 1 },
+        "schema": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}