@kungfu-tech/buildchain 4.0.2-alpha.5 → 4.0.2-alpha.50

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": 66
       },
       "example": "import { buildchainPublicationAuthorityDescriptors } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -5305,7 +5310,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-publication-authority.js",
-        "line": 88
+        "line": 105
       },
       "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",
@@ -15326,7 +15331,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 344
+        "line": 343
       },
       "example": "import { advanceNextDevelopmentTransition } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15359,7 +15364,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 305
+        "line": 304
       },
       "example": "import { bindNextDevelopmentAnchor } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15388,7 +15393,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 253
+        "line": 252
       },
       "example": "import { createNextDevelopmentTransition } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15417,7 +15422,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 472
+        "line": 471
       },
       "example": "import { materializeNextDevelopmentTransition } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15623,7 +15628,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 416
+        "line": 415
       },
       "example": "import { recordNextDevelopmentMaterialization } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15652,7 +15657,7 @@
       ],
       "source": {
         "path": "packages/core/next-development-transition.js",
-        "line": 729
+        "line": 728
       },
       "example": "import { validateNextDevelopmentTransition } from \"@kungfu-tech/buildchain/next-development-transition\";",
       "maturity": "stable",
@@ -15661,6 +15666,121 @@
         "agent"
       ]
     },
+    {
+      "id": "packages/core/oci-publication-bundle.js#OCI_FAMILY_SCHEMA",
+      "name": "OCI_FAMILY_SCHEMA",
+      "kind": "constant",
+      "signature": "const OCI_FAMILY_SCHEMA",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/oci-publication-bundle.js",
+        "line": 10
+      },
+      "example": "import { OCI_FAMILY_SCHEMA } from \"@kungfu-tech/buildchain/oci-publication\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/oci-publication-bundle.js#ociBundleFile",
+      "name": "ociBundleFile",
+      "kind": "function",
+      "signature": "function ociBundleFile(root, relative)",
+      "parameters": [
+        {
+          "name": "root",
+          "signature": "root"
+        },
+        {
+          "name": "relative",
+          "signature": "relative"
+        }
+      ],
+      "returns": "unknown",
+      "errors": [
+        "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/oci-publication-bundle.js",
+        "line": 33
+      },
+      "example": "import { ociBundleFile } from \"@kungfu-tech/buildchain/oci-publication\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/oci-publication-bundle.js#sealOciPublicationBundle",
+      "name": "sealOciPublicationBundle",
+      "kind": "function",
+      "signature": "function sealOciPublicationBundle({ bundleRoot, body })",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ bundleRoot, body }"
+        }
+      ],
+      "returns": "unknown",
+      "errors": [
+        "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/oci-publication-bundle.js",
+        "line": 14
+      },
+      "example": "import { sealOciPublicationBundle } from \"@kungfu-tech/buildchain/oci-publication\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/oci-publication-bundle.js#verifyOciPublicationBundle",
+      "name": "verifyOciPublicationBundle",
+      "kind": "function",
+      "signature": "function verifyOciPublicationBundle({ bundleRoot, manifest, repository, sourceSha, version, })",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ bundleRoot, manifest, repository, sourceSha, version, }"
+        }
+      ],
+      "returns": "unknown",
+      "errors": [
+        "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/oci-publication-bundle.js",
+        "line": 118
+      },
+      "example": "import { verifyOciPublicationBundle } from \"@kungfu-tech/buildchain/oci-publication\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
     {
       "id": "packages/core/package-manager.js#assertPackageManager",
       "name": "assertPackageManager",
@@ -15942,11 +16062,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 +16078,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 +16107,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 +16140,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 +16164,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 +16188,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 +16212,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 +16236,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 +16265,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 +16294,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 +16327,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 +16770,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 2059
+        "line": 2025
       },
       "example": "import { collectPaperPreflight } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16679,7 +16799,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 1117
+        "line": 1124
       },
       "example": "import { collectPaperStatus } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16708,7 +16828,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 2301
+        "line": 2267
       },
       "example": "import { createPaperAlphaPlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16737,7 +16857,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 2238
+        "line": 2204
       },
       "example": "import { createPaperBuildPlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16766,7 +16886,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 525
