@kungfu-tech/buildchain 4.0.1-alpha.4 → 4.0.1-alpha.41

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 (172) hide show
  1. package/actions/release-tail/README.md +8 -0
  2. package/architecture/ci-lane-change-budget.json +187 -0
  3. package/architecture/decisions/0002-next-development-transition.md +101 -0
  4. package/architecture/internal-capabilities.json +117 -8
  5. package/architecture/maintainability-policy.json +43 -25
  6. package/architecture/release-tail-contract-inventory.json +5 -2
  7. package/architecture/v3-core-mechanism-inventory.json +89 -0
  8. package/architecture/v4-adopter-delivery-parity.json +32 -5
  9. package/architecture/v4-capability-state-machine-manifest.json +73 -0
  10. package/architecture/v4-compatibility-facts-parity.json +77 -0
  11. package/architecture/v4-floating-consumer-policy.json +6 -0
  12. package/architecture/v4-next-development-parity.json +192 -0
  13. package/architecture/v4-publication-rehearsal-parity.json +84 -0
  14. package/architecture/v4-release-train-parity.json +1 -0
  15. package/architecture/v4-tail-reseal-parity.json +150 -0
  16. package/bin/buildchain.mjs +23 -2
  17. package/bin/internal/adopter-delivery-cli.mjs +70 -0
  18. package/bin/internal/command-registry.mjs +3 -0
  19. package/bin/internal/compatibility-facts-cli.mjs +101 -0
  20. package/contracts/fixtures/next-development-transition-v1/anchored-manual-waiting.json +47 -0
  21. package/contracts/fixtures/next-development-transition-v1/semver-auto-planned.json +47 -0
  22. package/contracts/fixtures/next-development-transition-v1/version-model-cases.json +40 -0
  23. package/contracts/fixtures/v4-adopter-delivery-v1/archive-template.json +19 -0
  24. package/contracts/fixtures/v4-adopter-delivery-v1/bootstrap-positive.json +93 -0
  25. package/contracts/fixtures/v4-adopter-delivery-v1/gate-positive.json +29 -0
  26. package/contracts/fixtures/v4-adopter-delivery-v1/gate-unknown-selector.json +26 -0
  27. package/contracts/fixtures/v4-adopter-delivery-v1/offline-vectors.json +50 -0
  28. package/contracts/fixtures/v4-compatibility-facts-v1/shared.json +1129 -0
  29. package/contracts/fixtures/v4-floating-consumer-policy-v1/cases.json +7 -1
  30. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/artifacts/product.bin +1 -0
  31. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/config/buildchain.toml +5 -0
  32. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/documents/release-activation.json +1 -0
  33. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/documents/signed-channel.json +1 -0
  34. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/evidence/qualification.json +1 -0
  35. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/manifests/candidate.json +5 -0
  36. package/contracts/fixtures/v4-publication-rehearsal-v1/candidate/manifests/release-passport.json +1 -0
  37. package/contracts/fixtures/v4-publication-rehearsal-v1/capsule.json +707 -0
  38. package/contracts/fixtures/v4-publication-rehearsal-v1/offline-vectors.json +27 -0
  39. package/contracts/fixtures/v4-tail-reseal-v1/valid.json +229 -0
  40. package/contracts/next-development-request-v1.schema.json +66 -0
  41. package/contracts/next-development-transition-v1.schema.json +292 -0
  42. package/contracts/v4-adopter-delivery-v1.schema.json +81 -0
  43. package/contracts/v4-compatibility-facts-v1.schema.json +230 -0
  44. package/contracts/v4-floating-consumer-policy-receipt-v1.schema.json +4 -2
  45. package/contracts/v4-publication-rehearsal-capsule-v1.schema.json +233 -0
  46. package/contracts/v4-tail-reseal-v1.schema.json +276 -0
  47. package/dist/site/agent-index.json +4 -0
  48. package/dist/site/artifact-schemas.json +8 -0
  49. package/dist/site/buildchain-contract.json +1393 -28
  50. package/dist/site/buildchain-site.json +477 -32
  51. package/dist/site/capability-registry.json +17 -14
  52. package/dist/site/cli-registry.json +159 -1
  53. package/dist/site/kfd-claims.json +455 -15
  54. package/dist/site/kfd-upstream-aggregate.json +1 -1
  55. package/dist/site/manual-registry.json +53 -7
  56. package/dist/site/node-api-registry.json +14008 -9602
  57. package/dist/site/page-registry.json +442 -21
  58. package/dist/site/public-surface-audit.json +440 -11
  59. package/dist/site/publication-authority-registry.json +44 -8
  60. package/dist/site/publication-registry.json +4 -4
  61. package/dist/site/release-provenance.json +22 -0
  62. package/dist/site/schemas/release-tail-capabilities-v1.schema.json +199 -0
  63. package/dist/site/schemas/v4-adopter-delivery-v1.schema.json +81 -0
  64. package/dist/site/schemas/v4-compatibility-facts-v1.schema.json +230 -0
  65. package/dist/site/schemas/v4-publication-rehearsal-capsule-v1.schema.json +233 -0
  66. package/dist/site/site-manifest.json +35 -11
  67. package/dist/site/workflow-registry.json +142 -8
  68. package/docs/MAP.md +7 -2
  69. package/docs/cli-reference.md +193 -0
  70. package/docs/cli.md +8 -0
  71. package/docs/dev-alpha-candidate-patrol.md +8 -0
  72. package/docs/dev-delivery-warrant.md +22 -1
  73. package/docs/next-development-transition.md +118 -0
  74. package/docs/node-api-reference.md +583 -288
  75. package/docs/release-candidate.md +7 -0
  76. package/docs/release-tail-provider-plane.md +30 -0
  77. package/docs/v4-adopter-delivery.md +133 -0
  78. package/docs/v4-compatibility-facts.md +91 -0
  79. package/docs/v4-publication-rehearsal.md +130 -0
  80. package/docs/v4-tail-reseal.md +73 -0
  81. package/docs/versioning.md +4 -3
  82. package/package.json +30 -6
  83. package/packages/core/adopter-delivery-passport.js +259 -0
  84. package/packages/core/adopter-delivery-vectors.js +158 -0
  85. package/packages/core/adopter-delivery-vectors.json +77 -0
  86. package/packages/core/buildchain-agent-manuals.js +3 -0
  87. package/packages/core/buildchain-compatibility-authority.js +336 -0
  88. package/packages/core/buildchain-compatibility-fact.js +394 -0
  89. package/packages/core/buildchain-compatibility-facts.json +217 -0
  90. package/packages/core/buildchain-compatibility-proof.js +566 -0
  91. package/packages/core/buildchain-config.js +84 -0
  92. package/packages/core/buildchain-contract.js +93 -141
  93. package/packages/core/buildchain-delivery-bootstrap.js +240 -0
  94. package/packages/core/buildchain-delivery-infrastructure.js +164 -0
  95. package/packages/core/buildchain-delivery-self-dogfood.js +395 -0
  96. package/packages/core/buildchain-publication-authority.js +1 -0
  97. package/packages/core/channel-candidate.js +8 -0
  98. package/packages/core/channel-promotion-baseline.js +55 -0
  99. package/packages/core/ci-lane-change-budget.js +247 -0
  100. package/packages/core/dev-alpha-candidate-selection.js +10 -2
  101. package/packages/core/dev-delivery-execution-transfer.js +21 -1
  102. package/packages/core/dev-delivery-native-proof.js +43 -27
  103. package/packages/core/dev-delivery-process-boundary.js +19 -6
  104. package/packages/core/dev-delivery-provider-heartbeat.js +18 -6
  105. package/packages/core/dev-delivery-warrant-settlement.js +234 -2
  106. package/packages/core/dev-delivery-warrant-state.js +46 -10
  107. package/packages/core/dev-delivery-warrant.js +16 -3
  108. package/packages/core/github-governance-authority.js +1 -0
  109. package/packages/core/index.js +5 -0
  110. package/packages/core/kungfu-temporal-fact.js +557 -0
  111. package/packages/core/legacy-kfd-adopter-driver.js +167 -0
  112. package/packages/core/next-development-candidate-reservation.js +186 -0
  113. package/packages/core/next-development-controller.js +728 -0
  114. package/packages/core/next-development-projection.js +287 -0
  115. package/packages/core/next-development-transition.js +738 -0
  116. package/packages/core/paper-agent-entry.js +11 -5
  117. package/packages/core/paper.js +16 -5
  118. package/packages/core/published-delivery-authority.js +266 -0
  119. package/packages/core/release-candidate-recovery.js +70 -15
  120. package/packages/core/release-candidate.js +2 -2
  121. package/packages/core/release-passport.js +36 -9
  122. package/packages/core/v4-adopter-delivery-parity.js +3 -3
  123. package/packages/core/v4-adopter-delivery.js +359 -0
  124. package/packages/core/v4-canonical-contracts.js +5 -0
  125. package/packages/core/v4-delivery-warrant-read-candidate.js +10 -3
  126. package/packages/core/v4-floating-consumer-evidence.js +18 -4
  127. package/packages/core/v4-floating-consumer-policy.js +143 -20
  128. package/packages/core/v4-floating-consumer-release-passport.js +35 -8
  129. package/packages/core/v4-publication-rehearsal-capsule.js +468 -0
  130. package/packages/core/v4-publication-rehearsal-provider-bindings.js +212 -0
  131. package/packages/core/v4-publication-rehearsal.js +481 -0
  132. package/packages/core/v4-tail-reseal-contract.js +26 -0
  133. package/packages/core/v4-tail-reseal-github.js +178 -0
  134. package/packages/core/v4-tail-reseal-receipt.js +225 -0
  135. package/packages/core/v4-tail-reseal.js +594 -0
  136. package/packages/core/workflow-yaml-contract.js +24 -2
  137. package/scripts/artifact-signing-controller-core.mjs +1 -1
  138. package/scripts/buildchain-cli-help.mjs +30 -0
  139. package/scripts/check-ci-lane-change-budget.mjs +100 -0
  140. package/scripts/check-inventory.mjs +14 -3
  141. package/scripts/check-project-cut-merge-queue-admission.mjs +87 -0
  142. package/scripts/check-v4-floating-consumer-policy-contract.mjs +23 -4
  143. package/scripts/dev-alpha-candidate-patrol.mjs +22 -1
  144. package/scripts/dev-delivery-source-proof-replay.mjs +153 -0
  145. package/scripts/dev-delivery-source-proof-reuse.mjs +13 -97
  146. package/scripts/dev-delivery-warrant-options.mjs +27 -11
  147. package/scripts/dev-delivery-warrant-store.mjs +10 -6
  148. package/scripts/dev-delivery-warrant.mjs +50 -6
  149. package/scripts/dev-pr-auto-merge.mjs +25 -11
  150. package/scripts/dev-pr-delivery-warrant.mjs +45 -0
  151. package/scripts/dev-pr-prequeue-guard.mjs +0 -18
  152. package/scripts/dev-qualification-patrol.mjs +9 -9
  153. package/scripts/dispatch-artifact-signing-authority.mjs +1 -1
  154. package/scripts/generate-channel-promotion-workflow.mjs +2 -2
  155. package/scripts/generate-next-development-guidance.mjs +49 -0
  156. package/scripts/generate-release-candidate-passport.mjs +152 -0
  157. package/scripts/generate-site-bundle.mjs +46 -3
  158. package/scripts/init-repo.mjs +22 -4
  159. package/scripts/next-development-self-dogfood-harness.mjs +460 -0
  160. package/scripts/next-development-self-dogfood.mjs +597 -0
  161. package/scripts/next-development-transition.mjs +47 -0
  162. package/scripts/project-cut-merge-queue-admission.mjs +394 -0
  163. package/scripts/promotion-channel-router.mjs +4 -4
  164. package/scripts/release-candidate-anchor-provenance.mjs +99 -0
  165. package/scripts/release-tail.mjs +51 -3
  166. package/scripts/resume-from-candidate-run.mjs +595 -65
  167. package/scripts/site-capability-metadata.mjs +29 -0
  168. package/scripts/stable-candidate-qualification.mjs +9 -10
  169. package/scripts/v4-consumer-policy.mjs +5 -5
  170. package/scripts/v4-publication-rehearsal-fixture.mjs +144 -0
  171. package/scripts/v4-tail-reseal-macos-rehearsal.mjs +134 -0
  172. package/scripts/v4-tail-reseal.mjs +416 -0
