@intentius/chant 0.124.87 → 0.124.89

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 (483) hide show
  1. package/dist/action-pins.d.ts +1 -0
  2. package/dist/action-pins.d.ts.map +1 -1
  3. package/dist/action-pins.js +2 -0
  4. package/dist/actor.d.ts +47 -0
  5. package/dist/actor.d.ts.map +1 -0
  6. package/dist/actor.js +56 -0
  7. package/dist/bundle-check.d.ts +20 -5
  8. package/dist/bundle-check.d.ts.map +1 -1
  9. package/dist/bundle-check.js +20 -5
  10. package/dist/chant-install.d.ts +98 -0
  11. package/dist/chant-install.d.ts.map +1 -1
  12. package/dist/chant-install.js +203 -2
  13. package/dist/ci-base.d.ts +30 -0
  14. package/dist/ci-base.d.ts.map +1 -0
  15. package/dist/ci-base.js +33 -0
  16. package/dist/ci-comment-commands.d.ts +177 -0
  17. package/dist/ci-comment-commands.d.ts.map +1 -0
  18. package/dist/ci-comment-commands.js +325 -0
  19. package/dist/ci-comment-replies.d.ts +40 -0
  20. package/dist/ci-comment-replies.d.ts.map +1 -0
  21. package/dist/ci-comment-replies.js +59 -0
  22. package/dist/ci-commit.d.ts +1 -1
  23. package/dist/ci-commit.d.ts.map +1 -1
  24. package/dist/ci-commit.js +1 -2
  25. package/dist/ci-control.d.ts +1 -1
  26. package/dist/ci-control.d.ts.map +1 -1
  27. package/dist/ci-control.js +1 -1
  28. package/dist/ci-evidence-claims.d.ts +59 -0
  29. package/dist/ci-evidence-claims.d.ts.map +1 -0
  30. package/dist/ci-evidence-claims.js +87 -0
  31. package/dist/ci-evidence-from-job.d.ts +128 -0
  32. package/dist/ci-evidence-from-job.d.ts.map +1 -0
  33. package/dist/ci-evidence-from-job.js +203 -0
  34. package/dist/ci-evidence-jobs.d.ts +68 -4
  35. package/dist/ci-evidence-jobs.d.ts.map +1 -1
  36. package/dist/ci-evidence-jobs.js +82 -5
  37. package/dist/ci-handover.d.ts +12 -0
  38. package/dist/ci-handover.d.ts.map +1 -1
  39. package/dist/ci-handover.js +15 -3
  40. package/dist/ci-identity.d.ts +32 -6
  41. package/dist/ci-identity.d.ts.map +1 -1
  42. package/dist/ci-identity.js +40 -8
  43. package/dist/ci-image.d.ts +65 -10
  44. package/dist/ci-image.d.ts.map +1 -1
  45. package/dist/ci-image.js +101 -22
  46. package/dist/ci-jobs.d.ts +1 -1
  47. package/dist/ci-jobs.d.ts.map +1 -1
  48. package/dist/ci-jobs.js +7 -2
  49. package/dist/ci-login.d.ts +75 -13
  50. package/dist/ci-login.d.ts.map +1 -1
  51. package/dist/ci-login.js +89 -37
  52. package/dist/ci-note-commands.d.ts +63 -3
  53. package/dist/ci-note-commands.d.ts.map +1 -1
  54. package/dist/ci-note-commands.js +69 -35
  55. package/dist/ci-product-words.d.ts +62 -1
  56. package/dist/ci-product-words.d.ts.map +1 -1
  57. package/dist/ci-product-words.js +52 -1
  58. package/dist/ci-product.d.ts +52 -2
  59. package/dist/ci-product.d.ts.map +1 -1
  60. package/dist/ci-product.js +51 -2
  61. package/dist/cli/commands/build.d.ts.map +1 -1
  62. package/dist/cli/commands/build.js +29 -2
  63. package/dist/cli/handlers/approve-confirm.d.ts +14 -0
  64. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -1
  65. package/dist/cli/handlers/approve-confirm.js +46 -0
  66. package/dist/cli/handlers/approve.d.ts.map +1 -1
  67. package/dist/cli/handlers/approve.js +2 -1
  68. package/dist/cli/handlers/build.d.ts +1 -1
  69. package/dist/cli/handlers/build.d.ts.map +1 -1
  70. package/dist/cli/handlers/build.js +22 -1
  71. package/dist/cli/handlers/ci-check.d.ts +1 -1
  72. package/dist/cli/handlers/ci-check.d.ts.map +1 -1
  73. package/dist/cli/handlers/ci-check.js +37 -7
  74. package/dist/cli/handlers/ci-evidence.d.ts.map +1 -1
  75. package/dist/cli/handlers/ci-evidence.js +255 -20
  76. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -1
  77. package/dist/cli/handlers/ci-forge-check.js +34 -17
  78. package/dist/cli/handlers/components.d.ts.map +1 -1
  79. package/dist/cli/handlers/components.js +3 -1
  80. package/dist/cli/handlers/generated-check.d.ts +11 -0
  81. package/dist/cli/handlers/generated-check.d.ts.map +1 -0
  82. package/dist/cli/handlers/generated-check.js +71 -0
  83. package/dist/cli/handlers/lifecycle.d.ts.map +1 -1
  84. package/dist/cli/handlers/lifecycle.js +3 -0
  85. package/dist/cli/handlers/local-chant.d.ts +13 -0
  86. package/dist/cli/handlers/local-chant.d.ts.map +1 -1
  87. package/dist/cli/handlers/local-chant.js +42 -1
  88. package/dist/cli/handlers/lock.d.ts.map +1 -1
  89. package/dist/cli/handlers/lock.js +121 -4
  90. package/dist/cli/handlers/pr-comment.d.ts +21 -0
  91. package/dist/cli/handlers/pr-comment.d.ts.map +1 -0
  92. package/dist/cli/handlers/pr-comment.js +112 -0
  93. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  94. package/dist/cli/handlers/pr-env.js +6 -3
  95. package/dist/cli/handlers/pr.d.ts +23 -1
  96. package/dist/cli/handlers/pr.d.ts.map +1 -1
  97. package/dist/cli/handlers/pr.js +97 -14
  98. package/dist/cli/handlers/promote.d.ts.map +1 -1
  99. package/dist/cli/handlers/promote.js +2 -1
  100. package/dist/cli/handlers/release.d.ts.map +1 -1
  101. package/dist/cli/handlers/release.js +11 -2
  102. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  103. package/dist/cli/handlers/run-wave.js +36 -2
  104. package/dist/cli/handlers/run.d.ts.map +1 -1
  105. package/dist/cli/handlers/run.js +2 -1
  106. package/dist/cli/main.d.ts.map +1 -1
  107. package/dist/cli/main.js +60 -4
  108. package/dist/cli/parse-args.d.ts.map +1 -1
  109. package/dist/cli/parse-args.js +82 -0
  110. package/dist/cli/registry.d.ts +35 -0
  111. package/dist/cli/registry.d.ts.map +1 -1
  112. package/dist/components/auto-release.d.ts.map +1 -1
  113. package/dist/components/auto-release.js +2 -1
  114. package/dist/components/check-hooks.d.ts +10 -0
  115. package/dist/components/check-hooks.d.ts.map +1 -1
  116. package/dist/components/check-hooks.js +18 -0
  117. package/dist/components/pr-checks.d.ts +169 -0
  118. package/dist/components/pr-checks.d.ts.map +1 -0
  119. package/dist/components/pr-checks.js +180 -0
  120. package/dist/components/pr-pipeline.d.ts +38 -0
  121. package/dist/components/pr-pipeline.d.ts.map +1 -1
  122. package/dist/components/pr-pipeline.js +6 -1
  123. package/dist/components/product-pipeline.d.ts +58 -2
  124. package/dist/components/product-pipeline.d.ts.map +1 -1
  125. package/dist/components/product-pipeline.js +76 -9
  126. package/dist/components/product-plan.d.ts +445 -7
  127. package/dist/components/product-plan.d.ts.map +1 -1
  128. package/dist/components/product-plan.js +426 -15
  129. package/dist/config.d.ts +10 -6
  130. package/dist/config.d.ts.map +1 -1
  131. package/dist/config.js +11 -6
  132. package/dist/control/consumers.d.ts +6 -0
  133. package/dist/control/consumers.d.ts.map +1 -1
  134. package/dist/control/consumers.js +6 -0
  135. package/dist/dead-guards.d.ts.map +1 -1
  136. package/dist/dead-guards.js +9 -6
  137. package/dist/discovery/files.d.ts +1 -1
  138. package/dist/discovery/files.js +1 -1
  139. package/dist/drift-issue.d.ts +20 -3
  140. package/dist/drift-issue.d.ts.map +1 -1
  141. package/dist/drift-issue.js +16 -0
  142. package/dist/drift-record.d.ts +52 -5
  143. package/dist/drift-record.d.ts.map +1 -1
  144. package/dist/drift-record.js +46 -6
  145. package/dist/floor-table.d.ts +6 -6
  146. package/dist/floor-table.d.ts.map +1 -1
  147. package/dist/floor-table.data.d.ts.map +1 -1
  148. package/dist/floor-table.data.js +81 -21
  149. package/dist/floor-table.js +10 -7
  150. package/dist/forge-check/contract.d.ts +19 -1
  151. package/dist/forge-check/contract.d.ts.map +1 -1
  152. package/dist/forge-check/contract.js +8 -2
  153. package/dist/forge-check/index.d.ts +4 -0
  154. package/dist/forge-check/index.d.ts.map +1 -1
  155. package/dist/forge-check/index.js +4 -0
  156. package/dist/forge-flags.d.ts +10 -0
  157. package/dist/forge-flags.d.ts.map +1 -1
  158. package/dist/forge-flags.js +31 -0
  159. package/dist/forge-remote.d.ts +47 -0
  160. package/dist/forge-remote.d.ts.map +1 -0
  161. package/dist/forge-remote.js +69 -0
  162. package/dist/gate-resume-run.d.ts +9 -1
  163. package/dist/gate-resume-run.d.ts.map +1 -1
  164. package/dist/gate-resume-run.js +26 -3
  165. package/dist/generated-check.d.ts +88 -0
  166. package/dist/generated-check.d.ts.map +1 -0
  167. package/dist/generated-check.js +248 -0
  168. package/dist/image-pins.d.ts +26 -0
  169. package/dist/image-pins.d.ts.map +1 -0
  170. package/dist/image-pins.js +19 -0
  171. package/dist/lexicon.d.ts +27 -0
  172. package/dist/lexicon.d.ts.map +1 -1
  173. package/dist/lifecycle/git.d.ts +11 -0
  174. package/dist/lifecycle/git.d.ts.map +1 -1
  175. package/dist/lifecycle/git.js +30 -3
  176. package/dist/lifecycle/publish-npm.d.ts +26 -0
  177. package/dist/lifecycle/publish-npm.d.ts.map +1 -1
  178. package/dist/lifecycle/publish-npm.js +76 -4
  179. package/dist/lifecycle/reach-locks.d.ts +131 -0
  180. package/dist/lifecycle/reach-locks.d.ts.map +1 -0
  181. package/dist/lifecycle/reach-locks.js +118 -0
  182. package/dist/lifecycle/release-cut.d.ts +3 -1
  183. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  184. package/dist/lifecycle/release-cut.js +15 -0
  185. package/dist/lifecycle/release-images.d.ts +22 -1
  186. package/dist/lifecycle/release-images.d.ts.map +1 -1
  187. package/dist/lifecycle/release-images.js +26 -3
  188. package/dist/lifecycle/release-ledger.d.ts +4 -3
  189. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  190. package/dist/lifecycle/release-ledger.js +3 -2
  191. package/dist/local-chant.d.ts +57 -3
  192. package/dist/local-chant.d.ts.map +1 -1
  193. package/dist/local-chant.js +122 -13
  194. package/dist/notify-product.d.ts +12 -3
  195. package/dist/notify-product.d.ts.map +1 -1
  196. package/dist/notify-product.js +10 -6
  197. package/dist/op/activities/source-release.d.ts.map +1 -1
  198. package/dist/op/activities/source-release.js +2 -1
  199. package/dist/op/activities/source-rollback.d.ts.map +1 -1
  200. package/dist/op/activities/source-rollback.js +2 -1
  201. package/dist/op/index.d.ts +2 -0
  202. package/dist/op/index.d.ts.map +1 -1
  203. package/dist/op/index.js +1 -0
  204. package/dist/op/op-waves-evidence-jobs.d.ts +97 -0
  205. package/dist/op/op-waves-evidence-jobs.d.ts.map +1 -0
  206. package/dist/op/op-waves-evidence-jobs.js +118 -0
  207. package/dist/op/op-waves-evidence.d.ts +12 -1
  208. package/dist/op/op-waves-evidence.d.ts.map +1 -1
  209. package/dist/op/op-waves-evidence.js +23 -2
  210. package/dist/op/op-waves-render-spec.d.ts +100 -0
  211. package/dist/op/op-waves-render-spec.d.ts.map +1 -0
  212. package/dist/op/op-waves-render-spec.js +162 -0
  213. package/dist/op/op-waves-run.d.ts +14 -1
  214. package/dist/op/op-waves-run.d.ts.map +1 -1
  215. package/dist/op/op-waves-run.js +56 -4
  216. package/dist/op/op-waves.d.ts +12 -0
  217. package/dist/op/op-waves.d.ts.map +1 -1
  218. package/dist/op/op-waves.js +14 -1
  219. package/dist/op/schedule-overdue.d.ts +39 -2
  220. package/dist/op/schedule-overdue.d.ts.map +1 -1
  221. package/dist/op/schedule-overdue.js +148 -10
  222. package/dist/op/wave-stop.d.ts +64 -0
  223. package/dist/op/wave-stop.d.ts.map +1 -0
  224. package/dist/op/wave-stop.js +127 -0
  225. package/dist/planned-files.d.ts +76 -0
  226. package/dist/planned-files.d.ts.map +1 -0
  227. package/dist/planned-files.js +108 -0
  228. package/dist/pr-forge-job.d.ts +22 -0
  229. package/dist/pr-forge-job.d.ts.map +1 -0
  230. package/dist/pr-forge-job.js +46 -0
  231. package/dist/pr-forge-reads.d.ts +21 -1
  232. package/dist/pr-forge-reads.d.ts.map +1 -1
  233. package/dist/pr-forge-reads.js +19 -1
  234. package/dist/pr-forge.d.ts +7 -1
  235. package/dist/pr-forge.d.ts.map +1 -1
  236. package/dist/pr-forge.js +7 -2
  237. package/dist/pr-loop.d.ts +3 -6
  238. package/dist/pr-loop.d.ts.map +1 -1
  239. package/dist/pr-loop.js +4 -81
  240. package/dist/pr-plan-note.d.ts +121 -0
  241. package/dist/pr-plan-note.d.ts.map +1 -1
  242. package/dist/pr-plan-note.js +104 -1
  243. package/dist/pr-plan-record.d.ts +47 -0
  244. package/dist/pr-plan-record.d.ts.map +1 -0
  245. package/dist/pr-plan-record.js +89 -0
  246. package/dist/pr-post.d.ts +68 -3
  247. package/dist/pr-post.d.ts.map +1 -1
  248. package/dist/pr-post.js +218 -13
  249. package/dist/pr-requires.d.ts +8 -0
  250. package/dist/pr-requires.d.ts.map +1 -1
  251. package/dist/pr-requires.js +3 -1
  252. package/dist/pr-status.d.ts +16 -0
  253. package/dist/pr-status.d.ts.map +1 -0
  254. package/dist/pr-status.js +90 -0
  255. package/dist/ref-gate-init.d.ts +90 -0
  256. package/dist/ref-gate-init.d.ts.map +1 -0
  257. package/dist/ref-gate-init.js +155 -0
  258. package/dist/ref-gate-rules.d.ts +19 -0
  259. package/dist/ref-gate-rules.d.ts.map +1 -0
  260. package/dist/ref-gate-rules.js +17 -0
  261. package/dist/release-floors.d.ts +100 -16
  262. package/dist/release-floors.d.ts.map +1 -1
  263. package/dist/release-floors.js +101 -17
  264. package/dist/render-module.d.ts +15 -0
  265. package/dist/render-module.d.ts.map +1 -0
  266. package/dist/render-module.js +73 -0
  267. package/dist/state-migration.d.ts +24 -1
  268. package/dist/state-migration.d.ts.map +1 -1
  269. package/dist/state-migration.js +39 -4
  270. package/dist/state-unlock.d.ts +32 -1
  271. package/dist/state-unlock.d.ts.map +1 -1
  272. package/dist/state-unlock.js +31 -0
  273. package/dist/wave-runtime.mjs +307 -297
  274. package/dist/workspace/ci-green-cli.d.ts.map +1 -1
  275. package/dist/workspace/ci-green-cli.js +15 -8
  276. package/dist/workspace/drift-cli.d.ts +1 -1
  277. package/dist/workspace/drift-cli.d.ts.map +1 -1
  278. package/dist/workspace/drift-cli.js +5 -12
  279. package/dist/workspace/forge-work.d.ts +3 -2
  280. package/dist/workspace/forge-work.d.ts.map +1 -1
  281. package/dist/workspace/forge-work.js +7 -17
  282. package/dist/workspace/lexicon-outputs.js +2 -2
  283. package/dist/workspace/release-train.d.ts.map +1 -1
  284. package/dist/workspace/release-train.js +2 -1
  285. package/dist/workspace/release-workflow.d.ts +27 -3
  286. package/dist/workspace/release-workflow.d.ts.map +1 -1
  287. package/dist/workspace/release-workflow.js +52 -7
  288. package/dist/workspace/trust/check-evidence-report.d.ts +25 -2
  289. package/dist/workspace/trust/check-evidence-report.d.ts.map +1 -1
  290. package/dist/workspace/trust/check-evidence-report.js +28 -8
  291. package/dist/workspace/trust/check-evidence.d.ts +13 -1
  292. package/dist/workspace/trust/check-evidence.d.ts.map +1 -1
  293. package/dist/workspace/trust/check-evidence.js +8 -3
  294. package/dist/workspace/trust/evidence.d.ts +5 -0
  295. package/dist/workspace/trust/evidence.d.ts.map +1 -1
  296. package/dist/workspace/trust/evidence.js +5 -0
  297. package/dist/workspace/trust/open-evidence.d.ts +67 -0
  298. package/dist/workspace/trust/open-evidence.d.ts.map +1 -0
  299. package/dist/workspace/trust/open-evidence.js +92 -0
  300. package/dist/workspace/trust/ref-gate-cli.d.ts +10 -1
  301. package/dist/workspace/trust/ref-gate-cli.d.ts.map +1 -1
  302. package/dist/workspace/trust/ref-gate-cli.js +93 -11
  303. package/dist/workspace/trust/ref-gate.d.ts +61 -2
  304. package/dist/workspace/trust/ref-gate.d.ts.map +1 -1
  305. package/dist/workspace/trust/ref-gate.js +72 -7
  306. package/dist/workspace/workspace-run.d.ts.map +1 -1
  307. package/dist/workspace/workspace-run.js +2 -1
  308. package/package.json +1 -1
  309. package/src/action-pins.ts +2 -0
  310. package/src/actor.test.ts +78 -0
  311. package/src/actor.ts +79 -0
  312. package/src/bundle-check.test.ts +22 -0
  313. package/src/bundle-check.ts +33 -5
  314. package/src/chant-install.test.ts +108 -1
  315. package/src/chant-install.ts +242 -2
  316. package/src/ci-base.test.ts +41 -0
  317. package/src/ci-base.ts +43 -0
  318. package/src/ci-comment-commands.test.ts +376 -0
  319. package/src/ci-comment-commands.ts +389 -0
  320. package/src/ci-comment-replies.ts +78 -0
  321. package/src/ci-commit.test.ts +51 -6
  322. package/src/ci-commit.ts +1 -2
  323. package/src/ci-control.ts +1 -0
  324. package/src/ci-evidence-claims.ts +102 -0
  325. package/src/ci-evidence-from-job.test.ts +165 -0
  326. package/src/ci-evidence-from-job.ts +251 -0
  327. package/src/ci-evidence-jobs.ts +88 -6
  328. package/src/ci-handover.ts +16 -3
  329. package/src/ci-identity.test.ts +3 -3
  330. package/src/ci-identity.ts +51 -11
  331. package/src/ci-image.test.ts +187 -16
  332. package/src/ci-image.ts +157 -25
  333. package/src/ci-jobs.ts +7 -2
  334. package/src/ci-login.test.ts +131 -3
  335. package/src/ci-login.token-drop.test.ts +204 -0
  336. package/src/ci-login.ts +137 -39
  337. package/src/ci-note-commands.ts +104 -41
  338. package/src/ci-product-words.ts +89 -0
  339. package/src/ci-product.ts +62 -1
  340. package/src/cli/commands/__fixtures__/source-dir-root/migrations/0001-init/backfill.ts +3 -0
  341. package/src/cli/commands/build.test.ts +41 -0
  342. package/src/cli/commands/build.ts +27 -2
  343. package/src/cli/handlers/approve-confirm.test.ts +35 -0
  344. package/src/cli/handlers/approve-confirm.ts +44 -0
  345. package/src/cli/handlers/approve.ts +2 -1
  346. package/src/cli/handlers/build-source-dir.test.ts +4 -0
  347. package/src/cli/handlers/build.ts +20 -2
  348. package/src/cli/handlers/ci-check.ts +37 -7
  349. package/src/cli/handlers/ci-evidence-open.test.ts +164 -0
  350. package/src/cli/handlers/ci-evidence.ts +233 -18
  351. package/src/cli/handlers/ci-forge-check.ts +22 -9
  352. package/src/cli/handlers/components.ts +3 -1
  353. package/src/cli/handlers/generated-check.ts +69 -0
  354. package/src/cli/handlers/lifecycle.test.ts +20 -0
  355. package/src/cli/handlers/lifecycle.ts +4 -0
  356. package/src/cli/handlers/local-chant.ts +39 -1
  357. package/src/cli/handlers/lock-reach.test.ts +103 -0
  358. package/src/cli/handlers/lock.ts +100 -4
  359. package/src/cli/handlers/pr-comment.ts +104 -0
  360. package/src/cli/handlers/pr-env.ts +6 -3
  361. package/src/cli/handlers/pr-record.test.ts +1 -1
  362. package/src/cli/handlers/pr.ts +93 -15
  363. package/src/cli/handlers/promote.ts +2 -1
  364. package/src/cli/handlers/release.e2e.test.ts +35 -0
  365. package/src/cli/handlers/release.ts +14 -2
  366. package/src/cli/handlers/run-wave.ts +35 -2
  367. package/src/cli/handlers/run.ts +2 -1
  368. package/src/cli/main.ts +60 -4
  369. package/src/cli/parse-args.ts +58 -0
  370. package/src/cli/registry.ts +35 -0
  371. package/src/components/auto-release.ts +2 -1
  372. package/src/components/check-hooks.ts +22 -0
  373. package/src/components/check-report-summary.test.ts +78 -0
  374. package/src/components/pr-checks.ts +254 -0
  375. package/src/components/pr-pipeline.ts +43 -1
  376. package/src/components/product-pipeline.ts +113 -9
  377. package/src/components/product-plan.test.ts +140 -1
  378. package/src/components/product-plan.ts +707 -20
  379. package/src/config.ts +13 -8
  380. package/src/control/consumers.ts +7 -0
  381. package/src/dead-guards.test.ts +27 -5
  382. package/src/dead-guards.ts +9 -6
  383. package/src/discovery/files.ts +1 -1
  384. package/src/drift-issue.test.ts +29 -1
  385. package/src/drift-issue.ts +28 -3
  386. package/src/drift-record.test.ts +45 -0
  387. package/src/drift-record.ts +71 -6
  388. package/src/floor-table.data.ts +81 -21
  389. package/src/floor-table.ts +12 -9
  390. package/src/forge-check/contract.ts +23 -2
  391. package/src/forge-check/forge-check.test.ts +25 -0
  392. package/src/forge-check/index.ts +4 -0
  393. package/src/forge-flags.test.ts +25 -1
  394. package/src/forge-flags.ts +34 -0
  395. package/src/forge-remote.test.ts +37 -0
  396. package/src/forge-remote.ts +79 -0
  397. package/src/gate-resume-run.ts +27 -3
  398. package/src/generated-check.e2e.test.ts +118 -0
  399. package/src/generated-check.test.ts +170 -0
  400. package/src/generated-check.ts +310 -0
  401. package/src/image-pins.ts +31 -0
  402. package/src/lexicon.ts +28 -0
  403. package/src/lifecycle/git.test.ts +48 -0
  404. package/src/lifecycle/git.ts +27 -4
  405. package/src/lifecycle/publish-npm.ts +87 -4
  406. package/src/lifecycle/reach-locks.test.ts +87 -0
  407. package/src/lifecycle/reach-locks.ts +169 -0
  408. package/src/lifecycle/release-catalog.test.ts +2 -2
  409. package/src/lifecycle/release-cut.ts +17 -1
  410. package/src/lifecycle/release-images-dockerfile.test.ts +20 -0
  411. package/src/lifecycle/release-images.test.ts +100 -0
  412. package/src/lifecycle/release-images.ts +38 -3
  413. package/src/lifecycle/release-ledger.ts +4 -3
  414. package/src/local-chant.e2e.test.ts +81 -6
  415. package/src/local-chant.test.ts +22 -3
  416. package/src/local-chant.ts +130 -13
  417. package/src/notify-product.ts +19 -8
  418. package/src/op/activities/source-release.ts +2 -1
  419. package/src/op/activities/source-rollback.ts +2 -1
  420. package/src/op/gate-resume.test.ts +27 -0
  421. package/src/op/index.ts +10 -0
  422. package/src/op/op-waves-evidence-jobs.ts +140 -0
  423. package/src/op/op-waves-evidence.test.ts +36 -3
  424. package/src/op/op-waves-evidence.ts +23 -3
  425. package/src/op/op-waves-notify-words.test.ts +18 -0
  426. package/src/op/op-waves-render-spec.test.ts +160 -0
  427. package/src/op/op-waves-render-spec.ts +171 -0
  428. package/src/op/op-waves-run.ts +59 -3
  429. package/src/op/op-waves.ts +16 -2
  430. package/src/op/schedule-overdue.test.ts +126 -1
  431. package/src/op/schedule-overdue.ts +164 -12
  432. package/src/op/wave-stop.test.ts +72 -0
  433. package/src/op/wave-stop.ts +137 -0
  434. package/src/planned-files.test.ts +80 -0
  435. package/src/planned-files.ts +134 -0
  436. package/src/pr-forge-job.test.ts +53 -0
  437. package/src/pr-forge-job.ts +46 -0
  438. package/src/pr-forge-reads-compare.test.ts +2 -1
  439. package/src/pr-forge-reads.ts +37 -1
  440. package/src/pr-forge.ts +14 -3
  441. package/src/pr-loop-narrowed.test.ts +2 -1
  442. package/src/pr-loop-words.test.ts +2 -1
  443. package/src/pr-loop.test.ts +1 -2
  444. package/src/pr-loop.ts +4 -80
  445. package/src/pr-plan-note.ts +184 -3
  446. package/src/pr-plan-record.test.ts +75 -0
  447. package/src/pr-plan-record.ts +101 -0
  448. package/src/pr-post-plan-note.test.ts +60 -0
  449. package/src/pr-post-replan.test.ts +144 -0
  450. package/src/pr-post-subject.test.ts +230 -0
  451. package/src/pr-post.test.ts +32 -1
  452. package/src/pr-post.ts +254 -15
  453. package/src/pr-requires.test.ts +20 -0
  454. package/src/pr-requires.ts +10 -1
  455. package/src/pr-status.ts +91 -0
  456. package/src/ref-gate-init.ts +208 -0
  457. package/src/ref-gate-rules.ts +26 -0
  458. package/src/release-floors.ts +139 -17
  459. package/src/render-module.ts +73 -0
  460. package/src/state-migration-record.test.ts +89 -0
  461. package/src/state-migration.test.ts +1 -1
  462. package/src/state-migration.ts +52 -4
  463. package/src/state-unlock.test.ts +33 -1
  464. package/src/state-unlock.ts +49 -1
  465. package/src/workspace/ci-green-cli.ts +14 -7
  466. package/src/workspace/ci-green-workflow.test.ts +32 -1
  467. package/src/workspace/drift-cli.ts +6 -18
  468. package/src/workspace/forge-work.ts +7 -14
  469. package/src/workspace/lexicon-outputs.ts +2 -2
  470. package/src/workspace/release-train.ts +2 -1
  471. package/src/workspace/release-workflow.test.ts +104 -3
  472. package/src/workspace/release-workflow.ts +60 -9
  473. package/src/workspace/trust/check-evidence-report.ts +39 -8
  474. package/src/workspace/trust/check-evidence.test.ts +5 -0
  475. package/src/workspace/trust/check-evidence.ts +17 -5
  476. package/src/workspace/trust/evidence.ts +5 -0
  477. package/src/workspace/trust/open-evidence.ts +129 -0
  478. package/src/workspace/trust/ref-gate-cli.ts +88 -10
  479. package/src/workspace/trust/ref-gate-pieces.test.ts +220 -0
  480. package/src/workspace/trust/ref-gate.e2e.test.ts +17 -0
  481. package/src/workspace/trust/ref-gate.test.ts +10 -0
  482. package/src/workspace/trust/ref-gate.ts +87 -6
  483. package/src/workspace/workspace-run.ts +2 -1
