@kungfu-tech/buildchain 4.1.6-alpha.0 → 4.1.7-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 (101) hide show
  1. package/AGENTS.md +7 -5
  2. package/CONTRIBUTING.md +12 -6
  3. package/README.md +9 -5
  4. package/architecture/action-taxonomy.json +2 -0
  5. package/architecture/agent-change-map.md +6 -1
  6. package/architecture/build-orchestration.json +7 -1
  7. package/architecture/ci-lane-change-budget.json +1836 -0
  8. package/architecture/consumer-upgrade.json +6482 -0
  9. package/architecture/internal-capabilities.json +5 -2
  10. package/architecture/maintainability-debt.json +18 -10
  11. package/architecture/maintainability-policy.json +9 -9
  12. package/architecture/release-topology.json +10 -1
  13. package/architecture/universal-workflow-bootstrap.json +88 -18
  14. package/architecture/universal-workflow-capability-policy.json +2 -2
  15. package/architecture/workflow-taxonomy.json +2 -1
  16. package/contracts/dev-delivery-authority-v2.schema.json +29 -3
  17. package/contracts/fixtures/consumer-upgrade/build-v4.0.0.json +764 -0
  18. package/contracts/fixtures/consumer-upgrade/consumer-calls.json +447 -0
  19. package/contracts/fixtures/consumer-upgrade/dev-delivery-identity-v4.0.0.json +27 -0
  20. package/contracts/fixtures/consumer-upgrade/dev-pr-auto-merge-v4.0.0.json +256 -0
  21. package/contracts/fixtures/consumer-upgrade/dev-pr-auto-merge-v4.0.9.json +358 -0
  22. package/contracts/fixtures/consumer-upgrade/release-v4.0.0.json +815 -0
  23. package/contracts/promotion-invocation-v1.schema.json +5 -0
  24. package/dist/site/buildchain-contract.json +40 -23
  25. package/dist/site/buildchain-site.json +20 -20
  26. package/dist/site/capability-registry.json +5 -5
  27. package/dist/site/controller-registry.json +17 -5
  28. package/dist/site/kfd-claims.json +1376 -143
  29. package/dist/site/kfd-upstream-aggregate.json +1 -1
  30. package/dist/site/manual-registry.json +4 -4
  31. package/dist/site/node-api-registry.json +22 -22
  32. package/dist/site/page-registry.json +14 -14
  33. package/dist/site/public-surface-audit.json +1733 -101
  34. package/dist/site/publication-authority-registry.json +651 -32
  35. package/dist/site/publication-registry.json +1 -1
  36. package/dist/site/schemas/dev-delivery-authority-v2.schema.json +29 -3
  37. package/dist/site/site-manifest.json +5 -5
  38. package/dist/site/workflow-registry.json +2501 -149
  39. package/docs/MAP.md +5 -4
  40. package/docs/code-organization.md +11 -8
  41. package/docs/getting-started.md +31 -2
  42. package/docs/migration-inventory.md +8 -6
  43. package/docs/node-api-reference.md +36 -36
  44. package/docs/workflow-path-migration.md +8 -7
  45. package/package.json +1 -1
  46. package/packages/core/build/artifact/contracts.js +10 -2
  47. package/packages/core/build/artifact/transport.js +1 -1
  48. package/packages/core/build/artifact/upload.js +2 -2
  49. package/packages/core/build/plan/action.js +2 -0
  50. package/packages/core/build/plan/admission.js +9 -3
  51. package/packages/core/build/plan/compatibility-artifacts.js +47 -0
  52. package/packages/core/build/plan/compatibility-plan.js +121 -0
  53. package/packages/core/build/plan/compatibility.js +162 -0
  54. package/packages/core/build/plan/configuration.js +10 -37
  55. package/packages/core/build/plan/identity.js +42 -0
  56. package/packages/core/build/plan/lifecycle.js +1 -0
  57. package/packages/core/build/plan/resolve.js +2 -0
  58. package/packages/core/build/summary/aggregation.js +4 -2
  59. package/packages/core/build/summary/compatibility.js +24 -0
  60. package/packages/core/build/summary/finalization.js +18 -0
  61. package/packages/core/build/summary/historical-outputs.js +88 -0
  62. package/packages/core/contracts/runtime-contract-inspection.js +8 -0
  63. package/packages/core/dev-delivery/candidate/submission.js +2 -1
  64. package/packages/core/dev-delivery/commands/dev-delivery-authority-command-adapters.mjs +2 -1
  65. package/packages/core/dev-delivery/commands/dev-delivery-authority.mjs +6 -5
  66. package/packages/core/dev-delivery/commands/dev-delivery-warrant-options.mjs +22 -3
  67. package/packages/core/dev-delivery/dev-delivery-candidate-identity.js +13 -4
  68. package/packages/core/dev-delivery/dev-delivery-warrant.js +4 -1
  69. package/packages/core/dev-delivery/warrant/handoff.js +2 -1
  70. package/packages/core/dev-delivery/warrant/transitions.js +2 -2
  71. package/packages/core/governance/buildchain-publication-authority.js +5 -9
  72. package/packages/core/release/github-release-metadata.js +58 -0
  73. package/packages/core/release/promote-candidate/action.js +4 -2
  74. package/packages/core/release/promote-candidate/preparation.js +6 -0
  75. package/packages/core/release/promote-candidate/publication.js +36 -0
  76. package/packages/core/release/promote-candidate/release-documents.js +1 -1
  77. package/packages/core/release/promotion/candidate.js +4 -2
  78. package/packages/core/release/promotion/compatibility-context.js +93 -0
  79. package/packages/core/release/promotion/compatibility-qualification.js +48 -0
  80. package/packages/core/release/promotion/compatibility.js +141 -0
  81. package/packages/core/release/promotion/historical-evidence-action.js +17 -0
  82. package/packages/core/release/promotion/historical-evidence-files.js +112 -0
  83. package/packages/core/release/promotion/historical-evidence.js +231 -0
  84. package/packages/core/release/promotion/qualification.js +12 -1
  85. package/packages/core/release/promotion/routing.js +3 -2
  86. package/packages/core/release/promotion-request.js +31 -2
  87. package/packages/core/release/release-tail-provider-adapters.js +18 -0
  88. package/packages/core/runtime/entry/actions.js +4 -1
  89. package/packages/core/runtime/entry/compatibility.js +53 -0
  90. package/packages/core/workflow/engine/conformance.js +7 -3
  91. package/packages/core/workflow/pipeline/controller.js +26 -26
  92. package/scripts/check-dev-delivery-actions.mjs +12 -0
  93. package/scripts/check-inventory.mjs +1 -1
  94. package/scripts/check-public-dogfood-contract.mjs +2 -0
  95. package/scripts/check-release-topology.mjs +5 -1
  96. package/scripts/check-self-consumer-contract.mjs +5 -1
  97. package/scripts/generate-bootstrap-admission.mjs +20 -0
  98. package/scripts/generate-site-bundle.mjs +5 -5
  99. package/scripts/generate-workflow-taxonomy.mjs +17 -0
  100. package/scripts/maintainability-metrics.mjs +30 -2
  101. package/scripts/maintainability-public-surface.mjs +5 -3
