@kungfu-tech/buildchain 3.0.7 → 3.0.8

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

@@ -1368,18 +1368,14 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#discoverConfiguredDerivedVersionMaterial",
-      "name": "discoverConfiguredDerivedVersionMaterial",
+      "id": "packages/core/buildchain-compatibility-proof.js#assertBuildchainCompatibilityProjection",
+      "name": "assertBuildchainCompatibilityProjection",
       "kind": "function",
-      "signature": "function discoverConfiguredDerivedVersionMaterial(cwd = process.cwd(), loadedConfig = loadBuildchainConfig(cwd))",
+      "signature": "function assertBuildchainCompatibilityProjection(contractWorld)",
       "parameters": [
         {
-          "name": "cwd",
-          "signature": "cwd = process.cwd()"
-        },
-        {
-          "name": "loadedConfig",
-          "signature": "loadedConfig = loadBuildchainConfig(cwd)"
+          "name": "contractWorld",
+          "signature": "contractWorld"
         }
       ],
       "returns": "unknown",
@@ -1390,10 +1386,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-config.js",
-        "line": 1527
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 276
       },
-      "example": "import { discoverConfiguredDerivedVersionMaterial } from \"@kungfu-tech/buildchain\";",
+      "example": "import { assertBuildchainCompatibilityProjection } from \"@kungfu-tech/buildchain/buildchain-contract\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1401,32 +1397,23 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#discoverConfiguredVersionStateFiles",
-      "name": "discoverConfiguredVersionStateFiles",
-      "kind": "function",
-      "signature": "function discoverConfiguredVersionStateFiles(cwd = process.cwd(), loadedConfig = loadBuildchainConfig(cwd))",
-      "parameters": [
-        {
-          "name": "cwd",
-          "signature": "cwd = process.cwd()"
-        },
-        {
-          "name": "loadedConfig",
-          "signature": "loadedConfig = loadBuildchainConfig(cwd)"
-        }
-      ],
-      "returns": "unknown",
+      "id": "packages/core/buildchain-compatibility-proof.js#BUILDCHAIN_COMPATIBILITY_PROOF_REGISTRY_SCHEMA",
+      "name": "BUILDCHAIN_COMPATIBILITY_PROOF_REGISTRY_SCHEMA",
+      "kind": "constant",
+      "signature": "const BUILDCHAIN_COMPATIBILITY_PROOF_REGISTRY_SCHEMA",
+      "parameters": [],
+      "returns": "value",
       "errors": [
-        "May throw an Error on rejected input or failed operations; follow the linked source contract."
+        "Import does not declare a throw contract."
       ],
       "sideEffects": [
-        "none-detected-by-static-source-scan"
+        "none-on-import"
       ],
       "source": {
-        "path": "packages/core/buildchain-config.js",
-        "line": 1488
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 12
       },
-      "example": "import { discoverConfiguredVersionStateFiles } from \"@kungfu-tech/buildchain\";",
+      "example": "import { BUILDCHAIN_COMPATIBILITY_PROOF_REGISTRY_SCHEMA } from \"@kungfu-tech/buildchain/buildchain-contract\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1434,32 +1421,47 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#getLifecycleStage",
-      "name": "getLifecycleStage",
-      "kind": "function",
-      "signature": "function getLifecycleStage(loadedConfig, name)",
-      "parameters": [
-        {
-          "name": "loadedConfig",
-          "signature": "loadedConfig"
-        },
-        {
-          "name": "name",
-          "signature": "name"
-        }
+      "id": "packages/core/buildchain-compatibility-proof.js#BUILDCHAIN_COMPATIBILITY_PROOF_SCHEMA",
+      "name": "BUILDCHAIN_COMPATIBILITY_PROOF_SCHEMA",
+      "kind": "constant",
+      "signature": "const BUILDCHAIN_COMPATIBILITY_PROOF_SCHEMA",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
       ],
-      "returns": "unknown",
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 11
+      },
+      "example": "import { BUILDCHAIN_COMPATIBILITY_PROOF_SCHEMA } from \"@kungfu-tech/buildchain/buildchain-contract\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/buildchain-compatibility-proof.js#BUILDCHAIN_COMPATIBILITY_VERIFICATION_RECEIPT_SCHEMA",
+      "name": "BUILDCHAIN_COMPATIBILITY_VERIFICATION_RECEIPT_SCHEMA",
+      "kind": "constant",
+      "signature": "const BUILDCHAIN_COMPATIBILITY_VERIFICATION_RECEIPT_SCHEMA",
+      "parameters": [],
+      "returns": "value",
       "errors": [
-        "Errors from called operations may propagate; no narrower throw contract is declared in source."
+        "Import does not declare a throw contract."
       ],
       "sideEffects": [
-        "none-detected-by-static-source-scan"
+        "none-on-import"
       ],
       "source": {
-        "path": "packages/core/buildchain-config.js",
-        "line": 1432
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 13
       },
-      "example": "import { getLifecycleStage } from \"@kungfu-tech/buildchain\";",
+      "example": "import { BUILDCHAIN_COMPATIBILITY_VERIFICATION_RECEIPT_SCHEMA } from \"@kungfu-tech/buildchain/buildchain-contract\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1467,28 +1469,36 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#getNativeDiagnosticsProfile",
-      "name": "getNativeDiagnosticsProfile",
+      "id": "packages/core/buildchain-compatibility-proof.js#contractSummary",
+      "name": "contractSummary",
       "kind": "function",
-      "signature": "function getNativeDiagnosticsProfile(loadedConfig)",
+      "signature": "function contractSummary(contractWorld, runtimeRef = \"\", runtimeSha = \"\")",
       "parameters": [
         {
-          "name": "loadedConfig",
-          "signature": "loadedConfig"
+          "name": "contractWorld",
+          "signature": "contractWorld"
+        },
+        {
+          "name": "runtimeRef",
+          "signature": "runtimeRef = \"\""
+        },
+        {
+          "name": "runtimeSha",
+          "signature": "runtimeSha = \"\""
         }
       ],
       "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/buildchain-config.js",
-        "line": 585
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 359
       },
-      "example": "import { getNativeDiagnosticsProfile } from \"@kungfu-tech/buildchain\";",
+      "example": "import { contractSummary } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1496,28 +1506,28 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#getPublishContract",
-      "name": "getPublishContract",
+      "id": "packages/core/buildchain-compatibility-proof.js#createBuildchainCompatibilityProof",
+      "name": "createBuildchainCompatibilityProof",
       "kind": "function",
-      "signature": "function getPublishContract(loadedConfig)",
+      "signature": "function createBuildchainCompatibilityProof(input = {})",
       "parameters": [
         {
-          "name": "loadedConfig",
-          "signature": "loadedConfig"
+          "name": "input",
+          "signature": "input = {}"
         }
       ],
       "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-config.js",
-        "line": 1436
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 157
       },
-      "example": "import { getPublishContract } from \"@kungfu-tech/buildchain\";",
+      "example": "import { createBuildchainCompatibilityProof } from \"@kungfu-tech/buildchain/buildchain-contract\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1525,14 +1535,14 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#getStableReleasePolicy",
-      "name": "getStableReleasePolicy",
+      "id": "packages/core/buildchain-compatibility-proof.js#createBuildchainCompatibilityProofRegistry",
+      "name": "createBuildchainCompatibilityProofRegistry",
       "kind": "function",
-      "signature": "function getStableReleasePolicy(loadedConfig)",
+      "signature": "function createBuildchainCompatibilityProofRegistry({ proofs = createHistoricalBuildchainCompatibilityProofs(), surfaces = [], majorLine = \"\" } = {})",
       "parameters": [
         {
-          "name": "loadedConfig",
-          "signature": "loadedConfig"
+          "name": "parameter1",
+          "signature": "{ proofs = createHistoricalBuildchainCompatibilityProofs(), surfaces = [], majorLine = \"\" } = {}"
         }
       ],
       "returns": "unknown",
@@ -1543,10 +1553,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-config.js",
-        "line": 353
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 252
       },
-      "example": "import { getStableReleasePolicy } from \"@kungfu-tech/buildchain\";",
+      "example": "import { createBuildchainCompatibilityProofRegistry } from \"@kungfu-tech/buildchain/buildchain-contract\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1554,14 +1564,14 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#getVersionStrategy",
-      "name": "getVersionStrategy",
+      "id": "packages/core/buildchain-compatibility-proof.js#createBuildchainCompatibilityVerificationReceipt",
+      "name": "createBuildchainCompatibilityVerificationReceipt",
       "kind": "function",
-      "signature": "function getVersionStrategy(loadedConfig)",
+      "signature": "function createBuildchainCompatibilityVerificationReceipt(input = {})",
       "parameters": [
         {
-          "name": "loadedConfig",
-          "signature": "loadedConfig"
+          "name": "input",
+          "signature": "input = {}"
         }
       ],
       "returns": "unknown",
@@ -1572,10 +1582,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-config.js",
-        "line": 1560
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 322
       },
