@kungfu-tech/buildchain 4.0.2-alpha.34 → 4.0.2-alpha.35

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 (91) hide show
  1. package/AGENTS.md +9 -0
  2. package/CONTRIBUTING.md +24 -0
  3. package/README.md +2 -2
  4. package/actions/promote-buildchain-ref/README.md +1 -1
  5. package/architecture/agent-change-map.md +6 -4
  6. package/architecture/internal-capabilities.json +4 -4
  7. package/architecture/maintainability-debt.json +13 -11
  8. package/architecture/maintainability-policy.json +4 -4
  9. package/architecture/release-tail-contract-inventory.json +6 -6
  10. package/architecture/v4-delivery-authority-parity.json +2 -2
  11. package/architecture/v4-delivery-warrant-shadow-bootstrap-plan.json +1 -1
  12. package/architecture/v4-floating-consumer-policy.json +1 -1
  13. package/architecture/v4-next-development-parity.json +4 -4
  14. package/architecture/v4-platform-stage-checkpoints.json +1 -1
  15. package/architecture/v4-publication-facade-patches.json +53 -0
  16. package/architecture/v4-release-topology.json +46 -29
  17. package/architecture/v4-rust-wasm-production-authority.json +1 -0
  18. package/architecture/v4-stage-capsule-qualification.json +1 -1
  19. package/architecture/v4-universal-workflow-bootstrap.json +1 -1
  20. package/architecture/v4-universal-workflow-fault-campaign.json +1 -1
  21. package/architecture/v4-universal-workflow-train-admission.json +4 -4
  22. package/architecture/workflow-taxonomy.json +1437 -0
  23. package/contracts/buildchain-v2-residuals-v1.json +64 -1
  24. package/contracts/fixtures/v4-tail-reseal-v1/valid.json +1 -1
  25. package/contracts/v4-canonical-contracts-v1.schema.json +1 -0
  26. package/dist/site/buildchain-contract.json +20 -20
  27. package/dist/site/buildchain-site.json +122 -56
  28. package/dist/site/capability-registry.json +4 -4
  29. package/dist/site/controller-registry.json +5 -4
  30. package/dist/site/kfd-claims.json +2617 -964
  31. package/dist/site/kfd-upstream-aggregate.json +1 -1
  32. package/dist/site/manual-registry.json +10 -10
  33. package/dist/site/node-api-registry.json +26 -21
  34. package/dist/site/page-registry.json +107 -41
  35. package/dist/site/public-surface-audit.json +3196 -1128
  36. package/dist/site/publication-authority-registry.json +1179 -417
  37. package/dist/site/publication-registry.json +4 -4
  38. package/dist/site/site-manifest.json +14 -14
  39. package/dist/site/workflow-registry.json +5484 -1924
  40. package/docs/MAP.md +1 -0
  41. package/docs/auditable-demo.md +1 -1
  42. package/docs/cli.md +3 -3
  43. package/docs/dev-delivery-warrant.md +1 -1
  44. package/docs/engineering-housekeeper.md +3 -3
  45. package/docs/next-development-transition.md +1 -1
  46. package/docs/node-api-reference.md +30 -30
  47. package/docs/publication-authority.md +2 -2
  48. package/docs/release-candidate.md +3 -3
  49. package/docs/release-flow.md +67 -19
  50. package/docs/release-governance.md +8 -8
  51. package/docs/v4-adopter-delivery.md +1 -1
  52. package/docs/v4-production-release.md +45 -8
  53. package/docs/v4-stage-capsule.md +1 -1
  54. package/docs/workflow-catalog.md +151 -0
  55. package/package.json +8 -6
  56. package/packages/core/buildchain-contract.js +1 -1
  57. package/packages/core/buildchain-kfd-claims.js +2 -2
  58. package/packages/core/buildchain-publication-authority.js +40 -25
  59. package/packages/core/buildchain-v4-domain.wasm +0 -0
  60. package/packages/core/controller-evidence.js +4 -1
  61. package/packages/core/github-governance-authority.js +4 -4
  62. package/packages/core/next-development-projection.js +1 -1
  63. package/packages/core/release-line-dry-run.js +1 -1
  64. package/packages/core/v4-canonical-contracts.js +1 -0
  65. package/packages/core/v4-domain-wasm-artifact.js +2 -2
  66. package/packages/core/v4-floating-consumer-evidence.js +1 -1
  67. package/packages/core/v4-floating-consumer-policy.js +1 -1
  68. package/scripts/binary-publication-evidence.mjs +135 -0
  69. package/scripts/check-ci-lane-change-budget.mjs +4 -1
  70. package/scripts/check-core-mechanism-inventory.mjs +4 -3
  71. package/scripts/check-inventory.mjs +22 -22
  72. package/scripts/check-v4-floating-consumer-policy-contract.mjs +1 -1
  73. package/scripts/check-v4-public-dogfood-contract.mjs +18 -5
  74. package/scripts/check-v4-release-topology.mjs +5 -2
  75. package/scripts/check-v4-runtime-semantic-closure.mjs +4 -1
  76. package/scripts/check-v4-universal-workflow-bootstrap.mjs +5 -9
  77. package/scripts/check-workflow-taxonomy.mjs +6 -0
  78. package/scripts/generate-channel-build-workflow.mjs +2 -1
  79. package/scripts/generate-channel-promotion-workflow.mjs +4 -3
  80. package/scripts/generate-site-bundle.mjs +11 -11
  81. package/scripts/generate-v4-universal-workflow-facades.mjs +24 -6
  82. package/scripts/generate-workflow-taxonomy.mjs +25 -0
  83. package/scripts/maintainability-metrics.mjs +16 -5
  84. package/scripts/release-asset-client.mjs +90 -0
  85. package/scripts/release-candidate-resolver.mjs +1 -1
  86. package/scripts/source-verification-evidence.mjs +344 -0
  87. package/scripts/stable-candidate-qualification.mjs +1 -1
  88. package/scripts/v4-publication-settlement.mjs +207 -0
  89. package/scripts/v4-universal-workflow-self-dogfood.mjs +1 -1
  90. package/scripts/verify-version-state-delta.mjs +173 -0
  91. package/scripts/workflow-taxonomy.mjs +468 -0
