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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/contracts/auditable-demo-scenario-v1.schema.json +11 -0
  2. package/dist/site/buildchain-contract.json +42 -22
  3. package/dist/site/buildchain-site.json +73 -27
  4. package/dist/site/capability-registry.json +2 -2
  5. package/dist/site/cli-registry.json +5 -3
  6. package/dist/site/controller-registry.json +19 -3
  7. package/dist/site/kfd-claims.json +58 -14
  8. package/dist/site/kfd-upstream-aggregate.json +1 -1
  9. package/dist/site/manual-registry.json +7 -6
  10. package/dist/site/node-api-registry.json +335 -8
  11. package/dist/site/page-registry.json +63 -17
  12. package/dist/site/public-surface-audit.json +94 -11
  13. package/dist/site/publication-authority-registry.json +21 -1
  14. package/dist/site/publication-registry.json +4 -4
  15. package/dist/site/site-manifest.json +10 -10
  16. package/dist/site/workflow-registry.json +53 -4
  17. package/docs/MAP.md +4 -1
  18. package/docs/auditable-demo.md +19 -3
  19. package/docs/cli-reference.md +15 -4
  20. package/docs/dev-alpha-candidate-patrol.md +14 -5
  21. package/docs/dev-qualification-patrol.md +108 -0
  22. package/docs/node-api-reference.md +42 -9
  23. package/docs/release-propagation.md +93 -0
  24. package/docs/reusable-build-surface.md +44 -12
  25. package/docs/stable-candidate-patrol.md +5 -2
  26. package/package.json +1 -1
  27. package/packages/core/buildchain-publication-authority.js +1 -0
  28. package/packages/core/release-propagation-agent-entry.js +185 -0
  29. package/packages/core/release-propagation-push.js +293 -0
  30. package/packages/core/release-propagation-stage-evidence.js +36 -0
  31. package/packages/core/release-propagation-work.js +1 -1
  32. package/packages/core/release-propagation.js +15 -0
  33. package/scripts/artifact-signing-controller-core.mjs +525 -0
  34. package/scripts/artifact-signing-controller.mjs +302 -0
  35. package/scripts/artifact-signing-delegation.mjs +51 -3
  36. package/scripts/auditable-demo-platform.mjs +59 -1
  37. package/scripts/auditable-demo-transport-smoke.mjs +176 -0
  38. package/scripts/build-standalone-binary.mjs +3 -1
  39. package/scripts/buildchain-cli-help.mjs +1 -1
  40. package/scripts/check-inventory.mjs +1 -0
  41. package/scripts/compiler-cache-evidence.mjs +90 -7
  42. package/scripts/dev-alpha-candidate-patrol.mjs +80 -5
  43. package/scripts/dev-pr-auto-merge.mjs +4 -4
  44. package/scripts/dev-qualification-patrol.mjs +594 -0
  45. package/scripts/dispatch-artifact-signing-authority.mjs +312 -61
  46. package/scripts/generate-site-bundle.mjs +3 -0
  47. package/scripts/inspect-artifact-signing-requests.mjs +12 -0
  48. package/scripts/release-propagation.mjs +73 -0
  49. package/scripts/run-lifecycle-core.mjs +25 -0
  50. package/scripts/site-capability-metadata.mjs +1 -1
  51. package/scripts/stable-candidate-patrol.mjs +30 -4
@@ -3493,7 +3493,7 @@
3493
3493
  ],
3494
3494
  "source": {
3495
3495
  "path": "packages/core/buildchain-publication-authority.js",
3496
- "line": 53
3496
+ "line": 54
3497
3497
  },
3498
3498
  "example": "import { buildchainPublicationAuthorityDescriptors } from \"@kungfu-tech/buildchain\";",
3499
3499
  "maturity": "stable",
@@ -3522,7 +3522,7 @@
3522
3522
  ],
3523
3523
  "source": {
3524
3524
  "path": "packages/core/buildchain-publication-authority.js",
3525
- "line": 78
3525
+ "line": 79
3526
3526
  },
3527
3527
  "example": "import { createBuildchainPublicationAuthorityRegistry } from \"@kungfu-tech/buildchain\";",
3528
3528
  "maturity": "stable",
@@ -14850,6 +14850,165 @@
14850
14850
  "agent"