@@ -4,7 +4,7 @@
4
4
  "product": {
5
5
  "id": "kungfu-tech-buildchain",
6
6
  "name": "@kungfu-tech/buildchain",
7
- "version": "4.1.6-alpha.0",
7
+ "version": "4.1.7-alpha.0",
8
8
  "repository": "https://github.com/kungfu-systems/buildchain"
9
9
  },
10
10
  "source": {
@@ -9,7 +9,7 @@
9
9
  "title": "Buildchain documentation map",
10
10
  "path": "docs/MAP.md",
11
11
  "plane": "use",
12
- "digest": "sha256:dc5a0ead4c0ee474b54fd29275ed6024099948730bbf645b1d5e26ed9a4d9402",
12
+ "digest": "sha256:e73a9d94a37deb8354f741ee3a780c7bae1ec5fc28dd7eb917717b0fa289d56f",
13
13
  "capabilityGroup": "getting-started",
14
14
  "audience": [
15
15
  "agent",
@@ -23,7 +23,7 @@
23
23
  "title": "Golden Path",
24
24
  "path": "docs/getting-started.md",
25
25
  "plane": "use",
26
- "digest": "sha256:f7288047140441da510739759b4bc4e98953a93758241201517685ef2a59cfba",
26
+ "digest": "sha256:74b768144656395a3601173e38b931f6a228087f337551c4b3de5f1e36498d09",
27
27
  "capabilityGroup": "getting-started",
28
28
  "audience": [
29
29
  "consumer",
@@ -292,7 +292,7 @@
292
292
  "title": "Migration inventory",
293
293
  "path": "docs/migration-inventory.md",
294
294
  "plane": "verify",
295
- "digest": "sha256:704cb3bae314a8e57488fa1c0e897b7aa39619947dfdb02ceb1a6e1b945b8575",
295
+ "digest": "sha256:9c906930fd60bab1d22f56f8d1d26e1b83fe849bfcf67941b7e53003da15ba56",
296
296
  "capabilityGroup": "governance-versioning",
297
297
  "audience": [
298
298
  "maintainer",
@@ -362,7 +362,7 @@
362
362
  "title": "Generated Node API reference",
363
363
  "path": "docs/node-api-reference.md",
364
364
  "plane": "use",
365
- "digest": "sha256:eb8723de940d6c368163403df0680f9419379b3dc439f48bb5c5b52c778617c3",
365
+ "digest": "sha256:e05aeb1a6689be4bbb4958140caab07794d7a466f352f1b39eda1c7eb63bf0a9",
366
366
  "capabilityGroup": "api-cli-reference",
367
367
  "audience": [
368
368
  "agent",
@@ -10767,7 +10767,7 @@
10767
10767
  ],
10768
10768
  "source": {
10769
10769
  "path": "packages/core/dev-delivery/dev-delivery-warrant.js",
10770
- "line": 519
10770
+ "line": 522
10771
10771
  },
10772
10772
  "example": "import { cancelQueuedDevDeliveryCandidate } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
10773
10773
  "maturity": "stable",
@@ -10804,7 +10804,7 @@
10804
10804
  ],
10805
10805
  "source": {
10806
10806
  "path": "packages/core/dev-delivery/dev-delivery-warrant.js",
10807
- "line": 395
10807
+ "line": 396
10808
10808
  },
10809
10809
  "example": "import { closeDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
10810
10810
  "maturity": "stable",
@@ -11177,7 +11177,7 @@
11177
11177
  ],
11178
11178
  "source": {
11179
11179
  "path": "packages/core/dev-delivery/dev-delivery-warrant.js",
11180
- "line": 266
11180
+ "line": 267
11181
11181
  },
11182
11182
  "example": "import { heartbeatDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
11183
11183
  "maturity": "stable",
@@ -11234,7 +11234,7 @@
11234
11234
  ],
11235
11235
  "source": {
11236
11236
  "path": "packages/core/dev-delivery/dev-delivery-warrant.js",
11237
- "line": 533
11237
+ "line": 536
11238
11238
  },
11239
11239
  "example": "import { observeDevDeliveryQueue } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
11240
11240
  "maturity": "stable",
@@ -11258,7 +11258,7 @@
11258
11258
  ],
