@kungfu-tech/buildchain 4.1.2 → 4.1.3-alpha.0
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/CONTRIBUTING.md +7 -4
- package/architecture/action-taxonomy.json +4 -0
- package/architecture/agent-change-map.md +40 -0
- package/architecture/internal-capabilities.json +49 -0
- package/architecture/maintainability-debt.json +2 -1
- package/architecture/maintainability-policy.json +4 -4
- package/architecture/release-topology.json +11 -1
- package/architecture/universal-workflow-bootstrap.json +13 -2
- package/architecture/universal-workflow-capability-policy.json +15 -9
- package/contracts/promotion-invocation-v1.schema.json +6 -3
- package/contracts/promotion-request-v1.schema.json +6 -3
- package/contracts/release-discussion-v1.schema.json +140 -0
- package/dist/readers/release-discussion.cjs +203 -0
- package/dist/site/buildchain-contract.json +15 -11
- package/dist/site/buildchain-site.json +57 -6
- package/dist/site/capability-registry.json +3 -3
- package/dist/site/kfd-claims.json +95 -9
- package/dist/site/kfd-upstream-aggregate.json +1 -1
- package/dist/site/manual-registry.json +1 -1
- package/dist/site/node-api-registry.json +83 -1
- package/dist/site/page-registry.json +54 -3
- package/dist/site/public-surface-audit.json +53 -7
- package/dist/site/publication-registry.json +2 -2
- package/dist/site/release-provenance.json +2 -1
- package/dist/site/site-manifest.json +3 -3
- package/dist/site/workflow-registry.json +79 -7
- package/docs/node-api-reference.md +9 -0
- package/docs/release-discussions.md +154 -0
- package/package.json +10 -6
- package/packages/core/providers/github/discussions/materials.js +146 -0
- package/packages/core/providers/github/discussions/transport.js +115 -0
- package/packages/core/publication/binary/action.js +21 -7
- package/packages/core/release/discussion/actions.js +65 -0
- package/packages/core/release/discussion/binary.js +92 -0
- package/packages/core/release/discussion/checkpoints.js +241 -0
- package/packages/core/release/discussion/envelope.js +141 -0
- package/packages/core/release/discussion/publication.js +121 -0
- package/packages/core/release/discussion/qualification.js +121 -0
- package/packages/core/release/discussion/reader-entry.js +11 -0
- package/packages/core/release/discussion/reader.js +168 -0
- package/packages/core/release/discussion/recovery.js +132 -0
- package/packages/core/release/discussion/session.js +113 -0
- package/packages/core/release/discussion/store.js +169 -0
- package/packages/core/release/github-release.js +3 -1
- package/packages/core/release/promote-candidate/action.js +86 -6
- package/packages/core/release/promote-candidate/preparation.js +106 -0
- package/packages/core/release/promote-candidate/product-provider.js +4 -1
- package/packages/core/release/promote-candidate/provider-settlement.js +36 -23
- package/packages/core/release/promote-candidate/transaction.js +55 -97
- package/packages/core/release/promotion/candidate.js +11 -2
- package/packages/core/release/promotion/qualification.js +5 -2
- package/packages/core/release/promotion-request.js +8 -4
- package/packages/core/workflow/engine/execution.js +5 -1
- package/packages/core/workflow/engine/provider-context.js +2 -0
- package/packages/core/workflow/engine/release-observation.js +1 -0
- package/packages/core/workflow/engine/release-promotion.js +38 -26
- package/packages/core/workflow/universal-workflow-bootstrap.js +1 -0
- package/scripts/build-release-discussion-reader.mjs +34 -0
- package/scripts/inventory/binary.mjs +1 -1
- package/scripts/maintainability-metrics.mjs +1 -0
- package/scripts/site-capability-metadata.mjs +1 -0
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
"maturity": "stable",
|
|
16
16
|
"counts": {
|
|
17
17
|
"manualCount": 4,
|
|
18
|
-
"pageCount":
|
|
18
|
+
"pageCount": 27,
|
|
19
19
|
"cliCommandCount": 9,
|
|
20
20
|
"nodeApiCount": 0,
|
|
21
21
|
"workflowCount": 0,
|
|
@@ -51,9 +51,9 @@
|
|
|
51
51
|
"manualCount": 7,
|
|
52
52
|
"pageCount": 8,
|
|
53
53
|
"cliCommandCount": 27,
|
|
54
|
-
"nodeApiCount":
|
|
54
|
+
"nodeApiCount": 24,
|
|
55
55
|
"workflowCount": 0,
|
|
56
|
-
"actionCount":
|
|
56
|
+
"actionCount": 97
|
|
57
57
|
},
|
|
58
58
|
"manuals": [
|
|
59
59
|
"docs/release-passport.md",
|
|
@@ -14,19 +14,19 @@
|
|
|
14
14
|
},
|
|
15
15
|
"runtimeContract": {
|
|
16
16
|
"contract": "kungfu-buildchain-runtime-contract-world",
|
|
17
|
-
"compatibilityDigest": "sha256:
|
|
17
|
+
"compatibilityDigest": "sha256:14368a3f99f38a8c9c1e053f7ec3651766e3535237f4c551cc75417cf7ef97b3",
|
|
18
18
|
"majorLine": "v4"
|
|
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": "625a32cfb0030365a18660c9e3fac788b7f5ea99a3dffc05160ba3821cf10f76",
|
|
25
25
|
"summary": {
|
|
26
26
|
"cliCommandCount": 117,
|
|
27
27
|
"workflowCount": 67,
|
|
28
|
-
"actionCount":
|
|
29
|
-
"sitePageCount":
|
|
28
|
+
"actionCount": 268,
|
|
29
|
+
"sitePageCount": 94,
|
|
30
30
|
"docCommandRefCount": 1036,
|
|
31
31
|
"failureCount": 0
|
|
32
32
|
},
|
|
@@ -246,12 +246,12 @@
|
|
|
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": "625a32cfb0030365a18660c9e3fac788b7f5ea99a3dffc05160ba3821cf10f76",
|
|
250
250
|
"summary": {
|
|
251
251
|
"cliCommandCount": 117,
|
|
252
252
|
"workflowCount": 67,
|
|
253
|
-
"actionCount":
|
|
254
|
-
"sitePageCount":
|
|
253
|
+
"actionCount": 268,
|
|
254
|
+
"sitePageCount": 94,
|
|
255
255
|
"docCommandRefCount": 1036,
|
|
256
256
|
"failureCount": 0
|
|
257
257
|
},
|
|
@@ -2107,6 +2107,18 @@
|
|
|
2107
2107
|
"participantFacing": true,
|
|
2108
2108
|
"public": true,
|
|
2109
2109
|
"packageExport": "./cross-platform-adopter-qualification"
|
|
2110
|
+
},
|
|
2111
|
+
{
|
|
2112
|
+
"id": "export:./release-discussion-reader",
|
|
2113
|
+
"name": "@kungfu-tech/buildchain/release-discussion-reader",
|
|
2114
|
+
"kind": "package-export",
|
|
2115
|
+
"sourcePath": "packages/core/release/discussion/reader.js",
|
|
2116
|
+
"evidencePath": "packages/core/release/discussion/reader.js",
|
|
2117
|
+
"availability": "shipped",
|
|
2118
|
+
"visibility": "public",
|
|
2119
|
+
"participantFacing": true,
|
|
2120
|
+
"public": true,
|
|
2121
|
+
"packageExport": "./release-discussion-reader"
|
|
2110
2122
|
}
|
|
2111
2123
|
],
|
|
2112
2124
|
"siteConsumptionContracts": [
|
|
@@ -8883,7 +8895,7 @@
|
|
|
8883
8895
|
"visibility": "public",
|
|
8884
8896
|
"participantFacing": true,
|
|
8885
8897
|
"public": true,
|
|
8886
|
-
"inputCount":
|
|
8898
|
+
"inputCount": 34,
|
|
8887
8899
|
"inputs": [
|
|
8888
8900
|
"artifact-paths",
|
|
8889
8901
|
"candidate-build-summary-path",
|
|
@@ -8906,6 +8918,7 @@
|
|
|
8906
8918
|
"repository",
|
|
8907
8919
|
"required-artifacts-path",
|
|
8908
8920
|
"required-status-check",
|
|
8921
|
+
"resume-discussion-id",
|
|
8909
8922
|
"resume-transaction-id",
|
|
8910
8923
|
"runtime-commit",
|
|
8911
8924
|
"runtime-tree",
|
|
@@ -8913,6 +8926,7 @@
|
|
|
8913
8926
|
"sealed-bundle-root",
|
|
8914
8927
|
"source-sha",
|
|
8915
8928
|
"stage-capsules-path",
|
|
8929
|
+
"standalone-binary-distribution",
|
|
8916
8930
|
"state-path",
|
|
8917
8931
|
"target-ref",
|
|
8918
8932
|
"target-sha",
|
|
@@ -9532,6 +9546,66 @@
|
|
|
9532
9546
|
],
|
|
9533
9547
|
"reverseAuditSource": "actions/*/action.yml"
|
|
9534
9548
|
},
|
|
9549
|
+
{
|
|
9550
|
+
"id": "action:release/transaction/inspect",
|
|
9551
|
+
"name": "action:release/transaction/inspect",
|
|
9552
|
+
"kind": "action",
|
|
9553
|
+
"sourcePath": "actions/release/transaction/inspect/action.yml",
|
|
9554
|
+
"evidencePath": "actions/release/transaction/inspect/action.yml",
|
|
9555
|
+
"availability": "shipped",
|
|
9556
|
+
"visibility": "public",
|
|
9557
|
+
"participantFacing": true,
|
|
9558
|
+
"public": true,
|
|
9559
|
+
"inputCount": 2,
|
|
9560
|
+
"inputs": [
|
|
9561
|
+
"session-json",
|
|
9562
|
+
"token"
|
|
9563
|
+
],
|
|
9564
|
+
"reverseAuditSource": "actions/*/action.yml"
|
|
9565
|
+
},
|
|
9566
|
+
{
|
|
9567
|
+
"id": "action:release/transaction/open",
|
|
9568
|
+
"name": "action:release/transaction/open",
|
|
9569
|
+
"kind": "action",
|
|
9570
|
+
"sourcePath": "actions/release/transaction/open/action.yml",
|
|
9571
|
+
"evidencePath": "actions/release/transaction/open/action.yml",
|
|
9572
|
+
"availability": "shipped",
|
|
9573
|
+
"visibility": "public",
|
|
9574
|
+
"participantFacing": true,
|
|
9575
|
+
"public": true,
|
|
9576
|
+
"inputCount": 7,
|
|
9577
|
+
"inputs": [
|
|
9578
|
+
"discussion-id",
|
|
9579
|
+
"dry-run",
|
|
9580
|
+
"expected-nodes-json",
|
|
9581
|
+
"intent-key",
|
|
9582
|
+
"predecessor",
|
|
9583
|
+
"source-json",
|
|
9584
|
+
"token"
|
|
9585
|
+
],
|
|
9586
|
+
"reverseAuditSource": "actions/*/action.yml"
|
|
9587
|
+
},
|
|
9588
|
+
{
|
|
9589
|
+
"id": "action:release/transaction/record",
|
|
9590
|
+
"name": "action:release/transaction/record",
|
|
9591
|
+
"kind": "action",
|
|
9592
|
+
"sourcePath": "actions/release/transaction/record/action.yml",
|
|
9593
|
+
"evidencePath": "actions/release/transaction/record/action.yml",
|
|
9594
|
+
"availability": "shipped",
|
|
9595
|
+
"visibility": "public",
|
|
9596
|
+
"participantFacing": true,
|
|
9597
|
+
"public": true,
|
|
9598
|
+
"inputCount": 6,
|
|
9599
|
+
"inputs": [
|
|
9600
|
+
"node",
|
|
9601
|
+
"payload-json",
|
|
9602
|
+
"sequence",
|
|
9603
|
+
"session-json",
|
|
9604
|
+
"status",
|
|
9605
|
+
"token"
|
|
9606
|
+
],
|
|
9607
|
+
"reverseAuditSource": "actions/*/action.yml"
|
|
9608
|
+
},
|
|
9535
9609
|
{
|
|
9536
9610
|
"id": "action:runtime/dependencies/install",
|
|
9537
9611
|
"name": "action:runtime/dependencies/install",
|
|
@@ -11051,6 +11125,18 @@
|
|
|
11051
11125
|
"public": true,
|
|
11052
11126
|
"reverseAuditSource": "dist/site/page-registry.json"
|
|
11053
11127
|
},
|
|
11128
|
+
{
|
|
11129
|
+
"id": "site-page:manual:release-discussions",
|
|
11130
|
+
"name": "site-page:manual:release-discussions",
|
|
11131
|
+
"kind": "site-page",
|
|
11132
|
+
"sourcePath": "dist/site/page-registry.json",
|
|
11133
|
+
"evidencePath": "dist/site/page-registry.json",
|
|
11134
|
+
"availability": "shipped",
|
|
11135
|
+
"visibility": "public",
|
|
11136
|
+
"participantFacing": true,
|
|
11137
|
+
"public": true,
|
|
11138
|
+
"reverseAuditSource": "dist/site/page-registry.json"
|
|
11139
|
+
},
|
|
11054
11140
|
{
|
|
11055
11141
|
"id": "site-page:manual:release-flow",
|
|
11056
11142
|
"name": "site-page:manual:release-flow",
|
|
@@ -11594,6 +11680,6 @@
|
|
|
11594
11680
|
}
|
|
11595
11681
|
}
|
|
11596
11682
|
],
|
|
11597
|
-
"publicSurfaceCount":
|
|
11683
|
+
"publicSurfaceCount": 733
|
|
11598
11684
|
}
|
|
11599
11685
|
}
|
|
@@ -362,7 +362,7 @@
|
|
|
362
362
|
"title": "Generated Node API reference",
|
|
363
363
|
"path": "docs/node-api-reference.md",
|
|
364
364
|
"plane": "use",
|
|
365
|
-
"digest": "sha256:
|
|
365
|
+
"digest": "sha256:b37478c7c5f6a4c09a89bb7f4dfe70c3ebcfa4cae21f25e09d16f499bf526afb",
|
|
366
366
|
"capabilityGroup": "api-cli-reference",
|
|
367
367
|
"audience": [
|
|
368
368
|
"agent",
|
|
@@ -19443,6 +19443,64 @@
|
|
|
19443
19443
|
"agent"
|
|
19444
19444
|
]
|
|
19445
19445
|
},
|
|
19446
|
+
{
|
|
19447
|
+
"id": "packages/core/release/discussion/reader.js#discussionStatus",
|
|
19448
|
+
"name": "discussionStatus",
|
|
19449
|
+
"kind": "function",
|
|
19450
|
+
"signature": "function discussionStatus(state)",
|
|
19451
|
+
"parameters": [
|
|
19452
|
+
{
|
|
19453
|
+
"name": "state",
|
|
19454
|
+
"signature": "state"
|
|
19455
|
+
}
|
|
19456
|
+
],
|
|
19457
|
+
"returns": "unknown",
|
|
19458
|
+
"errors": [
|
|
19459
|
+
"Errors from called operations may propagate; no narrower throw contract is declared in source."
|
|
19460
|
+
],
|
|
19461
|
+
"sideEffects": [
|
|
19462
|
+
"none-detected-by-static-source-scan"
|
|
19463
|
+
],
|
|
19464
|
+
"source": {
|
|
19465
|
+
"path": "packages/core/release/discussion/reader.js",
|
|
19466
|
+
"line": 151
|
|
19467
|
+
},
|
|
19468
|
+
"example": "import { discussionStatus } from \"@kungfu-tech/buildchain/release-discussion-reader\";",
|
|
19469
|
+
"maturity": "stable",
|
|
19470
|
+
"audience": [
|
|
19471
|
+
"developer",
|
|
19472
|
+
"agent"
|
|
19473
|
+
]
|
|
19474
|
+
},
|
|
19475
|
+
{
|
|
19476
|
+
"id": "packages/core/release/discussion/reader.js#readReleaseDiscussion",
|
|
19477
|
+
"name": "readReleaseDiscussion",
|
|
19478
|
+
"kind": "function",
|
|
19479
|
+
"signature": "function readReleaseDiscussion({ body, records })",
|
|
19480
|
+
"parameters": [
|
|
19481
|
+
{
|
|
19482
|
+
"name": "parameter1",
|
|
19483
|
+
"signature": "{ body, records }"
|
|
19484
|
+
}
|
|
19485
|
+
],
|
|
19486
|
+
"returns": "unknown",
|
|
19487
|
+
"errors": [
|
|
19488
|
+
"May throw an Error on rejected input or failed operations; follow the linked source contract."
|
|
19489
|
+
],
|
|
19490
|
+
"sideEffects": [
|
|
19491
|
+
"none-detected-by-static-source-scan"
|
|
19492
|
+
],
|
|
19493
|
+
"source": {
|
|
19494
|
+
"path": "packages/core/release/discussion/reader.js",
|
|
19495
|
+
"line": 11
|
|
19496
|
+
},
|
|
19497
|
+
"example": "import { readReleaseDiscussion } from \"@kungfu-tech/buildchain/release-discussion-reader\";",
|
|
19498
|
+
"maturity": "stable",
|
|
19499
|
+
"audience": [
|
|
19500
|
+
"developer",
|
|
19501
|
+
"agent"
|
|
19502
|
+
]
|
|
19503
|
+
},
|
|
19446
19504
|
{
|
|
19447
19505
|
"id": "packages/core/release/next-development-controller.js#createNextDevelopmentController",
|
|
19448
19506
|
"name": "createNextDevelopmentController",
|
|
@@ -30009,6 +30067,30 @@
|
|
|
30009
30067
|
"deprecationReplacement": "",
|
|
30010
30068
|
"sunsetCondition": "explicit-contract-change-review",
|
|
30011
30069
|
"nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
|
|
30070
|
+
},
|
|
30071
|
+
{
|
|
30072
|
+
"specifier": "@kungfu-tech/buildchain/release-discussion-reader",
|
|
30073
|
+
"export": "./release-discussion-reader",
|
|
30074
|
+
"target": "./packages/core/release/discussion/reader.js",
|
|
30075
|
+
"digest": "sha256:ffda31a96dfb4f5515e0e1099ec34300e79327f3f23b83b211a9b0747c760720",
|
|
30076
|
+
"summary": "Standalone historical decoder for append-only release Discussion intent, attempt lineage and recovery handoff.",
|
|
30077
|
+
"capabilityGroup": "release-passport-trust",
|
|
30078
|
+
"audience": [
|
|
30079
|
+
"developer",
|
|
30080
|
+
"agent"
|
|
30081
|
+
],
|
|
30082
|
+
"symbolCount": 2,
|
|
30083
|
+
"symbolIds": [
|
|
30084
|
+
"packages/core/release/discussion/reader.js#discussionStatus",
|
|
30085
|
+
"packages/core/release/discussion/reader.js#readReleaseDiscussion"
|
|
30086
|
+
],
|
|
30087
|
+
"owner": "buildchain-core",
|
|
30088
|
+
"maturity": "stable",
|
|
30089
|
+
"introducedVersion": "4.1.0-alpha.0",
|
|
30090
|
+
"compatibilityPromise": "current-contract-only",
|
|
30091
|
+
"deprecationReplacement": "",
|
|
30092
|
+
"sunsetCondition": "explicit-contract-change-review",
|
|
30093
|
+
"nonDuplicationRationale": "Existing package subpath retained as the canonical API boundary for this capability."
|
|
30012
30094
|
}
|
|
30013
30095
|
],
|
|
30014
30096
|
"docs": [
|
|
@@ -30020,7 +30102,7 @@
|
|
|
30020
30102
|
{
|
|
30021
30103
|
"id": "node-api-reference",
|
|
30022
30104
|
"path": "docs/node-api-reference.md",
|
|
30023
|
-
"digest": "sha256:
|
|
30105
|
+
"digest": "sha256:b37478c7c5f6a4c09a89bb7f4dfe70c3ebcfa4cae21f25e09d16f499bf526afb"
|
|
30024
30106
|
},
|
|
30025
30107
|
{
|
|
30026
30108
|
"id": "build-facts",
|