-      "example": "import { getVersionStrategy } from \"@kungfu-tech/buildchain\";",
+      "example": "import { createBuildchainCompatibilityVerificationReceipt } from \"@kungfu-tech/buildchain/buildchain-contract\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1583,16 +1593,11 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#loadBuildchainConfig",
-      "name": "loadBuildchainConfig",
+      "id": "packages/core/buildchain-compatibility-proof.js#createHistoricalBuildchainCompatibilityProofs",
+      "name": "createHistoricalBuildchainCompatibilityProofs",
       "kind": "function",
-      "signature": "function loadBuildchainConfig(cwd = process.cwd())",
-      "parameters": [
-        {
-          "name": "cwd",
-          "signature": "cwd = process.cwd()"
-        }
-      ],
+      "signature": "function createHistoricalBuildchainCompatibilityProofs()",
+      "parameters": [],
       "returns": "unknown",
       "errors": [
         "May throw an Error on rejected input or failed operations; follow the linked source contract."
@@ -1601,10 +1606,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-config.js",
-        "line": 183
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 229
       },
-      "example": "import { loadBuildchainConfig } from \"@kungfu-tech/buildchain\";",
+      "example": "import { createHistoricalBuildchainCompatibilityProofs } from \"@kungfu-tech/buildchain/buildchain-contract\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1612,18 +1617,14 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#loadConfiguredAnchorManifest",
-      "name": "loadConfiguredAnchorManifest",
+      "id": "packages/core/buildchain-compatibility-proof.js#evaluateBuildchainContractLock",
+      "name": "evaluateBuildchainContractLock",
       "kind": "function",
-      "signature": "function loadConfiguredAnchorManifest(cwd = process.cwd(), loadedConfig = loadBuildchainConfig(cwd))",
+      "signature": "function evaluateBuildchainContractLock({ lock, current, runtimeRef = \"\", runtimeSha = \"\", runtimeClass = \"\", compatibilityPolicy = \"\", } = {})",
       "parameters": [
         {
-          "name": "cwd",
-          "signature": "cwd = process.cwd()"
-        },
-        {
-          "name": "loadedConfig",
-          "signature": "loadedConfig = loadBuildchainConfig(cwd)"
+          "name": "parameter1",
+          "signature": "{ lock, current, runtimeRef = \"\", runtimeSha = \"\", runtimeClass = \"\", compatibilityPolicy = \"\", } = {}"
         }
       ],
       "returns": "unknown",
@@ -1634,10 +1635,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-config.js",
-        "line": 1569
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 440
       },
-      "example": "import { loadConfiguredAnchorManifest } from \"@kungfu-tech/buildchain\";",
+      "example": "import { evaluateBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1645,28 +1646,28 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#normalizeBuildchainConfig",
-      "name": "normalizeBuildchainConfig",
+      "id": "packages/core/buildchain-compatibility-proof.js#renderBuildchainContractDriftIssueBody",
+      "name": "renderBuildchainContractDriftIssueBody",
       "kind": "function",
-      "signature": "function normalizeBuildchainConfig(config)",
+      "signature": "function renderBuildchainContractDriftIssueBody({ repository = \"\", workflow = \"\", runUrl = \"\", lockPath = \"\", evaluation } = {})",
       "parameters": [
         {
-          "name": "config",
-          "signature": "config"
+          "name": "parameter1",
+          "signature": "{ repository = \"\", workflow = \"\", runUrl = \"\", lockPath = \"\", evaluation } = {}"
         }
       ],
       "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/buildchain-config.js",
-        "line": 206
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 560
       },
-      "example": "import { normalizeBuildchainConfig } from \"@kungfu-tech/buildchain\";",
+      "example": "import { renderBuildchainContractDriftIssueBody } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1674,36 +1675,32 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#normalizeLifecycleStage",
-      "name": "normalizeLifecycleStage",
+      "id": "packages/core/buildchain-compatibility-proof.js#verifyBuildchainCompatibilityProof",
+      "name": "verifyBuildchainCompatibilityProof",
       "kind": "function",
-      "signature": "function normalizeLifecycleStage(stage, label = \"lifecycle stage\", lifecycle = {})",
+      "signature": "function verifyBuildchainCompatibilityProof(proofInput, expected = {})",
       "parameters": [
         {
-          "name": "stage",
-          "signature": "stage"
-        },
-        {
-          "name": "label",
-          "signature": "label = \"lifecycle stage\""
+          "name": "proofInput",
+          "signature": "proofInput"
         },
         {
-          "name": "lifecycle",
-          "signature": "lifecycle = {}"
+          "name": "expected",
+          "signature": "expected = {}"
         }
       ],
       "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/buildchain-config.js",
-        "line": 1393
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 205
       },
-      "example": "import { normalizeLifecycleStage } from \"@kungfu-tech/buildchain\";",
+      "example": "import { verifyBuildchainCompatibilityProof } from \"@kungfu-tech/buildchain/buildchain-contract\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1711,28 +1708,28 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#runLifecycleStage",
-      "name": "runLifecycleStage",
+      "id": "packages/core/buildchain-compatibility-proof.js#verifyBuildchainCompatibilityVerificationReceipt",
+      "name": "verifyBuildchainCompatibilityVerificationReceipt",
       "kind": "function",
-      "signature": "function runLifecycleStage({ cwd = process.cwd(), loadedConfig, name, stage, env: extraEnv, timeoutMinutes })",
+      "signature": "function verifyBuildchainCompatibilityVerificationReceipt(receiptInput)",
       "parameters": [
         {
-          "name": "parameter1",
-          "signature": "{ cwd = process.cwd(), loadedConfig, name, stage, env: extraEnv, timeoutMinutes }"
+          "name": "receiptInput",
+          "signature": "receiptInput"
         }
       ],
       "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": [
-        "subprocess"
+        "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-config.js",
-        "line": 1440
+        "path": "packages/core/buildchain-compatibility-proof.js",
+        "line": 346
       },
-      "example": "import { runLifecycleStage } from \"@kungfu-tech/buildchain\";",
+      "example": "import { verifyBuildchainCompatibilityVerificationReceipt } from \"@kungfu-tech/buildchain/buildchain-contract\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1740,18 +1737,18 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#updateConfiguredVersionStateContents",
-      "name": "updateConfiguredVersionStateContents",
+      "id": "packages/core/buildchain-config.js#discoverConfiguredDerivedVersionMaterial",
+      "name": "discoverConfiguredDerivedVersionMaterial",
       "kind": "function",
-      "signature": "function updateConfiguredVersionStateContents(files, version)",
+      "signature": "function discoverConfiguredDerivedVersionMaterial(cwd = process.cwd(), loadedConfig = loadBuildchainConfig(cwd))",
       "parameters": [
         {
-          "name": "files",
-          "signature": "files"
+          "name": "cwd",
+          "signature": "cwd = process.cwd()"
         },
         {
-          "name": "version",
-          "signature": "version"
+          "name": "loadedConfig",
+          "signature": "loadedConfig = loadBuildchainConfig(cwd)"
         }
       ],
       "returns": "unknown",
@@ -1759,13 +1756,13 @@
         "May throw an Error on rejected input or failed operations; follow the linked source contract."
       ],
       "sideEffects": [
-        "may-write-or-invoke-external-actions"
+        "none-detected-by-static-source-scan"
       ],
       "source": {
         "path": "packages/core/buildchain-config.js",
-        "line": 1740
+        "line": 1527
       },
-      "example": "import { updateConfiguredVersionStateContents } from \"@kungfu-tech/buildchain\";",
+      "example": "import { discoverConfiguredDerivedVersionMaterial } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1773,18 +1770,18 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-config.js#validateBuildchainConfig",
-      "name": "validateBuildchainConfig",
+      "id": "packages/core/buildchain-config.js#discoverConfiguredVersionStateFiles",
+      "name": "discoverConfiguredVersionStateFiles",
       "kind": "function",
-      "signature": "function validateBuildchainConfig(cwd = process.cwd(), { requireConfig = true, requireVersionState = false, requireLifecycleStages = [], } = {})",
+      "signature": "function discoverConfiguredVersionStateFiles(cwd = process.cwd(), loadedConfig = loadBuildchainConfig(cwd))",
       "parameters": [
         {
           "name": "cwd",
           "signature": "cwd = process.cwd()"
         },
         {
-          "name": "parameter2",
-          "signature": "{ requireConfig = true, requireVersionState = false, requireLifecycleStages = [], } = {}"
+          "name": "loadedConfig",
+          "signature": "loadedConfig = loadBuildchainConfig(cwd)"
         }
       ],
       "returns": "unknown",
@@ -1796,9 +1793,9 @@
       ],
       "source": {
         "path": "packages/core/buildchain-config.js",
-        "line": 1607
+        "line": 1488
       },
