@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
@@ -0,0 +1,106 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://buildchain.libkungfu.dev/schemas/kfd-support-projection-v1.schema.json",
4
+ "title": "Buildchain KFD support projection v1",
5
+ "description": "A release-bound, non-authoritative projection of one product-owned KFD support matrix.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": [
9
+ "schemaVersion",
10
+ "contract",
11
+ "matrix",
12
+ "standardPackage",
13
+ "gateResults",
14
+ "rows",
15
+ "status",
16
+ "projectionRoot",
17
+ "nonClaims"
18
+ ],
19
+ "properties": {
20
+ "schemaVersion": {
21
+ "const": 1
22
+ },
23
+ "contract": {
24
+ "const": "kungfu-buildchain-kfd-support-projection"
25
+ },
26
+ "matrix": {
27
+ "type": "object",
28
+ "additionalProperties": false,
29
+ "required": [
30
+ "contract",
31
+ "root",
32
+ "authorityPath"
33
+ ],
34
+ "properties": {
35
+ "contract": {
36
+ "type": "string",
37
+ "minLength": 1
38
+ },
39
+ "root": {
40
+ "type": "string",
41
+ "pattern": "^sha256:[0-9a-f]{64}$"
42
+ },
43
+ "authorityPath": {
44
+ "type": "string",
45
+ "minLength": 1
46
+ }
47
+ }
48
+ },
49
+ "standardPackage": {
50
+ "type": "object",
51
+ "additionalProperties": false,
52
+ "required": [
53
+ "name",
54
+ "version",
55
+ "standardsSha256"
56
+ ],
57
+ "properties": {
58
+ "name": {
59
+ "type": "string",
60
+ "minLength": 1
61
+ },
62
+ "version": {
63
+ "type": "string",
64
+ "minLength": 1
65
+ },
66
+ "standardsSha256": {
67
+ "type": "string",
68
+ "pattern": "^sha256:[0-9a-f]{64}$"
69
+ }
70
+ }
71
+ },
72
+ "gateResults": {
73
+ "type": "array",
74
+ "minItems": 3,
75
+ "items": {
76
+ "type": "object"
77
+ }
78
+ },
79
+ "rows": {
80
+ "type": "array",
81
+ "minItems": 13,
82
+ "maxItems": 13,
83
+ "items": {
84
+ "type": "object"
85
+ }
86
+ },
87
+ "status": {
88
+ "enum": [
89
+ "passed",
90
+ "failed"
91
+ ]
92
+ },
93
+ "projectionRoot": {
94
+ "type": "string",
95
+ "pattern": "^sha256:[0-9a-f]{64}$"
96
+ },
97
+ "nonClaims": {
98
+ "type": "array",
99
+ "minItems": 1,
100
+ "items": {
101
+ "type": "string",
102
+ "minLength": 1
103
+ }
104
+ }
105
+ }
106
+ }
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "contract": "kungfu-buildchain-site-manifest",
4
- "generatedAt": "2026-08-12T03:06:20.000Z",
5
- "publishedAt": "2026-08-12T03:06:20.000Z",
4
+ "generatedAt": "2026-08-07T02:08:51.492Z",
5
+ "publishedAt": "2026-08-07T02:08:51.492Z",
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": "afa0fe28c87c59dff4a53e801b12f6df3cc7353c",
22
+ "sourceRevision": "b9fbfd9d6ee909ee3a8c4bd6116e7ddafd7b05e1",
23
23
  "timestampPolicyDetails": {
24
24
  "contract": "kungfu-buildchain-surface-timestamp-policy",
25
25
  "timestampFields": [
@@ -37,7 +37,7 @@
37
37
  },
38
38
  "package": {
39
39
  "name": "@kungfu-tech/buildchain",
40
- "version": "3.0.9-alpha.8",
40
+ "version": "4.0.0-alpha.0",
41
41
  "versionSource": "package.json#version"
42
42
  },
43
43
  "entrypoint": "buildchain-site.json",
@@ -53,7 +53,7 @@
53
53
  "path": "docs/MAP.md",
54
54
  "plane": "use",
55
55
  "exists": true,
56
- "digest": "sha256:a1c408b13658f225113ede0ee4f4309cbae466178e8f248f4290a616ce39194c"
56
+ "digest": "sha256:94a4866f5a44f97ab10ad460c4d9ff39c58aa28e231311425af2fcb857aa8c72"
57
57
  },
58
58
  {
59
59
  "id": "getting-started",
@@ -61,7 +61,7 @@
61
61
  "path": "docs/getting-started.md",
62
62
  "plane": "use",
63
63
  "exists": true,
64
- "digest": "sha256:806224481f542786ed2e60226417bd1ba673099a3110f564357792bdbf637403"
64
+ "digest": "sha256:72adec660d001a3fb77cd990f2bacdb6f46c8eb4927533d408c3755dab02a94e"
65
65
  },
