@kungfu-tech/buildchain 2.12.9-alpha.0 → 2.13.0-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 (37) hide show
  1. package/actions/run-lifecycle/README.md +5 -0
  2. package/bin/buildchain.mjs +62 -0
  3. package/dist/site/buildchain-contract.json +33 -23
  4. package/dist/site/buildchain-site.json +66 -30
  5. package/dist/site/capability-registry.json +3 -3
  6. package/dist/site/cli-registry.json +24 -0
  7. package/dist/site/controller-registry.json +11 -3
  8. package/dist/site/kfd-claims.json +64 -13
  9. package/dist/site/kfd-upstream-aggregate.json +1 -1
  10. package/dist/site/manual-registry.json +7 -7
  11. package/dist/site/node-api-registry.json +19 -6
  12. package/dist/site/page-registry.json +55 -19
  13. package/dist/site/public-surface-audit.json +47 -10
  14. package/dist/site/publication-registry.json +4 -4
  15. package/dist/site/release-provenance.json +1 -0
  16. package/dist/site/site-manifest.json +11 -11
  17. package/dist/site/workflow-registry.json +7 -4
  18. package/docs/MAP.md +1 -0
  19. package/docs/artifact-verification-envelope.md +113 -0
  20. package/docs/cli.md +22 -0
  21. package/docs/release-candidate.md +5 -0
  22. package/docs/release-governance.md +7 -0
  23. package/docs/release-propagation.md +3 -0
  24. package/docs/reusable-build-surface.md +13 -0
  25. package/docs/versioning.md +1 -0
  26. package/package.json +2 -1
  27. package/packages/core/README.md +13 -0
  28. package/packages/core/artifact-passport.js +6 -1
  29. package/packages/core/artifact-verification-envelope.js +386 -0
  30. package/packages/core/buildchain-config.js +6 -2
  31. package/packages/core/controller-evidence.js +2 -3
  32. package/packages/core/index.js +10 -0
  33. package/packages/core/release-line-bootstrap.js +24 -0
  34. package/scripts/check-inventory.mjs +5 -0
  35. package/scripts/generate-site-bundle.mjs +4 -0
  36. package/scripts/release-candidate-resolver.mjs +52 -29
  37. package/scripts/run-lifecycle-core.mjs +50 -6
@@ -15,7 +15,7 @@
15
15
  "maturity": "stable",
16
16
  "counts": {
17
17
  "manualCount": 3,
18
- "pageCount": 7,
18
+ "pageCount": 8,
19
19
  "cliCommandCount": 5,
20
20
  "nodeApiCount": 0,
21
21
  "workflowCount": 0,
@@ -49,8 +49,8 @@
49
49
  "counts": {
50
50
  "manualCount": 4,
51
51
  "pageCount": 4,
52
- "cliCommandCount": 19,
53
- "nodeApiCount": 5,
52
+ "cliCommandCount": 21,
53
+ "nodeApiCount": 6,
54
54
  "workflowCount": 2,
55
55
  "actionCount": 1
56
56
  },
@@ -701,6 +701,18 @@
701
701
  ],
702
702
  "maturity": "stable"
703
703
  },
704
+ {
705
+ "id": "project",
706
+ "source": "bin/buildchain.mjs",
707
+ "usage": "buildchain project kfx-admission <file-or-json> [--assessment-time <epoch>]",
708
+ "purpose": "Inspect read-only consumer projection command families.",
709
+ "capabilityGroup": "release-passport-trust",
710
+ "audience": [
711
+ "agent",
712
+ "operator"
713
+ ],
714
+ "maturity": "stable"
715
+ },
704
716
  {
705
717
  "id": "publication-artifact",
706
718
  "source": "bin/buildchain.mjs",
@@ -881,6 +893,18 @@
881
893
  ],
882
894
  "maturity": "stable"
883
895
  },
