@kungfu-tech/buildchain 4.0.2-alpha.34 → 4.0.2-alpha.35

package/AGENTS.md

@@ -79,6 +79,15 @@ pnpm install --frozen-lockfile
 pnpm run check
 ```
 
+Workflow paths are governed by [`architecture/workflow-taxonomy.json`](architecture/workflow-taxonomy.json)
+and the generated [`Workflow Catalog`](docs/workflow-catalog.md). Before adding,
+renaming, or editing workflow YAML, register its role (`public`, component `.`,
+or `self`) and category (`build`, `release`, or `ops`). Use the derived filename;
+do not invent prefixes, categories, or compatibility aliases. Edit canonical
+implementations, run `pnpm run generate:workflows`, and pass
+`pnpm run check:workflows` plus the full check. Taxonomy and gate changes require
+independent `@kungfu-origin` review through CODEOWNERS.
+
 Buildchain v4 Stage Capsule checkpoint work is governed by
 `architecture/v4-platform-stage-checkpoints.json`. Agents must use that single
 platform/stage declaration for shadow emission and clean-process restore. Do

package/CONTRIBUTING.md

@@ -73,6 +73,30 @@ pnpm run build
 npm pack --dry-run --json --registry=https://registry.npmjs.org/
 ```
 
+## Workflow organization
+
+All workflows remain directly under `.github/workflows/`. The finite role and
+category vocabulary is enforced by `architecture/workflow-taxonomy.json`:
+
+| Role | Filename | Scope |
+| --- | --- | --- |
+| Public | `public-<category>-<purpose>.yml` | Consumer entry |
+| Component | `.<category>-<purpose>.yml` | Advanced reusable component |
+| Self | `self-<category>-<purpose>.yml` | Buildchain repository automation |
+
+Categories are only `build`, `release`, and `ops`. Register the identity, role,
+category, purpose, owner, lifecycle status, invocation, and rationale before
+adding its derived filename. The [Workflow Catalog](docs/workflow-catalog.md)
+lists every allowed path and compatibility exception. Existing public aliases
+are generated from their canonical implementations; self workflows have one
+event entry. A matching prefix alone does not admit an unregistered workflow.
+
+Run `pnpm run generate:workflows`, `pnpm run check:workflows`, then the full
+`pnpm run check`. The required Verify lifecycle runs this gate on PRs, merge
+queue candidates, and pushes. Policy, enforcement, and ownership changes require
+independent `@kungfu-origin` review. Keep published floating consumers on their
+registered legacy paths until the selected channel actually ships the new path.
+
 ## Generated files
 
 GitHub Actions consume committed bundles. When changing an action

package/README.md

@@ -324,9 +324,9 @@ The active reusable workflow surfaces are:
   heavy build;
 - `.github/workflows/.web-surface.yml` for preview, staging, production, and
   cleanup plans for site/app repositories;
-- `.github/workflows/buildchain-ref-promotion.yml` for protected release
+- `.github/workflows/self-release-promote.yml` for protected release
   promotion and version-state transactions;
-- `.github/workflows/binary-distribution.yml` for Buildchain's own release
+- `.github/workflows/self-build-binary-distribution.yml` for Buildchain's own release
   passport proof case.
 
 Stable consumers should reference actions and workflows through floating major

package/actions/promote-buildchain-ref/README.md

@@ -310,7 +310,7 @@ Buildchain itself uses this path for npm. Its `lifecycle.publish` runs
 `node scripts/npm-publish-transaction.mjs`, which publishes
 `@kungfu-tech/buildchain` through npm Trusted Publishing and writes npm
 artifact evidence into the transaction before release refs move. The separate
-`.github/workflows/npm-publish.yml` workflow is dry-run only.
+`.github/workflows/self-release-npm-dry-run.yml` workflow is dry-run only.
 
 Publish lifecycle environment:
 

package/architecture/agent-change-map.md

@@ -178,6 +178,7 @@ Safe change route: Reduce one owned responsibility behind the stable facade, run
 - `actions/promote-buildchain-ref/lib.js`
 - `actions/v4-release-candidate-promote/index.js`
 - `actions/v4-release-candidate-promote/product-provider.js`
