@kungfu-tech/buildchain 2.12.6 → 2.12.7-alpha.10

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 (40) hide show
  1. package/actions/promote-buildchain-ref/README.md +11 -3
  2. package/bin/buildchain.mjs +78 -0
  3. package/dist/site/agent-index.json +1 -0
  4. package/dist/site/artifact-schemas.json +1 -0
  5. package/dist/site/buildchain-contract.json +163 -38
  6. package/dist/site/buildchain-site.json +73 -17
  7. package/dist/site/capability-registry.json +6 -5
  8. package/dist/site/cli-registry.json +36 -0
  9. package/dist/site/controller-registry.json +121 -10
  10. package/dist/site/kfd-claims.json +305 -17
  11. package/dist/site/kfd-upstream-aggregate.json +1 -1
  12. package/dist/site/manual-registry.json +16 -2
  13. package/dist/site/node-api-registry.json +43 -4
  14. package/dist/site/page-registry.json +58 -11
  15. package/dist/site/public-surface-audit.json +212 -19
  16. package/dist/site/publication-authority-registry.json +778 -0
  17. package/dist/site/publication-registry.json +4 -4
  18. package/dist/site/release-provenance.json +4 -0
  19. package/dist/site/site-manifest.json +15 -6
  20. package/dist/site/workflow-registry.json +173 -12
  21. package/docs/MAP.md +2 -1
  22. package/docs/publication-artifacts.md +25 -18
  23. package/docs/publication-authority.md +213 -0
  24. package/docs/release-governance.md +3 -1
  25. package/docs/shifu-gate-profiles.md +6 -0
  26. package/package.json +5 -1
  27. package/packages/core/buildchain-kfd-claims.js +5 -0
  28. package/packages/core/buildchain-publication-authority.js +80 -0
  29. package/packages/core/controller-evidence.js +8 -8
  30. package/packages/core/index.js +35 -0
  31. package/packages/core/publication-artifact-candidate.js +128 -0
  32. package/packages/core/publication-authority.js +764 -0
  33. package/packages/core/publication-control-plane-audit.js +135 -0
  34. package/scripts/assemble-publication-artifact-admission.mjs +190 -0
  35. package/scripts/assemble-self-publication-admission.mjs +183 -0
  36. package/scripts/audit-publication-control-plane.mjs +409 -0
  37. package/scripts/check-inventory.mjs +25 -2
  38. package/scripts/generate-site-bundle.mjs +16 -0
  39. package/scripts/publication-artifact-candidate.mjs +130 -0
  40. package/scripts/workflow-friction-report.mjs +13 -2
@@ -47,15 +47,16 @@
47
47
  ],
48
48
  "maturity": "stable",
49
49
  "counts": {
50
- "manualCount": 3,
51
- "pageCount": 3,
52
- "cliCommandCount": 16,
53
- "nodeApiCount": 2,
50
+ "manualCount": 4,
51
+ "pageCount": 4,
52
+ "cliCommandCount": 19,
53
+ "nodeApiCount": 5,
54
54
  "workflowCount": 2,
55
55
  "actionCount": 1
56
56
  },
57
57
  "manuals": [
58
58
  "docs/release-passport.md",
59
+ "docs/publication-authority.md",
59
60
  "docs/binary-distribution.md",
60
61
  "docs/publish-transaction.md"
61
62
  ],
@@ -286,7 +287,7 @@
286
287
  "pageCount": 6,
287
288
  "cliCommandCount": 0,
288
289
  "nodeApiCount": 2,
289
- "workflowCount": 26,
290
+ "workflowCount": 30,
290
291
  "actionCount": 0
291
292
  },
