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

package/dist/site/capability-registry.json

@@ -15,7 +15,7 @@
       "maturity": "stable",
       "counts": {
         "manualCount": 4,
-        "pageCount": 16,
+        "pageCount": 17,
         "cliCommandCount": 9,
         "nodeApiCount": 0,
         "workflowCount": 0,
@@ -51,7 +51,7 @@
         "manualCount": 7,
         "pageCount": 8,
         "cliCommandCount": 27,
-        "nodeApiCount": 18,
+        "nodeApiCount": 21,
         "workflowCount": 4,
         "actionCount": 3
       },
@@ -85,10 +85,10 @@
       ],
       "maturity": "stable",
       "counts": {
-        "manualCount": 5,
-        "pageCount": 18,
-        "cliCommandCount": 9,
-        "nodeApiCount": 9,
+        "manualCount": 6,
+        "pageCount": 19,
+        "cliCommandCount": 10,
+        "nodeApiCount": 15,
         "workflowCount": 4,
         "actionCount": 2
       },
@@ -97,7 +97,8 @@
         "docs/controller-evidence.md",
         "docs/release-candidate.md",
         "docs/lifecycle-protocol.md",
-        "docs/reusable-build-surface.md"
+        "docs/reusable-build-surface.md",
+        "docs/v4-adopter-delivery.md"
       ],
       "factSources": [
         "page-registry.json",
@@ -123,7 +124,7 @@
         "manualCount": 2,
         "pageCount": 2,
         "cliCommandCount": 37,
-        "nodeApiCount": 9,
+        "nodeApiCount": 11,
         "workflowCount": 0,
         "actionCount": 0
       },
@@ -297,7 +298,7 @@
         "pageCount": 11,
         "cliCommandCount": 0,
         "nodeApiCount": 2,
-        "workflowCount": 43,
+        "workflowCount": 46,
         "actionCount": 1
       },
       "manuals": [

package/dist/site/cli-registry.json

@@ -5,6 +5,51 @@
   "npmPackage": "@kungfu-tech/buildchain",
   "commandSource": "bin/internal/command-registry.mjs plus bin/buildchain.mjs help enumeration",
   "commands": [
+    {
+      "id": "adopter-delivery",
+      "source": "bin/buildchain.mjs",
+      "usage": "buildchain adopter-delivery run --input <json-or-path> [--output <path>]",
+      "paths": [
+        "adopter-delivery",
+        "adopter-delivery archive",
+        "adopter-delivery bootstrap",
+        "adopter-delivery run",
+        "adopter-delivery verify"
+      ],
+      "syntaxes": [
+        "buildchain adopter-delivery",
+        "buildchain adopter-delivery archive --input <json-or-path> [--output <path>]",
+        "buildchain adopter-delivery bootstrap --input <json-or-path> [--output <path>]",
+        "buildchain adopter-delivery run --input <json-or-path> [--output <path>]",
+        "buildchain adopter-delivery verify --input <json-or-path> --readback <json-or-path> [--output <path>]"
+      ],
+      "options": [
+        "--input",
+        "--output",
+        "--readback"
+      ],
+      "aliases": [],
+      "helpCommands": [
+        "buildchain adopter-delivery --help",
+        "buildchain adopter-delivery archive --help",
+        "buildchain adopter-delivery bootstrap --help",
+        "buildchain adopter-delivery run --help",
+        "buildchain adopter-delivery verify --help"
+      ],
+      "purpose": "Run public protocol-neutral adopter delivery, exact readback, N-1 bootstrap, and published archive checks.",
+      "capabilityGroup": "reusable-build",
+      "audience": [
+        "agent",
+        "operator"
+      ],
+      "owner": "buildchain-cli",
+      "maturity": "stable",
+      "introducedVersion": "pre-3.0.2-alpha.4",
+      "compatibilityPromise": "preserved-through-the-v3-major-line",
+      "deprecationReplacement": "",
+      "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
+      "nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
+    },
     {
       "id": "architecture",
       "source": "bin/buildchain.mjs",
@@ -3544,6 +3589,7 @@
         "release-tail compat",
         "release-tail init",
         "release-tail plan",
+        "release-tail rehearse",
         "release-tail status",
         "release-tail verify"
       ],
@@ -3552,11 +3598,16 @@
         "buildchain release-tail <status|verify> [--state <path>] [--output <path>]",
         "buildchain release-tail compat --hooks-json <json-or-path> [--output <path>]",
         "buildchain release-tail init --declaration <json-or-path> [--state <path>]",
-        "buildchain release-tail plan --declaration <json-or-path> [--output <path>]"
+        "buildchain release-tail plan --declaration <json-or-path> [--output <path>]",
+        "buildchain release-tail rehearse --capsule <absolute-path> --candidate-root <absolute-path> --mode <simulate|replay> --state <absolute-path> --evidence <absolute-path>"
       ],
       "options": [
+        "--candidate-root",
+        "--capsule",
         "--declaration",
+        "--evidence",
         "--hooks-json",
+        "--mode",
         "--output",
         "--state"
       ],
@@ -3566,6 +3617,7 @@
         "buildchain release-tail compat --help",
         "buildchain release-tail init --help",
         "buildchain release-tail plan --help",
+        "buildchain release-tail rehearse --help",
         "buildchain release-tail status --help",
         "buildchain release-tail verify --help"
       ],