66
66
  {
67
67
  "id": "auditable-demo",
@@ -69,7 +69,7 @@
69
69
  "path": "docs/auditable-demo.md",
70
70
  "plane": "verify",
71
71
  "exists": true,
72
- "digest": "sha256:43989b951667f5dd3bf352209ffe551add4f83d5d551f960aeb787b2220aa665"
72
+ "digest": "sha256:c49e734fdfe3b74d317e23a523e198f1194b2c7cd16cca87e8e3a3ffc7bf589f"
73
73
  },
74
74
  {
75
75
  "id": "install",
@@ -77,7 +77,7 @@
77
77
  "path": "docs/install.md",
78
78
  "plane": "use",
79
79
  "exists": true,
80
- "digest": "sha256:b9d87becf94efff804495ee3beea5da795241ae4402186102baa846c87c7bf14"
80
+ "digest": "sha256:c04ba24a8bed696c02f68af4dd05bd2363fa06b85c54d49a4316efb36b7cf865"
81
81
  },
82
82
  {
83
83
  "id": "release-passport",
@@ -85,7 +85,7 @@
85
85
  "path": "docs/release-passport.md",
86
86
  "plane": "verify",
87
87
  "exists": true,
88
- "digest": "sha256:70bf29e974b190b249fbbcfd9a5de1e33a9b069de5d7811a25e147b860137629"
88
+ "digest": "sha256:4ce3c2edb095d7a103b3b1d22033b4ac3709ce709f8990b21995d491898bd051"
89
89
  },
90
90
  {
91
91
  "id": "github-artifact-attestation",
@@ -133,15 +133,7 @@
133
133
  "path": "docs/release-train.md",
134
134
  "plane": "verify",
135
135
  "exists": true,
136
- "digest": "sha256:5ec5534ee48790df09c71a2578e1ca364a14dadf6ba662685ee66f78ae2589e7"
137
- },
138
- {
139
- "id": "next-development-transition",
140
- "title": "Next-development transition",
141
- "path": "docs/next-development-transition.md",
142
- "plane": "verify",
143
- "exists": true,
144
- "digest": "sha256:93b2687be0e36744cb7b0b9d0d76588d89569120ffdb577f13c8c0827988ba28"
136
+ "digest": "sha256:6989ada03d381e68fdec55b26b76b2070fb37969826eadc0a989844a732ba557"
145
137
  },
146
138
  {
147
139
  "id": "release-propagation",
@@ -205,7 +197,7 @@
205
197
  "path": "docs/site-bundle-contract.md",
206
198
  "plane": "use",
207
199
  "exists": true,
208
- "digest": "sha256:371030eda56d7a968d037e8b9a348e0211038506b8c0b14c539ec790ce884945"
200
+ "digest": "sha256:36a4e60e91f500ea1dcdbef97cd0250a2c26562b98d8d3622e8e0f9df2aad23b"
209
201
  },
210
202
  {
211
203
  "id": "migration-inventory",
@@ -237,7 +229,7 @@
237
229
  "path": "docs/cli.md",
238
230
  "plane": "use",
239
231
  "exists": true,
240
- "digest": "sha256:142d4c11dde521dae8d829372ef28eb0b7b4d05ff29d0ce35d7fc33a7230dca5"
232
+ "digest": "sha256:fad47682ed909f7b16f58bb8c24c51a943eb704a0a50ab6e033d745ee16a809a"
241
233
  },
242
234
  {
243
235
  "id": "cli-reference",
@@ -245,7 +237,7 @@
245
237
  "path": "docs/cli-reference.md",
246
238
  "plane": "use",
247
239
  "exists": true,
248
- "digest": "sha256:f77310bb6cbfca2aefbf25c02c5ee01a6c093548e5cc4d1db6b44e742e5d30d8"
240
+ "digest": "sha256:0aa0c937ca4f3f239f67c10a3e656ca0934cd3618bf84639525ea1fbd685c055"
249
241
  },
250
242
  {
251
243
  "id": "node-api-reference",
@@ -253,7 +245,7 @@
253
245
  "path": "docs/node-api-reference.md",
254
246
  "plane": "use",
255
247
  "exists": true,
256
- "digest": "sha256:37102c168f1eb23f2e9d5a86a4e2df366a755ef102626088232c8599d9cdf91e"
248
+ "digest": "sha256:f8200ba1fbe5779408b4a1e82a0e28a5e8f696b05f97efd2d286d3008755fdbb"
257
249
  },
