@kungfu-tech/buildchain 4.0.2 → 4.0.3-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 (233) hide show
  1. package/AGENTS.md +4 -4
  2. package/CONTRIBUTING.md +34 -0
  3. package/README.md +1 -1
  4. package/architecture/agent-change-map.md +154 -147
  5. package/architecture/{v4-architecture-constitution.md → architecture-constitution.md} +11 -11
  6. package/architecture/{v3-core-mechanism-inventory.md → baseline-core-mechanism-inventory.md} +1 -1
  7. package/architecture/{v4-bootstrap-authority.json → bootstrap-authority.json} +3 -3
  8. package/architecture/{v3-v4-capability-closure.md → capability-parity-closure.md} +3 -3
  9. package/architecture/{v3-v4-live-capability-inventory.json → capability-parity-live-capability-inventory.json} +4 -4
  10. package/architecture/{v4-capability-state-machine-manifest.json → capability-state-machine-manifest.json} +2 -2
  11. package/architecture/{v4-capability-state-machine-manifest.schema.json → capability-state-machine-manifest.schema.json} +2 -2
  12. package/architecture/ci-lane-change-budget.json +18 -0
  13. package/architecture/{v4-cross-platform-adopter-qualification.json → cross-platform-adopter-qualification.json} +3 -3
  14. package/architecture/{v4-delivery-authority-parity.json → delivery-authority-parity.json} +16 -16
  15. package/architecture/{v4-delivery-warrant-shadow-bootstrap-plan.json → delivery-warrant-shadow-bootstrap-plan.json} +3 -3
  16. package/architecture/{v4-delivery-warrant-shadow-bootstrap-plan.md → delivery-warrant-shadow-bootstrap-plan.md} +7 -7
  17. package/architecture/{v4-floating-consumer-policy.md → floating-consumer-policy.md} +1 -1
  18. package/architecture/implementation-naming.json +1273 -0
  19. package/architecture/internal-capabilities.json +171 -169
  20. package/architecture/maintainability-debt.json +87 -82
  21. package/architecture/maintainability-policy.json +15 -15
  22. package/architecture/{v4-next-development-parity.json → next-development-parity.json} +8 -8
  23. package/architecture/{v4-partial-mutation-recovery-qualification.json → partial-mutation-recovery-qualification.json} +8 -8
  24. package/architecture/{v4-platform-stage-checkpoints.json → platform-stage-checkpoints.json} +2 -2
  25. package/architecture/{v4-provider-operation-journal-contract.json → provider-operation-journal-contract.json} +9 -9
  26. package/architecture/{v4-publication-rehearsal-parity.json → publication-rehearsal-parity.json} +4 -4
  27. package/architecture/{v4-release-activation-shadow-domain.json → release-activation-shadow-domain.json} +8 -8
  28. package/architecture/{v4-release-topology.json → release-topology.json} +112 -56
  29. package/architecture/{v4-release-train-parity.json → release-train-parity.json} +2 -2
  30. package/architecture/{v4-runtime-ref-resume-authority.json → runtime-ref-resume-authority.json} +1 -1
  31. package/architecture/{v4-runtime-semantic-closure.json → runtime-semantic-closure.json} +2 -2
  32. package/architecture/{v4-rust-libnode-bridge-evaluation.json → rust-libnode-bridge-evaluation.json} +3 -3
  33. package/architecture/{v4-rust-libnode-bridge-spike.md → rust-libnode-bridge-spike.md} +6 -6
  34. package/architecture/{v4-rust-wasm-production-authority.json → rust-wasm-production-authority.json} +11 -11
  35. package/architecture/{v4-stable-publication-fence.json → stable-publication-fence.json} +6 -6
  36. package/architecture/{v4-stage-capsule-contract.json → stage-capsule-contract.json} +1 -1
  37. package/architecture/{v4-stage-capsule-qualification.json → stage-capsule-qualification.json} +6 -6
  38. package/architecture/{v4-stage-capsule-resume-planner.json → stage-capsule-resume-planner.json} +2 -2
  39. package/architecture/{v4-stage-capsule-store-contract.json → stage-capsule-store-contract.json} +4 -4
  40. package/architecture/{v4-tail-reseal-parity.json → tail-reseal-parity.json} +28 -28
  41. package/architecture/{v4-universal-workflow-bootstrap.json → universal-workflow-bootstrap.json} +9 -4
  42. package/architecture/{v4-universal-workflow-fault-campaign.json → universal-workflow-fault-campaign.json} +8 -8
  43. package/architecture/{v4-universal-workflow-train-admission.json → universal-workflow-train-admission.json} +8 -8
  44. package/architecture/workflow-taxonomy.json +11 -0
  45. package/bin/buildchain.mjs +3 -3
  46. package/bin/internal/adopter-delivery-cli.mjs +9 -9
  47. package/contracts/fixtures/v4-tail-reseal-v1/valid.json +1 -1
  48. package/crates/{buildchain-v4-bridge → buildchain-host-bridge}/Cargo.lock +1 -1
  49. package/crates/{buildchain-v4-bridge → buildchain-host-bridge}/Cargo.toml +1 -1
  50. package/crates/{buildchain-v4-bridge → buildchain-host-bridge}/src/main.rs +3 -3
  51. package/dist/site/buildchain-contract.json +18 -18
  52. package/dist/site/buildchain-site.json +167 -71
  53. package/dist/site/capability-registry.json +5 -5
  54. package/dist/site/kfd-claims.json +226 -90
  55. package/dist/site/kfd-upstream-aggregate.json +1 -1
  56. package/dist/site/manual-registry.json +7 -7
  57. package/dist/site/node-api-registry.json +12929 -10491
  58. package/dist/site/page-registry.json +155 -59
  59. package/dist/site/public-surface-audit.json +65 -46
  60. package/dist/site/publication-authority-registry.json +27 -17
  61. package/dist/site/publication-registry.json +4 -4
  62. package/dist/site/release-provenance.json +18 -9
  63. package/dist/site/site-manifest.json +11 -11
  64. package/dist/site/workflow-registry.json +86 -52
  65. package/docs/MAP.md +4 -3
  66. package/docs/next-development-transition.md +24 -1
  67. package/docs/node-api-reference.md +435 -175
  68. package/docs/oci-publication.md +173 -0
  69. package/docs/publish-transaction.md +36 -3
  70. package/docs/release-flow.md +1 -1
  71. package/docs/reusable-build-surface.md +1 -1
  72. package/docs/v4-adopter-delivery.md +2 -2
  73. package/docs/v4-canonical-contracts.md +7 -7
  74. package/docs/v4-delivery-warrant-read-candidate.md +3 -3
  75. package/docs/v4-delivery-warrant-semantic-diff.md +3 -3
  76. package/docs/v4-production-release.md +8 -2
  77. package/docs/v4-publication-rehearsal.md +3 -3
  78. package/docs/v4-runtime-ref-resume-authority.md +2 -2
  79. package/docs/v4-rust-wasm-production-authority.md +6 -6
  80. package/docs/v4-stage-capsule.md +7 -7
  81. package/docs/v4-tail-reseal.md +1 -1
  82. package/docs/workflow-catalog.md +1 -0
  83. package/package.json +37 -26
  84. package/packages/compatibility/adopter-delivery.js +16 -0
  85. package/packages/compatibility/cross-platform-adopter-qualification.js +12 -0
  86. package/packages/compatibility/floating-consumer-policy.js +14 -0
  87. package/packages/compatibility/publication-qualification.js +11 -0
  88. package/packages/compatibility/publication-rehearsal.js +18 -0
  89. package/packages/compatibility/runtime-ref-resume-authority.js +13 -0
  90. package/packages/compatibility/tail-reseal-receipt.js +7 -0
  91. package/packages/compatibility/tail-reseal.js +11 -0
  92. package/packages/core/{v4-adopter-delivery-parity.js → adopter-delivery-parity.js} +12 -12
  93. package/packages/core/{v4-adopter-delivery.js → adopter-delivery.js} +24 -24
  94. package/packages/core/buildchain-contract.js +5 -5
  95. package/packages/core/buildchain-domain.wasm +0 -0
  96. package/packages/core/buildchain-publication-authority.js +1 -0
  97. package/packages/core/{v4-canonical-contracts.js → canonical-contracts.js} +32 -31
  98. package/packages/core/{v4-cross-platform-adopter-qualification.js → cross-platform-adopter-qualification.js} +19 -19
  99. package/packages/core/{v4-delivery-warrant-fixture-runner.js → delivery-warrant-fixture-runner.js} +36 -32
  100. package/packages/core/{v4-delivery-warrant-read-candidate.js → delivery-warrant-read-candidate.js} +40 -40
  101. package/packages/core/{v4-delivery-warrant-semantic-diff-gate.js → delivery-warrant-semantic-diff-gate.js} +58 -59
  102. package/packages/core/{v4-delivery-warrant-shadow-adapter.js → delivery-warrant-shadow-adapter.js} +15 -15
  103. package/packages/core/dev-delivery-execution-transfer.js +6 -6
  104. package/packages/core/dev-delivery-native-proof.js +12 -8
  105. package/packages/core/dev-delivery-warrant-legacy-recovery.js +1 -1
  106. package/packages/core/dev-delivery-warrant-native-compatibility.js +4 -4
  107. package/packages/core/dev-delivery-warrant-state.js +11 -11
  108. package/packages/core/dev-delivery-warrant.js +3 -3
  109. package/packages/core/domain-wasm-artifact.js +7 -0
  110. package/packages/core/{v4-domain-wasm.js → domain-wasm.js} +31 -31
  111. package/packages/core/{v4-floating-consumer-evidence.js → floating-consumer-evidence.js} +13 -13
  112. package/packages/core/{v4-floating-consumer-policy.js → floating-consumer-policy.js} +27 -29
  113. package/packages/core/{v4-floating-consumer-release-passport.js → floating-consumer-release-passport.js} +25 -25
  114. package/packages/core/index.js +4 -8
  115. package/packages/core/next-development-projection.js +24 -1
  116. package/packages/core/next-development-transition.js +5 -6
  117. package/packages/core/oci-compose-qualification.js +143 -0
  118. package/packages/core/oci-publication-bundle.js +281 -0
  119. package/packages/core/oci-publication-graph.js +206 -0
  120. package/packages/core/paper-runtime-channels.js +2 -2
  121. package/packages/core/paper.js +3 -3
  122. package/packages/core/partial-mutation-recovery-qualification.js +18 -0
  123. package/packages/core/{v4-platform-stage-checkpoints.js → platform-stage-checkpoints.js} +37 -37
  124. package/packages/core/{v4-product-publication.js → product-publication.js} +11 -9
  125. package/packages/core/{v4-protected-publication-source.js → protected-publication-source.js} +3 -3
  126. package/packages/core/provider-operation-journal.js +62 -0
  127. package/packages/core/{v4-provider-readback-idempotency.js → provider-readback-idempotency.js} +33 -33
  128. package/packages/core/public-export-compatibility.js +33 -0
  129. package/packages/core/publication-development.js +72 -0
  130. package/packages/core/{v4-publication-qualification.js → publication-qualification.js} +17 -17
  131. package/packages/core/{v4-publication-rehearsal-capsule.js → publication-rehearsal-capsule.js} +23 -23
  132. package/packages/core/publication-rehearsal-projection.js +2 -2
  133. package/packages/core/{v4-publication-rehearsal-provider-bindings.js → publication-rehearsal-provider-bindings.js} +4 -4
  134. package/packages/core/publication-rehearsal-runtime.js +21 -21
  135. package/packages/core/{v4-publication-rehearsal.js → publication-rehearsal.js} +33 -33
  136. package/packages/core/publication-sealed-bundle.js +78 -13
  137. package/packages/core/release-activation-shadow.js +32 -0
  138. package/packages/core/release-candidate.js +6 -6
  139. package/packages/core/{v4-release-invocation.js → release-invocation.js} +15 -15
  140. package/packages/core/release-passport.js +36 -36
  141. package/packages/core/release-tail-product-capabilities.js +9 -0
  142. package/packages/core/release-tail-provider-plane.js +10 -10
  143. package/packages/core/{v4-runtime-ref-resume-authority.js → runtime-ref-resume-authority.js} +36 -40
  144. package/packages/core/{v4-runtime-selector-persistence.js → runtime-selector-persistence.js} +7 -7
  145. package/packages/core/stable-publication-fence.js +28 -0
  146. package/packages/core/{v4-stage-capsule-local-store.js → stage-capsule-local-store.js} +56 -54
  147. package/packages/core/{v4-stage-capsule-qualification-campaign.js → stage-capsule-qualification-campaign.js} +37 -38
  148. package/packages/core/{v4-stage-capsule-qualification.js → stage-capsule-qualification.js} +28 -29
  149. package/packages/core/{v4-stage-capsule-resume-planner.js → stage-capsule-resume-planner.js} +29 -29
  150. package/packages/core/{v4-stage-capsule-store.js → stage-capsule-store.js} +59 -56
  151. package/packages/core/{v4-stage-capsule.js → stage-capsule.js} +45 -45
  152. package/packages/core/{v4-tail-reseal-contract.js → tail-reseal-contract.js} +6 -6
  153. package/packages/core/{v4-tail-reseal-github.js → tail-reseal-github.js} +12 -12
  154. package/packages/core/{v4-tail-reseal-receipt.js → tail-reseal-receipt.js} +22 -22
  155. package/packages/core/{v4-tail-reseal.js → tail-reseal.js} +29 -29
  156. package/packages/core/{v4-universal-workflow-bootstrap.js → universal-workflow-bootstrap.js} +23 -23
  157. package/scripts/{v4-architecture.mjs → architecture.mjs} +6 -6
  158. package/scripts/binary-publication-evidence.mjs +1 -1
  159. package/scripts/{v4-bridge-bootstrap.mjs → bridge-bootstrap.mjs} +14 -18
  160. package/scripts/{v4-bridge-evidence.mjs → bridge-evidence.mjs} +8 -8
  161. package/scripts/{build-v4-domain-wasm.mjs → build-domain-wasm.mjs} +6 -18
  162. package/scripts/{v3-v4-capability-catalog.mjs → capability-parity-catalog.mjs} +19 -19
  163. package/scripts/check-action-bundles.mjs +2 -2
  164. package/scripts/{check-v3-v4-capability-inventory.mjs → check-capability-parity-inventory.mjs} +42 -42
  165. package/scripts/check-core-mechanism-inventory.mjs +4 -1
  166. package/scripts/{check-v4-floating-consumer-policy-contract.mjs → check-floating-consumer-policy-contract.mjs} +8 -8
  167. package/scripts/check-implementation-naming.mjs +135 -0
  168. package/scripts/check-inventory.mjs +6 -5
  169. package/scripts/check-maintainability.mjs +9 -2
  170. package/scripts/{check-v4-public-dogfood-contract.mjs → check-public-dogfood-contract.mjs} +15 -15
  171. package/scripts/{check-v4-release-topology.mjs → check-release-topology.mjs} +53 -31
  172. package/scripts/{check-v4-runtime-semantic-closure.mjs → check-runtime-semantic-closure.mjs} +19 -16
  173. package/scripts/{check-v4-universal-workflow-bootstrap.mjs → check-universal-workflow-bootstrap.mjs} +14 -14
  174. package/scripts/{v4-consumer-policy.mjs → consumer-policy.mjs} +15 -15
  175. package/scripts/{copy-v4-domain-wasm.mjs → copy-domain-wasm.mjs} +3 -3
  176. package/scripts/{v4-cross-platform-adopter-qualification.mjs → cross-platform-adopter-qualification.mjs} +9 -9
  177. package/scripts/{v4-declarative-promotion-admission.mjs → declarative-promotion-admission.mjs} +4 -4
  178. package/scripts/dev-delivery-warrant-options.mjs +1 -1
  179. package/scripts/dev-delivery-warrant-store.mjs +29 -10
  180. package/scripts/dev-delivery-warrant.mjs +4 -4
  181. package/scripts/dev-pr-delivery-warrant.mjs +1 -1
  182. package/scripts/generate-channel-build-workflow.mjs +2 -2
  183. package/scripts/generate-channel-promotion-workflow.mjs +14 -31
  184. package/scripts/generate-release-candidate-passport.mjs +23 -23
  185. package/scripts/generate-site-bundle.mjs +17 -17
  186. package/scripts/{generate-v4-universal-workflow-facades.mjs → generate-universal-workflow-facades.mjs} +61 -21
  187. package/scripts/{v4-host-adapter.mjs → host-adapter.mjs} +1 -1
  188. package/scripts/implementation-references.mjs +25 -0
  189. package/scripts/init-repo.mjs +1 -1
  190. package/scripts/next-development-review.mjs +17 -11
  191. package/scripts/oci-compose-preview.mjs +261 -0
  192. package/scripts/{v4-platform-stage-checkpoint-rehearsal.mjs → platform-stage-checkpoint-rehearsal.mjs} +17 -17
  193. package/scripts/{v4-product-publication-intent.mjs → product-publication-intent.mjs} +16 -8
  194. package/scripts/publication-candidate-kind.mjs +93 -0
  195. package/scripts/publication-candidate-sealer.mjs +16 -1
  196. package/scripts/{v4-publication-rehearsal-fixture.mjs → publication-rehearsal-fixture.mjs} +5 -5
  197. package/scripts/{v4-publication-settlement.mjs → publication-settlement.mjs} +8 -8
  198. package/scripts/{v4-release-candidate-adapter.mjs → release-candidate-adapter.mjs} +4 -4
  199. package/scripts/release-candidate-resolver.mjs +15 -26
  200. package/scripts/release-tail.mjs +5 -5
  201. package/scripts/resume-from-candidate-run.mjs +35 -42
  202. package/scripts/site-capability-metadata.mjs +9 -0
  203. package/scripts/source-verification-evidence.mjs +7 -7
  204. package/scripts/{v4-stage-capsule-qualification.mjs → stage-capsule-qualification.mjs} +62 -62
  205. package/scripts/{v4-stage-capsule-resume-rehearsal.mjs → stage-capsule-resume-rehearsal.mjs} +6 -6
  206. package/scripts/{v4-tail-reseal-macos-rehearsal.mjs → tail-reseal-macos-rehearsal.mjs} +9 -9
  207. package/scripts/{v4-tail-reseal.mjs → tail-reseal.mjs} +19 -19
  208. package/scripts/universal-facade-maintainability.mjs +12 -3
  209. package/scripts/{v4-universal-workflow-backflow.mjs → universal-workflow-backflow.mjs} +10 -10
  210. package/scripts/{v4-universal-workflow-engine.mjs → universal-workflow-engine.mjs} +40 -38
  211. package/scripts/{v4-universal-workflow-self-dogfood.mjs → universal-workflow-self-dogfood.mjs} +12 -12
  212. package/scripts/verify-version-state-delta.mjs +4 -2
  213. package/scripts/{v4-warrant-shadow-plan.mjs → warrant-shadow-plan.mjs} +6 -6
  214. package/templates/universal-buildchain-bootstrap-recovery.yml +4 -4
  215. package/packages/core/buildchain-v4-domain.wasm +0 -0
  216. package/packages/core/v4-domain-wasm-artifact.js +0 -7
  217. package/packages/core/v4-partial-mutation-recovery-qualification.js +0 -18
  218. package/packages/core/v4-provider-operation-journal.js +0 -62
  219. package/packages/core/v4-release-activation-shadow.js +0 -32
  220. package/packages/core/v4-stable-publication-fence.js +0 -28
  221. /package/actions/{v4-release-candidate-promote → release-candidate-promote}/README.md +0 -0
  222. /package/architecture/{v4-adopter-delivery-parity.json → adopter-delivery-parity.json} +0 -0
  223. /package/architecture/{v3-core-mechanism-inventory.json → baseline-core-mechanism-inventory.json} +0 -0
  224. /package/architecture/{v4-canonical-contract-fixtures.json → canonical-contract-fixtures.json} +0 -0
  225. /package/architecture/{v4-compatibility-facts-parity.json → compatibility-facts-parity.json} +0 -0
  226. /package/architecture/{v4-delivery-warrant-shadow-bootstrap-plan.schema.json → delivery-warrant-shadow-bootstrap-plan.schema.json} +0 -0
  227. /package/architecture/{v4-delivery-warrant-shadow-fixtures.json → delivery-warrant-shadow-fixtures.json} +0 -0
  228. /package/architecture/{v4-delivery-warrant-shadow-fixtures.schema.json → delivery-warrant-shadow-fixtures.schema.json} +0 -0
  229. /package/architecture/{v4-exception-ledger.json → exception-ledger.json} +0 -0
  230. /package/architecture/{v4-exception-ledger.schema.json → exception-ledger.schema.json} +0 -0
  231. /package/architecture/{v4-floating-consumer-policy.json → floating-consumer-policy.json} +0 -0
  232. /package/architecture/{v4-publication-facade-patches.json → publication-facade-patches.json} +0 -0
  233. /package/architecture/{v4-release-invocation-fixtures.json → release-invocation-fixtures.json} +0 -0
