@kungfu-tech/buildchain 3.0.9-alpha.8 → 4.0.0-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.
Files changed (255) hide show
  1. package/AGENTS.md +39 -0
  2. package/README.md +17 -13
  3. package/actions/promote-buildchain-ref/README.md +0 -10
  4. package/actions/release-tail/README.md +6 -10
  5. package/architecture/internal-capabilities.json +502 -0
  6. package/architecture/maintainability-baseline.json +59 -0
  7. package/architecture/maintainability-policy.json +1384 -0
  8. package/architecture/release-tail-contract-inventory.json +587 -0
  9. package/architecture/v3-core-mechanism-inventory.json +1043 -0
  10. package/architecture/v3-core-mechanism-inventory.md +67 -0
  11. package/architecture/v4-adopter-delivery-parity.json +47 -0
  12. package/architecture/v4-architecture-constitution.md +210 -0
  13. package/architecture/v4-bootstrap-authority.json +56 -0
  14. package/architecture/v4-canonical-contract-fixtures.json +105 -0
  15. package/architecture/v4-capability-state-machine-manifest.json +480 -0
  16. package/architecture/v4-capability-state-machine-manifest.schema.json +202 -0
  17. package/architecture/v4-delivery-warrant-shadow-bootstrap-plan.json +830 -0
  18. package/architecture/v4-delivery-warrant-shadow-bootstrap-plan.md +223 -0
  19. package/architecture/v4-delivery-warrant-shadow-bootstrap-plan.schema.json +318 -0
  20. package/architecture/v4-delivery-warrant-shadow-fixtures.json +227 -0
  21. package/architecture/v4-delivery-warrant-shadow-fixtures.schema.json +67 -0
  22. package/architecture/v4-exception-ledger.json +5 -0
  23. package/architecture/v4-exception-ledger.schema.json +56 -0
  24. package/architecture/v4-partial-mutation-recovery-qualification.json +65 -0
  25. package/architecture/v4-platform-stage-checkpoints.json +97 -0
  26. package/architecture/v4-provider-operation-journal-contract.json +113 -0
  27. package/architecture/v4-release-activation-shadow-domain.json +61 -0
  28. package/architecture/v4-release-train-parity.json +68 -0
  29. package/architecture/v4-rust-libnode-bridge-evaluation.json +107 -0
  30. package/architecture/v4-rust-libnode-bridge-spike.md +85 -0
  31. package/architecture/v4-stable-publication-fence.json +66 -0
  32. package/architecture/v4-stage-capsule-contract.json +90 -0
  33. package/architecture/v4-stage-capsule-qualification.json +99 -0
  34. package/architecture/v4-stage-capsule-resume-planner.json +52 -0
  35. package/architecture/v4-stage-capsule-store-contract.json +72 -0
  36. package/bin/buildchain.mjs +15 -6
  37. package/contracts/auditable-demo-scenario-v1.schema.json +1 -1
  38. package/contracts/buildchain-v2-residuals-v1.json +2 -2
  39. package/contracts/fixtures/v4-delivery-warrant-trace-v1/golden.json +158 -0
  40. package/contracts/fixtures/v4-delivery-warrant-trace-v1/property.json +380 -0
  41. package/contracts/fixtures/v4-delivery-warrant-trace-v1/replay.json +163 -0
  42. package/contracts/fixtures/v4-partial-mutation-recovery-v1/shared.json +155 -0
  43. package/contracts/fixtures/v4-provider-operation-journal-v1/shared.json +457 -0
  44. package/contracts/fixtures/v4-provider-readback-idempotency-v1/shared.json +682 -0
  45. package/contracts/fixtures/v4-release-activation-shadow-v1/shared.json +53 -0
  46. package/contracts/fixtures/v4-stable-publication-fence-v1/shared.json +56 -0
  47. package/contracts/fixtures/v4-stage-capsule-resume-v1/late-platform-failure.json +176 -0
  48. package/contracts/fixtures/v4-stage-capsule-store-v1/shared.json +132 -0
  49. package/contracts/fixtures/v4-stage-capsule-v1/shared.json +111 -0
  50. package/contracts/v4-canonical-contracts-v1.schema.json +182 -0
  51. package/contracts/v4-delivery-warrant-semantic-diff-report-v1.schema.json +284 -0
  52. package/contracts/v4-delivery-warrant-trace-v1.schema.json +215 -0
  53. package/contracts/v4-host-contract-v1.schema.json +135 -0
  54. package/contracts/v4-partial-mutation-recovery-v1.schema.json +168 -0
  55. package/contracts/v4-provider-operation-journal-v1.schema.json +381 -0
  56. package/contracts/v4-release-activation-shadow-v1.schema.json +186 -0
  57. package/contracts/v4-stable-publication-fence-v1.schema.json +125 -0
  58. package/contracts/v4-stage-capsule-resume-v1.schema.json +225 -0
  59. package/contracts/v4-stage-capsule-store-v1.schema.json +154 -0
  60. package/contracts/v4-stage-capsule-v1.schema.json +178 -0
  61. package/crates/buildchain-v4-bridge/Cargo.lock +213 -0
  62. package/crates/buildchain-v4-bridge/Cargo.toml +12 -0
  63. package/crates/buildchain-v4-bridge/src/main.rs +495 -0
  64. package/dist/site/agent-index.json +0 -3
  65. package/dist/site/artifact-schemas.json +0 -6
  66. package/dist/site/buildchain-contract.json +103 -397
  67. package/dist/site/buildchain-site.json +302 -270
  68. package/dist/site/capability-registry.json +9 -11
  69. package/dist/site/cli-registry.json +8 -30
  70. package/dist/site/controller-registry.json +48 -8
  71. package/dist/site/kfd-claims.json +129 -142
  72. package/dist/site/kfd-upstream-aggregate.json +9 -9
  73. package/dist/site/manual-registry.json +18 -49
  74. package/dist/site/node-api-registry.json +1882 -4118
  75. package/dist/site/page-registry.json +278 -230
  76. package/dist/site/public-surface-audit.json +87 -185
  77. package/dist/site/publication-authority-registry.json +11 -1
  78. package/dist/site/publication-registry.json +4 -4
  79. package/dist/site/release-provenance.json +3 -7
  80. package/dist/site/schemas/kfd-support-projection-v1.schema.json +106 -0
  81. package/dist/site/site-manifest.json +22 -38
  82. package/dist/site/workflow-registry.json +80 -35
  83. package/docs/MAP.md +8 -4
  84. package/docs/auditable-demo.md +2 -2
  85. package/docs/aws-us-elastic-runner-burst-plane.md +7 -59
  86. package/docs/cli-reference.md +15 -92
  87. package/docs/cli.md +14 -14
  88. package/docs/dev-alpha-candidate-patrol.md +3 -11
  89. package/docs/dev-delivery-warrant.md +28 -100
  90. package/docs/engineering-housekeeper.md +12 -4
  91. package/docs/getting-started.md +1 -1
  92. package/docs/install.md +5 -5
  93. package/docs/kfd-support.md +2 -7
  94. package/docs/lifecycle-protocol.md +2 -4
  95. package/docs/node-api-reference.md +414 -523
  96. package/docs/release-flow.md +31 -31
  97. package/docs/release-governance.md +16 -28
  98. package/docs/release-passport.md +2 -15
  99. package/docs/release-tail-contract.md +13 -6
  100. package/docs/release-tail-provider-plane.md +13 -19
  101. package/docs/release-train.md +4 -4
  102. package/docs/reusable-build-surface.md +14 -27
  103. package/docs/site-bundle-contract.md +1 -5
  104. package/docs/stable-candidate-patrol.md +7 -7
  105. package/docs/v4-canonical-contracts.md +92 -0
  106. package/docs/v4-delivery-warrant-read-candidate.md +73 -0
  107. package/docs/v4-delivery-warrant-semantic-diff.md +75 -0
  108. package/docs/v4-production-release.md +63 -0
  109. package/docs/v4-stage-capsule.md +193 -0
  110. package/docs/versioning.md +3 -3
  111. package/package.json +19 -17
  112. package/packages/core/adopter-delivery-gate.js +576 -0
  113. package/packages/core/adopter-delivery-json.js +66 -0
  114. package/packages/core/artifact-signing.js +0 -61
  115. package/packages/core/artifact-verification-envelope.js +5 -5
  116. package/packages/core/build-facts.js +12 -4
  117. package/packages/core/buildchain-agent-manuals.js +0 -2
  118. package/packages/core/buildchain-config.js +4 -69
  119. package/packages/core/buildchain-contract.js +232 -46
  120. package/packages/core/buildchain-kfd-claims.js +1 -1
  121. package/packages/core/channel-candidate.js +0 -8
  122. package/packages/core/channel-promotion-baseline.js +0 -52
  123. package/packages/core/controller-evidence.js +3 -4
  124. package/packages/core/dev-alpha-candidate-selection.js +2 -10
  125. package/packages/core/dev-delivery-warrant-cancellation.js +0 -1
  126. package/packages/core/dev-delivery-warrant-settlement.js +1 -5
  127. package/packages/core/dev-delivery-warrant.js +12 -52
  128. package/packages/core/diagnostics.js +3 -8
  129. package/packages/core/github-governance-authority.js +3 -1
  130. package/packages/core/kfd-adopter-category-driver.js +167 -0
  131. package/packages/core/kfd-adopter-manifest.js +47 -46
  132. package/packages/core/kfd-gate.js +15 -45
  133. package/packages/core/paper-agent-entry.js +7 -16
  134. package/packages/core/paper-fleet.js +2 -2
  135. package/packages/core/paper-repository.js +2 -3
  136. package/packages/core/paper-scaffold-content.js +2 -23
  137. package/packages/core/paper.js +11 -43
  138. package/packages/core/publication-reproducibility.js +4 -4
  139. package/packages/core/release-line-bootstrap.js +21 -8
  140. package/packages/core/release-passport-contract.js +5 -5
  141. package/packages/core/release-passport.js +20 -131
  142. package/packages/core/self-dogfood-version.js +48 -35
  143. package/packages/core/spawn-command.js +232 -8
  144. package/packages/core/v4-adopter-delivery-parity.js +219 -0
  145. package/packages/core/v4-canonical-contracts.js +284 -0
  146. package/packages/core/v4-delivery-warrant-fixture-runner.js +371 -0
  147. package/packages/core/v4-delivery-warrant-read-candidate.js +279 -0
  148. package/packages/core/v4-delivery-warrant-semantic-diff-gate.js +352 -0
  149. package/packages/core/v4-delivery-warrant-shadow-adapter.js +447 -0
  150. package/packages/core/v4-partial-mutation-recovery-qualification.js +395 -0
  151. package/packages/core/v4-platform-stage-checkpoints.js +471 -0
  152. package/packages/core/v4-provider-operation-journal.js +531 -0
  153. package/packages/core/v4-provider-readback-idempotency.js +394 -0
  154. package/packages/core/v4-release-activation-shadow.js +519 -0
  155. package/packages/core/v4-stable-publication-fence.js +357 -0
  156. package/packages/core/v4-stage-capsule-local-store.js +426 -0
  157. package/packages/core/v4-stage-capsule-qualification-campaign.js +512 -0
  158. package/packages/core/v4-stage-capsule-qualification.js +456 -0
  159. package/packages/core/v4-stage-capsule-resume-planner.js +397 -0
  160. package/packages/core/v4-stage-capsule-store.js +401 -0
  161. package/packages/core/v4-stage-capsule.js +319 -0
  162. package/scripts/assemble-self-publication-admission.mjs +1 -1
  163. package/scripts/audit-publication-control-plane.mjs +5 -5
  164. package/scripts/auditable-demo-bundle-verification.mjs +3 -2
  165. package/scripts/auditable-demo-platform.mjs +2 -2
  166. package/scripts/auditable-demo-renditions.mjs +1 -1
  167. package/scripts/auditable-demo.mjs +2 -2
  168. package/scripts/aws-macos-jit-controller-core.mjs +13 -346
  169. package/scripts/aws-macos-jit-controller-runtime.mjs +2 -210
  170. package/scripts/aws-macos-jit-controller.mjs +37 -275
  171. package/scripts/aws-macos-jit-core.mjs +3 -41
  172. package/scripts/aws-macos-jit.mjs +0 -12
  173. package/scripts/aws-windows-jit-campaign.mjs +2 -2
  174. package/scripts/aws-windows-jit-controller-core.mjs +1 -1
  175. package/scripts/aws-windows-jit-controller.mjs +3 -3
  176. package/scripts/build-contract-core.mjs +3 -8
  177. package/scripts/build-standalone-binary.mjs +3 -14
  178. package/scripts/buildchain-channel-router.mjs +4 -0
  179. package/scripts/buildchain-cli-help.mjs +7 -13
  180. package/scripts/buildchain-contract-lock.mjs +0 -6
  181. package/scripts/check-action-bundles.mjs +3 -4
  182. package/scripts/check-internal-architecture.mjs +7 -6
  183. package/scripts/check-inventory.mjs +30 -25
  184. package/scripts/check-v4-public-dogfood-contract.mjs +270 -0
  185. package/scripts/create-release-bundle.mjs +8 -4
  186. package/scripts/dev-alpha-candidate-patrol.mjs +1 -22
  187. package/scripts/dev-delivery-proof.mjs +2 -54
  188. package/scripts/dev-delivery-warrant.mjs +59 -77
  189. package/scripts/dev-pr-auto-merge.mjs +4 -30
  190. package/scripts/dev-pr-delivery-warrant.mjs +0 -55
  191. package/scripts/dispatch-artifact-signing-authority.mjs +7 -4
  192. package/scripts/generate-buildchain-kfd-witnesses.mjs +94 -88
  193. package/scripts/generate-channel-build-workflow.mjs +54 -24
  194. package/scripts/generate-channel-promotion-workflow.mjs +15 -6
  195. package/scripts/generate-site-bundle.mjs +5 -21
  196. package/scripts/git-fetch-process-tree.mjs +34 -1
  197. package/scripts/init-repo.mjs +64 -159
  198. package/scripts/inspect-artifact-signing-requests.mjs +0 -6
  199. package/scripts/locked-source-checkout.mjs +3 -4
  200. package/scripts/maintainability-metrics.mjs +8 -2
  201. package/scripts/npm-publish-dry-run.mjs +2 -2
  202. package/scripts/npm-publish-transaction.mjs +2 -2
  203. package/scripts/publication-commit-evidence.mjs +23 -69
  204. package/scripts/release-candidate-resolver.mjs +11 -17
  205. package/scripts/release-tail.mjs +3 -49
  206. package/scripts/resume-from-candidate-run.mjs +9 -123
  207. package/scripts/run-lifecycle-core.mjs +12 -13
  208. package/scripts/seal-artifact-signing-requests.mjs +17 -21
  209. package/scripts/site-capability-metadata.mjs +2 -7
  210. package/scripts/stable-candidate-qualification.mjs +10 -10
  211. package/scripts/v4-architecture.mjs +12 -2
  212. package/scripts/v4-bridge-bootstrap.mjs +141 -0
  213. package/scripts/v4-bridge-evidence.mjs +141 -0
  214. package/scripts/v4-host-adapter.mjs +182 -0
  215. package/scripts/v4-platform-stage-checkpoint-rehearsal.mjs +207 -0
  216. package/scripts/v4-stage-capsule-qualification.mjs +528 -0
  217. package/scripts/v4-stage-capsule-resume-rehearsal.mjs +57 -0
  218. package/scripts/v4-warrant-shadow-plan.mjs +601 -0
  219. package/scripts/verify-golden-path.mjs +5 -5
  220. package/scripts/web-surface-cloudfront-rewrite.mjs +15 -15
  221. package/scripts/web-surface-core.mjs +2 -8
  222. package/scripts/workflow-call-contract.mjs +5 -184
  223. package/contracts/fixtures/kfd-adopter-release-v1/kfd-4-perspective.json +0 -16
  224. package/contracts/fixtures/kfd-adopter-release-v1/kfd-4-replay.json +0 -57
  225. package/contracts/fixtures/next-development-transition-v1/anchored-manual-waiting.json +0 -47
  226. package/contracts/fixtures/next-development-transition-v1/semver-auto-planned.json +0 -47
  227. package/contracts/fixtures/next-development-transition-v1/version-model-cases.json +0 -40
  228. package/contracts/next-development-request-v1.schema.json +0 -66
  229. package/contracts/next-development-transition-v1.schema.json +0 -292
  230. package/contracts/publication-rehearsal-capsule-v1.schema.json +0 -173
  231. package/dist/site/schemas/publication-rehearsal-capsule-v1.schema.json +0 -269
  232. package/dist/site/schemas/release-tail-capabilities-v1.schema.json +0 -353
  233. package/dist/site/schemas/release-tail-provider-bindings-v1.schema.json +0 -94
  234. package/docs/next-development-transition.md +0 -119
  235. package/docs/publication-rehearsal.md +0 -94
  236. package/packages/core/buildchain-compatibility-proof.js +0 -631
  237. package/packages/core/dev-delivery-native-proof.js +0 -333
  238. package/packages/core/dev-delivery-warrant-shadow.js +0 -502
  239. package/packages/core/next-development-candidate-reservation.js +0 -186
  240. package/packages/core/next-development-controller.js +0 -726
  241. package/packages/core/next-development-projection.js +0 -288
  242. package/packages/core/next-development-transition.js +0 -738
  243. package/packages/core/publication-rehearsal-projection.js +0 -173
  244. package/packages/core/publication-rehearsal-runtime.js +0 -921
  245. package/scripts/aws-macos-jit-instance-rehydrate.mjs +0 -260
  246. package/scripts/aws-macos-jit-source-rebind.mjs +0 -724
  247. package/scripts/dev-delivery-native-run.mjs +0 -187
  248. package/scripts/dev-delivery-two-phase.mjs +0 -598
  249. package/scripts/generate-next-development-guidance.mjs +0 -49
  250. package/scripts/materialize-self-release-candidate-version.mjs +0 -137
  251. package/scripts/next-development-self-dogfood-harness.mjs +0 -409
  252. package/scripts/next-development-self-dogfood.mjs +0 -532
  253. package/scripts/next-development-transition.mjs +0 -47
  254. package/scripts/release-candidate-tail-reseal.mjs +0 -426
  255. package/templates/native-dev-delivery.yml +0 -82
