@kungfu-tech/buildchain 4.1.3-alpha.2 → 4.1.3-alpha.4

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.
Files changed (80) hide show
  1. package/architecture/action-taxonomy.json +8 -0
  2. package/architecture/agent-change-map.md +23 -0
  3. package/architecture/ci-lane-change-budget.json +85 -0
  4. package/architecture/decisions/0009-pipeline-version-preparation.md +186 -0
  5. package/architecture/internal-capabilities.json +32 -2
  6. package/architecture/maintainability-debt.json +10 -4
  7. package/architecture/maintainability-policy.json +7 -7
  8. package/architecture/minimal-consumer-migration.json +9 -0
  9. package/architecture/product-upstreams.json +20 -0
  10. package/architecture/release-topology.json +63 -25
  11. package/architecture/universal-workflow-bootstrap.json +2 -0
  12. package/architecture/universal-workflow-capability-policy.json +1 -1
  13. package/architecture/workflow-taxonomy.json +11 -0
  14. package/dist/readers/business-attempt.cjs +6 -2
  15. package/dist/site/buildchain-contract.json +4 -4
  16. package/dist/site/buildchain-site.json +9 -9
  17. package/dist/site/capability-registry.json +2 -2
  18. package/dist/site/kfd-claims.json +82 -8
  19. package/dist/site/kfd-upstream-aggregate.json +1 -1
  20. package/dist/site/manual-registry.json +1 -1
  21. package/dist/site/node-api-registry.json +18 -18
  22. package/dist/site/page-registry.json +4 -4
  23. package/dist/site/public-surface-audit.json +64 -7
  24. package/dist/site/publication-authority-registry.json +21 -1
  25. package/dist/site/publication-registry.json +4 -4
  26. package/dist/site/site-manifest.json +5 -5
  27. package/dist/site/workflow-registry.json +113 -7
  28. package/docs/node-api-reference.md +34 -34
  29. package/docs/workflow-catalog.md +1 -0
  30. package/package.json +1 -1
  31. package/packages/core/build/standalone/build.js +7 -1
  32. package/packages/core/consumer/buildchain-config.js +2 -21
  33. package/packages/core/consumer/contract/plan.js +53 -3
  34. package/packages/core/consumer/contract/products.js +20 -2
  35. package/packages/core/consumer/contract/reader.js +47 -0
  36. package/packages/core/dev-delivery/commands/project-cut-merge-queue-admission.mjs +47 -20
  37. package/packages/core/governance/buildchain-publication-authority.js +1 -0
  38. package/packages/core/providers/github/discussions/materials.js +12 -4
  39. package/packages/core/providers/github/pipeline-entry-runs.js +203 -0
  40. package/packages/core/providers/github/pipeline-policy.js +44 -17
  41. package/packages/core/providers/github/pipeline-release-evidence.js +111 -0
  42. package/packages/core/providers/github/pipeline-stable-source.js +354 -0
  43. package/packages/core/providers/github/pipeline-version-artifacts.js +91 -0
  44. package/packages/core/providers/github/pipeline-version-readback.js +117 -0
  45. package/packages/core/providers/github/pipeline-version.js +10 -12
  46. package/packages/core/publication/pipeline/actions.js +17 -1
  47. package/packages/core/publication/pipeline/apply.js +23 -17
  48. package/packages/core/publication/pipeline/development-pr.js +28 -1
  49. package/packages/core/publication/pipeline/documents.js +37 -1
  50. package/packages/core/publication/pipeline/next-development.js +1 -0
  51. package/packages/core/publication/pipeline/pack.js +7 -1
  52. package/packages/core/publication/pipeline/plan.js +22 -0
  53. package/packages/core/publication/pipeline/prepare.js +44 -56
  54. package/packages/core/publication/pipeline/qualification.js +5 -0
  55. package/packages/core/publication/pipeline/stable-entry.js +215 -0
  56. package/packages/core/publication/pipeline/stable-products.js +317 -0
  57. package/packages/core/publication/pipeline/stable-wait.js +170 -0
  58. package/packages/core/publication/pipeline/stable.js +82 -0
  59. package/packages/core/publication/pipeline/version-actions.js +93 -0
  60. package/packages/core/publication/pipeline/version-build.js +130 -0
  61. package/packages/core/publication/pipeline/version-context.js +143 -0
  62. package/packages/core/publication/pipeline/version-material.js +36 -0
  63. package/packages/core/publication/pipeline/version-preparation.js +69 -0
  64. package/packages/core/publication/pipeline/version-regeneration.js +162 -0
  65. package/packages/core/publication/pipeline/version-source-guard.js +69 -0
  66. package/packages/core/publication/pipeline/worker.js +72 -0
  67. package/packages/core/release/stable-release-gate.js +11 -0
  68. package/packages/core/workflow/attempt/identity.js +7 -2
  69. package/packages/core/workflow/pipeline/actions.js +14 -1
  70. package/packages/core/workflow/pipeline/build-result.js +8 -0
  71. package/packages/core/workflow/pipeline/build.js +49 -2
  72. package/packages/core/workflow/pipeline/channel-control.js +10 -1
  73. package/packages/core/workflow/pipeline/channel-source.js +53 -0
  74. package/packages/core/workflow/pipeline/group-control.js +2 -0
  75. package/packages/core/workflow/pipeline/host.js +24 -16
  76. package/packages/core/workflow/pipeline/selection.js +9 -4
  77. package/scripts/check-pipeline-publication-topology.mjs +12 -0
  78. package/scripts/check-release-topology.mjs +1 -0
  79. package/scripts/generate-site-bundle.mjs +1 -1
  80. package/scripts/verify-standalone-product.mjs +42 -0
