@kungfu-tech/buildchain 4.1.3-alpha.4 → 4.1.3-alpha.6

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 (79) hide show
  1. package/AGENTS.md +41 -75
  2. package/CONTRIBUTING.md +19 -26
  3. package/architecture/agent-change-map.md +8 -12
  4. package/architecture/capability-state-machine-manifest.json +1 -4
  5. package/architecture/ci-lane-change-budget.json +35 -1026
  6. package/architecture/core-mechanisms.json +3 -6
  7. package/architecture/internal-capabilities.json +1 -5
  8. package/architecture/maintainability-debt.json +44 -36
  9. package/architecture/maintainability-policy.json +8 -8
  10. package/architecture/minimal-consumer-migration.json +80 -1977
  11. package/architecture/platform-stage-checkpoints.json +31 -7
  12. package/architecture/release-topology.json +64 -84
  13. package/architecture/stage-capsule-qualification.json +3 -1
  14. package/architecture/universal-workflow-bootstrap.json +3 -1
  15. package/architecture/universal-workflow-capability-policy.json +4 -4
  16. package/architecture/universal-workflow-fault-campaign.json +3 -1
  17. package/architecture/workflow-taxonomy.json +24 -341
  18. package/dist/site/buildchain-contract.json +13 -67
  19. package/dist/site/buildchain-site.json +33 -23
  20. package/dist/site/capability-registry.json +2 -2
  21. package/dist/site/controller-registry.json +1 -47
  22. package/dist/site/kfd-claims.json +78 -448
  23. package/dist/site/kfd-upstream-aggregate.json +1 -1
  24. package/dist/site/manual-registry.json +3 -3
  25. package/dist/site/node-api-registry.json +24 -24
  26. package/dist/site/page-registry.json +26 -16
  27. package/dist/site/public-surface-audit.json +35 -349
  28. package/dist/site/publication-authority-registry.json +51 -511
  29. package/dist/site/publication-registry.json +4 -4
  30. package/dist/site/site-manifest.json +7 -7
  31. package/dist/site/workflow-registry.json +263 -1128
  32. package/docs/code-organization.md +9 -6
  33. package/docs/node-api-reference.md +57 -57
  34. package/docs/release-governance.md +10 -12
  35. package/docs/runtime-entry.md +31 -3
  36. package/docs/runtime-train-validation.md +39 -11
  37. package/docs/stable-candidate-patrol.md +6 -5
  38. package/docs/workflow-catalog.md +3 -32
  39. package/package.json +1 -1
  40. package/packages/core/adoption/buildchain-kfd-claims.js +7 -7
  41. package/packages/core/dev-delivery/dev-delivery-provider-heartbeat.js +18 -15
  42. package/packages/core/dev-delivery/native/actions.js +2 -0
  43. package/packages/core/dev-delivery/native/process-entry.js +19 -0
  44. package/packages/core/dev-delivery/queue/landing-action.js +49 -1
  45. package/packages/core/dev-delivery/warrant/failure-settlement.js +8 -6
  46. package/packages/core/dev-delivery/warrant/service.js +7 -0
  47. package/packages/core/governance/buildchain-publication-authority.js +2 -23
  48. package/packages/core/governance/github-governance-authority.js +1 -0
  49. package/packages/core/observability/controller-evidence.js +0 -8
  50. package/packages/core/providers/github/pipeline-entry-runs.js +8 -1
  51. package/packages/core/providers/github/pipeline-events.js +79 -0
  52. package/packages/core/providers/github/pipeline-source.js +24 -7
  53. package/packages/core/publication/pipeline/pack.js +31 -8
  54. package/packages/core/workflow/pipeline/actions.js +0 -23
  55. package/packages/core/workflow/pipeline/build-evidence.js +123 -5
  56. package/packages/core/workflow/pipeline/build-result.js +1 -0
  57. package/packages/core/workflow/pipeline/channel-control.js +25 -4
  58. package/packages/core/workflow/pipeline/controller.js +9 -1
  59. package/packages/core/workflow/pipeline/delivery-control.js +54 -9
  60. package/packages/core/workflow/pipeline/delivery-observation.js +16 -10
  61. package/packages/core/workflow/pipeline/group-control.js +1 -0
  62. package/packages/core/workflow/pipeline/guard-build.js +37 -0
  63. package/packages/core/workflow/pipeline/guard.js +4 -2
  64. package/packages/core/workflow/pipeline/host.js +23 -1
  65. package/packages/core/workflow/pipeline/integration-status.js +113 -0
  66. package/packages/core/workflow/pipeline/record-action.js +27 -0
  67. package/packages/core/workflow/pipeline/recorder-status.js +69 -0
  68. package/packages/core/workflow/workflow-taxonomy.mjs +67 -47
  69. package/scripts/check-inventory.mjs +7 -70
  70. package/scripts/check-pipeline-publication-topology.mjs +2 -0
  71. package/scripts/check-public-dogfood-contract.mjs +38 -51
  72. package/scripts/check-release-topology.mjs +8 -7
  73. package/scripts/check-self-consumer-contract.mjs +133 -0
  74. package/scripts/check-universal-workflow-bootstrap.mjs +4 -6
  75. package/scripts/generate-minimal-consumer-contract.mjs +1 -1
  76. package/scripts/inventory/binary.mjs +9 -19
  77. package/scripts/inventory/promotion.mjs +2 -13
  78. package/scripts/prepare-product-toolchain.mjs +10 -0
  79. package/scripts/verify-product-platform.mjs +65 -0
