@kungfu-tech/buildchain 4.0.8 → 4.0.9-alpha.1

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 (57) hide show
  1. package/AGENTS.md +12 -19
  2. package/CONTRIBUTING.md +6 -9
  3. package/README.md +11 -1
  4. package/architecture/agent-change-map.md +11 -4
  5. package/architecture/build-environments.json +71 -0
  6. package/architecture/build-orchestration.json +18 -0
  7. package/architecture/ci-lane-change-budget.json +51 -2
  8. package/architecture/internal-capabilities.json +17 -4
  9. package/architecture/maintainability-debt.json +37 -126
  10. package/architecture/maintainability-policy.json +19 -210
  11. package/architecture/release-topology.json +9 -7
  12. package/architecture/universal-workflow-bootstrap.json +5 -4
  13. package/architecture/universal-workflow-train-admission.json +2 -2
  14. package/architecture/workflow-taxonomy.json +13 -0
  15. package/bin/buildchain.mjs +1 -1
  16. package/contracts/fixtures/v4-tail-reseal-v1/valid.json +1 -1
  17. package/dist/site/buildchain-contract.json +41 -1131
  18. package/dist/site/buildchain-site.json +48 -153
  19. package/dist/site/capability-registry.json +2 -2
  20. package/dist/site/cli-registry.json +1 -1
  21. package/dist/site/controller-registry.json +30 -868
  22. package/dist/site/kfd-claims.json +148 -396
  23. package/dist/site/kfd-upstream-aggregate.json +1 -1
  24. package/dist/site/manual-registry.json +7 -7
  25. package/dist/site/node-api-registry.json +37 -37
  26. package/dist/site/page-registry.json +36 -141
  27. package/dist/site/public-surface-audit.json +93 -402
  28. package/dist/site/publication-authority-registry.json +22 -1
  29. package/dist/site/publication-registry.json +4 -4
  30. package/dist/site/site-manifest.json +11 -11
  31. package/dist/site/workflow-registry.json +165 -391
  32. package/docs/MAP.md +5 -4
  33. package/docs/cli-reference.md +1 -1
  34. package/docs/getting-started.md +8 -7
  35. package/docs/node-api-reference.md +85 -85
  36. package/docs/release-governance.md +19 -18
  37. package/docs/reusable-build-surface.md +160 -1430
  38. package/docs/runtime-train-validation.md +45 -172
  39. package/docs/workflow-catalog.md +1 -0
  40. package/package.json +1 -1
  41. package/packages/core/build-configuration.js +117 -0
  42. package/packages/core/buildchain-config.js +2 -0
  43. package/packages/core/buildchain-contract.js +14 -44
  44. package/packages/core/buildchain-publication-authority.js +1 -0
  45. package/packages/core/controller-evidence.js +2 -9
  46. package/scripts/buildchain-cli-help.mjs +1 -1
  47. package/scripts/check-floating-consumer-policy-contract.mjs +4 -7
  48. package/scripts/check-inventory.mjs +91 -77
  49. package/scripts/check-maintainability.mjs +23 -8
  50. package/scripts/check-universal-workflow-bootstrap.mjs +12 -2
  51. package/scripts/generate-channel-build-workflow.mjs +50 -410
  52. package/scripts/generate-site-bundle.mjs +2 -1
  53. package/scripts/generate-universal-workflow-facades.mjs +1 -0
  54. package/scripts/init-repo.mjs +25 -26
  55. package/scripts/resolve-build-configuration.mjs +105 -0
  56. package/scripts/universal-workflow-self-dogfood.mjs +8 -1
  57. package/scripts/verify-golden-path.mjs +3 -3
@@ -9,7 +9,7 @@
9
9
  "title": "Buildchain documentation map",
10
10
  "path": "docs/MAP.md",
11
11
  "plane": "use",
12
- "digest": "sha256:93128b060fe11f0c14451966aa2ac467c47248946c577a16daed124344824282",
12
+ "digest": "sha256:1de05d2ed89f816e23c8cab285c2bdc9a427d07ea1446e2bb56565a21b6ff113",
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:72adec660d001a3fb77cd990f2bacdb6f46c8eb4927533d408c3755dab02a94e",
26
+ "digest": "sha256:8cadc5f2bb4ec8d8aea3bd7e05936da197ce3dfbae39c432a0fe9edf6d2b36fa",
27
27
  "capabilityGroup": "getting-started",
