@kungfu-tech/buildchain 3.0.5 → 3.0.6-alpha.0

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

@@ -1881,7 +1881,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 910
+        "line": 945
       },
       "example": "import { contractSummary } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -1910,7 +1910,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 752
+        "line": 787
       },
       "example": "import { createBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -1939,7 +1939,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 75
+        "line": 110
       },
       "example": "import { createBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -1968,7 +1968,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 818
+        "line": 853
       },
       "example": "import { evaluateBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -1997,7 +1997,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 727
+        "line": 762
       },
       "example": "import { finalizeBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -2026,7 +2026,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 803
+        "line": 838
       },
       "example": "import { readBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -2055,7 +2055,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 783
+        "line": 818
       },
       "example": "import { readBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -2084,7 +2084,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-contract.js",
-        "line": 922
+        "line": 957
       },
       "example": "import { renderBuildchainContractDriftIssueBody } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -3493,7 +3493,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-publication-authority.js",
-        "line": 51
+        "line": 54
       },
       "example": "import { buildchainPublicationAuthorityDescriptors } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -3522,7 +3522,7 @@
       ],
       "source": {
         "path": "packages/core/buildchain-publication-authority.js",
-        "line": 76
+        "line": 79
       },
       "example": "import { createBuildchainPublicationAuthorityRegistry } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -11306,7 +11306,7 @@
       ],
       "source": {
         "path": "packages/core/public-surface-audit.js",
-        "line": 292
+        "line": 261
       },
       "example": "import { assertPublicSurfaceReverseAudit } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -11330,7 +11330,7 @@
       ],
       "source": {
         "path": "packages/core/public-surface-audit.js",
-        "line": 11
+        "line": 12
       },
       "example": "import { BUILDCHAIN_PUBLIC_SURFACE_AUDIT_CONTRACT } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -11359,7 +11359,7 @@
       ],
       "source": {
         "path": "packages/core/public-surface-audit.js",
-        "line": 192
+        "line": 161
       },
       "example": "import { collectPublicSurfaceReverseAudit } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -11388,7 +11388,7 @@
       ],
       "source": {
         "path": "packages/core/public-surface-audit.js",
-        "line": 122
+        "line": 91
       },
       "example": "import { enumerateActionInputs } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -11417,7 +11417,7 @@
       ],
       "source": {
         "path": "packages/core/public-surface-audit.js",
-        "line": 146
+        "line": 115
       },
       "example": "import { enumerateDocCommandRefs } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -11446,7 +11446,7 @@
       ],
       "source": {
         "path": "packages/core/public-surface-audit.js",
-        "line": 137
+        "line": 106
       },
       "example": "import { enumerateSitePages } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -11475,7 +11475,7 @@
       ],
       "source": {
         "path": "packages/core/public-surface-audit.js",
-        "line": 105
+        "line": 74
       },
       "example": "import { enumerateWorkflowInputs } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -14850,6 +14850,165 @@
         "agent"
       ]
     },
