@kungfu-tech/buildchain 4.0.2-alpha.38 → 4.0.2-alpha.39

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 (20) hide show
  1. package/architecture/maintainability-debt.json +7 -7
  2. package/dist/site/buildchain-contract.json +6 -6
  3. package/dist/site/buildchain-site.json +13 -13
  4. package/dist/site/kfd-claims.json +2 -2
  5. package/dist/site/kfd-upstream-aggregate.json +1 -1
  6. package/dist/site/manual-registry.json +3 -3
  7. package/dist/site/node-api-registry.json +29 -29
  8. package/dist/site/page-registry.json +6 -6
  9. package/dist/site/public-surface-audit.json +2 -2
  10. package/dist/site/publication-registry.json +4 -4
  11. package/dist/site/site-manifest.json +7 -7
  12. package/dist/site/workflow-registry.json +5 -5
  13. package/docs/kfd-support.md +26 -2
  14. package/docs/node-api-reference.md +32 -32
  15. package/docs/release-passport.md +27 -2
  16. package/package.json +1 -1
  17. package/packages/core/artifact-verification-envelope.js +5 -5
  18. package/packages/core/kfd-adopter-manifest.js +46 -47
  19. package/packages/core/release-passport-contract.js +5 -5
  20. package/packages/core/release-passport.js +5 -4