14851
14851
  ]
14852
14852
  },
14853
+ {
14854
+ "id": "packages/core/release-propagation-agent-entry.js#classifyReleasePropagationCondition",
14855
+ "name": "classifyReleasePropagationCondition",
14856
+ "kind": "function",
14857
+ "signature": "function classifyReleasePropagationCondition(condition)",
14858
+ "parameters": [
14859
+ {
14860
+ "name": "condition",
14861
+ "signature": "condition"
14862
+ }
14863
+ ],
14864
+ "returns": "unknown",
14865
+ "errors": [
14866
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
14867
+ ],
14868
+ "sideEffects": [
14869
+ "none-detected-by-static-source-scan"
14870
+ ],
14871
+ "source": {
14872
+ "path": "packages/core/release-propagation-agent-entry.js",
14873
+ "line": 171
14874
+ },
14875
+ "example": "import { classifyReleasePropagationCondition } from \"@kungfu-tech/buildchain\";",
14876
+ "maturity": "stable",
14877
+ "audience": [
14878
+ "developer",
14879
+ "agent"
14880
+ ]
14881
+ },
14882
+ {
14883
+ "id": "packages/core/release-propagation-agent-entry.js#normalizeSiteUpstreamIntent",
14884
+ "name": "normalizeSiteUpstreamIntent",
14885
+ "kind": "function",
14886
+ "signature": "function normalizeSiteUpstreamIntent(value)",
14887
+ "parameters": [
14888
+ {
14889
+ "name": "value",
14890
+ "signature": "value"
14891
+ }
14892
+ ],
14893
+ "returns": "unknown",
14894
+ "errors": [
14895
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
14896
+ ],
14897
+ "sideEffects": [
14898
+ "none-detected-by-static-source-scan"
14899
+ ],
14900
+ "source": {
14901
+ "path": "packages/core/release-propagation-agent-entry.js",
14902
+ "line": 77
14903
+ },
14904
+ "example": "import { normalizeSiteUpstreamIntent } from \"@kungfu-tech/buildchain\";",
14905
+ "maturity": "stable",
14906
+ "audience": [
14907
+ "developer",
14908
+ "agent"
14909
+ ]
14910
+ },
14911
+ {
14912
+ "id": "packages/core/release-propagation-agent-entry.js#planSiteUpstreamAgentEntry",
14913
+ "name": "planSiteUpstreamAgentEntry",
14914
+ "kind": "function",
14915
+ "signature": "function planSiteUpstreamAgentEntry({ sourceId: sourceInput, channel = \"\", handoffWork = null, } = {})",
14916
+ "parameters": [
14917
+ {
14918
+ "name": "parameter1",
14919
+ "signature": "{ sourceId: sourceInput, channel = \"\", handoffWork = null, } = {}"
14920
+ }
14921
+ ],
14922
+ "returns": "unknown",
14923
+ "errors": [
14924
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
14925
+ ],
14926
+ "sideEffects": [
14927
+ "none-detected-by-static-source-scan"
14928
+ ],
14929
+ "source": {
14930
+ "path": "packages/core/release-propagation-agent-entry.js",
14931
+ "line": 134
14932
+ },
14933
+ "example": "import { planSiteUpstreamAgentEntry } from \"@kungfu-tech/buildchain\";",
14934
+ "maturity": "stable",
14935
+ "audience": [
14936
+ "developer",
14937
+ "agent"
14938
+ ]
14939
+ },
14940
+ {
14941
+ "id": "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX",
14942
+ "name": "RELEASE_PROPAGATION_FAILURE_MATRIX",
14943
+ "kind": "constant",
14944
+ "signature": "const RELEASE_PROPAGATION_FAILURE_MATRIX",
14945
+ "parameters": [],
14946
+ "returns": "value",
14947
+ "errors": [
14948
+ "Import does not declare a throw contract."
14949
+ ],
14950
+ "sideEffects": [
14951
+ "none-on-import"
14952
+ ],
14953
+ "source": {
14954
+ "path": "packages/core/release-propagation-agent-entry.js",
14955
+ "line": 66
14956
+ },
14957
+ "example": "import { RELEASE_PROPAGATION_FAILURE_MATRIX } from \"@kungfu-tech/buildchain\";",
14958
+ "maturity": "stable",
14959
+ "audience": [
14960
+ "developer",
14961
+ "agent"
14962
+ ]
14963
+ },
14964
+ {
14965
+ "id": "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
14966
+ "name": "RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
14967
+ "kind": "constant",
14968
+ "signature": "const RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
14969
+ "parameters": [],
14970
+ "returns": "value",
14971
+ "errors": [
14972
+ "Import does not declare a throw contract."
14973
+ ],
14974
+ "sideEffects": [
14975
+ "none-on-import"
14976
+ ],
14977
+ "source": {
14978
+ "path": "packages/core/release-propagation-agent-entry.js",
14979
+ "line": 11
14980
+ },
14981
+ "example": "import { RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT } from \"@kungfu-tech/buildchain\";",
14982
+ "maturity": "stable",
14983
+ "audience": [
14984
+ "developer",
14985
+ "agent"
14986
+ ]
14987
+ },
14988
+ {
14989
+ "id": "packages/core/release-propagation-agent-entry.js#SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
14990
+ "name": "SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
14991
+ "kind": "constant",
14992
+ "signature": "const SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
14993
+ "parameters": [],
14994
+ "returns": "value",
14995
+ "errors": [
14996
+ "Import does not declare a throw contract."
14997
+ ],
14998
+ "sideEffects": [
14999
+ "none-on-import"
15000
+ ],
15001
+ "source": {
15002
+ "path": "packages/core/release-propagation-agent-entry.js",
15003
+ "line": 9
15004
+ },
15005
+ "example": "import { SITE_UPSTREAM_AGENT_ENTRY_CONTRACT } from \"@kungfu-tech/buildchain\";",
15006
+ "maturity": "stable",
15007
+ "audience": [
15008
+ "developer",
15009
+ "agent"
15010
+ ]
15011
+ },
14853
15012
  {
14854
15013
  "id": "packages/core/release-propagation-capture.js#createPackageReleasePropagationCapture",
14855
15014
  "name": "createPackageReleasePropagationCapture",
@@ -15096,6 +15255,141 @@
15096
15255
  "agent"
15097
15256
  ]
