@kungfu-tech/buildchain 3.0.7 → 3.0.8

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.
Files changed (45) hide show
  1. package/contracts/engineering-housekeeper-v1.schema.json +11 -1
  2. package/contracts/fixtures/engineering-housekeeper-v1/cases.json +10 -0
  3. package/contracts/release-cut-v1.schema.json +70 -0
  4. package/contracts/release-train-transition-v1.schema.json +85 -0
  5. package/contracts/release-train-v1.schema.json +82 -0
  6. package/dist/site/buildchain-contract.json +302 -16
  7. package/dist/site/buildchain-site.json +83 -27
  8. package/dist/site/capability-registry.json +4 -3
  9. package/dist/site/kfd-claims.json +45 -8
  10. package/dist/site/kfd-upstream-aggregate.json +1 -1
  11. package/dist/site/manual-registry.json +22 -6
  12. package/dist/site/node-api-registry.json +1218 -489
  13. package/dist/site/page-registry.json +65 -17
  14. package/dist/site/public-surface-audit.json +13 -8
  15. package/dist/site/publication-authority-registry.json +2 -4
  16. package/dist/site/publication-registry.json +4 -4
  17. package/dist/site/release-provenance.json +1 -0
  18. package/dist/site/site-manifest.json +18 -10
  19. package/dist/site/workflow-registry.json +10 -9
  20. package/docs/MAP.md +1 -1
  21. package/docs/aws-us-elastic-runner-burst-plane.md +20 -7
  22. package/docs/engineering-housekeeper.md +61 -28
  23. package/docs/node-api-reference.md +109 -77
  24. package/docs/release-governance.md +13 -10
  25. package/docs/release-train.md +102 -0
  26. package/docs/reusable-build-surface.md +16 -6
  27. package/docs/site-bundle-contract.md +5 -1
  28. package/docs/versioning.md +1 -0
  29. package/package.json +2 -1
  30. package/packages/core/buildchain-agent-manuals.js +1 -0
  31. package/packages/core/buildchain-compatibility-proof.js +577 -0
  32. package/packages/core/buildchain-contract.js +46 -181
  33. package/packages/core/engineering-housekeeper-github-client.js +18 -1
  34. package/packages/core/engineering-housekeeper-github.js +247 -41
  35. package/packages/core/engineering-housekeeper.js +15 -0
  36. package/packages/core/release-train.js +520 -0
  37. package/scripts/aws-macos-jit-controller-core.mjs +33 -11
  38. package/scripts/aws-macos-jit-controller-runtime.mjs +208 -0
  39. package/scripts/aws-macos-jit-controller.mjs +50 -37
  40. package/scripts/aws-macos-jit-core.mjs +41 -3
  41. package/scripts/buildchain-contract-lock.mjs +6 -0
  42. package/scripts/dispatch-artifact-signing-authority.mjs +4 -7
  43. package/scripts/engineering-housekeeper-workflow.mjs +13 -6
  44. package/scripts/generate-site-bundle.mjs +2 -0
  45. package/scripts/site-capability-metadata.mjs +1 -0
package/docs/node-api-reference.md CHANGED
@@ -34,7 +34,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
34
34
  | `aggregateControllerReceipts` | function: function aggregateControllerReceipts({ plans = [], receipts = [] } = {}) | { plans = [], receipts = [] } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { aggregateControllerReceipts } from "@kungfu-tech/buildchain";` | `packages/core/controller-evidence.js:449` |
35
35
  | `ANCHORED_VERSION_MATERIAL_CONTRACT` | constant: const ANCHORED_VERSION_MATERIAL_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ANCHORED_VERSION_MATERIAL_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/anchored-version-material.js:15` |
36
36
  | `appendBuildchainLogEvent` | function: function appendBuildchainLogEvent(filePath, event) | filePath, event | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | local-filesystem-write | `import { appendBuildchainLogEvent } from "@kungfu-tech/buildchain";` | `packages/core/logging.js:67` |
37
- | `applyGitHubHousekeeperPlan` | function: async function applyGitHubHousekeeperPlan({ client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, }) | { client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, } | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { applyGitHubHousekeeperPlan } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github.js:409` |
37
+ | `applyGitHubHousekeeperPlan` | function: async function applyGitHubHousekeeperPlan({ client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, }) | { client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, } | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { applyGitHubHousekeeperPlan } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github.js:615` |
38
38
  | `applySurfaceTimestampPolicy` | function: function applySurfaceTimestampPolicy(manifest, options = {}) | manifest, options = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | may-write-or-invoke-external-actions | `import { applySurfaceTimestampPolicy } from "@kungfu-tech/buildchain";` | `packages/core/surface-manifest.js:79` |
39
39
  | `ARTIFACT_EVIDENCE_CONTRACT` | constant: const ARTIFACT_EVIDENCE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ARTIFACT_EVIDENCE_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:29` |
40
40
  | `ARTIFACT_PASSPORT_LOCATOR_CONTRACT` | constant: const ARTIFACT_PASSPORT_LOCATOR_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ARTIFACT_PASSPORT_LOCATOR_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/artifact-passport.js:11` |
@@ -68,7 +68,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
68
68
  | `BUILDCHAIN_CANDIDATE_TIMELINE_EVENT_CONTRACT` | constant: const BUILDCHAIN_CANDIDATE_TIMELINE_EVENT_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CANDIDATE_TIMELINE_EVENT_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/candidate-timeline.js:3` |
69
69
  | `BUILDCHAIN_CONFIG_PATH` | constant: const BUILDCHAIN_CONFIG_PATH | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONFIG_PATH } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-layout.js:7` |
70
70
  | `BUILDCHAIN_CONSUMER_ISSUE_CONTRACT` | constant: const BUILDCHAIN_CONSUMER_ISSUE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONSUMER_ISSUE_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/issue-reporting.js:4` |
71
- | `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";` | `packages/core/buildchain-contract.js:8` |
71
+ | `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";` | `packages/core/buildchain-contract.js:29` |
72
72
  | `BUILDCHAIN_CONTRACT_LOCK_PATH` | constant: const BUILDCHAIN_CONTRACT_LOCK_PATH | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONTRACT_LOCK_PATH } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-layout.js:9` |
73
73
  | `BUILDCHAIN_CONTROLLER_AGGREGATE_CONTRACT` | constant: const BUILDCHAIN_CONTROLLER_AGGREGATE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONTROLLER_AGGREGATE_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/controller-evidence.js:6` |
74
74
  | `BUILDCHAIN_CONTROLLER_DESCRIPTOR_CONTRACT` | constant: const BUILDCHAIN_CONTROLLER_DESCRIPTOR_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONTROLLER_DESCRIPTOR_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/controller-evidence.js:4` |
@@ -110,7 +110,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
110
110
  | `BUILDCHAIN_PROCESS_SAMPLE_SUMMARY_CONTRACT` | constant: const BUILDCHAIN_PROCESS_SAMPLE_SUMMARY_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_PROCESS_SAMPLE_SUMMARY_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/diagnostics.js:39` |
111
111
  | `BUILDCHAIN_PUBLIC_SURFACE_AUDIT_CONTRACT` | constant: const BUILDCHAIN_PUBLIC_SURFACE_AUDIT_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_PUBLIC_SURFACE_AUDIT_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/public-surface-audit.js:12` |
112
112
  | `BUILDCHAIN_RELEASE_PASSPORT_PATH` | constant: const BUILDCHAIN_RELEASE_PASSPORT_PATH | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_RELEASE_PASSPORT_PATH } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-layout.js:33` |
113
- | `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";` | `packages/core/buildchain-contract.js:7` |
113
+ | `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";` | `packages/core/buildchain-contract.js:28` |
114
114
  | `BUILDCHAIN_VERSION_PIN_PATH` | constant: const BUILDCHAIN_VERSION_PIN_PATH | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_VERSION_PIN_PATH } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-layout.js:5` |
115
115
  | `BUILDCHAIN_WORKFLOW_FRICTION_ISSUE_CONTRACT` | constant: const BUILDCHAIN_WORKFLOW_FRICTION_ISSUE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_WORKFLOW_FRICTION_ISSUE_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/issue-reporting.js:5` |
116
116
  | `buildchainKfdClaims` | constant: const buildchainKfdClaims | none | value | Import does not declare a throw contract. | none-on-import | `import { buildchainKfdClaims } from "@kungfu-tech/buildchain";` | `packages/core/kfd.js:896` |
@@ -126,9 +126,9 @@ Target: `./packages/core/index.js`. Public symbols: 609.
126
126
  | `checkKfd2ProductClaimOutputs` | function: function checkKfd2ProductClaimOutputs(options = {}) | options = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { checkKfd2ProductClaimOutputs } from "@kungfu-tech/buildchain";` | `packages/core/kfd2-product-claims.js:415` |
127
127
  | `checkReadmeBadgeBlock` | function: function checkReadmeBadgeBlock({ readmeText, facts } = {}) | { readmeText, facts } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { checkReadmeBadgeBlock } from "@kungfu-tech/buildchain";` | `packages/core/readme-badges.js:848` |
128
128
  | `claimReleasePropagationWork` | function: function claimReleasePropagationWork({ work, expectedWorkRoot, authority, familyState, } = {}) | { work, expectedWorkRoot, authority, familyState, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { claimReleasePropagationWork } from "@kungfu-tech/buildchain";` | `packages/core/release-propagation-work-transitions.js:17` |
129
- | `classifyHousekeeperBranch` | function: function classifyHousekeeperBranch(branch, policyInput = {}) | branch, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperBranch } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:92` |
130
- | `classifyHousekeeperPullRequest` | function: function classifyHousekeeperPullRequest(pullRequest, policyInput = {}) | pullRequest, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperPullRequest } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:129` |
131
- | `classifyHousekeeperReplay` | function: function classifyHousekeeperReplay(plan, priorReceipt) | plan, priorReceipt | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperReplay } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:250` |
129
+ | `classifyHousekeeperBranch` | function: function classifyHousekeeperBranch(branch, policyInput = {}) | branch, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperBranch } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:105` |
130
+ | `classifyHousekeeperPullRequest` | function: function classifyHousekeeperPullRequest(pullRequest, policyInput = {}) | pullRequest, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperPullRequest } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:144` |
131
+ | `classifyHousekeeperReplay` | function: function classifyHousekeeperReplay(plan, priorReceipt) | plan, priorReceipt | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperReplay } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:265` |
132
132
  | `classifyProcessCommand` | function: function classifyProcessCommand(command = "") | command = "" | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyProcessCommand } from "@kungfu-tech/buildchain";` | `packages/core/diagnostics.js:1090` |
133
133
  | `classifyReleasePropagationCondition` | function: function classifyReleasePropagationCondition(condition) | condition | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { classifyReleasePropagationCondition } from "@kungfu-tech/buildchain";` | `packages/core/release-propagation-agent-entry.js:171` |
134
134
  | `codeownersForPath` | function: function codeownersForPath(source, candidatePath) | source, candidatePath | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { codeownersForPath } from "@kungfu-tech/buildchain";` | `packages/core/github-governance-authority.js:417` |
