@intentius/chant 0.124.55 → 0.124.57

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 (419) hide show
  1. package/dist/ci-agent.d.ts.map +1 -1
  2. package/dist/ci-agent.js +1 -2
  3. package/dist/ci-audit/attribution.d.ts +111 -0
  4. package/dist/ci-audit/attribution.d.ts.map +1 -0
  5. package/dist/ci-audit/attribution.js +194 -0
  6. package/dist/ci-audit/audit-log.d.ts +144 -0
  7. package/dist/ci-audit/audit-log.d.ts.map +1 -0
  8. package/dist/ci-audit/audit-log.js +149 -0
  9. package/dist/ci-audit/index.d.ts +12 -0
  10. package/dist/ci-audit/index.d.ts.map +1 -0
  11. package/dist/ci-audit/index.js +11 -0
  12. package/dist/ci-audit/unrecorded.d.ts +74 -0
  13. package/dist/ci-audit/unrecorded.d.ts.map +1 -0
  14. package/dist/ci-audit/unrecorded.js +95 -0
  15. package/dist/ci-audit.d.ts +3 -0
  16. package/dist/ci-audit.d.ts.map +1 -0
  17. package/dist/ci-audit.js +2 -0
  18. package/dist/ci-control.d.ts.map +1 -1
  19. package/dist/ci-control.js +3 -4
  20. package/dist/ci-estate.d.ts +24 -0
  21. package/dist/ci-estate.d.ts.map +1 -1
  22. package/dist/ci-estate.js +1 -2
  23. package/dist/ci-identity.d.ts.map +1 -1
  24. package/dist/ci-identity.js +2 -3
  25. package/dist/ci-job-guard.d.ts +139 -0
  26. package/dist/ci-job-guard.d.ts.map +1 -0
  27. package/dist/ci-job-guard.js +287 -0
  28. package/dist/ci-jobs.d.ts +7 -0
  29. package/dist/ci-jobs.d.ts.map +1 -1
  30. package/dist/ci-jobs.js +7 -0
  31. package/dist/ci-product-words.d.ts +7 -1
  32. package/dist/ci-product-words.d.ts.map +1 -1
  33. package/dist/ci-product-words.js +38 -4
  34. package/dist/ci-product.d.ts +35 -0
  35. package/dist/ci-product.d.ts.map +1 -1
  36. package/dist/ci-product.js +38 -4
  37. package/dist/ci-respond-run.d.ts +73 -0
  38. package/dist/ci-respond-run.d.ts.map +1 -0
  39. package/dist/ci-respond-run.js +247 -0
  40. package/dist/ci-respond.d.ts +189 -0
  41. package/dist/ci-respond.d.ts.map +1 -0
  42. package/dist/ci-respond.js +285 -0
  43. package/dist/cli/handlers/audit-log.d.ts +12 -0
  44. package/dist/cli/handlers/audit-log.d.ts.map +1 -0
  45. package/dist/cli/handlers/audit-log.js +81 -0
  46. package/dist/cli/handlers/build.d.ts +7 -0
  47. package/dist/cli/handlers/build.d.ts.map +1 -1
  48. package/dist/cli/handlers/build.js +81 -0
  49. package/dist/cli/handlers/ci-check-job.d.ts +11 -0
  50. package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
  51. package/dist/cli/handlers/ci-check-job.js +27 -0
  52. package/dist/cli/handlers/ci-check.d.ts.map +1 -1
  53. package/dist/cli/handlers/ci-check.js +38 -9
  54. package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
  55. package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
  56. package/dist/cli/handlers/e2e-safe-run.js +23 -0
  57. package/dist/cli/handlers/lifecycle.d.ts.map +1 -1
  58. package/dist/cli/handlers/lifecycle.js +14 -0
  59. package/dist/cli/handlers/pr.d.ts +5 -0
  60. package/dist/cli/handlers/pr.d.ts.map +1 -1
  61. package/dist/cli/handlers/pr.js +346 -36
  62. package/dist/cli/handlers/run-wave.js +89 -1
  63. package/dist/cli/main.d.ts.map +1 -1
  64. package/dist/cli/main.js +56 -2
  65. package/dist/cli/parse-args.d.ts.map +1 -1
  66. package/dist/cli/parse-args.js +107 -0
  67. package/dist/cli/registry.d.ts +38 -0
  68. package/dist/cli/registry.d.ts.map +1 -1
  69. package/dist/components/adoption.d.ts.map +1 -1
  70. package/dist/components/adoption.js +1 -2
  71. package/dist/components/auto-release.d.ts +5 -2
  72. package/dist/components/auto-release.d.ts.map +1 -1
  73. package/dist/components/auto-release.js +9 -4
  74. package/dist/components/capability.d.ts +47 -0
  75. package/dist/components/capability.d.ts.map +1 -1
  76. package/dist/components/capability.js +25 -0
  77. package/dist/components/check-hooks.d.ts +4 -1
  78. package/dist/components/check-hooks.d.ts.map +1 -1
  79. package/dist/components/check-steps.d.ts +74 -0
  80. package/dist/components/check-steps.d.ts.map +1 -0
  81. package/dist/components/check-steps.js +102 -0
  82. package/dist/components/ci-services.d.ts.map +1 -1
  83. package/dist/components/ci-services.js +1 -2
  84. package/dist/components/deploy-units.d.ts +12 -0
  85. package/dist/components/deploy-units.d.ts.map +1 -1
  86. package/dist/components/deploy-units.js +20 -1
  87. package/dist/components/driver.d.ts +12 -0
  88. package/dist/components/driver.d.ts.map +1 -1
  89. package/dist/components/driver.js +35 -1
  90. package/dist/components/groups.d.ts.map +1 -1
  91. package/dist/components/groups.js +4 -3
  92. package/dist/components/pr-env-ledger.d.ts.map +1 -1
  93. package/dist/components/pr-env-ledger.js +1 -2
  94. package/dist/components/pr-environment.d.ts +1 -1
  95. package/dist/components/pr-environment.d.ts.map +1 -1
  96. package/dist/components/pr-environment.js +1 -1
  97. package/dist/components/pr-pipeline.d.ts +137 -5
  98. package/dist/components/pr-pipeline.d.ts.map +1 -1
  99. package/dist/components/pr-pipeline.js +164 -20
  100. package/dist/components/pr-run.d.ts +8 -0
  101. package/dist/components/pr-run.d.ts.map +1 -1
  102. package/dist/components/pr-run.js +9 -4
  103. package/dist/components/product-pipeline.d.ts +35 -2
  104. package/dist/components/product-pipeline.d.ts.map +1 -1
  105. package/dist/components/product-pipeline.js +24 -5
  106. package/dist/components/row-lease.d.ts +22 -1
  107. package/dist/components/row-lease.d.ts.map +1 -1
  108. package/dist/components/row-lease.js +32 -6
  109. package/dist/components/wave-plan.d.ts +8 -0
  110. package/dist/components/wave-plan.d.ts.map +1 -1
  111. package/dist/components/wave-plan.js +18 -2
  112. package/dist/e2e-harness/bucket.d.ts +21 -0
  113. package/dist/e2e-harness/bucket.d.ts.map +1 -0
  114. package/dist/e2e-harness/bucket.js +61 -0
  115. package/dist/e2e-harness/claim.d.ts +70 -0
  116. package/dist/e2e-harness/claim.d.ts.map +1 -0
  117. package/dist/e2e-harness/claim.js +98 -0
  118. package/dist/e2e-harness/driver.d.ts +64 -0
  119. package/dist/e2e-harness/driver.d.ts.map +1 -0
  120. package/dist/e2e-harness/driver.js +243 -0
  121. package/dist/e2e-harness/forgejo.d.ts +77 -0
  122. package/dist/e2e-harness/forgejo.d.ts.map +1 -0
  123. package/dist/e2e-harness/forgejo.js +205 -0
  124. package/dist/e2e-harness/git.d.ts +32 -0
  125. package/dist/e2e-harness/git.d.ts.map +1 -0
  126. package/dist/e2e-harness/git.js +67 -0
  127. package/dist/e2e-harness/index.d.ts +22 -0
  128. package/dist/e2e-harness/index.d.ts.map +1 -0
  129. package/dist/e2e-harness/index.js +47 -0
  130. package/dist/e2e-harness/jobs.d.ts +8 -0
  131. package/dist/e2e-harness/jobs.d.ts.map +1 -0
  132. package/dist/e2e-harness/jobs.js +34 -0
  133. package/dist/e2e-harness/pins.d.ts +45 -0
  134. package/dist/e2e-harness/pins.d.ts.map +1 -0
  135. package/dist/e2e-harness/pins.js +44 -0
  136. package/dist/e2e-harness/ports.d.ts +113 -0
  137. package/dist/e2e-harness/ports.d.ts.map +1 -0
  138. package/dist/e2e-harness/ports.js +4 -0
  139. package/dist/e2e-harness/reports.d.ts +45 -0
  140. package/dist/e2e-harness/reports.d.ts.map +1 -0
  141. package/dist/e2e-harness/reports.js +57 -0
  142. package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
  143. package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
  144. package/dist/e2e-harness/safe-run-cli.js +43 -0
  145. package/dist/e2e-harness/safe-run.d.ts +61 -0
  146. package/dist/e2e-harness/safe-run.d.ts.map +1 -0
  147. package/dist/e2e-harness/safe-run.js +172 -0
  148. package/dist/e2e-harness/scenario.d.ts +11 -0
  149. package/dist/e2e-harness/scenario.d.ts.map +1 -0
  150. package/dist/e2e-harness/scenario.js +89 -0
  151. package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  152. package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
  153. package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  154. package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  155. package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  156. package/dist/e2e-harness/schemas/index.d.ts +191 -0
  157. package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
  158. package/dist/e2e-harness/schemas/index.js +62 -0
  159. package/dist/e2e-harness/stack.d.ts +124 -0
  160. package/dist/e2e-harness/stack.d.ts.map +1 -0
  161. package/dist/e2e-harness/stack.js +207 -0
  162. package/dist/e2e-harness/steps.d.ts +11 -0
  163. package/dist/e2e-harness/steps.d.ts.map +1 -0
  164. package/dist/e2e-harness/steps.js +22 -0
  165. package/dist/e2e-harness.d.ts +3 -0
  166. package/dist/e2e-harness.d.ts.map +1 -0
  167. package/dist/e2e-harness.js +2 -0
  168. package/dist/exit-codes.d.ts +7 -1
  169. package/dist/exit-codes.d.ts.map +1 -1
  170. package/dist/exit-codes.js +7 -1
  171. package/dist/lexicon.d.ts +55 -0
  172. package/dist/lexicon.d.ts.map +1 -1
  173. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  174. package/dist/lifecycle/gate-ledger.js +2 -3
  175. package/dist/lifecycle/gated-request.d.ts.map +1 -1
  176. package/dist/lifecycle/gated-request.js +1 -2
  177. package/dist/lifecycle/git.d.ts +39 -3
  178. package/dist/lifecycle/git.d.ts.map +1 -1
  179. package/dist/lifecycle/git.js +223 -15
  180. package/dist/lifecycle/lock-rows.d.ts +23 -0
  181. package/dist/lifecycle/lock-rows.d.ts.map +1 -1
  182. package/dist/lifecycle/lock-rows.js +47 -8
  183. package/dist/lifecycle/query.d.ts.map +1 -1
  184. package/dist/lifecycle/query.js +4 -5
  185. package/dist/lifecycle/release-catalog.d.ts.map +1 -1
  186. package/dist/lifecycle/release-catalog.js +1 -1
  187. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  188. package/dist/lifecycle/release-ledger.js +1 -2
  189. package/dist/lifecycle/release-status.d.ts +20 -0
  190. package/dist/lifecycle/release-status.d.ts.map +1 -1
  191. package/dist/lifecycle/release-status.js +1 -22
  192. package/dist/lifecycle/resource-lock.d.ts +70 -0
  193. package/dist/lifecycle/resource-lock.d.ts.map +1 -1
  194. package/dist/lifecycle/resource-lock.js +241 -5
  195. package/dist/lifecycle/wave-plans.d.ts +23 -7
  196. package/dist/lifecycle/wave-plans.d.ts.map +1 -1
  197. package/dist/lifecycle/wave-plans.js +9 -2
  198. package/dist/op/approval-status.d.ts +103 -0
  199. package/dist/op/approval-status.d.ts.map +1 -0
  200. package/dist/op/approval-status.js +197 -0
  201. package/dist/op/gate.js +21 -4
  202. package/dist/op/index.d.ts +1 -1
  203. package/dist/op/index.d.ts.map +1 -1
  204. package/dist/op/index.js +1 -1
  205. package/dist/op/op-waves-capability-spec.d.ts +8 -0
  206. package/dist/op/op-waves-capability-spec.d.ts.map +1 -1
  207. package/dist/op/op-waves-capability-spec.js +21 -0
  208. package/dist/op/op-waves-release-port.js +1 -1
  209. package/dist/op/op-waves-release.d.ts +2 -1
  210. package/dist/op/op-waves-release.d.ts.map +1 -1
  211. package/dist/op/op-waves-release.js +1 -2
  212. package/dist/op/op-waves-run.d.ts +15 -2
  213. package/dist/op/op-waves-run.d.ts.map +1 -1
  214. package/dist/op/op-waves-run.js +195 -31
  215. package/dist/op/op-waves-stand-down.d.ts.map +1 -1
  216. package/dist/op/op-waves-stand-down.js +1 -2
  217. package/dist/op/op-waves.d.ts +53 -0
  218. package/dist/op/op-waves.d.ts.map +1 -1
  219. package/dist/op/op-waves.js +62 -6
  220. package/dist/op/runtime.d.ts +4 -0
  221. package/dist/op/runtime.d.ts.map +1 -1
  222. package/dist/op/runtime.js +2 -3
  223. package/dist/otlp.d.ts.map +1 -1
  224. package/dist/otlp.js +1 -2
  225. package/dist/parallelism.d.ts +17 -0
  226. package/dist/parallelism.d.ts.map +1 -0
  227. package/dist/parallelism.js +33 -0
  228. package/dist/policy-source.d.ts.map +1 -1
  229. package/dist/policy-source.js +1 -2
  230. package/dist/pr-forge.d.ts.map +1 -1
  231. package/dist/pr-forge.js +56 -39
  232. package/dist/pr-loop.d.ts +9 -0
  233. package/dist/pr-loop.d.ts.map +1 -1
  234. package/dist/pr-loop.js +22 -4
  235. package/dist/pr-merge.d.ts +64 -0
  236. package/dist/pr-merge.d.ts.map +1 -0
  237. package/dist/pr-merge.js +78 -0
  238. package/dist/pr-post.d.ts +70 -1
  239. package/dist/pr-post.d.ts.map +1 -1
  240. package/dist/pr-post.js +116 -5
  241. package/dist/pr-report-url.d.ts.map +1 -1
  242. package/dist/pr-report-url.js +1 -2
  243. package/dist/release-floors.d.ts +1 -1
  244. package/dist/release-floors.js +1 -1
  245. package/dist/run-event.d.ts.map +1 -1
  246. package/dist/run-event.js +1 -2
  247. package/dist/scheduled-op-cloud.d.ts +32 -0
  248. package/dist/scheduled-op-cloud.d.ts.map +1 -0
  249. package/dist/scheduled-op-cloud.js +69 -0
  250. package/dist/wave-runtime.mjs +351 -328
  251. package/dist/workspace/ci-lock-grain.d.ts +5 -0
  252. package/dist/workspace/ci-lock-grain.d.ts.map +1 -1
  253. package/dist/workspace/ci-lock-grain.js +1 -7
  254. package/dist/workspace/ci-run.d.ts.map +1 -1
  255. package/dist/workspace/ci-run.js +5 -1
  256. package/dist/workspace/pr-report.schema.json +5 -0
  257. package/package.json +1 -1
  258. package/src/ci-agent.ts +1 -2
  259. package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
  260. package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
  261. package/src/ci-audit/attribution.ts +260 -0
  262. package/src/ci-audit/audit-log.ts +220 -0
  263. package/src/ci-audit/ci-audit.test.ts +175 -0
  264. package/src/ci-audit/index.ts +14 -0
  265. package/src/ci-audit/unrecorded.ts +140 -0
  266. package/src/ci-audit.ts +2 -0
  267. package/src/ci-control.ts +3 -4
  268. package/src/ci-estate.ts +1 -2
  269. package/src/ci-identity-database.test.ts +2 -3
  270. package/src/ci-identity-targets.test.ts +1 -3
  271. package/src/ci-identity.ts +2 -3
  272. package/src/ci-job-guard.test.ts +154 -0
  273. package/src/ci-job-guard.ts +319 -0
  274. package/src/ci-jobs.ts +8 -0
  275. package/src/ci-product-comment-targets.test.ts +45 -0
  276. package/src/ci-product-words.ts +35 -6
  277. package/src/ci-product.ts +55 -4
  278. package/src/ci-respond-run.ts +291 -0
  279. package/src/ci-respond.test.ts +264 -0
  280. package/src/ci-respond.ts +412 -0
  281. package/src/cli/handlers/audit-log.ts +74 -0
  282. package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
  283. package/src/cli/handlers/build.ts +69 -0
  284. package/src/cli/handlers/ci-check-job.test.ts +114 -0
  285. package/src/cli/handlers/ci-check-job.ts +33 -0
  286. package/src/cli/handlers/ci-check.ts +38 -8
  287. package/src/cli/handlers/e2e-safe-run.ts +27 -0
  288. package/src/cli/handlers/lifecycle.ts +13 -0
  289. package/src/cli/handlers/pr-before-merge.test.ts +1 -1
  290. package/src/cli/handlers/pr-deploy-inputs.test.ts +1 -1
  291. package/src/cli/handlers/pr-endpoint.test.ts +1 -1
  292. package/src/cli/handlers/pr-green.test.ts +1 -1
  293. package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
  294. package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
  295. package/src/cli/handlers/pr-plan-targets.test.ts +1 -1
  296. package/src/cli/handlers/pr-record.test.ts +34 -2
  297. package/src/cli/handlers/pr-waves-blocked.test.ts +1 -1
  298. package/src/cli/handlers/pr-waves.test.ts +1 -1
  299. package/src/cli/handlers/pr.test.ts +1 -1
  300. package/src/cli/handlers/pr.ts +311 -32
  301. package/src/cli/handlers/run-wave.ts +79 -1
  302. package/src/cli/main.test.ts +1 -1
  303. package/src/cli/main.ts +56 -2
  304. package/src/cli/parse-args.ts +77 -0
  305. package/src/cli/registry.ts +38 -0
  306. package/src/components/adoption.ts +1 -2
  307. package/src/components/auto-release.test.ts +4 -2
  308. package/src/components/auto-release.ts +9 -5
  309. package/src/components/capability.ts +60 -0
  310. package/src/components/check-hooks.ts +4 -1
  311. package/src/components/check-steps.test.ts +70 -0
  312. package/src/components/check-steps.ts +158 -0
  313. package/src/components/ci-services.ts +1 -2
  314. package/src/components/deploy-units.test.ts +18 -1
  315. package/src/components/deploy-units.ts +26 -1
  316. package/src/components/driver.ts +35 -1
  317. package/src/components/groups.ts +4 -2
  318. package/src/components/plan-flags.test.ts +46 -0
  319. package/src/components/pr-comment-preview-targets.test.ts +34 -0
  320. package/src/components/pr-env-ledger.ts +1 -2
  321. package/src/components/pr-env-run-bundle.test.ts +0 -20
  322. package/src/components/pr-environment.ts +1 -1
  323. package/src/components/pr-pipeline-runners.test.ts +80 -0
  324. package/src/components/pr-pipeline.ts +244 -20
  325. package/src/components/pr-run.ts +17 -6
  326. package/src/components/pr-stale-job.test.ts +34 -0
  327. package/src/components/product-pipeline.ts +50 -8
  328. package/src/components/row-lease.test.ts +61 -1
  329. package/src/components/row-lease.ts +48 -7
  330. package/src/components/wave-plan.ts +18 -2
  331. package/src/e2e-harness/__project__/chant.config.ts +4 -0
  332. package/src/e2e-harness/__project__/src/compose.ts +33 -0
  333. package/src/e2e-harness/bucket.ts +69 -0
  334. package/src/e2e-harness/claim.test.ts +150 -0
  335. package/src/e2e-harness/claim.ts +140 -0
  336. package/src/e2e-harness/driver.test.ts +304 -0
  337. package/src/e2e-harness/driver.ts +294 -0
  338. package/src/e2e-harness/forgejo.ts +267 -0
  339. package/src/e2e-harness/git.ts +96 -0
  340. package/src/e2e-harness/index.ts +49 -0
  341. package/src/e2e-harness/jobs.ts +35 -0
  342. package/src/e2e-harness/pins.ts +52 -0
  343. package/src/e2e-harness/ports.ts +130 -0
  344. package/src/e2e-harness/reports.ts +79 -0
  345. package/src/e2e-harness/safe-run-cli.test.ts +102 -0
  346. package/src/e2e-harness/safe-run-cli.ts +54 -0
  347. package/src/e2e-harness/safe-run.ts +198 -0
  348. package/src/e2e-harness/scenario.ts +89 -0
  349. package/src/e2e-harness/schemas/README.md +62 -0
  350. package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  351. package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
  352. package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  353. package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  354. package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  355. package/src/e2e-harness/schemas/index.ts +220 -0
  356. package/src/e2e-harness/schemas.test.ts +145 -0
  357. package/src/e2e-harness/stack.test.ts +124 -0
  358. package/src/e2e-harness/stack.ts +306 -0
  359. package/src/e2e-harness/steps.ts +30 -0
  360. package/src/e2e-harness.ts +2 -0
  361. package/src/exit-codes.test.ts +3 -2
  362. package/src/exit-codes.ts +7 -1
  363. package/src/gate-decision-bundle.test.ts +0 -2
  364. package/src/lexicon.ts +57 -0
  365. package/src/lifecycle/control-entries-ledger.test.ts +2 -3
  366. package/src/lifecycle/gate-ledger.ts +2 -3
  367. package/src/lifecycle/gated-request.ts +1 -2
  368. package/src/lifecycle/git.test.ts +155 -0
  369. package/src/lifecycle/git.ts +213 -17
  370. package/src/lifecycle/lock-rows.test.ts +6 -1
  371. package/src/lifecycle/lock-rows.ts +58 -7
  372. package/src/lifecycle/query.ts +4 -5
  373. package/src/lifecycle/release-catalog.test.ts +3 -4
  374. package/src/lifecycle/release-catalog.ts +1 -1
  375. package/src/lifecycle/release-ledger.ts +1 -2
  376. package/src/lifecycle/release-status.test.ts +3 -4
  377. package/src/lifecycle/release-status.ts +1 -2
  378. package/src/lifecycle/resource-lock-wait.test.ts +292 -0
  379. package/src/lifecycle/resource-lock.ts +261 -7
  380. package/src/lifecycle/wave-plans.ts +33 -5
  381. package/src/op/approval-status.test.ts +134 -0
  382. package/src/op/approval-status.ts +235 -0
  383. package/src/op/gate-review.test.ts +2 -1
  384. package/src/op/gate.test.ts +7 -5
  385. package/src/op/gate.ts +20 -4
  386. package/src/op/index.ts +2 -0
  387. package/src/op/op-waves-after-plan.test.ts +11 -0
  388. package/src/op/op-waves-capability-spec.ts +20 -0
  389. package/src/op/op-waves-ledger-lock.test.ts +208 -0
  390. package/src/op/op-waves-parallelism.test.ts +89 -0
  391. package/src/op/op-waves-pull-request.test.ts +78 -1
  392. package/src/op/op-waves-release-port.ts +1 -1
  393. package/src/op/op-waves-release.ts +2 -3
  394. package/src/op/op-waves-run.ts +196 -31
  395. package/src/op/op-waves-stand-down.ts +1 -2
  396. package/src/op/op-waves.ts +81 -6
  397. package/src/op/runtime.ts +6 -3
  398. package/src/otlp.ts +1 -2
  399. package/src/parallelism.test.ts +38 -0
  400. package/src/parallelism.ts +33 -0
  401. package/src/policy-source.ts +1 -2
  402. package/src/pr-forge-bundle.test.ts +1 -1
  403. package/src/pr-forge.ts +54 -35
  404. package/src/pr-loop-bundle.test.ts +0 -2
  405. package/src/pr-loop-narrowed.test.ts +63 -0
  406. package/src/pr-loop.ts +30 -4
  407. package/src/pr-merge.test.ts +100 -0
  408. package/src/pr-merge.ts +105 -0
  409. package/src/pr-post-stale.test.ts +163 -0
  410. package/src/pr-post.ts +159 -5
  411. package/src/pr-report-url.ts +1 -2
  412. package/src/product-subpaths-plain-node.e2e.test.ts +1 -0
  413. package/src/release-floors.ts +1 -1
  414. package/src/run-event.ts +1 -2
  415. package/src/scheduled-op-cloud.ts +68 -0
  416. package/src/stage-hooks-bundle.test.ts +0 -2
  417. package/src/workspace/ci-lock-grain.ts +1 -2
  418. package/src/workspace/ci-run.ts +5 -1
  419. package/src/workspace/pr-report.schema.json +5 -0
