@kungfu-tech/buildchain 4.0.2-alpha.8 → 4.0.2

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

@@ -1408,11 +1408,11 @@
       "id": "packages/core/artifact-verification-envelope.js#createKfdAdopterReleaseBinding",
       "name": "createKfdAdopterReleaseBinding",
       "kind": "function",
-      "signature": "function createKfdAdopterReleaseBinding({ manifest, manifestGate, legacyProjection, manifestPath = \"kfd-adopter-manifest.json\", gatePath = \"kfd-adopter-manifest-gate.json\", legacyProjectionPath = \"kfd-support.json\", expectedSourceSha = \"\", } = {})",
+      "signature": "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 = \"\", } = {})",
       "parameters": [
         {
           "name": "parameter1",
-          "signature": "{ manifest, manifestGate, legacyProjection, manifestPath = \"kfd-adopter-manifest.json\", gatePath = \"kfd-adopter-manifest-gate.json\", legacyProjectionPath = \"kfd-support.json\", expectedSourceSha = \"\", } = {}"
+          "signature": "{ manifest, manifestGate, legacyProjection, manifestPath = \"kfd-adopter-manifest.json\", gatePath = \"kfd-adopter-manifest-gate.json\", legacyProjectionPath = \"kfd-support.json\", expectedAdopterId = \"kungfu-systems/buildchain\", expectedSourceRepository = \"\", expectedSourceSha = \"\", } = {}"
         }
       ],
       "returns": "unknown",
@@ -1567,7 +1567,7 @@
       "id": "packages/core/artifact-verification-envelope.js#validateKfdAdopterReleaseBinding",
       "name": "validateKfdAdopterReleaseBinding",
       "kind": "function",
-      "signature": "function validateKfdAdopterReleaseBinding(binding, { manifest, manifestGate, legacyProjection, expectedSourceSha = \"\", } = {})",
+      "signature": "function validateKfdAdopterReleaseBinding(binding, { manifest, manifestGate, legacyProjection, expectedAdopterId = \"kungfu-systems/buildchain\", expectedSourceRepository = \"\", expectedSourceSha = \"\", } = {})",
       "parameters": [
         {
           "name": "binding",
@@ -1575,7 +1575,7 @@
         },
         {
           "name": "parameter2",
-          "signature": "{ manifest, manifestGate, legacyProjection, expectedSourceSha = \"\", } = {}"
+          "signature": "{ manifest, manifestGate, legacyProjection, expectedAdopterId = \"kungfu-systems/buildchain\", expectedSourceRepository = \"\", expectedSourceSha = \"\", } = {}"
         }
       ],
       "returns": "unknown",
@@ -5265,18 +5265,23 @@
       "id": "packages/core/buildchain-publication-authority.js#buildchainPublicationAuthorityDescriptors",
       "name": "buildchainPublicationAuthorityDescriptors",
       "kind": "function",
-      "signature": "function buildchainPublicationAuthorityDescriptors()",
-      "parameters": [],
+      "signature": "function buildchainPublicationAuthorityDescriptors({ root = process.cwd() } = {})",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ root = process.cwd() } = {}"
+        }
+      ],
       "returns": "unknown",
       "errors": [
-        "Errors from called operations may propagate; no narrower throw contract is declared in source."
+        "May throw an Error on rejected input or failed operations; follow the linked source contract."
       ],
       "sideEffects": [
         "none-detected-by-static-source-scan"
       ],
       "source": {
         "path": "packages/core/buildchain-publication-authority.js",
-        "line": 64
+        "line": 65
       },
       "example": "import { buildchainPublicationAuthorityDescriptors } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -5305,7 +5310,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-publication-authority.js",
