@kungfu-tech/buildchain 4.1.0-alpha.0 → 4.1.0-alpha.2

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 (295) hide show
  1. package/AGENTS.md +30 -41
  2. package/CONTRIBUTING.md +6 -7
  3. package/architecture/action-taxonomy.json +5 -21
  4. package/architecture/agent-change-map.md +74 -56
  5. package/architecture/build-orchestration.json +8 -1
  6. package/architecture/ci-lane-change-budget.json +179 -69
  7. package/architecture/floating-consumer-policy.json +7 -17
  8. package/architecture/internal-capabilities.json +58 -72
  9. package/architecture/maintainability-debt.json +138 -52
  10. package/architecture/maintainability-policy.json +6 -15
  11. package/architecture/promotion-job-topology.json +39 -20
  12. package/architecture/release-topology.json +26 -37
  13. package/architecture/runtime-entry.json +26 -0
  14. package/architecture/runtime-resume-lineage.json +23 -0
  15. package/architecture/stage-capsule-qualification.json +2 -2
  16. package/architecture/universal-workflow-bootstrap.json +10 -25
  17. package/architecture/universal-workflow-capability-policy.json +61 -0
  18. package/architecture/universal-workflow-fault-campaign.json +18 -24
  19. package/architecture/workflow-taxonomy.json +0 -11
  20. package/contracts/fixtures/{v4-runtime-ref-resume-authority-v1 → runtime-resume-lineage-v2}/scenario.json +2 -3
  21. package/contracts/fixtures/v4-floating-consumer-policy-v1/cases.json +2 -2
  22. package/contracts/fixtures/v4-tail-reseal-v1/valid.json +1 -1
  23. package/contracts/promotion-invocation-v1.schema.json +0 -44
  24. package/contracts/promotion-request-v1.schema.json +0 -39
  25. package/contracts/runtime-resume-lineage-v2.schema.json +182 -0
  26. package/dist/site/buildchain-contract.json +472 -361
  27. package/dist/site/buildchain-site.json +99 -99
  28. package/dist/site/capability-registry.json +3 -3
  29. package/dist/site/cli-registry.json +4 -4
  30. package/dist/site/controller-registry.json +94 -78
  31. package/dist/site/kfd-claims.json +224 -343
  32. package/dist/site/kfd-upstream-aggregate.json +1 -1
  33. package/dist/site/manual-registry.json +15 -15
  34. package/dist/site/node-api-registry.json +239 -354
  35. package/dist/site/page-registry.json +80 -80
  36. package/dist/site/public-surface-audit.json +203 -254
  37. package/dist/site/publication-authority-registry.json +1 -24
  38. package/dist/site/publication-registry.json +4 -4
  39. package/dist/site/release-provenance.json +1 -1
  40. package/dist/site/site-manifest.json +19 -19
  41. package/dist/site/workflow-registry.json +197 -357
  42. package/docs/MAP.md +3 -3
  43. package/docs/auditable-demo.md +4 -4
  44. package/docs/cli-reference.md +2 -2
  45. package/docs/code-organization.md +5 -4
  46. package/docs/controller-evidence.md +2 -2
  47. package/docs/dev-alpha-candidate-patrol.md +5 -5
  48. package/docs/dev-delivery-warrant.md +14 -24
  49. package/docs/engineering-housekeeper.md +3 -3
  50. package/docs/github-artifact-attestation.md +9 -12
  51. package/docs/github-governance-authority.md +4 -4
  52. package/docs/node-api-reference.md +153 -167
  53. package/docs/publication-artifacts.md +3 -4
  54. package/docs/publication-authority.md +2 -2
  55. package/docs/release-candidate.md +21 -27
  56. package/docs/release-governance.md +10 -10
  57. package/docs/release-promotion-request.md +11 -18
  58. package/docs/release-propagation.md +5 -6
  59. package/docs/release-tail-provider-plane.md +2 -3
  60. package/docs/reusable-build-surface.md +13 -7
  61. package/docs/runtime-entry.md +122 -0
  62. package/docs/runtime-train-validation.md +30 -41
  63. package/docs/v4-publication-rehearsal.md +5 -5
  64. package/docs/v4-stage-capsule.md +9 -10
  65. package/docs/web-surface-deployments.md +16 -20
  66. package/docs/workflow-catalog.md +0 -1
  67. package/package.json +6 -6
  68. package/packages/core/adoption/commands/init-repo.mjs +2 -2
  69. package/packages/core/adoption/cross-platform-adopter-qualification.js +2 -13
  70. package/packages/core/adoption/qualification/actions.js +3 -5
  71. package/packages/core/adoption/qualification/admission.js +2 -3
  72. package/packages/core/build/artifact/attestation.js +0 -1
  73. package/packages/core/build/artifact/contracts.js +1 -4
  74. package/packages/core/build/artifact/store.js +6 -5
  75. package/packages/core/build/artifact-signing.js +4 -10
  76. package/packages/core/build/binary/actions.js +15 -9
  77. package/packages/core/build/binary-publication-dispatch.js +2 -6
  78. package/packages/core/build/demo/action-context.js +2 -11
  79. package/packages/core/build/demo/binary-action.js +8 -10
  80. package/packages/core/build/gate/controller.js +0 -2
  81. package/packages/core/build/github-attestation/action.js +2 -7
  82. package/packages/core/build/github-attestation/admission.js +0 -8
  83. package/packages/core/build/github-attestation/transaction.js +1 -2
  84. package/packages/core/build/lifecycle/stage-action.js +2 -0
  85. package/packages/core/build/lifecycle/stage.js +6 -3
  86. package/packages/core/build/macos-credential-island/dmg-assembly.js +0 -2
  87. package/packages/core/build/macos-credential-island/lib.js +2 -6
  88. package/packages/core/build/plan/action-context.js +0 -7
  89. package/packages/core/build/plan/action.js +7 -11
  90. package/packages/core/build/plan/admission.js +6 -73
  91. package/packages/core/build/plan/configuration.js +1 -1
  92. package/packages/core/build/plan/environment.js +1 -1
  93. package/packages/core/build/plan/identity.js +1 -5
  94. package/packages/core/build/plan/resolve.js +7 -1
  95. package/packages/core/build/recovery/checkpoint.js +158 -0
  96. package/packages/core/build/recovery/transaction.js +51 -0
  97. package/packages/core/build/signing/authority-actions.js +2 -11
  98. package/packages/core/build/signing/control.js +0 -5
  99. package/packages/core/build/signing/controller-transaction.js +0 -1
  100. package/packages/core/build/signing/delegation.js +2 -4
  101. package/packages/core/build/signing/dispatch.js +10 -56
  102. package/packages/core/build/signing/intake.js +0 -4
  103. package/packages/core/build/signing/prepare.js +1 -1
  104. package/packages/core/build/signing/request.js +3 -8
  105. package/packages/core/build/source/checkout-action.js +6 -10
  106. package/packages/core/build/source/controller.js +1 -4
  107. package/packages/core/build/source/lifecycle.js +3 -13
  108. package/packages/core/build/stage-capsule/actions.js +3 -13
  109. package/packages/core/build/stage-capsule/campaign/resume.js +10 -5
  110. package/packages/core/build/stage-capsule/rehearsal/verify.js +3 -4
  111. package/packages/core/build/stage-capsule-resume-planner.js +0 -1
  112. package/packages/core/build/summary/aggregation.js +5 -5
  113. package/packages/core/build/summary/finalization.js +1 -1
  114. package/packages/core/build/verification/actions.js +3 -12
  115. package/packages/core/build/verification/runner.js +22 -20
  116. package/packages/core/consumer/floating-consumer-evidence.js +3 -21
  117. package/packages/core/consumer/floating-consumer-policy.js +2 -93
  118. package/packages/core/consumer/floating-consumer-release-passport.js +1 -34
  119. package/packages/core/consumer/policy-admission.js +1 -3
  120. package/packages/core/contracts/buildchain-contract.js +12 -146
  121. package/packages/core/contracts/workflow-yaml-contract.js +11 -1
  122. package/packages/core/dev-delivery/candidate/admission.js +3 -4
  123. package/packages/core/dev-delivery/candidate/coordinates.js +0 -8
  124. package/packages/core/dev-delivery/commands/dev-delivery-request.sh +5 -13
  125. package/packages/core/dev-delivery/commands/dev-delivery-source-proof-reuse.mjs +0 -3
  126. package/packages/core/dev-delivery/dev-delivery-contract-surface.js +4 -52
  127. package/packages/core/dev-delivery/dev-delivery-execution-transfer.js +2 -15
  128. package/packages/core/dev-delivery/native/action-context.js +4 -32
  129. package/packages/core/dev-delivery/native/provider-boundary.js +0 -2
  130. package/packages/core/dev-delivery/native/transactions.js +1 -2
  131. package/packages/core/dev-delivery/queue/reconciliation-action.js +6 -10
  132. package/packages/core/dev-delivery/source-proof/predicates.js +0 -6
  133. package/packages/core/dev-delivery/source-proof/reuse.js +0 -2
  134. package/packages/core/dev-delivery/source-proof/seal.js +0 -2
  135. package/packages/core/governance/alpha-candidate/action.js +1 -10
  136. package/packages/core/governance/audit/actions.js +1 -3
  137. package/packages/core/governance/audit/collection.js +1 -3
  138. package/packages/core/governance/audit/identity.js +3 -31
  139. package/packages/core/governance/audit/transactions.js +2 -4
  140. package/packages/core/governance/buildchain-publication-authority.js +0 -1
  141. package/packages/core/governance/commands/audit-github-governance.mjs +3 -2
  142. package/packages/core/governance/github-governance-authority.js +0 -5
  143. package/packages/core/governance/receipt-admission.js +0 -15
  144. package/packages/core/index.js +1 -1
  145. package/packages/core/observability/controller/identity.js +4 -5
  146. package/packages/core/observability/controller-evidence.js +5 -10
  147. package/packages/core/paper/commands/paper.mjs +6 -6
  148. package/packages/core/paper/operations/plans.js +2 -2
  149. package/packages/core/paper/operations/provisioning-validation.js +1 -1
  150. package/packages/core/paper/operations/scaffold-workflows.js +29 -12
  151. package/packages/core/paper/operations/scaffold.js +97 -69
  152. package/packages/core/paper/paper-agent-entry.js +0 -11
  153. package/packages/core/paper/paper-runtime-channels.js +21 -66
  154. package/packages/core/paper/paper-scaffold-content.js +1 -1
  155. package/packages/core/paper/paper.js +9 -5
  156. package/packages/core/paper/publication/candidate.js +0 -9
  157. package/packages/core/paper/publication-controller.js +2 -4
  158. package/packages/core/providers/github/artifact-attestation.js +1 -1
  159. package/packages/core/publication/authority/actions.js +9 -8
  160. package/packages/core/publication/authority/admission.js +0 -11
  161. package/packages/core/publication/authority/assembly.js +2 -7
  162. package/packages/core/publication/authority/control-plane.js +2 -2
  163. package/packages/core/publication/authority/governance.js +2 -9
  164. package/packages/core/publication/authority/request.js +7 -2
  165. package/packages/core/publication/authority/verification.js +3 -18
  166. package/packages/core/publication/binary/action.js +5 -7
  167. package/packages/core/publication/candidate/qualification-action.js +1 -6
  168. package/packages/core/publication/candidate/stage-capsules.js +1 -1
  169. package/packages/core/publication/npm/preview-action.js +9 -15
  170. package/packages/core/publication/oci/preview-actions.js +1 -10
  171. package/packages/core/publication/publication-artifact-candidate.js +2 -2
  172. package/packages/core/publication/publication-authority.js +2 -2
  173. package/packages/core/publication/publication-rehearsal-projection.js +3 -3
  174. package/packages/core/publication/settlement/actions.js +2 -11
  175. package/packages/core/release/binary/coordinates-action.js +0 -13
  176. package/packages/core/release/binary/coordinates.js +2 -19
  177. package/packages/core/release/commands/promotion-channel-router.mjs +12 -56
  178. package/packages/core/release/commands/resume-from-candidate-run.mjs +2 -3
  179. package/packages/core/release/dev-alpha-active-release-train.js +0 -5
  180. package/packages/core/release/line/action.js +2 -13
  181. package/packages/core/release/next-development/actions.js +2 -5
  182. package/packages/core/release/passport/consumer-validation.js +1 -28
  183. package/packages/core/release/promote-candidate/development-source.js +7 -8
  184. package/packages/core/release/promotion/actions.js +7 -38
  185. package/packages/core/release/promotion/admission.js +3 -50
  186. package/packages/core/release/promotion/candidate.js +2 -4
  187. package/packages/core/release/promotion/channel.js +13 -101
  188. package/packages/core/release/promotion/qualification-action.js +2 -13
  189. package/packages/core/release/promotion/routing.js +16 -81
  190. package/packages/core/release/promotion/selection.js +1 -9
  191. package/packages/core/release/promotion-request.js +1 -40
  192. package/packages/core/release/qualification/actions.js +0 -8
  193. package/packages/core/release/qualification/public-build.js +1 -1
  194. package/packages/core/release/recovery/candidate.js +15 -21
  195. package/packages/core/release/recovery/capsules.js +2 -10
  196. package/packages/core/release/recovery/lineage.js +305 -0
  197. package/packages/core/release/recovery/provenance.js +1 -2
  198. package/packages/core/release/recovery/publication.js +4 -14
  199. package/packages/core/release/recovery/readback.js +19 -32
  200. package/packages/core/release/recovery/runtime.js +4 -95
  201. package/packages/core/release/release-candidate-recovery.js +4 -9
  202. package/packages/core/release/release-candidate.js +2 -5
  203. package/packages/core/release/reseal/actions.js +3 -22
  204. package/packages/core/release/reseal/admission.js +0 -2
  205. package/packages/core/release/reseal/finalize-platform.js +0 -2
  206. package/packages/core/release/tail-reseal-github.js +1 -2
  207. package/packages/core/release/tail-reseal-receipt.js +0 -1
  208. package/packages/core/release/tail-reseal.js +2 -20
  209. package/packages/core/release/version-state.js +16 -13
  210. package/packages/core/runtime/buildchain-domain.wasm +0 -0
  211. package/packages/core/runtime/checkout-identity.js +0 -13
  212. package/packages/core/runtime/domain-wasm-artifact.js +2 -2
  213. package/packages/core/runtime/entry/actions.js +121 -0
  214. package/packages/core/runtime/entry/activation.js +86 -0
  215. package/packages/core/runtime/entry/github.js +55 -0
  216. package/packages/core/runtime/entry/recovery.js +37 -0
  217. package/packages/core/runtime/entry/selection.js +110 -0
  218. package/packages/core/web/controller.js +1 -1
  219. package/packages/core/web/publication-admission-action.js +1 -8
  220. package/packages/core/web/web-surface-publication-candidate.js +2 -5
  221. package/packages/core/workflow/admission/actions.js +6 -26
  222. package/packages/core/workflow/admission/recovery.js +3 -43
  223. package/packages/core/workflow/admission/transactions.js +8 -24
  224. package/packages/core/workflow/commands/buildchain-cli-help.mjs +1 -1
  225. package/packages/core/workflow/commands/universal-workflow-engine.mjs +2 -7
  226. package/packages/core/workflow/dogfood/actions.js +0 -17
  227. package/packages/core/workflow/engine/action.js +0 -5
  228. package/packages/core/workflow/engine/conformance.js +1 -1
  229. package/packages/core/workflow/engine/execution.js +2 -6
  230. package/packages/core/workflow/engine/identity.js +1 -6
  231. package/packages/core/workflow/engine/release-environment.js +11 -35
  232. package/packages/core/workflow/engine/release-promotion.js +2 -2
  233. package/packages/core/workflow/settlement/actions.js +0 -12
  234. package/packages/core/workflow/universal-self-dogfood.js +2 -16
  235. package/packages/core/workflow/universal-workflow-bootstrap.js +16 -241
  236. package/packages/core/workflow/workflow-taxonomy.mjs +2 -2
  237. package/scripts/check-dev-delivery-actions.mjs +17 -8
  238. package/scripts/check-floating-consumer-policy-contract.mjs +6 -6
  239. package/scripts/check-inventory.mjs +1 -10
  240. package/scripts/check-public-dogfood-contract.mjs +34 -21
  241. package/scripts/check-release-topology.mjs +2 -6
  242. package/scripts/check-runtime-entry.mjs +133 -0
  243. package/scripts/check-universal-workflow-bootstrap.mjs +45 -281
  244. package/scripts/check-workflows.sh +0 -7
  245. package/scripts/generate-bootstrap-admission.mjs +1 -1
  246. package/scripts/generate-channel-promotion-workflow.mjs +4 -4
  247. package/scripts/inventory/binary.mjs +4 -4
  248. package/scripts/inventory/promotion.mjs +5 -3
  249. package/scripts/runtime-source-boundaries.mjs +70 -0
  250. package/scripts/site-capability-metadata.mjs +2 -2
  251. package/scripts/workflow-action-graph.mjs +5 -18
  252. package/scripts/workflow-self-reference.mjs +20 -0
  253. package/templates/native-dev-delivery.yml +4 -4
  254. package/templates/universal-buildchain-bootstrap.yml +12 -2
  255. package/architecture/runtime-ref-resume-authority.json +0 -64
  256. package/architecture/universal-workflow-train-admission.json +0 -76
  257. package/contracts/v4-runtime-ref-resume-authority-v1.schema.json +0 -235
  258. package/docs/v4-runtime-ref-resume-authority.md +0 -69
  259. package/packages/core/consumer/channel-selection.js +0 -211
  260. package/packages/core/consumer/commands/buildchain-channel-router.mjs +0 -81
  261. package/packages/core/consumer/invocation-selector.js +0 -4
  262. package/packages/core/consumer/runtime-ref-resume-authority.js +0 -621
  263. package/packages/core/consumer/workflow-definition-authority.js +0 -64
  264. package/packages/core/contracts/runtime-contract-action.js +0 -48
  265. package/packages/core/release/commands/promotion-identity-resolver.mjs +0 -77
  266. package/packages/core/release/commands/verify-promotion-router-binding.sh +0 -36
  267. package/packages/core/release/promotion/identities.js +0 -56
  268. package/packages/core/release/runtime-override-authorization.js +0 -242
  269. package/packages/core/runtime/commands/runtime-ref-core.mjs +0 -171
  270. package/packages/core/runtime/provider-closure.js +0 -60
  271. package/packages/core/runtime/runtime-selection-action.js +0 -34
  272. package/packages/core/runtime/runtime-selection.js +0 -136
  273. package/packages/core/runtime/workflow-runtime.js +0 -11
  274. package/packages/core/workflow/admission/review.js +0 -188
  275. package/packages/core/workflow/commands/universal-workflow-backflow.mjs +0 -26
  276. package/packages/core/workflow/installation.js +0 -33
  277. package/packages/core/workflow/settlement/backflow.js +0 -187
  278. package/scripts/generate-bootstrap-recovery.mjs +0 -94
  279. package/templates/bootstrap-recovery/actions/build/source/admit/action.yml +0 -17
  280. package/templates/bootstrap-recovery/actions/build/source/admit/dist/index.js +0 -63
  281. package/templates/bootstrap-recovery/actions/runtime/dependencies/install/action.yml +0 -18
  282. package/templates/bootstrap-recovery/actions/runtime/dependencies/install/dist/index.js +0 -63
  283. package/templates/bootstrap-recovery/actions/runtime/environment/prepare/action.yml +0 -21
  284. package/templates/bootstrap-recovery/actions/workflow/admission/inspect/action.yml +0 -27
  285. package/templates/bootstrap-recovery/actions/workflow/admission/inspect/dist/index.js +0 -64
  286. package/templates/bootstrap-recovery/actions/workflow/admission/review/action.yml +0 -15
  287. package/templates/bootstrap-recovery/actions/workflow/admission/review/dist/index.js +0 -65
  288. package/templates/bootstrap-recovery/actions/workflow/recovery/admit/action.yml +0 -47
  289. package/templates/bootstrap-recovery/actions/workflow/recovery/execute/action.yml +0 -48
  290. package/templates/bootstrap-recovery/actions/workflow/recovery/settle/action.yml +0 -54
  291. package/templates/bootstrap-recovery/actions/workflow/settlement/seal/action.yml +0 -17
  292. package/templates/bootstrap-recovery/actions/workflow/settlement/seal/dist/index.js +0 -65
  293. package/templates/bootstrap-recovery/manifest.json +0 -68
  294. package/templates/bootstrap-recovery/package.json +0 -9
  295. package/templates/universal-buildchain-bootstrap-recovery.yml +0 -115
