@kungfu-tech/buildchain 2.10.2 → 2.10.3
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/dist/site/agent-index.json +1 -0
- package/dist/site/artifact-schemas.json +1 -0
- package/dist/site/buildchain-contract.json +4 -4
- package/dist/site/buildchain-site.json +296 -16
- package/dist/site/capability-registry.json +302 -0
- package/dist/site/cli-registry.json +364 -52
- package/dist/site/kfd-claims.json +27 -3
- package/dist/site/manual-registry.json +210 -25
- package/dist/site/node-api-registry.json +162 -22
- package/dist/site/page-registry.json +273 -8
- package/dist/site/public-surface-audit.json +3 -3
- package/dist/site/release-provenance.json +1 -0
- package/dist/site/site-manifest.json +17 -8
- package/dist/site/workflow-registry.json +39 -0
- package/docs/MAP.md +19 -0
- package/docs/cli.md +5 -0
- package/docs/site-bundle-contract.md +9 -0
- package/docs/web-surface-deployments.md +18 -0
- package/package.json +2 -1
- package/packages/core/buildchain-kfd-claims.js +3 -0
- package/scripts/check-inventory.mjs +43 -2
- package/scripts/generate-site-bundle.mjs +352 -59
- package/scripts/web-surface-core.mjs +147 -0
- package/scripts/web-surface.mjs +16 -1
|
@@ -9,313 +9,625 @@
|
|
|
9
9
|
"id": "badges",
|
|
10
10
|
"source": "bin/buildchain.mjs",
|
|
11
11
|
"usage": "buildchain badges",
|
|
12
|
-
"purpose": "
|
|
12
|
+
"purpose": "Inspect README badge command families.",
|
|
13
|
+
"capabilityGroup": "distribution-indexes",
|
|
14
|
+
"audience": [
|
|
15
|
+
"agent",
|
|
16
|
+
"operator"
|
|
17
|
+
],
|
|
18
|
+
"maturity": "stable"
|
|
13
19
|
},
|
|
14
20
|
{
|
|
15
21
|
"id": "badges-bundle",
|
|
16
22
|
"source": "bin/buildchain.mjs",
|
|
17
23
|
"usage": "buildchain badges bundle [--cwd <dir>] [--readme <path>] [--claims <csv>] [--check] [--write] [--json]",
|
|
18
|
-
"purpose": "Generate or verify the combined KFD and Release Passport badge bundle."
|
|
24
|
+
"purpose": "Generate or verify the combined KFD and Release Passport badge bundle.",
|
|
25
|
+
"capabilityGroup": "distribution-indexes",
|
|
26
|
+
"audience": [
|
|
27
|
+
"agent",
|
|
28
|
+
"operator"
|
|
29
|
+
],
|
|
30
|
+
"maturity": "stable"
|
|
19
31
|
},
|
|
20
32
|
{
|
|
21
33
|
"id": "badges-readme",
|
|
22
34
|
"source": "bin/buildchain.mjs",
|
|
23
35
|
"usage": "buildchain badges readme [--cwd <dir>] [--readme <path>] [--check] [--write] [--json]",
|
|
24
|
-
"purpose": "Generate or verify managed README badge blocks."
|
|
36
|
+
"purpose": "Generate or verify managed README badge blocks.",
|
|
37
|
+
"capabilityGroup": "distribution-indexes",
|
|
38
|
+
"audience": [
|
|
39
|
+
"agent",
|
|
40
|
+
"operator"
|
|
41
|
+
],
|
|
42
|
+
"maturity": "stable"
|
|
25
43
|
},
|
|
26
44
|
{
|
|
27
45
|
"id": "build-contract",
|
|
28
46
|
"source": "bin/buildchain.mjs",
|
|
29
47
|
"usage": "buildchain build-contract ...",
|
|
30
|
-
"purpose": "Resolve Buildchain runtime contract metadata."
|
|
48
|
+
"purpose": "Resolve Buildchain runtime contract metadata for floating-ref drift checks.",
|
|
49
|
+
"capabilityGroup": "governance-versioning",
|
|
50
|
+
"audience": [
|
|
51
|
+
"agent",
|
|
52
|
+
"operator"
|
|
53
|
+
],
|
|
54
|
+
"maturity": "stable"
|
|
31
55
|
},
|
|
32
56
|
{
|
|
33
57
|
"id": "build-facts",
|
|
34
58
|
"source": "bin/buildchain.mjs",
|
|
35
59
|
"usage": "buildchain facts module [--cwd <dir>] [--module <id>] [--module-root <path>]",
|
|
36
|
-
"purpose": "Collect and verify Git source, version, module output, product artifact, and legacy Kungfu buildinfo facts."
|
|
60
|
+
"purpose": "Collect and verify Git source, version, module output, product artifact, and legacy Kungfu buildinfo facts.",
|
|
61
|
+
"capabilityGroup": "observability-diagnostics",
|
|
62
|
+
"audience": [
|
|
63
|
+
"agent",
|
|
64
|
+
"operator"
|
|
65
|
+
],
|
|
66
|
+
"maturity": "stable"
|
|
37
67
|
},
|
|
38
68
|
{
|
|
39
69
|
"id": "collect",
|
|
40
70
|
"source": "bin/buildchain.mjs",
|
|
41
71
|
"usage": "buildchain collect",
|
|
42
|
-
"purpose": "
|
|
72
|
+
"purpose": "Inspect release evidence collection command families.",
|
|
73
|
+
"capabilityGroup": "release-passport-trust",
|
|
74
|
+
"audience": [
|
|
75
|
+
"agent",
|
|
76
|
+
"operator"
|
|
77
|
+
],
|
|
78
|
+
"maturity": "stable"
|
|
43
79
|
},
|
|
44
80
|
{
|
|
45
81
|
"id": "collect-github-release",
|
|
46
82
|
"source": "bin/buildchain.mjs",
|
|
47
83
|
"usage": "buildchain collect github-release --tag <tag> [--repository <owner/repo>]",
|
|
48
|
-
"purpose": "Collect
|
|
84
|
+
"purpose": "Collect GitHub Release assets into a release passport.",
|
|
85
|
+
"capabilityGroup": "release-passport-trust",
|
|
86
|
+
"audience": [
|
|
87
|
+
"agent",
|
|
88
|
+
"operator"
|
|
89
|
+
],
|
|
90
|
+
"maturity": "stable"
|
|
49
91
|
},
|
|
50
92
|
{
|
|
51
93
|
"id": "diagnostics",
|
|
52
94
|
"source": "bin/buildchain.mjs",
|
|
53
95
|
"usage": "buildchain diagnostics",
|
|
54
|
-
"purpose": "
|
|
96
|
+
"purpose": "Inspect diagnostics command families.",
|
|
97
|
+
"capabilityGroup": "observability-diagnostics",
|
|
98
|
+
"audience": [
|
|
99
|
+
"agent",
|
|
100
|
+
"operator"
|
|
101
|
+
],
|
|
102
|
+
"maturity": "stable"
|
|
55
103
|
},
|
|
56
104
|
{
|
|
57
105
|
"id": "diagnostics-summary",
|
|
58
106
|
"source": "bin/buildchain.mjs",
|
|
59
107
|
"usage": "buildchain diagnostics summary <diagnostics.json>... [--artifact <file>]...",
|
|
60
|
-
"purpose": "Summarize diagnostics artifacts into JSON and cross-platform lifecycle timing tables."
|
|
108
|
+
"purpose": "Summarize diagnostics artifacts into JSON and cross-platform lifecycle timing tables.",
|
|
109
|
+
"capabilityGroup": "observability-diagnostics",
|
|
110
|
+
"audience": [
|
|
111
|
+
"agent",
|
|
112
|
+
"operator"
|
|
113
|
+
],
|
|
114
|
+
"maturity": "stable"
|
|
61
115
|
},
|
|
62
116
|
{
|
|
63
117
|
"id": "doctor",
|
|
64
118
|
"source": "bin/buildchain.mjs",
|
|
65
119
|
"usage": "buildchain doctor [--cwd <dir>] [--require-publish-source-lock] [--json]",
|
|
66
|
-
"purpose": "Report local integration readiness."
|
|
120
|
+
"purpose": "Report local integration readiness.",
|
|
121
|
+
"capabilityGroup": "getting-started",
|
|
122
|
+
"audience": [
|
|
123
|
+
"agent",
|
|
124
|
+
"operator"
|
|
125
|
+
],
|
|
126
|
+
"maturity": "stable"
|
|
67
127
|
},
|
|
68
128
|
{
|
|
69
129
|
"id": "explain",
|
|
70
130
|
"source": "bin/buildchain.mjs",
|
|
71
131
|
"usage": "buildchain explain",
|
|
72
|
-
"purpose": "
|
|
132
|
+
"purpose": "Inspect release and artifact explanation command families.",
|
|
133
|
+
"capabilityGroup": "release-passport-trust",
|
|
134
|
+
"audience": [
|
|
135
|
+
"agent",
|
|
136
|
+
"operator"
|
|
137
|
+
],
|
|
138
|
+
"maturity": "stable"
|
|
73
139
|
},
|
|
74
140
|
{
|
|
75
141
|
"id": "explain-artifact",
|
|
76
142
|
"source": "bin/buildchain.mjs",
|
|
77
143
|
"usage": "buildchain explain artifact <subject> [--passport <file-or-url>] [--for human|agent] [--json]",
|
|
78
|
-
"purpose": "Explain artifact evidence for humans or agents."
|
|
144
|
+
"purpose": "Explain artifact evidence for humans or agents.",
|
|
145
|
+
"capabilityGroup": "release-passport-trust",
|
|
146
|
+
"audience": [
|
|
147
|
+
"agent",
|
|
148
|
+
"operator"
|
|
149
|
+
],
|
|
150
|
+
"maturity": "stable"
|
|
79
151
|
},
|
|
80
152
|
{
|
|
81
153
|
"id": "explain-release",
|
|
82
154
|
"source": "bin/buildchain.mjs",
|
|
83
155
|
"usage": "buildchain explain release --passport <file-or-url> [--for human|agent] [--json]",
|
|
84
|
-
"purpose": "Explain a release passport for humans or agents."
|
|
156
|
+
"purpose": "Explain a release passport for humans or agents.",
|
|
157
|
+
"capabilityGroup": "release-passport-trust",
|
|
158
|
+
"audience": [
|
|
159
|
+
"agent",
|
|
160
|
+
"operator"
|
|
161
|
+
],
|
|
162
|
+
"maturity": "stable"
|
|
85
163
|
},
|
|
86
164
|
{
|
|
87
165
|
"id": "facts",
|
|
88
166
|
"source": "bin/buildchain.mjs",
|
|
89
167
|
"usage": "buildchain facts",
|
|
90
|
-
"purpose": "
|
|
168
|
+
"purpose": "Inspect build facts command families.",
|
|
169
|
+
"capabilityGroup": "observability-diagnostics",
|
|
170
|
+
"audience": [
|
|
171
|
+
"agent",
|
|
172
|
+
"operator"
|
|
173
|
+
],
|
|
174
|
+
"maturity": "stable"
|
|
91
175
|
},
|
|
92
176
|
{
|
|
93
177
|
"id": "help",
|
|
94
178
|
"source": "bin/buildchain.mjs",
|
|
95
179
|
"usage": "buildchain --help",
|
|
96
|
-
"purpose": "Print Buildchain CLI help."
|
|
180
|
+
"purpose": "Print Buildchain CLI help.",
|
|
181
|
+
"capabilityGroup": "getting-started",
|
|
182
|
+
"audience": [
|
|
183
|
+
"agent",
|
|
184
|
+
"operator"
|
|
185
|
+
],
|
|
186
|
+
"maturity": "stable"
|
|
97
187
|
},
|
|
98
188
|
{
|
|
99
189
|
"id": "homebrew",
|
|
100
190
|
"source": "bin/buildchain.mjs",
|
|
101
191
|
"usage": "buildchain homebrew",
|
|
102
|
-
"purpose": "
|
|
192
|
+
"purpose": "Inspect Homebrew distribution-index command families.",
|
|
193
|
+
"capabilityGroup": "distribution-indexes",
|
|
194
|
+
"audience": [
|
|
195
|
+
"agent",
|
|
196
|
+
"operator"
|
|
197
|
+
],
|
|
198
|
+
"maturity": "stable"
|
|
103
199
|
},
|
|
104
200
|
{
|
|
105
201
|
"id": "homebrew-check",
|
|
106
202
|
"source": "bin/buildchain.mjs",
|
|
107
203
|
"usage": "buildchain homebrew check [--cwd <dir>] [--package <name>] [--release-passport <file-or-url>] [--json]",
|
|
108
|
-
"purpose": "Verify Homebrew tap metadata against upstream release passport evidence."
|
|
204
|
+
"purpose": "Verify Homebrew tap metadata against upstream release passport evidence.",
|
|
205
|
+
"capabilityGroup": "distribution-indexes",
|
|
206
|
+
"audience": [
|
|
207
|
+
"agent",
|
|
208
|
+
"operator"
|
|
209
|
+
],
|
|
210
|
+
"maturity": "stable"
|
|
109
211
|
},
|
|
110
212
|
{
|
|
111
213
|
"id": "homebrew-update-formula",
|
|
112
214
|
"source": "bin/buildchain.mjs",
|
|
113
215
|
"usage": "buildchain homebrew update-formula --package <name> --release-passport <file-or-url> [--write] [--json]",
|
|
114
|
-
"purpose": "Generate Homebrew Formula metadata from upstream release passport evidence."
|
|
216
|
+
"purpose": "Generate Homebrew Formula metadata from upstream release passport evidence.",
|
|
217
|
+
"capabilityGroup": "distribution-indexes",
|
|
218
|
+
"audience": [
|
|
219
|
+
"agent",
|
|
220
|
+
"operator"
|
|
221
|
+
],
|
|
222
|
+
"maturity": "stable"
|
|
115
223
|
},
|
|
116
224
|
{
|
|
117
225
|
"id": "infra-contract",
|
|
118
226
|
"source": "bin/buildchain.mjs",
|
|
119
227
|
"usage": "buildchain infra-contract ...",
|
|
120
|
-
"purpose": "Validate and publish provider-neutral infrastructure contract evidence."
|
|
228
|
+
"purpose": "Validate and publish provider-neutral infrastructure contract evidence.",
|
|
229
|
+
"capabilityGroup": "governance-versioning",
|
|
230
|
+
"audience": [
|
|
231
|
+
"agent",
|
|
232
|
+
"operator"
|
|
233
|
+
],
|
|
234
|
+
"maturity": "stable"
|
|
121
235
|
},
|
|
122
236
|
{
|
|
123
237
|
"id": "init",
|
|
124
238
|
"source": "bin/buildchain.mjs",
|
|
125
239
|
"usage": "buildchain init [--cwd <dir>] [--type package|native|web-surface|infra-contract|anchored-package] [--force]",
|
|
126
|
-
"purpose": "Bootstrap a repository with Buildchain configuration and caller workflow files."
|
|
240
|
+
"purpose": "Bootstrap a repository with Buildchain configuration and caller workflow files.",
|
|
241
|
+
"capabilityGroup": "getting-started",
|
|
242
|
+
"audience": [
|
|
243
|
+
"agent",
|
|
244
|
+
"operator"
|
|
245
|
+
],
|
|
246
|
+
"maturity": "stable"
|
|
127
247
|
},
|
|
128
248
|
{
|
|
129
249
|
"id": "inspect",
|
|
130
250
|
"source": "bin/buildchain.mjs",
|
|
131
251
|
"usage": "buildchain inspect",
|
|
132
|
-
"purpose": "
|
|
252
|
+
"purpose": "Inspect release and artifact evidence command families.",
|
|
253
|
+
"capabilityGroup": "release-passport-trust",
|
|
254
|
+
"audience": [
|
|
255
|
+
"agent",
|
|
256
|
+
"operator"
|
|
257
|
+
],
|
|
258
|
+
"maturity": "stable"
|
|
133
259
|
},
|
|
134
260
|
{
|
|
135
261
|
"id": "inspect-artifact",
|
|
136
262
|
"source": "bin/buildchain.mjs",
|
|
137
263
|
"usage": "buildchain inspect artifact <subject> [--passport <file-or-url>] [--json]",
|
|
138
|
-
"purpose": "Inspect artifact evidence."
|
|
264
|
+
"purpose": "Inspect artifact evidence.",
|
|
265
|
+
"capabilityGroup": "release-passport-trust",
|
|
266
|
+
"audience": [
|
|
267
|
+
"agent",
|
|
268
|
+
"operator"
|
|
269
|
+
],
|
|
270
|
+
"maturity": "stable"
|
|
139
271
|
},
|
|
140
272
|
{
|
|
141
273
|
"id": "inspect-release",
|
|
142
274
|
"source": "bin/buildchain.mjs",
|
|
143
275
|
"usage": "buildchain inspect release --passport <file-or-url> [--json]",
|
|
144
|
-
"purpose": "Inspect release passport evidence."
|
|
276
|
+
"purpose": "Inspect release passport evidence.",
|
|
277
|
+
"capabilityGroup": "release-passport-trust",
|
|
278
|
+
"audience": [
|
|
279
|
+
"agent",
|
|
280
|
+
"operator"
|
|
281
|
+
],
|
|
282
|
+
"maturity": "stable"
|
|
145
283
|
},
|
|
146
284
|
{
|
|
147
285
|
"id": "kfd-3",
|
|
148
286
|
"source": "bin/buildchain.mjs",
|
|
149
287
|
"usage": "buildchain kfd-3",
|
|
150
|
-
"purpose": "
|
|
288
|
+
"purpose": "Inspect KFD-3 surface detection, registry, witness, audit, and query command families.",
|
|
289
|
+
"capabilityGroup": "kfd-trust",
|
|
290
|
+
"audience": [
|
|
291
|
+
"agent",
|
|
292
|
+
"operator"
|
|
293
|
+
],
|
|
294
|
+
"maturity": "stable"
|
|
151
295
|
},
|
|
152
296
|
{
|
|
153
297
|
"id": "kfd-3-audit",
|
|
154
298
|
"source": "bin/buildchain.mjs",
|
|
155
299
|
"usage": "buildchain kfd-3 audit [--cwd <dir>] [--registry <path>] [--artifact <path>] [--json]",
|
|
156
|
-
"purpose": "Compare detected, declared, and enforced KFD-3 public surfaces."
|
|
300
|
+
"purpose": "Compare detected, declared, and enforced KFD-3 public surfaces.",
|
|
301
|
+
"capabilityGroup": "kfd-trust",
|
|
302
|
+
"audience": [
|
|
303
|
+
"agent",
|
|
304
|
+
"operator"
|
|
305
|
+
],
|
|
306
|
+
"maturity": "stable"
|
|
157
307
|
},
|
|
158
308
|
{
|
|
159
309
|
"id": "kfd-3-detect",
|
|
160
310
|
"source": "bin/buildchain.mjs",
|
|
161
311
|
"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."
|
|
312
|
+
"purpose": "Detect standard KFD-3 public surface candidates from source and artifact metadata.",
|
|
313
|
+
"capabilityGroup": "kfd-trust",
|
|
314
|
+
"audience": [
|
|
315
|
+
"agent",
|
|
316
|
+
"operator"
|
|
317
|
+
],
|
|
318
|
+
"maturity": "stable"
|
|
163
319
|
},
|
|
164
320
|
{
|
|
165
321
|
"id": "kfd-3-query",
|
|
166
322
|
"source": "bin/buildchain.mjs",
|
|
167
323
|
"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."
|
|
324
|
+
"purpose": "Return an agent-readable KFD-3 capability map for a product, registry, or release passport.",
|
|
325
|
+
"capabilityGroup": "kfd-trust",
|
|
326
|
+
"audience": [
|
|
327
|
+
"agent",
|
|
328
|
+
"operator"
|
|
329
|
+
],
|
|
330
|
+
"maturity": "stable"
|
|
169
331
|
},
|
|
170
332
|
{
|
|
171
333
|
"id": "kfd-3-register",
|
|
172
334
|
"source": "bin/buildchain.mjs",
|
|
173
335
|
"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."
|
|
336
|
+
"purpose": "Declare detected KFD-3 public surfaces into a product-owned surface registry.",
|
|
337
|
+
"capabilityGroup": "kfd-trust",
|
|
338
|
+
"audience": [
|
|
339
|
+
"agent",
|
|
340
|
+
"operator"
|
|
341
|
+
],
|
|
342
|
+
"maturity": "stable"
|
|
175
343
|
},
|
|
176
344
|
{
|
|
177
345
|
"id": "kfd-3-witness",
|
|
178
346
|
"source": "bin/buildchain.mjs",
|
|
179
347
|
"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."
|
|
348
|
+
"purpose": "Generate release-passport-compatible KFD-3 surface witnesses from a product registry.",
|
|
349
|
+
"capabilityGroup": "kfd-trust",
|
|
350
|
+
"audience": [
|
|
351
|
+
"agent",
|
|
352
|
+
"operator"
|
|
353
|
+
],
|
|
354
|
+
"maturity": "stable"
|
|
181
355
|
},
|
|
182
356
|
{
|
|
183
357
|
"id": "lifecycle",
|
|
184
358
|
"source": "bin/buildchain.mjs",
|
|
185
359
|
"usage": "buildchain lifecycle run <stage> [--cwd <dir>] [--required]",
|
|
186
|
-
"purpose": "Run configured lifecycle commands and write deterministic artifact manifests."
|
|
360
|
+
"purpose": "Run configured lifecycle commands and write deterministic artifact manifests.",
|
|
361
|
+
"capabilityGroup": "reusable-build",
|
|
362
|
+
"audience": [
|
|
363
|
+
"agent",
|
|
364
|
+
"operator"
|
|
365
|
+
],
|
|
366
|
+
"maturity": "stable"
|
|
187
367
|
},
|
|
188
368
|
{
|
|
189
369
|
"id": "log",
|
|
190
370
|
"source": "bin/buildchain.mjs",
|
|
191
371
|
"usage": "buildchain log",
|
|
192
|
-
"purpose": "
|
|
372
|
+
"purpose": "Inspect Buildchain logging command families.",
|
|
373
|
+
"capabilityGroup": "observability-diagnostics",
|
|
374
|
+
"audience": [
|
|
375
|
+
"agent",
|
|
376
|
+
"operator"
|
|
377
|
+
],
|
|
378
|
+
"maturity": "stable"
|
|
193
379
|
},
|
|
194
380
|
{
|
|
195
381
|
"id": "logging",
|
|
196
382
|
"source": "bin/buildchain.mjs",
|
|
197
383
|
"usage": "buildchain log <info|warn|error> --event <name> [--phase <phase>]",
|
|
198
|
-
"purpose": "Emit timestamped build events, summarize logs, and enforce required phases."
|
|
384
|
+
"purpose": "Emit timestamped build events, summarize logs, and enforce required phases.",
|
|
385
|
+
"capabilityGroup": "observability-diagnostics",
|
|
386
|
+
"audience": [
|
|
387
|
+
"agent",
|
|
388
|
+
"operator"
|
|
389
|
+
],
|
|
390
|
+
"maturity": "stable"
|
|
199
391
|
},
|
|
200
392
|
{
|
|
201
393
|
"id": "mark",
|
|
202
394
|
"source": "bin/buildchain.mjs",
|
|
203
395
|
"usage": "buildchain mark --event <name> [--phase <phase>] [--component <name>]",
|
|
204
|
-
"purpose": "Emit a single Buildchain log event."
|
|
396
|
+
"purpose": "Emit a single Buildchain log event.",
|
|
397
|
+
"capabilityGroup": "observability-diagnostics",
|
|
398
|
+
"audience": [
|
|
399
|
+
"agent",
|
|
400
|
+
"operator"
|
|
401
|
+
],
|
|
402
|
+
"maturity": "stable"
|
|
205
403
|
},
|
|
206
404
|
{
|
|
207
405
|
"id": "npm",
|
|
208
406
|
"source": "bin/buildchain.mjs",
|
|
209
407
|
"usage": "buildchain npm",
|
|
210
|
-
"purpose": "
|
|
408
|
+
"purpose": "Inspect npm publishing command families.",
|
|
409
|
+
"capabilityGroup": "release-passport-trust",
|
|
410
|
+
"audience": [
|
|
411
|
+
"agent",
|
|
412
|
+
"operator"
|
|
413
|
+
],
|
|
414
|
+
"maturity": "stable"
|
|
211
415
|
},
|
|
212
416
|
{
|
|
213
417
|
"id": "npm-dry-run",
|
|
214
418
|
"source": "bin/buildchain.mjs",
|
|
215
419
|
"usage": "buildchain npm dry-run [--cwd <dir>] [--expected-tag <tag>] [--registry <url>]",
|
|
216
|
-
"purpose": "Verify npm publish shape before a release transaction."
|
|
420
|
+
"purpose": "Verify npm publish shape before a release transaction.",
|
|
421
|
+
"capabilityGroup": "release-passport-trust",
|
|
422
|
+
"audience": [
|
|
423
|
+
"agent",
|
|
424
|
+
"operator"
|
|
425
|
+
],
|
|
426
|
+
"maturity": "stable"
|
|
217
427
|
},
|
|
218
428
|
{
|
|
219
429
|
"id": "publish-source",
|
|
220
430
|
"source": "bin/buildchain.mjs",
|
|
221
431
|
"usage": "buildchain publish-source <lock|manifest|verify-lock|verify-channel-ref|validate-anchored-release> ...",
|
|
222
|
-
"purpose": "Create, inspect, or verify publish-gate source-lock refs."
|
|
432
|
+
"purpose": "Create, inspect, or verify publish-gate source-lock refs.",
|
|
433
|
+
"capabilityGroup": "release-passport-trust",
|
|
434
|
+
"audience": [
|
|
435
|
+
"agent",
|
|
436
|
+
"operator"
|
|
437
|
+
],
|
|
438
|
+
"maturity": "stable"
|
|
223
439
|
},
|
|
224
440
|
{
|
|
225
441
|
"id": "release-dry-run",
|
|
226
442
|
"source": "bin/buildchain.mjs",
|
|
227
443
|
"usage": "buildchain release --dry-run --target-ref <ref> [--sha <sha>] [--source-ref <ref>]",
|
|
228
|
-
"purpose": "Explain what a channel merge would publish before the PR is merged."
|
|
444
|
+
"purpose": "Explain what a channel merge would publish before the PR is merged.",
|
|
445
|
+
"capabilityGroup": "governance-versioning",
|
|
446
|
+
"audience": [
|
|
447
|
+
"agent",
|
|
448
|
+
"operator"
|
|
449
|
+
],
|
|
450
|
+
"maturity": "stable"
|
|
229
451
|
},
|
|
230
452
|
{
|
|
231
453
|
"id": "release-line-open",
|
|
232
454
|
"source": "bin/buildchain.mjs",
|
|
233
455
|
"usage": "buildchain release line open --major <n> --minor <n> [--source-ref <ref>]",
|
|
234
|
-
"purpose": "Plan or write the initial version-state commit for a new minor release line."
|
|
456
|
+
"purpose": "Plan or write the initial version-state commit for a new minor release line.",
|
|
457
|
+
"capabilityGroup": "governance-versioning",
|
|
458
|
+
"audience": [
|
|
459
|
+
"agent",
|
|
460
|
+
"operator"
|
|
461
|
+
],
|
|
462
|
+
"maturity": "stable"
|
|
235
463
|
},
|
|
236
464
|
{
|
|
237
465
|
"id": "release-propagation",
|
|
238
466
|
"source": "bin/buildchain.mjs",
|
|
239
467
|
"usage": "buildchain release-propagation <plan|write-lock> ...",
|
|
240
|
-
"purpose": "Plan channel-preserving downstream release PRs and write exact upstream release locks."
|
|
468
|
+
"purpose": "Plan channel-preserving downstream release PRs and write exact upstream release locks.",
|
|
469
|
+
"capabilityGroup": "site-and-propagation",
|
|
470
|
+
"audience": [
|
|
471
|
+
"agent",
|
|
472
|
+
"operator"
|
|
473
|
+
],
|
|
474
|
+
"maturity": "stable"
|
|
241
475
|
},
|
|
242
476
|
{
|
|
243
477
|
"id": "release-transaction",
|
|
244
478
|
"source": "bin/buildchain.mjs",
|
|
245
479
|
"usage": "buildchain release <inspect|recover|finalize|abort> ...",
|
|
246
|
-
"purpose": "Inspect, recover, finalize, or abort durable release transactions."
|
|
480
|
+
"purpose": "Inspect, recover, finalize, or abort durable release transactions.",
|
|
481
|
+
"capabilityGroup": "release-passport-trust",
|
|
482
|
+
"audience": [
|
|
483
|
+
"agent",
|
|
484
|
+
"operator"
|
|
485
|
+
],
|
|
486
|
+
"maturity": "stable"
|
|
247
487
|
},
|
|
248
488
|
{
|
|
249
489
|
"id": "sample",
|
|
250
490
|
"source": "bin/buildchain.mjs",
|
|
251
491
|
"usage": "buildchain sample",
|
|
252
|
-
"purpose": "
|
|
492
|
+
"purpose": "Inspect sampler command families.",
|
|
493
|
+
"capabilityGroup": "observability-diagnostics",
|
|
494
|
+
"audience": [
|
|
495
|
+
"agent",
|
|
496
|
+
"operator"
|
|
497
|
+
],
|
|
498
|
+
"maturity": "stable"
|
|
253
499
|
},
|
|
254
500
|
{
|
|
255
501
|
"id": "sample-process-tree",
|
|
256
502
|
"source": "bin/buildchain.mjs",
|
|
257
503
|
"usage": "buildchain sample process-tree [--interval-ms <n>] [--label <name>]",
|
|
258
|
-
"purpose": "Sample process-tree diagnostics for a wrapped command."
|
|
504
|
+
"purpose": "Sample process-tree diagnostics for a wrapped command.",
|
|
505
|
+
"capabilityGroup": "observability-diagnostics",
|
|
506
|
+
"audience": [
|
|
507
|
+
"agent",
|
|
508
|
+
"operator"
|
|
509
|
+
],
|
|
510
|
+
"maturity": "stable"
|
|
259
511
|
},
|
|
260
512
|
{
|
|
261
513
|
"id": "span",
|
|
262
514
|
"source": "bin/buildchain.mjs",
|
|
263
515
|
"usage": "buildchain span --event <name> [--phase <phase>] [--component <name>]",
|
|
264
|
-
"purpose": "Run a command inside a Buildchain log span."
|
|
516
|
+
"purpose": "Run a command inside a Buildchain log span.",
|
|
517
|
+
"capabilityGroup": "observability-diagnostics",
|
|
518
|
+
"audience": [
|
|
519
|
+
"agent",
|
|
520
|
+
"operator"
|
|
521
|
+
],
|
|
522
|
+
"maturity": "stable"
|
|
265
523
|
},
|
|
266
524
|
{
|
|
267
525
|
"id": "transaction-inspect",
|
|
268
526
|
"source": "bin/buildchain.mjs",
|
|
269
527
|
"usage": "buildchain transaction inspect ...",
|
|
270
|
-
"purpose": "Inspect durable release transaction state."
|
|
528
|
+
"purpose": "Inspect durable release transaction state.",
|
|
529
|
+
"capabilityGroup": "release-passport-trust",
|
|
530
|
+
"audience": [
|
|
531
|
+
"agent",
|
|
532
|
+
"operator"
|
|
533
|
+
],
|
|
534
|
+
"maturity": "stable"
|
|
271
535
|
},
|
|
272
536
|
{
|
|
273
537
|
"id": "validate",
|
|
274
538
|
"source": "bin/buildchain.mjs",
|
|
275
539
|
"usage": "buildchain validate [--cwd <dir>] [--require-version-state]",
|
|
276
|
-
"purpose": "Validate buildchain.toml and declared lifecycle surfaces."
|
|
540
|
+
"purpose": "Validate buildchain.toml and declared lifecycle surfaces.",
|
|
541
|
+
"capabilityGroup": "getting-started",
|
|
542
|
+
"audience": [
|
|
543
|
+
"agent",
|
|
544
|
+
"operator"
|
|
545
|
+
],
|
|
546
|
+
"maturity": "stable"
|
|
277
547
|
},
|
|
278
548
|
{
|
|
279
549
|
"id": "verify",
|
|
280
550
|
"source": "bin/buildchain.mjs",
|
|
281
551
|
"usage": "buildchain verify",
|
|
282
|
-
"purpose": "
|
|
552
|
+
"purpose": "Inspect release and artifact verification command families.",
|
|
553
|
+
"capabilityGroup": "release-passport-trust",
|
|
554
|
+
"audience": [
|
|
555
|
+
"agent",
|
|
556
|
+
"operator"
|
|
557
|
+
],
|
|
558
|
+
"maturity": "stable"
|
|
283
559
|
},
|
|
284
560
|
{
|
|
285
561
|
"id": "verify-artifact",
|
|
286
562
|
"source": "bin/buildchain.mjs",
|
|
287
563
|
"usage": "buildchain verify artifact <file|dir|url|npm:...|oci:...|github-release:...>",
|
|
288
|
-
"purpose": "Verify artifact subjects against release passport evidence."
|
|
564
|
+
"purpose": "Verify artifact subjects against release passport evidence.",
|
|
565
|
+
"capabilityGroup": "release-passport-trust",
|
|
566
|
+
"audience": [
|
|
567
|
+
"agent",
|
|
568
|
+
"operator"
|
|
569
|
+
],
|
|
570
|
+
"maturity": "stable"
|
|
289
571
|
},
|
|
290
572
|
{
|
|
291
573
|
"id": "verify-infra-contract-evidence-bundle",
|
|
292
574
|
"source": "bin/buildchain.mjs",
|
|
293
575
|
"usage": "buildchain verify infra-contract-evidence-bundle <file> [--json]",
|
|
294
|
-
"purpose": "Fail closed unless an infra-contract lifecycle evidence bundle is complete, hash-bound, and validation-consistent."
|
|
576
|
+
"purpose": "Fail closed unless an infra-contract lifecycle evidence bundle is complete, hash-bound, and validation-consistent.",
|
|
577
|
+
"capabilityGroup": "governance-versioning",
|
|
578
|
+
"audience": [
|
|
579
|
+
"agent",
|
|
580
|
+
"operator"
|
|
581
|
+
],
|
|
582
|
+
"maturity": "stable"
|
|
295
583
|
},
|
|
296
584
|
{
|
|
297
585
|
"id": "verify-observability-log",
|
|
298
586
|
"source": "bin/buildchain.mjs",
|
|
299
587
|
"usage": "buildchain verify observability-log <jsonl> [--min-events <n>]",
|
|
300
|
-
"purpose": "Verify Buildchain observability log events."
|
|
588
|
+
"purpose": "Verify Buildchain observability log events.",
|
|
589
|
+
"capabilityGroup": "observability-diagnostics",
|
|
590
|
+
"audience": [
|
|
591
|
+
"agent",
|
|
592
|
+
"operator"
|
|
593
|
+
],
|
|
594
|
+
"maturity": "stable"
|
|
301
595
|
},
|
|
302
596
|
{
|
|
303
597
|
"id": "verify-release-passport",
|
|
304
598
|
"source": "bin/buildchain.mjs",
|
|
305
599
|
"usage": "buildchain verify release-passport <file-or-url> [--json]",
|
|
306
|
-
"purpose": "Fail closed unless a release passport and its evidence are complete."
|
|
600
|
+
"purpose": "Fail closed unless a release passport and its evidence are complete.",
|
|
601
|
+
"capabilityGroup": "release-passport-trust",
|
|
602
|
+
"audience": [
|
|
603
|
+
"agent",
|
|
604
|
+
"operator"
|
|
605
|
+
],
|
|
606
|
+
"maturity": "stable"
|
|
307
607
|
},
|
|
308
608
|
{
|
|
309
609
|
"id": "version",
|
|
310
610
|
"source": "bin/buildchain.mjs",
|
|
311
611
|
"usage": "buildchain version",
|
|
312
|
-
"purpose": "Print the package or embedded binary version."
|
|
612
|
+
"purpose": "Print the package or embedded binary version.",
|
|
613
|
+
"capabilityGroup": "getting-started",
|
|
614
|
+
"audience": [
|
|
615
|
+
"agent",
|
|
616
|
+
"operator"
|
|
617
|
+
],
|
|
618
|
+
"maturity": "stable"
|
|
313
619
|
},
|
|
314
620
|
{
|
|
315
621
|
"id": "web-surface",
|
|
316
622
|
"source": "bin/buildchain.mjs",
|
|
317
623
|
"usage": "buildchain web-surface ...",
|
|
318
|
-
"purpose": "Plan, verify, and apply Buildchain web-surface deployments."
|
|
624
|
+
"purpose": "Plan, verify, and apply Buildchain web-surface deployments.",
|
|
625
|
+
"capabilityGroup": "site-and-propagation",
|
|
626
|
+
"audience": [
|
|
627
|
+
"agent",
|
|
628
|
+
"operator"
|
|
629
|
+
],
|
|
630
|
+
"maturity": "stable"
|
|
319
631
|
}
|
|
320
632
|
]
|
|
321
633
|
}
|