896
+ {
897
+ "id": "verify-artifact-envelope",
898
+ "source": "bin/buildchain.mjs",
899
+ "usage": "buildchain verify artifact-envelope <file-or-json> [--assessment-time <epoch>]",
900
+ "purpose": "Verify exact roots, identity, lifecycle, revocation, and an existing KFD assessment in a sealed artifact envelope.",
901
+ "capabilityGroup": "release-passport-trust",
902
+ "audience": [
903
+ "agent",
904
+ "operator"
905
+ ],
906
+ "maturity": "stable"
907
+ },
884
908
  {
885
909
  "id": "verify-infra-contract-evidence-bundle",
886
910
  "source": "bin/buildchain.mjs",
@@ -214,6 +214,10 @@
214
214
  "classification": "digest-only",
215
215
  "source": "workflow-call-input"
216
216
  },
217
+ "lifecycle-timeout-minutes": {
218
+ "classification": "included",
219
+ "source": "workflow-call-input"
220
+ },
217
221
  "linux-container-image": {
218
222
  "classification": "digest-only",
219
223
  "source": "workflow-call-input"
@@ -366,7 +370,7 @@
366
370
  "controller-receipt"
367
371
  ]
368
372
  },
369
- "digest": "sha256:ce2ada5daf86cbe6e58327c190fdfe07510952cc8820cf445eb4342daae4da18"
373
+ "digest": "sha256:367be236280f2597ffefc49680feb106b4cf9e8f5fb9420713351f075a168c4a"
370
374
  },
371
375
  {
372
376
  "schemaVersion": 1,
@@ -518,6 +522,10 @@
518
522
  "classification": "digest-only",
519
523
  "source": "workflow-call-input"
520
524
  },
525
+ "lifecycle-timeout-minutes": {
526
+ "classification": "included",
527
+ "source": "workflow-call-input"
528
+ },
521
529
  "linux-container-image": {
522
530
  "classification": "digest-only",
523
531
  "source": "workflow-call-input"
@@ -660,7 +668,7 @@
660
668
  "controller-receipt"
661
669
  ]
662
670
  },
663
- "digest": "sha256:0ed17d03e410ca1b7726422716522a5e9096eee7badb197401291d53198518ea"
671
+ "digest": "sha256:2e113607af3cb0a17b4da64b8758652a4bee4a162656ce7256a8e06de3d4cf2f"
664
672
  },
665
673
  {
666
674
  "schemaVersion": 1,
@@ -1737,5 +1745,5 @@
1737
1745
  "digest": "sha256:9b9f9a2320c4349903d72ee46e329211b5538ed5ebebaa93559df4eafb835997"
1738
1746
  }
1739
1747
  ],
1740
- "digest": "sha256:22be9d05109396f2b5c44a74fb0f67e4a554c462662c5a41e44e466c4d90ed04"
1748
+ "digest": "sha256:710205201c2f18c442bdda7247d70e34da81c9bdb151658af93be73b29f1d90f"
1741
1749
  }
@@ -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": "8815fc5abfe516e247a7024a367be5e3144fbe49196b7ec251dba4598bfc59ea",
24
+ "sha256": "14a69740f5eea38b4de319d7da09b58cfca185fa767493b8d1850fbf3be50f1d",
25
25
  "summary": {
26
- "cliCommandCount": 79,
26
+ "cliCommandCount": 81,
27
27
  "workflowCount": 47,
28
28
  "actionCount": 4,
29
- "sitePageCount": 49,
30
- "docCommandRefCount": 246,
29
+ "sitePageCount": 50,
30
+ "docCommandRefCount": 250,
31
31
  "failureCount": 0
32
32
  },