@@ -336,6 +336,19 @@
336
336
  "runnerPolicy": "unqualified",
337
337
  "notes": ""
338
338
  },
339
+ {
340
+ "workflowPath": ".github/workflows/buildchain-ref-promotion-recovery.yml",
341
+ "authorityClass": "governance-write",
342
+ "publicationCapable": false,
343
+ "capabilityIds": [],
344
+ "credentialMode": "none",
345
+ "publisherWorkflowMode": "fixed",
346
+ "publisherWorkflowPath": ".github/workflows/buildchain-ref-promotion-recovery.yml",
347
+ "environment": "",
348
+ "environmentMode": "fixed",
349
+ "runnerPolicy": "unqualified",
350
+ "notes": ""
351
+ },
339
352
  {
340
353
  "workflowPath": ".github/workflows/buildchain-ref-promotion.yml",
341
354
  "authorityClass": "governance-write",
@@ -882,10 +895,7 @@
882
895
  },
883
896
  {
884
897
  "path": ".github/workflows/build-surface-fixture.yml",
885
- "signals": [
886
- "write-permission",
887
- "oidc"
888
- ],
898
+ "signals": [],
889
899
  "classified": true
890
900
  },
891
901
  {
@@ -944,6 +954,14 @@
944
954
  ],
945
955
  "classified": true
