@kungfu-tech/buildchain 3.0.9-alpha.9 → 4.0.0-alpha.0

package/architecture/v4-stage-capsule-store-contract.json

@@ -0,0 +1,72 @@
+{
+  "schemaVersion": 1,
+  "contract": "kungfu-buildchain-v4-stage-capsule-store-architecture",
+  "identityAuthority": "architecture/v4-stage-capsule-contract.json",
+  "schemaAuthority": "contracts/v4-stage-capsule-store-v1.schema.json",
+  "fixtureAuthority": "contracts/fixtures/v4-stage-capsule-store-v1/shared.json",
+  "implementations": {
+    "rust": "crates/buildchain-v4-contracts/src/stage_capsule_store.rs",
+    "typescriptContract": "packages/core/v4-stage-capsule-store.js",
+    "localReferenceStore": "packages/core/v4-stage-capsule-local-store.js"
+  },
+  "authority": {
+    "writer": "typescript-v3",
+    "rust": "validation-only",
+    "localStore": "reference-effect-only",
+    "providerAdapters": "effect-disabled-or-fixture-backed",
+    "productionWriteChange": false
+  },
+  "rootDomains": [
+    "stage-capsule-output-manifest",
+    "stage-capsule-retention-promise",
+    "stage-capsule-retention-state",
+    "stage-capsule-transport",
+    "stage-capsule-store-receipt",
+    "stage-capsule-quarantine"
+  ],
+  "separateFacts": [
+    "capsuleRoot",
+    "manifestRoot",
+    "retentionStateRoot",
+    "availabilityRoot",
+    "transportRoot",
+    "qualificationRoot",
+    "receiptRoot"
+  ],
+  "localLayout": {
+    "key": "lowercase-sha256-root",
+    "immutableFamilies": ["blobs", "capsules", "manifests", "records"],
+    "quarantine": "rooted-marker",
+    "ambientClock": false,
+    "network": false
+  },
+  "faultPriority": [
+    "quarantined",
+    "missing",
+    "root-mismatch",
+    "expired",
+    "partial",
+    "corrupt"
+  ],
+  "providerBoundaries": [
+    {
+      "provider": "github-artifacts",
+      "modes": ["effect-disabled", "fixture-backed"]
+    },
+    {
+      "provider": "s3-compatible",
+      "modes": ["effect-disabled", "fixture-backed"]
+    }
+  ],
+  "budgets": {
+    "newHandMaintainedSourceFiles": 3,
+    "providerSdkImports": 0,
+    "networkEffects": 0,
+    "productionProviderMutations": 0,
+    "cacheFallbacks": 0,
+    "credentialFields": 0,
+    "ambientClocks": 0,
+    "productionWriteAuthorityChanges": 0,
+    "v3ConsumerBehaviorChanges": 0
+  }
+}

package/bin/buildchain.mjs

