@kungfu-tech/buildchain 3.0.7 → 3.0.8

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 (45) hide show
  1. package/contracts/engineering-housekeeper-v1.schema.json +11 -1
  2. package/contracts/fixtures/engineering-housekeeper-v1/cases.json +10 -0
  3. package/contracts/release-cut-v1.schema.json +70 -0
  4. package/contracts/release-train-transition-v1.schema.json +85 -0
  5. package/contracts/release-train-v1.schema.json +82 -0
  6. package/dist/site/buildchain-contract.json +302 -16
  7. package/dist/site/buildchain-site.json +83 -27
  8. package/dist/site/capability-registry.json +4 -3
  9. package/dist/site/kfd-claims.json +45 -8
  10. package/dist/site/kfd-upstream-aggregate.json +1 -1
  11. package/dist/site/manual-registry.json +22 -6
  12. package/dist/site/node-api-registry.json +1218 -489
  13. package/dist/site/page-registry.json +65 -17
  14. package/dist/site/public-surface-audit.json +13 -8
  15. package/dist/site/publication-authority-registry.json +2 -4
  16. package/dist/site/publication-registry.json +4 -4
  17. package/dist/site/release-provenance.json +1 -0
  18. package/dist/site/site-manifest.json +18 -10
  19. package/dist/site/workflow-registry.json +10 -9
  20. package/docs/MAP.md +1 -1
  21. package/docs/aws-us-elastic-runner-burst-plane.md +20 -7
  22. package/docs/engineering-housekeeper.md +61 -28
  23. package/docs/node-api-reference.md +109 -77
  24. package/docs/release-governance.md +13 -10
  25. package/docs/release-train.md +102 -0
  26. package/docs/reusable-build-surface.md +16 -6
  27. package/docs/site-bundle-contract.md +5 -1
  28. package/docs/versioning.md +1 -0
  29. package/package.json +2 -1
  30. package/packages/core/buildchain-agent-manuals.js +1 -0
  31. package/packages/core/buildchain-compatibility-proof.js +577 -0
  32. package/packages/core/buildchain-contract.js +46 -181
  33. package/packages/core/engineering-housekeeper-github-client.js +18 -1
  34. package/packages/core/engineering-housekeeper-github.js +247 -41
  35. package/packages/core/engineering-housekeeper.js +15 -0
  36. package/packages/core/release-train.js +520 -0
  37. package/scripts/aws-macos-jit-controller-core.mjs +33 -11
  38. package/scripts/aws-macos-jit-controller-runtime.mjs +208 -0
  39. package/scripts/aws-macos-jit-controller.mjs +50 -37
  40. package/scripts/aws-macos-jit-core.mjs +41 -3
  41. package/scripts/buildchain-contract-lock.mjs +6 -0
  42. package/scripts/dispatch-artifact-signing-authority.mjs +4 -7
  43. package/scripts/engineering-housekeeper-workflow.mjs +13 -6
  44. package/scripts/generate-site-bundle.mjs +2 -0
  45. package/scripts/site-capability-metadata.mjs +1 -0
@@ -253,15 +253,16 @@
253
253
  ],
254
254
  "maturity": "stable",
255
255
  "counts": {
256
- "manualCount": 8,
257
- "pageCount": 8,
256
+ "manualCount": 9,
257
+ "pageCount": 9,
258
258
  "cliCommandCount": 12,
259
- "nodeApiCount": 8,
259
+ "nodeApiCount": 9,
260
260
  "workflowCount": 20,
261
261
  "actionCount": 0
262
262
  },
263
263
  "manuals": [
264
264
  "docs/github-governance-authority.md",
265
+ "docs/release-train.md",
265
266
  "docs/infra-contract.md",
266
267
  "docs/migration-inventory.md",
267
268
  "docs/ownership.md",
@@ -14,19 +14,19 @@
14
14
  },
15
15
  "runtimeContract": {
16
16
  "contract": "kungfu-buildchain-runtime-contract-world",
17
- "compatibilityDigest": "sha256:80cfdf1786019217c439810f1a80d2866bf8f7ef35a6fa569e1a687fb2bf4cbe",
17
+ "compatibilityDigest": "sha256:c74d76789e49291503292e0a5c38fffc5e3ef420ad85eeb8a2480d287fccfed7",
18
18
  "majorLine": "v3"
19
19
  },