package/dist/site/kfd-claims.json

@@ -21,13 +21,13 @@
     "contract": "kungfu-buildchain-public-surface-reverse-audit",
     "path": "dist/site/public-surface-audit.json",
     "status": "passed",
-    "sha256": "992ca2b4be3a3e80177648fee1f8c4e46a7859ad41bddf0ac54316f9d2c2752d",
+    "sha256": "4e1fa00a7188f43a5714e4d7a0c87c302dc3fc8cb80e3b9c87da9c970e6819c2",
     "summary": {
-      "cliCommandCount": 116,
-      "workflowCount": 72,
+      "cliCommandCount": 117,
+      "workflowCount": 75,
       "actionCount": 7,
-      "sitePageCount": 80,
-      "docCommandRefCount": 1025,
+      "sitePageCount": 82,
+      "docCommandRefCount": 1049,
       "failureCount": 0
     },
     "auditBoundary": {
@@ -246,13 +246,13 @@
       "contract": "kungfu-buildchain-public-surface-reverse-audit",
       "path": "dist/site/public-surface-audit.json",
       "status": "passed",
-      "sha256": "992ca2b4be3a3e80177648fee1f8c4e46a7859ad41bddf0ac54316f9d2c2752d",
+      "sha256": "4e1fa00a7188f43a5714e4d7a0c87c302dc3fc8cb80e3b9c87da9c970e6819c2",
       "summary": {
-        "cliCommandCount": 116,
-        "workflowCount": 72,
+        "cliCommandCount": 117,
+        "workflowCount": 75,
         "actionCount": 7,
-        "sitePageCount": 80,
-        "docCommandRefCount": 1025,
+        "sitePageCount": 82,
+        "docCommandRefCount": 1049,
         "failureCount": 0
       },
       "auditBoundary": {
@@ -824,6 +824,18 @@
           "public": true,
           "plane": "use"
         },
+        {
+          "id": "doc:docs/v4-adopter-delivery.md",
+          "name": "V4 public adopter delivery",
+          "kind": "documentation",
+          "sourcePath": "docs/v4-adopter-delivery.md",
+          "evidencePath": "docs/v4-adopter-delivery.md",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "plane": "verify"
+        },
         {
           "id": "doc:docs/v4-compatibility-facts.md",
           "name": "Buildchain v4 compatibility Facts",
@@ -1640,6 +1652,138 @@
           "public": true,
           "packageExport": "./v4-tail-reseal-receipt"
         },
+        {
+          "id": "export:./v4-publication-rehearsal",
+          "name": "@kungfu-tech/buildchain/v4-publication-rehearsal",
+          "kind": "package-export",
+          "sourcePath": "packages/core/v4-publication-rehearsal.js",
+          "evidencePath": "packages/core/v4-publication-rehearsal.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./v4-publication-rehearsal"
+        },
+        {
+          "id": "export:./adopter-delivery-gate",
+          "name": "@kungfu-tech/buildchain/adopter-delivery-gate",
+          "kind": "package-export",
+          "sourcePath": "packages/core/adopter-delivery-gate.js",
+          "evidencePath": "packages/core/adopter-delivery-gate.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./adopter-delivery-gate"
+        },
+        {
+          "id": "export:./kfd-adopter-category-driver",
+          "name": "@kungfu-tech/buildchain/kfd-adopter-category-driver",
+          "kind": "package-export",
+          "sourcePath": "packages/core/kfd-adopter-category-driver.js",
+          "evidencePath": "packages/core/kfd-adopter-category-driver.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./kfd-adopter-category-driver"
+        },
+        {
+          "id": "export:./buildchain-delivery-infrastructure",
+          "name": "@kungfu-tech/buildchain/buildchain-delivery-infrastructure",
+          "kind": "package-export",
+          "sourcePath": "packages/core/buildchain-delivery-infrastructure.js",
+          "evidencePath": "packages/core/buildchain-delivery-infrastructure.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./buildchain-delivery-infrastructure"
+        },
+        {
+          "id": "export:./buildchain-delivery-bootstrap",
+          "name": "@kungfu-tech/buildchain/buildchain-delivery-bootstrap",
+          "kind": "package-export",
+          "sourcePath": "packages/core/buildchain-delivery-bootstrap.js",
+          "evidencePath": "packages/core/buildchain-delivery-bootstrap.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./buildchain-delivery-bootstrap"
+        },
+        {
+          "id": "export:./buildchain-delivery-self-dogfood",
+          "name": "@kungfu-tech/buildchain/buildchain-delivery-self-dogfood",
+          "kind": "package-export",
+          "sourcePath": "packages/core/buildchain-delivery-self-dogfood.js",
+          "evidencePath": "packages/core/buildchain-delivery-self-dogfood.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./buildchain-delivery-self-dogfood"
+        },
+        {
+          "id": "export:./published-delivery-authority",
+          "name": "@kungfu-tech/buildchain/published-delivery-authority",
+          "kind": "package-export",
+          "sourcePath": "packages/core/published-delivery-authority.js",
+          "evidencePath": "packages/core/published-delivery-authority.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./published-delivery-authority"
+        },
+        {
+          "id": "export:./legacy-kfd-adopter-driver",
+          "name": "@kungfu-tech/buildchain/legacy-kfd-adopter-driver",
+          "kind": "package-export",
+          "sourcePath": "packages/core/legacy-kfd-adopter-driver.js",
+          "evidencePath": "packages/core/legacy-kfd-adopter-driver.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./legacy-kfd-adopter-driver"
+        },
+        {
+          "id": "export:./adopter-delivery-passport",
+          "name": "@kungfu-tech/buildchain/adopter-delivery-passport",
+          "kind": "package-export",
+          "sourcePath": "packages/core/adopter-delivery-passport.js",
+          "evidencePath": "packages/core/adopter-delivery-passport.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./adopter-delivery-passport"
+        },
+        {
+          "id": "export:./adopter-delivery-vectors",
+          "name": "@kungfu-tech/buildchain/adopter-delivery-vectors",
+          "kind": "package-export",
+          "sourcePath": "packages/core/adopter-delivery-vectors.js",
+          "evidencePath": "packages/core/adopter-delivery-vectors.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./adopter-delivery-vectors"
+        },
+        {
+          "id": "export:./v4-adopter-delivery",
+          "name": "@kungfu-tech/buildchain/v4-adopter-delivery",
+          "kind": "package-export",
+          "sourcePath": "packages/core/v4-adopter-delivery.js",
+          "evidencePath": "packages/core/v4-adopter-delivery.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./v4-adopter-delivery"
+        },
         {
           "id": "export:./logging",
           "name": "@kungfu-tech/buildchain/logging",
@@ -2224,6 +2368,18 @@
         }
       ],
       "reverseEnumeratedSurfaces": [
+        {
+          "id": "cli:adopter-delivery",
+          "name": "buildchain adopter-delivery run --input <json-or-path> [--output <path>]",
+          "kind": "cli-command",
+          "sourcePath": "bin/buildchain.mjs",
+          "evidencePath": "bin/buildchain.mjs",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "bin/buildchain.mjs"
+        },
         {
           "id": "cli:architecture",
           "name": "buildchain architecture validate [--cwd <dir>] [--json]",
@@ -5494,12 +5650,17 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 5,
+          "inputCount": 10,
           "inputs": [
             "buildchain-ref",
+            "candidate-root",
             "declaration-path",
             "execute",
             "provider-bindings-path",
+            "rehearsal-authority-path",
+            "rehearsal-capsule-path",
+            "rehearsal-evidence-path",
+            "rehearsal-mode",
             "state-path"
           ],
           "reverseAuditSource": ".github/workflows"
@@ -5577,6 +5738,40 @@
           ],
           "reverseAuditSource": ".github/workflows"
         },
