@kungfu-tech/buildchain 3.0.6-alpha.2 → 3.0.6-alpha.3

package/dist/site/capability-registry.json

@@ -51,7 +51,7 @@
         "manualCount": 5,
         "pageCount": 5,
         "cliCommandCount": 25,
-        "nodeApiCount": 11,
+        "nodeApiCount": 12,
         "workflowCount": 3,
         "actionCount": 2
       },
@@ -292,7 +292,7 @@
         "pageCount": 10,
         "cliCommandCount": 0,
         "nodeApiCount": 2,
-        "workflowCount": 39,
+        "workflowCount": 40,
         "actionCount": 1
       },
       "manuals": [

package/dist/site/controller-registry.json

@@ -2091,6 +2091,42 @@
           "classification": "included",
           "source": "workflow-call-input"
         },
+        "resume-buildchain-runtime-sha": {
+          "classification": "included",
+          "source": "workflow-call-input"
+        },
+        "resume-candidate-repository": {
+          "classification": "included",
+          "source": "workflow-call-input"
+        },
+        "resume-candidate-run-id": {
+          "classification": "included",
+          "source": "workflow-call-input"
+        },
+        "resume-expected-candidate-root": {
+          "classification": "included",
+          "source": "workflow-call-input"
+        },
+        "resume-expected-candidate-runtime-sha": {
+          "classification": "included",
+          "source": "workflow-call-input"
+        },
+        "resume-expected-source-tree": {
+          "classification": "included",
+          "source": "workflow-call-input"
+        },
+        "resume-expected-workflow-file": {
+          "classification": "included",
+          "source": "workflow-call-input"
+        },
+        "resume-expected-workflow-name": {
+          "classification": "included",
+          "source": "workflow-call-input"
+        },
+        "resume-transaction-id": {
+          "classification": "included",
+          "source": "workflow-call-input"
+        },
         "runner-preset": {
           "classification": "digest-only",
           "source": "workflow-call-input"
@@ -2153,7 +2189,7 @@
           "controller-receipt"
         ]
       },
-      "digest": "sha256:a13b820669b162ab2f39d213164e7b7ab4e24c65f93cd3265a977fcd667c1303"
+      "digest": "sha256:bc03b3ac295e33b738fe5168e14ebf4d0fabf2325b4ae4a3d2b3c12afe816068"
     },
     {
       "schemaVersion": 1,
@@ -2346,5 +2382,5 @@
       "digest": "sha256:b6f53563c0adc859bc586c05fce560a5094d7d9666438d63c5fd3e1fc4774555"
     }
   ],
-  "digest": "sha256:e7d02924b5f42f513e6f6a3b2cdbccdcd92b594b63ebc7aa8dd8cd3d8376283e"
+  "digest": "sha256:cc205cd0abe4ba5023d8afc38dea9d3f17c06f4a3622a6b8ccd3fc90b10e3fb7"
 }

package/dist/site/kfd-claims.json