-      "example": "import { validateBuildchainConfig } from \"@kungfu-tech/buildchain\";",
+      "example": "import { discoverConfiguredVersionStateFiles } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1806,23 +1803,32 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#BUILDCHAIN_CONTRACT_LOCK",
-      "name": "BUILDCHAIN_CONTRACT_LOCK",
-      "kind": "constant",
-      "signature": "const BUILDCHAIN_CONTRACT_LOCK",
-      "parameters": [],
-      "returns": "value",
+      "id": "packages/core/buildchain-config.js#getLifecycleStage",
+      "name": "getLifecycleStage",
+      "kind": "function",
+      "signature": "function getLifecycleStage(loadedConfig, name)",
+      "parameters": [
+        {
+          "name": "loadedConfig",
+          "signature": "loadedConfig"
+        },
+        {
+          "name": "name",
+          "signature": "name"
+        }
+      ],
+      "returns": "unknown",
       "errors": [
-        "Import does not declare a throw contract."
+        "Errors from called operations may propagate; no narrower throw contract is declared in source."
       ],
       "sideEffects": [
-        "none-on-import"
+        "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-contract.js",
-        "line": 8
+        "path": "packages/core/buildchain-config.js",
+        "line": 1432
       },
-      "example": "import { BUILDCHAIN_CONTRACT_LOCK } from \"@kungfu-tech/buildchain\";",
+      "example": "import { getLifecycleStage } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1830,23 +1836,28 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#BUILDCHAIN_RUNTIME_CONTRACT_WORLD",
-      "name": "BUILDCHAIN_RUNTIME_CONTRACT_WORLD",
-      "kind": "constant",
-      "signature": "const BUILDCHAIN_RUNTIME_CONTRACT_WORLD",
-      "parameters": [],
-      "returns": "value",
+      "id": "packages/core/buildchain-config.js#getNativeDiagnosticsProfile",
+      "name": "getNativeDiagnosticsProfile",
+      "kind": "function",
+      "signature": "function getNativeDiagnosticsProfile(loadedConfig)",
+      "parameters": [
+        {
+          "name": "loadedConfig",
+          "signature": "loadedConfig"
+        }
+      ],
+      "returns": "unknown",
       "errors": [
-        "Import does not declare a throw contract."
+        "May throw an Error on rejected input or failed operations; follow the linked source contract."
       ],
       "sideEffects": [
-        "none-on-import"
+        "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-contract.js",
-        "line": 7
+        "path": "packages/core/buildchain-config.js",
+        "line": 585
       },
-      "example": "import { BUILDCHAIN_RUNTIME_CONTRACT_WORLD } from \"@kungfu-tech/buildchain\";",
+      "example": "import { getNativeDiagnosticsProfile } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1854,22 +1865,14 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#contractSummary",
-      "name": "contractSummary",
+      "id": "packages/core/buildchain-config.js#getPublishContract",
+      "name": "getPublishContract",
       "kind": "function",
-      "signature": "function contractSummary(contractWorld, runtimeRef = \"\", runtimeSha = \"\")",
+      "signature": "function getPublishContract(loadedConfig)",
       "parameters": [
         {
-          "name": "contractWorld",
-          "signature": "contractWorld"
-        },
-        {
-          "name": "runtimeRef",
-          "signature": "runtimeRef = \"\""
-        },
-        {
-          "name": "runtimeSha",
-          "signature": "runtimeSha = \"\""
+          "name": "loadedConfig",
+          "signature": "loadedConfig"
         }
       ],
       "returns": "unknown",
@@ -1880,10 +1883,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-contract.js",
-        "line": 973
+        "path": "packages/core/buildchain-config.js",
+        "line": 1436
       },
-      "example": "import { contractSummary } from \"@kungfu-tech/buildchain\";",
+      "example": "import { getPublishContract } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1891,14 +1894,14 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#createBuildchainContractLock",
-      "name": "createBuildchainContractLock",
+      "id": "packages/core/buildchain-config.js#getStableReleasePolicy",
+      "name": "getStableReleasePolicy",
       "kind": "function",
-      "signature": "function createBuildchainContractLock({ buildchainRef = \"v3\", resolvedSha = \"\", contractWorld, compatibilityPolicy = DEFAULT_POLICY, acceptedAt = new Date().toISOString(), } = {})",
+      "signature": "function getStableReleasePolicy(loadedConfig)",
       "parameters": [
         {
-          "name": "parameter1",
-          "signature": "{ buildchainRef = \"v3\", resolvedSha = \"\", contractWorld, compatibilityPolicy = DEFAULT_POLICY, acceptedAt = new Date().toISOString(), } = {}"
+          "name": "loadedConfig",
+          "signature": "loadedConfig"
         }
       ],
       "returns": "unknown",
@@ -1909,10 +1912,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-contract.js",
-        "line": 815
+        "path": "packages/core/buildchain-config.js",
+        "line": 353
       },
-      "example": "import { createBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
+      "example": "import { getStableReleasePolicy } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1920,14 +1923,14 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#createBuildchainContractWorld",
-      "name": "createBuildchainContractWorld",
+      "id": "packages/core/buildchain-config.js#getVersionStrategy",
+      "name": "getVersionStrategy",
       "kind": "function",
-      "signature": "function createBuildchainContractWorld({ root = process.cwd(), packageJson = undefined, controllerRegistry = undefined, } = {})",
+      "signature": "function getVersionStrategy(loadedConfig)",
       "parameters": [
         {
-          "name": "parameter1",
-          "signature": "{ root = process.cwd(), packageJson = undefined, controllerRegistry = undefined, } = {}"
+          "name": "loadedConfig",
+          "signature": "loadedConfig"
         }
       ],
       "returns": "unknown",
@@ -1938,10 +1941,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-contract.js",
-        "line": 110
+        "path": "packages/core/buildchain-config.js",
+        "line": 1560
       },
-      "example": "import { createBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
+      "example": "import { getVersionStrategy } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1949,14 +1952,14 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#evaluateBuildchainContractLock",
-      "name": "evaluateBuildchainContractLock",
+      "id": "packages/core/buildchain-config.js#loadBuildchainConfig",
+      "name": "loadBuildchainConfig",
       "kind": "function",
-      "signature": "function evaluateBuildchainContractLock({ lock, current, runtimeRef = \"\", runtimeSha = \"\", runtimeClass = \"\", compatibilityPolicy = \"\", } = {})",
+      "signature": "function loadBuildchainConfig(cwd = process.cwd())",
       "parameters": [
         {
-          "name": "parameter1",
-          "signature": "{ lock, current, runtimeRef = \"\", runtimeSha = \"\", runtimeClass = \"\", compatibilityPolicy = \"\", } = {}"
+          "name": "cwd",
+          "signature": "cwd = process.cwd()"
         }
       ],
       "returns": "unknown",
@@ -1967,10 +1970,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-contract.js",
-        "line": 881
+        "path": "packages/core/buildchain-config.js",
+        "line": 183
       },
-      "example": "import { evaluateBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
+      "example": "import { loadBuildchainConfig } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -1978,28 +1981,32 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#finalizeBuildchainContractWorld",
-      "name": "finalizeBuildchainContractWorld",
+      "id": "packages/core/buildchain-config.js#loadConfiguredAnchorManifest",
+      "name": "loadConfiguredAnchorManifest",
       "kind": "function",
-      "signature": "function finalizeBuildchainContractWorld(contractWorld)",
+      "signature": "function loadConfiguredAnchorManifest(cwd = process.cwd(), loadedConfig = loadBuildchainConfig(cwd))",
       "parameters": [
         {
-          "name": "contractWorld",
-          "signature": "contractWorld"
+          "name": "cwd",
+          "signature": "cwd = process.cwd()"
+        },
+        {
+          "name": "loadedConfig",
+          "signature": "loadedConfig = loadBuildchainConfig(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-contract.js",
-        "line": 790
+        "path": "packages/core/buildchain-config.js",
+        "line": 1569
       },
-      "example": "import { finalizeBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
+      "example": "import { loadConfiguredAnchorManifest } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -2007,14 +2014,14 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#readBuildchainContractLock",
-      "name": "readBuildchainContractLock",
+      "id": "packages/core/buildchain-config.js#normalizeBuildchainConfig",
+      "name": "normalizeBuildchainConfig",
       "kind": "function",
-      "signature": "function readBuildchainContractLock(filePath)",
+      "signature": "function normalizeBuildchainConfig(config)",
       "parameters": [
         {
-          "name": "filePath",
-          "signature": "filePath"
+          "name": "config",
+          "signature": "config"
         }
       ],
       "returns": "unknown",
@@ -2025,10 +2032,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-contract.js",
-        "line": 866
+        "path": "packages/core/buildchain-config.js",
+        "line": 206
       },
-      "example": "import { readBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
+      "example": "import { normalizeBuildchainConfig } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -2036,14 +2043,22 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#readBuildchainContractWorld",
-      "name": "readBuildchainContractWorld",
+      "id": "packages/core/buildchain-config.js#normalizeLifecycleStage",
+      "name": "normalizeLifecycleStage",
       "kind": "function",
-      "signature": "function readBuildchainContractWorld(filePath)",
+      "signature": "function normalizeLifecycleStage(stage, label = \"lifecycle stage\", lifecycle = {})",
       "parameters": [
         {
-          "name": "filePath",
-          "signature": "filePath"
+          "name": "stage",
+          "signature": "stage"
+        },
+        {
+          "name": "label",
+          "signature": "label = \"lifecycle stage\""
+        },
+        {
+          "name": "lifecycle",
+          "signature": "lifecycle = {}"
         }
       ],
       "returns": "unknown",
@@ -2054,10 +2069,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/buildchain-contract.js",
-        "line": 846
+        "path": "packages/core/buildchain-config.js",
+        "line": 1393
       },