-        "line": 88
+        "line": 104
       },
       "example": "import { createBuildchainPublicationAuthorityRegistry } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -5772,7 +5777,7 @@
       ],
       "source": {
         "path": "packages/core/ci-lane-change-budget.js",
-        "line": 180
+        "line": 181
       },
       "example": "import { evaluateCiLaneChangeBudget } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -5801,7 +5806,7 @@
       ],
       "source": {
         "path": "packages/core/controller-evidence.js",
-        "line": 449
+        "line": 452
       },
       "example": "import { aggregateControllerReceipts } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -5955,7 +5960,7 @@
       ],
       "source": {
         "path": "packages/core/controller-evidence.js",
-        "line": 287
+        "line": 290
       },
       "example": "import { createControllerPlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -5984,7 +5989,7 @@
       ],
       "source": {
         "path": "packages/core/controller-evidence.js",
-        "line": 363
+        "line": 366
       },
       "example": "import { createControllerReceipt } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6013,7 +6018,7 @@
       ],
       "source": {
         "path": "packages/core/controller-evidence.js",
-        "line": 491
+        "line": 494
       },
       "example": "import { createControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6071,7 +6076,7 @@
       ],
       "source": {
         "path": "packages/core/controller-evidence.js",
-        "line": 532
+        "line": 535
       },
       "example": "import { normalizeControllerReceiptReferences } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6100,7 +6105,7 @@
       ],
       "source": {
         "path": "packages/core/controller-evidence.js",
-        "line": 325
+        "line": 328
       },
       "example": "import { validateControllerPlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6133,7 +6138,7 @@
       ],
       "source": {
         "path": "packages/core/controller-evidence.js",
-        "line": 423
+        "line": 426
       },
       "example": "import { validateControllerReceipt } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6166,7 +6171,7 @@
       ],
       "source": {
         "path": "packages/core/controller-evidence.js",
-        "line": 505
+        "line": 508
       },
       "example": "import { validateControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -8149,7 +8154,7 @@
       ],
       "source": {
         "path": "packages/core/dev-delivery-warrant.js",
-        "line": 520
+        "line": 521
       },
       "example": "import { cancelQueuedDevDeliveryCandidate } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
       "maturity": "stable",
@@ -8616,7 +8621,7 @@
       ],
       "source": {
         "path": "packages/core/dev-delivery-warrant.js",
-        "line": 534
+        "line": 535
       },
       "example": "import { observeDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
       "maturity": "stable",
@@ -8688,7 +8693,7 @@
       ],
       "source": {
         "path": "packages/core/dev-delivery-warrant.js",
-        "line": 529
+        "line": 530
       },
       "example": "import { reconcileDevDeliveryTerminalEvidence } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
       "maturity": "stable",
@@ -8778,7 +8783,7 @@
       ],
       "source": {
         "path": "packages/core/dev-delivery-warrant.js",
-        "line": 523
+        "line": 524
       },
       "example": "import { settleDevDeliveryTerminalEvent } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
       "maturity": "stable",
@@ -12056,11 +12061,11 @@
       "id": "packages/core/kfd-adopter-manifest.js#createKfdAdopterManifestGate",
       "name": "createKfdAdopterManifestGate",
       "kind": "function",
-      "signature": "function createKfdAdopterManifestGate({ manifest, packageArtifactRoot = \"\", gateResults = [], authorityPath = \".buildchain/kfd/adopter-manifest.json\", expectedSourceSha = \"\", checkedAt = new Date().toISOString(), maxAgeSeconds = 86400, } = {})",
+      "signature": "function createKfdAdopterManifestGate({ manifest, packageArtifactRoot = \"\", gateResults = [], authorityPath = \".buildchain/kfd/adopter-manifest.json\", expectedAdopterId = BUILDCHAIN_ADOPTER_ID, expectedSourceRepository = \"\", expectedSourceSha = \"\", checkedAt = new Date().toISOString(), maxAgeSeconds = 86400, } = {})",
       "parameters": [
         {
           "name": "parameter1",
-          "signature": "{ manifest, packageArtifactRoot = \"\", gateResults = [], authorityPath = \".buildchain/kfd/adopter-manifest.json\", expectedSourceSha = \"\", checkedAt = new Date().toISOString(), maxAgeSeconds = 86400, } = {}"
+          "signature": "{ manifest, packageArtifactRoot = \"\", gateResults = [], authorityPath = \".buildchain/kfd/adopter-manifest.json\", expectedAdopterId = BUILDCHAIN_ADOPTER_ID, expectedSourceRepository = \"\", expectedSourceSha = \"\", checkedAt = new Date().toISOString(), maxAgeSeconds = 86400, } = {}"
         }
       ],
       "returns": "unknown",