package/docs/node-api-reference.md CHANGED
@@ -213,7 +213,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
213
213
  | `createKfd1ReleaseGateEvidence` | function: function createKfd1ReleaseGateEvidence({ cwd = process.cwd(), artifactRoot = "", artifacts = [], witnesses = [], verifiedAt = new Date().toISOString(), metadata = resolveKfd1Metadata(), } = {}) | { cwd = process.cwd(), artifactRoot = "", artifacts = [], witnesses = [], verifiedAt = new Date().toISOString(), metadata = resolveKfd1Metadata(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createKfd1ReleaseGateEvidence } from "@kungfu-tech/buildchain";` | `packages/core/kfd-gate.js:977` |
214
214
  | `createKfd3CollaborationInterfaceReleaseGateEvidence` | function: function createKfd3CollaborationInterfaceReleaseGateEvidence({ prebuildWitnesses = [], artifactWitnesses = [], prebuildWitnessMetas = [], artifactWitnessMetas = [], artifactCommandMeta = undefined, verifiedAt = new Date().toISOString(), metadata = resolveKfd3Metadata(), } = {}) | { prebuildWitnesses = [], artifactWitnesses = [], prebuildWitnessMetas = [], artifactWitnessMetas = [], artifactCommandMeta = undefined, verifiedAt = new Date().toISOString(), metadata = resolveKfd3Metadata(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createKfd3CollaborationInterfaceReleaseGateEvidence } from "@kungfu-tech/buildchain";` | `packages/core/kfd-gate.js:1132` |
215
215
  | `createKfd3SurfaceWitness` | function: function createKfd3SurfaceWitness({ cwd = process.cwd(), registryPath = "", kind = "prebuild", sourceSha = "", artifactPath = "", } = {}) | { cwd = process.cwd(), registryPath = "", kind = "prebuild", sourceSha = "", artifactPath = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | network | `import { createKfd3SurfaceWitness } from "@kungfu-tech/buildchain";` | `packages/core/kfd3-surface-register.js:702` |
216
- | `createKfdAdopterReleaseBinding` | function: function createKfdAdopterReleaseBinding({ manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedSourceSha = "", } = {}) | { manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedSourceSha = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain";` | `packages/core/artifact-verification-envelope.js:441` |
216
+ | `createKfdAdopterReleaseBinding` | function: function createKfdAdopterReleaseBinding({ manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {}) | { manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain";` | `packages/core/artifact-verification-envelope.js:441` |
217
217
  | `createKfdBadgeSpecsFromStandards` | function: function createKfdBadgeSpecsFromStandards(standardsMetadata) | standardsMetadata | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createKfdBadgeSpecsFromStandards } from "@kungfu-tech/buildchain";` | `packages/core/readme-badges.js:126` |
218
218
  | `createKungfuBuildInfoProjection` | function: function createKungfuBuildInfoProjection({ moduleFact, cwd = process.cwd(), now = nowIso() } = {}) | { moduleFact, cwd = process.cwd(), now = nowIso() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createKungfuBuildInfoProjection } from "@kungfu-tech/buildchain";` | `packages/core/build-facts.js:528` |
219
219
  | `createManualUpstreamPickupCapture` | function: function createManualUpstreamPickupCapture({ plan, expectedDownstreamBaseSha, }) | { plan, expectedDownstreamBaseSha, } | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createManualUpstreamPickupCapture } from "@kungfu-tech/buildchain";` | `packages/core/release-propagation-pickup.js:361` |
@@ -239,7 +239,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
239
239
  | `createReleaseActivationReceiptSet` | function: function createReleaseActivationReceiptSet({ transaction, receipts = [], } = {}) | { transaction, receipts = [], } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createReleaseActivationReceiptSet } from "@kungfu-tech/buildchain";` | `packages/core/release-activation-transaction.js:311` |
240
240
  | `createReleaseActivationTransaction` | function: function createReleaseActivationTransaction({ transactionId, mode = "shadow", bindings, owners, } = {}) | { transactionId, mode = "shadow", bindings, owners, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createReleaseActivationTransaction } from "@kungfu-tech/buildchain";` | `packages/core/release-activation-transaction.js:103` |
241
241
  | `createReleaseCandidatePassport` | function: function createReleaseCandidatePassport({ repository = "", pullRequest = {}, targetChannel = "", version = "", sourceHeadSha = "", baseSha = "", mergeRefSha = "", sourceTreeHash = "", buildSummary = {}, buildchain = {}, gateAggregate = undefined, familyEvidence = undefined, consumerPolicyReceipt = undefined, controllerReceipts = [], controllerReceiptReferences = [], workflow = {}, createdAt = nowIso(), } = {}) | { repository = "", pullRequest = {}, targetChannel = "", version = "", sourceHeadSha = "", baseSha = "", mergeRefSha = "", sourceTreeHash = "", buildSummary = {}, buildchain = {}, gateAggregate = undefined, familyEvidence = undefined, consumerPolicyReceipt = undefined, controllerReceipts = [], controllerReceiptReferences = [], workflow = {}, createdAt = nowIso(), } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createReleaseCandidatePassport } from "@kungfu-tech/buildchain";` | `packages/core/release-candidate.js:369` |
242
- | `createReleaseCheckReport` | function: function createReleaseCheckReport({ passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {}) | { passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleaseCheckReport } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:2607` |
242
+ | `createReleaseCheckReport` | function: function createReleaseCheckReport({ passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {}) | { passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleaseCheckReport } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:2608` |
243
243
  | `createReleasePassport` | function: function createReleasePassport(options = {}) | options = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | local-filesystem-write | `import { createReleasePassport } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:1165` |
244
244
  | `createReleasePassportCheckManifest` | function: function createReleasePassportCheckManifest({ standards = kfdStandards } = {}) | { standards = kfdStandards } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleasePassportCheckManifest } from "@kungfu-tech/buildchain";` | `packages/core/release-passport-contract.js:159` |
245
245
  | `createReleasePropagationLock` | function: function createReleasePropagationLock({ graph, edge, sourceNode, targetNode, upstreamRelease, downstreamChannel, } = {}) | { graph, edge, sourceNode, targetNode, upstreamRelease, downstreamChannel, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleasePropagationLock } from "@kungfu-tech/buildchain";` | `packages/core/release-propagation.js:199` |
@@ -301,7 +301,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
301
301
  | `explainArtifactPassport` | function: async function explainArtifactPassport(options = {}) | options = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { explainArtifactPassport } from "@kungfu-tech/buildchain";` | `packages/core/artifact-passport.js:827` |
302
302
  | `explainKfdAgentHub` | function: function explainKfdAgentHub({ cwd = process.cwd(), declarationPath = KFD_AGENT_HUB_DECLARATION, kfdRoot = "" } = {}) | { cwd = process.cwd(), declarationPath = KFD_AGENT_HUB_DECLARATION, kfdRoot = "" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { explainKfdAgentHub } from "@kungfu-tech/buildchain";` | `packages/core/kfd-agent-hub.js:470` |
303
303
  | `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` |
304
- | `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:2763` |
304
+ | `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:2764` |
305
305
  | `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:6` |
306
306
  | `finalizeBuildchainContractWorld` | function: function finalizeBuildchainContractWorld(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 { finalizeBuildchainContractWorld } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-contract.js:881` |
307
307
  | `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` |
@@ -385,7 +385,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
385
385
  | `listKfdSchemas` | function: function listKfdSchemas({ standard = "" } = {}) | { standard = "" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { listKfdSchemas } from "@kungfu-tech/buildchain";` | `packages/core/kfd.js:492` |
386
386
  | `loadBuildchainConfig` | function: function loadBuildchainConfig(cwd = process.cwd()) | cwd = 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 { loadBuildchainConfig } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-config.js:183` |
387
387
  | `loadConfiguredAnchorManifest` | function: function loadConfiguredAnchorManifest(cwd = process.cwd(), loadedConfig = loadBuildchainConfig(cwd)) | cwd = process.cwd(), loadedConfig = loadBuildchainConfig(cwd) | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { loadConfiguredAnchorManifest } from "@kungfu-tech/buildchain";` | `packages/core/buildchain-config.js:1653` |
388
- | `makeReleasePassportFixtureAssets` | function: function makeReleasePassportFixtureAssets(dir) | dir | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | local-filesystem-write | `import { makeReleasePassportFixtureAssets } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:2792` |
388
+ | `makeReleasePassportFixtureAssets` | function: function makeReleasePassportFixtureAssets(dir) | dir | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | local-filesystem-write | `import { makeReleasePassportFixtureAssets } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:2793` |
389
389
  | `MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT` | constant: const MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/release-propagation-pickup.js:16` |
390
390
  | `MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT` | constant: const MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT } from "@kungfu-tech/buildchain";` | `packages/core/release-propagation-pickup.js:18` |
391
391
  | `markStableCandidatePromoted` | function: function markStableCandidatePromoted(ledgerInput, versionInput, { stableTag = "", stableSha = "", now = new Date().toISOString() } = {}) | ledgerInput, versionInput, { stableTag = "", stableSha = "", 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 { markStableCandidatePromoted } from "@kungfu-tech/buildchain";` | `packages/core/stable-candidate-ledger.js:229` |
@@ -466,7 +466,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
466
466
  | `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:976` |
467
467
  | `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` |
468
468
  | `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:1468` |
469
- | `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:2679` |
469
+ | `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:2680` |
470
470
  | `readKfd2ProductClaimsRegistry` | function: function readKfd2ProductClaimsRegistry({ cwd = process.cwd(), registryPath = BUILDCHAIN_KFD2_REGISTRY_PATH, } = {}) | { cwd = process.cwd(), registryPath = BUILDCHAIN_KFD2_REGISTRY_PATH, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { readKfd2ProductClaimsRegistry } from "@kungfu-tech/buildchain";` | `packages/core/kfd2-product-claims.js:137` |
471
471
  | `readKfd3SurfaceRegistry` | function: function readKfd3SurfaceRegistry({ cwd = process.cwd(), registryPath = "" } = {}) | { cwd = process.cwd(), registryPath = "" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { readKfd3SurfaceRegistry } from "@kungfu-tech/buildchain";` | `packages/core/kfd3-surface-register.js:455` |
472
472
  | `readKfdSchema` | function: function readKfdSchema({ standard, schema = "" } = {}) | { standard, schema = "" } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { readKfdSchema } from "@kungfu-tech/buildchain";` | `packages/core/kfd.js:520` |
@@ -612,9 +612,9 @@ Target: `./packages/core/index.js`. Public symbols: 636.
612
612
  | `validateKfd1ReleaseGateEvidence` | function: function validateKfd1ReleaseGateEvidence(section, { metadata = resolveKfd1Metadata() } = {}) | section, { metadata = resolveKfd1Metadata() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfd1ReleaseGateEvidence } from "@kungfu-tech/buildchain";` | `packages/core/kfd-gate.js:1337` |
613
613
  | `validateKfd2ProductClaimsRegistry` | function: function validateKfd2ProductClaimsRegistry(registry = {}) | registry = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { validateKfd2ProductClaimsRegistry } from "@kungfu-tech/buildchain";` | `packages/core/kfd2-product-claims.js:152` |
614
614
  | `validateKfd3CollaborationInterfaceReleaseGateEvidence` | function: function validateKfd3CollaborationInterfaceReleaseGateEvidence(section, { metadata = resolveKfd3Metadata() } = {}) | section, { metadata = resolveKfd3Metadata() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfd3CollaborationInterfaceReleaseGateEvidence } from "@kungfu-tech/buildchain";` | `packages/core/kfd-gate.js:1470` |
615
- | `validateKfdAdopterReleaseBinding` | function: function validateKfdAdopterReleaseBinding(binding, { manifest, manifestGate, legacyProjection, expectedSourceSha = "", } = {}) | binding, { manifest, manifestGate, legacyProjection, expectedSourceSha = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain";` | `packages/core/artifact-verification-envelope.js:467` |
615
+ | `validateKfdAdopterReleaseBinding` | function: function validateKfdAdopterReleaseBinding(binding, { manifest, manifestGate, legacyProjection, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {}) | binding, { manifest, manifestGate, legacyProjection, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain";` | `packages/core/artifact-verification-envelope.js:467` |
616
616
  | `validateKfdProductGateResult` | function: function validateKfdProductGateResult(result, { expectedSourceSha = "", checkedAt = new Date().toISOString(), } = {}) | result, { expectedSourceSha = "", checkedAt = 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 { validateKfdProductGateResult } from "@kungfu-tech/buildchain";` | `packages/core/kfd-product-gates.js:519` |
617
- | `validateKnownReleasePassportContracts` | function: function validateKnownReleasePassportContracts() | none | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKnownReleasePassportContracts } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:2804` |
617
+ | `validateKnownReleasePassportContracts` | function: function validateKnownReleasePassportContracts() | none | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKnownReleasePassportContracts } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:2805` |
618
618
  | `validatePackageManagerContract` | function: function validatePackageManagerContract({ cwd = process.cwd(), expectedManager = "" } = {}) | { cwd = process.cwd(), expectedManager = "" } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { validatePackageManagerContract } from "@kungfu-tech/buildchain";` | `packages/core/package-manager.js:18` |
619
619
  | `validatePublishEvidence` | function: function validatePublishEvidence({ evidence, version, channel, sourceSha, releaseSha, targetRef = "", releaseMaterialSha = releaseSha, publishToolingSha = "", requiredArtifacts = [], } = {}) | { evidence, version, channel, sourceSha, releaseSha, targetRef = "", releaseMaterialSha = releaseSha, publishToolingSha = "", requiredArtifacts = [], } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validatePublishEvidence } from "@kungfu-tech/buildchain";` | `packages/core/publish-transaction.js:674` |
620
620
  | `validateReleaseActivationReceiptSet` | function: function validateReleaseActivationReceiptSet(receiptSet, { allowShadow = true } = {}) | receiptSet, { allowShadow = true } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateReleaseActivationReceiptSet } from "@kungfu-tech/buildchain";` | `packages/core/release-activation-transaction.js:376` |
@@ -641,7 +641,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
641
641
  | `verifyPublicationReproducibility` | function: function verifyPublicationReproducibility({ cwd = process.cwd(), sourceSha = "", output = DEFAULT_OUTPUT, promote = false, keepWorkspaces = false, pullToolchain = true, packageName = "", allowUnpinnedToolchain = false, overlayPaths = [DEFAULT_REGISTRY_INPUT_DIR, DEFAULT_REGISTRY_HYDRATION], } = {}) | { cwd = process.cwd(), sourceSha = "", output = DEFAULT_OUTPUT, promote = false, keepWorkspaces = false, pullToolchain = true, packageName = "", allowUnpinnedToolchain = false, overlayPaths = [DEFAULT_REGISTRY_INPUT_DIR, DEFAULT_REGISTRY_HYDRATION], } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | local-filesystem-write | `import { verifyPublicationReproducibility } from "@kungfu-tech/buildchain";` | `packages/core/publication-reproducibility.js:869` |
642
642
  | `verifyPublicationSealedBundle` | function: function verifyPublicationSealedBundle({ bundleRoot, manifest } = {}) | { bundleRoot, manifest } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { verifyPublicationSealedBundle } from "@kungfu-tech/buildchain";` | `packages/core/publication-sealed-bundle.js:133` |
643
643
  | `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, anchorProvenance = undefined, 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, anchorProvenance = undefined, 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";` | `packages/core/release-candidate-recovery.js:444` |
644
- | `verifyReleasePassport` | function: async function verifyReleasePassport({ passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {}) | { passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyReleasePassport } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:2728` |
644
+ | `verifyReleasePassport` | function: async function verifyReleasePassport({ passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {}) | { passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyReleasePassport } from "@kungfu-tech/buildchain";` | `packages/core/release-passport.js:2729` |
645
645
  | `verifyReleasePropagationWork` | function: function verifyReleasePropagationWork(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 { verifyReleasePropagationWork } from "@kungfu-tech/buildchain";` | `packages/core/release-propagation-work.js:486` |
646
646
  | `verifyV4FloatingConsumerPolicyCertification` | function: function verifyV4FloatingConsumerPolicyCertification(options = {}) | options = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyV4FloatingConsumerPolicyCertification } from "@kungfu-tech/buildchain";` | `packages/core/v4-floating-consumer-evidence.js:287` |
647
647
  | `verifyV4FloatingConsumerPolicyReceipt` | function: function verifyV4FloatingConsumerPolicyReceipt(options = {}) | options = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyV4FloatingConsumerPolicyReceipt } from "@kungfu-tech/buildchain";` | `packages/core/v4-floating-consumer-evidence.js:142` |
@@ -902,7 +902,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
902
902
  | `createKfd1ReleaseGateEvidence` | function: function createKfd1ReleaseGateEvidence({ cwd = process.cwd(), artifactRoot = "", artifacts = [], witnesses = [], verifiedAt = new Date().toISOString(), metadata = resolveKfd1Metadata(), } = {}) | { cwd = process.cwd(), artifactRoot = "", artifacts = [], witnesses = [], verifiedAt = new Date().toISOString(), metadata = resolveKfd1Metadata(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createKfd1ReleaseGateEvidence } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd-gate.js:977` |
903
903
  | `createKfd3CollaborationInterfaceReleaseGateEvidence` | function: function createKfd3CollaborationInterfaceReleaseGateEvidence({ prebuildWitnesses = [], artifactWitnesses = [], prebuildWitnessMetas = [], artifactWitnessMetas = [], artifactCommandMeta = undefined, verifiedAt = new Date().toISOString(), metadata = resolveKfd3Metadata(), } = {}) | { prebuildWitnesses = [], artifactWitnesses = [], prebuildWitnessMetas = [], artifactWitnessMetas = [], artifactCommandMeta = undefined, verifiedAt = new Date().toISOString(), metadata = resolveKfd3Metadata(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createKfd3CollaborationInterfaceReleaseGateEvidence } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd-gate.js:1132` |
904
904
  | `createKfd3SurfaceWitness` | function: function createKfd3SurfaceWitness({ cwd = process.cwd(), registryPath = "", kind = "prebuild", sourceSha = "", artifactPath = "", } = {}) | { cwd = process.cwd(), registryPath = "", kind = "prebuild", sourceSha = "", artifactPath = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | network | `import { createKfd3SurfaceWitness } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd3-surface-register.js:702` |
905
- | `createKfdAdopterReleaseBinding` | function: function createKfdAdopterReleaseBinding({ manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedSourceSha = "", } = {}) | { manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedSourceSha = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/core";` | `packages/core/artifact-verification-envelope.js:441` |
905
+ | `createKfdAdopterReleaseBinding` | function: function createKfdAdopterReleaseBinding({ manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {}) | { manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/core";` | `packages/core/artifact-verification-envelope.js:441` |
906
906
  | `createKfdBadgeSpecsFromStandards` | function: function createKfdBadgeSpecsFromStandards(standardsMetadata) | standardsMetadata | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createKfdBadgeSpecsFromStandards } from "@kungfu-tech/buildchain/core";` | `packages/core/readme-badges.js:126` |
907
907
  | `createKungfuBuildInfoProjection` | function: function createKungfuBuildInfoProjection({ moduleFact, cwd = process.cwd(), now = nowIso() } = {}) | { moduleFact, cwd = process.cwd(), now = nowIso() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createKungfuBuildInfoProjection } from "@kungfu-tech/buildchain/core";` | `packages/core/build-facts.js:528` |
908
908
  | `createManualUpstreamPickupCapture` | function: function createManualUpstreamPickupCapture({ plan, expectedDownstreamBaseSha, }) | { plan, expectedDownstreamBaseSha, } | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createManualUpstreamPickupCapture } from "@kungfu-tech/buildchain/core";` | `packages/core/release-propagation-pickup.js:361` |
@@ -928,7 +928,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
928
928
  | `createReleaseActivationReceiptSet` | function: function createReleaseActivationReceiptSet({ transaction, receipts = [], } = {}) | { transaction, receipts = [], } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createReleaseActivationReceiptSet } from "@kungfu-tech/buildchain/core";` | `packages/core/release-activation-transaction.js:311` |
929
929
  | `createReleaseActivationTransaction` | function: function createReleaseActivationTransaction({ transactionId, mode = "shadow", bindings, owners, } = {}) | { transactionId, mode = "shadow", bindings, owners, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createReleaseActivationTransaction } from "@kungfu-tech/buildchain/core";` | `packages/core/release-activation-transaction.js:103` |
930
930
  | `createReleaseCandidatePassport` | function: function createReleaseCandidatePassport({ repository = "", pullRequest = {}, targetChannel = "", version = "", sourceHeadSha = "", baseSha = "", mergeRefSha = "", sourceTreeHash = "", buildSummary = {}, buildchain = {}, gateAggregate = undefined, familyEvidence = undefined, consumerPolicyReceipt = undefined, controllerReceipts = [], controllerReceiptReferences = [], workflow = {}, createdAt = nowIso(), } = {}) | { repository = "", pullRequest = {}, targetChannel = "", version = "", sourceHeadSha = "", baseSha = "", mergeRefSha = "", sourceTreeHash = "", buildSummary = {}, buildchain = {}, gateAggregate = undefined, familyEvidence = undefined, consumerPolicyReceipt = undefined, controllerReceipts = [], controllerReceiptReferences = [], workflow = {}, createdAt = nowIso(), } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createReleaseCandidatePassport } from "@kungfu-tech/buildchain/core";` | `packages/core/release-candidate.js:369` |
931
- | `createReleaseCheckReport` | function: function createReleaseCheckReport({ passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {}) | { passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleaseCheckReport } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:2607` |
931
+ | `createReleaseCheckReport` | function: function createReleaseCheckReport({ passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {}) | { passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleaseCheckReport } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:2608` |
932
932
  | `createReleasePassport` | function: function createReleasePassport(options = {}) | options = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | local-filesystem-write | `import { createReleasePassport } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:1165` |
933
933
  | `createReleasePassportCheckManifest` | function: function createReleasePassportCheckManifest({ standards = kfdStandards } = {}) | { standards = kfdStandards } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleasePassportCheckManifest } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport-contract.js:159` |
934
934
  | `createReleasePropagationLock` | function: function createReleasePropagationLock({ graph, edge, sourceNode, targetNode, upstreamRelease, downstreamChannel, } = {}) | { graph, edge, sourceNode, targetNode, upstreamRelease, downstreamChannel, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleasePropagationLock } from "@kungfu-tech/buildchain/core";` | `packages/core/release-propagation.js:199` |
@@ -990,7 +990,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
990
990
  | `explainArtifactPassport` | function: async function explainArtifactPassport(options = {}) | options = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { explainArtifactPassport } from "@kungfu-tech/buildchain/core";` | `packages/core/artifact-passport.js:827` |
991
991
  | `explainKfdAgentHub` | function: function explainKfdAgentHub({ cwd = process.cwd(), declarationPath = KFD_AGENT_HUB_DECLARATION, kfdRoot = "" } = {}) | { cwd = process.cwd(), declarationPath = KFD_AGENT_HUB_DECLARATION, kfdRoot = "" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { explainKfdAgentHub } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd-agent-hub.js:470` |
992
992
  | `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` |
993
- | `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:2763` |
993
+ | `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:2764` |
994
994
  | `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:6` |
995
995
  | `finalizeBuildchainContractWorld` | function: function finalizeBuildchainContractWorld(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 { finalizeBuildchainContractWorld } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-contract.js:881` |
996
996
  | `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` |
@@ -1074,7 +1074,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
1074
1074
  | `listKfdSchemas` | function: function listKfdSchemas({ standard = "" } = {}) | { standard = "" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { listKfdSchemas } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd.js:492` |
1075
1075
  | `loadBuildchainConfig` | function: function loadBuildchainConfig(cwd = process.cwd()) | cwd = 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 { loadBuildchainConfig } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-config.js:183` |
1076
1076
  | `loadConfiguredAnchorManifest` | function: function loadConfiguredAnchorManifest(cwd = process.cwd(), loadedConfig = loadBuildchainConfig(cwd)) | cwd = process.cwd(), loadedConfig = loadBuildchainConfig(cwd) | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { loadConfiguredAnchorManifest } from "@kungfu-tech/buildchain/core";` | `packages/core/buildchain-config.js:1653` |
1077
- | `makeReleasePassportFixtureAssets` | function: function makeReleasePassportFixtureAssets(dir) | dir | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | local-filesystem-write | `import { makeReleasePassportFixtureAssets } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:2792` |
1077
+ | `makeReleasePassportFixtureAssets` | function: function makeReleasePassportFixtureAssets(dir) | dir | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | local-filesystem-write | `import { makeReleasePassportFixtureAssets } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:2793` |
1078
1078
  | `MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT` | constant: const MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/release-propagation-pickup.js:16` |
1079
1079
  | `MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT` | constant: const MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT } from "@kungfu-tech/buildchain/core";` | `packages/core/release-propagation-pickup.js:18` |
1080
1080
  | `markStableCandidatePromoted` | function: function markStableCandidatePromoted(ledgerInput, versionInput, { stableTag = "", stableSha = "", now = new Date().toISOString() } = {}) | ledgerInput, versionInput, { stableTag = "", stableSha = "", 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 { markStableCandidatePromoted } from "@kungfu-tech/buildchain/core";` | `packages/core/stable-candidate-ledger.js:229` |
@@ -1155,7 +1155,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
1155
1155
  | `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:976` |
1156
1156
  | `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` |
1157
1157
  | `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:1468` |
1158
- | `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:2679` |
1158
+ | `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:2680` |
1159
1159
  | `readKfd2ProductClaimsRegistry` | function: function readKfd2ProductClaimsRegistry({ cwd = process.cwd(), registryPath = BUILDCHAIN_KFD2_REGISTRY_PATH, } = {}) | { cwd = process.cwd(), registryPath = BUILDCHAIN_KFD2_REGISTRY_PATH, } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { readKfd2ProductClaimsRegistry } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd2-product-claims.js:137` |
1160
1160
  | `readKfd3SurfaceRegistry` | function: function readKfd3SurfaceRegistry({ cwd = process.cwd(), registryPath = "" } = {}) | { cwd = process.cwd(), registryPath = "" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { readKfd3SurfaceRegistry } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd3-surface-register.js:455` |
1161
1161
  | `readKfdSchema` | function: function readKfdSchema({ standard, schema = "" } = {}) | { standard, schema = "" } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { readKfdSchema } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd.js:520` |
@@ -1301,9 +1301,9 @@ Target: `./packages/core/index.js`. Public symbols: 636.
1301
1301
  | `validateKfd1ReleaseGateEvidence` | function: function validateKfd1ReleaseGateEvidence(section, { metadata = resolveKfd1Metadata() } = {}) | section, { metadata = resolveKfd1Metadata() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfd1ReleaseGateEvidence } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd-gate.js:1337` |
1302
1302
  | `validateKfd2ProductClaimsRegistry` | function: function validateKfd2ProductClaimsRegistry(registry = {}) | registry = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { validateKfd2ProductClaimsRegistry } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd2-product-claims.js:152` |
1303
1303
  | `validateKfd3CollaborationInterfaceReleaseGateEvidence` | function: function validateKfd3CollaborationInterfaceReleaseGateEvidence(section, { metadata = resolveKfd3Metadata() } = {}) | section, { metadata = resolveKfd3Metadata() } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfd3CollaborationInterfaceReleaseGateEvidence } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd-gate.js:1470` |
1304
- | `validateKfdAdopterReleaseBinding` | function: function validateKfdAdopterReleaseBinding(binding, { manifest, manifestGate, legacyProjection, expectedSourceSha = "", } = {}) | binding, { manifest, manifestGate, legacyProjection, expectedSourceSha = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/core";` | `packages/core/artifact-verification-envelope.js:467` |
1304
+ | `validateKfdAdopterReleaseBinding` | function: function validateKfdAdopterReleaseBinding(binding, { manifest, manifestGate, legacyProjection, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {}) | binding, { manifest, manifestGate, legacyProjection, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/core";` | `packages/core/artifact-verification-envelope.js:467` |
1305
1305
  | `validateKfdProductGateResult` | function: function validateKfdProductGateResult(result, { expectedSourceSha = "", checkedAt = new Date().toISOString(), } = {}) | result, { expectedSourceSha = "", checkedAt = 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 { validateKfdProductGateResult } from "@kungfu-tech/buildchain/core";` | `packages/core/kfd-product-gates.js:519` |
1306
- | `validateKnownReleasePassportContracts` | function: function validateKnownReleasePassportContracts() | none | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKnownReleasePassportContracts } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:2804` |
1306
+ | `validateKnownReleasePassportContracts` | function: function validateKnownReleasePassportContracts() | none | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKnownReleasePassportContracts } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:2805` |
1307
1307
  | `validatePackageManagerContract` | function: function validatePackageManagerContract({ cwd = process.cwd(), expectedManager = "" } = {}) | { cwd = process.cwd(), expectedManager = "" } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { validatePackageManagerContract } from "@kungfu-tech/buildchain/core";` | `packages/core/package-manager.js:18` |
1308
1308
  | `validatePublishEvidence` | function: function validatePublishEvidence({ evidence, version, channel, sourceSha, releaseSha, targetRef = "", releaseMaterialSha = releaseSha, publishToolingSha = "", requiredArtifacts = [], } = {}) | { evidence, version, channel, sourceSha, releaseSha, targetRef = "", releaseMaterialSha = releaseSha, publishToolingSha = "", requiredArtifacts = [], } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validatePublishEvidence } from "@kungfu-tech/buildchain/core";` | `packages/core/publish-transaction.js:674` |
1309
1309
  | `validateReleaseActivationReceiptSet` | function: function validateReleaseActivationReceiptSet(receiptSet, { allowShadow = true } = {}) | receiptSet, { allowShadow = true } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateReleaseActivationReceiptSet } from "@kungfu-tech/buildchain/core";` | `packages/core/release-activation-transaction.js:376` |
@@ -1330,7 +1330,7 @@ Target: `./packages/core/index.js`. Public symbols: 636.
1330
1330
  | `verifyPublicationReproducibility` | function: function verifyPublicationReproducibility({ cwd = process.cwd(), sourceSha = "", output = DEFAULT_OUTPUT, promote = false, keepWorkspaces = false, pullToolchain = true, packageName = "", allowUnpinnedToolchain = false, overlayPaths = [DEFAULT_REGISTRY_INPUT_DIR, DEFAULT_REGISTRY_HYDRATION], } = {}) | { cwd = process.cwd(), sourceSha = "", output = DEFAULT_OUTPUT, promote = false, keepWorkspaces = false, pullToolchain = true, packageName = "", allowUnpinnedToolchain = false, overlayPaths = [DEFAULT_REGISTRY_INPUT_DIR, DEFAULT_REGISTRY_HYDRATION], } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | local-filesystem-write | `import { verifyPublicationReproducibility } from "@kungfu-tech/buildchain/core";` | `packages/core/publication-reproducibility.js:869` |
1331
1331
  | `verifyPublicationSealedBundle` | function: function verifyPublicationSealedBundle({ bundleRoot, manifest } = {}) | { bundleRoot, manifest } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { verifyPublicationSealedBundle } from "@kungfu-tech/buildchain/core";` | `packages/core/publication-sealed-bundle.js:133` |
1332
1332
  | `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, anchorProvenance = undefined, 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, anchorProvenance = undefined, 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/core";` | `packages/core/release-candidate-recovery.js:444` |
1333
- | `verifyReleasePassport` | function: async function verifyReleasePassport({ passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {}) | { passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyReleasePassport } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:2728` |
1333
+ | `verifyReleasePassport` | function: async function verifyReleasePassport({ passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {}) | { passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyReleasePassport } from "@kungfu-tech/buildchain/core";` | `packages/core/release-passport.js:2729` |
1334
1334
  | `verifyReleasePropagationWork` | function: function verifyReleasePropagationWork(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 { verifyReleasePropagationWork } from "@kungfu-tech/buildchain/core";` | `packages/core/release-propagation-work.js:486` |
1335
1335
  | `verifyV4FloatingConsumerPolicyCertification` | function: function verifyV4FloatingConsumerPolicyCertification(options = {}) | options = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyV4FloatingConsumerPolicyCertification } from "@kungfu-tech/buildchain/core";` | `packages/core/v4-floating-consumer-evidence.js:287` |
1336
1336
  | `verifyV4FloatingConsumerPolicyReceipt` | function: function verifyV4FloatingConsumerPolicyReceipt(options = {}) | options = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyV4FloatingConsumerPolicyReceipt } from "@kungfu-tech/buildchain/core";` | `packages/core/v4-floating-consumer-evidence.js:142` |
@@ -1380,13 +1380,13 @@ Target: `./packages/core/artifact-verification-envelope.js`. Public symbols: 11.
1380
1380
  | `ARTIFACT_VERIFICATION_ENVELOPE_CHECK_CONTRACT` | constant: const ARTIFACT_VERIFICATION_ENVELOPE_CHECK_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ARTIFACT_VERIFICATION_ENVELOPE_CHECK_CONTRACT } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:12` |
1381
1381
  | `ARTIFACT_VERIFICATION_ENVELOPE_CONTRACT` | constant: const ARTIFACT_VERIFICATION_ENVELOPE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ARTIFACT_VERIFICATION_ENVELOPE_CONTRACT } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:10` |
1382
1382
  | `artifactVerificationEnvelopeDigest` | function: function artifactVerificationEnvelopeDigest(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 { artifactVerificationEnvelopeDigest } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:59` |
1383
- | `createKfdAdopterReleaseBinding` | function: function createKfdAdopterReleaseBinding({ manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedSourceSha = "", } = {}) | { manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedSourceSha = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:441` |
1383
+ | `createKfdAdopterReleaseBinding` | function: function createKfdAdopterReleaseBinding({ manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {}) | { manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:441` |
1384
1384
  | `installedKfdPackageArtifactRoot` | function: function installedKfdPackageArtifactRoot() | none | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { installedKfdPackageArtifactRoot } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:397` |
1385
1385
  | `KFD_ADOPTER_RELEASE_BINDING_CONTRACT` | constant: const KFD_ADOPTER_RELEASE_BINDING_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { KFD_ADOPTER_RELEASE_BINDING_CONTRACT } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:16` |
1386
1386
  | `KFX_ADMISSION_INPUTS_CONTRACT` | constant: const KFX_ADMISSION_INPUTS_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { KFX_ADMISSION_INPUTS_CONTRACT } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:14` |
1387
1387
  | `projectArtifactVerificationEnvelopeToKfx` | function: function projectArtifactVerificationEnvelopeToKfx({ envelope, assessmentTime = Math.floor(Date.now() / 1000), expectedEnvelopeRoot = "", expectedIssuer = "", expectedPublisher = "", expectedContractVersion = "", } = {}) | { envelope, assessmentTime = Math.floor(Date.now() / 1000), expectedEnvelopeRoot = "", expectedIssuer = "", expectedPublisher = "", expectedContractVersion = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { projectArtifactVerificationEnvelopeToKfx } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:368` |
1388
1388
  | `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/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:323` |
1389
- | `validateKfdAdopterReleaseBinding` | function: function validateKfdAdopterReleaseBinding(binding, { manifest, manifestGate, legacyProjection, expectedSourceSha = "", } = {}) | binding, { manifest, manifestGate, legacyProjection, expectedSourceSha = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:467` |
1389
+ | `validateKfdAdopterReleaseBinding` | function: function validateKfdAdopterReleaseBinding(binding, { manifest, manifestGate, legacyProjection, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {}) | binding, { manifest, manifestGate, legacyProjection, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:467` |
1390
1390
  | `verifyArtifactVerificationEnvelope` | function: function verifyArtifactVerificationEnvelope({ envelope, assessmentTime = Math.floor(Date.now() / 1000), expectedEnvelopeRoot = "", expectedIssuer = "", expectedPublisher = "", expectedContractVersion = "", } = {}) | { envelope, assessmentTime = Math.floor(Date.now() / 1000), expectedEnvelopeRoot = "", expectedIssuer = "", expectedPublisher = "", expectedContractVersion = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyArtifactVerificationEnvelope } from "@kungfu-tech/buildchain/artifact-verification-envelope";` | `packages/core/artifact-verification-envelope.js:153` |
1391
1391
 
1392
1392
  ## `@kungfu-tech/buildchain/github-artifact-attestation`
@@ -1836,12 +1836,12 @@ Target: `./packages/core/kfd-adopter-manifest.js`. Public symbols: 6.
1836
1836
 
1837
1837
  | Symbol | Kind and signature | Parameters | Return | Errors | Side effects | Example | Source |
1838
1838
  | --- | --- | --- | --- | --- | --- | --- | --- |
1839
- | `createKfdAdopterManifestGate` | function: function createKfdAdopterManifestGate({ manifest, packageArtifactRoot = "", gateResults = [], authorityPath = ".buildchain/kfd/adopter-manifest.json", expectedSourceSha = "", checkedAt = new Date().toISOString(), maxAgeSeconds = 86400, } = {}) | { manifest, packageArtifactRoot = "", gateResults = [], authorityPath = ".buildchain/kfd/adopter-manifest.json", expectedSourceSha = "", checkedAt = new Date().toISOString(), maxAgeSeconds = 86400, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createKfdAdopterManifestGate } from "@kungfu-tech/buildchain/kfd-adopter-manifest";` | `packages/core/kfd-adopter-manifest.js:209` |
1840
- | `createKfdLegacySupportMatrixProjection` | function: function createKfdLegacySupportMatrixProjection({ manifest, manifestGate } = {}) | { manifest, manifestGate } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createKfdLegacySupportMatrixProjection } from "@kungfu-tech/buildchain/kfd-adopter-manifest";` | `packages/core/kfd-adopter-manifest.js:327` |
1839
+ | `createKfdAdopterManifestGate` | function: function createKfdAdopterManifestGate({ manifest, packageArtifactRoot = "", gateResults = [], authorityPath = ".buildchain/kfd/adopter-manifest.json", expectedAdopterId = BUILDCHAIN_ADOPTER_ID, expectedSourceRepository = "", expectedSourceSha = "", checkedAt = new Date().toISOString(), maxAgeSeconds = 86400, } = {}) | { manifest, packageArtifactRoot = "", gateResults = [], authorityPath = ".buildchain/kfd/adopter-manifest.json", expectedAdopterId = BUILDCHAIN_ADOPTER_ID, expectedSourceRepository = "", expectedSourceSha = "", checkedAt = new Date().toISOString(), maxAgeSeconds = 86400, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createKfdAdopterManifestGate } from "@kungfu-tech/buildchain/kfd-adopter-manifest";` | `packages/core/kfd-adopter-manifest.js:206` |
1840
+ | `createKfdLegacySupportMatrixProjection` | function: function createKfdLegacySupportMatrixProjection({ manifest, manifestGate } = {}) | { manifest, manifestGate } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createKfdLegacySupportMatrixProjection } from "@kungfu-tech/buildchain/kfd-adopter-manifest";` | `packages/core/kfd-adopter-manifest.js:325` |
1841
1841
  | `KFD_ADOPTER_MANIFEST_GATE_CONTRACT` | constant: const KFD_ADOPTER_MANIFEST_GATE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { KFD_ADOPTER_MANIFEST_GATE_CONTRACT } from "@kungfu-tech/buildchain/kfd-adopter-manifest";` | `packages/core/kfd-adopter-manifest.js:18` |
1842
1842
  | `KFD_LEGACY_SUPPORT_MATRIX_CONTRACT` | constant: const KFD_LEGACY_SUPPORT_MATRIX_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { KFD_LEGACY_SUPPORT_MATRIX_CONTRACT } from "@kungfu-tech/buildchain/kfd-adopter-manifest";` | `packages/core/kfd-adopter-manifest.js:20` |
1843
- | `validateKfdAdopterManifestGate` | function: function validateKfdAdopterManifestGate(gate, { expectedSourceSha = "", checkedAt = gate?.checkedAt \|\| new Date().toISOString(), } = {}) | gate, { expectedSourceSha = "", checkedAt = gate?.checkedAt \|\| 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 { validateKfdAdopterManifestGate } from "@kungfu-tech/buildchain/kfd-adopter-manifest";` | `packages/core/kfd-adopter-manifest.js:279` |
1844
- | `validateKfdLegacySupportMatrixProjection` | function: function validateKfdLegacySupportMatrixProjection(matrix, { manifest, manifestGate } = {}) | matrix, { manifest, manifestGate } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdLegacySupportMatrixProjection } from "@kungfu-tech/buildchain/kfd-adopter-manifest";` | `packages/core/kfd-adopter-manifest.js:381` |
1843
+ | `validateKfdAdopterManifestGate` | function: function validateKfdAdopterManifestGate(gate, { expectedAdopterId = BUILDCHAIN_ADOPTER_ID, expectedSourceRepository = "", expectedSourceSha = "", checkedAt = gate?.checkedAt \|\| new Date().toISOString(), } = {}) | gate, { expectedAdopterId = BUILDCHAIN_ADOPTER_ID, expectedSourceRepository = "", expectedSourceSha = "", checkedAt = gate?.checkedAt \|\| 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 { validateKfdAdopterManifestGate } from "@kungfu-tech/buildchain/kfd-adopter-manifest";` | `packages/core/kfd-adopter-manifest.js:277` |
1844
+ | `validateKfdLegacySupportMatrixProjection` | function: function validateKfdLegacySupportMatrixProjection(matrix, { manifest, manifestGate } = {}) | matrix, { manifest, manifestGate } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdLegacySupportMatrixProjection } from "@kungfu-tech/buildchain/kfd-adopter-manifest";` | `packages/core/kfd-adopter-manifest.js:380` |
1845
1845
 
1846
1846
  ## `@kungfu-tech/buildchain/kfd-adopter-release-binding`
1847
1847
 
@@ -1852,13 +1852,13 @@ Target: `./packages/core/artifact-verification-envelope.js`. Public symbols: 11.
1852
1852
  | `ARTIFACT_VERIFICATION_ENVELOPE_CHECK_CONTRACT` | constant: const ARTIFACT_VERIFICATION_ENVELOPE_CHECK_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ARTIFACT_VERIFICATION_ENVELOPE_CHECK_CONTRACT } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:12` |
1853
1853
  | `ARTIFACT_VERIFICATION_ENVELOPE_CONTRACT` | constant: const ARTIFACT_VERIFICATION_ENVELOPE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { ARTIFACT_VERIFICATION_ENVELOPE_CONTRACT } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:10` |
1854
1854
  | `artifactVerificationEnvelopeDigest` | function: function artifactVerificationEnvelopeDigest(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 { artifactVerificationEnvelopeDigest } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:59` |
1855
- | `createKfdAdopterReleaseBinding` | function: function createKfdAdopterReleaseBinding({ manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedSourceSha = "", } = {}) | { manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedSourceSha = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:441` |
1855
+ | `createKfdAdopterReleaseBinding` | function: function createKfdAdopterReleaseBinding({ manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {}) | { manifest, manifestGate, legacyProjection, manifestPath = "kfd-adopter-manifest.json", gatePath = "kfd-adopter-manifest-gate.json", legacyProjectionPath = "kfd-support.json", expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { createKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:441` |
1856
1856
  | `installedKfdPackageArtifactRoot` | function: function installedKfdPackageArtifactRoot() | none | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { installedKfdPackageArtifactRoot } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:397` |
1857
1857
  | `KFD_ADOPTER_RELEASE_BINDING_CONTRACT` | constant: const KFD_ADOPTER_RELEASE_BINDING_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { KFD_ADOPTER_RELEASE_BINDING_CONTRACT } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:16` |
1858
1858
  | `KFX_ADMISSION_INPUTS_CONTRACT` | constant: const KFX_ADMISSION_INPUTS_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { KFX_ADMISSION_INPUTS_CONTRACT } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:14` |
1859
1859
  | `projectArtifactVerificationEnvelopeToKfx` | function: function projectArtifactVerificationEnvelopeToKfx({ envelope, assessmentTime = Math.floor(Date.now() / 1000), expectedEnvelopeRoot = "", expectedIssuer = "", expectedPublisher = "", expectedContractVersion = "", } = {}) | { envelope, assessmentTime = Math.floor(Date.now() / 1000), expectedEnvelopeRoot = "", expectedIssuer = "", expectedPublisher = "", expectedContractVersion = "", } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { projectArtifactVerificationEnvelopeToKfx } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:368` |
1860
1860
  | `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/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:323` |
1861
- | `validateKfdAdopterReleaseBinding` | function: function validateKfdAdopterReleaseBinding(binding, { manifest, manifestGate, legacyProjection, expectedSourceSha = "", } = {}) | binding, { manifest, manifestGate, legacyProjection, expectedSourceSha = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:467` |
1861
+ | `validateKfdAdopterReleaseBinding` | function: function validateKfdAdopterReleaseBinding(binding, { manifest, manifestGate, legacyProjection, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {}) | binding, { manifest, manifestGate, legacyProjection, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdAdopterReleaseBinding } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:467` |
1862
1862
  | `verifyArtifactVerificationEnvelope` | function: function verifyArtifactVerificationEnvelope({ envelope, assessmentTime = Math.floor(Date.now() / 1000), expectedEnvelopeRoot = "", expectedIssuer = "", expectedPublisher = "", expectedContractVersion = "", } = {}) | { envelope, assessmentTime = Math.floor(Date.now() / 1000), expectedEnvelopeRoot = "", expectedIssuer = "", expectedPublisher = "", expectedContractVersion = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyArtifactVerificationEnvelope } from "@kungfu-tech/buildchain/kfd-adopter-release-binding";` | `packages/core/artifact-verification-envelope.js:153` |
1863
1863
 
1864
1864
  ## `@kungfu-tech/buildchain/kfd-agent-hub`
@@ -2645,25 +2645,25 @@ Target: `./packages/core/release-passport.js`. Public symbols: 24.
2645
2645
  | `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 = "", releaseJson = "", productName = "Buildchain", packageName = "@kungfu-tech/buildchain", packageVersion = "", packageSetJson = "", publishEvidenceJson = "", trustedPublishingJson = "", transactionJson = "", anchorManifestJson = "", versionMaterialJson = "", impactJson = "", buildSummaryJson = "", buildFactsJsons = [], platformManifestJsons = [], distTagEvidenceJson = "", kfd1WitnessJsons = [], kfd2ClaimJsons = [], kfd3PrebuildWitnessJsons = [], kfd3ArtifactWitnessJsons = [], kfd3ArtifactVerifyCommand = "", kfdAdopterManifestJson = "", kfdSupportMatrixJson = "", kfdProductGateJsons = [], invariantPassportJsons = [], invariantPassportCommand = "", releaseEvidenceJsons = [], v4ConsumerPolicyCertificationJson = "", v4ConsumerPolicyCertificationRoot = "", v4RuntimeResumeEvidenceJson = "", 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 = "", releaseJson = "", productName = "Buildchain", packageName = "@kungfu-tech/buildchain", packageVersion = "", packageSetJson = "", publishEvidenceJson = "", trustedPublishingJson = "", transactionJson = "", anchorManifestJson = "", versionMaterialJson = "", impactJson = "", buildSummaryJson = "", buildFactsJsons = [], platformManifestJsons = [], distTagEvidenceJson = "", kfd1WitnessJsons = [], kfd2ClaimJsons = [], kfd3PrebuildWitnessJsons = [], kfd3ArtifactWitnessJsons = [], kfd3ArtifactVerifyCommand = "", kfdAdopterManifestJson = "", kfdSupportMatrixJson = "", kfdProductGateJsons = [], invariantPassportJsons = [], invariantPassportCommand = "", releaseEvidenceJsons = [], v4ConsumerPolicyCertificationJson = "", v4ConsumerPolicyCertificationRoot = "", v4RuntimeResumeEvidenceJson = "", kfdAgentHubEvidenceJson = "", controllerReceiptReferences = [], githubArtifactAttestationPolicyJsons = [], basePassportJson = "", requireBaseKfd = false, releaseJsonExtra = "", publishJson = "", workflow = {}, checkedAt = "", } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { collectGitHubReleasePassport } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:1465` |
2646
2646
  | `createArtifactEvidence` | function: function createArtifactEvidence({ assets = [], repository = "", tag = "", sourceSha = "", workflow = {}, kfdAdopter = undefined } = {}) | { assets = [], repository = "", tag = "", sourceSha = "", workflow = {}, kfdAdopter = undefined } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createArtifactEvidence } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:1128` |
2647
2647
  | `createInvariantPassportGate` | function: function createInvariantPassportGate(passportMetas = []) | passportMetas = [] | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createInvariantPassportGate } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:223` |
2648
- | `createReleaseCheckReport` | function: function createReleaseCheckReport({ passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {}) | { passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleaseCheckReport } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:2607` |
2648
+ | `createReleaseCheckReport` | function: function createReleaseCheckReport({ passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {}) | { passport, artifactEvidence, publishEvidence, impact, agentIndex, productMechanism, kfdAgentHubEvidence, kfdSupportEvidence, kfdAdopterManifest, kfdAdopterManifestGate, releaseEvidenceDocuments = [], checkedAt = nowIso(), } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleaseCheckReport } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:2608` |
2649
2649
  | `createReleasePassport` | function: function createReleasePassport(options = {}) | options = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | local-filesystem-write | `import { createReleasePassport } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:1165` |
2650
- | `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/release-passport";` | `packages/core/release-passport.js:2763` |
2650
+ | `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/release-passport";` | `packages/core/release-passport.js:2764` |
2651
2651
  | `IMPACT_LEDGER_CONTRACT` | constant: const IMPACT_LEDGER_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { IMPACT_LEDGER_CONTRACT } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:53` |
2652
2652
  | `INVARIANT_PASSPORT_GATE_CONTRACT` | constant: const INVARIANT_PASSPORT_GATE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { INVARIANT_PASSPORT_GATE_CONTRACT } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:59` |
2653
2653
  | `KFD_AGENT_HUB_RELEASE_EVIDENCE_CONTRACT` | constant: const KFD_AGENT_HUB_RELEASE_EVIDENCE_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { KFD_AGENT_HUB_RELEASE_EVIDENCE_CONTRACT } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:60` |
2654
2654
  | `KFD2_RELEASE_TRUST_PASSPORT_CONTRACT` | constant: const KFD2_RELEASE_TRUST_PASSPORT_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { KFD2_RELEASE_TRUST_PASSPORT_CONTRACT } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:57` |
2655
2655
  | `KFD2_TRUST_PROOF_CONTRACT` | constant: const KFD2_TRUST_PROOF_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { KFD2_TRUST_PROOF_CONTRACT } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:58` |
2656
- | `makeReleasePassportFixtureAssets` | function: function makeReleasePassportFixtureAssets(dir) | dir | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | local-filesystem-write | `import { makeReleasePassportFixtureAssets } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:2792` |
2656
+ | `makeReleasePassportFixtureAssets` | function: function makeReleasePassportFixtureAssets(dir) | dir | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | local-filesystem-write | `import { makeReleasePassportFixtureAssets } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:2793` |
2657
2657
  | `PRODUCT_MECHANISM_CONTRACT` | constant: const PRODUCT_MECHANISM_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { PRODUCT_MECHANISM_CONTRACT } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:55` |
2658
- | `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/release-passport";` | `packages/core/release-passport.js:2679` |
2658
+ | `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/release-passport";` | `packages/core/release-passport.js:2680` |
2659
2659
  | `RELEASE_CHECK_REPORT_CONTRACT` | value: RELEASE_CHECK_REPORT_CONTRACT | none | unknown | No narrower error contract was mechanically discoverable. | unknown | `import { RELEASE_CHECK_REPORT_CONTRACT } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:1` |
2660
2660
  | `RELEASE_EVIDENCE_ATTACHMENT_CONTRACT` | constant: const RELEASE_EVIDENCE_ATTACHMENT_CONTRACT | none | value | Import does not declare a throw contract. | none-on-import | `import { RELEASE_EVIDENCE_ATTACHMENT_CONTRACT } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:56` |
2661
2661
  | `RELEASE_PASSPORT_CONTRACT` | value: RELEASE_PASSPORT_CONTRACT | none | unknown | No narrower error contract was mechanically discoverable. | unknown | `import { RELEASE_PASSPORT_CONTRACT } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:1` |
2662
2662
  | `releasePassportKfdAdopterSourceSha` | function: function releasePassportKfdAdopterSourceSha({ passportSourceSha = "", release = undefined, } = {}) | { passportSourceSha = "", release = undefined, } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { releasePassportKfdAdopterSourceSha } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/adopter-delivery-passport.js:12` |
2663
2663
  | `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/release-passport";` | `packages/core/release-passport.js:238` |
2664
2664
  | `sha256Text` | function: function sha256Text(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 { sha256Text } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:160` |
2665
- | `validateKnownReleasePassportContracts` | function: function validateKnownReleasePassportContracts() | none | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKnownReleasePassportContracts } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:2804` |
2666
- | `verifyReleasePassport` | function: async function verifyReleasePassport({ passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {}) | { passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyReleasePassport } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:2728` |
2665
+ | `validateKnownReleasePassportContracts` | function: function validateKnownReleasePassportContracts() | none | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKnownReleasePassportContracts } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:2805` |
2666
+ | `verifyReleasePassport` | function: async function verifyReleasePassport({ passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {}) | { passportLocation, artifactEvidenceLocation = "", publishEvidenceLocation = "", impactLocation = "", agentIndexLocation = "", productMechanismLocation = "", kfdAgentHubEvidenceLocation = "", kfdAdopterManifestLocation = "", kfdAdopterManifestGateLocation = "", kfdSupportEvidenceLocation = "", checkedAt = nowIso(), } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { verifyReleasePassport } from "@kungfu-tech/buildchain/release-passport";` | `packages/core/release-passport.js:2729` |
2667
2667
 
2668
2668
  ## `@kungfu-tech/buildchain/release-passport-contract`
2669
2669
 
@@ -2672,7 +2672,7 @@ Target: `./packages/core/release-passport-contract.js`. Public symbols: 16.
2672
2672
  | Symbol | Kind and signature | Parameters | Return | Errors | Side effects | Example | Source |
2673
2673
  | --- | --- | --- | --- | --- | --- | --- | --- |
2674
2674
  | `buildReleaseArtifactEvidence` | function: function buildReleaseArtifactEvidence({ normalizedAssets = [], repository = "", tag = "", sourceSha = "", workflow = {}, kfdAdopter } = {}) | { normalizedAssets = [], repository = "", tag = "", sourceSha = "", workflow = {}, kfdAdopter } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { buildReleaseArtifactEvidence } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:359` |
2675
- | `collectKfdAdopterReleaseEvidence` | function: function collectKfdAdopterReleaseEvidence({ manifest, gateResults = [], comparisonMatrix, sourceSha = "", checkedAt } = {}) | { manifest, gateResults = [], comparisonMatrix, sourceSha = "", checkedAt } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { collectKfdAdopterReleaseEvidence } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:408` |
2675
+ | `collectKfdAdopterReleaseEvidence` | function: function collectKfdAdopterReleaseEvidence({ manifest, gateResults = [], comparisonMatrix, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", sourceSha = "", checkedAt } = {}) | { manifest, gateResults = [], comparisonMatrix, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", sourceSha = "", checkedAt } = {} | unknown | May throw an Error on rejected input or failed operations; follow the linked source contract. | none-detected-by-static-source-scan | `import { collectKfdAdopterReleaseEvidence } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:408` |
2676
2676
  | `createReleasePassportCheckManifest` | function: function createReleasePassportCheckManifest({ standards = kfdStandards } = {}) | { standards = kfdStandards } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { createReleasePassportCheckManifest } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:159` |
2677
2677
  | `defaultReleaseAgentIndex` | function: function defaultReleaseAgentIndex({ tag = "", passportPath = "buildchain.release.json" } = {}) | { tag = "", passportPath = "buildchain.release.json" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { defaultReleaseAgentIndex } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:336` |
2678
2678
  | `defaultReleaseImpact` | function: function defaultReleaseImpact({ tag = "", line = "", decision = "unknown" } = {}) | { tag = "", line = "", decision = "unknown" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { defaultReleaseImpact } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:318` |
@@ -2685,7 +2685,7 @@ Target: `./packages/core/release-passport-contract.js`. Public symbols: 16.
2685
2685
  | `RELEASE_PASSPORT_SCHEMA` | constant: const RELEASE_PASSPORT_SCHEMA | none | value | Import does not declare a throw contract. | none-on-import | `import { RELEASE_PASSPORT_SCHEMA } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:26` |
2686
2686
  | `RELEASE_PASSPORT_SCHEMA_ID` | constant: const RELEASE_PASSPORT_SCHEMA_ID | none | value | Import does not declare a throw contract. | none-on-import | `import { RELEASE_PASSPORT_SCHEMA_ID } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:17` |
2687
2687
  | `resolveReleasePassportVerificationInputs` | function: async function resolveReleasePassportVerificationInputs({ passportLocation, locations = {}, readJson, resolveSibling } = {}) | { passportLocation, locations = {}, readJson, resolveSibling } = {} | Promise<unknown> | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { resolveReleasePassportVerificationInputs } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:456` |
2688
- | `validateKfdAdopterReleaseEvidence` | function: function validateKfdAdopterReleaseEvidence({ binding, artifactBinding, manifest, manifestGate, legacyProjection, passportLegacyProjection, expectedSourceSha = "" } = {}) | { binding, artifactBinding, manifest, manifestGate, legacyProjection, passportLegacyProjection, expectedSourceSha = "" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdAdopterReleaseEvidence } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:432` |
2688
+ | `validateKfdAdopterReleaseEvidence` | function: function validateKfdAdopterReleaseEvidence({ binding, artifactBinding, manifest, manifestGate, legacyProjection, passportLegacyProjection, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "" } = {}) | { binding, artifactBinding, manifest, manifestGate, legacyProjection, passportLegacyProjection, expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "" } = {} | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateKfdAdopterReleaseEvidence } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:432` |
2689
2689
  | `validateReleasePassportSchema` | function: function validateReleasePassportSchema(passport) | passport | unknown | Errors from called operations may propagate; no narrower throw contract is declared in source. | none-detected-by-static-source-scan | `import { validateReleasePassportSchema } from "@kungfu-tech/buildchain/release-passport-contract";` | `packages/core/release-passport-contract.js:277` |
2690
2690
 
2691
2691
  ## `@kungfu-tech/buildchain/release-propagation`
package/docs/release-passport.md CHANGED
@@ -1,3 +1,22 @@
1
+ ---
2
+ status: active
3
+ period: ongoing
4
+ theme: generic-kfd-adopter-binding
5
+ doc_type: reference
6
+ source_level: local-files
7
+ confidence: high
8
+ sensitivity: public
9
+ evidence_grade: B
10
+ review_state: unreviewed
11
+ last_reviewed: 2026-09-06
12
+ ai_provenance:
13
+ model_family: GPT-6
14
+ product: Codex
15
+ generated_at: 2026-09-06
16
+ visible_context: Buildchain v3 implementation and v4 source and regression tests.
17
+ invisible_context_boundary: No credentials or private runtime evidence inspected.
18
+ ---
19
+
1
20
  # Release Passport
2
21
 
3
22
  Buildchain Release Passport is the core product mechanism: a mature product
@@ -403,8 +422,14 @@ Pass the standard full-cut declaration with `--kfd-adopter-manifest-json`
403
422
  together with three `--kfd-product-gate-json` arguments for KFD-4, KFD-5, and
404
423
  KFD-7. The collector invokes the verifier from the exact installed
405
424
  `@kungfu-tech/kfd` package, binds the package artifact, registry and verifier
406
- roots, the exact Buildchain source, the manifest/report/bundle witness roots,
407
- and the existing product-gate roots. It emits `kfd-adopter-manifest.json`,
425
+ roots, the collector's exact product repository and source, the
426
+ manifest/report/bundle witness roots, and the existing product-gate roots. A
427
+ non-Buildchain adopter is accepted only when its manifest identity, artifact
428
+ coordinate, and all three product-gate repositories match the collector's
429
+ `--repository` value. The lower-level Node API exposes the same boundary as
430
+ `expectedAdopterId`, `expectedSourceRepository`, and `expectedSourceSha`, while
431
+ omitted identity/repository values retain the Buildchain self-release default.
432
+ It emits `kfd-adopter-manifest.json`,
408
433
  `kfd-adopter-manifest-gate.json`, and a legacy `kfd-support.json` projection.
409
434
  The release passport and `artifact-evidence.json` carry the same rooted
410
435
  `kfdAdopter` binding.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kungfu-tech/buildchain",
3
- "version": "4.0.2-alpha.38",
3
+ "version": "4.0.2-alpha.39",
4
4
  "private": false,
5
5
  "description": "Buildchain Release Passport, release governance, CLI toolkit, and site facts.",
6
6
  "repository": "https://github.com/kungfu-systems/buildchain",
package/packages/core/artifact-verification-envelope.js CHANGED
@@ -417,7 +417,7 @@ function kfdBindingBody({ manifest, manifestGate, legacyProjection, paths }) {
417
417
  gatePath: paths.gate,
418
418
  gateRoot: manifestGate.gateRoot,
419
419
  },
420
- source: jsonClone(manifestGate.source),
420
+ adopter: jsonClone(manifestGate.adopter), source: jsonClone(manifestGate.source),
421
421
  standardPackage: jsonClone(manifestGate.standardPackage),
422
422
  witness: {
423
423
  decisionRoot: manifestGate.decisionWitness.root,
@@ -445,10 +445,10 @@ export function createKfdAdopterReleaseBinding({
445
445
  manifestPath = "kfd-adopter-manifest.json",
446
446
  gatePath = "kfd-adopter-manifest-gate.json",
447
447
  legacyProjectionPath = "kfd-support.json",
448
- expectedSourceSha = "",
448
+ expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "",
449
449
  } = {}) {
450
450
  const gate = validateKfdAdopterManifestGate(manifestGate, {
451
- expectedSourceSha,
451
+ expectedAdopterId, expectedSourceRepository, expectedSourceSha,
452
452
  checkedAt: manifestGate?.checkedAt,
453
453
  });
454
454
  const legacy = validateKfdLegacySupportMatrixProjection(legacyProjection, { manifest, manifestGate });
@@ -468,7 +468,7 @@ export function validateKfdAdopterReleaseBinding(binding, {
468
468
  manifest,
469
469
  manifestGate,
470
470
  legacyProjection,
471
- expectedSourceSha = "",
471
+ expectedAdopterId = "kungfu-systems/buildchain", expectedSourceRepository = "", expectedSourceSha = "",
472
472
  } = {}) {
473
473
  const issues = [];
474
474
  if (!binding || binding.schemaVersion !== 1 || binding.contract !== KFD_ADOPTER_RELEASE_BINDING_CONTRACT) {
@@ -488,7 +488,7 @@ export function validateKfdAdopterReleaseBinding(binding, {
488
488
  manifestPath: binding.authority?.manifestPath,
489
489
  gatePath: binding.authority?.gatePath,
490
490
  legacyProjectionPath: binding.legacyProjection?.path,
491
- expectedSourceSha,
491
+ expectedAdopterId, expectedSourceRepository, expectedSourceSha,
492
492
  });
493
493
  if (stableJson(binding) !== stableJson(expected)) {
494
494
  issues.push({ code: "adopter-release-binding-drift", path: "", message: "release binding differs from the exact manifest, gate, or legacy projection closure" });