+        {
+          "id": "workflow:v4-adopter-delivery-dogfood",
+          "name": "workflow:v4-adopter-delivery-dogfood",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/v4-adopter-delivery-dogfood.yml",
+          "evidencePath": ".github/workflows/v4-adopter-delivery-dogfood.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 0,
+          "inputs": [],
+          "reverseAuditSource": ".github/workflows"
+        },
+        {
+          "id": "workflow:v4-adopter-delivery",
+          "name": "workflow:v4-adopter-delivery",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/v4-adopter-delivery.yml",
+          "evidencePath": ".github/workflows/v4-adopter-delivery.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 5,
+          "inputs": [
+            "archive-path",
+            "bootstrap-path",
+            "consumer",
+            "input-path",
+            "node-version"
+          ],
+          "reverseAuditSource": ".github/workflows"
+        },
         {
           "id": "workflow:v4-public-consumer-dogfood",
           "name": "workflow:v4-public-consumer-dogfood",
@@ -5591,6 +5786,20 @@
           "inputs": [],
           "reverseAuditSource": ".github/workflows"
         },
+        {
+          "id": "workflow:v4-publication-rehearsal-dogfood",
+          "name": "workflow:v4-publication-rehearsal-dogfood",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/v4-publication-rehearsal-dogfood.yml",
+          "evidencePath": ".github/workflows/v4-publication-rehearsal-dogfood.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 0,
+          "inputs": [],
+          "reverseAuditSource": ".github/workflows"
+        },
         {
           "id": "workflow:v4-stage-capsule-canary",
           "name": "workflow:v4-stage-capsule-canary",
@@ -5719,7 +5928,7 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 83,
+          "inputCount": 84,
           "inputs": [
             "allow-repository",
             "branch-protection-bypass-apps",
@@ -5791,6 +6000,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",
@@ -5817,13 +6027,18 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 6,
+          "inputCount": 11,
           "inputs": [
+            "candidate-root",
             "declaration",
             "execute",
             "github-token",
             "http-token",
             "provider-bindings",
+            "rehearsal-authority",
+            "rehearsal-capsule",
+            "rehearsal-evidence-path",
+            "rehearsal-mode",
             "state-path"
           ],
           "reverseAuditSource": "actions/*/action.yml"
@@ -6769,6 +6984,18 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:manual:v4-adopter-delivery",
+          "name": "site-page:manual:v4-adopter-delivery",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
         {
           "id": "site-page:manual:v4-canonical-contracts",
           "name": "site-page:manual:v4-canonical-contracts",
@@ -6829,6 +7056,18 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:manual:v4-publication-rehearsal",
+          "name": "site-page:manual:v4-publication-rehearsal",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
         {
           "id": "site-page:manual:v4-runtime-ref-resume-authority",
           "name": "site-page:manual:v4-runtime-ref-resume-authority",
@@ -7072,6 +7311,6 @@
         }
       }
     ],
-    "publicSurfaceCount": 452
+    "publicSurfaceCount": 470
   }
 }