@@ -1,269 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://buildchain.kungfu.ai/contracts/publication-rehearsal-capsule-v1.schema.json",
4
- "title": "Buildchain publication rehearsal capsule",
5
- "type": "object",
6
- "additionalProperties": false,
7
- "required": [
8
- "contract",
9
- "schemaVersion",
10
- "root",
11
- "declaration",
12
- "policyRoots",
13
- "passport",
14
- "transaction",
15
- "files",
16
- "providerBindings",
17
- "providerObservations",
18
- "runtime"
19
- ],
20
- "properties": {
21
- "contract": {
22
- "const": "kungfu.buildchain.publication-rehearsal-capsule/v1"
23
- },
24
- "schemaVersion": {
25
- "const": 1
26
- },
27
- "root": {
28
- "$ref": "#/$defs/root"
29
- },
30
- "declaration": {
31
- "$ref": "release-tail-capabilities-v1.schema.json"
32
- },
33
- "policyRoots": {
34
- "type": "array",
35
- "minItems": 1,
36
- "uniqueItems": true,
37
- "items": {
38
- "$ref": "#/$defs/root"
39
- }
40
- },
41
- "passport": {
42
- "type": "object",
43
- "additionalProperties": false,
44
- "required": [
45
- "path",
46
- "root"
47
- ],
48
- "properties": {
49
- "path": {
50
- "$ref": "#/$defs/path"
51
- },
52
- "root": {
53
- "$ref": "#/$defs/root"
54
- }
55
- }
56
- },
57
- "transaction": {
58
- "type": "object",
59
- "required": [
60
- "schema",
61
- "transactionPolicy",
62
- "transactionRoot",
63
- "declarationRoot",
64
- "planRoot",
65
- "subject",
66
- "state",
67
- "operationOrder",
68
- "operations",
69
- "observations",
70
- "receipts",
71
- "failure",
72
- "stateRoot"
73
- ]
74
- },
75
- "files": {
76
- "type": "array",
77
- "minItems": 1,
78
- "items": {
79
- "type": "object",
80
- "additionalProperties": false,
81
- "required": [
82
- "role",
83
- "path",
84
- "size",
85
- "root"
86
- ],
87
- "properties": {
88
- "role": {
89
- "type": "string",
90
- "minLength": 1
91
- },
92
- "path": {
93
- "$ref": "#/$defs/path"
94
- },
95
- "size": {
96
- "type": "integer",
97
- "minimum": 0
98
- },
99
- "root": {
100
- "$ref": "#/$defs/root"
101
- }
102
- }
103
- }
104
- },
105
- "providerBindings": {
106
- "$ref": "release-tail-provider-bindings-v1.schema.json"
107
- },
108
- "providerObservations": {
109
- "type": "array",
110
- "items": {
111
- "type": "object",
112
- "additionalProperties": false,
113
- "required": [
114
- "operationId",
115
- "readbacks",
116
- "apply"
117
- ],
118
- "properties": {
119
- "operationId": {
120
- "$ref": "#/$defs/root"
121
- },
122
- "readbacks": {
123
- "type": "array",
124
- "minItems": 1,
125
- "items": {
126
- "$ref": "#/$defs/observation"
127
- }
128
- },
129
- "apply": {
130
- "type": "object",
131
- "additionalProperties": false,
132
- "required": [
133
- "outcome",
134
- "code",
135
- "classification"
136
- ],
137
- "properties": {
138
- "outcome": {
139
- "enum": [
140
- "applied",
141
- "transient",
142
- "conflict"
143
- ]
144
- },
145
- "code": {
146
- "type": "string",
147
- "minLength": 1
148
- },
149
- "classification": {
150
- "type": "string",
151
- "minLength": 1
152
- }
153
- }
154
- }
155
- }
156
- }
157
- },
158
- "runtime": {
159
- "type": "object",
160
- "additionalProperties": false,
161
- "required": [
162
- "platform",
163
- "declaredEnvironment",
164
- "externalEffects"
165
- ],
166
- "properties": {
167
- "platform": {
168
- "const": "portable"
169
- },
170
- "declaredEnvironment": {
171
- "type": "array",
172
- "uniqueItems": true,
173
- "items": {
174
- "type": "string",
175
- "pattern": "^[A-Z][A-Z0-9_]*$"
176
- }
177
- },
178
- "externalEffects": {
179
- "type": "array",
180
- "items": {
181
- "type": "object",
182
- "additionalProperties": false,
183
- "required": [
184
- "capabilityId",
185
- "adapter",
186
- "kind"
187
- ],
188
- "properties": {
189
- "capabilityId": {
190
- "type": "string",
191
- "minLength": 1
192
- },
193
- "adapter": {
194
- "type": "string",
195
- "minLength": 1
196
- },
197
- "kind": {
198
- "type": "string",
199
- "minLength": 1
200
- }
201
- }
202
- }
203
- }
204
- }
205
- }
206
- },
207
- "$defs": {
208
- "root": {
209
- "type": "string",
210
- "pattern": "^sha256:[0-9a-f]{64}$"
211
- },
212
- "path": {
213
- "type": "string",
214
- "minLength": 1,
215
- "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*\\\\).+$"
216
- },
217
- "observation": {
218
- "type": "object",
219
- "additionalProperties": false,
220
- "required": [
221
- "outcome",
222
- "subjectRoot",
223
- "targetRoot",
224
- "evidenceRoots",
225
- "providerCode"
226
- ],
227
- "properties": {
228
- "outcome": {
229
- "enum": [
230
- "observed",
231
- "absent",
232
- "transient",
233
- "conflict"
234
- ]
235
- },
236
- "subjectRoot": {
237
- "anyOf": [
238
- {
239
- "$ref": "#/$defs/root"
240
- },
241
- {
242
- "const": ""
243
- }
244
- ]
245
- },
246
- "targetRoot": {
247
- "anyOf": [
248
- {
249
- "$ref": "#/$defs/root"
250
- },
251
- {
252
- "const": ""
253
- }
254
- ]
255
- },
256
- "evidenceRoots": {
257
- "type": "array",
258
- "items": {
259
- "$ref": "#/$defs/root"
260
- }
261
- },
262
- "providerCode": {
263
- "type": "string",
264
- "minLength": 1
265
- }
266
- }
267
- }
268
- }
269
- }
@@ -1,353 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://buildchain.kungfu.ai/contracts/release-tail-capabilities-v1.schema.json",
4
- "title": "Buildchain release-tail capability declaration",
5
- "type": "object",
6
- "additionalProperties": false,
7
- "required": [
8
- "contract",
9
- "schemaVersion",
10
- "transactionPolicy",
11
- "subject",
12
- "capabilities"
13
- ],
14
- "properties": {
15
- "contract": {
16
- "const": "kungfu-buildchain-release-tail-capabilities"
17
- },
18
- "schemaVersion": {
19
- "const": 1
20
- },
21
- "transactionPolicy": {
22
- "const": "buildchain.release-tail/v1"
23
- },
24
- "subject": {
25
- "type": "object",
26
- "additionalProperties": false,
27
- "required": [
28
- "repository",
29
- "sourceSha",
30
- "version",
31
- "tag",
32
- "channel"
33
- ],
34
- "properties": {
35
- "repository": {
36
- "type": "string",
37
- "minLength": 1
38
- },
39
- "sourceSha": {
40
- "type": "string",
41
- "pattern": "^[0-9a-f]{40}$"
42
- },
43
- "version": {
44
- "type": "string",
45
- "minLength": 1
46
- },
47
- "tag": {
48
- "type": "string",
49
- "minLength": 1
50
- },
51
- "channel": {
52
- "enum": [
53
- "alpha",
54
- "release",
55
- "stable"
56
- ]
57
- }
58
- }
59
- },
60
- "capabilities": {
61
- "type": "array",
62
- "minItems": 1,
63
- "items": {
64
- "$ref": "#/$defs/capability"
65
- }
66
- }
67
- },
68
- "$defs": {
69
- "root": {
70
- "type": "string",
71
- "pattern": "^sha256:[0-9a-f]{64}$"
72
- },
73
- "capability": {
74
- "type": "object",
75
- "additionalProperties": false,
76
- "required": [
77
- "id",
78
- "executor",
79
- "adapter",
80
- "artifactRoles",
81
- "destination",
82
- "channelPolicy",
83
- "activationPolicy",
84
- "readbackPredicates",
85
- "effect",
86
- "observation",
87
- "receipt",
88
- "operationIdentity",
89
- "idempotency",
90
- "retry",
91
- "evidenceRequirements"
92
- ],
93
- "properties": {
94
- "id": {
95
- "enum": [
96
- "artifact.publish",
97
- "signed-channel.commit",
98
- "release.activate",
99
- "released-evidence.synthesize"
100
- ]
101
- },
102
- "executor": {
103
- "enum": [
104
- "buildchain-core",
105
- "provider-adapter"
106
- ]
107
- },
108
- "adapter": {
109
- "type": "string",
110
- "minLength": 1
111
- },
112
- "artifactRoles": {
113
- "type": "array",
114
- "items": {
115
- "type": "object",
116
- "additionalProperties": false,
117
- "required": [
118
- "role",
119
- "root"
120
- ],
121
- "properties": {
122
- "role": {
123
- "type": "string",
124
- "minLength": 1
125
- },
126
- "root": {
127
- "$ref": "#/$defs/root"
128
- }
129
- }
130
- }
131
- },
132
- "destination": {
133
- "type": "object",
134
- "additionalProperties": false,
135
- "required": [
136
- "kind",
137
- "locator"
138
- ],
139
- "properties": {
140
- "kind": {
141
- "type": "string",
142
- "minLength": 1
143
- },
144
- "locator": {
145
- "type": "string",
146
- "minLength": 1
147
- }
148
- }
149
- },
150
- "channelPolicy": {
151
- "type": "object",
152
- "additionalProperties": false,
153
- "required": [
154
- "channel",
155
- "tagPattern",
156
- "authorityMove"
157
- ],
158
- "properties": {
159
- "channel": {
160
- "enum": [
161
- "alpha",
162
- "release",
163
- "stable"
164
- ]
165
- },
166
- "tagPattern": {
167
- "type": "string",
168
- "minLength": 1
169
- },
170
- "authorityMove": {
171
- "enum": [
172
- "none",
173
- "signed-cas",
174
- "verified-ref"
175
- ]
176
- }
177
- }
178
- },
179
- "activationPolicy": {
180
- "type": "object",
181
- "additionalProperties": false,
182
- "required": [
183
- "mode",
184
- "environment"
185
- ],
186
- "properties": {
187
- "mode": {
188
- "enum": [
189
- "none",
190
- "receipt-set",
191
- "receipt-only"
192
- ]
193
- },
194
- "environment": {
195
- "enum": [
196
- "none",
197
- "shadow",
198
- "production"
199
- ]
200
- }
201
- }
202
- },
203
- "readbackPredicates": {
204
- "type": "array",
205
- "items": {
206
- "type": "object",
207
- "additionalProperties": false,
208
- "required": [
209
- "id",
210
- "kind",
211
- "expected"
212
- ],
213
- "properties": {
214
- "id": {
215
- "type": "string",
216
- "minLength": 1
217
- },
218
- "kind": {
219
- "type": "string",
220
- "minLength": 1
221
- },
222
- "expected": {
223
- "type": "string",
224
- "minLength": 1
225
- }
226
- }
227
- }
228
- },
229
- "effect": {
230
- "$ref": "#/$defs/message"
231
- },
232
- "observation": {
233
- "$ref": "#/$defs/message"
234
- },
235
- "receipt": {
236
- "$ref": "#/$defs/message"
237
- },
238
- "operationIdentity": {
239
- "type": "object",
240
- "additionalProperties": false,
241
- "required": [
242
- "transactionRoot",
243
- "capabilityId",
244
- "subjectRoot",
245
- "targetRoot",
246
- "attemptKey"
247
- ],
248
- "properties": {
249
- "transactionRoot": {
250
- "$ref": "#/$defs/root"
251
- },
252
- "capabilityId": {
253
- "enum": [
254
- "artifact.publish",
255
- "signed-channel.commit",
256
- "release.activate",
257
- "released-evidence.synthesize"
258
- ]
259
- },
260
- "subjectRoot": {
261
- "$ref": "#/$defs/root"
262
- },
263
- "targetRoot": {
264
- "$ref": "#/$defs/root"
265
- },
266
- "attemptKey": {
267
- "type": "string",
268
- "minLength": 1
269
- }
270
- }
271
- },
272
- "idempotency": {
273
- "type": "object",
274
- "additionalProperties": false,
275
- "required": [
276
- "scope",
277
- "duplicate"
278
- ],
279
- "properties": {
280
- "scope": {
281
- "enum": [
282
- "operation",
283
- "subject-target"
284
- ]
285
- },
286
- "duplicate": {
287
- "enum": [
288
- "return-observed-receipt",
289
- "readback-before-retry"
290
- ]
291
- }
292
- }
293
- },
294
- "retry": {
295
- "type": "object",
296
- "additionalProperties": false,
297
- "required": [
298
- "class",
299
- "localAttempts",
300
- "exhausted"
301
- ],
302
- "properties": {
303
- "class": {
304
- "enum": [
305
- "never",
306
- "readback",
307
- "provider-transient"
308
- ]
309
- },
310
- "localAttempts": {
311
- "type": "integer",
312
- "minimum": 0,
313
- "maximum": 3
314
- },
315
- "exhausted": {
316
- "enum": [
317
- "blocked",
318
- "repair-required",
319
- "terminal-failure"
320
- ]
321
- }
322
- }
323
- },
324
- "evidenceRequirements": {
325
- "type": "array",
326
- "minItems": 1,
327
- "items": {
328
- "type": "string",
329
- "minLength": 1
330
- }
331
- }
332
- }
333
- },
334
- "message": {
335
- "type": "object",
336
- "additionalProperties": false,
337
- "required": [
338
- "kind",
339
- "schema"
340
- ],
341
- "properties": {
342
- "kind": {
343
- "type": "string",
344
- "minLength": 1
345
- },
346
- "schema": {
347
- "type": "string",
348
- "minLength": 1
349
- }
350
- }
351
- }
352
- }
353
- }
@@ -1,94 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://buildchain.kungfu.ai/contracts/release-tail-provider-bindings-v1.schema.json",
4
- "title": "Buildchain release-tail provider bindings",
5
- "type": "object",
6
- "additionalProperties": false,
7
- "required": [
8
- "schema",
9
- "artifacts",
10
- "documents",
11
- "evidence"
12
- ],
13
- "properties": {
14
- "schema": {
15
- "const": "kungfu.buildchain.release-tail.provider-bindings/v1"
16
- },
17
- "artifacts": {
18
- "type": "object",
19
- "additionalProperties": {
20
- "type": "object",
21
- "additionalProperties": false,
22
- "required": [
23
- "path",
24
- "name"
25
- ],
26
- "properties": {
27
- "path": {
28
- "type": "string",
29
- "minLength": 1
30
- },
31
- "name": {
32
- "type": "string",
33
- "minLength": 1
34
- }
35
- }
36
- }
37
- },
38
- "documents": {
39
- "type": "object",
40
- "additionalProperties": false,
41
- "properties": {
42
- "signed-channel.commit": {
43
- "$ref": "#/$defs/document"
44
- },
45
- "release.activate": {
46
- "$ref": "#/$defs/document"
47
- }
48
- }
49
- },
50
- "evidence": {
51
- "type": "object",
52
- "additionalProperties": false,
53
- "required": [
54
- "inputs",
55
- "output"
56
- ],
57
- "properties": {
58
- "inputs": {
59
- "type": "array",
60
- "items": {
61
- "type": "string",
62
- "minLength": 1
63
- }
64
- },
65
- "output": {
66
- "type": "string",
67
- "minLength": 1
68
- }
69
- }
70
- }
71
- },
72
- "$defs": {
73
- "document": {
74
- "type": "object",
75
- "additionalProperties": false,
76
- "required": [
77
- "path",
78
- "method"
79
- ],
80
- "properties": {
81
- "path": {
82
- "type": "string",
83
- "minLength": 1
84
- },
85
- "method": {
86
- "enum": [
87
- "PUT",
88
- "POST"
89
- ]
90
- }
91
- }
92
- }
93
- }
94
- }