@kungfu-tech/buildchain 3.0.6 → 3.0.7-alpha.1
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 +4 -2
- package/actions/promote-buildchain-ref/README.md +10 -0
- package/actions/release-tail/README.md +17 -0
- package/bin/buildchain.mjs +11 -0
- package/bin/internal/command-registry.mjs +2 -0
- package/contracts/auditable-demo-scenario-v1.schema.json +1 -1
- package/contracts/engineering-housekeeper-v1.schema.json +143 -0
- package/contracts/fixtures/engineering-housekeeper-v1/cases.json +68 -0
- package/contracts/fixtures/release-tail-capabilities-v1/kungfu-alpha.json +273 -0
- package/contracts/publication-rehearsal-capsule-v1.schema.json +173 -0
- package/contracts/release-tail-capabilities-v1.schema.json +199 -0
- package/contracts/release-tail-provider-bindings-v1.schema.json +56 -0
- package/dist/site/agent-index.json +3 -0
- package/dist/site/artifact-schemas.json +6 -0
- package/dist/site/buildchain-contract.json +42 -27
- package/dist/site/buildchain-site.json +384 -33
- package/dist/site/capability-registry.json +15 -12
- package/dist/site/cli-registry.json +102 -0
- package/dist/site/controller-registry.json +19 -3
- package/dist/site/kfd-claims.json +359 -17
- package/dist/site/kfd-upstream-aggregate.json +1 -1
- package/dist/site/manual-registry.json +53 -7
- package/dist/site/node-api-registry.json +5882 -3605
- package/dist/site/page-registry.json +348 -21
- package/dist/site/public-surface-audit.json +396 -16
- package/dist/site/publication-authority-registry.json +106 -1
- package/dist/site/publication-registry.json +4 -4
- package/dist/site/release-provenance.json +7 -0
- package/dist/site/schemas/publication-rehearsal-capsule-v1.schema.json +269 -0
- package/dist/site/schemas/release-tail-capabilities-v1.schema.json +353 -0
- package/dist/site/schemas/release-tail-provider-bindings-v1.schema.json +94 -0
- package/dist/site/site-manifest.json +35 -11
- package/dist/site/workflow-registry.json +204 -10
- package/docs/MAP.md +6 -2
- package/docs/auditable-demo.md +2 -2
- package/docs/cli-reference.md +136 -0
- package/docs/dev-delivery-warrant.md +49 -4
- package/docs/engineering-housekeeper.md +138 -0
- package/docs/lifecycle-protocol.md +4 -2
- package/docs/node-api-reference.md +495 -281
- package/docs/publication-rehearsal.md +94 -0
- package/docs/release-governance.md +17 -2
- package/docs/release-tail-contract.md +160 -0
- package/docs/release-tail-provider-plane.md +120 -0
- package/docs/reusable-build-surface.md +11 -0
- package/package.json +11 -3
- package/packages/core/artifact-signing.js +61 -0
- package/packages/core/buildchain-agent-manuals.js +3 -0
- package/packages/core/buildchain-config.js +66 -6
- package/packages/core/buildchain-kfd-claims.js +1 -1
- package/packages/core/buildchain-publication-authority.js +5 -0
- package/packages/core/controller-evidence.js +2 -1
- package/packages/core/dev-delivery-warrant-cancellation.js +1 -0
- package/packages/core/dev-delivery-warrant-shadow.js +502 -0
- package/packages/core/dev-delivery-warrant.js +15 -6
- package/packages/core/diagnostics.js +8 -3
- package/packages/core/engineering-housekeeper-github-client.js +222 -0
- package/packages/core/engineering-housekeeper-github.js +501 -0
- package/packages/core/engineering-housekeeper.js +259 -0
- package/packages/core/index.js +42 -0
- package/packages/core/kfd-gate.js +45 -15
- package/packages/core/paper-agent-entry.js +11 -5
- package/packages/core/paper-repository.js +1 -0
- package/packages/core/paper-scaffold-content.js +21 -0
- package/packages/core/paper.js +28 -2
- package/packages/core/publication-rehearsal-projection.js +173 -0
- package/packages/core/publication-rehearsal-runtime.js +921 -0
- package/packages/core/release-passport.js +130 -20
- package/packages/core/release-tail-compatibility.js +60 -0
- package/packages/core/release-tail-provider-adapters.js +461 -0
- package/packages/core/release-tail-provider-plane.js +1228 -0
- package/scripts/assemble-publication-artifact-admission.mjs +1 -1
- package/scripts/assemble-self-publication-admission.mjs +2 -2
- package/scripts/audit-publication-control-plane.mjs +1 -1
- package/scripts/auditable-demo-bundle-verification.mjs +2 -3
- package/scripts/auditable-demo-platform.mjs +2 -2
- package/scripts/auditable-demo-renditions.mjs +1 -1
- package/scripts/auditable-demo.mjs +2 -2
- package/scripts/build-contract-core.mjs +8 -3
- package/scripts/build-standalone-binary.mjs +14 -3
- package/scripts/buildchain-cli-help.mjs +13 -0
- package/scripts/check-core-mechanism-inventory.mjs +347 -0
- package/scripts/check-inventory.mjs +10 -8
- package/scripts/check-maintainability.mjs +9 -2
- package/scripts/check-release-tail-contract.mjs +435 -0
- package/scripts/dev-delivery-warrant.mjs +31 -4
- package/scripts/dev-pr-auto-merge.mjs +30 -4
- package/scripts/dev-pr-delivery-warrant.mjs +50 -0
- package/scripts/engineering-housekeeper-workflow.mjs +394 -0
- package/scripts/generate-channel-promotion-workflow.mjs +10 -8
- package/scripts/generate-site-bundle.mjs +47 -4
- package/scripts/init-repo.mjs +26 -2
- package/scripts/inspect-artifact-signing-requests.mjs +6 -0
- package/scripts/materialize-self-release-candidate-version.mjs +137 -0
- package/scripts/publication-commit-evidence.mjs +69 -23
- package/scripts/release-candidate-resolver.mjs +16 -10
- package/scripts/release-tail.mjs +159 -0
- package/scripts/resume-from-candidate-run.mjs +123 -9
- package/scripts/seal-artifact-signing-requests.mjs +6 -0
- package/scripts/site-capability-metadata.mjs +13 -0
- package/scripts/v4-architecture.mjs +600 -0
- package/scripts/web-surface-core.mjs +8 -2
- package/scripts/workflow-call-contract.mjs +184 -5
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
"maturity": "stable",
|
|
16
16
|
"counts": {
|
|
17
17
|
"manualCount": 4,
|
|
18
|
-
"pageCount":
|
|
18
|
+
"pageCount": 16,
|
|
19
19
|
"cliCommandCount": 9,
|
|
20
20
|
"nodeApiCount": 0,
|
|
21
21
|
"workflowCount": 0,
|
|
@@ -48,19 +48,22 @@
|
|
|
48
48
|
],
|
|
49
49
|
"maturity": "stable",
|
|
50
50
|
"counts": {
|
|
51
|
-
"manualCount":
|
|
52
|
-
"pageCount":
|
|
53
|
-
"cliCommandCount":
|
|
54
|
-
"nodeApiCount":
|
|
55
|
-
"workflowCount":
|
|
56
|
-
"actionCount":
|
|
51
|
+
"manualCount": 8,
|
|
52
|
+
"pageCount": 8,
|
|
53
|
+
"cliCommandCount": 26,
|
|
54
|
+
"nodeApiCount": 17,
|
|
55
|
+
"workflowCount": 4,
|
|
56
|
+
"actionCount": 3
|
|
57
57
|
},
|
|
58
58
|
"manuals": [
|
|
59
59
|
"docs/release-passport.md",
|
|
60
60
|
"docs/github-artifact-attestation.md",
|
|
61
61
|
"docs/publication-authority.md",
|
|
62
62
|
"docs/binary-distribution.md",
|
|
63
|
-
"docs/publish-transaction.md"
|
|
63
|
+
"docs/publish-transaction.md",
|
|
64
|
+
"docs/release-tail-contract.md",
|
|
65
|
+
"docs/release-tail-provider-plane.md",
|
|
66
|
+
"docs/publication-rehearsal.md"
|
|
64
67
|
],
|
|
65
68
|
"factSources": [
|
|
66
69
|
"page-registry.json",
|
|
@@ -252,9 +255,9 @@
|
|
|
252
255
|
"counts": {
|
|
253
256
|
"manualCount": 8,
|
|
254
257
|
"pageCount": 8,
|
|
255
|
-
"cliCommandCount":
|
|
256
|
-
"nodeApiCount":
|
|
257
|
-
"workflowCount":
|
|
258
|
+
"cliCommandCount": 12,
|
|
259
|
+
"nodeApiCount": 8,
|
|
260
|
+
"workflowCount": 20,
|
|
258
261
|
"actionCount": 0
|
|
259
262
|
},
|
|
260
263
|
"manuals": [
|
|
@@ -289,7 +292,7 @@
|
|
|
289
292
|
"maturity": "stable",
|
|
290
293
|
"counts": {
|
|
291
294
|
"manualCount": 3,
|
|
292
|
-
"pageCount":
|
|
295
|
+
"pageCount": 11,
|
|
293
296
|
"cliCommandCount": 0,
|
|
294
297
|
"nodeApiCount": 2,
|
|
295
298
|
"workflowCount": 40,
|
|
@@ -5,6 +5,52 @@
|
|
|
5
5
|
"npmPackage": "@kungfu-tech/buildchain",
|
|
6
6
|
"commandSource": "bin/internal/command-registry.mjs plus bin/buildchain.mjs help enumeration",
|
|
7
7
|
"commands": [
|
|
8
|
+
{
|
|
9
|
+
"id": "architecture",
|
|
10
|
+
"source": "bin/buildchain.mjs",
|
|
11
|
+
"usage": "buildchain architecture validate [--cwd <dir>] [--json]",
|
|
12
|
+
"paths": [
|
|
13
|
+
"architecture",
|
|
14
|
+
"architecture list",
|
|
15
|
+
"architecture qualify",
|
|
16
|
+
"architecture show",
|
|
17
|
+
"architecture validate"
|
|
18
|
+
],
|
|
19
|
+
"syntaxes": [
|
|
20
|
+
"buildchain architecture",
|
|
21
|
+
"buildchain architecture list [--cwd <dir>] [--json]",
|
|
22
|
+
"buildchain architecture qualify --authority-revision <git-revision> [--candidate-revision <git-revision>] [--cwd <dir>] [--json]",
|
|
23
|
+
"buildchain architecture show <capability-id> [--cwd <dir>] [--json]",
|
|
24
|
+
"buildchain architecture validate [--cwd <dir>] [--json]"
|
|
25
|
+
],
|
|
26
|
+
"options": [
|
|
27
|
+
"--authority-revision",
|
|
28
|
+
"--candidate-revision",
|
|
29
|
+
"--cwd",
|
|
30
|
+
"--json"
|
|
31
|
+
],
|
|
32
|
+
"aliases": [],
|
|
33
|
+
"helpCommands": [
|
|
34
|
+
"buildchain architecture --help",
|
|
35
|
+
"buildchain architecture list --help",
|
|
36
|
+
"buildchain architecture qualify --help",
|
|
37
|
+
"buildchain architecture show --help",
|
|
38
|
+
"buildchain architecture validate --help"
|
|
39
|
+
],
|
|
40
|
+
"purpose": "Inspect and qualify the Buildchain v4 capability and state-machine architecture contract.",
|
|
41
|
+
"capabilityGroup": "governance-versioning",
|
|
42
|
+
"audience": [
|
|
43
|
+
"agent",
|
|
44
|
+
"operator"
|
|
45
|
+
],
|
|
46
|
+
"owner": "buildchain-cli",
|
|
47
|
+
"maturity": "stable",
|
|
48
|
+
"introducedVersion": "pre-3.0.2-alpha.4",
|
|
49
|
+
"compatibilityPromise": "preserved-through-the-v3-major-line",
|
|
50
|
+
"deprecationReplacement": "",
|
|
51
|
+
"sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
|
|
52
|
+
"nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
|
|
53
|
+
},
|
|
8
54
|
{
|
|
9
55
|
"id": "audit",
|
|
10
56
|
"source": "bin/buildchain.mjs",
|
|
@@ -3388,6 +3434,62 @@
|
|
|
3388
3434
|
"sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
|
|
3389
3435
|
"nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
|
|
3390
3436
|
},
|
|
3437
|
+
{
|
|
3438
|
+
"id": "release-tail",
|
|
3439
|
+
"source": "bin/buildchain.mjs",
|
|
3440
|
+
"usage": "buildchain release-tail plan --declaration <json-or-path> [--output <path>]",
|
|
3441
|
+
"paths": [
|
|
3442
|
+
"release-tail",
|
|
3443
|
+
"release-tail compat",
|
|
3444
|
+
"release-tail init",
|
|
3445
|
+
"release-tail plan",
|
|
3446
|
+
"release-tail rehearse",
|
|
3447
|
+
"release-tail status",
|
|
3448
|
+
"release-tail verify"
|
|
3449
|
+
],
|
|
3450
|
+
"syntaxes": [
|
|
3451
|
+
"buildchain release-tail",
|
|
3452
|
+
"buildchain release-tail <status|verify> [--state <path>] [--output <path>]",
|
|
3453
|
+
"buildchain release-tail compat --hooks-json <json-or-path> [--output <path>]",
|
|
3454
|
+
"buildchain release-tail init --declaration <json-or-path> [--state <path>]",
|
|
3455
|
+
"buildchain release-tail plan --declaration <json-or-path> [--output <path>]",
|
|
3456
|
+
"buildchain release-tail rehearse --capsule <path> --capsule-root <absolute-path> --mode <simulate|replay> --state <path> --evidence <path> [--environment-json <json-or-path>]"
|
|
3457
|
+
],
|
|
3458
|
+
"options": [
|
|
3459
|
+
"--capsule",
|
|
3460
|
+
"--capsule-root",
|
|
3461
|
+
"--declaration",
|
|
3462
|
+
"--environment-json",
|
|
3463
|
+
"--evidence",
|
|
3464
|
+
"--hooks-json",
|
|
3465
|
+
"--mode",
|
|
3466
|
+
"--output",
|
|
3467
|
+
"--state"
|
|
3468
|
+
],
|
|
3469
|
+
"aliases": [],
|
|
3470
|
+
"helpCommands": [
|
|
3471
|
+
"buildchain release-tail --help",
|
|
3472
|
+
"buildchain release-tail compat --help",
|
|
3473
|
+
"buildchain release-tail init --help",
|
|
3474
|
+
"buildchain release-tail plan --help",
|
|
3475
|
+
"buildchain release-tail rehearse --help",
|
|
3476
|
+
"buildchain release-tail status --help",
|
|
3477
|
+
"buildchain release-tail verify --help"
|
|
3478
|
+
],
|
|
3479
|
+
"purpose": "Plan, initialize, rehearse, resume, and verify one declarative provider-owned release-tail transaction.",
|
|
3480
|
+
"capabilityGroup": "release-passport-trust",
|
|
3481
|
+
"audience": [
|
|
3482
|
+
"agent",
|
|
3483
|
+
"operator"
|
|
3484
|
+
],
|
|
3485
|
+
"owner": "buildchain-cli",
|
|
3486
|
+
"maturity": "stable",
|
|
3487
|
+
"introducedVersion": "pre-3.0.2-alpha.4",
|
|
3488
|
+
"compatibilityPromise": "preserved-through-the-v3-major-line",
|
|
3489
|
+
"deprecationReplacement": "",
|
|
3490
|
+
"sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
|
|
3491
|
+
"nonDuplicationRationale": "Existing command identity retained for CLI compatibility and discoverability."
|
|
3492
|
+
},
|
|
3391
3493
|
{
|
|
3392
3494
|
"id": "release-transaction",
|
|
3393
3495
|
"source": "bin/buildchain.mjs",
|
|
@@ -481,6 +481,10 @@
|
|
|
481
481
|
"id": "anchored-release-preflight",
|
|
482
482
|
"required": false
|
|
483
483
|
},
|
|
484
|
+
{
|
|
485
|
+
"id": "pre-build-contracts",
|
|
486
|
+
"required": false
|
|
487
|
+
},
|
|
484
488
|
{
|
|
485
489
|
"id": "build",
|
|
486
490
|
"required": true
|
|
@@ -516,7 +520,7 @@
|
|
|
516
520
|
"controller-receipt"
|
|
517
521
|
]
|
|
518
522
|
},
|
|
519
|
-
"digest": "sha256:
|
|
523
|
+
"digest": "sha256:f986e79241d831f027a0955a35c918f946989176c76555e20f156ed31fb10c94"
|
|
520
524
|
},
|
|
521
525
|
{
|
|
522
526
|
"schemaVersion": 1,
|
|
@@ -1771,6 +1775,10 @@
|
|
|
1771
1775
|
"classification": "included",
|
|
1772
1776
|
"source": "workflow-call-input"
|
|
1773
1777
|
},
|
|
1778
|
+
"declarative-release-tail": {
|
|
1779
|
+
"classification": "included",
|
|
1780
|
+
"source": "workflow-call-input"
|
|
1781
|
+
},
|
|
1774
1782
|
"dry-run": {
|
|
1775
1783
|
"classification": "included",
|
|
1776
1784
|
"source": "workflow-call-input"
|
|
@@ -1859,6 +1867,10 @@
|
|
|
1859
1867
|
"classification": "digest-only",
|
|
1860
1868
|
"source": "workflow-call-input"
|
|
1861
1869
|
},
|
|
1870
|
+
"publication-authority-workflow-path": {
|
|
1871
|
+
"classification": "digest-only",
|
|
1872
|
+
"source": "workflow-call-input"
|
|
1873
|
+
},
|
|
1862
1874
|
"publication-auto-admission": {
|
|
1863
1875
|
"classification": "included",
|
|
1864
1876
|
"source": "workflow-call-input"
|
|
@@ -1883,6 +1895,10 @@
|
|
|
1883
1895
|
"classification": "digest-only",
|
|
1884
1896
|
"source": "workflow-call-input"
|
|
1885
1897
|
},
|
|
1898
|
+
"publication-consumer-qualification-controller-sha": {
|
|
1899
|
+
"classification": "included",
|
|
1900
|
+
"source": "workflow-call-input"
|
|
1901
|
+
},
|
|
1886
1902
|
"publication-control-plane-audit-json": {
|
|
1887
1903
|
"classification": "digest-only",
|
|
1888
1904
|
"source": "workflow-call-input"
|
|
@@ -2193,7 +2209,7 @@
|
|
|
2193
2209
|
"controller-receipt"
|
|
2194
2210
|
]
|
|
2195
2211
|
},
|
|
2196
|
-
"digest": "sha256:
|
|
2212
|
+
"digest": "sha256:83bc2f7d57ad3500e0b2983314aa5fdaa0dff1f78ef011af94cde760b86a010f"
|
|
2197
2213
|
},
|
|
2198
2214
|
{
|
|
2199
2215
|
"schemaVersion": 1,
|
|
@@ -2386,5 +2402,5 @@
|
|
|
2386
2402
|
"digest": "sha256:b6f53563c0adc859bc586c05fce560a5094d7d9666438d63c5fd3e1fc4774555"
|
|
2387
2403
|
}
|
|
2388
2404
|
],
|
|
2389
|
-
"digest": "sha256:
|
|
2405
|
+
"digest": "sha256:e9f5716c5298730bcab51a9e2f2316df8b4a7cec7ce609a7a8808928a48edd1e"
|
|
2390
2406
|
}
|