@@ -841,7 +841,7 @@
841
841
  ],
842
842
  "source": {
843
843
  "path": "packages/core/adoption/buildchain-kfd-claims.js",
844
- "line": 530
844
+ "line": 532
845
845
  },
846
846
  "example": "import { createBuildchainKfd1Witness } from \"@kungfu-tech/buildchain\";",
847
847
  "maturity": "stable",
@@ -928,7 +928,7 @@
928
928
  ],
929
929
  "source": {
930
930
  "path": "packages/core/adoption/buildchain-kfd-claims.js",
931
- "line": 583
931
+ "line": 584
932
932
  },
933
933
  "example": "import { createBuildchainKfd3PrebuildWitness } from \"@kungfu-tech/buildchain\";",
934
934
  "maturity": "stable",
@@ -957,7 +957,7 @@
957
957
  ],
958
958
  "source": {
959
959
  "path": "packages/core/adoption/buildchain-kfd-claims.js",
960
- "line": 510
960
+ "line": 512
961
961
  },
962
962
  "example": "import { createBuildchainKfdClaimRegistry } from \"@kungfu-tech/buildchain\";",
963
963
  "maturity": "stable",
@@ -986,7 +986,7 @@
986
986
  ],
987
987
  "source": {
988
988
  "path": "packages/core/adoption/buildchain-kfd-claims.js",
989
- "line": 411
989
+ "line": 413
990
990
  },
991
991
  "example": "import { createBuildchainKfdSurfaceRegistry } from \"@kungfu-tech/buildchain\";",
992
992
  "maturity": "stable",
@@ -1010,7 +1010,7 @@
1010
1010
  ],
1011
1011
  "source": {
1012
1012
  "path": "packages/core/adoption/buildchain-kfd-claims.js",
1013
- "line": 226
1013
+ "line": 228
1014
1014
  },
1015
1015
  "example": "import { createBuildchainPublicClaimDefinitions } from \"@kungfu-tech/buildchain\";",
1016
1016
  "maturity": "stable",
@@ -12184,7 +12184,7 @@
12184
12184
  ],
12185
12185
  "source": {
12186
12186
  "path": "packages/core/governance/buildchain-publication-authority.js",
12187
- "line": 71
12187
+ "line": 50
12188
12188
  },
12189
12189
  "example": "import { buildchainPublicationAuthorityDescriptors } from \"@kungfu-tech/buildchain\";",
12190
12190
  "maturity": "stable",
@@ -12213,7 +12213,7 @@
12213
12213
  ],
12214
12214
  "source": {
12215
12215
  "path": "packages/core/governance/buildchain-publication-authority.js",
12216
- "line": 110
12216
+ "line": 89
12217
12217
  },
12218
12218
  "example": "import { createBuildchainPublicationAuthorityRegistry } from \"@kungfu-tech/buildchain\";",
12219
12219
  "maturity": "stable",
