@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
@@ -0,0 +1,140 @@
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";
14
+ import type { RunOrigin } from "../lifecycle/release-ledger";
15
+ import type { ArmRun, ClaimRun } from "./driver";
16
+ import { FLOCI_DIGEST } from "./pins";
17
+ import {
18
+ E2E_CLAIMS_SCHEMA,
19
+ E2E_CLAIM_ROW_SCHEMA,
20
+ validateClaimRow,
21
+ validateClaims,
22
+ type BreakVerdict,
23
+ type ClaimRow,
24
+ type ClaimsDoc,
25
+ type PlainVerdict,
26
+ type Scenario,
27
+ } from "./schemas/index";
28
+
29
+ /** The op every claim run is recorded under. */
30
+ export const CLAIM_OP = "e2e-claim";
31
+
32
+ export interface ClaimRowInput {
33
+ scenario: Pick<Scenario, "id" | "product" | "claim">;
34
+ productCommit: string;
35
+ engine: { binary: string; version: string };
36
+ verdicts: { plain: PlainVerdict; break: BreakVerdict };
37
+ /** When the run ended. */
38
+ at: Date;
39
+ /** The floci digest the stack ran. Default the harness's pin. */
40
+ floci?: string;
41
+ chant?: string;
42
+ runUrl?: string;
43
+ }
44
+
45
+ /** A claim row, validated. A run's scan verdict is added when it is recorded. */
46
+ export function claimRow(i: ClaimRowInput): ClaimRow {
47
+ const row: ClaimRow = {
48
+ $schema: E2E_CLAIM_ROW_SCHEMA,
49
+ contract: 1,
50
+ product: i.scenario.product,
51
+ productCommit: i.productCommit,
52
+ scenario: i.scenario.id,
53
+ claim: i.scenario.claim,
54
+ engine: { binary: i.engine.binary, version: i.engine.version },
55
+ floci: i.floci ?? FLOCI_DIGEST,
56
+ ...(i.chant ? { chant: i.chant } : {}),
57
+ date: i.at.toISOString().slice(0, 10),
58
+ plain: i.verdicts.plain,
59
+ break: i.verdicts.break,
60
+ safeRun: "CLEAN",
61
+ ...(i.runUrl ? { runUrl: i.runUrl } : {}),
62
+ };
63
+ const v = validateClaimRow(row);
64
+ if (!v.ok) throw new Error(`the claim row for ${row.scenario} is not e2e-claim-row/v1: ${v.errors.join("; ")}`);
65
+ return row;
66
+ }
67
+
68
+ /** Whether a row proves its claim: the plain run passed and the BREAK run was caught. */
69
+ export const rowHolds = (row: Pick<ClaimRow, "plain" | "break">): boolean => row.plain === "pass" && row.break === "caught";
70
+
71
+ const phaseOf = (run: ArmRun) => ({
72
+ name: run.arm,
73
+ // A phase fails when a step did, as the ledger reads phases; the arm's verdict is in the row.
74
+ status: run.outcome === "held" ? ("ok" as const) : ("fail" as const),
75
+ steps: run.steps.map((s) => ({
76
+ fn: `${s.do}:${s.id}`,
77
+ status: s.stopped ? ("fail" as const) : ("ok" as const),
78
+ durationMs: 0,
79
+ ...(s.stopped ? { error: `${s.stopped.outcome}: ${s.stopped.reason}` } : {}),
80
+ })),
81
+ });
82
+
83
+ /**
84
+ * The run record of one claim run (#4551): op `e2e-claim`, labels naming the
85
+ * product, scenario and claim, the row as the `claim` outcome, and one phase
86
+ * per arm with a step per scenario step. Status ok when the row holds.
87
+ */
88
+ export function claimRunRecordInput(o: { row: ClaimRow; run: ClaimRun; env?: string; gitSha?: string; runOrigin?: RunOrigin }): OpRunRecordInput {
89
+ return {
90
+ op: CLAIM_OP,
91
+ env: o.env ?? "local",
92
+ started: o.run.plain.started,
93
+ ended: o.run.break.ended,
94
+ status: rowHolds(o.row) ? "ok" : "fail",
95
+ labels: { Product: o.row.product, Scenario: o.row.scenario, Claim: o.row.claim },
96
+ outcomes: { claim: o.row },
97
+ phases: [phaseOf(o.run.plain), phaseOf(o.run.break)],
98
+ ...(o.gitSha ? { gitSha: o.gitSha } : {}),
99
+ ...(o.runOrigin ? { runOrigin: o.runOrigin } : {}),
100
+ };
101
+ }
102
+
103
+ /** The rows on a ledger's e2e-claim records, oldest first. A record whose outcome is not a row is skipped. */
104
+ export function claimRowsOf(records: readonly OpRunRecord[]): ClaimRow[] {
105
+ return records
106
+ .filter((r) => r.op === CLAIM_OP)
107
+ .slice()
108
+ .sort((a, b) => a.ended.localeCompare(b.ended))
109
+ .map((r) => r.outcomes.claim)
110
+ .filter((c): c is ClaimRow => validateClaimRow(c).ok);
111
+ }
112
+
113
+ /**
114
+ * e2e-claims/v1 for one product: its newest row per scenario and claim,
115
+ * sorted by scenario then claim. Rows are recorded in order, so the last
116
+ * one read for a pair is the newest.
117
+ */
118
+ export function renderClaims(product: string, rows: readonly ClaimRow[]): ClaimsDoc {
119
+ const newest = new Map<string, ClaimRow>();
120
+ for (const row of rows) if (row.product === product) newest.set(`${row.scenario}\u0000${row.claim}`, row);
121
+ const doc: ClaimsDoc = {
122
+ $schema: E2E_CLAIMS_SCHEMA,
123
+ contract: 1,
124
+ product,
125
+ rows: [...newest.values()].sort((a, b) => a.scenario.localeCompare(b.scenario) || a.claim.localeCompare(b.claim)),
126
+ };
127
+ const v = validateClaims(doc);
128
+ if (!v.ok) throw new Error(`the rendered claims of ${product} are not e2e-claims/v1: ${v.errors.join("; ")}`);
129
+ return doc;
130
+ }
131
+
132
+ /**
133
+ * Whether an engine claim about `version` may count a row: only when the row
134
+ * ran that version of that engine (chant#4586, the v0.28.0 against 0.31.0
135
+ * split), and only when it holds.
136
+ */
137
+ export function rowCountsFor(row: ClaimRow, engine: { binary: string; version: string }): boolean {
138
+ const norm = (v: string) => v.replace(/^v/, "");
139
+ return row.engine.binary === engine.binary && norm(row.engine.version) === norm(engine.version) && rowHolds(row);
140
+ }
@@ -0,0 +1,304 @@
1
+ /**
2
+ * The harness's driver (chant#4587) running a scenario in process, with
3
+ * fakes for the forge, the report bucket, chant, the ledger and the clock. A
4
+ * fake pipeline writes chant's reports where the jobs would: pr-plan.json at
5
+ * the head when a pull request opens, pr-apply.json at the merge commit when
6
+ * it merges. Nothing here starts a container or opens a socket.
7
+ */
8
+ import { describe, expect, test } from "vitest";
9
+ import type { OpRunRecord } from "../op/runtime";
10
+ import { runArm, runClaim, verdictsOf, type DriverPorts } from "./driver";
11
+ import type { ApproveInput, Bucket, Clock, ForgeIssue, PullForge } from "./ports";
12
+ import { reportObjectKey } from "./reports";
13
+ import { lintScenario } from "./scenario";
14
+ import { E2E_SCENARIO_SCHEMA, type Scenario } from "./schemas/index";
15
+
16
+ const PREFIX = "shop/reports";
17
+
18
+ /** The fan-out story as a scenario: the change fails cluster-a, the fix applies the seven. */
19
+ function fanOut(over: Partial<Scenario> = {}): Scenario {
20
+ return {
21
+ $schema: E2E_SCENARIO_SCHEMA,
22
+ contract: 1,
23
+ id: "fan-out",
24
+ product: "chant",
25
+ claim: "fan-out/failure-blocks-dependents",
26
+ tree: { base: "../..", overlays: "overlays" },
27
+ env: "demo",
28
+ reportUrl: `s3://chant-demo/${PREFIX}`,
29
+ steps: [
30
+ { id: "change", do: "open", branch: "demo/change", overlay: "change", title: "The change" },
31
+ { id: "change-plan", do: "plan", pull: "change", expect: [{ report: { status: "planned" } }] },
32
+ { id: "change-approve", do: "approve", pull: "change" },
33
+ { id: "change-merge", do: "merge", pull: "change" },
34
+ {
35
+ id: "change-apply",
36
+ do: "apply",
37
+ merge: "change-merge",
38
+ expect: [{ report: { status: "failed", components: { "cluster-a": "failed", "app-01": "blocked", "cluster-b": "applied" } } }],
39
+ },
40
+ ],
41
+ break: { env: { BREAK: "1" }, note: "cluster-a's queue gets a valid name, so nothing fails" },
42
+ ...over,
43
+ };
44
+ }
45
+
46
+ /** Time that moves only when the driver sleeps. */
47
+ function fakeClock(start = Date.parse("2026-10-28T10:00:00Z")): Clock & { t: number } {
48
+ const c = {
49
+ t: start,
50
+ now: () => c.t,
51
+ sleep: async (ms: number) => {
52
+ c.t += ms;
53
+ },
54
+ };
55
+ return c;
56
+ }
57
+
58
+ function fakeBucket(): Bucket & { objects: Map<string, string> } {
59
+ const objects = new Map<string, string>();
60
+ return {
61
+ objects,
62
+ get: async (k) => objects.get(k) ?? null,
63
+ put: async (k, b) => void objects.set(k, b),
64
+ list: async (p) => [...objects.keys()].filter((k) => k.startsWith(p)),
65
+ delete: async (k) => void objects.delete(k),
66
+ };
67
+ }
68
+
69
+ interface World {
70
+ ports: DriverPorts;
71
+ bucket: ReturnType<typeof fakeBucket>;
72
+ clock: ReturnType<typeof fakeClock>;
73
+ approvals: ApproveInput[];
74
+ opened: Array<{ branch: string; files: Record<string, string> }>;
75
+ comments: Map<number, string[]>;
76
+ ledger: OpRunRecord[];
77
+ resets: number;
78
+ armEnv: Record<string, string>[];
79
+ log: string[];
80
+ }
81
+
82
+ /**
83
+ * A forge and a pipeline that plans and applies on its own. `broken` is what
84
+ * BREAK=1 does to the pipeline here: cluster-a applies cleanly, so the
85
+ * failure the claim is about never happens. `silent` stops the pipeline from
86
+ * writing an apply report at all.
87
+ */
88
+ function world(o: { silent?: boolean; breakDoesNothing?: boolean } = {}): World {
89
+ const bucket = fakeBucket();
90
+ const clock = fakeClock();
91
+ const approvals: ApproveInput[] = [];
92
+ const opened: World["opened"] = [];
93
+ const comments = new Map<number, string[]>();
94
+ const ledger: OpRunRecord[] = [];
95
+ const log: string[] = [];
96
+ let broken = false;
97
+ let next = 1;
98
+ const heads = new Map<number, string>();
99
+ const sha = (n: number, kind: string) => `${kind}${String(n).padStart(40 - kind.length, "0")}`;
100
+ const w = { resets: 0, armEnv: [] as Record<string, string>[] };
101
+
102
+ const forge: PullForge & { comments(pull: number): Promise<string[]>; issues(): Promise<ForgeIssue[]> } = {
103
+ async pushBranch(branch, files) {
104
+ opened.push({ branch, files });
105
+ return sha(opened.length, "a");
106
+ },
107
+ async openPull(branch) {
108
+ const pull = next++;
109
+ const head = sha(opened.findIndex((x) => x.branch === branch) + 1, "a");
110
+ heads.set(pull, head);
111
+ // The pipeline's plan job.
112
+ await bucket.put(
113
+ reportObjectKey(PREFIX, pull, head, "plan"),
114
+ JSON.stringify({ stage: "plan", pr: pull, head, op: `pr-${pull}`, gate: "pr-apply", digest: `jcs1-sha256:${pull}`, status: "planned", selection: { waves: [] }, members: [] }),
115
+ "application/json",
116
+ );
117
+ comments.set(pull, [`plan for #${pull}: 15 stacks in 3 waves`]);
118
+ return pull;
119
+ },
120
+ async approvePull() {},
121
+ async mergePull(pull) {
122
+ const commit = sha(pull, "b");
123
+ if (!o.silent) {
124
+ const clusterA = broken ? "applied" : "failed";
125
+ const app01 = broken ? "applied" : "blocked";
126
+ await bucket.put(
127
+ reportObjectKey(PREFIX, pull, commit, "apply"),
128
+ JSON.stringify({
129
+ stage: "apply",
130
+ pr: pull,
131
+ head: commit,
132
+ op: `pr-${pull}`,
133
+ gate: "pr-apply",
134
+ digest: "",
135
+ status: broken ? "applied" : "failed",
136
+ selection: { waves: [] },
137
+ members: [
138
+ { member: "cluster-a", component: "cluster-a", status: clusterA },
139
+ { member: "app-01", component: "app-01", status: app01 },
140
+ { member: "cluster-b", component: "cluster-b", status: "applied" },
141
+ ],
142
+ }),
143
+ "application/json",
144
+ );
145
+ ledger.push({
146
+ version: 1,
147
+ id: `run-${pull}`,
148
+ op: "pr-apply",
149
+ env: "demo",
150
+ started: new Date(clock.now()).toISOString(),
151
+ ended: new Date(clock.now()).toISOString(),
152
+ status: broken ? "ok" : "fail",
153
+ labels: {},
154
+ outcomes: {},
155
+ phases: [],
156
+ });
157
+ }
158
+ return commit;
159
+ },
160
+ openPulls: async () => [],
161
+ closePull: async () => {},
162
+ forceMain: async () => {},
163
+ branches: async () => [],
164
+ deleteBranch: async () => {},
165
+ comments: async (pull) => comments.get(pull) ?? [],
166
+ issues: async () => [{ number: 9, title: "drift: shop-dev", body: "", open: true }],
167
+ };
168
+
169
+ const ports: DriverPorts = {
170
+ forge,
171
+ bucket,
172
+ clock,
173
+ chant: { approve: async (i) => void approvals.push(i) },
174
+ overlay: (name) => ({ [`src/${name}.ts`]: `export const overlay = "${name}";\n` }),
175
+ ledger: { runs: async (env, op) => ledger.filter((r) => r.env === env && r.op === op) },
176
+ reset: async () => {
177
+ w.resets++;
178
+ },
179
+ arm: async (arm, env) => {
180
+ w.armEnv.push(env);
181
+ broken = arm === "break" && env.BREAK === "1" && !o.breakDoesNothing;
182
+ },
183
+ log: (line) => log.push(line),
184
+ };
185
+ return { ports, bucket, clock, approvals, opened, comments, ledger, log, get resets() { return w.resets; }, get armEnv() { return w.armEnv; } } as World;
186
+ }
187
+
188
+ const OPTS = { approver: "forgejo@forgejo:3000:reviewer", pollMs: 1000 };
189
+
190
+ describe("the e2e harness's driver", () => {
191
+ test("the fixture scenario lints clean", () => {
192
+ expect(lintScenario(fanOut())).toEqual([]);
193
+ });
194
+
195
+ test("a plain run whose outcomes all hold passes, and approves the plan's digest as the reviewer", async () => {
196
+ const w = world();
197
+ const run = await runArm(fanOut(), "plain", w.ports, OPTS);
198
+ expect(run.outcome).toBe("held");
199
+ expect(run.steps.map((s) => s.id)).toEqual(["change", "change-plan", "change-approve", "change-merge", "change-apply"]);
200
+ expect(w.approvals).toEqual([{ pull: 1, op: "pr-1", gate: "pr-apply", digest: "jcs1-sha256:1", approver: "forgejo@forgejo:3000:reviewer" }]);
201
+ expect(w.opened[0]).toEqual({ branch: "demo/change", files: { "src/change.ts": 'export const overlay = "change";\n' } });
202
+ });
203
+
204
+ test("the BREAK run is caught when an outcome stops holding, on its own branch", async () => {
205
+ const w = world();
206
+ const claim = await runClaim(fanOut(), w.ports, OPTS);
207
+ expect(claim.plain.outcome).toBe("held");
208
+ expect(claim.break.outcome).toBe("broke");
209
+ expect(claim.break.reason).toMatch(/change-apply: the apply report ended applied, not failed/);
210
+ expect(claim.break.steps.at(-1)?.stopped?.outcome).toBe("broke");
211
+ expect(claim.verdicts).toEqual({ plain: "pass", break: "caught" });
212
+ expect(w.opened.map((o) => o.branch)).toEqual(["demo/change", "demo/change-break"]);
213
+ expect(w.resets).toBe(2);
214
+ expect(w.armEnv).toEqual([{}, { BREAK: "1" }]);
215
+ });
216
+
217
+ test("a BREAK run that changes nothing is missed", async () => {
218
+ const w = world({ breakDoesNothing: true });
219
+ const claim = await runClaim(fanOut(), w.ports, OPTS);
220
+ expect(claim.verdicts).toEqual({ plain: "pass", break: "missed" });
221
+ });
222
+
223
+ test("a report that never comes stalls the run past its limit, and a stall is neither verdict", async () => {
224
+ const w = world({ silent: true });
225
+ const run = await runArm(fanOut({ limits: { apply: 30 } }), "plain", w.ports, OPTS);
226
+ expect(run.outcome).toBe("stalled");
227
+ expect(run.reason).toMatch(/change-apply: no pr-apply.json at 1\/b0+1 within 30s/);
228
+ expect(run.steps.at(-1)).toMatchObject({ id: "change-apply", stopped: { outcome: "stalled" } });
229
+ expect(verdictsOf(run, run)).toEqual({ plain: "fail", break: "stalled" });
230
+ });
231
+
232
+ test("the break overlay goes over every pull request of the BREAK run", async () => {
233
+ const w = world();
234
+ await runArm(fanOut({ break: { env: { BREAK: "1" }, overlay: "break" } }), "break", w.ports, OPTS);
235
+ expect(w.opened[0]!.files).toEqual({
236
+ "src/change.ts": 'export const overlay = "change";\n',
237
+ "src/break.ts": 'export const overlay = "break";\n',
238
+ });
239
+ });
240
+
241
+ test("open-concurrent opens its pull request beside the open before it", async () => {
242
+ const w = world();
243
+ const s = fanOut({
244
+ steps: [
245
+ { id: "a", do: "open", branch: "a", overlay: "change", title: "A" },
246
+ { id: "b", do: "open-concurrent", branch: "b", overlay: "fix", title: "B" },
247
+ { id: "a-plan", do: "plan", pull: "a", expect: [{ report: { status: "planned" } }] },
248
+ { id: "b-plan", do: "plan", pull: "b", expect: [{ comment: "plan for #2" }] },
249
+ ],
250
+ });
251
+ expect(lintScenario(s)).toEqual([]);
252
+ const run = await runArm(s, "plain", w.ports, OPTS);
253
+ expect(run.outcome).toBe("held");
254
+ expect(run.steps.map((x) => [x.id, x.pull])).toEqual([
255
+ ["a", 1],
256
+ ["b", 2],
257
+ ["a-plan", 1],
258
+ ["b-plan", 2],
259
+ ]);
260
+ });
261
+
262
+ test("ledger, comment and issue outcomes read the ledger and the forge", async () => {
263
+ const w = world();
264
+ const s = fanOut();
265
+ s.steps[4]!.expect!.push({ ledger: { op: "pr-apply", status: "fail", count: 1 } }, { comment: "15 stacks" }, { issue: { title: "drift", open: true } });
266
+ expect((await runArm(s, "plain", w.ports, OPTS)).outcome).toBe("held");
267
+
268
+ const wrong = fanOut();
269
+ wrong.steps[4]!.expect = [{ ledger: { op: "pr-apply", status: "ok" } }];
270
+ const run = await runArm(wrong, "plain", world().ports, OPTS);
271
+ expect(run.outcome).toBe("broke");
272
+ expect(run.reason).toMatch(/no pr-apply run ok on the ledger/);
273
+ });
274
+
275
+ test("out-of-band and kill-job steps go through their ports, and stall without them", async () => {
276
+ const w = world();
277
+ const ran: string[][] = [];
278
+ const killed: Array<string | undefined> = [];
279
+ const s = fanOut({
280
+ steps: [
281
+ { id: "drift", do: "out-of-band", command: ["aws", "sqs", "tag-queue"], expect: [{ exit: 0 }] },
282
+ { id: "kill", do: "kill-job", match: "pr-apply" },
283
+ ],
284
+ });
285
+ const run = await runArm(s, "plain", { ...w.ports, outOfBand: { run: async (c) => (ran.push(c), 0) }, jobs: { kill: async (m) => (killed.push(m), true) } }, OPTS);
286
+ expect(run.outcome).toBe("held");
287
+ expect(ran).toEqual([["aws", "sqs", "tag-queue"]]);
288
+ expect(killed).toEqual(["pr-apply"]);
289
+
290
+ const bare = await runArm(s, "plain", w.ports, OPTS);
291
+ expect(bare.outcome).toBe("stalled");
292
+ expect(bare.reason).toMatch(/drift: an out-of-band step needs the out-of-band port/);
293
+
294
+ const none = await runArm(s, "plain", { ...w.ports, outOfBand: { run: async () => 0 }, jobs: { kill: async () => false } }, OPTS);
295
+ expect(none.reason).toMatch(/kill: no running job matching pr-apply to kill/);
296
+ });
297
+
298
+ test("a forge error stalls the run at its step", async () => {
299
+ const w = world();
300
+ const run = await runArm(fanOut(), "plain", { ...w.ports, forge: { ...w.ports.forge, mergePull: async () => Promise.reject(new Error("Forgejo answered 500")) } }, OPTS);
301
+ expect(run.outcome).toBe("stalled");
302
+ expect(run.reason).toBe("change-merge: Forgejo answered 500");
303
+ });
304
+ });