@kungfu-tech/buildchain 3.0.7-alpha.0 → 3.0.7

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 (67) hide show
  1. package/actions/promote-buildchain-ref/README.md +10 -0
  2. package/contracts/auditable-demo-scenario-v1.schema.json +1 -1
  3. package/contracts/engineering-housekeeper-v1.schema.json +143 -0
  4. package/contracts/fixtures/engineering-housekeeper-v1/cases.json +68 -0
  5. package/dist/site/buildchain-contract.json +24 -24
  6. package/dist/site/buildchain-site.json +91 -30
  7. package/dist/site/capability-registry.json +3 -3
  8. package/dist/site/controller-registry.json +6 -2
  9. package/dist/site/kfd-claims.json +122 -11
  10. package/dist/site/kfd-upstream-aggregate.json +1 -1
  11. package/dist/site/manual-registry.json +8 -7
  12. package/dist/site/node-api-registry.json +683 -105
  13. package/dist/site/page-registry.json +80 -19
  14. package/dist/site/public-surface-audit.json +98 -7
  15. package/dist/site/publication-authority-registry.json +81 -1
  16. package/dist/site/publication-registry.json +4 -4
  17. package/dist/site/release-provenance.json +2 -0
  18. package/dist/site/site-manifest.json +11 -11
  19. package/dist/site/workflow-registry.json +119 -2
  20. package/docs/MAP.md +1 -0
  21. package/docs/auditable-demo.md +2 -2
  22. package/docs/dev-delivery-warrant.md +49 -4
  23. package/docs/engineering-housekeeper.md +138 -0
  24. package/docs/lifecycle-protocol.md +4 -2
  25. package/docs/node-api-reference.md +277 -212
  26. package/docs/release-governance.md +17 -2
  27. package/docs/release-tail-provider-plane.md +1 -1
  28. package/docs/reusable-build-surface.md +11 -0
  29. package/package.json +4 -1
  30. package/packages/core/artifact-signing.js +61 -0
  31. package/packages/core/buildchain-config.js +66 -6
  32. package/packages/core/buildchain-publication-authority.js +4 -0
  33. package/packages/core/controller-evidence.js +2 -1
  34. package/packages/core/dev-delivery-warrant-cancellation.js +1 -0
  35. package/packages/core/dev-delivery-warrant-shadow.js +502 -0
  36. package/packages/core/dev-delivery-warrant.js +15 -6
  37. package/packages/core/diagnostics.js +8 -3
  38. package/packages/core/engineering-housekeeper-github-client.js +222 -0
  39. package/packages/core/engineering-housekeeper-github.js +501 -0
  40. package/packages/core/engineering-housekeeper.js +259 -0
  41. package/packages/core/index.js +3 -0
  42. package/packages/core/kfd-gate.js +45 -15
  43. package/packages/core/publication-rehearsal-runtime.js +13 -1
  44. package/packages/core/release-passport.js +130 -20
  45. package/scripts/assemble-self-publication-admission.mjs +1 -1
  46. package/scripts/audit-publication-control-plane.mjs +1 -1
  47. package/scripts/auditable-demo-bundle-verification.mjs +2 -3
  48. package/scripts/auditable-demo-platform.mjs +2 -2
  49. package/scripts/auditable-demo-renditions.mjs +1 -1
  50. package/scripts/auditable-demo.mjs +2 -2
  51. package/scripts/build-contract-core.mjs +8 -3
  52. package/scripts/build-standalone-binary.mjs +14 -3
  53. package/scripts/check-inventory.mjs +3 -1
  54. package/scripts/dev-delivery-warrant.mjs +31 -4
  55. package/scripts/dev-pr-auto-merge.mjs +30 -4
  56. package/scripts/dev-pr-delivery-warrant.mjs +50 -0
  57. package/scripts/engineering-housekeeper-workflow.mjs +394 -0
  58. package/scripts/generate-site-bundle.mjs +23 -4
  59. package/scripts/inspect-artifact-signing-requests.mjs +6 -0
  60. package/scripts/materialize-self-release-candidate-version.mjs +6 -0
  61. package/scripts/publication-commit-evidence.mjs +69 -23
  62. package/scripts/release-candidate-resolver.mjs +16 -10
  63. package/scripts/resume-from-candidate-run.mjs +123 -9
  64. package/scripts/seal-artifact-signing-requests.mjs +6 -0
  65. package/scripts/site-capability-metadata.mjs +2 -0
  66. package/scripts/web-surface-core.mjs +8 -2
  67. package/scripts/workflow-call-contract.mjs +1 -1