@@ -71,13 +71,76 @@
71
71
  "sunsetCondition": "Remove after wheel consumers migrate to the lifecycle version command."
72
72
  },
73
73
  {
74
- "path": ".github/workflows/candidate-lab.yml",
74
+ "path": ".github/workflows/self-build-candidate-lab.yml",
75
75
  "token": "default: \"v2\"",
76
76
  "expectedOccurrences": 1,
77
77
  "classification": "legacy-compatibility-ref",
78
78
  "callerStatus": "manual-no-publish-report-only",
79
79
  "owner": "buildchain-maintainers",
80
80
  "sunsetCondition": "Remove after the legacy workflows comparison lane is formally retired."
81
+ },
82
+ {
83
+ "path": ".github/workflows/.release-minor-bump-compat.yml",
84
+ "token": "kungfu-systems/buildchain/actions/bump-version@v2",
85
+ "expectedOccurrences": 1,
86
+ "classification": "legacy-compatibility-action",
87
+ "callerStatus": "legacy-reusable",
88
+ "owner": "buildchain-maintainers",
89
+ "sunsetCondition": "Remove after every known caller migrates to the lifecycle version command."
90
+ },
91
+ {
92
+ "path": ".github/workflows/.build-release-verify-compat.yml",
93
+ "token": "workflows v2",
94
+ "expectedOccurrences": 3,
95
+ "classification": "retired-path-tombstone",
96
+ "callerStatus": "fail-closed",
97
+ "owner": "buildchain-maintainers",
98
+ "sunsetCondition": "Remove each message with its corresponding retired input or path."
99
+ },
100
+ {
101
+ "path": ".github/workflows/.build-sam-verify-compat.yml",
102
+ "token": "kungfu-systems/buildchain/actions/bump-version@v2",
103
+ "expectedOccurrences": 3,
104
+ "classification": "legacy-compatibility-action",
105
+ "callerStatus": "legacy-reusable",
106
+ "owner": "buildchain-maintainers",
107
+ "sunsetCondition": "Remove after SAM consumers migrate to the lifecycle version command."
108
+ },
109
+ {
110
+ "path": ".github/workflows/.build-sam-verify-compat.yml",
111
+ "token": "aws-actions/setup-sam@v2",
112
+ "expectedOccurrences": 1,
113
+ "classification": "third-party-action-version",
114
+ "callerStatus": "legacy-reusable",
115
+ "owner": "aws-actions/setup-sam maintainers",
116
+ "sunsetCondition": "Upgrade through normal dependency review when a compatible successor is adopted."
117
+ },
118
+ {
119
+ "path": ".github/workflows/.release-page-sync-retired.yml",
120
+ "token": "retired in workflows v2",
121
+ "expectedOccurrences": 1,
122
+ "classification": "retired-path-tombstone",
123
+ "callerStatus": "fail-closed",
124
+ "owner": "buildchain-maintainers",
125
+ "sunsetCondition": "Remove only after the compatibility workflow entry itself is removed."
126
+ },
127
+ {
128
+ "path": ".github/workflows/.build-wheel-verify-compat.yml",
129
+ "token": "kungfu-systems/buildchain/actions/publish-prebuilt@v2",
130
+ "expectedOccurrences": 1,
131
+ "classification": "legacy-compatibility-action",
132
+ "callerStatus": "legacy-reusable",
133
+ "owner": "buildchain-maintainers",
134
+ "sunsetCondition": "Remove after wheel consumers migrate to the publication authority path."
135
+ },
136
+ {
137
+ "path": ".github/workflows/.build-wheel-verify-compat.yml",
138
+ "token": "kungfu-systems/buildchain/actions/bump-version@v2",
139
+ "expectedOccurrences": 3,
140
+ "classification": "legacy-compatibility-action",
141
+ "callerStatus": "legacy-reusable",
142
+ "owner": "buildchain-maintainers",
143
+ "sunsetCondition": "Remove after wheel consumers migrate to the lifecycle version command."
81
144
  }