@@ -14,17 +14,17 @@
   },
   "runtimeContract": {
     "contract": "kungfu-buildchain-runtime-contract-world",
-    "compatibilityDigest": "sha256:76c3dd58a02887ecd6af33d63e749fef0a988a820fea99bdf4cb078cc48caa83",
+    "compatibilityDigest": "sha256:80cfdf1786019217c439810f1a80d2866bf8f7ef35a6fa569e1a687fb2bf4cbe",
     "majorLine": "v3"
   },
   "publicSurfaceReverseAudit": {
     "contract": "kungfu-buildchain-public-surface-reverse-audit",
     "path": "dist/site/public-surface-audit.json",
     "status": "passed",
-    "sha256": "000be65d0102e56b08a7c98e12836af0b137603e1c438b248f017ac338394271",
+    "sha256": "0bf7f1ba89493e333e8eaf266373f7fefb11c0c7d3b3e7dd7a98d753695e02d5",
     "summary": {
       "cliCommandCount": 112,
-      "workflowCount": 63,
+      "workflowCount": 64,
       "actionCount": 6,
       "sitePageCount": 65,
       "docCommandRefCount": 881,
@@ -246,10 +246,10 @@
       "contract": "kungfu-buildchain-public-surface-reverse-audit",
       "path": "dist/site/public-surface-audit.json",
       "status": "passed",
-      "sha256": "000be65d0102e56b08a7c98e12836af0b137603e1c438b248f017ac338394271",
+      "sha256": "0bf7f1ba89493e333e8eaf266373f7fefb11c0c7d3b3e7dd7a98d753695e02d5",
       "summary": {
         "cliCommandCount": 112,
-        "workflowCount": 63,
+        "workflowCount": 64,
         "actionCount": 6,
         "sitePageCount": 65,
         "docCommandRefCount": 881,
@@ -1628,6 +1628,18 @@
           "public": true,
           "packageExport": "./release-candidate"
         },
+        {
+          "id": "export:./release-candidate-recovery",
+          "name": "@kungfu-tech/buildchain/release-candidate-recovery",
+          "kind": "package-export",
+          "sourcePath": "packages/core/release-candidate-recovery.js",
+          "evidencePath": "packages/core/release-candidate-recovery.js",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "packageExport": "./release-candidate-recovery"
+        },
         {
           "id": "export:./stable-candidate-ledger",
           "name": "@kungfu-tech/buildchain/stable-candidate-ledger",
@@ -3582,7 +3594,7 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 97,
+          "inputCount": 106,
           "inputs": [
             "allow-repository",
             "artifact-name",
@@ -3676,6 +3688,15 @@
             "release-propagation-config-path",
             "required-artifact-count",
             "required-status-check",
+            "resume-buildchain-runtime-sha",
+            "resume-candidate-repository",
+            "resume-candidate-run-id",
+            "resume-expected-candidate-root",
+            "resume-expected-candidate-runtime-sha",
+            "resume-expected-source-tree",
+            "resume-expected-workflow-file",
+            "resume-expected-workflow-name",
+            "resume-transaction-id",
             "runner-preset",
             "standalone-binary-distribution",
             "target-ref",
@@ -4197,6 +4218,20 @@
           "inputs": [],
           "reverseAuditSource": ".github/workflows"
         },
+        {
+          "id": "workflow:buildchain-candidate-recovery-dogfood-failure",
+          "name": "workflow:buildchain-candidate-recovery-dogfood-failure",
+          "kind": "workflow",
+          "sourcePath": ".github/workflows/buildchain-candidate-recovery-dogfood-failure.yml",
+          "evidencePath": ".github/workflows/buildchain-candidate-recovery-dogfood-failure.yml",
+          "availability": "shipped",
+          "visibility": "public",
+          "participantFacing": true,
+          "public": true,
+          "inputCount": 0,
+          "inputs": [],
+          "reverseAuditSource": ".github/workflows"
+        },
         {
           "id": "workflow:buildchain-dev-delivery",
           "name": "workflow:buildchain-dev-delivery",
@@ -4822,7 +4857,7 @@
           "visibility": "public",
           "participantFacing": true,
           "public": true,
-          "inputCount": 89,
+          "inputCount": 98,
           "inputs": [
             "allow-repository",
             "artifact-name",
@@ -4908,6 +4943,15 @@
             "release-propagation-config-path",
             "required-artifact-count",
             "required-status-check",
+            "resume-buildchain-runtime-sha",
+            "resume-candidate-repository",
+            "resume-candidate-run-id",
+            "resume-expected-candidate-root",
+            "resume-expected-candidate-runtime-sha",
+            "resume-expected-source-tree",
+            "resume-expected-workflow-file",
+            "resume-expected-workflow-name",
+            "resume-transaction-id",
             "runner-preset",
             "standalone-binary-distribution",
             "target-ref",
@@ -6303,6 +6347,6 @@
         }
       }
     ],
-    "publicSurfaceCount": 399
+    "publicSurfaceCount": 401
   }
 }

package/dist/site/kfd-upstream-aggregate.json

