@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.
- package/AGENTS.md +12 -19
- package/CONTRIBUTING.md +6 -9
- package/README.md +11 -1
- package/architecture/agent-change-map.md +11 -4
- package/architecture/build-environments.json +71 -0
- package/architecture/build-orchestration.json +18 -0
- package/architecture/ci-lane-change-budget.json +51 -2
- package/architecture/internal-capabilities.json +17 -4
- package/architecture/maintainability-debt.json +37 -126
- package/architecture/maintainability-policy.json +19 -210
- package/architecture/release-topology.json +9 -7
- package/architecture/universal-workflow-bootstrap.json +5 -4
- package/architecture/universal-workflow-train-admission.json +2 -2
- package/architecture/workflow-taxonomy.json +13 -0
- package/bin/buildchain.mjs +1 -1
- package/contracts/fixtures/v4-tail-reseal-v1/valid.json +1 -1
- package/dist/site/buildchain-contract.json +41 -1131
- package/dist/site/buildchain-site.json +48 -153
- package/dist/site/capability-registry.json +2 -2
- package/dist/site/cli-registry.json +1 -1
- package/dist/site/controller-registry.json +30 -868
- package/dist/site/kfd-claims.json +148 -396
- package/dist/site/kfd-upstream-aggregate.json +1 -1
- package/dist/site/manual-registry.json +7 -7
- package/dist/site/node-api-registry.json +37 -37
- package/dist/site/page-registry.json +36 -141
- package/dist/site/public-surface-audit.json +93 -402
- package/dist/site/publication-authority-registry.json +22 -1
- package/dist/site/publication-registry.json +4 -4
- package/dist/site/site-manifest.json +11 -11
- package/dist/site/workflow-registry.json +165 -391
- package/docs/MAP.md +5 -4
- package/docs/cli-reference.md +1 -1
- package/docs/getting-started.md +8 -7
- package/docs/node-api-reference.md +85 -85
- package/docs/release-governance.md +19 -18
- package/docs/reusable-build-surface.md +160 -1430
- package/docs/runtime-train-validation.md +45 -172
- package/docs/workflow-catalog.md +1 -0
- package/package.json +1 -1
- package/packages/core/build-configuration.js +117 -0
- package/packages/core/buildchain-config.js +2 -0
- package/packages/core/buildchain-contract.js +14 -44
- package/packages/core/buildchain-publication-authority.js +1 -0
- package/packages/core/controller-evidence.js +2 -9
- package/scripts/buildchain-cli-help.mjs +1 -1
- package/scripts/check-floating-consumer-policy-contract.mjs +4 -7
- package/scripts/check-inventory.mjs +91 -77
- package/scripts/check-maintainability.mjs +23 -8
- package/scripts/check-universal-workflow-bootstrap.mjs +12 -2
- package/scripts/generate-channel-build-workflow.mjs +50 -410
- package/scripts/generate-site-bundle.mjs +2 -1
- package/scripts/generate-universal-workflow-facades.mjs +1 -0
- package/scripts/init-repo.mjs +25 -26
- package/scripts/resolve-build-configuration.mjs +105 -0
- package/scripts/universal-workflow-self-dogfood.mjs +8 -1
- 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-
|
|
11
|
+
last_reviewed: 2026-09-08
|
|
12
12
|
ai_provenance:
|
|
13
|
-
model_family: GPT-
|
|
13
|
+
model_family: GPT-6
|
|
14
14
|
product: Codex
|
|
15
|
-
generated_at: 2026-
|
|
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
|
|
246
|
+
### Buildchain public build self-dogfood
|
|
247
247
|
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
`
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
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
|
|
721
|
-
|
|
|
722
|
-
| `.github/workflows/patrol-daily.yml`
|
|
723
|
-
| `.github/workflows/patrol-weekly.yml`
|
|
724
|
-
| `.github/workflows/patrol-monthly.yml`
|
|
725
|
-
| `.github/workflows/patrol-observed-evidence.yml` | caller-selected schedule
|
|
726
|
-
| `.github/workflows/stable-candidate-patrol.yml`
|
|
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
|
|