@kungfu-tech/buildchain 2.12.0 → 2.12.1-alpha.10

package/dist/site/capability-registry.json

@@ -15,7 +15,7 @@
       "maturity": "stable",
       "counts": {
         "manualCount": 3,
-        "pageCount": 5,
+        "pageCount": 6,
         "cliCommandCount": 5,
         "nodeApiCount": 0,
         "workflowCount": 0,
@@ -115,7 +115,7 @@
       "counts": {
         "manualCount": 1,
         "pageCount": 1,
-        "cliCommandCount": 26,
+        "cliCommandCount": 27,
         "nodeApiCount": 5,
         "workflowCount": 0,
         "actionCount": 0
@@ -247,8 +247,8 @@
         "manualCount": 7,
         "pageCount": 7,
         "cliCommandCount": 5,
-        "nodeApiCount": 2,
-        "workflowCount": 8,
+        "nodeApiCount": 3,
+        "workflowCount": 10,
         "actionCount": 0
       },
       "manuals": [
@@ -285,7 +285,7 @@
         "pageCount": 6,
         "cliCommandCount": 0,
         "nodeApiCount": 2,
-        "workflowCount": 24,
+        "workflowCount": 25,
         "actionCount": 0
       },
       "manuals": [

package/dist/site/cli-registry.json

@@ -593,6 +593,18 @@
       ],
       "maturity": "stable"
     },
+    {
+      "id": "layout",
+      "source": "bin/buildchain.mjs",
+      "usage": "buildchain layout [--cwd <dir>] [--json]",
+      "purpose": "Return the versioned repository-layout and KFD registry discovery contract for tools such as Shifu.",
+      "capabilityGroup": "kfd-trust",
+      "audience": [
+        "agent",
+        "operator"
+      ],
+      "maturity": "stable"
+    },
     {
       "id": "lifecycle",
       "source": "bin/buildchain.mjs",

package/dist/site/kfd-claims.json

@@ -21,13 +21,13 @@
     "contract": "kungfu-buildchain-public-surface-reverse-audit",
     "path": "dist/site/public-surface-audit.json",
     "status": "passed",
-    "sha256": "abb62f9017ec8d3bdad15be860bda98aaf4438e0fd623fe1d9200619a497ccab",
+    "sha256": "99f063a65baf4a13767477f2d33796a5fcc1bb0bcafdaef39074f84c7ce7ba2d",
     "summary": {
-      "cliCommandCount": 75,
-      "workflowCount": 39,
+      "cliCommandCount": 76,
+      "workflowCount": 42,
       "actionCount": 4,
-      "sitePageCount": 45,
-      "docCommandRefCount": 237,
+      "sitePageCount": 46,
+      "docCommandRefCount": 241,
       "failureCount": 0
     },
     "auditBoundary": {
@@ -110,6 +110,23 @@
         "dist/site/public-surface-audit.json"
       ]
     },