+- `actions/v4-release-candidate-promote/product-provider-github-adapters.js`
 - `tests/v4-release-candidate-promote.test.mjs`
 - `scripts/check-inventory.mjs`
 - `tests/promote-buildchain-ref.test.mjs`
@@ -197,6 +198,7 @@ Safe change route: Reduce one owned responsibility behind the stable facade, run
 - `scripts/buildchain-cli-help.mjs`
 - `scripts/check-maintainability.mjs`
 - `tests/maintainability.test.mjs`
+- `scripts/generate-v4-universal-workflow-facades.mjs`
 
 ## cli-command-registry
 
@@ -741,7 +743,7 @@ Owner: Buildchain adopter delivery maintainers
 - `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`
+- `.github/workflows/self-build-adopter-dogfood.yml`
 - `docs/v4-adopter-delivery.md`
 
 ### Tests
@@ -953,7 +955,7 @@ Owner: Buildchain protected delivery maintainers
 - `contracts/dev-delivery-authority-v2.schema.json`
 - `dist/site/schemas/dev-delivery-authority-v2.schema.json`
 - `.github/workflows/dev-pr-auto-merge.yml`
-- `.github/workflows/buildchain-dev-delivery.yml`
+- `.github/workflows/self-ops-dev-delivery.yml`
 - `templates/native-dev-delivery.yml`
 - `docs/dev-delivery-warrant.md`
 - `docs/dev-delivery-qualification-landing-adr.md`
@@ -995,7 +997,7 @@ Owner: Buildchain publication rehearsal maintainers
 
 - `architecture/v4-publication-rehearsal-parity.json`
 - `contracts/v4-publication-rehearsal-capsule-v1.schema.json`
-- `.github/workflows/v4-publication-rehearsal-dogfood.yml`
+- `.github/workflows/self-release-rehearsal-dogfood.yml`
 - `docs/v4-publication-rehearsal.md`
 
 ### Tests
@@ -1029,7 +1031,7 @@ Owner: Buildchain workflow maintainers
 - `architecture/v4-universal-workflow-fault-campaign.json`
 - `architecture/v4-universal-workflow-train-admission.json`
 - `.github/workflows/bootstrap.yml`
-- `.github/workflows/universal-bootstrap-dogfood.yml`
+- `.github/workflows/self-ops-bootstrap-dogfood.yml`
 - `templates/universal-buildchain-bootstrap-recovery.yml`
 
 ### Tests

package/architecture/internal-capabilities.json

@@ -589,7 +589,7 @@
       "contracts": [
         "architecture/v4-publication-rehearsal-parity.json",
         "contracts/v4-publication-rehearsal-capsule-v1.schema.json",
-        ".github/workflows/v4-publication-rehearsal-dogfood.yml",
+        ".github/workflows/self-release-rehearsal-dogfood.yml",
         "docs/v4-publication-rehearsal.md"
       ],
       "generatedOutputs": [],
@@ -656,7 +656,7 @@
         "contracts/dev-delivery-authority-v2.schema.json",
         "dist/site/schemas/dev-delivery-authority-v2.schema.json",
         ".github/workflows/dev-pr-auto-merge.yml",
-        ".github/workflows/buildchain-dev-delivery.yml",
+        ".github/workflows/self-ops-dev-delivery.yml",
         "templates/native-dev-delivery.yml",
         "docs/dev-delivery-warrant.md",
         "docs/dev-delivery-qualification-landing-adr.md"
@@ -734,7 +734,7 @@
         "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",
+        ".github/workflows/self-build-adopter-dogfood.yml",
         "docs/v4-adopter-delivery.md"
       ],
       "generatedOutputs": [],
@@ -866,7 +866,7 @@
         "architecture/v4-universal-workflow-fault-campaign.json",
         "architecture/v4-universal-workflow-train-admission.json",
         ".github/workflows/bootstrap.yml",
