@kungfu-tech/buildchain 3.0.9-alpha.8 → 4.0.0-alpha.0

package/architecture/internal-capabilities.json

@@ -0,0 +1,502 @@
+{
+  "schemaVersion": 1,
+  "coverageRoots": [
+    "actions/promote-buildchain-ref/internal",
+    "bin/buildchain.mjs",
+    "bin/internal",
+    "packages/core/release-passport.js",
+    "packages/core/buildchain-contract.js",
+    "packages/core/workflow-call-contract.js",
+    "packages/core/workflow-yaml-contract.js",
+    "packages/core/paper-fleet.js",
+    "packages/core/paper-agent-entry.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",
+    "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",
+    "packages/core/engineering-housekeeper.js",
+    "packages/core/engineering-housekeeper-github-client.js",
+    "packages/core/engineering-housekeeper-github.js",
+    "packages/core/release-tail-provider-plane.js",
+    "packages/core/release-tail-provider-adapters.js",
+    "packages/core/release-tail-compatibility.js",
+    "actions/release-tail/index.js",
+    "scripts/authorize-promotion-runtime-override.cjs",
+    "scripts/build-contract-core.mjs",
+    "scripts/buildchain-cli-help.mjs",
+    "scripts/generate-channel-build-workflow.mjs",
+    "scripts/promotion-routing-evidence.mjs",
+    "scripts/paper-work-fleet-cli.mjs",
+    "scripts/run-lifecycle-core.mjs",
+    "scripts/resolve-artifact-transfer-mode.mjs",
+    "scripts/release-propagation.mjs",
+    "scripts/engineering-housekeeper-workflow.mjs",
+    "scripts/release-tail.mjs",
+    "scripts/web-surface-core.mjs",
+    "scripts/web-surface-routing.mjs",
+    "scripts/web-surface.mjs",
+    "scripts/workflow-call-contract.mjs",
+    "scripts/verify-promotion-router-binding.sh",
+    "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-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",
+    "packages/core/v4-provider-readback-idempotency.js",
+    "crates/buildchain-v4-contracts/src/provider_readback_idempotency.rs",
+    "packages/core/v4-release-activation-shadow.js",
+    "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",
+    "packages/core/v4-stable-publication-fence.js",
+    "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/v4-adopter-delivery-parity.js",
+    "crates/buildchain-v4-contracts/src/adopter_delivery.rs"
+  ],
+  "ownershipRules": [
+    {
+      "id": "action-runtime-sources",
+      "owner": "Buildchain action maintainers",
+      "paths": ["actions"]
+    },
+    {
+      "id": "cli-sources",
+      "owner": "Buildchain CLI maintainers",
+      "paths": ["bin"]
+    },
+    {
+      "id": "fixture-sources",
+      "owner": "Buildchain fixture maintainers",
+      "paths": ["fixtures"]
+    },
+    {
+      "id": "core-library-sources",
+      "owner": "Buildchain core maintainers",
+      "paths": ["packages/core"]
+    },
+    {
+      "id": "workflow-runtime-sources",
+      "owner": "Buildchain workflow maintainers",
+      "paths": ["scripts"]
+    },
+    {
+      "id": "v4-rust-domain-sources",
+      "owner": "Buildchain architecture maintainers",
+      "paths": ["crates"]
+    }
+  ],
+  "ownershipExclusions": [],
+  "dependencyRules": [
+    {
+      "id": "core-does-not-depend-on-delivery-surfaces",
+      "sources": ["packages/core"],
+      "allowedRelativeTargets": ["packages/core"]
+    },
+    {
+      "id": "promotion-internals-do-not-depend-on-facade",
+      "sources": ["actions/promote-buildchain-ref/internal"],
+      "allowedRelativeTargets": [
+        "actions/promote-buildchain-ref/internal",
+        "packages/core"
+      ]
+    },
+    {
+      "id": "cli-handlers-do-not-depend-on-entrypoint",
+      "sources": ["bin/internal"],
+      "allowedRelativeTargets": ["bin/internal", "packages/core", "scripts"]
+    },
+    {
+      "id": "workflow-helpers-stay-below-workflow-delivery",
+      "sources": [
+        "scripts/promotion-routing-evidence.mjs",
+        "scripts/authorize-promotion-runtime-override.cjs"
+      ],
+      "allowedRelativeTargets": ["packages/core", "scripts"]
+    }
+  ],
+  "capabilities": [
+    {
+      "id": "promotion-policy",
+      "owner": "Buildchain maintainers",
+      "implementation": [
+        "actions/promote-buildchain-ref/internal/promotion-policy.js"
+      ],
+      "tests": [
+        "tests/promote-buildchain-ref.test.mjs",
+        "tests/promote-buildchain-ref-governance.test.mjs",
+        "tests/promotion-responsibilities.test.mjs"
+      ],
+      "contracts": [
+        "actions/promote-buildchain-ref/action.yml",
+        "actions/promote-buildchain-ref/lib.js"
+      ]
+    },
+    {
+      "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"
+      ],
+      "tests": [
+        "tests/promote-buildchain-ref.test.mjs",
+        "tests/promote-buildchain-ref-recovery.test.mjs",
+        "tests/release-impact-contract.test.mjs"
+      ],
+      "contracts": [
+        ".buildchain/release-impact.json",
+        "actions/promote-buildchain-ref/lib.js"
+      ]
+    },
+    {
+      "id": "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"
+      ],
+      "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"]
+    },
+    {
+      "id": "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"
+      ],
+      "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"
+      ],
+      "contracts": [
+        "actions/promote-buildchain-ref/action.yml",
+        "actions/promote-buildchain-ref/lib.js"
+      ]
+    },
+    {
+      "id": "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"
+      ],
+      "tests": ["tests/cli.test.mjs", "tests/public-surface-audit.test.mjs"],
+      "contracts": ["bin/buildchain.mjs", "docs/cli.md"]
+    },
+    {
+      "id": "release-workflow-promotion-routing",
+      "owner": "Buildchain maintainers",
+      "implementation": [
+        "scripts/promotion-routing-evidence.mjs",
+        "scripts/verify-promotion-router-binding.sh"
+      ],
+      "tests": [
+        "tests/promotion-routing-evidence.test.mjs",
+        "tests/build-surface.test.mjs",
+        "tests/build-surface-promotion.test.mjs"
+      ],
+      "contracts": [
+        ".github/workflows/.release-candidate-promote.yml",
+        ".github/workflows/release-candidate-promote.yml"
+      ]
+    },
+    {
+      "id": "release-passport-verification",
+      "owner": "Buildchain release trust maintainers",
+      "implementation": ["packages/core/release-passport.js"],
+      "tests": [
+        "tests/release-passport.test.mjs",
+        "tests/release-passport-contract.test.mjs"
+      ],
+      "contracts": [
+        "docs/release-passport.md",
+        "dist/site/release-passport-check-manifest.json"
+      ]
+    },
+    {
+      "id": "cli-command-registry",
+      "owner": "Buildchain CLI maintainers",
+      "implementation": [
+        "bin/buildchain.mjs",
+        "bin/internal/command-registry.mjs"
+      ],
+      "tests": ["tests/command-registry.test.mjs", "tests/cli.test.mjs"],
+      "contracts": ["docs/cli.md", "dist/site/cli-registry.json"]
+    },
+    {
+      "id": "reusable-build-orchestration",
+      "owner": "Buildchain workflow maintainers",
+      "implementation": [
+        "scripts/generate-channel-build-workflow.mjs",
+        "scripts/resolve-artifact-transfer-mode.mjs",
+        "scripts/run-lifecycle-core.mjs"
+      ],
+      "tests": [
+        "tests/artifact-transfer-mode.test.mjs",
+        "tests/build-surface.test.mjs",
+        "tests/build-surface-promotion.test.mjs",
+        "tests/controller-evidence.test.mjs"
+      ],
+      "contracts": [
+        ".github/workflows/.build.yml",
+        ".github/workflows/build.yml"
+      ]
+    },
+    {
+      "id": "web-surface-delivery",
+      "owner": "Buildchain web-surface maintainers",
+      "implementation": [
+        "scripts/web-surface-core.mjs",
+        "scripts/web-surface-routing.mjs",
+        "scripts/web-surface.mjs"
+      ],
+      "tests": [
+        "tests/web-surface.test.mjs",
+        "tests/web-surface-publication-authority.test.mjs"
+      ],
+      "contracts": [".github/workflows/.web-surface.yml"]
+    },
+    {
+      "id": "shared-build-contract",
+      "owner": "Buildchain contract maintainers",
+      "implementation": [
+        "packages/core/buildchain-contract.js",
+        "scripts/build-contract-core.mjs"
+      ],
+      "tests": [
+        "tests/buildchain-contract.test.mjs",
+        "tests/build-surface.test.mjs",
+        "tests/build-surface-promotion.test.mjs"
+      ],
+      "contracts": [
+        "dist/site/buildchain-contract.json",
+        "docs/runtime-train-validation.md"
+      ]
+    },
+    {
+      "id": "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"
+      ],
+      "tests": [
+        "tests/workflow-call-contract.test.mjs",
+        "tests/public-surface-audit.test.mjs"
+      ],
+      "contracts": ["docs/release-governance.md"]
+    },
+    {
+      "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"]
+    },
+    {
+      "id": "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"
+      ],
+      "tests": [
+        "tests/cli.test.mjs",
+        "tests/paper.test.mjs",
+        "tests/public-surface-audit.test.mjs"
+      ],
+      "contracts": [
+        "dist/site/cli-registry.json",
+        "dist/site/node-api-registry.json"
+      ]
+    },
+    {
+      "id": "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"
+      ],
+      "tests": [
+        "tests/release-propagation.test.mjs",
+        "tests/release-propagation-pickup.test.mjs"
+      ],
+      "contracts": [
+        "docs/release-propagation.md",
+        "dist/site/cli-registry.json",
+        "dist/site/node-api-registry.json"
+      ]
+    },
+    {
+      "id": "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"
+      ],
+      "tests": [
+        "tests/engineering-housekeeper.test.mjs",
+        "tests/engineering-housekeeper-github.test.mjs",
+        "tests/engineering-housekeeper-workflow.test.mjs"
+      ],
+      "contracts": [
+        "contracts/engineering-housekeeper-v1.schema.json",
+        "contracts/fixtures/engineering-housekeeper-v1/cases.json",
+        "docs/engineering-housekeeper.md"
+      ]
+    },
+    {
+      "id": "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"
+      ],
+      "tests": [
+        "tests/release-tail-provider-plane.test.mjs",
+        "tests/release-tail-contract.test.mjs"
+      ],
+      "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"
+      ]
+    },
+    {
+      "id": "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-adopter-delivery-parity.js",
+        "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",
+        "crates/buildchain-v4-contracts/src/adopter_delivery.rs"
+      ],
+      "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-adopter-delivery-parity.test.mjs"
+      ],
+      "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-adopter-delivery-parity.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",
+        "docs/v4-stage-capsule.md"
+      ]
+    }
+  ]
+}