292
293
  "manuals": [
@@ -5,6 +5,18 @@
5
5
  "npmPackage": "@kungfu-tech/buildchain",
6
6
  "commandSource": "bin/buildchain.mjs reverse enumeration",
7
7
  "commands": [
8
+ {
9
+ "id": "audit",
10
+ "source": "bin/buildchain.mjs",
11
+ "usage": "buildchain audit publication-control-plane --repository <owner/repo> --branch <protected-branch>",
12
+ "purpose": "Inspect read-only publication authority audit commands.",
13
+ "capabilityGroup": "release-passport-trust",
14
+ "audience": [
15
+ "agent",
16
+ "operator"
17
+ ],
18
+ "maturity": "stable"
19
+ },
8
20
  {
9
21
  "id": "badges",
10
22
  "source": "bin/buildchain.mjs",
@@ -89,6 +101,18 @@
89
101
  ],
90
102
  "maturity": "stable"
91
103
  },
104
+ {
105
+ "id": "create",
106
+ "source": "bin/buildchain.mjs",
107
+ "usage": "buildchain create publication-admission --input-json <file-or-json> [--output <file>] [--json]",
108
+ "purpose": "Create canonical sealed publication evidence documents.",
109
+ "capabilityGroup": "release-passport-trust",
110
+ "audience": [
111
+ "agent",
112
+ "operator"
113
+ ],
114
+ "maturity": "stable"
115
+ },
92
116
  {
93
117
  "id": "diagnostics",
94
118
  "source": "bin/buildchain.mjs",
@@ -881,6 +905,18 @@
881
905
  ],
882
906
  "maturity": "stable"
883
907
  },
908
+ {
909
+ "id": "verify-publication-admission",
910
+ "source": "bin/buildchain.mjs",
911
+ "usage": "buildchain verify publication-admission <file-or-json>",
912
+ "purpose": "Independently verify sealed publication admission, runner provenance, control-plane audit, nonce freshness, and exact artifact bindings.",
913
+ "capabilityGroup": "release-passport-trust",
914
+ "audience": [
915
+ "agent",
916
+ "operator"
917
+ ],
918
+ "maturity": "stable"
919
+ },
884
920
  {
885
921
  "id": "verify-release-passport",
886
922
  "source": "bin/buildchain.mjs",
@@ -897,6 +897,26 @@
897
897
  "classification": "redacted",
898
898
  "source": "workflow-call-input"
899
899
  },
900
+ "publication-admission-json": {
901
+ "classification": "digest-only",
902
+ "source": "workflow-call-input"
903
+ },
904
+ "publication-control-plane-audit-json": {
905
+ "classification": "digest-only",
906
+ "source": "workflow-call-input"
907
+ },
908
+ "publication-expected-json": {
909
+ "classification": "digest-only",
910
+ "source": "workflow-call-input"
911
+ },
912
+ "publication-runner-provenance-json": {
913
+ "classification": "digest-only",
914
+ "source": "workflow-call-input"
915
+ },
916
+ "publication-used-nonces-json": {
917
+ "classification": "digest-only",
918
+ "source": "workflow-call-input"
919
+ },
900
920
  "release-feedback-actor-privacy": {
901
921
  "classification": "included",
902
922
  "source": "workflow-call-input"
@@ -940,6 +960,10 @@
940
960
  "id": "verify",
941
961
  "required": false
942
962
  },
963
+ {
964
+ "id": "publication-authority",
965
+ "required": false
966
+ },
943
967
  {
944
968
  "id": "apply",
945
969
  "required": false
@@ -953,14 +977,15 @@
953
977
  "web-build",
954
978
  "web-verify",
955
979
  "deployment-plan",
956
- "deployment-apply"
980
+ "deployment-apply",
981
+ "publication-authority"
957
982
  ],
958
983
  "evidence": [
959
984
  "web-surface-plan",
960
985
  "controller-receipt"
961
986
  ]
962
987
  },
963
- "digest": "sha256:09b4d98c400fb12a87b701eedaaefbf4af2fd0c1fb19b8b44c6219c596430e80"
988
+ "digest": "sha256:f08c4970f33c059f8e0b43110f0063172fb1015ac914bdb0c8e9646692fb9f06"
964
989
  },
