@kungfu-tech/buildchain 2.9.1 → 2.10.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.
- package/bin/buildchain.mjs +131 -0
- package/dist/site/buildchain-contract.json +6 -6
- package/dist/site/buildchain-site.json +83 -14
- package/dist/site/cli-registry.json +36 -0
- package/dist/site/kfd-claims.json +144 -9
- package/dist/site/manual-registry.json +11 -3
- package/dist/site/node-api-registry.json +16 -5
- package/dist/site/page-registry.json +68 -7
- package/dist/site/public-surface-audit.json +119 -5
- package/dist/site/release-provenance.json +1 -0
- package/dist/site/site-manifest.json +15 -7
- package/docs/MAP.md +2 -0
- package/docs/cli.md +18 -0
- package/docs/kfd-support.md +163 -0
- package/docs/web-surface-deployments.md +9 -9
- package/package.json +2 -1
- package/packages/core/buildchain-kfd-claims.js +19 -0
- package/packages/core/index.js +15 -0
- package/packages/core/kfd3-surface-register.js +705 -0
- package/packages/core/public-surface-audit.js +1 -0
- package/scripts/check-inventory.mjs +14 -0
- package/scripts/generate-site-bundle.mjs +7 -0
- package/scripts/web-surface-core.mjs +0 -71
- package/scripts/web-surface.mjs +82 -28
|
@@ -143,6 +143,42 @@
|
|
|
143
143
|
"usage": "buildchain inspect release --passport <file-or-url> [--json]",
|
|
144
144
|
"purpose": "Inspect release passport evidence."
|
|
145
145
|
},
|
|
146
|
+
{
|
|
147
|
+
"id": "kfd-3",
|
|
148
|
+
"source": "bin/buildchain.mjs",
|
|
149
|
+
"usage": "buildchain kfd-3",
|
|
150
|
+
"purpose": "Public Buildchain CLI surface. Add a specific purpose in scripts/generate-site-bundle.mjs when this command graduates."
|
|
151
|
+
},
|
|
152
|
+
{
|
|
153
|
+
"id": "kfd-3-audit",
|
|
154
|
+
"source": "bin/buildchain.mjs",
|
|
155
|
+
"usage": "buildchain kfd-3 audit [--cwd <dir>] [--registry <path>] [--artifact <path>] [--json]",
|
|
156
|
+
"purpose": "Compare detected, declared, and enforced KFD-3 public surfaces."
|
|
157
|
+
},
|
|
158
|
+
{
|
|
159
|
+
"id": "kfd-3-detect",
|
|
160
|
+
"source": "bin/buildchain.mjs",
|
|
161
|
+
"usage": "buildchain kfd-3 detect [--cwd <dir>] [--kind <kind>]... [--artifact <path>] [--json]",
|
|
162
|
+
"purpose": "Detect standard KFD-3 public surface candidates from source and artifact metadata."
|
|
163
|
+
},
|
|
164
|
+
{
|
|
165
|
+
"id": "kfd-3-query",
|
|
166
|
+
"source": "bin/buildchain.mjs",
|
|
167
|
+
"usage": "buildchain kfd-3 query [<product>] [--cwd <dir>] [--registry <path>]",
|
|
168
|
+
"purpose": "Return an agent-readable KFD-3 capability map for a product, registry, or release passport."
|
|
169
|
+
},
|
|
170
|
+
{
|
|
171
|
+
"id": "kfd-3-register",
|
|
172
|
+
"source": "bin/buildchain.mjs",
|
|
173
|
+
"usage": "buildchain kfd-3 register <node-api|python-api|cli|binary|documentation|site-bundle>",
|
|
174
|
+
"purpose": "Declare detected KFD-3 public surfaces into a product-owned surface registry."
|
|
175
|
+
},
|
|
176
|
+
{
|
|
177
|
+
"id": "kfd-3-witness",
|
|
178
|
+
"source": "bin/buildchain.mjs",
|
|
179
|
+
"usage": "buildchain kfd-3 witness [--cwd <dir>] [--registry <path>] [--kind prebuild|artifact]",
|
|
180
|
+
"purpose": "Generate release-passport-compatible KFD-3 surface witnesses from a product registry."
|
|
181
|
+
},
|
|
146
182
|
{
|
|
147
183
|
"id": "lifecycle",
|
|
148
184
|
"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": "55c8c3ee6230e1a91eaf16542e1a7e7d51a9414fc716f1aa29285c6a5e875c2d",
|
|
25
25
|
"summary": {
|
|
26
|
-
"cliCommandCount":
|
|
26
|
+
"cliCommandCount": 52,
|
|
27
27
|
"workflowCount": 35,
|
|
28
28
|
"actionCount": 4,
|
|
29
|
-
"sitePageCount":
|
|
30
|
-
"docCommandRefCount":
|
|
29
|
+
"sitePageCount": 43,
|
|
30
|
+
"docCommandRefCount": 180,
|
|
31
31
|
"failureCount": 0
|
|
32
32
|
},
|
|
33
33
|
"auditBoundary": {
|
|
@@ -92,6 +92,22 @@
|
|
|
92
92
|
"dist/site/kfd-claims.json"
|
|
93
93
|
]
|
|
94
94
|
},
|
|
95
|
+
{
|
|
96
|
+
"id": "claim:buildchain-kfd-3-surface-registration",
|
|
97
|
+
"claim": "Buildchain provides KFD-3 surface detection, registration, audit, witness, and query APIs so products can declare agent-facing public capability surfaces without hand-writing full witness registries.",
|
|
98
|
+
"sourcePaths": [
|
|
99
|
+
"packages/core/kfd3-surface-register.js",
|
|
100
|
+
"bin/buildchain.mjs",
|
|
101
|
+
"docs/kfd-support.md",
|
|
102
|
+
"docs/cli.md"
|
|
103
|
+
],
|
|
104
|
+
"artifactPaths": [
|
|
105
|
+
"dist/site/cli-registry.json",
|
|
106
|
+
"dist/site/node-api-registry.json",
|
|
107
|
+
"dist/site/kfd-claims.json",
|
|
108
|
+
"dist/site/public-surface-audit.json"
|
|
109
|
+
]
|
|
110
|
+
},
|
|
95
111
|
{
|
|
96
112
|
"id": "claim:buildchain-readme-badge-facts",
|
|
97
113
|
"claim": "Buildchain README status badges are generated from repository-owned facts and verified release-passport evidence, not hand-maintained README prose.",
|
|
@@ -190,13 +206,13 @@
|
|
|
190
206
|
"contract": "kungfu-buildchain-public-surface-reverse-audit",
|
|
191
207
|
"path": "dist/site/public-surface-audit.json",
|
|
192
208
|
"status": "passed",
|
|
193
|
-
"sha256": "
|
|
209
|
+
"sha256": "55c8c3ee6230e1a91eaf16542e1a7e7d51a9414fc716f1aa29285c6a5e875c2d",
|
|
194
210
|
"summary": {
|
|
195
|
-
"cliCommandCount":
|
|
211
|
+
"cliCommandCount": 52,
|
|
196
212
|
"workflowCount": 35,
|
|
197
213
|
"actionCount": 4,
|
|
198
|
-
"sitePageCount":
|
|
199
|
-
"docCommandRefCount":
|
|
214
|
+
"sitePageCount": 43,
|
|
215
|
+
"docCommandRefCount": 180,
|
|
200
216
|
"failureCount": 0
|
|
201
217
|
},
|
|
202
218
|
"auditBoundary": {
|
|
@@ -366,6 +382,18 @@
|
|
|
366
382
|
"public": true,
|
|
367
383
|
"plane": "use"
|
|
368
384
|
},
|
|
385
|
+
{
|
|
386
|
+
"id": "doc:docs/kfd-support.md",
|
|
387
|
+
"name": "KFD support and KFD-3 surface registration",
|
|
388
|
+
"kind": "documentation",
|
|
389
|
+
"sourcePath": "docs/kfd-support.md",
|
|
390
|
+
"evidencePath": "docs/kfd-support.md",
|
|
391
|
+
"availability": "shipped",
|
|
392
|
+
"visibility": "public",
|
|
393
|
+
"participantFacing": true,
|
|
394
|
+
"public": true,
|
|
395
|
+
"plane": "verify"
|
|
396
|
+
},
|
|
369
397
|
{
|
|
370
398
|
"id": "doc:docs/lifecycle-protocol.md",
|
|
371
399
|
"name": "Lifecycle protocol",
|
|
@@ -748,6 +776,17 @@
|
|
|
748
776
|
"participantFacing": true,
|
|
749
777
|
"public": true
|
|
750
778
|
},
|
|
779
|
+
{
|
|
780
|
+
"id": "schema:packages/core/kfd3-surface-register.js",
|
|
781
|
+
"name": "schema:packages/core/kfd3-surface-register.js",
|
|
782
|
+
"kind": "schema",
|
|
783
|
+
"sourcePath": "packages/core/kfd3-surface-register.js",
|
|
784
|
+
"evidencePath": "packages/core/kfd3-surface-register.js",
|
|
785
|
+
"availability": "shipped",
|
|
786
|
+
"visibility": "public",
|
|
787
|
+
"participantFacing": true,
|
|
788
|
+
"public": true
|
|
789
|
+
},
|
|
751
790
|
{
|
|
752
791
|
"id": "schema:packages/core/public-surface-audit.js",
|
|
753
792
|
"name": "schema:packages/core/public-surface-audit.js",
|
|
@@ -937,6 +976,18 @@
|
|
|
937
976
|
"public": true,
|
|
938
977
|
"packageExport": "./issue-reporting"
|
|
939
978
|
},
|
|
979
|
+
{
|
|
980
|
+
"id": "export:./kfd-3-surfaces",
|
|
981
|
+
"name": "@kungfu-tech/buildchain/kfd-3-surfaces",
|
|
982
|
+
"kind": "package-export",
|
|
983
|
+
"sourcePath": "packages/core/kfd3-surface-register.js",
|
|
984
|
+
"evidencePath": "packages/core/kfd3-surface-register.js",
|
|
985
|
+
"availability": "shipped",
|
|
986
|
+
"visibility": "public",
|
|
987
|
+
"participantFacing": true,
|
|
988
|
+
"public": true,
|
|
989
|
+
"packageExport": "./kfd-3-surfaces"
|
|
990
|
+
},
|
|
940
991
|
{
|
|
941
992
|
"id": "export:./release-line-bootstrap",
|
|
942
993
|
"name": "@kungfu-tech/buildchain/release-line-bootstrap",
|
|
@@ -1502,6 +1553,78 @@
|
|
|
1502
1553
|
"public": true,
|
|
1503
1554
|
"reverseAuditSource": "bin/buildchain.mjs"
|
|
1504
1555
|
},
|
|
1556
|
+
{
|
|
1557
|
+
"id": "cli:kfd-3",
|
|
1558
|
+
"name": "buildchain kfd-3",
|
|
1559
|
+
"kind": "cli-command",
|
|
1560
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
1561
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
1562
|
+
"availability": "shipped",
|
|
1563
|
+
"visibility": "public",
|
|
1564
|
+
"participantFacing": true,
|
|
1565
|
+
"public": true,
|
|
1566
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
1567
|
+
},
|
|
1568
|
+
{
|
|
1569
|
+
"id": "cli:kfd-3-audit",
|
|
1570
|
+
"name": "buildchain kfd-3 audit [--cwd <dir>] [--registry <path>] [--artifact <path>] [--json]",
|
|
1571
|
+
"kind": "cli-command",
|
|
1572
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
1573
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
1574
|
+
"availability": "shipped",
|
|
1575
|
+
"visibility": "public",
|
|
1576
|
+
"participantFacing": true,
|
|
1577
|
+
"public": true,
|
|
1578
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
1579
|
+
},
|
|
1580
|
+
{
|
|
1581
|
+
"id": "cli:kfd-3-detect",
|
|
1582
|
+
"name": "buildchain kfd-3 detect [--cwd <dir>] [--kind <kind>]... [--artifact <path>] [--json]",
|
|
1583
|
+
"kind": "cli-command",
|
|
1584
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
1585
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
1586
|
+
"availability": "shipped",
|
|
1587
|
+
"visibility": "public",
|
|
1588
|
+
"participantFacing": true,
|
|
1589
|
+
"public": true,
|
|
1590
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
1591
|
+
},
|
|
1592
|
+
{
|
|
1593
|
+
"id": "cli:kfd-3-query",
|
|
1594
|
+
"name": "buildchain kfd-3 query [<product>] [--cwd <dir>] [--registry <path>]",
|
|
1595
|
+
"kind": "cli-command",
|
|
1596
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
1597
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
1598
|
+
"availability": "shipped",
|
|
1599
|
+
"visibility": "public",
|
|
1600
|
+
"participantFacing": true,
|
|
1601
|
+
"public": true,
|
|
1602
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
1603
|
+
},
|
|
1604
|
+
{
|
|
1605
|
+
"id": "cli:kfd-3-register",
|
|
1606
|
+
"name": "buildchain kfd-3 register <node-api|python-api|cli|binary|documentation|site-bundle>",
|
|
1607
|
+
"kind": "cli-command",
|
|
1608
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
1609
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
1610
|
+
"availability": "shipped",
|
|
1611
|
+
"visibility": "public",
|
|
1612
|
+
"participantFacing": true,
|
|
1613
|
+
"public": true,
|
|
1614
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
1615
|
+
},
|
|
1616
|
+
{
|
|
1617
|
+
"id": "cli:kfd-3-witness",
|
|
1618
|
+
"name": "buildchain kfd-3 witness [--cwd <dir>] [--registry <path>] [--kind prebuild|artifact]",
|
|
1619
|
+
"kind": "cli-command",
|
|
1620
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
1621
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
1622
|
+
"availability": "shipped",
|
|
1623
|
+
"visibility": "public",
|
|
1624
|
+
"participantFacing": true,
|
|
1625
|
+
"public": true,
|
|
1626
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
1627
|
+
},
|
|
1505
1628
|
{
|
|
1506
1629
|
"id": "cli:lifecycle",
|
|
1507
1630
|
"name": "buildchain lifecycle run <stage> [--cwd <dir>] [--required]",
|
|
@@ -3069,6 +3192,18 @@
|
|
|
3069
3192
|
"public": true,
|
|
3070
3193
|
"reverseAuditSource": "dist/site/page-registry.json"
|
|
3071
3194
|
},
|
|
3195
|
+
{
|
|
3196
|
+
"id": "site-page:manual:kfd-support",
|
|
3197
|
+
"name": "site-page:manual:kfd-support",
|
|
3198
|
+
"kind": "site-page",
|
|
3199
|
+
"sourcePath": "dist/site/page-registry.json",
|
|
3200
|
+
"evidencePath": "dist/site/page-registry.json",
|
|
3201
|
+
"availability": "shipped",
|
|
3202
|
+
"visibility": "public",
|
|
3203
|
+
"participantFacing": true,
|
|
3204
|
+
"public": true,
|
|
3205
|
+
"reverseAuditSource": "dist/site/page-registry.json"
|
|
3206
|
+
},
|
|
3072
3207
|
{
|
|
3073
3208
|
"id": "site-page:manual:lifecycle-protocol",
|
|
3074
3209
|
"name": "site-page:manual:lifecycle-protocol",
|
|
@@ -3367,6 +3502,6 @@
|
|
|
3367
3502
|
"public": true
|
|
3368
3503
|
}
|
|
3369
3504
|
],
|
|
3370
|
-
"publicSurfaceCount":
|
|
3505
|
+
"publicSurfaceCount": 229
|
|
3371
3506
|
}
|
|
3372
3507
|
}
|
|
@@ -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:3712026dcfcf44c16bc4def2acf246caee1ec036543c0fea265fa17b19d4de31"
|
|
13
13
|
},
|
|
14
14
|
{
|
|
15
15
|
"id": "install",
|
|
@@ -107,7 +107,7 @@
|
|
|
107
107
|
"title": "CLI and npm package",
|
|
108
108
|
"path": "docs/cli.md",
|
|
109
109
|
"plane": "use",
|
|
110
|
-
"digest": "sha256:
|
|
110
|
+
"digest": "sha256:85e014b7e053b74b620e5b438d54453e20b22f758a33dfd5ae970403fa41d9d7"
|
|
111
111
|
},
|
|
112
112
|
{
|
|
113
113
|
"id": "build-facts",
|
|
@@ -116,6 +116,13 @@
|
|
|
116
116
|
"plane": "use",
|
|
117
117
|
"digest": "sha256:75dcf7a6628dac9e982a455de9966044ae771611d4efc04e7264a2d4adb0bd3e"
|
|
118
118
|
},
|
|
119
|
+
{
|
|
120
|
+
"id": "kfd-support",
|
|
121
|
+
"title": "KFD support and KFD-3 surface registration",
|
|
122
|
+
"path": "docs/kfd-support.md",
|
|
123
|
+
"plane": "verify",
|
|
124
|
+
"digest": "sha256:4bb33e408a2129e1534e92bea78d3cc0e4d8f986b0fbb27fe73ae6eae46b9ca3"
|
|
125
|
+
},
|
|
119
126
|
{
|
|
120
127
|
"id": "lifecycle-protocol",
|
|
121
128
|
"title": "Lifecycle protocol",
|
|
@@ -170,7 +177,7 @@
|
|
|
170
177
|
"title": "Web surface deployments",
|
|
171
178
|
"path": "docs/web-surface-deployments.md",
|
|
172
179
|
"plane": "use",
|
|
173
|
-
"digest": "sha256:
|
|
180
|
+
"digest": "sha256:8ba3ab4715844df2d5ca07121cde4875f89be55bb44be27d63bae404611f3112"
|
|
174
181
|
}
|
|
175
182
|
],
|
|
176
183
|
"requiredAgentManuals": [
|
|
@@ -178,6 +185,7 @@
|
|
|
178
185
|
"docs/install.md",
|
|
179
186
|
"docs/cli.md",
|
|
180
187
|
"docs/build-facts.md",
|
|
188
|
+
"docs/kfd-support.md",
|
|
181
189
|
"docs/reusable-build-surface.md",
|
|
182
190
|
"docs/release-candidate.md",
|
|
183
191
|
"docs/release-governance.md",
|
|
@@ -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:91dac9241f8e9aa02df360a0720d3998cf8eca27910517d8afabcb4a97e019e1"
|
|
12
12
|
},
|
|
13
13
|
{
|
|
14
14
|
"specifier": "@kungfu-tech/buildchain/badges",
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
"specifier": "@kungfu-tech/buildchain/core",
|
|
27
27
|
"export": "./core",
|
|
28
28
|
"target": "./packages/core/index.js",
|
|
29
|
-
"digest": "sha256:
|
|
29
|
+
"digest": "sha256:91dac9241f8e9aa02df360a0720d3998cf8eca27910517d8afabcb4a97e019e1"
|
|
30
30
|
},
|
|
31
31
|
{
|
|
32
32
|
"specifier": "@kungfu-tech/buildchain/artifact-passport",
|
|
@@ -58,6 +58,12 @@
|
|
|
58
58
|
"target": "./packages/core/issue-reporting.js",
|
|
59
59
|
"digest": "sha256:d6e0a450a52b7a4fba84bff855d5370e0cfa2ec3c4be737b3c9099a72f705e2d"
|
|
60
60
|
},
|
|
61
|
+
{
|
|
62
|
+
"specifier": "@kungfu-tech/buildchain/kfd-3-surfaces",
|
|
63
|
+
"export": "./kfd-3-surfaces",
|
|
64
|
+
"target": "./packages/core/kfd3-surface-register.js",
|
|
65
|
+
"digest": "sha256:dc0d041257e0080147fbaa0a2d61e7f0a7ec3031a94311c58ea6b3e0fb78c18b"
|
|
66
|
+
},
|
|
61
67
|
{
|
|
62
68
|
"specifier": "@kungfu-tech/buildchain/release-line-bootstrap",
|
|
63
69
|
"export": "./release-line-bootstrap",
|
|
@@ -74,7 +80,7 @@
|
|
|
74
80
|
"specifier": "@kungfu-tech/buildchain/public-surface-audit",
|
|
75
81
|
"export": "./public-surface-audit",
|
|
76
82
|
"target": "./packages/core/public-surface-audit.js",
|
|
77
|
-
"digest": "sha256:
|
|
83
|
+
"digest": "sha256:c9fbbfa5a4d78ff4bfb4b5570fedc5dcfc9e0a43f01ac5c3bbc2298d086a6346"
|
|
78
84
|
},
|
|
79
85
|
{
|
|
80
86
|
"specifier": "@kungfu-tech/buildchain/logging",
|
|
@@ -116,20 +122,25 @@
|
|
|
116
122
|
"specifier": "@kungfu-tech/buildchain/buildchain-kfd-claims",
|
|
117
123
|
"export": "./buildchain-kfd-claims",
|
|
118
124
|
"target": "./packages/core/buildchain-kfd-claims.js",
|
|
119
|
-
"digest": "sha256:
|
|
125
|
+
"digest": "sha256:223fcf5de2b2c0dd31012d6ed2f27187d2a5472a5ccede5884eb15ae6d43dffc"
|
|
120
126
|
}
|
|
121
127
|
],
|
|
122
128
|
"docs": [
|
|
123
129
|
{
|
|
124
130
|
"id": "cli-and-node-package",
|
|
125
131
|
"path": "docs/cli.md",
|
|
126
|
-
"digest": "sha256:
|
|
132
|
+
"digest": "sha256:85e014b7e053b74b620e5b438d54453e20b22f758a33dfd5ae970403fa41d9d7"
|
|
127
133
|
},
|
|
128
134
|
{
|
|
129
135
|
"id": "build-facts",
|
|
130
136
|
"path": "docs/build-facts.md",
|
|
131
137
|
"digest": "sha256:75dcf7a6628dac9e982a455de9966044ae771611d4efc04e7264a2d4adb0bd3e"
|
|
132
138
|
},
|
|
139
|
+
{
|
|
140
|
+
"id": "kfd-support",
|
|
141
|
+
"path": "docs/kfd-support.md",
|
|
142
|
+
"digest": "sha256:4bb33e408a2129e1534e92bea78d3cc0e4d8f986b0fbb27fe73ae6eae46b9ca3"
|
|
143
|
+
},
|
|
133
144
|
{
|
|
134
145
|
"id": "readme-badges",
|
|
135
146
|
"path": "docs/readme-badges.md",
|