@@ -12072,7 +12077,7 @@
       ],
       "source": {
         "path": "packages/core/kfd-adopter-manifest.js",
-        "line": 209
+        "line": 206
       },
       "example": "import { createKfdAdopterManifestGate } from \"@kungfu-tech/buildchain/kfd-adopter-manifest\";",
       "maturity": "stable",
@@ -12101,7 +12106,7 @@
       ],
       "source": {
         "path": "packages/core/kfd-adopter-manifest.js",
-        "line": 327
+        "line": 325
       },
       "example": "import { createKfdLegacySupportMatrixProjection } from \"@kungfu-tech/buildchain/kfd-adopter-manifest\";",
       "maturity": "stable",
@@ -12162,7 +12167,7 @@
       "id": "packages/core/kfd-adopter-manifest.js#validateKfdAdopterManifestGate",
       "name": "validateKfdAdopterManifestGate",
       "kind": "function",
-      "signature": "function validateKfdAdopterManifestGate(gate, { expectedSourceSha = \"\", checkedAt = gate?.checkedAt || new Date().toISOString(), } = {})",
+      "signature": "function validateKfdAdopterManifestGate(gate, { expectedAdopterId = BUILDCHAIN_ADOPTER_ID, expectedSourceRepository = \"\", expectedSourceSha = \"\", checkedAt = gate?.checkedAt || new Date().toISOString(), } = {})",
       "parameters": [
         {
           "name": "gate",
@@ -12170,7 +12175,7 @@
         },
         {
           "name": "parameter2",
-          "signature": "{ expectedSourceSha = \"\", checkedAt = gate?.checkedAt || new Date().toISOString(), } = {}"
+          "signature": "{ expectedAdopterId = BUILDCHAIN_ADOPTER_ID, expectedSourceRepository = \"\", expectedSourceSha = \"\", checkedAt = gate?.checkedAt || new Date().toISOString(), } = {}"
         }
       ],
       "returns": "unknown",
@@ -12182,7 +12187,7 @@
       ],
       "source": {
         "path": "packages/core/kfd-adopter-manifest.js",
-        "line": 279
+        "line": 277
       },
       "example": "import { validateKfdAdopterManifestGate } from \"@kungfu-tech/buildchain/kfd-adopter-manifest\";",
       "maturity": "stable",
@@ -12215,7 +12220,7 @@
       ],
       "source": {
         "path": "packages/core/kfd-adopter-manifest.js",
-        "line": 381
+        "line": 380
       },
       "example": "import { validateKfdLegacySupportMatrixProjection } from \"@kungfu-tech/buildchain/kfd-adopter-manifest\";",
       "maturity": "stable",
@@ -15942,11 +15947,11 @@
       "id": "packages/core/paper-agent-entry.js#collectPaperAgentEntry",
       "name": "collectPaperAgentEntry",
       "kind": "function",
-      "signature": "function collectPaperAgentEntry({ cwd = process.cwd(), buildchainSha = \"\", mode = \"contract\", env = process.env, } = {})",
+      "signature": "function collectPaperAgentEntry({ cwd = process.cwd(), buildchainSha = \"\", mode = \"contract\", env = process.env, runtimeAdmission, } = {})",
       "parameters": [
         {
           "name": "parameter1",
-          "signature": "{ cwd = process.cwd(), buildchainSha = \"\", mode = \"contract\", env = process.env, } = {}"
+          "signature": "{ cwd = process.cwd(), buildchainSha = \"\", mode = \"contract\", env = process.env, runtimeAdmission, } = {}"
         }
       ],
       "returns": "unknown",
@@ -15958,7 +15963,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 254
+        "line": 279
       },
       "example": "import { collectPaperAgentEntry } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -15987,7 +15992,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 94
+        "line": 101
       },
       "example": "import { createPaperAgentEntry } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16020,7 +16025,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 62
+        "line": 69
       },
       "example": "import { mergePaperAgentEntryInstructions } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16044,7 +16049,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 17
+        "line": 24
       },
       "example": "import { PAPER_AGENT_ENTRY_CONTRACT } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16068,7 +16073,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 18
+        "line": 25
       },
       "example": "import { PAPER_AGENT_ENTRY_SCHEMA_VERSION } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16092,7 +16097,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 21
+        "line": 28
       },
       "example": "import { PAPER_AGENT_ENTRY_SECTION_END } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16116,7 +16121,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 19