@@ -137,7 +137,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
137
137
  | `collectCacheDiagnostics` | function: function collectCacheDiagnostics({ cwd = process.cwd(), cacheDirs = [], runCommand = defaultDiagnosticCommandRunner } = {}) | { cwd = process.cwd(), cacheDirs = [], runCommand = defaultDiagnosticCommandRunner } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectCacheDiagnostics } from "@kungfu-tech/buildchain";` | `packages/core/diagnostics.js:927` |
138
138
  | `collectCompilerCacheDiagnostics` | function: function collectCompilerCacheDiagnostics({ cwd = process.cwd(), runCommand = defaultDiagnosticCommandRunner, env = process.env, } = {}) | { cwd = process.cwd(), runCommand = defaultDiagnosticCommandRunner, env = process.env, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectCompilerCacheDiagnostics } from "@kungfu-tech/buildchain";` | `packages/core/diagnostics.js:578` |
139
139
  | `collectGitDiagnostics` | function: function collectGitDiagnostics({ cwd = process.cwd() } = {}) | { cwd = process.cwd() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectGitDiagnostics } from "@kungfu-tech/buildchain";` | `packages/core/diagnostics.js:949` |
140
- | `collectGitHubHousekeeperInventory` | function: async function collectGitHubHousekeeperInventory({ client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, }) | { client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, } | Promise<unknown> | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { collectGitHubHousekeeperInventory } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github.js:110` |
140
+ | `collectGitHubHousekeeperInventory` | function: async function collectGitHubHousekeeperInventory({ client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, }) | { client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, } | Promise<unknown> | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { collectGitHubHousekeeperInventory } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github.js:246` |
141
141
  | `collectGitHubReleasePassport` | function: function collectGitHubReleasePassport({ cwd = process.cwd(), tag = "", repository = process.env.GITHUB_REPOSITORY \|\| "", sourceSha = process.env.GITHUB_SHA \|\| "", line = "", outputDir = ".buildchain/release-passport", assetsJson = "", assetsDir = "", kfdArtifactSearchRoots = [], releaseJson = "", productName = "Buildchain", packageName = "@kungfu-tech/buildchain", packageVersion = "", packageSetJson = "", publishEvidenceJson = "", trustedPublishingJson = "", transactionJson = "", anchorManifestJson = "", versionMaterialJson = "", impactJson = "", buildSummaryJson = "", buildFactsJsons = [], platformManifestJsons = [], distTagEvidenceJson = "", kfd1WitnessJsons = [], kfd2ClaimJsons = [], kfd3PrebuildWitnessJsons = [], kfd3ArtifactWitnessJsons = [], kfd3ArtifactVerifyCommand = "", kfdSupportMatrixJson = "", kfdProductGateJsons = [], invariantPassportJsons = [], invariantPassportCommand = "", releaseEvidenceJsons = [], kfdAgentHubEvidenceJson = "", controllerReceiptReferences = [], githubArtifactAttestationPolicyJsons = [], basePassportJson = "", requireBaseKfd = false, releaseJsonExtra = "", publishJson = "", workflow = {}, checkedAt = "", } = {}) | { cwd = process.cwd(), tag = "", repository = process.env.GITHUB_REPOSITORY \|\| "", sourceSha = process.env.GITHUB_SHA \|\| "", line = "", outputDir = ".buildchain/release-passport", assetsJson = "", assetsDir = "", kfdArtifactSearchRoots = [], releaseJson = "", productName = "Buildchain", packageName = "@kungfu-tech/buildchain", packageVersion = "", packageSetJson = "", publishEvidenceJson = "", trustedPublishingJson = "", transactionJson = "", anchorManifestJson = "", versionMaterialJson = "", impactJson = "", buildSummaryJson = "", buildFactsJsons = [], platformManifestJsons = [], distTagEvidenceJson = "", kfd1WitnessJsons = [], kfd2ClaimJsons = [], kfd3PrebuildWitnessJsons = [], kfd3ArtifactWitnessJsons = [], kfd3ArtifactVerifyCommand = "", kfdSupportMatrixJson = "", kfdProductGateJsons = [], invariantPassportJsons = [], invariantPassportCommand = "", releaseEvidenceJsons = [], kfdAgentHubEvidenceJson = "", controllerReceiptReferences = [], githubArtifactAttestationPolicyJsons = [], basePassportJson = "", requireBaseKfd = false, releaseJsonExtra = "", publishJson = "", workflow = {}, checkedAt = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | local-filesystem-write | `import { collectGitHubReleasePassport } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:1563` |
142
142
  | `collectGitSourceFacts` | function: function collectGitSourceFacts({ cwd = process.cwd(), root = "." } = {}) | { cwd = process.cwd(), root = "." } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectGitSourceFacts } from "@kungfu-tech/buildchain";` | `packages/core/build-facts.js:146` |
143
143
  | `collectHomebrewTapFacts` | function: async function collectHomebrewTapFacts({ cwd = process.cwd(), packageName = "buildchain", releasePassport = "", manifestPath = DEFAULT_MANIFEST_PATH, formulaPath = "", } = {}) | { cwd = process.cwd(), packageName = "buildchain", releasePassport = "", manifestPath = DEFAULT_MANIFEST_PATH, formulaPath = "", } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectHomebrewTapFacts } from "@kungfu-tech/buildchain";` | `packages/core/homebrew.js:223` |
@@ -164,7 +164,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
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-contract.js:973` |
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:359` |
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:151` |
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` |
@@ -172,8 +172,8 @@ Target: `./packages/core/index.js`. Public symbols: 609.
172
172
  | `createArtifactSigningReceipt` | function: function createArtifactSigningReceipt({ request, status = "passed", authority = {}, result = {}, signatures = [], reason = "", } = {}) | { request, status = "passed", authority = {}, result = {}, signatures = [], reason = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createArtifactSigningReceipt } from "@kungfu-tech/buildchain";` | `packages/core/artifact-signing.js:374` |
173
173
  | `createArtifactSigningRequest` | function: function createArtifactSigningRequest({ source = {}, runtime = {}, artifact = {}, signature = {}, delivery = {}, } = {}) | { source = {}, runtime = {}, artifact = {}, signature = {}, delivery = {}, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createArtifactSigningRequest } from "@kungfu-tech/buildchain";` | `packages/core/artifact-signing.js:226` |
174
174
  | `createArtifactSigningResult` | function: function createArtifactSigningResult({ request, receipt, receiptPath = "receipt.json", payload = {}, evidence = [], verification = {}, } = {}) | { request, receipt, receiptPath = "receipt.json", payload = {}, evidence = [], verification = {}, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createArtifactSigningResult } from "@kungfu-tech/buildchain";` | `packages/core/artifact-signing-result.js:68` |
175
- | `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";` | `packages/core/buildchain-contract.js:815` |
176
- | `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";` | `packages/core/buildchain-contract.js:110` |
175
+ | `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";` | `packages/core/buildchain-contract.js:839` |
176
+ | `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";` | `packages/core/buildchain-contract.js:130` |
177
177
  | `createBuildchainGithubGovernanceAuthority` | function: function createBuildchainGithubGovernanceAuthority() | none | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createBuildchainGithubGovernanceAuthority } from "@kungfu-tech/buildchain";` | `packages/core/github-governance-authority.js:450` |
178
178
  | `createBuildchainKfd1Witness` | function: function createBuildchainKfd1Witness({ root = process.cwd(), sourceSha = "" } = {}) | { root = process.cwd(), sourceSha = "" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createBuildchainKfd1Witness } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-kfd-claims.js:530` |
179
179
  | `createBuildchainKfd2Claims` | function: function createBuildchainKfd2Claims({ root = process.cwd(), witnessFiles = {} } = {}) | { root = process.cwd(), witnessFiles = {} } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createBuildchainKfd2Claims } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-kfd-claims.js:687` |
@@ -194,8 +194,8 @@ Target: `./packages/core/index.js`. Public symbols: 609.
194
194
  | `createControllerReceiptReference` | function: function createControllerReceiptReference(receipt) | receipt | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createControllerReceiptReference } from "@kungfu-tech/buildchain";` | `packages/core/controller-evidence.js:491` |
195
195
  | `createControllerRegistry` | function: function createControllerRegistry({ workflows = [] } = {}) | { workflows = [] } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createControllerRegistry } from "@kungfu-tech/buildchain";` | `packages/core/controller-evidence.js:197` |
196
196
  | `createDiagnosticsArtifact` | function: function createDiagnosticsArtifact({ cwd = process.cwd(), logPath = "", artifactPaths = [], cacheDirs = [], lifecycleObservability = undefined, processSamples = [], processSummary = undefined, requestedParallelism = 0, sourceCheckout = undefined, compilerCachePreparation = undefined, links = {}, } = {}) | { cwd = process.cwd(), logPath = "", artifactPaths = [], cacheDirs = [], lifecycleObservability = undefined, processSamples = [], processSummary = undefined, requestedParallelism = 0, sourceCheckout = undefined, compilerCachePreparation = undefined, links = {}, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createDiagnosticsArtifact } from "@kungfu-tech/buildchain";` | `packages/core/diagnostics.js:1413` |
197
- | `createEngineeringHousekeeperPlan` | function: function createEngineeringHousekeeperPlan({ repository, target, branches = [], pullRequests = [], policy = {}, observedAt, }) | { repository, target, branches = [], pullRequests = [], policy = {}, observedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperPlan } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:155` |
198
- | `createEngineeringHousekeeperReceipt` | function: function createEngineeringHousekeeperReceipt({ plan, outcomes, appliedAt, }) | { plan, outcomes, appliedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperReceipt } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:231` |
197
+ | `createEngineeringHousekeeperPlan` | function: function createEngineeringHousekeeperPlan({ repository, target, branches = [], pullRequests = [], policy = {}, observedAt, }) | { repository, target, branches = [], pullRequests = [], policy = {}, observedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperPlan } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:170` |
198
+ | `createEngineeringHousekeeperReceipt` | function: function createEngineeringHousekeeperReceipt({ plan, outcomes, appliedAt, }) | { plan, outcomes, appliedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperReceipt } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:246` |
199
199
  | `createGitHubArtifactAttestationEvidence` | function: function createGitHubArtifactAttestationEvidence({ preparation, attestationId, attestationUrl, bundlePath, workflow = {}, } = {}) | { preparation, attestationId, attestationUrl, bundlePath, workflow = {}, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createGitHubArtifactAttestationEvidence } from "@kungfu-tech/buildchain";` | `packages/core/github-artifact-attestation.js:474` |
200
200
  | `createGitHubArtifactAttestationPolicy` | function: function createGitHubArtifactAttestationPolicy(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 { createGitHubArtifactAttestationPolicy } from "@kungfu-tech/buildchain";` | `packages/core/github-artifact-attestation.js:204` |
201
201
  | `createGitHubArtifactAttestationVerificationPlan` | function: function createGitHubArtifactAttestationVerificationPlan({ artifactPath, bundlePath, evidence, } = {}) | { artifactPath, bundlePath, evidence, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createGitHubArtifactAttestationVerificationPlan } from "@kungfu-tech/buildchain";` | `packages/core/github-artifact-attestation.js:524` |
@@ -254,7 +254,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
254
254
  | `createWebSurfacePublicationCandidate` | function: function createWebSurfacePublicationCandidate({ repository, sourceSha, sourceTreeSha, runtimeSha, plan, planFileDigest, controllerReceipt, decision, } = {}) | { repository, sourceSha, sourceTreeSha, runtimeSha, plan, planFileDigest, controllerReceipt, decision, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createWebSurfacePublicationCandidate } from "@kungfu-tech/buildchain";` | `packages/core/web-surface-publication-candidate.js:79` |