@@ -19,7 +19,7 @@ ai_provenance:
19
19
  # Buildchain v4 Architecture Constitution
20
20
 
21
21
  This constitution governs the `dev/v4/v4.0` release line. The executable
22
- authority is [`v4-capability-state-machine-manifest.json`](v4-capability-state-machine-manifest.json),
22
+ authority is [`capability-state-machine-manifest.json`](capability-state-machine-manifest.json),
23
23
  validated by `buildchain architecture validate`. This document explains that
24
24
  contract; it cannot override it.
25
25
 
@@ -27,7 +27,7 @@ contract; it cannot override it.
27
27
 
28
28
  The first v4 line was created from the exact protected v3 merge that contains
29
29
  this constitution and
30
- [`v4-bootstrap-authority.json`](v4-bootstrap-authority.json). The exact source,
30
+ [`bootstrap-authority.json`](bootstrap-authority.json). The exact source,
31
31
  bootstrap revision, N-1 qualification, protection, and merge-queue evidence are
32
32
  recorded there under the state `qualified-protected-v4-bootstrap`; a local
33
33
  branch or unrecorded candidate commit is not release-line authority.
@@ -87,7 +87,7 @@ second hand-maintained architecture list is authoritative.
87
87
  The v4 line owns Delivery Warrant, Release Transaction, activation,
