@kungfu-tech/buildchain 4.0.8 → 4.0.9-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/AGENTS.md +12 -19
  2. package/CONTRIBUTING.md +6 -9
  3. package/README.md +11 -1
  4. package/architecture/agent-change-map.md +11 -4
  5. package/architecture/build-environments.json +71 -0
  6. package/architecture/build-orchestration.json +18 -0
  7. package/architecture/ci-lane-change-budget.json +51 -2
  8. package/architecture/internal-capabilities.json +17 -4
  9. package/architecture/maintainability-debt.json +37 -126
  10. package/architecture/maintainability-policy.json +19 -210
  11. package/architecture/release-topology.json +9 -7
  12. package/architecture/universal-workflow-bootstrap.json +5 -4
  13. package/architecture/universal-workflow-train-admission.json +2 -2
  14. package/architecture/workflow-taxonomy.json +13 -0
  15. package/bin/buildchain.mjs +1 -1
  16. package/contracts/fixtures/v4-tail-reseal-v1/valid.json +1 -1
  17. package/dist/site/buildchain-contract.json +41 -1131
  18. package/dist/site/buildchain-site.json +48 -153
  19. package/dist/site/capability-registry.json +2 -2
  20. package/dist/site/cli-registry.json +1 -1
  21. package/dist/site/controller-registry.json +30 -868
  22. package/dist/site/kfd-claims.json +148 -396
  23. package/dist/site/kfd-upstream-aggregate.json +1 -1
  24. package/dist/site/manual-registry.json +7 -7
  25. package/dist/site/node-api-registry.json +37 -37
  26. package/dist/site/page-registry.json +36 -141
  27. package/dist/site/public-surface-audit.json +93 -402
  28. package/dist/site/publication-authority-registry.json +22 -1
  29. package/dist/site/publication-registry.json +4 -4
  30. package/dist/site/site-manifest.json +11 -11
  31. package/dist/site/workflow-registry.json +165 -391
  32. package/docs/MAP.md +5 -4
  33. package/docs/cli-reference.md +1 -1
  34. package/docs/getting-started.md +8 -7
  35. package/docs/node-api-reference.md +85 -85
  36. package/docs/release-governance.md +19 -18
  37. package/docs/reusable-build-surface.md +160 -1430
  38. package/docs/runtime-train-validation.md +45 -172
  39. package/docs/workflow-catalog.md +1 -0
  40. package/package.json +1 -1
  41. package/packages/core/build-configuration.js +117 -0
  42. package/packages/core/buildchain-config.js +2 -0
  43. package/packages/core/buildchain-contract.js +14 -44
  44. package/packages/core/buildchain-publication-authority.js +1 -0
  45. package/packages/core/controller-evidence.js +2 -9
  46. package/scripts/buildchain-cli-help.mjs +1 -1
  47. package/scripts/check-floating-consumer-policy-contract.mjs +4 -7
  48. package/scripts/check-inventory.mjs +91 -77
  49. package/scripts/check-maintainability.mjs +23 -8
  50. package/scripts/check-universal-workflow-bootstrap.mjs +12 -2
  51. package/scripts/generate-channel-build-workflow.mjs +50 -410
  52. package/scripts/generate-site-bundle.mjs +2 -1
  53. package/scripts/generate-universal-workflow-facades.mjs +1 -0
  54. package/scripts/init-repo.mjs +25 -26
  55. package/scripts/resolve-build-configuration.mjs +105 -0
  56. package/scripts/universal-workflow-self-dogfood.mjs +8 -1
  57. package/scripts/verify-golden-path.mjs +3 -3
@@ -8,11 +8,11 @@ confidence: high
8
8
  sensitivity: public
9
9
  evidence_grade: A
10
10
  review_state: unreviewed
11
- last_reviewed: 2026-07-31
11
+ last_reviewed: 2026-09-08
12
12
  ai_provenance:
13
- model_family: GPT-5
13
+ model_family: GPT-6
14
14
  product: Codex
15
- generated_at: 2026-07-27
15
+ generated_at: 2026-09-08
16
16
  invisible_context: not asserted
17
17
  ---
18
18
 
@@ -243,15 +243,16 @@ This keeps the test channel self-describing. If a consumer checks out
243
243
  alpha ref removes routine consumer edits when Buildchain opens a newer minor,
244
244
  while exact tags and SHAs remain the reproducible audit choice.
245
245
 
246
- ### Buildchain Alpha Self-Dogfood
246
+ ### Buildchain public build self-dogfood
247
247
 
248
- Buildchain continuously consumes its own current major alpha through
249
- `.github/workflows/self-build-alpha-dogfood.yml`. Both lanes call the
250
- released channel router at `build.yml@v3-alpha`. The auto lane must resolve
251
- `v3-alpha`; the explicit stable lane must resolve `v3`. Both execute the same
252
- declared install, build, and verify fixture, proving that a single consumer
253
- surface routes to distinct released runtimes without duplicating lifecycle
254
- configuration in the consumer.
248
+ Two independent thin workflows continuously qualify the published channels.
249
+ `self-build-alpha-dogfood.yml` calls `build.yml@v4-alpha` with zero inputs and
250
+ runs the root project's real install, build, and verify lifecycle.
251
+ `self-build-stable-dogfood.yml` calls `build.yml@v4` with only the nested fixture's
252
+ `config-path`, including native and Linux container builds. Project settings
253
+ live in TOML; the called workflow binds its exact runtime SHA and configuration
254
+ root into the build receipts. Separate workflow validation allows each channel
255
+ to advance independently during a breaking producer-first release.
255
256
 
256
257
  Buildchain's generic artifact-signing contract seals source-, tree-, runtime-,
257
258
  platform-, and digest-bound requests from ordinary credential-free build jobs.
@@ -717,13 +718,13 @@ status to failure, while the merge group must still produce its own final check.
717
718
  that want a stable day-to-day operations contract, Buildchain also exposes a
718
719
  patrol workflow family:
719
720
 
720
- | Workflow | Intended cadence | Default intent |
721
- | --- | --- | --- |
722
- | `.github/workflows/patrol-daily.yml` | daily | lightweight inspection plus ready dev PR maintenance |
723
- | `.github/workflows/patrol-weekly.yml` | weekly | release-state, passport, gate, and stale-state health checks as they are added |
724
- | `.github/workflows/patrol-monthly.yml` | monthly | governance, permission, branch-protection, and workflow drift checks as they are added |
725
- | `.github/workflows/patrol-observed-evidence.yml` | caller-selected schedule | validated immutable observation plus atomic last-known-good publication; no per-refresh PR |
726
- | `.github/workflows/stable-candidate-patrol.yml` | repository-selected release window | qualify immutable alpha candidates and open the exact source-lock stable PR |
721
+ | Workflow | Intended cadence | Default intent |
722
+ | ------------------------------------------------ | ---------------------------------- | ------------------------------------------------------------------------------------------ |
723
+ | `.github/workflows/patrol-daily.yml` | daily | lightweight inspection plus ready dev PR maintenance |
724
+ | `.github/workflows/patrol-weekly.yml` | weekly | release-state, passport, gate, and stale-state health checks as they are added |
725
+ | `.github/workflows/patrol-monthly.yml` | monthly | governance, permission, branch-protection, and workflow drift checks as they are added |
726
+ | `.github/workflows/patrol-observed-evidence.yml` | caller-selected schedule | validated immutable observation plus atomic last-known-good publication; no per-refresh PR |
727
+ | `.github/workflows/stable-candidate-patrol.yml` | repository-selected release window | qualify immutable alpha candidates and open the exact source-lock stable PR |
727
728
 
728
729
  The cadence names describe patrol intensity, not release cadence:
729
730