20
20
  "publicSurfaceReverseAudit": {
21
21
  "contract": "kungfu-buildchain-public-surface-reverse-audit",
22
22
  "path": "dist/site/public-surface-audit.json",
23
23
  "status": "passed",
24
- "sha256": "1d9b603c5adcd90d7e8431621f44baa36ce78e9b0cd27776697aa87b791e712b",
24
+ "sha256": "92f9a4d8520236573c7cfaf91f3697e63d679e92ac7fbf4eb33fcbec336a3939",
25
25
  "summary": {
26
26
  "cliCommandCount": 114,
27
27
  "workflowCount": 69,
28
28
  "actionCount": 7,
29
- "sitePageCount": 70,
29
+ "sitePageCount": 71,
30
30
  "docCommandRefCount": 924,
31
31
  "failureCount": 0
32
32
  },
@@ -246,12 +246,12 @@
246
246
  "contract": "kungfu-buildchain-public-surface-reverse-audit",
247
247
  "path": "dist/site/public-surface-audit.json",
248
248
  "status": "passed",
249
- "sha256": "1d9b603c5adcd90d7e8431621f44baa36ce78e9b0cd27776697aa87b791e712b",
249
+ "sha256": "92f9a4d8520236573c7cfaf91f3697e63d679e92ac7fbf4eb33fcbec336a3939",
250
250
  "summary": {
251
251
  "cliCommandCount": 114,
252
252
  "workflowCount": 69,
253
253
  "actionCount": 7,
254
- "sitePageCount": 70,
254
+ "sitePageCount": 71,
255
255
  "docCommandRefCount": 924,
256
256
  "failureCount": 0
257
257
  },
@@ -764,6 +764,18 @@
764
764
  "public": true,
765
765
  "plane": "use"
766
766
  },
767
+ {
768
+ "id": "doc:docs/release-train.md",
769
+ "name": "Release Train and Release Cut",
770
+ "kind": "documentation",
771
+ "sourcePath": "docs/release-train.md",
772
+ "evidencePath": "docs/release-train.md",
773
+ "availability": "shipped",
774
+ "visibility": "public",
775
+ "participantFacing": true,
776
+ "public": true,
777
+ "plane": "verify"
778
+ },
767
779
  {
768
780
  "id": "doc:docs/reusable-build-surface.md",
769
781
  "name": "Reusable build surface",
@@ -1712,6 +1724,18 @@
1712
1724
  "public": true,
1713
1725
  "packageExport": "./release-candidate-recovery"
1714
1726
  },
1727
+ {
1728
+ "id": "export:./release-train",
1729
+ "name": "@kungfu-tech/buildchain/release-train",
1730
+ "kind": "package-export",
1731
+ "sourcePath": "packages/core/release-train.js",
1732
+ "evidencePath": "packages/core/release-train.js",
1733
+ "availability": "shipped",
1734
+ "visibility": "public",
1735
+ "participantFacing": true,
1736
+ "public": true,
1737
+ "packageExport": "./release-train"
1738
+ },
1715
1739
  {
1716
1740
  "id": "export:./stable-candidate-ledger",
1717
1741
  "name": "@kungfu-tech/buildchain/stable-candidate-ledger",
@@ -4787,7 +4811,7 @@
4787
4811
  "visibility": "public",
4788
4812
  "participantFacing": true,
4789
4813
  "public": true,
4790
- "inputCount": 13,
4814
+ "inputCount": 14,
4791
4815
  "inputs": [
4792
4816
  "apply-enabled",
4793
4817
  "artifact-prefix",
@@ -4801,7 +4825,8 @@
4801
4825
  "retained-patterns",
4802
4826
  "stale-days",
4803
4827
  "stale-pull-request-label",
4804
- "target-branch"
4828
+ "target-branch",
4829
+ "temporary-branch-patterns"
4805
4830
  ],
4806
4831
  "reverseAuditSource": ".github/workflows"
4807
4832
  },
@@ -6415,6 +6440,18 @@
6415
6440
  "public": true,
6416
6441
  "reverseAuditSource": "dist/site/page-registry.json"
6417
6442
  },
6443
+ {
6444
+ "id": "site-page:manual:release-train",
6445
+ "name": "site-page:manual:release-train",
6446
+ "kind": "site-page",
6447
+ "sourcePath": "dist/site/page-registry.json",
6448
+ "evidencePath": "dist/site/page-registry.json",
6449
+ "availability": "shipped",
6450
+ "visibility": "public",
6451
+ "participantFacing": true,
6452
+ "public": true,
6453
+ "reverseAuditSource": "dist/site/page-registry.json"
6454
+ },
6418
6455
  {
6419
6456
  "id": "site-page:manual:reusable-build-surface",
6420
6457
  "name": "site-page:manual:reusable-build-surface",
@@ -6694,6 +6731,6 @@
6694
6731
  }
6695
6732
  }
6696
6733
  ],