28
28
  "audience": [
29
29
  "consumer",
@@ -347,7 +347,7 @@
347
347
  "title": "Generated CLI reference",
348
348
  "path": "docs/cli-reference.md",
349
349
  "plane": "use",
350
- "digest": "sha256:1be0e552967733d9d6e5bf460c84b866fdfb60966ac16177b43370c1367de321",
350
+ "digest": "sha256:f8c1d64d8087819b6496b21878ad1457ecba52c0b5e74793c35ddb9bd838497c",
351
351
  "capabilityGroup": "api-cli-reference",
352
352
  "audience": [
353
353
  "agent",
@@ -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:7ead263fccd68f471a4e3fee4b9ffe39b2ef0cbbea3c961605f8a13f66f09328",
365
+ "digest": "sha256:0b971a24b4fb850cf941d05f0ee8b3493f0dfe3ddbea5479bf2e344ea8a1553e",
366
366
  "capabilityGroup": "api-cli-reference",
367
367
  "audience": [
368
368
  "agent",
@@ -433,7 +433,7 @@
433
433
  "title": "Reusable build surface",
434
434
  "path": "docs/reusable-build-surface.md",
435
435
  "plane": "use",
436
- "digest": "sha256:71a327274f18445d3e26392d24a707b887650603c574354009243164dbc59cdc",
436
+ "digest": "sha256:bc609cad079a44afb8c2cf2b4459d44612bfd5ff09ed3064f85a2a3f02a5ec1e",
437
437
  "capabilityGroup": "reusable-build",
438
438
  "audience": [
439
439
  "consumer",
@@ -505,7 +505,7 @@
505
505
  "title": "Release governance",
506
506
  "path": "docs/release-governance.md",
507
507
  "plane": "why",
508
- "digest": "sha256:dab1c9cdc92b96fc79a45d33916973a6006c0be834d2a3adbf70f63f23bf00b5",
508
+ "digest": "sha256:4dca8751549a33393a0eb6f7237e1e70e9c586929b1e2792f7b32e9beadef75f",
509
509
  "capabilityGroup": "governance-versioning",
510
510
  "audience": [
511
511
  "maintainer",
@@ -548,7 +548,7 @@
548
548
  "title": "Runtime train validation",
549
549
  "path": "docs/runtime-train-validation.md",
550
550
  "plane": "verify",
551
- "digest": "sha256:7df1e85785a1bd8d87c22359d63bcd1caf3fc6c4924d04b6802584b189f75a08",
551
+ "digest": "sha256:6f362a7ad276acfe34b2faa74b3e1212c5cdc451f137b65002975e642540fa5b",
552
552
  "capabilityGroup": "governance-versioning",
553
553
  "audience": [
554
554
  "maintainer",
@@ -3476,7 +3476,7 @@
3476
3476
  ],
3477
3477
  "source": {
3478
3478
  "path": "packages/core/buildchain-config.js",
3479
- "line": 1611
3479
+ "line": 1613
3480
3480
  },
3481
3481
  "example": "import { discoverConfiguredDerivedVersionMaterial } from \"@kungfu-tech/buildchain\";",
3482
3482
  "maturity": "stable",
@@ -3509,7 +3509,7 @@
3509
3509
  ],
3510
3510
  "source": {
3511
3511
  "path": "packages/core/buildchain-config.js",
3512
- "line": 1572
3512
+ "line": 1574
3513
3513
  },
3514
3514
  "example": "import { discoverConfiguredVersionStateFiles } from \"@kungfu-tech/buildchain\";",
3515
3515
  "maturity": "stable",
@@ -3542,7 +3542,7 @@
3542
3542
  ],
3543
3543
  "source": {
3544
3544
  "path": "packages/core/buildchain-config.js",
3545
- "line": 1516
3545
+ "line": 1518
3546
3546
  },
3547
3547
  "example": "import { getLifecycleStage } from \"@kungfu-tech/buildchain\";",
3548
3548
  "maturity": "stable",
@@ -3571,7 +3571,7 @@
3571
3571
  ],
3572
3572
  "source": {
3573
3573
  "path": "packages/core/buildchain-config.js",
3574
- "line": 595
3574
+ "line": 597
3575
3575
  },
3576
3576
  "example": "import { getNativeDiagnosticsProfile } from \"@kungfu-tech/buildchain\";",
3577
3577
  "maturity": "stable",
@@ -3600,7 +3600,7 @@
3600
3600
  ],
3601
3601
  "source": {
3602
3602
  "path": "packages/core/buildchain-config.js",
3603
- "line": 1520
3603
+ "line": 1522
3604
3604
  },
3605
3605
  "example": "import { getPublishContract } from \"@kungfu-tech/buildchain\";",
3606
3606
  "maturity": "stable",
@@ -3629,7 +3629,7 @@
3629
3629
  ],