@@ -53,7 +53,7 @@
53
53
  "cliCommandCount": 27,
54
54
  "nodeApiCount": 24,
55
55
  "workflowCount": 0,
56
- "actionCount": 104
56
+ "actionCount": 107
57
57
  },
58
58
  "manuals": [
59
59
  "docs/release-passport.md",
@@ -298,7 +298,7 @@
298
298
  "pageCount": 13,
299
299
  "cliCommandCount": 0,
300
300
  "nodeApiCount": 2,
301
- "workflowCount": 60,
301
+ "workflowCount": 61,
302
302
  "actionCount": 31
303
303
  },
304
304
  "manuals": [
@@ -21,11 +21,11 @@
21
21
  "contract": "kungfu-buildchain-public-surface-reverse-audit",
22
22
  "path": "dist/site/public-surface-audit.json",
23
23
  "status": "passed",
24
- "sha256": "6e2ae1986c4fe734fddd9b5d9f78ac94f0caa89d9c084cb7fe4f120b402a4758",
24
+ "sha256": "0961a448474a107d8a0361e2f691f8f866da52a3d8b30db2edb616c6e737ebea",
25
25
  "summary": {
26
26
  "cliCommandCount": 117,
27
- "workflowCount": 72,
28
- "actionCount": 280,
27
+ "workflowCount": 73,
28
+ "actionCount": 283,
29
29
  "sitePageCount": 94,
30
30
  "docCommandRefCount": 1036,
31
31
  "failureCount": 0
@@ -246,11 +246,11 @@
246
246
  "contract": "kungfu-buildchain-public-surface-reverse-audit",
247
247
  "path": "dist/site/public-surface-audit.json",
248
248
  "status": "passed",
249
- "sha256": "6e2ae1986c4fe734fddd9b5d9f78ac94f0caa89d9c084cb7fe4f120b402a4758",
249
+ "sha256": "0961a448474a107d8a0361e2f691f8f866da52a3d8b30db2edb616c6e737ebea",
250
250
  "summary": {
251
251
  "cliCommandCount": 117,
252
- "workflowCount": 72,
253
- "actionCount": 280,
252
+ "workflowCount": 73,
253
+ "actionCount": 283,
254
254
  "sitePageCount": 94,
255
255
  "docCommandRefCount": 1036,
256
256
  "failureCount": 0
@@ -4003,6 +4003,26 @@
4003
4003
  ],
4004
4004
  "reverseAuditSource": ".github/workflows"
4005
4005
  },
4006
+ {
4007
+ "id": "workflow:.release-pipeline-version",
4008
+ "name": "workflow:.release-pipeline-version",
4009
+ "kind": "workflow",
4010
+ "sourcePath": ".github/workflows/.release-pipeline-version.yml",
4011
+ "evidencePath": ".github/workflows/.release-pipeline-version.yml",
4012
+ "availability": "shipped",
4013
+ "visibility": "public",
4014
+ "participantFacing": true,
4015
+ "public": true,
4016
+ "inputCount": 5,
4017
+ "inputs": [
4018
+ "context",
4019
+ "matrix",
4020
+ "operation",
4021
+ "purpose",
4022
+ "runtime-selection"
4023
+ ],
4024
+ "reverseAuditSource": ".github/workflows"
4025
+ },
4006
4026
  {
4007
4027
  "id": "workflow:.release-promote",
4008
4028
  "name": "workflow:.release-promote",
@@ -8786,6 +8806,59 @@
8786
8806
  ],
8787
8807
  "reverseAuditSource": "actions/*/action.yml"
8788
8808
  },