258
250
  {
259
251
  "id": "build-facts",
@@ -269,7 +261,7 @@
269
261
  "path": "docs/kfd-support.md",
270
262
  "plane": "verify",
271
263
  "exists": true,
272
- "digest": "sha256:f849c3b69c8c716a5ae4e917e43a9a3ab8de977e7672b49697ba242fd320a014"
264
+ "digest": "sha256:4efc8fb6f94293b75606aa0631dfa122edccc970c2cfc00c7e35f81817ea8335"
273
265
  },
274
266
  {
275
267
  "id": "kfd-agent-hub",
@@ -285,7 +277,7 @@
285
277
  "path": "docs/lifecycle-protocol.md",
286
278
  "plane": "use",
287
279
  "exists": true,
288
- "digest": "sha256:9fdab92b63eae0085d460a4ec78511fbb63999a311cd7693c669705bd9897eb2"
280
+ "digest": "sha256:4b7a8efe1d22751ded069f46a23490db70cda9e9e14641acab600ab781245b19"
289
281
  },
290
282
  {
291
283
  "id": "reusable-build-surface",
@@ -293,7 +285,7 @@
293
285
  "path": "docs/reusable-build-surface.md",
294
286
  "plane": "use",
295
287
  "exists": true,
296
- "digest": "sha256:8868acbf7942b0d8e5101203a4ab98b984028b90e0584ea131e1d9b0253e4344"
288
+ "digest": "sha256:54cadd6e2f168ca40d9ed66d2f9848d5d56c9d05759bf0454f5027b1df274796"
297
289
  },
298
290
  {
299
291
  "id": "publish-transaction",
@@ -309,7 +301,7 @@
309
301
  "path": "docs/release-tail-contract.md",
310
302
  "plane": "verify",
311
303
  "exists": true,
312
- "digest": "sha256:1cfd927f30d71a359397a7177048b298269a8e665e67237187eb817e5d196b41"
304
+ "digest": "sha256:db5d38df0af0f7ce76ff93cc78a0d96a0738a40f6f40f7c1a0cfd78ca9f4f22a"
313
305
  },
314
306
  {
315
307
  "id": "release-tail-provider-plane",
@@ -317,15 +309,7 @@
317
309
  "path": "docs/release-tail-provider-plane.md",
318
310
  "plane": "use",
319
311
  "exists": true,
320
- "digest": "sha256:12f291124f51520b4f64c21d7fb249e89928b607a30bc00ba81eb1fc5acea5bd"
321
- },
322
- {
323
- "id": "publication-rehearsal",
324
- "title": "Publication rehearsal",
325
- "path": "docs/publication-rehearsal.md",
326
- "plane": "use",
327
- "exists": true,
328
- "digest": "sha256:b71c8be4a73078adae6efa838eeded0bfafef90f1e3873aad65d116f2481ae09"
312
+ "digest": "sha256:80b39ba4f0a8ed723e2a03e7efff0fee1e891245f7d1bf343edc75011aded801"
329
313
  },
330
314
  {
331
315
  "id": "release-governance",
@@ -333,7 +317,7 @@
333
317
  "path": "docs/release-governance.md",
334
318
  "plane": "why",
335
319
  "exists": true,
336
- "digest": "sha256:889955042854bb95bc5dd58d2bdd26bdc8259c096e15c0a8d479289ff51448b8"
320
+ "digest": "sha256:6dfe8a9b974040fc1465b0da696519b4e97b0b901e30d852ffacda0d193810af"
337
321
  },
338
322
  {
339
323
  "id": "release-flow",
@@ -341,7 +325,7 @@
341
325
  "path": "docs/release-flow.md",
342
326
  "plane": "verify",
343
327
  "exists": true,
344
- "digest": "sha256:dc54b8a264489341984ca6157b07d1956e934366f937b7412a21df7f025d2d8d"
328
+ "digest": "sha256:f2086d06a64f9321d7c1d62f93b37a169f781ba5bed4b714b5a8cb6509953c6e"
345
329
  },
346
330
  {
347
331
  "id": "runtime-train-validation",
@@ -357,7 +341,7 @@
357
341
  "path": "docs/versioning.md",
358
342
  "plane": "why",
359
343
  "exists": true,
360
- "digest": "sha256:0b1485e9e87a5f185041746e6ce8068373b3a6483fa7d1123f60702de471849b"
344
+ "digest": "sha256:7f6e377abf976e9eb9c5f0fd2baec96922ca44d9ab7dd08178608657fa858978"
361
345
  },