3630
3630
  "source": {
3631
3631
  "path": "packages/core/buildchain-config.js",
3632
- "line": 363
3632
+ "line": 365
3633
3633
  },
3634
3634
  "example": "import { getStableReleasePolicy } from \"@kungfu-tech/buildchain\";",
3635
3635
  "maturity": "stable",
@@ -3658,7 +3658,7 @@
3658
3658
  ],
3659
3659
  "source": {
3660
3660
  "path": "packages/core/buildchain-config.js",
3661
- "line": 1644
3661
+ "line": 1646
3662
3662
  },
3663
3663
  "example": "import { getVersionStrategy } from \"@kungfu-tech/buildchain\";",
3664
3664
  "maturity": "stable",
@@ -3687,7 +3687,7 @@
3687
3687
  ],
3688
3688
  "source": {
3689
3689
  "path": "packages/core/buildchain-config.js",
3690
- "line": 183
3690
+ "line": 184
3691
3691
  },
3692
3692
  "example": "import { loadBuildchainConfig } from \"@kungfu-tech/buildchain\";",
3693
3693
  "maturity": "stable",
@@ -3720,7 +3720,7 @@
3720
3720
  ],
3721
3721
  "source": {
3722
3722
  "path": "packages/core/buildchain-config.js",
3723
- "line": 1653
3723
+ "line": 1655
3724
3724
  },
3725
3725
  "example": "import { loadConfiguredAnchorManifest } from \"@kungfu-tech/buildchain\";",
3726
3726
  "maturity": "stable",
@@ -3749,7 +3749,7 @@
3749
3749
  ],
3750
3750
  "source": {
3751
3751
  "path": "packages/core/buildchain-config.js",
3752
- "line": 206
3752
+ "line": 207
3753
3753
  },
3754
3754
  "example": "import { normalizeBuildchainConfig } from \"@kungfu-tech/buildchain\";",
3755
3755
  "maturity": "stable",
@@ -3786,7 +3786,7 @@
3786
3786
  ],
3787
3787
  "source": {
3788
3788
  "path": "packages/core/buildchain-config.js",
3789
- "line": 1477
3789
+ "line": 1479
3790
3790
  },
3791
3791
  "example": "import { normalizeLifecycleStage } from \"@kungfu-tech/buildchain\";",
3792
3792
  "maturity": "stable",
@@ -3815,7 +3815,7 @@
3815
3815
  ],
3816
3816
  "source": {
3817
3817
  "path": "packages/core/buildchain-config.js",
3818
- "line": 1524
3818
+ "line": 1526
3819
3819
  },
3820
3820
  "example": "import { runLifecycleStage } from \"@kungfu-tech/buildchain\";",
3821
3821
  "maturity": "stable",
@@ -3848,7 +3848,7 @@
3848
3848
  ],
3849
3849
  "source": {
3850
3850
  "path": "packages/core/buildchain-config.js",
3851
- "line": 1824
3851
+ "line": 1826
3852
3852
  },
3853
3853
  "example": "import { updateConfiguredVersionStateContents } from \"@kungfu-tech/buildchain\";",
3854
3854
  "maturity": "stable",
@@ -3881,7 +3881,7 @@
3881
3881
  ],
3882
3882
  "source": {
3883
3883
  "path": "packages/core/buildchain-config.js",
3884
- "line": 1691
3884
+ "line": 1693
3885
3885
  },
3886
3886
  "example": "import { validateBuildchainConfig } from \"@kungfu-tech/buildchain\";",
3887
3887
  "maturity": "stable",
@@ -3990,7 +3990,7 @@
3990
3990
  ],
3991
3991
  "source": {
3992
3992
  "path": "packages/core/buildchain-contract.js",
3993
- "line": 1011
3993
+ "line": 981
3994
3994
  },
3995
3995
  "example": "import { contractSummary } from \"@kungfu-tech/buildchain\";",
3996
3996
  "maturity": "stable",
@@ -4019,7 +4019,7 @@
4019
4019
  ],
4020
4020
  "source": {
4021
4021
  "path": "packages/core/buildchain-contract.js",
4022
- "line": 940
4022
+ "line": 910
4023
4023
  },
4024
4024
  "example": "import { createBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
4025
4025
  "maturity": "stable",
@@ -4101,7 +4101,7 @@
4101
4101
  ],
4102
4102
  "source": {
4103
4103
  "path": "packages/core/buildchain-contract.js",
4104
- "line": 1007
4104
+ "line": 977
4105
4105
  },