88
88
  publication, propagation, and release-tail state. Its production domain is the
89
89
  tracked artifact governed by
90
- [`v4-rust-wasm-production-authority.json`](v4-rust-wasm-production-authority.json):
90
+ [`rust-wasm-production-authority.json`](rust-wasm-production-authority.json):
91
91
  Node verifies the artifact digest and ABI before use and fails closed without a
92
92
  JavaScript semantic fallback. This does not introduce a daemon, a service
93
93
  database, provider SDKs in contracts or Rust domain code, or a second writer.
@@ -97,7 +97,7 @@ regain production authority without a new reviewed cutover.
97
97
  ## 7. Wave 0 host boundary
98
98
 
99
99
  The bounded Rust/libnode bridge spike is recorded in
100
- [`v4-rust-libnode-bridge-spike.md`](v4-rust-libnode-bridge-spike.md). Wave 0
100
+ [`rust-libnode-bridge-spike.md`](rust-libnode-bridge-spike.md). Wave 0
101
101
  uses a replaceable subprocess host behind a closed byte-oriented contract; the
102
102
  Rust trunk owns process lifecycle and transport, while existing TypeScript
103
103
  remains the only production writer. This selection is evidence for later
@@ -106,7 +106,7 @@ qualification, not a final ABI or consumer migration.
106
106
  ## 8. Wave 2 Stage Capsule contract