255
255
  | `decideChannelCandidate` | function: function decideChannelCandidate(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 { decideChannelCandidate } from "@kungfu-tech/buildchain";` | `packages/core/channel-candidate.js:91` |
256
256
  | `DEFAULT_BUILDCHAIN_ISSUE_REPOSITORY` | constant: const DEFAULT_BUILDCHAIN_ISSUE_REPOSITORY | none | value | Import does not declare a throw contract. | none-on-import | `import { DEFAULT_BUILDCHAIN_ISSUE_REPOSITORY } from "@kungfu-tech/buildchain";` | `packages/core/issue-reporting.js:6` |
257
- | `DEFAULT_HOUSEKEEPER_POLICY` | constant: const DEFAULT_HOUSEKEEPER_POLICY | none | value | Import does not declare a throw contract. | none-on-import | `import { DEFAULT_HOUSEKEEPER_POLICY } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:28` |
257
+ | `DEFAULT_HOUSEKEEPER_POLICY` | constant: const DEFAULT_HOUSEKEEPER_POLICY | none | value | Import does not declare a throw contract. | none-on-import | `import { DEFAULT_HOUSEKEEPER_POLICY } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:29` |
258
258
  | `defaultBuildchainLogPath` | function: function defaultBuildchainLogPath({ cwd = process.cwd() } = {}) | { cwd = process.cwd() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { defaultBuildchainLogPath } from "@kungfu-tech/buildchain";` | `packages/core/logging.js:41` |
259
259
  | `defaultPublishEvidencePath` | function: function defaultPublishEvidencePath(version, workspace = process.cwd()) | version, workspace = process.cwd() | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { defaultPublishEvidencePath } from "@kungfu-tech/buildchain";` | `packages/core/publish-transaction.js:193` |
260
260
  | `defaultReleaseStatePath` | function: function defaultReleaseStatePath(version, workspace = process.cwd()) | version, workspace = process.cwd() | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { defaultReleaseStatePath } from "@kungfu-tech/buildchain";` | `packages/core/publish-transaction.js:185` |
@@ -274,13 +274,13 @@ Target: `./packages/core/index.js`. Public symbols: 609.
274
274
  | `discoverPaperFleet` | function: function discoverPaperFleet(root = process.cwd()) | root = process.cwd() | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { discoverPaperFleet } from "@kungfu-tech/buildchain";` | `packages/core/paper-fleet.js:23` |
275
275
  | `ENGINEERING_HOUSEKEEPER_CONTRACT` | constant: const ENGINEERING_HOUSEKEEPER_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ENGINEERING_HOUSEKEEPER_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:3` |
276
276
  | `ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION` | constant: const ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION | none | value | Import does not declare a throw contract. | none-on-import | `import { ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:5` |
277
- | `engineeringHousekeeperRoot` | function: function engineeringHousekeeperRoot(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { engineeringHousekeeperRoot } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:49` |
277
+ | `engineeringHousekeeperRoot` | function: function engineeringHousekeeperRoot(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { engineeringHousekeeperRoot } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:58` |
278
278
  | `enumerateActionInputs` | function: function enumerateActionInputs({ 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 { enumerateActionInputs } from "@kungfu-tech/buildchain";` | `packages/core/public-surface-audit.js:91` |
279
279
  | `enumerateCliCommandsFromBin` | function: function enumerateCliCommandsFromBin({ root = process.cwd(), binPath = "bin/buildchain.mjs", } = {}) | { root = process.cwd(), binPath = "bin/buildchain.mjs", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { enumerateCliCommandsFromBin } from "@kungfu-tech/buildchain";` | `packages/core/public-surface-cli.js:93` |
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 = "", } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {} | 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-contract.js:881` |
283
+ | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {} | 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:440` |
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:465` |
@@ -295,10 +295,10 @@ Target: `./packages/core/index.js`. Public symbols: 609.
295
295
  | `explainReleaseLineDryRun` | function: function explainReleaseLineDryRun({ cwd = process.cwd(), targetRef, sha = "", sourceRef = "", tags, publishTransaction = false, publishCommand = "", } = {}) | { cwd = process.cwd(), targetRef, sha = "", sourceRef = "", tags, publishTransaction = false, publishCommand = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { explainReleaseLineDryRun } from "@kungfu-tech/buildchain";` | `packages/core/release-line-dry-run.js:127` |
296
296
  | `explainReleasePassport` | function: async function explainReleasePassport({ passportLocation, forAudience = "human" } = {}) | { passportLocation, forAudience = "human" } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { explainReleasePassport } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:2922` |
297
297
  | `FAMILY_RELEASE_EVIDENCE_CONTRACT` | constant: const FAMILY_RELEASE_EVIDENCE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { FAMILY_RELEASE_EVIDENCE_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/release-candidate.js:5` |
298
- | `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";` | `packages/core/buildchain-contract.js:790` |
298
+ | `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";` | `packages/core/buildchain-contract.js:794` |
299
299
  | `formatCandidateTimelineReport` | function: function formatCandidateTimelineReport(timeline) | timeline | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatCandidateTimelineReport } from "@kungfu-tech/buildchain";` | `packages/core/candidate-timeline.js:438` |
300
300
  | `formatDiagnosticsSummaryTable` | function: function formatDiagnosticsSummaryTable(summary = {}) | summary = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatDiagnosticsSummaryTable } from "@kungfu-tech/buildchain";` | `packages/core/diagnostics.js:1791` |
301
- | `formatGitHubHousekeeperPlan` | function: function formatGitHubHousekeeperPlan(plan) | plan | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatGitHubHousekeeperPlan } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github.js:491` |
301
+ | `formatGitHubHousekeeperPlan` | function: function formatGitHubHousekeeperPlan(plan) | plan | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatGitHubHousekeeperPlan } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github.js:697` |
302
302
  | `formatReleaseLineDryRun` | function: function formatReleaseLineDryRun(plan) | plan | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatReleaseLineDryRun } from "@kungfu-tech/buildchain";` | `packages/core/release-line-dry-run.js:267` |
303
303
  | `getLifecycleStage` | function: function getLifecycleStage(loadedConfig, name) | loadedConfig, name | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { getLifecycleStage } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-config.js:1432` |
304
304
  | `getNativeDiagnosticsProfile` | function: function getNativeDiagnosticsProfile(loadedConfig) | loadedConfig | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { getNativeDiagnosticsProfile } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-config.js:585` |
@@ -321,8 +321,8 @@ Target: `./packages/core/index.js`. Public symbols: 609.
321
321
  | `githubArtifactAttestationSha256Buffer` | function: function githubArtifactAttestationSha256Buffer(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { githubArtifactAttestationSha256Buffer } from "@kungfu-tech/buildchain";` | `packages/core/github-artifact-attestation.js:83` |
322
322
  | `githubArtifactAttestationSha256File` | function: function githubArtifactAttestationSha256File(filePath) | filePath | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { githubArtifactAttestationSha256File } from "@kungfu-tech/buildchain";` | `packages/core/github-artifact-attestation.js:87` |
323
323
  | `githubGovernanceDigest` | function: function githubGovernanceDigest(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 { githubGovernanceDigest } from "@kungfu-tech/buildchain";` | `packages/core/github-governance-authority.js:163` |
324
- | `GitHubHousekeeperClient` | class: class GitHubHousekeeperClient | none | GitHubHousekeeperClient | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperClient } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github-client.js:53` |
325
- | `GitHubHousekeeperProviderError` | class: class GitHubHousekeeperProviderError | none | GitHubHousekeeperProviderError | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperProviderError } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github-client.js:36` |
324
+ | `GitHubHousekeeperClient` | class: class GitHubHousekeeperClient | none | GitHubHousekeeperClient | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperClient } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github-client.js:54` |
325
+ | `GitHubHousekeeperProviderError` | class: class GitHubHousekeeperProviderError | none | GitHubHousekeeperProviderError | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperProviderError } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github-client.js:37` |
326
326
  | `GitHubIssueRequestError` | class: class GitHubIssueRequestError | none | GitHubIssueRequestError | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubIssueRequestError } from "@kungfu-tech/buildchain";` | `packages/core/issue-reporting.js:23` |
327
327
  | `githubReleaseAssetsTargetRoot` | function: function githubReleaseAssetsTargetRoot({ destination, artifacts }) | { destination, artifacts } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { githubReleaseAssetsTargetRoot } from "@kungfu-tech/buildchain";` | `packages/core/release-tail-provider-adapters.js:297` |