-        ".github/workflows/universal-bootstrap-dogfood.yml",
+        ".github/workflows/self-ops-bootstrap-dogfood.yml",
         "templates/universal-buildchain-bootstrap-recovery.yml"
       ],
       "generatedOutputs": [

package/architecture/maintainability-debt.json

@@ -7,8 +7,8 @@
   },
   "totalExcessLedger": {
     "metric": "calibrated-full-dimensional-excess-v1",
-    "measuredExcess": 64779,
-    "current": 56718
+    "measuredExcess": 64771,
+    "current": 56710
   },
   "defaults": {
     "owner": "Buildchain architecture maintainers",
@@ -1435,21 +1435,21 @@
       "scripts/generate-channel-promotion-workflow.mjs": {
         "baseline": {
           "functions": {
-            "generateChannelPromotionWorkflow@279": {
+            "generateChannelPromotionWorkflow@280": {
               "lines": 282
             }
           }
         },
         "current": {
           "functions": {
-            "generateChannelPromotionWorkflow@279": {
+            "generateChannelPromotionWorkflow@280": {
               "lines": 240
             }
           }
         },
         "target": {
           "functions": {
-            "generateChannelPromotionWorkflow@279": {
+            "generateChannelPromotionWorkflow@280": {
               "lines": 180
             }
           }
@@ -1459,7 +1459,7 @@
         "baseline": {
           "lines": 1410,
           "functions": {
-            "buildSiteBundle@719": {
+            "buildSiteBundle@720": {
               "lines": 637
             }
           }
@@ -1467,15 +1467,15 @@
         "current": {
           "lines": 1410,
           "functions": {
-            "buildSiteBundle@719": {
-              "lines": 637
+            "buildSiteBundle@720": {
+              "lines": 636
             }
           }
         },
         "target": {
           "lines": 600,
           "functions": {
-            "buildSiteBundle@719": {
+            "buildSiteBundle@720": {
               "lines": 180
             }
           }
@@ -2075,7 +2075,7 @@
         "current": {
           "functions": {
             "dispatch@61": {
-              "lines": 214,
+              "lines": 207,
               "complexity": 64
             }
           }
@@ -3150,6 +3150,7 @@
     "actions/promote-buildchain-ref/lib.js",
     "actions/v4-release-candidate-promote/index.js",
     "actions/v4-release-candidate-promote/product-provider.js",
+    "actions/v4-release-candidate-promote/product-provider-github-adapters.js",
     "tests/v4-release-candidate-promote.test.mjs",
     "scripts/check-inventory.mjs",
     "tests/promote-buildchain-ref.test.mjs",
@@ -3168,7 +3169,8 @@
     "tests/promote-buildchain-ref-governance.test.mjs",
     "scripts/buildchain-cli-help.mjs",
     "scripts/check-maintainability.mjs",
-    "tests/maintainability.test.mjs"
+    "tests/maintainability.test.mjs",
+    "scripts/generate-v4-universal-workflow-facades.mjs"
   ],
   "burnDownSlices": [
     {

package/architecture/maintainability-policy.json

@@ -26,12 +26,12 @@
   },
   "repositoryBudgets": {
     "baselineRevision": "9569f69c2cb609372b8a3d65ce5dec8fb7b34a84",
-    "maxHandMaintainedSourceFiles": 472,
-    "maxHandMaintainedSourceLines": 170850,
+    "maxHandMaintainedSourceFiles": 482,
+    "maxHandMaintainedSourceLines": 172476,
     "maxWorkflowFiles": 80,
     "maxWorkflowLines": 26791,
-    "latestTransition": "Alpha publishes the reviewed version and advances Dev afterward.",
-    "latestTransitionRationale": "The Rust/WASM publication authority now uses the exact reviewed Alpha candidate version and sealed npm tarball, keeps Dev outside release-ref convergence, and reuses the existing next-development transition to create and enqueue one successor-version Dev pull request only after publication succeeds. Candidate-input discovery remains inside the existing product provider, preserving the privileged module topology and adding no workflow, credential, provider permission, merge authority, capability, or publication scope.",
+    "latestTransition": "Exact source verification reuse and independently retained v4 publication settlement. Preserve the separately reviewed workflow taxonomy source allowance. Retain protected PR 3508 called-workflow path admission.",
+    "latestTransitionRationale": "Bounded evidence transport, exact base regeneration, native proof validation, immutable asset readback and publication settlement adapters preserve full-source test coverage and provider permissions. The aggregate source allowance records these modules at their measured size; existing file/function debt, exception counts and the frozen total-excess maximum do not widen. Exact facade patches remain reproducible against their recorded source and result digests. The combined source inventory is 171156 reviewed taxonomy lines plus this Work's 1309 lines against common source a41c00a0c; the two branches cannot each spend the same 228-line baseline slack. The resulting 482 files and 172465 lines retain both additions without changing complexity or debt ceilings. Protected PR 3508 adds 11 measured lines in the existing taxonomy generator, yielding 172476 combined source lines; its alias identity binding and every existing complexity, debt and exception ceiling are retained.",
     "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. CI lane change-budget enforcement adds a bounded parser, evaluator, guard, and tests without creating another merge authority.",
     "governance": "legacy-debt-sunset-2026q4"
   },

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

@@ -427,7 +427,7 @@
       "repository": "kungfu-systems/buildchain",
       "sourceCommit": "7c8956e8babb521d3e743d40108f115a59a40427",
       "sourceTree": "7e24ca6bafe98b571d94c3bcf07a9d38b31092c5",
-      "workflow": ".github/workflows/buildchain-ref-promotion.yml",
+      "workflow": ".github/workflows/self-release-promote.yml",
       "runtimeRef": "local exact checkout",
       "executableSurfaceIds": []
     },
@@ -454,7 +454,7 @@
       "repository": "kungfu-systems/kungfu",
       "sourceCommit": "445ec32d6bf53dd5ff502d685792406ad38dd4f5",
       "sourceTree": "4963b2f9deb0245f7277cea7224ab0d062a0cc54",
-      "workflow": ".github/workflows/release-new-version.yml",
+      "workflow": ".github/workflows/self-release-new-version-compat.yml",
       "runtimeRef": "train/v3/v3.0/resume-candidate-run",
       "executableSurfaceIds": [
         "publication-admission-commands",
@@ -470,7 +470,7 @@
       "repository": "kungfu-systems/libnode",
       "sourceCommit": "4bef69b88a441f22024fa9f3d7bfd76a89963e8a",
       "sourceTree": "6c4dec7fd70cbdcfbc9ada19e66271654eb393af",
-      "workflow": ".github/workflows/release-new-version.yml",
+      "workflow": ".github/workflows/self-release-new-version-compat.yml",
       "runtimeRef": "v3-alpha",
       "executableSurfaceIds": ["release-passport-producer-commands"]
     },
@@ -479,7 +479,7 @@
       "repository": "kungfu-systems/kfd",
       "sourceCommit": "e82fe11acecdbebfd0c42778c7a1bd6fdc54ab81",
       "sourceTree": "fe0ad4f4b98889c7c246fe16958e118ff79b193b",
-      "workflow": ".github/workflows/buildchain-ref-promotion.yml",
+      "workflow": ".github/workflows/self-release-promote.yml",
       "runtimeRef": "v3-alpha",
       "executableSurfaceIds": []
     },
@@ -488,7 +488,7 @@
       "repository": "kungfu-systems/paper-kungfu-product-white-paper",
       "sourceCommit": "82dd748d6b0edf18d0074262cc8d8ac803e45c7e",
       "sourceTree": "a918f8840608931fdf88d007e20bc4f70ab7eb54",
-      "workflow": ".github/workflows/buildchain-ref-promotion.yml",
+      "workflow": ".github/workflows/self-release-promote.yml",
       "runtimeRef": "v3",
       "executableSurfaceIds": []
     }
@@ -497,7 +497,7 @@
     {
       "repository": "kungfu-systems/agent-hub-demo",
       "sourceCommit": "633111450867919d5063298308cdbfcbd77a8d2e",
-      "workflow": ".github/workflows/buildchain-ref-promotion.yml",
+      "workflow": ".github/workflows/self-release-promote.yml",
       "runtimeRef": "v2",
       "reason": "outside the Buildchain v3 contract inventory"
     }

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

@@ -227,7 +227,7 @@
         "docs/dev-delivery-warrant.md",
         "docs/dev-delivery-qualification-landing-adr.md",
         "templates/native-dev-delivery.yml",
-        ".github/workflows/buildchain-dev-delivery.yml",
+        ".github/workflows/self-ops-dev-delivery.yml",
         ".buildchain/contract-lock.json",
         ".buildchain/alpha-contract-lock.json"
       ],
@@ -246,5 +246,5 @@
       "verificationEvidence": []
     }
   ],
-  "matrixRoot": "sha256:5be5abf70b982374f32a1400d4ec7c830017a0473d03165e831a506c94c8b881"
+  "matrixRoot": "sha256:85fc624f09abb2014601a9857dbcd07a59750b6dd6d77ab240ed037d3169ac69"
 }

package/architecture/v4-delivery-warrant-shadow-bootstrap-plan.json

@@ -9,7 +9,7 @@
     "legacyCore": "packages/core/dev-delivery-warrant.js",
     "legacyStore": "scripts/dev-delivery-warrant.mjs",
     "legacyWorkflows": [
-      ".github/workflows/buildchain-dev-delivery.yml",
+      ".github/workflows/self-ops-dev-delivery.yml",
       ".github/workflows/dev-delivery-warrant-close.yml",
       ".github/workflows/dev-delivery-warrant-cancel.yml"
     ]

package/architecture/v4-floating-consumer-policy.json

@@ -38,7 +38,7 @@
     "persistedSelectorOverride": false,
     "protectedAlphaRecoveryBootstrap": {
       "selector": "alpha/v4/v4.0",
-      "sourcePath": ".github/workflows/buildchain-ref-promotion-recovery.yml",
+      "sourcePath": ".github/workflows/self-ops-promotion-recovery.yml",
       "workflow": ".github/workflows/.release-candidate-promote.yml",
       "repository": "kungfu-systems/buildchain"
     },

package/architecture/v4-next-development-parity.json

@@ -11,7 +11,7 @@
   "target": {
     "branch": "dev/v4/v4.0",
     "implementationBaseline": "36ad1dc03a9d2785aca938a7a369e4b96707fa32",
-    "publicConsumerCaller": ".github/workflows/v4-public-consumer-dogfood.yml",
+    "publicConsumerCaller": ".github/workflows/self-build-public-consumer-dogfood.yml",
     "publicConsumerReusable": "kungfu-systems/buildchain/.github/workflows/v4-stage-capsule-canary.yml@v4-alpha"
   },
   "earlierContinuityDelta": {
@@ -152,8 +152,8 @@
       "claim": "V4 recovery proof runs as pure tests through the standard lifecycle.verify reached by the exact thin public consumer caller, while existing hosted dual-channel evidence keeps public v4-alpha and v4 routes.",
       "disposition": "implemented",
       "implementationEvidence": [
-        ".github/workflows/v4-public-consumer-dogfood.yml",
-        ".github/workflows/buildchain-alpha-self-dogfood.yml",
+        ".github/workflows/self-build-public-consumer-dogfood.yml",
+        ".github/workflows/self-build-alpha-dogfood.yml",
         ".buildchain/buildchain.toml",
         "scripts/next-development-self-dogfood.mjs",
         "scripts/next-development-self-dogfood-harness.mjs"
@@ -188,5 +188,5 @@
       "verificationEvidence": []
     }
   ],
-  "matrixRoot": "sha256:0f0d69dd338cad33dc61870675cbedb8664e019e403f73a1ddcf8471d69df405"
+  "matrixRoot": "sha256:59bf32516748d4d2f823cdcbcfe0b75a7332fa122e2ebc66c6ea8553b34c5ccf"
 }

package/architecture/v4-platform-stage-checkpoints.json

@@ -81,7 +81,7 @@
     }
   ],
   "projections": {
-    "protectedWorkflow": ".github/workflows/verify.yml",
+    "protectedWorkflow": ".github/workflows/self-build-verify.yml",
     "generatedTemplate": "scripts/init-repo.mjs",
     "agentGuidance": "AGENTS.md",
     "manual": "docs/v4-stage-capsule.md"

package/architecture/v4-publication-facade-patches.json

@@ -0,0 +1,53 @@
+{
+  "schemaVersion": 1,
+  "sourceRevision": "a41c00a0c0b2dbd57c238cd9b326b167a1d27ca8",
+  "purpose": "Retain completed v4 publication receipt independently of next-development and preserve immutable binary publication assets.",
+  "facades": [
+    {
+      "workflow": ".github/workflows/.binary-release-assets.yml",
+      "beforeSha256": "5dfaea0f9cf83500706f423eca08f43594fe3653fa139da359041e88fae49266",
+      "afterSha256": "06831b3ec8db28fbf96ffa8907fd58c1a77dd09e8d4fe02100a98febe10dba34",
+      "replacements": [
+        {
+          "before": "          fs.writeFileSync(\".buildchain/publication-authority/capability.json\", `${JSON.stringify(capability, null, 2)}\\n`);\n          NODE\n\n      - name: Upload GitHub Release assets\n        env:\n          GH_TOKEN: ${{ github.token }}\n          RELEASE_TAG: ${{ inputs.release-tag }}\n",
+          "after": "          fs.writeFileSync(\".buildchain/publication-authority/capability.json\", `${JSON.stringify(capability, null, 2)}\\n`);\n          NODE\n\n      - uses: actions/setup-node@v6.4.0\n        if: ${{ startsWith(inputs.release-tag, 'v4.') }}\n        with:\n          node-version: \"24\"\n\n      - name: Install exact publication runtime dependencies\n        if: ${{ startsWith(inputs.release-tag, 'v4.') }}\n        run: corepack pnpm@11.7.0 install --frozen-lockfile --ignore-scripts\n\n      - name: Upload immutable GitHub Release assets and verify readback\n        if: ${{ startsWith(inputs.release-tag, 'v4.') }}\n        env:\n          GH_TOKEN: ${{ github.token }}\n          RELEASE_TAG: ${{ inputs.release-tag }}\n        run: node scripts/binary-publication-evidence.mjs publish\n\n      - name: Retain binary publication readback\n        if: ${{ startsWith(inputs.release-tag, 'v4.') }}\n        uses: actions/upload-artifact@v7.0.1\n        with:\n          name: binary-publication-readback-${{ inputs.release-tag }}\n          path: .buildchain/binary-publication/readback.json\n          include-hidden-files: true\n          if-no-files-found: error\n\n      - name: Upload GitHub Release assets\n        if: ${{ !startsWith(inputs.release-tag, 'v4.') }}\n        env:\n          GH_TOKEN: ${{ github.token }}\n          RELEASE_TAG: ${{ inputs.release-tag }}\n"
+        }
+      ]
+    },
+    {
+      "workflow": ".github/workflows/.release-candidate-promote.yml",
+      "beforeSha256": "177b3c50685405e5ed2bf1ac893469fdb3a27e7b03d55025611b2985028cd8cf",
+      "afterSha256": "9c7f3586a3444cdad34d2a61be3cb9b0ae271fb56f9e371d9c37940e6b317780",
+      "replacements": [
+        {
+          "before": "      release-candidate-artifact: ${{ needs.qualify.outputs.candidate-artifact }}\n      release-candidate-action: canonical-release-invocation\n      release-candidate-outcome: success\n      promotion-outcome: success\n      finalization-needed: \"false\"\n      release-tail-transaction-state: ${{ steps.provider.outputs.transaction-state || steps.resume.outputs.transaction-state }}\n      release-tail-declaration-root: ${{ steps.provider.outputs.declaration-root || steps.resume.outputs.declaration-root }}\n      release-tail-transaction-root: ${{ steps.provider.outputs.transaction-root || steps.resume.outputs.transaction-root }}\n",
+          "after": "      release-candidate-artifact: ${{ needs.qualify.outputs.candidate-artifact }}\n      release-candidate-action: canonical-release-invocation\n      release-candidate-outcome: success\n      promotion-outcome: ${{ steps.publication-settlement.outputs.status == 'complete' && 'success' || 'failure' }}\n      finalization-needed: ${{ steps.publication-settlement.outputs.status != 'complete' }}\n      release-tail-transaction-state: ${{ steps.provider.outputs.transaction-state || steps.resume.outputs.transaction-state }}\n      release-tail-declaration-root: ${{ steps.provider.outputs.declaration-root || steps.resume.outputs.declaration-root }}\n      release-tail-transaction-root: ${{ steps.provider.outputs.transaction-root || steps.resume.outputs.transaction-root }}\n"
+        },
+        {
+          "before": "      release-tail-receipt-roots-json: ${{ steps.provider.outputs.receipt-roots-json || steps.resume.outputs.receipt-roots-json }}\n      release-invocation-root: ${{ steps.provider.outputs.release-invocation-root || steps.resume.outputs.release-invocation-root }}\n      release-transaction-root: ${{ steps.provider.outputs.release-transaction-root || steps.resume.outputs.release-transaction-root }}\n      release-receipt-root: ${{ steps.provider.outputs.release-receipt-root || steps.resume.outputs.release-receipt-root }}\n    steps:\n      - name: Checkout the admitted protected channel state\n        uses: actions/checkout@v7.0.0\n",
+          "after": "      release-tail-receipt-roots-json: ${{ steps.provider.outputs.receipt-roots-json || steps.resume.outputs.receipt-roots-json }}\n      release-invocation-root: ${{ steps.provider.outputs.release-invocation-root || steps.resume.outputs.release-invocation-root }}\n      release-transaction-root: ${{ steps.provider.outputs.release-transaction-root || steps.resume.outputs.release-transaction-root }}\n      release-receipt-root: ${{ steps.publication-settlement.outputs.receipt-root || steps.provider.outputs.release-receipt-root || steps.resume.outputs.release-receipt-root }}\n    steps:\n      - name: Checkout the admitted protected channel state\n        uses: actions/checkout@v7.0.0\n"
+        },
+        {
+          "before": "        uses: ./.buildchain/runtime/actions/v4-release-candidate-promote\n        with: *provider-inputs\n\n      - name: Retain canonical APPLY and ReleaseReceipt evidence\n        if: ${{ always() }}\n        uses: actions/upload-artifact@v7.0.1\n",
+          "after": "        uses: ./.buildchain/runtime/actions/v4-release-candidate-promote\n        with: *provider-inputs\n\n      - name: Retain completed publication independently of next-development\n        id: publication-settlement\n        if: ${{ always() && hashFiles('.buildchain/release-tail/release-receipt.json') != '' }}\n        env:\n          GH_TOKEN: ${{ github.token }}\n          CANDIDATE_SHA: ${{ needs.qualify.outputs.requested-sha }}\n          APPLY_OUTCOME: ${{ (steps.resume.outcome == 'success' || steps.resume.outcome == 'failure') && steps.resume.outcome || steps.provider.outcome }}\n        run: node .buildchain/runtime/scripts/v4-publication-settlement.mjs .buildchain\n\n      - name: Retain canonical APPLY and ReleaseReceipt evidence\n        if: ${{ always() }}\n        uses: actions/upload-artifact@v7.0.1\n"
+        },
+        {
+          "before": "      controller-receipt-status: ${{ steps.verify.outputs.status || steps.projection-state.outputs.status }}\n    steps:\n      - name: Checkout the admitted receipt verifier\n        if: ${{ needs.apply.result == 'success' }}\n        uses: actions/checkout@v7.0.0\n        with:\n          repository: kungfu-systems/buildchain\n",
+          "after": "      controller-receipt-status: ${{ steps.verify.outputs.status || steps.projection-state.outputs.status }}\n    steps:\n      - name: Checkout the admitted receipt verifier\n        if: ${{ needs.qualify.outputs.action == 'promote' && !inputs.dry-run }}\n        uses: actions/checkout@v7.0.0\n        with:\n          repository: kungfu-systems/buildchain\n"
+        },
+        {
+          "before": "          persist-credentials: false\n\n      - name: Restore canonical APPLY evidence\n        if: ${{ needs.apply.result == 'success' }}\n        uses: actions/download-artifact@v7.0.0\n        with:\n          name: buildchain-v4-release-apply-${{ needs.qualify.outputs.requested-sha }}\n",
+          "after": "          persist-credentials: false\n\n      - name: Restore canonical APPLY evidence\n        if: ${{ needs.qualify.outputs.action == 'promote' && !inputs.dry-run }}\n        uses: actions/download-artifact@v7.0.0\n        with:\n          name: buildchain-v4-release-apply-${{ needs.qualify.outputs.requested-sha }}\n"
+        },
+        {
+          "before": "\n      - name: Verify the single terminal receipt\n        id: verify\n        if: ${{ needs.apply.result == 'success' }}\n        shell: bash\n        run: |\n          node --input-type=module <<'NODE'\n          import fs from \"node:fs\";\n          import {\n            createV4ReleaseInvocation,\n            createV4ReleaseReceipt,\n            createV4ReleaseTransaction,\n          } from \"./.buildchain/runtime/packages/core/v4-release-invocation.js\";\n          const base = \".buildchain/evidence/release-tail\";\n          const invocation = JSON.parse(fs.readFileSync(`${base}/release-invocation.json`, \"utf8\"));\n          const transaction = JSON.parse(fs.readFileSync(`${base}/release-transaction.json`, \"utf8\"));\n          const storedReceipt = JSON.parse(fs.readFileSync(`${base}/release-receipt.json`, \"utf8\"));\n          const invocationProjection = createV4ReleaseInvocation(invocation);\n          const transactionProjection = createV4ReleaseTransaction({\n            invocationRoot: transaction.invocationRoot,\n            publisherRoot: transaction.publisherRoot,\n            runtimeRoot: transaction.runtimeRoot,\n            providerRoot: transaction.providerRoot,\n            parentRoot: transaction.parentRoot,\n          });\n          const { receiptRoot, ...receipt } = storedReceipt;\n          const receiptProjection = createV4ReleaseReceipt(receipt);\n          if (transaction.invocationRoot !== invocationProjection.roots.invocationRoot ||\n              transaction.transactionRoot !== transactionProjection.transactionRoot ||\n              receipt.transactionRoot !== transactionProjection.transactionRoot ||\n              receiptProjection.receiptRoot !== receiptRoot || receipt.outcome !== \"complete\") {\n            throw new Error(\"terminal ReleaseReceipt lineage does not verify\");\n          }\n          fs.appendFileSync(process.env.GITHUB_OUTPUT,\n            `receipt-json=${JSON.stringify(storedReceipt)}\\nreceipt-root=${receiptRoot}\\nstatus=complete\\n`);\n          NODE\n\n      - name: Record non-terminal projection state\n        id: projection-state\n        if: ${{ needs.apply.result != 'success' }}\n        shell: bash\n        run: |\n          echo \"status=${{ inputs.dry-run && 'dry-run' || needs.qualify.outputs.action == 'noop' && 'noop' || 'blocked' }}\" >> \"$GITHUB_OUTPUT\"\n",
+          "after": "\n      - name: Verify the single terminal receipt\n        id: verify\n        env:\n          CANDIDATE_SHA: ${{ needs.qualify.outputs.requested-sha }}\n        if: ${{ needs.qualify.outputs.action == 'promote' && !inputs.dry-run }}\n        shell: bash\n        run: |\n          node --input-type=module <<'NODE'\n          import fs from \"node:fs\";\n          const { readApplyDocuments, verifyPublicationSettlement } = await import(\"./.buildchain/runtime/scripts/v4-publication-settlement.mjs\");\n          const documents = readApplyDocuments(\".buildchain/evidence\");\n          verifyPublicationSettlement(documents, {\n            repository: process.env.GITHUB_REPOSITORY,\n            candidateSha: process.env.CANDIDATE_SHA,\n            tag: documents.invocation.target.tag,\n            sourceSha: documents.product.publication.releaseSha,\n          });\n          const storedReceipt = documents.receipt;\n          const receiptRoot = storedReceipt.receiptRoot;\n          fs.appendFileSync(process.env.GITHUB_OUTPUT,\n            `receipt-json=${JSON.stringify(storedReceipt)}\\nreceipt-root=${receiptRoot}\\nstatus=complete\\n`);\n          NODE\n\n      - name: Record non-terminal projection state\n        id: projection-state\n        if: ${{ always() && steps.verify.outcome != 'success' }}\n        shell: bash\n        run: |\n          echo \"status=${{ inputs.dry-run && 'dry-run' || needs.qualify.outputs.action == 'noop' && 'noop' || 'blocked' }}\" >> \"$GITHUB_OUTPUT\"\n"
+        },
+        {
+          "before": "            .buildchain/evidence/release-tail/release-invocation.json\n            .buildchain/evidence/release-tail/release-transaction.json\n            .buildchain/evidence/release-tail/release-receipt.json\n          if-no-files-found: error\n",
+          "after": "            .buildchain/evidence/release-tail/release-invocation.json\n            .buildchain/evidence/release-tail/release-transaction.json\n            .buildchain/evidence/release-tail/release-receipt.json\n            .buildchain/evidence/release-tail/delivery-summary.json\n            .buildchain/evidence/release-tail/buildchain-publication-settlement.json\n          if-no-files-found: error\n"
+        }
+      ]
+    }
+  ]
+}