107
107
 
108
108
  The executable Stage Capsule architecture contract is
109
- [`v4-stage-capsule-contract.json`](v4-stage-capsule-contract.json). It fixes one
109
+ [`stage-capsule-contract.json`](stage-capsule-contract.json). It fixes one
110
110
  schema authority, one TypeScript v3 writer, validation-only Rust, and zero
111
111
  provider imports or production write-authority changes. Identity, retention
112
112
  promise, current availability, qualification, content roots, and rooted
@@ -115,7 +115,7 @@ reconciliation work must consume this contract rather than create competing
115
115
  identity or writer authority.
116
116
 
117
117
  The successor storage slice is governed by
118
- [`v4-stage-capsule-store-contract.json`](v4-stage-capsule-store-contract.json).
118
+ [`stage-capsule-store-contract.json`](stage-capsule-store-contract.json).
119
119
  It adds provider-neutral output-manifest, retention-state, transport, and store
120
120
  receipt roots plus a deterministic no-network local filesystem reference
121
121
  store. GitHub Artifact and S3-compatible adapters remain effect-disabled or
@@ -124,7 +124,7 @@ and qualification evidence stay separate facts; none becomes Capsule identity,
124
124
  qualification authority, or a production writer.
125
125
 
126
126
  Final Wave 2 qualification is governed by