11259
11259
  "source": {
11260
11260
  "path": "packages/core/dev-delivery/dev-delivery-warrant.js",
11261
- "line": 391
11261
+ "line": 392
11262
11262
  },
11263
11263
  "example": "import { qualifyDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
11264
11264
  "maturity": "stable",
@@ -11306,7 +11306,7 @@
11306
11306
  ],
11307
11307
  "source": {
11308
11308
  "path": "packages/core/dev-delivery/dev-delivery-warrant.js",
11309
- "line": 528
11309
+ "line": 531
11310
11310
  },
11311
11311
  "example": "import { reconcileDevDeliveryTerminalEvidence } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
11312
11312
  "maturity": "stable",
@@ -11339,7 +11339,7 @@
11339
11339
  ],
11340
11340
  "source": {
11341
11341
  "path": "packages/core/dev-delivery/dev-delivery-warrant.js",
11342
- "line": 312
11342
+ "line": 313
11343
11343
  },
11344
11344
  "example": "import { recoverExpiredDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
11345
11345
  "maturity": "stable",
@@ -11372,7 +11372,7 @@
11372
11372
  ],
11373
11373
  "source": {
11374
11374
  "path": "packages/core/dev-delivery/dev-delivery-warrant.js",
11375
- "line": 106
11375
+ "line": 107
11376
11376
  },