+    {
+      "id": "packages/core/release-propagation-agent-entry.js#classifyReleasePropagationCondition",
+      "name": "classifyReleasePropagationCondition",
+      "kind": "function",
+      "signature": "function classifyReleasePropagationCondition(condition)",
+      "parameters": [
+        {
+          "name": "condition",
+          "signature": "condition"
+        }
+      ],
+      "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-propagation-agent-entry.js",
+        "line": 171
+      },
+      "example": "import { classifyReleasePropagationCondition } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-agent-entry.js#normalizeSiteUpstreamIntent",
+      "name": "normalizeSiteUpstreamIntent",
+      "kind": "function",
+      "signature": "function normalizeSiteUpstreamIntent(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-propagation-agent-entry.js",
+        "line": 77
+      },
+      "example": "import { normalizeSiteUpstreamIntent } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-agent-entry.js#planSiteUpstreamAgentEntry",
+      "name": "planSiteUpstreamAgentEntry",
+      "kind": "function",
+      "signature": "function planSiteUpstreamAgentEntry({ sourceId: sourceInput, channel = \"\", handoffWork = null, } = {})",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ sourceId: sourceInput, channel = \"\", handoffWork = null, } = {}"
+        }
+      ],
+      "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-propagation-agent-entry.js",
+        "line": 134
+      },
+      "example": "import { planSiteUpstreamAgentEntry } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX",
+      "name": "RELEASE_PROPAGATION_FAILURE_MATRIX",
+      "kind": "constant",
+      "signature": "const RELEASE_PROPAGATION_FAILURE_MATRIX",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-propagation-agent-entry.js",
+        "line": 66
+      },
+      "example": "import { RELEASE_PROPAGATION_FAILURE_MATRIX } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
+      "name": "RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
+      "kind": "constant",
+      "signature": "const RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-propagation-agent-entry.js",
+        "line": 11
+      },
+      "example": "import { RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-agent-entry.js#SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
+      "name": "SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
+      "kind": "constant",
+      "signature": "const SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-propagation-agent-entry.js",
+        "line": 9
+      },
+      "example": "import { SITE_UPSTREAM_AGENT_ENTRY_CONTRACT } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
     {
       "id": "packages/core/release-propagation-capture.js#createPackageReleasePropagationCapture",
       "name": "createPackageReleasePropagationCapture",
@@ -14932,6 +15091,305 @@
         "agent"
       ]
     },