@@ -22,22 +22,22 @@ const routedOutputs = {
22
22
  };
23
23
  export function generateChannelPromotionWorkflow(source) {
24
24
  const component = YAML.parse(source).on.workflow_call;
25
- if (Object.keys(component.inputs).join() !== "request-json") throw new Error("Promotion component requires one complete invocation request");
25
+ if (Object.keys(component.inputs).filter(key => !["runtime-ref", "contract-lock", "runtime-selection"].includes(key)).join() !== "request-json") throw new Error("Promotion component requires one complete invocation request");
26
26
  const outputs = Object.fromEntries(Object.entries(routedOutputs).map(([key, value]) => [key, {
27
27
  description: `Admitted ${value}.`, value: `\${{ jobs.resolve-promotion.outputs.${value} }}`,
28
28
  }]));
29
29
  for (const [key, output] of Object.entries(component.outputs)) outputs[key] = { ...output, value: `\${{ jobs.invoke.outputs.${key} }}` };
30
30
  const jobs = JSON.parse(fs.readFileSync(path.join(root, "architecture/promotion-job-topology.json"), "utf8"));
31
31
  jobs.invoke = {
32
- name: "Invoke the current publisher component", needs: ["resolve-promotion", "consumer-admission"],
33
- uses: "./.github/workflows/.release-promote.yml", with: { "request-json": "${{ needs.consumer-admission.outputs.invocation-json }}" }, secrets: "inherit",
32
+ name: "Invoke the current publisher component", needs: ["resolve-promotion", "consumer-admission", "execution-runtime"],
33
+ uses: "./.github/workflows/.release-promote.yml", with: { "request-json": "${{ needs.consumer-admission.outputs.invocation-json }}", "runtime-selection": "${{ needs.execution-runtime.outputs.selection }}" }, secrets: "inherit",
34
34
  };
35
35
  return "# Generated by scripts/generate-channel-promotion-workflow.mjs. Do not edit directly.\n" + YAML.stringify({
36
36
  name: "Release Candidate Promote",
37
37
  on: { workflow_call: { inputs: { "request-json": {
38
38
  description: "JSON object matching contracts/promotion-request-v1.schema.json. The API validates types, defaults and authority before dispatch.",
39
39
  required: true, type: "string",
40
- } }, secrets: component.secrets, outputs } }, jobs,
40
+ }, ...Object.fromEntries(["runtime-ref", "contract-lock", "runtime-selection"].map(key => [key, component.inputs[key]])) }, secrets: component.secrets, outputs } }, jobs,
41
41
  }, { lineWidth: 0, aliasDuplicateObjects: false });