11377
11377
  "example": "import { selectDevDeliveryWarrant } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
11378
11378
  "maturity": "stable",
@@ -11396,7 +11396,7 @@
11396
11396
  ],
11397
11397
  "source": {
11398
11398
  "path": "packages/core/dev-delivery/dev-delivery-warrant.js",
11399
- "line": 522
11399
+ "line": 525
11400
11400
  },
11401
11401
  "example": "import { settleDevDeliveryTerminalEvent } from \"@kungfu-tech/buildchain/dev-delivery-warrant\";",
11402
11402
  "maturity": "stable",
@@ -12184,7 +12184,7 @@
12184
12184
  ],
12185
12185
  "source": {
12186
12186
  "path": "packages/core/governance/buildchain-publication-authority.js",
12187
- "line": 50
12187
+ "line": 51
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": 89
12216
+ "line": 85
12217
12217
  },
12218
12218
  "example": "import { createBuildchainPublicationAuthorityRegistry } from \"@kungfu-tech/buildchain\";",
12219
12219
  "maturity": "stable",
@@ -23463,7 +23463,7 @@
23463
23463
  ],
23464
23464
  "source": {
23465
23465
  "path": "packages/core/release/release-tail-provider-adapters.js",
23466
- "line": 181
23466
+ "line": 182
23467
23467
  },
23468
23468
  "example": "import { createActivationReceiptProjectorAdapter } from \"@kungfu-tech/buildchain\";",
23469
23469
  "maturity": "stable",
@@ -23492,7 +23492,7 @@
23492
23492
  ],
23493
23493
  "source": {
23494
23494
  "path": "packages/core/release/release-tail-provider-adapters.js",
23495
- "line": 310
23495
+ "line": 311
23496
23496
  },
23497
23497
  "example": "import { createGitHubReleaseAssetsAdapter } from \"@kungfu-tech/buildchain\";",
23498
23498
  "maturity": "stable",
@@ -23521,7 +23521,7 @@
23521
23521
  ],
23522
23522
  "source": {
23523
23523
  "path": "packages/core/release/release-tail-provider-adapters.js",
23524
- "line": 191
23524
+ "line": 192
23525
23525
  },
23526
23526
  "example": "import { createHttpJsonReadback } from \"@kungfu-tech/buildchain\";",
23527
23527
  "maturity": "stable",
@@ -23550,7 +23550,7 @@
23550
23550
  ],
23551
23551
  "source": {
23552
23552
  "path": "packages/core/release/release-tail-provider-adapters.js",
23553
- "line": 161
23553
+ "line": 162
23554
23554
  },
23555
23555
  "example": "import { createSignedStaticChannelAdapter } from \"@kungfu-tech/buildchain\";",
23556
23556
  "maturity": "stable",
@@ -23579,7 +23579,7 @@
23579
23579
  ],