+    {
+      "id": "packages/core/release-propagation-pickup.js#createManualUpstreamPickupCapture",
+      "name": "createManualUpstreamPickupCapture",
+      "kind": "function",
+      "signature": "function createManualUpstreamPickupCapture({ plan, expectedDownstreamBaseSha, })",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ plan, expectedDownstreamBaseSha, }"
+        }
+      ],
+      "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-propagation-pickup.js",
+        "line": 361
+      },
+      "example": "import { createManualUpstreamPickupCapture } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-pickup.js#createManualUpstreamPickupPlan",
+      "name": "createManualUpstreamPickupPlan",
+      "kind": "function",
+      "signature": "function createManualUpstreamPickupPlan({ config: configInput, sourceId, channel, currentVersion, upstreamRelease, })",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ config: configInput, sourceId, channel, currentVersion, upstreamRelease, }"
+        }
+      ],
+      "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-propagation-pickup.js",
+        "line": 303
+      },
+      "example": "import { createManualUpstreamPickupPlan } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-pickup.js#MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT",
+      "name": "MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT",
+      "kind": "constant",
+      "signature": "const MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-propagation-pickup.js",
+        "line": 16
+      },
+      "example": "import { MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-pickup.js#MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT",
+      "name": "MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT",
+      "kind": "constant",
+      "signature": "const MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-propagation-pickup.js",
+        "line": 18
+      },
+      "example": "import { MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-pickup.js#normalizeManualUpstreamPickupConfig",
+      "name": "normalizeManualUpstreamPickupConfig",
+      "kind": "function",
+      "signature": "function normalizeManualUpstreamPickupConfig(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-propagation-pickup.js",
+        "line": 118
+      },
+      "example": "import { normalizeManualUpstreamPickupConfig } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-pickup.js#resolveNpmRegistryRelease",
+      "name": "resolveNpmRegistryRelease",
+      "kind": "function",
+      "signature": "function resolveNpmRegistryRelease({ source: sourceInput, channel, packageMetadata, attestations, })",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ source: sourceInput, channel, packageMetadata, attestations, }"
+        }
+      ],
+      "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-propagation-pickup.js",
+        "line": 167
+      },
+      "example": "import { resolveNpmRegistryRelease } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-push.js#createReleasePropagationPushPlan",
+      "name": "createReleasePropagationPushPlan",
+      "kind": "function",
+      "signature": "function createReleasePropagationPushPlan({ work: workInput, expectedWorkRoot, repositoryState: stateInput, } = {})",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ work: workInput, expectedWorkRoot, repositoryState: stateInput, } = {}"
+        }
+      ],
+      "returns": "unknown",
+      "errors": [
+        "May throw an Error on rejected input or failed operations; follow the linked source contract."
+      ],
+      "sideEffects": [
+        "subprocess"
+      ],
+      "source": {
+        "path": "packages/core/release-propagation-push.js",
+        "line": 77
+      },
+      "example": "import { createReleasePropagationPushPlan } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-push.js#executeReleasePropagationPush",
+      "name": "executeReleasePropagationPush",
+      "kind": "function",
+      "signature": "function executeReleasePropagationPush({ work, expectedWorkRoot, cwd = process.cwd(), remote = \"origin\", } = {})",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ work, expectedWorkRoot, cwd = process.cwd(), remote = \"origin\", } = {}"
+        }
+      ],
+      "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"
+      ],
+      "source": {
+        "path": "packages/core/release-propagation-push.js",
+        "line": 231
+      },
+      "example": "import { executeReleasePropagationPush } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-push.js#inspectReleasePropagationPushState",
+      "name": "inspectReleasePropagationPushState",
+      "kind": "function",
+      "signature": "function inspectReleasePropagationPushState({ work: workInput, cwd = process.cwd(), remote = \"origin\", } = {})",
+      "parameters": [
+        {
+          "name": "parameter1",
+          "signature": "{ work: workInput, cwd = process.cwd(), remote = \"origin\", } = {}"
+        }
+      ],
+      "returns": "unknown",
+      "errors": [
+        "May throw an Error on rejected input or failed operations; follow the linked source contract."
+      ],
+      "sideEffects": [
+        "subprocess"
+      ],
+      "source": {
+        "path": "packages/core/release-propagation-push.js",
+        "line": 174
+      },
+      "example": "import { inspectReleasePropagationPushState } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
+      "name": "RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
+      "kind": "constant",
+      "signature": "const RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-propagation-push.js",
+        "line": 14
+      },
+      "example": "import { RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
+    {
+      "id": "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
+      "name": "RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
+      "kind": "constant",
+      "signature": "const RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
+      "parameters": [],
+      "returns": "value",
+      "errors": [
+        "Import does not declare a throw contract."
+      ],
+      "sideEffects": [
+        "none-on-import"
+      ],
+      "source": {
+        "path": "packages/core/release-propagation-push.js",
+        "line": 16
+      },
+      "example": "import { RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT } from \"@kungfu-tech/buildchain\";",
+      "maturity": "stable",
+      "audience": [
+        "developer",
+        "agent"
+      ]
+    },
     {
       "id": "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_STAGE_RECEIPT_CONTRACT",
       "name": "RELEASE_PROPAGATION_STAGE_RECEIPT_CONTRACT",
@@ -15198,7 +15656,7 @@
       ],
       "source": {
         "path": "packages/core/release-propagation-work.js",
-        "line": 514
+        "line": 518
       },
       "example": "import { resumeReleasePropagationWork } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -15227,7 +15685,7 @@
       ],
       "source": {
         "path": "packages/core/release-propagation-work.js",
-        "line": 482
+        "line": 486
       },
       "example": "import { verifyReleasePropagationWork } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -15285,7 +15743,7 @@
       ],
       "source": {
         "path": "packages/core/release-propagation.js",
-        "line": 370
+        "line": 371
       },
       "example": "import { createReleasePropagationReceipt } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -15343,7 +15801,7 @@
       ],
       "source": {
         "path": "packages/core/release-propagation.js",
-        "line": 248
+        "line": 249
       },
       "example": "import { planReleasePropagation } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -15376,7 +15834,7 @@
       ],
       "source": {
         "path": "packages/core/release-propagation.js",
-        "line": 304
+        "line": 305
       },
       "example": "import { readReleasePropagationJson } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -15534,7 +15992,7 @@
       ],
       "source": {
         "path": "packages/core/release-propagation.js",
-        "line": 316
+        "line": 317
       },
       "example": "import { writeReleasePropagationLock } from \"@kungfu-tech/buildchain\";",
       "maturity": "stable",