42
42
  }
43
43
  if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url))
@@ -5,8 +5,8 @@ export function assertBinaryInventory(root) {
5
5
  const file = ".github/workflows/self-build-binary-distribution.yml";
6
6
  const workflow = readWorkflow(file, root);
7
7
  assert.equal(workflow.name, "Binary Distribution");
8
- assert.deepEqual(Object.keys(workflow.jobs), ["preflight", "binary", "passport", "dispatch-publication"]);
9
- const graphs = Object.keys(workflow.jobs).map(id => inspectWorkflowJob(file, id, root));
8
+ assert.deepEqual(Object.keys(workflow.jobs).filter(id => id !== "execution-runtime"), ["preflight", "binary", "passport", "dispatch-publication"]);
9
+ const graphs = Object.keys(workflow.jobs).filter(id => id !== "execution-runtime").map(id => inspectWorkflowJob(file, id, root));
10
10
  for (const graph of graphs) {
11
11
  assert.equal(graph.job.permissions.contents, "read");
12
12
  assert.notEqual(graph.job.permissions["id-token"], "write");
@@ -23,7 +23,7 @@ export function assertBinaryInventory(root) {
23
23
  assert.ok(passport.actions.has("actions/build/binary/qualify"));
24
24
  const publish = inspectWorkflowJob(".github/workflows/.release-binary-assets.yml", "publish", root);
25
25
  assert.equal(publish.workflow.jobs["publication-authority"].uses, "./.github/workflows/.release-authority.yml");
26
- assert.equal(publish.job.needs, "publication-authority");
26
+ assert.ok(publish.job.needs.includes("publication-authority"));
27
27
  assert.equal(publish.job.environment, "buildchain-release-assets");
28
28
  assert.equal(publish.job.permissions.contents, "write");
29
29
  assert.ok(publish.actions.has("actions/release/binary/publish"));
@@ -32,5 +32,5 @@ export function assertBinaryInventory(root) {
32
32
  assert.equal(effect["continue-on-error"], undefined);
33
33
  const transaction = publish.modules.get("packages/core/publication/binary/transaction.js");
34
34
  assert.match(transaction, /validateBinaryCapability\([\s\S]*await client.publish\(/, "Binary effects must follow capability admission");
35
- assert.match(publish.modules.get("packages/core/publication/binary/action.js"), /verifySourceRuntimeCheckouts\([\s\S]*await publishBinaryAssets\(/);
35
+ assert.match(publish.modules.get("packages/core/publication/binary/action.js"), /verifyCheckoutIdentity\([\s\S]*await publishBinaryAssets\(/);
36
36
  }
@@ -15,13 +15,14 @@ export function assertPromotionInventory(root) {
15
15
  read(".github/workflows/.release-promote.yml"),
16
16
  ),
17
17
  );
18
- assert.deepEqual(Object.keys(api.on.workflow_call.inputs), ["request-json"]);
18
+ assert.deepEqual(Object.keys(api.on.workflow_call.inputs), ["request-json", "runtime-ref", "contract-lock", "runtime-selection"]);
19
19
  assert.equal(
20
20
  api.jobs.invoke.uses,
21
21
  "./.github/workflows/.release-promote.yml",
22
22
  );
23
23
  assert.deepEqual(api.jobs.invoke.with, {
24
24
  "request-json": "${{ needs.consumer-admission.outputs.invocation-json }}",
25
+ "runtime-selection": "${{ needs.execution-runtime.outputs.selection }}",
25
26
  });
26
27
  const request = JSON.parse(
27
28
  read("contracts/promotion-request-v1.schema.json"),
@@ -41,10 +42,11 @@ export function assertPromotionInventory(root) {
41
42
  ]) {
42
43
  const caller = YAML.parse(read(`.github/workflows/${file}.yml`));
43
44
  const calls = Object.values(caller.jobs).filter(
44
- (job) => job.uses === `./${publicPath}`,
45
+ (job) => job.uses === `kungfu-systems/buildchain/${publicPath}@v4`,
45
46
  );
46
47
  assert.equal(calls.length, 1, file);
47
- assert.deepEqual(Object.keys(calls[0].with), ["request-json"]);
48
+ assert.ok(calls[0].with["request-json"]);
49
+ assert.ok(Object.keys(calls[0].with).every(key => ["request-json", "runtime-ref", "contract-lock", "runtime-selection"].includes(key)));
48
50
  }
49
51
  const component = ".github/workflows/.release-promote.yml";
50
52
  const expected = {
@@ -0,0 +1,70 @@
1
+ import ts from "typescript";
2
+
3
+ const equality = new Set([
4
+ ts.SyntaxKind.EqualsEqualsToken,
5
+ ts.SyntaxKind.EqualsEqualsEqualsToken,
6
+ ts.SyntaxKind.ExclamationEqualsToken,
7
+ ts.SyntaxKind.ExclamationEqualsEqualsToken,
8
+ ]);
9
+
10
+ export function auditRuntimeSourceBoundaries(source, file) {
11
+ const tree = ts.createSourceFile(file, source, ts.ScriptTarget.Latest, true);
12
+ const aliases = new Map();
13
+ function collect(node) {
14
+ if (
15
+ ts.isVariableDeclaration(node) &&
16
+ ts.isIdentifier(node.name) &&
17
+ node.initializer
18
+ )
19
+ aliases.set(node.name.text, node.initializer);
20
+ ts.forEachChild(node, collect);
21
+ }
22
+ collect(tree);
23
+ function origins(node, seen = new Set()) {
24
+ const text = node.getText(tree);
25
+ const result = new Set();
26
+ if (
27
+ /\b(?:installationRoot|BUILDCHAIN_RUNTIME_ROOT|runtimeRoot)\b/u.test(text)
28
+ )
29
+ result.add("runtime");
30
+ if (
31
+ /\b(?:GITHUB_WORKSPACE|workspace|sourceRoot|consumerRoot)\b/u.test(text)
32
+ )
33
+ result.add("source");
34
+ if (
35
+ ts.isIdentifier(node) &&
36
+ aliases.has(node.text) &&
37
+ !seen.has(node.text)
38
+ ) {
39
+ for (const origin of origins(
40
+ aliases.get(node.text),
41
+ new Set([...seen, node.text]),
42
+ ))
43
+ result.add(origin);
44
+ }
45
+ ts.forEachChild(node, (child) => {
46
+ for (const origin of origins(child, seen)) result.add(origin);
47
+ });
48
+ return result;
49
+ }
50
+ const issues = [];
51
+ function inspect(node) {
52
+ if (ts.isBinaryExpression(node) && equality.has(node.operatorToken.kind)) {
53
+ const left = origins(node.left),
54
+ right = origins(node.right);
55
+ if (
56
+ (left.has("runtime") && right.has("source")) ||
57
+ (right.has("runtime") && left.has("source"))
58
+ ) {
59
+ const line =
60
+ tree.getLineAndCharacterOfPosition(node.getStart(tree)).line + 1;
61
+ issues.push(
62
+ `${file}:${line}: business code cannot require runtime and source directory equality`,
63
+ );
64
+ }
65
+ }
66
+ ts.forEachChild(node, inspect);
67
+ }
68
+ inspect(tree);
69
+ return issues;
70
+ }
@@ -226,8 +226,8 @@ export function nodeApiMeta(exportName) {
226
226
  "./release-candidate": { group: "reusable-build", summary: "PR-stage release-candidate artifact, passport, and promote-only resolver APIs." },
227
227
  "./v4-floating-consumer-policy": { group: "governance-versioning", summary: "Semantic floating-selector admission, dual-lock receipt, and independent v4 consumer certification APIs." },
228
228
  "./floating-consumer-policy": { group: "governance-versioning", summary: "Semantic floating-selector admission, dual-lock receipt, and independent v4 consumer certification APIs." },
229
- "./v4-runtime-ref-resume-authority": { group: "release-passport-trust", summary: "Transient exact-runtime authorization, persisted-selector rejection, fresh-attempt Stage Capsule reuse, and A+B Passport lineage APIs." },
230
- "./runtime-ref-resume-authority": { group: "release-passport-trust", summary: "Transient exact-runtime authorization, persisted-selector rejection, fresh-attempt Stage Capsule reuse, and A+B Passport lineage APIs." },
229
+ "./runtime-resume-lineage": { group: "release-passport-trust", summary: "Source-bound recovery, reusable Stage Capsule evidence and publication readback lineage across execution runtimes." },
230
+ "./runtime-resume-lineage": { group: "release-passport-trust", summary: "Transient exact-runtime authorization, persisted-selector rejection, fresh-attempt Stage Capsule reuse, and A+B Passport lineage APIs." },
231
231
  "./v4-tail-reseal": { group: "release-passport-trust", summary: "Effect-pure retained Stage Capsule validation and explicit Warrant-, credential-, and release-tail-fenced macOS reseal planning APIs." },
232
232
  "./tail-reseal": { group: "release-passport-trust", summary: "Effect-pure retained Stage Capsule validation and explicit Warrant-, credential-, and release-tail-fenced macOS reseal planning APIs." },
233
233
  "./v4-tail-reseal-receipt": { group: "release-passport-trust", summary: "Four-platform byte readback, standard candidate Passport binding, and terminal v4 tail-reseal receipt APIs." },
@@ -8,7 +8,7 @@ export const repositoryRoot = path.resolve(import.meta.dirname, "..");
8
8
  export function localActionDirectory(uses) {
9
9
  if (typeof uses !== "string") return null;
10
10
  const match =
11
- /^\.\/(?:\.buildchain\/[a-z0-9][a-z0-9-]*\/)?(actions\/[a-z0-9-]+\/[a-z0-9-]+\/[a-z0-9-]+)$/u.exec(
11
+ /^(?:\$\/|\.\/(?:\.buildchain\/[a-z0-9][a-z0-9-]*\/)?)((?:actions)\/[a-z0-9-]+\/[a-z0-9-]+\/[a-z0-9-]+)$/u.exec(
12
12
  uses,
13
13
  );
14
14
  return match?.[1] || null;
@@ -117,23 +117,10 @@ export function inspectWorkflowJob(relative, jobId, root = repositoryRoot) {
117
117
  if (action.runs.using === "composite") {
118
118
  for (const child of action.runs.steps) {
119
119
  if (excludedPhase(child, childInputs)) continue;
120
- const executableText = [child.run, child.with?.script]
121
- .filter(Boolean)
122
- .join("\n");
123
- for (const match of executableText.matchAll(
124
- /(?:\$GITHUB_ACTION_PATH\/|["'](?:\.\.\/)+)([^"'\s]+\.[cm]?js)/gu,
125
- )) {
126
- const prefix = match[0].startsWith("$GITHUB_ACTION_PATH/")
127
- ? ""
128
- : match[0].slice(1, -match[1].length);
129
- sourceModule(path.posix.join(directory, prefix, match[1]));
130
- }
131
- for (const match of executableText.matchAll(
132
- /(?:^|[\s"'/])((?:packages\/core|scripts)\/[^\s"']+\.[cm]?js)/gu,
133
- )) {
134
- const file = match[1];
135
- if (fs.existsSync(path.join(root, file))) sourceModule(file);
136
- }
120
+ assert.ok(
121
+ child.uses && !child.run && !child.shell && !child.with?.script,
122
+ `${directory}: composite must invoke actions, not executable scripts`,
123
+ );
137
124
  walk(child, [...ancestry, directory], childInputs);
138
125
  }
139
126
  } else if (/^node\d+$/u.test(action.runs.using)) {
@@ -0,0 +1,20 @@
1
+ import YAML from "yaml";
2
+
3
+ // actionlint 1.7.12 predates GitHub's self-repository action references.
4
+ // Resolve only this syntax in the isolated source project so actionlint still
5
+ // validates the real action's inputs, outputs and every other expression.
6
+ export function lowerSelfReferencesForLint(source) {
7
+ const document = YAML.parseDocument(source);
8
+ if (document.errors.length) throw document.errors[0];
9
+ YAML.visit(document, {
10
+ Pair(_key, pair) {
11
+ if (pair.key?.value !== "uses" || typeof pair.value?.value !== "string") return;
12
+ const reference = pair.value.value;
13
+ if (!reference.startsWith("$/")) return;
14
+ if (!/^\$\/actions\/[a-z0-9-]+\/[a-z0-9-]+\/[a-z0-9-]+$/u.test(reference))
15
+ throw new Error(`Invalid Buildchain self action reference: ${reference}`);
16
+ pair.value.value = `.${reference.slice(1)}`;
17
+ },
18
+ });
19
+ return String(document);
20
+ }
@@ -5,10 +5,10 @@ on:
5
5
  - buildchain-dev-delivery-wake
6
6
  workflow_dispatch:
7
7
  inputs:
8
- buildchain-ref:
9
- description: "Buildchain runtime selector: v4, v4-alpha, or a trusted train/v4/v4.0/<capability>"
8
+ runtime-ref:
9
+ description: "Buildchain runtime selector: v4, v4-alpha, or a trusted train/v4/v4.1/<capability>"
10
10
  required: false
11
- default: v4-alpha
11
+ default: ""
12
12
  target-branch:
13
13
  description: Protected dev/vN/vN.M branch
14
14
  required: true
@@ -95,7 +95,7 @@ jobs:
95
95
  deliver:
96
96
  uses: kungfu-systems/buildchain/.github/workflows/public-ops-dev-auto-merge.yml@v4-alpha
97
97
  with:
98
- buildchain-ref: ${{ inputs.buildchain-ref || 'v4-alpha' }}
98
+ runtime-ref: ${{ inputs.runtime-ref || '' }}
99
99
  target-branch: ${{ github.event.client_payload.candidate.targetBranch || inputs.target-branch }}
100
100
  expected-pr-number: ${{ github.event.client_payload.candidate.pullRequestNumber || inputs.expected-pr-number }}
101
101
  expected-head-sha: ${{ github.event.client_payload.candidate.sourceHead || inputs.expected-head-sha }}
@@ -7,6 +7,16 @@ on:
7
7
  description: "Versioned exact-candidate request envelope"
8
8
  required: true
9
9
  type: string
10
+ runtime-ref:
11
+ description: Entry-owned runtime selection parameter.
12
+ required: false
13
+ type: string
14
+ default: ""
15
+ contract-lock:
16
+ description: Entry-owned runtime selection parameter.
17
+ required: false
18
+ type: string
19
+ default: ""
10
20
  outputs:
11
21
  runtime-sha:
12
22
  value: ${{ jobs.bootstrap.outputs.runtime-sha }}
@@ -14,8 +24,6 @@ on:
14
24
  value: ${{ jobs.bootstrap.outputs.terminal-receipt-json }}
15
25
  terminal-receipt-root:
16
26
  value: ${{ jobs.bootstrap.outputs.terminal-receipt-root }}
17
- backflow-root:
18
- value: ${{ jobs.bootstrap.outputs.backflow-root }}
19
27
 
20
28
  permissions:
21
29
  contents: read
@@ -25,4 +33,6 @@ jobs:
25
33
  uses: kungfu-systems/buildchain/.github/workflows/public-ops-bootstrap.yml@v4
26
34
  with:
27
35
  request-json: ${{ inputs.request-json }}
36
+ runtime-ref: ${{ inputs.runtime-ref }}
37
+ contract-lock: ${{ inputs.contract-lock }}
28
38
  secrets: inherit
@@ -1,64 +0,0 @@
1
- {
2
- "schemaVersion": 1,
3
- "contract": "kungfu-buildchain-v4-runtime-ref-resume-authority/v1",
4
- "schemaAuthority": "contracts/v4-runtime-ref-resume-authority-v1.schema.json",
5
- "fixtureAuthority": "contracts/fixtures/v4-runtime-ref-resume-authority-v1/scenario.json",
6
- "runtimeAuthority": "packages/core/consumer/runtime-ref-resume-authority.js",
7
- "mode": "v4-only",
8
- "transientSelection": {
9
- "trustedEvent": "workflow_dispatch",
10
- "actorPermissions": ["write", "maintain", "admin"],
11
- "approvedRefs": [
12
- "v4",
13
- "v4-alpha",
14
- "train/v4/v4.N/*",
15
- "authority/v4/v4.N/*"
16
- ],
17
- "exactShaRequiresApprovedRefReachability": true,
18
- "operatorReasonRequired": true,
19
- "sourceTreeBound": true,
20
- "consumerPolicyReceiptBound": true,
21
- "dualContractLockRootsBound": true,
22
- "providerReadbackRooted": true
23
- },
24
- "persistence": {
25
- "exactShaDefault": "deny",
26
- "trainOrAuthorityDefault": "deny",
27
- "repositoryVariableIndirection": "deny",
28
- "secretIndirection": "deny",
29
- "environmentIndirection": "deny",
30
- "oidcIamAndExternalAuthorityInventory": "metadata-only"
31
- },
32
- "resume": {
33
- "freshAttemptRequired": true,
34
- "failedJobRerun": false,
35
- "floatingRefMovementRequired": true,
36
- "buildAndResumeRuntimeMustDiffer": true,
37
- "sealedCapsuleIdentity": [
38
- "source-sha",
39
- "source-tree-sha",
40
- "platform",
41
- "build-runtime-sha",
42
- "consumer-policy-receipt-root",
43
- "capsule-root",
44
- "identity-root",
45
- "artifact-digest"
46
- ],
47
- "validUnaffectedPlatforms": "reuse",
48
- "missingPlatforms": "rebuild",
49
- "staleOrAmbiguousCapsules": "reject"
50
- },
51
- "passport": {
52
- "section": "v4RuntimeResume",
53
- "recordsRuntimeAAndB": true,
54
- "authorizationRootRequired": true,
55
- "lineageRootRequired": true,
56
- "finalPublicReadbackRootRequired": true
57
- },
58
- "authority": {
59
- "v3BehaviorChange": false,
60
- "credentialsInEvidence": false,
61
- "persistentExactSha": false,
62
- "providerMutation": false
63
- }
64
- }
@@ -1,76 +0,0 @@
1
- {
2
- "schema": "kungfu-buildchain-v4-universal-workflow-admission-policy/v1",
3
- "sourceRepository": "kungfu-systems/buildchain",
4
- "consumerAdmission": "verified-caller",
5
- "allowedCapabilities": [
6
- "bootstrap-conformance",
7
- "release-candidate-promote",
8
- "release-invocation"
9
- ],
10
- "permissionCeiling": {
11
- "actions": "write",
12
- "artifact-metadata": "write",
13
- "attestations": "write",
14
- "checks": "write",
15
- "contents": "write",
16
- "deployments": "write",
17
- "id-token": "write",
18
- "issues": "write",
19
- "packages": "write",
20
- "pages": "write",
21
- "pull-requests": "write",
22
- "security-events": "write",
23
- "statuses": "write"
24
- },
25
- "contractRoots": [
26
- "sha256:01afa05effa5be9c3178382ea76b125c431c310f31c930acc51dd2011b0b44c7",
27
- "sha256:0e9b473d3e04c4563c81b96bf159b4e8565fb7442cbae9fd5f2b736ecf931965",
28
- "sha256:0fc02895c9da6e1eb50fb0d9edcfa29a7be074f8d06e4755c3a8948229e9d615",
29
- "sha256:1474f1cc5f9db3903e3961e973f8ba96fac9401850751399841fb3957bb6c917",
30
- "sha256:17c5fc05f8599662cd061a94add5313dc0fcea58404f9a92ee632c98abce24c6",
31
- "sha256:18546a18c951a7d594b42fc38ee2f8ce90e2506ed514332af0e67d092e2d1f40",
32
- "sha256:1a80a52652f61d061f3c427240f35b99a147aff7f4a3995b2b9938d5acaa81f2",
33
- "sha256:234e49ec69c1d8bbc57a7e528c07f66cf5c8c21bfcd802aa7610b23d7d5b3c04",
34
- "sha256:263b63d25b82255dfc087d76d28b208dd59c44914c3c45cb537c438151214b4b",
35
- "sha256:265ccc9da3d84b8bf50746b6722b18c680dcc65bd322a5170e81bd5d0fa5b2b0",
36
- "sha256:29dbec8ebd38dd8cef69bbf2fdf8586391863e7e53d78de55ca922409592e94e",
37
- "sha256:2af9e624b70654c8a080dacaefa59a61ddf05be542c2f595a8d1970a1a14e8dd",
38
- "sha256:3176603b4e69310944aaeda84f6f27c6d57e73bb082a7d7ee6ee62d9bc0816ea",
39
- "sha256:3be79c2a7b6d48bcff3a8294cd98835b8e58cbf769bc8ec67a7ea77b065d2e92",
40
- "sha256:41de3292e11725b738a41abacc093fca8ddb9d54c58765dfb67ad5c005f102ba",
41
- "sha256:43d2812a9d07435b4550386ac8903dfd511802dc38efa8e546430af7a414cb98",
42
- "sha256:441430a3dc420f9b1ba363703c3ec28f92606b3b6dd328523b5492d327aa6ba3",
43
- "sha256:466bdddfcf06ad60cf038777ceaf793511581336c845cb8daef6e4f233c3a7ff",
44
- "sha256:49065b4b7f0e4fd1760e808e310edfea3bd7333c8407c4b419a097ea3d908adc",
45
- "sha256:4916bb48f509f3e4db3626ae676e735253ad3aace8b54c20aca6f084ce70802b",
46
- "sha256:567970a563ada761dc4889e8a22bd2b67cc70b1318dd43c9584c39f002a5fc0a",
47
- "sha256:5e0dae41e7e0c5e375f88cdcc4a30505246000740c6806b1119312171c8d42d8",
48
- "sha256:6b95750684c7a4131bd0c7e95326f1b00c01e47a7e5fe5312a916ca86e5bf74d",
49
- "sha256:6ead02c396a2580606ebc0bc12aa4606bfdd7596ba1d45d316af5c3767517c39",
50
- "sha256:74782cada7ad52a4cd2f6bdf59d288d7514d6647f8f27aaeb70e4b2b41f83d60",
51
- "sha256:874fc697abac4a79e77fd133935763f09e027c2f8cdf147b5b1fab2193b49a09",
52
- "sha256:8fcb36f28fba242c0259824b47bb63821ced69ed30b5d36530bc4c2ef5192e81",
53
- "sha256:990f80c199735e1876c3c8887a4b5ff34b0e8dd304cc35779ae269117f0b933d",
54
- "sha256:9a8c11b4787f24447df76a5ee0f31ed7d7cf0284a1251d4d4bdccc895571d4fe",
55
- "sha256:9d1c6a36f814360123ea2647962df1bbd7fcba33b9e987d34364894b836ff90c",
56
- "sha256:9ed88028c348832cf60b30536f8feda84248350e26fb00256076ff3f7d3d3f19",
57
- "sha256:a2a553a0e774224b398e5bccde811f8354638547656453adf7734f416f011a2b",
58
- "sha256:ab5681f60da097852e44c254e8c66b50572389b9ebfb94fa0c67af416d7ecb07",
59
- "sha256:b4f6e135e44b60097ec926509c705d8f3307de113c9d1155a22a3ea61a5daa28",
60
- "sha256:baf0273671278773d931b202de9bd7facc28e2d9962bbdfa038594c8ba00ab51",
61
- "sha256:bdd0b125ca2b4fa9828178631bb70bc9417b50f1206d04203c38088f0c077665",
62
- "sha256:cb42b0f31edf5bc290ea0634c4b71e27a929c9fe68131f9e113c12c385f96095",
63
- "sha256:d309f53c7ab4d2fd99fae0512eee93aebeedc82e6c8db6e2d02107d0d1e6d24f",
64
- "sha256:d829866ba8565b432af82aa059af9bcc11b730f1283ba78fb618e50f213cf5a2",
65
- "sha256:e8486f542a660129ae63cbba79aa36192038b210b2954d8bf127e907ea286b28",
66
- "sha256:f1a22e4a7bc42e63cc34bf43837f4ae38905a8b5e2908163401057af9982b2a0",
67
- "sha256:f1ebeb4bc3f4cedea5c325b0f807452576d89fa1be6549ce837a98bdce0d642f",
68
- "sha256:f77d617eac0035542baa86f5364db79ccbf93bb7202ed1c36cee5a52cf31f0d1"
69
- ],
70
- "targetRef": "dev/v4/v4.1",
71
- "allowedReviewers": ["kungfu-origin"],
72
- "minimumApprovals": 1,
73
- "requiredChecks": ["check"],
74
- "validFrom": "2026-08-30T00:00:00.000Z",
75
- "expiresAt": "2026-09-15T00:00:00.000Z"
76
- }