127
- [`v4-stage-capsule-qualification.json`](v4-stage-capsule-qualification.json).
127
+ [`stage-capsule-qualification.json`](stage-capsule-qualification.json).
128
128
  It consumes the existing Capsule, store, checkpoint, and resume authorities for
129
129
  six real-runner shadow campaigns and one exact terminal reconciliation. A
130
130
  qualification root is evidence only: TypeScript v3 remains production
@@ -134,7 +134,7 @@ effects, release effects, and public cutover remain outside this transition.
134
134
  ## 9. Wave 3 provider operation journal
135
135
 
136
136
  The executable provider operation journal contract is
137
- [`v4-provider-operation-journal-contract.json`](v4-provider-operation-journal-contract.json).
137
+ [`provider-operation-journal-contract.json`](provider-operation-journal-contract.json).
138
138
  It freezes one closed schema authority and one Rust v4 state-fold authority
139
139
  for append-only intent, attempt, rooted observation, confirmation, and
140
140
  reconciliation records. The Node v4 plane performs provider adaptation and
@@ -161,7 +161,7 @@ closed with typed faults.
161
161
  ## 10. Release activation production domain
162
162
 
163
163
  The executable release activation boundary is
164
- [`v4-release-activation-shadow-domain.json`](v4-release-activation-shadow-domain.json).
164
+ [`release-activation-shadow-domain.json`](release-activation-shadow-domain.json).
165
165
  It consumes an explicit qualification root, dependency graph, compensation
166
166
  boundaries, provider-operation identities, and append-only journal facts to
167
167
  derive one deterministic activation plan and resume state. Rust/WASM is the
@@ -180,7 +180,7 @@ rooted readback before confirmation or retry.
180
180
  ## 11. Stable publication production fence
181
181
 
182
182
  The stable-candidate production publication boundary is governed by
183
- [`v4-stable-publication-fence.json`](v4-stable-publication-fence.json). It
183
+ [`stable-publication-fence.json`](stable-publication-fence.json). It
184
184
  binds one exact candidate root to source, metadata, provider-operation journal,
185
185
  protected ancestry, provider confirmations, and an independently sealed
186
186
  qualification before a production publication plan can exist.
@@ -196,7 +196,7 @@ targets, and it must read them back before completion.
196
196
  ## 12. Wave 3 partial-mutation recovery qualification
197
197
 
198
198
  The executable recovery qualification boundary is
199
- [`v4-partial-mutation-recovery-qualification.json`](v4-partial-mutation-recovery-qualification.json).
199
+ [`partial-mutation-recovery-qualification.json`](partial-mutation-recovery-qualification.json).
200
200
  It consumes retained Stage Capsule resume evidence and release-activation journal
201
201
  state only after exact source, policy, platform, qualification, plan, state,
202
202
  operation, journal, and compensation-boundary roots agree.
@@ -19,7 +19,7 @@ ai_provenance:
19
19
  # v3 Core Mechanism Inventory
20
20
 
21
21
  This is the human projection of
22
- [`v3-core-mechanism-inventory.json`](v3-core-mechanism-inventory.json).
22
+ [`baseline-core-mechanism-inventory.json`](baseline-core-mechanism-inventory.json).
23
23
  The JSON inventory is authoritative and validated by
24
24
  `scripts/check-core-mechanism-inventory.mjs`.
25
25
 
@@ -36,9 +36,9 @@
36
36
  "verifiedAt": "2026-08-07T02:20:03Z"
37
37
  },
38
38
  "authorityFiles": [
39
- "architecture/v4-bootstrap-authority.json",
40
- "architecture/v4-capability-state-machine-manifest.json",
41
- "architecture/v4-exception-ledger.json"
39
+ "architecture/bootstrap-authority.json",
40
+ "architecture/capability-state-machine-manifest.json",
41
+ "architecture/exception-ledger.json"
42
42
  ],