965
990
  {
966
991
  "schemaVersion": 1,
@@ -1012,10 +1037,26 @@
1012
1037
  "classification": "included",
1013
1038
  "source": "workflow-call-input"
1014
1039
  },
1040
+ "package-name": {
1041
+ "classification": "included",
1042
+ "source": "workflow-call-input"
1043
+ },
1044
+ "prepare-paper-package": {
1045
+ "classification": "included",
1046
+ "source": "workflow-call-input"
1047
+ },
1048
+ "publish-dist-tag": {
1049
+ "classification": "included",
1050
+ "source": "workflow-call-input"
1051
+ },
1015
1052
  "setup-node": {
1016
1053
  "classification": "included",
1017
1054
  "source": "workflow-call-input"
1018
1055
  },
1056
+ "target-ref": {
1057
+ "classification": "included",
1058
+ "source": "workflow-call-input"
1059
+ },
1019
1060
  "toolchain-command": {
1020
1061
  "classification": "digest-only",
1021
1062
  "source": "workflow-call-input"
@@ -1075,7 +1116,7 @@
1075
1116
  "controller-receipt"
1076
1117
  ]
1077
1118
  },
1078
- "digest": "sha256:d09d8f4081e7b5b9296487337206111591eeca6f8d7667e90012ac911c1b71cf"
1119
+ "digest": "sha256:6b132790b9798e8a5dfbe095701d8e024c160a08bc7c4bd477ee79feef7a9cfd"
1079
1120
  },
1080
1121
  {
1081
1122
  "schemaVersion": 1,
@@ -1087,10 +1128,6 @@
1087
1128
  "path": ".github/workflows/paper-release.yml"
1088
1129
  },
1089
1130
  "inputs": {
1090
- "BUILDCHAIN_PROMOTION_TOKEN": {
1091
- "classification": "redacted",
1092
- "source": "workflow-call-secret"
1093
- },
1094
1131
  "artifact-name": {
1095
1132
  "classification": "included",
1096
1133
  "source": "workflow-call-input"
@@ -1159,6 +1196,26 @@
1159
1196
  "classification": "included",
1160
1197
  "source": "workflow-call-input"
1161
1198
  },
1199
+ "publication-admission-json": {
1200
+ "classification": "digest-only",
1201
+ "source": "workflow-call-input"
1202
+ },
1203
+ "publication-control-plane-audit-json": {
1204
+ "classification": "digest-only",
1205
+ "source": "workflow-call-input"
1206
+ },
1207
+ "publication-expected-json": {
1208
+ "classification": "digest-only",
1209
+ "source": "workflow-call-input"
1210
+ },
1211
+ "publication-runner-provenance-json": {
1212
+ "classification": "digest-only",
1213
+ "source": "workflow-call-input"
1214
+ },
1215
+ "publication-used-nonces-json": {
1216
+ "classification": "digest-only",
1217
+ "source": "workflow-call-input"
1218
+ },
1162
1219
  "publish-dist-tag": {
1163
1220
  "classification": "included",
1164
1221
  "source": "workflow-call-input"
@@ -1238,6 +1295,10 @@
1238
1295
  "id": "collect",
1239
1296
  "required": true
1240
1297
  },
1298
+ {
1299
+ "id": "publication-authority",
1300
+ "required": true
1301
+ },
1241
1302
  {
1242
1303
  "id": "publish",
1243
1304
  "required": true
@@ -1254,6 +1315,7 @@
1254
1315
  "capabilities": [
1255
1316
  "publication-build",
1256
1317
  "artifact-admission",
1318
+ "publication-authority",
1257
1319
  "release-publish",
1258
1320
  "release-passport"
1259
1321
  ],
@@ -1263,7 +1325,7 @@
1263
1325
  "controller-receipt"
1264
1326
  ]
1265
1327
  },