@@ -15,7 +15,7 @@
15
15
  "maturity": "stable",
16
16
  "counts": {
17
17
  "manualCount": 4,
18
- "pageCount": 15,
18
+ "pageCount": 16,
19
19
  "cliCommandCount": 9,
20
20
  "nodeApiCount": 0,
21
21
  "workflowCount": 0,
@@ -256,8 +256,8 @@
256
256
  "manualCount": 8,
257
257
  "pageCount": 8,
258
258
  "cliCommandCount": 12,
259
- "nodeApiCount": 6,
260
- "workflowCount": 16,
259
+ "nodeApiCount": 8,
260
+ "workflowCount": 20,
261
261
  "actionCount": 0
262
262
  },
263
263
  "manuals": [
@@ -481,6 +481,10 @@
481
481
  "id": "anchored-release-preflight",
482
482
  "required": false
483
483
  },
484
+ {
485
+ "id": "pre-build-contracts",
486
+ "required": false
487
+ },
484
488
  {
485
489
  "id": "build",
486
490
  "required": true
@@ -516,7 +520,7 @@
516
520
  "controller-receipt"
517
521
  ]
518
522
  },
519
- "digest": "sha256:9c0aacca910cef4619a797898ff5c24027c1583f84431a93a5efc854925326e7"
523
+ "digest": "sha256:f986e79241d831f027a0955a35c918f946989176c76555e20f156ed31fb10c94"
520
524
  },
521
525
  {
522
526
  "schemaVersion": 1,
@@ -2398,5 +2402,5 @@
2398
2402
  "digest": "sha256:b6f53563c0adc859bc586c05fce560a5094d7d9666438d63c5fd3e1fc4774555"
2399
2403
  }
2400
2404
  ],
2401
- "digest": "sha256:4610d5ecdd42984fef782af010ed6978f4a40438134b3d962698854978fd0095"
2405
+ "digest": "sha256:e9f5716c5298730bcab51a9e2f2316df8b4a7cec7ce609a7a8808928a48edd1e"
2402
2406
  }
@@ -21,13 +21,13 @@
21
21
  "contract": "kungfu-buildchain-public-surface-reverse-audit",
22
22
  "path": "dist/site/public-surface-audit.json",
23
23
  "status": "passed",
24
- "sha256": "5f7c953b2c903e24f69de55e50f33e431654c2e693acb30079be63880e6ebee2",
24
+ "sha256": "1d9b603c5adcd90d7e8431621f44baa36ce78e9b0cd27776697aa87b791e712b",
25
25
  "summary": {
26
26
  "cliCommandCount": 114,
27
- "workflowCount": 65,
27
+ "workflowCount": 69,
28
28
  "actionCount": 7,
29
- "sitePageCount": 69,
30
- "docCommandRefCount": 922,
29
+ "sitePageCount": 70,
30
+ "docCommandRefCount": 924,
31
31
  "failureCount": 0
32
32
  },