@@ -0,0 +1,310 @@
1
+ /**
2
+ * `@intentius/chant/generated-check` (#4909): the check that a product's
3
+ * committed generated files are what their sources render.
4
+ *
5
+ * A product commits files that chant or its own scripts render from
6
+ * TypeScript: workflows GitHub reads, Dockerfiles, a JSON Schema, a stack's
7
+ * configs. Each product carried its own drift check for them: terragucci's
8
+ * `just ci-check` rendered every one into a `mktemp -d` dir, compared it with
9
+ * `diff -u` and cleaned up with `rm -rf`, and plywood's `build-images.mjs
10
+ * --check` and `build-schema.mjs --check` compared in memory. Here a product
11
+ * declares its renders in `chantGenerated` in its root package.json, and
12
+ * `chant dev generated-check` runs them:
13
+ *
14
+ * 1. make one directory under the OS temp directory, the render tree;
15
+ * 2. run every render's command in the product root at once, with `{out}`
16
+ * in the command and `CHANT_GENERATED_OUT` in its environment naming that
17
+ * tree, so each writes its files at their committed paths below it;
18
+ * 3. compare each declared file with its render, in declaration order, and
19
+ * fail naming every file that differs, is missing on either side, or a
20
+ * render that failed.
21
+ *
22
+ * The render tree is never removed: it is left for the OS to clear, and the
23
+ * check prints where it is, so a failure can be read there.
24
+ *
25
+ * chant's own writers read `CHANT_GENERATED_OUT` too ({@link renderPathOf},
26
+ * {@link committedPathOf}): under a check, `chant ci workflow` and `chant
27
+ * release workflow` write every file into the render tree, the trigger edits
28
+ * to other workflows included, and name the committed path in their header,
29
+ * so the render matches the file that was written without `--output`. #4950:
30
+ * with no `--output` they write into the render tree too.
31
+ *
32
+ * A render can also be a module and its export (#4950, `./render-module`):
33
+ * the check imports the module and writes the `{ path: text }` files the
34
+ * export returns below the render tree, with no command or bundler.
35
+ *
36
+ * This module imports only Node's own modules; a module render loads
37
+ * `./render-module` when it runs.
38
+ */
39
+ import { spawn } from "node:child_process";
40
+ import { existsSync, mkdtempSync, readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
41
+ import { tmpdir } from "node:os";
42
+ import { isAbsolute, join, relative, resolve } from "node:path";
43
+
44
+ /** The render tree of the running check, for chant's own writers and a product's scripts. */
45
+ export const GENERATED_OUT_ENV = "CHANT_GENERATED_OUT";
46
+ /** The product root the check renders for: the committed paths are relative to it. */
47
+ export const GENERATED_ROOT_ENV = "CHANT_GENERATED_ROOT";
48
+
49
+ /**
50
+ * One render: a command that writes some of the product's generated files,
51
+ * or (#4950) a module whose export returns them. Each render has `run`, or
52
+ * `module` and `export`.
53
+ */
54
+ export interface GeneratedRender {
55
+ /** A short name, in the output: `ci`, `images`. */
56
+ name: string;
57
+ /**
58
+ * A shell command run in the product root. `{out}` is the render tree,
59
+ * quoted for the shell; the command writes each file at its committed path
60
+ * below it (`npx chant build ci -o {out}/.github/workflows/ci.yml`).
61
+ */
62
+ run?: string;
63
+ /**
64
+ * #4950: a TypeScript or JavaScript module, relative to the product root,
65
+ * whose {@link export} is a `{ path: text }` object, or a function that
66
+ * returns one. chant imports it and writes each file at its path below the
67
+ * render tree, as `chant dev render <module> <export>` writes it in place.
68
+ */
69
+ module?: string;
70
+ /** The export of {@link module} that renders the files: `dockerfiles`. */
71
+ export?: string;
72
+ /**
73
+ * The committed files it renders, relative to the product root. A `*` in a
74
+ * path's last segment matches within it (`images/Dockerfile.*`), and then
75
+ * every match on either side must have its twin. A command render with no
76
+ * files passes when its command exits 0 (a script with a check of its
77
+ * own); a module render with no files compares every file it renders.
78
+ */
79
+ files?: string[];
80
+ }
81
+
82
+ /** `chantGenerated` in a product's root package.json (#4909). */
83
+ export interface GeneratedCheckConfig {
84
+ /** The command that writes the committed files, named in a failure: `just ci`. */
85
+ regenerate?: string;
86
+ renders: GeneratedRender[];
87
+ }
88
+
89
+ export interface GeneratedRenderResult {
90
+ name: string;
91
+ /** The command as run, `{out}` filled in. */
92
+ command: string;
93
+ exitCode: number;
94
+ /** Its stdout and stderr, together. */
95
+ output: string;
96
+ /** The committed files compared, relative to the product root. */
97
+ files: string[];
98
+ }
99
+
100
+ export interface GeneratedCheckResult {
101
+ ok: boolean;
102
+ /** The render tree, left in place. */
103
+ out: string;
104
+ problems: string[];
105
+ renders: GeneratedRenderResult[];
106
+ /** Each committed file that matched its render. */
107
+ matched: string[];
108
+ }
109
+
110
+ /** The `chantGenerated` field of the package.json in `productDir`, or undefined. Throws on a malformed one. */
111
+ export function readGeneratedCheckConfig(productDir: string): GeneratedCheckConfig | undefined {
112
+ const f = join(productDir, "package.json");
113
+ if (!existsSync(f)) return undefined;
114
+ const raw = (JSON.parse(readFileSync(f, "utf8")) as { chantGenerated?: unknown }).chantGenerated;
115
+ if (raw === undefined) return undefined;
116
+ const c = raw as Partial<GeneratedCheckConfig>;
117
+ if (!c || typeof c !== "object" || !Array.isArray(c.renders)) throw new Error(`${f}: chantGenerated needs a renders list`);
118
+ const names = new Set<string>();
119
+ for (const [i, r] of c.renders.entries()) {
120
+ if (!r || typeof r.name !== "string" || !r.name) throw new Error(`${f}: chantGenerated.renders[${i}] needs a name and a run command`);
121
+ const isRun = r.run !== undefined;
122
+ const isModule = r.module !== undefined || r.export !== undefined;
123
+ if (isRun === isModule) throw new Error(`${f}: chantGenerated.renders[${i}] needs a run command, or a module and its export`);
124
+ if (isRun && (typeof r.run !== "string" || !r.run)) throw new Error(`${f}: chantGenerated.renders[${i}] needs a name and a run command`);
125
+ if (isModule && (typeof r.module !== "string" || !r.module || typeof r.export !== "string" || !r.export)) throw new Error(`${f}: chantGenerated.renders[${i}] needs a module and the name of its export`);
126
+ if (isModule && (r.module!.startsWith("/") || r.module!.split("/").includes(".."))) throw new Error(`${f}: chantGenerated.renders[${i}].module must be a path inside the product`);
127
+ if (names.has(r.name)) throw new Error(`${f}: chantGenerated.renders names '${r.name}' twice`);
128
+ names.add(r.name);
129
+ if (r.files !== undefined && (!Array.isArray(r.files) || r.files.some((p) => typeof p !== "string" || p.startsWith("/") || p.split("/").includes("..")))) {
130
+ throw new Error(`${f}: chantGenerated.renders[${i}].files must be paths inside the product`);
131
+ }
132
+ }
133
+ if (c.regenerate !== undefined && typeof c.regenerate !== "string") throw new Error(`${f}: chantGenerated.regenerate must be a command`);
134
+ return c as GeneratedCheckConfig;
135
+ }
136
+
137
+ /** Quote one argument for `sh`. */
138
+ const shellQuote = (s: string) => (/^[A-Za-z0-9._\/=:@%+,-]+$/.test(s) ? s : `'${s.replace(/'/g, `'\\''`)}'`);
139
+
140
+ /** The render tree and product root of the running check, or undefined outside one. */
141
+ function renderEnv(): { out: string; root: string } | undefined {
142
+ const out = process.env[GENERATED_OUT_ENV];
143
+ const root = process.env[GENERATED_ROOT_ENV];
144
+ return out && root ? { out: resolve(out), root: resolve(root) } : undefined;
145
+ }
146
+
147
+ /** Whether `path` is `dir` or below it. */
148
+ const within = (dir: string, path: string) => {
149
+ const r = relative(dir, resolve(path));
150
+ return !r.startsWith("..") && !isAbsolute(r);
151
+ };
152
+
153
+ /**
154
+ * Where a chant writer puts `path` (absolute): under a check, a path inside
155
+ * the product root moves to the same place in the render tree, so a check
156
+ * never writes the product's files. Outside a check, `path` itself.
157
+ */
158
+ export function renderPathOf(path: string): string {
159
+ const env = renderEnv();
160
+ if (!env || within(env.out, path) || !within(env.root, path)) return path;
161
+ return join(env.out, relative(env.root, path));
162
+ }
163
+
164
+ /** The committed path a render-tree path stands for, so a header names it; any other path is itself. */
165
+ export function committedPathOf(path: string): string {
166
+ const env = renderEnv();
167
+ if (!env || !within(env.out, path)) return path;
168
+ return join(env.root, relative(env.out, path));
169
+ }
170
+
171
+ /** Whether `path` (absolute) is in the render tree of a running check. */
172
+ export function isRenderPath(path: string): boolean {
173
+ const env = renderEnv();
174
+ return env !== undefined && within(env.out, path);
175
+ }
176
+
177
+ /** The files a declared path names under `base`, relative to it: the path itself, or a last-segment `*` pattern's matches. */
178
+ function expand(base: string, path: string): string[] {
179
+ const last = path.lastIndexOf("/");
180
+ const dir = last < 0 ? "" : path.slice(0, last);
181
+ const name = path.slice(last + 1);
182
+ if (!name.includes("*")) return existsSync(join(base, path)) ? [path] : [];
183
+ const re = new RegExp(`^${name.split("*").map((p) => p.replace(/[.+?^${}()|[\]\\]/g, "\\$&")).join("[^/]*")}$`);
184
+ const at = join(base, dir);
185
+ if (!existsSync(at) || !statSync(at).isDirectory()) return [];
186
+ return readdirSync(at)
187
+ .filter((f) => re.test(f) && statSync(join(at, f)).isFile())
188
+ .sort()
189
+ .map((f) => (dir ? `${dir}/${f}` : f));
190
+ }
191
+
192
+ /** A short line diff of two texts: the first lines that differ, with a little context. */
193
+ export function diffLines(committed: string, rendered: string, max = 12): string[] {
194
+ const a = committed.split("\n");
195
+ const b = rendered.split("\n");
196
+ let start = 0;
197
+ while (start < a.length && start < b.length && a[start] === b[start]) start++;
198
+ let endA = a.length;
199
+ let endB = b.length;
200
+ while (endA > start && endB > start && a[endA - 1] === b[endB - 1]) {
201
+ endA--;
202
+ endB--;
203
+ }
204
+ const out = [`@@ line ${start + 1} @@`];
205
+ for (const l of a.slice(Math.max(0, start - 2), start)) out.push(` ${l}`);
206
+ const removed = a.slice(start, endA).map((l) => `- ${l}`);
207
+ const added = b.slice(start, endB).map((l) => `+ ${l}`);
208
+ const body = [...removed, ...added];
209
+ out.push(...body.slice(0, max));
210
+ if (body.length > max) out.push(` ... ${body.length - max} more changed lines`);
211
+ return out;
212
+ }
213
+
214
+ /** Run one render; resolves with its exit code and output. */
215
+ function runRender(command: string, cwd: string, env: NodeJS.ProcessEnv): Promise<{ exitCode: number; output: string }> {
216
+ return new Promise((done) => {
217
+ const child = spawn("sh", ["-c", command], { cwd, env, stdio: ["ignore", "pipe", "pipe"] });
218
+ const chunks: Buffer[] = [];
219
+ child.stdout.on("data", (c: Buffer) => chunks.push(c));
220
+ child.stderr.on("data", (c: Buffer) => chunks.push(c));
221
+ child.on("error", (err) => done({ exitCode: 127, output: String(err) }));
222
+ child.on("close", (code, signal) => done({ exitCode: code ?? (signal ? 128 : 1), output: Buffer.concat(chunks).toString("utf8") }));
223
+ });
224
+ }
225
+
226
+ export interface GeneratedCheckOptions {
227
+ /** Only these renders, by name. */
228
+ only?: string[];
229
+ /** The render tree's parent directory (default: the OS temp directory). */
230
+ tmpDir?: string;
231
+ }
232
+
233
+ /**
234
+ * Render the product's declared generated files into a fresh directory under
235
+ * the OS temp directory and compare each with the committed file (#4909).
236
+ * The directory is left in place and named in the result.
237
+ */
238
+ export async function checkGenerated(productDir: string, config: GeneratedCheckConfig, opts: GeneratedCheckOptions = {}): Promise<GeneratedCheckResult> {
239
+ const root = realpathSync(resolve(productDir));
240
+ const out = realpathSync(mkdtempSync(join(opts.tmpDir ?? tmpdir(), "chant-generated-")));
241
+ const problems: string[] = [];
242
+ let renders = config.renders;
243
+ if (opts.only?.length) {
244
+ const unknown = opts.only.filter((n) => !renders.some((r) => r.name === n));
245
+ if (unknown.length) problems.push(`chantGenerated has no render named ${unknown.map((n) => `'${n}'`).join(", ")}`);
246
+ renders = renders.filter((r) => opts.only!.includes(r.name));
247
+ }
248
+ const env = { ...process.env, [GENERATED_OUT_ENV]: out, [GENERATED_ROOT_ENV]: root };
249
+ const ran = await Promise.all(
250
+ renders.map(async (r) => {
251
+ if (r.module !== undefined) {
252
+ // #4950: a module render runs here, in chant's process, with the
253
+ // TypeScript loader and chant served as itself. Exit 1 and the error
254
+ // stand in for a command's exit code and output.
255
+ const command = `chant dev render ${shellQuote(r.module)} ${shellQuote(r.export!)}`;
256
+ try {
257
+ const { renderModuleFiles, writeRenderedFiles } = await import("./render-module");
258
+ const rendered = await renderModuleFiles(r.module, r.export!, root);
259
+ writeRenderedFiles(out, rendered);
260
+ return { r, command, exitCode: 0, output: "", rendered: Object.keys(rendered) };
261
+ } catch (err) {
262
+ return { r, command, exitCode: 1, output: err instanceof Error ? err.message : String(err) };
263
+ }
264
+ }
265
+ const command = r.run!.split("{out}").join(shellQuote(out));
266
+ return { r, command, ...(await runRender(command, root, env)) };
267
+ }),
268
+ );
269
+
270
+ const results: GeneratedRenderResult[] = [];
271
+ const matched: string[] = [];
272
+ const hint = config.regenerate ? ` Run '${config.regenerate}' and commit the result.` : "";
273
+ for (const { r, command, exitCode, output, rendered } of ran as ((typeof ran)[number] & { rendered?: string[] })[]) {
274
+ const files: string[] = [];
275
+ results.push({ name: r.name, command, exitCode, output, files });
276
+ if (exitCode !== 0) {
277
+ problems.push(`render '${r.name}' exited ${exitCode}: ${command}${output.trim() ? `\n${output.trimEnd().split("\n").map((l) => ` ${l}`).join("\n")}` : ""}`);
278
+ continue;
279
+ }
280
+ // A module render with no files compares every file it rendered.
281
+ for (const path of r.files ?? rendered ?? []) {
282
+ const committed = expand(root, path);
283
+ const rendered = expand(out, path);
284
+ if (!path.includes("*") && rendered.length === 0) {
285
+ problems.push(`render '${r.name}' wrote no ${path} under the render tree`);
286
+ continue;
287
+ }
288
+ if (path.includes("*") && committed.length === 0 && rendered.length === 0) {
289
+ problems.push(`${path} matches no file, committed or rendered by '${r.name}'`);
290
+ continue;
291
+ }
292
+ for (const f of [...new Set([...committed, ...rendered])].sort()) {
293
+ files.push(f);
294
+ if (!rendered.includes(f)) {
295
+ problems.push(`${f} is committed, but '${r.name}' no longer renders it.${hint}`);
296
+ continue;
297
+ }
298
+ if (!committed.includes(f)) {
299
+ problems.push(`${f} is what '${r.name}' renders, but it is not committed.${hint}`);
300
+ continue;
301
+ }
302
+ const a = readFileSync(join(root, f), "utf8");
303
+ const b = readFileSync(join(out, f), "utf8");
304
+ if (a === b) matched.push(f);
305
+ else problems.push(`${f} is not what '${r.name}' renders.${hint}\n${diffLines(a, b).map((l) => ` ${l}`).join("\n")}`);
306
+ }
307
+ }
308
+ }
309
+ return { ok: problems.length === 0, out, problems, renders: results, matched };
310
+ }
@@ -0,0 +1,31 @@
1
+ /**
2
+ * The container images the workflows chant generates run, each pinned by the
3
+ * digest of its image index (#4941), as {@link ../action-pins.ts} pins the
4
+ * actions by commit. A tag can move; a digest cannot. A generator takes its
5
+ * image reference from here, so an update is one change to this table. Each
6
+ * row names the tag it followed when it was resolved, which the reference
7
+ * keeps beside the digest so a reader sees the release.
8
+ *
9
+ * Refresh a row by resolving its tag to the index digest:
10
+ *
11
+ * docker buildx imagetools inspect tonistiigi/binfmt:qemu-v10.2.3 --format '{{.Manifest.Digest}}'
12
+ */
13
+
14
+ export interface ImagePin {
15
+ /** The repository, as `docker run` names it: `tonistiigi/binfmt`. */
16
+ readonly repository: string;
17
+ /** The tag the row followed when it was resolved. */
18
+ readonly tag: string;
19
+ /** The image index digest, `sha256:<hex>`. */
20
+ readonly digest: string;
21
+ }
22
+
23
+ const pin = (repository: string, tag: string, digest: string): ImagePin => ({ repository, tag, digest });
24
+
25
+ export const IMAGE_PINS = {
26
+ // #4941: the GitLab release workflow's QEMU binfmt setup (#4876); `latest` pointed at this index on 2026-11-10.
27
+ binfmt: pin("tonistiigi/binfmt", "qemu-v10.2.3", "sha256:400a4873b838d1b89194d982c45e5fb3cda4593fbfd7e08a02e76b03b21166f0"),
28
+ } as const satisfies Record<string, ImagePin>;
29
+
30
+ /** The reference a pin is run by: `<repository>:<tag>@<digest>`. Docker pulls by the digest and ignores the tag. */
31
+ export const imageRef = (p: ImagePin): string => `${p.repository}:${p.tag}@${p.digest}`;
package/src/lexicon.ts CHANGED
@@ -793,6 +793,8 @@ export interface OpSetupUsesStep {
793
793
  * `assertSetupSteps`, which refuses both at build time.
794
794
  */
795
795
  uses: string;
796
+ /** The step's name on GitHub and Forgejo, such as "Log in to AWS" (#4932). GitLab script lines have none. Absent: the forge names it from the action. */
797
+ name?: string;
796
798
  /** The action's inputs, emitted as the step's `with:` mapping. */
797
799
  with?: Record<string, string | number | boolean>;
798
800
  /** Environment for this step alone, emitted as the step's `env:` mapping. */
@@ -803,6 +805,8 @@ export interface OpSetupUsesStep {
803
805
  export interface OpSetupRunStep {
804
806
  /** The shell line, emitted as the step's `run:`. */
805
807
  run: string;
808
+ /** The step's name on GitHub and Forgejo, such as "Log in to AWS" (#4932). GitLab script lines have none. Absent: the forge shows the line. */
809
+ name?: string;
806
810
  /** Environment for this step alone, emitted as the step's `env:` mapping. */
807
811
  env?: Record<string, string>;
808
812
  }
@@ -1170,6 +1174,17 @@ export interface OpWavesPipelineOptions
1170
1174
  * wave is planned. Absent: the jobs render as without it.
1171
1175
  */
1172
1176
  evidence?: import("./ci-evidence-jobs").PipelineEvidence;
1177
+ /**
1178
+ * A spec the job renders at run time (#4982,
1179
+ * `@intentius/chant/op/op-waves-render-spec`): every wave, deciding and
1180
+ * share job and the policy step runs `chant run wave --render-spec`, with
1181
+ * `CHANT_WAVES_SPEC_COMMAND` set to `command`, which prints the spec at
1182
+ * the commit in `CHANT_WAVES_SPEC_AT`. The spec handed to the generator
1183
+ * is the pipeline's shape (its waves, shares, job groups, `cloud`,
1184
+ * runners, environments and `holds.policy`); the rendered one sets the
1185
+ * rules. Absent: the jobs read the committed spec as before.
1186
+ */
1187
+ renderSpec?: import("./op/op-waves-render-spec").OpWavesRenderSpec;
1173
1188
  }
1174
1189
 
1175
1190
  /** A run step a product adds to a generated job (#4791): its name, and its shell lines in order. */
@@ -1936,6 +1951,19 @@ export interface LexiconPlugin {
1936
1951
  migrationSource?(from: string, to?: string): MigrationSource | undefined;
1937
1952
 
1938
1953
  // State
1954
+ /**
1955
+ * What a declared entity {@link describeResources} confirmed absent is,
1956
+ * when no snapshot says it was deployed (#4896). Left out, it is
1957
+ * `pending`: not deployed yet, the right reading for a cloud stack. A
1958
+ * lexicon whose environments always hold what is declared once they are
1959
+ * set up says `missing`, gone: the sql lexicon does, since a server that
1960
+ * lacks a declared table lost it. `chant lifecycle diff --live --json`
1961
+ * writes it as the lexicon section's `absent`, and the drift records
1962
+ * (`lexiconDriftRecords` on `@intentius/chant/drift-record`) read it from
1963
+ * there. The live diff's own `missing` list is unchanged.
1964
+ */
1965
+ liveAbsentStatus?: "pending" | "missing";
1966
+
1939
1967
  /**
1940
1968
  * Query deployed resources and return API metadata. Opt-in.
1941
1969
  *
@@ -634,6 +634,54 @@ describe("lifecycle/git", () => {
634
634
  }
635
635
  });
636
636
 
637
+ /** An update hook that refuses the first push with GitHub's words from plywood's 0.3.9 cut, and takes the rest (#4965). */
638
+ const refuseOnce = (remotePath: string) =>
639
+ writeFileSync(
640
+ join(remotePath, "hooks", "update"),
641
+ `#!/bin/sh\nif [ ! -f '${remotePath}/refused' ]; then touch '${remotePath}/refused'; echo 'fatal error in commit_refs_rules' >&2; exit 1; fi\nexit 0\n`,
642
+ { mode: 0o755 },
643
+ );
644
+
645
+ test("#4965: a push the remote refuses once is pushed again and lands", async () => {
646
+ const { b, remotePath, done } = await twoWriters();
647
+ try {
648
+ refuseOnce(remotePath);
649
+ await writeBlobToPath("prod", "release.json", '{"cut":1}', "Release cut", { cwd: b });
650
+ expect(await pushLifecycleRebasing({ cwd: b, requireLanded: true, waitMs: 0 })).toEqual({ pushed: true });
651
+ expect(git(["rev-parse", "refs/heads/chant/lifecycle"], remotePath).stdout.trim()).toBe(git(["rev-parse", "refs/heads/chant/lifecycle"], b).stdout.trim());
652
+ } finally {
653
+ await done();
654
+ }
655
+ });
656
+
657
+ test("#4965: the first push of the branch, refused once, is pushed again and lands", async () => {
658
+ const { clonePath, remotePath, cleanup } = await setupClonePair();
659
+ try {
660
+ refuseOnce(remotePath);
661
+ await writeBlobToPath("prod", "release.json", '{"cut":1}', "Release cut", { cwd: clonePath });
662
+ expect(await pushLifecycleRebasing({ cwd: clonePath, requireLanded: true, waitMs: 0 })).toEqual({ pushed: true });
663
+ expect(git(["show", "chant/lifecycle:prod/release.json"], remotePath).stdout).toBe('{"cut":1}');
664
+ } finally {
665
+ await cleanup();
666
+ }
667
+ });
668
+
669
+ test("#4965: with requireLanded, a push that fails for another reason is tried again and then throws", async () => {
670
+ const { clonePath, cleanup } = await setupClonePair();
671
+ try {
672
+ await writeBlobToPath("prod", "release.json", '{"cut":1}', "Release cut", { cwd: clonePath });
673
+ git(["remote", "set-url", "origin", join(tmpdir(), `chant-no-such-remote-${Date.now()}`)], clonePath);
674
+ // Without it the failure is a warning, as before.
675
+ expect((await pushLifecycleRebasing({ cwd: clonePath })).pushed).toBe(false);
676
+ const err = await pushLifecycleRebasing({ cwd: clonePath, requireLanded: true, waitMs: 0 }).catch((e: unknown) => e);
677
+ expect(err).toBeInstanceOf(LifecyclePushLostError);
678
+ expect((err as LifecyclePushLostError).tries).toBe(LIFECYCLE_PUSH_TRIES);
679
+ expect((err as Error).message).toContain("the push of chant/lifecycle to \"origin\" failed");
680
+ } finally {
681
+ await cleanup();
682
+ }
683
+ });
684
+
637
685
  test("plywood#22 finding 9: two writers that append lines to one ledger file both land, in push order", async () => {
638
686
  const { a, b, remotePath, done } = await twoWriters();
639
687
  try {
@@ -976,6 +976,9 @@ function pushReportOf(result: LifecyclePushStatus): { pushed: boolean; pushWarni
976
976
  /** How many pushes {@link pushLifecycleRebasing} makes, as the snapshot store's `publishRef` does. */
977
977
  export const LIFECYCLE_PUSH_TRIES = 3;
978
978
 
979
+ /** With `requireLanded`, how long {@link pushLifecycleRebasing} waits after a failed push, times the try's number (#4965). */
980
+ export const LIFECYCLE_PUSH_WAIT_MS = 2_000;
981
+
979
982
  /**
980
983
  * Thrown by {@link pushLifecycleRebasing} when the ledger branch did not reach
981
984
  * the remote: another writer pushed before each of its tries, or this
@@ -1013,6 +1016,8 @@ async function rebaseLifecycleOnRemote(remote: string, cwd?: string): Promise<{
1013
1016
  const firstLine = (s: string | undefined) => (s ?? "").trim().split("\n")[0] ?? "";
1014
1017
  try {
1015
1018
  const fetched = await run(["fetch", "--no-tags", "--force", remote, `refs/heads/${STATE_BRANCH}:${REBASE_REF}`]);
1019
+ // #4965: the remote refused the branch's first push (a hook, a rule) and still has none: nothing to replay onto.
1020
+ if (fetched.exitCode !== 0 && /couldn't find remote ref/i.test(fetched.stderr ?? "")) return { rebased: 0 };
1016
1021
  if (fetched.exitCode !== 0) return { error: `the fetch of the remote's tip failed (git said: ${firstLine(fetched.stderr)})` };
1017
1022
  const remoteTip = (await run(["rev-parse", "--verify", REBASE_REF])).stdout.trim();
1018
1023
  const local = await getStateBranchTip(cwd);
@@ -1206,22 +1211,40 @@ async function replayAppends(parent: string, commit: string, onto: string, cwd?:
1206
1211
  * remote, recording off and a push git refused for another reason (no
1207
1212
  * network, no credentials) are returned as {@link pushLifecycleReport}
1208
1213
  * returns them.
1214
+ *
1215
+ * `requireLanded` (#4965) is for a writer that must not go on without its
1216
+ * record on the remote, such as `chant release cut` before the workflow pushes
1217
+ * the release tag: a push git refused for another reason is tried again too,
1218
+ * `waitMs` times the try's number after it (default
1219
+ * {@link LIFECYCLE_PUSH_WAIT_MS}), and the last refusal throws
1220
+ * {@link LifecyclePushLostError}. No remote and recording off still return.
1209
1221
  */
1210
- export async function pushLifecycleRebasing(opts?: { cwd?: string; tries?: number }): Promise<{ pushed: boolean; pushWarning?: string }> {
1222
+ export async function pushLifecycleRebasing(opts?: { cwd?: string; tries?: number; requireLanded?: boolean; waitMs?: number }): Promise<{ pushed: boolean; pushWarning?: string }> {
1211
1223
  const tries = Math.max(1, opts?.tries ?? LIFECYCLE_PUSH_TRIES);
1212
1224
  const cwd = opts?.cwd;
1225
+ const waitMs = opts?.waitMs ?? LIFECYCLE_PUSH_WAIT_MS;
1213
1226
  for (let attempt = 1; ; attempt++) {
1214
1227
  let result: LifecyclePushStatus;
1215
1228
  try {
1216
1229
  result = await pushLifecycleStatus({ cwd });
1217
1230
  } catch (err) {
1218
- return { pushed: false, pushWarning: err instanceof Error ? err.message : String(err) };
1231
+ const message = err instanceof Error ? err.message : String(err);
1232
+ if (!opts?.requireLanded) return { pushed: false, pushWarning: message };
1233
+ result = { status: "failed", remote: "(unknown)", stderr: message };
1234
+ }
1235
+ if (result.status === "failed" && opts?.requireLanded) {
1236
+ if (attempt >= tries) throw new LifecyclePushLostError(result.remote, attempt, describeLifecyclePush(result) ?? "the push did not land");
1237
+ if (waitMs > 0) await new Promise((r) => setTimeout(r, waitMs * attempt));
1238
+ continue;
1219
1239
  }
1220
1240
  if (result.status !== "stale") return pushReportOf(result);
1221
1241
  if (attempt >= tries) {
1222
- const said = result.stderr.trim().split("\n")[0];
1223
- throw new LifecyclePushLostError(result.remote, attempt, `another writer pushed before each try${said ? ` (git said: ${said})` : ""}`);
1242
+ // #4965: "[remote rejected]" is the remote's own refusal (a hook, a rule), which no other writer explains.
1243
+ const said = result.stderr.trim().split("\n").find((l) => /remote rejected/.test(l))?.trim() ?? result.stderr.trim().split("\n")[0];
1244
+ const why = /remote rejected/.test(result.stderr) ? "the remote refused each try" : "another writer pushed before each try";
1245
+ throw new LifecyclePushLostError(result.remote, attempt, `${why}${said ? ` (git said: ${said})` : ""}`);
1224
1246
  }
1247
+ if (opts?.requireLanded && waitMs > 0) await new Promise((r) => setTimeout(r, waitMs * attempt));
1225
1248
  const rebased = await rebaseLifecycleOnRemote(result.remote, cwd);
1226
1249
  if ("error" in rebased) throw new LifecyclePushLostError(result.remote, attempt, rebased.error);
1227
1250
  }
@@ -53,9 +53,9 @@
53
53
  */
54
54
 
55
55
  import { execFileSync, spawn } from "node:child_process";
56
- import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
56
+ import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
57
57
  import { tmpdir } from "node:os";
58
- import { join } from "node:path";
58
+ import { join, relative, resolve, sep } from "node:path";
59
59
  import { packageSbom } from "./publish-attachments";
60
60
  import type { NpmPublishDeclaration } from "./publish-declaration";
61
61
  import { checkReleaseDigest, fileDigest, isDir, memberFile, publishTargetKey } from "./publish-targets";
@@ -194,6 +194,83 @@ export function checkPackagePins(decl: Pick<NpmPublishDeclaration, "pins">, rele
194
194
  if (found === 0) throw new PublishTargetError("publish-npm-pins-missing", `no package of the npm target holds ${decl.pins}, which pins names`, "Build the package so it carries the file, or remove pins.");
195
195
  }
196
196
 
197
+ /** The output of `npm pack --dry-run --json`: one entry per package, with the files it would carry. */
198
+ type NpmPackListing = Array<{ files?: Array<{ path?: unknown }> }>;
199
+
200
+ /**
201
+ * #4934: refuse a package that would carry an image archive the release
202
+ * records (`release.images`). In a dispatched release the publish job takes
203
+ * the cut's archives into their directory under the checkout, as the tag
204
+ * workflow's `release images` and a workstation cut write them there, so a
205
+ * package whose `files` takes that directory packs the image and the registry
206
+ * refuses it (413) after the other targets published. For each package that
207
+ * an archive lies inside, `npm pack --dry-run --json --ignore-scripts` lists
208
+ * what `npm publish` would send, and an archive among it, or a file under an
209
+ * archive that is a layout directory, is refused at the plan, before any
210
+ * target publishes, naming the file and the `files` entry that leaves it out.
211
+ * A package no archive lies inside runs no npm, and a packed `.tgz` holds
212
+ * what it was packed with, which the plan reads as it is.
213
+ */
214
+ export function checkPackageImages(release: PublishContext["release"], cwd: string, pkgs: ReadonlyArray<Pick<NpmPackage, "path" | "abs" | "name">>, bin = "npm", env: NodeJS.ProcessEnv = process.env): void {
215
+ const archives = release.artifactDigests.filter((a) => a.kind === "image" && a.path !== "").map((a) => ({ component: a.component, abs: resolve(cwd, a.path) }));
216
+ if (archives.length === 0) return;
217
+ for (const pkg of pkgs) {
218
+ if (!isDir(pkg.abs)) continue;
219
+ const inside = archives.map((a) => ({ ...a, rel: relative(pkg.abs, a.abs).split(sep).join("/") })).filter((a) => a.rel !== "" && a.rel !== ".." && !a.rel.startsWith("../"));
220
+ if (inside.length === 0) continue;
221
+ let files: string[];
222
+ try {
223
+ const out = execFileSync(bin, ["pack", "--dry-run", "--json", "--ignore-scripts"], { cwd: pkg.abs, env, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"], maxBuffer: 256 * 1024 * 1024 });
224
+ files = (JSON.parse(out.slice(out.indexOf("["))) as NpmPackListing).flatMap((e) => (e.files ?? []).map((f) => String(f.path)));
225
+ } catch (err) {
226
+ throw new PublishTargetError(
227
+ "publish-npm-pack-failed",
228
+ `npm pack --dry-run --json could not list what ${pkg.name} (${pkg.path}) carries, so whether it packs the image archive ${inside[0]!.rel} is not known: ${err instanceof Error ? err.message.split("\n")[0] : String(err)}`,
229
+ "Run npm pack --dry-run in the package to see why it fails.",
230
+ );
231
+ }
232
+ for (const a of inside) {
233
+ const carried = files.find((f) => f === a.rel || f.startsWith(`${a.rel}/`));
234
+ if (carried === undefined) continue;
235
+ throw new PublishTargetError(
236
+ "publish-npm-carries-image",
237
+ `${pkg.name} (${pkg.path}) would carry ${carried}, the archive of image "${a.component}" that release.images names; the image goes to its own target, and npmjs refuses a package that size (413)`,
238
+ `Add "!${a.rel}" to "files" in ${pkg.path === "." ? "" : `${pkg.path}/`}package.json (or ${a.rel} to its .npmignore when it has no "files"), so the package leaves the image out.`,
239
+ );
240
+ }
241
+ }
242
+ }
243
+
244
+ /**
245
+ * #4941: {@link checkPackageImages} for every npm target `release.publish`
246
+ * declares, run by the cut once the images are built and before anything is
247
+ * recorded, so a package that would carry an archive stops the cut instead of
248
+ * the publish job after the label is spent. A package that is not a
249
+ * directory with a package.json yet is left for the publish's plan to refuse.
250
+ */
251
+ export function checkDeclaredPackageImages(
252
+ decls: ReadonlyArray<{ type: string; packages?: readonly string[] }>,
253
+ release: PublishContext["release"],
254
+ cwd: string,
255
+ bin = "npm",
256
+ env: NodeJS.ProcessEnv = process.env,
257
+ ): void {
258
+ for (const decl of decls) {
259
+ if (decl.type !== "npm") continue;
260
+ const pkgs = (decl.packages ?? []).flatMap((path) => {
261
+ const abs = resolve(cwd, path);
262
+ if (!existsSync(abs) || !isDir(abs)) return [];
263
+ try {
264
+ const name = (JSON.parse(readFileSync(join(abs, "package.json"), "utf-8")) as { name?: unknown }).name;
265
+ return [{ path, abs, name: typeof name === "string" ? name : path }];
266
+ } catch {
267
+ return [];
268
+ }
269
+ });
270
+ checkPackageImages(release, cwd, pkgs, bin, env);
271
+ }
272
+ }
273
+
197
274
  export function npmTarget(decl: NpmPublishDeclaration, deps: PublishDeps): PublishTarget {
198
275
  const bin = deps.npm ?? "npm";
199
276
  const sleep = deps.sleep ?? ((ms: number) => new Promise<void>((r) => setTimeout(r, ms)));
@@ -249,8 +326,14 @@ export function npmTarget(decl: NpmPublishDeclaration, deps: PublishDeps): Publi
249
326
  return pkgs;
250
327
  };
251
328
  const extra = (pkg: NpmPackage) => ({ ...(pkg.digest ? { digest: pkg.digest } : {}), ...(pkg.sbom ? { sbom: pkg.sbom } : {}) });
329
+ /** #4934: what plan and stage read, with the image archives a package would carry refused. */
330
+ const readChecked = (ctx: PublishContext) => {
331
+ const pkgs = read(ctx);
332
+ checkPackageImages(ctx.release, ctx.cwd, pkgs, bin, ctx.env);
333
+ return pkgs;
334
+ };
252
335
  const plan = async (ctx: PublishContext): Promise<PublishItem[]> =>
253
- read(ctx).map((pkg) => ({ name: `${pkg.name}@${pkg.version}`, destination: staging ? `${shown(NPM_STAGE_TAG)}, then ${revealTag(ctx)}` : shown(revealTag(ctx)), ...extra(pkg) }));
336
+ readChecked(ctx).map((pkg) => ({ name: `${pkg.name}@${pkg.version}`, destination: staging ? `${shown(NPM_STAGE_TAG)}, then ${revealTag(ctx)}` : shown(revealTag(ctx)), ...extra(pkg) }));
254
337
  /**
255
338
  * In CI, install what was published into an empty directory and run
256
339
  * `npm audit signatures` there (#4049), which checks each package's
@@ -343,7 +426,7 @@ export function npmTarget(decl: NpmPublishDeclaration, deps: PublishDeps): Publi
343
426
  key: publishTargetKey(decl),
344
427
  plan,
345
428
  async stage(ctx) {
346
- const pkgs = read(ctx);
429
+ const pkgs = readChecked(ctx);
347
430
  const items: PublishItem[] = [];
348
431
  for (const pkg of pkgs) {
349
432
  const item: PublishItem = { name: `${pkg.name}@${pkg.version}`, destination: shown(stageTag(ctx)), ...extra(pkg) };