362
346
  {
363
347
  "id": "web-surface-deployments",
@@ -93,6 +93,8 @@
93
93
  "reusable": true,
94
94
  "inputs": [
95
95
  "artifact-compression-level",
96
+ "artifact-finalization-command",
97
+ "artifact-finalization-on-platform",
96
98
  "artifact-name",
97
99
  "artifact-name-template",
98
100
  "artifact-paths",
@@ -113,6 +115,8 @@
113
115
  "buildchain-contract-compatibility-policy",
114
116
  "buildchain-contract-drift-issue-mode",
115
117
  "buildchain-contract-lock-path",
118
+ "buildchain-expected-channel",
119
+ "buildchain-expected-major",
116
120
  "buildchain-ref",
117
121
  "buildchain-repository",
118
122
  "cache-dependency-lock-root",
@@ -179,7 +183,7 @@
179
183
  "verify-substage-evidence-path",
180
184
  "working-directory"
181
185
  ],
182
- "inputCount": 86,
186
+ "inputCount": 90,
183
187
  "secrets": [
184
188
  "BUILDCHAIN_ARTIFACT_RELAY_S3_DOWNLOAD_ROLE_ARN",
185
189
  "BUILDCHAIN_ARTIFACT_RELAY_S3_ROLE_ARN",
@@ -428,9 +432,10 @@
428
432
  ],
429
433
  "inputCount": 37,
430
434
  "secrets": [
435
+ "BUILDCHAIN_GOVERNANCE_READ_TOKEN",
431
436
  "KUNGFU_GOVERNANCE_AUDITOR_APP_PRIVATE_KEY"
432
437
  ],
433
- "secretCount": 1,
438
+ "secretCount": 2,
434
439
  "outputs": [
435
440
  "capability-artifact",
436
441
  "capability-digest",
@@ -464,6 +469,8 @@
464
469
  "buildchain-contract-compatibility-policy",
465
470
  "buildchain-contract-drift-issue-mode",
466
471
  "buildchain-contract-lock-path",
472
+ "buildchain-expected-channel",
473
+ "buildchain-expected-major",
467
474
  "buildchain-ref",
468
475
  "buildchain-repository",
469
476
  "channel",
@@ -567,7 +574,7 @@
567
574
  "target-sha",
568
575
  "trusted-publishing"
569
576
  ],
570
- "inputCount": 111,
577
+ "inputCount": 113,
571
578
  "secrets": [
572
579
  "BUILDCHAIN_ISSUE_APP_ID",
573
580
  "BUILDCHAIN_ISSUE_APP_PRIVATE_KEY",
@@ -1216,6 +1223,8 @@
1216
1223
  "reusable": true,
1217
1224
  "inputs": [
1218
1225
  "artifact-compression-level",
1226
+ "artifact-finalization-command",
1227
+ "artifact-finalization-on-platform",
1219
1228
  "artifact-name",
1220
1229
  "artifact-name-template",
1221
1230
  "artifact-paths",
@@ -1238,6 +1247,8 @@
1238
1247
  "buildchain-contract-compatibility-policy",
1239
1248
  "buildchain-contract-drift-issue-mode",
1240
1249
  "buildchain-contract-lock-path",
1250
+ "buildchain-expected-channel",
1251
+ "buildchain-expected-major",
1241
1252
  "buildchain-ref",
1242
1253
  "buildchain-repository",
1243
1254
  "buildchain-stable-contract-lock-path",
@@ -1305,7 +1316,7 @@
1305
1316
  "verify-substage-evidence-path",
1306
1317
  "working-directory"
1307
1318
  ],
1308
- "inputCount": 89,
1319
+ "inputCount": 93,
1309
1320
  "secrets": [
1310
1321
  "BUILDCHAIN_ARTIFACT_RELAY_S3_DOWNLOAD_ROLE_ARN",
1311
1322
  "BUILDCHAIN_ARTIFACT_RELAY_S3_ROLE_ARN",
@@ -1835,7 +1846,6 @@
1835
1846
  "path": ".github/workflows/dev-pr-auto-merge.yml",
1836
1847
  "reusable": true,
1837
1848
  "inputs": [
1838
- "active-lease-context",
1839
1849
  "affected-paths-json",
1840
1850
  "allowed-head-prefixes",
1841
1851
  "assignment-root",
@@ -1851,14 +1861,10 @@
1851
1861
  "dry-run",
1852
1862
  "expected-head-sha",
1853
1863
  "expected-pr-number",
1854
- "handoff-workflow-id",
1855
1864
  "initiative-root",
1856
1865
  "landing-mode",
1857
1866
  "max-merges",
1858
1867
  "merge-method",
1859
- "native-command",
1860
- "native-heartbeat-seconds",
1861
- "native-proof-json",
1862
1868
  "plan-root",
1863
1869
  "project-cut-proof-json",
1864
1870
  "queue-admission-context",
@@ -1869,13 +1875,11 @@
1869
1875
  "shard-evidence-roots-json",
1870
1876
  "source-identity-root",
1871
1877
  "source-patch-root",
1872
- "source-workflow-id",
1873
- "source-workflow-run-id",
1874
1878
  "target-branch",
1875
1879
  "toolchain-root",
1876
1880
  "warrant-lease-seconds"
1877
1881
  ],
1878
- "inputCount": 39,
1882
+ "inputCount": 32,
1879
1883
  "secrets": [
1880
1884
  "github-token"
1881
1885
  ],
@@ -1888,17 +1892,14 @@
1888
1892
  "evaluated-count",
1889
1893
  "final-base-sha",
1890
1894
  "merged-count",
1891
- "native-proof-root",
1892
- "native-reuse-decision-root",
1893
1895
  "project-cut-proof-root",
1894
- "qualified-warrant-receipt-root",
1895
1896
  "skipped-count",
1896
1897
  "source-proof-root",
1897
1898
  "warrant-receipt-root",
1898
1899
  "warrant-state-commit",
1899
1900
  "warrant-state-root"
1900
1901
  ],
1901
- "outputCount": 16,
1902
+ "outputCount": 13,
1902
1903
  "surface": "dev-governance",
1903
1904
  "capabilityGroup": "governance-versioning",
1904
1905
  "status": "active",
@@ -1967,7 +1968,7 @@
1967
1968
  "status": "preview",
1968
1969
  "owner": "buildchain-workflows",
1969
1970
  "maturity": "preview",
1970
- "introducedVersion": "3.0.9-alpha.8",
1971
+ "introducedVersion": "4.0.0-alpha.0",
1971
1972
  "compatibilityPromise": "preserved-through-the-v3-major-line",
1972
1973
  "deprecationReplacement": "",
1973
1974
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -1988,7 +1989,7 @@
1988
1989
  "status": "preview",
1989
1990
  "owner": "buildchain-workflows",
1990
1991
  "maturity": "preview",
1991
- "introducedVersion": "3.0.9-alpha.8",
1992
+ "introducedVersion": "4.0.0-alpha.0",
1992
1993
  "compatibilityPromise": "preserved-through-the-v3-major-line",
1993
1994
  "deprecationReplacement": "",
1994
1995
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -2009,7 +2010,7 @@
2009
2010
  "status": "preview",
2010
2011
  "owner": "buildchain-workflows",
2011
2012
  "maturity": "preview",
2012
- "introducedVersion": "3.0.9-alpha.8",
2013
+ "introducedVersion": "4.0.0-alpha.0",
2013
2014
  "compatibilityPromise": "preserved-through-the-v3-major-line",
2014
2015
  "deprecationReplacement": "",
2015
2016
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -2059,7 +2060,7 @@
2059
2060
  "status": "preview",
2060
2061
  "owner": "buildchain-workflows",
2061
2062
  "maturity": "preview",
2062
- "introducedVersion": "3.0.9-alpha.8",
2063
+ "introducedVersion": "4.0.0-alpha.0",
2063
2064
  "compatibilityPromise": "preserved-through-the-v3-major-line",
2064
2065
  "deprecationReplacement": "",
2065
2066
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
@@ -2800,25 +2801,22 @@
2800
2801
  "reusable": true,
2801
2802
  "inputs": [
2802
2803
  "buildchain-ref",
2803
- "capsule-contract",
2804
- "capsule-path",
2805
- "capsule-root",
2806
- "evidence-path",
2804
+ "declaration-path",
2805
+ "execute",
2806
+ "provider-bindings-path",
2807
2807
  "state-path"
2808
2808
  ],
2809
- "inputCount": 6,
2809
+ "inputCount": 5,
2810
2810
  "secrets": [
2811
2811
  "http-token"
2812
2812
  ],
2813
2813
  "secretCount": 1,
2814
2814
  "outputs": [
2815
- "binding-root",
2816
- "evidence-root",
2817
2815
  "state-root",
2818
2816
  "transaction-root",
2819
2817
  "transaction-state"
2820
2818
  ],
2821
- "outputCount": 5,
2819
+ "outputCount": 3,
2822
2820
  "surface": "release-tail-provider-plane",
2823
2821
  "capabilityGroup": "release-passport-trust",
2824
2822
  "status": "active",
@@ -2941,6 +2939,55 @@
2941
2939
  "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
2942
2940
  "nonDuplicationRationale": "Existing workflow identity retained for caller compatibility and repository orchestration."
2943
2941
  },
2942
+ {
2943
+ "id": "v4-public-consumer-dogfood",
2944
+ "path": ".github/workflows/v4-public-consumer-dogfood.yml",
2945
+ "reusable": false,
2946
+ "inputs": [],
2947
+ "inputCount": 0,
2948
+ "secrets": [],
2949
+ "secretCount": 0,
2950
+ "outputs": [],
2951
+ "outputCount": 0,
2952
+ "surface": "repository-workflow",
2953
+ "capabilityGroup": "api-cli-reference",
2954
+ "status": "active",
2955
+ "owner": "buildchain-workflows",
2956
+ "maturity": "active",
2957
+ "introducedVersion": "pre-3.0.2-alpha.4",
2958
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
2959
+ "deprecationReplacement": "",
2960
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
2961
+ "nonDuplicationRationale": "Existing workflow identity retained for caller compatibility and repository orchestration."
2962
+ },
2963
+ {
2964
+ "id": "v4-stage-capsule-canary",
2965
+ "path": ".github/workflows/v4-stage-capsule-canary.yml",
2966
+ "reusable": true,
2967
+ "inputs": [
2968
+ "build-artifact-path",
2969
+ "consumer",
2970
+ "go-version",
2971
+ "install-artifact-path",
2972
+ "node-version",
2973
+ "verify-artifact-path"
2974
+ ],
2975
+ "inputCount": 6,
2976
+ "secrets": [],
2977
+ "secretCount": 0,
2978
+ "outputs": [],
2979
+ "outputCount": 0,
2980
+ "surface": "repository-workflow",
2981
+ "capabilityGroup": "api-cli-reference",
2982
+ "status": "active",
2983
+ "owner": "buildchain-workflows",
2984
+ "maturity": "active",
2985
+ "introducedVersion": "pre-3.0.2-alpha.4",
2986
+ "compatibilityPromise": "preserved-through-the-v3-major-line",
2987
+ "deprecationReplacement": "",
2988
+ "sunsetCondition": "explicit-breaking-change-review-in-a-future-major-line",
2989
+ "nonDuplicationRationale": "Existing workflow identity retained for caller compatibility and repository orchestration."
2990
+ },
2944
2991
  {
2945
2992
  "id": "verify",
2946
2993
  "path": ".github/workflows/verify.yml",
@@ -3049,7 +3096,6 @@
3049
3096
  "github-release-artifact-paths",
3050
3097
  "github-release-notes",
3051
3098
  "github-release-title",
3052
- "plan-before-target-advance",
3053
3099
  "promote-only-release-candidate",
3054
3100
  "publication-capability-json",
3055
3101
  "publication-gate-aggregate-json",
@@ -3117,7 +3163,7 @@
3117
3163
  "transaction-state-path",
3118
3164
  "verification-command"
3119
3165
  ],
3120
- "inputCount": 81,
3166
+ "inputCount": 80,
3121
3167
  "capabilityGroup": "release-passport-trust",
3122
3168
  "status": "active",
3123
3169
  "owner": "buildchain-actions",
@@ -3132,15 +3178,14 @@
3132
3178
  "id": "release-tail",
3133
3179
  "path": "actions/release-tail/action.yml",
3134
3180
  "inputs": [
3135
- "capsule",
3136
- "capsule-contract",
3137
- "capsule-root",
3138
- "evidence-path",
3181
+ "declaration",
3182
+ "execute",
3139
3183
  "github-token",
3140
3184
  "http-token",
3185
+ "provider-bindings",
3141
3186
  "state-path"
3142
3187
  ],
3143
- "inputCount": 7,
3188
+ "inputCount": 6,
3144
3189
  "capabilityGroup": "release-passport-trust",
3145
3190
  "status": "active",
3146
3191
  "owner": "buildchain-actions",
package/docs/MAP.md CHANGED
@@ -59,14 +59,14 @@ workflow, action, and Node API export also carries a `capabilityGroup`,
59
59
  | Capability group | Primary facts | Primary manuals |
60
60
  | --- | --- | --- |
61
61
  | Getting Started | `capability-registry.json`, `product-mechanism.json` | [`getting-started.md`](getting-started.md), [`install.md`](install.md), [`product-mechanism.md`](product-mechanism.md), [`cli.md`](cli.md) |
62
- | Release Passport and Trust | `release-model.json`, `artifact-schemas.json`, `publication-authority-registry.json`, `kfd-claims.json` | [`release-passport.md`](release-passport.md), [`github-artifact-attestation.md`](github-artifact-attestation.md), [`publication-authority.md`](publication-authority.md), [`release-candidate.md`](release-candidate.md), [`release-train.md`](release-train.md), [`publish-transaction.md`](publish-transaction.md), [`release-tail-contract.md`](release-tail-contract.md), [`publication-rehearsal.md`](publication-rehearsal.md), [`binary-distribution.md`](binary-distribution.md) |
62
+ | Release Passport and Trust | `release-model.json`, `artifact-schemas.json`, `publication-authority-registry.json`, `kfd-claims.json` | [`release-passport.md`](release-passport.md), [`github-artifact-attestation.md`](github-artifact-attestation.md), [`publication-authority.md`](publication-authority.md), [`release-candidate.md`](release-candidate.md), [`release-train.md`](release-train.md), [`publish-transaction.md`](publish-transaction.md), [`release-tail-contract.md`](release-tail-contract.md), [`binary-distribution.md`](binary-distribution.md) |
63
63
  | Reusable Build and Lifecycle | `workflow-registry.json`, `controller-registry.json`, `release-model.json` | [`reusable-build-surface.md`](reusable-build-surface.md), [`controller-evidence.md`](controller-evidence.md), [`shifu-gate-profiles.md`](shifu-gate-profiles.md), [`lifecycle-protocol.md`](lifecycle-protocol.md) |
64
64
  | KFD Trust and Surface Closure | `kfd-claims.json`, `public-surface-audit.json`, `cli-registry.json`, `node-api-registry.json` | [`kfd-support.md`](kfd-support.md), [`release-passport.md`](release-passport.md) |
65
65
  | Site Bundle, Web Surfaces, and Propagation | `buildchain-site.json`, `site-manifest.json`, `page-registry.json`, `release-model.json` | [`site-bundle-contract.md`](site-bundle-contract.md), [`web-surface-deployments.md`](web-surface-deployments.md), [`release-propagation.md`](release-propagation.md) |
66
66
  | Publication Artifacts | `publication-registry.json`, `workflow-registry.json`, `node-api-registry.json`, `manual-registry.json`, `kungfu-buildchain-publication-artifact-registry` | [`publication-artifacts.md`](publication-artifacts.md), [`reusable-build-surface.md`](reusable-build-surface.md) |
67
67
  | Distribution Indexes and Badges | `badge-endpoint-registry.json`, `node-api-registry.json`, `manual-registry.json` | [`readme-badges.md`](readme-badges.md), [`homebrew.md`](homebrew.md) |
68
68
  | Build Facts, Observability, and Diagnostics | `cli-registry.json`, `node-api-registry.json`, lifecycle artifacts | [`build-facts.md`](build-facts.md), [`toolkit-observability.md`](toolkit-observability.md), [`consumer-issue-reporting.md`](consumer-issue-reporting.md) |
69
- | Governance, Versioning, and Runtime Drift | `buildchain-contract.json`, `workflow-registry.json`, `release-model.json` | [`github-governance-authority.md`](github-governance-authority.md), [`release-governance.md`](release-governance.md), [`release-flow.md`](release-flow.md), [`next-development-transition.md`](next-development-transition.md), [`versioning.md`](versioning.md), [`runtime-train-validation.md`](runtime-train-validation.md), [`cli.md`](cli.md) |
69
+ | Governance, Versioning, and Runtime Drift | `buildchain-contract.json`, `workflow-registry.json`, `release-model.json` | [`github-governance-authority.md`](github-governance-authority.md), [`release-governance.md`](release-governance.md), [`release-flow.md`](release-flow.md), [`versioning.md`](versioning.md), [`runtime-train-validation.md`](runtime-train-validation.md), [`cli.md`](cli.md) |
70
70
  | CLI and Node API Reference | `cli-registry.json`, `node-api-registry.json`, `workflow-registry.json`, `manual-registry.json` | [`cli-reference.md`](cli-reference.md), [`node-api-reference.md`](node-api-reference.md), [`cli.md`](cli.md), [`../packages/core/README.md`](../packages/core/README.md) |
71
71
 
72
72
  | Capability | Machine-readable entry | Manual entry |
@@ -110,6 +110,12 @@ replace them.
110
110
  | How do I initialize a new repository? | [`getting-started.md`](getting-started.md) + [`lifecycle-protocol.md`](lifecycle-protocol.md) | use | stable |
111
111
  | Why does Buildchain use branch-driven release governance? | [`release-governance.md`](release-governance.md) | why | stable |
112
112
  | What freezes the v4 dependency direction, writer authority, complexity budgets, exceptions, and N-1 qualification? | [`../architecture/v4-architecture-constitution.md`](../architecture/v4-architecture-constitution.md) | why/verify | preview |
113
+ | How will Delivery Warrant move from the v3 writer through shadow, v4 read, single-writer cutover, and legacy removal? | [`../architecture/v4-delivery-warrant-shadow-bootstrap-plan.md`](../architecture/v4-delivery-warrant-shadow-bootstrap-plan.md) | why/verify | preview |
114
+ | What exact canonical bytes, roots, clocks, event, receipt, and typed-fault contracts do Rust and JavaScript share in v4? | [`v4-canonical-contracts.md`](v4-canonical-contracts.md) | use/verify | preview |
115
+ | How is one per-platform v4 build stage identified, retained, observed, and reused without provider identity or a second writer? | [`v4-stage-capsule.md`](v4-stage-capsule.md) | use/verify | preview |
116
+ | How does a late platform failure deterministically reuse qualified Stage Capsules and rebuild only invalid or missing dependencies? | [`v4-stage-capsule.md`](v4-stage-capsule.md#deterministic-resume-planning) | use/verify | preview |
117
+ | How do Rust and JavaScript read the same retained Delivery Warrant traces and emit one semantic projection? | [`v4-canonical-contracts.md`](v4-canonical-contracts.md#shared-delivery-warrant-fixture-runner) | use/verify | preview |
118
+ | How does an explicit caller try the qualified v4 read projection and roll back without moving v3 writer authority? | [`v4-delivery-warrant-read-candidate.md`](v4-delivery-warrant-read-candidate.md) | use/verify | preview |
113
119
  | How do protected dev branches and scheduled ready-PR merging work? | [`release-governance.md`](release-governance.md#protected-dev-branches) | use | stable |
114
120
  | How do slow required checks land reliably on a busy dev channel? | [`release-governance.md`](release-governance.md#protected-dev-branches) + [`cli.md`](cli.md#commands) | use | preview |
115
121
  | How does the durable fair Dev Delivery Warrant Queue prevent slow-candidate starvation? | [`dev-delivery-warrant.md`](dev-delivery-warrant.md) | use/verify | preview |
@@ -118,13 +124,11 @@ replace them.
118
124
  | How do I report or safely apply branch and pull-request engineering hygiene? | [`engineering-housekeeper.md`](engineering-housekeeper.md) | use/verify | preview |
119
125
  | How does Buildchain decide patch, minor, and major release lines? | [`versioning.md`](versioning.md) | why | stable |
120
126
  | What exact branch/tag state machine runs on alpha, release, and major gate? | [`release-flow.md`](release-flow.md) | verify | stable |
121
- | How does a completed Alpha remain successful while the following development version is prepared? | [`next-development-transition.md`](next-development-transition.md), [`../architecture/decisions/0002-next-development-transition.md`](../architecture/decisions/0002-next-development-transition.md) | verify/use | preview |
122
127
  | What did Buildchain migrate or retire from old action repositories? | [`migration-inventory.md`](migration-inventory.md) | verify | stable |
123
128
  | What is the active action and workflow source of truth? | [`ownership.md`](ownership.md) | verify | stable |
124
129
  | How do I declare version files and custom lifecycle commands? | [`lifecycle-protocol.md`](lifecycle-protocol.md) | use | stable |
125
130
  | How does publish evidence, recovery, and finalization work? | [`publish-transaction.md`](publish-transaction.md) | verify | stable |
126
131
  | How are consumer-owned release-tail commands inventoried and replaced by declarative capabilities? | [`release-tail-contract.md`](release-tail-contract.md) | verify | draft |
127
- | How do I reproduce publication semantics locally without GitHub runner state? | [`publication-rehearsal.md`](publication-rehearsal.md), [`../architecture/decisions/0001-release-local-constructibility.md`](../architecture/decisions/0001-release-local-constructibility.md) | use/verify | preview |
128
132
  | How do I collect and verify module/product build facts from Git source, version files, and outputs? | [`build-facts.md`](build-facts.md) + [`cli.md`](cli.md) | use/verify | stable |
129
133
  | How do I publish or verify release passport artifacts? | [`release-passport.md`](release-passport.md) | use | stable |
130
134
  | How do I keylessly attest Linux release artifacts with GitHub and bind them to a Release Passport? | [`github-artifact-attestation.md`](github-artifact-attestation.md) | verify/use | preview |
@@ -47,7 +47,7 @@ literal argv steps. Steps in one demo share a disposable workspace; separate
47
47
  demos and the two rendition captures do not. Commands are never accepted as a
48
48
  shell string. An omitted or explicit `standard` duration class remains bounded
49
49
  to 60 seconds. A reviewed `execution.durationClass: long-form` declaration may
50
- raise the scenario and literal step ceilings to 360 seconds; it does not change
50
+ raise the scenario and literal step ceilings to 180 seconds; it does not change
51
51
  the default. Both classes retain 4 MiB per step, a clean Home/XDG environment,
52
52
  no inherited credentials, and a network-disabled read-only container with
53
53
  bounded tmpfs.
@@ -155,7 +155,7 @@ scene.json
155
155
 
156
156
  It may additionally emit one declared `terminal-capture.json` using
157
157
  `kungfu.terminal-capture/v1`. The optional capture is bounded to 60 seconds by
158
- default or 360 seconds only when its scene explicitly declares `long-form`,
158
+ default or 180 seconds only when its scene explicitly declares `long-form`,
159
159
  fixed 80-200 by 24-80 terminal cells, 10,000 events, and 4 MiB of canonical
160
160
  base64 bytes. It must contain a qualified completion sentinel and an explicitly
161
161
  empty authority-grant list. Existing three-file adapters remain valid.