@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,292 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://buildchain.libkungfu.dev/schemas/next-development-transition-v1.schema.json",
4
- "title": "Buildchain Next-development Transition v1",
5
- "type": "object",
6
- "additionalProperties": false,
7
- "required": [
8
- "schemaVersion",
9
- "contract",
10
- "idempotencyKey",
11
- "repository",
12
- "completedAlpha",
13
- "completedAlphaRoot",
14
- "alphaOutcome",
15
- "model",
16
- "target",
17
- "declaredPaths",
18
- "adapter",
19
- "effectBounds",
20
- "state",
21
- "materialization",
22
- "transitions"
23
- ],
24
- "properties": {
25
- "schemaVersion": { "const": 1 },
26
- "contract": {
27
- "const": "kungfu-buildchain-next-development-transition/v1"
28
- },
29
- "idempotencyKey": { "$ref": "#/$defs/root" },
30
- "repository": {
31
- "type": "string",
32
- "pattern": "^[^/\\s]+/[^/\\s]+$"
33
- },
34
- "completedAlpha": { "$ref": "#/$defs/completedAlpha" },
35
- "completedAlphaRoot": { "$ref": "#/$defs/root" },
36
- "alphaOutcome": { "const": "preserved-success" },
37
- "model": { "$ref": "#/$defs/model" },
38
- "target": { "$ref": "#/$defs/target" },
39
- "declaredPaths": {
40
- "type": "array",
41
- "minItems": 1,
42
- "uniqueItems": true,
43
- "items": { "$ref": "#/$defs/path" }
44
- },
45
- "adapter": { "$ref": "#/$defs/adapter" },
46
- "effectBounds": {
47
- "type": "object",
48
- "additionalProperties": false,
49
- "required": ["allowedPaths", "refUpdates", "forbiddenRefNamespaces"],
50
- "properties": {
51
- "allowedPaths": {
52
- "type": "array",
53
- "minItems": 1,
54
- "uniqueItems": true,
55
- "items": { "$ref": "#/$defs/path" }
56
- },
57
- "refUpdates": { "type": "array", "maxItems": 0 },
58
- "forbiddenRefNamespaces": {
59
- "const": ["refs/heads/alpha/", "refs/tags/"]
60
- }
61
- }
62
- },
63
- "state": {
64
- "type": "object",
65
- "additionalProperties": false,
66
- "required": ["status", "generation", "stateRoot"],
67
- "properties": {
68
- "status": { "$ref": "#/$defs/state" },
69
- "generation": { "type": "integer", "minimum": 1 },
70
- "stateRoot": { "$ref": "#/$defs/root" }
71
- }
72
- },
73
- "materialization": {
74
- "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/materialization" }]
75
- },
76
- "transitions": {
77
- "type": "array",
78
- "items": { "$ref": "#/$defs/transition" }
79
- }
80
- },
81
- "allOf": [
82
- {
83
- "if": {
84
- "properties": {
85
- "state": {
86
- "properties": {
87
- "status": {
88
- "enum": ["materialized", "pr-pending", "merged", "verified"]
89
- }
90
- }
91
- }
92
- }
93
- },
94
- "then": {
95
- "properties": {
96
- "materialization": { "$ref": "#/$defs/materialization" }
97
- }
98
- }
99
- }
100
- ],
101
- "$defs": {
102
- "gitSha": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
103
- "root": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
104
- "semver": {
105
- "type": "string",
106
- "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$"
107
- },
108
- "path": {
109
- "type": "string",
110
- "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[^\\s]+$"
111
- },
112
- "state": {
113
- "enum": [
114
- "planned",
115
- "waiting-anchor",
116
- "materialized",
117
- "pr-pending",
118
- "merged",
119
- "verified"
120
- ]
121
- },
122
- "completedAlpha": {
123
- "type": "object",
124
- "additionalProperties": false,
125
- "required": [
126
- "outcome",
127
- "version",
128
- "exactTag",
129
- "releaseSha",
130
- "treeSha",
131
- "publicationRoot",
132
- "completedAt"
133
- ],
134
- "properties": {
135
- "outcome": { "const": "succeeded" },
136
- "version": {
137
- "type": "string",
138
- "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)-alpha\\.(0|[1-9][0-9]*)$"
139
- },
140
- "exactTag": { "type": "string", "minLength": 1 },
141
- "releaseSha": { "$ref": "#/$defs/gitSha" },
142
- "treeSha": { "$ref": "#/$defs/gitSha" },
143
- "publicationRoot": { "$ref": "#/$defs/root" },
144
- "completedAt": { "type": "string", "format": "date-time" }
145
- }
146
- },
147
- "model": {
148
- "oneOf": [
149
- {
150
- "type": "object",
151
- "additionalProperties": false,
152
- "required": ["strategy", "next"],
153
- "properties": {
154
- "strategy": { "const": "semver" },
155
- "next": { "const": "auto" }
156
- }
157
- },
158
- {
159
- "type": "object",
160
- "additionalProperties": false,
161
- "required": ["strategy", "next"],
162
- "properties": {
163
- "strategy": { "const": "anchored" },
164
- "next": { "const": "manual" }
165
- }
166
- }
167
- ]
168
- },
169
- "adapter": {
170
- "type": "object",
171
- "additionalProperties": false,
172
- "required": [
173
- "environmentVariable",
174
- "sourcePaths",
175
- "derivedPaths",
176
- "allowedChangePaths",
177
- "readOnlyPaths",
178
- "derivationStage",
179
- "verificationStage"
180
- ],
181
- "properties": {
182
- "environmentVariable": { "const": "BUILDCHAIN_VERSION" },
183
- "sourcePaths": {
184
- "type": "array",
185
- "minItems": 1,
186
- "uniqueItems": true,
187
- "items": { "$ref": "#/$defs/path" }
188
- },
189
- "derivedPaths": {
190
- "type": "array",
191
- "uniqueItems": true,
192
- "items": { "$ref": "#/$defs/path" }
193
- },
194
- "allowedChangePaths": {
195
- "type": "array",
196
- "minItems": 1,
197
- "uniqueItems": true,
198
- "items": { "$ref": "#/$defs/path" }
199
- },
200
- "readOnlyPaths": {
201
- "type": "array",
202
- "uniqueItems": true,
203
- "items": { "$ref": "#/$defs/path" }
204
- },
205
- "derivationStage": {
206
- "oneOf": [{ "type": "null" }, { "const": "lifecycle.version-state" }]
207
- },
208
- "verificationStage": { "const": "lifecycle.verify" }
209
- }
210
- },
211
- "target": {
212
- "type": "object",
213
- "additionalProperties": false,
214
- "required": ["version", "anchor"],
215
- "properties": {
216
- "version": {
217
- "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/semver" }]
218
- },
219
- "anchor": {
220
- "oneOf": [
221
- { "type": "null" },
222
- {
223
- "type": "object",
224
- "additionalProperties": false,
225
- "required": ["manifestPath", "manifestRoot"],
226
- "properties": {
227
- "manifestPath": { "$ref": "#/$defs/path" },
228
- "manifestRoot": { "$ref": "#/$defs/root" }
229
- }
230
- }
231
- ]
232
- }
233
- }
234
- },
235
- "materialization": {
236
- "type": "object",
237
- "additionalProperties": false,
238
- "required": [
239
- "targetVersion",
240
- "anchorRoot",
241
- "paths",
242
- "materializationRoot"
243
- ],
244
- "properties": {
245
- "targetVersion": { "$ref": "#/$defs/semver" },
246
- "anchorRoot": {
247
- "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/root" }]
248
- },
249
- "paths": {
250
- "type": "array",
251
- "minItems": 1,
252
- "items": {
253
- "type": "object",
254
- "additionalProperties": false,
255
- "required": ["path", "beforeRoot", "afterRoot", "changed"],
256
- "properties": {
257
- "path": { "$ref": "#/$defs/path" },
258
- "beforeRoot": { "$ref": "#/$defs/root" },
259
- "afterRoot": { "$ref": "#/$defs/root" },
260
- "changed": { "type": "boolean" }
261
- }
262
- }
263
- },
264
- "materializationRoot": { "$ref": "#/$defs/root" }
265
- }
266
- },
267
- "transition": {
268
- "type": "object",
269
- "additionalProperties": false,
270
- "required": [
271
- "expectedStateRoot",
272
- "from",
273
- "to",
274
- "event",
275
- "evidenceRoot",
276
- "recordedAt",
277
- "requestRoot",
278
- "transitionRoot"
279
- ],
280
- "properties": {
281
- "expectedStateRoot": { "$ref": "#/$defs/root" },
282
- "from": { "$ref": "#/$defs/state" },
283
- "to": { "$ref": "#/$defs/state" },
284
- "event": { "type": "string", "minLength": 1 },
285
- "evidenceRoot": { "$ref": "#/$defs/root" },
286
- "recordedAt": { "type": "string", "format": "date-time" },
287
- "requestRoot": { "$ref": "#/$defs/root" },
288
- "transitionRoot": { "$ref": "#/$defs/root" }
289
- }
290
- }
291
- }
292
- }
@@ -1,173 +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": { "const": 1 },
25
- "root": { "$ref": "#/$defs/root" },
26
- "declaration": {
27
- "$ref": "release-tail-capabilities-v1.schema.json"
28
- },
29
- "policyRoots": {
30
- "type": "array",
31
- "minItems": 1,
32
- "uniqueItems": true,
33
- "items": { "$ref": "#/$defs/root" }
34
- },
35
- "passport": {
36
- "type": "object",
37
- "additionalProperties": false,
38
- "required": ["path", "root"],
39
- "properties": {
40
- "path": { "$ref": "#/$defs/path" },
41
- "root": { "$ref": "#/$defs/root" }
42
- }
43
- },
44
- "transaction": {
45
- "type": "object",
46
- "required": [
47
- "schema",
48
- "transactionPolicy",
49
- "transactionRoot",
50
- "declarationRoot",
51
- "planRoot",
52
- "subject",
53
- "state",
54
- "operationOrder",
55
- "operations",
56
- "observations",
57
- "receipts",
58
- "failure",
59
- "stateRoot"
60
- ]
61
- },
62
- "files": {
63
- "type": "array",
64
- "minItems": 1,
65
- "items": {
66
- "type": "object",
67
- "additionalProperties": false,
68
- "required": ["role", "path", "size", "root"],
69
- "properties": {
70
- "role": { "type": "string", "minLength": 1 },
71
- "path": { "$ref": "#/$defs/path" },
72
- "size": { "type": "integer", "minimum": 0 },
73
- "root": { "$ref": "#/$defs/root" }
74
- }
75
- }
76
- },
77
- "providerBindings": {
78
- "$ref": "release-tail-provider-bindings-v1.schema.json"
79
- },
80
- "providerObservations": {
81
- "type": "array",
82
- "items": {
83
- "type": "object",
84
- "additionalProperties": false,
85
- "required": ["operationId", "readbacks", "apply"],
86
- "properties": {
87
- "operationId": { "$ref": "#/$defs/root" },
88
- "readbacks": {
89
- "type": "array",
90
- "minItems": 1,
91
- "items": { "$ref": "#/$defs/observation" }
92
- },
93
- "apply": {
94
- "type": "object",
95
- "additionalProperties": false,
96
- "required": ["outcome", "code", "classification"],
97
- "properties": {
98
- "outcome": {
99
- "enum": ["applied", "transient", "conflict"]
100
- },
101
- "code": { "type": "string", "minLength": 1 },
102
- "classification": { "type": "string", "minLength": 1 }
103
- }
104
- }
105
- }
106
- }
107
- },
108
- "runtime": {
109
- "type": "object",
110
- "additionalProperties": false,
111
- "required": ["platform", "declaredEnvironment", "externalEffects"],
112
- "properties": {
113
- "platform": { "const": "portable" },
114
- "declaredEnvironment": {
115
- "type": "array",
116
- "uniqueItems": true,
117
- "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" }
118
- },
119
- "externalEffects": {
120
- "type": "array",
121
- "items": {
122
- "type": "object",
123
- "additionalProperties": false,
124
- "required": ["capabilityId", "adapter", "kind"],
125
- "properties": {
126
- "capabilityId": { "type": "string", "minLength": 1 },
127
- "adapter": { "type": "string", "minLength": 1 },
128
- "kind": { "type": "string", "minLength": 1 }
129
- }
130
- }
131
- }
132
- }
133
- }
134
- },
135
- "$defs": {
136
- "root": {
137
- "type": "string",
138
- "pattern": "^sha256:[0-9a-f]{64}$"
139
- },
140
- "path": {
141
- "type": "string",
142
- "minLength": 1,
143
- "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!.*\\\\).+$"
144
- },
145
- "observation": {
146
- "type": "object",
147
- "additionalProperties": false,
148
- "required": [
149
- "outcome",
150
- "subjectRoot",
151
- "targetRoot",
152
- "evidenceRoots",
153
- "providerCode"
154
- ],
155
- "properties": {
156
- "outcome": {
157
- "enum": ["observed", "absent", "transient", "conflict"]
158
- },
159
- "subjectRoot": {
160
- "anyOf": [{ "$ref": "#/$defs/root" }, { "const": "" }]
161
- },
162
- "targetRoot": {
163
- "anyOf": [{ "$ref": "#/$defs/root" }, { "const": "" }]
164
- },
165
- "evidenceRoots": {
166
- "type": "array",
167
- "items": { "$ref": "#/$defs/root" }
168
- },
169
- "providerCode": { "type": "string", "minLength": 1 }
170
- }
171
- }
172
- }
173
- }