328
328
  | `HOMEBREW_TAP_CHECK_CONTRACT` | constant: const HOMEBREW_TAP_CHECK_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { HOMEBREW_TAP_CHECK_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/homebrew.js:6` |
@@ -455,8 +455,8 @@ Target: `./packages/core/index.js`. Public symbols: 609.
455
455
  | `publicationGateAggregateBindings` | function: function publicationGateAggregateBindings(gateAggregate) | gateAggregate | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { publicationGateAggregateBindings } from "@kungfu-tech/buildchain";` | `packages/core/publication-authority.js:408` |
456
456
  | `qualifyStableCandidate` | function: function qualifyStableCandidate(ledgerInput, observation, { minimumSoakSeconds = 3600, now = new Date().toISOString() } = {}) | ledgerInput, observation, { minimumSoakSeconds = 3600, now = new Date().toISOString() } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | may-write-or-invoke-external-actions | `import { qualifyStableCandidate } from "@kungfu-tech/buildchain";` | `packages/core/stable-candidate-ledger.js:139` |
457
457
  | `queryKfd3Capabilities` | function: async function queryKfd3Capabilities({ cwd = process.cwd(), product = "", registryPath = "", passportLocation = "", artifactPath = "", } = {}) | { cwd = process.cwd(), product = "", registryPath = "", passportLocation = "", artifactPath = "", } = {} | Promise<unknown> | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { queryKfd3Capabilities } from "@kungfu-tech/buildchain";` | `packages/core/kfd3-surface-register.js:824` |
458
- | `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";` | `packages/core/buildchain-contract.js:866` |
459
- | `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";` | `packages/core/buildchain-contract.js:846` |
458
+ | `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";` | `packages/core/buildchain-contract.js:893` |
459
+ | `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";` | `packages/core/buildchain-contract.js:872` |
460
460
  | `readBuildchainLogEvents` | function: function readBuildchainLogEvents(filePath) | filePath | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { readBuildchainLogEvents } from "@kungfu-tech/buildchain";` | `packages/core/logging.js:75` |
461
461
  | `readDiagnosticsArtifact` | function: function readDiagnosticsArtifact(filePath) | filePath | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { readDiagnosticsArtifact } from "@kungfu-tech/buildchain";` | `packages/core/diagnostics.js:1473` |
462
462
  | `readJsonFromLocation` | function: async function readJsonFromLocation(location, redirectCount = 0, { timeoutMs = 15_000 } = {}) | location, redirectCount = 0, { timeoutMs = 15_000 } = {} | Promise<unknown> | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { readJsonFromLocation } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:2804` |
@@ -520,7 +520,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
520
520
  | `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` |
521
521
  | `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` |
522
522
  | `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` |
523
- | `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-contract.js:985` |
523
+ | `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:560` |
524
524
  | `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` |
525
525
  | `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` |
526
526
  | `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` |
@@ -542,10 +542,10 @@ Target: `./packages/core/index.js`. Public symbols: 609.
542
542
  | `resolvePublicationCandidateFile` | function: function resolvePublicationCandidateFile(files = [], candidatePath) | files = [], candidatePath | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { resolvePublicationCandidateFile } from "@kungfu-tech/buildchain";` | `packages/core/publication-artifact-candidate.js:23` |
543
543
  | `resolveReleasePassportPath` | function: function resolveReleasePassportPath(cwd = process.cwd()) | cwd = process.cwd() | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { resolveReleasePassportPath } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-layout.js:92` |
544
544
  | `resumeReleasePropagationWork` | function: function resumeReleasePropagationWork(work) | work | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { resumeReleasePropagationWork } from "@kungfu-tech/buildchain";` | `packages/core/release-propagation-work.js:518` |
545
- | `revalidateHousekeeperBranchAction` | function: function revalidateHousekeeperBranchAction(action, current, policy = {}) | action, current, policy = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { revalidateHousekeeperBranchAction } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:208` |
545
+ | `revalidateHousekeeperBranchAction` | function: function revalidateHousekeeperBranchAction(action, current, policy = {}) | action, current, policy = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { revalidateHousekeeperBranchAction } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper.js:223` |
546
546
  | `revokeStableCandidate` | function: function revokeStableCandidate(ledgerInput, versionInput, { reason, actor = "", now = new Date().toISOString() } = {}) | ledgerInput, versionInput, { reason, actor = "", now = new Date().toISOString() } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | may-write-or-invoke-external-actions | `import { revokeStableCandidate } from "@kungfu-tech/buildchain";` | `packages/core/stable-candidate-ledger.js:185` |
547
547
  | `rollbackReleaseActivationTransaction` | function: function rollbackReleaseActivationTransaction(transaction, { toSiteSourceSha, reason } = {}) | transaction, { toSiteSourceSha, reason } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | may-write-or-invoke-external-actions | `import { rollbackReleaseActivationTransaction } from "@kungfu-tech/buildchain";` | `packages/core/release-activation-transaction.js:290` |
548
- | `runGitHubHousekeeper` | function: async function runGitHubHousekeeper(options) | options | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { runGitHubHousekeeper } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github.js:485` |
548
+ | `runGitHubHousekeeper` | function: async function runGitHubHousekeeper(options) | options | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { runGitHubHousekeeper } from "@kungfu-tech/buildchain";` | `packages/core/engineering-housekeeper-github.js:691` |
549
549
  | `runLifecycleStage` | function: function runLifecycleStage({ cwd = process.cwd(), loadedConfig, name, stage, env: extraEnv, timeoutMinutes }) | { cwd = process.cwd(), loadedConfig, name, stage, env: extraEnv, timeoutMinutes } | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | subprocess | `import { runLifecycleStage } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-config.js:1440` |
550
550
  | `RUNNER_PROVENANCE_CLASSES` | constant: const RUNNER_PROVENANCE_CLASSES | none | value | Import does not declare a throw contract. | none-on-import | `import { RUNNER_PROVENANCE_CLASSES } from "@kungfu-tech/buildchain";` | `packages/core/publication-authority.js:36` |
551
551
  | `RUNNER_PROVENANCE_CONTRACT` | constant: const RUNNER_PROVENANCE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { RUNNER_PROVENANCE_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/publication-authority.js:14` |
@@ -553,7 +553,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
553
553
  | `sealArtifactVerificationReport` | function: function sealArtifactVerificationReport({ report, bindings, kfdAssessment, issuedAt, expiresAt, revocation, } = {}) | { report, bindings, kfdAssessment, issuedAt, expiresAt, revocation, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { sealArtifactVerificationReport } from "@kungfu-tech/buildchain";` | `packages/core/artifact-verification-envelope.js:314` |
554
554
  | `selectStableCandidate` | function: function selectStableCandidate(ledgerInput, { releaseNow = "", now = new Date().toISOString() } = {}) | ledgerInput, { releaseNow = "", now = new Date().toISOString() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { selectStableCandidate } from "@kungfu-tech/buildchain";` | `packages/core/stable-candidate-ledger.js:206` |
555
555
  | `setStableCandidateHold` | function: function setStableCandidateHold(ledgerInput, enabled, { reason = "", now = new Date().toISOString() } = {}) | ledgerInput, enabled, { reason = "", now = new Date().toISOString() } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | may-write-or-invoke-external-actions | `import { setStableCandidateHold } from "@kungfu-tech/buildchain";` | `packages/core/stable-candidate-ledger.js:198` |
556
- | `sha256BuildchainContractJson` | 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 { sha256BuildchainContractJson } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-contract.js:30` |
556
+ | `sha256BuildchainContractJson` | 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 { sha256BuildchainContractJson } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-contract.js:50` |
557
557
  | `sha256File` | function: function sha256File(filePath) | filePath | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | local-filesystem-write, subprocess | `import { sha256File } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:243` |
558
558
  | `sha256Json` | function: function sha256Json(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 { sha256Json } from "@kungfu-tech/buildchain";` | `packages/core/release-candidate.js:90` |
559
559
  | `sha256KfdJson` | 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 { sha256KfdJson } from "@kungfu-tech/buildchain";` | `packages/core/kfd-gate.js:50` |
@@ -696,7 +696,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
696
696
  | `aggregateControllerReceipts` | function: function aggregateControllerReceipts({ plans = [], receipts = [] } = {}) | { plans = [], receipts = [] } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { aggregateControllerReceipts } from "@kungfu-tech/buildchain/core";` | `packages/core/controller-evidence.js:449` |
697
697
  | `ANCHORED_VERSION_MATERIAL_CONTRACT` | constant: const ANCHORED_VERSION_MATERIAL_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ANCHORED_VERSION_MATERIAL_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/anchored-version-material.js:15` |
698
698
  | `appendBuildchainLogEvent` | function: function appendBuildchainLogEvent(filePath, event) | filePath, event | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | local-filesystem-write | `import { appendBuildchainLogEvent } from "@kungfu-tech/buildchain/core";` | `packages/core/logging.js:67` |
699
- | `applyGitHubHousekeeperPlan` | function: async function applyGitHubHousekeeperPlan({ client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, }) | { client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, } | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { applyGitHubHousekeeperPlan } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github.js:409` |
699
+ | `applyGitHubHousekeeperPlan` | function: async function applyGitHubHousekeeperPlan({ client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, }) | { client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, } | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { applyGitHubHousekeeperPlan } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github.js:615` |
700
700
  | `applySurfaceTimestampPolicy` | function: function applySurfaceTimestampPolicy(manifest, options = {}) | manifest, options = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | may-write-or-invoke-external-actions | `import { applySurfaceTimestampPolicy } from "@kungfu-tech/buildchain/core";` | `packages/core/surface-manifest.js:79` |
701
701
  | `ARTIFACT_EVIDENCE_CONTRACT` | constant: const ARTIFACT_EVIDENCE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ARTIFACT_EVIDENCE_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:29` |
702
702
  | `ARTIFACT_PASSPORT_LOCATOR_CONTRACT` | constant: const ARTIFACT_PASSPORT_LOCATOR_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ARTIFACT_PASSPORT_LOCATOR_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/artifact-passport.js:11` |
@@ -730,7 +730,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
730
730
  | `BUILDCHAIN_CANDIDATE_TIMELINE_EVENT_CONTRACT` | constant: const BUILDCHAIN_CANDIDATE_TIMELINE_EVENT_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CANDIDATE_TIMELINE_EVENT_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/candidate-timeline.js:3` |
731
731
  | `BUILDCHAIN_CONFIG_PATH` | constant: const BUILDCHAIN_CONFIG_PATH | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONFIG_PATH } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-layout.js:7` |
732
732
  | `BUILDCHAIN_CONSUMER_ISSUE_CONTRACT` | constant: const BUILDCHAIN_CONSUMER_ISSUE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONSUMER_ISSUE_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/issue-reporting.js:4` |
733
- | `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/core";` | `packages/core/buildchain-contract.js:8` |
733
+ | `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/core";` | `packages/core/buildchain-contract.js:29` |
734
734
  | `BUILDCHAIN_CONTRACT_LOCK_PATH` | constant: const BUILDCHAIN_CONTRACT_LOCK_PATH | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONTRACT_LOCK_PATH } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-layout.js:9` |
735
735
  | `BUILDCHAIN_CONTROLLER_AGGREGATE_CONTRACT` | constant: const BUILDCHAIN_CONTROLLER_AGGREGATE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONTROLLER_AGGREGATE_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/controller-evidence.js:6` |
736
736
  | `BUILDCHAIN_CONTROLLER_DESCRIPTOR_CONTRACT` | constant: const BUILDCHAIN_CONTROLLER_DESCRIPTOR_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_CONTROLLER_DESCRIPTOR_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/controller-evidence.js:4` |
@@ -772,7 +772,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
772
772
  | `BUILDCHAIN_PROCESS_SAMPLE_SUMMARY_CONTRACT` | constant: const BUILDCHAIN_PROCESS_SAMPLE_SUMMARY_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_PROCESS_SAMPLE_SUMMARY_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/diagnostics.js:39` |
773
773
  | `BUILDCHAIN_PUBLIC_SURFACE_AUDIT_CONTRACT` | constant: const BUILDCHAIN_PUBLIC_SURFACE_AUDIT_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_PUBLIC_SURFACE_AUDIT_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/public-surface-audit.js:12` |
774
774
  | `BUILDCHAIN_RELEASE_PASSPORT_PATH` | constant: const BUILDCHAIN_RELEASE_PASSPORT_PATH | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_RELEASE_PASSPORT_PATH } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-layout.js:33` |
775
- | `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/core";` | `packages/core/buildchain-contract.js:7` |
775
+ | `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/core";` | `packages/core/buildchain-contract.js:28` |
776
776
  | `BUILDCHAIN_VERSION_PIN_PATH` | constant: const BUILDCHAIN_VERSION_PIN_PATH | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_VERSION_PIN_PATH } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-layout.js:5` |
777
777
  | `BUILDCHAIN_WORKFLOW_FRICTION_ISSUE_CONTRACT` | constant: const BUILDCHAIN_WORKFLOW_FRICTION_ISSUE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { BUILDCHAIN_WORKFLOW_FRICTION_ISSUE_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/issue-reporting.js:5` |
778
778
  | `buildchainKfdClaims` | constant: const buildchainKfdClaims | none | value | Import does not declare a throw contract. | none-on-import | `import { buildchainKfdClaims } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd.js:896` |
@@ -788,9 +788,9 @@ Target: `./packages/core/index.js`. Public symbols: 609.
788
788
  | `checkKfd2ProductClaimOutputs` | function: function checkKfd2ProductClaimOutputs(options = {}) | options = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { checkKfd2ProductClaimOutputs } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd2-product-claims.js:415` |
789
789
  | `checkReadmeBadgeBlock` | function: function checkReadmeBadgeBlock({ readmeText, facts } = {}) | { readmeText, facts } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { checkReadmeBadgeBlock } from "@kungfu-tech/buildchain/core";` | `packages/core/readme-badges.js:848` |