8809
+ {
8810
+ "id": "action:publication/version/build",
8811
+ "name": "action:publication/version/build",
8812
+ "kind": "action",
8813
+ "sourcePath": "actions/publication/version/build/action.yml",
8814
+ "evidencePath": "actions/publication/version/build/action.yml",
8815
+ "availability": "shipped",
8816
+ "visibility": "public",
8817
+ "participantFacing": true,
8818
+ "public": true,
8819
+ "inputCount": 2,
8820
+ "inputs": [
8821
+ "context",
8822
+ "platform"
8823
+ ],
8824
+ "reverseAuditSource": "actions/*/action.yml"
8825
+ },
8826
+ {
8827
+ "id": "action:publication/version/materialize-development",
8828
+ "name": "action:publication/version/materialize-development",
8829
+ "kind": "action",
8830
+ "sourcePath": "actions/publication/version/materialize-development/action.yml",
8831
+ "evidencePath": "actions/publication/version/materialize-development/action.yml",
8832
+ "availability": "shipped",
8833
+ "visibility": "public",
8834
+ "participantFacing": true,
8835
+ "public": true,
8836
+ "inputCount": 3,
8837
+ "inputs": [
8838
+ "context",
8839
+ "pr-token",
8840
+ "token"
8841
+ ],
8842
+ "reverseAuditSource": "actions/*/action.yml"
8843
+ },
8844
+ {
8845
+ "id": "action:publication/version/materialize-publication",
8846
+ "name": "action:publication/version/materialize-publication",
8847
+ "kind": "action",
8848
+ "sourcePath": "actions/publication/version/materialize-publication/action.yml",
8849
+ "evidencePath": "actions/publication/version/materialize-publication/action.yml",
8850
+ "availability": "shipped",
8851
+ "visibility": "public",
8852
+ "participantFacing": true,
8853
+ "public": true,
8854
+ "inputCount": 3,
8855
+ "inputs": [
8856
+ "context",
8857
+ "operation",
8858
+ "token"
8859
+ ],
8860
+ "reverseAuditSource": "actions/*/action.yml"
8861
+ },
8789
8862
  {
8790
8863
  "id": "action:release/binary/coordinates",
8791
8864
  "name": "action:release/binary/coordinates",
@@ -10658,9 +10731,10 @@
10658
10731
  "visibility": "public",
10659
10732
  "participantFacing": true,
10660
10733
  "public": true,
10661
- "inputCount": 2,
10734
+ "inputCount": 3,
10662
10735
  "inputs": [
10663
10736
  "attempt",
10737
+ "stable-wait",
10664
10738
  "token"
10665
10739
  ],
10666
10740
  "reverseAuditSource": "actions/*/action.yml"
@@ -11981,6 +12055,6 @@
11981
12055
  }
11982
12056
  }
11983
12057
  ],
11984
- "publicSurfaceCount": 750
12058
+ "publicSurfaceCount": 754
11985
12059
  }
11986
12060
  }
@@ -4,7 +4,7 @@
4
4
  "product": {
5
5
  "id": "kungfu-tech-buildchain",
6
6
  "name": "@kungfu-tech/buildchain",
7
- "version": "4.1.3-alpha.2",
7
+ "version": "4.1.3-alpha.4",
8
8
  "repository": "https://github.com/kungfu-systems/buildchain"
9
9
  },