-      "example": "import { readBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
+      "example": "import { normalizeLifecycleStage } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -2065,28 +2080,28 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#renderBuildchainContractDriftIssueBody",
-      "name": "renderBuildchainContractDriftIssueBody",
+      "id": "packages/core/buildchain-config.js#runLifecycleStage",
+      "name": "runLifecycleStage",
       "kind": "function",
-      "signature": "function renderBuildchainContractDriftIssueBody({ repository = \"\", workflow = \"\", runUrl = \"\", lockPath = \"\", evaluation, } = {})",
+      "signature": "function runLifecycleStage({ cwd = process.cwd(), loadedConfig, name, stage, env: extraEnv, timeoutMinutes })",
       "parameters": [
         {
           "name": "parameter1",
-          "signature": "{ repository = \"\", workflow = \"\", runUrl = \"\", lockPath = \"\", evaluation, } = {}"
+          "signature": "{ cwd = process.cwd(), loadedConfig, name, stage, env: extraEnv, timeoutMinutes }"
         }
       ],
       "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"
+        "subprocess"
       ],
       "source": {
-        "path": "packages/core/buildchain-contract.js",
-        "line": 985
+        "path": "packages/core/buildchain-config.js",
+        "line": 1440
       },
-      "example": "import { renderBuildchainContractDriftIssueBody } from \"@kungfu-tech/buildchain\";",
+      "example": "import { runLifecycleStage } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -2094,28 +2109,32 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#sha256BuildchainContractJson",
-      "name": "sha256BuildchainContractJson",
+      "id": "packages/core/buildchain-config.js#updateConfiguredVersionStateContents",
+      "name": "updateConfiguredVersionStateContents",
       "kind": "function",
-      "signature": "function sha256Json(value)",
+      "signature": "function updateConfiguredVersionStateContents(files, version)",
       "parameters": [
         {
-          "name": "value",
-          "signature": "value"
+          "name": "files",
+          "signature": "files"
+        },
+        {
+          "name": "version",
+          "signature": "version"
         }
       ],
       "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"
+        "may-write-or-invoke-external-actions"
       ],
       "source": {
-        "path": "packages/core/buildchain-contract.js",
-        "line": 30
+        "path": "packages/core/buildchain-config.js",
+        "line": 1740
       },
-      "example": "import { sha256BuildchainContractJson } from \"@kungfu-tech/buildchain\";",
+      "example": "import { updateConfiguredVersionStateContents } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -2123,28 +2142,32 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#sha256File",
-      "name": "sha256File",
+      "id": "packages/core/buildchain-config.js#validateBuildchainConfig",
+      "name": "validateBuildchainConfig",
       "kind": "function",
-      "signature": "function sha256File(filePath)",
+      "signature": "function validateBuildchainConfig(cwd = process.cwd(), { requireConfig = true, requireVersionState = false, requireLifecycleStages = [], } = {})",
       "parameters": [
         {
-          "name": "filePath",
-          "signature": "filePath"
+          "name": "cwd",
+          "signature": "cwd = process.cwd()"
+        },
+        {
+          "name": "parameter2",
+          "signature": "{ requireConfig = true, requireVersionState = false, requireLifecycleStages = [], } = {}"
         }
       ],
       "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-contract.js",
-        "line": 34
+        "path": "packages/core/buildchain-config.js",
+        "line": 1607
       },
-      "example": "import { sha256File } from \"@kungfu-tech/buildchain/buildchain-contract\";",
+      "example": "import { validateBuildchainConfig } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -2152,17 +2175,94 @@
       ]
     },
     {
-      "id": "packages/core/buildchain-contract.js#sha256Json",
-      "name": "sha256Json",
-      "kind": "function",
-      "signature": "function sha256Json(value)",
-      "parameters": [
-        {
-          "name": "value",
-          "signature": "value"
-        }
-      ],
-      "returns": "unknown",
+      "id": "packages/core/buildchain-contract.js#BUILDCHAIN_CONTRACT_LOCK",
+      "name": "BUILDCHAIN_CONTRACT_LOCK",
+      "kind": "constant",
+      "signature": "const BUILDCHAIN_CONTRACT_LOCK",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/buildchain-contract.js",
+        "line": 29
+      },
+      "example": "import { BUILDCHAIN_CONTRACT_LOCK } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/buildchain-contract.js#BUILDCHAIN_RUNTIME_CONTRACT_WORLD",
+      "name": "BUILDCHAIN_RUNTIME_CONTRACT_WORLD",
+      "kind": "constant",
+      "signature": "const BUILDCHAIN_RUNTIME_CONTRACT_WORLD",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/buildchain-contract.js",
+        "line": 28
+      },
+      "example": "import { BUILDCHAIN_RUNTIME_CONTRACT_WORLD } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/buildchain-contract.js#createBuildchainContractLock",
+      "name": "createBuildchainContractLock",
+      "kind": "function",
+      "signature": "function createBuildchainContractLock({ buildchainRef = \"v3\", resolvedSha = \"\", contractWorld, compatibilityPolicy = DEFAULT_POLICY, acceptedAt = new Date().toISOString(), } = {})",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ buildchainRef = \"v3\", resolvedSha = \"\", contractWorld, compatibilityPolicy = DEFAULT_POLICY, acceptedAt = new Date().toISOString(), } = {}"
+        }
+      ],
+      "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/buildchain-contract.js",
+        "line": 839
+      },
+      "example": "import { createBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/buildchain-contract.js#createBuildchainContractWorld",
+      "name": "createBuildchainContractWorld",
+      "kind": "function",
+      "signature": "function createBuildchainContractWorld({ root = process.cwd(), packageJson = undefined, controllerRegistry = undefined, } = {})",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ root = process.cwd(), packageJson = undefined, controllerRegistry = undefined, } = {}"
+        }
+      ],
+      "returns": "unknown",
       "errors": [
         "Errors from called operations may propagate; no narrower throw contract is declared in source."
       ],
@@ -2171,7 +2271,181 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 30
+        "line": 130
+      },
+      "example": "import { createBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/buildchain-contract.js#finalizeBuildchainContractWorld",
+      "name": "finalizeBuildchainContractWorld",
+      "kind": "function",
+      "signature": "function finalizeBuildchainContractWorld(contractWorld)",
+      "parameters": [
+        {
+          "name": "contractWorld",
+          "signature": "contractWorld"
+        }
+      ],
+      "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/buildchain-contract.js",
+        "line": 794
+      },
+      "example": "import { finalizeBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/buildchain-contract.js#readBuildchainContractLock",
+      "name": "readBuildchainContractLock",
+      "kind": "function",
+      "signature": "function readBuildchainContractLock(filePath)",
+      "parameters": [
+        {
+          "name": "filePath",
+          "signature": "filePath"
+        }
+      ],
+      "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/buildchain-contract.js",
+        "line": 893
+      },
+      "example": "import { readBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/buildchain-contract.js#readBuildchainContractWorld",
+      "name": "readBuildchainContractWorld",
+      "kind": "function",
+      "signature": "function readBuildchainContractWorld(filePath)",
+      "parameters": [
+        {
+          "name": "filePath",
+          "signature": "filePath"
+        }
+      ],
+      "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/buildchain-contract.js",
+        "line": 872
+      },
+      "example": "import { readBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/buildchain-contract.js#sha256BuildchainContractJson",
+      "name": "sha256BuildchainContractJson",
+      "kind": "function",
+      "signature": "function sha256Json(value)",
+      "parameters": [
+        {
+          "name": "value",
+          "signature": "value"
+        }
+      ],
+      "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/buildchain-contract.js",
+        "line": 50
+      },
+      "example": "import { sha256BuildchainContractJson } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/buildchain-contract.js#sha256File",
+      "name": "sha256File",
+      "kind": "function",
+      "signature": "function sha256File(filePath)",
+      "parameters": [
+        {
+          "name": "filePath",
+          "signature": "filePath"
+        }
+      ],
+      "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/buildchain-contract.js",
+        "line": 54
+      },
+      "example": "import { sha256File } from \"@kungfu-tech/buildchain/buildchain-contract\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/buildchain-contract.js#sha256Json",
+      "name": "sha256Json",
+      "kind": "function",
+      "signature": "function sha256Json(value)",
+      "parameters": [
+        {
+          "name": "value",
+          "signature": "value"
+        }
+      ],
+      "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/buildchain-contract.js",
+        "line": 50
       },
       "example": "import { sha256Json } from \"@kungfu-tech/buildchain/buildchain-contract\";",
       "maturity": "stable",
@@ -6200,7 +6474,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper-github-client.js",
-        "line": 53
+        "line": 54
       },
       "example": "import { GitHubHousekeeperClient } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6224,7 +6498,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper-github-client.js",
-        "line": 36
+        "line": 37
       },
       "example": "import { GitHubHousekeeperProviderError } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6253,7 +6527,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper-github.js",
-        "line": 409
+        "line": 615
       },
       "example": "import { applyGitHubHousekeeperPlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6282,7 +6556,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper-github.js",
-        "line": 110
+        "line": 246
       },
       "example": "import { collectGitHubHousekeeperInventory } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6311,7 +6585,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper-github.js",