@@ -4,7 +4,7 @@
   "product": {
     "id": "kungfu-tech-buildchain",
     "name": "@kungfu-tech/buildchain",
-    "version": "3.0.6-alpha.2",
+    "version": "3.0.6-alpha.3",
     "repository": "https://github.com/kungfu-systems/buildchain"
   },
   "source": {

package/dist/site/manual-registry.json

@@ -136,7 +136,7 @@
       "title": "Release Candidate Passport",
       "path": "docs/release-candidate.md",
       "plane": "verify",
-      "digest": "sha256:48e42e92174b1091e8ff32e876099f092ca12ce886d3382f019f0ccd907f1c9b",
+      "digest": "sha256:71161bb57229fe6b66ca131189d3ff3f1dd1a8ca7f6894aa1f596827cb8167f3",
       "capabilityGroup": "reusable-build",
       "audience": [
         "release-operator",
@@ -332,7 +332,7 @@
       "title": "Generated Node API reference",
       "path": "docs/node-api-reference.md",
       "plane": "use",
-      "digest": "sha256:e0e720eeacfa61a1ca235142858f544e18d3f7a000e300a4311e246fe738ff81",
+      "digest": "sha256:3fbfe0227cf929f0ddc2050605d071643cee0b302a4c31920b4f9047c923ae8c",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "agent",
@@ -417,7 +417,7 @@
       "title": "Publish transaction",
       "path": "docs/publish-transaction.md",
       "plane": "verify",
-      "digest": "sha256:3a9ef099d5d93d9b558c7b6a0aa4403dfcce1479ce5d6fc36ecb3e34cdd5bb6d",
+      "digest": "sha256:72466943bb459f6857f23ac6f92bcf4714dcd2f535c38a9f0e34864b36404e06",
       "capabilityGroup": "release-passport-trust",
       "audience": [
         "release-operator"

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

@@ -1881,7 +1881,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 945
+        "line": 973
       },
       "example": "import { contractSummary } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -1910,7 +1910,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 787
+        "line": 815
       },
       "example": "import { createBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -1968,7 +1968,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 853
+        "line": 881
       },
       "example": "import { evaluateBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -1997,7 +1997,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 762
+        "line": 790
       },
       "example": "import { finalizeBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -2026,7 +2026,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 838
+        "line": 866
       },
       "example": "import { readBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -2055,7 +2055,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 818
+        "line": 846
       },
       "example": "import { readBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -2084,7 +2084,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 957
+        "line": 985
       },
       "example": "import { renderBuildchainContractDriftIssueBody } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -14780,6 +14780,112 @@
         "agent"
       ]
     },
+    {
+      "id": "packages/core/release-candidate-recovery.js#recoveryFailure",
+      "name": "recoveryFailure",
+      "kind": "function",
+      "signature": "function recoveryFailure(error)",
+      "parameters": [
+        {
+          "name": "error",
+          "signature": "error"
+        }
+      ],
+      "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-candidate-recovery.js",
+        "line": 376
+      },
+      "example": "import { recoveryFailure } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
+      "name": "RELEASE_CANDIDATE_RECOVERY_CONTRACT",
+      "kind": "constant",
+      "signature": "const RELEASE_CANDIDATE_RECOVERY_CONTRACT",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-candidate-recovery.js",
+        "line": 11
+      },
+      "example": "import { RELEASE_CANDIDATE_RECOVERY_CONTRACT } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
+      "name": "ReleaseCandidateRecoveryError",
+      "kind": "class",
+      "signature": "class ReleaseCandidateRecoveryError",
+      "parameters": [],
+      "returns": "ReleaseCandidateRecoveryError",
+      "errors": [
+        "Construction and method errors follow the linked source implementation."
+      ],
+      "sideEffects": [
+        "class-dependent"
+      ],
+      "source": {
+        "path": "packages/core/release-candidate-recovery.js",
+        "line": 18
+      },
+      "example": "import { ReleaseCandidateRecoveryError } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery",
+      "name": "verifyReleaseCandidateRecovery",
+      "kind": "function",
+      "signature": "function verifyReleaseCandidateRecovery({ candidateRepository, targetRepository, expectedRunId, expectedWorkflowFile, expectedWorkflowName, channel, targetRef, targetSha, targetTree, expectedSourceTree = \"\", expectedCandidateRoot = \"\", expectedRuntimeSha, expectedTransactionId = \"\", existingTransaction = undefined, run, workflow, pullRequest, ancestry, passport, buildSummary, controllerReceipts = [], platformManifests = [], productPayloadManifests = [], artifacts = [], currentToolingSha, recoveryRunId = \"\", createdAt = new Date().toISOString(), } = {})",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ candidateRepository, targetRepository, expectedRunId, expectedWorkflowFile, expectedWorkflowName, channel, targetRef, targetSha, targetTree, expectedSourceTree = \"\", expectedCandidateRoot = \"\", expectedRuntimeSha, expectedTransactionId = \"\", existingTransaction = undefined, run, workflow, pullRequest, ancestry, passport, buildSummary, controllerReceipts = [], platformManifests = [], productPayloadManifests = [], artifacts = [], currentToolingSha, recoveryRunId = \"\", createdAt = new Date().toISOString(), } = {}"
+        }
+      ],
+      "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-candidate-recovery.js",
+        "line": 256
+      },
+      "example": "import { verifyReleaseCandidateRecovery } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
     {
       "id": "packages/core/release-candidate.js#createReleaseCandidatePassport",
       "name": "createReleaseCandidatePassport",
@@ -17516,14 +17622,14 @@
       "specifier": "@kungfu-tech/buildchain",
       "export": ".",
       "target": "./packages/core/index.js",
-      "digest": "sha256:0a415732a05ad95fe9a8ae4da20df826f392c9c5227e9f0eee3722a3d97af49d",
+      "digest": "sha256:6f22c5a7afd733e03d948cd322e01f7255b973780c89a70892c869eb3c15d05f",
       "summary": "Root toolkit export for Buildchain's public Node API.",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "developer",
         "agent"
       ],