790
790
  | `claimReleasePropagationWork` | function: function claimReleasePropagationWork({ work, expectedWorkRoot, authority, familyState, } = {}) | { work, expectedWorkRoot, authority, familyState, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { claimReleasePropagationWork } from "@kungfu-tech/buildchain/core";` | `packages/core/release-propagation-work-transitions.js:17` |
791
- | `classifyHousekeeperBranch` | function: function classifyHousekeeperBranch(branch, policyInput = {}) | branch, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperBranch } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:92` |
792
- | `classifyHousekeeperPullRequest` | function: function classifyHousekeeperPullRequest(pullRequest, policyInput = {}) | pullRequest, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperPullRequest } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:129` |
793
- | `classifyHousekeeperReplay` | function: function classifyHousekeeperReplay(plan, priorReceipt) | plan, priorReceipt | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperReplay } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:250` |
791
+ | `classifyHousekeeperBranch` | function: function classifyHousekeeperBranch(branch, policyInput = {}) | branch, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperBranch } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:105` |
792
+ | `classifyHousekeeperPullRequest` | function: function classifyHousekeeperPullRequest(pullRequest, policyInput = {}) | pullRequest, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperPullRequest } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:144` |
793
+ | `classifyHousekeeperReplay` | function: function classifyHousekeeperReplay(plan, priorReceipt) | plan, priorReceipt | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperReplay } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:265` |
794
794
  | `classifyProcessCommand` | function: function classifyProcessCommand(command = "") | command = "" | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyProcessCommand } from "@kungfu-tech/buildchain/core";` | `packages/core/diagnostics.js:1090` |
795
795
  | `classifyReleasePropagationCondition` | function: function classifyReleasePropagationCondition(condition) | condition | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { classifyReleasePropagationCondition } from "@kungfu-tech/buildchain/core";` | `packages/core/release-propagation-agent-entry.js:171` |
796
796
  | `codeownersForPath` | function: function codeownersForPath(source, candidatePath) | source, candidatePath | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { codeownersForPath } from "@kungfu-tech/buildchain/core";` | `packages/core/github-governance-authority.js:417` |
@@ -799,7 +799,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
799
799
  | `collectCacheDiagnostics` | function: function collectCacheDiagnostics({ cwd = process.cwd(), cacheDirs = [], runCommand = defaultDiagnosticCommandRunner } = {}) | { cwd = process.cwd(), cacheDirs = [], runCommand = defaultDiagnosticCommandRunner } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectCacheDiagnostics } from "@kungfu-tech/buildchain/core";` | `packages/core/diagnostics.js:927` |
800
800
  | `collectCompilerCacheDiagnostics` | function: function collectCompilerCacheDiagnostics({ cwd = process.cwd(), runCommand = defaultDiagnosticCommandRunner, env = process.env, } = {}) | { cwd = process.cwd(), runCommand = defaultDiagnosticCommandRunner, env = process.env, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectCompilerCacheDiagnostics } from "@kungfu-tech/buildchain/core";` | `packages/core/diagnostics.js:578` |
801
801
  | `collectGitDiagnostics` | function: function collectGitDiagnostics({ cwd = process.cwd() } = {}) | { cwd = process.cwd() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectGitDiagnostics } from "@kungfu-tech/buildchain/core";` | `packages/core/diagnostics.js:949` |
802
- | `collectGitHubHousekeeperInventory` | function: async function collectGitHubHousekeeperInventory({ client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, }) | { client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, } | Promise<unknown> | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { collectGitHubHousekeeperInventory } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github.js:110` |
802
+ | `collectGitHubHousekeeperInventory` | function: async function collectGitHubHousekeeperInventory({ client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, }) | { client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, } | Promise<unknown> | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { collectGitHubHousekeeperInventory } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github.js:246` |
803
803
  | `collectGitHubReleasePassport` | function: function collectGitHubReleasePassport({ cwd = process.cwd(), tag = "", repository = process.env.GITHUB_REPOSITORY \|\| "", sourceSha = process.env.GITHUB_SHA \|\| "", line = "", outputDir = ".buildchain/release-passport", assetsJson = "", assetsDir = "", kfdArtifactSearchRoots = [], releaseJson = "", productName = "Buildchain", packageName = "@kungfu-tech/buildchain", packageVersion = "", packageSetJson = "", publishEvidenceJson = "", trustedPublishingJson = "", transactionJson = "", anchorManifestJson = "", versionMaterialJson = "", impactJson = "", buildSummaryJson = "", buildFactsJsons = [], platformManifestJsons = [], distTagEvidenceJson = "", kfd1WitnessJsons = [], kfd2ClaimJsons = [], kfd3PrebuildWitnessJsons = [], kfd3ArtifactWitnessJsons = [], kfd3ArtifactVerifyCommand = "", kfdSupportMatrixJson = "", kfdProductGateJsons = [], invariantPassportJsons = [], invariantPassportCommand = "", releaseEvidenceJsons = [], kfdAgentHubEvidenceJson = "", controllerReceiptReferences = [], githubArtifactAttestationPolicyJsons = [], basePassportJson = "", requireBaseKfd = false, releaseJsonExtra = "", publishJson = "", workflow = {}, checkedAt = "", } = {}) | { cwd = process.cwd(), tag = "", repository = process.env.GITHUB_REPOSITORY \|\| "", sourceSha = process.env.GITHUB_SHA \|\| "", line = "", outputDir = ".buildchain/release-passport", assetsJson = "", assetsDir = "", kfdArtifactSearchRoots = [], releaseJson = "", productName = "Buildchain", packageName = "@kungfu-tech/buildchain", packageVersion = "", packageSetJson = "", publishEvidenceJson = "", trustedPublishingJson = "", transactionJson = "", anchorManifestJson = "", versionMaterialJson = "", impactJson = "", buildSummaryJson = "", buildFactsJsons = [], platformManifestJsons = [], distTagEvidenceJson = "", kfd1WitnessJsons = [], kfd2ClaimJsons = [], kfd3PrebuildWitnessJsons = [], kfd3ArtifactWitnessJsons = [], kfd3ArtifactVerifyCommand = "", kfdSupportMatrixJson = "", kfdProductGateJsons = [], invariantPassportJsons = [], invariantPassportCommand = "", releaseEvidenceJsons = [], kfdAgentHubEvidenceJson = "", controllerReceiptReferences = [], githubArtifactAttestationPolicyJsons = [], basePassportJson = "", requireBaseKfd = false, releaseJsonExtra = "", publishJson = "", workflow = {}, checkedAt = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | local-filesystem-write | `import { collectGitHubReleasePassport } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:1563` |
804
804
  | `collectGitSourceFacts` | function: function collectGitSourceFacts({ cwd = process.cwd(), root = "." } = {}) | { cwd = process.cwd(), root = "." } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectGitSourceFacts } from "@kungfu-tech/buildchain/core";` | `packages/core/build-facts.js:146` |
805
805
  | `collectHomebrewTapFacts` | function: async function collectHomebrewTapFacts({ cwd = process.cwd(), packageName = "buildchain", releasePassport = "", manifestPath = DEFAULT_MANIFEST_PATH, formulaPath = "", } = {}) | { cwd = process.cwd(), packageName = "buildchain", releasePassport = "", manifestPath = DEFAULT_MANIFEST_PATH, formulaPath = "", } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectHomebrewTapFacts } from "@kungfu-tech/buildchain/core";` | `packages/core/homebrew.js:223` |
@@ -826,7 +826,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
826
826
  | `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` |
827
827
  | `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` |
828
828
  | `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` |
829
- | `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-contract.js:973` |
829
+ | `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:359` |
830
830
  | `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:151` |
831
831
  | `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` |
832
832
  | `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` |
@@ -834,8 +834,8 @@ Target: `./packages/core/index.js`. Public symbols: 609.
834
834
  | `createArtifactSigningReceipt` | function: function createArtifactSigningReceipt({ request, status = "passed", authority = {}, result = {}, signatures = [], reason = "", } = {}) | { request, status = "passed", authority = {}, result = {}, signatures = [], reason = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createArtifactSigningReceipt } from "@kungfu-tech/buildchain/core";` | `packages/core/artifact-signing.js:374` |
835
835
  | `createArtifactSigningRequest` | function: function createArtifactSigningRequest({ source = {}, runtime = {}, artifact = {}, signature = {}, delivery = {}, } = {}) | { source = {}, runtime = {}, artifact = {}, signature = {}, delivery = {}, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createArtifactSigningRequest } from "@kungfu-tech/buildchain/core";` | `packages/core/artifact-signing.js:226` |
836
836
  | `createArtifactSigningResult` | function: function createArtifactSigningResult({ request, receipt, receiptPath = "receipt.json", payload = {}, evidence = [], verification = {}, } = {}) | { request, receipt, receiptPath = "receipt.json", payload = {}, evidence = [], verification = {}, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createArtifactSigningResult } from "@kungfu-tech/buildchain/core";` | `packages/core/artifact-signing-result.js:68` |
837
- | `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/core";` | `packages/core/buildchain-contract.js:815` |
838
- | `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/core";` | `packages/core/buildchain-contract.js:110` |
837
+ | `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/core";` | `packages/core/buildchain-contract.js:839` |
838
+ | `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/core";` | `packages/core/buildchain-contract.js:130` |
839
839
  | `createBuildchainGithubGovernanceAuthority` | function: function createBuildchainGithubGovernanceAuthority() | none | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createBuildchainGithubGovernanceAuthority } from "@kungfu-tech/buildchain/core";` | `packages/core/github-governance-authority.js:450` |
840
840
  | `createBuildchainKfd1Witness` | function: function createBuildchainKfd1Witness({ root = process.cwd(), sourceSha = "" } = {}) | { root = process.cwd(), sourceSha = "" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createBuildchainKfd1Witness } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-kfd-claims.js:530` |
841
841
  | `createBuildchainKfd2Claims` | function: function createBuildchainKfd2Claims({ root = process.cwd(), witnessFiles = {} } = {}) | { root = process.cwd(), witnessFiles = {} } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createBuildchainKfd2Claims } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-kfd-claims.js:687` |
@@ -856,8 +856,8 @@ Target: `./packages/core/index.js`. Public symbols: 609.
856
856
  | `createControllerReceiptReference` | function: function createControllerReceiptReference(receipt) | receipt | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createControllerReceiptReference } from "@kungfu-tech/buildchain/core";` | `packages/core/controller-evidence.js:491` |
857
857
  | `createControllerRegistry` | function: function createControllerRegistry({ workflows = [] } = {}) | { workflows = [] } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createControllerRegistry } from "@kungfu-tech/buildchain/core";` | `packages/core/controller-evidence.js:197` |
858
858
  | `createDiagnosticsArtifact` | function: function createDiagnosticsArtifact({ cwd = process.cwd(), logPath = "", artifactPaths = [], cacheDirs = [], lifecycleObservability = undefined, processSamples = [], processSummary = undefined, requestedParallelism = 0, sourceCheckout = undefined, compilerCachePreparation = undefined, links = {}, } = {}) | { cwd = process.cwd(), logPath = "", artifactPaths = [], cacheDirs = [], lifecycleObservability = undefined, processSamples = [], processSummary = undefined, requestedParallelism = 0, sourceCheckout = undefined, compilerCachePreparation = undefined, links = {}, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createDiagnosticsArtifact } from "@kungfu-tech/buildchain/core";` | `packages/core/diagnostics.js:1413` |