946
956
  },
957
+ {
958
+ "path": ".github/workflows/buildchain-ref-promotion-recovery.yml",
959
+ "signals": [
960
+ "write-permission",
961
+ "oidc"
962
+ ],
963
+ "classified": true
964
+ },
947
965
  {
948
966
  "path": ".github/workflows/buildchain-ref-promotion.yml",
949
967
  "signals": [
@@ -1152,9 +1170,7 @@
1152
1170
  },
1153
1171
  {
1154
1172
  "path": ".github/workflows/release-tail.yml",
1155
- "signals": [
1156
- "write-permission"
1157
- ],
1173
+ "signals": [],
1158
1174
  "classified": true
1159
1175
  },
1160
1176
  {
@@ -1181,21 +1197,41 @@
1181
1197
  ],
1182
1198
  "classified": true
1183
1199
  },
1200
+ {
1201
+ "path": ".github/workflows/v4-adopter-delivery-dogfood.yml",
1202
+ "signals": [],
1203
+ "classified": false
1204
+ },
1205
+ {
1206
+ "path": ".github/workflows/v4-adopter-delivery.yml",
1207
+ "signals": [],
1208
+ "classified": false
1209
+ },
1184
1210
  {
1185
1211
  "path": ".github/workflows/v4-public-consumer-dogfood.yml",
1186
1212
  "signals": [],
1187
1213
  "classified": false
1188
1214
  },