23580
23580
  "source": {
23581
23581
  "path": "packages/core/release/release-tail-provider-adapters.js",
23582
- "line": 171
23582
+ "line": 172
23583
23583
  },
23584
23584
  "example": "import { createSiteReleaseActivationAdapter } from \"@kungfu-tech/buildchain\";",
23585
23585
  "maturity": "stable",
@@ -23608,7 +23608,7 @@
23608
23608
  ],
23609
23609
  "source": {
23610
23610
  "path": "packages/core/release/release-tail-provider-adapters.js",
23611
- "line": 297
23611
+ "line": 298
23612
23612
  },
23613
23613
  "example": "import { githubReleaseAssetsTargetRoot } from \"@kungfu-tech/buildchain\";",
23614
23614
  "maturity": "stable",
@@ -23632,7 +23632,7 @@
23632
23632
  ],
23633
23633
  "source": {
23634
23634
  "path": "packages/core/release/release-tail-provider-adapters.js",
23635
- "line": 9
23635
+ "line": 10
23636
23636
  },
23637
23637
  "example": "import { ReleaseTailProviderError } from \"@kungfu-tech/buildchain\";",
23638
23638
  "maturity": "stable",
@@ -27860,7 +27860,7 @@
27860
27860
  "specifier": "@kungfu-tech/buildchain/dev-delivery-warrant",
27861
27861
  "export": "./dev-delivery-warrant",
27862
27862
  "target": "./packages/core/dev-delivery/dev-delivery-warrant.js",
27863
- "digest": "sha256:86cdcfcd6ea321245719bd37a0a277249f2778ebc301eaea64c411e446e82a96",
27863
+ "digest": "sha256:aa841331bdcff362f0e430b11f9937ad4bc6f320482338c8a658658bf9baddfb",
27864
27864
  "summary": "Durable fair Dev Delivery Warrant queue, fenced lease, and split source and integration proof APIs.",
27865
27865
  "capabilityGroup": "governance-versioning",
27866
27866
  "audience": [
@@ -28870,7 +28870,7 @@
28870
28870
  "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
28871
28871
  "export": "./buildchain-publication-authority",
28872
28872
  "target": "./packages/core/governance/buildchain-publication-authority.js",
28873
- "digest": "sha256:71a8eb0d09571955f83bed634743e3571346c29af9772feb7a27a835beb087ec",
28873
+ "digest": "sha256:14972f19229bc4089260ab481776096421d31008f5c56d1b803635aa8f17b3d1",
28874
28874
  "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
28875
28875
  "capabilityGroup": "release-passport-trust",
28876
28876
  "audience": [
@@ -29469,7 +29469,7 @@
29469
29469
  "specifier": "@kungfu-tech/buildchain/release-tail-provider-adapters",
29470
29470
  "export": "./release-tail-provider-adapters",
29471
29471
  "target": "./packages/core/release/release-tail-provider-adapters.js",
29472
- "digest": "sha256:56ee24cb3b8d89808ba17bc5dbbf5038d466d71ab7ecf1329c64a946f4cd13a3",
29472
+ "digest": "sha256:f1f6931f8bc8107a753a10ca77a62b1fbf731fcb450cf8c9750c693641c994d1",
29473
29473
  "summary": "Buildchain-owned GitHub Release, signed-channel, activation, and released-evidence provider adapters.",
29474
29474
  "capabilityGroup": "release-passport-trust",
29475
29475
  "audience": [
@@ -29845,7 +29845,7 @@
29845
29845
  {
29846
29846
  "id": "node-api-reference",
29847
29847
  "path": "docs/node-api-reference.md",
29848
- "digest": "sha256:eb8723de940d6c368163403df0680f9419379b3dc439f48bb5c5b52c778617c3"
29848
+ "digest": "sha256:e05aeb1a6689be4bbb4958140caab07794d7a466f352f1b39eda1c7eb63bf0a9"
29849
29849
  },
29850
29850
  {
29851
29851
  "id": "build-facts",