859
- | `createEngineeringHousekeeperPlan` | function: function createEngineeringHousekeeperPlan({ repository, target, branches = [], pullRequests = [], policy = {}, observedAt, }) | { repository, target, branches = [], pullRequests = [], policy = {}, observedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperPlan } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:155` |
860
- | `createEngineeringHousekeeperReceipt` | function: function createEngineeringHousekeeperReceipt({ plan, outcomes, appliedAt, }) | { plan, outcomes, appliedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperReceipt } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:231` |
859
+ | `createEngineeringHousekeeperPlan` | function: function createEngineeringHousekeeperPlan({ repository, target, branches = [], pullRequests = [], policy = {}, observedAt, }) | { repository, target, branches = [], pullRequests = [], policy = {}, observedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperPlan } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:170` |
860
+ | `createEngineeringHousekeeperReceipt` | function: function createEngineeringHousekeeperReceipt({ plan, outcomes, appliedAt, }) | { plan, outcomes, appliedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperReceipt } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:246` |
861
861
  | `createGitHubArtifactAttestationEvidence` | function: function createGitHubArtifactAttestationEvidence({ preparation, attestationId, attestationUrl, bundlePath, workflow = {}, } = {}) | { preparation, attestationId, attestationUrl, bundlePath, workflow = {}, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createGitHubArtifactAttestationEvidence } from "@kungfu-tech/buildchain/core";` | `packages/core/github-artifact-attestation.js:474` |
862
862
  | `createGitHubArtifactAttestationPolicy` | function: function createGitHubArtifactAttestationPolicy(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 { createGitHubArtifactAttestationPolicy } from "@kungfu-tech/buildchain/core";` | `packages/core/github-artifact-attestation.js:204` |
863
863
  | `createGitHubArtifactAttestationVerificationPlan` | function: function createGitHubArtifactAttestationVerificationPlan({ artifactPath, bundlePath, evidence, } = {}) | { artifactPath, bundlePath, evidence, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createGitHubArtifactAttestationVerificationPlan } from "@kungfu-tech/buildchain/core";` | `packages/core/github-artifact-attestation.js:524` |
@@ -916,7 +916,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
916
916
  | `createWebSurfacePublicationCandidate` | function: function createWebSurfacePublicationCandidate({ repository, sourceSha, sourceTreeSha, runtimeSha, plan, planFileDigest, controllerReceipt, decision, } = {}) | { repository, sourceSha, sourceTreeSha, runtimeSha, plan, planFileDigest, controllerReceipt, decision, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createWebSurfacePublicationCandidate } from "@kungfu-tech/buildchain/core";` | `packages/core/web-surface-publication-candidate.js:79` |
917
917
  | `decideChannelCandidate` | function: function decideChannelCandidate(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 { decideChannelCandidate } from "@kungfu-tech/buildchain/core";` | `packages/core/channel-candidate.js:91` |
918
918
  | `DEFAULT_BUILDCHAIN_ISSUE_REPOSITORY` | constant: const DEFAULT_BUILDCHAIN_ISSUE_REPOSITORY | none | value | Import does not declare a throw contract. | none-on-import | `import { DEFAULT_BUILDCHAIN_ISSUE_REPOSITORY } from "@kungfu-tech/buildchain/core";` | `packages/core/issue-reporting.js:6` |
919
- | `DEFAULT_HOUSEKEEPER_POLICY` | constant: const DEFAULT_HOUSEKEEPER_POLICY | none | value | Import does not declare a throw contract. | none-on-import | `import { DEFAULT_HOUSEKEEPER_POLICY } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:28` |
919
+ | `DEFAULT_HOUSEKEEPER_POLICY` | constant: const DEFAULT_HOUSEKEEPER_POLICY | none | value | Import does not declare a throw contract. | none-on-import | `import { DEFAULT_HOUSEKEEPER_POLICY } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:29` |
920
920
  | `defaultBuildchainLogPath` | function: function defaultBuildchainLogPath({ cwd = process.cwd() } = {}) | { cwd = process.cwd() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { defaultBuildchainLogPath } from "@kungfu-tech/buildchain/core";` | `packages/core/logging.js:41` |
921
921
  | `defaultPublishEvidencePath` | function: function defaultPublishEvidencePath(version, workspace = process.cwd()) | version, workspace = process.cwd() | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { defaultPublishEvidencePath } from "@kungfu-tech/buildchain/core";` | `packages/core/publish-transaction.js:193` |
922
922
  | `defaultReleaseStatePath` | function: function defaultReleaseStatePath(version, workspace = process.cwd()) | version, workspace = process.cwd() | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { defaultReleaseStatePath } from "@kungfu-tech/buildchain/core";` | `packages/core/publish-transaction.js:185` |
@@ -936,13 +936,13 @@ Target: `./packages/core/index.js`. Public symbols: 609.
936
936
  | `discoverPaperFleet` | function: function discoverPaperFleet(root = process.cwd()) | root = process.cwd() | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { discoverPaperFleet } from "@kungfu-tech/buildchain/core";` | `packages/core/paper-fleet.js:23` |
937
937
  | `ENGINEERING_HOUSEKEEPER_CONTRACT` | constant: const ENGINEERING_HOUSEKEEPER_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ENGINEERING_HOUSEKEEPER_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:3` |
938
938
  | `ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION` | constant: const ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION | none | value | Import does not declare a throw contract. | none-on-import | `import { ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:5` |
939
- | `engineeringHousekeeperRoot` | function: function engineeringHousekeeperRoot(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { engineeringHousekeeperRoot } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:49` |
939
+ | `engineeringHousekeeperRoot` | function: function engineeringHousekeeperRoot(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { engineeringHousekeeperRoot } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:58` |
940
940
  | `enumerateActionInputs` | function: function enumerateActionInputs({ 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 { enumerateActionInputs } from "@kungfu-tech/buildchain/core";` | `packages/core/public-surface-audit.js:91` |
941
941
  | `enumerateCliCommandsFromBin` | function: function enumerateCliCommandsFromBin({ root = process.cwd(), binPath = "bin/buildchain.mjs", } = {}) | { root = process.cwd(), binPath = "bin/buildchain.mjs", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { enumerateCliCommandsFromBin } from "@kungfu-tech/buildchain/core";` | `packages/core/public-surface-cli.js:93` |
942
942
  | `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` |
943
943
  | `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` |
944
944
  | `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` |
945
- | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {} | 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-contract.js:881` |
945
+ | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {} | 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:440` |
946
946
  | `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` |
947
947
  | `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` |
948
948
  | `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:465` |
@@ -957,10 +957,10 @@ Target: `./packages/core/index.js`. Public symbols: 609.
957
957
  | `explainReleaseLineDryRun` | function: function explainReleaseLineDryRun({ cwd = process.cwd(), targetRef, sha = "", sourceRef = "", tags, publishTransaction = false, publishCommand = "", } = {}) | { cwd = process.cwd(), targetRef, sha = "", sourceRef = "", tags, publishTransaction = false, publishCommand = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { explainReleaseLineDryRun } from "@kungfu-tech/buildchain/core";` | `packages/core/release-line-dry-run.js:127` |
958
958
  | `explainReleasePassport` | function: async function explainReleasePassport({ passportLocation, forAudience = "human" } = {}) | { passportLocation, forAudience = "human" } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { explainReleasePassport } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:2922` |
959
959
  | `FAMILY_RELEASE_EVIDENCE_CONTRACT` | constant: const FAMILY_RELEASE_EVIDENCE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { FAMILY_RELEASE_EVIDENCE_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/release-candidate.js:5` |
960
- | `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/core";` | `packages/core/buildchain-contract.js:790` |
960
+ | `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/core";` | `packages/core/buildchain-contract.js:794` |
961
961
  | `formatCandidateTimelineReport` | function: function formatCandidateTimelineReport(timeline) | timeline | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatCandidateTimelineReport } from "@kungfu-tech/buildchain/core";` | `packages/core/candidate-timeline.js:438` |
962
962
  | `formatDiagnosticsSummaryTable` | function: function formatDiagnosticsSummaryTable(summary = {}) | summary = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatDiagnosticsSummaryTable } from "@kungfu-tech/buildchain/core";` | `packages/core/diagnostics.js:1791` |
963
- | `formatGitHubHousekeeperPlan` | function: function formatGitHubHousekeeperPlan(plan) | plan | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatGitHubHousekeeperPlan } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github.js:491` |
963
+ | `formatGitHubHousekeeperPlan` | function: function formatGitHubHousekeeperPlan(plan) | plan | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatGitHubHousekeeperPlan } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github.js:697` |
964
964
  | `formatReleaseLineDryRun` | function: function formatReleaseLineDryRun(plan) | plan | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatReleaseLineDryRun } from "@kungfu-tech/buildchain/core";` | `packages/core/release-line-dry-run.js:267` |
965
965
  | `getLifecycleStage` | function: function getLifecycleStage(loadedConfig, name) | loadedConfig, name | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { getLifecycleStage } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-config.js:1432` |
966
966
  | `getNativeDiagnosticsProfile` | function: function getNativeDiagnosticsProfile(loadedConfig) | loadedConfig | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { getNativeDiagnosticsProfile } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-config.js:585` |
@@ -983,8 +983,8 @@ Target: `./packages/core/index.js`. Public symbols: 609.
983
983
  | `githubArtifactAttestationSha256Buffer` | function: function githubArtifactAttestationSha256Buffer(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { githubArtifactAttestationSha256Buffer } from "@kungfu-tech/buildchain/core";` | `packages/core/github-artifact-attestation.js:83` |
984
984
  | `githubArtifactAttestationSha256File` | function: function githubArtifactAttestationSha256File(filePath) | filePath | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { githubArtifactAttestationSha256File } from "@kungfu-tech/buildchain/core";` | `packages/core/github-artifact-attestation.js:87` |
985
985
  | `githubGovernanceDigest` | function: function githubGovernanceDigest(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 { githubGovernanceDigest } from "@kungfu-tech/buildchain/core";` | `packages/core/github-governance-authority.js:163` |
986
- | `GitHubHousekeeperClient` | class: class GitHubHousekeeperClient | none | GitHubHousekeeperClient | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperClient } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github-client.js:53` |
987
- | `GitHubHousekeeperProviderError` | class: class GitHubHousekeeperProviderError | none | GitHubHousekeeperProviderError | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperProviderError } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github-client.js:36` |
986
+ | `GitHubHousekeeperClient` | class: class GitHubHousekeeperClient | none | GitHubHousekeeperClient | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperClient } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github-client.js:54` |
987
+ | `GitHubHousekeeperProviderError` | class: class GitHubHousekeeperProviderError | none | GitHubHousekeeperProviderError | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperProviderError } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github-client.js:37` |
988
988
  | `GitHubIssueRequestError` | class: class GitHubIssueRequestError | none | GitHubIssueRequestError | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubIssueRequestError } from "@kungfu-tech/buildchain/core";` | `packages/core/issue-reporting.js:23` |
989
989
  | `githubReleaseAssetsTargetRoot` | function: function githubReleaseAssetsTargetRoot({ destination, artifacts }) | { destination, artifacts } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { githubReleaseAssetsTargetRoot } from "@kungfu-tech/buildchain/core";` | `packages/core/release-tail-provider-adapters.js:297` |
