@kungfu-tech/buildchain 4.0.1-alpha.42 → 4.0.1-alpha.54

package/architecture/agent-change-map.md

@@ -0,0 +1,1015 @@
+<!-- Generated by scripts/generate-agent-change-map.mjs. Do not edit directly. -->
+# Agent Change Map
+
+Use this index to identify the smallest implementation, contract, test, generated-output, and validation surface for a capability change. The machine-readable source of truth is `architecture/internal-capabilities.json`.
+
+## Governed complexity debt routes
+
+Owner: Buildchain architecture maintainers
+
+Capability: `maintainability-governance`
+
+Invariant: Every over-default surface remains exactly measured, owned, mapped, and unable to widen.
+
+Tests: `tests/maintainability.test.mjs`, `tests/maintainability-governance.test.mjs`
+
+Safe change route: Reduce one owned responsibility behind the stable facade, run focused differential tests, regenerate this map, and lower the exact ceiling.
+
+### Oversized surfaces
+
+- sources: `actions/macos-credential-island/index.js`
+- sources: `actions/macos-credential-island/lib.js`
+- sources: `actions/promote-buildchain-ref/index.js`
+- sources: `actions/promote-buildchain-ref/internal/durable-transaction-operations.js`
+- sources: `actions/promote-buildchain-ref/internal/durable-transaction-store.js`
+- sources: `actions/promote-buildchain-ref/internal/version-state-operations.js`
+- sources: `actions/promote-buildchain-ref/lib.js`
+- sources: `bin/buildchain.mjs`
+- sources: `packages/core/artifact-passport.js`
+- sources: `packages/core/artifact-verification-envelope.js`
+- sources: `packages/core/buildchain-config.js`
+- sources: `packages/core/buildchain-contract.js`
+- sources: `packages/core/buildchain-kfd-claims.js`
+- sources: `packages/core/dev-delivery-execution-transfer.js`
+- sources: `packages/core/dev-delivery-native-proof.js`
+- sources: `packages/core/dev-delivery-process-boundary.js`
+- sources: `packages/core/diagnostics.js`
+- sources: `packages/core/engineering-housekeeper-github.js`
+- sources: `packages/core/github-artifact-attestation.js`
+- sources: `packages/core/github-governance-authority.js`
+- sources: `packages/core/index.js`
+- sources: `packages/core/issue-reporting.js`
+- sources: `packages/core/kfd-gate.js`
+- sources: `packages/core/kfd-product-gates.js`
+- sources: `packages/core/kfd.js`
+- sources: `packages/core/kfd3-surface-register.js`
+- sources: `packages/core/next-development-controller.js`
+- sources: `packages/core/next-development-transition.js`
+- sources: `packages/core/paper-npm-bootstrap.js`
+- sources: `packages/core/paper.js`
+- sources: `packages/core/publication-artifact.js`
+- sources: `packages/core/publication-authority.js`
+- sources: `packages/core/publication-reproducibility.js`
+- sources: `packages/core/publish-transaction.js`
+- sources: `packages/core/readme-badges.js`
+- sources: `packages/core/release-candidate.js`
+- sources: `packages/core/release-passport.js`
+- sources: `packages/core/release-tail-provider-plane.js`
+- sources: `packages/core/release-train.js`
+- sources: `packages/core/stable-release-gate.js`
+- sources: `packages/core/v4-runtime-ref-resume-authority.js`
+- sources: `scripts/audit-github-governance.mjs`
+- sources: `scripts/audit-publication-control-plane.mjs`
+- sources: `scripts/auditable-demo.mjs`
+- sources: `scripts/build-contract-core.mjs`
+- sources: `scripts/check-inventory.mjs`
+- sources: `scripts/check-maintainability.mjs`
+- sources: `scripts/dev-alpha-candidate-patrol.mjs`
+- sources: `scripts/dev-delivery-authority.mjs`
+- sources: `scripts/dev-delivery-two-phase.mjs`
+- sources: `scripts/dev-delivery-warrant-options.mjs`
+- sources: `scripts/dev-pr-auto-merge.mjs`
+- sources: `scripts/finalize-native-artifact-signing-result.mjs`
+- sources: `scripts/generate-channel-promotion-workflow.mjs`
+- sources: `scripts/generate-site-bundle.mjs`
+- sources: `scripts/infra-contract-core.mjs`
+- sources: `scripts/infra-contract.mjs`
+- sources: `scripts/locked-source-checkout.mjs`
+- sources: `scripts/maintainability-domain-metrics.mjs`
+- sources: `scripts/paper.mjs`
+- sources: `scripts/publication-commit-evidence.mjs`
+- sources: `scripts/reconcile-github-governance.mjs`
+- sources: `scripts/release-candidate-resolver.mjs`
+- sources: `scripts/release-line-policy.mjs`
+- sources: `scripts/resume-from-candidate-run.mjs`
+- sources: `scripts/run-lifecycle-core.mjs`
+- sources: `scripts/stable-candidate-patrol.mjs`
+- sources: `scripts/stable-release-gate.mjs`
+- sources: `scripts/v4-architecture.mjs`
+- sources: `scripts/v4-warrant-shadow-plan.mjs`
+- sources: `scripts/web-surface-core.mjs`
+- sources: `scripts/web-surface-production-release-pr.mjs`
+- sources: `scripts/web-surface.mjs`
+- sources: `actions/promote-buildchain-ref/internal/promotion-operations.js`
+- rust: `crates/buildchain-v4-bridge/src/main.rs`
+- rust: `crates/buildchain-v4-contracts/src/main.rs`
+- rust: `crates/buildchain-v4-contracts/src/provider_operation_journal.rs`
+- rust: `crates/buildchain-v4-contracts/src/provider_operation_journal/fold.rs`
+- rust: `crates/buildchain-v4-contracts/src/warrant.rs`
+- rust: `crates/buildchain-v4-contracts/src/warrant/decision.rs`
+- tests: `tests/auditable-demo-platform.test.mjs`
+- tests: `tests/auditable-demo.test.mjs`
+- tests: `tests/aws-windows-jit-controller.test.mjs`
+- tests: `tests/build-surface-promotion.test.mjs`
+- tests: `tests/build-surface.test.mjs`
+- tests: `tests/buildchain-config.test.mjs`
+- tests: `tests/cli.test.mjs`
+- tests: `tests/dev-alpha-candidate-patrol.test.mjs`
+- tests: `tests/dev-delivery-authority.test.mjs`
+- tests: `tests/dev-delivery-process-boundary.test.mjs`
+- tests: `tests/dev-delivery-warrant-command.test.mjs`
+- tests: `tests/dev-delivery-warrant.test.mjs`
+- tests: `tests/dev-pr-auto-merge.test.mjs`
+- tests: `tests/github-governance-authority.test.mjs`
+- tests: `tests/infra-contract.test.mjs`
+- tests: `tests/macos-credential-island.test.mjs`
+- tests: `tests/native-artifact-signing-authority.test.mjs`
+- tests: `tests/paper.test.mjs`
+- tests: `tests/promote-buildchain-ref-governance.test.mjs`
+- tests: `tests/promote-buildchain-ref.test.mjs`
+- tests: `tests/publication-authority.test.mjs`
+- tests: `tests/publish-transaction.test.mjs`
+- tests: `tests/release-candidate-recovery.test.mjs`
+- tests: `tests/release-candidate.test.mjs`
+- tests: `tests/release-passport.test.mjs`
+- tests: `tests/release-propagation.test.mjs`
+- tests: `tests/v4-delivery-authority-parity.test.mjs`
+- tests: `tests/v4-floating-consumer-policy-contract.test.mjs`
+- tests: `tests/v4-floating-consumer-policy.test.mjs`
+- tests: `tests/v4-publication-rehearsal.test.mjs`
+- tests: `tests/web-surface.test.mjs`
+- tests: `tests/build-surface-reusable-build.test.mjs`
+- tests: `tests/build-surface-reusable-build-signing.test.mjs`
+- tests: `tests/build-surface-reusable-build-artifacts.test.mjs`
+- tests: `tests/promote-buildchain-ref-durable-recovery.test.mjs`
+- tests: `tests/promote-buildchain-ref-major-promotion.test.mjs`
+- tests: `tests/promote-buildchain-ref-recovery-alpha-finalization.test.mjs`
+- tests: `tests/promote-buildchain-ref-recovery-release-reconciliation.test.mjs`
+- workflows: `.github/workflows/.build.yml`
+- workflows: `.github/workflows/.gate-profile.yml`
+- workflows: `.github/workflows/.publication-authority.yml`
+- workflows: `.github/workflows/.release-candidate-promote.yml`
+- workflows: `.github/workflows/.release-verify.yml`
+- workflows: `.github/workflows/.web-surface.yml`
+- workflows: `.github/workflows/build.yml`
+- workflows: `.github/workflows/check.yml`
+- workflows: `.github/workflows/dev-pr-auto-merge.yml`
+- workflows: `.github/workflows/paper-release-sealed.yml`
+- workflows: `.github/workflows/paper-release.yml`
+- workflows: `.github/workflows/publication-artifact.yml`
+- workflows: `.github/workflows/release-candidate-promote.yml`
+- workflows: `.github/workflows/release-propagation.yml`
+
+### Current top twenty maintenance hotspots
+
+- `tests/v3-v4-capability-inventory.test.mjs`
+- `tests/v4-floating-consumer-policy-contract.test.mjs`
+- `.github/workflows/v4-adopter-delivery.yml`
+- `.github/workflows/buildchain-ref-promotion.yml`
+- `tests/release-candidate-recovery.test.mjs`
+- `.github/workflows/.release-candidate-promote.yml`
+- `tests/build-surface-promotion.test.mjs`
+- `.github/workflows/buildchain-ref-promotion-recovery.yml`
+- `tests/build-surface.test.mjs`
+- `tests/internal-architecture.test.mjs`
+- `scripts/resume-from-candidate-run.mjs`
+- `scripts/check-v3-v4-capability-inventory.mjs`
+- `.github/workflows/release-candidate-promote.yml`
+- `actions/promote-buildchain-ref/lib.js`
+- `scripts/check-inventory.mjs`
+- `tests/promote-buildchain-ref.test.mjs`
+- `tests/promotion-channel-router.test.mjs`
+- `scripts/site-capability-metadata.mjs`
+- `tests/v4-floating-consumer-policy.test.mjs`
+- `scripts/buildchain-cli-help.mjs`
+- `scripts/check-v4-floating-consumer-policy-contract.mjs`
+- `tests/dev-delivery-warrant.test.mjs`
+- `actions/promote-buildchain-ref/internal/version-state.js`
+- `packages/core/v4-floating-consumer-policy.js`
+- `packages/core/v4-floating-consumer-release-passport.js`
+- `packages/core/release-passport.js`
+- `tests/promote-buildchain-ref-governance.test.mjs`
+- `tests/v4-declarative-promotion-mode.test.mjs`
+- `scripts/buildchain-cli-help.mjs`
+
+## cli-command-registry
+
+Owner: Buildchain CLI maintainers
+
+### Implementation
+
+- `bin/buildchain.mjs`
+- `bin/internal/command-registry.mjs`
+
+### Contracts
+
+- `docs/cli.md`
+- `dist/site/cli-registry.json`
+
+### Tests
+
+- `tests/command-registry.test.mjs`
+- `tests/cli.test.mjs`
+
+### Generated outputs
+
+- `dist/site/cli-registry.json`
+
+### Minimal validation
+
+- `node --test tests/command-registry.test.mjs tests/cli.test.mjs`
+
+## cli-trust-release-dispatch
+
+Owner: Buildchain maintainers
+
+### Implementation
+
+- `bin/internal/cli-options.mjs`
+- `bin/internal/trust-release-command-handlers.mjs`
+- `bin/internal/trust-release-cli.mjs`
+- `bin/internal/trust-release-inspection-handlers.mjs`
+- `bin/internal/trust-release-release-handlers.mjs`
+- `bin/internal/trust-release-verification-handlers.mjs`
+
+### Contracts
+
+- `bin/buildchain.mjs`
+- `docs/cli.md`
+
+### Tests
+
+- `tests/cli.test.mjs`
+- `tests/public-surface-audit.test.mjs`
+
+### Generated outputs
+
+- None.
+
+### Minimal validation
+
+- `node --test tests/cli.test.mjs tests/public-surface-audit.test.mjs`
+
+## declarative-release-provider-plane
+
+Owner: Buildchain release provider maintainers
+
+### Implementation
+
+- `packages/core/release-tail-provider-plane.js`
+- `packages/core/release-tail-provider-adapters.js`
+- `packages/core/release-tail-compatibility.js`
+- `scripts/release-tail.mjs`
+- `actions/release-tail/index.js`
+
+### Contracts
+
+- `contracts/release-tail-capabilities-v1.schema.json`
+- `contracts/release-tail-provider-bindings-v1.schema.json`
+- `.github/workflows/release-tail.yml`
+- `actions/release-tail/action.yml`
+- `docs/release-tail-provider-plane.md`
+
+### Tests
+
+- `tests/release-tail-provider-plane.test.mjs`
+- `tests/release-tail-contract.test.mjs`
+
+### Generated outputs
+
+- `actions/release-tail/dist/index.js`
+
+### Minimal validation
+
+- `node --test tests/release-tail-provider-plane.test.mjs tests/release-tail-contract.test.mjs`
+
+## engineering-housekeeper
+
+Owner: Buildchain engineering hygiene maintainers
+
+### Implementation
+
+- `packages/core/engineering-housekeeper.js`
+- `packages/core/engineering-housekeeper-github-client.js`
+- `packages/core/engineering-housekeeper-github.js`
+- `scripts/engineering-housekeeper-workflow.mjs`
+
+### Contracts
+
+- `contracts/engineering-housekeeper-v1.schema.json`
+- `contracts/fixtures/engineering-housekeeper-v1/cases.json`
+- `docs/engineering-housekeeper.md`
+
+### Tests
+
+- `tests/engineering-housekeeper.test.mjs`
+- `tests/engineering-housekeeper-github.test.mjs`
+- `tests/engineering-housekeeper-workflow.test.mjs`
+
+### Generated outputs
+
+- None.
+
+### Minimal validation
+
+- `node --test tests/engineering-housekeeper.test.mjs tests/engineering-housekeeper-github.test.mjs tests/engineering-housekeeper-workflow.test.mjs`
+
+## maintainability-governance
+
+Owner: Buildchain architecture maintainers
+
+### Implementation
+
+- `scripts/check-internal-architecture.mjs`
+- `scripts/check-maintainability.mjs`
+- `scripts/maintainability-metrics.mjs`
+- `scripts/generate-agent-change-map.mjs`
+- `scripts/maintainability-domain-metrics.mjs`
+- `scripts/maintainability-governance.mjs`
+
+### Contracts
+
+- `architecture/internal-capabilities.json`
+- `architecture/maintainability-debt.json`
+- `architecture/maintainability-policy.json`
+
+### Tests
+
+- `tests/internal-architecture.test.mjs`
+- `tests/maintainability.test.mjs`
+- `tests/maintainability-governance.test.mjs`
+
+### Generated outputs
+
+- `architecture/agent-change-map.md`
+
+### Minimal validation
+
+- `node --test tests/internal-architecture.test.mjs tests/maintainability.test.mjs tests/maintainability-governance.test.mjs`
+- `node scripts/generate-agent-change-map.mjs`
+
+## paper-fleet-golden-path
+
+Owner: Buildchain Paper maintainers
+
+### Implementation
+
+- `packages/core/paper-agent-entry.js`
+- `packages/core/paper-fleet.js`
+- `packages/core/paper-npm-bootstrap.js`
+- `packages/core/paper-repository.js`
+- `packages/core/paper-scaffold-content.js`
+- `packages/core/paper-work.js`
+- `packages/core/paper.js`
+- `packages/core/public-surface-cli.js`
+- `scripts/buildchain-cli-help.mjs`
+- `scripts/paper-work-fleet-cli.mjs`
+
+### Contracts
+
+- `dist/site/cli-registry.json`
+- `dist/site/node-api-registry.json`
+
+### Tests
+
+- `tests/cli.test.mjs`
+- `tests/paper.test.mjs`
+- `tests/public-surface-audit.test.mjs`
+
+### Generated outputs
+
+- `dist/site/cli-registry.json`
+- `dist/site/node-api-registry.json`
+
+### Minimal validation
+
+- `node --test tests/cli.test.mjs tests/paper.test.mjs tests/public-surface-audit.test.mjs`
+
+## promotion-channel-orchestration
+
+Owner: Buildchain action maintainers
+
+### Implementation
+
+- `actions/promote-buildchain-ref/internal/promote-alpha-channel.js`
+- `actions/promote-buildchain-ref/internal/promote-major-channel.js`
+- `actions/promote-buildchain-ref/internal/promote-release-channel.js`
+
+### Contracts
+
+- `actions/promote-buildchain-ref/action.yml`
+- `actions/promote-buildchain-ref/lib.js`
+
+### Tests
+
+- `tests/promote-buildchain-ref.test.mjs`
+- `tests/promote-buildchain-ref-recovery.test.mjs`
+- `tests/promote-buildchain-ref-governance.test.mjs`
+- `tests/promotion-responsibilities.test.mjs`
+
+### Generated outputs
+
+- `actions/promote-buildchain-ref/dist/index.js`
+
+### Minimal validation
+
+- `node --test tests/promote-buildchain-ref.test.mjs tests/promote-buildchain-ref-recovery.test.mjs tests/promote-buildchain-ref-governance.test.mjs tests/promotion-responsibilities.test.mjs`
+
+## promotion-github-transaction-store
+
+Owner: Buildchain maintainers
+
+### Implementation
+
+- `actions/promote-buildchain-ref/internal/durable-transaction-store.js`
+- `actions/promote-buildchain-ref/internal/durable-transaction-operations.js`
+- `actions/promote-buildchain-ref/internal/github-adapter.js`
+- `actions/promote-buildchain-ref/internal/promotion-operations.js`
+
+### Contracts
+
+- `actions/promote-buildchain-ref/lib.js`
+
+### Tests
+
+- `tests/promote-buildchain-ref.test.mjs`
+- `tests/promote-buildchain-ref-recovery.test.mjs`
+- `tests/promotion-responsibilities.test.mjs`
+
+### Generated outputs
+
+- `actions/promote-buildchain-ref/dist/index.js`
+
+### Minimal validation
+
+- `node --test tests/promote-buildchain-ref.test.mjs tests/promote-buildchain-ref-recovery.test.mjs tests/promotion-responsibilities.test.mjs`
+
+## promotion-policy
+
+Owner: Buildchain maintainers
+
+### Implementation
+
+- `actions/promote-buildchain-ref/internal/promotion-policy.js`
+
+### Contracts
+
+- `actions/promote-buildchain-ref/action.yml`
+- `actions/promote-buildchain-ref/lib.js`
+
+### Tests
+
+- `tests/promote-buildchain-ref.test.mjs`
+- `tests/promote-buildchain-ref-governance.test.mjs`
+- `tests/promotion-responsibilities.test.mjs`
+
+### Generated outputs
+
+- `actions/promote-buildchain-ref/dist/index.js`
+
+### Minimal validation
+
+- `node --test tests/promote-buildchain-ref.test.mjs tests/promote-buildchain-ref-governance.test.mjs tests/promotion-responsibilities.test.mjs`
+
+## promotion-runtime-override-authorization
+
+Owner: Buildchain release governance maintainers
+
+### Implementation
+
+- `scripts/authorize-promotion-runtime-override.cjs`
+
+### Contracts
+
+- `.github/workflows/release-candidate-promote.yml`
+
+### Tests
+
+- `tests/authorize-promotion-runtime-override.test.mjs`
+
+### Generated outputs
+
+- None.
+
+### Minimal validation
+
+- `node --test tests/authorize-promotion-runtime-override.test.mjs`
+
+## promotion-version-state
+
+Owner: Buildchain maintainers
+
+### Implementation
+
+- `actions/promote-buildchain-ref/internal/version-state.js`
+- `actions/promote-buildchain-ref/internal/version-state-operations.js`
+
+### Contracts
+
+- `.buildchain/release-impact.json`
+- `actions/promote-buildchain-ref/lib.js`
+
+### Tests
+
+- `tests/promote-buildchain-ref.test.mjs`
+- `tests/promote-buildchain-ref-recovery.test.mjs`
+- `tests/release-impact-contract.test.mjs`
+
+### Generated outputs
+
+- `actions/promote-buildchain-ref/dist/index.js`
+
+### Minimal validation
+
+- `node --test tests/promote-buildchain-ref.test.mjs tests/promote-buildchain-ref-recovery.test.mjs tests/release-impact-contract.test.mjs`
+
+## release-passport-verification
+
+Owner: Buildchain release trust maintainers
+
+### Implementation
+
+- `packages/core/release-passport.js`
+
+### Contracts
+
+- `docs/release-passport.md`
+- `dist/site/release-passport-check-manifest.json`
+
+### Tests
+
+- `tests/release-passport.test.mjs`
+- `tests/release-passport-contract.test.mjs`
+
+### Generated outputs
+
+- `dist/site/release-passport-check-manifest.json`
+
+### Minimal validation
+
+- `node --test tests/release-passport.test.mjs tests/release-passport-contract.test.mjs`
+
+## release-workflow-promotion-routing
+
+Owner: Buildchain maintainers
+
+### Implementation
+
+- `scripts/promotion-routing-evidence.mjs`
+- `scripts/verify-promotion-router-binding.sh`
+
+### Contracts
+
+- `.github/workflows/.release-candidate-promote.yml`
+- `.github/workflows/release-candidate-promote.yml`
+
+### Tests
+
+- `tests/promotion-routing-evidence.test.mjs`
+- `tests/build-surface.test.mjs`
+- `tests/build-surface-promotion.test.mjs`
+
+### Generated outputs
+
+- `.github/workflows/release-candidate-promote.yml`
+
+### Minimal validation
+
+- `node --test tests/promotion-routing-evidence.test.mjs tests/build-surface.test.mjs tests/build-surface-promotion.test.mjs`
+
+## reusable-build-orchestration
+
+Owner: Buildchain workflow maintainers
+
+### Implementation
+
+- `scripts/generate-channel-build-workflow.mjs`
+- `scripts/resolve-artifact-transfer-mode.mjs`
+- `scripts/resolve-build-summary-names.sh`
+- `scripts/run-lifecycle-core.mjs`
+
+### Contracts
+
+- `.github/workflows/.build.yml`
+- `.github/workflows/build.yml`
+
+### Tests
+
+- `tests/artifact-transfer-mode.test.mjs`
+- `tests/resolve-build-summary-names.test.mjs`
+- `tests/build-surface-reusable-build-artifacts.test.mjs`
+- `tests/build-surface.test.mjs`
+- `tests/build-surface-promotion.test.mjs`
+- `tests/controller-evidence.test.mjs`
+
+### Generated outputs
+
+- `.github/workflows/build.yml`
+- `actions/run-lifecycle/dist/index.js`
+
+### Minimal validation
+
+- `node --test tests/artifact-transfer-mode.test.mjs tests/resolve-build-summary-names.test.mjs tests/build-surface-reusable-build-artifacts.test.mjs tests/build-surface.test.mjs tests/build-surface-promotion.test.mjs tests/controller-evidence.test.mjs`
+
+## reusable-workflow-call-contract
+
+Owner: Buildchain release governance maintainers
+
+### Implementation
+
+- `packages/core/workflow-call-contract.js`
+- `packages/core/workflow-yaml-contract.js`
+- `scripts/workflow-call-contract.mjs`
+
+### Contracts
+
+- `docs/release-governance.md`
+
+### Tests
+
+- `tests/workflow-call-contract.test.mjs`
+- `tests/public-surface-audit.test.mjs`
+
+### Generated outputs
+
+- None.
+
+### Minimal validation
+
+- `node --test tests/workflow-call-contract.test.mjs tests/public-surface-audit.test.mjs`
+
+## shared-build-contract
+
+Owner: Buildchain contract maintainers
+
+### Implementation
+
+- `packages/core/buildchain-contract.js`
+- `scripts/build-contract-core.mjs`
+
+### Contracts
+
+- `dist/site/buildchain-contract.json`
+- `docs/runtime-train-validation.md`
+
+### Tests
+
+- `tests/buildchain-contract.test.mjs`
+- `tests/build-surface.test.mjs`
+- `tests/build-surface-promotion.test.mjs`
+
+### Generated outputs
+
+- `dist/site/buildchain-contract.json`
+
+### Minimal validation
+
+- `node --test tests/buildchain-contract.test.mjs tests/build-surface.test.mjs tests/build-surface-promotion.test.mjs`
+
+## site-upstream-agent-propagation
+
+Owner: Buildchain release propagation maintainers
+
+### Implementation
+
+- `packages/core/release-propagation-agent-entry.js`
+- `packages/core/release-propagation-push.js`
+- `packages/core/release-propagation-stage-evidence.js`
+- `packages/core/release-propagation-work.js`
+- `scripts/release-propagation.mjs`
+
+### Contracts
+
+- `docs/release-propagation.md`
+- `dist/site/cli-registry.json`
+- `dist/site/node-api-registry.json`
+
+### Tests
+
+- `tests/release-propagation.test.mjs`
+- `tests/release-propagation-pickup.test.mjs`
+
+### Generated outputs
+
+- `dist/site/cli-registry.json`
+- `dist/site/node-api-registry.json`
+
+### Minimal validation
+
+- `node --test tests/release-propagation.test.mjs tests/release-propagation-pickup.test.mjs`
+
+## v4-adopter-delivery
+
+Owner: Buildchain adopter delivery maintainers
+
+### Implementation
+
+- `bin/internal/adopter-delivery-cli.mjs`
+- `packages/core/adopter-delivery-gate.js`
+- `packages/core/adopter-delivery-passport.js`
+- `packages/core/adopter-delivery-vectors.js`
+- `packages/core/buildchain-delivery-bootstrap.js`
+- `packages/core/buildchain-delivery-infrastructure.js`
+- `packages/core/buildchain-delivery-self-dogfood.js`
+- `packages/core/kfd-adopter-category-driver.js`
+- `packages/core/legacy-kfd-adopter-driver.js`
+- `packages/core/published-delivery-authority.js`
+- `packages/core/v4-adopter-delivery.js`
+- `packages/core/v4-adopter-delivery-parity.js`
+- `packages/core/v4-cross-platform-adopter-qualification.js`
+- `scripts/v4-cross-platform-adopter-qualification.mjs`
+- `crates/buildchain-v4-contracts/src/adopter_delivery.rs`
+
+### Contracts
+
+- `architecture/v4-adopter-delivery-parity.json`
+- `architecture/v4-cross-platform-adopter-qualification.json`
+- `contracts/v4-adopter-delivery-v1.schema.json`
+- `contracts/fixtures/v4-adopter-delivery-v1/archive-template.json`
+- `contracts/fixtures/v4-adopter-delivery-v1/bootstrap-positive.json`
+- `contracts/fixtures/v4-adopter-delivery-v1/gate-positive.json`
+- `contracts/fixtures/v4-adopter-delivery-v1/gate-unknown-selector.json`
+- `contracts/fixtures/v4-adopter-delivery-v1/offline-vectors.json`
+- `.github/workflows/v4-adopter-delivery.yml`
+- `.github/workflows/v4-adopter-delivery-dogfood.yml`
+- `docs/v4-adopter-delivery.md`
+
+### Tests
+
+- `tests/v4-adopter-delivery.test.mjs`
+- `tests/v4-adopter-delivery-parity.test.mjs`
+- `tests/v4-cross-platform-adopter-qualification.test.mjs`
+- `tests/non-kfd-specification-driver-clean-room.test.mjs`
+
+### Generated outputs
+
+- None.
+
+### Minimal validation
+
+- `node --test tests/v4-adopter-delivery.test.mjs tests/v4-adopter-delivery-parity.test.mjs tests/v4-cross-platform-adopter-qualification.test.mjs tests/non-kfd-specification-driver-clean-room.test.mjs`
+
+## v4-architecture-governance
+
+Owner: Buildchain architecture maintainers
+
+### Implementation
+
+- `scripts/v4-architecture.mjs`
+- `scripts/v4-bridge-bootstrap.mjs`
+- `scripts/v4-bridge-evidence.mjs`
+- `scripts/v4-host-adapter.mjs`
+- `crates/buildchain-v4-bridge/src/main.rs`
+- `packages/core/v4-provider-operation-journal.js`
+- `packages/core/v4-provider-readback-idempotency.js`
+- `packages/core/v4-release-activation-shadow.js`
+- `packages/core/v4-stable-publication-fence.js`
+- `packages/core/v4-partial-mutation-recovery-qualification.js`
+- `packages/core/v4-runtime-ref-resume-authority.js`
+- `packages/core/v4-runtime-selector-persistence.js`
+- `packages/core/v4-tail-reseal-contract.js`
+- `packages/core/v4-tail-reseal.js`
+- `packages/core/v4-tail-reseal-github.js`
+- `packages/core/v4-tail-reseal-receipt.js`
+- `scripts/v4-tail-reseal.mjs`
+- `scripts/v4-tail-reseal-macos-rehearsal.mjs`
+- `packages/core/v4-stage-capsule.js`
+- `packages/core/v4-stage-capsule-store.js`
+- `packages/core/v4-stage-capsule-local-store.js`
+- `packages/core/v4-platform-stage-checkpoints.js`
+- `scripts/v4-platform-stage-checkpoint-rehearsal.mjs`
+- `packages/core/v4-stage-capsule-qualification.js`
+- `packages/core/v4-stage-capsule-qualification-campaign.js`
+- `scripts/v4-stage-capsule-qualification.mjs`
+- `crates/buildchain-v4-contracts/src/stage_capsule.rs`
+- `crates/buildchain-v4-contracts/src/stage_capsule_store.rs`
+- `crates/buildchain-v4-contracts/src/provider_operation_journal.rs`
+- `crates/buildchain-v4-contracts/src/provider_operation_journal/fold.rs`
+- `crates/buildchain-v4-contracts/src/provider_readback_idempotency.rs`
+- `crates/buildchain-v4-contracts/src/release_activation_shadow.rs`
+- `crates/buildchain-v4-contracts/src/release_activation_shadow/model.rs`
+- `crates/buildchain-v4-contracts/src/release_activation_shadow/journal.rs`
+- `crates/buildchain-v4-contracts/src/stable_publication_fence.rs`
+- `crates/buildchain-v4-contracts/src/partial_mutation_recovery.rs`
+
+### Contracts
+
+- `architecture/v4-architecture-constitution.md`
+- `architecture/v4-capability-state-machine-manifest.json`
+- `architecture/v4-bootstrap-authority.json`
+- `architecture/v4-exception-ledger.json`
+- `architecture/v4-rust-libnode-bridge-evaluation.json`
+- `architecture/v4-rust-libnode-bridge-spike.md`
+- `architecture/v4-provider-operation-journal-contract.json`
+- `architecture/v4-release-activation-shadow-domain.json`
+- `architecture/v4-stable-publication-fence.json`
+- `architecture/v4-partial-mutation-recovery-qualification.json`
+- `architecture/v4-stage-capsule-contract.json`
+- `architecture/v4-stage-capsule-store-contract.json`
+- `architecture/v4-platform-stage-checkpoints.json`
+- `architecture/v4-stage-capsule-qualification.json`
+- `architecture/v4-runtime-ref-resume-authority.json`
+- `contracts/v4-host-contract-v1.schema.json`
+- `contracts/v4-provider-operation-journal-v1.schema.json`
+- `contracts/v4-release-activation-shadow-v1.schema.json`
+- `contracts/v4-stable-publication-fence-v1.schema.json`
+- `contracts/v4-partial-mutation-recovery-v1.schema.json`
+- `contracts/v4-stage-capsule-v1.schema.json`
+- `contracts/v4-stage-capsule-store-v1.schema.json`
+- `contracts/fixtures/v4-stage-capsule-v1/shared.json`
+- `contracts/fixtures/v4-stage-capsule-store-v1/shared.json`
+- `contracts/fixtures/v4-provider-operation-journal-v1/shared.json`
+- `contracts/fixtures/v4-provider-readback-idempotency-v1/shared.json`
+- `contracts/fixtures/v4-release-activation-shadow-v1/shared.json`
+- `contracts/fixtures/v4-stable-publication-fence-v1/shared.json`
+- `contracts/fixtures/v4-partial-mutation-recovery-v1/shared.json`
+- `contracts/v4-runtime-ref-resume-authority-v1.schema.json`
+- `contracts/fixtures/v4-runtime-ref-resume-authority-v1/scenario.json`
+- `architecture/v4-tail-reseal-parity.json`
+- `contracts/v4-tail-reseal-v1.schema.json`
+- `contracts/fixtures/v4-tail-reseal-v1/valid.json`
+- `.github/workflows/v4-tail-reseal.yml`
+- `docs/v4-stage-capsule.md`
+- `docs/v4-runtime-ref-resume-authority.md`
+- `docs/v4-tail-reseal.md`
+
+### Tests
+
+- `tests/v4-architecture.test.mjs`
+- `tests/v4-bridge.test.mjs`
+- `tests/v4-provider-operation-journal.test.mjs`
+- `tests/v4-provider-readback-idempotency.test.mjs`
+- `tests/v4-release-activation-shadow.test.mjs`
+- `tests/v4-stable-publication-fence.test.mjs`
+- `tests/v4-partial-mutation-recovery-qualification.test.mjs`
+- `tests/v4-stage-capsule.test.mjs`
+- `tests/v4-stage-capsule-store.test.mjs`
+- `tests/v4-platform-stage-checkpoints.test.mjs`
+- `tests/v4-stage-capsule-qualification.test.mjs`
+- `tests/v4-runtime-ref-resume-authority.test.mjs`
+- `tests/v4-tail-reseal.test.mjs`
+- `tests/v4-tail-reseal-parity.test.mjs`
+
+### Generated outputs
+
+- None.
+
+### Minimal validation
+
+- `node --test tests/v4-architecture.test.mjs tests/v4-bridge.test.mjs tests/v4-provider-operation-journal.test.mjs tests/v4-provider-readback-idempotency.test.mjs tests/v4-release-activation-shadow.test.mjs tests/v4-stable-publication-fence.test.mjs tests/v4-partial-mutation-recovery-qualification.test.mjs tests/v4-stage-capsule.test.mjs tests/v4-stage-capsule-store.test.mjs tests/v4-platform-stage-checkpoints.test.mjs tests/v4-stage-capsule-qualification.test.mjs tests/v4-runtime-ref-resume-authority.test.mjs tests/v4-tail-reseal.test.mjs tests/v4-tail-reseal-parity.test.mjs`
+
+## v4-compatibility-facts
+
+Owner: Buildchain compatibility authority maintainers
+
+### Implementation
+
+- `bin/internal/compatibility-facts-cli.mjs`
+- `packages/core/kungfu-temporal-fact.js`
+- `packages/core/buildchain-compatibility-fact.js`
+- `packages/core/buildchain-compatibility-authority.js`
+- `packages/core/buildchain-compatibility-proof.js`
+- `crates/buildchain-v4-contracts/src/compatibility_facts.rs`
+- `crates/buildchain-v4-contracts/src/compatibility_facts/encoding.rs`
+- `crates/buildchain-v4-contracts/src/compatibility_facts/fixture.rs`
+- `crates/buildchain-v4-contracts/src/compatibility_facts/lifecycle.rs`
+- `crates/buildchain-v4-contracts/src/compatibility_facts/verifier.rs`
+
+### Contracts
+
+- `architecture/v4-compatibility-facts-parity.json`
+- `contracts/v4-compatibility-facts-v1.schema.json`
+- `contracts/fixtures/v4-compatibility-facts-v1/shared.json`
+- `dist/site/schemas/v4-compatibility-facts-v1.schema.json`
+- `docs/v4-compatibility-facts.md`
+
+### Tests
+
+- `tests/v4-compatibility-facts.test.mjs`
+
+### Generated outputs
+
+- `dist/site/schemas/v4-compatibility-facts-v1.schema.json`
+
+### Minimal validation
+
+- `node --test tests/v4-compatibility-facts.test.mjs`
+
+## v4-delivery-authority
+
+Owner: Buildchain protected delivery maintainers
+
+### Implementation
+
+- `packages/core/dev-delivery-warrant.js`
+- `packages/core/dev-delivery-warrant-state.js`
+- `packages/core/dev-delivery-warrant-qualification.js`
+- `packages/core/dev-delivery-native-proof.js`
+- `packages/core/dev-delivery-native-execution.js`
+- `packages/core/dev-delivery-execution-failure.js`
+- `packages/core/dev-delivery-execution-transfer.js`
+- `packages/core/dev-delivery-process-boundary.js`
+- `packages/core/dev-delivery-contract-surface.js`
+- `packages/core/dev-delivery-authority-candidate.js`
+- `packages/core/dev-delivery-authority-evidence.js`
+- `packages/core/dev-delivery-authority-state.js`
+- `packages/core/dev-delivery-authority-qualification.js`
+- `packages/core/dev-delivery-authority-landing.js`
+- `packages/core/dev-delivery-landing-admission-core.js`
+- `packages/core/dev-delivery-authority-settlement.js`
+- `packages/core/dev-delivery-landing-readback.js`
+- `packages/core/dev-delivery-landing-terminal-evidence.js`
+- `packages/core/dev-delivery-landing-testing-port.js`
+- `packages/core/dev-delivery-provider-attempt.js`
+- `packages/core/dev-delivery-provider-heartbeat.js`
+- `scripts/dev-delivery-warrant.mjs`
+- `scripts/dev-delivery-warrant-options.mjs`
+- `scripts/dev-delivery-warrant-store.mjs`
+- `scripts/dev-delivery-authority.mjs`
+- `scripts/dev-delivery-authority-command-adapters.mjs`
+- `scripts/dev-delivery-authority-provider.mjs`
+- `scripts/dev-delivery-native-run.mjs`
+- `scripts/dev-delivery-process-boundary.mjs`
+- `scripts/dev-delivery-provider-heartbeat.mjs`
+- `scripts/dev-delivery-two-phase-resume.mjs`
+- `scripts/dev-delivery-two-phase.mjs`
+
+### Contracts
+
+- `architecture/v4-delivery-authority-parity.json`
+- `architecture/decisions/0003-two-phase-delivery-warrant.md`
+- `contracts/dev-delivery-authority-v2.schema.json`
+- `dist/site/schemas/dev-delivery-authority-v2.schema.json`
+- `.github/workflows/dev-pr-auto-merge.yml`
+- `.github/workflows/buildchain-dev-delivery.yml`
+- `templates/native-dev-delivery.yml`
+- `docs/dev-delivery-warrant.md`
+- `docs/dev-delivery-qualification-landing-adr.md`
+
+### Tests
+
+- `tests/dev-delivery-warrant.test.mjs`
+- `tests/dev-delivery-warrant-command.test.mjs`
+- `tests/dev-delivery-two-phase.test.mjs`
+- `tests/dev-delivery-two-phase-run.test.mjs`
+- `tests/dev-delivery-native-run.test.mjs`
+- `tests/dev-delivery-process-boundary.test.mjs`
+- `tests/dev-delivery-process-boundary-negative.test.mjs`
+- `tests/dev-delivery-provider-heartbeat.test.mjs`
+- `tests/dev-delivery-authority.test.mjs`
+- `tests/build-surface.test.mjs`
+- `tests/v4-delivery-authority-parity.test.mjs`
+
+### Generated outputs
+
+- `dist/site/schemas/dev-delivery-authority-v2.schema.json`
+
+### Minimal validation
+
+- `node --test tests/dev-delivery-warrant.test.mjs tests/dev-delivery-warrant-command.test.mjs tests/dev-delivery-two-phase.test.mjs tests/dev-delivery-two-phase-run.test.mjs tests/dev-delivery-native-run.test.mjs tests/dev-delivery-process-boundary.test.mjs tests/dev-delivery-process-boundary-negative.test.mjs tests/dev-delivery-provider-heartbeat.test.mjs tests/dev-delivery-authority.test.mjs tests/build-surface.test.mjs tests/v4-delivery-authority-parity.test.mjs`
+
+## v4-publication-rehearsal
+
+Owner: Buildchain publication rehearsal maintainers
+
+### Implementation
+
+- `packages/core/v4-publication-rehearsal-capsule.js`
+- `packages/core/v4-publication-rehearsal-provider-bindings.js`
+- `packages/core/v4-publication-rehearsal.js`
+
+### Contracts
+
+- `architecture/v4-publication-rehearsal-parity.json`
+- `contracts/v4-publication-rehearsal-capsule-v1.schema.json`
+- `.github/workflows/v4-publication-rehearsal-dogfood.yml`
+- `docs/v4-publication-rehearsal.md`
+
+### Tests
+
+- `tests/v4-publication-rehearsal.test.mjs`
+
+### Generated outputs
+
+- None.
+
+### Minimal validation
+
+- `node --test tests/v4-publication-rehearsal.test.mjs`
+
+## web-surface-delivery
+
+Owner: Buildchain web-surface maintainers
+
+### Implementation
+
+- `scripts/web-surface-core.mjs`
+- `scripts/web-surface-routing.mjs`
+- `scripts/web-surface.mjs`
+
+### Contracts
+
+- `.github/workflows/.web-surface.yml`
+
+### Tests
+
+- `tests/web-surface.test.mjs`
+- `tests/web-surface-publication-authority.test.mjs`
+
+### Generated outputs
+
+- None.
+
+### Minimal validation
+
+- `node --test tests/web-surface.test.mjs tests/web-surface-publication-authority.test.mjs`