@@ -2,6 +2,7 @@
 import { spawn, spawnSync } from "node:child_process";
 import crypto from "node:crypto";
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { initBuildchainRepo } from "../scripts/init-repo.mjs";
@@ -1152,6 +1153,12 @@ async function runProcessTreeSample(sampleArgs = []) {
     cwd: process.cwd(),
     env: process.env,
     stdio: ["ignore", "pipe", "pipe"],
+    windowsVerbatimArguments:
+      process.platform === "win32" &&
+      path.basename(command).toLowerCase() === "cmd.exe" &&
+      args[0] === "/d" &&
+      args[1] === "/s" &&
+      args[2] === "/c",
   });
   child.stdout?.on("data", (chunk) => {
     stdoutTail.append(chunk);
@@ -1378,20 +1385,12 @@ async function handleDevCommand(args) {
       runScript("dev-delivery-warrant.mjs", devArgs);
       return;
     }
-    if (subcommand === "authority") {
-      runScript("dev-delivery-authority.mjs", devArgs);
-      return;
-    }
     if (subcommand === "proof") {
       runScript("dev-delivery-proof.mjs", devArgs);
       return;
     }
-    if (subcommand === "two-phase") {
-      runScript("dev-delivery-two-phase.mjs", devArgs);
-      return;
-    }
     if (subcommand !== "merge-queue") {
-      throw new Error("usage: buildchain dev <pr-admit|merge-queue|warrant|authority|proof|two-phase> [options]");
+      throw new Error("usage: buildchain dev <pr-admit|merge-queue|warrant|proof> [options]");
     }
     runScript("dev-merge-queue.mjs", devArgs);
     return;
@@ -1566,6 +1565,12 @@ async function handleLifecycleCommand(args) {
       required: readBooleanFlag(lifecycleArgs, "required"),
       artifactName: readFlag(lifecycleArgs, "artifact-name", "buildchain-artifact"),
       artifactPaths,
+      platformId: readFlag(lifecycleArgs, "platform-id", os.platform()),
+      platformName: readFlag(
+        lifecycleArgs,
+        "platform-name",
+        readFlag(lifecycleArgs, "platform-id", os.platform()),
+      ),
       manifestPath: readFlag(lifecycleArgs, "manifest-path", ".buildchain/artifacts/manifest.json"),
       summaryPath: readFlag(lifecycleArgs, "summary-path", ".buildchain/artifacts/summary.json"),
       expectedArtifactsJson: readFlag(lifecycleArgs, "expected-artifacts-json", ""),
@@ -1657,7 +1662,7 @@ async function handleReleaseGovernanceCommand(args) {
 }
 
 async function handleReleaseTailCommand(args) {
-  await runReleaseTailCli(args);
+  runReleaseTailCli(args);
 }
 
 async function handleGitHubGovernanceCommand(args) {

package/contracts/auditable-demo-scenario-v1.schema.json

@@ -112,7 +112,7 @@
     "renditions": {
       "const": [
         {"id": "1080p", "role": "primary", "columns": 150, "rows": 36, "width": 1920, "height": 1080},
-        {"id": "720p", "role": "responsive", "columns": 150, "rows": 28, "width": 1280, "height": 720}
+        {"id": "720p", "role": "responsive", "columns": 100, "rows": 28, "width": 1280, "height": 720}
       ]
     },
     "demos": {

package/contracts/buildchain-v2-residuals-v1.json

@@ -2,8 +2,8 @@
   "contract": "buildchain.v2-residual-inventory/v1",
   "scope": ".github/workflows on the current default branch",
   "policy": {
-    "runtimeDefault": "v3",
-    "dogfoodRuntimeDefault": "v3-alpha",
+    "runtimeDefault": "v4",
+    "dogfoodRuntimeDefault": "v4-alpha",
     "unclassifiedV2TokensAllowed": false
   },
   "entries": [

package/contracts/fixtures/v4-delivery-warrant-trace-v1/golden.json

@@ -0,0 +1,158 @@
+{
+  "schemaVersion": 1,
+  "contract": "buildchain-v4-delivery-warrant-trace-fixture/v1",
+  "runner": "buildchain-v4-delivery-warrant-fixture-runner/v1",
+  "trace": {
+    "id": "golden-submit-select",
+    "kind": "golden",
+    "initialState": {
+      "schema": "buildchain-v4-delivery-warrant-state/v1",
+      "generation": 0,
+      "fencingCounter": 0,
+      "activeWarrant": null,
+      "candidates": []
+    },
+    "initialStateRoot": "sha256:1e18ecb69d09e4ed2e370dfd364846a089bc5776f295018e11d85582d19f972b",
+    "steps": [
+      {
+        "sequence": 0,
+        "id": "submit",
+        "operation": "submit",
+        "event": {
+          "schema": "buildchain-v4-event-envelope/v1",
+          "eventId": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+          "eventType": "candidate-submitted",
+          "occurredAt": "2026-08-07T00:00:01.000Z",
+          "subjectRoot": "sha256:1e18ecb69d09e4ed2e370dfd364846a089bc5776f295018e11d85582d19f972b",
+          "payload": {
+            "candidateId": "candidate-101",
+            "pullRequestNumber": 101
+          }
+        },
+        "decision": { "action": "candidate-submitted", "fault": null },
+        "priorStateRoot": "sha256:1e18ecb69d09e4ed2e370dfd364846a089bc5776f295018e11d85582d19f972b",
+        "successorState": {
+          "schema": "buildchain-v4-delivery-warrant-state/v1",
+          "generation": 1,
+          "fencingCounter": 0,
+          "activeWarrant": null,
+          "candidates": [
+            {
+              "candidateId": "candidate-101",
+              "pullRequestNumber": 101,
+              "status": "queued"
+            }
+          ]
+        },
+        "successorRoot": "sha256:18049afcd211acf798f4eef2d11bb7a85823c7860dd9eb452f71b9abbde1a719",
+        "effects": [
+          {
+            "sequence": 0,
+            "type": "persist-successor",
+            "payload": {
+              "expectedOldStateRoot": "sha256:1e18ecb69d09e4ed2e370dfd364846a089bc5776f295018e11d85582d19f972b",
+              "nextStateRoot": "sha256:18049afcd211acf798f4eef2d11bb7a85823c7860dd9eb452f71b9abbde1a719"
+            }
+          }
+        ],
+        "observations": [
+          {
+            "sequence": 0,
+            "type": "state-readback",
+            "payload": {
+              "readbackRoot": "sha256:18049afcd211acf798f4eef2d11bb7a85823c7860dd9eb452f71b9abbde1a719",
+              "status": "matched"
+            }
+          }
+        ],
+        "receipt": {
+          "schema": "buildchain-v4-receipt-envelope/v1",
+          "receiptType": "candidate-submitted",
+          "recordedAt": "2026-08-07T00:00:01.000Z",
+          "eventRoot": "sha256:e990f213f7cfdc7ba028325b7e918bc12baf9ebbd0b07cd4bb65a06858649a0a",
+          "priorStateRoot": "sha256:1e18ecb69d09e4ed2e370dfd364846a089bc5776f295018e11d85582d19f972b",
+          "nextStateRoot": "sha256:18049afcd211acf798f4eef2d11bb7a85823c7860dd9eb452f71b9abbde1a719",
+          "outcome": "accepted",
+          "fault": null
+        },
+        "receiptRoot": "sha256:0eefe3a9f161b83895037ef423b465dda3993befb203dfab2adcc2581faee7df"
+      },
+      {
+        "sequence": 1,
+        "id": "select",
+        "operation": "select",
+        "event": {
+          "schema": "buildchain-v4-event-envelope/v1",
+          "eventId": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+          "eventType": "warrant-selected",
+          "occurredAt": "2026-08-07T00:00:02.000Z",
+          "subjectRoot": "sha256:18049afcd211acf798f4eef2d11bb7a85823c7860dd9eb452f71b9abbde1a719",
+          "payload": {
+            "candidateId": "candidate-101",
+            "fencingToken": "fence-1"
+          }
+        },
+        "decision": { "action": "warrant-selected", "fault": null },
+        "priorStateRoot": "sha256:18049afcd211acf798f4eef2d11bb7a85823c7860dd9eb452f71b9abbde1a719",
+        "successorState": {
+          "schema": "buildchain-v4-delivery-warrant-state/v1",
+          "generation": 2,
+          "fencingCounter": 1,
+          "activeWarrant": {
+            "candidateId": "candidate-101",
+            "fencingToken": "fence-1",
+            "generation": 2
+          },
+          "candidates": [
+            {
+              "candidateId": "candidate-101",
+              "pullRequestNumber": 101,
+              "status": "selected"
+            }
+          ]
+        },
+        "successorRoot": "sha256:dc85db06e2cea6b53afa8e5888f0d42b4d5374e9fc42bbc3c2fd3943e3d31363",
+        "effects": [
+          {
+            "sequence": 0,
+            "type": "persist-successor",
+            "payload": {
+              "expectedOldStateRoot": "sha256:18049afcd211acf798f4eef2d11bb7a85823c7860dd9eb452f71b9abbde1a719",
+              "nextStateRoot": "sha256:dc85db06e2cea6b53afa8e5888f0d42b4d5374e9fc42bbc3c2fd3943e3d31363"
+            }
+          },
+          {
+            "sequence": 1,
+            "type": "request-admission",
+            "payload": {
+              "candidateId": "candidate-101",
+              "fencingToken": "fence-1"
+            }
+          }
+        ],
+        "observations": [
+          {
+            "sequence": 0,
+            "type": "state-readback",
+            "payload": {
+              "readbackRoot": "sha256:dc85db06e2cea6b53afa8e5888f0d42b4d5374e9fc42bbc3c2fd3943e3d31363",
+              "status": "matched"
+            }
+          }
+        ],
+        "receipt": {
+          "schema": "buildchain-v4-receipt-envelope/v1",
+          "receiptType": "warrant-selected",
+          "recordedAt": "2026-08-07T00:00:02.000Z",
+          "eventRoot": "sha256:3d58747d5231ad3404f30e8f065fa0980a42d73bb791ed5193a4156251287823",
+          "priorStateRoot": "sha256:18049afcd211acf798f4eef2d11bb7a85823c7860dd9eb452f71b9abbde1a719",
+          "nextStateRoot": "sha256:dc85db06e2cea6b53afa8e5888f0d42b4d5374e9fc42bbc3c2fd3943e3d31363",
+          "outcome": "accepted",
+          "fault": null
+        },
+        "receiptRoot": "sha256:15e48ac87c06e1a7dad01d2d1848547abc4f01a06abd319261162a06ae8b86a7"
+      }
+    ]
+  },
+  "expectedProjectionRoot": "sha256:c1e1086119449f2cfef191fba51b60f91af668ee7c9b6159ef0c5a756f54c9c3"
+}