+        "line": 26
       },
       "example": "import { PAPER_AGENT_ENTRY_SECTION_START } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16145,7 +16150,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 151
+        "line": 176
       },
       "example": "import { paperAgentEntryFiles } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16174,7 +16179,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 37
+        "line": 44
       },
       "example": "import { paperAgentEntryInstructions } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16207,7 +16212,7 @@
       ],
       "source": {
         "path": "packages/core/paper-agent-entry.js",
-        "line": 180
+        "line": 205
       },
       "example": "import { resolvePaperBuildchainSha } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16650,7 +16655,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 2059
+        "line": 2025
       },
       "example": "import { collectPaperPreflight } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16679,7 +16684,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 1117
+        "line": 1124
       },
       "example": "import { collectPaperStatus } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16708,7 +16713,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 2301
+        "line": 2267
       },
       "example": "import { createPaperAlphaPlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16737,7 +16742,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 2238
+        "line": 2204
       },
       "example": "import { createPaperBuildPlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16766,7 +16771,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 525
+        "line": 511
       },
       "example": "import { createPaperProvisioningAuthority } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16795,7 +16800,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 2359
+        "line": 2325
       },
       "example": "import { createPaperResumePlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16824,7 +16829,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 2486
+        "line": 2452
       },
       "example": "import { executePaperNpmBootstrap } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16848,7 +16853,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 96
+        "line": 98
       },
       "example": "import { PAPER_ALPHA_PLAN_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16872,7 +16877,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 95
+        "line": 97
       },
       "example": "import { PAPER_BUILD_PLAN_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16896,7 +16901,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 88
+        "line": 90
       },
       "example": "import { PAPER_MIGRATION_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16920,7 +16925,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 91
+        "line": 93
       },
       "example": "import { PAPER_NPM_BOOTSTRAP_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16944,7 +16949,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 89
+        "line": 91
       },
       "example": "import { PAPER_PREFLIGHT_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16968,7 +16973,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 93
+        "line": 95
       },
       "example": "import { PAPER_PROVISIONING_CONTRACT } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16992,7 +16997,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 97
+        "line": 99
       },
       "example": "import { PAPER_RESUME_PLAN_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -17016,7 +17021,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 87
+        "line": 89
       },
       "example": "import { PAPER_SCAFFOLD_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -17040,7 +17045,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 100
+        "line": 102
       },
       "example": "import { PAPER_STATE_ORDER } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -17064,7 +17069,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 90
+        "line": 92
       },
       "example": "import { PAPER_STATUS_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -17088,7 +17093,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 98
+        "line": 100
       },
       "example": "import { PAPER_VISIBILITY_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -17169,7 +17174,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 251
+        "line": 253
       },
       "example": "import { resolvePaperRuntimeGitSha } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -21148,11 +21153,11 @@
       "id": "packages/core/release-passport-contract.js#collectKfdAdopterReleaseEvidence",
       "name": "collectKfdAdopterReleaseEvidence",
       "kind": "function",
-      "signature": "function collectKfdAdopterReleaseEvidence({ manifest, gateResults = [], comparisonMatrix, sourceSha = \"\", checkedAt } = {})",
+      "signature": "function collectKfdAdopterReleaseEvidence({ manifest, gateResults = [], comparisonMatrix, expectedAdopterId = \"kungfu-systems/buildchain\", expectedSourceRepository = \"\", sourceSha = \"\", checkedAt } = {})",
       "parameters": [
         {
           "name": "parameter1",
-          "signature": "{ manifest, gateResults = [], comparisonMatrix, sourceSha = \"\", checkedAt } = {}"
+          "signature": "{ manifest, gateResults = [], comparisonMatrix, expectedAdopterId = \"kungfu-systems/buildchain\", expectedSourceRepository = \"\", sourceSha = \"\", checkedAt } = {}"
         }
       ],
       "returns": "unknown",
@@ -21500,11 +21505,11 @@
       "id": "packages/core/release-passport-contract.js#validateKfdAdopterReleaseEvidence",
       "name": "validateKfdAdopterReleaseEvidence",
       "kind": "function",
