@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.
Files changed (24) hide show
  1. package/dist/site/agent-index.json +1 -0
  2. package/dist/site/artifact-schemas.json +1 -0
  3. package/dist/site/buildchain-contract.json +4 -4
  4. package/dist/site/buildchain-site.json +296 -16
  5. package/dist/site/capability-registry.json +302 -0
  6. package/dist/site/cli-registry.json +364 -52
  7. package/dist/site/kfd-claims.json +27 -3
  8. package/dist/site/manual-registry.json +210 -25
  9. package/dist/site/node-api-registry.json +162 -22
  10. package/dist/site/page-registry.json +273 -8
  11. package/dist/site/public-surface-audit.json +3 -3
  12. package/dist/site/release-provenance.json +1 -0
  13. package/dist/site/site-manifest.json +17 -8
  14. package/dist/site/workflow-registry.json +39 -0
  15. package/docs/MAP.md +19 -0
  16. package/docs/cli.md +5 -0
  17. package/docs/site-bundle-contract.md +9 -0
  18. package/docs/web-surface-deployments.md +18 -0
  19. package/package.json +2 -1
  20. package/packages/core/buildchain-kfd-claims.js +3 -0
  21. package/scripts/check-inventory.mjs +43 -2
  22. package/scripts/generate-site-bundle.mjs +352 -59
  23. package/scripts/web-surface-core.mjs +147 -0
  24. package/scripts/web-surface.mjs +16 -1
