@kungfu-tech/buildchain 4.0.1-alpha.5 → 4.0.1-alpha.55

package/architecture/internal-capabilities.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": 1,
+  "schemaVersion": 2,
   "coverageRoots": [
     "actions/promote-buildchain-ref/internal",
     "bin/buildchain.mjs",
@@ -30,6 +30,9 @@
     "packages/core/release-tail-provider-plane.js",
     "packages/core/release-tail-provider-adapters.js",
     "packages/core/release-tail-compatibility.js",
+    "packages/core/v4-publication-rehearsal-capsule.js",
+    "packages/core/v4-publication-rehearsal-provider-bindings.js",
+    "packages/core/v4-publication-rehearsal.js",
     "actions/release-tail/index.js",
     "scripts/authorize-promotion-runtime-override.cjs",
     "scripts/build-contract-core.mjs",
@@ -39,6 +42,7 @@
     "scripts/paper-work-fleet-cli.mjs",
     "scripts/run-lifecycle-core.mjs",
     "scripts/resolve-artifact-transfer-mode.mjs",
+    "scripts/resolve-build-summary-names.sh",
     "scripts/release-propagation.mjs",
     "scripts/engineering-housekeeper-workflow.mjs",
     "scripts/release-tail.mjs",
@@ -115,10 +119,28 @@
     "crates/buildchain-v4-contracts/src/stable_publication_fence.rs",
     "packages/core/v4-partial-mutation-recovery-qualification.js",
     "crates/buildchain-v4-contracts/src/partial_mutation_recovery.rs",
+    "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",
     "crates/buildchain-v4-contracts/src/compatibility_facts.rs",
-    "crates/buildchain-v4-contracts/src/compatibility_facts"
+    "crates/buildchain-v4-contracts/src/compatibility_facts",
+    "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"
   ],
   "ownershipRules": [
     {
@@ -196,13 +218,16 @@
       "contracts": [
         "actions/promote-buildchain-ref/action.yml",
         "actions/promote-buildchain-ref/lib.js"
+      ],
+      "generatedOutputs": ["actions/promote-buildchain-ref/dist/index.js"],
+      "validationCommands": [
+        "node --test tests/promote-buildchain-ref.test.mjs tests/promote-buildchain-ref-governance.test.mjs tests/promotion-responsibilities.test.mjs"
       ]
     },
     {
       "id": "promotion-version-state",
       "owner": "Buildchain maintainers",
       "implementation": [
-        "actions/promote-buildchain-ref/internal/existing-version-state.js",
         "actions/promote-buildchain-ref/internal/version-state.js",
         "actions/promote-buildchain-ref/internal/version-state-operations.js"
       ],
@@ -214,6 +239,10 @@
       "contracts": [
         ".buildchain/release-impact.json",
         "actions/promote-buildchain-ref/lib.js"
+      ],
+      "generatedOutputs": ["actions/promote-buildchain-ref/dist/index.js"],
+      "validationCommands": [
+        "node --test tests/promote-buildchain-ref.test.mjs tests/promote-buildchain-ref-recovery.test.mjs tests/release-impact-contract.test.mjs"
       ]
     },
     {
@@ -222,14 +251,19 @@
       "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/github-adapter.js",
+        "actions/promote-buildchain-ref/internal/promotion-operations.js"
       ],
       "tests": [
         "tests/promote-buildchain-ref.test.mjs",
         "tests/promote-buildchain-ref-recovery.test.mjs",
         "tests/promotion-responsibilities.test.mjs"
       ],
-      "contracts": ["actions/promote-buildchain-ref/lib.js"]
+      "contracts": ["actions/promote-buildchain-ref/lib.js"],
+      "generatedOutputs": ["actions/promote-buildchain-ref/dist/index.js"],
+      "validationCommands": [
+        "node --test tests/promote-buildchain-ref.test.mjs tests/promote-buildchain-ref-recovery.test.mjs tests/promotion-responsibilities.test.mjs"
+      ]
     },
     {
       "id": "promotion-channel-orchestration",
@@ -248,6 +282,10 @@
       "contracts": [
         "actions/promote-buildchain-ref/action.yml",
         "actions/promote-buildchain-ref/lib.js"
+      ],
+      "generatedOutputs": ["actions/promote-buildchain-ref/dist/index.js"],
+      "validationCommands": [
+        "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"
       ]
     },
     {
@@ -262,7 +300,11 @@
         "bin/internal/trust-release-verification-handlers.mjs"
       ],
       "tests": ["tests/cli.test.mjs", "tests/public-surface-audit.test.mjs"],
