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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -8123,8 +8123,8 @@
8123
8123
  "workflowRegistryPath": "dist/site/workflow-registry.json",
8124
8124
  "pageRegistryPath": "dist/site/page-registry.json",
8125
8125
  "cliRegistryDigest": "2db0002dc06d97c6ab975f3ba395d23a0c6d7fe2796ded9852a7a127e52637cd",
8126
- "workflowRegistryDigest": "c088fe6df30d1c4c1b1bf3d3d483074814dfd68811c0d8c9cac2ae0cc37e2bf0",
8127
- "pageRegistryDigest": "7ae6094713bb4f601df84367c0e681fae2df68681ffa299c0e634626b44e5245"
8126
+ "workflowRegistryDigest": "14fa5b4a29f03f337f1502bd852771d72a1c7af25684ef23c3b5be990f748acf",
8127
+ "pageRegistryDigest": "f8cbbdc8e411ef8c753107476adebf7d6e69b83089c7a7e814cbe47c5b7f0a95"
8128
8128
  },
8129
8129
  "comparison": {
8130
8130
  "missingCliRegistry": [],
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "contract": "kungfu-buildchain-publication-release-registry",
4
- "generatedAt": "2026-08-11T19:43:47.000Z",
5
- "publishedAt": "2026-08-11T19:43:47.000Z",
4
+ "generatedAt": "2026-08-12T01:33:49.000Z",
5
+ "publishedAt": "2026-08-12T01:33:49.000Z",
6
6
  "reproducible": true,
7
7
  "timestampPolicy": "ci-injected",
8
8
  "deterministicInputs": [
@@ -19,7 +19,7 @@
19
19
  "declared Buildchain surface manifest contract"
20
20
  ],
21
21
  "sourceDateEpoch": "0",
22
- "sourceRevision": "c05d3c359fc356f8ab5dfbeffa35a2059e254c46",
22
+ "sourceRevision": "1080aeadc49281f991bde9a0b53dc399242702ff",
23
23
  "timestampPolicyDetails": {
24
24
  "contract": "kungfu-buildchain-surface-timestamp-policy",
25
25
  "timestampFields": [
@@ -32,7 +32,7 @@
32
32
  },
33
33
  "package": {
34
34
  "name": "@kungfu-tech/buildchain",
35
- "version": "3.0.9-alpha.6",
35
+ "version": "3.0.9-alpha.7",
36
36
  "versionSource": "package.json#version"
37
37
  },
38
38
  "sourceKind": "package-site-bundle",
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "contract": "kungfu-buildchain-site-manifest",
4
- "generatedAt": "2026-08-11T19:43:47.000Z",
5
- "publishedAt": "2026-08-11T19:43:47.000Z",
4
+ "generatedAt": "2026-08-12T01:33:49.000Z",
5
+ "publishedAt": "2026-08-12T01:33:49.000Z",
6
6
  "reproducible": true,
7
7
  "timestampPolicy": "ci-injected",
8
8
  "deterministicInputs": [
@@ -19,7 +19,7 @@
19
19
  "declared Buildchain surface manifest contract"
20
20
  ],
21
21
  "sourceDateEpoch": "0",
22
- "sourceRevision": "c05d3c359fc356f8ab5dfbeffa35a2059e254c46",
22
+ "sourceRevision": "1080aeadc49281f991bde9a0b53dc399242702ff",
23
23
  "timestampPolicyDetails": {
24
24
  "contract": "kungfu-buildchain-surface-timestamp-policy",
25
25
  "timestampFields": [
@@ -37,7 +37,7 @@
37
37
  },
38
38
  "package": {
39
39
  "name": "@kungfu-tech/buildchain",
40
- "version": "3.0.9-alpha.6",
40
+ "version": "3.0.9-alpha.7",
41
41
  "versionSource": "package.json#version"
42
42
  },
43
43
  "entrypoint": "buildchain-site.json",
@@ -253,7 +253,7 @@
253
253
  "path": "docs/node-api-reference.md",
254
254
  "plane": "use",
255
255
  "exists": true,
256
- "digest": "sha256:4663cf32a0116a8605e7b8a475fc4b38e02b81ca21af59e49be0043f3eb99a02"
256
+ "digest": "sha256:37102c168f1eb23f2e9d5a86a4e2df366a755ef102626088232c8599d9cdf91e"
257
257
  },
258
258
  {
259
259
  "id": "build-facts",
@@ -1967,7 +1967,7 @@
1967
1967
  "status": "preview",
1968
1968
  "owner": "buildchain-workflows",
1969
1969
  "maturity": "preview",
1970
- "introducedVersion": "3.0.9-alpha.6",
1970
+ "introducedVersion": "3.0.9-alpha.7",
1971
1971
  "compatibilityPromise": "preserved-through-the-v3-major-line",
1972
1972
  "deprecationReplacement": "",
1973
1973
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -1988,7 +1988,7 @@
1988
1988
  "status": "preview",
1989
1989
  "owner": "buildchain-workflows",
1990
1990
  "maturity": "preview",
1991
- "introducedVersion": "3.0.9-alpha.6",
1991
+ "introducedVersion": "3.0.9-alpha.7",
1992
1992
  "compatibilityPromise": "preserved-through-the-v3-major-line",
1993
1993
  "deprecationReplacement": "",
1994
1994
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -2009,7 +2009,7 @@
2009
2009
  "status": "preview",
2010
2010
  "owner": "buildchain-workflows",
2011
2011
  "maturity": "preview",
2012
- "introducedVersion": "3.0.9-alpha.6",
2012
+ "introducedVersion": "3.0.9-alpha.7",
2013
2013
  "compatibilityPromise": "preserved-through-the-v3-major-line",
2014
2014
  "deprecationReplacement": "",
2015
2015
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -2059,7 +2059,7 @@
2059
2059
  "status": "preview",
2060
2060
  "owner": "buildchain-workflows",
2061
2061
  "maturity": "preview",
2062
- "introducedVersion": "3.0.9-alpha.6",
2062
+ "introducedVersion": "3.0.9-alpha.7",
2063
2063
  "compatibilityPromise": "preserved-through-the-v3-major-line",
2064
2064
  "deprecationReplacement": "",
2065
2065
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -343,6 +343,11 @@ JIT SecureString under `/kungfu/burst/macos/`, then runs GitHub Actions Runner
343
343
  2.336.0 for exactly one job. The runner archive is pinned to the official
344
344
  macOS ARM64 SHA256. No GitHub, signing, notarization, publication, SSH, or
345
345
  static AWS credential is admitted to the instance.
346
+ The provider provenance step explicitly disables artifact-signing request
347
+ sealing for these qualification jobs, so consumer signing declarations cannot
348
+ turn a runner-profile smoke or full qualification into a signing-authority
349
+ dispatch. All other Buildchain lanes retain the default fail-closed signing
350
+ declaration behavior.
346
351
 
347
352
  The instance uses the exact retained Amazon EC2 macOS AMI, IMDSv2, an encrypted
348
353
  delete-on-termination root volume, no inbound security-group rule, and the
@@ -164,7 +164,7 @@ Target: `./packages/core/index.js`. Public symbols: 608.
164
164
  | `computeConsumerIssueFingerprint` | function: function computeConsumerIssueFingerprint(fields = {}) | fields = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { computeConsumerIssueFingerprint } from "@kungfu-tech/buildchain";` | `packages/core/issue-reporting.js:64` |
165
165
  | `CONSUMER_PUBLICATION_DECISION_CONTRACT` | constant: const CONSUMER_PUBLICATION_DECISION_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { CONSUMER_PUBLICATION_DECISION_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/publication-authority.js:20` |
166
166
  | `consumerIssueMarker` | function: function consumerIssueMarker(fingerprint) | fingerprint | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { consumerIssueMarker } from "@kungfu-tech/buildchain";` | `packages/core/issue-reporting.js:76` |
167
- | `contractSummary` | function: function contractSummary(contractWorld, runtimeRef = "", runtimeSha = "") | contractWorld, runtimeRef = "", runtimeSha = "" | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { contractSummary } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-compatibility-proof.js:360` |
167
+ | `contractSummary` | function: function contractSummary(contractWorld, runtimeRef = "", runtimeSha = "") | contractWorld, runtimeRef = "", runtimeSha = "" | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { contractSummary } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-compatibility-proof.js:382` |
168
168
  | `controllerEvidenceDigest` | function: function controllerEvidenceDigest(value) | value | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { controllerEvidenceDigest } from "@kungfu-tech/buildchain";` | `packages/core/controller-evidence.js:152` |
169
169
  | `createActivationReceiptProjectorAdapter` | function: function createActivationReceiptProjectorAdapter(options = {}) | options = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createActivationReceiptProjectorAdapter } from "@kungfu-tech/buildchain";` | `packages/core/release-tail-provider-adapters.js:181` |
170
170
  | `createAnchoredVersionMaterialEvidence` | function: function createAnchoredVersionMaterialEvidence({ cwd = process.cwd(), targetChannel = "", targetRef = "", alphaRef = "", releaseRef = "HEAD", runLifecycle = true, } = {}) | { cwd = process.cwd(), targetChannel = "", targetRef = "", alphaRef = "", releaseRef = "HEAD", runLifecycle = true, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createAnchoredVersionMaterialEvidence } from "@kungfu-tech/buildchain";` | `packages/core/anchored-version-material.js:118` |
@@ -280,7 +280,7 @@ Target: `./packages/core/index.js`. Public symbols: 608.
280
280
  | `enumerateDocCommandRefs` | function: function enumerateDocCommandRefs({ root = process.cwd() } = {}) | { root = process.cwd() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { enumerateDocCommandRefs } from "@kungfu-tech/buildchain";` | `packages/core/public-surface-audit.js:115` |
281
281
  | `enumerateSitePages` | function: function enumerateSitePages({ root = process.cwd() } = {}) | { root = process.cwd() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { enumerateSitePages } from "@kungfu-tech/buildchain";` | `packages/core/public-surface-audit.js:106` |
282
282
  | `enumerateWorkflowInputs` | function: function enumerateWorkflowInputs({ root = process.cwd() } = {}) | { root = process.cwd() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { enumerateWorkflowInputs } from "@kungfu-tech/buildchain";` | `packages/core/public-surface-audit.js:74` |
283
- | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { evaluateBuildchainContractLock } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-compatibility-proof.js:454` |
283
+ | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { evaluateBuildchainContractLock } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-compatibility-proof.js:476` |
284
284
  | `evaluateCodeownersAuthority` | function: function evaluateCodeownersAuthority({ source = "", sourcePath = "", reviewAuthority = "kungfu-origin", protectedPaths = PROTECTED_AUTHORITY_PATHS, } = {}) | { source = "", sourcePath = "", reviewAuthority = "kungfu-origin", protectedPaths = PROTECTED_AUTHORITY_PATHS, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { evaluateCodeownersAuthority } from "@kungfu-tech/buildchain";` | `packages/core/github-governance-authority.js:425` |
285
285
  | `evaluateGithubGovernanceSnapshot` | function: function evaluateGithubGovernanceSnapshot({ descriptor = createBuildchainGithubGovernanceAuthority(), repository, targetRef, organizationPlan, codeowners, effectivePolicy, memberships, apiEvidence = {}, observedAt, expiresAt, verifier = {}, } = {}) | { descriptor = createBuildchainGithubGovernanceAuthority(), repository, targetRef, organizationPlan, codeowners, effectivePolicy, memberships, apiEvidence = {}, observedAt, expiresAt, verifier = {}, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { evaluateGithubGovernanceSnapshot } from "@kungfu-tech/buildchain";` | `packages/core/github-governance-authority.js:694` |
286
286
  | `evaluateKfdProductGate` | function: async function evaluateKfdProductGate({ cwd = process.cwd(), input, expectedSourceSha = "", checkedAt = new Date().toISOString(), } = {}) | { cwd = process.cwd(), input, expectedSourceSha = "", checkedAt = new Date().toISOString(), } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { evaluateKfdProductGate } from "@kungfu-tech/buildchain";` | `packages/core/kfd-product-gates.js:419` |
@@ -519,7 +519,7 @@ Target: `./packages/core/index.js`. Public symbols: 608.
519
519
  | `releaseTailRoot` | function: function releaseTailRoot(value) | value | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { releaseTailRoot } from "@kungfu-tech/buildchain";` | `packages/core/release-tail-provider-plane.js:164` |
520
520
  | `releaseTailStableJson` | function: function releaseTailStableJson(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { releaseTailStableJson } from "@kungfu-tech/buildchain";` | `packages/core/release-tail-provider-plane.js:149` |
521
521
  | `renderBadgeBundleBlock` | function: function renderBadgeBundleBlock(facts) | facts | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { renderBadgeBundleBlock } from "@kungfu-tech/buildchain";` | `packages/core/readme-badges.js:840` |
522
- | `renderBuildchainContractDriftIssueBody` | function: function renderBuildchainContractDriftIssueBody({ repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {}) | { repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { renderBuildchainContractDriftIssueBody } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-compatibility-proof.js:592` |
522
+ | `renderBuildchainContractDriftIssueBody` | function: function renderBuildchainContractDriftIssueBody({ repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {}) | { repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { renderBuildchainContractDriftIssueBody } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-compatibility-proof.js:614` |
523
523
  | `renderHomebrewFormula` | function: function renderHomebrewFormula(facts) | facts | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { renderHomebrewFormula } from "@kungfu-tech/buildchain";` | `packages/core/homebrew.js:290` |
524
524
  | `renderKfd2ProductClaimOutputs` | function: function renderKfd2ProductClaimOutputs({ cwd = process.cwd(), registryPath = BUILDCHAIN_KFD2_REGISTRY_PATH, outputDir = BUILDCHAIN_KFD2_DIR, version = "", channel = "", tag = "", sourceSha = "", } = {}) | { cwd = process.cwd(), registryPath = BUILDCHAIN_KFD2_REGISTRY_PATH, outputDir = BUILDCHAIN_KFD2_DIR, version = "", channel = "", tag = "", sourceSha = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { renderKfd2ProductClaimOutputs } from "@kungfu-tech/buildchain";` | `packages/core/kfd2-product-claims.js:321` |
525
525
  | `renderReadmeBadgeBlock` | function: function renderReadmeBadgeBlock(facts) | facts | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { renderReadmeBadgeBlock } from "@kungfu-tech/buildchain";` | `packages/core/readme-badges.js:836` |
@@ -825,7 +825,7 @@ Target: `./packages/core/index.js`. Public symbols: 608.
825
825
  | `computeConsumerIssueFingerprint` | function: function computeConsumerIssueFingerprint(fields = {}) | fields = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { computeConsumerIssueFingerprint } from "@kungfu-tech/buildchain/core";` | `packages/core/issue-reporting.js:64` |
826
826
  | `CONSUMER_PUBLICATION_DECISION_CONTRACT` | constant: const CONSUMER_PUBLICATION_DECISION_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { CONSUMER_PUBLICATION_DECISION_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/publication-authority.js:20` |
827
827
  | `consumerIssueMarker` | function: function consumerIssueMarker(fingerprint) | fingerprint | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { consumerIssueMarker } from "@kungfu-tech/buildchain/core";` | `packages/core/issue-reporting.js:76` |
828
- | `contractSummary` | function: function contractSummary(contractWorld, runtimeRef = "", runtimeSha = "") | contractWorld, runtimeRef = "", runtimeSha = "" | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { contractSummary } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-compatibility-proof.js:360` |
828
+ | `contractSummary` | function: function contractSummary(contractWorld, runtimeRef = "", runtimeSha = "") | contractWorld, runtimeRef = "", runtimeSha = "" | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { contractSummary } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-compatibility-proof.js:382` |
829
829
  | `controllerEvidenceDigest` | function: function controllerEvidenceDigest(value) | value | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { controllerEvidenceDigest } from "@kungfu-tech/buildchain/core";` | `packages/core/controller-evidence.js:152` |
830
830
  | `createActivationReceiptProjectorAdapter` | function: function createActivationReceiptProjectorAdapter(options = {}) | options = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createActivationReceiptProjectorAdapter } from "@kungfu-tech/buildchain/core";` | `packages/core/release-tail-provider-adapters.js:181` |
831
831
  | `createAnchoredVersionMaterialEvidence` | function: function createAnchoredVersionMaterialEvidence({ cwd = process.cwd(), targetChannel = "", targetRef = "", alphaRef = "", releaseRef = "HEAD", runLifecycle = true, } = {}) | { cwd = process.cwd(), targetChannel = "", targetRef = "", alphaRef = "", releaseRef = "HEAD", runLifecycle = true, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createAnchoredVersionMaterialEvidence } from "@kungfu-tech/buildchain/core";` | `packages/core/anchored-version-material.js:118` |
@@ -941,7 +941,7 @@ Target: `./packages/core/index.js`. Public symbols: 608.
941
941
  | `enumerateDocCommandRefs` | function: function enumerateDocCommandRefs({ root = process.cwd() } = {}) | { root = process.cwd() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { enumerateDocCommandRefs } from "@kungfu-tech/buildchain/core";` | `packages/core/public-surface-audit.js:115` |
942
942
  | `enumerateSitePages` | function: function enumerateSitePages({ root = process.cwd() } = {}) | { root = process.cwd() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { enumerateSitePages } from "@kungfu-tech/buildchain/core";` | `packages/core/public-surface-audit.js:106` |
943
943
  | `enumerateWorkflowInputs` | function: function enumerateWorkflowInputs({ root = process.cwd() } = {}) | { root = process.cwd() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { enumerateWorkflowInputs } from "@kungfu-tech/buildchain/core";` | `packages/core/public-surface-audit.js:74` |
944
- | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { evaluateBuildchainContractLock } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-compatibility-proof.js:454` |
944
+ | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { evaluateBuildchainContractLock } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-compatibility-proof.js:476` |
945
945
  | `evaluateCodeownersAuthority` | function: function evaluateCodeownersAuthority({ source = "", sourcePath = "", reviewAuthority = "kungfu-origin", protectedPaths = PROTECTED_AUTHORITY_PATHS, } = {}) | { source = "", sourcePath = "", reviewAuthority = "kungfu-origin", protectedPaths = PROTECTED_AUTHORITY_PATHS, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { evaluateCodeownersAuthority } from "@kungfu-tech/buildchain/core";` | `packages/core/github-governance-authority.js:425` |
946
946
  | `evaluateGithubGovernanceSnapshot` | function: function evaluateGithubGovernanceSnapshot({ descriptor = createBuildchainGithubGovernanceAuthority(), repository, targetRef, organizationPlan, codeowners, effectivePolicy, memberships, apiEvidence = {}, observedAt, expiresAt, verifier = {}, } = {}) | { descriptor = createBuildchainGithubGovernanceAuthority(), repository, targetRef, organizationPlan, codeowners, effectivePolicy, memberships, apiEvidence = {}, observedAt, expiresAt, verifier = {}, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { evaluateGithubGovernanceSnapshot } from "@kungfu-tech/buildchain/core";` | `packages/core/github-governance-authority.js:694` |
947
947
  | `evaluateKfdProductGate` | function: async function evaluateKfdProductGate({ cwd = process.cwd(), input, expectedSourceSha = "", checkedAt = new Date().toISOString(), } = {}) | { cwd = process.cwd(), input, expectedSourceSha = "", checkedAt = new Date().toISOString(), } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { evaluateKfdProductGate } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd-product-gates.js:419` |
@@ -1180,7 +1180,7 @@ Target: `./packages/core/index.js`. Public symbols: 608.
1180
1180
  | `releaseTailRoot` | function: function releaseTailRoot(value) | value | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { releaseTailRoot } from "@kungfu-tech/buildchain/core";` | `packages/core/release-tail-provider-plane.js:164` |
1181
1181
  | `releaseTailStableJson` | function: function releaseTailStableJson(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { releaseTailStableJson } from "@kungfu-tech/buildchain/core";` | `packages/core/release-tail-provider-plane.js:149` |
1182
1182
  | `renderBadgeBundleBlock` | function: function renderBadgeBundleBlock(facts) | facts | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { renderBadgeBundleBlock } from "@kungfu-tech/buildchain/core";` | `packages/core/readme-badges.js:840` |
1183
- | `renderBuildchainContractDriftIssueBody` | function: function renderBuildchainContractDriftIssueBody({ repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {}) | { repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { renderBuildchainContractDriftIssueBody } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-compatibility-proof.js:592` |
1183
+ | `renderBuildchainContractDriftIssueBody` | function: function renderBuildchainContractDriftIssueBody({ repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {}) | { repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { renderBuildchainContractDriftIssueBody } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-compatibility-proof.js:614` |
1184
1184
  | `renderHomebrewFormula` | function: function renderHomebrewFormula(facts) | facts | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { renderHomebrewFormula } from "@kungfu-tech/buildchain/core";` | `packages/core/homebrew.js:290` |
1185
1185
  | `renderKfd2ProductClaimOutputs` | function: function renderKfd2ProductClaimOutputs({ cwd = process.cwd(), registryPath = BUILDCHAIN_KFD2_REGISTRY_PATH, outputDir = BUILDCHAIN_KFD2_DIR, version = "", channel = "", tag = "", sourceSha = "", } = {}) | { cwd = process.cwd(), registryPath = BUILDCHAIN_KFD2_REGISTRY_PATH, outputDir = BUILDCHAIN_KFD2_DIR, version = "", channel = "", tag = "", sourceSha = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { renderKfd2ProductClaimOutputs } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd2-product-claims.js:321` |
1186
1186
  | `renderReadmeBadgeBlock` | function: function renderReadmeBadgeBlock(facts) | facts | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { renderReadmeBadgeBlock } from "@kungfu-tech/buildchain/core";` | `packages/core/readme-badges.js:836` |
@@ -1412,32 +1412,32 @@ Target: `./packages/core/buildchain-contract.js`. Public symbols: 26.
1412
1412
 
1413
1413
  | Symbol | Kind and signature | Parameters | Return | Errors | Side effects | Example | Source |
1414
1414
  | --- | --- | --- | --- | --- | --- | --- | --- |
1415
- | `assertBuildchainCompatibilityProjection` | function: function assertBuildchainCompatibilityProjection(contractWorld) | contractWorld | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { assertBuildchainCompatibilityProjection } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:277` |
1415
+ | `assertBuildchainCompatibilityProjection` | function: function assertBuildchainCompatibilityProjection(contractWorld) | contractWorld | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { assertBuildchainCompatibilityProjection } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:299` |
1416
1416
  | `BUILDCHAIN_CHANNELS` | constant: const BUILDCHAIN_CHANNELS | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CHANNELS } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-channel-identity.js:8` |
1417
1417
  | `BUILDCHAIN_COMPATIBILITY_PROOF_REGISTRY_SCHEMA` | constant: const BUILDCHAIN_COMPATIBILITY_PROOF_REGISTRY_SCHEMA | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_COMPATIBILITY_PROOF_REGISTRY_SCHEMA } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:13` |
1418
1418
  | `BUILDCHAIN_COMPATIBILITY_PROOF_SCHEMA` | constant: const BUILDCHAIN_COMPATIBILITY_PROOF_SCHEMA | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_COMPATIBILITY_PROOF_SCHEMA } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:12` |
1419
1419
  | `BUILDCHAIN_COMPATIBILITY_VERIFICATION_RECEIPT_SCHEMA` | constant: const BUILDCHAIN_COMPATIBILITY_VERIFICATION_RECEIPT_SCHEMA | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_COMPATIBILITY_VERIFICATION_RECEIPT_SCHEMA } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:14` |
1420
1420
  | `BUILDCHAIN_CONTRACT_LOCK` | constant: const BUILDCHAIN_CONTRACT_LOCK | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONTRACT_LOCK } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-contract.js:36` |
1421
1421
  | `BUILDCHAIN_RUNTIME_CONTRACT_WORLD` | constant: const BUILDCHAIN_RUNTIME_CONTRACT_WORLD | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_RUNTIME_CONTRACT_WORLD } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-contract.js:35` |
1422
- | `contractSummary` | function: function contractSummary(contractWorld, runtimeRef = "", runtimeSha = "") | contractWorld, runtimeRef = "", runtimeSha = "" | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { contractSummary } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:360` |
1423
- | `createBuildchainCompatibilityProof` | function: function createBuildchainCompatibilityProof(input = {}) | input = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createBuildchainCompatibilityProof } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:158` |
1424
- | `createBuildchainCompatibilityProofRegistry` | function: function createBuildchainCompatibilityProofRegistry({ proofs = createHistoricalBuildchainCompatibilityProofs(), surfaces = [], majorLine = "" } = {}) | { proofs = createHistoricalBuildchainCompatibilityProofs(), surfaces = [], majorLine = "" } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createBuildchainCompatibilityProofRegistry } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:253` |
1425
- | `createBuildchainCompatibilityVerificationReceipt` | function: function createBuildchainCompatibilityVerificationReceipt(input = {}) | input = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createBuildchainCompatibilityVerificationReceipt } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:323` |
1422
+ | `contractSummary` | function: function contractSummary(contractWorld, runtimeRef = "", runtimeSha = "") | contractWorld, runtimeRef = "", runtimeSha = "" | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { contractSummary } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:382` |
1423
+ | `createBuildchainCompatibilityProof` | function: function createBuildchainCompatibilityProof(input = {}) | input = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createBuildchainCompatibilityProof } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:180` |
1424
+ | `createBuildchainCompatibilityProofRegistry` | function: function createBuildchainCompatibilityProofRegistry({ proofs = createHistoricalBuildchainCompatibilityProofs(), surfaces = [], majorLine = "" } = {}) | { proofs = createHistoricalBuildchainCompatibilityProofs(), surfaces = [], majorLine = "" } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createBuildchainCompatibilityProofRegistry } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:275` |
1425
+ | `createBuildchainCompatibilityVerificationReceipt` | function: function createBuildchainCompatibilityVerificationReceipt(input = {}) | input = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createBuildchainCompatibilityVerificationReceipt } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:345` |
1426
1426
  | `createBuildchainContractLock` | function: function createBuildchainContractLock({ buildchainRef = "v3", resolvedSha = "", contractWorld, compatibilityPolicy = DEFAULT_POLICY, acceptedAt = new Date().toISOString(), } = {}) | { buildchainRef = "v3", resolvedSha = "", contractWorld, compatibilityPolicy = DEFAULT_POLICY, acceptedAt = new Date().toISOString(), } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createBuildchainContractLock } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-contract.js:846` |
1427
1427
  | `createBuildchainContractWorld` | function: function createBuildchainContractWorld({ root = process.cwd(), packageJson = undefined, controllerRegistry = undefined, } = {}) | { root = process.cwd(), packageJson = undefined, controllerRegistry = undefined, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createBuildchainContractWorld } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-contract.js:137` |
1428
- | `createHistoricalBuildchainCompatibilityProofs` | function: function createHistoricalBuildchainCompatibilityProofs() | none | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createHistoricalBuildchainCompatibilityProofs } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:230` |
1428
+ | `createHistoricalBuildchainCompatibilityProofs` | function: function createHistoricalBuildchainCompatibilityProofs() | none | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createHistoricalBuildchainCompatibilityProofs } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:252` |
1429
1429
  | `evaluateBuildchainChannelBinding` | function: function evaluateBuildchainChannelBinding({ workflowShellRef = "", runtimeRef = "", lockRef = "", lockMajorLine = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false } = {}) | { workflowShellRef = "", runtimeRef = "", lockRef = "", lockMajorLine = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { evaluateBuildchainChannelBinding } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-channel-identity.js:97` |
1430
- | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { evaluateBuildchainContractLock } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:454` |
1430
+ | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", workflowShellRef = "", expectedChannel = "", expectedMajor = "", allowOpaqueRuntime = false, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { evaluateBuildchainContractLock } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:476` |
1431
1431
  | `finalizeBuildchainContractWorld` | function: function finalizeBuildchainContractWorld(contractWorld) | contractWorld | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { finalizeBuildchainContractWorld } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-contract.js:801` |
1432
1432
  | `normalizeBuildchainRef` | function: function normalizeBuildchainRef(ref = "") | ref = "" | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { normalizeBuildchainRef } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-channel-identity.js:10` |
1433
1433
  | `parseBuildchainRefIdentity` | function: function parseBuildchainRefIdentity(ref = "") | ref = "" | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { parseBuildchainRefIdentity } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-channel-identity.js:16` |
1434
1434
  | `readBuildchainContractLock` | function: function readBuildchainContractLock(filePath) | filePath | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { readBuildchainContractLock } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-contract.js:900` |
1435
1435
  | `readBuildchainContractWorld` | function: function readBuildchainContractWorld(filePath) | filePath | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { readBuildchainContractWorld } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-contract.js:879` |
1436
- | `renderBuildchainContractDriftIssueBody` | function: function renderBuildchainContractDriftIssueBody({ repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {}) | { repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { renderBuildchainContractDriftIssueBody } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:592` |
1436
+ | `renderBuildchainContractDriftIssueBody` | function: function renderBuildchainContractDriftIssueBody({ repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {}) | { repository = "", workflow = "", runUrl = "", lockPath = "", evaluation } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { renderBuildchainContractDriftIssueBody } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:614` |
1437
1437
  | `sha256File` | function: function sha256File(filePath) | filePath | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { sha256File } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-contract.js:61` |
1438
1438
  | `sha256Json` | function: function sha256Json(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { sha256Json } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-contract.js:57` |
1439
- | `verifyBuildchainCompatibilityProof` | function: function verifyBuildchainCompatibilityProof(proofInput, expected = {}) | proofInput, expected = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyBuildchainCompatibilityProof } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:206` |
1440
- | `verifyBuildchainCompatibilityVerificationReceipt` | function: function verifyBuildchainCompatibilityVerificationReceipt(receiptInput) | receiptInput | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyBuildchainCompatibilityVerificationReceipt } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:347` |
1439
+ | `verifyBuildchainCompatibilityProof` | function: function verifyBuildchainCompatibilityProof(proofInput, expected = {}) | proofInput, expected = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyBuildchainCompatibilityProof } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:228` |
1440
+ | `verifyBuildchainCompatibilityVerificationReceipt` | function: function verifyBuildchainCompatibilityVerificationReceipt(receiptInput) | receiptInput | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyBuildchainCompatibilityVerificationReceipt } from "@kungfu-tech/buildchain/buildchain-contract";` | `packages/core/buildchain-compatibility-proof.js:369` |
1441
1441
 
1442
1442
  ## `@kungfu-tech/buildchain/candidate-timeline`
1443
1443
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kungfu-tech/buildchain",
3
- "version": "3.0.9-alpha.6",
3
+ "version": "3.0.9-alpha.7",
4
4
  "private": false,
5
5
  "description": "Buildchain Release Passport, release governance, CLI toolkit, and site facts.",
6
6
  "repository": "https://github.com/kungfu-systems/buildchain",
@@ -110,6 +110,28 @@ const HISTORICAL_ACCEPTANCES = [
110
110
  compatibilityDigest: "sha256:32a651504c57829085dc8863f0e41dee98eb60708ff6dec958c9c7e4b1010102",
111
111
  },
112
112
  },
113
+ {
114
+ proofId: "build-channel-router-d40dd0-to-30549a",
115
+ surfaceId: "controller:build-channel-router",
116
+ surfaceKind: "controller",
117
+ sourceBreakingDigest: "sha256:d40dd05d7e07473d4b2dc1b62fbb0ed6f06449b4d3a7c44a2e8014313e3c0273",
118
+ targetBreakingDigest: "sha256:30549aa26cd1e1dd81f10fe3529d3c6e3f8438a6efa0100c47ebae4d2f3d71df",
119
+ evidence: {
120
+ kind: "protected-pull-request-contract-acceptance",
121
+ pullRequest: "https://github.com/kungfu-systems/buildchain/pull/2549",
122
+ protectedBase: "dev/v3/v3.0",
123
+ sourceCommit: "0d87b772265066f5e6157e1ba6a2ba1021fb5225",
124
+ mergeCommit: "34fad9d3a94c450d75c0d06fd6ed00470c992ff7",
125
+ contractDigest: "sha256:2584ba36ab54cd5e9bab9e34dfc08d87a55dc57de1be7641492bf7ceb1366350",
126
+ compatibilityDigest: "sha256:80f65cc191b1f771475184edf8a1bf9c10dd69bb58060aa09313d0e1e57f508a",
127
+ },
128
+ cut: {
129
+ kind: "protected-git-cut",
130
+ repository: "kungfu-systems/buildchain",
131
+ protectedBase: "dev/v3/v3.0",
132
+ commit: "34fad9d3a94c450d75c0d06fd6ed00470c992ff7",
133
+ },
134
+ },
113
135
  ];
114
136
 
115
137
  function exactText(value, label) {
@@ -101,6 +101,20 @@ function preflightFailureRunIds(value) {
101
101
  return [...normalized].sort((left, right) => Number(left) - Number(right));
102
102
  }
103
103
 
104
+ function successfulRunIds(value) {
105
+ if (value === undefined) return [];
106
+ if (!Array.isArray(value)) {
107
+ throw new Error("successfulRunIds must be an array");
108
+ }
109
+ const normalized = value.map((entry) =>
110
+ exact(entry, /^[1-9]\d*$/, "successfulRunId"),
111
+ );
112
+ if (new Set(normalized).size !== normalized.length) {
113
+ throw new Error("successfulRunIds must be unique");
114
+ }
115
+ return [...normalized].sort((left, right) => Number(left) - Number(right));
116
+ }
117
+
104
118
  function startupFailureRuns(value) {
105
119
  if (value === undefined) return [];
106
120
  if (!Array.isArray(value)) {
@@ -139,6 +153,25 @@ function historicalTerminalFailureRuns(value) {
139
153
  );
140
154
  }
141
155
 
156
+ function historicalPreflightFailureRuns(value) {
157
+ if (value === undefined) return [];
158
+ if (!Array.isArray(value)) {
159
+ throw new Error("historicalPreflightFailureRuns must be an array");
160
+ }
161
+ const normalized = value.map((entry) => ({
162
+ runId: exact(entry?.runId, /^[1-9]\d*$/, "historicalPreflightFailureRunId"),
163
+ sourceSha: exactSha(entry?.sourceSha),
164
+ }));
165
+ if (
166
+ new Set(normalized.map(({ runId }) => runId)).size !== normalized.length
167
+ ) {
168
+ throw new Error("historicalPreflightFailureRuns must use unique run ids");
169
+ }
170
+ return [...normalized].sort(
171
+ (left, right) => Number(left.runId) - Number(right.runId),
172
+ );
173
+ }
174
+
142
175
  function commonAws(values) {
143
176
  const region = exact(
144
177
  values.region || MACOS_EC2_JIT.region,
@@ -386,6 +419,10 @@ export function createMacosJitSourceRebindPlan(values = {}) {
386
419
  const historicalTerminalRuns = historicalTerminalFailureRuns(
387
420
  values.historicalTerminalFailureRuns,
388
421
  );
422
+ const historicalPreflightRuns = historicalPreflightFailureRuns(
423
+ values.historicalPreflightFailureRuns,
424
+ );
425
+ const successfulRuns = successfulRunIds(values.successfulRunIds);
389
426
  if (priorRunPolicy === "unused" && startupRuns.length !== 0) {
390
427
  throw new Error("startupFailureRuns require a failed priorRunPolicy");
391
428
  }
@@ -394,6 +431,14 @@ export function createMacosJitSourceRebindPlan(values = {}) {
394
431
  "historicalTerminalFailureRuns require a failed priorRunPolicy",
395
432
  );
396
433
  }
434
+ if (priorRunPolicy === "unused" && historicalPreflightRuns.length !== 0) {
435
+ throw new Error(
436
+ "historicalPreflightFailureRuns require a failed priorRunPolicy",
437
+ );
438
+ }
439
+ if (priorRunPolicy === "unused" && successfulRuns.length !== 0) {
440
+ throw new Error("successfulRunIds require a failed priorRunPolicy");
441
+ }
397
442
  const plan = {
398
443
  schemaVersion: 1,
399
444
  contract: AWS_MACOS_JIT_CONTROLLER_CONTRACT,
@@ -413,6 +458,8 @@ export function createMacosJitSourceRebindPlan(values = {}) {
413
458
  preflightFailureRunIds: preflightRunIds,
414
459
  startupFailureRuns: startupRuns,
415
460
  historicalTerminalFailureRuns: historicalTerminalRuns,
461
+ historicalPreflightFailureRuns: historicalPreflightRuns,
462
+ successfulRunIds: successfulRuns,
416
463
  },
417
464
  aws: {
418
465
  ...aws,
@@ -433,6 +480,9 @@ export function createMacosJitSourceRebindPlan(values = {}) {
433
480
  startupFailureEvidencePreserved: startupRuns.length !== 0,
434
481
  historicalTerminalFailureEvidencePreserved:
435
482
  historicalTerminalRuns.length !== 0,
483
+ historicalPreflightFailureEvidencePreserved:
484
+ historicalPreflightRuns.length !== 0,
485
+ successfulRunEvidencePreserved: successfulRuns.length !== 0,
436
486
  zeroJitResidueRequired: true,
437
487
  zeroEvidenceRequired: true,
438
488
  exactCampaignResourcesRequired: true,
@@ -508,6 +508,20 @@ function commonValues(execute) {
508
508
  };
509
509
  }
510
510
 
511
+ function confirmHistoricalPreflightFailures(plan) {
512
+ const confirmed = flag("confirm-historical-preflight-failure-runs-json")
513
+ ? jsonArrayArg("confirm-historical-preflight-failure-runs-json")
514
+ : [];
515
+ if (
516
+ JSON.stringify(confirmed) !==
517
+ JSON.stringify(plan.github.historicalPreflightFailureRuns)
518
+ ) {
519
+ throw new Error(
520
+ "--confirm-historical-preflight-failure-runs-json must equal the exact historical preflight failure inventory",
521
+ );
522
+ }
523
+ }
524
+
511
525
  function confirm(plan) {
512
526
  if (arg("confirm-source-sha") !== plan.source.sha) {
513
527
  throw new Error("--confirm-source-sha must equal the exact source SHA");
@@ -566,6 +580,17 @@ function confirm(plan) {
566
580
  "--confirm-historical-terminal-failure-runs-json must equal the exact historical terminal failure inventory",
567
581
  );
568
582
  }
583
+ const confirmedSuccessfulRuns = flag("confirm-successful-run-ids-json")
584
+ ? jsonArrayArg("confirm-successful-run-ids-json").map(String)
585
+ : [];
586
+ if (
587
+ JSON.stringify(confirmedSuccessfulRuns) !==
588
+ JSON.stringify(plan.github.successfulRunIds)
589
+ ) {
590
+ throw new Error(
591
+ "--confirm-successful-run-ids-json must equal the exact successful run inventory",
592
+ );
593
+ }
569
594
  } else if (plan.github.priorRunPolicy === "preflight-failure") {
570
595
  const confirmed = jsonArrayArg(
571
596
  "confirm-preflight-failure-run-ids-json",
@@ -602,7 +627,19 @@ function confirm(plan) {
602
627
  "--confirm-historical-terminal-failure-runs-json must equal the exact historical terminal failure inventory",
603
628
  );
604
629
  }
630
+ const confirmedSuccessfulRuns = flag("confirm-successful-run-ids-json")
631
+ ? jsonArrayArg("confirm-successful-run-ids-json").map(String)
632
+ : [];
633
+ if (
634
+ JSON.stringify(confirmedSuccessfulRuns) !==
635
+ JSON.stringify(plan.github.successfulRunIds)
636
+ ) {
637
+ throw new Error(
638
+ "--confirm-successful-run-ids-json must equal the exact successful run inventory",
639
+ );
640
+ }
605
641
  }
642
+ confirmHistoricalPreflightFailures(plan);
606
643
  }
607
644
  if (plan.kind === "instance-rehydrate-plan") {
608
645
  if (arg("confirm-host-id") !== plan.aws.hostId) {
@@ -696,6 +733,16 @@ export function main() {
696
733
  flag("historical-terminal-failure-runs-json")
697
734
  ? jsonArrayArg("historical-terminal-failure-runs-json")
698
735
  : [],
736
+ historicalPreflightFailureRuns:
737
+ (afterFailure || afterPreflightFailure) &&
738
+ flag("historical-preflight-failure-runs-json")
739
+ ? jsonArrayArg("historical-preflight-failure-runs-json")
740
+ : [],
741
+ successfulRunIds:
742
+ (afterFailure || afterPreflightFailure) &&
743
+ flag("successful-run-ids-json")
744
+ ? jsonArrayArg("successful-run-ids-json")
745
+ : [],
699
746
  });
700
747
  return emit(plan, mode, execute, () =>
701
748
  executeMacosJitSourceRebind(plan, { profile: arg("aws-profile") }),
@@ -89,6 +89,20 @@ function assertExactStartupFailure(run, jobCount, artifactCount) {
89
89
  }
90
90
  }
91
91
 
92
+ function assertExactSuccessfulRun(run, jobs, jobCount, artifactCount) {
93
+ if (
94
+ run.status !== "completed" ||
95
+ run.conclusion !== "success" ||
96
+ jobCount === 0 ||
97
+ artifactCount === 0 ||
98
+ (jobs.jobs || []).some((job) => job.status !== "completed")
99
+ ) {
100
+ throw new Error(
101
+ `macOS campaign run ${run.id} is not a terminal successful run with retained evidence`,
102
+ );
103
+ }
104
+ }
105
+
92
106
  function classifyCampaignRun(plan, run) {
93
107
  const startupFailure = plan.github.startupFailureRuns.find(
94
108
  ({ runId }) => runId === String(run.id),
@@ -97,23 +111,35 @@ function classifyCampaignRun(plan, run) {
97
111
  plan.github.historicalTerminalFailureRuns.find(
98
112
  ({ runId }) => runId === String(run.id),
99
113
  );
114
+ const historicalPreflightFailure =
115
+ plan.github.historicalPreflightFailureRuns.find(
116
+ ({ runId }) => runId === String(run.id),
117
+ );
100
118
  const preflightFailure = plan.github.preflightFailureRunIds.includes(
101
119
  String(run.id),
102
120
  );
121
+ const successfulRun = plan.github.successfulRunIds.includes(String(run.id));
103
122
  return {
104
123
  startupFailure,
105
124
  historicalTerminalFailure,
125
+ historicalPreflightFailure,
126
+ successfulRun,
106
127
  expectedSourceSha:
107
128
  startupFailure?.sourceSha ||
108
129
  historicalTerminalFailure?.sourceSha ||
130
+ historicalPreflightFailure?.sourceSha ||
109
131
  plan.previousSource.sha,
110
132
  classification: startupFailure
111
133
  ? "startup-failure"
112
134
  : historicalTerminalFailure
113
135
  ? "historical-terminal-failure"
114
- : preflightFailure
115
- ? "preflight-failure"
116
- : plan.github.priorRunPolicy,
136
+ : historicalPreflightFailure
137
+ ? "historical-preflight-failure"
138
+ : successfulRun
139
+ ? "successful-run"
140
+ : preflightFailure
141
+ ? "preflight-failure"
142
+ : plan.github.priorRunPolicy,
117
143
  };
118
144
  }
119
145
 
@@ -137,12 +163,18 @@ function assertExactReceiptInventories(plan, receipts) {
137
163
  const inventories = [
138
164
  ["terminal-failure", plan.github.terminalFailureRunIds, false],
139
165
  ["preflight-failure", plan.github.preflightFailureRunIds, false],
166
+ ["successful-run", plan.github.successfulRunIds, false],
140
167
  ["startup-failure", plan.github.startupFailureRuns, true],
141
168
  [
142
169
  "historical-terminal-failure",
143
170
  plan.github.historicalTerminalFailureRuns,
144
171
  true,
145
172
  ],
173
+ [
174
+ "historical-preflight-failure",
175
+ plan.github.historicalPreflightFailureRuns,
176
+ true,
177
+ ],
146
178
  ];
147
179
  for (const [classification, expected, withSource] of inventories) {
148
180
  const observed = exactReceiptInventory(
@@ -201,11 +233,15 @@ function campaignRunReceipts(plan) {
201
233
  );
202
234
  if (classification.startupFailure) {
203
235
  assertExactStartupFailure(run, jobCount, artifactCount);
236
+ } else if (classification.successfulRun) {
237
+ assertExactSuccessfulRun(run, jobs, jobCount, artifactCount);
204
238
  } else {
205
239
  assertRunMatchesPolicy(
206
240
  classification.historicalTerminalFailure
207
241
  ? "terminal-failure"
208
- : plan.github.priorRunPolicy,
242
+ : classification.historicalPreflightFailure
243
+ ? "preflight-failure"
244
+ : plan.github.priorRunPolicy,
209
245
  run,
210
246
  jobs,
211
247
  jobCount,
@@ -438,10 +474,15 @@ function assertZeroCampaignResidue(plan, profile) {
438
474
  const evidenceObjects = {};
439
475
  const historicalTerminalSources =
440
476
  plan.github.historicalTerminalFailureRuns.map(({ sourceSha }) => sourceSha);
477
+ const historicalPreflightSources =
478
+ plan.github.historicalPreflightFailureRuns.map(
479
+ ({ sourceSha }) => sourceSha,
480
+ );
441
481
  const evidenceSources = [
442
482
  ...new Set([
443
483
  plan.previousSource.sha,
444
484
  ...historicalTerminalSources,
485
+ ...historicalPreflightSources,
445
486
  plan.source.sha,
446
487
  ]),
447
488
  ];
@@ -25,6 +25,17 @@ function writeJson(file, value) {
25
25
  return resolved;
26
26
  }
27
27
 
28
+ export function writeMacosJitQualificationEnvironment(
29
+ githubEnv = process.env.GITHUB_ENV,
30
+ ) {
31
+ if (!githubEnv) return false;
32
+ fs.appendFileSync(
33
+ path.resolve(githubEnv),
34
+ "BUILDCHAIN_SIGNING_REQUESTS_ENABLED=false\n",
35
+ );
36
+ return true;
37
+ }
38
+
28
39
  export function main() {
29
40
  const mode = process.argv[2] || "plan";
30
41
  if (mode === "plan") {
@@ -64,6 +75,7 @@ export function main() {
64
75
  ".buildchain/aws-macos-jit.json",
65
76
  result,
66
77
  );
78
+ writeMacosJitQualificationEnvironment();
67
79
  process.stdout.write(`${output}\n`);
68
80
  return result;
69
81
  }