@kungfu-tech/buildchain 3.0.3-alpha.1 → 3.0.3-alpha.2
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/README.md +9 -4
- package/bin/buildchain.mjs +2 -256
- package/dist/site/buildchain-contract.json +5 -5
- package/dist/site/buildchain-site.json +19 -14
- package/dist/site/capability-registry.json +2 -2
- package/dist/site/cli-registry.json +72 -0
- package/dist/site/kfd-claims.json +95 -11
- package/dist/site/kfd-upstream-aggregate.json +1 -1
- package/dist/site/manual-registry.json +1 -1
- package/dist/site/node-api-registry.json +7 -7
- package/dist/site/page-registry.json +13 -8
- package/dist/site/public-surface-audit.json +72 -14
- package/dist/site/publication-registry.json +4 -4
- package/dist/site/site-manifest.json +5 -5
- package/docs/cli.md +31 -7
- package/docs/publication-artifacts.md +27 -0
- package/package.json +1 -1
- package/packages/core/README.md +3 -2
- package/packages/core/github-governance-authority.js +10 -25
- package/packages/core/index.js +1 -1
- package/packages/core/paper-fleet.js +260 -0
- package/packages/core/paper-repository.js +210 -0
- package/packages/core/paper-work.js +365 -0
- package/packages/core/paper.js +117 -163
- package/packages/core/public-surface-audit.js +26 -78
- package/packages/core/public-surface-cli.js +117 -0
- package/scripts/buildchain-cli-help.mjs +256 -0
- package/scripts/generate-site-bundle.mjs +1 -187
- package/scripts/paper-work-fleet-cli.mjs +563 -0
- package/scripts/paper.mjs +31 -45
- package/scripts/site-capability-metadata.mjs +202 -0
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
"counts": {
|
|
17
17
|
"manualCount": 3,
|
|
18
18
|
"pageCount": 12,
|
|
19
|
-
"cliCommandCount":
|
|
19
|
+
"cliCommandCount": 8,
|
|
20
20
|
"nodeApiCount": 0,
|
|
21
21
|
"workflowCount": 0,
|
|
22
22
|
"actionCount": 0
|
|
@@ -251,7 +251,7 @@
|
|
|
251
251
|
"counts": {
|
|
252
252
|
"manualCount": 8,
|
|
253
253
|
"pageCount": 8,
|
|
254
|
-
"cliCommandCount":
|
|
254
|
+
"cliCommandCount": 11,
|
|
255
255
|
"nodeApiCount": 5,
|
|
256
256
|
"workflowCount": 12,
|
|
257
257
|
"actionCount": 0
|
|
@@ -1355,6 +1355,42 @@
|
|
|
1355
1355
|
"sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
|
|
1356
1356
|
"nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
|
|
1357
1357
|
},
|
|
1358
|
+
{
|
|
1359
|
+
"id": "paper-fleet-audit",
|
|
1360
|
+
"source": "bin/buildchain.mjs",
|
|
1361
|
+
"usage": "buildchain paper fleet audit [--root <dir>] [--offline] [--json]",
|
|
1362
|
+
"purpose": "Discover Paper repositories and emit one deterministic v3 dependency, control-surface, and governance audit.",
|
|
1363
|
+
"capabilityGroup": "governance-versioning",
|
|
1364
|
+
"audience": [
|
|
1365
|
+
"agent",
|
|
1366
|
+
"operator"
|
|
1367
|
+
],
|
|
1368
|
+
"owner": "buildchain-cli",
|
|
1369
|
+
"maturity": "stable",
|
|
1370
|
+
"introducedVersion": "pre-3.0.2-alpha.4",
|
|
1371
|
+
"compatibilityPromise": "preserved-through-the-v3-major-line",
|
|
1372
|
+
"deprecationReplacement": "",
|
|
1373
|
+
"sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
|
|
1374
|
+
"nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
|
|
1375
|
+
},
|
|
1376
|
+
{
|
|
1377
|
+
"id": "paper-fleet-update",
|
|
1378
|
+
"source": "bin/buildchain.mjs",
|
|
1379
|
+
"usage": "buildchain paper fleet update [--root <dir>] [--write] [--json]",
|
|
1380
|
+
"purpose": "Plan or write a bounded v3 migration across isolated Paper work branches.",
|
|
1381
|
+
"capabilityGroup": "governance-versioning",
|
|
1382
|
+
"audience": [
|
|
1383
|
+
"agent",
|
|
1384
|
+
"operator"
|
|
1385
|
+
],
|
|
1386
|
+
"owner": "buildchain-cli",
|
|
1387
|
+
"maturity": "stable",
|
|
1388
|
+
"introducedVersion": "pre-3.0.2-alpha.4",
|
|
1389
|
+
"compatibilityPromise": "preserved-through-the-v3-major-line",
|
|
1390
|
+
"deprecationReplacement": "",
|
|
1391
|
+
"sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
|
|
1392
|
+
"nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
|
|
1393
|
+
},
|
|
1358
1394
|
{
|
|
1359
1395
|
"id": "paper-migrate",
|
|
1360
1396
|
"source": "bin/buildchain.mjs",
|
|
@@ -1445,6 +1481,42 @@
|
|
|
1445
1481
|
"sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
|
|
1446
1482
|
"nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
|
|
1447
1483
|
},
|
|
1484
|
+
{
|
|
1485
|
+
"id": "paper-work-start",
|
|
1486
|
+
"source": "bin/buildchain.mjs",
|
|
1487
|
+
"usage": "buildchain paper work start <topic> [--cwd <dir>] [--branch <branch>] [--execute] [--json]",
|
|
1488
|
+
"purpose": "Create a safe Paper work branch from the exact canonical remote development SHA.",
|
|
1489
|
+
"capabilityGroup": "getting-started",
|
|
1490
|
+
"audience": [
|
|
1491
|
+
"agent",
|
|
1492
|
+
"operator"
|
|
1493
|
+
],
|
|
1494
|
+
"owner": "buildchain-cli",
|
|
1495
|
+
"maturity": "stable",
|
|
1496
|
+
"introducedVersion": "pre-3.0.2-alpha.4",
|
|
1497
|
+
"compatibilityPromise": "preserved-through-the-v3-major-line",
|
|
1498
|
+
"deprecationReplacement": "",
|
|
1499
|
+
"sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
|
|
1500
|
+
"nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
|
|
1501
|
+
},
|
|
1502
|
+
{
|
|
1503
|
+
"id": "paper-work-submit",
|
|
1504
|
+
"source": "bin/buildchain.mjs",
|
|
1505
|
+
"usage": "buildchain paper work submit [--cwd <dir>] [--title <title>] [--body <body>] [--execute] [--json]",
|
|
1506
|
+
"purpose": "Push a Paper work branch without force and open or reuse the correctly targeted development PR.",
|
|
1507
|
+
"capabilityGroup": "governance-versioning",
|
|
1508
|
+
"audience": [
|
|
1509
|
+
"agent",
|
|
1510
|
+
"operator"
|
|
1511
|
+
],
|
|
1512
|
+
"owner": "buildchain-cli",
|
|
1513
|
+
"maturity": "stable",
|
|
1514
|
+
"introducedVersion": "pre-3.0.2-alpha.4",
|
|
1515
|
+
"compatibilityPromise": "preserved-through-the-v3-major-line",
|
|
1516
|
+
"deprecationReplacement": "",
|
|
1517
|
+
"sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
|
|
1518
|
+
"nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
|
|
1519
|
+
},
|
|
1448
1520
|
{
|
|
1449
1521
|
"id": "portable-cache",
|
|
1450
1522
|
"source": "bin/buildchain.mjs",
|
|
@@ -21,21 +21,39 @@
|
|
|
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": "af5cb9990177c134c9de2a03cd21bba16258e4ead0e8c7d01c94446d8cff8760",
|
|
25
25
|
"summary": {
|
|
26
|
-
"cliCommandCount":
|
|
26
|
+
"cliCommandCount": 111,
|
|
27
27
|
"workflowCount": 57,
|
|
28
28
|
"actionCount": 6,
|
|
29
29
|
"sitePageCount": 60,
|
|
30
|
-
"docCommandRefCount":
|
|
30
|
+
"docCommandRefCount": 315,
|
|
31
31
|
"failureCount": 0
|
|
32
32
|
},
|
|
33
33
|
"auditBoundary": {
|
|
34
34
|
"mode": "closed-world-enumerable",
|
|
35
35
|
"scope": "Buildchain CLI usage/dispatch, reusable workflow inputs, action inputs, site pages, and documentation command references",
|
|
36
36
|
"residualRisk": [
|
|
37
|
-
|
|
38
|
-
|
|
37
|
+
{
|
|
38
|
+
"id": "public-surface-helper-command-enumeration",
|
|
39
|
+
"definedBy": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-taxonomy.schema.json#/$defs/residualRisk",
|
|
40
|
+
"riskType": "natural-language-semantic-risk",
|
|
41
|
+
"trustImpact": "downgrade-warning",
|
|
42
|
+
"machineProvability": "not-machine-verifiable",
|
|
43
|
+
"agentAction": "semantic-review-required",
|
|
44
|
+
"owner": "Buildchain maintainers",
|
|
45
|
+
"reason": "Shell commands delegated through helper scripts are counted only when exposed through bin/buildchain.mjs usage or documentation."
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
"id": "public-surface-yaml-enumeration",
|
|
49
|
+
"definedBy": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-taxonomy.schema.json#/$defs/residualRisk",
|
|
50
|
+
"riskType": "natural-language-semantic-risk",
|
|
51
|
+
"trustImpact": "downgrade-warning",
|
|
52
|
+
"machineProvability": "not-machine-verifiable",
|
|
53
|
+
"agentAction": "semantic-review-required",
|
|
54
|
+
"owner": "Buildchain maintainers",
|
|
55
|
+
"reason": "YAML enumeration covers first-class action and workflow inputs, not arbitrary step environment variables."
|
|
56
|
+
}
|
|
39
57
|
]
|
|
40
58
|
}
|
|
41
59
|
},
|
|
@@ -228,21 +246,39 @@
|
|
|
228
246
|
"contract": "kungfu-buildchain-public-surface-reverse-audit",
|
|
229
247
|
"path": "dist/site/public-surface-audit.json",
|
|
230
248
|
"status": "passed",
|
|
231
|
-
"sha256": "
|
|
249
|
+
"sha256": "af5cb9990177c134c9de2a03cd21bba16258e4ead0e8c7d01c94446d8cff8760",
|
|
232
250
|
"summary": {
|
|
233
|
-
"cliCommandCount":
|
|
251
|
+
"cliCommandCount": 111,
|
|
234
252
|
"workflowCount": 57,
|
|
235
253
|
"actionCount": 6,
|
|
236
254
|
"sitePageCount": 60,
|
|
237
|
-
"docCommandRefCount":
|
|
255
|
+
"docCommandRefCount": 315,
|
|
238
256
|
"failureCount": 0
|
|
239
257
|
},
|
|
240
258
|
"auditBoundary": {
|
|
241
259
|
"mode": "closed-world-enumerable",
|
|
242
260
|
"scope": "Buildchain CLI usage/dispatch, reusable workflow inputs, action inputs, site pages, and documentation command references",
|
|
243
261
|
"residualRisk": [
|
|
244
|
-
|
|
245
|
-
|
|
262
|
+
{
|
|
263
|
+
"id": "public-surface-helper-command-enumeration",
|
|
264
|
+
"definedBy": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-taxonomy.schema.json#/$defs/residualRisk",
|
|
265
|
+
"riskType": "natural-language-semantic-risk",
|
|
266
|
+
"trustImpact": "downgrade-warning",
|
|
267
|
+
"machineProvability": "not-machine-verifiable",
|
|
268
|
+
"agentAction": "semantic-review-required",
|
|
269
|
+
"owner": "Buildchain maintainers",
|
|
270
|
+
"reason": "Shell commands delegated through helper scripts are counted only when exposed through bin/buildchain.mjs usage or documentation."
|
|
271
|
+
},
|
|
272
|
+
{
|
|
273
|
+
"id": "public-surface-yaml-enumeration",
|
|
274
|
+
"definedBy": "https://kfd.libkungfu.dev/schemas/kfd-2/trust-taxonomy.schema.json#/$defs/residualRisk",
|
|
275
|
+
"riskType": "natural-language-semantic-risk",
|
|
276
|
+
"trustImpact": "downgrade-warning",
|
|
277
|
+
"machineProvability": "not-machine-verifiable",
|
|
278
|
+
"agentAction": "semantic-review-required",
|
|
279
|
+
"owner": "Buildchain maintainers",
|
|
280
|
+
"reason": "YAML enumeration covers first-class action and workflow inputs, not arbitrary step environment variables."
|
|
281
|
+
}
|
|
246
282
|
]
|
|
247
283
|
}
|
|
248
284
|
},
|
|
@@ -2752,6 +2788,30 @@
|
|
|
2752
2788
|
"public": true,
|
|
2753
2789
|
"reverseAuditSource": "bin/buildchain.mjs"
|
|
2754
2790
|
},
|
|
2791
|
+
{
|
|
2792
|
+
"id": "cli:paper-fleet-audit",
|
|
2793
|
+
"name": "buildchain paper fleet audit [--root <dir>] [--offline] [--json]",
|
|
2794
|
+
"kind": "cli-command",
|
|
2795
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
2796
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
2797
|
+
"availability": "shipped",
|
|
2798
|
+
"visibility": "public",
|
|
2799
|
+
"participantFacing": true,
|
|
2800
|
+
"public": true,
|
|
2801
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
2802
|
+
},
|
|
2803
|
+
{
|
|
2804
|
+
"id": "cli:paper-fleet-update",
|
|
2805
|
+
"name": "buildchain paper fleet update [--root <dir>] [--write] [--json]",
|
|
2806
|
+
"kind": "cli-command",
|
|
2807
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
2808
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
2809
|
+
"availability": "shipped",
|
|
2810
|
+
"visibility": "public",
|
|
2811
|
+
"participantFacing": true,
|
|
2812
|
+
"public": true,
|
|
2813
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
2814
|
+
},
|
|
2755
2815
|
{
|
|
2756
2816
|
"id": "cli:paper-migrate",
|
|
2757
2817
|
"name": "buildchain paper migrate [--cwd <dir>] [--write] [--json]",
|
|
@@ -2812,6 +2872,30 @@
|
|
|
2812
2872
|
"public": true,
|
|
2813
2873
|
"reverseAuditSource": "bin/buildchain.mjs"
|
|
2814
2874
|
},
|
|
2875
|
+
{
|
|
2876
|
+
"id": "cli:paper-work-start",
|
|
2877
|
+
"name": "buildchain paper work start <topic> [--cwd <dir>] [--branch <branch>] [--execute] [--json]",
|
|
2878
|
+
"kind": "cli-command",
|
|
2879
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
2880
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
2881
|
+
"availability": "shipped",
|
|
2882
|
+
"visibility": "public",
|
|
2883
|
+
"participantFacing": true,
|
|
2884
|
+
"public": true,
|
|
2885
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
2886
|
+
},
|
|
2887
|
+
{
|
|
2888
|
+
"id": "cli:paper-work-submit",
|
|
2889
|
+
"name": "buildchain paper work submit [--cwd <dir>] [--title <title>] [--body <body>] [--execute] [--json]",
|
|
2890
|
+
"kind": "cli-command",
|
|
2891
|
+
"sourcePath": "bin/buildchain.mjs",
|
|
2892
|
+
"evidencePath": "bin/buildchain.mjs",
|
|
2893
|
+
"availability": "shipped",
|
|
2894
|
+
"visibility": "public",
|
|
2895
|
+
"participantFacing": true,
|
|
2896
|
+
"public": true,
|
|
2897
|
+
"reverseAuditSource": "bin/buildchain.mjs"
|
|
2898
|
+
},
|
|
2815
2899
|
{
|
|
2816
2900
|
"id": "cli:portable-cache",
|
|
2817
2901
|
"name": "buildchain portable-cache plan --manifest <file-or-json> [--output <file>]",
|
|
@@ -5924,6 +6008,6 @@
|
|
|
5924
6008
|
}
|
|
5925
6009
|
}
|
|
5926
6010
|
],
|
|
5927
|
-
"publicSurfaceCount":
|
|
6011
|
+
"publicSurfaceCount": 383
|
|
5928
6012
|
}
|
|
5929
6013
|
}
|
|
@@ -289,7 +289,7 @@
|
|
|
289
289
|
"title": "CLI and npm package",
|
|
290
290
|
"path": "docs/cli.md",
|
|
291
291
|
"plane": "use",
|
|
292
|
-
"digest": "sha256:
|
|
292
|
+
"digest": "sha256:9afe80ef29fb5cce140ffc7980c41172495878726e5504e47914b8dc7af8fc1f",
|
|
293
293
|
"capabilityGroup": "api-cli-reference",
|
|
294
294
|
"audience": [
|
|
295
295
|
"agent",
|
|
@@ -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:728cea6d09cfe3714a6e95e5ce7c02ab200c6d53823c5ab0e4a2ff3b01eb6e08",
|
|
12
12
|
"summary": "Root toolkit export for Buildchain's public Node API.",
|
|
13
13
|
"capabilityGroup": "api-cli-reference",
|
|
14
14
|
"audience": [
|
|
@@ -65,7 +65,7 @@
|
|
|
65
65
|
"specifier": "@kungfu-tech/buildchain/core",
|
|
66
66
|
"export": "./core",
|
|
67
67
|
"target": "./packages/core/index.js",
|
|
68
|
-
"digest": "sha256:
|
|
68
|
+
"digest": "sha256:728cea6d09cfe3714a6e95e5ce7c02ab200c6d53823c5ab0e4a2ff3b01eb6e08",
|
|
69
69
|
"summary": "Alias for the root public toolkit export.",
|
|
70
70
|
"capabilityGroup": "api-cli-reference",
|
|
71
71
|
"audience": [
|
|
@@ -483,7 +483,7 @@
|
|
|
483
483
|
"specifier": "@kungfu-tech/buildchain/public-surface-audit",
|
|
484
484
|
"export": "./public-surface-audit",
|
|
485
485
|
"target": "./packages/core/public-surface-audit.js",
|
|
486
|
-
"digest": "sha256:
|
|
486
|
+
"digest": "sha256:d8c73e29d45f93e45efd77ce80a1a0ef0153123c8e350958f710500f418f8315",
|
|
487
487
|
"summary": "Reverse audit APIs for CLI, workflow, action, site page, and documentation command surfaces.",
|
|
488
488
|
"capabilityGroup": "kfd-trust",
|
|
489
489
|
"audience": [
|
|
@@ -616,8 +616,8 @@
|
|
|
616
616
|
"specifier": "@kungfu-tech/buildchain/paper",
|
|
617
617
|
"export": "./paper",
|
|
618
618
|
"target": "./packages/core/paper.js",
|
|
619
|
-
"digest": "sha256:
|
|
620
|
-
"summary": "Unified
|
|
619
|
+
"digest": "sha256:8c8484ae8eaec9065f32cd5cb8a90b85d7bfae00c066dfcf416971243591b61d",
|
|
620
|
+
"summary": "Unified Paper work, fleet, scaffold, preflight, npm bootstrap, build, Alpha, status, and resume planning APIs.",
|
|
621
621
|
"capabilityGroup": "reusable-build",
|
|
622
622
|
"audience": [
|
|
623
623
|
"developer",
|
|
@@ -692,7 +692,7 @@
|
|
|
692
692
|
"specifier": "@kungfu-tech/buildchain/github-governance-authority",
|
|
693
693
|
"export": "./github-governance-authority",
|
|
694
694
|
"target": "./packages/core/github-governance-authority.js",
|
|
695
|
-
"digest": "sha256:
|
|
695
|
+
"digest": "sha256:5fc4c3b26d2fb0ea1b30f1e8913fd3a3fb7a8f69689f0f9ad2cff1a7555e7799",
|
|
696
696
|
"summary": "Fail-closed GitHub ownership, effective-policy, managed-zone admission, rollout-plan, and immutable receipt APIs.",
|
|
697
697
|
"capabilityGroup": "governance-versioning",
|
|
698
698
|
"audience": [
|
|
@@ -883,7 +883,7 @@
|
|
|
883
883
|
{
|
|
884
884
|
"id": "cli-and-node-package",
|
|
885
885
|
"path": "docs/cli.md",
|
|
886
|
-
"digest": "sha256:
|
|
886
|
+
"digest": "sha256:9afe80ef29fb5cce140ffc7980c41172495878726e5504e47914b8dc7af8fc1f"
|
|
887
887
|
},
|
|
888
888
|
{
|
|
889
889
|
"id": "build-facts",
|