-        "line": 491
+        "line": 697
       },
       "example": "import { formatGitHubHousekeeperPlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6340,7 +6614,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper-github.js",
-        "line": 485
+        "line": 691
       },
       "example": "import { runGitHubHousekeeper } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6373,7 +6647,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper.js",
-        "line": 92
+        "line": 105
       },
       "example": "import { classifyHousekeeperBranch } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6406,7 +6680,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper.js",
-        "line": 129
+        "line": 144
       },
       "example": "import { classifyHousekeeperPullRequest } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6439,7 +6713,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper.js",
-        "line": 250
+        "line": 265
       },
       "example": "import { classifyHousekeeperReplay } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6468,7 +6742,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper.js",
-        "line": 155
+        "line": 170
       },
       "example": "import { createEngineeringHousekeeperPlan } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6497,7 +6771,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper.js",
-        "line": 231
+        "line": 246
       },
       "example": "import { createEngineeringHousekeeperReceipt } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6521,7 +6795,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper.js",
-        "line": 28
+        "line": 29
       },
       "example": "import { DEFAULT_HOUSEKEEPER_POLICY } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6598,7 +6872,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper.js",
-        "line": 49
+        "line": 58
       },
       "example": "import { engineeringHousekeeperRoot } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -6659,7 +6933,7 @@
       ],
       "source": {
         "path": "packages/core/engineering-housekeeper.js",
-        "line": 208
+        "line": 223
       },
       "example": "import { revalidateHousekeeperBranchAction } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -18597,25 +18871,453 @@
       "id": "packages/core/release-tail-provider-plane.js#createReleaseTailTransaction",
       "name": "createReleaseTailTransaction",
       "kind": "function",
-      "signature": "function createReleaseTailTransaction(input)",
+      "signature": "function createReleaseTailTransaction(input)",
+      "parameters": [
+        {
+          "name": "input",
+          "signature": "input"
+        }
+      ],
+      "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/release-tail-provider-plane.js",
+        "line": 697
+      },
+      "example": "import { createReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#executeReleaseTailTransaction",
+      "name": "executeReleaseTailTransaction",
+      "kind": "function",
+      "signature": "async function executeReleaseTailTransaction(transaction, { adapters, checkpoint: checkpointCallback } = {})",
+      "parameters": [
+        {
+          "name": "transaction",
+          "signature": "transaction"
+        },
+        {
+          "name": "parameter2",
+          "signature": "{ adapters, checkpoint: checkpointCallback } = {}"
+        }
+      ],
+      "returns": "Promise<unknown>",
+      "errors": [
+        "May throw an Error on rejected input or failed operations; follow the linked source contract."
+      ],
+      "sideEffects": [
+        "may-write-or-invoke-external-actions"
+      ],
+      "source": {
+        "path": "packages/core/release-tail-provider-plane.js",
+        "line": 1016
+      },
+      "example": "import { executeReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#parseReleaseTailDeclaration",
+      "name": "parseReleaseTailDeclaration",
+      "kind": "function",
+      "signature": "function parseReleaseTailDeclaration(input)",
+      "parameters": [
+        {
+          "name": "input",
+          "signature": "input"
+        }
+      ],
+      "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/release-tail-provider-plane.js",
+        "line": 491
+      },
+      "example": "import { parseReleaseTailDeclaration } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#readReleaseTailTransaction",
+      "name": "readReleaseTailTransaction",
+      "kind": "function",
+      "signature": "function readReleaseTailTransaction(filePath)",
+      "parameters": [
+        {
+          "name": "filePath",
+          "signature": "filePath"
+        }
+      ],
+      "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/release-tail-provider-plane.js",
+        "line": 830
+      },
+      "example": "import { readReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_CAPABILITY_REGISTRY",
+      "name": "RELEASE_TAIL_CAPABILITY_REGISTRY",
+      "kind": "constant",
+      "signature": "const RELEASE_TAIL_CAPABILITY_REGISTRY",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-tail-provider-plane.js",
+        "line": 31
+      },
+      "example": "import { RELEASE_TAIL_CAPABILITY_REGISTRY } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_DECLARATION_CONTRACT",
+      "name": "RELEASE_TAIL_DECLARATION_CONTRACT",
+      "kind": "constant",
+      "signature": "const RELEASE_TAIL_DECLARATION_CONTRACT",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-tail-provider-plane.js",
+        "line": 5
+      },
+      "example": "import { RELEASE_TAIL_DECLARATION_CONTRACT } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_EFFECT_SCHEMA",
+      "name": "RELEASE_TAIL_EFFECT_SCHEMA",
+      "kind": "constant",
+      "signature": "const RELEASE_TAIL_EFFECT_SCHEMA",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-tail-provider-plane.js",
+        "line": 10
+      },
+      "example": "import { RELEASE_TAIL_EFFECT_SCHEMA } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_OBSERVATION_SCHEMA",
+      "name": "RELEASE_TAIL_OBSERVATION_SCHEMA",
+      "kind": "constant",
+      "signature": "const RELEASE_TAIL_OBSERVATION_SCHEMA",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-tail-provider-plane.js",
+        "line": 12
+      },
+      "example": "import { RELEASE_TAIL_OBSERVATION_SCHEMA } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_RECEIPT_SCHEMA",
+      "name": "RELEASE_TAIL_RECEIPT_SCHEMA",
+      "kind": "constant",
+      "signature": "const RELEASE_TAIL_RECEIPT_SCHEMA",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-tail-provider-plane.js",
+        "line": 14
+      },
+      "example": "import { RELEASE_TAIL_RECEIPT_SCHEMA } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_STATES",
+      "name": "RELEASE_TAIL_STATES",
+      "kind": "constant",
+      "signature": "const RELEASE_TAIL_STATES",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-tail-provider-plane.js",
+        "line": 17
+      },
+      "example": "import { RELEASE_TAIL_STATES } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_TRANSACTION_POLICY",
+      "name": "RELEASE_TAIL_TRANSACTION_POLICY",
+      "kind": "constant",
+      "signature": "const RELEASE_TAIL_TRANSACTION_POLICY",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-tail-provider-plane.js",
+        "line": 7
+      },
+      "example": "import { RELEASE_TAIL_TRANSACTION_POLICY } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_TRANSACTION_SCHEMA",
+      "name": "RELEASE_TAIL_TRANSACTION_SCHEMA",
+      "kind": "constant",
+      "signature": "const RELEASE_TAIL_TRANSACTION_SCHEMA",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-tail-provider-plane.js",
+        "line": 8
+      },
+      "example": "import { RELEASE_TAIL_TRANSACTION_SCHEMA } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#releaseTailRetryPolicyFromDeclaration",
+      "name": "releaseTailRetryPolicyFromDeclaration",
+      "kind": "function",
+      "signature": "function releaseTailRetryPolicyFromDeclaration(input)",
+      "parameters": [
+        {
+          "name": "input",
+          "signature": "input"
+        }
+      ],
+      "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/release-tail-provider-plane.js",
+        "line": 1207
+      },
+      "example": "import { releaseTailRetryPolicyFromDeclaration } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#releaseTailRoot",
+      "name": "releaseTailRoot",
+      "kind": "function",
+      "signature": "function releaseTailRoot(value)",
+      "parameters": [
+        {
+          "name": "value",
+          "signature": "value"
+        }
+      ],
+      "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/release-tail-provider-plane.js",
+        "line": 164
+      },
+      "example": "import { releaseTailRoot } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#releaseTailStableJson",
+      "name": "releaseTailStableJson",
+      "kind": "function",
+      "signature": "function releaseTailStableJson(value)",
+      "parameters": [
+        {
+          "name": "value",
+          "signature": "value"
+        }
+      ],
+      "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/release-tail-provider-plane.js",
+        "line": 149
+      },
+      "example": "import { releaseTailStableJson } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#validateReleaseTailEffectPlan",
+      "name": "validateReleaseTailEffectPlan",
+      "kind": "function",
+      "signature": "function validateReleaseTailEffectPlan(plan)",
+      "parameters": [
+        {
+          "name": "plan",
+          "signature": "plan"
+        }
+      ],
+      "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/release-tail-provider-plane.js",
+        "line": 602
+      },
+      "example": "import { validateReleaseTailEffectPlan } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-tail-provider-plane.js#validateReleaseTailTransaction",
+      "name": "validateReleaseTailTransaction",
+      "kind": "function",
+      "signature": "function validateReleaseTailTransaction(transaction)",
       "parameters": [
         {
-          "name": "input",
-          "signature": "input"
+          "name": "transaction",
+          "signature": "transaction"
         }
       ],
       "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": 744
       },
-      "example": "import { createReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
+      "example": "import { validateReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18623,32 +19325,32 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#executeReleaseTailTransaction",
-      "name": "executeReleaseTailTransaction",
+      "id": "packages/core/release-tail-provider-plane.js#writeReleaseTailTransaction",
+      "name": "writeReleaseTailTransaction",
       "kind": "function",