package/dist/site/capability-registry.json ADDED
@@ -0,0 +1,302 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "contract": "kungfu-buildchain-capability-registry",
4
+ "package": "@kungfu-tech/buildchain",
5
+ "sourceOfTruth": "npm package @kungfu-tech/buildchain/dist/site/capability-registry.json",
6
+ "groups": [
7
+ {
8
+ "id": "getting-started",
9
+ "title": "Getting Started",
10
+ "summary": "Install Buildchain, understand the product mechanism, and choose the right entrypoint.",
11
+ "audience": [
12
+ "consumer",
13
+ "agent"
14
+ ],
15
+ "maturity": "stable",
16
+ "counts": {
17
+ "manualCount": 3,
18
+ "pageCount": 4,
19
+ "cliCommandCount": 5,
20
+ "nodeApiCount": 0,
21
+ "workflowCount": 0,
22
+ "actionCount": 0
23
+ },
24
+ "manuals": [
25
+ "docs/MAP.md",
26
+ "docs/install.md",
27
+ "docs/product-mechanism.md"
28
+ ],
29
+ "factSources": [
30
+ "page-registry.json",
31
+ "manual-registry.json",
32
+ "cli-registry.json",
33
+ "node-api-registry.json",
34
+ "workflow-registry.json",
35
+ "kfd-claims.json"
36
+ ]
37
+ },
38
+ {
39
+ "id": "release-passport-trust",
40
+ "title": "Release Passport and Trust",
41
+ "summary": "Create, verify, explain, and publish release passports, KFD trust evidence, GitHub Releases, and binary assets.",
42
+ "audience": [
43
+ "release-operator",
44
+ "agent"
45
+ ],
46
+ "maturity": "stable",
47
+ "counts": {
48
+ "manualCount": 3,
49
+ "pageCount": 3,
50
+ "cliCommandCount": 16,
51
+ "nodeApiCount": 2,
52
+ "workflowCount": 2,
53
+ "actionCount": 1
54
+ },
55
+ "manuals": [
56
+ "docs/release-passport.md",
57
+ "docs/binary-distribution.md",
58
+ "docs/publish-transaction.md"
59
+ ],
60
+ "factSources": [
61
+ "page-registry.json",
62
+ "manual-registry.json",
63
+ "cli-registry.json",
64
+ "node-api-registry.json",
65
+ "workflow-registry.json",
66
+ "kfd-claims.json"
67
+ ]
68
+ },
69
+ {
70
+ "id": "reusable-build",
71
+ "title": "Reusable Build and Lifecycle",
72
+ "summary": "Run reusable package/native builds, lifecycle stages, release candidates, source locks, and self-hosted artifact transfer.",
73
+ "audience": [
74
+ "consumer",
75
+ "release-operator"
76
+ ],
77
+ "maturity": "stable",
78
+ "counts": {
79
+ "manualCount": 3,
80
+ "pageCount": 14,
81
+ "cliCommandCount": 1,
82
+ "nodeApiCount": 1,
83
+ "workflowCount": 1,
84
+ "actionCount": 2
85
+ },
86
+ "manuals": [
87
+ "docs/release-candidate.md",
88
+ "docs/lifecycle-protocol.md",
89
+ "docs/reusable-build-surface.md"
90
+ ],
91
+ "factSources": [
92
+ "page-registry.json",
93
+ "manual-registry.json",
94
+ "cli-registry.json",
95
+ "node-api-registry.json",
96
+ "workflow-registry.json",
97
+ "kfd-claims.json"
98
+ ]
99
+ },
100
+ {
101
+ "id": "kfd-trust",
102
+ "title": "KFD Trust and Surface Closure",
103
+ "summary": "Discover KFD-1, KFD-2, and KFD-3 support, public surface reverse audits, and product capability queries.",
104
+ "audience": [
105
+ "agent",
106
+ "maintainer"
107
+ ],
108
+ "maturity": "stable",
109
+ "counts": {
110
+ "manualCount": 1,
111
+ "pageCount": 1,
112
+ "cliCommandCount": 6,
113
+ "nodeApiCount": 4,
114
+ "workflowCount": 0,
115
+ "actionCount": 0
116
+ },
117
+ "manuals": [
118
+ "docs/kfd-support.md"
119
+ ],
120
+ "factSources": [
121
+ "page-registry.json",
122
+ "manual-registry.json",
123
+ "cli-registry.json",
124
+ "node-api-registry.json",
125
+ "workflow-registry.json",
126
+ "kfd-claims.json"
127
+ ]
128
+ },
129
+ {
130
+ "id": "site-and-propagation",
131
+ "title": "Site Bundle, Web Surfaces, and Propagation",
132
+ "summary": "Publish package-owned site facts, web-surface previews/staging/production, and downstream release propagation.",
133
+ "audience": [
134
+ "site",
135
+ "release-operator",
136
+ "agent"
137
+ ],
138
+ "maturity": "stable",
139
+ "counts": {
140
+ "manualCount": 3,
141
+ "pageCount": 3,
142
+ "cliCommandCount": 2,
143
+ "nodeApiCount": 2,
144
+ "workflowCount": 1,
145
+ "actionCount": 0
146
+ },
147
+ "manuals": [
148
+ "docs/release-propagation.md",
149
+ "docs/site-bundle-contract.md",
150
+ "docs/web-surface-deployments.md"
151
+ ],
152
+ "factSources": [
153
+ "page-registry.json",
154
+ "manual-registry.json",
155
+ "cli-registry.json",
156
+ "node-api-registry.json",
157
+ "workflow-registry.json",
158
+ "kfd-claims.json"
159
+ ]
160
+ },
161
+ {
162
+ "id": "distribution-indexes",
163
+ "title": "Distribution Indexes and Badges",
164
+ "summary": "Generate README badge facts and distribution-index projections such as Homebrew taps from release passport evidence.",
165
+ "audience": [
166
+ "consumer",
167
+ "site",
168
+ "agent"
169
+ ],
170
+ "maturity": "stable",
171
+ "counts": {
172
+ "manualCount": 2,
173
+ "pageCount": 2,
174
+ "cliCommandCount": 6,
175
+ "nodeApiCount": 3,
176
+ "workflowCount": 0,
177
+ "actionCount": 0
178
+ },
179
+ "manuals": [
180
+ "docs/readme-badges.md",
181
+ "docs/homebrew.md"
182
+ ],
183
+ "factSources": [
184
+ "page-registry.json",
185
+ "manual-registry.json",
186
+ "cli-registry.json",
187
+ "node-api-registry.json",
188
+ "workflow-registry.json",
189
+ "kfd-claims.json"
190
+ ]
191
+ },
192
+ {
193
+ "id": "observability-diagnostics",
194
+ "title": "Build Facts, Observability, and Diagnostics",
195
+ "summary": "Collect source/module/product facts, lifecycle logs, diagnostics summaries, and process-tree evidence.",
196
+ "audience": [
197
+ "maintainer",
198
+ "agent"
199
+ ],
200
+ "maturity": "stable",
201
+ "counts": {
202
+ "manualCount": 3,
203
+ "pageCount": 3,
204
+ "cliCommandCount": 11,
205
+ "nodeApiCount": 4,
206
+ "workflowCount": 0,
207
+ "actionCount": 1
208
+ },
209
+ "manuals": [
210
+ "docs/consumer-issue-reporting.md",
211
+ "docs/toolkit-observability.md",
212
+ "docs/build-facts.md"
213
+ ],
214
+ "factSources": [
215
+ "page-registry.json",
216
+ "manual-registry.json",
217
+ "cli-registry.json",
218
+ "node-api-registry.json",
219
+ "workflow-registry.json",
220
+ "kfd-claims.json"
221
+ ]
222
+ },
223
+ {
224
+ "id": "governance-versioning",
225
+ "title": "Governance, Versioning, and Runtime Drift",
226
+ "summary": "Operate protected dev lines, semver line bootstrap, runtime trains, floating-ref contract locks, and ownership boundaries.",
227
+ "audience": [
228
+ "maintainer",
229
+ "release-operator"
230
+ ],
231
+ "maturity": "stable",
232
+ "counts": {
233
+ "manualCount": 7,
234
+ "pageCount": 7,
235
+ "cliCommandCount": 5,
236
+ "nodeApiCount": 2,
237
+ "workflowCount": 8,
238
+ "actionCount": 0
239
+ },
240
+ "manuals": [
241
+ "docs/infra-contract.md",
242
+ "docs/migration-inventory.md",
243
+ "docs/ownership.md",
244
+ "docs/release-governance.md",
245
+ "docs/release-flow.md",
246
+ "docs/runtime-train-validation.md",
247
+ "docs/versioning.md"
248
+ ],
249
+ "factSources": [
250
+ "page-registry.json",
251
+ "manual-registry.json",
252
+ "cli-registry.json",
253
+ "node-api-registry.json",
254
+ "workflow-registry.json",
255
+ "kfd-claims.json"
256
+ ]
257
+ },
258
+ {
259
+ "id": "api-cli-reference",
260
+ "title": "CLI and Node API Reference",
261
+ "summary": "Enumerate supported CLI commands, Node package exports, workflow/action inputs, and packaged manuals.",
262
+ "audience": [
263
+ "agent",
264
+ "developer"
265
+ ],
266
+ "maturity": "stable",
267
+ "counts": {
268
+ "manualCount": 1,
269
+ "pageCount": 6,
270
+ "cliCommandCount": 0,
271
+ "nodeApiCount": 2,
272
+ "workflowCount": 23,
273
+ "actionCount": 0
274
+ },
275
+ "manuals": [
276
+ "docs/cli.md"
277
+ ],
278
+ "factSources": [
279
+ "page-registry.json",
280
+ "manual-registry.json",
281
+ "cli-registry.json",
282
+ "node-api-registry.json",
283
+ "workflow-registry.json",
284
+ "kfd-claims.json"
285
+ ]
286
+ }
287
+ ],
288
+ "navigationPolicy": {
289
+ "defaultOrder": [
290
+ "getting-started",
291
+ "release-passport-trust",
292
+ "reusable-build",
293
+ "kfd-trust",
294
+ "site-and-propagation",
295
+ "distribution-indexes",
296
+ "observability-diagnostics",
297
+ "governance-versioning",
298
+ "api-cli-reference"
299
+ ],
300
+ "rule": "Render Buildchain documentation by capability group first, then by manual order or command/API registry within the selected group."
301
+ }
302
+ }