@@ -15,6 +15,13 @@
15
15
  * - A held row fails the step, or every member of the group, with a record
16
16
  * marked `held`, so the command exits 5 (`CHANT_EXIT.held`) and nothing of
17
17
  * that step applied.
18
+ * - A step on the `target` grain whose lexicon names its target's row
19
+ * (`targetLockRow`: a stock Pulumi stack, a Terraform root), or on the
20
+ * `repo` grain, waits for that row in the ledger's queue, oldest commit
21
+ * first, up to `CHANT_LOCK_WAIT` seconds (ruling for ci-products
22
+ * 2026-10-28, "Ledger lock"), and at the deadline fails with
23
+ * {@link LockWaitTimeoutError}, held, exit 5. A step on the resource grain
24
+ * never waits.
18
25
  *
19
26
  * The port ({@link ledgerRowLease}) writes `_locks/rows/<gate>.json` through
20
27
  * ../lifecycle/resource-lock.ts with one holder for the whole run, and
@@ -35,14 +42,22 @@ export interface RowLeasePort {
35
42
  * Lease `rows` for `label` (a component, or a group's components), all or
36
43
  * nothing. Throws {@link LockRowsHeldError} when another live run holds
37
44
  * one, and any other error when the rows file cannot be read or written.
45
+ * With `wait`, waits in the queue for them instead, and throws
46
+ * {@link LockWaitTimeoutError} at the deadline.
38
47
  */
39
- take(rows: readonly LockRow[], label: string): Promise<RowLease>;
48
+ take(rows: readonly LockRow[], label: string, opts?: {
49
+ wait?: boolean;
50
+ }): Promise<RowLease>;
40
51
  }
41
52
  /** Another live run holds a row this apply changes (#4594), so nothing of it applied. Exit 5. */
42
53
  export declare class LockRowsHeldError extends Error {
43
54
  readonly lockRowsHeld = true;
44
55
  constructor(message: string);
45
56
  }
57
+ /** A wait for a target's row reached its deadline (ruling for ci-products 2026-10-28): nothing of the step applied. Exit 5, as a held row is. */
58
+ export declare class LockWaitTimeoutError extends LockRowsHeldError {
59
+ constructor(message: string);
60
+ }
46
61
  /** Whether `err` is a held row ({@link LockRowsHeldError}), by its mark, so a copy from another bundle counts too. */
47
62
  export declare function isLockRowsHeldError(err: unknown): err is LockRowsHeldError;
48
63
  export interface LedgerRowLeaseOptions {
@@ -53,6 +68,12 @@ export interface LedgerRowLeaseOptions {
53
68
  holder?: LockRowHolder;
54
69
  /** Where the lease's info lines go. Default stderr. */
55
70
  log?: (line: string) => void;
71
+ /** How long a waiting take waits, in seconds. Default `CHANT_LOCK_WAIT`. */
72
+ waitSeconds?: number;
73
+ /** How often a waiting take reads the rows file again, in ms. Default `CHANT_LOCK_POLL` seconds, else 10 s. */
74
+ pollMs?: number;
75
+ /** The commit time that orders this run in the queue. Default: HEAD's in `cwd`. */
76
+ commitAt?: string;
56
77
  }
57
78
  /**
58
79
  * The port over `gate`'s rows file on `chant/lifecycle` (#4594), one holder
@@ -1 +1 @@
1
- {"version":3,"file":"row-lease.d.ts","sourceRoot":"","sources":["../../src/components/row-lease.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE9E,qDAAqD;AACrD,MAAM,WAAW,QAAQ;IACvB,8IAA8I;IAC9I,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAClE;AAED,iGAAiG;AACjG,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,YAAY,QAAQ;IAC7B,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,sHAAsH;AACtH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAE1E;AAID,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,uDAAuD;IACvD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,YAAY,CA+C3F;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,EACtC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,CAUlD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,EACtC,OAAO,EAAE,aAAa,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,aAAa,CAAA;CAAE,CAAC,EAClF,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EAC/C,QAAQ,EAAE,SAAS,GAAG,SAAS,GAC9B,OAAO,CAAC,OAAO,EAAE,CAAC,CASpB"}
1
+ {"version":3,"file":"row-lease.d.ts","sourceRoot":"","sources":["../../src/components/row-lease.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE9E,qDAAqD;AACrD,MAAM,WAAW,QAAQ;IACvB,8IAA8I;IAC9I,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7F;AAED,iGAAiG;AACjG,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,YAAY,QAAQ;IAC7B,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,iJAAiJ;AACjJ,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,sHAAsH;AACtH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAE1E;AAID,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,uDAAuD;IACvD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+GAA+G;IAC/G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,qBAA0B,GAAG,YAAY,CA2D3F;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,EACtC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,CAgBlD;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,EACtC,OAAO,EAAE,aAAa,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,aAAa,CAAA;CAAE,CAAC,EAClF,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EAC/C,QAAQ,EAAE,SAAS,GAAG,SAAS,GAC9B,OAAO,CAAC,OAAO,EAAE,CAAC,CASpB"}
@@ -1,4 +1,4 @@
1
- import { lockGrainBeforePlan, resolvePlannedLock, sortedLockRows } from "../lifecycle/lock-rows.js";
1
+ import { lockGrainBeforePlan, queueRowsOf, resolvePlannedLock, sortedLockRows } from "../lifecycle/lock-rows.js";
2
2
  /** Another live run holds a row this apply changes (#4594), so nothing of it applied. Exit 5. */
3
3
  export class LockRowsHeldError extends Error {
4
4
  constructor(message) {
@@ -7,6 +7,13 @@ export class LockRowsHeldError extends Error {
7
7
  this.name = "LockRowsHeldError";
8
8
  }
9
9
  }
10
+ /** A wait for a target's row reached its deadline (ruling for ci-products 2026-10-28): nothing of the step applied. Exit 5, as a held row is. */
11
+ export class LockWaitTimeoutError extends LockRowsHeldError {
12
+ constructor(message) {
13
+ super(message);
14
+ this.name = "LockWaitTimeoutError";
15
+ }
16
+ }
10
17
  /** Whether `err` is a held row ({@link LockRowsHeldError}), by its mark, so a copy from another bundle counts too. */
11
18
  export function isLockRowsHeldError(err) {
12
19
  return typeof err === "object" && err !== null && err.lockRowsHeld === true;
@@ -24,15 +31,28 @@ export function ledgerRowLease(gate, opts = {}) {
24
31
  let holder = opts.holder;
25
32
  const lock = () => import("../lifecycle/resource-lock.js");
26
33
  return {
27
- async take(rows, label) {
34
+ async take(rows, label, takeOpts) {
28
35
  const wanted = sortedLockRows(rows);
29
36
  if (wanted.length === 0)
30
37
  return NO_LEASE;
31
- const { leaseLockRows, lockRowHolder, releaseLockRows } = await lock();
38
+ const { commitTimeOf, leaseLockRows, lockPollMs, lockRowHolder, lockWaitSeconds, releaseLockRows } = await lock();
32
39
  holder ?? (holder = lockRowHolder(process.env));
33
40
  const fresh = wanted.filter((r) => (counts.get(r.key) ?? 0) === 0);
34
41
  if (fresh.length > 0) {
35
- const leased = await leaseLockRows(gate, fresh, { holder, ...(opts.cwd ? { cwd: opts.cwd } : {}), ...(opts.alive ? { alive: opts.alive } : {}) });
42
+ const commitAt = takeOpts?.wait ? (opts.commitAt ?? (await commitTimeOf(holder.sha ?? "HEAD", opts.cwd))) : undefined;
43
+ const wait = takeOpts?.wait
44
+ ? {
45
+ wait: {
46
+ deadline: Date.now() + (opts.waitSeconds ?? lockWaitSeconds(process.env)) * 1000,
47
+ pollMs: opts.pollMs ?? lockPollMs(process.env),
48
+ log: (line) => log(`${label}: ${line}`),
49
+ ...(commitAt ? { commitAt } : {}),
50
+ },
51
+ }
52
+ : {};
53
+ const leased = await leaseLockRows(gate, fresh, { holder, ...(opts.cwd ? { cwd: opts.cwd } : {}), ...(opts.alive ? { alive: opts.alive } : {}), ...wait });
54
+ if (!leased.ok && leased.timedOut)
55
+ throw new LockWaitTimeoutError(`${label}: LockWaitTimeoutError: ${leased.message}, so nothing of it was applied.`);
36
56
  if (!leased.ok) {
37
57
  throw new LockRowsHeldError(`${label}: ${leased.message}, so nothing of it was applied. Apply again once that run ends; a run that is gone, or whose lease is older than CHANT_LOCK_STALE seconds, is taken over.`);
38
58
  }
@@ -80,9 +100,15 @@ export function ledgerRowLease(gate, opts = {}) {
80
100
  */
81
101
  export async function leaseCapabilityStep(capability, ctx, input) {
82
102
  const port = ctx.rowLease;
83
- if (!port || ctx.plans !== undefined || !capability.plan)
103
+ if (!port)
84
104
  return { ctx, lease: NO_LEASE };
85
- if ((await lockGrainBeforePlan(capability, input, ctx.lockGrain)) !== "resource")
105
+ const grain = await lockGrainBeforePlan(capability, input, ctx.lockGrain);
106
+ if (grain !== "resource") {
107
+ // The ruling for ci-products (2026-10-28): the target's row (or the repo row), waited for, whether or not a plan was handed in.
108
+ const queue = await queueRowsOf(capability, input, ctx.component, grain);
109
+ return { ctx, lease: queue.length > 0 ? await port.take(queue, ctx.component, { wait: true }) : NO_LEASE };
110
+ }
111
+ if (ctx.plans !== undefined || !capability.plan)
86
112
  return { ctx, lease: NO_LEASE };
87
113
  const planned = await capability.plan(ctx, input);
88
114
  const lock = await resolvePlannedLock(capability, input, planned, ctx.lockGrain);
@@ -108,6 +108,14 @@ export declare function targetedPlanDigest(planDigest: string, targets: readonly
108
108
  * `ctx.targets`, the plan as it came.
109
109
  */
110
110
  export declare function bindTargets(kind: string, ctx: DeployContext, planned: CapabilityPlan): CapabilityPlan;
111
+ /**
112
+ * A step's plan made with `ctx.refresh` or `ctx.targetDependents` (#4627),
113
+ * its digest bound to them: the digest over the plan's own digest and the
114
+ * flags, so an approval of a refreshed or widened plan covers no plain one,
115
+ * as {@link bindTargets} binds targets. Without either flag, the plan as it
116
+ * came.
117
+ */
118
+ export declare function bindPlanFlags(ctx: Pick<DeployContext, "refresh" | "targetDependents">, planned: CapabilityPlan): CapabilityPlan;
111
119
  /**
112
120
  * The outputs `component` exposes now, read from each step whose capability
113
121
  * has `outputs` (#3183), merged the way the driver merges a run's outputs.
@@ -1 +1 @@
1
- {"version":3,"file":"wave-plan.d.ts","sourceRoot":"","sources":["../../src/components/wave-plan.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"wave-plan.d.ts","sourceRoot":"","sources":["../../src/components/wave-plan.ts"],"names":[],"mappings":"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"}
@@ -27,7 +27,7 @@
27
27
  * `@<component>.publish.*`) resolves.
28
28
  */
29
29
  import { resolvePlannedLock } from "../lifecycle/lock-rows.js";
30
- import { assertTargetsAccepted, resolveStepInput, unresolvedWiringSources } from "./driver.js";
30
+ import { assertPlanFlagsAccepted, assertTargetsAccepted, resolveStepInput, unresolvedWiringSources } from "./driver.js";
31
31
  import { componentPlanDigest } from "./gate-plan.js";
32
32
  import { componentDeployInputs } from "./deploy-inputs.js";
33
33
  import { computePlanDigest } from "../lifecycle/plan-digest.js";
@@ -103,13 +103,14 @@ export async function planWaveComponent(component, registry, ctx, componentOutpu
103
103
  const locks = {};
104
104
  const locations = {};
105
105
  assertTargetsAccepted(component, registry, ctx);
106
+ assertPlanFlagsAccepted(component, registry, ctx);
106
107
  for (const step of capabilitySteps(component.deploy)) {
107
108
  const capability = registry.resolve(step.kind);
108
109
  if (!capability.plan)
109
110
  continue;
110
111
  const { kind: _kind, ...rest } = step;
111
112
  const input = resolveStepInput(rest, {}, componentOutputs);
112
- const planned = bindTargets(step.kind, ctx, await capability.plan(planContext(ctx, rest, componentOutputs), input));
113
+ const planned = bindPlanFlags(ctx, bindTargets(step.kind, ctx, await capability.plan(planContext(ctx, rest, componentOutputs), input)));
113
114
  const member = { member: planned.member, planDigest: planned.planDigest };
114
115
  members.push(member);
115
116
  parts.push(planned.changeSet ?? emptyPart(member));
@@ -208,6 +209,21 @@ export function bindTargets(kind, ctx, planned) {
208
209
  : undefined;
209
210
  return { ...planned, planDigest, targets: want, ...(changeSet ? { changeSet } : {}) };
210
211
  }
212
+ /**
213
+ * A step's plan made with `ctx.refresh` or `ctx.targetDependents` (#4627),
214
+ * its digest bound to them: the digest over the plan's own digest and the
215
+ * flags, so an approval of a refreshed or widened plan covers no plain one,
216
+ * as {@link bindTargets} binds targets. Without either flag, the plan as it
217
+ * came.
218
+ */
219
+ export function bindPlanFlags(ctx, planned) {
220
+ const flags = { ...(ctx.refresh ? { refresh: true } : {}), ...(ctx.targetDependents ? { targetDependents: true } : {}) };
221
+ if (Object.keys(flags).length === 0)
222
+ return planned;
223
+ const planDigest = computePlanDigest("capability-plan-flags", { plan: planned.planDigest, ...flags });
224
+ const changeSet = planned.changeSet ? { ...planned.changeSet, member: { ...planned.changeSet.member, planDigest } } : undefined;
225
+ return { ...planned, planDigest, ...(changeSet ? { changeSet } : {}) };
226
+ }
211
227
  /** `next` over `prior`, as a later step's outputs win over an earlier one's in a run. */
212
228
  function mergePlannedOutputs(prior, next) {
213
229
  const known = { ...(prior?.known ?? {}), ...next.known };
@@ -0,0 +1,21 @@
1
+ /**
2
+ * A bucket, for real: one bucket in the harness's floci, path-style S3 over
3
+ * http (chant#4587, from the fan-out demo's lib/bucket.ts). floci takes
4
+ * unsigned requests, so the driver needs no AWS CLI on the host. chant's
5
+ * reports under `--report-url` are read from here.
6
+ */
7
+ import type { Bucket } from "./ports.js";
8
+ export declare class FlociBucket implements Bucket {
9
+ private readonly endpoint;
10
+ private readonly bucket;
11
+ /** `endpoint` is floci as the driver reaches it, http://localhost:<port>. */
12
+ constructor(endpoint: string, bucket: string);
13
+ private url;
14
+ /** The bucket itself. An existing one is kept. */
15
+ create(): Promise<void>;
16
+ get(key: string): Promise<string | null>;
17
+ put(key: string, body: string, contentType: string): Promise<void>;
18
+ list(prefix: string): Promise<string[]>;
19
+ delete(key: string): Promise<void>;
20
+ }
21
+ //# sourceMappingURL=bucket.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bucket.d.ts","sourceRoot":"","sources":["../../src/e2e-harness/bucket.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC,qBAAa,WAAY,YAAW,MAAM;IAGtC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,6EAA6E;IAC7E,YACmB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAC7B;IAEJ,OAAO,CAAC,GAAG;IAIX,kDAAkD;IAC5C,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAG5B;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAK7C;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvE;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAc5C;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvC;CACF"}
@@ -0,0 +1,61 @@
1
+ const TIMEOUT_MS = 30000;
2
+ export class FlociBucket {
3
+ /** `endpoint` is floci as the driver reaches it, http://localhost:<port>. */
4
+ constructor(endpoint, bucket) {
5
+ this.endpoint = endpoint;
6
+ this.bucket = bucket;
7
+ }
8
+ url(key = "") {
9
+ return `${this.endpoint.replace(/\/$/, "")}/${this.bucket}${key ? `/${key.split("/").map(encodeURIComponent).join("/")}` : ""}`;
10
+ }
11
+ /** The bucket itself. An existing one is kept. */
12
+ async create() {
13
+ const res = await fetch(this.url(), { method: "PUT", signal: AbortSignal.timeout(TIMEOUT_MS) });
14
+ if (!res.ok && res.status !== 409)
15
+ throw new Error(`floci PUT ${this.bucket} answered ${res.status}`);
16
+ }
17
+ async get(key) {
18
+ const res = await fetch(this.url(key), { signal: AbortSignal.timeout(TIMEOUT_MS) });
19
+ if (res.status === 404 || res.status === 403)
20
+ return null;
21
+ if (!res.ok)
22
+ throw new Error(`floci GET ${key} answered ${res.status}`);
23
+ return res.text();
24
+ }
25
+ async put(key, body, contentType) {
26
+ const res = await fetch(this.url(key), {
27
+ method: "PUT",
28
+ headers: { "content-type": contentType },
29
+ body,
30
+ signal: AbortSignal.timeout(TIMEOUT_MS),
31
+ });
32
+ if (!res.ok)
33
+ throw new Error(`floci PUT ${key} answered ${res.status}`);
34
+ }
35
+ async list(prefix) {
36
+ const keys = [];
37
+ let token;
38
+ for (;;) {
39
+ const q = new URLSearchParams({ "list-type": "2", prefix, ...(token ? { "continuation-token": token } : {}) });
40
+ const res = await fetch(`${this.url()}?${q.toString()}`, { signal: AbortSignal.timeout(TIMEOUT_MS) });
41
+ if (!res.ok)
42
+ throw new Error(`floci list ${prefix} answered ${res.status}`);
43
+ const xml = await res.text();
44
+ for (const m of xml.matchAll(/<Key>([^<]*)<\/Key>/g))
45
+ keys.push(decodeXml(m[1]));
46
+ const next = /<NextContinuationToken>([^<]*)<\/NextContinuationToken>/.exec(xml)?.[1];
47
+ if (!next || !/<IsTruncated>true<\/IsTruncated>/.test(xml))
48
+ break;
49
+ token = decodeXml(next);
50
+ }
51
+ return keys;
52
+ }
53
+ async delete(key) {
54
+ const res = await fetch(this.url(key), { method: "DELETE", signal: AbortSignal.timeout(TIMEOUT_MS) });
55
+ if (!res.ok && res.status !== 404)
56
+ throw new Error(`floci DELETE ${key} answered ${res.status}`);
57
+ }
58
+ }
59
+ function decodeXml(s) {
60
+ return s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
61
+ }
@@ -0,0 +1,70 @@
1
+ /**
2
+ * The claim row protocol (chant#4587), terragucci's: one claim, a plain run
3
+ * that must pass, a BREAK=1 run that must be caught, one row. A row records
4
+ * the product and its commit, the engine binary and version, the floci
5
+ * digest, the date and both verdicts.
6
+ *
7
+ * Following the ledger ruling (chant#4551), the run is a ledger record: op
8
+ * `e2e-claim`, the row as its `claim` outcome, one phase per arm. A
9
+ * product's page reads e2e-claims/v1, rendered from those records with the
10
+ * newest row per scenario and claim. Recording goes through ./safe-run.ts's
11
+ * `recordClaimRow`, which refuses a run whose scan was not CLEAN.
12
+ */
13
+ import type { OpRunRecord, OpRunRecordInput } from "../op/runtime.js";
14
+ import type { RunOrigin } from "../lifecycle/release-ledger.js";
15
+ import type { ClaimRun } from "./driver.js";
16
+ import { type BreakVerdict, type ClaimRow, type ClaimsDoc, type PlainVerdict, type Scenario } from "./schemas/index.js";
17
+ /** The op every claim run is recorded under. */
18
+ export declare const CLAIM_OP = "e2e-claim";
19
+ export interface ClaimRowInput {
20
+ scenario: Pick<Scenario, "id" | "product" | "claim">;
21
+ productCommit: string;
22
+ engine: {
23
+ binary: string;
24
+ version: string;
25
+ };
26
+ verdicts: {
27
+ plain: PlainVerdict;
28
+ break: BreakVerdict;
29
+ };
30
+ /** When the run ended. */
31
+ at: Date;
32
+ /** The floci digest the stack ran. Default the harness's pin. */
33
+ floci?: string;
34
+ chant?: string;
35
+ runUrl?: string;
36
+ }
37
+ /** A claim row, validated. A run's scan verdict is added when it is recorded. */
38
+ export declare function claimRow(i: ClaimRowInput): ClaimRow;
39
+ /** Whether a row proves its claim: the plain run passed and the BREAK run was caught. */
40
+ export declare const rowHolds: (row: Pick<ClaimRow, "plain" | "break">) => boolean;
41
+ /**
42
+ * The run record of one claim run (#4551): op `e2e-claim`, labels naming the
43
+ * product, scenario and claim, the row as the `claim` outcome, and one phase
44
+ * per arm with a step per scenario step. Status ok when the row holds.
45
+ */
46
+ export declare function claimRunRecordInput(o: {
47
+ row: ClaimRow;
48
+ run: ClaimRun;
49
+ env?: string;
50
+ gitSha?: string;
51
+ runOrigin?: RunOrigin;
52
+ }): OpRunRecordInput;
53
+ /** The rows on a ledger's e2e-claim records, oldest first. A record whose outcome is not a row is skipped. */
54
+ export declare function claimRowsOf(records: readonly OpRunRecord[]): ClaimRow[];
55
+ /**
56
+ * e2e-claims/v1 for one product: its newest row per scenario and claim,
57
+ * sorted by scenario then claim. Rows are recorded in order, so the last
58
+ * one read for a pair is the newest.
59
+ */
60
+ export declare function renderClaims(product: string, rows: readonly ClaimRow[]): ClaimsDoc;
61
+ /**
62
+ * Whether an engine claim about `version` may count a row: only when the row
63
+ * ran that version of that engine (chant#4586, the v0.28.0 against 0.31.0
64
+ * split), and only when it holds.
65
+ */
66
+ export declare function rowCountsFor(row: ClaimRow, engine: {
67
+ binary: string;
68
+ version: string;
69
+ }): boolean;
70
+ //# sourceMappingURL=claim.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../../src/e2e-harness/claim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAU,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AAEzB,gDAAgD;AAChD,eAAO,MAAM,QAAQ,cAAc,CAAC;AAEpC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IACvD,0BAA0B;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,aAAa,GAAG,QAAQ,CAoBnD;AAED,yFAAyF;AACzF,eAAO,MAAM,QAAQ,QAAS,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,KAAG,OAAyD,CAAC;AAc5H;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE;IAAE,GAAG,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,gBAAgB,CAa/I;AAED,8GAA8G;AAC9G,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,QAAQ,EAAE,CAOvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,CAYlF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAGhG"}
@@ -0,0 +1,98 @@
1
+ import { FLOCI_DIGEST } from "./pins.js";
2
+ import { E2E_CLAIMS_SCHEMA, E2E_CLAIM_ROW_SCHEMA, validateClaimRow, validateClaims, } from "./schemas/index.js";
3
+ /** The op every claim run is recorded under. */
4
+ export const CLAIM_OP = "e2e-claim";
5
+ /** A claim row, validated. A run's scan verdict is added when it is recorded. */
6
+ export function claimRow(i) {
7
+ const row = {
8
+ $schema: E2E_CLAIM_ROW_SCHEMA,
9
+ contract: 1,
10
+ product: i.scenario.product,
11
+ productCommit: i.productCommit,
12
+ scenario: i.scenario.id,
13
+ claim: i.scenario.claim,
14
+ engine: { binary: i.engine.binary, version: i.engine.version },
15
+ floci: i.floci ?? FLOCI_DIGEST,
16
+ ...(i.chant ? { chant: i.chant } : {}),
17
+ date: i.at.toISOString().slice(0, 10),
18
+ plain: i.verdicts.plain,
19
+ break: i.verdicts.break,
20
+ safeRun: "CLEAN",
21
+ ...(i.runUrl ? { runUrl: i.runUrl } : {}),
22
+ };
23
+ const v = validateClaimRow(row);
24
+ if (!v.ok)
25
+ throw new Error(`the claim row for ${row.scenario} is not e2e-claim-row/v1: ${v.errors.join("; ")}`);
26
+ return row;
27
+ }
28
+ /** Whether a row proves its claim: the plain run passed and the BREAK run was caught. */
29
+ export const rowHolds = (row) => row.plain === "pass" && row.break === "caught";
30
+ const phaseOf = (run) => ({
31
+ name: run.arm,
32
+ // A phase fails when a step did, as the ledger reads phases; the arm's verdict is in the row.
33
+ status: run.outcome === "held" ? "ok" : "fail",
34
+ steps: run.steps.map((s) => ({
35
+ fn: `${s.do}:${s.id}`,
36
+ status: s.stopped ? "fail" : "ok",
37
+ durationMs: 0,
38
+ ...(s.stopped ? { error: `${s.stopped.outcome}: ${s.stopped.reason}` } : {}),
39
+ })),
40
+ });
41
+ /**
42
+ * The run record of one claim run (#4551): op `e2e-claim`, labels naming the
43
+ * product, scenario and claim, the row as the `claim` outcome, and one phase
44
+ * per arm with a step per scenario step. Status ok when the row holds.
45
+ */
46
+ export function claimRunRecordInput(o) {
47
+ return {
48
+ op: CLAIM_OP,
49
+ env: o.env ?? "local",
50
+ started: o.run.plain.started,
51
+ ended: o.run.break.ended,
52
+ status: rowHolds(o.row) ? "ok" : "fail",
53
+ labels: { Product: o.row.product, Scenario: o.row.scenario, Claim: o.row.claim },
54
+ outcomes: { claim: o.row },
55
+ phases: [phaseOf(o.run.plain), phaseOf(o.run.break)],
56
+ ...(o.gitSha ? { gitSha: o.gitSha } : {}),
57
+ ...(o.runOrigin ? { runOrigin: o.runOrigin } : {}),
58
+ };
59
+ }
60
+ /** The rows on a ledger's e2e-claim records, oldest first. A record whose outcome is not a row is skipped. */
61
+ export function claimRowsOf(records) {
62
+ return records
63
+ .filter((r) => r.op === CLAIM_OP)
64
+ .slice()
65
+ .sort((a, b) => a.ended.localeCompare(b.ended))
66
+ .map((r) => r.outcomes.claim)
67
+ .filter((c) => validateClaimRow(c).ok);
68
+ }
69
+ /**
70
+ * e2e-claims/v1 for one product: its newest row per scenario and claim,
71
+ * sorted by scenario then claim. Rows are recorded in order, so the last
72
+ * one read for a pair is the newest.
73
+ */
74
+ export function renderClaims(product, rows) {
75
+ const newest = new Map();
76
+ for (const row of rows)
77
+ if (row.product === product)
78
+ newest.set(`${row.scenario}\u0000${row.claim}`, row);
79
+ const doc = {
80
+ $schema: E2E_CLAIMS_SCHEMA,
81
+ contract: 1,
82
+ product,
83
+ rows: [...newest.values()].sort((a, b) => a.scenario.localeCompare(b.scenario) || a.claim.localeCompare(b.claim)),
84
+ };
85
+ const v = validateClaims(doc);
86
+ if (!v.ok)
87
+ throw new Error(`the rendered claims of ${product} are not e2e-claims/v1: ${v.errors.join("; ")}`);
88
+ return doc;
89
+ }
90
+ /**
91
+ * Whether an engine claim about `version` may count a row: only when the row
92
+ * ran that version of that engine (chant#4586, the v0.28.0 against 0.31.0
93
+ * split), and only when it holds.
94
+ */
95
+ export function rowCountsFor(row, engine) {
96
+ const norm = (v) => v.replace(/^v/, "");
97
+ return row.engine.binary === engine.binary && norm(row.engine.version) === norm(engine.version) && rowHolds(row);
98
+ }
@@ -0,0 +1,64 @@
1
+ import type { Bucket, Chant, Clock, ForgeReads, Jobs, Ledger, Log, OutOfBand, PullForge } from "./ports.js";
2
+ import type { BreakVerdict, PlainVerdict, Scenario, ScenarioStepKind } from "./schemas/index.js";
3
+ export type Arm = "plain" | "break";
4
+ export interface DriverPorts {
5
+ forge: PullForge & Partial<ForgeReads>;
6
+ /** The bucket the scenario's report URL names. */
7
+ bucket: Bucket;
8
+ chant: Pick<Chant, "approve">;
9
+ clock: Clock;
10
+ /** An overlay's files, repo-relative path to content. */
11
+ overlay(name: string): Record<string, string>;
12
+ ledger?: Ledger;
13
+ jobs?: Jobs;
14
+ outOfBand?: OutOfBand;
15
+ /** Put the repo and the stacks back to the base, before each run. */
16
+ reset?(): Promise<void>;
17
+ /** Hand the run's environment to where the pipeline reads it (the runner's secrets file). */
18
+ arm?(arm: Arm, env: Record<string, string>): Promise<void>;
19
+ log?: Log;
20
+ }
21
+ export interface DriverOptions {
22
+ /** Who approves, as chant names reviewers: `forgejo@forgejo:3000:<login>`. */
23
+ approver: string;
24
+ /** How often reports are polled, in ms. Default 2000. */
25
+ pollMs?: number;
26
+ }
27
+ export interface StepResult {
28
+ id: string;
29
+ do: ScenarioStepKind;
30
+ pull?: number;
31
+ commit?: string;
32
+ /** Why the run stopped at this step. */
33
+ stopped?: {
34
+ outcome: "broke" | "stalled";
35
+ reason: string;
36
+ };
37
+ }
38
+ export interface ArmRun {
39
+ scenario: string;
40
+ arm: Arm;
41
+ outcome: "held" | "broke" | "stalled";
42
+ reason?: string;
43
+ started: string;
44
+ ended: string;
45
+ steps: StepResult[];
46
+ }
47
+ /** Run one arm of a scenario. */
48
+ export declare function runArm(s: Scenario, arm: Arm, p: DriverPorts, opts: DriverOptions): Promise<ArmRun>;
49
+ /** The row's verdicts from the two runs. */
50
+ export declare function verdictsOf(plain: Pick<ArmRun, "outcome">, brk: Pick<ArmRun, "outcome">): {
51
+ plain: PlainVerdict;
52
+ break: BreakVerdict;
53
+ };
54
+ export interface ClaimRun {
55
+ plain: ArmRun;
56
+ break: ArmRun;
57
+ verdicts: {
58
+ plain: PlainVerdict;
59
+ break: BreakVerdict;
60
+ };
61
+ }
62
+ /** The plain run, then the BREAK run, and their verdicts. */
63
+ export declare function runClaim(s: Scenario, p: DriverPorts, opts: DriverOptions): Promise<ClaimRun>;
64
+ //# sourceMappingURL=driver.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/e2e-harness/driver.ts"],"names":[],"mappings":"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"}