33
33
  "auditBoundary": {
@@ -246,13 +246,13 @@
246
246
  "contract": "kungfu-buildchain-public-surface-reverse-audit",
247
247
  "path": "dist/site/public-surface-audit.json",
248
248
  "status": "passed",
249
- "sha256": "5f7c953b2c903e24f69de55e50f33e431654c2e693acb30079be63880e6ebee2",
249
+ "sha256": "1d9b603c5adcd90d7e8431621f44baa36ce78e9b0cd27776697aa87b791e712b",
250
250
  "summary": {
251
251
  "cliCommandCount": 114,
252
- "workflowCount": 65,
252
+ "workflowCount": 69,
253
253
  "actionCount": 7,
254
- "sitePageCount": 69,
255
- "docCommandRefCount": 922,
254
+ "sitePageCount": 70,
255
+ "docCommandRefCount": 924,
256
256
  "failureCount": 0
257
257
  },
258
258
  "auditBoundary": {
@@ -1652,6 +1652,30 @@
1652
1652
  "public": true,
1653
1653
  "packageExport": "./github-governance-authority"
1654
1654
  },
1655
+ {
1656
+ "id": "export:./engineering-housekeeper",
1657
+ "name": "@kungfu-tech/buildchain/engineering-housekeeper",
1658
+ "kind": "package-export",
1659
+ "sourcePath": "packages/core/engineering-housekeeper.js",
1660
+ "evidencePath": "packages/core/engineering-housekeeper.js",
1661
+ "availability": "shipped",
1662
+ "visibility": "public",
1663
+ "participantFacing": true,
1664
+ "public": true,
1665
+ "packageExport": "./engineering-housekeeper"
1666
+ },
1667
+ {
1668
+ "id": "export:./engineering-housekeeper-github",
1669
+ "name": "@kungfu-tech/buildchain/engineering-housekeeper-github",
1670
+ "kind": "package-export",
1671
+ "sourcePath": "packages/core/engineering-housekeeper-github.js",
1672
+ "evidencePath": "packages/core/engineering-housekeeper-github.js",
1673
+ "availability": "shipped",
1674
+ "visibility": "public",
1675
+ "participantFacing": true,
1676
+ "public": true,
1677
+ "packageExport": "./engineering-housekeeper-github"
1678
+ },
1655
1679
  {
1656
1680
  "id": "export:./kfd-gate",
1657
1681
  "name": "@kungfu-tech/buildchain/kfd-gate",
@@ -4645,8 +4669,9 @@
4645
4669
  "visibility": "public",
4646
4670
  "participantFacing": true,
4647
4671
  "public": true,
4648
- "inputCount": 32,
4672
+ "inputCount": 36,
4649
4673
  "inputs": [
4674
+ "active-lease-context",
4650
4675
  "affected-paths-json",
4651
4676
  "allowed-head-prefixes",
4652
4677
  "assignment-root",
@@ -4662,6 +4687,7 @@
4662
4687
  "dry-run",
4663
4688
  "expected-head-sha",
4664
4689
  "expected-pr-number",
4690
+ "handoff-workflow-id",
4665
4691
  "initiative-root",
4666
4692
  "landing-mode",
4667
4693
  "max-merges",
@@ -4676,6 +4702,8 @@
4676
4702
  "shard-evidence-roots-json",
4677
4703
  "source-identity-root",
4678
4704
  "source-patch-root",
4705
+ "source-workflow-id",
4706
+ "source-workflow-run-id",
4679
4707
  "target-branch",
4680
4708
  "toolchain-root",
4681
4709
  "warrant-lease-seconds"
@@ -4707,6 +4735,76 @@
4707
4735
  ],
4708
4736
  "reverseAuditSource": ".github/workflows"
4709
4737
  },
4738
+ {
4739
+ "id": "workflow:engineering-housekeeper-daily",
4740
+ "name": "workflow:engineering-housekeeper-daily",
4741
+ "kind": "workflow",
4742
+ "sourcePath": ".github/workflows/engineering-housekeeper-daily.yml",
4743
+ "evidencePath": ".github/workflows/engineering-housekeeper-daily.yml",
4744
+ "availability": "shipped",
4745
+ "visibility": "public",
4746
+ "participantFacing": true,
4747
+ "public": true,
4748
+ "inputCount": 0,
4749
+ "inputs": [],
4750
+ "reverseAuditSource": ".github/workflows"
4751
+ },
4752
+ {
4753
+ "id": "workflow:engineering-housekeeper-monthly",
4754
+ "name": "workflow:engineering-housekeeper-monthly",
4755
+ "kind": "workflow",
4756
+ "sourcePath": ".github/workflows/engineering-housekeeper-monthly.yml",
4757
+ "evidencePath": ".github/workflows/engineering-housekeeper-monthly.yml",
4758
+ "availability": "shipped",
4759
+ "visibility": "public",
4760
+ "participantFacing": true,
4761
+ "public": true,
4762
+ "inputCount": 0,
4763
+ "inputs": [],
4764
+ "reverseAuditSource": ".github/workflows"
4765
+ },
4766
+ {
4767
+ "id": "workflow:engineering-housekeeper-weekly",
4768
+ "name": "workflow:engineering-housekeeper-weekly",
4769
+ "kind": "workflow",
4770
+ "sourcePath": ".github/workflows/engineering-housekeeper-weekly.yml",
4771
+ "evidencePath": ".github/workflows/engineering-housekeeper-weekly.yml",
4772
+ "availability": "shipped",
4773
+ "visibility": "public",
4774
+ "participantFacing": true,
4775
+ "public": true,
4776
+ "inputCount": 0,
4777
+ "inputs": [],
4778
+ "reverseAuditSource": ".github/workflows"
4779
+ },
4780
+ {
4781
+ "id": "workflow:engineering-housekeeper",
4782
+ "name": "workflow:engineering-housekeeper",
4783
+ "kind": "workflow",
4784
+ "sourcePath": ".github/workflows/engineering-housekeeper.yml",
4785
+ "evidencePath": ".github/workflows/engineering-housekeeper.yml",
4786
+ "availability": "shipped",
4787
+ "visibility": "public",
4788
+ "participantFacing": true,
4789
+ "public": true,
4790
+ "inputCount": 13,
4791
+ "inputs": [
4792
+ "apply-enabled",
4793
+ "artifact-prefix",
4794
+ "artifact-retention-days",
4795
+ "buildchain-ref",
4796
+ "buildchain-repository",
4797
+ "max-actions",
4798
+ "mode",
4799
+ "protected-patterns",
4800
+ "repository",
4801
+ "retained-patterns",
4802
+ "stale-days",
4803
+ "stale-pull-request-label",
4804
+ "target-branch"
4805
+ ],
4806
+ "reverseAuditSource": ".github/workflows"
4807
+ },
4710
4808
  {
4711
4809
  "id": "workflow:github-artifact-attestation",
4712
4810
  "name": "workflow:github-artifact-attestation",
@@ -5365,7 +5463,7 @@
5365
5463
  "visibility": "public",
5366
5464
  "participantFacing": true,
5367
5465
  "public": true,
5368
- "inputCount": 79,
5466
+ "inputCount": 80,
5369
5467
  "inputs": [
5370
5468
  "allow-repository",
5371
5469
  "branch-protection-bypass-apps",
@@ -5396,6 +5494,7 @@
5396
5494
  "publish-package-set-order",
5397
5495
  "publish-rematerialize-on-resume",
5398
5496
  "publish-required-artifacts-json",
5497
+ "publish-required-artifacts-path",
5399
5498
  "publish-sealed-bundle-manifest",
5400
5499
  "publish-sealed-bundle-root",
5401
5500
  "publish-source-locked",
@@ -5968,6 +6067,18 @@
5968
6067
  "public": true,
5969
6068
  "reverseAuditSource": "dist/site/page-registry.json"
5970
6069
  },
6070
+ {
6071
+ "id": "site-page:manual:engineering-housekeeper",
6072
+ "name": "site-page:manual:engineering-housekeeper",
6073
+ "kind": "site-page",
6074
+ "sourcePath": "dist/site/page-registry.json",
6075
+ "evidencePath": "dist/site/page-registry.json",
6076
+ "availability": "shipped",
6077
+ "visibility": "public",
6078
+ "participantFacing": true,
6079
+ "public": true,
6080
+ "reverseAuditSource": "dist/site/page-registry.json"
6081
+ },
5971
6082
  {
5972
6083
  "id": "site-page:manual:getting-started",
5973
6084
  "name": "site-page:manual:getting-started",
@@ -6583,6 +6694,6 @@
6583
6694
  }
6584
6695
  }
6585
6696
  ],