4106
4106
  "example": "import { evaluateBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
4107
4107
  "maturity": "stable",
@@ -4130,7 +4130,7 @@
4130
4130
  ],
4131
4131
  "source": {
4132
4132
  "path": "packages/core/buildchain-contract.js",
4133
- "line": 881
4133
+ "line": 851
4134
4134
  },
4135
4135
  "example": "import { finalizeBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
4136
4136
  "maturity": "stable",
@@ -4207,7 +4207,7 @@
4207
4207
  ],
4208
4208
  "source": {
4209
4209
  "path": "packages/core/buildchain-contract.js",
4210
- "line": 996
4210
+ "line": 966
4211
4211
  },
4212
4212
  "example": "import { readBuildchainContractLock } from \"@kungfu-tech/buildchain\";",
4213
4213
  "maturity": "stable",
@@ -4236,7 +4236,7 @@
4236
4236
  ],
4237
4237
  "source": {
4238
4238
  "path": "packages/core/buildchain-contract.js",
4239
- "line": 976
4239
+ "line": 946
4240
4240
  },
4241
4241
  "example": "import { readBuildchainContractWorld } from \"@kungfu-tech/buildchain\";",
4242
4242
  "maturity": "stable",
@@ -4265,7 +4265,7 @@
4265
4265
  ],
4266
4266
  "source": {
4267
4267
  "path": "packages/core/buildchain-contract.js",
4268
- "line": 1026
4268
+ "line": 996
4269
4269
  },
4270
4270
  "example": "import { renderBuildchainContractDriftIssueBody } from \"@kungfu-tech/buildchain\";",
4271
4271
  "maturity": "stable",
@@ -5957,7 +5957,7 @@
5957
5957
  ],
5958
5958
  "source": {
5959
5959
  "path": "packages/core/buildchain-publication-authority.js",
5960
- "line": 66
5960
+ "line": 67
5961
5961
  },
5962
5962
  "example": "import { buildchainPublicationAuthorityDescriptors } from \"@kungfu-tech/buildchain\";",
5963
5963
  "maturity": "stable",
@@ -5986,7 +5986,7 @@
5986
5986
  ],
5987
5987
  "source": {
5988
5988
  "path": "packages/core/buildchain-publication-authority.js",
5989
- "line": 105
5989
+ "line": 106
5990
5990
  },
5991
5991
  "example": "import { createBuildchainPublicationAuthorityRegistry } from \"@kungfu-tech/buildchain\";",
5992
5992
  "maturity": "stable",
@@ -6482,7 +6482,7 @@
6482
6482
  ],
6483
6483
  "source": {
6484
6484
  "path": "packages/core/controller-evidence.js",
6485
- "line": 452
6485
+ "line": 445
6486
6486
  },
6487
6487
  "example": "import { aggregateControllerReceipts } from \"@kungfu-tech/buildchain\";",
6488
6488
  "maturity": "stable",
@@ -6607,7 +6607,7 @@
6607
6607
  ],
6608
6608
  "source": {
6609
6609
  "path": "packages/core/controller-evidence.js",
6610
- "line": 151
6610
+ "line": 143
6611
6611
  },
6612
6612
  "example": "import { controllerEvidenceDigest } from \"@kungfu-tech/buildchain\";",
6613
6613
  "maturity": "stable",
@@ -6636,7 +6636,7 @@
6636
6636
  ],
6637
6637
  "source": {
6638
6638
  "path": "packages/core/controller-evidence.js",
6639
- "line": 290
6639
+ "line": 283
6640
6640
  },
6641
6641
  "example": "import { createControllerPlan } from \"@kungfu-tech/buildchain\";",
6642
6642
  "maturity": "stable",
@@ -6665,7 +6665,7 @@
6665
6665
  ],
6666
6666
  "source": {
6667
6667
  "path": "packages/core/controller-evidence.js",
6668
- "line": 366
6668
+ "line": 359
6669
6669
  },
6670
6670
  "example": "import { createControllerReceipt } from \"@kungfu-tech/buildchain\";",
6671
6671
  "maturity": "stable",
@@ -6694,7 +6694,7 @@
6694
6694
  ],
6695
6695
  "source": {
6696
6696
  "path": "packages/core/controller-evidence.js",
6697
- "line": 494
6697
+ "line": 487
6698
6698
  },
6699
6699
  "example": "import { createControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
6700
6700
  "maturity": "stable",
@@ -6723,7 +6723,7 @@
6723
6723
  ],