+    {
+      "id": "claim:buildchain-shifu-kfd-discovery",
+      "claim": "Buildchain exposes a versioned repository-layout discovery contract and KFD-3 distribution declarations so Shifu can locate the registry and determine jurisdiction without copying Buildchain layout paths.",
+      "sourcePaths": [
+        "packages/core/buildchain-layout.js",
+        "packages/core/buildchain-kfd-claims.js",
+        "packages/core/kfd3-surface-register.js",
+        "bin/buildchain.mjs",
+        "scripts/build-standalone-binary.mjs",
+        "docs/kfd-support.md"
+      ],
+      "artifactPaths": [
+        "dist/site/kfd-claims.json",
+        "dist/site/cli-registry.json",
+        "dist/site/node-api-registry.json"
+      ]
+    },
     {
       "id": "claim:buildchain-readme-badge-facts",
       "claim": "Buildchain README status badges are generated from repository-owned facts and verified release-passport evidence, not hand-maintained README prose.",
@@ -208,13 +225,13 @@
       "contract": "kungfu-buildchain-public-surface-reverse-audit",
       "path": "dist/site/public-surface-audit.json",
       "status": "passed",
-      "sha256": "abb62f9017ec8d3bdad15be860bda98aaf4438e0fd623fe1d9200619a497ccab",
+      "sha256": "99f063a65baf4a13767477f2d33796a5fcc1bb0bcafdaef39074f84c7ce7ba2d",
       "summary": {
-        "cliCommandCount": 75,
-        "workflowCount": 39,
+        "cliCommandCount": 76,
+        "workflowCount": 42,
         "actionCount": 4,
-        "sitePageCount": 45,
-        "docCommandRefCount": 237,
+        "sitePageCount": 46,
+        "docCommandRefCount": 241,
         "failureCount": 0
       },
       "auditBoundary": {
@@ -1122,6 +1139,18 @@
           "public": true,
           "packageExport": "./release-candidate"
         },
+        {
+          "id": "export:./stable-candidate-ledger",
+          "name": "@kungfu-tech/buildchain/stable-candidate-ledger",
+          "kind": "package-export",
+          "sourcePath": "packages/core/stable-candidate-ledger.js",
+          "evidencePath": "packages/core/stable-candidate-ledger.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./stable-candidate-ledger"
+        },
         {
           "id": "export:./release-passport",
           "name": "@kungfu-tech/buildchain/release-passport",
@@ -1960,6 +1989,18 @@
           "public": true,
           "reverseAuditSource": "bin/buildchain.mjs"
         },
+        {
+          "id": "cli:layout",
+          "name": "buildchain layout [--cwd <dir>] [--json]",
+          "kind": "cli-command",
+          "sourcePath": "bin/buildchain.mjs",
+          "evidencePath": "bin/buildchain.mjs",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "bin/buildchain.mjs"
+        },
         {
           "id": "cli:lifecycle",
           "name": "buildchain lifecycle run <stage> [--cwd <dir>] [--required]",
@@ -2282,7 +2323,7 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 50,
+          "inputCount": 57,
           "inputs": [
             "artifact-name",
             "artifact-name-template",
@@ -2302,6 +2343,7 @@
             "buildchain-contract-lock-path",
             "buildchain-ref",
             "buildchain-repository",
+            "cargo-registry-index",
             "checkout-cache-fallback",
             "checkout-cache-fetch-attempts",
             "checkout-cache-github-timeout-seconds",
@@ -2329,8 +2371,14 @@
             "require-trusted-event",
             "require-verify",
             "runner-preset",
+            "rust-toolchain",
+            "rustup-dist-server",
+            "rustup-update-root",
             "sample-process-tree",
             "setup-node",
+            "setup-rust",
+            "shifu-cache-profile-digest",
+            "shifu-cache-profile-ref",
             "untrusted-policy",
             "verify-command",
             "working-directory"
@@ -2697,7 +2745,7 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 53,
+          "inputCount": 60,
           "inputs": [
             "artifact-name",
             "artifact-name-template",
@@ -2720,6 +2768,7 @@
             "buildchain-ref",
             "buildchain-repository",
             "buildchain-stable-contract-lock-path",
+            "cargo-registry-index",
             "checkout-cache-fallback",
             "checkout-cache-fetch-attempts",
             "checkout-cache-github-timeout-seconds",
@@ -2747,8 +2796,14 @@
             "require-trusted-event",
             "require-verify",
             "runner-preset",
+            "rust-toolchain",
+            "rustup-dist-server",
+            "rustup-update-root",
             "sample-process-tree",
             "setup-node",
+            "setup-rust",
+            "shifu-cache-profile-digest",
+            "shifu-cache-profile-ref",
             "untrusted-policy",
             "verify-command",
             "working-directory"
@@ -2868,6 +2923,41 @@
           ],
           "reverseAuditSource": ".github/workflows"
         },
+        {
+          "id": "workflow:buildchain-stable-candidate-patrol",
+          "name": "workflow:buildchain-stable-candidate-patrol",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/buildchain-stable-candidate-patrol.yml",
+          "evidencePath": ".github/workflows/buildchain-stable-candidate-patrol.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 3,
+          "inputs": [
+            "buildchain-ref",
+            "dry-run",
+            "release-now"
+          ],
+          "reverseAuditSource": ".github/workflows"
+        },
+        {
+          "id": "workflow:buildchain-stable-candidate-qualification",
+          "name": "workflow:buildchain-stable-candidate-qualification",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/buildchain-stable-candidate-qualification.yml",
+          "evidencePath": ".github/workflows/buildchain-stable-candidate-qualification.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 2,
+          "inputs": [
+            "candidate-sha",
+            "dry-run"
+          ],
+          "reverseAuditSource": ".github/workflows"
+        },
         {
           "id": "workflow:candidate-lab",
           "name": "workflow:candidate-lab",
@@ -2897,10 +2987,11 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 6,
+          "inputCount": 7,
           "inputs": [
             "buildchain-ref",
             "buildchain-repository",
+            "mode",
             "node-version",
             "require-version-state",
             "upload-artifacts",
@@ -3264,6 +3355,36 @@
           "inputs": [],
           "reverseAuditSource": ".github/workflows"
         },
+        {
+          "id": "workflow:stable-candidate-patrol",
+          "name": "workflow:stable-candidate-patrol",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/stable-candidate-patrol.yml",
+          "evidencePath": ".github/workflows/stable-candidate-patrol.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 15,
+          "inputs": [
+            "auto-approve",
+            "auto-merge",
+            "auto-promote",
+            "buildchain-ref",
+            "buildchain-repository",
+            "dry-run",
+            "hold",
+            "hold-reason",
+            "ledger-ref",
+            "minimum-soak-seconds",
+            "release-now",
+            "required-checks",
+            "revoke-reason",
+            "revoked-versions",
+            "target-branch"
+          ],
+          "reverseAuditSource": ".github/workflows"
+        },
         {
           "id": "workflow:verify",
           "name": "workflow:verify",
@@ -3947,6 +4068,18 @@
           "public": true,
           "reverseAuditSource": "dist/site/page-registry.json"
         },
+        {
+          "id": "site-page:manual:stable-candidate-patrol",
+          "name": "site-page:manual:stable-candidate-patrol",
+          "kind": "site-page",
+          "sourcePath": "dist/site/page-registry.json",
+          "evidencePath": "dist/site/page-registry.json",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "reverseAuditSource": "dist/site/page-registry.json"
+        },
         {
           "id": "site-page:manual:toolkit-observability",
           "name": "site-page:manual:toolkit-observability",
@@ -4063,8 +4196,43 @@
         "visibility": "public",
         "participantFacing": true,
         "public": true
+      },
+      {
+        "id": "distribution:buildchain-standalone",
+        "name": "Buildchain standalone binary distribution",
+        "kind": "binary-distribution",
+        "sourcePath": "scripts/build-standalone-binary.mjs",
+        "evidencePath": ".github/workflows/binary-distribution.yml",
+        "availability": "shipped",
+        "visibility": "public",
+        "participantFacing": true,
+        "public": true,
+        "artifactPath": "dist/binary",
+        "distribution": {
+          "registrar": "shifu",
+          "tasks": [
+            "binary:build"
+          ],
+          "artifacts": [
+            {
+              "kind": "binary",
+              "platform": "linux",
+              "pathGlob": "dist/binary/buildchain-x86_64-unknown-linux-gnu.tar.gz"
+            },
+            {
+              "kind": "binary",
+              "platform": "macos",
+              "pathGlob": "dist/binary/buildchain-aarch64-apple-darwin.tar.gz"
+            },
+            {
+              "kind": "binary",
+              "platform": "windows",
+              "pathGlob": "dist/binary/buildchain-x86_64-pc-windows-msvc.zip"
+            }
+          ]
+        }
       }
     ],
-    "publicSurfaceCount": 266
+    "publicSurfaceCount": 273
   }
 }