1215
+ {
1216
+ "path": ".github/workflows/v4-publication-rehearsal-dogfood.yml",
1217
+ "signals": [],
1218
+ "classified": false
1219
+ },
1189
1220
  {
1190
1221
  "path": ".github/workflows/v4-stage-capsule-canary.yml",
1191
1222
  "signals": [],
1192
1223
  "classified": false
1193
1224
  },
1225
+ {
1226
+ "path": ".github/workflows/v4-tail-reseal.yml",
1227
+ "signals": [],
1228
+ "classified": false
1229
+ },
1194
1230
  {
1195
1231
  "path": ".github/workflows/verify.yml",
1196
1232
  "signals": [],
1197
1233
  "classified": false
1198
1234
  }
1199
1235
  ],
1200
- "registryDigest": "456987223fcd21bb1db29583187fcbefacf91668a1a245ed1fb186ffe95c15c3"
1236
+ "registryDigest": "9c930540ed2366db36802ce03cac597657e45ff402c14ef13099c788ed4e2501"
1201
1237
  }
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "contract": "kungfu-buildchain-publication-release-registry",
4
- "generatedAt": "2026-08-16T00:38:02.716Z",
5
- "publishedAt": "2026-08-16T00:38:02.716Z",
4
+ "generatedAt": "2026-08-26T11:31:40.226Z",
5
+ "publishedAt": "2026-08-26T11:31:40.226Z",
6
6
  "reproducible": true,
