@kungfu-tech/buildchain 4.0.2-alpha.9 → 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.
- package/AGENTS.md +14 -5
- package/CONTRIBUTING.md +58 -0
- package/README.md +3 -3
- package/actions/promote-buildchain-ref/README.md +1 -1
- package/actions/release-candidate-promote/README.md +31 -0
- package/architecture/agent-change-map.md +190 -126
- package/architecture/{v4-architecture-constitution.md → architecture-constitution.md} +33 -30
- package/architecture/{v3-core-mechanism-inventory.md → baseline-core-mechanism-inventory.md} +1 -1
- package/architecture/{v4-bootstrap-authority.json → bootstrap-authority.json} +3 -3
- package/architecture/{v3-v4-capability-closure.md → capability-parity-closure.md} +3 -3
- package/architecture/{v3-v4-live-capability-inventory.json → capability-parity-live-capability-inventory.json} +4 -4
- package/architecture/{v4-capability-state-machine-manifest.json → capability-state-machine-manifest.json} +2 -2
- package/architecture/{v4-capability-state-machine-manifest.schema.json → capability-state-machine-manifest.schema.json} +2 -2
- package/architecture/ci-lane-change-budget.json +384 -0
- package/architecture/{v4-cross-platform-adopter-qualification.json → cross-platform-adopter-qualification.json} +4 -4
- package/architecture/{v4-delivery-authority-parity.json → delivery-authority-parity.json} +17 -17
- package/architecture/{v4-delivery-warrant-shadow-bootstrap-plan.json → delivery-warrant-shadow-bootstrap-plan.json} +4 -4
- package/architecture/{v4-delivery-warrant-shadow-bootstrap-plan.md → delivery-warrant-shadow-bootstrap-plan.md} +7 -7
- package/architecture/{v4-floating-consumer-policy.json → floating-consumer-policy.json} +2 -2
- package/architecture/{v4-floating-consumer-policy.md → floating-consumer-policy.md} +1 -1
- package/architecture/implementation-naming.json +1273 -0
- package/architecture/internal-capabilities.json +201 -154
- package/architecture/maintainability-debt.json +205 -146
- package/architecture/maintainability-policy.json +37 -33
- package/architecture/{v4-next-development-parity.json → next-development-parity.json} +12 -12
- package/architecture/{v4-partial-mutation-recovery-qualification.json → partial-mutation-recovery-qualification.json} +8 -5
- package/architecture/{v4-platform-stage-checkpoints.json → platform-stage-checkpoints.json} +3 -3
- package/architecture/{v4-provider-operation-journal-contract.json → provider-operation-journal-contract.json} +10 -7
- package/architecture/publication-facade-patches.json +64 -0
- package/architecture/{v4-publication-rehearsal-parity.json → publication-rehearsal-parity.json} +4 -4
- package/architecture/{v4-release-activation-shadow-domain.json → release-activation-shadow-domain.json} +9 -6
- package/architecture/release-tail-contract-inventory.json +6 -6
- package/architecture/{v4-release-topology.json → release-topology.json} +163 -72
- package/architecture/{v4-release-train-parity.json → release-train-parity.json} +2 -2
- package/architecture/{v4-runtime-ref-resume-authority.json → runtime-ref-resume-authority.json} +1 -1
- package/architecture/{v4-runtime-semantic-closure.json → runtime-semantic-closure.json} +2 -2
- package/architecture/{v4-rust-libnode-bridge-evaluation.json → rust-libnode-bridge-evaluation.json} +3 -3
- package/architecture/{v4-rust-libnode-bridge-spike.md → rust-libnode-bridge-spike.md} +6 -6
- package/architecture/rust-wasm-production-authority.json +58 -0
- package/architecture/{v4-stable-publication-fence.json → stable-publication-fence.json} +7 -4
- package/architecture/{v4-stage-capsule-contract.json → stage-capsule-contract.json} +1 -1
- package/architecture/{v4-stage-capsule-qualification.json → stage-capsule-qualification.json} +8 -8
- package/architecture/{v4-stage-capsule-resume-planner.json → stage-capsule-resume-planner.json} +2 -2
- package/architecture/{v4-stage-capsule-store-contract.json → stage-capsule-store-contract.json} +4 -4
- package/architecture/{v4-tail-reseal-parity.json → tail-reseal-parity.json} +35 -33
- package/architecture/universal-workflow-bootstrap.json +176 -0
- package/architecture/universal-workflow-fault-campaign.json +72 -0
- package/architecture/universal-workflow-train-admission.json +40 -0
- package/architecture/workflow-taxonomy.json +1462 -0
- package/bin/buildchain.mjs +10 -10
- package/bin/internal/adopter-delivery-cli.mjs +9 -9
- package/contracts/buildchain-v2-residuals-v1.json +57 -48
- package/contracts/dev-delivery-authority-v2.schema.json +16 -2
- package/contracts/fixtures/v4-tail-reseal-v1/valid.json +1 -1
- package/contracts/v4-canonical-contracts-v1.schema.json +1 -0
- package/crates/{buildchain-v4-bridge → buildchain-host-bridge}/Cargo.lock +1 -1
- package/crates/{buildchain-v4-bridge → buildchain-host-bridge}/Cargo.toml +1 -1
- package/crates/{buildchain-v4-bridge → buildchain-host-bridge}/src/main.rs +3 -3
- package/dist/site/buildchain-contract.json +98 -53
- package/dist/site/buildchain-site.json +351 -102
- package/dist/site/capability-registry.json +7 -7
- package/dist/site/controller-registry.json +50 -13
- package/dist/site/kfd-claims.json +2773 -1052
- package/dist/site/kfd-upstream-aggregate.json +1 -1
- package/dist/site/manual-registry.json +14 -14
- package/dist/site/node-api-registry.json +13176 -10733
- package/dist/site/page-registry.json +332 -83
- package/dist/site/public-surface-audit.json +3227 -1222
- package/dist/site/publication-authority-registry.json +1135 -363
- package/dist/site/publication-registry.json +4 -4
- package/dist/site/release-provenance.json +18 -9
- package/dist/site/schemas/dev-delivery-authority-v2.schema.json +16 -2
- package/dist/site/site-manifest.json +18 -18
- package/dist/site/workflow-registry.json +5367 -1931
- package/docs/MAP.md +5 -3
- package/docs/auditable-demo.md +1 -1
- package/docs/cli.md +21 -8
- package/docs/dev-delivery-warrant.md +1 -1
- package/docs/engineering-housekeeper.md +3 -3
- package/docs/kfd-support.md +26 -2
- package/docs/next-development-transition.md +26 -3
- package/docs/node-api-reference.md +618 -358
- package/docs/oci-publication.md +173 -0
- package/docs/publication-authority.md +2 -2
- package/docs/publish-transaction.md +36 -3
- package/docs/release-candidate.md +3 -3
- package/docs/release-flow.md +67 -19
- package/docs/release-governance.md +8 -8
- package/docs/release-passport.md +27 -2
- package/docs/reusable-build-surface.md +17 -1
- package/docs/v4-adopter-delivery.md +4 -4
- package/docs/v4-canonical-contracts.md +7 -7
- package/docs/v4-delivery-warrant-read-candidate.md +3 -3
- package/docs/v4-delivery-warrant-semantic-diff.md +3 -3
- package/docs/v4-production-release.md +77 -8
- package/docs/v4-publication-rehearsal.md +3 -3
- package/docs/v4-runtime-ref-resume-authority.md +2 -2
- package/docs/v4-rust-wasm-production-authority.md +58 -0
- package/docs/v4-stage-capsule.md +9 -9
- package/docs/v4-tail-reseal.md +2 -2
- package/docs/workflow-catalog.md +155 -0
- package/docs/workflow-path-migration.md +109 -0
- package/package.json +39 -24
- package/packages/compatibility/adopter-delivery.js +16 -0
- package/packages/compatibility/cross-platform-adopter-qualification.js +12 -0
- package/packages/compatibility/floating-consumer-policy.js +14 -0
- package/packages/compatibility/publication-qualification.js +11 -0
- package/packages/compatibility/publication-rehearsal.js +18 -0
- package/packages/compatibility/runtime-ref-resume-authority.js +13 -0
- package/packages/compatibility/tail-reseal-receipt.js +7 -0
- package/packages/compatibility/tail-reseal.js +11 -0
- package/packages/core/{v4-adopter-delivery-parity.js → adopter-delivery-parity.js} +12 -12
- package/packages/core/{v4-adopter-delivery.js → adopter-delivery.js} +24 -24
- package/packages/core/artifact-verification-envelope.js +5 -5
- package/packages/core/buildchain-contract.js +6 -6
- package/packages/core/buildchain-domain.wasm +0 -0
- package/packages/core/buildchain-kfd-claims.js +2 -2
- package/packages/core/buildchain-publication-authority.js +43 -26
- package/packages/core/{v4-canonical-contracts.js → canonical-contracts.js} +39 -103
- package/packages/core/ci-lane-change-budget.js +14 -1
- package/packages/core/controller-evidence.js +4 -1
- package/packages/core/{v4-cross-platform-adopter-qualification.js → cross-platform-adopter-qualification.js} +19 -19
- package/packages/core/{v4-delivery-warrant-fixture-runner.js → delivery-warrant-fixture-runner.js} +36 -32
- package/packages/core/{v4-delivery-warrant-read-candidate.js → delivery-warrant-read-candidate.js} +40 -40
- package/packages/core/{v4-delivery-warrant-semantic-diff-gate.js → delivery-warrant-semantic-diff-gate.js} +58 -59
- package/packages/core/{v4-delivery-warrant-shadow-adapter.js → delivery-warrant-shadow-adapter.js} +15 -15
- package/packages/core/dev-delivery-candidate-identity.js +40 -6
- package/packages/core/dev-delivery-execution-transfer.js +6 -6
- package/packages/core/dev-delivery-native-proof.js +12 -8
- package/packages/core/dev-delivery-warrant-legacy-recovery.js +1 -1
- package/packages/core/dev-delivery-warrant-native-compatibility.js +4 -4
- package/packages/core/dev-delivery-warrant-state.js +14 -15
- package/packages/core/dev-delivery-warrant.js +15 -5
- package/packages/core/domain-wasm-artifact.js +7 -0
- package/packages/core/domain-wasm.js +216 -0
- package/packages/core/{v4-floating-consumer-evidence.js → floating-consumer-evidence.js} +14 -14
- package/packages/core/{v4-floating-consumer-policy.js → floating-consumer-policy.js} +28 -30
- package/packages/core/{v4-floating-consumer-release-passport.js → floating-consumer-release-passport.js} +25 -25
- package/packages/core/github-governance-authority.js +4 -4
- package/packages/core/index.js +4 -8
- package/packages/core/kfd-adopter-manifest.js +46 -47
- package/packages/core/next-development-projection.js +26 -3
- package/packages/core/next-development-transition.js +5 -6
- package/packages/core/oci-compose-qualification.js +143 -0
- package/packages/core/oci-publication-bundle.js +281 -0
- package/packages/core/oci-publication-graph.js +206 -0
- package/packages/core/paper-agent-entry.js +30 -4
- package/packages/core/paper-fleet.js +1 -1
- package/packages/core/paper-runtime-channels.js +348 -0
- package/packages/core/paper-scaffold-content.js +10 -0
- package/packages/core/paper.js +37 -71
- package/packages/core/partial-mutation-recovery-qualification.js +18 -0
- package/packages/core/{v4-platform-stage-checkpoints.js → platform-stage-checkpoints.js} +37 -37
- package/packages/core/product-publication.js +59 -0
- package/packages/core/{v4-protected-publication-source.js → protected-publication-source.js} +22 -24
- package/packages/core/provider-operation-journal.js +62 -0
- package/packages/core/{v4-provider-readback-idempotency.js → provider-readback-idempotency.js} +40 -125
- package/packages/core/public-export-compatibility.js +33 -0
- package/packages/core/publication-development.js +72 -0
- package/packages/core/{v4-publication-qualification.js → publication-qualification.js} +17 -17
- package/packages/core/{v4-publication-rehearsal-capsule.js → publication-rehearsal-capsule.js} +23 -23
- package/packages/core/publication-rehearsal-projection.js +2 -2
- package/packages/core/{v4-publication-rehearsal-provider-bindings.js → publication-rehearsal-provider-bindings.js} +4 -4
- package/packages/core/publication-rehearsal-runtime.js +21 -21
- package/packages/core/{v4-publication-rehearsal.js → publication-rehearsal.js} +33 -33
- package/packages/core/publication-sealed-bundle.js +78 -13
- package/packages/core/release-activation-shadow.js +32 -0
- package/packages/core/release-candidate.js +6 -6
- package/packages/core/release-invocation.js +64 -0
- package/packages/core/release-line-dry-run.js +1 -1
- package/packages/core/release-passport-contract.js +5 -5
- package/packages/core/release-passport.js +41 -40
- package/packages/core/release-tail-product-capabilities.js +9 -0
- package/packages/core/release-tail-provider-plane.js +68 -1048
- package/packages/core/{v4-runtime-ref-resume-authority.js → runtime-ref-resume-authority.js} +36 -40
- package/packages/core/{v4-runtime-selector-persistence.js → runtime-selector-persistence.js} +7 -7
- package/packages/core/stable-publication-fence.js +28 -0
- package/packages/core/{v4-stage-capsule-local-store.js → stage-capsule-local-store.js} +56 -54
- package/packages/core/{v4-stage-capsule-qualification-campaign.js → stage-capsule-qualification-campaign.js} +37 -38
- package/packages/core/{v4-stage-capsule-qualification.js → stage-capsule-qualification.js} +28 -29
- package/packages/core/{v4-stage-capsule-resume-planner.js → stage-capsule-resume-planner.js} +29 -29
- package/packages/core/{v4-stage-capsule-store.js → stage-capsule-store.js} +59 -56
- package/packages/core/{v4-stage-capsule.js → stage-capsule.js} +45 -45
- package/packages/core/{v4-tail-reseal-contract.js → tail-reseal-contract.js} +6 -6
- package/packages/core/{v4-tail-reseal-github.js → tail-reseal-github.js} +12 -12
- package/packages/core/{v4-tail-reseal-receipt.js → tail-reseal-receipt.js} +22 -22
- package/packages/core/{v4-tail-reseal.js → tail-reseal.js} +29 -29
- package/packages/core/universal-workflow-bootstrap.js +586 -0
- package/scripts/{v4-architecture.mjs → architecture.mjs} +6 -6
- package/scripts/binary-publication-evidence.mjs +135 -0
- package/scripts/{v4-bridge-bootstrap.mjs → bridge-bootstrap.mjs} +14 -18
- package/scripts/{v4-bridge-evidence.mjs → bridge-evidence.mjs} +8 -8
- package/scripts/build-contract-core.mjs +1 -14
- package/scripts/build-domain-wasm.mjs +177 -0
- package/scripts/{v3-v4-capability-catalog.mjs → capability-parity-catalog.mjs} +19 -19
- package/scripts/check-action-bundles.mjs +12 -2
- package/scripts/{check-v3-v4-capability-inventory.mjs → check-capability-parity-inventory.mjs} +42 -42
- package/scripts/check-ci-lane-change-budget.mjs +4 -1
- package/scripts/check-core-mechanism-inventory.mjs +8 -4
- package/scripts/{check-v4-floating-consumer-policy-contract.mjs → check-floating-consumer-policy-contract.mjs} +10 -10
- package/scripts/check-implementation-naming.mjs +135 -0
- package/scripts/check-inventory.mjs +39 -47
- package/scripts/check-maintainability.mjs +25 -115
- package/scripts/{check-v4-public-dogfood-contract.mjs → check-public-dogfood-contract.mjs} +37 -24
- package/scripts/{check-v4-release-topology.mjs → check-release-topology.mjs} +131 -52
- package/scripts/{check-v4-runtime-semantic-closure.mjs → check-runtime-semantic-closure.mjs} +23 -17
- package/scripts/check-universal-workflow-bootstrap.mjs +266 -0
- package/scripts/check-workflow-taxonomy.mjs +6 -0
- package/scripts/{v4-consumer-policy.mjs → consumer-policy.mjs} +15 -15
- package/scripts/copy-domain-wasm.mjs +14 -0
- package/scripts/{v4-cross-platform-adopter-qualification.mjs → cross-platform-adopter-qualification.mjs} +9 -9
- package/scripts/{v4-declarative-promotion-admission.mjs → declarative-promotion-admission.mjs} +4 -4
- package/scripts/dev-delivery-authority-command-adapters.mjs +1 -1
- package/scripts/dev-delivery-authority.mjs +8 -8
- package/scripts/dev-delivery-source-proof-reuse.mjs +2 -1
- package/scripts/dev-delivery-warrant-options.mjs +15 -10
- package/scripts/dev-delivery-warrant-store.mjs +98 -13
- package/scripts/dev-delivery-warrant-transition.mjs +109 -0
- package/scripts/dev-delivery-warrant.mjs +80 -103
- package/scripts/dev-pr-auto-merge.mjs +15 -15
- package/scripts/dev-pr-delivery-warrant.mjs +1 -1
- package/scripts/generate-channel-build-workflow.mjs +7 -2
- package/scripts/generate-channel-promotion-workflow.mjs +19 -34
- package/scripts/generate-release-candidate-passport.mjs +23 -23
- package/scripts/generate-site-bundle.mjs +28 -28
- package/scripts/generate-universal-workflow-facades.mjs +498 -0
- package/scripts/generate-workflow-taxonomy.mjs +25 -0
- package/scripts/github-output.mjs +31 -0
- package/scripts/{v4-host-adapter.mjs → host-adapter.mjs} +1 -1
- package/scripts/implementation-references.mjs +25 -0
- package/scripts/init-repo.mjs +1 -1
- package/scripts/maintainability-metrics.mjs +16 -5
- package/scripts/maintainability-public-surface.mjs +115 -0
- package/scripts/next-development-review.mjs +313 -0
- package/scripts/oci-compose-preview.mjs +261 -0
- package/scripts/paper-work-fleet-cli.mjs +2 -0
- package/scripts/{v4-platform-stage-checkpoint-rehearsal.mjs → platform-stage-checkpoint-rehearsal.mjs} +17 -17
- package/scripts/{v4-product-publication-intent.mjs → product-publication-intent.mjs} +28 -13
- package/scripts/publication-candidate-kind.mjs +93 -0
- package/scripts/publication-candidate-sealer.mjs +16 -1
- package/scripts/{v4-publication-rehearsal-fixture.mjs → publication-rehearsal-fixture.mjs} +5 -5
- package/scripts/publication-settlement.mjs +211 -0
- package/scripts/release-asset-client.mjs +91 -0
- package/scripts/{v4-release-candidate-adapter.mjs → release-candidate-adapter.mjs} +4 -4
- package/scripts/release-candidate-resolver.mjs +24 -35
- package/scripts/release-tail.mjs +5 -5
- package/scripts/resume-from-candidate-run.mjs +35 -42
- package/scripts/site-capability-metadata.mjs +9 -0
- package/scripts/source-verification-evidence.mjs +344 -0
- package/scripts/stable-candidate-qualification.mjs +1 -1
- package/scripts/{v4-stage-capsule-qualification.mjs → stage-capsule-qualification.mjs} +62 -62
- package/scripts/{v4-stage-capsule-resume-rehearsal.mjs → stage-capsule-resume-rehearsal.mjs} +6 -6
- package/scripts/{v4-tail-reseal-macos-rehearsal.mjs → tail-reseal-macos-rehearsal.mjs} +9 -9
- package/scripts/{v4-tail-reseal.mjs → tail-reseal.mjs} +19 -19
- package/scripts/universal-facade-maintainability.mjs +91 -0
- package/scripts/universal-workflow-backflow.mjs +212 -0
- package/scripts/universal-workflow-engine.mjs +620 -0
- package/scripts/universal-workflow-self-dogfood.mjs +205 -0
- package/scripts/verify-version-state-delta.mjs +175 -0
- package/scripts/{v4-warrant-shadow-plan.mjs → warrant-shadow-plan.mjs} +6 -6
- package/scripts/workflow-taxonomy.mjs +507 -0
- package/templates/native-dev-delivery.yml +4 -7
- package/templates/universal-buildchain-bootstrap-recovery.yml +282 -0
- package/templates/universal-buildchain-bootstrap.yml +28 -0
- package/actions/v4-release-candidate-promote/README.md +0 -3
- package/packages/core/v4-partial-mutation-recovery-qualification.js +0 -395
- package/packages/core/v4-product-publication.js +0 -387
- package/packages/core/v4-provider-operation-journal.js +0 -531
- package/packages/core/v4-release-activation-shadow.js +0 -519
- package/packages/core/v4-release-invocation.js +0 -425
- package/packages/core/v4-stable-publication-fence.js +0 -357
- /package/architecture/{v4-adopter-delivery-parity.json → adopter-delivery-parity.json} +0 -0
- /package/architecture/{v3-core-mechanism-inventory.json → baseline-core-mechanism-inventory.json} +0 -0
- /package/architecture/{v4-canonical-contract-fixtures.json → canonical-contract-fixtures.json} +0 -0
- /package/architecture/{v4-compatibility-facts-parity.json → compatibility-facts-parity.json} +0 -0
- /package/architecture/{v4-delivery-warrant-shadow-bootstrap-plan.schema.json → delivery-warrant-shadow-bootstrap-plan.schema.json} +0 -0
- /package/architecture/{v4-delivery-warrant-shadow-fixtures.json → delivery-warrant-shadow-fixtures.json} +0 -0
- /package/architecture/{v4-delivery-warrant-shadow-fixtures.schema.json → delivery-warrant-shadow-fixtures.schema.json} +0 -0
- /package/architecture/{v4-exception-ledger.json → exception-ledger.json} +0 -0
- /package/architecture/{v4-exception-ledger.schema.json → exception-ledger.schema.json} +0 -0
- /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 [`
|
|
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
|
-
[`
|
|
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.
|
|
@@ -43,8 +43,8 @@ ledger.
|
|
|
43
43
|
Dependencies point inward only:
|
|
44
44
|
|
|
45
45
|
```text
|
|
46
|
-
workflows ->
|
|
47
|
-
legacy compatibility ->
|
|
46
|
+
workflows -> Node provider/IO adapters -> tracked Rust/WASM domain -> contracts
|
|
47
|
+
legacy compatibility -> Node facades / contracts
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
Contracts contain serialization and compatibility facts, not provider SDK
|
|
@@ -55,12 +55,12 @@ or Rust domain are hard-zero violations. Cycles are forbidden.
|
|
|
55
55
|
## 3. Single-writer rule
|
|
56
56
|
|
|
57
57
|
Every state machine has exactly one authoritative writer. The v4 cutover marks
|
|
58
|
-
the
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
write, cross-machine mutable file, or implicit
|
|
63
|
-
hard-zero budget.
|
|
58
|
+
the Rust/WASM domain authoritative and the legacy v3 and duplicate TypeScript
|
|
59
|
+
semantic writers retired. Node owns provider and IO effects and exposes
|
|
60
|
+
compatibility facades, but every deterministic release plan, fold, root, retry,
|
|
61
|
+
and receipt decision crosses the checked WASM ABI. A second writer, permanent
|
|
62
|
+
dual write, semantic fallback, cross-machine mutable file, or implicit
|
|
63
|
+
compatibility authority has a hard-zero budget.
|
|
64
64
|
|
|
65
65
|
## 4. Explicit complexity budgets
|
|
66
66
|
|
|
@@ -85,15 +85,19 @@ second hand-maintained architecture list is authoritative.
|
|
|
85
85
|
## 6. Production cutover boundary
|
|
86
86
|
|
|
87
87
|
The v4 line owns Delivery Warrant, Release Transaction, activation,
|
|
88
|
-
publication, propagation, and release-tail state.
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
88
|
+
publication, propagation, and release-tail state. Its production domain is the
|
|
89
|
+
tracked artifact governed by
|
|
90
|
+
[`rust-wasm-production-authority.json`](rust-wasm-production-authority.json):
|
|
91
|
+
Node verifies the artifact digest and ABI before use and fails closed without a
|
|
92
|
+
JavaScript semantic fallback. This does not introduce a daemon, a service
|
|
93
|
+
database, provider SDKs in contracts or Rust domain code, or a second writer.
|
|
94
|
+
The retained `release/v3/v3.0` coordinate is rollback evidence only and cannot
|
|
95
|
+
regain production authority without a new reviewed cutover.
|
|
92
96
|
|
|
93
97
|
## 7. Wave 0 host boundary
|
|
94
98
|
|
|
95
99
|
The bounded Rust/libnode bridge spike is recorded in
|
|
96
|
-
[`
|
|
100
|
+
[`rust-libnode-bridge-spike.md`](rust-libnode-bridge-spike.md). Wave 0
|
|
97
101
|
uses a replaceable subprocess host behind a closed byte-oriented contract; the
|
|
98
102
|
Rust trunk owns process lifecycle and transport, while existing TypeScript
|
|
99
103
|
remains the only production writer. This selection is evidence for later
|
|
@@ -102,7 +106,7 @@ qualification, not a final ABI or consumer migration.
|
|
|
102
106
|
## 8. Wave 2 Stage Capsule contract
|
|
103
107
|
|
|
104
108
|
The executable Stage Capsule architecture contract is
|
|
105
|
-
[`
|
|
109
|
+
[`stage-capsule-contract.json`](stage-capsule-contract.json). It fixes one
|
|
106
110
|
schema authority, one TypeScript v3 writer, validation-only Rust, and zero
|
|
107
111
|
provider imports or production write-authority changes. Identity, retention
|
|
108
112
|
promise, current availability, qualification, content roots, and rooted
|
|
@@ -111,7 +115,7 @@ reconciliation work must consume this contract rather than create competing
|
|
|
111
115
|
identity or writer authority.
|
|
112
116
|
|
|
113
117
|
The successor storage slice is governed by
|
|
114
|
-
[`
|
|
118
|
+
[`stage-capsule-store-contract.json`](stage-capsule-store-contract.json).
|
|
115
119
|
It adds provider-neutral output-manifest, retention-state, transport, and store
|
|
116
120
|
receipt roots plus a deterministic no-network local filesystem reference
|
|
117
121
|
store. GitHub Artifact and S3-compatible adapters remain effect-disabled or
|
|
@@ -120,7 +124,7 @@ and qualification evidence stay separate facts; none becomes Capsule identity,
|
|
|
120
124
|
qualification authority, or a production writer.
|
|
121
125
|
|
|
122
126
|
Final Wave 2 qualification is governed by
|
|
123
|
-
[`
|
|
127
|
+
[`stage-capsule-qualification.json`](stage-capsule-qualification.json).
|
|
124
128
|
It consumes the existing Capsule, store, checkpoint, and resume authorities for
|
|
125
129
|
six real-runner shadow campaigns and one exact terminal reconciliation. A
|
|
126
130
|
qualification root is evidence only: TypeScript v3 remains production
|
|
@@ -130,12 +134,11 @@ effects, release effects, and public cutover remain outside this transition.
|
|
|
130
134
|
## 9. Wave 3 provider operation journal
|
|
131
135
|
|
|
132
136
|
The executable provider operation journal contract is
|
|
133
|
-
[`
|
|
137
|
+
[`provider-operation-journal-contract.json`](provider-operation-journal-contract.json).
|
|
134
138
|
It freezes one closed schema authority and one Rust v4 state-fold authority
|
|
135
139
|
for append-only intent, attempt, rooted observation, confirmation, and
|
|
136
|
-
reconciliation records. The
|
|
137
|
-
|
|
138
|
-
production writer.
|
|
140
|
+
reconciliation records. The Node v4 plane performs provider adaptation and
|
|
141
|
+
calls the tracked Rust/WASM authority; it contains no second state fold.
|
|
139
142
|
|
|
140
143
|
Logical operation identity excludes attempt ordinals and mutable provider or
|
|
141
144
|
runner facts. Every retry preserves `operationRoot`, while every attempt and
|
|
@@ -158,12 +161,12 @@ closed with typed faults.
|
|
|
158
161
|
## 10. Release activation production domain
|
|
159
162
|
|
|
160
163
|
The executable release activation boundary is
|
|
161
|
-
[`
|
|
164
|
+
[`release-activation-shadow-domain.json`](release-activation-shadow-domain.json).
|
|
162
165
|
It consumes an explicit qualification root, dependency graph, compensation
|
|
163
166
|
boundaries, provider-operation identities, and append-only journal facts to
|
|
164
|
-
derive one deterministic activation plan and resume state. Rust is the
|
|
165
|
-
plan-and-fold authority;
|
|
166
|
-
|
|
167
|
+
derive one deterministic activation plan and resume state. Rust/WASM is the
|
|
168
|
+
sole v4 plan-and-fold authority; the Node facade delegates through the checked
|
|
169
|
+
ABI and retains only provider adaptation.
|
|
167
170
|
|
|
168
171
|
Confirmed operations are never eligible for replay. Attempting, observed, and
|
|
169
172
|
confirmable operations require provider-neutral readback before any retry,
|
|
@@ -177,7 +180,7 @@ rooted readback before confirmation or retry.
|
|
|
177
180
|
## 11. Stable publication production fence
|
|
178
181
|
|
|
179
182
|
The stable-candidate production publication boundary is governed by
|
|
180
|
-
[`
|
|
183
|
+
[`stable-publication-fence.json`](stable-publication-fence.json). It
|
|
181
184
|
binds one exact candidate root to source, metadata, provider-operation journal,
|
|
182
185
|
protected ancestry, provider confirmations, and an independently sealed
|
|
183
186
|
qualification before a production publication plan can exist.
|
|
@@ -193,7 +196,7 @@ targets, and it must read them back before completion.
|
|
|
193
196
|
## 12. Wave 3 partial-mutation recovery qualification
|
|
194
197
|
|
|
195
198
|
The executable recovery qualification boundary is
|
|
196
|
-
[`
|
|
199
|
+
[`partial-mutation-recovery-qualification.json`](partial-mutation-recovery-qualification.json).
|
|
197
200
|
It consumes retained Stage Capsule resume evidence and release-activation journal
|
|
198
201
|
state only after exact source, policy, platform, qualification, plan, state,
|
|
199
202
|
operation, journal, and compensation-boundary roots agree.
|
|
@@ -203,8 +206,8 @@ Every nonterminal operation maps deterministically to `retry`, `wait`,
|
|
|
203
206
|
`terminal-noop` facts and never re-enter the next-operation set. Missing,
|
|
204
207
|
expired, corrupt, conflicting, cross-boundary, or attempt-budget-exhausted
|
|
205
208
|
evidence fails closed at an exact Stage Capsule or provider-operation
|
|
206
|
-
checkpoint. The Rust domain is the sole v4 planner and
|
|
207
|
-
|
|
209
|
+
checkpoint. The Rust/WASM domain is the sole v4 planner and the Node facade
|
|
210
|
+
delegates to it. The planner is pure: it performs zero provider,
|
|
208
211
|
filesystem, network, credential, ref, package, image, or release mutation.
|
|
209
212
|
Their exact plan is the only recovery authority consumed by the TypeScript v4
|
|
210
213
|
provider adapter.
|
package/architecture/{v3-core-mechanism-inventory.md → baseline-core-mechanism-inventory.md}
RENAMED
|
@@ -19,7 +19,7 @@ ai_provenance:
|
|
|
19
19
|
# v3 Core Mechanism Inventory
|
|
20
20
|
|
|
21
21
|
This is the human projection of
|
|
22
|
-
[`
|
|
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/
|
|
40
|
-
"architecture/
|
|
41
|
-
"architecture/
|
|
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
|
-
[`
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
61
|
+
"const": "architecture/bootstrap-authority.json"
|
|
62
62
|
},
|
|
63
63
|
"productionAuthority": { "const": "v4-native" },
|
|
64
64
|
"productionFallback": { "type": "null" },
|