@@ -16138,7 +16596,7 @@
         "developer",
         "agent"
       ],
-      "symbolCount": 541,
+      "symbolCount": 558,
       "symbolIds": [
         "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
         "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -16238,6 +16696,7 @@
         "packages/core/readme-badges.js#checkReadmeBadgeBlock",
         "packages/core/release-propagation-work-transitions.js#claimReleasePropagationWork",
         "packages/core/diagnostics.js#classifyProcessCommand",
+        "packages/core/release-propagation-agent-entry.js#classifyReleasePropagationCondition",
         "packages/core/github-governance-authority.js#codeownersForPath",
         "packages/core/readme-badges.js#collectBadgeBundleFacts",
         "packages/core/diagnostics.js#collectBuildchainDiagnostics",
@@ -16311,6 +16770,8 @@
         "packages/core/readme-badges.js#createKfdBadgeSpecsFromStandards",
         "packages/core/kfd-product-gates.js#createKfdSupportProjection",
         "packages/core/build-facts.js#createKungfuBuildInfoProjection",
+        "packages/core/release-propagation-pickup.js#createManualUpstreamPickupCapture",
+        "packages/core/release-propagation-pickup.js#createManualUpstreamPickupPlan",
         "packages/core/release-propagation-capture.js#createPackageReleasePropagationCapture",
         "packages/core/paper.js#createPaperAlphaPlan",
         "packages/core/paper.js#createPaperBuildPlan",
@@ -16336,6 +16797,7 @@
         "packages/core/release-passport.js#createReleasePassport",
         "packages/core/release-passport-contract.js#createReleasePassportCheckManifest",
         "packages/core/release-propagation.js#createReleasePropagationLock",
+        "packages/core/release-propagation-push.js#createReleasePropagationPushPlan",
         "packages/core/release-propagation.js#createReleasePropagationReceipt",
         "packages/core/release-propagation-work.js#createReleasePropagationStageReceipt",
         "packages/core/release-propagation-work.js#createReleasePropagationWork",
@@ -16376,6 +16838,7 @@
         "packages/core/paper.js#executePaperNpmBootstrap",
         "packages/core/paper-work.js#executePaperWorkStart",
         "packages/core/paper-work.js#executePaperWorkSubmitPush",
+        "packages/core/release-propagation-push.js#executeReleasePropagationPush",
         "packages/core/artifact-passport.js#explainArtifactPassport",
         "packages/core/kfd-agent-hub.js#explainKfdAgentHub",
         "packages/core/release-line-dry-run.js#explainReleaseLineDryRun",
@@ -16413,6 +16876,7 @@
         "packages/core/release-passport.js#IMPACT_LEDGER_CONTRACT",
         "packages/core/kfd-agent-hub.js#initKfdAgentHub",
         "packages/core/kfd-agent-hub.js#inspectKfdAgentHub",
+        "packages/core/release-propagation-push.js#inspectReleasePropagationPushState",
         "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_ADOPTION_CONTRACT",
         "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_ADOPTION_SCHEMA",
         "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_DECLARATION",
@@ -16459,6 +16923,8 @@
         "packages/core/buildchain-config.js#loadBuildchainConfig",
         "packages/core/buildchain-config.js#loadConfiguredAnchorManifest",
         "packages/core/release-passport.js#makeReleasePassportFixtureAssets",
+        "packages/core/release-propagation-pickup.js#MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT",
+        "packages/core/release-propagation-pickup.js#MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT",
         "packages/core/stable-candidate-ledger.js#markStableCandidatePromoted",
         "packages/core/buildchain-layout.js#migrateBuildchainLayout",
         "packages/core/buildchain-config.js#normalizeBuildchainConfig",
@@ -16475,8 +16941,10 @@
         "packages/core/kfd3-surface-register.js#normalizeKfd3DistributionDeclaration",
         "packages/core/kfd.js#normalizeKfdStandardId",
         "packages/core/buildchain-config.js#normalizeLifecycleStage",
+        "packages/core/release-propagation-pickup.js#normalizeManualUpstreamPickupConfig",
         "packages/core/release-propagation-capture.js#normalizePackageReleasePropagationConfig",
         "packages/core/release-propagation.js#normalizeReleasePropagationGraph",
+        "packages/core/release-propagation-agent-entry.js#normalizeSiteUpstreamIntent",
         "packages/core/stable-candidate-ledger.js#normalizeStableCandidateLedger",
         "packages/core/release-propagation-capture.js#PACKAGE_RELEASE_PROPAGATION_CONFIG_CONTRACT",
         "packages/core/paper.js#PAPER_ALPHA_PLAN_CONTRACT",
@@ -16503,6 +16971,7 @@
         "packages/core/paper.js#planPaperScaffold",
         "packages/core/release-line-bootstrap.js#planReleaseLineBootstrap",
         "packages/core/release-propagation.js#planReleasePropagation",
+        "packages/core/release-propagation-agent-entry.js#planSiteUpstreamAgentEntry",
         "packages/core/publish-transaction.js#planTransactionRecovery",
         "packages/core/github-artifact-attestation.js#prepareGitHubArtifactAttestation",
         "packages/core/publication-package.js#preparePublicationNpmPackage",
@@ -16563,9 +17032,13 @@
         "packages/core/release-passport.js#RELEASE_PASSPORT_CONTRACT",
         "packages/core/release-passport-contract.js#RELEASE_PASSPORT_SCHEMA",
         "packages/core/release-passport-contract.js#RELEASE_PASSPORT_SCHEMA_ID",
+        "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX",
+        "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_GRAPH_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_LOCK_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_PLAN_CONTRACT",
+        "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
+        "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_RECEIPT_CONTRACT",
         "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_STAGE_RECEIPT_CONTRACT",
         "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
@@ -16588,6 +17061,7 @@
         "packages/core/buildchain-layout.js#resolveKfd2ProductClaimsRegistryPath",
         "packages/core/kfd-gate.js#resolveKfd3Metadata",
         "packages/core/buildchain-layout.js#resolveKfd3SurfaceRegistryPath",
+        "packages/core/release-propagation-pickup.js#resolveNpmRegistryRelease",
         "packages/core/paper-repository.js#resolvePaperRepository",
         "packages/core/release-propagation.js#resolvePropagationChannel",
         "packages/core/publication-artifact-candidate.js#resolvePublicationCandidateFile",
@@ -16611,6 +17085,7 @@
         "packages/core/artifact-passport.js#sha512IntegrityFile",
         "packages/core/package-manager.js#shellJoin",
         "packages/core/detached-artifact-signature.js#signDetachedArtifactRequest",
+        "packages/core/release-propagation-agent-entry.js#SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
         "packages/core/stable-candidate-ledger.js#STABLE_CANDIDATE_LEDGER_CONTRACT",
         "packages/core/stable-candidate-ledger.js#STABLE_CANDIDATE_STATES",
         "packages/core/stable-candidate-ledger.js#stableCandidatePromotionRefs",
@@ -16777,7 +17252,7 @@
         "developer",
         "agent"
       ],