-      "contracts": ["bin/buildchain.mjs", "docs/cli.md"]
+      "contracts": ["bin/buildchain.mjs", "docs/cli.md"],
+      "generatedOutputs": [],
+      "validationCommands": [
+        "node --test tests/cli.test.mjs tests/public-surface-audit.test.mjs"
+      ]
     },
     {
       "id": "release-workflow-promotion-routing",
@@ -279,6 +321,10 @@
       "contracts": [
         ".github/workflows/.release-candidate-promote.yml",
         ".github/workflows/release-candidate-promote.yml"
+      ],
+      "generatedOutputs": [".github/workflows/release-candidate-promote.yml"],
+      "validationCommands": [
+        "node --test tests/promotion-routing-evidence.test.mjs tests/build-surface.test.mjs tests/build-surface-promotion.test.mjs"
       ]
     },
     {
@@ -292,6 +338,10 @@
       "contracts": [
         "docs/release-passport.md",
         "dist/site/release-passport-check-manifest.json"
+      ],
+      "generatedOutputs": ["dist/site/release-passport-check-manifest.json"],
+      "validationCommands": [
+        "node --test tests/release-passport.test.mjs tests/release-passport-contract.test.mjs"
       ]
     },
     {
@@ -302,7 +352,11 @@
         "bin/internal/command-registry.mjs"
       ],
       "tests": ["tests/command-registry.test.mjs", "tests/cli.test.mjs"],
-      "contracts": ["docs/cli.md", "dist/site/cli-registry.json"]
+      "contracts": ["docs/cli.md", "dist/site/cli-registry.json"],
+      "generatedOutputs": ["dist/site/cli-registry.json"],
+      "validationCommands": [
+        "node --test tests/command-registry.test.mjs tests/cli.test.mjs"
+      ]
     },
     {
       "id": "reusable-build-orchestration",
@@ -310,10 +364,13 @@
       "implementation": [
         "scripts/generate-channel-build-workflow.mjs",
         "scripts/resolve-artifact-transfer-mode.mjs",
+        "scripts/resolve-build-summary-names.sh",
         "scripts/run-lifecycle-core.mjs"
       ],
       "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"
@@ -321,6 +378,13 @@
       "contracts": [
         ".github/workflows/.build.yml",
         ".github/workflows/build.yml"
+      ],
+      "generatedOutputs": [
+        ".github/workflows/build.yml",
+        "actions/run-lifecycle/dist/index.js"
+      ],
+      "validationCommands": [
+        "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"
       ]
     },
     {
@@ -335,7 +399,11 @@
         "tests/web-surface.test.mjs",
         "tests/web-surface-publication-authority.test.mjs"
       ],
-      "contracts": [".github/workflows/.web-surface.yml"]
+      "contracts": [".github/workflows/.web-surface.yml"],
+      "generatedOutputs": [],
+      "validationCommands": [
+        "node --test tests/web-surface.test.mjs tests/web-surface-publication-authority.test.mjs"
+      ]
     },
     {
       "id": "shared-build-contract",
@@ -352,6 +420,10 @@
       "contracts": [
         "dist/site/buildchain-contract.json",
         "docs/runtime-train-validation.md"
+      ],
+      "generatedOutputs": ["dist/site/buildchain-contract.json"],
+      "validationCommands": [
+        "node --test tests/buildchain-contract.test.mjs tests/build-surface.test.mjs tests/build-surface-promotion.test.mjs"
       ]
     },
     {
@@ -366,14 +438,22 @@
         "tests/workflow-call-contract.test.mjs",
         "tests/public-surface-audit.test.mjs"
       ],