-      "signature": "function validateKfdAdopterReleaseEvidence({ binding, artifactBinding, manifest, manifestGate, legacyProjection, passportLegacyProjection, expectedSourceSha = \"\" } = {})",
+      "signature": "function validateKfdAdopterReleaseEvidence({ binding, artifactBinding, manifest, manifestGate, legacyProjection, passportLegacyProjection, expectedAdopterId = \"kungfu-systems/buildchain\", expectedSourceRepository = \"\", expectedSourceSha = \"\" } = {})",
       "parameters": [
         {
           "name": "parameter1",
-          "signature": "{ binding, artifactBinding, manifest, manifestGate, legacyProjection, passportLegacyProjection, expectedSourceSha = \"\" } = {}"
+          "signature": "{ binding, artifactBinding, manifest, manifestGate, legacyProjection, passportLegacyProjection, expectedAdopterId = \"kungfu-systems/buildchain\", expectedSourceRepository = \"\", expectedSourceSha = \"\" } = {}"
         }
       ],
       "returns": "unknown",
@@ -21709,7 +21714,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2607
+        "line": 2608
       },
       "example": "import { createReleaseCheckReport } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -21767,7 +21772,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2763
+        "line": 2764
       },
       "example": "import { explainReleasePassport } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -21916,7 +21921,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2792
+        "line": 2793
       },
       "example": "import { makeReleasePassportFixtureAssets } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -21977,7 +21982,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2679
+        "line": 2680
       },
       "example": "import { readJsonFromLocation } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -22132,7 +22137,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2804
+        "line": 2805
       },
       "example": "import { validateKnownReleasePassportContracts } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -22161,7 +22166,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2728
+        "line": 2729
       },
       "example": "import { verifyReleasePassport } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23616,7 +23621,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 584
+        "line": 96
       },
       "example": "import { compileReleaseTailDeclaration } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23649,7 +23654,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 1217
+        "line": 237
       },
       "example": "import { createReleaseTailAdapterSet } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23671,14 +23676,14 @@
       ],
       "returns": "unknown",
       "errors": [
-        "May throw an Error on rejected input or failed operations; follow the linked source contract."
+        "Errors from called operations may propagate; no narrower throw contract is declared in source."
       ],
       "sideEffects": [
         "none-detected-by-static-source-scan"
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 697
+        "line": 107
       },
       "example": "import { createReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23691,7 +23696,7 @@
       "id": "packages/core/release-tail-provider-plane.js#executeReleaseTailTransaction",
       "name": "executeReleaseTailTransaction",
       "kind": "function",
-      "signature": "async function executeReleaseTailTransaction(transaction, { adapters, checkpoint: checkpointCallback } = {})",
+      "signature": "async function executeReleaseTailTransaction(transaction, { adapters, checkpoint } = {})",
       "parameters": [
         {
           "name": "transaction",
@@ -23699,7 +23704,7 @@
         },
         {
           "name": "parameter2",
-          "signature": "{ adapters, checkpoint: checkpointCallback } = {}"
+          "signature": "{ adapters, checkpoint } = {}"
         }
       ],
       "returns": "Promise<unknown>",
@@ -23711,7 +23716,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 1016
+        "line": 172
       },
       "example": "import { executeReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23733,14 +23738,14 @@
       ],
       "returns": "unknown",
       "errors": [
-        "Errors from called operations may propagate; no narrower throw contract is declared in source."
+        "May throw an Error on rejected input or failed operations; follow the linked source contract."
       ],
       "sideEffects": [
         "none-detected-by-static-source-scan"
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 491
+        "line": 82
       },
       "example": "import { parseReleaseTailDeclaration } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23769,7 +23774,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 830
+        "line": 115
       },
       "example": "import { readReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23793,7 +23798,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 30
+        "line": 33
       },
       "example": "import { RELEASE_TAIL_CAPABILITY_REGISTRY } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23817,7 +23822,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 5
+        "line": 7
       },
       "example": "import { RELEASE_TAIL_DECLARATION_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23841,7 +23846,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 10
+        "line": 12
       },
       "example": "import { RELEASE_TAIL_EFFECT_SCHEMA } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23865,7 +23870,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 12
+        "line": 14
       },
       "example": "import { RELEASE_TAIL_OBSERVATION_SCHEMA } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23889,7 +23894,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 14
+        "line": 16
       },
       "example": "import { RELEASE_TAIL_RECEIPT_SCHEMA } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23913,7 +23918,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 17