-      "symbolCount": 541,
+      "symbolCount": 558,
       "symbolIds": [
         "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
         "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -16877,6 +17352,7 @@
         "packages/core/readme-badges.js#checkReadmeBadgeBlock",
         "packages/core/release-propagation-work-transitions.js#claimReleasePropagationWork",
         "packages/core/diagnostics.js#classifyProcessCommand",
+        "packages/core/release-propagation-agent-entry.js#classifyReleasePropagationCondition",
         "packages/core/github-governance-authority.js#codeownersForPath",
         "packages/core/readme-badges.js#collectBadgeBundleFacts",
         "packages/core/diagnostics.js#collectBuildchainDiagnostics",
@@ -16950,6 +17426,8 @@
         "packages/core/readme-badges.js#createKfdBadgeSpecsFromStandards",
         "packages/core/kfd-product-gates.js#createKfdSupportProjection",
         "packages/core/build-facts.js#createKungfuBuildInfoProjection",
+        "packages/core/release-propagation-pickup.js#createManualUpstreamPickupCapture",
+        "packages/core/release-propagation-pickup.js#createManualUpstreamPickupPlan",
         "packages/core/release-propagation-capture.js#createPackageReleasePropagationCapture",
         "packages/core/paper.js#createPaperAlphaPlan",
         "packages/core/paper.js#createPaperBuildPlan",
@@ -16975,6 +17453,7 @@
         "packages/core/release-passport.js#createReleasePassport",
         "packages/core/release-passport-contract.js#createReleasePassportCheckManifest",
         "packages/core/release-propagation.js#createReleasePropagationLock",
+        "packages/core/release-propagation-push.js#createReleasePropagationPushPlan",
         "packages/core/release-propagation.js#createReleasePropagationReceipt",
         "packages/core/release-propagation-work.js#createReleasePropagationStageReceipt",
         "packages/core/release-propagation-work.js#createReleasePropagationWork",
@@ -17015,6 +17494,7 @@
         "packages/core/paper.js#executePaperNpmBootstrap",
         "packages/core/paper-work.js#executePaperWorkStart",
         "packages/core/paper-work.js#executePaperWorkSubmitPush",
+        "packages/core/release-propagation-push.js#executeReleasePropagationPush",
         "packages/core/artifact-passport.js#explainArtifactPassport",
         "packages/core/kfd-agent-hub.js#explainKfdAgentHub",
         "packages/core/release-line-dry-run.js#explainReleaseLineDryRun",
@@ -17052,6 +17532,7 @@
         "packages/core/release-passport.js#IMPACT_LEDGER_CONTRACT",
         "packages/core/kfd-agent-hub.js#initKfdAgentHub",
         "packages/core/kfd-agent-hub.js#inspectKfdAgentHub",
+        "packages/core/release-propagation-push.js#inspectReleasePropagationPushState",
         "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_ADOPTION_CONTRACT",
         "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_ADOPTION_SCHEMA",
         "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_DECLARATION",
@@ -17098,6 +17579,8 @@
         "packages/core/buildchain-config.js#loadBuildchainConfig",
         "packages/core/buildchain-config.js#loadConfiguredAnchorManifest",
         "packages/core/release-passport.js#makeReleasePassportFixtureAssets",
+        "packages/core/release-propagation-pickup.js#MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT",
+        "packages/core/release-propagation-pickup.js#MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT",
         "packages/core/stable-candidate-ledger.js#markStableCandidatePromoted",
         "packages/core/buildchain-layout.js#migrateBuildchainLayout",
         "packages/core/buildchain-config.js#normalizeBuildchainConfig",
@@ -17114,8 +17597,10 @@
         "packages/core/kfd3-surface-register.js#normalizeKfd3DistributionDeclaration",
         "packages/core/kfd.js#normalizeKfdStandardId",
         "packages/core/buildchain-config.js#normalizeLifecycleStage",
+        "packages/core/release-propagation-pickup.js#normalizeManualUpstreamPickupConfig",
         "packages/core/release-propagation-capture.js#normalizePackageReleasePropagationConfig",
         "packages/core/release-propagation.js#normalizeReleasePropagationGraph",
+        "packages/core/release-propagation-agent-entry.js#normalizeSiteUpstreamIntent",
         "packages/core/stable-candidate-ledger.js#normalizeStableCandidateLedger",
         "packages/core/release-propagation-capture.js#PACKAGE_RELEASE_PROPAGATION_CONFIG_CONTRACT",
         "packages/core/paper.js#PAPER_ALPHA_PLAN_CONTRACT",
@@ -17142,6 +17627,7 @@
         "packages/core/paper.js#planPaperScaffold",
         "packages/core/release-line-bootstrap.js#planReleaseLineBootstrap",
         "packages/core/release-propagation.js#planReleasePropagation",
+        "packages/core/release-propagation-agent-entry.js#planSiteUpstreamAgentEntry",
         "packages/core/publish-transaction.js#planTransactionRecovery",
         "packages/core/github-artifact-attestation.js#prepareGitHubArtifactAttestation",
         "packages/core/publication-package.js#preparePublicationNpmPackage",
@@ -17202,9 +17688,13 @@
         "packages/core/release-passport.js#RELEASE_PASSPORT_CONTRACT",
         "packages/core/release-passport-contract.js#RELEASE_PASSPORT_SCHEMA",
         "packages/core/release-passport-contract.js#RELEASE_PASSPORT_SCHEMA_ID",
+        "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX",
+        "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_GRAPH_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_LOCK_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_PLAN_CONTRACT",
+        "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
+        "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_RECEIPT_CONTRACT",
         "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_STAGE_RECEIPT_CONTRACT",
         "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
@@ -17227,6 +17717,7 @@
         "packages/core/buildchain-layout.js#resolveKfd2ProductClaimsRegistryPath",
         "packages/core/kfd-gate.js#resolveKfd3Metadata",
         "packages/core/buildchain-layout.js#resolveKfd3SurfaceRegistryPath",
+        "packages/core/release-propagation-pickup.js#resolveNpmRegistryRelease",
         "packages/core/paper-repository.js#resolvePaperRepository",
         "packages/core/release-propagation.js#resolvePropagationChannel",
         "packages/core/publication-artifact-candidate.js#resolvePublicationCandidateFile",
@@ -17250,6 +17741,7 @@
         "packages/core/artifact-passport.js#sha512IntegrityFile",
         "packages/core/package-manager.js#shellJoin",
         "packages/core/detached-artifact-signature.js#signDetachedArtifactRequest",
+        "packages/core/release-propagation-agent-entry.js#SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
         "packages/core/stable-candidate-ledger.js#STABLE_CANDIDATE_LEDGER_CONTRACT",
         "packages/core/stable-candidate-ledger.js#STABLE_CANDIDATE_STATES",
         "packages/core/stable-candidate-ledger.js#stableCandidatePromotionRefs",
@@ -17542,7 +18034,7 @@
       "specifier": "@kungfu-tech/buildchain/buildchain-contract",
       "export": "./buildchain-contract",
       "target": "./packages/core/buildchain-contract.js",
-      "digest": "sha256:b36bbd70ebd7dffdba2ab3161cbea8adfed0cd72b418ba587a4d0e5aecbd94dc",
+      "digest": "sha256:876f747eccd92d31e821c85b2f38a54ba6056704adfb30cbf7e545ff61148625",
       "summary": "Runtime contract world and compatibility digest APIs for floating-ref drift checks.",
       "capabilityGroup": "governance-versioning",
       "audience": [
@@ -18046,7 +18538,7 @@
       "specifier": "@kungfu-tech/buildchain/public-surface-audit",
       "export": "./public-surface-audit",
       "target": "./packages/core/public-surface-audit.js",
-      "digest": "sha256:d8c73e29d45f93e45efd77ce80a1a0ef0153123c8e350958f710500f418f8315",
+      "digest": "sha256:486e2ecc57aa5fa8f7664ce75ea2852c4d226f823b51d1b04d8f680b60bf1b39",
       "summary": "Reverse audit APIs for CLI, workflow, action, site page, and documentation command surfaces.",
       "capabilityGroup": "kfd-trust",
       "audience": [
@@ -18381,7 +18873,7 @@
       "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
       "export": "./buildchain-publication-authority",
       "target": "./packages/core/buildchain-publication-authority.js",
-      "digest": "sha256:0e5db6d66ed48d5eb57be1e4f1c3de92a2fc4c72a70b5764df6b21f78026a731",
+      "digest": "sha256:377c23328c8d07fd98def4e2f170d68294893f695cda8cb85766c45083510e87",
       "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
       "capabilityGroup": "release-passport-trust",
       "audience": [
@@ -18622,38 +19114,55 @@
       "specifier": "@kungfu-tech/buildchain/release-propagation",
       "export": "./release-propagation",
       "target": "./packages/core/release-propagation.js",
-      "digest": "sha256:193a8489c200d96b50bc71d54162d7ec37a7c1335bc97bc1459971fe18c31b16",
+      "digest": "sha256:2a04d2061d8c3dbc3a5b91a48d0e0392f3e345f247251efb23d5edf95329a092",
       "summary": "Release propagation graph, plan, and exact upstream lock APIs.",
       "capabilityGroup": "site-and-propagation",
       "audience": [
         "developer",
         "agent"
       ],
-      "symbolCount": 25,
+      "symbolCount": 42,
       "symbolIds": [
         "packages/core/release-propagation-work-transitions.js#claimReleasePropagationWork",
+        "packages/core/release-propagation-agent-entry.js#classifyReleasePropagationCondition",
         "packages/core/release-propagation-work-transitions.js#completeReleasePropagationWork",
+        "packages/core/release-propagation-pickup.js#createManualUpstreamPickupCapture",
+        "packages/core/release-propagation-pickup.js#createManualUpstreamPickupPlan",
         "packages/core/release-propagation-capture.js#createPackageReleasePropagationCapture",
         "packages/core/release-propagation.js#createReleasePropagationLock",
+        "packages/core/release-propagation-push.js#createReleasePropagationPushPlan",
         "packages/core/release-propagation.js#createReleasePropagationReceipt",
         "packages/core/release-propagation-work.js#createReleasePropagationStageReceipt",
         "packages/core/release-propagation-work.js#createReleasePropagationWork",
+        "packages/core/release-propagation-push.js#executeReleasePropagationPush",
+        "packages/core/release-propagation-push.js#inspectReleasePropagationPushState",
+        "packages/core/release-propagation-pickup.js#MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT",
+        "packages/core/release-propagation-pickup.js#MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT",
+        "packages/core/release-propagation-pickup.js#normalizeManualUpstreamPickupConfig",
         "packages/core/release-propagation-capture.js#normalizePackageReleasePropagationConfig",
         "packages/core/release-propagation.js#normalizeReleasePropagationGraph",
+        "packages/core/release-propagation-agent-entry.js#normalizeSiteUpstreamIntent",
         "packages/core/release-propagation-capture.js#PACKAGE_RELEASE_PROPAGATION_CONFIG_CONTRACT",
         "packages/core/release-propagation.js#planReleasePropagation",
+        "packages/core/release-propagation-agent-entry.js#planSiteUpstreamAgentEntry",
         "packages/core/release-propagation.js#readReleasePropagationJson",
         "packages/core/release-propagation-work-transitions.js#recordReleasePropagationStage",
+        "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX",
+        "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_GRAPH_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_LOCK_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_PLAN_CONTRACT",
+        "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
+        "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
         "packages/core/release-propagation.js#RELEASE_PROPAGATION_RECEIPT_CONTRACT",
         "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_STAGE_RECEIPT_CONTRACT",
         "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-propagation-work-transitions.js#repairReleasePropagationWork",
+        "packages/core/release-propagation-pickup.js#resolveNpmRegistryRelease",
         "packages/core/release-propagation.js#resolvePropagationChannel",
         "packages/core/release-propagation-work.js#resumeReleasePropagationWork",
+        "packages/core/release-propagation-agent-entry.js#SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
         "packages/core/release-propagation-work.js#verifyReleasePropagationWork",
         "packages/core/release-propagation.js#writeReleasePropagationLock"
       ],
@@ -18765,7 +19274,7 @@
     {
       "id": "node-api-reference",
       "path": "docs/node-api-reference.md",
-      "digest": "sha256:38f051f579fb93dc7d8b4f2c70acd622c020e867394344b5e932568cd8d2ad83"
+      "digest": "sha256:ae49a589091d1ab91d29f2d6ac52cf2551a9d0b1f78350965b408f40fd219e29"
     },
     {
       "id": "build-facts",