-      "symbolCount": 558,
+      "symbolCount": 562,
       "symbolIds": [
         "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
         "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -17944,6 +18050,7 @@
         "packages/core/publish-transaction.js#readReleaseTransaction",
         "packages/core/release-activation-transaction.js#recordReleaseActivationPhase",
         "packages/core/release-propagation-work-transitions.js#recordReleasePropagationStage",
+        "packages/core/release-candidate-recovery.js#recoveryFailure",
         "packages/core/logging.js#redactBuildchainLogAttributes",
         "packages/core/diagnostics.js#redactDiagnosticsValue",
         "packages/core/issue-reporting.js#redactIssueText",
@@ -17953,6 +18060,7 @@
         "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_PHASES",
         "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_RECEIPT_SET_CONTRACT",
         "packages/core/release-candidate.js#RELEASE_CANDIDATE_PASSPORT_CONTRACT",
+        "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
         "packages/core/release-passport.js#RELEASE_CHECK_REPORT_CONTRACT",
         "packages/core/release-passport.js#RELEASE_EVIDENCE_ATTACHMENT_CONTRACT",
         "packages/core/release-passport-contract.js#RELEASE_PASSPORT_CHECK_MANIFEST_CONTRACT",
@@ -17971,6 +18079,7 @@
         "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
         "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_STAGES",
         "packages/core/release-activation-transaction.js#releaseActivationRoot",
+        "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
         "packages/core/readme-badges.js#renderBadgeBundleBlock",
         "packages/core/buildchain-contract.js#renderBuildchainContractDriftIssueBody",
         "packages/core/homebrew.js#renderHomebrewFormula",
@@ -18065,6 +18174,7 @@
         "packages/core/publication-authority.js#verifyPublicationQualificationReceipt",
         "packages/core/publication-reproducibility.js#verifyPublicationReproducibility",
         "packages/core/publication-sealed-bundle.js#verifyPublicationSealedBundle",
+        "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery",
         "packages/core/release-passport.js#verifyReleasePassport",
         "packages/core/release-propagation-work.js#verifyReleasePropagationWork",
         "packages/core/web-surface-publication-candidate.js#WEB_SURFACE_PRODUCTION_DECISION_CONTRACT",
@@ -18172,14 +18282,14 @@
       "specifier": "@kungfu-tech/buildchain/core",
       "export": "./core",
       "target": "./packages/core/index.js",
-      "digest": "sha256:0a415732a05ad95fe9a8ae4da20df826f392c9c5227e9f0eee3722a3d97af49d",
+      "digest": "sha256:6f22c5a7afd733e03d948cd322e01f7255b973780c89a70892c869eb3c15d05f",
       "summary": "Alias for the root public toolkit export.",
       "capabilityGroup": "api-cli-reference",
       "audience": [
         "developer",
         "agent"
       ],
-      "symbolCount": 558,
+      "symbolCount": 562,
       "symbolIds": [
         "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
         "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -18600,6 +18710,7 @@
         "packages/core/publish-transaction.js#readReleaseTransaction",
         "packages/core/release-activation-transaction.js#recordReleaseActivationPhase",
         "packages/core/release-propagation-work-transitions.js#recordReleasePropagationStage",
+        "packages/core/release-candidate-recovery.js#recoveryFailure",
         "packages/core/logging.js#redactBuildchainLogAttributes",
         "packages/core/diagnostics.js#redactDiagnosticsValue",
         "packages/core/issue-reporting.js#redactIssueText",
@@ -18609,6 +18720,7 @@
         "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_PHASES",
         "packages/core/release-activation-transaction.js#RELEASE_ACTIVATION_RECEIPT_SET_CONTRACT",
         "packages/core/release-candidate.js#RELEASE_CANDIDATE_PASSPORT_CONTRACT",
+        "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
         "packages/core/release-passport.js#RELEASE_CHECK_REPORT_CONTRACT",
         "packages/core/release-passport.js#RELEASE_EVIDENCE_ATTACHMENT_CONTRACT",
         "packages/core/release-passport-contract.js#RELEASE_PASSPORT_CHECK_MANIFEST_CONTRACT",
@@ -18627,6 +18739,7 @@
         "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
         "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_STAGES",
         "packages/core/release-activation-transaction.js#releaseActivationRoot",
+        "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
         "packages/core/readme-badges.js#renderBadgeBundleBlock",
         "packages/core/buildchain-contract.js#renderBuildchainContractDriftIssueBody",
         "packages/core/homebrew.js#renderHomebrewFormula",
@@ -18721,6 +18834,7 @@
         "packages/core/publication-authority.js#verifyPublicationQualificationReceipt",
         "packages/core/publication-reproducibility.js#verifyPublicationReproducibility",
         "packages/core/publication-sealed-bundle.js#verifyPublicationSealedBundle",
+        "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery",
         "packages/core/release-passport.js#verifyReleasePassport",
         "packages/core/release-propagation-work.js#verifyReleasePropagationWork",
         "packages/core/web-surface-publication-candidate.js#WEB_SURFACE_PRODUCTION_DECISION_CONTRACT",
@@ -18961,7 +19075,7 @@
       "specifier": "@kungfu-tech/buildchain/buildchain-contract",
       "export": "./buildchain-contract",
       "target": "./packages/core/buildchain-contract.js",
-      "digest": "sha256:876f747eccd92d31e821c85b2f38a54ba6056704adfb30cbf7e545ff61148625",
+      "digest": "sha256:90e88e4ac4759838afc4d760811ab30aad3e79066ba64fc69c81a31f3fffd291",
       "summary": "Runtime contract world and compatibility digest APIs for floating-ref drift checks.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -19986,6 +20100,32 @@
       "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-candidate-recovery",
+      "export": "./release-candidate-recovery",
+      "target": "./packages/core/release-candidate-recovery.js",
+      "digest": "sha256:effbc455f83062b52dd11ac72341160d30c7a0c5f35fd829059776eb5cd423ba",
+      "summary": "Fail-closed verification and immutable receipts for reusing a successful sealed candidate run without rebuilding product payloads.",
+      "capabilityGroup": "release-passport-trust",
+      "audience": [
+        "developer",
+        "agent"
+      ],
+      "symbolCount": 4,
+      "symbolIds": [
+        "packages/core/release-candidate-recovery.js#recoveryFailure",
+        "packages/core/release-candidate-recovery.js#RELEASE_CANDIDATE_RECOVERY_CONTRACT",
+        "packages/core/release-candidate-recovery.js#ReleaseCandidateRecoveryError",
+        "packages/core/release-candidate-recovery.js#verifyReleaseCandidateRecovery"
+      ],
+      "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",
@@ -20255,7 +20395,7 @@
     {
       "id": "node-api-reference",
       "path": "docs/node-api-reference.md",
-      "digest": "sha256:e0e720eeacfa61a1ca235142858f544e18d3f7a000e300a4311e246fe738ff81"
+      "digest": "sha256:3fbfe0227cf929f0ddc2050605d071643cee0b302a4c31920b4f9047c923ae8c"
     },
     {
       "id": "build-facts",