@intentius/chant 0.124.54 → 0.124.55

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 (894) hide show
  1. package/dist/__fixtures__/estate-ledger.d.ts +13 -0
  2. package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
  3. package/dist/__fixtures__/estate-ledger.js +67 -0
  4. package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
  5. package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
  6. package/dist/__fixtures__/oidc-emulator.js +26 -2
  7. package/dist/__fixtures__/product-words.d.ts +78 -0
  8. package/dist/__fixtures__/product-words.d.ts.map +1 -0
  9. package/dist/__fixtures__/product-words.js +43 -0
  10. package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  11. package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  12. package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  13. package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  14. package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  15. package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  16. package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
  17. package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
  18. package/dist/__golden__/wave-loop/op-held-on.json +28 -7
  19. package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  20. package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  21. package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  22. package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
  23. package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  24. package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
  25. package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
  26. package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
  27. package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  28. package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  29. package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
  30. package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  31. package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  32. package/dist/__golden__/wave-loop/op-overridden.json +28 -7
  33. package/dist/__golden__/wave-loop/op-per-run.json +20 -4
  34. package/dist/__golden__/wave-loop/op-point.json +18 -4
  35. package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
  36. package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
  37. package/dist/__golden__/wave-loop/op-spend.json +10 -2
  38. package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
  39. package/dist/__golden__/wave-loop/op-wide.json +20 -4
  40. package/dist/bucket-check/azure.d.ts +108 -0
  41. package/dist/bucket-check/azure.d.ts.map +1 -0
  42. package/dist/bucket-check/azure.js +258 -0
  43. package/dist/bucket-check/fixtures/azure.json +153 -0
  44. package/dist/bucket-check/fixtures/gcs.json +148 -0
  45. package/dist/bucket-check/fixtures/s3.json +277 -0
  46. package/dist/bucket-check/gcs.d.ts +77 -0
  47. package/dist/bucket-check/gcs.d.ts.map +1 -0
  48. package/dist/bucket-check/gcs.js +202 -0
  49. package/dist/bucket-check/index.d.ts +48 -0
  50. package/dist/bucket-check/index.d.ts.map +1 -0
  51. package/dist/bucket-check/index.js +44 -0
  52. package/dist/bucket-check/s3.d.ts +116 -0
  53. package/dist/bucket-check/s3.d.ts.map +1 -0
  54. package/dist/bucket-check/s3.js +362 -0
  55. package/dist/bucket-check/types.d.ts +66 -0
  56. package/dist/bucket-check/types.d.ts.map +1 -0
  57. package/dist/bucket-check/types.js +31 -0
  58. package/dist/bucket-check/wire.d.ts +27 -0
  59. package/dist/bucket-check/wire.d.ts.map +1 -0
  60. package/dist/bucket-check/wire.js +32 -0
  61. package/dist/bucket-check.d.ts +6 -0
  62. package/dist/bucket-check.d.ts.map +1 -0
  63. package/dist/bucket-check.js +5 -0
  64. package/dist/capabilities/templates.d.ts.map +1 -1
  65. package/dist/capabilities/templates.js +1 -2
  66. package/dist/change-set.d.ts.map +1 -1
  67. package/dist/change-set.js +2 -3
  68. package/dist/ci-agent.d.ts +381 -0
  69. package/dist/ci-agent.d.ts.map +1 -0
  70. package/dist/ci-agent.js +833 -0
  71. package/dist/ci-control.d.ts +42 -0
  72. package/dist/ci-control.d.ts.map +1 -0
  73. package/dist/ci-control.js +42 -0
  74. package/dist/ci-estate/delivery.d.ts +137 -0
  75. package/dist/ci-estate/delivery.d.ts.map +1 -0
  76. package/dist/ci-estate/delivery.js +311 -0
  77. package/dist/ci-estate/overdue.d.ts +34 -0
  78. package/dist/ci-estate/overdue.d.ts.map +1 -0
  79. package/dist/ci-estate/overdue.js +58 -0
  80. package/dist/ci-estate/page.d.ts +134 -0
  81. package/dist/ci-estate/page.d.ts.map +1 -0
  82. package/dist/ci-estate/page.js +233 -0
  83. package/dist/ci-estate/rows.d.ts +118 -0
  84. package/dist/ci-estate/rows.d.ts.map +1 -0
  85. package/dist/ci-estate/rows.js +126 -0
  86. package/dist/ci-estate.d.ts +68 -0
  87. package/dist/ci-estate.d.ts.map +1 -0
  88. package/dist/ci-estate.js +83 -0
  89. package/dist/ci-handover.d.ts +29 -5
  90. package/dist/ci-handover.d.ts.map +1 -1
  91. package/dist/ci-handover.js +50 -16
  92. package/dist/ci-identity.d.ts +82 -7
  93. package/dist/ci-identity.d.ts.map +1 -1
  94. package/dist/ci-identity.js +87 -15
  95. package/dist/ci-product-words.d.ts +290 -0
  96. package/dist/ci-product-words.d.ts.map +1 -0
  97. package/dist/ci-product-words.js +373 -0
  98. package/dist/ci-product.d.ts +82 -0
  99. package/dist/ci-product.d.ts.map +1 -0
  100. package/dist/ci-product.js +78 -0
  101. package/dist/cli/commands/audit.d.ts +2 -2
  102. package/dist/cli/commands/audit.d.ts.map +1 -1
  103. package/dist/cli/commands/audit.js +3 -2
  104. package/dist/cli/commands/carve.js +2 -2
  105. package/dist/cli/commands/init.d.ts +2 -0
  106. package/dist/cli/commands/init.d.ts.map +1 -1
  107. package/dist/cli/commands/init.js +1 -1
  108. package/dist/cli/handlers/agent.d.ts +17 -0
  109. package/dist/cli/handlers/agent.d.ts.map +1 -0
  110. package/dist/cli/handlers/agent.js +114 -0
  111. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  112. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  113. package/dist/cli/handlers/approve-confirm.js +142 -0
  114. package/dist/cli/handlers/approve.d.ts.map +1 -1
  115. package/dist/cli/handlers/approve.js +19 -1
  116. package/dist/cli/handlers/build.d.ts.map +1 -1
  117. package/dist/cli/handlers/build.js +43 -1
  118. package/dist/cli/handlers/ci-check.d.ts +3 -0
  119. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  120. package/dist/cli/handlers/ci-check.js +34 -0
  121. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  122. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  123. package/dist/cli/handlers/ci-forge-check.js +89 -0
  124. package/dist/cli/handlers/fan-out.js +4 -0
  125. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  126. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  127. package/dist/cli/handlers/gate-pending.js +44 -0
  128. package/dist/cli/handlers/init.d.ts.map +1 -1
  129. package/dist/cli/handlers/init.js +1 -0
  130. package/dist/cli/handlers/ledger.js +1 -1
  131. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  132. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  133. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  134. package/dist/cli/handlers/lock.d.ts.map +1 -1
  135. package/dist/cli/handlers/lock.js +64 -5
  136. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  137. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  138. package/dist/cli/handlers/notify-relay.js +130 -0
  139. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  140. package/dist/cli/handlers/pr-env.js +42 -11
  141. package/dist/cli/handlers/pr.d.ts +38 -3
  142. package/dist/cli/handlers/pr.d.ts.map +1 -1
  143. package/dist/cli/handlers/pr.js +653 -205
  144. package/dist/cli/handlers/promote.d.ts.map +1 -1
  145. package/dist/cli/handlers/promote.js +21 -2
  146. package/dist/cli/handlers/release.d.ts.map +1 -1
  147. package/dist/cli/handlers/release.js +3 -0
  148. package/dist/cli/handlers/run-wave.d.ts +8 -0
  149. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  150. package/dist/cli/handlers/run-wave.js +71 -1
  151. package/dist/cli/handlers/run.d.ts +6 -1
  152. package/dist/cli/handlers/run.d.ts.map +1 -1
  153. package/dist/cli/handlers/run.js +86 -1
  154. package/dist/cli/handlers/serve.d.ts.map +1 -1
  155. package/dist/cli/handlers/serve.js +10 -1
  156. package/dist/cli/main.d.ts +11 -1
  157. package/dist/cli/main.d.ts.map +1 -1
  158. package/dist/cli/main.js +124 -13
  159. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  160. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  161. package/dist/cli/mcp/ledger-tools.js +122 -0
  162. package/dist/cli/mcp/product-tools.d.ts +78 -0
  163. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  164. package/dist/cli/mcp/product-tools.js +93 -0
  165. package/dist/cli/mcp/read-only.d.ts +34 -0
  166. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  167. package/dist/cli/mcp/read-only.js +61 -0
  168. package/dist/cli/mcp/report-tools.d.ts +48 -0
  169. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  170. package/dist/cli/mcp/report-tools.js +128 -0
  171. package/dist/cli/mcp/server.d.ts +28 -1
  172. package/dist/cli/mcp/server.d.ts.map +1 -1
  173. package/dist/cli/mcp/server.js +86 -15
  174. package/dist/cli/mcp-config.d.ts +9 -2
  175. package/dist/cli/mcp-config.d.ts.map +1 -1
  176. package/dist/cli/mcp-config.js +8 -3
  177. package/dist/cli/parse-args.d.ts.map +1 -1
  178. package/dist/cli/parse-args.js +57 -3
  179. package/dist/cli/registry.d.ts +35 -0
  180. package/dist/cli/registry.d.ts.map +1 -1
  181. package/dist/cloud-lister/sigv4.d.ts +42 -7
  182. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  183. package/dist/cloud-lister/sigv4.js +72 -22
  184. package/dist/components/adoption.d.ts +69 -0
  185. package/dist/components/adoption.d.ts.map +1 -0
  186. package/dist/components/adoption.js +93 -0
  187. package/dist/components/apply-lease.d.ts +19 -0
  188. package/dist/components/apply-lease.d.ts.map +1 -0
  189. package/dist/components/apply-lease.js +41 -0
  190. package/dist/components/capability.d.ts +122 -5
  191. package/dist/components/capability.d.ts.map +1 -1
  192. package/dist/components/capability.js +14 -6
  193. package/dist/components/check-hooks.d.ts +113 -0
  194. package/dist/components/check-hooks.d.ts.map +1 -0
  195. package/dist/components/check-hooks.js +192 -0
  196. package/dist/components/ci-services.d.ts +57 -0
  197. package/dist/components/ci-services.d.ts.map +1 -0
  198. package/dist/components/ci-services.js +61 -0
  199. package/dist/components/cli-support.d.ts +13 -0
  200. package/dist/components/cli-support.d.ts.map +1 -1
  201. package/dist/components/cli-support.js +10 -2
  202. package/dist/components/driver.d.ts +20 -3
  203. package/dist/components/driver.d.ts.map +1 -1
  204. package/dist/components/driver.js +24 -4
  205. package/dist/components/fan-out-run.d.ts +12 -0
  206. package/dist/components/fan-out-run.d.ts.map +1 -1
  207. package/dist/components/fan-out-run.js +56 -16
  208. package/dist/components/groups.d.ts.map +1 -1
  209. package/dist/components/groups.js +19 -2
  210. package/dist/components/pr-env-ledger.d.ts +32 -0
  211. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  212. package/dist/components/pr-env-ledger.js +39 -0
  213. package/dist/components/pr-env-ports.d.ts +12 -0
  214. package/dist/components/pr-env-ports.d.ts.map +1 -1
  215. package/dist/components/pr-env-ports.js +13 -3
  216. package/dist/components/pr-env-run.d.ts +6 -0
  217. package/dist/components/pr-env-run.d.ts.map +1 -1
  218. package/dist/components/pr-env-run.js +3 -2
  219. package/dist/components/pr-environment.d.ts +31 -3
  220. package/dist/components/pr-environment.d.ts.map +1 -1
  221. package/dist/components/pr-environment.js +25 -7
  222. package/dist/components/pr-pipeline.d.ts +169 -3
  223. package/dist/components/pr-pipeline.d.ts.map +1 -1
  224. package/dist/components/pr-pipeline.js +184 -9
  225. package/dist/components/pr-policy.d.ts +26 -2
  226. package/dist/components/pr-policy.d.ts.map +1 -1
  227. package/dist/components/pr-policy.js +41 -7
  228. package/dist/components/pr-run.d.ts +63 -0
  229. package/dist/components/pr-run.d.ts.map +1 -1
  230. package/dist/components/pr-run.js +82 -3
  231. package/dist/components/pr-targets.d.ts +24 -0
  232. package/dist/components/pr-targets.d.ts.map +1 -0
  233. package/dist/components/pr-targets.js +48 -0
  234. package/dist/components/product-pipeline.d.ts +217 -0
  235. package/dist/components/product-pipeline.d.ts.map +1 -0
  236. package/dist/components/product-pipeline.js +193 -0
  237. package/dist/components/promote.d.ts +6 -0
  238. package/dist/components/promote.d.ts.map +1 -1
  239. package/dist/components/promote.js +4 -1
  240. package/dist/components/release-compile.d.ts +22 -1
  241. package/dist/components/release-compile.d.ts.map +1 -1
  242. package/dist/components/release-compile.js +85 -0
  243. package/dist/components/release-promote.d.ts +15 -1
  244. package/dist/components/release-promote.d.ts.map +1 -1
  245. package/dist/components/release-promote.js +67 -2
  246. package/dist/components/repo-lock.d.ts +27 -0
  247. package/dist/components/repo-lock.d.ts.map +1 -0
  248. package/dist/components/repo-lock.js +49 -0
  249. package/dist/components/row-lease.d.ts +84 -0
  250. package/dist/components/row-lease.d.ts.map +1 -0
  251. package/dist/components/row-lease.js +110 -0
  252. package/dist/components/wave-plan.d.ts +34 -0
  253. package/dist/components/wave-plan.d.ts.map +1 -1
  254. package/dist/components/wave-plan.js +54 -2
  255. package/dist/control/applied.d.ts +89 -0
  256. package/dist/control/applied.d.ts.map +1 -0
  257. package/dist/control/applied.js +175 -0
  258. package/dist/control/consumers.d.ts +78 -0
  259. package/dist/control/consumers.d.ts.map +1 -0
  260. package/dist/control/consumers.js +172 -0
  261. package/dist/control/dispatch.d.ts +334 -0
  262. package/dist/control/dispatch.d.ts.map +1 -0
  263. package/dist/control/dispatch.js +519 -0
  264. package/dist/control/edges.d.ts +75 -0
  265. package/dist/control/edges.d.ts.map +1 -0
  266. package/dist/control/edges.js +133 -0
  267. package/dist/control/reconcile.d.ts +120 -0
  268. package/dist/control/reconcile.d.ts.map +1 -0
  269. package/dist/control/reconcile.js +178 -0
  270. package/dist/control/records.d.ts +187 -0
  271. package/dist/control/records.d.ts.map +1 -0
  272. package/dist/control/records.js +307 -0
  273. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  274. package/dist/discovery/sandbox/bundle.js +25 -1
  275. package/dist/engine-facts.d.ts.map +1 -1
  276. package/dist/engine-facts.js +1 -2
  277. package/dist/exit-codes.d.ts +48 -0
  278. package/dist/exit-codes.d.ts.map +1 -0
  279. package/dist/exit-codes.js +49 -0
  280. package/dist/forge-check/check.d.ts +63 -0
  281. package/dist/forge-check/check.d.ts.map +1 -0
  282. package/dist/forge-check/check.js +139 -0
  283. package/dist/forge-check/contract.d.ts +152 -0
  284. package/dist/forge-check/contract.d.ts.map +1 -0
  285. package/dist/forge-check/contract.js +118 -0
  286. package/dist/forge-check/forge.d.ts +42 -0
  287. package/dist/forge-check/forge.d.ts.map +1 -0
  288. package/dist/forge-check/forge.js +338 -0
  289. package/dist/forge-check/index.d.ts +24 -0
  290. package/dist/forge-check/index.d.ts.map +1 -0
  291. package/dist/forge-check/index.js +23 -0
  292. package/dist/forge-check/pulumi.d.ts +44 -0
  293. package/dist/forge-check/pulumi.d.ts.map +1 -0
  294. package/dist/forge-check/pulumi.js +184 -0
  295. package/dist/forge-check/read-only.d.ts +26 -0
  296. package/dist/forge-check/read-only.d.ts.map +1 -0
  297. package/dist/forge-check/read-only.js +53 -0
  298. package/dist/forge-check/trust.d.ts +94 -0
  299. package/dist/forge-check/trust.d.ts.map +1 -0
  300. package/dist/forge-check/trust.js +532 -0
  301. package/dist/forge-check/types.d.ts +80 -0
  302. package/dist/forge-check/types.d.ts.map +1 -0
  303. package/dist/forge-check/types.js +18 -0
  304. package/dist/forge-check.d.ts +6 -0
  305. package/dist/forge-check.d.ts.map +1 -0
  306. package/dist/forge-check.js +5 -0
  307. package/dist/gate-decision.d.ts +1 -0
  308. package/dist/gate-decision.d.ts.map +1 -1
  309. package/dist/gate-decision.js +2 -0
  310. package/dist/gate-policy.d.ts +47 -1
  311. package/dist/gate-policy.d.ts.map +1 -1
  312. package/dist/gate-policy.js +50 -2
  313. package/dist/index.d.ts +1 -0
  314. package/dist/index.d.ts.map +1 -1
  315. package/dist/index.js +2 -0
  316. package/dist/lexicon.d.ts +106 -6
  317. package/dist/lexicon.d.ts.map +1 -1
  318. package/dist/lifecycle/adoption-file.d.ts +24 -0
  319. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  320. package/dist/lifecycle/adoption-file.js +1 -2
  321. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  322. package/dist/lifecycle/cloud-index.js +1 -2
  323. package/dist/lifecycle/gate-applied.d.ts +6 -0
  324. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  325. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  326. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  327. package/dist/lifecycle/gate-ledger.js +11 -1
  328. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  329. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  330. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  331. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  332. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  333. package/dist/lifecycle/gated-request-digest.js +35 -0
  334. package/dist/lifecycle/gated-request.d.ts +126 -0
  335. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  336. package/dist/lifecycle/gated-request.js +205 -0
  337. package/dist/lifecycle/identity-match.d.ts +15 -0
  338. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  339. package/dist/lifecycle/identity-match.js +11 -6
  340. package/dist/lifecycle/index-diff.d.ts +40 -0
  341. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  342. package/dist/lifecycle/index-diff.js +1 -2
  343. package/dist/lifecycle/index-document.d.ts.map +1 -1
  344. package/dist/lifecycle/index-document.js +1 -2
  345. package/dist/lifecycle/index-import.d.ts +4 -1
  346. package/dist/lifecycle/index-import.d.ts.map +1 -1
  347. package/dist/lifecycle/index-import.js +29 -32
  348. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  349. package/dist/lifecycle/ledger-read.js +7 -3
  350. package/dist/lifecycle/lock-rows.d.ts +76 -0
  351. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  352. package/dist/lifecycle/lock-rows.js +140 -0
  353. package/dist/lifecycle/query.d.ts +50 -3
  354. package/dist/lifecycle/query.d.ts.map +1 -1
  355. package/dist/lifecycle/query.js +97 -6
  356. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  357. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  358. package/dist/lifecycle/release-catalog-site.js +232 -0
  359. package/dist/lifecycle/release-catalog.d.ts +201 -0
  360. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  361. package/dist/lifecycle/release-catalog.js +198 -0
  362. package/dist/lifecycle/release-changelog.d.ts +41 -0
  363. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  364. package/dist/lifecycle/release-changelog.js +38 -0
  365. package/dist/lifecycle/release-cut.d.ts +1 -0
  366. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  367. package/dist/lifecycle/release-cut.js +1 -1
  368. package/dist/lifecycle/release-ledger.d.ts +16 -0
  369. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  370. package/dist/lifecycle/release-ledger.js +10 -0
  371. package/dist/lifecycle/release-publish.d.ts +43 -22
  372. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  373. package/dist/lifecycle/release-read.d.ts.map +1 -1
  374. package/dist/lifecycle/release-read.js +3 -0
  375. package/dist/lifecycle/release-status.d.ts +86 -0
  376. package/dist/lifecycle/release-status.d.ts.map +1 -0
  377. package/dist/lifecycle/release-status.js +136 -0
  378. package/dist/lifecycle/resource-lock.d.ts +120 -0
  379. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  380. package/dist/lifecycle/resource-lock.js +317 -0
  381. package/dist/lifecycle/retention.d.ts.map +1 -1
  382. package/dist/lifecycle/retention.js +3 -0
  383. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  384. package/dist/lifecycle/run-ledger.js +9 -1
  385. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  386. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  387. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  388. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  389. package/dist/lifecycle/snapshot-store.js +1 -2
  390. package/dist/lifecycle/target-lock.d.ts +15 -0
  391. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  392. package/dist/lifecycle/target-lock.js +25 -10
  393. package/dist/mcp/types.d.ts +7 -0
  394. package/dist/mcp/types.d.ts.map +1 -1
  395. package/dist/notify-product.d.ts +43 -0
  396. package/dist/notify-product.d.ts.map +1 -0
  397. package/dist/notify-product.js +58 -0
  398. package/dist/notify-relay.d.ts +197 -0
  399. package/dist/notify-relay.d.ts.map +1 -0
  400. package/dist/notify-relay.js +321 -0
  401. package/dist/notify.d.ts +44 -4
  402. package/dist/notify.d.ts.map +1 -1
  403. package/dist/notify.js +77 -14
  404. package/dist/object-store/azure-blob.d.ts +129 -0
  405. package/dist/object-store/azure-blob.d.ts.map +1 -0
  406. package/dist/object-store/azure-blob.js +341 -0
  407. package/dist/object-store/common.d.ts +108 -0
  408. package/dist/object-store/common.d.ts.map +1 -0
  409. package/dist/object-store/common.js +80 -0
  410. package/dist/object-store/errors.d.ts +28 -0
  411. package/dist/object-store/errors.d.ts.map +1 -0
  412. package/dist/object-store/errors.js +21 -0
  413. package/dist/object-store/from-env.d.ts +18 -0
  414. package/dist/object-store/from-env.d.ts.map +1 -0
  415. package/dist/object-store/from-env.js +22 -0
  416. package/dist/object-store/gcs.d.ts +106 -0
  417. package/dist/object-store/gcs.d.ts.map +1 -0
  418. package/dist/object-store/gcs.js +393 -0
  419. package/dist/object-store/index.d.ts +9 -0
  420. package/dist/object-store/index.d.ts.map +1 -0
  421. package/dist/object-store/index.js +8 -0
  422. package/dist/object-store/s3.d.ts +146 -0
  423. package/dist/object-store/s3.d.ts.map +1 -0
  424. package/dist/object-store/s3.js +306 -0
  425. package/dist/op/activities/converge.d.ts.map +1 -1
  426. package/dist/op/activities/converge.js +2 -1
  427. package/dist/op/activities/index.d.ts +1 -1
  428. package/dist/op/activities/index.d.ts.map +1 -1
  429. package/dist/op/activities/index.js +1 -1
  430. package/dist/op/activities/review-agent.d.ts +55 -2
  431. package/dist/op/activities/review-agent.d.ts.map +1 -1
  432. package/dist/op/activities/review-agent.js +65 -5
  433. package/dist/op/gate.d.ts +29 -1
  434. package/dist/op/gate.d.ts.map +1 -1
  435. package/dist/op/gate.js +59 -23
  436. package/dist/op/generate-pipeline.d.ts.map +1 -1
  437. package/dist/op/generate-pipeline.js +7 -1
  438. package/dist/op/index.d.ts +12 -1
  439. package/dist/op/index.d.ts.map +1 -1
  440. package/dist/op/index.js +7 -1
  441. package/dist/op/op-waves-after-plan.d.ts +137 -0
  442. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  443. package/dist/op/op-waves-after-plan.js +163 -0
  444. package/dist/op/op-waves-capability-spec.d.ts +55 -0
  445. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  446. package/dist/op/op-waves-capability-spec.js +94 -0
  447. package/dist/op/op-waves-capability.d.ts +197 -0
  448. package/dist/op/op-waves-capability.d.ts.map +1 -0
  449. package/dist/op/op-waves-capability.js +311 -0
  450. package/dist/op/op-waves-events.d.ts +54 -0
  451. package/dist/op/op-waves-events.d.ts.map +1 -0
  452. package/dist/op/op-waves-events.js +122 -0
  453. package/dist/op/op-waves-notify.d.ts +7 -1
  454. package/dist/op/op-waves-notify.d.ts.map +1 -1
  455. package/dist/op/op-waves-notify.js +35 -16
  456. package/dist/op/op-waves-release-port.d.ts +18 -0
  457. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  458. package/dist/op/op-waves-release-port.js +61 -0
  459. package/dist/op/op-waves-release.d.ts +92 -0
  460. package/dist/op/op-waves-release.d.ts.map +1 -0
  461. package/dist/op/op-waves-release.js +97 -0
  462. package/dist/op/op-waves-run.d.ts +175 -4
  463. package/dist/op/op-waves-run.d.ts.map +1 -1
  464. package/dist/op/op-waves-run.js +981 -41
  465. package/dist/op/op-waves-stand-down.d.ts +60 -0
  466. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  467. package/dist/op/op-waves-stand-down.js +97 -0
  468. package/dist/op/op-waves.d.ts +152 -8
  469. package/dist/op/op-waves.d.ts.map +1 -1
  470. package/dist/op/op-waves.js +161 -17
  471. package/dist/op/runtime.d.ts +91 -0
  472. package/dist/op/runtime.d.ts.map +1 -1
  473. package/dist/op/runtime.js +19 -0
  474. package/dist/op/stage-hooks.d.ts +45 -7
  475. package/dist/op/stage-hooks.d.ts.map +1 -1
  476. package/dist/op/stage-hooks.js +61 -3
  477. package/dist/op/steward-beside.d.ts.map +1 -1
  478. package/dist/op/steward-beside.js +2 -1
  479. package/dist/op/types.d.ts +2 -2
  480. package/dist/op/types.d.ts.map +1 -1
  481. package/dist/op/types.js +3 -2
  482. package/dist/otlp-metrics.d.ts +38 -0
  483. package/dist/otlp-metrics.d.ts.map +1 -0
  484. package/dist/otlp-metrics.js +82 -0
  485. package/dist/otlp.d.ts +249 -0
  486. package/dist/otlp.d.ts.map +1 -0
  487. package/dist/otlp.js +426 -0
  488. package/dist/override-gate.d.ts.map +1 -1
  489. package/dist/override-gate.js +5 -0
  490. package/dist/policy-packs.d.ts +69 -0
  491. package/dist/policy-packs.d.ts.map +1 -0
  492. package/dist/policy-packs.js +205 -0
  493. package/dist/policy-source.d.ts +51 -0
  494. package/dist/policy-source.d.ts.map +1 -0
  495. package/dist/policy-source.js +103 -0
  496. package/dist/pr-forge.d.ts +40 -0
  497. package/dist/pr-forge.d.ts.map +1 -1
  498. package/dist/pr-forge.js +92 -0
  499. package/dist/pr-loop.d.ts +149 -11
  500. package/dist/pr-loop.d.ts.map +1 -1
  501. package/dist/pr-loop.js +283 -44
  502. package/dist/pr-post.d.ts +16 -0
  503. package/dist/pr-post.d.ts.map +1 -1
  504. package/dist/pr-post.js +26 -1
  505. package/dist/pr-report-url.d.ts +32 -4
  506. package/dist/pr-report-url.d.ts.map +1 -1
  507. package/dist/pr-report-url.js +46 -5
  508. package/dist/pr-requires.d.ts +13 -2
  509. package/dist/pr-requires.d.ts.map +1 -1
  510. package/dist/pr-requires.js +14 -0
  511. package/dist/release-floors.d.ts +1 -1
  512. package/dist/release-floors.js +1 -1
  513. package/dist/run-event.d.ts +26 -1
  514. package/dist/run-event.d.ts.map +1 -1
  515. package/dist/run-event.js +4 -1
  516. package/dist/sorted-json.d.ts +10 -0
  517. package/dist/sorted-json.d.ts.map +1 -0
  518. package/dist/sorted-json.js +14 -0
  519. package/dist/terraform/credentials.d.ts +59 -0
  520. package/dist/terraform/credentials.d.ts.map +1 -0
  521. package/dist/terraform/credentials.js +149 -0
  522. package/dist/utils.d.ts +1 -4
  523. package/dist/utils.d.ts.map +1 -1
  524. package/dist/utils.js +1 -9
  525. package/dist/wave-runtime.d.ts +1 -1
  526. package/dist/wave-runtime.js +2 -2
  527. package/dist/wave-runtime.mjs +390 -285
  528. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  529. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  530. package/dist/workspace/ci-lock-grain.d.ts +12 -0
  531. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  532. package/dist/workspace/ci-lock-grain.js +27 -0
  533. package/dist/workspace/ci-run.d.ts +2 -1
  534. package/dist/workspace/ci-run.d.ts.map +1 -1
  535. package/dist/workspace/ci-run.js +6 -3
  536. package/dist/workspace/declaration.d.ts +16 -4
  537. package/dist/workspace/declaration.d.ts.map +1 -1
  538. package/dist/workspace/declaration.js +5 -2
  539. package/dist/workspace/declaration.schema.json +27 -3
  540. package/dist/workspace/drift-cli.d.ts.map +1 -1
  541. package/dist/workspace/drift-cli.js +8 -3
  542. package/dist/workspace/exit-cli.d.ts +1 -1
  543. package/dist/workspace/exit-cli.d.ts.map +1 -1
  544. package/dist/workspace/exit-cli.js +2 -1
  545. package/dist/workspace/import-fetch.d.ts +4 -2
  546. package/dist/workspace/import-fetch.d.ts.map +1 -1
  547. package/dist/workspace/import-fetch.js +4 -2
  548. package/dist/workspace/import-init.d.ts.map +1 -1
  549. package/dist/workspace/import-init.js +4 -2
  550. package/dist/workspace/ledger.schema.json +7 -3
  551. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  552. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  553. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  554. package/dist/workspace/pr-report.schema.json +74 -3
  555. package/dist/workspace/promote.d.ts +1 -1
  556. package/dist/workspace/promote.d.ts.map +1 -1
  557. package/dist/workspace/promote.js +2 -1
  558. package/dist/workspace/records-cli.d.ts +2 -2
  559. package/dist/workspace/records-cli.d.ts.map +1 -1
  560. package/dist/workspace/records-cli.js +3 -2
  561. package/dist/workspace/release-catalog.schema.json +277 -0
  562. package/dist/workspace/run-event.schema.json +18 -1
  563. package/dist/workspace/work-cli.d.ts +3 -1
  564. package/dist/workspace/work-cli.d.ts.map +1 -1
  565. package/dist/workspace/work-cli.js +7 -2
  566. package/dist/workspace/workspace-run.d.ts.map +1 -1
  567. package/dist/workspace/workspace-run.js +2 -1
  568. package/package.json +21 -1
  569. package/src/__fixtures__/estate-ledger.ts +101 -0
  570. package/src/__fixtures__/oidc-emulator.ts +31 -2
  571. package/src/__fixtures__/product-words.ts +44 -0
  572. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  573. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  574. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  575. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  576. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  577. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  578. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  579. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  580. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  581. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  582. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  583. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  584. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  585. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  586. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  587. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  588. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  589. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  590. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  591. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  592. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  593. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  594. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  595. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  596. package/src/__golden__/wave-loop/op-point.json +18 -4
  597. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  598. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  599. package/src/__golden__/wave-loop/op-spend.json +10 -2
  600. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  601. package/src/__golden__/wave-loop/op-wide.json +20 -4
  602. package/src/bucket-check/azure.ts +307 -0
  603. package/src/bucket-check/bucket-check.test.ts +210 -0
  604. package/src/bucket-check/fixtures/azure.json +153 -0
  605. package/src/bucket-check/fixtures/gcs.json +148 -0
  606. package/src/bucket-check/fixtures/s3.json +277 -0
  607. package/src/bucket-check/gcs.ts +257 -0
  608. package/src/bucket-check/index.ts +61 -0
  609. package/src/bucket-check/s3.ts +433 -0
  610. package/src/bucket-check/types.ts +75 -0
  611. package/src/bucket-check/wire.ts +50 -0
  612. package/src/bucket-check.ts +5 -0
  613. package/src/capabilities/templates.test.ts +2 -3
  614. package/src/capabilities/templates.ts +1 -2
  615. package/src/cdk/advise.test.ts +1 -1
  616. package/src/change-set-bundle.test.ts +0 -1
  617. package/src/change-set.ts +2 -3
  618. package/src/ci-agent.test.ts +348 -0
  619. package/src/ci-agent.ts +1026 -0
  620. package/src/ci-control.ts +174 -0
  621. package/src/ci-estate/delivery.ts +433 -0
  622. package/src/ci-estate/overdue.ts +81 -0
  623. package/src/ci-estate/page.ts +343 -0
  624. package/src/ci-estate/rows.ts +251 -0
  625. package/src/ci-estate.test.ts +281 -0
  626. package/src/ci-estate.ts +176 -0
  627. package/src/ci-handover.ts +67 -16
  628. package/src/ci-identity-database.test.ts +55 -0
  629. package/src/ci-identity-pulumi.test.ts +163 -0
  630. package/src/ci-identity-targets.test.ts +6 -2
  631. package/src/ci-identity.ts +124 -22
  632. package/src/ci-product-words.test.ts +101 -0
  633. package/src/ci-product-words.ts +536 -0
  634. package/src/ci-product.ts +174 -0
  635. package/src/ci-shared-reads.test.ts +145 -0
  636. package/src/cli/commands/audit.test.ts +1 -1
  637. package/src/cli/commands/audit.ts +3 -2
  638. package/src/cli/commands/carve.test.ts +1 -1
  639. package/src/cli/commands/carve.ts +2 -2
  640. package/src/cli/commands/init.ts +3 -1
  641. package/src/cli/component-wave-args.test.ts +16 -0
  642. package/src/cli/handlers/agent.ts +126 -0
  643. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  644. package/src/cli/handlers/approve-confirm.ts +200 -0
  645. package/src/cli/handlers/approve.ts +18 -1
  646. package/src/cli/handlers/build.test.ts +7 -0
  647. package/src/cli/handlers/build.ts +44 -1
  648. package/src/cli/handlers/ci-check.ts +33 -0
  649. package/src/cli/handlers/ci-forge-check.ts +91 -0
  650. package/src/cli/handlers/fan-out.test.ts +10 -10
  651. package/src/cli/handlers/fan-out.ts +5 -0
  652. package/src/cli/handlers/gate-pending.ts +46 -0
  653. package/src/cli/handlers/init.ts +1 -0
  654. package/src/cli/handlers/ledger.ts +1 -1
  655. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  656. package/src/cli/handlers/lock.test.ts +29 -2
  657. package/src/cli/handlers/lock.ts +66 -6
  658. package/src/cli/handlers/notify-relay.ts +130 -0
  659. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  660. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  661. package/src/cli/handlers/pr-env.ts +48 -11
  662. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  663. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  664. package/src/cli/handlers/pr-waves.test.ts +8 -2
  665. package/src/cli/handlers/pr.test.ts +8 -8
  666. package/src/cli/handlers/pr.ts +655 -205
  667. package/src/cli/handlers/promote.test.ts +5 -5
  668. package/src/cli/handlers/promote.ts +22 -2
  669. package/src/cli/handlers/release.ts +2 -0
  670. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  671. package/src/cli/handlers/run-wave.ts +65 -1
  672. package/src/cli/handlers/run.test.ts +6 -4
  673. package/src/cli/handlers/run.ts +86 -1
  674. package/src/cli/handlers/serve.ts +10 -1
  675. package/src/cli/main.ts +126 -13
  676. package/src/cli/mcp/ledger-tools.ts +126 -0
  677. package/src/cli/mcp/product-tools.test.ts +123 -0
  678. package/src/cli/mcp/product-tools.ts +129 -0
  679. package/src/cli/mcp/read-only.test.ts +134 -0
  680. package/src/cli/mcp/read-only.ts +68 -0
  681. package/src/cli/mcp/report-tools.ts +135 -0
  682. package/src/cli/mcp/server.test.ts +5 -4
  683. package/src/cli/mcp/server.ts +90 -16
  684. package/src/cli/mcp-config.ts +8 -3
  685. package/src/cli/parse-args.ts +42 -2
  686. package/src/cli/registry.ts +35 -0
  687. package/src/cloud-lister/sigv4.ts +80 -23
  688. package/src/components/adoption.test.ts +140 -0
  689. package/src/components/adoption.ts +141 -0
  690. package/src/components/apply-lease.ts +49 -0
  691. package/src/components/capability.ts +130 -6
  692. package/src/components/check-hooks.test.ts +66 -0
  693. package/src/components/check-hooks.ts +252 -0
  694. package/src/components/ci-services.test.ts +51 -0
  695. package/src/components/ci-services.ts +83 -0
  696. package/src/components/cli-support.ts +23 -2
  697. package/src/components/driver.test.ts +3 -3
  698. package/src/components/driver.ts +38 -5
  699. package/src/components/fan-out-run.ts +68 -18
  700. package/src/components/groups.ts +17 -2
  701. package/src/components/pr-comment-preview.test.ts +54 -0
  702. package/src/components/pr-env-ledger.test.ts +9 -0
  703. package/src/components/pr-env-ledger.ts +43 -0
  704. package/src/components/pr-env-ports.ts +29 -4
  705. package/src/components/pr-env-run-bundle.test.ts +8 -0
  706. package/src/components/pr-env-run.test.ts +19 -0
  707. package/src/components/pr-env-run.ts +12 -2
  708. package/src/components/pr-environment.test.ts +29 -0
  709. package/src/components/pr-environment.ts +39 -7
  710. package/src/components/pr-pipeline.test.ts +15 -0
  711. package/src/components/pr-pipeline.ts +274 -9
  712. package/src/components/pr-policy.ts +45 -7
  713. package/src/components/pr-run.test.ts +1 -1
  714. package/src/components/pr-run.ts +121 -5
  715. package/src/components/pr-targets.test.ts +35 -0
  716. package/src/components/pr-targets.ts +45 -0
  717. package/src/components/product-pipeline.test.ts +200 -0
  718. package/src/components/product-pipeline.ts +341 -0
  719. package/src/components/promote.ts +10 -1
  720. package/src/components/release-compile.ts +87 -1
  721. package/src/components/release-promote.ts +65 -1
  722. package/src/components/repo-lock.ts +52 -0
  723. package/src/components/row-lease.test.ts +490 -0
  724. package/src/components/row-lease.ts +167 -0
  725. package/src/components/wave-plan-policy.test.ts +19 -0
  726. package/src/components/wave-plan.ts +78 -4
  727. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  728. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  729. package/src/control/applied.test.ts +148 -0
  730. package/src/control/applied.ts +191 -0
  731. package/src/control/consumers.test.ts +129 -0
  732. package/src/control/consumers.ts +192 -0
  733. package/src/control/control.test.ts +302 -0
  734. package/src/control/dispatch.ts +699 -0
  735. package/src/control/edges.test.ts +112 -0
  736. package/src/control/edges.ts +164 -0
  737. package/src/control/note-checkout.test.ts +91 -0
  738. package/src/control/reconcile.ts +250 -0
  739. package/src/control/records.ts +395 -0
  740. package/src/discovery/sandbox/bundle.ts +25 -1
  741. package/src/engine-facts.test.ts +2 -3
  742. package/src/engine-facts.ts +1 -2
  743. package/src/exit-codes.test.ts +31 -0
  744. package/src/exit-codes.ts +55 -0
  745. package/src/forge-check/check.ts +155 -0
  746. package/src/forge-check/contract.ts +215 -0
  747. package/src/forge-check/forge-check.test.ts +427 -0
  748. package/src/forge-check/forge.ts +318 -0
  749. package/src/forge-check/index.ts +43 -0
  750. package/src/forge-check/pulumi.ts +192 -0
  751. package/src/forge-check/read-only.ts +56 -0
  752. package/src/forge-check/trust.ts +527 -0
  753. package/src/forge-check/types.ts +78 -0
  754. package/src/forge-check.ts +5 -0
  755. package/src/gate-decision-bundle.test.ts +13 -0
  756. package/src/gate-decision.ts +3 -0
  757. package/src/gate-policy.ts +92 -3
  758. package/src/gated-waves-bundle.test.ts +0 -1
  759. package/src/index.ts +2 -0
  760. package/src/lexicon.ts +95 -6
  761. package/src/lifecycle/adoption-file.ts +1 -2
  762. package/src/lifecycle/cloud-index.test.ts +2 -3
  763. package/src/lifecycle/cloud-index.ts +1 -2
  764. package/src/lifecycle/control-entries-ledger.test.ts +70 -0
  765. package/src/lifecycle/gate-applied.ts +6 -0
  766. package/src/lifecycle/gate-ledger.ts +36 -1
  767. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  768. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  769. package/src/lifecycle/gated-request-digest.ts +49 -0
  770. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  771. package/src/lifecycle/gated-request.ts +280 -0
  772. package/src/lifecycle/identity-match.ts +25 -6
  773. package/src/lifecycle/index-diff.ts +1 -2
  774. package/src/lifecycle/index-document.ts +1 -2
  775. package/src/lifecycle/index-import.test.ts +14 -0
  776. package/src/lifecycle/index-import.ts +54 -34
  777. package/src/lifecycle/ledger-read.ts +7 -3
  778. package/src/lifecycle/lock-rows.test.ts +109 -0
  779. package/src/lifecycle/lock-rows.ts +167 -0
  780. package/src/lifecycle/publish-target-context.test.ts +108 -0
  781. package/src/lifecycle/query.test.ts +2 -3
  782. package/src/lifecycle/query.ts +109 -7
  783. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  784. package/src/lifecycle/release-catalog-site.ts +291 -0
  785. package/src/lifecycle/release-catalog.test.ts +193 -0
  786. package/src/lifecycle/release-catalog.ts +353 -0
  787. package/src/lifecycle/release-changelog.test.ts +70 -0
  788. package/src/lifecycle/release-changelog.ts +71 -0
  789. package/src/lifecycle/release-cut.ts +2 -2
  790. package/src/lifecycle/release-ledger.ts +20 -0
  791. package/src/lifecycle/release-publish.ts +45 -22
  792. package/src/lifecycle/release-read.ts +2 -0
  793. package/src/lifecycle/release-status.test.ts +186 -0
  794. package/src/lifecycle/release-status.ts +176 -0
  795. package/src/lifecycle/resource-lock.test.ts +175 -0
  796. package/src/lifecycle/resource-lock.ts +354 -0
  797. package/src/lifecycle/retention.ts +2 -0
  798. package/src/lifecycle/run-ledger.ts +7 -1
  799. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  800. package/src/lifecycle/snapshot-store.ts +1 -2
  801. package/src/lifecycle/target-lock.ts +24 -9
  802. package/src/mcp/types.ts +7 -0
  803. package/src/notify-product.ts +76 -0
  804. package/src/notify-relay.test.ts +213 -0
  805. package/src/notify-relay.ts +407 -0
  806. package/src/notify.ts +95 -14
  807. package/src/object-store/azure-blob.ts +374 -0
  808. package/src/object-store/common.ts +133 -0
  809. package/src/object-store/errors.ts +26 -0
  810. package/src/object-store/from-env.ts +36 -0
  811. package/src/object-store/gcs.ts +436 -0
  812. package/src/object-store/index.ts +8 -0
  813. package/src/object-store/object-store.test.ts +130 -0
  814. package/src/object-store/s3.ts +350 -0
  815. package/src/op/activities/converge.ts +2 -1
  816. package/src/op/activities/index.ts +1 -1
  817. package/src/op/activities/review-agent.open.test.ts +78 -0
  818. package/src/op/activities/review-agent.test.ts +13 -0
  819. package/src/op/activities/review-agent.ts +89 -5
  820. package/src/op/gate.ts +81 -22
  821. package/src/op/generate-pipeline.ts +7 -1
  822. package/src/op/index.ts +21 -0
  823. package/src/op/op-waves-after-plan.test.ts +276 -0
  824. package/src/op/op-waves-after-plan.ts +238 -0
  825. package/src/op/op-waves-capability-spec.ts +113 -0
  826. package/src/op/op-waves-capability.test.ts +217 -0
  827. package/src/op/op-waves-capability.ts +370 -0
  828. package/src/op/op-waves-events.ts +135 -0
  829. package/src/op/op-waves-notify-words.test.ts +149 -0
  830. package/src/op/op-waves-notify.ts +41 -16
  831. package/src/op/op-waves-pull-request.test.ts +142 -0
  832. package/src/op/op-waves-release-port.ts +64 -0
  833. package/src/op/op-waves-release.test.ts +209 -0
  834. package/src/op/op-waves-release.ts +133 -0
  835. package/src/op/op-waves-run-record.test.ts +32 -0
  836. package/src/op/op-waves-run.ts +1142 -49
  837. package/src/op/op-waves-stand-down.test.ts +240 -0
  838. package/src/op/op-waves-stand-down.ts +108 -0
  839. package/src/op/op-waves-trace.test.ts +205 -0
  840. package/src/op/op-waves.test.ts +112 -0
  841. package/src/op/op-waves.ts +261 -20
  842. package/src/op/runtime.ts +104 -0
  843. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  844. package/src/op/stage-hooks.ts +91 -12
  845. package/src/op/steward-beside.ts +2 -1
  846. package/src/op/types.ts +3 -2
  847. package/src/otlp-metrics.ts +96 -0
  848. package/src/otlp.test.ts +243 -0
  849. package/src/otlp.ts +544 -0
  850. package/src/override-gate-bundle.test.ts +2 -0
  851. package/src/override-gate.ts +4 -0
  852. package/src/policy-packs.ts +230 -0
  853. package/src/policy-source.test.ts +256 -0
  854. package/src/policy-source.ts +112 -0
  855. package/src/pr-forge.ts +123 -0
  856. package/src/pr-loop-bundle.test.ts +6 -2
  857. package/src/pr-loop-words.test.ts +155 -0
  858. package/src/pr-loop.ts +371 -52
  859. package/src/pr-post.ts +32 -1
  860. package/src/pr-report-url.ts +62 -6
  861. package/src/pr-requires.test.ts +37 -1
  862. package/src/pr-requires.ts +16 -2
  863. package/src/product-subpaths-plain-node.e2e.test.ts +211 -0
  864. package/src/release-floors.ts +1 -1
  865. package/src/run-event.ts +29 -1
  866. package/src/sorted-json.ts +17 -0
  867. package/src/stage-hooks-bundle.test.ts +8 -0
  868. package/src/terraform/credentials.test.ts +77 -0
  869. package/src/terraform/credentials.ts +162 -0
  870. package/src/utils.ts +2 -11
  871. package/src/wave-loop-golden.test.ts +2 -1
  872. package/src/wave-runtime.ts +2 -2
  873. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  874. package/src/workspace/ci-lock-grain.test.ts +31 -0
  875. package/src/workspace/ci-lock-grain.ts +30 -0
  876. package/src/workspace/ci-report-url.test.ts +1 -1
  877. package/src/workspace/ci-run.test.ts +1 -1
  878. package/src/workspace/ci-run.ts +6 -3
  879. package/src/workspace/declaration.schema.json +27 -3
  880. package/src/workspace/declaration.test.ts +1 -1
  881. package/src/workspace/declaration.ts +26 -10
  882. package/src/workspace/drift-cli.ts +8 -3
  883. package/src/workspace/exit-cli.ts +2 -1
  884. package/src/workspace/import-fetch.ts +4 -2
  885. package/src/workspace/import-init.ts +4 -2
  886. package/src/workspace/ledger.schema.json +7 -3
  887. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  888. package/src/workspace/pr-report.schema.json +74 -3
  889. package/src/workspace/promote.ts +2 -1
  890. package/src/workspace/records-cli.ts +3 -2
  891. package/src/workspace/release-catalog.schema.json +277 -0
  892. package/src/workspace/run-event.schema.json +18 -1
  893. package/src/workspace/work-cli.ts +8 -2
  894. package/src/workspace/workspace-run.ts +2 -1