1266
- "digest": "sha256:726e94ed5353240289700df7f436e9aa4041783738757dfbdef1a6825acb6bfb"
1328
+ "digest": "sha256:0613ea545fe2d630f34e665c8e6fe99df3f5333d75051a7176e9cf991e494f59"
1267
1329
  },
1268
1330
  {
1269
1331
  "schemaVersion": 1,
@@ -1371,6 +1433,50 @@
1371
1433
  "classification": "included",
1372
1434
  "source": "workflow-call-input"
1373
1435
  },
1436
+ "publication-admission-json": {
1437
+ "classification": "digest-only",
1438
+ "source": "workflow-call-input"
1439
+ },
1440
+ "publication-auto-admission": {
1441
+ "classification": "included",
1442
+ "source": "workflow-call-input"
1443
+ },
1444
+ "publication-control-plane-audit-json": {
1445
+ "classification": "digest-only",
1446
+ "source": "workflow-call-input"
1447
+ },
1448
+ "publication-expected-json": {
1449
+ "classification": "digest-only",
1450
+ "source": "workflow-call-input"
1451
+ },
1452
+ "publication-gate-aggregate-json": {
1453
+ "classification": "digest-only",
1454
+ "source": "workflow-call-input"
1455
+ },
1456
+ "publication-package-name": {
1457
+ "classification": "included",
1458
+ "source": "workflow-call-input"
1459
+ },
1460
+ "publication-product": {
1461
+ "classification": "included",
1462
+ "source": "workflow-call-input"
1463
+ },
1464
+ "publication-publisher-workflow-path": {
1465
+ "classification": "digest-only",
1466
+ "source": "workflow-call-input"
1467
+ },
1468
+ "publication-runner-provenance-json": {
1469
+ "classification": "digest-only",
1470
+ "source": "workflow-call-input"
1471
+ },
1472
+ "publication-target": {
1473
+ "classification": "included",
1474
+ "source": "workflow-call-input"
1475
+ },
1476
+ "publication-used-nonces-json": {
1477
+ "classification": "digest-only",
1478
+ "source": "workflow-call-input"
1479
+ },
1374
1480
  "publish-artifact-kind": {
1375
1481
  "classification": "included",
1376
1482
  "source": "workflow-call-input"
@@ -1490,6 +1596,10 @@
1490
1596
  "id": "admit-release-candidate",
1491
1597
  "required": true
1492
1598
  },
1599
+ {
1600
+ "id": "publication-authority",
1601
+ "required": true
1602
+ },
1493
1603
  {
1494
1604
  "id": "publish",
1495
1605
  "required": true
@@ -1506,6 +1616,7 @@
1506
1616
  "capabilities": [
1507
1617
  "promotion-preflight",
1508
1618
  "artifact-admission",
1619
+ "publication-authority",
1509
1620
  "publish-transaction",
1510
1621
  "release-passport"
1511
1622
  ],
@@ -1516,7 +1627,7 @@
1516
1627
  "controller-receipt"
1517
1628
  ]
1518
1629
  },
1519
- "digest": "sha256:f5a295b2d3e8f20ba46c611acaed71ee7ab5cd1ecaa6e7504b4344493271a803"
1630
+ "digest": "sha256:c2f1fd6e984606b077b27bb243b66077162c2c4be03f99c0d8f917bf7bf4d0d1"
1520
1631
  },
1521
1632
  {
1522
1633
  "schemaVersion": 1,
@@ -1622,5 +1733,5 @@
1622
1733
  "digest": "sha256:9b9f9a2320c4349903d72ee46e329211b5538ed5ebebaa93559df4eafb835997"
1623
1734
  }
1624
1735
  ],
1625
- "digest": "sha256:0bd2214618cfa1fb7cdc052b3dcb64fa1ab8b815416bc00bbd27c0c666923363"
1736
+ "digest": "sha256:aeb2d6b05cdd8e8118d6cc2c82cf4b7bf00f934b809479017a12b69c299d0e05"
1626
1737
  }