@@ -12773,7 +12773,7 @@
12773
12773
  ],
12774
12774
  "source": {
12775
12775
  "path": "packages/core/governance/github-governance-authority.js",
12776
- "line": 1359
12776
+ "line": 1360
12777
12777
  },
12778
12778
  "example": "import { BUILDCHAIN_GITHUB_GOVERNANCE_AUTHORITY } from \"@kungfu-tech/buildchain\";",
12779
12779
  "maturity": "stable",
@@ -12797,7 +12797,7 @@
12797
12797
  ],
12798
12798
  "source": {
12799
12799
  "path": "packages/core/governance/github-governance-authority.js",
12800
- "line": 1361
12800
+ "line": 1362
12801
12801
  },
12802
12802
  "example": "import { BUILDCHAIN_GITHUB_GOVERNANCE_PROTECTED_PATHS } from \"@kungfu-tech/buildchain\";",
12803
12803
  "maturity": "stable",
@@ -14290,7 +14290,7 @@
14290
14290
  ],
14291
14291
  "source": {
14292
14292
  "path": "packages/core/observability/controller-evidence.js",
14293
- "line": 446
14293
+ "line": 438
14294
14294
  },
14295
14295
  "example": "import { aggregateControllerReceipts } from \"@kungfu-tech/buildchain\";",
14296
14296
  "maturity": "stable",
@@ -14415,7 +14415,7 @@
14415
14415
  ],
14416
14416
  "source": {
14417
14417
  "path": "packages/core/observability/controller-evidence.js",
14418
- "line": 145
14418
+ "line": 137
14419
14419
  },
14420
14420
  "example": "import { controllerEvidenceDigest } from \"@kungfu-tech/buildchain\";",
14421
14421
  "maturity": "stable",
@@ -14444,7 +14444,7 @@
14444
14444
  ],
14445
14445
  "source": {
14446
14446
  "path": "packages/core/observability/controller-evidence.js",
14447
- "line": 285
14447
+ "line": 277
14448
14448
  },
14449
14449
  "example": "import { createControllerPlan } from \"@kungfu-tech/buildchain\";",
14450
14450
  "maturity": "stable",
@@ -14473,7 +14473,7 @@
14473
14473
  ],
14474
14474
  "source": {
14475
14475
  "path": "packages/core/observability/controller-evidence.js",
14476
- "line": 361
14476
+ "line": 353
14477
14477
  },
14478
14478
  "example": "import { createControllerReceipt } from \"@kungfu-tech/buildchain\";",
14479
14479
  "maturity": "stable",
@@ -14502,7 +14502,7 @@
14502
14502
  ],
14503
14503
  "source": {
14504
14504
  "path": "packages/core/observability/controller-evidence.js",
14505
- "line": 488
14505
+ "line": 480
14506
14506
  },
14507
14507
  "example": "import { createControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
14508
14508
  "maturity": "stable",
@@ -14531,7 +14531,7 @@
14531
14531
  ],
14532
14532
  "source": {
14533
14533
  "path": "packages/core/observability/controller-evidence.js",
14534
- "line": 191
14534
+ "line": 183
14535
14535
  },
14536
14536
  "example": "import { createControllerRegistry } from \"@kungfu-tech/buildchain\";",
14537
14537
  "maturity": "stable",
@@ -14560,7 +14560,7 @@
14560
14560
  ],
14561
14561
  "source": {
14562
14562
  "path": "packages/core/observability/controller-evidence.js",
14563
- "line": 527
14563
+ "line": 519
14564
14564
  },
14565
14565
  "example": "import { normalizeControllerReceiptReferences } from \"@kungfu-tech/buildchain\";",
14566
14566
  "maturity": "stable",
@@ -14589,7 +14589,7 @@
14589
14589
  ],
14590
14590
  "source": {
14591
14591
  "path": "packages/core/observability/controller-evidence.js",
14592
- "line": 323
14592
+ "line": 315
14593
14593
  },
14594
14594
  "example": "import { validateControllerPlan } from \"@kungfu-tech/buildchain\";",
14595
14595
  "maturity": "stable",
@@ -14622,7 +14622,7 @@
14622
14622
  ],