10
10
  "source": {
@@ -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:23782a5348b073974490eee5e79e4fe0d614d75c1a884d5899730f75a9da01f2",
365
+ "digest": "sha256:a7135f86b2c74078eed1b6fd920629addce974140d7f18a7cdc86c21c8fd7f8d",
366
366
  "capabilityGroup": "api-cli-reference",
367
367
  "audience": [
368
368
  "agent",
@@ -6129,7 +6129,7 @@
6129
6129
  ],
6130
6130
  "source": {
6131
6131
  "path": "packages/core/consumer/buildchain-config.js",
6132
- "line": 1551
6132
+ "line": 1532
6133
6133
  },
6134
6134
  "example": "import { discoverConfiguredDerivedVersionMaterial } from \"@kungfu-tech/buildchain\";",
6135
6135
  "maturity": "stable",
@@ -6162,7 +6162,7 @@
6162
6162
  ],
6163
6163
  "source": {
6164
6164
  "path": "packages/core/consumer/buildchain-config.js",
6165
- "line": 1512
6165
+ "line": 1493
6166
6166
  },
6167
6167
  "example": "import { discoverConfiguredVersionStateFiles } from \"@kungfu-tech/buildchain\";",
6168
6168
  "maturity": "stable",
@@ -6195,7 +6195,7 @@
6195
6195
  ],
6196
6196
  "source": {
6197
6197
  "path": "packages/core/consumer/buildchain-config.js",
6198
- "line": 1456
6198
+ "line": 1437
6199
6199
  },
6200
6200
  "example": "import { getLifecycleStage } from \"@kungfu-tech/buildchain\";",
6201
6201
  "maturity": "stable",
@@ -6224,7 +6224,7 @@
6224
6224
  ],
6225
6225
  "source": {
6226
6226
  "path": "packages/core/consumer/buildchain-config.js",
6227
- "line": 575
6227
+ "line": 556
6228
6228
  },
6229
6229
  "example": "import { getNativeDiagnosticsProfile } from \"@kungfu-tech/buildchain\";",
6230
6230
  "maturity": "stable",
@@ -6253,7 +6253,7 @@
6253
6253
  ],
6254
6254
  "source": {
6255
6255
  "path": "packages/core/consumer/buildchain-config.js",
6256
- "line": 1460
6256
+ "line": 1441
6257
6257
  },
6258
6258
  "example": "import { getPublishContract } from \"@kungfu-tech/buildchain\";",
6259
6259
  "maturity": "stable",
@@ -6282,7 +6282,7 @@
6282
6282
  ],
6283
6283
  "source": {
6284
6284
  "path": "packages/core/consumer/buildchain-config.js",
6285
- "line": 362
6285
+ "line": 343
6286
6286
  },
6287
6287
  "example": "import { getStableReleasePolicy } from \"@kungfu-tech/buildchain\";",
6288
6288
  "maturity": "stable",
@@ -6311,7 +6311,7 @@
6311
6311
  ],
6312
6312
  "source": {
6313
6313
  "path": "packages/core/consumer/buildchain-config.js",
6314
- "line": 1584
6314
+ "line": 1565
6315
6315
  },
6316
6316
  "example": "import { getVersionStrategy } from \"@kungfu-tech/buildchain\";",
6317
6317
  "maturity": "stable",
@@ -6333,7 +6333,7 @@
6333
6333
  ],
6334
6334
  "returns": "unknown",
6335
6335
  "errors": [
6336
- "May throw an Error on rejected input or failed operations; follow the linked source contract."
6336
+ "Errors from called operations may propagate; no narrower throw contract is declared in source."
6337
6337
  ],
6338
6338
  "sideEffects": [
6339
6339
  "none-detected-by-static-source-scan"
@@ -6373,7 +6373,7 @@
6373
6373
  ],
6374
6374
  "source": {
6375
6375
  "path": "packages/core/consumer/buildchain-config.js",
6376
- "line": 1593
6376
+ "line": 1574
6377
6377
  },
6378
6378
  "example": "import { loadConfiguredAnchorManifest } from \"@kungfu-tech/buildchain\";",
6379
6379
  "maturity": "stable",