43
43
  "bootstrapRule": {
44
44
  "authorityRevision": "the exact protected dev/v3/v3.0 merge containing this contract",
@@ -19,7 +19,7 @@ ai_provenance:
19
19
  # Buildchain v3 to v4 live capability inventory
20
20
 
21
21
  The machine-readable inventory in
22
- [`v3-v4-live-capability-inventory.json`](v3-v4-live-capability-inventory.json)
22
+ [`capability-parity-live-capability-inventory.json`](capability-parity-live-capability-inventory.json)
23
23
  binds the previous absorption-family v3 cut, the execution-time protected v3
24
24
  head, and the execution-time protected v4 head. It is an auditable cache of
25
25
  Git objects and generated registries, not an assertion that branch names remain
@@ -36,14 +36,14 @@ previous family capture. Each capability has exactly one disposition:
36
36
  Run the fail-closed check with:
37
37
 
38
38
  ```sh
39
- node scripts/check-v3-v4-capability-inventory.mjs
39
+ node scripts/check-capability-parity-inventory.mjs
40
40
  ```
41
41
 
42
42
  Refresh the checked-in matrix only after intentionally updating all three exact
43
43
  cuts and reviewing every newly discovered gap:
44
44
 
45
45
  ```sh
46
- node scripts/check-v3-v4-capability-inventory.mjs --write
46
+ node scripts/check-capability-parity-inventory.mjs --write
47
47
  ```
48
48
 
49
49
  The extractor rejects a new missing capability unless its exact stable identity
@@ -68690,7 +68690,7 @@
68690
68690
  "disposition": "v4-native",
68691
68691
  "id": "platform-branch:linux",
68692
68692
  "negativeProbe": "removing or substituting the declared v4 route fails validation",
68693
- "ownerAssignment": "2026-08-26-buildchain-v4-cross-platform-adopter-qualification",
68693
+ "ownerAssignment": "2026-08-26-buildchain-cross-platform-adopter-qualification",
68694
68694
  "positiveProbe": "the exact v4 cut contains the declared route evidence",
68695
68695
  "residual": null,
68696
68696
  "sourceEvidence": {
@@ -68712,7 +68712,7 @@
68712
68712
  "disposition": "v4-native",
68713
68713
  "id": "platform-branch:macos",
68714
68714
  "negativeProbe": "removing or substituting the declared v4 route fails validation",
68715
- "ownerAssignment": "2026-08-26-buildchain-v4-cross-platform-adopter-qualification",
68715
+ "ownerAssignment": "2026-08-26-buildchain-cross-platform-adopter-qualification",
68716
68716
  "positiveProbe": "the exact v4 cut contains the declared route evidence",
68717
68717
  "residual": null,
68718
68718
  "sourceEvidence": {
@@ -68734,7 +68734,7 @@
68734
68734
  "disposition": "v4-native",
68735
68735
  "id": "platform-branch:self-hosted",
68736
68736
  "negativeProbe": "removing or substituting the declared v4 route fails validation",
68737
- "ownerAssignment": "2026-08-26-buildchain-v4-cross-platform-adopter-qualification",
68737
+ "ownerAssignment": "2026-08-26-buildchain-cross-platform-adopter-qualification",
68738
68738
  "positiveProbe": "the exact v4 cut contains the declared route evidence",
68739
68739
  "residual": null,
68740
68740
  "sourceEvidence": {
@@ -68756,7 +68756,7 @@
68756
68756
  "disposition": "v4-native",
68757
68757
  "id": "platform-branch:windows",
68758
68758
  "negativeProbe": "removing or substituting the declared v4 route fails validation",
68759
- "ownerAssignment": "2026-08-26-buildchain-v4-cross-platform-adopter-qualification",
68759
+ "ownerAssignment": "2026-08-26-buildchain-cross-platform-adopter-qualification",
68760
68760
  "positiveProbe": "the exact v4 cut contains the declared route evidence",
68761
68761
  "residual": null,
68762
68762
  "sourceEvidence": {
@@ -3,7 +3,7 @@
3
3
  "contract": "kungfu-buildchain-v4-capability-state-machine-manifest",
4
4
  "releaseLine": {
5
5
  "branch": "dev/v4/v4.0",
6
- "bootstrapAuthority": "architecture/v4-bootstrap-authority.json",
6
+ "bootstrapAuthority": "architecture/bootstrap-authority.json",
7
7
  "productionAuthority": "v4-native",
8
8
  "productionFallback": null,
9
9
  "rollbackRef": "release/v3/v3.0",
@@ -549,5 +549,5 @@
549
549
  }
550
550
  }
551
551
  ],
552
- "exceptionLedger": "architecture/v4-exception-ledger.json"
552
+ "exceptionLedger": "architecture/exception-ledger.json"
553
553
  }
@@ -36,7 +36,7 @@
36
36
  "minItems": 1,
37
37
  "items": { "$ref": "#/$defs/stateMachine" }
38
38
  },
39
- "exceptionLedger": { "const": "architecture/v4-exception-ledger.json" }
39
+ "exceptionLedger": { "const": "architecture/exception-ledger.json" }
40
40
  },
41
41
  "$defs": {
42
42
  "stringArray": {
@@ -58,7 +58,7 @@
58
58
  "properties": {
59
59
  "branch": { "const": "dev/v4/v4.0" },
60
60
  "bootstrapAuthority": {
61
- "const": "architecture/v4-bootstrap-authority.json"
61
+ "const": "architecture/bootstrap-authority.json"
62
62
  },
63
63
  "productionAuthority": { "const": "v4-native" },
64
64
  "productionFallback": { "type": "null" },
@@ -608,6 +608,23 @@
608
608
  "expectedContributionSeconds": 180,
609
609
  "rationale": "Only successful same-repository version PRs regenerate from the protected base and read completed publication evidence; ordinary source PRs skip the lane. Native queue checks remain final merge authority."
610
610
  }
611
+ },
612
+ {
613
+ "laneId": ".github/workflows/public-release-oci-compose-preview.yml#promote",
614
+ "authorityClass": "release",
615
+ "triggerClass": "reusable",
616
+ "concurrencyPolicy": {
617
+ "mode": "serialized",
618
+ "cancelInProgress": false
619
+ },
620
+ "expectedRunnerMinutes": 8,
621
+ "cancellationBehavior": "finish-started",
622
+ "sloImpact": {
623
+ "mergeCritical": false,
624
+ "metric": "qualified Compose preview promotion",
625
+ "expectedContributionSeconds": 0,
626
+ "rationale": "Runs only after completed exact-source public installation qualification; no merge-critical runner lane is added."
627
+ }
611
628
  }
612
629
  ],