@@ -0,0 +1,42 @@
1
+ /**
2
+ * `@intentius/chant/ci-control` (#4568): the control repo, shared by the CI
3
+ * products built on chant (terragucci, plywood).
4
+ *
5
+ * - The dispatch a member's pipeline sends after its apply on the default
6
+ * branch, for GitHub, GitLab and Forgejo, and the control repo's own
7
+ * pipeline that runs the member's dependents (./control/dispatch.ts). The
8
+ * forge lexicons serialize both: the member's `control-dispatch` job from
9
+ * the pull request loop's `control` option, and the control repo's file
10
+ * from each lexicon's `generateControlPipeline`.
11
+ * - The control repo's projects and defaults as `control-entry` records on
12
+ * its workspace ledger (./control/records.ts).
13
+ * - Reconcile over the product's generator (./control/reconcile.ts).
14
+ * - Each project's `consumers.json` joined into one consumer list per
15
+ * release version, for the release catalog (./control/consumers.ts, #4600).
16
+ * - The apply outcome an op waves pipeline's dispatch carries, and the
17
+ * control repo's record of each one in `_control/applied.jsonl`
18
+ * (./control/applied.ts, #4617).
19
+ * - Cross-stack edges marked stale, current or unknown from the entries
20
+ * and those records, for the pull request note (./control/edges.ts), and
21
+ * the note job's read-only fetch of the control repo's `chant/lifecycle`
22
+ * that sets `CHANT_CONTROL_DIR` (`controlNoteCheckout`, #4619).
23
+ *
24
+ * A product holds the words, the settings it writes into an entry and their
25
+ * check, its generator and its docs. It feature-detects this entry until the
26
+ * chant release that carries {@link CI_CONTROL_FLOOR} is its floor:
27
+ * `controlDispatchRequest`, `putControlEntry` and `reconcileProjects`
28
+ * present means the rest is too.
29
+ */
30
+ /** The first chant with `@intentius/chant/ci-control` (#4568). */
31
+ export declare const CI_CONTROL_FLOOR = "0.124.55";
32
+ /** The first chant that records the applies a dispatch carries and marks cross-stack edges (#4617). `recordControlAppliedFromEnv` present means the rest is too. */
33
+ export declare const CONTROL_APPLIED_FLOOR = "0.124.55";
34
+ /** The first chant whose note jobs read the control repo for the cross-stack edges (#4619). `controlNoteCheckout` present means the rest is too. */
35
+ export declare const CONTROL_NOTE_CHECKOUT_FLOOR = "0.124.55";
36
+ export { CONTROL_APPLY_OUTCOMES, CONTROL_OUTCOME_VAR, CONTROL_RUNS_DEPENDENTS, type ControlApplyOutcome, CONTROL_CHANT_COMMAND, CONTROL_DEPENDENTS_FLOOR, CONTROL_DISPATCH_JOB, CONTROL_MEMBER_VAR, CONTROL_NAME, CONTROL_OP_VAR, CONTROL_READ_TOKEN_ENV, CONTROL_READ_TOKEN_SECRET, CONTROL_REF, CONTROL_REF_DEFAULT, CONTROL_SECRET_NAME, CONTROL_SHA_VAR, CONTROL_TOKEN_ENV, CONTROL_TOKEN_SECRET, CONTROL_TOKEN_VARS, ControlConfigError, ControlDispatchError, controlDependentsScript, controlDispatchEvent, controlDispatchJob, controlDispatchRequest, controlDispatchScript, controlNoteCheckout, controlPipelineFileName, controlPipelinePath, controlPipelineSpec, controlSettingsProblems, controlStatusContext, dispatchControl, forgeApiBase, forgeFromHost, parseProjectKey, resolveControlTarget, type ControlDispatch, type ControlDispatchJobSpec, type ControlDispatchRequest, type ControlDispatchScriptOptions, type ControlNoteCheckout, type ControlPipelineSpec, type ControlSettingsInput, type ControlTarget, type ControlTokenPlace, type DispatchControlOptions, type ProjectKey, } from "./control/dispatch.js";
37
+ export { CONTROL_ENTRY_KIND, CONTROL_ENTRY_KINDS, CONTROL_ID_PREFIX, CONTROL_LEDGER_DIR, CONTROL_LEDGER_FILE, ControlEntryConflict, ControlRecordsError, controlConfig, controlEntryDigest, controlEntryRecordProblems, currentControlEntries, estateClaims, gitControlLedger, importControlConfig, parseControlEntries, putControlEntry, readControlEntries, retireControlEntry, type ControlEntry, type ControlEntryKind, type ControlEntryRecord, type ControlEntryState, type ControlLedgerPort, type ControlPutResult, type ControlSettingsValidator, type ControlWriteOptions, type ReadControlEntriesOptions, } from "./control/records.js";
38
+ export { cloneUrlOf, commandGit, describeReconcile, gitAuthEnv, reconcileBranch, reconcileProjects, reconcileTokenEnv, type ControlFileChange, type ControlGenerator, type ControlGit, type GitAuth, type ReconcileOptions, type ReconcileOutcome, type ReconcileProject, type ReconcileTarget, } from "./control/reconcile.js";
39
+ export { CONSUMERS_CONTRACT, CONSUMERS_FILE, consumersDocument, joinControlConsumers, parseConsumersDocument, readControlConsumers, type ConsumersDocument, type ControlConsumers, type JoinedConsumers, type ProjectConsumers, type ProjectConsumersReader, } from "./control/consumers.js";
40
+ export { CONTROL_APPLIED_FILE, CONTROL_APPLIED_KIND, applyOutcomeOf, controlAppliedProblems, gitControlAppliedLedger, latestControlApplies, parseControlApplied, recordControlApplied, recordControlAppliedFromEnv, type ApplyOutcomeSummary, type ControlAppliedRecord, } from "./control/applied.js";
41
+ export { CONTROL_DIR_ENV, controlEdgeFactsFromEnv, controlMemberOf, markCrossStackEdges, readControlEdgeFacts, remarkCrossStackEdges, type ControlEdgeFacts, type CrossStackEdge, type CrossStackRead, } from "./control/edges.js";
42
+ //# sourceMappingURL=ci-control.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ci-control.d.ts","sourceRoot":"","sources":["../src/ci-control.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * `@intentius/chant/ci-control` (#4568): the control repo, shared by the CI
3
+ * products built on chant (terragucci, plywood).
4
+ *
5
+ * - The dispatch a member's pipeline sends after its apply on the default
6
+ * branch, for GitHub, GitLab and Forgejo, and the control repo's own
7
+ * pipeline that runs the member's dependents (./control/dispatch.ts). The
8
+ * forge lexicons serialize both: the member's `control-dispatch` job from
9
+ * the pull request loop's `control` option, and the control repo's file
10
+ * from each lexicon's `generateControlPipeline`.
11
+ * - The control repo's projects and defaults as `control-entry` records on
12
+ * its workspace ledger (./control/records.ts).
13
+ * - Reconcile over the product's generator (./control/reconcile.ts).
14
+ * - Each project's `consumers.json` joined into one consumer list per
15
+ * release version, for the release catalog (./control/consumers.ts, #4600).
16
+ * - The apply outcome an op waves pipeline's dispatch carries, and the
17
+ * control repo's record of each one in `_control/applied.jsonl`
18
+ * (./control/applied.ts, #4617).
19
+ * - Cross-stack edges marked stale, current or unknown from the entries
20
+ * and those records, for the pull request note (./control/edges.ts), and
21
+ * the note job's read-only fetch of the control repo's `chant/lifecycle`
22
+ * that sets `CHANT_CONTROL_DIR` (`controlNoteCheckout`, #4619).
23
+ *
24
+ * A product holds the words, the settings it writes into an entry and their
25
+ * check, its generator and its docs. It feature-detects this entry until the
26
+ * chant release that carries {@link CI_CONTROL_FLOOR} is its floor:
27
+ * `controlDispatchRequest`, `putControlEntry` and `reconcileProjects`
28
+ * present means the rest is too.
29
+ */
30
+ import { NEXT_RELEASE } from "./release-floors.js";
31
+ /** The first chant with `@intentius/chant/ci-control` (#4568). */
32
+ export const CI_CONTROL_FLOOR = NEXT_RELEASE;
33
+ /** The first chant that records the applies a dispatch carries and marks cross-stack edges (#4617). `recordControlAppliedFromEnv` present means the rest is too. */
34
+ export const CONTROL_APPLIED_FLOOR = NEXT_RELEASE;
35
+ /** The first chant whose note jobs read the control repo for the cross-stack edges (#4619). `controlNoteCheckout` present means the rest is too. */
36
+ export const CONTROL_NOTE_CHECKOUT_FLOOR = NEXT_RELEASE;
37
+ export { CONTROL_APPLY_OUTCOMES, CONTROL_OUTCOME_VAR, CONTROL_RUNS_DEPENDENTS, CONTROL_CHANT_COMMAND, CONTROL_DEPENDENTS_FLOOR, CONTROL_DISPATCH_JOB, CONTROL_MEMBER_VAR, CONTROL_NAME, CONTROL_OP_VAR, CONTROL_READ_TOKEN_ENV, CONTROL_READ_TOKEN_SECRET, CONTROL_REF, CONTROL_REF_DEFAULT, CONTROL_SECRET_NAME, CONTROL_SHA_VAR, CONTROL_TOKEN_ENV, CONTROL_TOKEN_SECRET, CONTROL_TOKEN_VARS, ControlConfigError, ControlDispatchError, controlDependentsScript, controlDispatchEvent, controlDispatchJob, controlDispatchRequest, controlDispatchScript, controlNoteCheckout, controlPipelineFileName, controlPipelinePath, controlPipelineSpec, controlSettingsProblems, controlStatusContext, dispatchControl, forgeApiBase, forgeFromHost, parseProjectKey, resolveControlTarget, } from "./control/dispatch.js";
38
+ export { CONTROL_ENTRY_KIND, CONTROL_ENTRY_KINDS, CONTROL_ID_PREFIX, CONTROL_LEDGER_DIR, CONTROL_LEDGER_FILE, ControlEntryConflict, ControlRecordsError, controlConfig, controlEntryDigest, controlEntryRecordProblems, currentControlEntries, estateClaims, gitControlLedger, importControlConfig, parseControlEntries, putControlEntry, readControlEntries, retireControlEntry, } from "./control/records.js";
39
+ export { cloneUrlOf, commandGit, describeReconcile, gitAuthEnv, reconcileBranch, reconcileProjects, reconcileTokenEnv, } from "./control/reconcile.js";
40
+ export { CONSUMERS_CONTRACT, CONSUMERS_FILE, consumersDocument, joinControlConsumers, parseConsumersDocument, readControlConsumers, } from "./control/consumers.js";
41
+ export { CONTROL_APPLIED_FILE, CONTROL_APPLIED_KIND, applyOutcomeOf, controlAppliedProblems, gitControlAppliedLedger, latestControlApplies, parseControlApplied, recordControlApplied, recordControlAppliedFromEnv, } from "./control/applied.js";
42
+ export { CONTROL_DIR_ENV, controlEdgeFactsFromEnv, controlMemberOf, markCrossStackEdges, readControlEdgeFacts, remarkCrossStackEdges, } from "./control/edges.js";
@@ -0,0 +1,137 @@
1
+ import { type CiProductWords } from "../ci-product-words.js";
2
+ import type { DriftRun, EstateRows, WaveJob } from "./rows.js";
3
+ /** How many weeks the metrics cover, the current one included. */
4
+ export declare const DORA_WEEKS = 8;
5
+ /** An applied wave whose targets drift within this long counts as a failed change. */
6
+ export declare const DRIFT_WINDOW_SECONDS: number;
7
+ /** The shortest span a deployment rate divides by, so one apply does not read as thousands a week. */
8
+ export declare const DORA_MIN_SPAN_SECONDS = 86400;
9
+ /** The file beside the estate page. */
10
+ export declare const DORA_FILE = "dora.json";
11
+ /** `<product>.dora/v1`: terragucci's schema name under terragucci's words. */
12
+ export declare const doraSchema: (words?: Pick<CiProductWords, "product">) => string;
13
+ export interface DoraLeadTime {
14
+ /** Applied waves whose first plan was found. */
15
+ changes: number;
16
+ /** Medians in seconds; null when no change counts. */
17
+ median_seconds: number | null;
18
+ /** From the first plan to the wave reaching its gate, or to the apply when no gate held it. */
19
+ before_gate_seconds: number | null;
20
+ /** From the gate asking for an approval to the approval. */
21
+ at_gate_seconds: number | null;
22
+ /** From the approval to the wave applied. */
23
+ after_gate_seconds: number | null;
24
+ }
25
+ export interface DoraWeek {
26
+ /** The Monday the week starts on, YYYY-MM-DD. */
27
+ week: string;
28
+ deployments: number;
29
+ applies: number;
30
+ /** Failed applies and applied waves followed by drift. */
31
+ failures: number;
32
+ lead_time_seconds: number | null;
33
+ restore_seconds: number | null;
34
+ }
35
+ export interface DoraMetrics {
36
+ /** Applied waves in the window, and per week over span_seconds. */
37
+ deployments: number;
38
+ per_week: number;
39
+ /** What per_week divides by: now back to the oldest apply on record, or to the window's start when the history is older; at least DORA_MIN_SPAN_SECONDS. With no apply on record, the window. */
40
+ span_seconds: number;
41
+ lead_time: DoraLeadTime;
42
+ change_failure: {
43
+ applies: number;
44
+ failed: number;
45
+ drifted: number;
46
+ rate: number | null;
47
+ };
48
+ /** Incidents restored in the window and their median; open ones are still failing or drifted. */
49
+ restore: {
50
+ restored: number;
51
+ open: number;
52
+ median_seconds: number | null;
53
+ apply_restored: number;
54
+ drift_restored: number;
55
+ };
56
+ /** Oldest week first. */
57
+ trend: DoraWeek[];
58
+ }
59
+ export interface DoraProject extends DoraMetrics {
60
+ /** The member. */
61
+ project: string;
62
+ }
63
+ export interface Dora {
64
+ /** {@link doraSchema}. */
65
+ schema: string;
66
+ generated: string;
67
+ weeks: number;
68
+ /** The first Monday the window holds, and when it ends. */
69
+ window: {
70
+ from: string;
71
+ to: string;
72
+ };
73
+ drift_window_seconds: number;
74
+ /** Whether any apply record was on the ledger. Without one only drift counts. */
75
+ audit: boolean;
76
+ /** Where the numbers came from: always `ledger` here. terragucci's own file has no such field. */
77
+ source: "ledger";
78
+ estate: DoraMetrics;
79
+ projects: DoraProject[];
80
+ }
81
+ export interface DeliveryOptions {
82
+ words?: Pick<CiProductWords, "product">;
83
+ now?: Date;
84
+ /** The members to report, in order. Default every member the rows name. */
85
+ members?: readonly string[];
86
+ /** A commit's time in milliseconds, or null when unknown. Given, a change starts no later than its commit. */
87
+ commitTime?: (commit: string) => number | null;
88
+ }
89
+ /** The Monday, 00:00 UTC, of the week `t` falls in. */
90
+ export declare function weekStart(t: number): number;
91
+ export declare function median(values: number[]): number | null;
92
+ /** One wave's apply, its jobs joined. */
93
+ interface Apply {
94
+ project: string;
95
+ at: number;
96
+ applied: boolean;
97
+ spec: string;
98
+ digest?: string;
99
+ commit?: string;
100
+ roots: string[];
101
+ failed: string[];
102
+ }
103
+ /** The waves that applied or failed, their share and group jobs joined on the digest, oldest first. */
104
+ export declare function appliesOf(waves: readonly WaveJob[]): Apply[];
105
+ /** Drift as one incident: when it was first found, on which targets (empty for any), and when a check first found none. */
106
+ export interface DriftIncident {
107
+ since: number;
108
+ roots: Set<string>;
109
+ closed?: number;
110
+ }
111
+ /** A member's drift incidents from its checks, oldest first. A check that says nothing (it failed) neither opens nor closes one. */
112
+ export declare function driftIncidents(checks: readonly DriftRun[]): DriftIncident[];
113
+ /** "32 hours", "9 days", "7.4 weeks": a span as the page names it. */
114
+ export declare function spanLabel(seconds: number): string;
115
+ /** The metrics of every member and of the estate, from the ledger rows. */
116
+ export declare function buildDelivery(rows: EstateRows, options?: DeliveryOptions): Dora;
117
+ /** "3d 4h", "2h 10m", "5m", "40s": how long, to two units. */
118
+ export declare function duration(seconds: number | null): string;
119
+ /** One gauge the estate sends, per member and for the estate (project `*`). terragucci's DoraGauge. */
120
+ export interface DeliveryGauge {
121
+ name: string;
122
+ unit: string;
123
+ description: string;
124
+ value: number;
125
+ attributes: Record<string, string>;
126
+ }
127
+ /** `<product>_dora_<name>`: terragucci's metric names under terragucci's words, which its dashboards query. */
128
+ export declare function doraMetricNames(words?: Pick<CiProductWords, "product">): {
129
+ deployments: string;
130
+ leadTime: string;
131
+ failureRate: string;
132
+ restore: string;
133
+ };
134
+ /** The gauges for `dora`, as terragucci's `doraGauges` builds them. */
135
+ export declare function deliveryGauges(dora: Dora, words?: Pick<CiProductWords, "product">): DeliveryGauge[];
136
+ export {};
137
+ //# sourceMappingURL=delivery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/ci-estate/delivery.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,311 @@
1
+ /**
2
+ * Delivery metrics (#4612): the four DORA metrics per member and for the
3
+ * estate, from the workspace ledger and nothing else. Lifted from
4
+ * terragucci's report/dora.ts, which reads the same facts from its reports
5
+ * bucket (audit.jsonl and index rows). The output keeps that file's shape,
6
+ * `dora.json`, with the product's name in `schema`
7
+ * (`terragucci.dora/v1`, `plywood.dora/v1`), so a reader of terragucci's file
8
+ * reads this one. A member is what the file calls a `project`.
9
+ *
10
+ * Where each number comes from:
11
+ *
12
+ * applies op wave jobs' run records (`runs.wave`, #4551): a wave
13
+ * applied when its jobs applied targets and none failed,
14
+ * failed when a target failed. Share and group jobs of one
15
+ * wave join on the set digest and count once.
16
+ * first plan the earliest job of the same spec and digest (the
17
+ * deciding job, or the job that waited at the gate), or the
18
+ * commit's time when the caller passes `commitTime`
19
+ * the gate the pending fact for the digest (`gates`), and the
20
+ * approval the apply spent (`applies`), else a resolution
21
+ * of the same digest
22
+ * drift drift checks' run records: `Drift=true` opens an
23
+ * incident on the member (on the roots or stacks a
24
+ * `DriftedRoots` outcome names, else on any of them), and
25
+ * the next check with `Drift=false` closes it
26
+ *
27
+ * Deployment frequency applied waves per week, over the span the history covers
28
+ * Lead time first plan to applied, split at the gate
29
+ * Change failure rate failed applies, plus applied waves whose targets
30
+ * drifted within DRIFT_WINDOW_SECONDS, over all applies.
31
+ * A refused wave is the gate working and counts for nothing.
32
+ * Time to restore a failed apply to the next apply of those targets;
33
+ * drift found to the next check that found none
34
+ *
35
+ * Every number covers the newest DORA_WEEKS weeks, Monday to Sunday in UTC,
36
+ * with a row per week. Nothing is compared to DORA's performance tiers.
37
+ */
38
+ import { samePlanDigest } from "../lifecycle/plan-digest.js";
39
+ import { CHANT_WORDS } from "../ci-product-words.js";
40
+ /** How many weeks the metrics cover, the current one included. */
41
+ export const DORA_WEEKS = 8;
42
+ /** An applied wave whose targets drift within this long counts as a failed change. */
43
+ export const DRIFT_WINDOW_SECONDS = 7 * 86400;
44
+ /** The shortest span a deployment rate divides by, so one apply does not read as thousands a week. */
45
+ export const DORA_MIN_SPAN_SECONDS = 86400;
46
+ /** The file beside the estate page. */
47
+ export const DORA_FILE = "dora.json";
48
+ /** `<product>.dora/v1`: terragucci's schema name under terragucci's words. */
49
+ export const doraSchema = (words = CHANT_WORDS) => `${words.product}.dora/v1`;
50
+ const at = (iso) => (iso ? Date.parse(iso) || 0 : 0);
51
+ const secs = (from, to) => Math.max(0, Math.round((to - from) / 1000));
52
+ const WEEK_MS = 7 * 86400 * 1000;
53
+ const WEEK_SECONDS = 7 * 86400;
54
+ /** The Monday, 00:00 UTC, of the week `t` falls in. */
55
+ export function weekStart(t) {
56
+ const d = new Date(t);
57
+ const day = (d.getUTCDay() + 6) % 7;
58
+ return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate() - day);
59
+ }
60
+ export function median(values) {
61
+ if (values.length === 0)
62
+ return null;
63
+ const s = [...values].sort((a, b) => a - b);
64
+ const m = Math.floor(s.length / 2);
65
+ return s.length % 2 ? s[m] : Math.round((s[m - 1] + s[m]) / 2);
66
+ }
67
+ /** The waves that applied or failed, their share and group jobs joined on the digest, oldest first. */
68
+ export function appliesOf(waves) {
69
+ const by = new Map();
70
+ for (const w of waves) {
71
+ if (w.job === "decide" || (w.applied.length === 0 && w.failed.length === 0))
72
+ continue;
73
+ const k = [w.member, w.spec, w.wave, w.digest ?? `run:${w.id}`].join("\n");
74
+ by.set(k, [...(by.get(k) ?? []), w]);
75
+ }
76
+ const out = [];
77
+ for (const jobs of by.values()) {
78
+ const first = jobs[0];
79
+ const failed = [...new Set(jobs.flatMap((j) => j.failed))];
80
+ const roots = [...new Set(jobs.flatMap((j) => [...j.applied, ...j.failed]))];
81
+ const commit = jobs.find((j) => j.commit)?.commit;
82
+ out.push({ project: first.member, at: Math.max(...jobs.map((j) => at(j.ended))), applied: failed.length === 0, spec: first.spec, ...(first.digest ? { digest: first.digest } : {}), ...(commit ? { commit } : {}), roots, failed });
83
+ }
84
+ return out.sort((a, b) => a.at - b.at);
85
+ }
86
+ /** The lead time of an applied wave, or undefined when nothing says when its change started. */
87
+ function leadOf(a, rows, commitTime) {
88
+ const same = (d) => a.digest !== undefined && d !== undefined && samePlanDigest(d, a.digest);
89
+ const starts = [];
90
+ for (const w of rows.waves)
91
+ if (w.member === a.project && w.spec === a.spec && same(w.digest) && at(w.started) <= a.at)
92
+ starts.push(at(w.started));
93
+ const committed = a.commit && commitTime ? commitTime(a.commit) : null;
94
+ if (committed !== null && committed !== undefined && committed <= a.at)
95
+ starts.push(committed);
96
+ if (starts.length === 0)
97
+ return undefined;
98
+ const first = Math.min(...starts);
99
+ const asked = rows.gates
100
+ .filter((g) => g.kind === "pending" && g.member === a.project && g.op === a.spec && same(g.planDigest) && at(g.timestamp) <= a.at)
101
+ .map((g) => at(g.timestamp))
102
+ .sort((x, y) => x - y)[0];
103
+ const spent = rows.approved.filter((p) => p.member === a.project && p.op === a.spec && same(p.planDigest) && at(p.approvedAt) <= a.at).map((p) => at(p.approvedAt));
104
+ const resolved = rows.gates.filter((g) => g.kind === "resolution" && g.resolvedBy && g.member === a.project && g.op === a.spec && same(g.planDigest) && at(g.timestamp) <= a.at).map((g) => at(g.timestamp));
105
+ const approvedAt = spent.length ? Math.max(...spent) : resolved.length ? Math.max(...resolved) : undefined;
106
+ if (asked === undefined)
107
+ return { project: a.project, at: a.at, total: secs(first, a.at), before: secs(first, a.at), gate: 0, after: 0 };
108
+ const ok = approvedAt !== undefined ? Math.min(Math.max(approvedAt, asked), a.at) : undefined;
109
+ const gateEnd = ok ?? asked;
110
+ return { project: a.project, at: a.at, total: secs(first, a.at), before: secs(first, Math.max(first, asked)), gate: secs(asked, gateEnd), after: secs(gateEnd, a.at) };
111
+ }
112
+ /** Failed applies, each restored by the next apply that applied every target it failed on. */
113
+ function applyRestores(applies) {
114
+ const restored = [];
115
+ const open = new Map();
116
+ for (const a of applies) {
117
+ if (!a.applied) {
118
+ const roots = (a.failed.length ? a.failed : a.roots).filter((r) => !open.has(r));
119
+ if (roots.length === 0)
120
+ continue;
121
+ const incident = { start: a.at, roots: new Set(roots) };
122
+ for (const r of roots)
123
+ open.set(r, incident);
124
+ continue;
125
+ }
126
+ for (const r of a.roots) {
127
+ const incident = open.get(r);
128
+ if (!incident)
129
+ continue;
130
+ open.delete(r);
131
+ incident.roots.delete(r);
132
+ if (incident.roots.size === 0)
133
+ restored.push({ project: a.project, at: a.at, seconds: secs(incident.start, a.at), kind: "apply" });
134
+ }
135
+ }
136
+ return { restored, open: new Set(open.values()).size };
137
+ }
138
+ /** A member's drift incidents from its checks, oldest first. A check that says nothing (it failed) neither opens nor closes one. */
139
+ export function driftIncidents(checks) {
140
+ const out = [];
141
+ let open;
142
+ for (const c of [...checks].sort((x, y) => at(x.ended) - at(y.ended))) {
143
+ if (c.drifted === true) {
144
+ if (!open)
145
+ out.push((open = { since: at(c.ended), roots: new Set() }));
146
+ for (const r of c.roots)
147
+ open.roots.add(r);
148
+ }
149
+ else if (c.drifted === false && open) {
150
+ open.closed = at(c.ended);
151
+ open = undefined;
152
+ }
153
+ }
154
+ return out;
155
+ }
156
+ /** Applied waves whose targets drifted within the window, before another apply of those targets. */
157
+ function driftedApplies(applies, incidents) {
158
+ const out = new Set();
159
+ for (const a of applies) {
160
+ if (!a.applied)
161
+ continue;
162
+ const hit = incidents.some((i) => {
163
+ const t = i.since;
164
+ if (t < a.at || t - a.at > DRIFT_WINDOW_SECONDS * 1000)
165
+ return false;
166
+ const shared = i.roots.size ? a.roots.filter((x) => i.roots.has(x)) : a.roots;
167
+ return shared.some((x) => !applies.some((b) => b !== a && b.applied && b.at > a.at && b.at <= t && b.roots.includes(x)));
168
+ });
169
+ if (hit)
170
+ out.add(a);
171
+ }
172
+ return out;
173
+ }
174
+ function eventsOf(member, rows, applies, commitTime) {
175
+ const mine = applies.filter((a) => a.project === member);
176
+ const incidents = driftIncidents(rows.drift.filter((d) => d.member === member));
177
+ const leads = mine.filter((a) => a.applied).flatMap((a) => leadOf(a, rows, commitTime) ?? []);
178
+ const drifted = driftedApplies(mine, incidents);
179
+ const failures = mine.filter((a) => !a.applied || drifted.has(a)).map((a) => ({ project: a.project, at: a.at }));
180
+ const ar = applyRestores(mine);
181
+ const dr = incidents.filter((i) => i.closed !== undefined).map((i) => ({ project: member, at: i.closed, seconds: secs(i.since, i.closed), kind: "drift" }));
182
+ return { applies: mine, leads, failures, drifted, restores: [...ar.restored, ...dr], open: ar.open + incidents.filter((i) => i.closed === undefined).length };
183
+ }
184
+ const merge = (all) => ({
185
+ applies: all.flatMap((e) => e.applies),
186
+ leads: all.flatMap((e) => e.leads),
187
+ failures: all.flatMap((e) => e.failures),
188
+ drifted: new Set(all.flatMap((e) => [...e.drifted])),
189
+ restores: all.flatMap((e) => e.restores),
190
+ open: all.reduce((n, e) => n + e.open, 0),
191
+ });
192
+ function spanOf(all, from, now) {
193
+ const start = all.length ? Math.max(from, Math.min(...all.map((a) => a.at))) : from;
194
+ return Math.max(DORA_MIN_SPAN_SECONDS, secs(start, now));
195
+ }
196
+ /** "32 hours", "9 days", "7.4 weeks": a span as the page names it. */
197
+ export function spanLabel(seconds) {
198
+ const unit = (n, one) => `${n} ${n === 1 ? one : `${one}s`}`;
199
+ if (seconds < 72 * 3600)
200
+ return unit(Math.max(1, Math.round(seconds / 3600)), "hour");
201
+ if (seconds < 2 * WEEK_SECONDS)
202
+ return unit(Math.round(seconds / 86400), "day");
203
+ return unit(Math.round((seconds / WEEK_SECONDS) * 10) / 10, "week");
204
+ }
205
+ function metricsOf(ev, from, now) {
206
+ const inside = (xs) => xs.filter((x) => x.at >= from && x.at <= now);
207
+ const applies = inside(ev.applies);
208
+ const deployments = applies.filter((a) => a.applied).length;
209
+ const failed = applies.filter((a) => !a.applied).length;
210
+ const drift = applies.filter((a) => ev.drifted.has(a)).length;
211
+ const leads = inside(ev.leads);
212
+ const restores = inside(ev.restores);
213
+ const span = spanOf(ev.applies, from, now);
214
+ const trend = [];
215
+ for (let w = 0; w < DORA_WEEKS; w++) {
216
+ const start = from + w * WEEK_MS;
217
+ const end = start + WEEK_MS;
218
+ const of = (xs) => xs.filter((x) => x.at >= start && x.at < end);
219
+ trend.push({
220
+ week: new Date(start).toISOString().slice(0, 10),
221
+ deployments: of(applies).filter((a) => a.applied).length,
222
+ applies: of(applies).length,
223
+ failures: of(inside(ev.failures)).length,
224
+ lead_time_seconds: median(of(leads).map((l) => l.total)),
225
+ restore_seconds: median(of(restores).map((r) => r.seconds)),
226
+ });
227
+ }
228
+ return {
229
+ deployments,
230
+ per_week: Math.round(((deployments * WEEK_SECONDS) / span) * 100) / 100,
231
+ span_seconds: span,
232
+ lead_time: {
233
+ changes: leads.length,
234
+ median_seconds: median(leads.map((l) => l.total)),
235
+ before_gate_seconds: median(leads.map((l) => l.before)),
236
+ at_gate_seconds: median(leads.map((l) => l.gate)),
237
+ after_gate_seconds: median(leads.map((l) => l.after)),
238
+ },
239
+ change_failure: { applies: applies.length, failed, drifted: drift, rate: applies.length ? Math.round(((failed + drift) / applies.length) * 1e6) / 1e6 : null },
240
+ restore: {
241
+ restored: restores.length,
242
+ open: ev.open,
243
+ median_seconds: median(restores.map((r) => r.seconds)),
244
+ apply_restored: restores.filter((r) => r.kind === "apply").length,
245
+ drift_restored: restores.filter((r) => r.kind === "drift").length,
246
+ },
247
+ trend,
248
+ };
249
+ }
250
+ /** The metrics of every member and of the estate, from the ledger rows. */
251
+ export function buildDelivery(rows, options = {}) {
252
+ const now = options.now ?? new Date();
253
+ const end = now.getTime();
254
+ const from = weekStart(end) - (DORA_WEEKS - 1) * WEEK_MS;
255
+ const members = options.members ?? rows.members;
256
+ const applies = appliesOf(rows.waves);
257
+ const events = members.map((m) => eventsOf(m, rows, applies, options.commitTime));
258
+ return {
259
+ schema: doraSchema(options.words),
260
+ generated: now.toISOString(),
261
+ weeks: DORA_WEEKS,
262
+ window: { from: new Date(from).toISOString(), to: now.toISOString() },
263
+ drift_window_seconds: DRIFT_WINDOW_SECONDS,
264
+ audit: applies.length > 0,
265
+ source: "ledger",
266
+ estate: metricsOf(merge(events), from, end),
267
+ projects: members.map((m, i) => ({ project: m, ...metricsOf(events[i], from, end) })),
268
+ };
269
+ }
270
+ /** "3d 4h", "2h 10m", "5m", "40s": how long, to two units. */
271
+ export function duration(seconds) {
272
+ if (seconds === null)
273
+ return "none";
274
+ const d = Math.floor(seconds / 86400);
275
+ const h = Math.floor((seconds % 86400) / 3600);
276
+ const m = Math.floor((seconds % 3600) / 60);
277
+ if (d > 0)
278
+ return `${d}d ${h}h`;
279
+ if (h > 0)
280
+ return `${h}h ${m}m`;
281
+ if (m > 0)
282
+ return `${m}m`;
283
+ return `${seconds}s`;
284
+ }
285
+ /** `<product>_dora_<name>`: terragucci's metric names under terragucci's words, which its dashboards query. */
286
+ export function doraMetricNames(words = CHANT_WORDS) {
287
+ const p = words.product.replace(/[^a-z0-9_]/g, "_");
288
+ return { deployments: `${p}_dora_deployments_per_week`, leadTime: `${p}_dora_lead_time_seconds`, failureRate: `${p}_dora_change_failure_ratio`, restore: `${p}_dora_restore_seconds` };
289
+ }
290
+ /** The gauges for `dora`, as terragucci's `doraGauges` builds them. */
291
+ export function deliveryGauges(dora, words = CHANT_WORDS) {
292
+ const names = doraMetricNames(words);
293
+ const out = [];
294
+ const of = (project, m) => {
295
+ const a = { project };
296
+ out.push({ name: names.deployments, unit: "", description: `Applied waves per week over the newest ${spanLabel(m.span_seconds)}, the span the history covers in the ${dora.weeks}-week window.`, value: m.per_week, attributes: a });
297
+ const l = m.lead_time;
298
+ for (const [segment, v] of [["total", l.median_seconds], ["before_gate", l.before_gate_seconds], ["at_gate", l.at_gate_seconds], ["after_gate", l.after_gate_seconds]]) {
299
+ if (v !== null)
300
+ out.push({ name: names.leadTime, unit: "s", description: "Median lead time from a change's first plan to its wave applied, and its split.", value: v, attributes: { ...a, segment } });
301
+ }
302
+ if (m.change_failure.rate !== null)
303
+ out.push({ name: names.failureRate, unit: "", description: "Failed applies and applied waves followed by drift, over all applies.", value: m.change_failure.rate, attributes: a });
304
+ if (m.restore.median_seconds !== null)
305
+ out.push({ name: names.restore, unit: "s", description: "Median time from a failed apply or drift found to restored.", value: m.restore.median_seconds, attributes: a });
306
+ };
307
+ of("*", dora.estate);
308
+ for (const p of dora.projects)
309
+ of(p.project, p);
310
+ return out;
311
+ }
@@ -0,0 +1,34 @@
1
+ import type { OverdueOp } from "../op/schedule-overdue.js";
2
+ import { type CiProductWords } from "../ci-product-words.js";
3
+ import type { EstateRows } from "./rows.js";
4
+ /** One scheduled drift check: its Op and cron, and the members it covers. */
5
+ export interface DriftSchedule {
6
+ op: string;
7
+ cron: string;
8
+ /** The members it checks. Default every member with a run of `op` on record. */
9
+ members?: readonly string[];
10
+ }
11
+ /** A member whose drift checks stopped. */
12
+ export interface LedgerOverdue extends OverdueOp {
13
+ member: string;
14
+ /** The newest check on record, when there is one. */
15
+ last?: {
16
+ id: string;
17
+ ended: string;
18
+ status: string;
19
+ runUrl?: string;
20
+ };
21
+ }
22
+ export interface LedgerOverdueOptions {
23
+ words?: Pick<CiProductWords, "product" | "stages" | "noun">;
24
+ now?: Date;
25
+ /** When a member's schedule began (ISO 8601), for a member with no check on record. */
26
+ added?: (op: string, member: string) => string | undefined;
27
+ }
28
+ /**
29
+ * Each member whose drift check of each schedule is overdue, sorted by
30
+ * member and op. A member is overdue when the cron fired at least twice
31
+ * since its newest check on record, or since `added` when it has none.
32
+ */
33
+ export declare function ledgerOverdue(rows: Pick<EstateRows, "drift">, schedules: readonly DriftSchedule[], options?: LedgerOverdueOptions): LedgerOverdue[];
34
+ //# sourceMappingURL=overdue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"overdue.d.ts","sourceRoot":"","sources":["../../src/ci-estate/overdue.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAY,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEnD,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;IAC5D,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,uFAAuF;IACvF,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC5D;AAWD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,aAAa,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,aAAa,EAAE,CAyBvJ"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Overdue drift checks from the ledger (#4612). terragucci's
3
+ * report/overdue.ts asks the forge when its drift job last ran, which only
4
+ * the plan job of one repository can do. The estate reads every member at
5
+ * once, so here the last run is the newest drift check on the member's run
6
+ * ledger, and the rule is chant's `overdueVerdict` (../op/schedule-overdue.ts):
7
+ * overdue once the cron has fired at least twice since that run. A member
8
+ * with no check on record is counted from `added` when the caller knows when
9
+ * its schedule began, and is otherwise not judged.
10
+ *
11
+ * The verdict keeps the plan note's {@link OverdueOp} shape, with the member
12
+ * beside it, and its text uses the product's words: its name, its drift
13
+ * word and its noun for a member.
14
+ */
15
+ import { cronFiresUtc } from "../op/cron.js";
16
+ import { CHANT_WORDS } from "../ci-product-words.js";
17
+ const at = (iso) => Date.parse(iso) || 0;
18
+ /** The newest drift check of `op` on `member`, by when it ended. */
19
+ function newestCheck(checks, op, member) {
20
+ let best;
21
+ for (const c of checks)
22
+ if (c.op === op && c.member === member && (!best || at(c.ended) > at(best.ended)))
23
+ best = c;
24
+ return best;
25
+ }
26
+ /**
27
+ * Each member whose drift check of each schedule is overdue, sorted by
28
+ * member and op. A member is overdue when the cron fired at least twice
29
+ * since its newest check on record, or since `added` when it has none.
30
+ */
31
+ export function ledgerOverdue(rows, schedules, options = {}) {
32
+ const words = options.words ?? CHANT_WORDS;
33
+ const now = options.now ?? new Date();
34
+ const out = [];
35
+ for (const s of schedules) {
36
+ const members = s.members ?? [...new Set(rows.drift.filter((d) => d.op === s.op).map((d) => d.member))].sort();
37
+ for (const member of members) {
38
+ const last = newestCheck(rows.drift, s.op, member);
39
+ const since = last?.ended ?? options.added?.(s.op, member);
40
+ if (!since)
41
+ continue;
42
+ if (cronFiresUtc(s.cron, new Date(since), now, 2).length < 2)
43
+ continue;
44
+ const day = since.slice(0, 10);
45
+ const what = last ? `its last check on the ledger ended on ${day}` : `no check is on the ledger since its schedule began on ${day}`;
46
+ out.push({
47
+ op: s.op,
48
+ cron: s.cron,
49
+ since,
50
+ ...(last ? {} : { neverRan: true }),
51
+ member,
52
+ ...(last ? { last: { id: last.id, ended: last.ended, status: last.status, ...(last.runUrl ? { runUrl: last.runUrl } : {}) } } : {}),
53
+ message: `${words.product} ${words.stages.drift} checks of ${words.noun[0]} \`${member}\` are overdue: the schedule \`${s.cron}\` of \`${s.op}\` has fired at least twice and ${what}.`,
54
+ });
55
+ }
56
+ }
57
+ return out.sort((a, b) => a.member.localeCompare(b.member) || a.op.localeCompare(b.op));
58
+ }