990
990
  | `HOMEBREW_TAP_CHECK_CONTRACT` | constant: const HOMEBREW_TAP_CHECK_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { HOMEBREW_TAP_CHECK_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/homebrew.js:6` |
@@ -1117,8 +1117,8 @@ Target: `./packages/core/index.js`. Public symbols: 609.
1117
1117
  | `publicationGateAggregateBindings` | function: function publicationGateAggregateBindings(gateAggregate) | gateAggregate | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { publicationGateAggregateBindings } from "@kungfu-tech/buildchain/core";` | `packages/core/publication-authority.js:408` |
1118
1118
  | `qualifyStableCandidate` | function: function qualifyStableCandidate(ledgerInput, observation, { minimumSoakSeconds = 3600, now = new Date().toISOString() } = {}) | ledgerInput, observation, { minimumSoakSeconds = 3600, now = new Date().toISOString() } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | may-write-or-invoke-external-actions | `import { qualifyStableCandidate } from "@kungfu-tech/buildchain/core";` | `packages/core/stable-candidate-ledger.js:139` |
1119
1119
  | `queryKfd3Capabilities` | function: async function queryKfd3Capabilities({ cwd = process.cwd(), product = "", registryPath = "", passportLocation = "", artifactPath = "", } = {}) | { cwd = process.cwd(), product = "", registryPath = "", passportLocation = "", artifactPath = "", } = {} | Promise<unknown> | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { queryKfd3Capabilities } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd3-surface-register.js:824` |
1120
- | `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/core";` | `packages/core/buildchain-contract.js:866` |
1121
- | `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/core";` | `packages/core/buildchain-contract.js:846` |
1120
+ | `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/core";` | `packages/core/buildchain-contract.js:893` |
1121
+ | `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/core";` | `packages/core/buildchain-contract.js:872` |
1122
1122
  | `readBuildchainLogEvents` | function: function readBuildchainLogEvents(filePath) | filePath | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { readBuildchainLogEvents } from "@kungfu-tech/buildchain/core";` | `packages/core/logging.js:75` |
1123
1123
  | `readDiagnosticsArtifact` | function: function readDiagnosticsArtifact(filePath) | filePath | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { readDiagnosticsArtifact } from "@kungfu-tech/buildchain/core";` | `packages/core/diagnostics.js:1473` |
1124
1124
  | `readJsonFromLocation` | function: async function readJsonFromLocation(location, redirectCount = 0, { timeoutMs = 15_000 } = {}) | location, redirectCount = 0, { timeoutMs = 15_000 } = {} | Promise<unknown> | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { readJsonFromLocation } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:2804` |
@@ -1182,7 +1182,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
1182
1182
  | `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` |
1183
1183
  | `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` |
1184
1184
  | `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` |
1185
- | `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-contract.js:985` |
1185
+ | `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:560` |
1186
1186
  | `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` |
1187
1187
  | `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` |
1188
1188
  | `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` |
@@ -1204,10 +1204,10 @@ Target: `./packages/core/index.js`. Public symbols: 609.
1204
1204
  | `resolvePublicationCandidateFile` | function: function resolvePublicationCandidateFile(files = [], candidatePath) | files = [], candidatePath | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { resolvePublicationCandidateFile } from "@kungfu-tech/buildchain/core";` | `packages/core/publication-artifact-candidate.js:23` |
1205
1205
  | `resolveReleasePassportPath` | function: function resolveReleasePassportPath(cwd = process.cwd()) | cwd = process.cwd() | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { resolveReleasePassportPath } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-layout.js:92` |
1206
1206
  | `resumeReleasePropagationWork` | function: function resumeReleasePropagationWork(work) | work | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { resumeReleasePropagationWork } from "@kungfu-tech/buildchain/core";` | `packages/core/release-propagation-work.js:518` |
1207
- | `revalidateHousekeeperBranchAction` | function: function revalidateHousekeeperBranchAction(action, current, policy = {}) | action, current, policy = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { revalidateHousekeeperBranchAction } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:208` |
1207
+ | `revalidateHousekeeperBranchAction` | function: function revalidateHousekeeperBranchAction(action, current, policy = {}) | action, current, policy = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { revalidateHousekeeperBranchAction } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper.js:223` |
1208
1208
  | `revokeStableCandidate` | function: function revokeStableCandidate(ledgerInput, versionInput, { reason, actor = "", now = new Date().toISOString() } = {}) | ledgerInput, versionInput, { reason, actor = "", now = new Date().toISOString() } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | may-write-or-invoke-external-actions | `import { revokeStableCandidate } from "@kungfu-tech/buildchain/core";` | `packages/core/stable-candidate-ledger.js:185` |
1209
1209
  | `rollbackReleaseActivationTransaction` | function: function rollbackReleaseActivationTransaction(transaction, { toSiteSourceSha, reason } = {}) | transaction, { toSiteSourceSha, reason } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | may-write-or-invoke-external-actions | `import { rollbackReleaseActivationTransaction } from "@kungfu-tech/buildchain/core";` | `packages/core/release-activation-transaction.js:290` |
1210
- | `runGitHubHousekeeper` | function: async function runGitHubHousekeeper(options) | options | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { runGitHubHousekeeper } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github.js:485` |
1210
+ | `runGitHubHousekeeper` | function: async function runGitHubHousekeeper(options) | options | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { runGitHubHousekeeper } from "@kungfu-tech/buildchain/core";` | `packages/core/engineering-housekeeper-github.js:691` |
1211
1211
  | `runLifecycleStage` | function: function runLifecycleStage({ cwd = process.cwd(), loadedConfig, name, stage, env: extraEnv, timeoutMinutes }) | { cwd = process.cwd(), loadedConfig, name, stage, env: extraEnv, timeoutMinutes } | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | subprocess | `import { runLifecycleStage } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-config.js:1440` |
1212
1212
  | `RUNNER_PROVENANCE_CLASSES` | constant: const RUNNER_PROVENANCE_CLASSES | none | value | Import does not declare a throw contract. | none-on-import | `import { RUNNER_PROVENANCE_CLASSES } from "@kungfu-tech/buildchain/core";` | `packages/core/publication-authority.js:36` |
1213
1213
  | `RUNNER_PROVENANCE_CONTRACT` | constant: const RUNNER_PROVENANCE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { RUNNER_PROVENANCE_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/publication-authority.js:14` |
@@ -1215,7 +1215,7 @@ Target: `./packages/core/index.js`. Public symbols: 609.
1215
1215
  | `sealArtifactVerificationReport` | function: function sealArtifactVerificationReport({ report, bindings, kfdAssessment, issuedAt, expiresAt, revocation, } = {}) | { report, bindings, kfdAssessment, issuedAt, expiresAt, revocation, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { sealArtifactVerificationReport } from "@kungfu-tech/buildchain/core";` | `packages/core/artifact-verification-envelope.js:314` |
1216
1216
  | `selectStableCandidate` | function: function selectStableCandidate(ledgerInput, { releaseNow = "", now = new Date().toISOString() } = {}) | ledgerInput, { releaseNow = "", now = new Date().toISOString() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { selectStableCandidate } from "@kungfu-tech/buildchain/core";` | `packages/core/stable-candidate-ledger.js:206` |
1217
1217
  | `setStableCandidateHold` | function: function setStableCandidateHold(ledgerInput, enabled, { reason = "", now = new Date().toISOString() } = {}) | ledgerInput, enabled, { reason = "", now = new Date().toISOString() } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | may-write-or-invoke-external-actions | `import { setStableCandidateHold } from "@kungfu-tech/buildchain/core";` | `packages/core/stable-candidate-ledger.js:198` |
1218
- | `sha256BuildchainContractJson` | 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 { sha256BuildchainContractJson } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-contract.js:30` |
1218
+ | `sha256BuildchainContractJson` | 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 { sha256BuildchainContractJson } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-contract.js:50` |
1219
1219
  | `sha256File` | function: function sha256File(filePath) | filePath | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | local-filesystem-write, subprocess | `import { sha256File } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:243` |
1220
1220
  | `sha256Json` | function: function sha256Json(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 { sha256Json } from "@kungfu-tech/buildchain/core";` | `packages/core/release-candidate.js:90` |
1221
1221
  | `sha256KfdJson` | 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 { sha256KfdJson } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd-gate.js:50` |
@@ -1406,22 +1406,32 @@ Target: `./packages/core/anchored-version-material.js`. Public symbols: 2.
1406
1406
 
1407
1407
  ## `@kungfu-tech/buildchain/buildchain-contract`
1408
1408
 
1409
- Target: `./packages/core/buildchain-contract.js`. Public symbols: 12.
1409
+ Target: `./packages/core/buildchain-contract.js`. Public symbols: 22.
1410
1410
 
1411
1411
  | Symbol | Kind and signature | Parameters | Return | Errors | Side effects | Example | Source |
1412
1412
  | --- | --- | --- | --- | --- | --- | --- | --- |
1413
- | `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:8` |
1414
- | `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:7` |
1415
- | `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-contract.js:973` |
1416
- | `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:815` |
1417
- | `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:110` |
1418
- | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {} | 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-contract.js:881` |
1419
- | `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:790` |
1420
- | `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:866` |
1421
- | `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:846` |
1422
- | `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-contract.js:985` |
1423
- | `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:34` |
1424
- | `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:30` |
1413
+ | `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:276` |
1414
+ | `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:12` |
1415
+ | `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:11` |
1416
+ | `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:13` |
1417
+ | `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:29` |
1418
+ | `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:28` |
1419
+ | `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:359` |
1420
+ | `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:157` |
1421
+ | `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:252` |
1422
+ | `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:322` |
1423
+ | `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:839` |
1424
+ | `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:130` |
1425
+ | `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:229` |
1426
+ | `evaluateBuildchainContractLock` | function: function evaluateBuildchainContractLock({ lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {}) | { lock, current, runtimeRef = "", runtimeSha = "", runtimeClass = "", compatibilityPolicy = "", } = {} | 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:440` |
1427
+ | `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:794` |
1428
+ | `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:893` |
1429
+ | `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:872` |
1430
+ | `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:560` |
1431
+ | `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:54` |
1432
+ | `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:50` |
1433
+ | `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:205` |
1434
+ | `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:346` |
1425
1435
 
1426
1436
  ## `@kungfu-tech/buildchain/candidate-timeline`
1427
1437
 
@@ -1966,17 +1976,17 @@ Target: `./packages/core/engineering-housekeeper.js`. Public symbols: 11.
1966
1976
 
1967
1977
  | Symbol | Kind and signature | Parameters | Return | Errors | Side effects | Example | Source |
1968
1978
  | --- | --- | --- | --- | --- | --- | --- | --- |
1969
- | `classifyHousekeeperBranch` | function: function classifyHousekeeperBranch(branch, policyInput = {}) | branch, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperBranch } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:92` |
1970
- | `classifyHousekeeperPullRequest` | function: function classifyHousekeeperPullRequest(pullRequest, policyInput = {}) | pullRequest, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperPullRequest } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:129` |
1971
- | `classifyHousekeeperReplay` | function: function classifyHousekeeperReplay(plan, priorReceipt) | plan, priorReceipt | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperReplay } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:250` |
1972
- | `createEngineeringHousekeeperPlan` | function: function createEngineeringHousekeeperPlan({ repository, target, branches = [], pullRequests = [], policy = {}, observedAt, }) | { repository, target, branches = [], pullRequests = [], policy = {}, observedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperPlan } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:155` |
1973
- | `createEngineeringHousekeeperReceipt` | function: function createEngineeringHousekeeperReceipt({ plan, outcomes, appliedAt, }) | { plan, outcomes, appliedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperReceipt } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:231` |
1974
- | `DEFAULT_HOUSEKEEPER_POLICY` | constant: const DEFAULT_HOUSEKEEPER_POLICY | none | value | Import does not declare a throw contract. | none-on-import | `import { DEFAULT_HOUSEKEEPER_POLICY } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:28` |
1979
+ | `classifyHousekeeperBranch` | function: function classifyHousekeeperBranch(branch, policyInput = {}) | branch, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperBranch } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:105` |
1980
+ | `classifyHousekeeperPullRequest` | function: function classifyHousekeeperPullRequest(pullRequest, policyInput = {}) | pullRequest, policyInput = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperPullRequest } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:144` |
1981
+ | `classifyHousekeeperReplay` | function: function classifyHousekeeperReplay(plan, priorReceipt) | plan, priorReceipt | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { classifyHousekeeperReplay } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:265` |
1982
+ | `createEngineeringHousekeeperPlan` | function: function createEngineeringHousekeeperPlan({ repository, target, branches = [], pullRequests = [], policy = {}, observedAt, }) | { repository, target, branches = [], pullRequests = [], policy = {}, observedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperPlan } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:170` |
1983
+ | `createEngineeringHousekeeperReceipt` | function: function createEngineeringHousekeeperReceipt({ plan, outcomes, appliedAt, }) | { plan, outcomes, appliedAt, } | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createEngineeringHousekeeperReceipt } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:246` |
1984
+ | `DEFAULT_HOUSEKEEPER_POLICY` | constant: const DEFAULT_HOUSEKEEPER_POLICY | none | value | Import does not declare a throw contract. | none-on-import | `import { DEFAULT_HOUSEKEEPER_POLICY } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:29` |
1975
1985
  | `ENGINEERING_HOUSEKEEPER_CONTRACT` | constant: const ENGINEERING_HOUSEKEEPER_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ENGINEERING_HOUSEKEEPER_CONTRACT } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:3` |
1976
1986
  | `ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION` | constant: const ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION | none | value | Import does not declare a throw contract. | none-on-import | `import { ENGINEERING_HOUSEKEEPER_SCHEMA_VERSION } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:5` |
1977
- | `engineeringHousekeeperRoot` | function: function engineeringHousekeeperRoot(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { engineeringHousekeeperRoot } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:49` |
1987
+ | `engineeringHousekeeperRoot` | function: function engineeringHousekeeperRoot(value) | value | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { engineeringHousekeeperRoot } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:58` |
1978
1988
  | `HOUSEKEEPER_REASON_CODES` | constant: const HOUSEKEEPER_REASON_CODES | none | value | Import does not declare a throw contract. | none-on-import | `import { HOUSEKEEPER_REASON_CODES } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:7` |
1979
- | `revalidateHousekeeperBranchAction` | function: function revalidateHousekeeperBranchAction(action, current, policy = {}) | action, current, policy = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { revalidateHousekeeperBranchAction } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:208` |
1989
+ | `revalidateHousekeeperBranchAction` | function: function revalidateHousekeeperBranchAction(action, current, policy = {}) | action, current, policy = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { revalidateHousekeeperBranchAction } from "@kungfu-tech/buildchain/engineering-housekeeper";` | `packages/core/engineering-housekeeper.js:223` |
1980
1990
 
1981
1991
  ## `@kungfu-tech/buildchain/engineering-housekeeper-github`
1982
1992
 
@@ -1984,12 +1994,12 @@ Target: `./packages/core/engineering-housekeeper-github.js`. Public symbols: 6.
1984
1994
 
1985
1995
  | Symbol | Kind and signature | Parameters | Return | Errors | Side effects | Example | Source |
1986
1996
  | --- | --- | --- | --- | --- | --- | --- | --- |
1987
- | `applyGitHubHousekeeperPlan` | function: async function applyGitHubHousekeeperPlan({ client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, }) | { client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, } | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { applyGitHubHousekeeperPlan } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github.js:409` |
1988
- | `collectGitHubHousekeeperInventory` | function: async function collectGitHubHousekeeperInventory({ client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, }) | { client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, } | Promise<unknown> | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { collectGitHubHousekeeperInventory } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github.js:110` |
1989
- | `formatGitHubHousekeeperPlan` | function: function formatGitHubHousekeeperPlan(plan) | plan | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatGitHubHousekeeperPlan } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github.js:491` |
1990
- | `GitHubHousekeeperClient` | class: class GitHubHousekeeperClient | none | GitHubHousekeeperClient | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperClient } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github-client.js:53` |
1991
- | `GitHubHousekeeperProviderError` | class: class GitHubHousekeeperProviderError | none | GitHubHousekeeperProviderError | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperProviderError } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github-client.js:36` |
1992
- | `runGitHubHousekeeper` | function: async function runGitHubHousekeeper(options) | options | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { runGitHubHousekeeper } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github.js:485` |
1997
+ | `applyGitHubHousekeeperPlan` | function: async function applyGitHubHousekeeperPlan({ client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, }) | { client, plan, dryRun = true, priorReceipt, appliedAt = new Date().toISOString(), staleDays = DEFAULT_STALE_DAYS, maxActions = DEFAULT_MAX_ACTIONS, } | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { applyGitHubHousekeeperPlan } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github.js:615` |
1998
+ | `collectGitHubHousekeeperInventory` | function: async function collectGitHubHousekeeperInventory({ client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, }) | { client, repository, targetBranch, observedAt, staleDays = DEFAULT_STALE_DAYS, policy = {}, } | Promise<unknown> | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { collectGitHubHousekeeperInventory } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github.js:246` |
1999
+ | `formatGitHubHousekeeperPlan` | function: function formatGitHubHousekeeperPlan(plan) | plan | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { formatGitHubHousekeeperPlan } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github.js:697` |
2000
+ | `GitHubHousekeeperClient` | class: class GitHubHousekeeperClient | none | GitHubHousekeeperClient | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperClient } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github-client.js:54` |
2001
+ | `GitHubHousekeeperProviderError` | class: class GitHubHousekeeperProviderError | none | GitHubHousekeeperProviderError | Construction and method errors follow the linked source implementation. | class-dependent | `import { GitHubHousekeeperProviderError } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github-client.js:37` |
2002
+ | `runGitHubHousekeeper` | function: async function runGitHubHousekeeper(options) | options | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { runGitHubHousekeeper } from "@kungfu-tech/buildchain/engineering-housekeeper-github";` | `packages/core/engineering-housekeeper-github.js:691` |
1993
2003
 
1994
2004
  ## `@kungfu-tech/buildchain/kfd-gate`
1995
2005
 
@@ -2043,6 +2053,28 @@ Target: `./packages/core/release-candidate-recovery.js`. Public symbols: 7.
2043
2053
  | `validateReleaseCandidateRecoveryReceipt` | function: function validateReleaseCandidateRecoveryReceipt({ receipt, passport, repository = "", targetChannel = "", targetRef = "", targetSha = "", targetTree = "", version = "", } = {}) | { receipt, passport, repository = "", targetChannel = "", targetRef = "", targetSha = "", targetTree = "", version = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateReleaseCandidateRecoveryReceipt } from "@kungfu-tech/buildchain/release-candidate-recovery";` | `packages/core/release-candidate-recovery.js:176` |