33
33
  "auditBoundary": {
@@ -225,13 +225,13 @@
225
225
  "contract": "kungfu-buildchain-public-surface-reverse-audit",
226
226
  "path": "dist/site/public-surface-audit.json",
227
227
  "status": "passed",
228
- "sha256": "8815fc5abfe516e247a7024a367be5e3144fbe49196b7ec251dba4598bfc59ea",
228
+ "sha256": "14a69740f5eea38b4de319d7da09b58cfca185fa767493b8d1850fbf3be50f1d",
229
229
  "summary": {
230
- "cliCommandCount": 79,
230
+ "cliCommandCount": 81,
231
231
  "workflowCount": 47,
232
232
  "actionCount": 4,
233
- "sitePageCount": 49,
234
- "docCommandRefCount": 246,
233
+ "sitePageCount": 50,
234
+ "docCommandRefCount": 250,
235
235
  "failureCount": 0
236
236
  },
237
237
  "auditBoundary": {
@@ -1039,6 +1039,18 @@
1039
1039
  "public": true,
1040
1040
  "packageExport": "./artifact-passport"
1041
1041
  },
1042
+ {
1043
+ "id": "export:./artifact-verification-envelope",
1044
+ "name": "@kungfu-tech/buildchain/artifact-verification-envelope",
1045
+ "kind": "package-export",
1046
+ "sourcePath": "packages/core/artifact-verification-envelope.js",
1047
+ "evidencePath": "packages/core/artifact-verification-envelope.js",
1048
+ "availability": "shipped",
1049
+ "visibility": "public",
1050
+ "participantFacing": true,
1051
+ "public": true,
1052
+ "packageExport": "./artifact-verification-envelope"
1053
+ },
1042
1054
  {
1043
1055
  "id": "export:./buildchain-contract",
1044
1056
  "name": "@kungfu-tech/buildchain/buildchain-contract",
@@ -2235,6 +2247,18 @@
2235
2247
  "public": true,
2236
2248
  "reverseAuditSource": "bin/buildchain.mjs"
2237
2249
  },
2250
+ {
2251
+ "id": "cli:project",
2252
+ "name": "buildchain project kfx-admission <file-or-json> [--assessment-time <epoch>]",
2253
+ "kind": "cli-command",
2254
+ "sourcePath": "bin/buildchain.mjs",
2255
+ "evidencePath": "bin/buildchain.mjs",
2256
+ "availability": "shipped",
2257
+ "visibility": "public",
2258
+ "participantFacing": true,
2259
+ "public": true,
2260
+ "reverseAuditSource": "bin/buildchain.mjs"
2261
+ },
2238
2262
  {
2239
2263
  "id": "cli:publication-artifact",
2240
2264
  "name": "buildchain publication-artifact",
@@ -2415,6 +2439,18 @@
2415
2439
  "public": true,
2416
2440
  "reverseAuditSource": "bin/buildchain.mjs"
2417
2441
  },
2442
+ {
2443
+ "id": "cli:verify-artifact-envelope",
2444
+ "name": "buildchain verify artifact-envelope <file-or-json> [--assessment-time <epoch>]",
2445
+ "kind": "cli-command",
2446
+ "sourcePath": "bin/buildchain.mjs",
2447
+ "evidencePath": "bin/buildchain.mjs",
2448
+ "availability": "shipped",
2449
+ "visibility": "public",
2450
+ "participantFacing": true,
2451
+ "public": true,
2452
+ "reverseAuditSource": "bin/buildchain.mjs"
2453
+ },
2418
2454
  {
2419
2455
  "id": "cli:verify-infra-contract-evidence-bundle",
2420
2456
  "name": "buildchain verify infra-contract-evidence-bundle <file> [--json]",
@@ -2521,7 +2557,7 @@
2521
2557
  "visibility": "public",
2522
2558
  "participantFacing": true,
2523
2559
  "public": true,
2524
- "inputCount": 58,
2560
+ "inputCount": 59,
2525
2561
  "inputs": [
2526
2562
  "artifact-name",
2527
2563
  "artifact-name-template",
@@ -2552,6 +2588,7 @@
2552
2588
  "expected-artifacts-json",
2553
2589
  "gate-profile-aggregate-json",
2554
2590
  "install-command",
2591
+ "lifecycle-timeout-minutes",
2555
2592
  "linux-container-image",
2556
2593
  "linux-container-preset",
2557
2594
  "node-version",
@@ -3036,7 +3073,7 @@
3036
3073
  "visibility": "public",
3037
3074
  "participantFacing": true,
3038
3075
  "public": true,
3039
- "inputCount": 61,
3076
+ "inputCount": 62,
3040
3077
  "inputs": [
3041
3078
  "artifact-name",
3042
3079
  "artifact-name-template",
@@ -3070,6 +3107,7 @@
3070
3107
  "expected-artifacts-json",
3071
3108
  "gate-profile-aggregate-json",
3072
3109
  "install-command",
3110
+ "lifecycle-timeout-minutes",
3073
3111
  "linux-container-image",
3074
3112
  "linux-container-preset",
3075
3113
  "node-version",
@@ -3850,7 +3888,7 @@
3850
3888
  "visibility": "public",
3851
3889
  "participantFacing": true,
3852
3890
  "public": true,
3853
- "inputCount": 20,
3891
+ "inputCount": 21,
3854
3892
  "inputs": [
3855
3893
  "artifact-name",
3856
3894
  "artifact-paths",
@@ -3871,7 +3909,8 @@
3871
3909
  "required",
3872
3910
  "sample-process-tree",
3873
3911
  "stage",
3874
- "summary-path"
3912
+ "summary-path",
3913
+ "timeout-minutes"
3875
3914
  ],
3876
3915
  "reverseAuditSource": "actions/*/action.yml"
3877
3916
  },
@@ -4097,6 +4136,18 @@
4097
4136
  "public": true,
4098
4137
  "reverseAuditSource": "dist/site/page-registry.json"
4099
4138
  },
4139
+ {
4140
+ "id": "site-page:manual:artifact-verification-envelope",
4141
+ "name": "site-page:manual:artifact-verification-envelope",
4142
+ "kind": "site-page",
4143
+ "sourcePath": "dist/site/page-registry.json",
4144
+ "evidencePath": "dist/site/page-registry.json",
4145
+ "availability": "shipped",
4146
+ "visibility": "public",
4147
+ "participantFacing": true,
4148
+ "public": true,
4149
+ "reverseAuditSource": "dist/site/page-registry.json"
4150
+ },
4100
4151
  {
4101
4152
  "id": "site-page:manual:binary-distribution",
4102
4153
  "name": "site-page:manual:binary-distribution",
@@ -4586,6 +4637,6 @@
4586
4637
  }
4587
4638
  }
4588
4639
  ],