82
145
  ]
83
146
  }
@@ -22,7 +22,7 @@
22
22
  "ref": "v4-alpha",
23
23
  "sha": "dddddddddddddddddddddddddddddddddddddddd",
24
24
  "contractRoot": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
25
- "consumerPolicyReceiptRoot": "sha256:8d8e55a4ae07a57a2a262e138f55148b05916c364b3d086530e1392c982b886f"
25
+ "consumerPolicyReceiptRoot": "sha256:0617db75edb0f213804a110e690403f3241a28d8a27303b172c6397ac7bc288a"
26
26
  },
27
27
  "warrant": {
28
28
  "candidateId": "candidate-alpha-2",
@@ -69,6 +69,7 @@
69
69
  "stage-capsule-quarantine",
70
70
  "stage-capsule-resume-observation",
71
71
  "stage-capsule-resume-plan",
72
+ "source-verification-evidence",
72
73
  "stage-capsule-artifact-manifest",
73
74
  "stage-capsule-artifact-content",
74
75
  "stage-capsule-fault-campaign",
@@ -4,7 +4,7 @@
4
4
  "product": {
5
5
  "name": "Buildchain",
6
6
  "package": "@kungfu-tech/buildchain",
7
- "version": "4.0.2-alpha.34",
7
+ "version": "4.0.2-alpha.35",
8
8
  "repository": "https://github.com/kungfu-systems/buildchain"
9
9
  },
10
10
  "majorLine": "v4",
@@ -1591,7 +1591,7 @@
1591
1591
  "GitHub Release passport and evidence publication is delegated to promote-buildchain-ref after the semver release transaction completes"
1592
1592
  ],
1593
1593
  "breakingDigest": "sha256:5f10c81d3f80cb417960be682921884639c40b6d875f1a3b1ffae7e652c3f468",
1594
- "auditDigest": "sha256:c4d5fed7a21a3dee45777aef0b3eff3cc6da9884cf64131ffc85217ef7c16503"
1594
+ "auditDigest": "sha256:66409a757d8b009e7704c4dfc779ae009fa27d2db47cf307818eb3230b6721b7"
1595
1595
  },
1596
1596
  {
1597
1597
  "contractVersion": 1,
@@ -1646,7 +1646,7 @@
1646
1646
  "resume-from-candidate-run is fail-closed and uses a fresh caller event instead of rerunning a frozen startup graph"
1647
1647
  ],
1648
1648
  "breakingDigest": "sha256:9db8dd07152855d03ff30f9c571438593c689d3e8139fa45431d000f548242f5",