14623
14623
  "source": {
14624
14624
  "path": "packages/core/observability/controller-evidence.js",
14625
- "line": 421
14625
+ "line": 413
14626
14626
  },
14627
14627
  "example": "import { validateControllerReceipt } from \"@kungfu-tech/buildchain\";",
14628
14628
  "maturity": "stable",
@@ -14655,7 +14655,7 @@
14655
14655
  ],
14656
14656
  "source": {
14657
14657
  "path": "packages/core/observability/controller-evidence.js",
14658
- "line": 502
14658
+ "line": 494
14659
14659
  },
14660
14660
  "example": "import { validateControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
14661
14661
  "maturity": "stable",
@@ -27972,7 +27972,7 @@
27972
27972
  "specifier": "@kungfu-tech/buildchain/controller-evidence",
27973
27973
  "export": "./controller-evidence",
27974
27974
  "target": "./packages/core/observability/controller-evidence.js",
27975
- "digest": "sha256:81d609cbb09d542498235b08e8d0a09ed677d365a928b5b6399c8d00893ff5cf",
27975
+ "digest": "sha256:a5962561d88b70284116c4877e1598d7cbd3e3fcda92eb8f1225dfe84890094b",
27976
27976
  "summary": "Project-independent controller descriptors, source/runtime-bound plans, receipts, aggregates, and validation APIs.",
27977
27977
  "capabilityGroup": "reusable-build",
27978
27978
  "audience": [
@@ -29127,7 +29127,7 @@
29127
29127
  "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
29128
29128
  "export": "./buildchain-publication-authority",
29129
29129
  "target": "./packages/core/governance/buildchain-publication-authority.js",
29130
- "digest": "sha256:57b7a0922c57daa5647a6e6439d36d62d80ec3a21050073330ff0c81df84ae24",
29130
+ "digest": "sha256:3913adeed87ec92822a912d2a54fb5623fc7bdf0fe0bd40956b6e5588f98bd6e",
29131
29131
  "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
29132
29132
  "capabilityGroup": "release-passport-trust",
29133
29133
  "audience": [
@@ -29151,7 +29151,7 @@
29151
29151
  "specifier": "@kungfu-tech/buildchain/github-governance-authority",
29152
29152
  "export": "./github-governance-authority",
29153
29153
  "target": "./packages/core/governance/github-governance-authority.js",
29154
- "digest": "sha256:78a4a33e1791d97de21d31f24d1aaf1e10a9cc17090c25f025c9d48e66b1bd61",
29154
+ "digest": "sha256:47a6a89126c626722761ed6e682e0c16a3bbd851463d24fbcc7082f1edc948d9",
29155
29155
  "summary": "Fail-closed GitHub ownership, effective-policy, managed-zone admission, rollout-plan, and immutable receipt APIs.",
29156
29156
  "capabilityGroup": "governance-versioning",
29157
29157
  "audience": [
@@ -29780,7 +29780,7 @@
29780
29780
  "specifier": "@kungfu-tech/buildchain/buildchain-kfd-claims",
29781
29781
  "export": "./buildchain-kfd-claims",
29782
29782
  "target": "./packages/core/adoption/buildchain-kfd-claims.js",
29783
- "digest": "sha256:6655f2c6a891f3c62a5577aee2b1ecff6e40dbc4ba5f2f566a0db8326e4e5967",
29783
+ "digest": "sha256:42da36e3dd17fc034b3d1f05b4115b0feeb484953dad197915ade993e936cc79",
29784
29784
  "summary": "Buildchain self KFD claim registry, witnesses, and public claim APIs.",
29785
29785
  "capabilityGroup": "kfd-trust",
29786
29786
  "audience": [
@@ -30102,7 +30102,7 @@
30102
30102
  {
30103
30103
  "id": "node-api-reference",
30104
30104
  "path": "docs/node-api-reference.md",
30105
- "digest": "sha256:a7135f86b2c74078eed1b6fd920629addce974140d7f18a7cdc86c21c8fd7f8d"
30105
+ "digest": "sha256:176c523f579e4b2221f2e323c35d4a5a803d522b8e4f9eeb252a25481688c09a"
30106
30106
  },
30107
30107
  {
30108
30108
  "id": "build-facts",