+        "line": 19
       },
       "example": "import { RELEASE_TAIL_STATES } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23937,7 +23942,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 7
+        "line": 9
       },
       "example": "import { RELEASE_TAIL_TRANSACTION_POLICY } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23961,7 +23966,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 8
+        "line": 10
       },
       "example": "import { RELEASE_TAIL_TRANSACTION_SCHEMA } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23990,7 +23995,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 1207
+        "line": 227
       },
       "example": "import { releaseTailRetryPolicyFromDeclaration } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -24012,14 +24017,14 @@
       ],
       "returns": "unknown",
       "errors": [
-        "May throw an Error on rejected input or failed operations; follow the linked source contract."
+        "Errors from called operations may propagate; no narrower throw contract is declared in source."
       ],
       "sideEffects": [
         "none-detected-by-static-source-scan"
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 164
+        "line": 78
       },
       "example": "import { releaseTailRoot } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -24048,7 +24053,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 149
+        "line": 73
       },
       "example": "import { releaseTailStableJson } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -24077,7 +24082,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 602
+        "line": 103
       },
       "example": "import { validateReleaseTailEffectPlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -24106,7 +24111,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 744
+        "line": 111
       },
       "example": "import { validateReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -24139,7 +24144,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 841
+        "line": 126
       },
       "example": "import { writeReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -28586,7 +28591,7 @@
       "specifier": "@kungfu-tech/buildchain/artifact-verification-envelope",
       "export": "./artifact-verification-envelope",
       "target": "./packages/core/artifact-verification-envelope.js",