-      "signature": "async function executeReleaseTailTransaction(transaction, { adapters, checkpoint: checkpointCallback } = {})",
+      "signature": "function writeReleaseTailTransaction(filePath, transaction)",
       "parameters": [
         {
-          "name": "transaction",
-          "signature": "transaction"
+          "name": "filePath",
+          "signature": "filePath"
         },
         {
-          "name": "parameter2",
-          "signature": "{ adapters, checkpoint: checkpointCallback } = {}"
+          "name": "transaction",
+          "signature": "transaction"
         }
       ],
-      "returns": "Promise<unknown>",
+      "returns": "unknown",
       "errors": [
         "May throw an Error on rejected input or failed operations; follow the linked source contract."
       ],
       "sideEffects": [
-        "may-write-or-invoke-external-actions"
+        "local-filesystem-write"
       ],
       "source": {
         "path": "packages/core/release-tail-provider-plane.js",
-        "line": 1016
+        "line": 841
       },
-      "example": "import { executeReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
+      "example": "import { writeReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18656,14 +19358,14 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#parseReleaseTailDeclaration",
-      "name": "parseReleaseTailDeclaration",
+      "id": "packages/core/release-train.js#createReleaseCut",
+      "name": "createReleaseCut",
       "kind": "function",
-      "signature": "function parseReleaseTailDeclaration(input)",
+      "signature": "function createReleaseCut(input = {})",
       "parameters": [
         {
           "name": "input",
-          "signature": "input"
+          "signature": "input = {}"
         }
       ],
       "returns": "unknown",
@@ -18674,10 +19376,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 491
+        "path": "packages/core/release-train.js",
+        "line": 179
       },
-      "example": "import { parseReleaseTailDeclaration } from \"@kungfu-tech/buildchain\";",
+      "example": "import { createReleaseCut } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18685,28 +19387,28 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#readReleaseTailTransaction",
-      "name": "readReleaseTailTransaction",
+      "id": "packages/core/release-train.js#createReleaseTrain",
+      "name": "createReleaseTrain",
       "kind": "function",
-      "signature": "function readReleaseTailTransaction(filePath)",
+      "signature": "function createReleaseTrain(input = {})",
       "parameters": [
         {
-          "name": "filePath",
-          "signature": "filePath"
+          "name": "input",
+          "signature": "input = {}"
         }
       ],
       "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": 830
+        "path": "packages/core/release-train.js",
+        "line": 213
       },
-      "example": "import { readReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
+      "example": "import { createReleaseTrain } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18714,10 +19416,10 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_CAPABILITY_REGISTRY",
-      "name": "RELEASE_TAIL_CAPABILITY_REGISTRY",
+      "id": "packages/core/release-train.js#LEGACY_DEV_ALPHA_CANDIDATE_STATE_SCHEMA",
+      "name": "LEGACY_DEV_ALPHA_CANDIDATE_STATE_SCHEMA",
       "kind": "constant",
-      "signature": "const RELEASE_TAIL_CAPABILITY_REGISTRY",
+      "signature": "const LEGACY_DEV_ALPHA_CANDIDATE_STATE_SCHEMA",
       "parameters": [],
       "returns": "value",
       "errors": [
@@ -18727,10 +19429,10 @@
         "none-on-import"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 31
+        "path": "packages/core/release-train.js",
+        "line": 11
       },
-      "example": "import { RELEASE_TAIL_CAPABILITY_REGISTRY } from \"@kungfu-tech/buildchain\";",
+      "example": "import { LEGACY_DEV_ALPHA_CANDIDATE_STATE_SCHEMA } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18738,23 +19440,32 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_DECLARATION_CONTRACT",
-      "name": "RELEASE_TAIL_DECLARATION_CONTRACT",
-      "kind": "constant",
-      "signature": "const RELEASE_TAIL_DECLARATION_CONTRACT",
-      "parameters": [],
-      "returns": "value",
+      "id": "packages/core/release-train.js#observeReleaseTrain",
+      "name": "observeReleaseTrain",
+      "kind": "function",
+      "signature": "function observeReleaseTrain(trainInput, input = {})",
+      "parameters": [
+        {
+          "name": "trainInput",
+          "signature": "trainInput"
+        },
+        {
+          "name": "input",
+          "signature": "input = {}"
+        }
+      ],
+      "returns": "unknown",
       "errors": [
-        "Import does not declare a throw contract."
+        "Errors from called operations may propagate; no narrower throw contract is declared in source."
       ],
       "sideEffects": [
-        "none-on-import"
+        "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 5
+        "path": "packages/core/release-train.js",
+        "line": 358
       },
-      "example": "import { RELEASE_TAIL_DECLARATION_CONTRACT } from \"@kungfu-tech/buildchain\";",
+      "example": "import { observeReleaseTrain } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18762,23 +19473,28 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_EFFECT_SCHEMA",
-      "name": "RELEASE_TAIL_EFFECT_SCHEMA",
-      "kind": "constant",
-      "signature": "const RELEASE_TAIL_EFFECT_SCHEMA",
-      "parameters": [],
-      "returns": "value",
+      "id": "packages/core/release-train.js#readReleaseTrain",
+      "name": "readReleaseTrain",
+      "kind": "function",
+      "signature": "function readReleaseTrain(input)",
+      "parameters": [
+        {
+          "name": "input",
+          "signature": "input"
+        }
+      ],
+      "returns": "unknown",
       "errors": [
-        "Import does not declare a throw contract."
+        "May throw an Error on rejected input or failed operations; follow the linked source contract."
       ],
       "sideEffects": [
-        "none-on-import"
+        "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 10
+        "path": "packages/core/release-train.js",
+        "line": 491
       },
-      "example": "import { RELEASE_TAIL_EFFECT_SCHEMA } from \"@kungfu-tech/buildchain\";",
+      "example": "import { readReleaseTrain } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18786,10 +19502,10 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_OBSERVATION_SCHEMA",
-      "name": "RELEASE_TAIL_OBSERVATION_SCHEMA",
+      "id": "packages/core/release-train.js#RELEASE_CUT_CONTRACT",
+      "name": "RELEASE_CUT_CONTRACT",
       "kind": "constant",
-      "signature": "const RELEASE_TAIL_OBSERVATION_SCHEMA",
+      "signature": "const RELEASE_CUT_CONTRACT",
       "parameters": [],
       "returns": "value",
       "errors": [
@@ -18799,10 +19515,10 @@
         "none-on-import"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 12
+        "path": "packages/core/release-train.js",
+        "line": 5
       },
-      "example": "import { RELEASE_TAIL_OBSERVATION_SCHEMA } from \"@kungfu-tech/buildchain\";",
+      "example": "import { RELEASE_CUT_CONTRACT } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18810,10 +19526,10 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_RECEIPT_SCHEMA",
-      "name": "RELEASE_TAIL_RECEIPT_SCHEMA",
+      "id": "packages/core/release-train.js#RELEASE_TRAIN_CONTRACT",
+      "name": "RELEASE_TRAIN_CONTRACT",
       "kind": "constant",
-      "signature": "const RELEASE_TAIL_RECEIPT_SCHEMA",
+      "signature": "const RELEASE_TRAIN_CONTRACT",
       "parameters": [],
       "returns": "value",
       "errors": [
@@ -18823,10 +19539,10 @@
         "none-on-import"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 14
+        "path": "packages/core/release-train.js",
+        "line": 6
       },
-      "example": "import { RELEASE_TAIL_RECEIPT_SCHEMA } from \"@kungfu-tech/buildchain\";",
+      "example": "import { RELEASE_TRAIN_CONTRACT } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18834,10 +19550,10 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_STATES",
-      "name": "RELEASE_TAIL_STATES",
+      "id": "packages/core/release-train.js#RELEASE_TRAIN_OBSERVATION_CONTRACT",
+      "name": "RELEASE_TRAIN_OBSERVATION_CONTRACT",
       "kind": "constant",
-      "signature": "const RELEASE_TAIL_STATES",
+      "signature": "const RELEASE_TRAIN_OBSERVATION_CONTRACT",
       "parameters": [],
       "returns": "value",
       "errors": [
@@ -18847,10 +19563,10 @@
         "none-on-import"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 17
+        "path": "packages/core/release-train.js",
+        "line": 9
       },
-      "example": "import { RELEASE_TAIL_STATES } from \"@kungfu-tech/buildchain\";",
+      "example": "import { RELEASE_TRAIN_OBSERVATION_CONTRACT } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18858,10 +19574,10 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_TRANSACTION_POLICY",
-      "name": "RELEASE_TAIL_TRANSACTION_POLICY",
+      "id": "packages/core/release-train.js#RELEASE_TRAIN_STATES",
+      "name": "RELEASE_TRAIN_STATES",
       "kind": "constant",
-      "signature": "const RELEASE_TAIL_TRANSACTION_POLICY",
+      "signature": "const RELEASE_TRAIN_STATES",
       "parameters": [],
       "returns": "value",
       "errors": [
@@ -18871,10 +19587,10 @@
         "none-on-import"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 7
+        "path": "packages/core/release-train.js",
+        "line": 14
       },