1649
- "auditDigest": "sha256:177b3c50685405e5ed2bf1ac893469fdb3a27e7b03d55025611b2985028cd8cf",
1649
+ "auditDigest": "sha256:9c7f3586a3444cdad34d2a61be3cb9b0ae271fb56f9e371d9c37940e6b317780",
1650
1650
  "compatibleBreakingDigests": [
1651
1651
  "sha256:aa30f22e3af0a89841310bdbdc900844dd95a66974db173fa140a71bbd7e82c0"
1652
1652
  ],
@@ -2257,7 +2257,7 @@
2257
2257
  "manual entries carry source file digests so downstream sites and agents can detect stale hand-written documentation"
2258
2258
  ],
2259
2259
  "breakingDigest": "sha256:7d0d2819e3a3e72989d9c57b5efe9d0bc0a79bc0f2c82a0c7b9d6c5a211a91f2",
2260
- "auditDigest": "sha256:1a6a84869fc898263bb531ccfd6ec77260b618d16f0927f41d0da5ede708fab5"
2260
+ "auditDigest": "sha256:89d4116d2f9a1d6b00800180125aa5afbbec46ef17c400fa636327762f9a588f"
2261
2261
  },
2262
2262
  {
2263
2263
  "contractVersion": 1,
@@ -2279,7 +2279,7 @@
2279
2279
  "agents can discover supported Node APIs without importing internal file paths"
2280
2280
  ],
2281
2281
  "breakingDigest": "sha256:48f925608d3e2131d90936b07dc2a30341204cae3e6e785c0f77d61ad755c945",
2282
- "auditDigest": "sha256:318ce9c5c5ada815227a11e89418ab72854860cb61fd46ec58c6a69cd3dea58e"
2282
+ "auditDigest": "sha256:39e9418554b9aeeb297a90818d20c3dc79ee418a8d2d8fbdf4bae689a9abc5ae"
2283
2283
  },