6697
- "publicSurfaceCount": 425
6734
+ "publicSurfaceCount": 428
6698
6735
  }
6699
6736
  }
@@ -4,7 +4,7 @@
4
4
  "product": {
5
5
  "id": "kungfu-tech-buildchain",
6
6
  "name": "@kungfu-tech/buildchain",
7
- "version": "3.0.7",
7
+ "version": "3.0.8",
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:08cfae94c78776694736e81142e2d64480fdc3e67341b415340c03d3539531e7",
12
+ "digest": "sha256:5292461118df2ec99a15411b6ed50c288abeb05d992677e3500b9bd46255a001",
13
13
  "capabilityGroup": "getting-started",
14
14
  "audience": [
15
15
  "agent",
@@ -145,6 +145,21 @@
145
145
  "maturity": "stable",
146
146
  "order": 130
147
147
  },
148
+ {
149
+ "id": "release-train",
150
+ "title": "Release Train and Release Cut",
151
+ "path": "docs/release-train.md",
152
+ "plane": "verify",
153
+ "digest": "sha256:550e50726ff479730bee1abe7839776308396bb01613e31a3ed6e898297619fa",
154
+ "capabilityGroup": "governance-versioning",
155
+ "audience": [
156
+ "release-operator",
157
+ "consumer",
158
+ "agent"
159
+ ],
160
+ "maturity": "preview",
161
+ "order": 132
162
+ },
148
163
  {
149
164
  "id": "release-propagation",
150
165
  "title": "Release propagation",
@@ -248,7 +263,7 @@
248
263
  "title": "Site bundle contract",
249
264
  "path": "docs/site-bundle-contract.md",
250
265
  "plane": "use",
251
- "digest": "sha256:36a4e60e91f500ea1dcdbef97cd0250a2c26562b98d8d3622e8e0f9df2aad23b",
266
+ "digest": "sha256:371030eda56d7a968d037e8b9a348e0211038506b8c0b14c539ec790ce884945",
252
267
  "capabilityGroup": "site-and-propagation",
253
268
  "audience": [
254
269
  "site",
@@ -332,7 +347,7 @@
332
347
  "title": "Generated Node API reference",
333
348
  "path": "docs/node-api-reference.md",
334
349
  "plane": "use",
335
- "digest": "sha256:ed843753964193ecb59610a54f0f23d76578228ebe6d31d1d6edce526729910c",
350
+ "digest": "sha256:34f39632494c0f4d4961fd79fc8ac94466da56c29f04f09e706f402d98ef125c",
336
351
  "capabilityGroup": "api-cli-reference",
337
352
  "audience": [
338
353
  "agent",
@@ -403,7 +418,7 @@
403
418
  "title": "Reusable build surface",
404
419
  "path": "docs/reusable-build-surface.md",
405
420
  "plane": "use",
406
- "digest": "sha256:4741dc7661d40e14df8203d88a709b9becb08edc4313f5ad308c7e80bf672085",
421
+ "digest": "sha256:7f69bf3faf8c86b4af268f8e79d511f73de745e146a23809394074f816a372d7",
407
422
  "capabilityGroup": "reusable-build",
408
423
  "audience": [
409
424
  "consumer",
@@ -475,7 +490,7 @@
475
490
  "title": "Release governance",
476
491
  "path": "docs/release-governance.md",
477
492
  "plane": "why",
478
- "digest": "sha256:b37d4de1f1cf9155c0e3f42c8c20a0280a263f50173eb0cad2c5f1961954822e",
493
+ "digest": "sha256:150a6ceb40636838ed157abe11ae1dfe43f6447f01462a0238d343b9cf89fcb4",
479
494
  "capabilityGroup": "governance-versioning",
480
495
  "audience": [
481
496
  "maintainer",
@@ -517,7 +532,7 @@
517
532
  "title": "Versioning",
518
533
  "path": "docs/versioning.md",
519
534
  "plane": "why",
520
- "digest": "sha256:793db9414d11aeb314ff2d37a52481826ca5f636d08eaf93772d37962a51484f",
535
+ "digest": "sha256:6af44926f8138932aeb606bb264b19a40a273ce7bea7bad9b021bb9aa542d61b",
521
536
  "capabilityGroup": "governance-versioning",
522
537
  "audience": [
523
538
  "maintainer"
@@ -548,6 +563,7 @@
548
563
  "docs/kfd-support.md",
549
564
  "docs/reusable-build-surface.md",
550
565
  "docs/release-candidate.md",
566
+ "docs/release-train.md",
551
567
  "docs/stable-candidate-patrol.md",
552
568
  "docs/dev-qualification-patrol.md",
553
569
  "docs/dev-alpha-candidate-patrol.md",