package/dist/site/kfd-upstream-aggregate.json

@@ -4,7 +4,7 @@
   "product": {
     "id": "kungfu-tech-buildchain",
     "name": "@kungfu-tech/buildchain",
-    "version": "2.12.0",
+    "version": "2.12.1-alpha.10",
     "repository": "https://github.com/kungfu-systems/buildchain"
   },
   "source": {

package/dist/site/manual-registry.json

@@ -9,7 +9,7 @@
       "title": "Buildchain documentation map",
       "path": "docs/MAP.md",
       "plane": "use",
-      "digest": "sha256:bad18d05d3d03b77bf64d8697fc351d58b1372a355a4f25c6719bf08984a79a2",
+      "digest": "sha256:0735009b21cea9227f2c9b9bcbec1219898f4d211776b60aa030ace65821ec80",
       "capabilityGroup": "getting-started",
       "audience": [
         "agent",
@@ -106,7 +106,7 @@
       "title": "Binary distribution contract",
       "path": "docs/binary-distribution.md",
       "plane": "verify",
-      "digest": "sha256:36899140a9b2e9ce1565ed41f3d64f73a8829fad3d59a04b9498d9479c85c4be",
+      "digest": "sha256:08be4e97e1940a45a2c0aa2506012255888c23c1cbf8f5362b27c2b21089eb58",
       "capabilityGroup": "release-passport-trust",
       "audience": [
         "release-operator",
@@ -217,7 +217,7 @@
       "title": "CLI and npm package",
       "path": "docs/cli.md",
       "plane": "use",
-      "digest": "sha256:133a7921163fecda050d772827bd498f35f11b1a3514e303dbfe89bb7a220f5d",
+      "digest": "sha256:3b3ac97c353f7549229f1102cca38236e734ec8d08c219d4a6e5ef2a48fc0e16",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "agent",
@@ -245,7 +245,7 @@
       "title": "KFD support and KFD-3 surface registration",
       "path": "docs/kfd-support.md",
       "plane": "verify",
-      "digest": "sha256:456eef9dbb71df3842613083054942436e763c6aa5ca3ff8a51c5a4e8cc186e7",
+      "digest": "sha256:ab15de33a1a9e292b6da74c00b8b96b7c46330d0553a454d1de4c24c672fc025",
       "capabilityGroup": "kfd-trust",
       "audience": [
         "agent",
@@ -259,7 +259,7 @@
       "title": "Lifecycle protocol",
       "path": "docs/lifecycle-protocol.md",
       "plane": "use",
-      "digest": "sha256:60c39693878258d275e9d47983b306faed35d6416297c14570429de73284604c",
+      "digest": "sha256:bef6f703a76667c731dccea6a0385b2196b5a23438ce4bc39894561530975f21",
       "capabilityGroup": "reusable-build",
       "audience": [
         "consumer",
@@ -273,7 +273,7 @@
       "title": "Reusable build surface",
       "path": "docs/reusable-build-surface.md",
       "plane": "use",
-      "digest": "sha256:dfa37928517a391c2ab214a095954dcb50e84f514cea0a8424619903843d9b8d",
+      "digest": "sha256:fbc74dee3a6f2283ea69a2a9a31945ac82ccaf1d270995539f5d80235ab74614",
       "capabilityGroup": "reusable-build",
       "audience": [
         "consumer",
@@ -300,7 +300,7 @@
       "title": "Release governance",
       "path": "docs/release-governance.md",
       "plane": "why",
-      "digest": "sha256:11f0e3ff3162c7b3f886a38ab0e4b591886e2046937a9d006eda74b72a8cc9ab",
+      "digest": "sha256:3ae2bbc2df394726f350e58be1a71dd0379b99b19cd6ccf15fbe3b843f3890b6",
       "capabilityGroup": "governance-versioning",
       "audience": [
         "maintainer",
@@ -373,6 +373,7 @@
     "docs/kfd-support.md",
     "docs/reusable-build-surface.md",
     "docs/release-candidate.md",
+    "docs/stable-candidate-patrol.md",
     "docs/release-governance.md",
     "docs/release-passport.md",
     "docs/publish-transaction.md",

package/dist/site/node-api-registry.json

@@ -8,7 +8,7 @@
       "specifier": "@kungfu-tech/buildchain",
       "export": ".",
       "target": "./packages/core/index.js",
-      "digest": "sha256:13bd32ce8c34c353233c54b8989844a19621fedfd4e189af1d66dc8c97c31a55",
+      "digest": "sha256:b07f54900a72f05a8545d1325951ba5a373e43cc0bdddb628c75cf39d7c7223c",
       "summary": "Root toolkit export for Buildchain's public Node API.",
       "capabilityGroup": "api-cli-reference",
       "audience": [
@@ -47,7 +47,7 @@
       "specifier": "@kungfu-tech/buildchain/core",
       "export": "./core",
       "target": "./packages/core/index.js",
-      "digest": "sha256:13bd32ce8c34c353233c54b8989844a19621fedfd4e189af1d66dc8c97c31a55",
+      "digest": "sha256:b07f54900a72f05a8545d1325951ba5a373e43cc0bdddb628c75cf39d7c7223c",
       "summary": "Alias for the root public toolkit export.",
       "capabilityGroup": "api-cli-reference",
       "audience": [
@@ -138,8 +138,8 @@
       "specifier": "@kungfu-tech/buildchain/buildchain-layout",
       "export": "./buildchain-layout",
       "target": "./packages/core/buildchain-layout.js",
-      "digest": "sha256:f4f24cd2da379d79939127ad937dab43cb8ed4d8e79058e58add0b45912ee817",
-      "summary": "Canonical .buildchain repository layout constants, path resolution, and migration APIs.",
+      "digest": "sha256:84c0b784ff993f442b0499fce39bfc116f4a19570ed7ffd7231ec7e2191c86f8",
+      "summary": "Versioned Buildchain repository-layout discovery contract plus canonical .buildchain path resolution and migration APIs.",
       "capabilityGroup": "kfd-trust",
       "audience": [
         "developer",
@@ -251,6 +251,19 @@
       ],
       "maturity": "stable"
     },
+    {
+      "specifier": "@kungfu-tech/buildchain/stable-candidate-ledger",
+      "export": "./stable-candidate-ledger",
+      "target": "./packages/core/stable-candidate-ledger.js",
+      "digest": "sha256:cefb5d1747e6e0e11490350e6b49877fe69982117a027b7c5b28e08d7afee374",
+      "summary": "Immutable alpha candidate ledger, qualification, revocation, selection, and exact stable source-lock APIs.",
+      "capabilityGroup": "governance-versioning",
+      "audience": [
+        "developer",
+        "agent"
+      ],
+      "maturity": "stable"
+    },
     {
       "specifier": "@kungfu-tech/buildchain/release-passport",
       "export": "./release-passport",
@@ -294,7 +307,7 @@
       "specifier": "@kungfu-tech/buildchain/buildchain-kfd-claims",
       "export": "./buildchain-kfd-claims",
       "target": "./packages/core/buildchain-kfd-claims.js",
-      "digest": "sha256:139a2318ff627819fe5553f0572fe754ce296d5fa974a7337c32c811feb02b14",
+      "digest": "sha256:3a13ebd81e23433a3546d553eb55149bbe53ea2158e73b37adb6787661ac1045",
       "summary": "Buildchain self KFD claim registry, witnesses, and public claim APIs.",
       "capabilityGroup": "kfd-trust",
       "audience": [
@@ -308,7 +321,7 @@
     {
       "id": "cli-and-node-package",
       "path": "docs/cli.md",
-      "digest": "sha256:133a7921163fecda050d772827bd498f35f11b1a3514e303dbfe89bb7a220f5d"
+      "digest": "sha256:3b3ac97c353f7549229f1102cca38236e734ec8d08c219d4a6e5ef2a48fc0e16"
     },
     {
       "id": "build-facts",
@@ -318,7 +331,7 @@
     {
       "id": "kfd-support",
       "path": "docs/kfd-support.md",
-      "digest": "sha256:456eef9dbb71df3842613083054942436e763c6aa5ca3ff8a51c5a4e8cc186e7"
+      "digest": "sha256:ab15de33a1a9e292b6da74c00b8b96b7c46330d0553a454d1de4c24c672fc025"
     },
     {
       "id": "readme-badges",