613
630
  "declarationFamilies": [
@@ -657,6 +674,7 @@
657
674
  ".github/workflows/patrol-monthly.yml#universal-bootstrap",
658
675
  ".github/workflows/patrol-observed-evidence.yml#universal-bootstrap",
659
676
  ".github/workflows/patrol-weekly.yml#universal-bootstrap",
677
+ ".github/workflows/public-release-oci-compose-preview.yml#universal-bootstrap",
660
678
  ".github/workflows/publication-artifact.yml#universal-bootstrap",
661
679
  ".github/workflows/release-candidate-promote.yml#universal-bootstrap",
662
680
  ".github/workflows/release-propagation.yml#universal-bootstrap",
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "contract": "kungfu-buildchain-v4-cross-platform-adopter-qualification",
4
- "inventoryAuthority": "architecture/v3-v4-live-capability-inventory.json",
5
- "implementation": "packages/core/v4-cross-platform-adopter-qualification.js",
6
- "runner": "scripts/v4-cross-platform-adopter-qualification.mjs",
4
+ "inventoryAuthority": "architecture/capability-parity-live-capability-inventory.json",
5
+ "implementation": "packages/core/cross-platform-adopter-qualification.js",
6
+ "runner": "scripts/cross-platform-adopter-qualification.mjs",
7
7
  "publicWorkflow": ".github/workflows/public-build-adopter-qualification.yml",
8
8
  "sourceBinding": {
9
9
  "runtime": "job.workflow_sha",
@@ -31,7 +31,7 @@
31
31
  "tests/dev-delivery-two-phase.test.mjs",
32
32
  "tests/dev-delivery-two-phase-run.test.mjs"
33
33
  ],
34
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-01"
34
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-01"
35
35
  },
36
36
  {
37
37
  "id": "DA-02",
@@ -45,7 +45,7 @@
45
45
  "tests/dev-delivery-two-phase.test.mjs",
46
46
  "tests/dev-delivery-native-run.test.mjs"
47
47
  ],
48
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-02"
48
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-02"
49
49
  },
50
50
  {
51
51
  "id": "DA-03",
@@ -70,7 +70,7 @@
70
70
  "tests/dev-delivery-provider-heartbeat.test.mjs",
71
71
  "tests/build-surface.test.mjs"
72
72
  ],
73
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-03"
73
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-03"
74
74
  },
75
75
  {
76
76
  "id": "DA-04",
@@ -84,7 +84,7 @@
84
84
  "tests/dev-delivery-two-phase.test.mjs",
85
85
  "tests/dev-delivery-two-phase-run.test.mjs"
86
86
  ],
87
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-04"
87
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-04"
88
88
  },
89
89
  {
90
90
  "id": "DA-05",
@@ -95,7 +95,7 @@
95
95
  "packages/core/dev-delivery-warrant.js"
96
96
  ],
97
97
  "verificationEvidence": ["tests/dev-delivery-two-phase.test.mjs"],
98
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-05"
98
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-05"
99
99
  },
100
100
  {
101
101
  "id": "DA-06",
@@ -109,7 +109,7 @@
109
109
  "tests/dev-delivery-warrant.test.mjs",
110
110
  "tests/dev-delivery-two-phase.test.mjs"
111
111
  ],
112
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-06"
112
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-06"
113
113
  },
114
114
  {
115
115
  "id": "DA-07",
@@ -124,7 +124,7 @@
124
124
  "tests/dev-delivery-warrant.test.mjs",
125
125
  "tests/dev-pr-auto-merge.test.mjs"
126
126
  ],
127
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-07"
127
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-07"
128
128
  },
129
129
  {
130
130
  "id": "DA-08",
@@ -135,7 +135,7 @@
135
135
  "packages/core/dev-delivery-authority-state.js"
136
136
  ],
137
137
  "verificationEvidence": ["tests/dev-delivery-authority.test.mjs"],
138
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-08"
138
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-08"
139
139
  },
140
140
  {
141
141
  "id": "DA-09",
@@ -148,7 +148,7 @@
148
148
  "contracts/dev-delivery-authority-v2.schema.json"
149
149
  ],
150
150
  "verificationEvidence": ["tests/dev-delivery-authority.test.mjs"],
151
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-09"
151
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-09"
152
152
  },
153
153
  {
154
154
  "id": "DA-10",
@@ -159,7 +159,7 @@
159
159
  "packages/core/dev-delivery-authority-landing.js"
160
160
  ],
161
161
  "verificationEvidence": ["tests/dev-delivery-authority.test.mjs"],
162
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-10"
162
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-10"
163
163
  },
164
164
  {
165
165
  "id": "DA-11",
@@ -172,7 +172,7 @@
172
172
  "packages/core/dev-delivery-landing-readback.js"
173
173
  ],
174
174
  "verificationEvidence": ["tests/dev-delivery-authority.test.mjs"],
175
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-11"
175
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-11"
176
176
  },
177
177
  {
178
178
  "id": "DA-12",
@@ -186,7 +186,7 @@
186
186
  "tests/dev-delivery-authority.test.mjs",
187
187
  "tests/dev-delivery-warrant-command.test.mjs"
188
188
  ],
189
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-12"
189
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-12"
190
190
  },
191
191
  {
192
192
  "id": "DA-13",
@@ -197,7 +197,7 @@
197
197
  "scripts/dev-delivery-authority.mjs"
198
198
  ],
199
199
  "verificationEvidence": ["tests/dev-delivery-authority.test.mjs"],
200
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-13"
200
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-13"
201
201
  },
202
202
  {
203
203
  "id": "DA-14",
@@ -212,7 +212,7 @@
212
212
  "tests/dev-delivery-authority.test.mjs",
213
213
  "tests/dev-delivery-two-phase.test.mjs"
214
214
  ],
215
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-14"
215
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-14"
216
216
  },