-      "contracts": ["docs/release-governance.md"]
+      "contracts": ["docs/release-governance.md"],
+      "generatedOutputs": [],
+      "validationCommands": [
+        "node --test tests/workflow-call-contract.test.mjs tests/public-surface-audit.test.mjs"
+      ]
     },
     {
       "id": "promotion-runtime-override-authorization",
       "owner": "Buildchain release governance maintainers",
       "implementation": ["scripts/authorize-promotion-runtime-override.cjs"],
       "tests": ["tests/authorize-promotion-runtime-override.test.mjs"],
-      "contracts": [".github/workflows/release-candidate-promote.yml"]
+      "contracts": [".github/workflows/release-candidate-promote.yml"],
+      "generatedOutputs": [],
+      "validationCommands": [
+        "node --test tests/authorize-promotion-runtime-override.test.mjs"
+      ]
     },
     {
       "id": "paper-fleet-golden-path",
@@ -398,6 +478,13 @@
       "contracts": [
         "dist/site/cli-registry.json",
         "dist/site/node-api-registry.json"
+      ],
+      "generatedOutputs": [
+        "dist/site/cli-registry.json",
+        "dist/site/node-api-registry.json"
+      ],
+      "validationCommands": [
+        "node --test tests/cli.test.mjs tests/paper.test.mjs tests/public-surface-audit.test.mjs"
       ]
     },
     {
@@ -418,6 +505,13 @@
         "docs/release-propagation.md",
         "dist/site/cli-registry.json",
         "dist/site/node-api-registry.json"
+      ],
+      "generatedOutputs": [
+        "dist/site/cli-registry.json",
+        "dist/site/node-api-registry.json"
+      ],
+      "validationCommands": [
+        "node --test tests/release-propagation.test.mjs tests/release-propagation-pickup.test.mjs"
       ]
     },
     {
@@ -438,6 +532,10 @@
         "contracts/engineering-housekeeper-v1.schema.json",
         "contracts/fixtures/engineering-housekeeper-v1/cases.json",
         "docs/engineering-housekeeper.md"
+      ],
+      "generatedOutputs": [],
+      "validationCommands": [
+        "node --test tests/engineering-housekeeper.test.mjs tests/engineering-housekeeper-github.test.mjs tests/engineering-housekeeper-workflow.test.mjs"
       ]
     },
     {
@@ -460,6 +558,30 @@
         ".github/workflows/release-tail.yml",
         "actions/release-tail/action.yml",
         "docs/release-tail-provider-plane.md"
+      ],
+      "generatedOutputs": ["actions/release-tail/dist/index.js"],
+      "validationCommands": [
+        "node --test tests/release-tail-provider-plane.test.mjs tests/release-tail-contract.test.mjs"
+      ]
+    },
+    {
+      "id": "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"
+      ],
+      "tests": ["tests/v4-publication-rehearsal.test.mjs"],
+      "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"
+      ],
+      "generatedOutputs": [],
+      "validationCommands": [
+        "node --test tests/v4-publication-rehearsal.test.mjs"
       ]
     },
     {
@@ -522,6 +644,12 @@
         "templates/native-dev-delivery.yml",
         "docs/dev-delivery-warrant.md",
         "docs/dev-delivery-qualification-landing-adr.md"
+      ],
+      "generatedOutputs": [
+        "dist/site/schemas/dev-delivery-authority-v2.schema.json"
+      ],
+      "validationCommands": [
+        "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"
       ]
     },
     {
@@ -546,6 +674,56 @@
         "contracts/fixtures/v4-compatibility-facts-v1/shared.json",
         "dist/site/schemas/v4-compatibility-facts-v1.schema.json",
         "docs/v4-compatibility-facts.md"
+      ],
+      "generatedOutputs": [
+        "dist/site/schemas/v4-compatibility-facts-v1.schema.json"
+      ],
+      "validationCommands": [
+        "node --test tests/v4-compatibility-facts.test.mjs"
+      ]
+    },
+    {
+      "id": "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"
+      ],
+      "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"
+      ],
+      "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"
+      ],
+      "generatedOutputs": [],
+      "validationCommands": [
+        "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"
       ]
     },
     {
@@ -562,7 +740,6 @@
         "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-adopter-delivery-parity.js",
         "packages/core/v4-runtime-ref-resume-authority.js",
         "packages/core/v4-runtime-selector-persistence.js",
         "packages/core/v4-tail-reseal-contract.js",
@@ -588,8 +765,7 @@
         "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",
-        "crates/buildchain-v4-contracts/src/adopter_delivery.rs"
+        "crates/buildchain-v4-contracts/src/partial_mutation_recovery.rs"
       ],
       "tests": [
         "tests/v4-architecture.test.mjs",
@@ -603,7 +779,6 @@
         "tests/v4-stage-capsule-store.test.mjs",
         "tests/v4-platform-stage-checkpoints.test.mjs",
         "tests/v4-stage-capsule-qualification.test.mjs",
-        "tests/v4-adopter-delivery-parity.test.mjs",
         "tests/v4-runtime-ref-resume-authority.test.mjs",
         "tests/v4-tail-reseal.test.mjs",
         "tests/v4-tail-reseal-parity.test.mjs"
@@ -623,7 +798,6 @@
         "architecture/v4-stage-capsule-store-contract.json",
         "architecture/v4-platform-stage-checkpoints.json",
         "architecture/v4-stage-capsule-qualification.json",
-        "architecture/v4-adopter-delivery-parity.json",
         "architecture/v4-runtime-ref-resume-authority.json",
         "contracts/v4-host-contract-v1.schema.json",
         "contracts/v4-provider-operation-journal-v1.schema.json",
@@ -648,6 +822,37 @@
         "docs/v4-stage-capsule.md",
         "docs/v4-runtime-ref-resume-authority.md",
         "docs/v4-tail-reseal.md"
+      ],
+      "generatedOutputs": [],
+      "validationCommands": [
+        "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"
+      ]
+    },
+    {
+      "id": "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"
+      ],
+      "tests": [
+        "tests/internal-architecture.test.mjs",
+        "tests/maintainability.test.mjs",
+        "tests/maintainability-governance.test.mjs"
+      ],
+      "contracts": [
+        "architecture/internal-capabilities.json",
+        "architecture/maintainability-debt.json",
+        "architecture/maintainability-policy.json"
+      ],
+      "generatedOutputs": ["architecture/agent-change-map.md"],
+      "validationCommands": [
+        "node --test tests/internal-architecture.test.mjs tests/maintainability.test.mjs tests/maintainability-governance.test.mjs",
+        "node scripts/generate-agent-change-map.mjs"
       ]
     }
   ]