2284
2284
  {
2285
2285
  "contractVersion": 1,
@@ -2336,7 +2336,7 @@
2336
2336
  "controllerDescriptor": {
2337
2337
  "contract": "buildchain.controller-descriptor/v1",
2338
2338
  "digest": "sha256:cdb7dc4e69031dcd2c590789c666ececbad6bcc9cb916ae5b7f4cee4cda6d63e",
2339
- "registryDigest": "sha256:8b299ccf80925444055224f027b94aaab73741bf14e9302976eb0354053d1d31",
2339
+ "registryDigest": "sha256:6e49d5c9b70da381067ef03e088cb635ef7f4dba7fc56c7fa82e4c00784cf013",
2340
2340
  "inputClassifications": {
2341
2341
  "buildchain-ref": {
2342
2342
  "classification": "included",
@@ -2551,7 +2551,7 @@
2551
2551
  "controllerDescriptor": {
2552
2552
  "contract": "buildchain.controller-descriptor/v1",
2553
2553
  "digest": "sha256:939f1ac15513a0417b539b3d10e875a9f0ea02e885facac9fa4de0ab0e1f8ee5",
2554
- "registryDigest": "sha256:8b299ccf80925444055224f027b94aaab73741bf14e9302976eb0354053d1d31",
2554
+ "registryDigest": "sha256:6e49d5c9b70da381067ef03e088cb635ef7f4dba7fc56c7fa82e4c00784cf013",
2555
2555
  "inputClassifications": {
2556
2556
  "BUILDCHAIN_ARTIFACT_RELAY_S3_DOWNLOAD_ROLE_ARN": {
2557
2557
  "classification": "redacted",
@@ -3133,7 +3133,7 @@
3133
3133
  "controllerDescriptor": {
3134
3134
  "contract": "buildchain.controller-descriptor/v1",
3135
3135
  "digest": "sha256:382ae38afbf17236d093ec5bf945b7a151b99dacd1af53ac447c1ca5de73b956",
3136
- "registryDigest": "sha256:8b299ccf80925444055224f027b94aaab73741bf14e9302976eb0354053d1d31",
3136
+ "registryDigest": "sha256:6e49d5c9b70da381067ef03e088cb635ef7f4dba7fc56c7fa82e4c00784cf013",
3137
3137
  "inputClassifications": {
3138
3138
  "BUILDCHAIN_ARTIFACT_RELAY_S3_DOWNLOAD_ROLE_ARN": {
3139
3139
  "classification": "redacted",
@@ -3648,7 +3648,7 @@
3648
3648
  "controllerDescriptor": {
3649
3649
  "contract": "buildchain.controller-descriptor/v1",
3650
3650
  "digest": "sha256:76c8da1ca1d7c6014cbda3ae3c82b2e28dafda45ddc7d3b4d6fccb6d3fd4853e",
3651
- "registryDigest": "sha256:8b299ccf80925444055224f027b94aaab73741bf14e9302976eb0354053d1d31",
3651
+ "registryDigest": "sha256:6e49d5c9b70da381067ef03e088cb635ef7f4dba7fc56c7fa82e4c00784cf013",
3652
3652
  "inputClassifications": {
3653
3653
  "artifact-name": {
3654
3654
  "classification": "included",
@@ -3872,7 +3872,7 @@
3872
3872
  "controllerDescriptor": {
3873
3873
  "contract": "buildchain.controller-descriptor/v1",
3874
3874
  "digest": "sha256:8977c5222c4e30ee2d22e6519add1760cbbd917097b57f576d249001918217c8",
3875
- "registryDigest": "sha256:8b299ccf80925444055224f027b94aaab73741bf14e9302976eb0354053d1d31",
3875
+ "registryDigest": "sha256:6e49d5c9b70da381067ef03e088cb635ef7f4dba7fc56c7fa82e4c00784cf013",
3876
3876
  "inputClassifications": {
3877
3877
  "artifact-path": {
3878
3878
  "classification": "digest-only",
@@ -4131,7 +4131,7 @@
4131
4131
  "controllerDescriptor": {
4132
4132
  "contract": "buildchain.controller-descriptor/v1",
4133
4133
  "digest": "sha256:6768756f1a1855ffec164c9745a45805b775741d2ef72f464bfac093efffee7d",
4134
- "registryDigest": "sha256:8b299ccf80925444055224f027b94aaab73741bf14e9302976eb0354053d1d31",
4134
+ "registryDigest": "sha256:6e49d5c9b70da381067ef03e088cb635ef7f4dba7fc56c7fa82e4c00784cf013",
4135
4135
  "inputClassifications": {
4136
4136
  "artifact-name": {
4137
4137
  "classification": "included",
@@ -4326,7 +4326,7 @@
4326
4326
  "controllerDescriptor": {
4327
4327
  "contract": "buildchain.controller-descriptor/v1",
4328
4328
  "digest": "sha256:24602f0ed35bbfb794051921b90686c9eed2434b17fd5da14e9ad95355c01634",
4329
- "registryDigest": "sha256:8b299ccf80925444055224f027b94aaab73741bf14e9302976eb0354053d1d31",
4329
+ "registryDigest": "sha256:6e49d5c9b70da381067ef03e088cb635ef7f4dba7fc56c7fa82e4c00784cf013",
4330
4330
  "inputClassifications": {
4331
4331
  "artifact-name": {
4332
4332
  "classification": "included",
@@ -4674,7 +4674,7 @@
4674
4674
  "controllerDescriptor": {
4675
4675
  "contract": "buildchain.controller-descriptor/v1",
4676
4676
  "digest": "sha256:13a70da4c3234954c2acf5ff96c077e00b06297316bb2287ce28661ce1e62ef1",
4677
- "registryDigest": "sha256:8b299ccf80925444055224f027b94aaab73741bf14e9302976eb0354053d1d31",
4677
+ "registryDigest": "sha256:6e49d5c9b70da381067ef03e088cb635ef7f4dba7fc56c7fa82e4c00784cf013",
4678
4678
  "inputClassifications": {
4679
4679
  "BUILDCHAIN_ISSUE_APP_ID": {
4680
4680
  "classification": "redacted",
@@ -5213,7 +5213,7 @@
5213
5213
  "missing receipts are non-qualifying and must not be represented as a successful controller run"
5214
5214
  ],
5215
5215
  "breakingDigest": "sha256:015d8de793adbd4c539416be7d7512e18cc92097e629b0203fa06d2c183e98bd",
5216
- "auditDigest": "sha256:177b3c50685405e5ed2bf1ac893469fdb3a27e7b03d55025611b2985028cd8cf"
5216
+ "auditDigest": "sha256:9c7f3586a3444cdad34d2a61be3cb9b0ae271fb56f9e371d9c37940e6b317780"
5217
5217
  },
5218
5218
  {
5219
5219
  "contractVersion": 1,
@@ -5279,7 +5279,7 @@
5279
5279
  "controllerDescriptor": {
5280
5280
  "contract": "buildchain.controller-descriptor/v1",
5281
5281
  "digest": "sha256:e5aca2f9ebac530742cae8aa1e5959179bc3eca29bba384dd8f7cdf5821f5648",
5282
- "registryDigest": "sha256:8b299ccf80925444055224f027b94aaab73741bf14e9302976eb0354053d1d31",
5282
+ "registryDigest": "sha256:6e49d5c9b70da381067ef03e088cb635ef7f4dba7fc56c7fa82e4c00784cf013",
5283
5283
  "inputClassifications": {
5284
5284
  "agent-work-context-json": {
5285
5285
  "classification": "digest-only",
@@ -5391,7 +5391,7 @@
5391
5391
  "additiveChanges": "optional inputs, optional outputs, diagnostics, and documentation may be added within the same major line",
5392
5392
  "id": "controller:binary-distribution",
5393
5393
  "kind": "controller",
5394
- "path": ".github/workflows/binary-distribution.yml",
5394
+ "path": ".github/workflows/self-build-binary-distribution.yml",
5395
5395
  "requiredInputs": [],
5396
5396
  "requiredOutputs": [
5397
5397
  "controller-plan-json",
@@ -5426,8 +5426,8 @@
5426
5426
  "optionalInputs": [],
5427
5427
  "controllerDescriptor": {
5428
5428
  "contract": "buildchain.controller-descriptor/v1",
5429
- "digest": "sha256:b6f53563c0adc859bc586c05fce560a5094d7d9666438d63c5fd3e1fc4774555",
5430
- "registryDigest": "sha256:8b299ccf80925444055224f027b94aaab73741bf14e9302976eb0354053d1d31",
5429
+ "digest": "sha256:79fcf0b55df11186a5096aca13eaa965768ce7ee84b1e979eb1463f0b3f4e05e",
5430
+ "registryDigest": "sha256:6e49d5c9b70da381067ef03e088cb635ef7f4dba7fc56c7fa82e4c00784cf013",
5431
5431
  "inputClassifications": {}
5432
5432
  },
5433
5433
  "guarantees": [
@@ -5437,12 +5437,12 @@
5437
5437
  "missing receipts are non-qualifying and must not be represented as a successful controller run"
5438
5438
  ],
5439
5439
  "breakingDigest": "sha256:7c18fdd3df180db9e1f043a2286ef3f02fae60b84e42b76cd50da9cfeb77883d",
5440
- "auditDigest": "sha256:d07482cd66413a2fb3781a3b76f960b8151b6231841799647fe237820de2fde6"
5440
+ "auditDigest": "sha256:60a99366c243554e0b5f494754d6c0ccfdfc4a1b1d345e33de96893e39acf32d"
5441
5441
  }
5442
5442
  ],
5443
5443
  "compatibilityFactRegistryRoot": "sha256:232fd556a2372b29db586bbc2acbdfce6464a68c93902797ff527f75f7816c42",
5444
5444
  "compatibilityFactCutRoot": "sha256:f61b975d4a96c921cc4bd37fb3ed9a0596b47004fe34dc7219979d697e3707f9",
5445
5445
  "compatibilityProofRegistryRoot": "sha256:b7194b811e4d3af2df4390bc4d1731e16a86215bd64ee18cb630dd5492f4fb63",
5446
5446
  "compatibilityDigest": "sha256:20411029d83211dff426fb6535a608902129844a5ccb4788db77d3f81becb839",
5447
- "contractDigest": "sha256:5581b24ca2b0f86ee21594bf09673997498f93f4505c3433b6d672107881bdc2"
5447
+ "contractDigest": "sha256:8d9e16600d07bcf8dbd7989eaacb4f7d60e259c6483fe56f1d61d99bf8ccf8da"
5448
5448
  }