7
7
  "timestampPolicy": "ci-injected",
8
8
  "deterministicInputs": [
@@ -19,7 +19,7 @@
19
19
  "declared Buildchain surface manifest contract"
20
20
  ],
21
21
  "sourceDateEpoch": "0",
22
- "sourceRevision": "e6b14caa6b3dd2af4ea2f6c480baf84006ed0131",
22
+ "sourceRevision": "49b85f77b01788ea48f78b39dd59f9f9b208f144",
23
23
  "timestampPolicyDetails": {
24
24
  "contract": "kungfu-buildchain-surface-timestamp-policy",
25
25
  "timestampFields": [
@@ -32,7 +32,7 @@
32
32
  },
33
33
  "package": {
34
34
  "name": "@kungfu-tech/buildchain",
35
- "version": "4.0.1-alpha.4",
35
+ "version": "4.0.1-alpha.41",
36
36
  "versionSource": "package.json#version"
37
37
  },
38
38
  "sourceKind": "package-site-bundle",
@@ -20,7 +20,9 @@
20
20
  "./detached-artifact-signature": "./packages/core/detached-artifact-signature.js",
21
21
  "./anchored-version-material": "./packages/core/anchored-version-material.js",
22
22
  "./buildchain-contract": "./packages/core/buildchain-contract.js",
23
+ "./compatibility-fact-authority": "./packages/core/buildchain-compatibility-proof.js",
23
24
  "./candidate-timeline": "./packages/core/candidate-timeline.js",
25
+ "./ci-lane-change-budget": "./packages/core/ci-lane-change-budget.js",
24
26
  "./channel-candidate": "./packages/core/channel-candidate.js",
25
27
  "./cache-evidence": "./packages/core/cache-evidence.js",
26
28
  "./controller-evidence": "./packages/core/controller-evidence.js",
@@ -40,6 +42,19 @@
40
42
  "./public-surface-audit": "./packages/core/public-surface-audit.js",
41
43
  "./v4-floating-consumer-policy": "./packages/core/v4-floating-consumer-policy.js",
42
44
  "./v4-runtime-ref-resume-authority": "./packages/core/v4-runtime-ref-resume-authority.js",
45
+ "./v4-tail-reseal": "./packages/core/v4-tail-reseal.js",
46
+ "./v4-tail-reseal-receipt": "./packages/core/v4-tail-reseal-receipt.js",
47
+ "./v4-publication-rehearsal": "./packages/core/v4-publication-rehearsal.js",
48
+ "./adopter-delivery-gate": "./packages/core/adopter-delivery-gate.js",
49
+ "./kfd-adopter-category-driver": "./packages/core/kfd-adopter-category-driver.js",
50
+ "./buildchain-delivery-infrastructure": "./packages/core/buildchain-delivery-infrastructure.js",
51
+ "./buildchain-delivery-bootstrap": "./packages/core/buildchain-delivery-bootstrap.js",
52
+ "./buildchain-delivery-self-dogfood": "./packages/core/buildchain-delivery-self-dogfood.js",
53
+ "./published-delivery-authority": "./packages/core/published-delivery-authority.js",
54
+ "./legacy-kfd-adopter-driver": "./packages/core/legacy-kfd-adopter-driver.js",
55
+ "./adopter-delivery-passport": "./packages/core/adopter-delivery-passport.js",
56
+ "./adopter-delivery-vectors": "./packages/core/adopter-delivery-vectors.js",
57
+ "./v4-adopter-delivery": "./packages/core/v4-adopter-delivery.js",
43
58
  "./logging": "./packages/core/logging.js",
44
59
  "./portable-dev-cache": "./packages/core/portable-dev-cache.js",
45
60
  "./publication-artifact": "./packages/core/publication-artifact.js",
@@ -57,6 +72,9 @@
57
72
  "./release-candidate": "./packages/core/release-candidate.js",
58
73
  "./release-candidate-recovery": "./packages/core/release-candidate-recovery.js",
59
74
  "./release-train": "./packages/core/release-train.js",
75
+ "./next-development-transition": "./packages/core/next-development-transition.js",
76
+ "./next-development-controller": "./packages/core/next-development-controller.js",
77
+ "./next-development-projection": "./packages/core/next-development-projection.js",
60
78
  "./stable-candidate-ledger": "./packages/core/stable-candidate-ledger.js",
61
79
  "./release-passport": "./packages/core/release-passport.js",
62
80
  "./release-passport-contract": "./packages/core/release-passport-contract.js",
@@ -89,6 +107,10 @@
89
107
  "./site/schemas/kfd-product-gate-input-v1.schema.json": "./dist/site/schemas/kfd-product-gate-input-v1.schema.json",
90
108
  "./site/schemas/kfd-support-projection-v1.schema.json": "./dist/site/schemas/kfd-support-projection-v1.schema.json",
91
109
  "./site/schemas/dev-delivery-authority-v2.schema.json": "./dist/site/schemas/dev-delivery-authority-v2.schema.json",
110
+ "./site/schemas/v4-compatibility-facts-v1.schema.json": "./dist/site/schemas/v4-compatibility-facts-v1.schema.json",
111
+ "./site/schemas/v4-publication-rehearsal-capsule-v1.schema.json": "./dist/site/schemas/v4-publication-rehearsal-capsule-v1.schema.json",
112
+ "./site/schemas/v4-adopter-delivery-v1.schema.json": "./dist/site/schemas/v4-adopter-delivery-v1.schema.json",
113
+ "./site/schemas/release-tail-capabilities-v1.schema.json": "./dist/site/schemas/release-tail-capabilities-v1.schema.json",
92
114
  "./site/buildchain-contract.json": "./dist/site/buildchain-contract.json",
93
115
  "./site/product-mechanism.json": "./dist/site/product-mechanism.json",
94
116
  "./site/release-provenance.json": "./dist/site/release-provenance.json",
@@ -0,0 +1,199 @@
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": ["repository", "sourceSha", "version", "tag", "channel"],
28
+ "properties": {
29
+ "repository": { "type": "string", "minLength": 1 },
30
+ "sourceSha": { "type": "string", "pattern": "^[0-9a-f]{40}$" },
31
+ "version": { "type": "string", "minLength": 1 },
32
+ "tag": { "type": "string", "minLength": 1 },
33
+ "channel": { "enum": ["alpha", "release", "stable"] }
34
+ }
35
+ },
36
+ "capabilities": {
37
+ "type": "array",
38
+ "minItems": 1,
39
+ "items": { "$ref": "#/$defs/capability" }
40
+ }
41
+ },
42
+ "$defs": {
43
+ "root": {
44
+ "type": "string",
45
+ "pattern": "^sha256:[0-9a-f]{64}$"
46
+ },
47
+ "capability": {
48
+ "type": "object",
49
+ "additionalProperties": false,
50
+ "required": [
51
+ "id",
52
+ "executor",
53
+ "adapter",
54
+ "artifactRoles",
55
+ "destination",
56
+ "channelPolicy",
57
+ "activationPolicy",
58
+ "readbackPredicates",
59
+ "effect",
60
+ "observation",
61
+ "receipt",
62
+ "operationIdentity",
63
+ "idempotency",
64
+ "retry",
65
+ "evidenceRequirements"
66
+ ],
67
+ "properties": {
68
+ "id": {
69
+ "enum": [
70
+ "artifact.publish",
71
+ "signed-channel.commit",
72
+ "release.activate",
73
+ "released-evidence.synthesize"
74
+ ]
75
+ },
76
+ "executor": { "enum": ["buildchain-core", "provider-adapter"] },
77
+ "adapter": { "type": "string", "minLength": 1 },
78
+ "artifactRoles": {
79
+ "type": "array",
80
+ "items": {
81
+ "type": "object",
82
+ "additionalProperties": false,
83
+ "required": ["role", "root"],
84
+ "properties": {
85
+ "role": { "type": "string", "minLength": 1 },
86
+ "root": { "$ref": "#/$defs/root" }
87
+ }
88
+ }
89
+ },
90
+ "destination": {
91
+ "type": "object",
92
+ "additionalProperties": false,
93
+ "required": ["kind", "locator"],
94
+ "properties": {
95
+ "kind": { "type": "string", "minLength": 1 },
96
+ "locator": { "type": "string", "minLength": 1 }
97
+ }
98
+ },
99
+ "channelPolicy": {
100
+ "type": "object",
101
+ "additionalProperties": false,
102
+ "required": ["channel", "tagPattern", "authorityMove"],
103
+ "properties": {
104
+ "channel": { "enum": ["alpha", "release", "stable"] },
105
+ "tagPattern": { "type": "string", "minLength": 1 },
106
+ "authorityMove": { "enum": ["none", "signed-cas", "verified-ref"] }
107
+ }
108
+ },
109
+ "activationPolicy": {
110
+ "type": "object",
111
+ "additionalProperties": false,
112
+ "required": ["mode", "environment"],
113
+ "properties": {
114
+ "mode": { "enum": ["none", "receipt-set", "receipt-only"] },
115
+ "environment": { "enum": ["none", "shadow", "production"] }
116
+ }
117
+ },
118
+ "readbackPredicates": {
119
+ "type": "array",
120
+ "items": {
121
+ "type": "object",
122
+ "additionalProperties": false,
123
+ "required": ["id", "kind", "expected"],
124
+ "properties": {
125
+ "id": { "type": "string", "minLength": 1 },
126
+ "kind": { "type": "string", "minLength": 1 },
127
+ "expected": { "type": "string", "minLength": 1 }
128
+ }
129
+ }
130
+ },
131
+ "effect": { "$ref": "#/$defs/message" },
132
+ "observation": { "$ref": "#/$defs/message" },
133
+ "receipt": { "$ref": "#/$defs/message" },
134
+ "operationIdentity": {
135
+ "type": "object",
136
+ "additionalProperties": false,
137
+ "required": [
138
+ "transactionRoot",
139
+ "capabilityId",
140
+ "subjectRoot",
141
+ "targetRoot",
142
+ "attemptKey"
143
+ ],
144
+ "properties": {
145
+ "transactionRoot": { "$ref": "#/$defs/root" },
146
+ "capabilityId": {
147
+ "enum": [
148
+ "artifact.publish",
149
+ "signed-channel.commit",
150
+ "release.activate",
151
+ "released-evidence.synthesize"
152
+ ]
153
+ },
154
+ "subjectRoot": { "$ref": "#/$defs/root" },
155
+ "targetRoot": { "$ref": "#/$defs/root" },
156
+ "attemptKey": { "type": "string", "minLength": 1 }
157
+ }
158
+ },
159
+ "idempotency": {
160
+ "type": "object",
161
+ "additionalProperties": false,
162
+ "required": ["scope", "duplicate"],
163
+ "properties": {
164
+ "scope": { "enum": ["operation", "subject-target"] },
165
+ "duplicate": {
166
+ "enum": ["return-observed-receipt", "readback-before-retry"]
167
+ }
168
+ }
169
+ },
170
+ "retry": {
171
+ "type": "object",
172
+ "additionalProperties": false,
173
+ "required": ["class", "localAttempts", "exhausted"],
174
+ "properties": {
175
+ "class": { "enum": ["never", "readback", "provider-transient"] },
176
+ "localAttempts": { "type": "integer", "minimum": 0, "maximum": 3 },
177
+ "exhausted": {
178
+ "enum": ["blocked", "repair-required", "terminal-failure"]
179
+ }
180
+ }
181
+ },
182
+ "evidenceRequirements": {
183
+ "type": "array",
184
+ "minItems": 1,
185
+ "items": { "type": "string", "minLength": 1 }
186
+ }
187
+ }
188
+ },
189
+ "message": {
190
+ "type": "object",
191
+ "additionalProperties": false,
192
+ "required": ["kind", "schema"],
193
+ "properties": {
194
+ "kind": { "type": "string", "minLength": 1 },
195
+ "schema": { "type": "string", "minLength": 1 }
196
+ }
197
+ }
198
+ }
199
+ }
@@ -0,0 +1,81 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://buildchain.kungfu-tech.com/schemas/v4-adopter-delivery-v1.schema.json",
4
+ "title": "Buildchain v4 adopter delivery gate input",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "schemaVersion",
9
+ "contract",
10
+ "driverSelector",
11
+ "artifactProfileSelector",
12
+ "request",
13
+ "context"
14
+ ],
15
+ "properties": {
16
+ "schemaVersion": { "const": 1 },
17
+ "contract": { "const": "kungfu-buildchain-v4-adopter-delivery/v1" },
18
+ "driverSelector": {
19
+ "enum": ["json-assertion", "kfd-category", "legacy-kfd"]
20
+ },
21
+ "artifactProfileSelector": { "enum": ["git-commit", "package"] },
22
+ "request": { "$ref": "#/$defs/request" },
23
+ "context": { "type": "object" }
24
+ },
25
+ "$defs": {
26
+ "reference": {
27
+ "type": "object",
28
+ "additionalProperties": false,
29
+ "required": ["id", "version"],
30
+ "properties": {
31
+ "id": {
32
+ "type": "string",
33
+ "pattern": "^[a-z][a-z0-9.-]*(/[a-z][a-z0-9.-]*)*$"
34
+ },
35
+ "version": {
36
+ "type": "string",
37
+ "pattern": "^[1-9][0-9]*\\.[0-9]+\\.[0-9]+$"
38
+ }
39
+ }
40
+ },
41
+ "request": {
42
+ "type": "object",
43
+ "additionalProperties": false,
44
+ "required": [
45
+ "schemaVersion",
46
+ "contract",
47
+ "protocol",
48
+ "artifactProfile",
49
+ "project",
50
+ "artifact",
51
+ "declaration"
52
+ ],
53
+ "properties": {
54
+ "schemaVersion": { "const": 1 },
55
+ "contract": { "const": "kungfu-buildchain-adopter-delivery-request" },
56
+ "protocol": { "$ref": "#/$defs/reference" },
57
+ "artifactProfile": { "$ref": "#/$defs/reference" },
58
+ "project": {
59
+ "type": "object",
60
+ "additionalProperties": false,
61
+ "required": ["instanceId", "adopterId"],
62
+ "properties": {
63
+ "instanceId": { "type": "string", "minLength": 1 },
64
+ "adopterId": { "type": "string", "minLength": 1 }
65
+ }
66
+ },
67
+ "artifact": {
68
+ "type": "object",
69
+ "additionalProperties": false,
70
+ "required": ["kind", "coordinate", "root"],
71
+ "properties": {
72
+ "kind": { "type": "string", "minLength": 1 },
73
+ "coordinate": { "type": "string", "minLength": 1 },
74
+ "root": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
75
+ }
76
+ },
77
+ "declaration": { "type": "object" }
78
+ }
79
+ }
80
+ }
81
+ }