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

package/actions/release-tail/README.md

@@ -11,3 +11,11 @@ not the adapter, compares the observed subject and target roots, owns retry and
 terminal classification, checkpoints state and emits the standardized receipt.
 Tokens remain Action inputs and are never written to the transaction or
 receipt.
+
+When `rehearsal-capsule` is supplied, the same Action switches to the v4
+Publication Rehearsal Capsule boundary. `simulate` and `replay` remain
+effect-disabled. `provider` additionally requires exact capsule-bound
+rehearsal authority, consumes only the capsule-rooted data bindings, and
+records every request/readback while still emitting
+`productionAuthority: false` and no Release Passport. See
+[`docs/v4-publication-rehearsal.md`](../../docs/v4-publication-rehearsal.md).

package/architecture/internal-capabilities.json

@@ -30,6 +30,9 @@
     "packages/core/release-tail-provider-plane.js",
     "packages/core/release-tail-provider-adapters.js",
     "packages/core/release-tail-compatibility.js",
+    "packages/core/v4-publication-rehearsal-capsule.js",
+    "packages/core/v4-publication-rehearsal-provider-bindings.js",
+    "packages/core/v4-publication-rehearsal.js",
     "actions/release-tail/index.js",
     "scripts/authorize-promotion-runtime-override.cjs",
     "scripts/build-contract-core.mjs",
@@ -115,6 +118,16 @@
     "crates/buildchain-v4-contracts/src/stable_publication_fence.rs",
     "packages/core/v4-partial-mutation-recovery-qualification.js",
     "crates/buildchain-v4-contracts/src/partial_mutation_recovery.rs",
+    "packages/core/adopter-delivery-gate.js",
+    "packages/core/adopter-delivery-passport.js",
+    "packages/core/adopter-delivery-vectors.js",
+    "packages/core/buildchain-delivery-bootstrap.js",
+    "packages/core/buildchain-delivery-infrastructure.js",
+    "packages/core/buildchain-delivery-self-dogfood.js",
+    "packages/core/kfd-adopter-category-driver.js",
+    "packages/core/legacy-kfd-adopter-driver.js",
+    "packages/core/published-delivery-authority.js",
+    "packages/core/v4-adopter-delivery.js",
     "packages/core/v4-adopter-delivery-parity.js",
     "crates/buildchain-v4-contracts/src/adopter_delivery.rs",
     "crates/buildchain-v4-contracts/src/compatibility_facts.rs",
@@ -462,6 +475,22 @@
         "docs/release-tail-provider-plane.md"
       ]
     },
+    {
+      "id": "v4-publication-rehearsal",
+      "owner": "Buildchain publication rehearsal maintainers",
+      "implementation": [
+        "packages/core/v4-publication-rehearsal-capsule.js",
+        "packages/core/v4-publication-rehearsal-provider-bindings.js",
+        "packages/core/v4-publication-rehearsal.js"
+      ],
+      "tests": ["tests/v4-publication-rehearsal.test.mjs"],
+      "contracts": [
+        "architecture/v4-publication-rehearsal-parity.json",
+        "contracts/v4-publication-rehearsal-capsule-v1.schema.json",
+        ".github/workflows/v4-publication-rehearsal-dogfood.yml",
+        "docs/v4-publication-rehearsal.md"
+      ]
+    },
     {
       "id": "v4-delivery-authority",
       "owner": "Buildchain protected delivery maintainers",
@@ -548,6 +577,41 @@
         "docs/v4-compatibility-facts.md"
       ]
     },