15098
15257
  },
15258
+ {
15259
+ "id": "packages/core/release-propagation-push.js#createReleasePropagationPushPlan",
15260
+ "name": "createReleasePropagationPushPlan",
15261
+ "kind": "function",
15262
+ "signature": "function createReleasePropagationPushPlan({ work: workInput, expectedWorkRoot, repositoryState: stateInput, } = {})",
15263
+ "parameters": [
15264
+ {
15265
+ "name": "parameter1",
15266
+ "signature": "{ work: workInput, expectedWorkRoot, repositoryState: stateInput, } = {}"
15267
+ }
15268
+ ],
15269
+ "returns": "unknown",
15270
+ "errors": [
15271
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
15272
+ ],
15273
+ "sideEffects": [
15274
+ "subprocess"
15275
+ ],
15276
+ "source": {
15277
+ "path": "packages/core/release-propagation-push.js",
15278
+ "line": 77
15279
+ },
15280
+ "example": "import { createReleasePropagationPushPlan } from \"@kungfu-tech/buildchain\";",
15281
+ "maturity": "stable",
15282
+ "audience": [
15283
+ "developer",
15284
+ "agent"
15285
+ ]
15286
+ },
15287
+ {
15288
+ "id": "packages/core/release-propagation-push.js#executeReleasePropagationPush",
15289
+ "name": "executeReleasePropagationPush",
15290
+ "kind": "function",
15291
+ "signature": "function executeReleasePropagationPush({ work, expectedWorkRoot, cwd = process.cwd(), remote = \"origin\", } = {})",
15292
+ "parameters": [
15293
+ {
15294
+ "name": "parameter1",
15295
+ "signature": "{ work, expectedWorkRoot, cwd = process.cwd(), remote = \"origin\", } = {}"
15296
+ }
15297
+ ],
15298
+ "returns": "unknown",
15299
+ "errors": [
15300
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
15301
+ ],
15302
+ "sideEffects": [
15303
+ "may-write-or-invoke-external-actions"
15304
+ ],
15305
+ "source": {
15306
+ "path": "packages/core/release-propagation-push.js",
15307
+ "line": 231
15308
+ },
15309
+ "example": "import { executeReleasePropagationPush } from \"@kungfu-tech/buildchain\";",
15310
+ "maturity": "stable",
15311
+ "audience": [
15312
+ "developer",
15313
+ "agent"
15314
+ ]
15315
+ },
15316
+ {
15317
+ "id": "packages/core/release-propagation-push.js#inspectReleasePropagationPushState",
15318
+ "name": "inspectReleasePropagationPushState",
15319
+ "kind": "function",
15320
+ "signature": "function inspectReleasePropagationPushState({ work: workInput, cwd = process.cwd(), remote = \"origin\", } = {})",
15321
+ "parameters": [
15322
+ {
15323
+ "name": "parameter1",
15324
+ "signature": "{ work: workInput, cwd = process.cwd(), remote = \"origin\", } = {}"
15325
+ }
15326
+ ],
15327
+ "returns": "unknown",
15328
+ "errors": [
15329
+ "May throw an Error on rejected input or failed operations; follow the linked source contract."
15330
+ ],
15331
+ "sideEffects": [
15332
+ "subprocess"
15333
+ ],
15334
+ "source": {
15335
+ "path": "packages/core/release-propagation-push.js",
15336
+ "line": 174
15337
+ },
15338
+ "example": "import { inspectReleasePropagationPushState } from \"@kungfu-tech/buildchain\";",
15339
+ "maturity": "stable",
15340
+ "audience": [
15341
+ "developer",
15342
+ "agent"
15343
+ ]
15344
+ },
15345
+ {
15346
+ "id": "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
15347
+ "name": "RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
15348
+ "kind": "constant",
15349
+ "signature": "const RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
15350
+ "parameters": [],
15351
+ "returns": "value",
15352
+ "errors": [
15353
+ "Import does not declare a throw contract."
15354
+ ],
15355
+ "sideEffects": [
15356
+ "none-on-import"
15357
+ ],
15358
+ "source": {
15359
+ "path": "packages/core/release-propagation-push.js",
15360
+ "line": 14
15361
+ },
15362
+ "example": "import { RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT } from \"@kungfu-tech/buildchain\";",
15363
+ "maturity": "stable",
15364
+ "audience": [
15365
+ "developer",
15366
+ "agent"
15367
+ ]
15368
+ },
15369
+ {
15370
+ "id": "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
15371
+ "name": "RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
15372
+ "kind": "constant",
15373
+ "signature": "const RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
15374
+ "parameters": [],
15375
+ "returns": "value",
15376
+ "errors": [
15377
+ "Import does not declare a throw contract."
15378
+ ],
15379
+ "sideEffects": [
15380
+ "none-on-import"
15381
+ ],
15382
+ "source": {
15383
+ "path": "packages/core/release-propagation-push.js",
15384
+ "line": 16
15385
+ },
15386
+ "example": "import { RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT } from \"@kungfu-tech/buildchain\";",
15387
+ "maturity": "stable",
15388
+ "audience": [
15389
+ "developer",
15390
+ "agent"
15391
+ ]
15392
+ },
15099
15393
  {
15100
15394
  "id": "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_STAGE_RECEIPT_CONTRACT",
15101
15395
  "name": "RELEASE_PROPAGATION_STAGE_RECEIPT_CONTRACT",
@@ -16302,7 +16596,7 @@
16302
16596
  "developer",
16303
16597
  "agent"
16304
16598
  ],
