@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.
- package/dist/site/buildchain-contract.json +67 -7
- package/dist/site/buildchain-site.json +9 -9
- package/dist/site/kfd-claims.json +3 -3
- package/dist/site/kfd-upstream-aggregate.json +1 -1
- package/dist/site/manual-registry.json +1 -1
- package/dist/site/node-api-registry.json +11 -11
- package/dist/site/page-registry.json +4 -4
- package/dist/site/public-surface-audit.json +2 -2
- package/dist/site/publication-registry.json +4 -4
- package/dist/site/site-manifest.json +5 -5
- package/dist/site/workflow-registry.json +4 -4
- package/docs/aws-us-elastic-runner-burst-plane.md +5 -0
- package/docs/node-api-reference.md +16 -16
- package/package.json +1 -1
- package/packages/core/buildchain-compatibility-proof.js +22 -0
- package/scripts/aws-macos-jit-controller-core.mjs +50 -0
- package/scripts/aws-macos-jit-controller.mjs +47 -0
- package/scripts/aws-macos-jit-source-rebind.mjs +45 -4
- package/scripts/aws-macos-jit.mjs +12 -0
- package/scripts/seal-artifact-signing-requests.mjs +7 -4
|
@@ -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": "
|
|
8127
|
-
"pageRegistryDigest": "
|
|
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-
|
|
5
|
-
"publishedAt": "2026-08-
|
|
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": "
|
|
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.
|
|
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-
|
|
5
|
-
"publishedAt": "2026-08-
|
|
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": "
|
|
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.
|
|
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:
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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.
|
|
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
|
-
:
|
|
115
|
-
? "preflight-failure"
|
|
116
|
-
:
|
|
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
|
-
:
|
|
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
|
}
|