+        "line": 511
       },
       "example": "import { createPaperProvisioningAuthority } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -16795,7 +16915,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 2359
+        "line": 2325
       },
       "example": "import { createPaperResumePlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16824,7 +16944,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 2486
+        "line": 2452
       },
       "example": "import { executePaperNpmBootstrap } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16848,7 +16968,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 +16992,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 +17016,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 88
+        "line": 90
       },
       "example": "import { PAPER_MIGRATION_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16920,7 +17040,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 +17064,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 89
+        "line": 91
       },
       "example": "import { PAPER_PREFLIGHT_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16968,7 +17088,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 +17112,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 +17136,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 87
+        "line": 89
       },
       "example": "import { PAPER_SCAFFOLD_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -17040,7 +17160,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 100
+        "line": 102
       },
       "example": "import { PAPER_STATE_ORDER } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -17064,7 +17184,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 90
+        "line": 92
       },
       "example": "import { PAPER_STATUS_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -17088,7 +17208,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 98
+        "line": 100
       },
       "example": "import { PAPER_VISIBILITY_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -17169,7 +17289,7 @@
       ],
       "source": {
         "path": "packages/core/paper.js",
-        "line": 251
+        "line": 253
       },
       "example": "import { resolvePaperRuntimeGitSha } from \"@kungfu-tech/buildchain/paper\";",
       "maturity": "stable",
@@ -19390,11 +19510,11 @@
         "May throw an Error on rejected input or failed operations; follow the linked source contract."
       ],
       "sideEffects": [
-        "none-detected-by-static-source-scan"
+        "subprocess"
       ],
       "source": {
         "path": "packages/core/publication-sealed-bundle.js",
-        "line": 84
+        "line": 97
       },
       "example": "import { createPublicationSealedBundle } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -19418,7 +19538,7 @@
       ],
       "source": {
         "path": "packages/core/publication-sealed-bundle.js",
-        "line": 10
+        "line": 11
       },
       "example": "import { PUBLICATION_SEALED_BUNDLE_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -19447,7 +19567,7 @@
       ],
       "source": {
         "path": "packages/core/publication-sealed-bundle.js",
-        "line": 133
+        "line": 190
       },
       "example": "import { verifyPublicationSealedBundle } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -21148,11 +21268,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 +21620,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 +21829,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2607
+        "line": 2608
       },
       "example": "import { createReleaseCheckReport } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -21767,7 +21887,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2763
+        "line": 2764
       },
       "example": "import { explainReleasePassport } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -21916,7 +22036,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2792
+        "line": 2793
       },
       "example": "import { makeReleasePassportFixtureAssets } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -21977,7 +22097,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2679
+        "line": 2680
       },
       "example": "import { readJsonFromLocation } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -22132,7 +22252,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2804
+        "line": 2805
       },
       "example": "import { validateKnownReleasePassportContracts } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -22161,7 +22281,7 @@
       ],
       "source": {
         "path": "packages/core/release-passport.js",
-        "line": 2728
+        "line": 2729
       },
       "example": "import { verifyReleasePassport } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23616,7 +23736,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 +23769,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 +23791,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 +23811,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 +23819,7 @@
         },
         {
           "name": "parameter2",
-          "signature": "{ adapters, checkpoint: checkpointCallback } = {}"
+          "signature": "{ adapters, checkpoint } = {}"
         }
       ],
       "returns": "Promise<unknown>",
