@kungfu-tech/buildchain 2.10.9 → 2.10.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.
- package/bin/buildchain.mjs +11 -1
- package/dist/site/buildchain-contract.json +6 -6
- package/dist/site/buildchain-site.json +79 -16
- package/dist/site/capability-registry.json +5 -5
- package/dist/site/cli-registry.json +25 -1
- package/dist/site/kfd-claims.json +114 -13
- package/dist/site/kfd-upstream-aggregate.json +1 -1
- package/dist/site/manual-registry.json +3 -3
- package/dist/site/node-api-registry.json +17 -4
- package/dist/site/page-registry.json +72 -9
- package/dist/site/public-surface-audit.json +63 -9
- package/dist/site/release-provenance.json +1 -0
- package/dist/site/site-manifest.json +7 -7
- package/dist/site/workflow-registry.json +25 -1
- package/docs/MAP.md +6 -1
- package/docs/cli.md +19 -2
- package/docs/publication-artifacts.md +126 -0
- package/docs/web-surface-deployments.md +8 -2
- package/fixtures/publication-artifact-shaped/README.md +11 -0
- package/package.json +2 -1
- package/packages/core/README.md +11 -0
- package/packages/core/buildchain-config.js +33 -2
- package/packages/core/index.js +8 -0
- package/packages/core/public-surface-audit.js +4 -0
- package/packages/core/publication-artifact.js +245 -0
- package/scripts/generate-site-bundle.mjs +5 -1
- package/scripts/init-repo.mjs +80 -6
- package/scripts/publication-artifact.mjs +45 -0
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
"maturity": "stable",
|
|
16
16
|
"counts": {
|
|
17
17
|
"manualCount": 3,
|
|
18
|
-
"pageCount":
|
|
18
|
+
"pageCount": 5,
|
|
19
19
|
"cliCommandCount": 5,
|
|
20
20
|
"nodeApiCount": 0,
|
|
21
21
|
"workflowCount": 0,
|
|
@@ -79,10 +79,10 @@
|
|
|
79
79
|
"maturity": "stable",
|
|
80
80
|
"counts": {
|
|
81
81
|
"manualCount": 3,
|
|
82
|
-
"pageCount":
|
|
83
|
-
"cliCommandCount":
|
|
84
|
-
"nodeApiCount":
|
|
85
|
-
"workflowCount":
|
|
82
|
+
"pageCount": 15,
|
|
83
|
+
"cliCommandCount": 3,
|
|
84
|
+
"nodeApiCount": 2,
|
|
85
|
+
"workflowCount": 2,
|
|
86
86
|
"actionCount": 2
|
|
87
87
|
},
|
|
88
88
|
"manuals": [
|
|
@@ -236,7 +236,7 @@
|
|
|
236
236
|
{
|
|
237
237
|
"id": "init",
|
|
238
238
|
"source": "bin/buildchain.mjs",
|
|
239
|
-
"usage": "buildchain init [--cwd <dir>] [--type package|native|web-surface|infra-contract|anchored-package] [--force]",
|
|
239
|
+
"usage": "buildchain init [--cwd <dir>] [--type package|native|web-surface|infra-contract|publication-artifact|anchored-package] [--force]",
|
|
240
240
|
"purpose": "Bootstrap a repository with Buildchain configuration and caller workflow files.",
|
|
241
241
|
"capabilityGroup": "getting-started",
|
|
242
242
|
"audience": [
|
|
@@ -653,6 +653,30 @@
|
|
|
653
653
|
],
|
|
654
654
|
"maturity": "stable"
|
|
655
655
|
},
|
|
656
|
+
{
|
|
657
|
+
"id": "publication-artifact",
|
|
658
|
+
"source": "bin/buildchain.mjs",
|
|
659
|
+
"usage": "buildchain publication-artifact",
|
|
660
|
+
"purpose": "Generate publication artifact manifests, passports, and source bundles for paper/report repositories.",
|
|
661
|
+
"capabilityGroup": "reusable-build",
|
|
662
|
+
"audience": [
|
|
663
|
+
"agent",
|
|
664
|
+
"operator"
|
|
665
|
+
],
|
|
666
|
+
"maturity": "stable"
|
|
667
|
+
},
|
|
668
|
+
{
|
|
669
|
+
"id": "publication-artifact-manifest",
|
|
670
|
+
"source": "bin/buildchain.mjs",
|
|
671
|
+
"usage": "buildchain publication-artifact manifest [--cwd <dir>] [--source-sha <sha>]",
|
|
672
|
+
"purpose": "Write a site-consumable publication artifact manifest, publication passport, and source bundle.",
|
|
673
|
+
"capabilityGroup": "reusable-build",
|
|
674
|
+
"audience": [
|
|
675
|
+
"agent",
|
|
676
|
+
"operator"
|
|
677
|
+
],
|
|
678
|
+
"maturity": "stable"
|
|
679
|
+
},
|
|
656
680
|
{
|
|
657
681
|
"id": "publish-source",
|
|
658
682
|
"source": "bin/buildchain.mjs",
|
|
@@ -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": "
|
|
24
|
+
"sha256": "7d22fa037b5c1c14ac2ca1853dd414bb83b2c561221034a49a97401f28672471",
|
|
25
25
|
"summary": {
|
|
26
|
-
"cliCommandCount":
|
|
27
|
-
"workflowCount":
|
|
26
|
+
"cliCommandCount": 73,
|
|
27
|
+
"workflowCount": 36,
|
|
28
28
|
"actionCount": 4,
|
|
29
|
-
"sitePageCount":
|
|
30
|
-
"docCommandRefCount":
|
|
29
|
+
"sitePageCount": 45,
|
|
30
|
+
"docCommandRefCount": 227,
|
|
31
31
|
"failureCount": 0
|
|
32
32
|
},
|
|
33
33
|
"auditBoundary": {
|
|
@@ -207,13 +207,13 @@
|
|
|
207
207
|
"contract": "kungfu-buildchain-public-surface-reverse-audit",
|
|
208
208
|
"path": "dist/site/public-surface-audit.json",
|
|
209
209
|
"status": "passed",
|
|
210
|
-
"sha256": "
|
|
210
|
+
"sha256": "7d22fa037b5c1c14ac2ca1853dd414bb83b2c561221034a49a97401f28672471",
|
|
211
211
|
"summary": {
|
|
212
|
-
"cliCommandCount":
|
|
213
|
-
"workflowCount":
|
|
212
|
+
"cliCommandCount": 73,
|
|
213
|
+
"workflowCount": 36,
|
|
214
214
|
"actionCount": 4,
|
|
215
|
-
"sitePageCount":
|
|
216
|
-
"docCommandRefCount":
|
|
215
|
+
"sitePageCount": 45,
|
|
216
|
+
"docCommandRefCount": 227,
|
|
217
217
|
"failureCount": 0
|
|
218
218
|
},
|
|
219
219
|
"auditBoundary": {
|
|
@@ -695,6 +695,18 @@
|
|
|
695
695
|
"public": true,
|
|
696
696
|
"plane": "fixture"
|
|
697
697
|
},
|
|
698
|
+
{
|
|
699
|
+
"id": "doc:fixtures/publication-artifact-shaped/README.md",
|
|
700
|
+
"name": "fixtures/publication-artifact-shaped/README.md",
|
|
701
|
+
"kind": "documentation",
|
|
702
|
+
"sourcePath": "fixtures/publication-artifact-shaped/README.md",
|
|
703
|
+
"evidencePath": "fixtures/publication-artifact-shaped/README.md",
|
|
704
|
+
"availability": "shipped",
|
|
705
|
+
"visibility": "public",
|
|
706
|
+
"participantFacing": true,
|
|
707
|
+
"public": true,
|
|
708
|
+
"plane": "fixture"
|
|
709
|
+
},
|
|
698
710
|
{
|
|
699
711
|
"id": "doc:fixtures/publish-transaction-shaped/README.md",
|
|
700
712
|
"name": "fixtures/publish-transaction-shaped/README.md",
|
|
@@ -1061,6 +1073,18 @@
|
|
|
1061
1073
|
"public": true,
|
|
1062
1074
|
"packageExport": "./logging"
|
|
1063
1075
|
},
|
|
1076
|
+
{
|
|
1077
|
+
"id": "export:./publication-artifact",
|
|
1078
|
+
"name": "@kungfu-tech/buildchain/publication-artifact",
|
|
1079
|
+
"kind": "package-export",
|
|
1080
|
+
"sourcePath": "packages/core/publication-artifact.js",
|
|
1081
|
+
"evidencePath": "packages/core/publication-artifact.js",
|
|
1082
|
+
"availability": "shipped",
|
|
1083
|
+
"visibility": "public",
|
|
1084
|
+
"participantFacing": true,
|
|
1085
|
+
"public": true,
|
|
1086
|
+
"packageExport": "./publication-artifact"
|
|
1087
|
+
},
|
|
1064
1088
|
{
|
|
1065
1089
|
"id": "export:./kfd-gate",
|
|
1066
1090
|
"name": "@kungfu-tech/buildchain/kfd-gate",
|
|
@@ -1554,7 +1578,7 @@
|
|
|
1554
1578
|
},
|
|
1555
1579
|
{
|
|
1556
1580
|
"id": "cli:init",
|
|
1557
|
-
"name": "buildchain init [--cwd <dir>] [--type package|native|web-surface|infra-contract|anchored-package] [--force]",
|
|
1581
|
+
"name": "buildchain init [--cwd <dir>] [--type package|native|web-surface|infra-contract|publication-artifact|anchored-package] [--force]",
|
|
1558
1582
|
"kind": "cli-command",
|
|
1559
1583
|
"sourcePath": "bin/buildchain.mjs",
|
|
1560
1584
|
"evidencePath": "bin/buildchain.mjs",
|
|
@@ -1972,6 +1996,30 @@
|
|
|
1972
1996
|
"public": true,
|
|
1973
1997
|
"reverseAuditSource": "bin/buildchain.mjs"
|
|
1974
1998
|
},
|
|
1999
|
+
{
|
|
2000
|
+
"id": "cli:publication-artifact",
|
|
2001
|
+
"name": "buildchain publication-artifact",
|
|
2002
|
+
"kind": "cli-command",
|
|
2003
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
2004
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
2005
|
+
"availability": "shipped",
|
|
2006
|
+
"visibility": "public",
|
|
2007
|
+
"participantFacing": true,
|
|
2008
|
+
"public": true,
|
|
2009
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
2010
|
+
},
|
|
2011
|
+
{
|
|
2012
|
+
"id": "cli:publication-artifact-manifest",
|
|
2013
|
+
"name": "buildchain publication-artifact manifest [--cwd <dir>] [--source-sha <sha>]",
|
|
2014
|
+
"kind": "cli-command",
|
|
2015
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
2016
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
2017
|
+
"availability": "shipped",
|
|
2018
|
+
"visibility": "public",
|
|
2019
|
+
"participantFacing": true,
|
|
2020
|
+
"public": true,
|
|
2021
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
2022
|
+
},
|
|
1975
2023
|
{
|
|
1976
2024
|
"id": "cli:publish-source",
|
|
1977
2025
|
"name": "buildchain publish-source <lock|manifest|verify-lock|verify-channel-ref|validate-anchored-release> ...",
|
|
@@ -2480,7 +2528,7 @@
|
|
|
2480
2528
|
"visibility": "public",
|
|
2481
2529
|
"participantFacing": true,
|
|
2482
2530
|
"public": true,
|
|
2483
|
-
"inputCount":
|
|
2531
|
+
"inputCount": 33,
|
|
2484
2532
|
"inputs": [
|
|
2485
2533
|
"artifact-path",
|
|
2486
2534
|
"aws-region",
|
|
@@ -2501,6 +2549,7 @@
|
|
|
2501
2549
|
"production-approved",
|
|
2502
2550
|
"production-aws-role-arn",
|
|
2503
2551
|
"production-environment",
|
|
2552
|
+
"production-release-app-client-id",
|
|
2504
2553
|
"production-release-app-id",
|
|
2505
2554
|
"production-release-branch-channel",
|
|
2506
2555
|
"production-release-head-prefix",
|
|
@@ -2836,6 +2885,34 @@
|
|
|
2836
2885
|
],
|
|
2837
2886
|
"reverseAuditSource": ".github/workflows"
|
|
2838
2887
|
},
|
|
2888
|
+
{
|
|
2889
|
+
"id": "workflow:publication-artifact",
|
|
2890
|
+
"name": "workflow:publication-artifact",
|
|
2891
|
+
"kind": "workflow",
|
|
2892
|
+
"sourcePath": ".github/workflows/publication-artifact.yml",
|
|
2893
|
+
"evidencePath": ".github/workflows/publication-artifact.yml",
|
|
2894
|
+
"availability": "shipped",
|
|
2895
|
+
"visibility": "public",
|
|
2896
|
+
"participantFacing": true,
|
|
2897
|
+
"public": true,
|
|
2898
|
+
"inputCount": 13,
|
|
2899
|
+
"inputs": [
|
|
2900
|
+
"artifact-name",
|
|
2901
|
+
"artifact-paths",
|
|
2902
|
+
"artifact-retention-days",
|
|
2903
|
+
"build-command",
|
|
2904
|
+
"buildchain-contract-compatibility-policy",
|
|
2905
|
+
"buildchain-contract-drift-issue-mode",
|
|
2906
|
+
"buildchain-contract-lock-path",
|
|
2907
|
+
"buildchain-ref",
|
|
2908
|
+
"buildchain-repository",
|
|
2909
|
+
"node-version",
|
|
2910
|
+
"setup-node",
|
|
2911
|
+
"verify-command",
|
|
2912
|
+
"working-directory"
|
|
2913
|
+
],
|
|
2914
|
+
"reverseAuditSource": ".github/workflows"
|
|
2915
|
+
},
|
|
2839
2916
|
{
|
|
2840
2917
|
"id": "workflow:release-candidate-promote",
|
|
2841
2918
|
"name": "workflow:release-candidate-promote",
|
|
@@ -3351,6 +3428,18 @@
|
|
|
3351
3428
|
"public": true,
|
|
3352
3429
|
"reverseAuditSource": "dist/site/page-registry.json"
|
|
3353
3430
|
},
|
|
3431
|
+
{
|
|
3432
|
+
"id": "site-page:fixture:publication-artifact-shaped",
|
|
3433
|
+
"name": "site-page:fixture:publication-artifact-shaped",
|
|
3434
|
+
"kind": "site-page",
|
|
3435
|
+
"sourcePath": "dist/site/page-registry.json",
|
|
3436
|
+
"evidencePath": "dist/site/page-registry.json",
|
|
3437
|
+
"availability": "shipped",
|
|
3438
|
+
"visibility": "public",
|
|
3439
|
+
"participantFacing": true,
|
|
3440
|
+
"public": true,
|
|
3441
|
+
"reverseAuditSource": "dist/site/page-registry.json"
|
|
3442
|
+
},
|
|
3354
3443
|
{
|
|
3355
3444
|
"id": "site-page:fixture:publish-transaction-shaped",
|
|
3356
3445
|
"name": "site-page:fixture:publish-transaction-shaped",
|
|
@@ -3543,6 +3632,18 @@
|
|
|
3543
3632
|
"public": true,
|
|
3544
3633
|
"reverseAuditSource": "dist/site/page-registry.json"
|
|
3545
3634
|
},
|
|
3635
|
+
{
|
|
3636
|
+
"id": "site-page:manual:publication-artifacts",
|
|
3637
|
+
"name": "site-page:manual:publication-artifacts",
|
|
3638
|
+
"kind": "site-page",
|
|
3639
|
+
"sourcePath": "dist/site/page-registry.json",
|
|
3640
|
+
"evidencePath": "dist/site/page-registry.json",
|
|
3641
|
+
"availability": "shipped",
|
|
3642
|
+
"visibility": "public",
|
|
3643
|
+
"participantFacing": true,
|
|
3644
|
+
"public": true,
|
|
3645
|
+
"reverseAuditSource": "dist/site/page-registry.json"
|
|
3646
|
+
},
|
|
3546
3647
|
{
|
|
3547
3648
|
"id": "site-page:manual:publish-transaction",
|
|
3548
3649
|
"name": "site-page:manual:publish-transaction",
|
|
@@ -3781,6 +3882,6 @@
|
|
|
3781
3882
|
"public": true
|
|
3782
3883
|
}
|
|
3783
3884
|
],
|
|
3784
|
-
"publicSurfaceCount":
|
|
3885
|
+
"publicSurfaceCount": 259
|
|
3785
3886
|
}
|
|
3786
3887
|
}
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
"title": "Buildchain documentation map",
|
|
10
10
|
"path": "docs/MAP.md",
|
|
11
11
|
"plane": "use",
|
|
12
|
-
"digest": "sha256:
|
|
12
|
+
"digest": "sha256:2295adcb4860c46a6f7fb39a0790d7347d916a0ac999d862437698d194af31de",
|
|
13
13
|
"capabilityGroup": "getting-started",
|
|
14
14
|
"audience": [
|
|
15
15
|
"agent",
|
|
@@ -217,7 +217,7 @@
|
|
|
217
217
|
"title": "CLI and npm package",
|
|
218
218
|
"path": "docs/cli.md",
|
|
219
219
|
"plane": "use",
|
|
220
|
-
"digest": "sha256:
|
|
220
|
+
"digest": "sha256:35df4de8a3ade449bb577b50ac3000adb2eafe354fd2f885f408ffe6e86d5f19",
|
|
221
221
|
"capabilityGroup": "api-cli-reference",
|
|
222
222
|
"audience": [
|
|
223
223
|
"agent",
|
|
@@ -355,7 +355,7 @@
|
|
|
355
355
|
"title": "Web surface deployments",
|
|
356
356
|
"path": "docs/web-surface-deployments.md",
|
|
357
357
|
"plane": "use",
|
|
358
|
-
"digest": "sha256:
|
|
358
|
+
"digest": "sha256:e5792a28aac1b2502a91f0cafd06dd52a4eecbcfb1f8df349c5aed16229777ec",
|
|
359
359
|
"capabilityGroup": "site-and-propagation",
|
|
360
360
|
"audience": [
|
|
361
361
|
"site",
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
"specifier": "@kungfu-tech/buildchain",
|
|
9
9
|
"export": ".",
|
|
10
10
|
"target": "./packages/core/index.js",
|
|
11
|
-
"digest": "sha256:
|
|
11
|
+
"digest": "sha256:046d9a89ad57d78c93787baead48361179db9c5a408528a4f68a595b9acb9893",
|
|
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:
|
|
50
|
+
"digest": "sha256:046d9a89ad57d78c93787baead48361179db9c5a408528a4f68a595b9acb9893",
|
|
51
51
|
"summary": "Alias for the root public toolkit export.",
|
|
52
52
|
"capabilityGroup": "api-cli-reference",
|
|
53
53
|
"audience": [
|
|
@@ -177,7 +177,7 @@
|
|
|
177
177
|
"specifier": "@kungfu-tech/buildchain/public-surface-audit",
|
|
178
178
|
"export": "./public-surface-audit",
|
|
179
179
|
"target": "./packages/core/public-surface-audit.js",
|
|
180
|
-
"digest": "sha256:
|
|
180
|
+
"digest": "sha256:62c4b7e30d6f13b32df777c5c7e70d83bcac63b90d4bcbc4a647d8bfc8829850",
|
|
181
181
|
"summary": "Reverse audit APIs for CLI, workflow, action, site page, and documentation command surfaces.",
|
|
182
182
|
"capabilityGroup": "kfd-trust",
|
|
183
183
|
"audience": [
|
|
@@ -199,6 +199,19 @@
|
|
|
199
199
|
],
|
|
200
200
|
"maturity": "stable"
|
|
201
201
|
},
|
|
202
|
+
{
|
|
203
|
+
"specifier": "@kungfu-tech/buildchain/publication-artifact",
|
|
204
|
+
"export": "./publication-artifact",
|
|
205
|
+
"target": "./packages/core/publication-artifact.js",
|
|
206
|
+
"digest": "sha256:4d00985aa43a98ca0feee872f889251d7b7b2c8f1a6703316ffc27ad4405e423",
|
|
207
|
+
"summary": "Publication artifact manifest, source bundle, and publication passport APIs.",
|
|
208
|
+
"capabilityGroup": "reusable-build",
|
|
209
|
+
"audience": [
|
|
210
|
+
"developer",
|
|
211
|
+
"agent"
|
|
212
|
+
],
|
|
213
|
+
"maturity": "stable"
|
|
214
|
+
},
|
|
202
215
|
{
|
|
203
216
|
"specifier": "@kungfu-tech/buildchain/kfd-gate",
|
|
204
217
|
"export": "./kfd-gate",
|
|
@@ -282,7 +295,7 @@
|
|
|
282
295
|
{
|
|
283
296
|
"id": "cli-and-node-package",
|
|
284
297
|
"path": "docs/cli.md",
|
|
285
|
-
"digest": "sha256:
|
|
298
|
+
"digest": "sha256:35df4de8a3ade449bb577b50ac3000adb2eafe354fd2f885f408ffe6e86d5f19"
|
|
286
299
|
},
|
|
287
300
|
{
|
|
288
301
|
"id": "build-facts",
|