package/architecture/maintainability-baseline.json

@@ -0,0 +1,59 @@
+{
+  "schemaVersion": 1,
+  "contract": "kungfu-buildchain-maintainability-baseline",
+  "revision": "5308189b09bcb5a1314195412f2807a40d678838",
+  "collectedOn": "2026-08-01",
+  "sourceEvolution": {
+    "assignmentBaselineRevision": "3e63a39cfa44ff4a923ec97baa3fe778eda212ec",
+    "reason": "The protected dev/v3/v3.0 channel advanced through reviewed Paper, signing, build aggregation, and auditable-demo work after Assignment capture. The structural line therefore starts from the later protected head instead of replaying an obsolete cut."
+  },
+  "repository": {
+    "trackedFiles": 661,
+    "handMaintainedSourceFiles": 208,
+    "handMaintainedSourceLines": 87250,
+    "testFiles": 87,
+    "testLines": 50923,
+    "workflowFiles": 57,
+    "workflowLines": 19269,
+    "documentationFiles": 71,
+    "documentationLines": 15552,
+    "generatedFiles": 7,
+    "generatedBytes": 3876580
+  },
+  "publicSurface": {
+    "cliCommands": 112,
+    "nodeApiExports": 46,
+    "workflows": 57,
+    "actions": 6,
+    "reverseAuditFailures": 0
+  },
+  "architecture": {
+    "capabilities": 12,
+    "implementationMappings": 24,
+    "testMappings": 24,
+    "dependencyRules": 4,
+    "repositorySources": 208,
+    "ownedSources": 0,
+    "excludedSources": 0,
+    "dependencyEdges": 142,
+    "dependencyCycles": 0
+  },
+  "hotspots": {
+    "promoteBuildchainRefs": {
+      "file": "actions/promote-buildchain-ref/lib.js",
+      "lines": 341,
+      "complexity": 26
+    },
+    "createReleaseCheckReport": {
+      "file": "packages/core/release-passport.js",
+      "lines": 65,
+      "complexity": 5
+    }
+  },
+  "doneCheck": {
+    "command": "pnpm run check",
+    "tests": 1092,
+    "skipped": 0,
+    "wallSeconds": 36.9
+  }
+}