-      "example": "import { RELEASE_TAIL_TRANSACTION_POLICY } from \"@kungfu-tech/buildchain\";",
+      "example": "import { RELEASE_TRAIN_STATES } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18882,10 +19598,10 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#RELEASE_TAIL_TRANSACTION_SCHEMA",
-      "name": "RELEASE_TAIL_TRANSACTION_SCHEMA",
+      "id": "packages/core/release-train.js#RELEASE_TRAIN_SUPERSESSION_CAUSES",
+      "name": "RELEASE_TRAIN_SUPERSESSION_CAUSES",
       "kind": "constant",
-      "signature": "const RELEASE_TAIL_TRANSACTION_SCHEMA",
+      "signature": "const RELEASE_TRAIN_SUPERSESSION_CAUSES",
       "parameters": [],
       "returns": "value",
       "errors": [
@@ -18895,10 +19611,10 @@
         "none-on-import"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 8
+        "path": "packages/core/release-train.js",
+        "line": 24
       },
-      "example": "import { RELEASE_TAIL_TRANSACTION_SCHEMA } from \"@kungfu-tech/buildchain\";",
+      "example": "import { RELEASE_TRAIN_SUPERSESSION_CAUSES } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18906,28 +19622,23 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#releaseTailRetryPolicyFromDeclaration",
-      "name": "releaseTailRetryPolicyFromDeclaration",
-      "kind": "function",
-      "signature": "function releaseTailRetryPolicyFromDeclaration(input)",
-      "parameters": [
-        {
-          "name": "input",
-          "signature": "input"
-        }
-      ],
-      "returns": "unknown",
+      "id": "packages/core/release-train.js#RELEASE_TRAIN_TRANSITION_CONTRACT",
+      "name": "RELEASE_TRAIN_TRANSITION_CONTRACT",
+      "kind": "constant",
+      "signature": "const RELEASE_TRAIN_TRANSITION_CONTRACT",
+      "parameters": [],
+      "returns": "value",
       "errors": [
-        "Errors from called operations may propagate; no narrower throw contract is declared in source."
+        "Import does not declare a throw contract."
       ],
       "sideEffects": [
-        "none-detected-by-static-source-scan"
+        "none-on-import"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 1207
+        "path": "packages/core/release-train.js",
+        "line": 7
       },
-      "example": "import { releaseTailRetryPolicyFromDeclaration } from \"@kungfu-tech/buildchain\";",
+      "example": "import { RELEASE_TRAIN_TRANSITION_CONTRACT } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18935,10 +19646,10 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#releaseTailRoot",
-      "name": "releaseTailRoot",
+      "id": "packages/core/release-train.js#releaseTrainRoot",
+      "name": "releaseTrainRoot",
       "kind": "function",
-      "signature": "function releaseTailRoot(value)",
+      "signature": "function releaseTrainRoot(value)",
       "parameters": [
         {
           "name": "value",
@@ -18953,10 +19664,10 @@
         "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 164
+        "path": "packages/core/release-train.js",
+        "line": 71
       },
-      "example": "import { releaseTailRoot } from \"@kungfu-tech/buildchain\";",
+      "example": "import { releaseTrainRoot } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -18964,43 +19675,18 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#releaseTailStableJson",
-      "name": "releaseTailStableJson",
+      "id": "packages/core/release-train.js#transitionReleaseTrain",
+      "name": "transitionReleaseTrain",
       "kind": "function",
-      "signature": "function releaseTailStableJson(value)",
+      "signature": "function transitionReleaseTrain(trainInput, input = {})",
       "parameters": [
         {
-          "name": "value",
-          "signature": "value"
-        }
-      ],
-      "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/release-tail-provider-plane.js",
-        "line": 149
-      },
-      "example": "import { releaseTailStableJson } from \"@kungfu-tech/buildchain\";",
-      "maturity": "stable",
-      "audience": [
-        "developer",
-        "agent"
-      ]
-    },
-    {
-      "id": "packages/core/release-tail-provider-plane.js#validateReleaseTailEffectPlan",
-      "name": "validateReleaseTailEffectPlan",
-      "kind": "function",
-      "signature": "function validateReleaseTailEffectPlan(plan)",
-      "parameters": [
+          "name": "trainInput",
+          "signature": "trainInput"
+        },
         {
-          "name": "plan",
-          "signature": "plan"
+          "name": "input",
+          "signature": "input = {}"
         }
       ],
       "returns": "unknown",
@@ -19008,13 +19694,13 @@
         "Errors from called operations may propagate; no narrower throw contract is declared in source."
       ],
       "sideEffects": [
-        "none-detected-by-static-source-scan"
+        "may-write-or-invoke-external-actions"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 602
+        "path": "packages/core/release-train.js",
+        "line": 336
       },
-      "example": "import { validateReleaseTailEffectPlan } from \"@kungfu-tech/buildchain\";",
+      "example": "import { transitionReleaseTrain } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -19022,28 +19708,28 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#validateReleaseTailTransaction",
-      "name": "validateReleaseTailTransaction",
+      "id": "packages/core/release-train.js#validateReleaseCut",
+      "name": "validateReleaseCut",
       "kind": "function",
-      "signature": "function validateReleaseTailTransaction(transaction)",
+      "signature": "function validateReleaseCut(cut)",
       "parameters": [
         {
-          "name": "transaction",
-          "signature": "transaction"
+          "name": "cut",
+          "signature": "cut"
         }
       ],
       "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": 744
+        "path": "packages/core/release-train.js",
+        "line": 229
       },
-      "example": "import { validateReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
+      "example": "import { validateReleaseCut } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -19051,18 +19737,14 @@
       ]
     },
     {
-      "id": "packages/core/release-tail-provider-plane.js#writeReleaseTailTransaction",
-      "name": "writeReleaseTailTransaction",
+      "id": "packages/core/release-train.js#validateReleaseTrain",
+      "name": "validateReleaseTrain",
       "kind": "function",
-      "signature": "function writeReleaseTailTransaction(filePath, transaction)",
+      "signature": "function validateReleaseTrain(input)",
       "parameters": [
         {
-          "name": "filePath",
-          "signature": "filePath"
-        },
-        {
-          "name": "transaction",
-          "signature": "transaction"
+          "name": "input",
+          "signature": "input"
         }
       ],
       "returns": "unknown",
@@ -19070,13 +19752,13 @@
         "May throw an Error on rejected input or failed operations; follow the linked source contract."
       ],
       "sideEffects": [
-        "local-filesystem-write"
+        "none-detected-by-static-source-scan"
       ],
       "source": {
-        "path": "packages/core/release-tail-provider-plane.js",
-        "line": 841
+        "path": "packages/core/release-train.js",
+        "line": 362
       },