217
217
  {
218
218
  "id": "DA-15",
@@ -236,7 +236,7 @@
236
236
  "tests/dev-pr-auto-merge.test.mjs",
237
237
  "tests/build-surface.test.mjs"
238
238
  ],
239
- "behavioralProof": "tests/v4-delivery-authority-parity.test.mjs#DA-15"
239
+ "behavioralProof": "tests/delivery-authority-parity.test.mjs#DA-15"
240
240
  },
241
241
  {
242
242
  "id": "DA-16",
@@ -246,5 +246,5 @@
246
246
  "verificationEvidence": []
247
247
  }
248
248
  ],
249
- "matrixRoot": "sha256:85fc624f09abb2014601a9857dbcd07a59750b6dd6d77ab240ed037d3169ac69"
249
+ "matrixRoot": "sha256:7cda843562e9cc3d9de0434bab8b3570c1ed793b6c91eaf7aa675bbcdcc60715"
250
250
  }
@@ -4,8 +4,8 @@
4
4
  "releaseLine": "dev/v4/v4.0",
5
5
  "sourceCut": {
6
6
  "revision": "3fd14c7a6237c3a1709ce29fc9fcb4ac150a0e5d",
7
- "inventory": "architecture/v3-core-mechanism-inventory.json",
8
- "manifest": "architecture/v4-capability-state-machine-manifest.json",
7
+ "inventory": "architecture/baseline-core-mechanism-inventory.json",
8
+ "manifest": "architecture/capability-state-machine-manifest.json",
9
9
  "legacyCore": "packages/core/dev-delivery-warrant.js",
10
10
  "legacyStore": "scripts/dev-delivery-warrant.mjs",
11
11
  "legacyWorkflows": [
@@ -361,7 +361,7 @@
361
361
  }
362
362
  ],
363
363
  "shadow": {
364
- "fixtureContract": "architecture/v4-delivery-warrant-shadow-fixtures.json",
364
+ "fixtureContract": "architecture/delivery-warrant-shadow-fixtures.json",
365
365
  "inputs": "the same canonical fixture bytes are passed to JavaScript v3 and Rust v4",
366
366
  "comparison": [
367
367
  "decision kind and typed error",
@@ -21,9 +21,9 @@ ai_provenance:
21
21
  This plan makes the current Delivery Warrant behavior implementable as a
22
22
  provider-free Rust domain without changing production authority. The normative
23
23
  machine-readable plan is
24
- [`v4-delivery-warrant-shadow-bootstrap-plan.json`](./v4-delivery-warrant-shadow-bootstrap-plan.json).
24
+ [`delivery-warrant-shadow-bootstrap-plan.json`](./delivery-warrant-shadow-bootstrap-plan.json).
25
25
  The shared traces and frozen JavaScript projection roots are in
26
- [`v4-delivery-warrant-shadow-fixtures.json`](./v4-delivery-warrant-shadow-fixtures.json).
26
+ [`delivery-warrant-shadow-fixtures.json`](./delivery-warrant-shadow-fixtures.json).
27
27
 
28
28
  ## Decision
29
29
 
@@ -51,12 +51,12 @@ inventory rather than reconstructing it from workflow prose.
51
51
 
52
52
  | Concern | Source of record | Result |
53
53
  | ------------------------------------------------ | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
54
- | Current states, events, writers, stores, effects | `v3-core-mechanism-inventory.json` and `v4-capability-state-machine-manifest.json` | Nine states, seven manifest events, TypeScript v3 sole writer |
54
+ | Current states, events, writers, stores, effects | `baseline-core-mechanism-inventory.json` and `capability-state-machine-manifest.json` | Nine states, seven manifest events, TypeScript v3 sole writer |
55
55
  | Queue roots, generation, selection, leases | `packages/core/dev-delivery-warrant.js` | Rooted successors, bounded FIFO/aging, one active fence |
56
56
  | Terminal behavior | settlement and cancellation modules plus Warrant tests | Active fenced close, exact queued cancellation, terminal/no-authority no-ops |
57
57
  | Durable compare-and-set | `scripts/dev-delivery-warrant.mjs` | Immutable Git commit plus expected commit/root readback |
58
58
  | Protected effects | Buildchain dev delivery, close, and cancel workflows | GitHub admission occurs after exact state readback |
59
- | Bootstrap and N-1 | `v4-bootstrap-authority.json` and `v4-architecture.mjs` | v3 bootstrap authority, protected v4 handoff, no self-qualification |
59
+ | Bootstrap and N-1 | `bootstrap-authority.json` and `architecture.mjs` | v3 bootstrap authority, protected v4 handoff, no self-qualification |
60
60
 
61
61
  Public state-ref observations at the source audit showed an idle v4 queue at
62
62
  generation 9/fencing counter 3 and an idle v3 queue at generation 103/fencing
@@ -213,9 +213,9 @@ removal remain explicit future gates.
213
213
  Run the focused contract and fixture checks with:
214
214
 
215
215
  ```sh
216
- node scripts/v4-warrant-shadow-plan.mjs validate
217
- node --test tests/v4-warrant-shadow-plan.test.mjs
218
- node scripts/v4-architecture.mjs validate
216
+ node scripts/warrant-shadow-plan.mjs validate
217
+ node --test tests/warrant-shadow-plan.test.mjs
218
+ node scripts/architecture.mjs validate
219
219
  ```
220
220
 
221
221
  The repository `check` command runs the plan validator and the unit suite. A
@@ -27,6 +27,6 @@ requires that certification to match the caller source and actual runtime.
27
27
  Missing, rejected, stale, root-mismatched, or old-runtime evidence fails closed.
28
28
 
29
29
  The normative machine declaration is
30
- [`v4-floating-consumer-policy.json`](v4-floating-consumer-policy.json). v3
30
+ [`floating-consumer-policy.json`](floating-consumer-policy.json). v3
31
31
  behavior, provider effects, credentials, and production mutation authority are
32
32
  outside this decision.