@kungfu-tech/buildchain 4.1.2 → 4.1.3-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/CONTRIBUTING.md +7 -4
- package/architecture/action-taxonomy.json +4 -0
- package/architecture/agent-change-map.md +44 -0
- package/architecture/internal-capabilities.json +56 -0
- package/architecture/maintainability-debt.json +2 -1
- package/architecture/maintainability-policy.json +4 -4
- package/architecture/release-topology.json +14 -1
- package/architecture/universal-workflow-bootstrap.json +13 -2
- package/architecture/universal-workflow-capability-policy.json +14 -8
- 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 +143 -0
- package/dist/readers/release-discussion.cjs +207 -0
- package/dist/site/buildchain-contract.json +15 -11
- package/dist/site/buildchain-site.json +64 -8
- 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 +59 -3
- package/dist/site/public-surface-audit.json +53 -7
- package/dist/site/publication-registry.json +4 -4
- package/dist/site/release-provenance.json +2 -1
- package/dist/site/site-manifest.json +5 -5
- package/dist/site/workflow-registry.json +79 -7
- package/docs/node-api-reference.md +9 -0
- package/docs/release-discussions.md +193 -0
- package/package.json +10 -6
- package/packages/core/providers/github/discussions/materials.js +157 -0
- package/packages/core/providers/github/discussions/transport.js +126 -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 +103 -0
- package/packages/core/release/discussion/checkpoints.js +282 -0
- package/packages/core/release/discussion/envelope.js +142 -0
- package/packages/core/release/discussion/evidence.js +51 -0
- package/packages/core/release/discussion/presentation.js +92 -0
- package/packages/core/release/discussion/publication.js +123 -0
- package/packages/core/release/discussion/qualification.js +122 -0
- package/packages/core/release/discussion/reader-entry.js +11 -0
- package/packages/core/release/discussion/reader.js +177 -0
- package/packages/core/release/discussion/recovery.js +132 -0
- package/packages/core/release/discussion/session.js +115 -0
- package/packages/core/release/discussion/store.js +166 -0
- package/packages/core/release/discussion/threads.js +83 -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": "84a65aecde602d74e6e25fba7bf418e77e421d05e863ef70ee69b58a088c43b5",
|
|
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": "84a65aecde602d74e6e25fba7bf418e77e421d05e863ef70ee69b58a088c43b5",
|
|
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:0fc24661217d58302858cca49a5f11d49c894fc720f6735e11da2dba50300c91",
|
|
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": 155
|
|
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:da8d3bfc6ba04130df6e894fc28ef4786eae322d8db874f87080429aab382b81",
|
|
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:0fc24661217d58302858cca49a5f11d49c894fc720f6735e11da2dba50300c91"
|
|
30024
30106
|
},
|
|
30025
30107
|
{
|
|
30026
30108
|
"id": "build-facts",
|