-      "example": "import { writeReleaseTailTransaction } from \"@kungfu-tech/buildchain\";",
+      "example": "import { validateReleaseTrain } from \"@kungfu-tech/buildchain/release-train\";",
       "maturity": "stable",
       "audience": [
         "developer",
@@ -19816,7 +20498,7 @@
         "packages/core/issue-reporting.js#computeConsumerIssueFingerprint",
         "packages/core/publication-authority.js#CONSUMER_PUBLICATION_DECISION_CONTRACT",
         "packages/core/issue-reporting.js#consumerIssueMarker",
-        "packages/core/buildchain-contract.js#contractSummary",
+        "packages/core/buildchain-compatibility-proof.js#contractSummary",
         "packages/core/controller-evidence.js#controllerEvidenceDigest",
         "packages/core/release-tail-provider-adapters.js#createActivationReceiptProjectorAdapter",
         "packages/core/anchored-version-material.js#createAnchoredVersionMaterialEvidence",
@@ -19932,7 +20614,7 @@
         "packages/core/public-surface-audit.js#enumerateDocCommandRefs",
         "packages/core/public-surface-audit.js#enumerateSitePages",
         "packages/core/public-surface-audit.js#enumerateWorkflowInputs",
-        "packages/core/buildchain-contract.js#evaluateBuildchainContractLock",
+        "packages/core/buildchain-compatibility-proof.js#evaluateBuildchainContractLock",
         "packages/core/github-governance-authority.js#evaluateCodeownersAuthority",
         "packages/core/github-governance-authority.js#evaluateGithubGovernanceSnapshot",
         "packages/core/kfd-product-gates.js#evaluateKfdProductGate",
@@ -20172,7 +20854,7 @@
         "packages/core/release-tail-provider-plane.js#releaseTailRoot",
         "packages/core/release-tail-provider-plane.js#releaseTailStableJson",
         "packages/core/readme-badges.js#renderBadgeBundleBlock",
-        "packages/core/buildchain-contract.js#renderBuildchainContractDriftIssueBody",
+        "packages/core/buildchain-compatibility-proof.js#renderBuildchainContractDriftIssueBody",
         "packages/core/homebrew.js#renderHomebrewFormula",
         "packages/core/kfd2-product-claims.js#renderKfd2ProductClaimOutputs",
         "packages/core/readme-badges.js#renderReadmeBadgeBlock",
@@ -20523,7 +21205,7 @@
         "packages/core/issue-reporting.js#computeConsumerIssueFingerprint",
         "packages/core/publication-authority.js#CONSUMER_PUBLICATION_DECISION_CONTRACT",
         "packages/core/issue-reporting.js#consumerIssueMarker",
-        "packages/core/buildchain-contract.js#contractSummary",
+        "packages/core/buildchain-compatibility-proof.js#contractSummary",
         "packages/core/controller-evidence.js#controllerEvidenceDigest",
         "packages/core/release-tail-provider-adapters.js#createActivationReceiptProjectorAdapter",
         "packages/core/anchored-version-material.js#createAnchoredVersionMaterialEvidence",
@@ -20639,7 +21321,7 @@
         "packages/core/public-surface-audit.js#enumerateDocCommandRefs",
         "packages/core/public-surface-audit.js#enumerateSitePages",
         "packages/core/public-surface-audit.js#enumerateWorkflowInputs",
-        "packages/core/buildchain-contract.js#evaluateBuildchainContractLock",
+        "packages/core/buildchain-compatibility-proof.js#evaluateBuildchainContractLock",
         "packages/core/github-governance-authority.js#evaluateCodeownersAuthority",
         "packages/core/github-governance-authority.js#evaluateGithubGovernanceSnapshot",
         "packages/core/kfd-product-gates.js#evaluateKfdProductGate",
@@ -20879,7 +21561,7 @@
         "packages/core/release-tail-provider-plane.js#releaseTailRoot",
         "packages/core/release-tail-provider-plane.js#releaseTailStableJson",
         "packages/core/readme-badges.js#renderBadgeBundleBlock",
-        "packages/core/buildchain-contract.js#renderBuildchainContractDriftIssueBody",
+        "packages/core/buildchain-compatibility-proof.js#renderBuildchainContractDriftIssueBody",
         "packages/core/homebrew.js#renderHomebrewFormula",
         "packages/core/kfd2-product-claims.js#renderKfd2ProductClaimOutputs",
         "packages/core/readme-badges.js#renderReadmeBadgeBlock",
@@ -21218,27 +21900,37 @@
       "specifier": "@kungfu-tech/buildchain/buildchain-contract",
       "export": "./buildchain-contract",
       "target": "./packages/core/buildchain-contract.js",
-      "digest": "sha256:90e88e4ac4759838afc4d760811ab30aad3e79066ba64fc69c81a31f3fffd291",
+      "digest": "sha256:03ed3b622731f78dce445ef48a2d718ad211ab144fd74686741d547687867a5f",
       "summary": "Runtime contract world and compatibility digest APIs for floating-ref drift checks.",
       "capabilityGroup": "governance-versioning",
       "audience": [
         "developer",
         "agent"
       ],
-      "symbolCount": 12,
+      "symbolCount": 22,
       "symbolIds": [
+        "packages/core/buildchain-compatibility-proof.js#assertBuildchainCompatibilityProjection",
+        "packages/core/buildchain-compatibility-proof.js#BUILDCHAIN_COMPATIBILITY_PROOF_REGISTRY_SCHEMA",
+        "packages/core/buildchain-compatibility-proof.js#BUILDCHAIN_COMPATIBILITY_PROOF_SCHEMA",
+        "packages/core/buildchain-compatibility-proof.js#BUILDCHAIN_COMPATIBILITY_VERIFICATION_RECEIPT_SCHEMA",
         "packages/core/buildchain-contract.js#BUILDCHAIN_CONTRACT_LOCK",
         "packages/core/buildchain-contract.js#BUILDCHAIN_RUNTIME_CONTRACT_WORLD",
-        "packages/core/buildchain-contract.js#contractSummary",
+        "packages/core/buildchain-compatibility-proof.js#contractSummary",
+        "packages/core/buildchain-compatibility-proof.js#createBuildchainCompatibilityProof",
+        "packages/core/buildchain-compatibility-proof.js#createBuildchainCompatibilityProofRegistry",
+        "packages/core/buildchain-compatibility-proof.js#createBuildchainCompatibilityVerificationReceipt",
         "packages/core/buildchain-contract.js#createBuildchainContractLock",
         "packages/core/buildchain-contract.js#createBuildchainContractWorld",
-        "packages/core/buildchain-contract.js#evaluateBuildchainContractLock",
+        "packages/core/buildchain-compatibility-proof.js#createHistoricalBuildchainCompatibilityProofs",
+        "packages/core/buildchain-compatibility-proof.js#evaluateBuildchainContractLock",
         "packages/core/buildchain-contract.js#finalizeBuildchainContractWorld",
         "packages/core/buildchain-contract.js#readBuildchainContractLock",
         "packages/core/buildchain-contract.js#readBuildchainContractWorld",
-        "packages/core/buildchain-contract.js#renderBuildchainContractDriftIssueBody",
+        "packages/core/buildchain-compatibility-proof.js#renderBuildchainContractDriftIssueBody",
         "packages/core/buildchain-contract.js#sha256File",
-        "packages/core/buildchain-contract.js#sha256Json"
+        "packages/core/buildchain-contract.js#sha256Json",
+        "packages/core/buildchain-compatibility-proof.js#verifyBuildchainCompatibilityProof",
+        "packages/core/buildchain-compatibility-proof.js#verifyBuildchainCompatibilityVerificationReceipt"
       ],
       "owner": "buildchain-core",
       "maturity": "stable",
@@ -22179,7 +22871,7 @@
       "specifier": "@kungfu-tech/buildchain/engineering-housekeeper",
       "export": "./engineering-housekeeper",
       "target": "./packages/core/engineering-housekeeper.js",
-      "digest": "sha256:8d2075a7a4836dc8b08bc72e3e08171e3f9bcdbc18e626db912e4048769c627b",
+      "digest": "sha256:702ebe01406f6cecf03b9d5bdd0cd22c1b396c455e769c03d741dcb7a0c29048",
       "summary": "Provider-neutral repository hygiene classification, deterministic plan and receipt, apply-time revalidation, and replay APIs.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -22212,7 +22904,7 @@
       "specifier": "@kungfu-tech/buildchain/engineering-housekeeper-github",
       "export": "./engineering-housekeeper-github",
       "target": "./packages/core/engineering-housekeeper-github.js",
-      "digest": "sha256:fb9a9d15b284236cd4e09aedb238927d6ccd900ff011ad85eb184cecf7105750",
+      "digest": "sha256:d956b0a1790eecec6be5099ca16ffcc19fec0a53cd90366680234a83f1affec6",
       "summary": "Paginated GitHub repository hygiene inventory, default-dry-run execution, exact-head mutation fences, and rooted provider receipts.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -22333,6 +23025,43 @@
       "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/release-train",
+      "export": "./release-train",
+      "target": "./packages/core/release-train.js",
+      "digest": "sha256:16ea77f54dde016af95de9b2c18bfdb925f13fc3d263819eacd1100a111731c4",
+      "summary": "Frozen Release Cut identity, rooted Release Train transitions, Dev observations, supersession, replay, and legacy read compatibility APIs.",
+      "capabilityGroup": "governance-versioning",
+      "audience": [
+        "developer",
+        "agent"
+      ],
+      "symbolCount": 15,
+      "symbolIds": [
+        "packages/core/release-train.js#createReleaseCut",
+        "packages/core/release-train.js#createReleaseTrain",
+        "packages/core/release-train.js#LEGACY_DEV_ALPHA_CANDIDATE_STATE_SCHEMA",
+        "packages/core/release-train.js#observeReleaseTrain",
+        "packages/core/release-train.js#readReleaseTrain",
+        "packages/core/release-train.js#RELEASE_CUT_CONTRACT",
+        "packages/core/release-train.js#RELEASE_TRAIN_CONTRACT",
+        "packages/core/release-train.js#RELEASE_TRAIN_OBSERVATION_CONTRACT",
+        "packages/core/release-train.js#RELEASE_TRAIN_STATES",
+        "packages/core/release-train.js#RELEASE_TRAIN_SUPERSESSION_CAUSES",
+        "packages/core/release-train.js#RELEASE_TRAIN_TRANSITION_CONTRACT",
+        "packages/core/release-train.js#releaseTrainRoot",
+        "packages/core/release-train.js#transitionReleaseTrain",
+        "packages/core/release-train.js#validateReleaseCut",
+        "packages/core/release-train.js#validateReleaseTrain"
+      ],
+      "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."
+    },
     {
       "specifier": "@kungfu-tech/buildchain/stable-candidate-ledger",
       "export": "./stable-candidate-ledger",
@@ -22766,7 +23495,7 @@
     {
       "id": "node-api-reference",
       "path": "docs/node-api-reference.md",
-      "digest": "sha256:ed843753964193ecb59610a54f0f23d76578228ebe6d31d1d6edce526729910c"
+      "digest": "sha256:34f39632494c0f4d4961fd79fc8ac94466da56c29f04f09e706f402d98ef125c"
     },
     {
       "id": "build-facts",
@@ -22791,7 +23520,7 @@
     {
       "id": "site-bundle-contract",
       "path": "docs/site-bundle-contract.md",
-      "digest": "sha256:36a4e60e91f500ea1dcdbef97cd0250a2c26562b98d8d3622e8e0f9df2aad23b"
+      "digest": "sha256:371030eda56d7a968d037e8b9a348e0211038506b8c0b14c539ec790ce884945"
     }
   ],
   "guidance": "These are the public Node import surfaces and symbols shipped by the npm package. Prefer them over internal file paths."