16305
- "symbolCount": 547,
16599
+ "symbolCount": 558,
16306
16600
  "symbolIds": [
16307
16601
  "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
16308
16602
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -16402,6 +16696,7 @@
16402
16696
  "packages/core/readme-badges.js#checkReadmeBadgeBlock",
16403
16697
  "packages/core/release-propagation-work-transitions.js#claimReleasePropagationWork",
16404
16698
  "packages/core/diagnostics.js#classifyProcessCommand",
16699
+ "packages/core/release-propagation-agent-entry.js#classifyReleasePropagationCondition",
16405
16700
  "packages/core/github-governance-authority.js#codeownersForPath",
16406
16701
  "packages/core/readme-badges.js#collectBadgeBundleFacts",
16407
16702
  "packages/core/diagnostics.js#collectBuildchainDiagnostics",
@@ -16502,6 +16797,7 @@
16502
16797
  "packages/core/release-passport.js#createReleasePassport",
16503
16798
  "packages/core/release-passport-contract.js#createReleasePassportCheckManifest",
16504
16799
  "packages/core/release-propagation.js#createReleasePropagationLock",
16800
+ "packages/core/release-propagation-push.js#createReleasePropagationPushPlan",
16505
16801
  "packages/core/release-propagation.js#createReleasePropagationReceipt",
16506
16802
  "packages/core/release-propagation-work.js#createReleasePropagationStageReceipt",
16507
16803
  "packages/core/release-propagation-work.js#createReleasePropagationWork",
@@ -16542,6 +16838,7 @@
16542
16838
  "packages/core/paper.js#executePaperNpmBootstrap",
16543
16839
  "packages/core/paper-work.js#executePaperWorkStart",
16544
16840
  "packages/core/paper-work.js#executePaperWorkSubmitPush",
16841
+ "packages/core/release-propagation-push.js#executeReleasePropagationPush",
16545
16842
  "packages/core/artifact-passport.js#explainArtifactPassport",
16546
16843
  "packages/core/kfd-agent-hub.js#explainKfdAgentHub",
16547
16844
  "packages/core/release-line-dry-run.js#explainReleaseLineDryRun",
@@ -16579,6 +16876,7 @@
16579
16876
  "packages/core/release-passport.js#IMPACT_LEDGER_CONTRACT",
16580
16877
  "packages/core/kfd-agent-hub.js#initKfdAgentHub",
16581
16878
  "packages/core/kfd-agent-hub.js#inspectKfdAgentHub",
16879
+ "packages/core/release-propagation-push.js#inspectReleasePropagationPushState",
16582
16880
  "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_ADOPTION_CONTRACT",
16583
16881
  "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_ADOPTION_SCHEMA",
16584
16882
  "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_DECLARATION",
@@ -16646,6 +16944,7 @@
16646
16944
  "packages/core/release-propagation-pickup.js#normalizeManualUpstreamPickupConfig",
16647
16945
  "packages/core/release-propagation-capture.js#normalizePackageReleasePropagationConfig",
16648
16946
  "packages/core/release-propagation.js#normalizeReleasePropagationGraph",
16947
+ "packages/core/release-propagation-agent-entry.js#normalizeSiteUpstreamIntent",
16649
16948
  "packages/core/stable-candidate-ledger.js#normalizeStableCandidateLedger",
16650
16949
  "packages/core/release-propagation-capture.js#PACKAGE_RELEASE_PROPAGATION_CONFIG_CONTRACT",
16651
16950
  "packages/core/paper.js#PAPER_ALPHA_PLAN_CONTRACT",
@@ -16672,6 +16971,7 @@
16672
16971
  "packages/core/paper.js#planPaperScaffold",
16673
16972
  "packages/core/release-line-bootstrap.js#planReleaseLineBootstrap",
16674
16973
  "packages/core/release-propagation.js#planReleasePropagation",
16974
+ "packages/core/release-propagation-agent-entry.js#planSiteUpstreamAgentEntry",
16675
16975
  "packages/core/publish-transaction.js#planTransactionRecovery",
16676
16976
  "packages/core/github-artifact-attestation.js#prepareGitHubArtifactAttestation",
16677
16977
  "packages/core/publication-package.js#preparePublicationNpmPackage",
@@ -16732,9 +17032,13 @@
16732
17032
  "packages/core/release-passport.js#RELEASE_PASSPORT_CONTRACT",
16733
17033
  "packages/core/release-passport-contract.js#RELEASE_PASSPORT_SCHEMA",
16734
17034
  "packages/core/release-passport-contract.js#RELEASE_PASSPORT_SCHEMA_ID",
17035
+ "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX",
17036
+ "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
16735
17037
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_GRAPH_CONTRACT",
16736
17038
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_LOCK_CONTRACT",
16737
17039
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_PLAN_CONTRACT",
17040
+ "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
17041
+ "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
16738
17042
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_RECEIPT_CONTRACT",
16739
17043
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_STAGE_RECEIPT_CONTRACT",
16740
17044
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
@@ -16781,6 +17085,7 @@
16781
17085
  "packages/core/artifact-passport.js#sha512IntegrityFile",
16782
17086
  "packages/core/package-manager.js#shellJoin",
16783
17087
  "packages/core/detached-artifact-signature.js#signDetachedArtifactRequest",
17088
+ "packages/core/release-propagation-agent-entry.js#SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
16784
17089
  "packages/core/stable-candidate-ledger.js#STABLE_CANDIDATE_LEDGER_CONTRACT",
16785
17090
  "packages/core/stable-candidate-ledger.js#STABLE_CANDIDATE_STATES",
16786
17091
  "packages/core/stable-candidate-ledger.js#stableCandidatePromotionRefs",
@@ -16947,7 +17252,7 @@
16947
17252
  "developer",
16948
17253
  "agent"
16949
17254
  ],
