@kungfu-tech/buildchain 2.11.14-alpha.6 → 2.11.14-alpha.7

package/dist/site/site-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "contract": "kungfu-buildchain-site-manifest",
-  "generatedAt": "2026-07-10T16:41:11.001Z",
-  "publishedAt": "2026-07-10T16:41:11.001Z",
+  "generatedAt": "2026-07-11T00:08:19.877Z",
+  "publishedAt": "2026-07-11T00:08:19.877Z",
   "reproducible": true,
   "timestampPolicy": "ci-injected",
   "deterministicInputs": [
@@ -19,7 +19,7 @@
     "declared Buildchain surface manifest contract"
   ],
   "sourceDateEpoch": "0",
-  "sourceRevision": "4bbf92ba595952dbd22f8656829928991e84f448",
+  "sourceRevision": "7d3f049ffc8b567c3afad9fa9f8e974b50fd3b90",
   "timestampPolicyDetails": {
     "contract": "kungfu-buildchain-surface-timestamp-policy",
     "timestampFields": [
@@ -37,7 +37,7 @@
   },
   "package": {
     "name": "@kungfu-tech/buildchain",
-    "version": "2.11.14-alpha.6",
+    "version": "2.11.14-alpha.7",
     "versionSource": "package.json#version"
   },
   "entrypoint": "buildchain-site.json",
@@ -53,7 +53,7 @@
       "path": "docs/MAP.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:53b605e57a5ac2b8d4ed911a4fbb4d1a39352db143db183aa551f9226f2d7a6a"
+      "digest": "sha256:02987c6bf99441eddc630fa4050fd109c15923047a4591e26d54a714c124539a"
     },
     {
       "id": "install",
@@ -205,7 +205,7 @@
       "path": "docs/reusable-build-surface.md",
       "plane": "use",
       "exists": true,
-      "digest": "sha256:b9335434f95e6173f31d50983f8ab492378b065fa203a3b68bee447487883cea"
+      "digest": "sha256:4611e4ae47091687f50b489ccc6caba911f13bb1f73b27a5d44581d8a6450d06"
     },
     {
       "id": "publish-transaction",
@@ -221,7 +221,7 @@
       "path": "docs/release-governance.md",
       "plane": "why",
       "exists": true,
-      "digest": "sha256:8a70f9f2699bcec6102164d6ae67f13549f3ef962d12441fbb80f9d49a1cc2e1"
+      "digest": "sha256:69c4146640626bc03b93ac178e250745e45939ba9443f3ba27207a35522036c4"
     },
     {
       "id": "release-flow",
@@ -237,7 +237,7 @@
       "path": "docs/runtime-train-validation.md",
       "plane": "verify",
       "exists": true,
-      "digest": "sha256:bb053594407bd0f78aa43352a249a2ffa19825374147cc712cd56ca6ad50dfa3"
+      "digest": "sha256:1872e511b31c04ba75fc3a005c7a4f857c8b06ecadfedb75bc35b2ce70e7764a"
     },
     {
       "id": "versioning",

package/dist/site/workflow-registry.json

@@ -343,6 +343,15 @@
       "capabilityGroup": "api-cli-reference",
       "status": "repository-internal"
     },
