@kungfu-tech/buildchain 2.4.1-alpha.0 → 2.4.1-alpha.1

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

@@ -180,11 +180,16 @@ or ref finalization needs a later promotion run.
 After a publish transaction reaches `complete`, the action generates the unified
 `buildchain-release-passport` in `.buildchain/release-passport` by default and
 persists those files under `release-passport/` in the durable release-state ref.
+Set `release-passport-product-name` to record the consumer product name, for
+example `Libnode`, instead of the default `Buildchain`.
 When present, the passport includes the aggregate build summary, platform
 artifact manifests, npm publish evidence, dist-tag promotion evidence, the
 release-state ref, trusted publishing metadata, and the Buildchain transaction
-result. Set `release-passport: "false"` only for a controlled recovery run that
-must skip passport generation.
+result. After the first passport upload, Buildchain backfills the durable
+release-state SHA into `buildchain.release.json` and persists the passport
+again, so the consumer-side passport is a complete audit entrypoint. Set
+`release-passport: "false"` only for a controlled recovery run that must skip
+passport generation.
 
 Finalization recovery is anchored to the durable transaction, not to a single
 workflow run SHA. After a generated version-state PR is merged, the current

package/docs/publish-transaction.md

@@ -156,7 +156,9 @@ the `release-passport/*` files into the durable `buildchain/release-state/...`
 ref. The passport is the stable release artifact for agents and people: it
 links the package set, npm publish evidence, dist-tag evidence, build summary,
 platform artifact manifests, trusted publishing metadata, release-state ref,
-and transaction result in one schema.
+durable release-state SHA, and transaction result in one schema. Consumer
+repositories can set `release-passport-product-name` so the passport names their
+product instead of the Buildchain default.
 
 ## Evidence
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kungfu-tech/buildchain",
-  "version": "2.4.1-alpha.0",
+  "version": "2.4.1-alpha.1",
   "private": false,
   "description": "Buildchain Release Passport, release governance, CLI toolkit, and site facts.",
   "repository": "https://github.com/kungfu-systems/buildchain",