@kungfu-tech/buildchain 4.1.3-alpha.4 → 4.1.3-alpha.6

package/scripts/check-public-dogfood-contract.mjs

@@ -4,6 +4,7 @@ import fs from "node:fs";
 import YAML from "yaml";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { checkSelfConsumerContract } from "./check-self-consumer-contract.mjs";
 
 const DEFAULT_ROOT = path.resolve(
   path.dirname(fileURLToPath(import.meta.url)),
@@ -15,35 +16,6 @@ export const PUBLIC_DOGFOOD_ENTRY_REF = "v4";
 const PRIVATE_CONSUMER = ["buildchain", "self", "dogfood"].join("-");
 const PRIVATE_SHADOW = ["kungfu", "shadow"].join("-");
 
-export function expectedPublicDogfoodWorkflow(validationRef) {
-  return `name: V4 Public Consumer Dogfood
-
-on:
-  pull_request:
-  workflow_dispatch:
-    inputs:
-      runtime-ref:
-        description: Transient runtime selected by the public entry.
-        type: string
-        default: ""
-
-permissions:
-  contents: read
-
-jobs:
-  dogfood:
-    uses: kungfu-systems/buildchain/.github/workflows/public-build-stage-capsule-canary.yml@${validationRef}
-    with:
-      runtime-ref: \${{ inputs.runtime-ref }}
-      consumer: buildchain
-      node-version: "24"
-      go-version: "1.25.x"
-      install-artifact-path: node_modules/.modules.yaml
-      build-artifact-path: actions/build/lifecycle/run/dist/index.js
-      verify-artifact-path: dist/site
-`;
-}
-
 function fail(message) {
   throw new Error(`v4-public-dogfood-contract: ${message}`);
 }
@@ -238,17 +210,22 @@ function assertWorkflowInventory(root) {
 }
 
 function assertProtectedVerify(root) {
-  const verify = read(root, ".github/workflows/self-build-verify.yml");
-  const parsed = YAML.parse(verify);
-  const nodePath = "actions/build/verification/repository/action.yml";
+  checkSelfConsumerContract(root);
+  const verify = read(root, "scripts/verify-product-platform.mjs");
   if (
-    ![parsed.jobs.check.needs].flat().includes("stage-capsule-checkpoints") ||
-    parsed.jobs.check.steps.at(-1).uses !==
-      `./.buildchain/runtime/${nodePath.replace(/\/action.yml$/, "")}`
+    !verify.includes("verifyStageCapsuleCheckpoints({") ||
+    !verify.includes('"--network=none"') ||
+    !verify.includes(
+      "sha256:11f0ba64267ce88174a4f73a9bf833ff4e9c59cd16ec3d08a6432a06c2be6fb1",
+    ) ||
+    !verify.includes("tests/build-orchestration.test.mjs") ||
+    !verify.includes("tests/build-artifact-pipeline.test.mjs") ||
+    !verify.includes("tests/dev-delivery-minimal-request.test.mjs")
   )
     fail(
-      "Verify must bind the protected check node after Stage Capsule checkpoints",
+      "Product verification must retain checkpoint recovery and the isolated container backbone lane",
     );
+  const nodePath = "actions/build/verification/repository/action.yml";
   const implementation = read(root, nodePath);
   const steps = YAML.parse(implementation).runs.steps;
   const qualify = steps.find((step) => step.id === "source-verification");
@@ -283,12 +260,13 @@ function assertArchitecture(root) {
   const validationRef = dogfood?.validationRef;
   if (validationRef !== PUBLIC_DOGFOOD_ENTRY_REF)
     fail("architecture validationRef must use the public v4 entry");
-  const caller = read(root, CALLER_PATH);
   if (
-    JSON.stringify(YAML.parse(caller)) !==
-    JSON.stringify(YAML.parse(expectedPublicDogfoodWorkflow(validationRef)))
+    dogfood?.active !== false ||
+    dogfood.supersededBy !== ".github/workflows/buildchain.yml"
   )
-    fail(`${CALLER_PATH} must remain the exact thin public consumer caller`);
+    fail(
+      "Historical Canary caller must be explicitly superseded by the minimal pipeline",
+    );
   if (JSON.stringify(architecture.campaign?.consumers) !== '["buildchain"]')
     fail(
       "architecture must qualify only the public Buildchain consumer identity",
@@ -335,17 +313,25 @@ function assertArchitecture(root) {
 }
 
 function assertConsumerLifecycle(root) {
-  const lifecycle = read(root, ".buildchain/buildchain.toml");
-  for (const declaration of [
-    '[lifecycle.install]\ncommand = "corepack enable pnpm && corepack pnpm@11.7.0 install --frozen-lockfile"',
-    '[lifecycle.build]\ncommand = "corepack pnpm@11.7.0 run build && corepack pnpm@11.7.0 run generate:site"',
-    "[lifecycle.verify]\ncommands = [",
-    '"corepack pnpm@11.7.0 run check",',
-  ])
-    if (!lifecycle.includes(declaration))
+  const { plan } = checkSelfConsumerContract(root);
+  for (const platform of ["linux-x64", "macos-arm64", "windows-x64"]) {
+    const product = plan.products.find(
+      (product) =>
+        product.platforms.includes(platform) &&
+        product.verify.includes("corepack pnpm@11.7.0 run check"),
+    );
+    if (
+      !product?.install.includes("corepack enable pnpm") ||
+      !product.install.includes(
+        "corepack pnpm@11.7.0 install --frozen-lockfile",
+      ) ||
+      !product.build.includes("corepack pnpm@11.7.0 run build") ||
+      !product.build.includes("corepack pnpm@11.7.0 run generate:site")
+    )
       fail(
-        `tracked consumer lifecycle is missing ${declaration.split("\n")[0]}`,
+        `${platform}: tracked consumer lifecycle is missing its pinned install or full generated build`,
       );
+  }
   const attributes = read(root, ".gitattributes");
   if (!attributes.split("\n").includes("* text=auto eol=lf"))
     fail("consumer checkout is missing the cross-platform LF contract");
@@ -394,8 +380,9 @@ export function checkPublicDogfoodContract(root = DEFAULT_ROOT) {
   return {
     schema: "buildchain-v4-public-dogfood-contract-check/v1",
     ok: true,
-    caller: CALLER_PATH,
-    reusable: REUSABLE_PATH,
+    caller: ".github/workflows/buildchain.yml",
+    reusable: ".github/workflows/public-ops-pipeline.yml",
+    historicalCanary: REUSABLE_PATH,
     validationRef,
     productionAuthority: "v4-native",
   };

package/scripts/check-release-topology.mjs

@@ -186,7 +186,10 @@ export function discoverReleaseAuthorityClosure() {
       ]),
     ].sort(),
     runtimeSelectors,
-    runtimeEngines: ["packages/core/release/promote-candidate/action.js"],
+    runtimeEngines: [
+      "packages/core/release/promote-candidate/action.js",
+      "packages/core/publication/pipeline/apply.js",
+    ],
     terminalProjections,
     privilegedExecutableClosure: {
       entrypoints: PRIVILEGED_ENTRYPOINTS,
@@ -382,7 +385,7 @@ export function findUnknownReleaseTopology(
     .filter((relative) => {
       const source = readWorkflow(relative);
       const usesReleaseAuthority = parseYamlUses(source).some(({ value }) =>
-        /(?:release-candidate-promote|promote-buildchain-ref|release-tail|actions\/release\/promotion\/(?:candidate|ref)|\.github\/workflows\/(?:public-release-promote|\.release-promote))/u.test(
+        /(?:release-candidate-promote|promote-buildchain-ref|release-tail|actions\/release\/promotion\/(?:candidate|ref)|\.github\/workflows\/(?:public-release-promote|\.release-promote|public-ops-pipeline|public-ops-recover|\.release-pipeline-products))/u.test(
           value,
         ),
       );
@@ -461,14 +464,12 @@ function assertAuthorityClosure(ledger) {
   );
   assert.deepEqual(closure.runtimeEngines, [
     "packages/core/release/promote-candidate/action.js",
+    "packages/core/publication/pipeline/apply.js",
   ]);
-  assert.equal(
-    closure.freshEntry,
-    ".github/workflows/public-release-promote.yml",
-  );
+  assert.equal(closure.freshEntry, ".github/workflows/public-ops-pipeline.yml");
   assert.equal(
     closure.recoveryEntry,
-    ".github/workflows/self-ops-promotion-recovery.yml",
+    ".github/workflows/public-ops-recover.yml",
   );
   const engineSurface = [
     ".github/workflows/.release-promote.yml",

package/scripts/check-self-consumer-contract.mjs

@@ -0,0 +1,133 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse as yaml } from "yaml";
+import { compileConsumerPlan } from "../packages/core/consumer/contract/plan.js";
+import { consumerWorkflows } from "../packages/core/consumer/contract/entries.js";
+import { workflowPath } from "../packages/core/workflow/workflow-taxonomy.mjs";
+
+export const SELF_ENTRY_CHANNEL = "v4-alpha";
+export const SELF_CONFIG_PATH = ".buildchain/minimal-consumer.toml";
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const PLATFORMS = ["linux-x64", "macos-arm64", "windows-x64"];
+
+// Repository policy checks the consumer-facing wiring. Product implementation
+// libraries are separately registered and may not own repository event triggers.
+// This policy supplies no repository identity exception to runtime admission.
+export function checkSelfConsumerContract(root = ROOT) {
+  const read = (file) => fs.readFileSync(path.join(root, file), "utf8");
+  const fail = (message) => {
+    throw new Error(`self-consumer-contract: ${message}`);
+  };
+  const plan = compileConsumerPlan(read(SELF_CONFIG_PATH));
+  if (read(SELF_CONFIG_PATH) !== read(".buildchain/buildchain.toml"))
+    fail("transition config must match the canonical product plan");
+  const callers = consumerWorkflows(SELF_ENTRY_CHANNEL, SELF_CONFIG_PATH);
+  for (const [file, bytes] of Object.entries(callers))
+    if (read(file) !== bytes) fail(`${file}: generated caller drift`);
+  const taxonomy = JSON.parse(read("architecture/workflow-taxonomy.json"));
+  const registered = new Set(taxonomy.entries.map(workflowPath));
+  const observed = fs
+    .readdirSync(path.join(root, ".github/workflows"))
+    .filter((file) => /\.ya?ml$/u.test(file))
+    .map((file) => `.github/workflows/${file}`);
+  if (
+    observed.length !== registered.size ||
+    observed.some((file) => !registered.has(file))
+  )
+    fail("workflow inventory is not closed");
+  const self = taxonomy.entries
+    .filter((entry) => entry.role === "self")
+    .map(workflowPath)
+    .sort();
+  if (JSON.stringify(self) !== JSON.stringify(Object.keys(callers).sort()))
+    fail("self automation must contain exactly the generated caller pair");
+  for (const entry of taxonomy.entries.filter(
+    (entry) => entry.role !== "self",
+  )) {
+    const file = workflowPath(entry);
+    const document = yaml(read(file));
+    if (
+      Object.keys(document.on || {}).some(
+        (event) => !["workflow_call", "workflow_dispatch"].includes(event),
+      )
+    )
+      fail(`${file}: product library owns a repository event`);
+  }
+  for (const prefix of ["feature", "fix", "chore", "docs", "ci", "refactor"])
+    if (
+      !plan.channels.some(
+        (route) =>
+          route.from === `${prefix}/*` &&
+          route.to === "dev/v4/v4.1" &&
+          route.operation === "develop",
+      )
+    )
+      fail(`missing protected development route for ${prefix}`);
+  for (const platform of PLATFORMS) {
+    const verified = plan.products.some(
+      (product) =>
+        product.platforms.includes(platform) &&
+        product.verify.includes("corepack pnpm@11.7.0 run check") &&
+        product.verify.includes("node scripts/verify-product-platform.mjs"),
+    );
+    if (!verified)
+      fail(
+        `${platform}: full check and platform recovery verification are required`,
+      );
+  }
+  if (
+    !plan.products.some(
+      (product) =>
+        product.type === "npm" &&
+        product.targets.some((target) => target.provider === "npm"),
+    )
+  )
+    fail("npm publication is missing");
+  for (const platform of PLATFORMS)
+    if (
+      !plan.products.some(
+        (product) =>
+          product.type === "binary" &&
+          product.platforms.includes(platform) &&
+          product.targets.some(
+            (target) => target.provider === "github-release",
+          ),
+      )
+    )
+      fail(`${platform}: binary release asset is missing`);
+  const commands = plan.products.flatMap((product) => [
+    ...(product.install || []),
+    ...product.build,
+    ...product.verify,
+  ]);
+  if (
+    commands.some((command) =>
+      /\b(?:npm publish|gh release|buildchain (?:dev warrant|release|promote|recover|publish))\b|request-json|fencingToken/u.test(
+        command,
+      ),
+    )
+  )
+    fail("product lifecycle contains consumer-owned publication orchestration");
+  if (!read(".gitattributes").split("\n").includes("* text=auto eol=lf"))
+    fail("cross-platform LF checkout contract is missing");
+  return {
+    ok: true,
+    channel: SELF_ENTRY_CHANNEL,
+    callers: Object.keys(callers),
+    plan,
+  };
+}
+
+if (
+  process.argv[1] &&
+  path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)
+) {
+  const { plan, ...result } = checkSelfConsumerContract();
+  console.log(
+    JSON.stringify({
+      ...result,
+      products: plan.products.map((product) => product.id),
+    }),
+  );
+}

package/scripts/check-universal-workflow-bootstrap.mjs

@@ -43,10 +43,8 @@ assert.doesNotMatch(read(contract.bootstrap.publicWorkflow), /admission-policy-j
 const template = parse(contract.bootstrap.consumerTemplate);
 assert.equal(template.jobs.bootstrap.uses, "kungfu-systems/buildchain/.github/workflows/public-ops-bootstrap.yml@v4");
 assert.equal(template.jobs.bootstrap.with["runtime-ref"], "${{ inputs.runtime-ref }}");
-const dogfood = parse(contract.bootstrap.selfDogfoodWorkflow);
-for (const channel of ["conformance", "alpha", "stable"]) for (const mode of ["primary", "recovery"]) {
-  const job = dogfood.jobs[`${mode}-${channel}`];
-  assert.equal(job.uses, "kungfu-systems/buildchain/.github/workflows/public-ops-bootstrap.yml@v4");
-  assert.equal(job.with["runtime-ref"], mode === "primary" ? "${{ inputs.runtime-ref }}" : "${{ inputs.recovery-runtime-ref }}");
-}
+assert.equal(contract.bootstrap.selfDogfoodActive, false);
+assert.equal(fs.existsSync(path.join(root, contract.bootstrap.selfDogfoodWorkflow)), false,
+  "The retired bootstrap self controller must not coexist with the minimal pipeline");
+assert.equal(contract.bootstrap.selfDogfoodSupersededBy, ".github/workflows/buildchain.yml");
 console.log(JSON.stringify({ ok: true, reusableWorkflowCount: reusable.length, runtimeAcquisitionOwners: 1 }));

package/scripts/generate-minimal-consumer-contract.mjs

@@ -143,7 +143,7 @@ output(
   await format(
     JSON.stringify({
       schema: "buildchain.consumer-migration/v1",
-      stage: "contract-defined; execution-entry-not-yet-published",
+      stage: "self-cutover-in-progress; final-release-qualification-pending",
       workflows: workflowInventory(),
       consumerSources: consumerSourceInventory(),
     }),

package/scripts/inventory/binary.mjs

@@ -1,26 +1,16 @@
 import assert from "node:assert/strict";
+import { checkSelfConsumerContract } from "../check-self-consumer-contract.mjs";
 import { inspectWorkflowJob, readWorkflow } from "../workflow-action-graph.mjs";
 
 export function assertBinaryInventory(root) {
-  const file = ".github/workflows/self-build-binary-distribution.yml";
-  const workflow = readWorkflow(file, root);
-  assert.equal(workflow.name, "Binary Distribution");
-  assert.deepEqual(Object.keys(workflow.jobs).filter(id => id !== "execution-runtime"), ["preflight", "binary", "passport", "dispatch-publication"]);
-  const graphs = Object.keys(workflow.jobs).filter(id => id !== "execution-runtime").map(id => inspectWorkflowJob(file, id, root));
-  for (const graph of graphs) {
-    assert.equal(graph.job.permissions.contents, "read");
-    assert.notEqual(graph.job.permissions["id-token"], "write");
-    assert.ok(!JSON.stringify(graph.job["runs-on"]).includes("self-hosted"));
-    for (const step of graph.steps) assert.ok(!/gh release (?:upload|create)/u.test(step.run || ""));
-    assert.ok(graph.actions.has(`actions/build/binary/${["preflight", "build", "passport", "dispatch-publication"][graphs.indexOf(graph)]}`));
-  }
-  const binary = graphs[1];
-  assert.deepEqual(binary.job.strategy.matrix.include.map(entry => entry.os).sort(), ["macos-latest", "ubuntu-24.04", "windows-2022"]);
-  const passport = graphs[2];
-  const executable = passport.modules.get("packages/core/build/binary/distribution.js");
-  for (const command of ["verifyBuildchainLogEvents", "verifyReleasePassport", "verifyArtifactPassport", "createReleaseEvidenceBundle", "buildchain-log-events", "buildchain-log-summary"])
-    assert.ok(executable.includes(command), `Binary evidence is missing ${command}`);
-  assert.ok(passport.actions.has("actions/build/binary/qualify"));
+  const { plan } = checkSelfConsumerContract(root);
+  assert.deepEqual(plan.products.filter(product => product.type === "binary")
+    .flatMap(product => product.platforms).sort(), ["linux-x64", "macos-arm64", "windows-x64"]);
+  const build = inspectWorkflowJob(".github/workflows/.release-pipeline-products.yml", "build", root);
+  assert.equal(build.job.permissions.contents, "read");
+  assert.notEqual(build.job.permissions["id-token"], "write");
+  assert.ok(!JSON.stringify(build.job["runs-on"]).includes("self-hosted"));
+  for (const step of build.steps) assert.ok(!/gh release (?:upload|create)/u.test(step.run || ""));
   const publish = inspectWorkflowJob(".github/workflows/.release-binary-assets.yml", "publish", root);
   assert.equal(publish.workflow.jobs["publication-authority"].uses, "./.github/workflows/.release-authority.yml");
   assert.ok(publish.job.needs.includes("publication-authority"));

package/scripts/inventory/promotion.mjs

@@ -1,4 +1,5 @@
 import assert from "node:assert/strict";
+import { checkSelfConsumerContract } from "../check-self-consumer-contract.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import YAML from "yaml";
@@ -35,19 +36,7 @@ export function assertPromotionInventory(root) {
     "publish-command",
   ])
     assert.ok(!request.properties[key]);
-  for (const file of [
-    "self-release-promote",
-    "self-release-tail-dogfood",
-    "self-ops-promotion-recovery",
-  ]) {
-    const caller = YAML.parse(read(`.github/workflows/${file}.yml`));
-    const calls = Object.values(caller.jobs).filter(
-      (job) => job.uses === `kungfu-systems/buildchain/${publicPath}@v4`,
-    );
-    assert.equal(calls.length, 1, file);
-    assert.ok(calls[0].with["request-json"]);
-    assert.ok(Object.keys(calls[0].with).every(key => ["request-json", "runtime-ref", "contract-lock", "runtime-selection"].includes(key)));
-  }
+  checkSelfConsumerContract(root);
   const component = ".github/workflows/.release-promote.yml";
   const expected = {
     qualify: "promotion/qualify",

package/scripts/prepare-product-toolchain.mjs

@@ -0,0 +1,10 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+// Product prerequisites cross command phases through the runner file protocol.
+// An explicit cache works with the credential-isolated Windows environment too.
+fs.appendFileSync(
+  process.env.GITHUB_ENV,
+  `GOTOOLCHAIN=go1.25.14+auto\nGOCACHE=${path.join(os.tmpdir(), "buildchain-go-cache")}\nGOPATH=${path.join(os.tmpdir(), "buildchain-go")}\n`,
+);

package/scripts/verify-product-platform.mjs

@@ -0,0 +1,65 @@
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { verifyStageCapsuleCheckpoints } from "../packages/core/build/stage-capsule/rehearsal/verify.js";
+
+const platform = {
+  linux: "linux-x64",
+  darwin: "macos-arm64",
+  win32: "windows-x64",
+}[process.platform];
+if (!platform)
+  throw new Error(
+    `Unsupported product verification platform: ${process.platform}`,
+  );
+const goVersion = execFileSync("go", ["version"], { encoding: "utf8" }).trim();
+const goMatch = /^go version go1\.(\d+)\./u.exec(goVersion);
+if (!goMatch || Number(goMatch[1]) < 25)
+  throw new Error(
+    `Product verification requires Go 1.25 or newer in major 1: ${goVersion}`,
+  );
+const workspace = process.cwd();
+const result = verifyStageCapsuleCheckpoints({
+  runtimeRoot: workspace,
+  workspace,
+  platform,
+  environment: process.env,
+});
+if (platform === "linux-x64") {
+  // Same immutable image and backbone tests as the retired container CI lane.
+  // Supply the selected Node as the hosted container runner did; no credentials.
+  const image =
+    "ghcr.io/kungfu-systems/build-images/kungfu-verify@sha256:11f0ba64267ce88174a4f73a9bf833ff4e9c59cd16ec3d08a6432a06c2be6fb1";
+  execFileSync(
+    "docker",
+    [
+      "run",
+      "--rm",
+      "--network=none",
+      "--cap-drop=ALL",
+      "--security-opt=no-new-privileges",
+      "--mount",
+      `type=bind,source=${path.resolve(workspace)},target=/source,readonly`,
+      "--mount",
+      `type=bind,source=${process.execPath},target=/toolchain/node,readonly`,
+      "--env",
+      "PATH=/toolchain:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
+      "--workdir",
+      "/source",
+      image,
+      "node",
+      "--test",
+      "tests/build-orchestration.test.mjs",
+      "tests/build-artifact-pipeline.test.mjs",
+      "tests/dev-delivery-minimal-request.test.mjs",
+    ],
+    { stdio: "inherit" },
+  );
+}
+console.log(
+  JSON.stringify({
+    platform,
+    checkpoint: result.checkpoint,
+    resume: result.resume,
+    tail: result.tail,
+  }),
+);