@kungfu-tech/buildchain 3.0.4-alpha.0 → 3.0.4-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.
- package/AGENTS.md +14 -5
- package/README.md +18 -0
- package/bin/buildchain.mjs +136 -73
- package/bin/internal/trust-release-cli.mjs +15 -537
- package/bin/internal/trust-release-command-handlers.mjs +14 -0
- package/bin/internal/trust-release-inspection-handlers.mjs +175 -0
- package/bin/internal/trust-release-release-handlers.mjs +317 -0
- package/bin/internal/trust-release-verification-handlers.mjs +306 -0
- package/dist/site/buildchain-contract.json +36 -25
- package/dist/site/buildchain-site.json +1474 -61
- package/dist/site/capability-registry.json +8 -5
- package/dist/site/cli-registry.json +1869 -0
- package/dist/site/controller-registry.json +16 -3
- package/dist/site/kfd-claims.json +84 -10
- package/dist/site/kfd-upstream-aggregate.json +1 -1
- package/dist/site/manual-registry.json +49 -6
- package/dist/site/node-api-registry.json +17802 -11
- package/dist/site/page-registry.json +1441 -59
- package/dist/site/public-surface-audit.json +2863 -358
- package/dist/site/publication-registry.json +4 -4
- package/dist/site/release-model.json +7 -0
- package/dist/site/site-manifest.json +34 -10
- package/dist/site/workflow-registry.json +13 -5
- package/docs/MAP.md +21 -6
- package/docs/cli-reference.md +1936 -0
- package/docs/cli.md +15 -1
- package/docs/getting-started.md +167 -0
- package/docs/install.md +7 -8
- package/docs/node-api-reference.md +1952 -0
- package/docs/release-propagation.md +166 -8
- package/docs/site-bundle-contract.md +10 -4
- package/docs/versioning.md +5 -4
- package/package.json +8 -5
- package/packages/core/buildchain-agent-manuals.js +37 -0
- package/packages/core/buildchain-kfd-claims.js +4 -37
- package/packages/core/controller-evidence.js +8 -1
- package/packages/core/index.js +1 -13
- package/packages/core/paper-agent-entry.js +14 -11
- package/packages/core/paper-fleet.js +34 -7
- package/packages/core/paper-npm-bootstrap.js +492 -0
- package/packages/core/paper-repository.js +1 -0
- package/packages/core/paper.js +356 -674
- package/packages/core/public-surface-cli.js +12 -1
- package/packages/core/publication-package.js +7 -0
- package/packages/core/release-passport.js +67 -71
- package/packages/core/release-propagation-common.js +64 -0
- package/packages/core/release-propagation-execution-profile.js +59 -0
- package/packages/core/release-propagation-release.js +196 -0
- package/packages/core/release-propagation-stage-evidence.js +364 -0
- package/packages/core/release-propagation-work-capture.js +64 -0
- package/packages/core/release-propagation-work-constants.js +34 -0
- package/packages/core/release-propagation-work-control.js +203 -0
- package/packages/core/release-propagation-work-transitions.js +145 -0
- package/packages/core/release-propagation-work.js +517 -0
- package/packages/core/release-propagation.js +34 -158
- package/scripts/aggregate-build-summary.mjs +67 -4
- package/scripts/auditable-demo-renditions.mjs +131 -0
- package/scripts/auditable-demo.mjs +88 -91
- package/scripts/aws-windows-jit-controller-core.mjs +269 -0
- package/scripts/aws-windows-jit-controller.mjs +502 -0
- package/scripts/check-internal-architecture.mjs +178 -52
- package/scripts/check-inventory.mjs +2 -2
- package/scripts/check-maintainability.mjs +76 -17
- package/scripts/generate-public-reference.mjs +68 -0
- package/scripts/generate-site-bundle.mjs +35 -41
- package/scripts/maintainability-metrics.mjs +24 -4
- package/scripts/paper-work-fleet-cli.mjs +22 -3
- package/scripts/public-reference.mjs +557 -0
- package/scripts/release-propagation.mjs +126 -0
- package/scripts/resolve-artifact-transfer-mode.mjs +117 -0
- package/scripts/site-reference-registry.mjs +174 -0
- package/scripts/verify-golden-path.mjs +169 -0
- package/scripts/web-surface-core.mjs +46 -207
- package/scripts/web-surface-routing.mjs +286 -0
|
@@ -2121,6 +2121,14 @@
|
|
|
2121
2121
|
"path": ".github/workflows/release-propagation.yml"
|
|
2122
2122
|
},
|
|
2123
2123
|
"inputs": {
|
|
2124
|
+
"agent-work-context-json": {
|
|
2125
|
+
"classification": "digest-only",
|
|
2126
|
+
"source": "workflow-call-input"
|
|
2127
|
+
},
|
|
2128
|
+
"agent-work-mode": {
|
|
2129
|
+
"classification": "included",
|
|
2130
|
+
"source": "workflow-call-input"
|
|
2131
|
+
},
|
|
2124
2132
|
"buildchain-ref": {
|
|
2125
2133
|
"classification": "included",
|
|
2126
2134
|
"source": "workflow-call-input"
|
|
@@ -2204,6 +2212,10 @@
|
|
|
2204
2212
|
"id": "plan",
|
|
2205
2213
|
"required": true
|
|
2206
2214
|
},
|
|
2215
|
+
{
|
|
2216
|
+
"id": "emit-work",
|
|
2217
|
+
"required": false
|
|
2218
|
+
},
|
|
2207
2219
|
{
|
|
2208
2220
|
"id": "write-lock",
|
|
2209
2221
|
"required": true
|
|
@@ -2232,7 +2244,8 @@
|
|
|
2232
2244
|
"capabilities": [
|
|
2233
2245
|
"release-propagation-plan",
|
|
2234
2246
|
"downstream-lock",
|
|
2235
|
-
"
|
|
2247
|
+
"agent-native-work-envelope",
|
|
2248
|
+
"resumable-production-handoff"
|
|
2236
2249
|
],
|
|
2237
2250
|
"evidence": [
|
|
2238
2251
|
"propagation-plan",
|
|
@@ -2240,7 +2253,7 @@
|
|
|
2240
2253
|
"controller-receipt"
|
|
2241
2254
|
]
|
|
2242
2255
|
},
|
|
2243
|
-
"digest": "sha256:
|
|
2256
|
+
"digest": "sha256:660579b5561e8e33375a3f3b1fefbb8a5bd8241a55ba43374d786fb772c24a12"
|
|
2244
2257
|
},
|
|
2245
2258
|
{
|
|
2246
2259
|
"schemaVersion": 1,
|
|
@@ -2289,5 +2302,5 @@
|
|
|
2289
2302
|
"digest": "sha256:b6f53563c0adc859bc586c05fce560a5094d7d9666438d63c5fd3e1fc4774555"
|
|
2290
2303
|
}
|
|
2291
2304
|
],
|
|
2292
|
-
"digest": "sha256:
|
|
2305
|
+
"digest": "sha256:365541ae05fb807ed5ca3e80662ea5fa3b1d0cd13db5b56e444a4596b7b899f2"
|
|
2293
2306
|
}
|
|
@@ -14,20 +14,20 @@
|
|
|
14
14
|
},
|
|
15
15
|
"runtimeContract": {
|
|
16
16
|
"contract": "kungfu-buildchain-runtime-contract-world",
|
|
17
|
-
"compatibilityDigest": "sha256:
|
|
17
|
+
"compatibilityDigest": "sha256:3bbcaf835844260ed98414d3bd176667245d12131e13fc748e4c2fae12399691",
|
|
18
18
|
"majorLine": "v3"
|
|
19
19
|
},
|
|
20
20
|
"publicSurfaceReverseAudit": {
|
|
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": "29118ea036605532c088c4707809c4e0dac0430d1ade7b6b8a220bea5bd2ed09",
|
|
25
25
|
"summary": {
|
|
26
26
|
"cliCommandCount": 112,
|
|
27
27
|
"workflowCount": 57,
|
|
28
28
|
"actionCount": 6,
|
|
29
|
-
"sitePageCount":
|
|
30
|
-
"docCommandRefCount":
|
|
29
|
+
"sitePageCount": 63,
|
|
30
|
+
"docCommandRefCount": 813,
|
|
31
31
|
"failureCount": 0
|
|
32
32
|
},
|
|
33
33
|
"auditBoundary": {
|
|
@@ -211,7 +211,7 @@
|
|
|
211
211
|
},
|
|
212
212
|
{
|
|
213
213
|
"id": "claim:buildchain-release-propagation",
|
|
214
|
-
"claim": "Buildchain can propagate upstream
|
|
214
|
+
"claim": "Buildchain can propagate exact upstream releases as Family State v2 and WorkRef-bound, resumable downstream work that preserves protected review and completes only after production readback.",
|
|
215
215
|
"sourcePaths": [
|
|
216
216
|
"packages/core/release-propagation.js",
|
|
217
217
|
"scripts/release-propagation.mjs",
|
|
@@ -246,13 +246,13 @@
|
|
|
246
246
|
"contract": "kungfu-buildchain-public-surface-reverse-audit",
|
|
247
247
|
"path": "dist/site/public-surface-audit.json",
|
|
248
248
|
"status": "passed",
|
|
249
|
-
"sha256": "
|
|
249
|
+
"sha256": "29118ea036605532c088c4707809c4e0dac0430d1ade7b6b8a220bea5bd2ed09",
|
|
250
250
|
"summary": {
|
|
251
251
|
"cliCommandCount": 112,
|
|
252
252
|
"workflowCount": 57,
|
|
253
253
|
"actionCount": 6,
|
|
254
|
-
"sitePageCount":
|
|
255
|
-
"docCommandRefCount":
|
|
254
|
+
"sitePageCount": 63,
|
|
255
|
+
"docCommandRefCount": 813,
|
|
256
256
|
"failureCount": 0
|
|
257
257
|
},
|
|
258
258
|
"auditBoundary": {
|
|
@@ -416,6 +416,18 @@
|
|
|
416
416
|
"public": true,
|
|
417
417
|
"plane": "use"
|
|
418
418
|
},
|
|
419
|
+
{
|
|
420
|
+
"id": "doc:docs/cli-reference.md",
|
|
421
|
+
"name": "Generated CLI reference",
|
|
422
|
+
"kind": "documentation",
|
|
423
|
+
"sourcePath": "docs/cli-reference.md",
|
|
424
|
+
"evidencePath": "docs/cli-reference.md",
|
|
425
|
+
"availability": "shipped",
|
|
426
|
+
"visibility": "public",
|
|
427
|
+
"participantFacing": true,
|
|
428
|
+
"public": true,
|
|
429
|
+
"plane": "use"
|
|
430
|
+
},
|
|
419
431
|
{
|
|
420
432
|
"id": "doc:docs/cli.md",
|
|
421
433
|
"name": "CLI and npm package",
|
|
@@ -452,6 +464,18 @@
|
|
|
452
464
|
"public": true,
|
|
453
465
|
"plane": "verify"
|
|
454
466
|
},
|
|
467
|
+
{
|
|
468
|
+
"id": "doc:docs/getting-started.md",
|
|
469
|
+
"name": "Golden Path",
|
|
470
|
+
"kind": "documentation",
|
|
471
|
+
"sourcePath": "docs/getting-started.md",
|
|
472
|
+
"evidencePath": "docs/getting-started.md",
|
|
473
|
+
"availability": "shipped",
|
|
474
|
+
"visibility": "public",
|
|
475
|
+
"participantFacing": true,
|
|
476
|
+
"public": true,
|
|
477
|
+
"plane": "use"
|
|
478
|
+
},
|
|
455
479
|
{
|
|
456
480
|
"id": "doc:docs/github-artifact-attestation.md",
|
|
457
481
|
"name": "GitHub-native Linux artifact attestation",
|
|
@@ -560,6 +584,18 @@
|
|
|
560
584
|
"public": true,
|
|
561
585
|
"plane": "verify"
|
|
562
586
|
},
|
|
587
|
+
{
|
|
588
|
+
"id": "doc:docs/node-api-reference.md",
|
|
589
|
+
"name": "Generated Node API reference",
|
|
590
|
+
"kind": "documentation",
|
|
591
|
+
"sourcePath": "docs/node-api-reference.md",
|
|
592
|
+
"evidencePath": "docs/node-api-reference.md",
|
|
593
|
+
"availability": "shipped",
|
|
594
|
+
"visibility": "public",
|
|
595
|
+
"participantFacing": true,
|
|
596
|
+
"public": true,
|
|
597
|
+
"plane": "use"
|
|
598
|
+
},
|
|
563
599
|
{
|
|
564
600
|
"id": "doc:docs/ownership.md",
|
|
565
601
|
"name": "Ownership",
|
|
@@ -4754,8 +4790,10 @@
|
|
|
4754
4790
|
"visibility": "public",
|
|
4755
4791
|
"participantFacing": true,
|
|
4756
4792
|
"public": true,
|
|
4757
|
-
"inputCount":
|
|
4793
|
+
"inputCount": 19,
|
|
4758
4794
|
"inputs": [
|
|
4795
|
+
"agent-work-context-json",
|
|
4796
|
+
"agent-work-mode",
|
|
4759
4797
|
"buildchain-ref",
|
|
4760
4798
|
"buildchain-repository",
|
|
4761
4799
|
"downstream-base-ref",
|
|
@@ -5429,6 +5467,18 @@
|
|
|
5429
5467
|
"public": true,
|
|
5430
5468
|
"reverseAuditSource": "dist/site/page-registry.json"
|
|
5431
5469
|
},
|
|
5470
|
+
{
|
|
5471
|
+
"id": "site-page:manual:cli-reference",
|
|
5472
|
+
"name": "site-page:manual:cli-reference",
|
|
5473
|
+
"kind": "site-page",
|
|
5474
|
+
"sourcePath": "dist/site/page-registry.json",
|
|
5475
|
+
"evidencePath": "dist/site/page-registry.json",
|
|
5476
|
+
"availability": "shipped",
|
|
5477
|
+
"visibility": "public",
|
|
5478
|
+
"participantFacing": true,
|
|
5479
|
+
"public": true,
|
|
5480
|
+
"reverseAuditSource": "dist/site/page-registry.json"
|
|
5481
|
+
},
|
|
5432
5482
|
{
|
|
5433
5483
|
"id": "site-page:manual:consumer-issue-reporting",
|
|
5434
5484
|
"name": "site-page:manual:consumer-issue-reporting",
|
|
@@ -5465,6 +5515,18 @@
|
|
|
5465
5515
|
"public": true,
|
|
5466
5516
|
"reverseAuditSource": "dist/site/page-registry.json"
|
|
5467
5517
|
},
|
|
5518
|
+
{
|
|
5519
|
+
"id": "site-page:manual:getting-started",
|
|
5520
|
+
"name": "site-page:manual:getting-started",
|
|
5521
|
+
"kind": "site-page",
|
|
5522
|
+
"sourcePath": "dist/site/page-registry.json",
|
|
5523
|
+
"evidencePath": "dist/site/page-registry.json",
|
|
5524
|
+
"availability": "shipped",
|
|
5525
|
+
"visibility": "public",
|
|
5526
|
+
"participantFacing": true,
|
|
5527
|
+
"public": true,
|
|
5528
|
+
"reverseAuditSource": "dist/site/page-registry.json"
|
|
5529
|
+
},
|
|
5468
5530
|
{
|
|
5469
5531
|
"id": "site-page:manual:github-artifact-attestation",
|
|
5470
5532
|
"name": "site-page:manual:github-artifact-attestation",
|
|
@@ -5585,6 +5647,18 @@
|
|
|
5585
5647
|
"public": true,
|
|
5586
5648
|
"reverseAuditSource": "dist/site/page-registry.json"
|
|
5587
5649
|
},
|
|
5650
|
+
{
|
|
5651
|
+
"id": "site-page:manual:node-api-reference",
|
|
5652
|
+
"name": "site-page:manual:node-api-reference",
|
|
5653
|
+
"kind": "site-page",
|
|
5654
|
+
"sourcePath": "dist/site/page-registry.json",
|
|
5655
|
+
"evidencePath": "dist/site/page-registry.json",
|
|
5656
|
+
"availability": "shipped",
|
|
5657
|
+
"visibility": "public",
|
|
5658
|
+
"participantFacing": true,
|
|
5659
|
+
"public": true,
|
|
5660
|
+
"reverseAuditSource": "dist/site/page-registry.json"
|
|
5661
|
+
},
|
|
5588
5662
|
{
|
|
5589
5663
|
"id": "site-page:manual:observed-evidence-patrol",
|
|
5590
5664
|
"name": "site-page:manual:observed-evidence-patrol",
|
|
@@ -6020,6 +6094,6 @@
|
|
|
6020
6094
|
}
|
|
6021
6095
|
}
|
|
6022
6096
|
],
|
|
6023
|
-
"publicSurfaceCount":
|
|
6097
|
+
"publicSurfaceCount": 390
|
|
6024
6098
|
}
|
|
6025
6099
|
}
|
|
@@ -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:0731b18f6a7aa6a164197080fac3b57ff161640a28433c4cd26adcf145403fb5",
|
|
13
13
|
"capabilityGroup": "getting-started",
|
|
14
14
|
"audience": [
|
|
15
15
|
"agent",
|
|
@@ -18,6 +18,20 @@
|
|
|
18
18
|
"maturity": "stable",
|
|
19
19
|
"order": 10
|
|
20
20
|
},
|
|
21
|
+
{
|
|
22
|
+
"id": "getting-started",
|
|
23
|
+
"title": "Golden Path",
|
|
24
|
+
"path": "docs/getting-started.md",
|
|
25
|
+
"plane": "use",
|
|
26
|
+
"digest": "sha256:806224481f542786ed2e60226417bd1ba673099a3110f564357792bdbf637403",
|
|
27
|
+
"capabilityGroup": "getting-started",
|
|
28
|
+
"audience": [
|
|
29
|
+
"consumer",
|
|
30
|
+
"agent"
|
|
31
|
+
],
|
|
32
|
+
"maturity": "stable",
|
|
33
|
+
"order": 15
|
|
34
|
+
},
|
|
21
35
|
{
|
|
22
36
|
"id": "auditable-demo",
|
|
23
37
|
"title": "Auditable demo artifact pipeline",
|
|
@@ -37,7 +51,7 @@
|
|
|
37
51
|
"title": "Install and verify Buildchain",
|
|
38
52
|
"path": "docs/install.md",
|
|
39
53
|
"plane": "use",
|
|
40
|
-
"digest": "sha256:
|
|
54
|
+
"digest": "sha256:b9d87becf94efff804495ee3beea5da795241ae4402186102baa846c87c7bf14",
|
|
41
55
|
"capabilityGroup": "getting-started",
|
|
42
56
|
"audience": [
|
|
43
57
|
"consumer"
|
|
@@ -136,7 +150,7 @@
|
|
|
136
150
|
"title": "Release propagation",
|
|
137
151
|
"path": "docs/release-propagation.md",
|
|
138
152
|
"plane": "use",
|
|
139
|
-
"digest": "sha256:
|
|
153
|
+
"digest": "sha256:d9c9b4ba9dff6ed336b1ff31e5a02fcdf68dd013278caa86510e5fd0b50c4267",
|
|
140
154
|
"capabilityGroup": "site-and-propagation",
|
|
141
155
|
"audience": [
|
|
142
156
|
"release-operator",
|
|
@@ -234,7 +248,7 @@
|
|
|
234
248
|
"title": "Site bundle contract",
|
|
235
249
|
"path": "docs/site-bundle-contract.md",
|
|
236
250
|
"plane": "use",
|
|
237
|
-
"digest": "sha256:
|
|
251
|
+
"digest": "sha256:36a4e60e91f500ea1dcdbef97cd0250a2c26562b98d8d3622e8e0f9df2aad23b",
|
|
238
252
|
"capabilityGroup": "site-and-propagation",
|
|
239
253
|
"audience": [
|
|
240
254
|
"site",
|
|
@@ -289,7 +303,7 @@
|
|
|
289
303
|
"title": "CLI and npm package",
|
|
290
304
|
"path": "docs/cli.md",
|
|
291
305
|
"plane": "use",
|
|
292
|
-
"digest": "sha256:
|
|
306
|
+
"digest": "sha256:1707dd8989e1630b5ba9381c6f8aabbbc64288590628cbae9058ea6f56f9037c",
|
|
293
307
|
"capabilityGroup": "api-cli-reference",
|
|
294
308
|
"audience": [
|
|
295
309
|
"agent",
|
|
@@ -298,6 +312,35 @@
|
|
|
298
312
|
"maturity": "stable",
|
|
299
313
|
"order": 40
|
|
300
314
|
},
|
|
315
|
+
{
|
|
316
|
+
"id": "cli-reference",
|
|
317
|
+
"title": "Generated CLI reference",
|
|
318
|
+
"path": "docs/cli-reference.md",
|
|
319
|
+
"plane": "use",
|
|
320
|
+
"digest": "sha256:c728fe693ab591ab5b52f4276a817ec5a013c79833f0d20ca2cc137e85ae51ca",
|
|
321
|
+
"capabilityGroup": "api-cli-reference",
|
|
322
|
+
"audience": [
|
|
323
|
+
"agent",
|
|
324
|
+
"developer",
|
|
325
|
+
"operator"
|
|
326
|
+
],
|
|
327
|
+
"maturity": "stable",
|
|
328
|
+
"order": 42
|
|
329
|
+
},
|
|
330
|
+
{
|
|
331
|
+
"id": "node-api-reference",
|
|
332
|
+
"title": "Generated Node API reference",
|
|
333
|
+
"path": "docs/node-api-reference.md",
|
|
334
|
+
"plane": "use",
|
|
335
|
+
"digest": "sha256:ce9b018e6b1cfd98d8faa0ccadd6570585f2812b4828d610810f984f9810df5d",
|
|
336
|
+
"capabilityGroup": "api-cli-reference",
|
|
337
|
+
"audience": [
|
|
338
|
+
"agent",
|
|
339
|
+
"developer"
|
|
340
|
+
],
|
|
341
|
+
"maturity": "stable",
|
|
342
|
+
"order": 44
|
|
343
|
+
},
|
|
301
344
|
{
|
|
302
345
|
"id": "build-facts",
|
|
303
346
|
"title": "Build Facts",
|
|
@@ -429,7 +472,7 @@
|
|
|
429
472
|
"title": "Versioning",
|
|
430
473
|
"path": "docs/versioning.md",
|
|
431
474
|
"plane": "why",
|
|
432
|
-
"digest": "sha256:
|
|
475
|
+
"digest": "sha256:bdb155e873f9c2ea5cd40bdde057d2c2f90322f0d4575de77fe1670bd040e643",
|
|
433
476
|
"capabilityGroup": "governance-versioning",
|
|
434
477
|
"audience": [
|
|
435
478
|
"maintainer"
|