16950
- "symbolCount": 547,
17255
+ "symbolCount": 558,
16951
17256
  "symbolIds": [
16952
17257
  "packages/core/release-activation-transaction.js#abortReleaseActivationTransaction",
16953
17258
  "packages/core/release-passport.js#AGENT_INDEX_CONTRACT",
@@ -17047,6 +17352,7 @@
17047
17352
  "packages/core/readme-badges.js#checkReadmeBadgeBlock",
17048
17353
  "packages/core/release-propagation-work-transitions.js#claimReleasePropagationWork",
17049
17354
  "packages/core/diagnostics.js#classifyProcessCommand",
17355
+ "packages/core/release-propagation-agent-entry.js#classifyReleasePropagationCondition",
17050
17356
  "packages/core/github-governance-authority.js#codeownersForPath",
17051
17357
  "packages/core/readme-badges.js#collectBadgeBundleFacts",
17052
17358
  "packages/core/diagnostics.js#collectBuildchainDiagnostics",
@@ -17147,6 +17453,7 @@
17147
17453
  "packages/core/release-passport.js#createReleasePassport",
17148
17454
  "packages/core/release-passport-contract.js#createReleasePassportCheckManifest",
17149
17455
  "packages/core/release-propagation.js#createReleasePropagationLock",
17456
+ "packages/core/release-propagation-push.js#createReleasePropagationPushPlan",
17150
17457
  "packages/core/release-propagation.js#createReleasePropagationReceipt",
17151
17458
  "packages/core/release-propagation-work.js#createReleasePropagationStageReceipt",
17152
17459
  "packages/core/release-propagation-work.js#createReleasePropagationWork",
@@ -17187,6 +17494,7 @@
17187
17494
  "packages/core/paper.js#executePaperNpmBootstrap",
17188
17495
  "packages/core/paper-work.js#executePaperWorkStart",
17189
17496
  "packages/core/paper-work.js#executePaperWorkSubmitPush",
17497
+ "packages/core/release-propagation-push.js#executeReleasePropagationPush",
17190
17498
  "packages/core/artifact-passport.js#explainArtifactPassport",
17191
17499
  "packages/core/kfd-agent-hub.js#explainKfdAgentHub",
17192
17500
  "packages/core/release-line-dry-run.js#explainReleaseLineDryRun",
@@ -17224,6 +17532,7 @@
17224
17532
  "packages/core/release-passport.js#IMPACT_LEDGER_CONTRACT",
17225
17533
  "packages/core/kfd-agent-hub.js#initKfdAgentHub",
17226
17534
  "packages/core/kfd-agent-hub.js#inspectKfdAgentHub",
17535
+ "packages/core/release-propagation-push.js#inspectReleasePropagationPushState",
17227
17536
  "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_ADOPTION_CONTRACT",
17228
17537
  "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_ADOPTION_SCHEMA",
17229
17538
  "packages/core/kfd-agent-hub.js#KFD_AGENT_HUB_DECLARATION",
@@ -17291,6 +17600,7 @@
17291
17600
  "packages/core/release-propagation-pickup.js#normalizeManualUpstreamPickupConfig",
17292
17601
  "packages/core/release-propagation-capture.js#normalizePackageReleasePropagationConfig",
17293
17602
  "packages/core/release-propagation.js#normalizeReleasePropagationGraph",
17603
+ "packages/core/release-propagation-agent-entry.js#normalizeSiteUpstreamIntent",
17294
17604
  "packages/core/stable-candidate-ledger.js#normalizeStableCandidateLedger",
17295
17605
  "packages/core/release-propagation-capture.js#PACKAGE_RELEASE_PROPAGATION_CONFIG_CONTRACT",
17296
17606
  "packages/core/paper.js#PAPER_ALPHA_PLAN_CONTRACT",
@@ -17317,6 +17627,7 @@
17317
17627
  "packages/core/paper.js#planPaperScaffold",
17318
17628
  "packages/core/release-line-bootstrap.js#planReleaseLineBootstrap",
17319
17629
  "packages/core/release-propagation.js#planReleasePropagation",
17630
+ "packages/core/release-propagation-agent-entry.js#planSiteUpstreamAgentEntry",
17320
17631
  "packages/core/publish-transaction.js#planTransactionRecovery",
17321
17632
  "packages/core/github-artifact-attestation.js#prepareGitHubArtifactAttestation",
17322
17633
  "packages/core/publication-package.js#preparePublicationNpmPackage",
@@ -17377,9 +17688,13 @@
17377
17688
  "packages/core/release-passport.js#RELEASE_PASSPORT_CONTRACT",
17378
17689
  "packages/core/release-passport-contract.js#RELEASE_PASSPORT_SCHEMA",
17379
17690
  "packages/core/release-passport-contract.js#RELEASE_PASSPORT_SCHEMA_ID",
17691
+ "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX",
17692
+ "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
17380
17693
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_GRAPH_CONTRACT",
17381
17694
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_LOCK_CONTRACT",
17382
17695
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_PLAN_CONTRACT",
17696
+ "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
17697
+ "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
17383
17698
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_RECEIPT_CONTRACT",
17384
17699
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_STAGE_RECEIPT_CONTRACT",
17385
17700
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
@@ -17426,6 +17741,7 @@
17426
17741
  "packages/core/artifact-passport.js#sha512IntegrityFile",
17427
17742
  "packages/core/package-manager.js#shellJoin",
17428
17743
  "packages/core/detached-artifact-signature.js#signDetachedArtifactRequest",
17744
+ "packages/core/release-propagation-agent-entry.js#SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
17429
17745
  "packages/core/stable-candidate-ledger.js#STABLE_CANDIDATE_LEDGER_CONTRACT",
17430
17746
  "packages/core/stable-candidate-ledger.js#STABLE_CANDIDATE_STATES",
17431
17747
  "packages/core/stable-candidate-ledger.js#stableCandidatePromotionRefs",
@@ -18557,7 +18873,7 @@
18557
18873
  "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
18558
18874
  "export": "./buildchain-publication-authority",
18559
18875
  "target": "./packages/core/buildchain-publication-authority.js",
18560
- "digest": "sha256:4ac32145cacbf15e1fa4f8c5daf24c2374a76e9f079afc5bcc8d444c64c2d246",
18876
+ "digest": "sha256:377c23328c8d07fd98def4e2f170d68294893f695cda8cb85766c45083510e87",
18561
18877
  "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
18562
18878
  "capabilityGroup": "release-passport-trust",
18563
18879
  "audience": [
@@ -18798,36 +19114,46 @@
18798
19114
  "specifier": "@kungfu-tech/buildchain/release-propagation",
18799
19115
  "export": "./release-propagation",
18800
19116
  "target": "./packages/core/release-propagation.js",
18801
- "digest": "sha256:959a9474d48da2090debac31eb95927652ad05ded0364ef6b736b6c12af96847",
19117
+ "digest": "sha256:2a04d2061d8c3dbc3a5b91a48d0e0392f3e345f247251efb23d5edf95329a092",
18802
19118
  "summary": "Release propagation graph, plan, and exact upstream lock APIs.",
18803
19119
  "capabilityGroup": "site-and-propagation",
18804
19120
  "audience": [
18805
19121
  "developer",
18806
19122
  "agent"
18807
19123
  ],
18808
- "symbolCount": 31,
19124
+ "symbolCount": 42,
18809
19125
  "symbolIds": [
18810
19126
  "packages/core/release-propagation-work-transitions.js#claimReleasePropagationWork",
19127
+ "packages/core/release-propagation-agent-entry.js#classifyReleasePropagationCondition",
18811
19128
  "packages/core/release-propagation-work-transitions.js#completeReleasePropagationWork",
18812
19129
  "packages/core/release-propagation-pickup.js#createManualUpstreamPickupCapture",
18813
19130
  "packages/core/release-propagation-pickup.js#createManualUpstreamPickupPlan",
18814
19131
  "packages/core/release-propagation-capture.js#createPackageReleasePropagationCapture",
18815
19132
  "packages/core/release-propagation.js#createReleasePropagationLock",
19133
+ "packages/core/release-propagation-push.js#createReleasePropagationPushPlan",
18816
19134
  "packages/core/release-propagation.js#createReleasePropagationReceipt",
18817
19135
  "packages/core/release-propagation-work.js#createReleasePropagationStageReceipt",
18818
19136
  "packages/core/release-propagation-work.js#createReleasePropagationWork",
19137
+ "packages/core/release-propagation-push.js#executeReleasePropagationPush",
19138
+ "packages/core/release-propagation-push.js#inspectReleasePropagationPushState",
18819
19139
  "packages/core/release-propagation-pickup.js#MANUAL_UPSTREAM_PICKUP_CONFIG_CONTRACT",
18820
19140
  "packages/core/release-propagation-pickup.js#MANUAL_UPSTREAM_PICKUP_PLAN_CONTRACT",
18821
19141
  "packages/core/release-propagation-pickup.js#normalizeManualUpstreamPickupConfig",
18822
19142
  "packages/core/release-propagation-capture.js#normalizePackageReleasePropagationConfig",
18823
19143
  "packages/core/release-propagation.js#normalizeReleasePropagationGraph",
19144
+ "packages/core/release-propagation-agent-entry.js#normalizeSiteUpstreamIntent",
18824
19145
  "packages/core/release-propagation-capture.js#PACKAGE_RELEASE_PROPAGATION_CONFIG_CONTRACT",
18825
19146
  "packages/core/release-propagation.js#planReleasePropagation",
19147
+ "packages/core/release-propagation-agent-entry.js#planSiteUpstreamAgentEntry",
18826
19148
  "packages/core/release-propagation.js#readReleasePropagationJson",
18827
19149
  "packages/core/release-propagation-work-transitions.js#recordReleasePropagationStage",
19150
+ "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX",
19151
+ "packages/core/release-propagation-agent-entry.js#RELEASE_PROPAGATION_FAILURE_MATRIX_CONTRACT",
18828
19152
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_GRAPH_CONTRACT",
18829
19153
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_LOCK_CONTRACT",
18830
19154
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_PLAN_CONTRACT",
19155
+ "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_PLAN_CONTRACT",
19156
+ "packages/core/release-propagation-push.js#RELEASE_PROPAGATION_PUSH_RESULT_CONTRACT",
18831
19157
  "packages/core/release-propagation.js#RELEASE_PROPAGATION_RECEIPT_CONTRACT",
18832
19158
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_STAGE_RECEIPT_CONTRACT",
18833
19159
  "packages/core/release-propagation-work-constants.js#RELEASE_PROPAGATION_WORK_CONTRACT",
@@ -18836,6 +19162,7 @@
18836
19162
  "packages/core/release-propagation-pickup.js#resolveNpmRegistryRelease",
18837
19163
  "packages/core/release-propagation.js#resolvePropagationChannel",
18838
19164
  "packages/core/release-propagation-work.js#resumeReleasePropagationWork",
19165
+ "packages/core/release-propagation-agent-entry.js#SITE_UPSTREAM_AGENT_ENTRY_CONTRACT",
18839
19166
  "packages/core/release-propagation-work.js#verifyReleasePropagationWork",
18840
19167
  "packages/core/release-propagation.js#writeReleasePropagationLock"
18841
19168
  ],
@@ -18947,7 +19274,7 @@
18947
19274
  {
18948
19275
  "id": "node-api-reference",
18949
19276
  "path": "docs/node-api-reference.md",
18950
- "digest": "sha256:deab508284ed365a830894205a4d293c524281d6da7126094cf8e9eea8efe223"
19277
+ "digest": "sha256:ae49a589091d1ab91d29f2d6ac52cf2551a9d0b1f78350965b408f40fd219e29"
18951
19278
  },
18952
19279
  {
18953
19280
  "id": "build-facts",