@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
package/architecture/universal-workflow-bootstrap.json CHANGED
@@ -116,7 +116,6 @@
116
116
  "bootstrapGovernedWorkflows": [
117
117
  ".github/workflows/.auditable-demo.yml",
118
118
  ".github/workflows/.binary-release-assets.yml",
119
- ".github/workflows/.build.yml",
120
119
  ".github/workflows/.bump-minor-version.yml",
121
120
  ".github/workflows/.declarative-auditable-demo.yml",
122
121
  ".github/workflows/.gate-profile.yml",
@@ -129,7 +128,6 @@
129
128
  ".github/workflows/.web-surface.yml",
130
129
  ".github/workflows/.wheel-verify.yml",
131
130
  ".github/workflows/bootstrap.yml",
132
- ".github/workflows/build.yml",
133
131
  ".github/workflows/buildchain-patrol.yml",
134
132
  ".github/workflows/check.yml",
135
133
  ".github/workflows/dev-alpha-candidate-patrol.yml",
@@ -160,7 +158,6 @@
160
158
  "compatibilityFacadeGenerator": "scripts/generate-universal-workflow-facades.mjs",
161
159
  "facadeSourceRevision": "06a2d9f7d5753c5c9b2bf0e7f0e3220fc18cc183",
162
160
  "channelGeneratedFacades": [
163
- ".github/workflows/build.yml",
164
161
  ".github/workflows/release-candidate-promote.yml"
165
162
  ],
166
163
  "staticBootstrap": "implemented",
@@ -172,5 +169,9 @@
172
169
  "postMigrationWorkflows": [
173
170
  ".github/workflows/public-release-oci-compose-preview.yml"
174
171
  ]
175
- }
172
+ },
173
+ "configurationGovernedWorkflows": [
174
+ ".github/workflows/.build.yml",
175
+ ".github/workflows/build.yml"
176
+ ]
176
177
  }
package/architecture/universal-workflow-train-admission.json CHANGED
@@ -24,10 +24,10 @@
24
24
  },
25
25
  "contractRoots": [
26
26
  "sha256:19034e431506e219bec09851b0adb0e5ee6d1798528d2369f3f60b3f1bf2a8bf",
27
- "sha256:20d48eff5e9eac02d552a1cbdb76f01e2b5addec798260ab43c0102ebf630f4b",
28
27
  "sha256:348955860bd0c5f5486c48be2e6c8553b50afa0be96699eff1b3dba914e7f80d",
29
28
  "sha256:5e922ecc5f5b7b17a67ccd73be1eb73ae9db886a9da439dbef942b5e2d80062b",
30
- "sha256:b5d0050d17f2302e337dbbc9ad9bc07012d41b575cbca59123af5ae9df157579",
29
+ "sha256:639d7e151d7cccbdaab34ca7e2e5dfe10c5705e5a4d559f87fd4e688b291590b",
30
+ "sha256:803309167edeb5f2db25e3b7aa5d83d813d8b0912fdec2f1d307b9812d1564cf",
31
31
  "sha256:bab725233283c317972f383bcdd7c72725a1b46d96aa732e117f042b4bd313e9",
32
32
  "sha256:bbc0b1317f612b81ba3e462eab5a5ed2e0549ced6918fdc9b58b3dd14dc3db19"
33
33
  ],
package/architecture/workflow-taxonomy.json CHANGED
@@ -441,6 +441,19 @@
441
441
  "compatibility": null,
442
442
  "rationale": "Classify the existing .github/workflows/buildchain-alpha-self-dogfood.yml capability without adding execution behavior."
443
443
  },
444
+ {
445
+ "id": "buildchain-stable-self-dogfood",
446
+ "role": "self",
447
+ "category": "build",
448
+ "purpose": "stable-dogfood",
449
+ "summary": "Buildchain Stable Self-Dogfood",
450
+ "owner": "kungfu-origin",
451
+ "status": "active",
452
+ "invocation": "repository",
453
+ "migration": null,
454
+ "compatibility": null,
455
+ "rationale": "Independently qualify the published stable TOML build contract with a nested project locator."
456
+ },
444
457
  {
445
458
  "id": "buildchain-candidate-recovery-dogfood-failure",
446
459
  "role": "self",
package/bin/buildchain.mjs CHANGED
@@ -1344,7 +1344,7 @@ async function handleInitCommand(args) {
1344
1344
  force: readBooleanFlag(args, "force"),
1345
1345
  packageManager: readFlag(args, "package-manager", ""),
1346
1346
  runnerPreset: readFlag(args, "runner-preset", "github-hosted"),
1347
- artifactName: readFlag(args, "artifact-name", "{repo}-{version}-{platform}"),
1347
+ artifactName: readFlag(args, "artifact-name", ""),
1348
1348
  });
1349
1349
  printJson(result);
1350
1350
  return;
package/contracts/fixtures/v4-tail-reseal-v1/valid.json CHANGED
@@ -22,7 +22,7 @@
22
22
  "ref": "v4-alpha",
23
23
  "sha": "dddddddddddddddddddddddddddddddddddddddd",
24
24
  "contractRoot": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
25
- "consumerPolicyReceiptRoot": "sha256:acee2edcda59dfaf5fc0dd5877b7a20405fc6e0fa419abdd279a68aef32a0e5c"
25
+ "consumerPolicyReceiptRoot": "sha256:f80e32e2fcba14a942ead6eea5d34f7d208b9c1fa6012977a35f901a1081c9c0"
26
26
  },
27
27
  "warrant": {
28
28
  "candidateId": "candidate-alpha-2",