6586
- "publicSurfaceCount": 418
6697
+ "publicSurfaceCount": 425
6587
6698
  }
6588
6699
  }
@@ -4,7 +4,7 @@
4
4
  "product": {
5
5
  "id": "kungfu-tech-buildchain",
6
6
  "name": "@kungfu-tech/buildchain",
7
- "version": "3.0.7-alpha.0",
7
+ "version": "3.0.7",
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:768042c2b38dd261803f49a141898fe80ce3e19b2a948abda2867e47c56c0b5c",
12
+ "digest": "sha256:08cfae94c78776694736e81142e2d64480fdc3e67341b415340c03d3539531e7",
13
13
  "capabilityGroup": "getting-started",
14
14
  "audience": [
15
15
  "agent",
@@ -37,7 +37,7 @@
37
37
  "title": "Auditable demo artifact pipeline",
38
38
  "path": "docs/auditable-demo.md",
39
39
  "plane": "verify",
40
- "digest": "sha256:c49e734fdfe3b74d317e23a523e198f1194b2c7cd16cca87e8e3a3ffc7bf589f",
40
+ "digest": "sha256:43989b951667f5dd3bf352209ffe551add4f83d5d551f960aeb787b2220aa665",
41
41
  "capabilityGroup": "reusable-build",
42
42
  "audience": [
43
43
  "consumer",
@@ -332,7 +332,7 @@
332
332
  "title": "Generated Node API reference",
333
333
  "path": "docs/node-api-reference.md",
334
334
  "plane": "use",
335
- "digest": "sha256:6dd79b998f63cf996e5c76b4fe0c654d12ca603cd5db1277ef3347f489b96ef0",
335
+ "digest": "sha256:ed843753964193ecb59610a54f0f23d76578228ebe6d31d1d6edce526729910c",
336
336
  "capabilityGroup": "api-cli-reference",
337
337
  "audience": [
338
338
  "agent",
@@ -389,7 +389,7 @@
389
389
  "title": "Lifecycle protocol",
390
390
  "path": "docs/lifecycle-protocol.md",
391
391
  "plane": "use",
392
- "digest": "sha256:4b7a8efe1d22751ded069f46a23490db70cda9e9e14641acab600ab781245b19",
392
+ "digest": "sha256:9fdab92b63eae0085d460a4ec78511fbb63999a311cd7693c669705bd9897eb2",
393
393
  "capabilityGroup": "reusable-build",
394
394
  "audience": [
395
395
  "consumer",
@@ -403,7 +403,7 @@
403
403
  "title": "Reusable build surface",
404
404
  "path": "docs/reusable-build-surface.md",
405
405
  "plane": "use",
406
- "digest": "sha256:7bc04f658d7e298872756278c60143d8edf5dfb841d0b0d3ea62af8028735b54",
406
+ "digest": "sha256:4741dc7661d40e14df8203d88a709b9becb08edc4313f5ad308c7e80bf672085",
407
407
  "capabilityGroup": "reusable-build",
408
408
  "audience": [
409
409
  "consumer",
@@ -445,7 +445,7 @@
445
445
  "title": "Declarative release-tail provider plane",
446
446
  "path": "docs/release-tail-provider-plane.md",
447
447
  "plane": "use",
448
- "digest": "sha256:72f4267de80bb9c57859c78e5624a6d963d452d60412543347d98d6753218d61",
448
+ "digest": "sha256:12f291124f51520b4f64c21d7fb249e89928b607a30bc00ba81eb1fc5acea5bd",
449
449
  "capabilityGroup": "release-passport-trust",
450
450
  "audience": [
451
451
  "release-operator",
@@ -475,7 +475,7 @@
475
475
  "title": "Release governance",
476
476
  "path": "docs/release-governance.md",
477
477
  "plane": "why",
478
- "digest": "sha256:34fb81d1dd9f913cbed6ee76ac9f0bdb095669e55c1bee67389601fd494470cf",
478
+ "digest": "sha256:b37d4de1f1cf9155c0e3f42c8c20a0280a263f50173eb0cad2c5f1961954822e",
479
479
  "capabilityGroup": "governance-versioning",
480
480
  "audience": [
481
481
  "maintainer",
@@ -552,6 +552,7 @@
552
552
  "docs/dev-qualification-patrol.md",
553
553
  "docs/dev-alpha-candidate-patrol.md",
554
554
  "docs/observed-evidence-patrol.md",
555
+ "docs/engineering-housekeeper.md",
555
556
  "docs/release-governance.md",
556
557
  "docs/release-passport.md",
557
558
  "docs/controller-evidence.md",