6724
6724
  "source": {
6725
6725
  "path": "packages/core/controller-evidence.js",
6726
- "line": 197
6726
+ "line": 189
6727
6727
  },
6728
6728
  "example": "import { createControllerRegistry } from \"@kungfu-tech/buildchain\";",
6729
6729
  "maturity": "stable",
@@ -6752,7 +6752,7 @@
6752
6752
  ],
6753
6753
  "source": {
6754
6754
  "path": "packages/core/controller-evidence.js",
6755
- "line": 535
6755
+ "line": 528
6756
6756
  },
6757
6757
  "example": "import { normalizeControllerReceiptReferences } from \"@kungfu-tech/buildchain\";",
6758
6758
  "maturity": "stable",
@@ -6781,7 +6781,7 @@
6781
6781
  ],
6782
6782
  "source": {
6783
6783
  "path": "packages/core/controller-evidence.js",
6784
- "line": 328
6784
+ "line": 321
6785
6785
  },
6786
6786
  "example": "import { validateControllerPlan } from \"@kungfu-tech/buildchain\";",
6787
6787
  "maturity": "stable",
@@ -6814,7 +6814,7 @@
6814
6814
  ],
6815
6815
  "source": {
6816
6816
  "path": "packages/core/controller-evidence.js",
6817
- "line": 426
6817
+ "line": 419
6818
6818
  },
6819
6819
  "example": "import { validateControllerReceipt } from \"@kungfu-tech/buildchain\";",
6820
6820
  "maturity": "stable",
@@ -6847,7 +6847,7 @@
6847
6847
  ],
6848
6848
  "source": {
6849
6849
  "path": "packages/core/controller-evidence.js",
6850
- "line": 508
6850
+ "line": 501
6851
6851
  },
6852
6852
  "example": "import { validateControllerReceiptReference } from \"@kungfu-tech/buildchain\";",
6853
6853
  "maturity": "stable",
@@ -30867,7 +30867,7 @@
30867
30867
  "specifier": "@kungfu-tech/buildchain/buildchain-contract",
30868
30868
  "export": "./buildchain-contract",
30869
30869
  "target": "./packages/core/buildchain-contract.js",
30870
- "digest": "sha256:a82c26a085cd84e43c8c9d00c1699ceee15423829874e1699fd7d3fb31485f33",
30870
+ "digest": "sha256:e3d7d3d1716adc734c3f54e6ca57652afe826fc43812b4802d9c642bcbd6cd37",
30871
30871
  "summary": "Runtime contract world and compatibility digest APIs for floating-ref drift checks.",
30872
30872
  "capabilityGroup": "governance-versioning",
30873
30873
  "audience": [
@@ -31081,7 +31081,7 @@
31081
31081
  "specifier": "@kungfu-tech/buildchain/controller-evidence",
31082
31082
  "export": "./controller-evidence",
31083
31083
  "target": "./packages/core/controller-evidence.js",
31084
- "digest": "sha256:54af316639618918889d26407726e7eed97511ac37c015c89cad42456f2076f8",
31084
+ "digest": "sha256:04a9360f2423efb79ccf3f57f1f8f444f7eaa532087c4cb2f217af9163b385e0",
31085
31085
  "summary": "Project-independent controller descriptors, source/runtime-bound plans, receipts, aggregates, and validation APIs.",
31086
31086
  "capabilityGroup": "reusable-build",
31087
31087
  "audience": [
@@ -32626,7 +32626,7 @@
32626
32626
  "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
32627
32627
  "export": "./buildchain-publication-authority",
32628
32628
  "target": "./packages/core/buildchain-publication-authority.js",
32629
- "digest": "sha256:8ac4b5f2c11fc1562034bf188bb6a2349935483ea831d13b273bcc7b9fbb695c",
32629
+ "digest": "sha256:4ea1b4e49017ba3f1b706e3720884a8ed9d2f644e5f2747b7383f25f8eb26921",
32630
32630
  "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
32631
32631
  "capabilityGroup": "release-passport-trust",
32632
32632
  "audience": [
@@ -33637,7 +33637,7 @@
33637
33637
  {
33638
33638
  "id": "node-api-reference",
33639
33639
  "path": "docs/node-api-reference.md",
33640
- "digest": "sha256:7ead263fccd68f471a4e3fee4b9ffe39b2ef0cbbea3c961605f8a13f66f09328"
33640
+ "digest": "sha256:0b971a24b4fb850cf941d05f0ee8b3493f0dfe3ddbea5479bf2e344ea8a1553e"
33641
33641
  },
33642
33642
  {
33643
33643
  "id": "build-facts",