package/dist/site/kfd-upstream-aggregate.json

@@ -4,7 +4,7 @@
   "product": {
     "id": "kungfu-tech-buildchain",
     "name": "@kungfu-tech/buildchain",
-    "version": "4.0.1-alpha.5",
+    "version": "4.0.1-alpha.6",
     "repository": "https://github.com/kungfu-systems/buildchain"
   },
   "source": {

package/dist/site/manual-registry.json

@@ -9,7 +9,7 @@
       "title": "Buildchain documentation map",
       "path": "docs/MAP.md",
       "plane": "use",
-      "digest": "sha256:fd63caf537bdc0dc2a220688dcb89534f6f84f6223e8c45f399a7d1bb8f8faf8",
+      "digest": "sha256:a04d321dbec562807cb29b748039839d097a97d2c9d2f0e76d6d22f2845055ba",
       "capabilityGroup": "getting-started",
       "audience": [
         "agent",
@@ -333,7 +333,7 @@
       "title": "CLI and npm package",
       "path": "docs/cli.md",
       "plane": "use",
-      "digest": "sha256:fad47682ed909f7b16f58bb8c24c51a943eb704a0a50ab6e033d745ee16a809a",
+      "digest": "sha256:60208f0862195df44b27ada15e474ff1808dee6d492cd6303402b92fd72f06bc",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "agent",
@@ -347,7 +347,7 @@
       "title": "Generated CLI reference",
       "path": "docs/cli-reference.md",
       "plane": "use",
-      "digest": "sha256:157d6259dd8f884833f7065f52bff0d482878eca72623dcc607e4204692e4970",
+      "digest": "sha256:ec16f350596692989cf5eade945e7bbeee157a661c6d8faa55c8249b14ef5632",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "agent",
@@ -362,7 +362,7 @@
       "title": "Generated Node API reference",
       "path": "docs/node-api-reference.md",
       "plane": "use",
-      "digest": "sha256:34a2feafe2f6183afbc0a72fa6362d39db6968c2bac187a1a1dd376d7ca50e50",
+      "digest": "sha256:0732a6888896f492f6543c4c9b32a1aef58f0fe691977b961745e151178188e5",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "agent",
@@ -442,6 +442,21 @@
       "maturity": "stable",
       "order": 200
     },
+    {
+      "id": "v4-adopter-delivery",
+      "title": "V4 public adopter delivery",
+      "path": "docs/v4-adopter-delivery.md",
+      "plane": "verify",
+      "digest": "sha256:c74a004657f64d29ba2a47f599223e5ab132daf2881cf0564c85c04b22a69e6e",
+      "capabilityGroup": "reusable-build",
+      "audience": [
+        "consumer",
+        "developer",
+        "agent"
+      ],
+      "maturity": "preview",
+      "order": 205
+    },
     {
       "id": "publish-transaction",
       "title": "Publish transaction",
@@ -475,7 +490,7 @@
       "title": "Declarative release-tail provider plane",
       "path": "docs/release-tail-provider-plane.md",
       "plane": "use",
-      "digest": "sha256:80b39ba4f0a8ed723e2a03e7efff0fee1e891245f7d1bf343edc75011aded801",
+      "digest": "sha256:72dd8231f51003c8a0d6532991b908b39de02deb11300e8c63113cd3a9e5cd8e",
       "capabilityGroup": "release-passport-trust",
       "audience": [
         "release-operator",