+    {
+      "id": "v4-adopter-delivery",
+      "owner": "Buildchain adopter delivery maintainers",
+      "implementation": [
+        "bin/internal/adopter-delivery-cli.mjs",
+        "packages/core/adopter-delivery-gate.js",
+        "packages/core/adopter-delivery-passport.js",
+        "packages/core/adopter-delivery-vectors.js",
+        "packages/core/buildchain-delivery-bootstrap.js",
+        "packages/core/buildchain-delivery-infrastructure.js",
+        "packages/core/buildchain-delivery-self-dogfood.js",
+        "packages/core/kfd-adopter-category-driver.js",
+        "packages/core/legacy-kfd-adopter-driver.js",
+        "packages/core/published-delivery-authority.js",
+        "packages/core/v4-adopter-delivery.js",
+        "packages/core/v4-adopter-delivery-parity.js",
+        "crates/buildchain-v4-contracts/src/adopter_delivery.rs"
+      ],
+      "tests": [
+        "tests/v4-adopter-delivery.test.mjs",
+        "tests/v4-adopter-delivery-parity.test.mjs"
+      ],
+      "contracts": [
+        "architecture/v4-adopter-delivery-parity.json",
+        "contracts/v4-adopter-delivery-v1.schema.json",
+        "contracts/fixtures/v4-adopter-delivery-v1/archive-template.json",
+        "contracts/fixtures/v4-adopter-delivery-v1/bootstrap-positive.json",
+        "contracts/fixtures/v4-adopter-delivery-v1/gate-positive.json",
+        "contracts/fixtures/v4-adopter-delivery-v1/gate-unknown-selector.json",
+        "contracts/fixtures/v4-adopter-delivery-v1/offline-vectors.json",
+        ".github/workflows/v4-adopter-delivery.yml",
+        ".github/workflows/v4-adopter-delivery-dogfood.yml",
+        "docs/v4-adopter-delivery.md"
+      ]
+    },
     {
       "id": "v4-architecture-governance",
       "owner": "Buildchain architecture maintainers",
@@ -562,7 +626,6 @@
         "packages/core/v4-release-activation-shadow.js",
         "packages/core/v4-stable-publication-fence.js",
         "packages/core/v4-partial-mutation-recovery-qualification.js",
-        "packages/core/v4-adopter-delivery-parity.js",
         "packages/core/v4-runtime-ref-resume-authority.js",
         "packages/core/v4-runtime-selector-persistence.js",
         "packages/core/v4-tail-reseal-contract.js",
@@ -588,8 +651,7 @@
         "crates/buildchain-v4-contracts/src/release_activation_shadow/model.rs",
         "crates/buildchain-v4-contracts/src/release_activation_shadow/journal.rs",
         "crates/buildchain-v4-contracts/src/stable_publication_fence.rs",
-        "crates/buildchain-v4-contracts/src/partial_mutation_recovery.rs",
-        "crates/buildchain-v4-contracts/src/adopter_delivery.rs"
+        "crates/buildchain-v4-contracts/src/partial_mutation_recovery.rs"
       ],
       "tests": [
         "tests/v4-architecture.test.mjs",
@@ -603,7 +665,6 @@
         "tests/v4-stage-capsule-store.test.mjs",
         "tests/v4-platform-stage-checkpoints.test.mjs",
         "tests/v4-stage-capsule-qualification.test.mjs",
-        "tests/v4-adopter-delivery-parity.test.mjs",
         "tests/v4-runtime-ref-resume-authority.test.mjs",
         "tests/v4-tail-reseal.test.mjs",
         "tests/v4-tail-reseal-parity.test.mjs"
@@ -623,7 +684,6 @@
         "architecture/v4-stage-capsule-store-contract.json",
         "architecture/v4-platform-stage-checkpoints.json",
         "architecture/v4-stage-capsule-qualification.json",
-        "architecture/v4-adopter-delivery-parity.json",
         "architecture/v4-runtime-ref-resume-authority.json",
         "contracts/v4-host-contract-v1.schema.json",
         "contracts/v4-provider-operation-journal-v1.schema.json",

package/architecture/maintainability-policy.json

@@ -5,12 +5,13 @@
   "enforcementRevision": "5308189b09bcb5a1314195412f2807a40d678838",
   "repositoryBudgets": {
     "baselineRevision": "c70e6ac28431888b24fefc218246cc69f8dde85a",
-    "maxHandMaintainedSourceFiles": 408,
-    "maxHandMaintainedSourceLines": 154384,
-    "maxWorkflowFiles": 72,
-    "maxWorkflowLines": 25634,
-    "latestTransition": "Compatibility Facts parity adds a closed public schema, split Rust and TypeScript KFR2 cores, append-only lifecycle verification, shared fail-closed fixtures, CLI and Node projections, Release Passport lineage evidence, and generated site facts.",
-    "rationale": "Bounded modules separate candidate, evidence, native proof and execution, canonical failure verification, closed-set execution transfer, process-boundary verification, Warrant state and qualification, authority state, qualification, Landing acquisition, verified-attempt admission, Landing settlement and fence validation, provider attempt and heartbeat readback, sealed terminal evidence, hosted heartbeat, resume, store, options, command-specific adapters, and CLI orchestration responsibilities. The protected delivery workflow gives candidate and seal jobs no provider write credential, recursively rejects transfer drift, scopes every transfer artifact to the exact provider run attempt, chains every durable heartbeat state and receipt root on a distinct hosted runner domain, and permits qualification or exact failure settlement only after the finalizer verifies live jobs and the latest durable authority state. Public Landing admission and heartbeat always perform non-injectable fresh exact-attempt provider readback, tolerate only a not-yet-materialized seal job while retaining exact native and duplicate-job rejection, and heartbeat-loss coordination never invokes GitHub's run-scoped cancellation API where a successor rerun could race. The hosted process boundary anchors trust in the kernel-resolved versioned Runner.Worker path while accepting an equivalent argv-zero spelling with the same basename; its public boundary marker is allowed only at the one exact non-secret value, so a forged value under the same credential-like name still fails closed. The credentialless transfer seal validates the rooted native reuse decision against the Warrant-bound source, closure, dependency, toolchain, environment and command inputs; qualifiedBase stays in the proof and decision where it is rooted and later independently rechecked, rather than being assumed on the Warrant schema. V2 mutation cannot initialize a second empty authority beside a legacy ref: migration reads and roots the canonical live v1 ref, rechecks it, applies the explicit configured v2 policy, and atomically replaces its bytes through one expected-old non-force update, so old v1 controllers fail closed while the prior commit remains immutable history. Candidate ancestry classifies the GitHub artifact runtime token as credential authority. Every Landing settlement, including an unexpired fence, requires product-owned terminal readback. Terminal cleanup reads the immutable historical attempt, derives workflow and hosted Landing job identity from live run data, reads the exact protected ref head and compares containment against that immutable SHA, and seals merged only when the admitted merge-group head is contained by that protected base; a later different-head merge settles the old attempt as dequeued. Terminal normalization preserves transfer, finalizer boundary, native and seal job, admitted provider attempt, protected-base head, containment result, and terminal readback coordinates. The public reusable workflow truthfully retains its single-flight v1 authority without advertising v2 migration, while bounded v2 remains a separate opt-in CLI, Node API, and schema contract; the tracked self-caller stays on public v4-alpha with matching stable and alpha locks, and transient train selection is dispatch-only. Next-development parity adds one versioned transition authority, one durable controller, one bounded reservation adapter, and pure public-contract recovery evidence while retaining the existing thin floating-channel callers byte-for-byte. The floating-consumer gate reuses the existing contract-world evaluator so SHA drift passes only under the selected lock's compatibility policy, breaking surface drift still fails closed, and external certification reconstructs the receipt from the observed workflow SHA rather than the lock's historical evidence SHA. Tail reseal adds no Stage Capsule effect or general rebuild authority: it verifies the exact retained four-platform bytes, admits one known macOS tail failure through live provider readback, fences signing and finalization to explicit credentials and Warrant identity, and requires standard candidate Passport plus provider and protected readback. Compatibility Facts parity isolates canonical encoding, temporal verification, lifecycle validation, fixture projection, public authority projection, and CLI adaptation into bounded modules; legacy digest and proof arrays are derived only from exact current Fact lineage. These exact 408-file, 154384-source-line, 72-workflow-file and 25634-workflow-line ceilings cannot grow implicitly."
+    "maxHandMaintainedSourceFiles": 422,
+    "maxHandMaintainedSourceLines": 158836,
+    "maxWorkflowFiles": 75,
+    "maxWorkflowLines": 25983,
+    "latestTransition": "Floating Alpha bootstrap routes only automatic Alpha self-promotion through the protected Alpha private shell while the old floating shell cannot carry its own repair; stable promotion remains on the public v4 wrapper.",
+    "latestTransitionRationale": "One credentialless resolver reuses the published promotion identity authority to bind the floating router and runtime, protected Alpha shell, and exact Alpha lock digest before that shell independently reproduces the external consumer-policy certification. The bounded route adds no manual publication, tag, ref, npm, stable, or public-consumer authority and is removed after the protected workflow promotion advances v4-alpha. These exact 422-file, 158836-source-line, 75-workflow-file and 25983-workflow-line ceilings add no unreviewed headroom or function-budget widening.",
+    "rationale": "Bounded modules separate candidate, evidence, native proof and execution, canonical failure verification, closed-set execution transfer, process-boundary verification, Warrant state and qualification, authority state, qualification, Landing acquisition, verified-attempt admission, Landing settlement and fence validation, provider attempt and heartbeat readback, sealed terminal evidence, hosted heartbeat, resume, store, options, command-specific adapters, and CLI orchestration responsibilities. The protected delivery workflow gives candidate and seal jobs no provider write credential, recursively rejects transfer drift, scopes every transfer artifact to the exact provider run attempt, chains every durable heartbeat state and receipt root on a distinct hosted runner domain, and permits qualification or exact failure settlement only after the finalizer verifies live jobs and the latest durable authority state. Public Landing admission and heartbeat always perform non-injectable fresh exact-attempt provider readback, tolerate only a not-yet-materialized seal job while retaining exact native and duplicate-job rejection, and heartbeat-loss coordination never invokes GitHub's run-scoped cancellation API where a successor rerun could race. The hosted process boundary anchors trust in the kernel-resolved versioned Runner.Worker path while accepting an equivalent argv-zero spelling with the same basename; its public boundary marker is allowed only at the one exact non-secret value, so a forged value under the same credential-like name still fails closed. The credentialless transfer seal validates the rooted native reuse decision against the Warrant-bound source, closure, dependency, toolchain, environment and command inputs; qualifiedBase stays in the proof and decision where it is rooted and later independently rechecked, rather than being assumed on the Warrant schema. V2 mutation cannot initialize a second empty authority beside a legacy ref: migration reads and roots the canonical live v1 ref, rechecks it, applies the explicit configured v2 policy, and atomically replaces its bytes through one expected-old non-force update, so old v1 controllers fail closed while the prior commit remains immutable history. Candidate ancestry classifies the GitHub artifact runtime token as credential authority. Every Landing settlement, including an unexpired fence, requires product-owned terminal readback. Terminal cleanup reads the immutable historical attempt, derives workflow and hosted Landing job identity from live run data, reads the exact protected ref head and compares containment against that immutable SHA, and seals merged only when the admitted merge-group head is contained by that protected base; a later different-head merge settles the old attempt as dequeued. Terminal normalization preserves transfer, finalizer boundary, native and seal job, admitted provider attempt, protected-base head, containment result, and terminal readback coordinates. The public reusable workflow truthfully retains its single-flight v1 authority without advertising v2 migration, while bounded v2 remains a separate opt-in CLI, Node API, and schema contract; the tracked self-caller stays on public v4-alpha with matching stable and alpha locks, and transient train selection is dispatch-only. Next-development parity adds one versioned transition authority, one durable controller, one bounded reservation adapter, and pure public-contract recovery evidence while retaining the existing thin floating-channel callers byte-for-byte. The floating-consumer gate reuses the existing contract-world evaluator so SHA drift passes only under the selected lock's compatibility policy, breaking surface drift still fails closed, and external certification reconstructs the receipt from the observed workflow SHA rather than the lock's historical evidence SHA. Tail reseal adds no Stage Capsule effect or general rebuild authority: it verifies the exact retained four-platform bytes, admits one known macOS tail failure through live provider readback, fences signing and finalization to explicit credentials and Warrant identity, and requires standard candidate Passport plus provider and protected readback. Compatibility Facts parity isolates canonical encoding, temporal verification, lifecycle validation, fixture projection, public authority projection, and CLI adaptation into bounded modules; legacy digest and proof arrays are derived only from exact current Fact lineage. Publication Rehearsal adds no production release authority: the content-addressed capsule contract binds source, candidate, manifest, config, canonical data-only provider bindings, provider policy, observations and core version separately from filesystem, runtime and rehearsal-only provider authority; simulate, replay and explicitly authorized provider rehearsal all reuse the release-tail planner, while same-commit local dogfood resolves the new reusable contract and exact current runtime before external callers remain on floating v4-alpha. Cross-runtime candidate recovery preserves original runtime and provider roots and creates resume lineage only after exact public ref, tag, ancestry, npm version and integrity readback. Adopter Delivery restores the reviewed public v3 gate, drivers, Passport binding, N-1 bootstrap and exact archive loader through one public v4 surface while keeping provider and release authority explicit non-claims. Floating Alpha bootstrap uses only the existing exact resolver and protected Alpha private shell to move an otherwise stale floating shell, retains public v4 stable promotion, and removes itself after protected readback. These exact 422-file, 158836-source-line, 75-workflow-file and 25983-workflow-line ceilings cannot grow implicitly."
   },
   "sourceBudgets": {
     "newFileLines": 600,
@@ -33,7 +34,7 @@
     },
     "scripts/dev-delivery-source-proof-reuse.mjs": {
       "maxLines": 631,
-      "rationale": "The bounded source-proof driver seals one exact PR qualification and verifies either the reviewed two-parent merge or GitHub's exact linear replay by base ancestry, commit count and every intermediate tree. Unknown, nonlinear, extra-commit or tree-drift compositions still fail closed to the full lifecycle, and this exact file ceiling cannot grow implicitly."
+      "rationale": "The bounded source-proof driver seals one exact PR qualification and delegates merge-group graph verification to the isolated exact-patch replay module. Unknown, nonlinear, extra-commit, patch-drift or base-divergent compositions still fail closed to the full lifecycle, and this exact file ceiling cannot grow implicitly."
     },
     "scripts/dev-pr-prequeue-guard.mjs": {
       "maxLines": 399,
@@ -96,6 +97,10 @@
     "packages/core/v4-runtime-selector-persistence.js": {
       "maxLines": 228,
       "rationale": "The isolated source scanner rejects persisted exact, train, authority, variable, secret, and environment selector authority while inventorying OIDC, IAM, and external authority metadata without reading credentials; this exact ceiling cannot grow implicitly."
+    },
+    "scripts/resume-from-candidate-run.mjs": {
+      "maxLines": 1125,
+      "rationale": "The candidate recovery adapter retains the existing artifact normalization and immutable recovery receipt boundary while adding fresh authorized cross-runtime Stage Capsule resume material, post-publication ref, tag, ancestry, and npm readback, and rooted Release Passport lineage. Its main orchestration remains below the default function length and complexity limits, and this exact file ceiling cannot grow implicitly."
     }
   },
   "approvedExistingDebtTransitions": {
@@ -104,8 +109,8 @@
       "rationale": "The public facade forwards the reviewed runtime-resume authority beside the existing declarative release-tail and v4 governance APIs without adding a second implementation or execution path; this exact post-integration ceiling cannot grow implicitly."
     },
     "actions/promote-buildchain-ref/index.js": {
-      "maxFunctionLines": 276,
-      "rationale": "The existing action entrypoint forwards one optional rooted v4 runtime-resume evidence document into the already audited durable Passport operation; this one-line terminal widening is exact and cannot grow implicitly."
+      "maxFunctionLines": 280,
+      "rationale": "The existing action entrypoint forwards the optional rooted v4 runtime-resume material and its trusted post-publication finalizer into the audited durable Passport operation. The exact readable four-line input widening cannot grow implicitly."
     },
     "actions/promote-buildchain-ref/lib.js": {
       "maxLines": 6952,
@@ -116,9 +121,9 @@
       "rationale": "The runtime entrypoint now binds every compatibility command and alias, including the upstream paper command, through the tested command registry; this exact post-integration wiring ceiling cannot grow implicitly."
     },
     "packages/core/release-passport.js": {
-      "maxLines": 2958,
+      "maxLines": 2976,
       "maxFunctionLines": 304,
-      "rationale": "Responsibility-owned validators preserve issue ordering, byte-stable reports, upstream release evidence, consumer-policy certification, and the new rooted runtime A+B resume lineage. The optional attachment is normalized and independently reverified before inclusion; these exact post-integration ceilings cannot grow implicitly."
+      "rationale": "Responsibility-owned validators preserve issue ordering, byte-stable reports, upstream release evidence, consumer-policy certification, and rooted runtime A+B resume lineage. Tree-equivalent promotion keeps the original built source identity while the optional attachment is normalized and independently reverified before inclusion; these exact post-integration ceilings cannot grow implicitly."
     },
     "packages/core/buildchain-contract.js": {
       "maxLines": 1096,
@@ -131,8 +136,8 @@
       "rationale": "The publication authority now declares the alpha/v4/v4.0 and release/v4/v4.0 protected channels required for the v4 public train. This exact two-line channel transition cannot grow implicitly."
     },
     "packages/core/buildchain-config.js": {
-      "maxLines": 1806,
-      "rationale": "Artifact signing configuration admits only the Buildchain-owned JIT profile with exact safe archive-relative target paths while rejecting credentials, entitlement files, wildcard paths, incompatible artifact kinds, and incomplete declarations; this exact wiring ceiling cannot grow implicitly."
+      "maxLines": 1885,
+      "rationale": "Artifact signing configuration admits only the Buildchain-owned JIT profile with exact safe archive-relative target paths while rejecting credentials, entitlement files, wildcard paths, incompatible artifact kinds, and incomplete declarations. Publication rehearsal remains effect-disabled. Adopter delivery adds only a closed public contract, exact selectors and repository-relative input, readback, bootstrap, archive and result paths; this exact wiring ceiling cannot grow implicitly."
     },
     "scripts/check-internal-architecture.mjs": {
       "maxFunctionComplexity": 37,
@@ -299,6 +304,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",
@@ -316,7 +322,7 @@
         "secrets": [],
         "outputs": []
       },
-      "rationale": "The promote action preserves the independently rooted v4 consumer-policy certification and now accepts one optional verified runtime-resume evidence document for final Release Passport construction; v3 behavior remains unchanged."
+      "rationale": "The promote action preserves the independently rooted v4 consumer-policy certification and accepts one optional verified runtime-resume evidence document plus one trusted post-publication finalizer command. The command runs only inside the existing durable Passport finalization boundary after provider effects and public readback; v3 behavior remains unchanged."
     },
     "cli:architecture": {
       "fromRevision": "5308189b09bcb5a1314195412f2807a40d678838",
@@ -1506,9 +1512,9 @@
       "rationale": "The existing version-state commit transaction remains nested under its extracted operation factory and is independently regression-tested; this exact inherited ceiling cannot grow."
     },
     "actions/promote-buildchain-ref/internal/durable-transaction-operations.js#createDurableTransactionOperations": {
-      "maxLines": 376,
+      "maxLines": 378,
       "maxComplexity": 1,
-      "rationale": "Transplanted legacy durable transaction and Passport operations now live in an independently owned module; one semantic durable-material seam lets already-proven contained finalization restore immutable publication facts without accepting a transient rebuilt candidate or inconsistent per-field overrides, and this exact inherited ceiling cannot grow."
+      "rationale": "Transplanted legacy durable transaction and Passport operations remain in one independently owned module. The exact two-line readable widening forwards rooted runtime-resume material and its post-publication finalizer without accepting a transient rebuilt candidate or inconsistent per-field overrides; this ceiling cannot grow implicitly."
     },
     "packages/core/paper-npm-bootstrap.js#executePaperNpmBootstrap": {
       "maxLines": 490,

package/architecture/release-tail-contract-inventory.json

@@ -41,6 +41,7 @@
       "release-passport-evidence-command",
       "release-passport-invariant-passport-command",
       "release-passport-kfd-3-artifact-verify-command",
+      "release-passport-v4-runtime-resume-evidence-command",
       "verification-command"
     ],
     "configAndCliAliases": [
@@ -286,7 +287,8 @@
       "publicNames": [
         "release-passport-kfd-3-artifact-verify-command",
         "release-passport-invariant-passport-command",
-        "release-passport-attachment-command"
+        "release-passport-attachment-command",
+        "release-passport-v4-runtime-resume-evidence-command"
       ],
       "aliases": [
         {
@@ -306,7 +308,8 @@
         "action:actions/promote-buildchain-ref/action.yml#release-passport-kfd-3-artifact-verify-command",
         "action:actions/promote-buildchain-ref/action.yml#release-passport-invariant-passport-command",
         "action:actions/promote-buildchain-ref/action.yml#release-passport-attachment-command",
-        "action:actions/promote-buildchain-ref/action.yml#release-passport-evidence-command"
+        "action:actions/promote-buildchain-ref/action.yml#release-passport-evidence-command",
+        "action:actions/promote-buildchain-ref/action.yml#release-passport-v4-runtime-resume-evidence-command"
       ],
       "executionSites": [
         {

package/architecture/v4-adopter-delivery-parity.json

@@ -3,14 +3,16 @@
   "contract": "kungfu-buildchain-v4-adopter-delivery-parity-plan",
   "sourceAuthority": {
     "branch": "dev/v3/v3.0",
-    "commit": "c3f58d76391c1c6ceddfc900a68e91c7ab82a575",
-    "vectorSuiteRoot": "sha256:cf329805d928a9883cbafbdfdf21ef66c6a0889ed8dfe14356b4e0d25d6738f9",
-    "kfdPackage": "@kungfu-tech/kfd@1.0.0-alpha.62"
+    "commit": "6b96bdad8d9f8ccf9275f27d9370a226a9c78465",
+    "vectorSuiteRoot": "sha256:c978707556406ffda4ef4192032332c01c2da1cebb6ad8c4f0edfc65d5cef0c7",
+    "kfdPackage": "@kungfu-tech/kfd@1.0.0-alpha.65"
   },
   "target": {
     "branch": "dev/v4/v4.0",
-    "baseline": "3079091f770ce9fdca950e106259e34e5171f763",
+    "initialBaseline": "e5611377efc03178f8687d99968cfdfa3ce2825b",
+    "baseline": "e0342713c7447960c13bd73377282b2e93f4853d",
     "mode": "effect-disabled",
+    "surface": "public-protocol-neutral-adopter-delivery",
     "productionWriterAuthority": false
   },
   "vectors": [
@@ -37,11 +39,36 @@
     {
       "id": "fault-driver-throw",
       "mode": "gate-core-parity"
+    },
+    {
+      "id": "positive-n-minus-one-bootstrap",
+      "mode": "public-bootstrap-lineage"
+    },
+    {
+      "id": "positive-published-archive",
+      "mode": "public-archive-authority"
+    },
+    {
+      "id": "negative-archive-identity",
+      "mode": "public-archive-authority"
+    },
+    {
+      "id": "negative-bootstrap-lineage",
+      "mode": "public-bootstrap-lineage"
+    },
+    {
+      "id": "negative-protocol-version",
+      "mode": "public-driver-selection"
+    },
+    {
+      "id": "tamper-readback",
+      "mode": "public-exact-readback"
     }
   ],
   "nonClaims": [
     "The Rust projection has no provider, credential, release, signing or production-writer authority.",
     "KFD semantics are evaluated only by exact published KFD bytes before the effect-disabled carrier projection.",
-    "Release Passport evidence substitution remains on the protected v3 boundary and is not reimplemented as a v4 writer."
+    "Release Passport evidence substitution remains on the protected v3 boundary and is not reimplemented as a v4 writer.",
+    "The public CLI, Node API, schema, configuration and reusable workflow retain provider, signing, publication and release authority as explicit non-claims."
   ]
 }

package/architecture/v4-publication-rehearsal-parity.json

@@ -0,0 +1,84 @@
+{
+  "schema": "buildchain.v4.publication-rehearsal-parity/v1",
+  "source": {
+    "branch": "dev/v3/v3.0",
+    "commit": "6b96bdad8d9f8ccf9275f27d9370a226a9c78465",
+    "runtime": "packages/core/publication-rehearsal-runtime.js"
+  },
+  "target": {
+    "branch": "dev/v4/v4.0",
+    "commit": "bc12cd0ff18a7e1d918777ea093c169349952d34",
+    "capsuleContract": "packages/core/v4-publication-rehearsal-capsule.js",
+    "runtime": "packages/core/v4-publication-rehearsal.js",
+    "providerBindings": "packages/core/v4-publication-rehearsal-provider-bindings.js"
+  },
+  "sharedProductionCore": {
+    "planner": "compileReleaseTailDeclaration",
+    "initializer": "createReleaseTailTransaction",
+    "executor": "executeReleaseTailTransaction",
+    "version": "buildchain.release-tail/v1"
+  },
+  "stageCapsuleBoundary": {
+    "contract": "buildchain-v4-stage-capsule/v1",
+    "purpose": "pure platform-stage build checkpoint reuse",
+    "publicationEffects": false,
+    "publicationAuthority": false
+  },
+  "matrix": [
+    {
+      "invariant": "capsule-purpose",
+      "v3": "publication rehearsal",
+      "v4": "publication rehearsal distinct from Stage Capsule",
+      "parity": "safety-strengthened"
+    },
+    {
+      "invariant": "content-addressed-inputs",
+      "v3": "capsule, declaration, transaction, files, data-only provider bindings, policy and observations",
+      "v4": "capsule, source, candidate, manifest, config, provider bindings, provider policy, expected observations and core version",
+      "parity": "safety-strengthened"
+    },
+    {
+      "invariant": "provider-request-binding",
+      "v3": "provider binding payload is capsule-rooted and every input path is in files",
+      "v4": "providerBindingsRoot covers canonical bindings and every request byte is inventory-rooted before adapters",
+      "parity": "exact"
+    },
+    {
+      "invariant": "shared-release-tail-core",
+      "v3": "shared planner and executor",
+      "v4": "same production planner, initializer and executor",
+      "parity": "exact"
+    },
+    {
+      "invariant": "effect-default",
+      "v3": "simulate and replay local defaults",
+      "v4": "provider policy is rooted and effect-disabled by default",
+      "parity": "safety-strengthened"
+    },
+    {
+      "invariant": "authorized-provider-rehearsal",
+      "v3": "provider observations are recorded without authority",
+      "v4": "exact capsule-bound rehearsal-only authority plus request and readback transcript",
+      "parity": "safety-strengthened"
+    },
+    {
+      "invariant": "release-authority",
+      "v3": "externalPublicationClaimed false",
+      "v4": "productionAuthority false and releasePassport null",
+      "parity": "exact"
+    },
+    {
+      "invariant": "tamper-response",
+      "v3": "capsule and file mismatch fail closed",
+      "v4": "every named identity root and core version mismatch fails closed",
+      "parity": "safety-strengthened"
+    },
+    {
+      "invariant": "portability",
+      "v3": "platform-independent local capsule root",
+      "v4": "byte-identical offline linux, macos and windows vector",
+      "parity": "exact"
+    }
+  ],
+  "matrixRoot": "sha256:521694ce2cc1d5b383eaa6b84f1b6926ef8ce8f33085e02507e611e9f9b6e784"
+}

package/bin/buildchain.mjs

@@ -111,6 +111,7 @@ import {
 } from "./internal/trust-release-cli.mjs";
 import { dispatchRegisteredCommand } from "./internal/command-registry.mjs";
 import { runCompatibilityFactsCli } from "./internal/compatibility-facts-cli.mjs";
+import { runAdopterDeliveryCli } from "./internal/adopter-delivery-cli.mjs";
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const embeddedPackageVersion = process.env.BUILDCHAIN_EMBEDDED_PACKAGE_VERSION || "";
@@ -1675,7 +1676,7 @@ async function handleReleaseGovernanceCommand(args) {
 }
 
 async function handleReleaseTailCommand(args) {
-  runReleaseTailCli(args);
+  await runReleaseTailCli(args);
 }
 
 async function handleTailResealCommand(args) {
@@ -1750,6 +1751,10 @@ async function handleArchitectureCommand(args) {
   runScript("v4-architecture.mjs", args);
 }
 
+async function handleAdopterDeliveryCommand(args) {
+  await runAdopterDeliveryCli(args);
+}
+
 const BUILDCHAIN_COMMAND_HANDLERS = Object.freeze({
   "help": handleHelpCommand,
   "version": handleVersionCommand,
@@ -1790,6 +1795,7 @@ const BUILDCHAIN_COMMAND_HANDLERS = Object.freeze({
   "build-contract": handleBuildContractCommand,
   "publish-source": handlePublishSourceCommand,
   "architecture": handleArchitectureCommand,
+  "adopter-delivery": handleAdopterDeliveryCommand,
 });
 
 async function main(argv = process.argv.slice(2)) {

package/bin/internal/adopter-delivery-cli.mjs

@@ -0,0 +1,70 @@
+import {
+  loadV4PublishedAdopterDeliveryAuthority,
+  qualifyV4AdopterDeliveryBootstrap,
+  runV4AdopterDeliveryGate,
+  verifyV4AdopterDeliveryReadback,
+} from "../../packages/core/v4-adopter-delivery.js";
+import {
+  printJson,
+  readFlag,
+  readJsonInput,
+  writeJsonFile,
+} from "./cli-options.mjs";
+
+function emit(args, value) {
+  writeJsonFile(readFlag(args, "output", ""), value);
+  printJson(value);
+}
+
+export async function runAdopterDeliveryCli(args = []) {
+  const [subcommand = "", ...commandArgs] = args;
+  if (subcommand === "run") {
+    const input = readJsonInput(readFlag(commandArgs, "input", ""), {
+      label: "adopter delivery input",
+    });
+    emit(commandArgs, runV4AdopterDeliveryGate(input));
+    return;
+  }
+  if (subcommand === "verify") {
+    const input = readJsonInput(readFlag(commandArgs, "input", ""), {
+      label: "adopter delivery input",
+    });
+    const readback = readJsonInput(readFlag(commandArgs, "readback", ""), {
+      label: "adopter delivery readback",
+    });
+    emit(commandArgs, verifyV4AdopterDeliveryReadback({ input, readback }));
+    return;
+  }
+  if (subcommand === "bootstrap") {
+    const request = readJsonInput(readFlag(commandArgs, "input", ""), {
+      label: "adopter delivery bootstrap input",
+    });
+    emit(commandArgs, qualifyV4AdopterDeliveryBootstrap(request));
+    return;
+  }
+  if (subcommand === "archive") {
+    const request = readJsonInput(readFlag(commandArgs, "input", ""), {
+      label: "published archive input",
+    });
+    const authority = await loadV4PublishedAdopterDeliveryAuthority(request);
+    try {
+      emit(commandArgs, {
+        schemaVersion: authority.schemaVersion,
+        contract: authority.contract,
+        packages: authority.packages,
+        moduleCoordinates: authority.moduleCoordinates,
+        authorityRoot: authority.authorityRoot,
+        qualifying: authority.qualifying,
+        selfCertified: authority.selfCertified,
+        releaseAuthorized: authority.releaseAuthorized,
+        finalAuthority: authority.finalAuthority,
+      });
+    } finally {
+      await authority.dispose();
+    }
+    return;
+  }
+  throw new Error(
+    "usage: buildchain adopter-delivery <run|verify|bootstrap|archive> --input <json-or-path> [--readback <json-or-path>] [--output <path>]",
+  );
+}

package/bin/internal/command-registry.mjs

@@ -41,6 +41,7 @@ const BUILDCHAIN_COMMAND_REGISTRY = Object.freeze([
   { id: "build-contract", aliases: [] },
   { id: "publish-source", aliases: [] },
   { id: "architecture", aliases: [] },
+  { id: "adopter-delivery", aliases: [] },
 ]);
 
 function buildCommandLookup(registry = BUILDCHAIN_COMMAND_REGISTRY) {

package/contracts/fixtures/v4-adopter-delivery-v1/archive-template.json

@@ -0,0 +1,19 @@
+{
+  "packages": {
+    "buildchain": {
+      "name": "@kungfu-tech/buildchain",
+      "version": "3.0.9-alpha.16",
+      "archivePath": ".buildchain/adopter-delivery-archives/kungfu-tech-buildchain-3.0.9-alpha.16.tgz",
+      "archiveRoot": "sha256:3f425e2c77d11f0bee8eb9aa2448566bca7a9d14672a7e528ced3e505b3f14a3",
+      "artifactRoot": "sha256:3f425e2c77d11f0bee8eb9aa2448566bca7a9d14672a7e528ced3e505b3f14a3"
+    },
+    "kfd": {
+      "name": "@kungfu-tech/kfd",
+      "version": "1.0.0-alpha.65",
+      "archivePath": ".buildchain/adopter-delivery-archives/kungfu-tech-kfd-1.0.0-alpha.65.tgz",
+      "archiveRoot": "sha256:c4dbd3f954910236d7f0823ea6887f4151e43b871df526ccdd599123421bced2",
+      "artifactRoot": "sha256:c0781bcaf191a58561ae32ee2fbedabbb48ed50b5725c356fbd83704089637f8"
+    }
+  },
+  "expectedAuthorityRoot": "sha256:9ba0cc6042b189ce749d01003617b57bcd03ea6ecf40e96d19e8ecbbfa347134"
+}