+    {
+      "id": "buildchain-alpha-self-dogfood",
+      "path": ".github/workflows/buildchain-alpha-self-dogfood.yml",
+      "inputs": [],
+      "inputCount": 0,
+      "surface": "repository-workflow",
+      "capabilityGroup": "api-cli-reference",
+      "status": "active"
+    },
     {
       "id": "buildchain-patrol-daily",
       "path": ".github/workflows/buildchain-patrol-daily.yml",

package/docs/MAP.md

@@ -114,6 +114,8 @@ replace them.
 - **v2 / v2-alpha / v2.0 / v2.0-alpha / exact tags / floating tags** ->
   [`release-governance.md`](release-governance.md) and
   [`release-flow.md`](release-flow.md).
+- **Buildchain self-dogfood / released alpha canary / stable compatibility lane** ->
+  [`release-governance.md`](release-governance.md#buildchain-alpha-self-dogfood).
 - **v2.1 vs v2.2 / when to open a new minor line** ->
   [`versioning.md`](versioning.md).
 - **dry-run / what would happen if this channel PR merges** -> [`cli.md`](cli.md)

package/docs/release-governance.md

@@ -167,6 +167,41 @@ This keeps the test channel self-describing. If a consumer checks out
 alpha ref removes routine consumer edits when Buildchain opens a newer minor,
 while exact tags and SHAs remain the reproducible audit choice.
 
+### Buildchain Alpha Self-Dogfood
+
+Buildchain continuously consumes its own current major alpha through
+`.github/workflows/buildchain-alpha-self-dogfood.yml`. The workflow calls the
+released outer reusable workflow at `@v2-alpha` without a runtime override, so
+both the workflow shell and its default runtime must resolve through the same
+floating alpha channel. A parallel stable lane checks out `v2` and runs the
+same declared install, build, and verify lifecycle directly. The direct stable
+lane is intentional: it preserves stable-runtime compatibility without
+requiring the previous stable outer workflow to understand a self-call identity
+fix that has not reached stable yet. Both lanes use a single GitHub-hosted Linux
+fixture to keep the recurring check bounded.
+
+The reusable build trust gate reads `job.workflow_ref`, which identifies the
+called workflow and its selected ref. It does not infer the runtime from
+`github.workflow_ref`, because GitHub defines that context as the caller
+workflow identity during a reusable call.
+
+The evidence job resolves `v2-alpha` and `v2` through the GitHub refs API,
+compares those immutable SHAs with the reusable workflow outputs, verifies the
+`alpha` and `stable` classifications, and uploads a JSON evidence artifact.
+The canary runs after successful Buildchain ref promotion, on a daily fallback
+schedule, and on manual dispatch. It shares the release-promotion concurrency
+group, so another promotion cannot move the floating refs between runtime
+resolution and evidence comparison.
+
+This is a post-publication consumer canary, not a release bootstrap. Source
+verification still runs the current commit, and
+`buildchain-ref-promotion.yml` still passes the verified exact SHA into the
+promotion workflow. Patrol, dev-merge, repair, and promotion defaults remain on
+stable or exact refs so a broken alpha cannot prevent Buildchain from publishing
+its fix. When Buildchain opens a new major, inventory validation requires this
+workflow's fixed GitHub `uses` refs to move from `vN`/`vN-alpha` to the new
+major; GitHub does not allow expressions in a reusable-workflow `uses` ref.
+
 If `dev/vX/vX.Y` has already advanced before generated alpha version-state
 bookkeeping can sync back, Buildchain records `skipped-non-fast-forward` for the
 dev sync and still completes the exact and floating alpha tags for the reviewed

package/docs/reusable-build-surface.md

@@ -214,6 +214,21 @@ The lock is intentionally small. It does not copy the full contract. The full
 contract remains in the Buildchain ref and package; the consumer records only
 what it accepted and the policy used to compare future floating-ref movement.
 
+Alpha-channel consumers select the matching workflow shell:
+
+```yaml
+jobs:
+  build:
+    uses: kungfu-systems/buildchain/.github/workflows/.build.yml@v2-alpha
+    with:
+      buildchain-contract-lock-path: .buildchain/contract-lock.json
+```
+
+The runtime follows the called workflow through `job.workflow_ref`. Callers may
+also pass `buildchain-ref: v2-alpha` explicitly; official floating refs are
+ordinary channel selections and are allowed on pull requests and pushes. Train
+refs and exact SHAs remain trusted manual overrides.
+
 ## Locked Source Checkout Cache
 
 Self-hosted runners that build large repositories can opt into a locked source
@@ -309,7 +324,7 @@ The reusable workflow exposes the resolved contract:
 | `buildchain-runtime-ref`          | Runtime ref selected after applying the empty-default or override policy        |
 | `buildchain-runtime-sha`          | Immutable Buildchain runtime commit used by all runtime checkouts               |
 | `buildchain-runtime-class`        | `stable`, `alpha`, `train`, `exact-sha`, or `development`                       |
-| `buildchain-runtime-override`     | `true` when a non-empty `buildchain-ref` override was accepted                  |
+| `buildchain-runtime-override`     | `true` when a train or exact-SHA `buildchain-ref` override was accepted          |
 | `buildchain-runtime-trust-decision` | Runtime override trust decision                                               |
 | `buildchain-contract-lock-status` | `unchanged`, `compatible-drift`, `breaking-drift`, `missing-lock`, `non-floating-runtime`, or first-release `runtime-contract-unavailable` |
 | `buildchain-contract-lock-drift`  | `true` when the floating runtime SHA or contract digest changed                 |

package/docs/runtime-train-validation.md

@@ -5,6 +5,14 @@ committed workflow YAML. Runtime trains provide a temporary validation pointer
 for Buildchain changes that are ready for downstream testing but not yet
 promoted through the normal `dev -> alpha -> release` chain.
 
+Official floating channels are not runtime overrides. A consumer that
+deliberately follows `@v2-alpha` gets the matching runtime on pull requests and
+pushes because the reusable workflow reads the called workflow identity from
+`job.workflow_ref`. Passing `buildchain-ref: v2-alpha` explicitly is also
+accepted when the caller wants the channel binding visible in its input set.
+The caller's `github.workflow_ref` is not used for this inference because it
+identifies the caller workflow during reusable calls.
+
 ## Train refs
 
 A train ref is a branch in the Buildchain repository:
@@ -111,10 +119,12 @@ summary. The evidence should include:
 
 ## Trust and limitation
 
-Runtime overrides fail closed unless the event is `workflow_dispatch` and the
-actor has write, maintain, or admin permission on the caller repository.
-Pull requests, including fork-originated pull requests, cannot use a non-empty
-`buildchain-ref`.
+Official floating channel refs such as `v2` and `v2-alpha` may be selected on
+pull requests and pushes. Train refs and arbitrary exact-SHA overrides still
+fail closed unless the event is `workflow_dispatch` and the actor has write,
+maintain, or admin permission on the caller repository. Pull requests,
+including fork-originated pull requests, cannot use train or exact-SHA
+overrides.
 
 Runtime train validation covers Buildchain runtime scripts, CLI code, local
 actions, configuration parsing, and lifecycle behavior. It cannot validate

package/package.json

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

package/scripts/check-inventory.mjs

@@ -71,6 +71,7 @@ const requiredPaths = [
   ".github/workflows/buildchain-patrol-daily.yml",
   ".github/workflows/buildchain-patrol-weekly.yml",
   ".github/workflows/buildchain-patrol-monthly.yml",
+  ".github/workflows/buildchain-alpha-self-dogfood.yml",
   ".github/workflows/release-candidate-promote.yml",
   ".github/workflows/release-propagation.yml",
   ".github/workflows/npm-publish.yml",
@@ -97,6 +98,58 @@ if (rootPackage.name !== "@kungfu-tech/buildchain") {
 if (rootPackage.private !== false) {
   throw new Error("root package must be publishable with private=false");
 }
+const selfDogfoodWorkflow = fs.readFileSync(
+  path.join(root, ".github/workflows/buildchain-alpha-self-dogfood.yml"),
+  "utf8",
+);
+const selfDogfoodMajor = String(rootPackage.version || "").match(/^(\d+)\./)?.[1];
+if (!selfDogfoodMajor) {
+  throw new Error("root package version must expose a numeric major for self-dogfood");
+}
+for (const requiredSnippet of [
+  `/.github/workflows/.build.yml@v${selfDogfoodMajor}-alpha`,
+  `ref: v${selfDogfoodMajor}`,
+  `echo "ref=v${selfDogfoodMajor}"`,
+  `const alphaRef = "v${selfDogfoodMajor}-alpha"`,
+  `const stableRef = "v${selfDogfoodMajor}"`,
+]) {
+  if (!selfDogfoodWorkflow.includes(requiredSnippet)) {
+    throw new Error(`Buildchain self-dogfood workflow missing current-major snippet: ${requiredSnippet}`);
+  }
+}
+const reusableBuildWorkflow = fs.readFileSync(
+  path.join(root, ".github/workflows/.build.yml"),
+  "utf8",
+);
+for (const requiredSnippet of [
+  "BUILDCHAIN_WORKFLOW_REF: ${{ job.workflow_ref }}",
+  "process.env.BUILDCHAIN_WORKFLOW_REF || process.env.GITHUB_WORKFLOW_REF",
+  'replace(/^refs\\/(?:heads|tags)\\//, "")',
+]) {
+  if (!reusableBuildWorkflow.includes(requiredSnippet)) {
+    throw new Error(`reusable build workflow missing called-workflow identity: ${requiredSnippet}`);
+  }
+}
+for (const requiredSnippet of [
+  "group: buildchain-release-promotion-${{ github.repository }}",
+  "cancel-in-progress: false",
+]) {
+  if (!selfDogfoodWorkflow.includes(requiredSnippet)) {
+    throw new Error(`Buildchain self-dogfood workflow missing promotion serialization: ${requiredSnippet}`);
+  }
+}
+const actionlintConfig = fs.readFileSync(
+  path.join(root, ".github/actionlint.yaml"),
+  "utf8",
+);
+for (const requiredSnippet of [
+  ".github/workflows/.build.yml:",
+  'property "workflow_ref" is not defined in object type',
+]) {
+  if (!actionlintConfig.includes(requiredSnippet)) {
+    throw new Error(`actionlint config missing scoped job.workflow_ref compatibility rule: ${requiredSnippet}`);
+  }
+}
 const packageDependencySections = ["dependencies", "optionalDependencies", "peerDependencies"];
 const exoticDependencyPattern =
   /^(?:git(?:\+ssh|\+https|\+http|\+file)?:|github:|gitlab:|bitbucket:|https?:|file:|link:|workspace:)/i;

package/scripts/runtime-ref-core.mjs

@@ -1,5 +1,6 @@
 const EXACT_SHA_RE = /^[0-9a-f]{40}$/i;
 const TRAIN_REF_RE = /^train\/v\d+\/v\d+\.\d+\/[A-Za-z0-9._/-]+$/;
+const OFFICIAL_CHANNEL_REF_RE = /^v\d+(?:\.\d+)?(?:-alpha)?$/;
 
 export function parseWorkflowShellRef(workflowRef = "", fallback = "v2", buildchainRepository = "kungfu-systems/buildchain") {
   const value = String(workflowRef || "");
@@ -8,7 +9,7 @@ export function parseWorkflowShellRef(workflowRef = "", fallback = "v2", buildch
     return fallback;
   }
   const ref = value.split("@").pop()?.trim();
-  return ref || fallback;
+  return (ref || fallback).replace(/^refs\/(?:heads|tags)\//, "");
 }
 
 export function classifyBuildchainRuntimeRef(ref = "") {
@@ -28,13 +29,34 @@ export function classifyBuildchainRuntimeRef(ref = "") {
   return "development";
 }
 
+export function isOfficialBuildchainChannelRef(ref = "") {
+  const value = String(ref || "").trim().replace(/^refs\/tags\//, "");
+  return OFFICIAL_CHANNEL_REF_RE.test(value);
+}
+
 export function normalizeRequestedRuntimeRef(requestedRef = "") {
   const requested = String(requestedRef || "").trim();
   if (!requested) {
-    return { ref: "", fullRef: "", class: "", exactSha: false };
+    return { ref: "", fullRef: "", class: "", exactSha: false, officialChannel: false };
+  }
+  if (isOfficialBuildchainChannelRef(requested)) {
+    const channelRef = requested.replace(/^refs\/tags\//, "");
+    return {
+      ref: channelRef,
+      fullRef: channelRef,
+      class: classifyBuildchainRuntimeRef(channelRef),
+      exactSha: false,
+      officialChannel: true,
+    };
   }
   if (EXACT_SHA_RE.test(requested)) {
-    return { ref: requested, fullRef: requested, class: "exact-sha", exactSha: true };
+    return {
+      ref: requested,
+      fullRef: requested,
+      class: "exact-sha",
+      exactSha: true,
+      officialChannel: false,
+    };
   }
   const trainRef = requested.replace(/^refs\/heads\//, "");
   if (!TRAIN_REF_RE.test(trainRef)) {
@@ -47,6 +69,7 @@ export function normalizeRequestedRuntimeRef(requestedRef = "") {
     fullRef: `refs/heads/${trainRef}`,
     class: "train",
     exactSha: false,
+    officialChannel: false,
   };
 }
 
@@ -71,15 +94,16 @@ export function resolveRuntimeSelection({
     };
   }
   const normalized = normalizeRequestedRuntimeRef(requested);
+  const runtimeOverride = !normalized.officialChannel;
   return {
     requestedRef: requested,
     runtimeRef: normalized.ref,
     runtimeFullRef: normalized.fullRef,
     runtimeClass: normalized.class,
-    runtimeOverride: true,
+    runtimeOverride,
     workflowShellRef: workflowShellRef || defaultStableRef,
     rollbackRef: workflowShellRef || defaultStableRef,
-    trustDecision: "override-requested",
+    trustDecision: normalized.officialChannel ? "official-channel" : "override-requested",
   };
 }
 
@@ -91,6 +115,9 @@ export function validateRuntimeOverrideTrust({
   if (!String(requestedRef || "").trim()) {
     return { ok: true, decision: "stable-default" };
   }
+  if (isOfficialBuildchainChannelRef(requestedRef)) {
+    return { ok: true, decision: "official-channel" };
+  }
   if (eventName !== "workflow_dispatch") {
     return {
       ok: false,