@@ -23711,7 +23831,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 +23853,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 +23889,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 +23913,7 @@
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 31
+        "line": 33
       },
       "example": "import { RELEASE_TAIL_CAPABILITY_REGISTRY } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -23817,7 +23937,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 +23961,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 +23985,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 +24009,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 +24033,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 +24057,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 +24081,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 +24110,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 +24132,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 +24168,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 +24197,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 +24226,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 +24259,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 +28706,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 +28887,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 +29023,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 +29101,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 +29246,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 +29465,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 +29493,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 +29714,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": [
@@ -30289,7 +30409,7 @@
       "specifier": "@kungfu-tech/buildchain/publication-sealed-bundle",
       "export": "./publication-sealed-bundle",
       "target": "./packages/core/publication-sealed-bundle.js",
-      "digest": "sha256:0b912deace895b3f99e7a77b77678d35a7c22a68b3d18eb31aff2995fb66a51e",
+      "digest": "sha256:8e7ddd2c7686e78307b533fa24df79c4f004ba6cc2f009c57be502d7892679ae",
       "summary": "Build-once publication bundle manifests and exact-byte resume verification APIs.",
       "capabilityGroup": "reusable-build",
       "audience": [
@@ -30314,7 +30434,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 +30576,7 @@
       "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
       "export": "./buildchain-publication-authority",
       "target": "./packages/core/buildchain-publication-authority.js",
-      "digest": "sha256:9e35546655e3591e04f985c09b06f2ee4ee9c26bbf733cb807e49698f29c492c",
+      "digest": "sha256:8ac4b5f2c11fc1562034bf188bb6a2349935483ea831d13b273bcc7b9fbb695c",
       "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
       "capabilityGroup": "release-passport-trust",
       "audience": [
@@ -30480,7 +30600,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": [
@@ -30723,7 +30843,7 @@
       "specifier": "@kungfu-tech/buildchain/next-development-transition",
       "export": "./next-development-transition",
       "target": "./packages/core/next-development-transition.js",
-      "digest": "sha256:01b47222bb17fc4a36a66bce74ff11bf2d2ac17c935085aeec93684933849fee",
+      "digest": "sha256:c611357000496829a40605ba68755bb62b92d451ab452abcfce8fcd70373dd03",
       "summary": "Provider-neutral completed-Alpha preservation and rooted next-development state, version-model, idempotency, and local materialization APIs.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -30788,7 +30908,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 +30974,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 +31020,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 +31155,7 @@
       "specifier": "@kungfu-tech/buildchain/release-tail-provider-plane",
       "export": "./release-tail-provider-plane",
       "target": "./packages/core/release-tail-provider-plane.js",
-      "digest": "sha256:63860bdc066768c9fd69e8a64c2de245bdfc8798537e07d6a9a8f1e4b16cfb1e",
+      "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 +31276,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": [
@@ -31183,18 +31303,44 @@
       "deprecationReplacement": "",
       "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
       "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
+    },
+    {
+      "specifier": "@kungfu-tech/buildchain/oci-publication",
+      "export": "./oci-publication",
+      "target": "./packages/core/oci-publication-bundle.js",
+      "digest": "sha256:b01e5f325705cce2a15d6a7bca5a66448c6fa4510ecf1eadcf380551caa73f50",
+      "summary": "Sealed OCI image family verification, provenance, and smoke evidence APIs.",
+      "capabilityGroup": "reusable-build",
+      "audience": [
+        "developer",
+        "agent"
+      ],
+      "symbolCount": 4,
+      "symbolIds": [
+        "packages/core/oci-publication-bundle.js#OCI_FAMILY_SCHEMA",
+        "packages/core/oci-publication-bundle.js#ociBundleFile",
+        "packages/core/oci-publication-bundle.js#sealOciPublicationBundle",
+        "packages/core/oci-publication-bundle.js#verifyOciPublicationBundle"
+      ],
+      "owner": "buildchain-core",
+      "maturity": "stable",
+      "introducedVersion": "pre-3.0.2-alpha.4",
+      "compatibilityPromise": "preserved-through-the-v3-major-line",
+      "deprecationReplacement": "",
+      "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
+      "nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
     }
   ],
   "docs": [
     {
       "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:afc6f959491ea0360ee308ee476613a9b42ab37dc5755dc66d3edb484d5e81d3"
+      "digest": "sha256:1a5e35c8cdd891208525085d21ee7caad873dc156fa54db15cc38c1bf17080c0"
     },
     {
       "id": "build-facts",
@@ -31204,7 +31350,7 @@
     {
       "id": "kfd-support",
       "path": "docs/kfd-support.md",
-      "digest": "sha256:4efc8fb6f94293b75606aa0631dfa122edccc970c2cfc00c7e35f81817ea8335"
+      "digest": "sha256:e13f0e58a1bd4699ce8d443c0d316d37c9db807e03917bb2a5f8ebd11cdd7153"
     },
     {
       "id": "readme-badges",