-      "digest": "sha256:8e96b81f67c49b3249a0c7e5dab176f01713da896956ee536284db3d509dd67a",
+      "digest": "sha256:c917dac2f636fa7e078500c53639e958b1d94e46eb1a2c1a31f0e4ee57e10416",
       "summary": "Sealed exact-root, lifecycle, identity, and existing KFD assessment inputs for KFX admission.",
       "capabilityGroup": "release-passport-trust",
       "audience": [
@@ -28767,7 +28772,7 @@
       "specifier": "@kungfu-tech/buildchain/buildchain-contract",
       "export": "./buildchain-contract",
       "target": "./packages/core/buildchain-contract.js",
-      "digest": "sha256:3a8e9c3c834af04e1e22807030106efeecf053bda7911e939055b2654c54cbd6",
+      "digest": "sha256:6e09b31bef967205e33464fd5ef6e2a2a4a3b464ec22f346bc810d8993dd232d",
       "summary": "Runtime contract world and compatibility digest APIs for floating-ref drift checks.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -28903,7 +28908,7 @@
       "specifier": "@kungfu-tech/buildchain/ci-lane-change-budget",
       "export": "./ci-lane-change-budget",
       "target": "./packages/core/ci-lane-change-budget.js",
-      "digest": "sha256:0cabfc98dedfeeb37a49461e7fbb480e8bb1b5b22cf2ac4ae5bae31305977033",
+      "digest": "sha256:46ba0887f1be1ed096457ac757d6bc1ca07fac99e7a47e2b7e37c96d632d4bb8",
       "summary": "Exact-baseline CI lane admission requiring authority, trigger, concurrency, runner, cancellation, and merge-critical SLO budgets.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -28981,7 +28986,7 @@
       "specifier": "@kungfu-tech/buildchain/controller-evidence",
       "export": "./controller-evidence",
       "target": "./packages/core/controller-evidence.js",
-      "digest": "sha256:bc75e2163af58aaffceec415f617b667b6be25888185a30818a80c07a5f0da3d",
+      "digest": "sha256:54af316639618918889d26407726e7eed97511ac37c015c89cad42456f2076f8",
       "summary": "Project-independent controller descriptors, source/runtime-bound plans, receipts, aggregates, and validation APIs.",
       "capabilityGroup": "reusable-build",
       "audience": [
@@ -29126,7 +29131,7 @@
       "specifier": "@kungfu-tech/buildchain/dev-delivery-warrant",
       "export": "./dev-delivery-warrant",
       "target": "./packages/core/dev-delivery-warrant.js",
-      "digest": "sha256:14cc11a84018762f2169ade5e4daf94e2bc30a3f9f2bb1fb52105cd6dc6a0466",
+      "digest": "sha256:554814626f2e57783056da74d8b32eac934e158f26b2e2f8ac024bdb8ddb61bd",
       "summary": "Durable fair Dev Delivery Warrant queue, fenced lease, and split source and integration proof APIs.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -29345,7 +29350,7 @@
       "specifier": "@kungfu-tech/buildchain/kfd-adopter-manifest",
       "export": "./kfd-adopter-manifest",
       "target": "./packages/core/kfd-adopter-manifest.js",
-      "digest": "sha256:9300bf0531cd9bb6a0cce50363765cb5dd22cdf1bd0c9075d0eb36b80cea9943",
+      "digest": "sha256:71ab52ffc71e12b0d985daa5e4ef518fbaf0fb5a2cad248fecc361d0eb875626",
       "summary": "Exact-cut KFD adopter manifest verification, Buildchain evidence binding, and one-way legacy support-matrix projection APIs.",
       "capabilityGroup": "kfd-trust",
       "audience": [
@@ -29373,7 +29378,7 @@
       "specifier": "@kungfu-tech/buildchain/kfd-adopter-release-binding",
       "export": "./kfd-adopter-release-binding",
       "target": "./packages/core/artifact-verification-envelope.js",
-      "digest": "sha256:8e96b81f67c49b3249a0c7e5dab176f01713da896956ee536284db3d509dd67a",
+      "digest": "sha256:c917dac2f636fa7e078500c53639e958b1d94e46eb1a2c1a31f0e4ee57e10416",
       "summary": "Release Passport and artifact-evidence binding for one exact standard adopter manifest closure.",
       "capabilityGroup": "kfd-trust",
       "audience": [
@@ -29594,7 +29599,7 @@
       "specifier": "@kungfu-tech/buildchain/v4-floating-consumer-policy",
       "export": "./v4-floating-consumer-policy",
       "target": "./packages/core/v4-floating-consumer-policy.js",
-      "digest": "sha256:df1b9d27dc28324fc89dc5af7838d8d1b57aa91355e43653882286070ff2308c",
+      "digest": "sha256:5232bc56e9c438514814cc06c9cb5268abbb0d574516adb36061741cd0d41fd1",
       "summary": "Semantic floating-selector admission, dual-lock receipt, and independent v4 consumer certification APIs.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -30314,7 +30319,7 @@
       "specifier": "@kungfu-tech/buildchain/paper",
       "export": "./paper",
       "target": "./packages/core/paper.js",
-      "digest": "sha256:762f10b7e0f99422ecdc73e717f721a22c940989edaa7b1011b3ba551db2b37e",
+      "digest": "sha256:0af7b6a2b66d7b471bf6d22064558269375f6c01c4147be4d77bc00c9865d988",
       "summary": "Unified Paper work, fleet, scaffold, preflight, npm bootstrap, build, Alpha, status, and resume planning APIs.",
       "capabilityGroup": "reusable-build",
       "audience": [
@@ -30456,7 +30461,7 @@
       "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
       "export": "./buildchain-publication-authority",
       "target": "./packages/core/buildchain-publication-authority.js",
-      "digest": "sha256:9e35546655e3591e04f985c09b06f2ee4ee9c26bbf733cb807e49698f29c492c",
+      "digest": "sha256:abc25223046d3329ae970871c85187ca02c86f1d72ee9c2a28c2749babe3f11a",
       "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
       "capabilityGroup": "release-passport-trust",
       "audience": [
@@ -30480,7 +30485,7 @@
       "specifier": "@kungfu-tech/buildchain/github-governance-authority",
       "export": "./github-governance-authority",
       "target": "./packages/core/github-governance-authority.js",
-      "digest": "sha256:4eb7b9a3616b16178062cc88d430f0fb3bd11c16c8e926ebc9fd98396859732c",
+      "digest": "sha256:f90f7b17d84e0c9a13680a89270437e6792836b56579068e1595c5509feb358b",
       "summary": "Fail-closed GitHub ownership, effective-policy, managed-zone admission, rollout-plan, and immutable receipt APIs.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -30788,7 +30793,7 @@
       "specifier": "@kungfu-tech/buildchain/next-development-projection",
       "export": "./next-development-projection",
       "target": "./packages/core/next-development-projection.js",
-      "digest": "sha256:9dbc60f511bfca92fb8160024ec58454212e20b7c17df01345e4a2e65ca86b3f",
+      "digest": "sha256:c1a93e83e0ab80d50ecc147954ae73f647780ed2fb154ffd8132af79114abc00",
       "summary": "Canonical generated config, Agent, workflow-header, and manual projections for the next-development transition contract.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -30854,7 +30859,7 @@
       "specifier": "@kungfu-tech/buildchain/release-passport",
       "export": "./release-passport",
       "target": "./packages/core/release-passport.js",
-      "digest": "sha256:4932b0ef2ea1c62101347789ef233c77142630a69762d325688269fe29c230c5",
+      "digest": "sha256:4a095c1931b4e9c4d16455425d27a27f9607b7daffde5548b2a667dbdf41a546",
       "summary": "Release passport collection, verification, explanation, and evidence APIs.",
       "capabilityGroup": "release-passport-trust",
       "audience": [
@@ -30900,7 +30905,7 @@
       "specifier": "@kungfu-tech/buildchain/release-passport-contract",
       "export": "./release-passport-contract",
       "target": "./packages/core/release-passport-contract.js",
-      "digest": "sha256:2ab3962c8aea07e0f0e48ff07cb247235a8310344ea750b37e1cf7beb24a8352",
+      "digest": "sha256:e2d0b9b5067d3cb6a05ffee1961b92a469fe6b74a5054345efb769d9c6ff7f9b",
       "summary": "Standalone release passport JSON Schema, ownership/check manifest, and structural validation APIs.",
       "capabilityGroup": "release-passport-trust",
       "audience": [
@@ -31035,7 +31040,7 @@
       "specifier": "@kungfu-tech/buildchain/release-tail-provider-plane",
       "export": "./release-tail-provider-plane",
       "target": "./packages/core/release-tail-provider-plane.js",
-      "digest": "sha256:83661b137cf7945ba263954d9e11933a767933ad3e223791909721c048e2d377",
+      "digest": "sha256:525575c9d4330c7fa0760491342757be80a186be589f18d9bba64b5a1ea69c5d",
       "summary": "Versioned declarative release-tail parsing, deterministic effect planning, durable transaction execution, readback, retry, and rooted receipt APIs.",
       "capabilityGroup": "release-passport-trust",
       "audience": [
@@ -31156,7 +31161,7 @@
       "specifier": "@kungfu-tech/buildchain/buildchain-kfd-claims",
       "export": "./buildchain-kfd-claims",
       "target": "./packages/core/buildchain-kfd-claims.js",
-      "digest": "sha256:8bfde25d056cfdce1e84ceb71d75f5790b41d61db6f60e73d8f33fc2077e9331",
+      "digest": "sha256:82e513efff1070a681e944f225dd82932fb440f999af3088632540e6db2d54d0",
       "summary": "Buildchain self KFD claim registry, witnesses, and public claim APIs.",
       "capabilityGroup": "kfd-trust",
       "audience": [
@@ -31189,12 +31194,12 @@
     {
       "id": "cli-and-node-package",
       "path": "docs/cli.md",
-      "digest": "sha256:60208f0862195df44b27ada15e474ff1808dee6d492cd6303402b92fd72f06bc"
+      "digest": "sha256:fc2e0cd3f5718e05101d85f6363cefcd2336609c05dd6626b6a062b44c3a1a0d"
     },
     {
       "id": "node-api-reference",
       "path": "docs/node-api-reference.md",
-      "digest": "sha256:1f50b0f7a45632b6e08b492687818ccbd3e0f00d7f189a21e1512e1a61df7df8"
+      "digest": "sha256:df073c14c12f15c851eb4507cbeb2919add936ac3079b10f222478138720d092"
     },
     {
       "id": "build-facts",
@@ -31204,7 +31209,7 @@
     {
       "id": "kfd-support",
       "path": "docs/kfd-support.md",
-      "digest": "sha256:4efc8fb6f94293b75606aa0631dfa122edccc970c2cfc00c7e35f81817ea8335"
+      "digest": "sha256:e13f0e58a1bd4699ce8d443c0d316d37c9db807e03917bb2a5f8ebd11cdd7153"
     },
     {
       "id": "readme-badges",