2044
2054
  | `verifyReleaseCandidateRecovery` | function: function verifyReleaseCandidateRecovery({ candidateRepository, targetRepository, expectedRunId, expectedWorkflowFile, expectedWorkflowName, channel, targetRef, targetSha, targetRefSha = targetSha, targetTree, expectedSourceTree = "", expectedCandidateRoot = "", expectedRuntimeSha, expectedTransactionId = "", existingTransaction = undefined, run, workflow, pullRequest, ancestry, passport, buildSummary, controllerReceipts = [], platformManifests = [], platformManifestEvidence = [], productPayloadManifests = [], artifacts = [], publicationVersion = "", currentToolingSha, recoveryRunId = "", createdAt = new Date().toISOString(), } = {}) | { candidateRepository, targetRepository, expectedRunId, expectedWorkflowFile, expectedWorkflowName, channel, targetRef, targetSha, targetRefSha = targetSha, targetTree, expectedSourceTree = "", expectedCandidateRoot = "", expectedRuntimeSha, expectedTransactionId = "", existingTransaction = undefined, run, workflow, pullRequest, ancestry, passport, buildSummary, controllerReceipts = [], platformManifests = [], platformManifestEvidence = [], productPayloadManifests = [], artifacts = [], publicationVersion = "", currentToolingSha, recoveryRunId = "", createdAt = new Date().toISOString(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyReleaseCandidateRecovery } from "@kungfu-tech/buildchain/release-candidate-recovery";` | `packages/core/release-candidate-recovery.js:398` |
2045
2055
 
2056
+ ## `@kungfu-tech/buildchain/release-train`
2057
+
2058
+ Target: `./packages/core/release-train.js`. Public symbols: 15.
2059
+
2060
+ | Symbol | Kind and signature | Parameters | Return | Errors | Side effects | Example | Source |
2061
+ | --- | --- | --- | --- | --- | --- | --- | --- |
2062
+ | `createReleaseCut` | function: function createReleaseCut(input = {}) | input = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleaseCut } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:179` |
2063
+ | `createReleaseTrain` | function: function createReleaseTrain(input = {}) | input = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleaseTrain } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:213` |
2064
+ | `LEGACY_DEV_ALPHA_CANDIDATE_STATE_SCHEMA` | constant: const LEGACY_DEV_ALPHA_CANDIDATE_STATE_SCHEMA | none | value | Import does not declare a throw contract. | none-on-import | `import { LEGACY_DEV_ALPHA_CANDIDATE_STATE_SCHEMA } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:11` |
2065
+ | `observeReleaseTrain` | function: function observeReleaseTrain(trainInput, input = {}) | trainInput, input = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { observeReleaseTrain } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:358` |
2066
+ | `readReleaseTrain` | function: function readReleaseTrain(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 { readReleaseTrain } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:491` |
2067
+ | `RELEASE_CUT_CONTRACT` | constant: const RELEASE_CUT_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { RELEASE_CUT_CONTRACT } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:5` |
2068
+ | `RELEASE_TRAIN_CONTRACT` | constant: const RELEASE_TRAIN_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { RELEASE_TRAIN_CONTRACT } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:6` |
2069
+ | `RELEASE_TRAIN_OBSERVATION_CONTRACT` | constant: const RELEASE_TRAIN_OBSERVATION_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { RELEASE_TRAIN_OBSERVATION_CONTRACT } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:9` |
2070
+ | `RELEASE_TRAIN_STATES` | constant: const RELEASE_TRAIN_STATES | none | value | Import does not declare a throw contract. | none-on-import | `import { RELEASE_TRAIN_STATES } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:14` |
2071
+ | `RELEASE_TRAIN_SUPERSESSION_CAUSES` | constant: const RELEASE_TRAIN_SUPERSESSION_CAUSES | none | value | Import does not declare a throw contract. | none-on-import | `import { RELEASE_TRAIN_SUPERSESSION_CAUSES } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:24` |
2072
+ | `RELEASE_TRAIN_TRANSITION_CONTRACT` | constant: const RELEASE_TRAIN_TRANSITION_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { RELEASE_TRAIN_TRANSITION_CONTRACT } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:7` |
2073
+ | `releaseTrainRoot` | function: function releaseTrainRoot(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 { releaseTrainRoot } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:71` |
2074
+ | `transitionReleaseTrain` | function: function transitionReleaseTrain(trainInput, input = {}) | trainInput, input = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | may-write-or-invoke-external-actions | `import { transitionReleaseTrain } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:336` |
2075
+ | `validateReleaseCut` | function: function validateReleaseCut(cut) | cut | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { validateReleaseCut } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:229` |
2076
+ | `validateReleaseTrain` | function: function validateReleaseTrain(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 { validateReleaseTrain } from "@kungfu-tech/buildchain/release-train";` | `packages/core/release-train.js:362` |
2077
+
2046
2078
  ## `@kungfu-tech/buildchain/stable-candidate-ledger`
2047
2079
 
2048
2080
  Target: `./packages/core/stable-candidate-ledger.js`. Public symbols: 11.