@@ -6402,7 +6402,7 @@
6402
6402
  ],
6403
6403
  "source": {
6404
6404
  "path": "packages/core/consumer/buildchain-config.js",
6405
- "line": 206
6405
+ "line": 187
6406
6406
  },
6407
6407
  "example": "import { normalizeBuildchainConfig } from \"@kungfu-tech/buildchain\";",
6408
6408
  "maturity": "stable",
@@ -6439,7 +6439,7 @@
6439
6439
  ],
6440
6440
  "source": {
6441
6441
  "path": "packages/core/consumer/buildchain-config.js",
6442
- "line": 1417
6442
+ "line": 1398
6443
6443
  },
6444
6444
  "example": "import { normalizeLifecycleStage } from \"@kungfu-tech/buildchain\";",
6445
6445
  "maturity": "stable",
@@ -6468,7 +6468,7 @@
6468
6468
  ],
6469
6469
  "source": {
6470
6470
  "path": "packages/core/consumer/buildchain-config.js",
6471
- "line": 1464
6471
+ "line": 1445
6472
6472
  },
6473
6473
  "example": "import { runLifecycleStage } from \"@kungfu-tech/buildchain\";",
6474
6474
  "maturity": "stable",
@@ -6501,7 +6501,7 @@
6501
6501
  ],
6502
6502
  "source": {
6503
6503
  "path": "packages/core/consumer/buildchain-config.js",
6504
- "line": 1764
6504
+ "line": 1745
6505
6505
  },
6506
6506
  "example": "import { updateConfiguredVersionStateContents } from \"@kungfu-tech/buildchain\";",
6507
6507
  "maturity": "stable",
@@ -6534,7 +6534,7 @@
6534
6534
  ],
6535
6535
  "source": {
6536
6536
  "path": "packages/core/consumer/buildchain-config.js",
6537
- "line": 1631
6537
+ "line": 1612
6538
6538
  },
6539
6539
  "example": "import { validateBuildchainConfig } from \"@kungfu-tech/buildchain\";",
6540
6540
  "maturity": "stable",
@@ -12184,7 +12184,7 @@
12184
12184
  ],
12185
12185
  "source": {
12186
12186
  "path": "packages/core/governance/buildchain-publication-authority.js",
12187
- "line": 70
12187
+ "line": 71
12188
12188
  },
12189
12189
  "example": "import { buildchainPublicationAuthorityDescriptors } from \"@kungfu-tech/buildchain\";",
12190
12190
  "maturity": "stable",
@@ -12213,7 +12213,7 @@
12213
12213
  ],
12214
12214
  "source": {
12215
12215
  "path": "packages/core/governance/buildchain-publication-authority.js",
12216
- "line": 109
12216
+ "line": 110
12217
12217
  },
12218
12218
  "example": "import { createBuildchainPublicationAuthorityRegistry } from \"@kungfu-tech/buildchain\";",
12219
12219
  "maturity": "stable",
@@ -29127,7 +29127,7 @@
29127
29127
  "specifier": "@kungfu-tech/buildchain/buildchain-publication-authority",
29128
29128
  "export": "./buildchain-publication-authority",
29129
29129
  "target": "./packages/core/governance/buildchain-publication-authority.js",
29130
- "digest": "sha256:976b158cdf65dd00186733837d19b57341f02531f1d9daca2e189ca0ccc69a53",
29130
+ "digest": "sha256:57b7a0922c57daa5647a6e6439d36d62d80ec3a21050073330ff0c81df84ae24",
29131
29131
  "summary": "Buildchain-owned closed-world publication authority descriptor registry.",
29132
29132
  "capabilityGroup": "release-passport-trust",
29133
29133
  "audience": [
@@ -30102,7 +30102,7 @@
30102
30102
  {
30103
30103
  "id": "node-api-reference",
30104
30104
  "path": "docs/node-api-reference.md",
30105
- "digest": "sha256:23782a5348b073974490eee5e79e4fe0d614d75c1a884d5899730f75a9da01f2"
30105
+ "digest": "sha256:a7135f86b2c74078eed1b6fd920629addce974140d7f18a7cdc86c21c8fd7f8d"
30106
30106
  },
30107
30107
  {
30108
30108
  "id": "build-facts",