4589
- "publicSurfaceCount": 296
4640
+ "publicSurfaceCount": 300
4590
4641
  }
4591
4642
  }
@@ -4,7 +4,7 @@
4
4
  "product": {
5
5
  "id": "kungfu-tech-buildchain",
6
6
  "name": "@kungfu-tech/buildchain",
7
- "version": "2.12.9-alpha.0",
7
+ "version": "2.13.0-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:91dc800bafc31bc149680c86272827936c94e0f025d547bbabc10d58fe5f128e",
12
+ "digest": "sha256:ce439062d4ed9d8213499e607825afdcf8a65f825343a657d0438f3e229a0af0",
13
13
  "capabilityGroup": "getting-started",
14
14
  "audience": [
15
15
  "agent",
@@ -79,7 +79,7 @@
79
79
  "title": "Release Candidate Passport",
80
80
  "path": "docs/release-candidate.md",
81
81
  "plane": "verify",
82
- "digest": "sha256:6a20c6e3e483327d5ccbe70271f7fb4752731bd0523eeddb96f27b2b6ebf1cf8",
82
+ "digest": "sha256:554613c963f57cc391acbd072bf73e1a2543d9bd1371087d4411577cccbf817c",
83
83
  "capabilityGroup": "reusable-build",
84
84
  "audience": [
85
85
  "release-operator",
@@ -93,7 +93,7 @@
93
93
  "title": "Release propagation",
94
94
  "path": "docs/release-propagation.md",
95
95
  "plane": "use",
96
- "digest": "sha256:c8085445fcd0ffd6a55197ac2db1e34fa4aaa94df9107e8e7b216b925fc3bddc",
96
+ "digest": "sha256:55895694a32b76dfaf5ed0eb9e32f1e10bd859fb590d6f4504d36692ebe61ea9",
97
97
  "capabilityGroup": "site-and-propagation",
98
98
  "audience": [
99
99
  "release-operator",
@@ -246,7 +246,7 @@
246
246
  "title": "CLI and npm package",
247
247
  "path": "docs/cli.md",
248
248
  "plane": "use",
249
- "digest": "sha256:3b3ac97c353f7549229f1102cca38236e734ec8d08c219d4a6e5ef2a48fc0e16",
249
+ "digest": "sha256:ef5be4484da8628b9e027f00fe0fdb5b295665ed23eeceefac48e63581f12c0c",
250
250
  "capabilityGroup": "api-cli-reference",
251
251
  "audience": [
252
252
  "agent",
@@ -302,7 +302,7 @@
302
302
  "title": "Reusable build surface",
303
303
  "path": "docs/reusable-build-surface.md",
304
304
  "plane": "use",
305
- "digest": "sha256:6916d88ae0f25fa129308354b04d339552b72796d4d7d7938015e0e2f4dcaa6a",
305
+ "digest": "sha256:a2092c8064332cec9a4be852b24d94f90625cb45f885c4c3208f7068a643a3f0",
306
306
  "capabilityGroup": "reusable-build",
307
307
  "audience": [
308
308
  "consumer",
@@ -329,7 +329,7 @@
329
329
  "title": "Release governance",
330
330
  "path": "docs/release-governance.md",
331
331
  "plane": "why",
332
- "digest": "sha256:cce9f80add3c746fe28d8ebf5afb809348694741cb75d19154ed3057a9374c0d",
332
+ "digest": "sha256:03108f05a608cb0849e7a668fe23671b62863907ce02a70bc6522eb8074f3e63",
333
333
  "capabilityGroup": "governance-versioning",
334
334
  "audience": [
335
335
  "maintainer",
@@ -371,7 +371,7 @@
371
371
  "title": "Versioning",
372
372
  "path": "docs/versioning.md",
373
373
  "plane": "why",
374
- "digest": "sha256:400027d5e34d5c22752f7664bb9ca9ce99c04e7be298183d0303f3fb04fa7747",
374
+ "digest": "sha256:280d30e15552ab6a362cb121a7a1cafc3b907913cdc7d4d8a9e8e1930d856f7e",
375
375
  "capabilityGroup": "governance-versioning",
376
376
  "audience": [
377
377
  "maintainer"
@@ -8,7 +8,7 @@
8
8
  "specifier": "@kungfu-tech/buildchain",
9
9
  "export": ".",
10
10
  "target": "./packages/core/index.js",
11
- "digest": "sha256:07013ab68f7947772ec5bee502f97bae4b2c2f87235188f2f28f6fbb2dc5cb23",
11
+ "digest": "sha256:68a42e62f5204170bea16640febf52d5f3cefac3b95aa8c36eb0410725a39e34",
12
12
  "summary": "Root toolkit export for Buildchain's public Node API.",
13
13
  "capabilityGroup": "api-cli-reference",
14
14
  "audience": [
@@ -47,7 +47,7 @@
47
47
  "specifier": "@kungfu-tech/buildchain/core",
48
48
  "export": "./core",
49
49
  "target": "./packages/core/index.js",
50
- "digest": "sha256:07013ab68f7947772ec5bee502f97bae4b2c2f87235188f2f28f6fbb2dc5cb23",
50
+ "digest": "sha256:68a42e62f5204170bea16640febf52d5f3cefac3b95aa8c36eb0410725a39e34",
51
51
  "summary": "Alias for the root public toolkit export.",
52
52
  "capabilityGroup": "api-cli-reference",
53
53
  "audience": [
@@ -60,7 +60,7 @@
60
60
  "specifier": "@kungfu-tech/buildchain/artifact-passport",
61
61
  "export": "./artifact-passport",
62
62
  "target": "./packages/core/artifact-passport.js",
63
- "digest": "sha256:cb3f66539792f4df8e43379850de428f6d1431785e6265948f80bbdea46e8296",
63
+ "digest": "sha256:15a43745e337b94431734c2da28b4263cabe3584f1caf9d31802721e561f03c4",
64
64
  "summary": "Artifact passport digest and evidence helper APIs.",
65
65
  "capabilityGroup": "release-passport-trust",
66
66
  "audience": [
@@ -69,6 +69,19 @@
69
69
  ],
70
70
  "maturity": "stable"
71
71
  },
72
+ {
73
+ "specifier": "@kungfu-tech/buildchain/artifact-verification-envelope",
74
+ "export": "./artifact-verification-envelope",
75
+ "target": "./packages/core/artifact-verification-envelope.js",
76
+ "digest": "sha256:c8cc0b031fc1e78fe25b3034854b038f75eb2ea046734d32323707a4085dbbe4",
77
+ "summary": "Sealed exact-root, lifecycle, identity, and existing KFD assessment inputs for KFX admission.",
78
+ "capabilityGroup": "release-passport-trust",
79
+ "audience": [
80
+ "developer",
81
+ "agent"
82
+ ],
83
+ "maturity": "stable"
84
+ },
72
85
  {
73
86
  "specifier": "@kungfu-tech/buildchain/buildchain-contract",
74
87
  "export": "./buildchain-contract",
@@ -86,7 +99,7 @@
86
99
  "specifier": "@kungfu-tech/buildchain/controller-evidence",
87
100
  "export": "./controller-evidence",
88
101
  "target": "./packages/core/controller-evidence.js",
89
- "digest": "sha256:eb4541a6b184b8332448b594b70b367f2231e7fd57a69d5c54329998ee265b90",
102
+ "digest": "sha256:3c9cf557ee0e2e4376335bb7d0e61b6e8c9a1d8699962dd8a1e7adc529e13f89",
90
103
  "summary": "Project-independent controller descriptors, source/runtime-bound plans, receipts, aggregates, and validation APIs.",
91
104
  "capabilityGroup": "reusable-build",
92
105
  "audience": [
@@ -164,7 +177,7 @@
164
177
  "specifier": "@kungfu-tech/buildchain/release-line-bootstrap",
165
178
  "export": "./release-line-bootstrap",
166
179
  "target": "./packages/core/release-line-bootstrap.js",
167
- "digest": "sha256:7c42519975f8a653ca7bae4f0b33baf34d7e1dcb6dd4e87be9ed27de2d252e55",
180
+ "digest": "sha256:9f44e3f9c6be058a797a69cd43f539491a8c85e9ee937a8e91001b8fd138e626",
168
181
  "summary": "Semver release-line bootstrap planning and version-state APIs.",
169
182
  "capabilityGroup": "governance-versioning",
170
183
  "audience": [
@@ -373,7 +386,7 @@
373
386
  {
374
387
  "id": "cli-and-node-package",
375
388
  "path": "docs/cli.md",
376
- "digest": "sha256:3b3ac97c353f7549229f1102cca38236e734ec8d08c219d4a6e5ef2a48fc0e16"
389
+ "digest": "sha256:ef5be4484da8628b9e027f00fe0fdb5b295665ed23eeceefac48e63581f12c0c"
377
390
  },
378
391
  {
379
392
  "id": "build-facts",