@intentius/chant 0.124.99 → 0.124.101

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 (245) hide show
  1. package/bin/chant +3 -3
  2. package/dist/action-pins.d.ts +2 -0
  3. package/dist/action-pins.js +3 -0
  4. package/dist/ci-detect.d.ts +13 -0
  5. package/dist/ci-detect.js +12 -0
  6. package/dist/ci-system.d.ts +66 -0
  7. package/dist/ci-system.js +61 -0
  8. package/dist/cli/commands/carve-emit.js +2 -2
  9. package/dist/cli/commands/check-lexicon-plugin.d.ts +2 -2
  10. package/dist/cli/commands/check-lexicon-plugin.js +3 -3
  11. package/dist/cli/commands/check-lexicon.js +4 -4
  12. package/dist/cli/commands/init-lexicon/templates/project.d.ts +1 -1
  13. package/dist/cli/commands/init-lexicon/templates/project.js +4 -4
  14. package/dist/cli/commands/init.d.ts +13 -0
  15. package/dist/cli/commands/init.js +30 -2
  16. package/dist/cli/handlers/build.js +27 -0
  17. package/dist/cli/handlers/release-doctor.d.ts +12 -0
  18. package/dist/cli/handlers/release-doctor.js +118 -0
  19. package/dist/cli/handlers/release-init.d.ts +10 -0
  20. package/dist/cli/handlers/release-init.js +342 -0
  21. package/dist/cli/handlers/release.d.ts +50 -1
  22. package/dist/cli/handlers/release.js +688 -30
  23. package/dist/cli/handlers/run-generate.js +11 -0
  24. package/dist/cli/main.d.ts +2 -0
  25. package/dist/cli/main.js +45 -97
  26. package/dist/cli/parse-args.js +55 -0
  27. package/dist/cli/registry.d.ts +18 -0
  28. package/dist/cli/release-commands/artifacts.d.ts +3 -0
  29. package/dist/cli/release-commands/artifacts.js +14 -0
  30. package/dist/cli/release-commands/candidates.d.ts +3 -0
  31. package/dist/cli/release-commands/candidates.js +16 -0
  32. package/dist/cli/release-commands/changed.d.ts +3 -0
  33. package/dist/cli/release-commands/changed.js +14 -0
  34. package/dist/cli/release-commands/compose.d.ts +3 -0
  35. package/dist/cli/release-commands/compose.js +16 -0
  36. package/dist/cli/release-commands/cut.d.ts +3 -0
  37. package/dist/cli/release-commands/cut.js +49 -0
  38. package/dist/cli/release-commands/doctor.d.ts +3 -0
  39. package/dist/cli/release-commands/doctor.js +14 -0
  40. package/dist/cli/release-commands/export.d.ts +3 -0
  41. package/dist/cli/release-commands/export.js +12 -0
  42. package/dist/cli/release-commands/images.d.ts +3 -0
  43. package/dist/cli/release-commands/images.js +13 -0
  44. package/dist/cli/release-commands/index.d.ts +8 -0
  45. package/dist/cli/release-commands/index.js +52 -0
  46. package/dist/cli/release-commands/init.d.ts +3 -0
  47. package/dist/cli/release-commands/init.js +16 -0
  48. package/dist/cli/release-commands/list.d.ts +3 -0
  49. package/dist/cli/release-commands/list.js +10 -0
  50. package/dist/cli/release-commands/next.d.ts +3 -0
  51. package/dist/cli/release-commands/next.js +13 -0
  52. package/dist/cli/release-commands/publish.d.ts +3 -0
  53. package/dist/cli/release-commands/publish.js +22 -0
  54. package/dist/cli/release-commands/stamp.d.ts +3 -0
  55. package/dist/cli/release-commands/stamp.js +15 -0
  56. package/dist/cli/release-commands/status.d.ts +3 -0
  57. package/dist/cli/release-commands/status.js +17 -0
  58. package/dist/cli/release-commands/tag.d.ts +3 -0
  59. package/dist/cli/release-commands/tag.js +12 -0
  60. package/dist/cli/release-commands/types.d.ts +20 -0
  61. package/dist/cli/release-commands/types.js +1 -0
  62. package/dist/cli/release-commands/verify.d.ts +3 -0
  63. package/dist/cli/release-commands/verify.js +15 -0
  64. package/dist/cli/release-commands/workflow.d.ts +3 -0
  65. package/dist/cli/release-commands/workflow.js +13 -0
  66. package/dist/codegen/pinned-upgrade.js +1 -1
  67. package/dist/components/capability-plugin.d.ts +1 -1
  68. package/dist/components/capability-plugin.js +1 -1
  69. package/dist/components/cli-support.d.ts +1 -1
  70. package/dist/components/cli-support.js +1 -1
  71. package/dist/config-environments.d.ts +8 -1
  72. package/dist/config-environments.js +2 -0
  73. package/dist/config.d.ts +299 -6
  74. package/dist/config.js +102 -5
  75. package/dist/dead-guards.d.ts +5 -1
  76. package/dist/dead-guards.js +34 -23
  77. package/dist/discovery/sandbox/driver.js +1 -1
  78. package/dist/discovery/specifier-resolve.js +1 -1
  79. package/dist/floor-table.d.ts +3 -1
  80. package/dist/floor-table.data.js +23 -3
  81. package/dist/floor-table.js +4 -3
  82. package/dist/forge-remote.d.ts +13 -0
  83. package/dist/forge-remote.js +15 -0
  84. package/dist/lexicon.d.ts +41 -2
  85. package/dist/lifecycle/__fixtures__/publish-fakes.d.ts +62 -0
  86. package/dist/lifecycle/__fixtures__/publish-fakes.js +270 -3
  87. package/dist/lifecycle/publish-attachments.d.ts +2 -1
  88. package/dist/lifecycle/publish-attachments.js +19 -2
  89. package/dist/lifecycle/publish-cargo.d.ts +99 -0
  90. package/dist/lifecycle/publish-cargo.js +412 -0
  91. package/dist/lifecycle/publish-credentials.d.ts +1 -1
  92. package/dist/lifecycle/publish-credentials.js +8 -0
  93. package/dist/lifecycle/publish-declaration.d.ts +199 -4
  94. package/dist/lifecycle/publish-declaration.js +200 -9
  95. package/dist/lifecycle/publish-forge.d.ts +45 -2
  96. package/dist/lifecycle/publish-forge.js +434 -34
  97. package/dist/lifecycle/publish-git-ssh.d.ts +15 -0
  98. package/dist/lifecycle/publish-git-ssh.js +30 -4
  99. package/dist/lifecycle/publish-github.d.ts +40 -2
  100. package/dist/lifecycle/publish-github.js +100 -3
  101. package/dist/lifecycle/publish-homebrew.d.ts +7 -9
  102. package/dist/lifecycle/publish-homebrew.js +34 -197
  103. package/dist/lifecycle/publish-index.d.ts +141 -0
  104. package/dist/lifecycle/publish-index.js +719 -0
  105. package/dist/lifecycle/publish-marketplace.js +77 -0
  106. package/dist/lifecycle/publish-mcp-registry.d.ts +66 -0
  107. package/dist/lifecycle/publish-mcp-registry.js +306 -0
  108. package/dist/lifecycle/publish-npm.js +165 -2
  109. package/dist/lifecycle/publish-oci.d.ts +34 -1
  110. package/dist/lifecycle/publish-oci.js +246 -7
  111. package/dist/lifecycle/publish-pypi.d.ts +136 -0
  112. package/dist/lifecycle/publish-pypi.js +657 -0
  113. package/dist/lifecycle/publish-record.d.ts +6 -3
  114. package/dist/lifecycle/publish-record.js +6 -3
  115. package/dist/lifecycle/publish-signing.d.ts +147 -0
  116. package/dist/lifecycle/publish-signing.js +257 -0
  117. package/dist/lifecycle/publish-targets.d.ts +27 -1
  118. package/dist/lifecycle/publish-targets.js +80 -0
  119. package/dist/lifecycle/publish-tauri.js +43 -0
  120. package/dist/lifecycle/publish-train-names.d.ts +54 -0
  121. package/dist/lifecycle/publish-train-names.js +118 -0
  122. package/dist/lifecycle/publish-verify.d.ts +121 -0
  123. package/dist/lifecycle/publish-verify.js +130 -0
  124. package/dist/lifecycle/query.js +8 -0
  125. package/dist/lifecycle/release-artifacts.d.ts +212 -0
  126. package/dist/lifecycle/release-artifacts.js +571 -0
  127. package/dist/lifecycle/release-changelog.d.ts +13 -1
  128. package/dist/lifecycle/release-changelog.js +35 -2
  129. package/dist/lifecycle/release-cut.d.ts +58 -3
  130. package/dist/lifecycle/release-cut.js +132 -34
  131. package/dist/lifecycle/release-doctor.d.ts +113 -0
  132. package/dist/lifecycle/release-doctor.js +996 -0
  133. package/dist/lifecycle/release-green.d.ts +86 -0
  134. package/dist/lifecycle/release-green.js +286 -0
  135. package/dist/lifecycle/release-init.d.ts +255 -0
  136. package/dist/lifecycle/release-init.js +859 -0
  137. package/dist/lifecycle/release-intents.d.ts +73 -0
  138. package/dist/lifecycle/release-intents.js +128 -0
  139. package/dist/lifecycle/release-next.d.ts +111 -0
  140. package/dist/lifecycle/release-next.js +252 -0
  141. package/dist/lifecycle/release-prerelease.d.ts +19 -0
  142. package/dist/lifecycle/release-prerelease.js +30 -0
  143. package/dist/lifecycle/release-publish.d.ts +256 -10
  144. package/dist/lifecycle/release-publish.js +246 -34
  145. package/dist/lifecycle/release-status-change.d.ts +226 -0
  146. package/dist/lifecycle/release-status-change.js +478 -0
  147. package/dist/lifecycle/release-status.d.ts +11 -0
  148. package/dist/lifecycle/release-status.js +1 -1
  149. package/dist/lifecycle/release-store.d.ts +73 -2
  150. package/dist/lifecycle/release-store.js +32 -1
  151. package/dist/lifecycle/release-tag.d.ts +142 -0
  152. package/dist/lifecycle/release-tag.js +323 -0
  153. package/dist/lifecycle/release-verify.d.ts +73 -1
  154. package/dist/lifecycle/release-verify.js +117 -2
  155. package/dist/lifecycle/release-version-formats.d.ts +73 -0
  156. package/dist/lifecycle/release-version-formats.js +570 -0
  157. package/dist/lifecycle/release-version.d.ts +58 -10
  158. package/dist/lifecycle/release-version.js +164 -36
  159. package/dist/lifecycle/release-workstation.d.ts +3 -2
  160. package/dist/lifecycle/release-workstation.js +3 -2
  161. package/dist/module-source.d.ts +2 -2
  162. package/dist/module-source.js +8 -8
  163. package/dist/op/generate-pipeline.js +1 -1
  164. package/dist/pr-forge-base.js +4 -2
  165. package/dist/pr-forge.d.ts +20 -2
  166. package/dist/pr-forge.js +46 -10
  167. package/dist/release-floors.d.ts +10 -1
  168. package/dist/release-floors.js +10 -1
  169. package/dist/tool-pins.d.ts +38 -0
  170. package/dist/tool-pins.js +54 -0
  171. package/dist/ts-loader.d.ts +1 -1
  172. package/dist/ts-loader.js +6 -6
  173. package/dist/wave-runtime.mjs +337 -334
  174. package/dist/workspace/ci-forge.d.ts +17 -0
  175. package/dist/workspace/ci-forge.js +17 -0
  176. package/dist/workspace/ci-init.js +1 -1
  177. package/dist/workspace/composites.schema.json +1 -0
  178. package/dist/workspace/declaration.d.ts +8 -0
  179. package/dist/workspace/declaration.js +12 -0
  180. package/dist/workspace/declaration.schema.json +8 -0
  181. package/dist/workspace/environments.d.ts +2 -0
  182. package/dist/workspace/environments.js +1 -1
  183. package/dist/workspace/identity-gate-rule.d.ts +61 -5
  184. package/dist/workspace/identity-gate-rule.js +81 -12
  185. package/dist/workspace/member-pipeline.d.ts +2 -1
  186. package/dist/workspace/member-pipeline.js +5 -2
  187. package/dist/workspace/reason-codes.d.ts +6 -0
  188. package/dist/workspace/reason-codes.js +8 -1
  189. package/dist/workspace/release-changed.d.ts +179 -0
  190. package/dist/workspace/release-changed.js +625 -0
  191. package/dist/workspace/release-changed.schema.json +206 -0
  192. package/dist/workspace/release-steps/artifacts.d.ts +7 -0
  193. package/dist/workspace/release-steps/artifacts.js +45 -0
  194. package/dist/workspace/release-steps/builds.d.ts +12 -0
  195. package/dist/workspace/release-steps/builds.js +38 -0
  196. package/dist/workspace/release-steps/doctor.d.ts +8 -0
  197. package/dist/workspace/release-steps/doctor.js +14 -0
  198. package/dist/workspace/release-steps/goreleaser.d.ts +16 -0
  199. package/dist/workspace/release-steps/goreleaser.js +36 -0
  200. package/dist/workspace/release-steps/green.d.ts +3 -0
  201. package/dist/workspace/release-steps/green.js +6 -0
  202. package/dist/workspace/release-steps/images.d.ts +22 -0
  203. package/dist/workspace/release-steps/images.js +59 -0
  204. package/dist/workspace/release-steps/index.d.ts +9 -0
  205. package/dist/workspace/release-steps/index.js +46 -0
  206. package/dist/workspace/release-steps/pypi.d.ts +15 -0
  207. package/dist/workspace/release-steps/pypi.js +21 -0
  208. package/dist/workspace/release-steps/qemu.d.ts +21 -0
  209. package/dist/workspace/release-steps/qemu.js +35 -0
  210. package/dist/workspace/release-steps/signing.d.ts +18 -0
  211. package/dist/workspace/release-steps/signing.js +30 -0
  212. package/dist/workspace/release-steps/stamp.d.ts +3 -0
  213. package/dist/workspace/release-steps/stamp.js +4 -0
  214. package/dist/workspace/release-steps/targets.d.ts +31 -0
  215. package/dist/workspace/release-steps/targets.js +40 -0
  216. package/dist/workspace/release-steps/types.d.ts +104 -0
  217. package/dist/workspace/release-steps/types.js +2 -0
  218. package/dist/workspace/release-steps/verify.d.ts +3 -0
  219. package/dist/workspace/release-steps/verify.js +4 -0
  220. package/dist/workspace/release-toolchains.d.ts +59 -0
  221. package/dist/workspace/release-toolchains.js +133 -0
  222. package/dist/workspace/release-train-workflow.d.ts +29 -0
  223. package/dist/workspace/release-train-workflow.js +85 -0
  224. package/dist/workspace/release-train.d.ts +3 -1
  225. package/dist/workspace/release-train.js +20 -3
  226. package/dist/workspace/release-workflow.d.ts +160 -61
  227. package/dist/workspace/release-workflow.js +539 -193
  228. package/dist/workspace/releases.schema.json +70 -1
  229. package/dist/workspace/search-contract.d.ts +1 -1
  230. package/dist/workspace/security.js +9 -2
  231. package/dist/workspace/train-cut.d.ts +182 -0
  232. package/dist/workspace/train-cut.js +482 -0
  233. package/dist/workspace/train-prepare.d.ts +61 -0
  234. package/dist/workspace/train-prepare.js +267 -0
  235. package/dist/workspace/train-publish.d.ts +177 -0
  236. package/dist/workspace/train-publish.js +575 -0
  237. package/dist/workspace/train-range-labels.d.ts +33 -0
  238. package/dist/workspace/train-range-labels.js +109 -0
  239. package/dist/workspace/trust/seal.d.ts +13 -3
  240. package/dist/workspace/trust/seal.js +14 -4
  241. package/dist/workspace/work-cli.d.ts +3 -2
  242. package/dist/workspace/work-cli.js +3 -2
  243. package/dist/workspace/workspace-ledger.d.ts +14 -1
  244. package/dist/workspace/workspace-ledger.js +33 -7
  245. package/package.json +26 -26
@@ -35,6 +35,8 @@ export const DEFAULT_OP_PIPELINE_DIRS = {
35
35
  github: ".github/workflows",
36
36
  forgejo: ".forgejo/workflows",
37
37
  gitlab: ".",
38
+ // #5189: one job config holding every Op's job.
39
+ prow: "prow",
38
40
  };
39
41
  /** The first line of every file this command writes. */
40
42
  export function opPipelineHeader(provider, specFile) {
@@ -165,6 +167,15 @@ export async function runOpGenerate(ctx) {
165
167
  return 1;
166
168
  }
167
169
  }
170
+ // #5189: Prow keys the jobs by the GitHub repository's owner/name, from the spec's options, --repo or the origin remote.
171
+ if (provider === "prow" && !options?.forgeRepo) {
172
+ const resolved = (await import("../../forge-remote.js")).prowRepoOf(process.cwd(), args.ciRepo);
173
+ if ("error" in resolved) {
174
+ console.error(formatError({ message: resolved.error }));
175
+ return 1;
176
+ }
177
+ options = { ...options, forgeRepo: resolved.repo };
178
+ }
168
179
  const result = await generateOpsPipeline(ops, provider, plan ? { ...options, member: plan.member } : options);
169
180
  if (!result.success) {
170
181
  console.error(formatError({ message: result.error ?? "Failed to generate Op pipelines" }));
@@ -4,6 +4,8 @@ import { type CommandDef } from "./registry.js";
4
4
  import { parseArgs } from "./parse-args.js";
5
5
  import { waitForStreamDrain } from "./flush.js";
6
6
  export { parseArgs, waitForStreamDrain };
7
+ /** Core's own `--help` text, without the lexicon command groups. */
8
+ export declare function helpText(): string;
7
9
  /**
8
10
  * Run one level-0 command line in this process and return its exit code
9
11
  * (#2537). `chant workspace member-run` calls it once per member, from inside
package/dist/cli/main.js CHANGED
@@ -18,6 +18,7 @@ import { dispatchCommandGroup, collectCommandGroups, formatCommandGroupsHelp } f
18
18
  import { parseArgs } from "./parse-args.js";
19
19
  import { flushAndExit, waitForStreamDrain } from "./flush.js";
20
20
  import { setOwnChantCommand } from "../lifecycle/lock-beat.js";
21
+ import { releaseHelp } from "./release-commands/index.js";
21
22
  export { parseArgs, waitForStreamDrain };
22
23
  const handlerModules = new Map();
23
24
  function lazyHandler(load, pick) {
@@ -126,7 +127,14 @@ const resolveProjectLexicons = async (...a) => (await import("./plugins.js")).re
126
127
  * alongside core's own commands.
127
128
  */
128
129
  function printHelp(groups = []) {
129
- console.log(`
130
+ console.log(helpText());
131
+ const groupsHelp = formatCommandGroupsHelp(groups);
132
+ if (groupsHelp)
133
+ console.log(groupsHelp);
134
+ }
135
+ /** Core's own `--help` text, without the lexicon command groups. */
136
+ export function helpText() {
137
+ return `
130
138
  chant - Declarative infrastructure specification toolkit
131
139
 
132
140
  Usage:
@@ -469,98 +477,7 @@ CI:
469
477
  a run of its own.
470
478
 
471
479
  Releases:
472
- release cut [<label>] [--at <sha>] [--yes] [--build <command>] [--param <k=v>]
473
- [--params-file <file>] [--src <dir>] [-o <file>] [--lexicon <name>]
474
- [--actor <name>] [--sign [<key file>]] [--channel <tag>]
475
- [--lane <name>] [--override-green]
476
- [--image <component>=<repository>@sha256:<hex>] [--json]
477
- A dry run of a cut of this member from HEAD, which
478
- must be clean, on trunk and pushed, and carry a
479
- ci/green tag: compile every environment in the
480
- config's environments and print what the cut would
481
- build, record and tag, and what publishes where.
482
- --yes cuts: builds the artifacts once, stores the
483
- release on chant/lifecycle under its digest, records
484
- the actor and run id, tags the commit release/<label>
485
- here, and prints the next command.
486
- --build runs before each environment's templates are
487
- read, with CHANT_ENV set; {env} in --params-file is
488
- replaced by the environment. --sign signs the cut with
489
- the actor's ssh key; an identity.gates release entry
490
- requires it. A project with no components releases
491
- what chant build --env <env> writes: --src <dir> is
492
- the build root, -o <file> the output (dist/build.yaml),
493
- --lexicon narrows it. --at <sha> cuts that commit of
494
- trunk from a temporary worktree instead of HEAD, so
495
- the checkout need not be clean. The label reaches
496
- every compile and build as CHANT_RELEASE_LABEL.
497
- --image, repeatable, hands the cut a component's image
498
- built elsewhere, by digest: the release records it and
499
- the cut builds nothing for that component (#4694).
500
- A green commit of a pushed chant/compose/<name>
501
- branch is cut too, recording its base and sources.
502
- --channel <tag> records the tag a publish moves in
503
- place of latest. --lane <name> (or release.lane in
504
- chant.config.ts) checks a ci.green lane's tag,
505
- ci/green-<lane>/<sha>, in place of ci/green.
506
- --override-green cuts a commit that is not green
507
- under a person's override, recorded with chant
508
- approve policy-override release-<sha12>; the cut
509
- spends it and records who and why.
510
- release compose <name> [--base <label|sha>] (--pr <n> | --work <id>)...
511
- [--yes] [--json]
512
- Cherry-pick the chosen trunk changes, in trunk order,
513
- onto the base, each with a Chant-Composed-From
514
- trailer, on chant/compose/<name>. Appends to a branch
515
- that exists; stops on a conflict, naming the change
516
- and files, and writes nothing. A dry run unless --yes,
517
- which moves the branch and pushes it.
518
- release candidates [--env <env>] [--lane <name>] [--forge-issues] [--json]
519
- The green commits of trunk a release can be cut from,
520
- newest first, each with the commits, work items, pull
521
- requests and flags it would ship, and what each
522
- environment runs. --lane reads a lane's green tags,
523
- as release cut --lane checks them. --forge-issues asks
524
- the forge which issues each pull request closes, once
525
- per pull request
526
- release publish <label|digest> [--yes] [--allow-unsigned]
527
- [--require-provenance] [--json]
528
- Publish a cut release to the targets release.publish
529
- in chant.config.ts declares (npm, OCI registries,
530
- forge release assets), each with the release's
531
- provenance and an SBOM when it has a source. A dry
532
- run without --yes. Refuses a revoked release, and
533
- with a target a checkout that is not the release's
534
- commit. Under security verified-releases it refuses
535
- one whose signature does not verify against
536
- .chant/allowed_signers unless --allow-unsigned; under
537
- supply-chain it warns when the run has no OIDC token
538
- and refuses a target with no SBOM source.
539
- --require-provenance refuses a run with no OIDC.
540
- release verify <label|digest> [--json]
541
- Check, offline, that the release was signed by a key
542
- .chant/allowed_signers lists at the release's commit.
543
- release images <label|digest> [--no-build] [-o <file>] [--json]
544
- Build the images release.images declares again from
545
- the release's commit, refuse one whose digest is not
546
- the recorded one, and write the recorded digests to
547
- the file CHANT_RELEASE_DIGESTS names for the build.
548
- release stamp <label> [--json]
549
- Write the label as the version of each package.json
550
- release.version names, and the lockfile's entries for
551
- them, as the cut does before its build. The publish
552
- job runs it before its build.
553
- release workflow [--forge github|gitlab|forgejo] [--install <command>]
554
- [--build <command>] [--chant <command>] [--output <file>]
555
- Write the publish workflow, run on a release/** tag.
556
- Under supply-chain it passes --require-provenance, and
557
- under verified-releases it runs release verify first
558
- release list [--json] Every release of this member with its targets, its
559
- cuts and the environments that run it.
560
- release export <label|digest> --env <env> [-o <dir>] [--json]
561
- Write the files the release recorded for <env>, each
562
- checked against its digest, at their recorded paths
563
- under <dir> (default: here), for a deploy to read.
480
+ ${releaseHelp()}
564
481
 
565
482
  Change sets:
566
483
  change-set summary <file> The grouped plan summary of a change-set
@@ -1290,6 +1207,27 @@ Workspace (level 1, #2524):
1290
1207
  instead; --continue moves on from the member's answer
1291
1208
  in _control/applied.jsonl, after applied or unchanged
1292
1209
  (#5119)
1210
+ workspace train cut <env> [--at <sha>] [--levels <levels>] [--yes] [--no-push] [--json]
1211
+ Cut a train (release.train): the members release
1212
+ changed lists, each labelled past every version its
1213
+ ledger, tags, packages and npm hold, cut at one
1214
+ commit, the train recorded, and the member tags and
1215
+ release-train/<env>/<id> pushed in one push. --levels
1216
+ types levels (auto, minor, core=major ...). Without
1217
+ --yes it plans (#5154)
1218
+ workspace train prepare <env> [<train id|digest>] [--json]
1219
+ In a checkout of the train's commit: stamp each member
1220
+ cut here (release.version, train ranges) and build the
1221
+ workspace packages they depend on that the train does
1222
+ not publish here, once each, dependencies first
1223
+ (#5154)
1224
+ workspace train publish <env> [<train id|digest>] [--yes] [--allow-unsigned] [--require-provenance] [--json]
1225
+ Publish a train as one set: every member cut from this
1226
+ commit stages before any reveals, then each dependency
1227
+ layer reveals, core first, once the layer before it
1228
+ resolves. A member pinned at another commit must
1229
+ already be published. Resumes from each member's
1230
+ publish record (#5136)
1293
1231
 
1294
1232
  Lifecycle (alias: lc):
1295
1233
  lifecycle snapshot <env> Query API, save metadata to orphan branch
@@ -1751,10 +1689,7 @@ Examples:
1751
1689
  chant list ./infra/ --format json
1752
1690
  chant describe myComponent src/
1753
1691
  chant describe myComponent src/ --format json
1754
- `);
1755
- const groupsHelp = formatCommandGroupsHelp(groups);
1756
- if (groupsHelp)
1757
- console.log(groupsHelp);
1692
+ `;
1758
1693
  }
1759
1694
  /**
1760
1695
  * Best-effort load the current project's lexicon plugins for a purely
@@ -2032,13 +1967,26 @@ export const commandRegistry = [
2032
1967
  { name: "release verify", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseVerify(ctx) },
2033
1968
  // #4657: build a release's images again in its publish job, checked against the digests it records.
2034
1969
  { name: "release images", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseImages(ctx) },
1970
+ { name: "release artifacts", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseArtifacts(ctx) },
2035
1971
  // #4840: the label into the package.json files release.version names, in the publish job before its build.
1972
+ { name: "release doctor", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release-doctor.js")).runReleaseDoctor(ctx) },
2036
1973
  { name: "release stamp", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseStamp(ctx) },
1974
+ // #5150: the tag release.tag gives a release, found by label, digest or the tag itself.
1975
+ { name: "release tag", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseTag(ctx) },
1976
+ // #5160: the first setup of chant release in a project.
1977
+ { name: "release init", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release-init.js")).runReleaseInit(ctx) },
2037
1978
  { name: "release workflow", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/release-workflow.js")).runReleaseWorkflow(ctx) },
2038
1979
  // #4168 4.3: mode (b), chosen changes composed onto a base on chant/compose/<name>.
2039
1980
  { name: "release compose", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseCompose(ctx) },
2040
1981
  { name: "release candidates", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseCandidates(ctx) },
1982
+ // #5159: the next label from the commits and intent files since the previous release.
1983
+ { name: "release next", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseNext(ctx) },
1984
+ { name: "release changed", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseChanged(ctx) },
2041
1985
  { name: "release list", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseList(ctx) },
1986
+ // #5163: deprecate, yank and restore a published release on each target that can.
1987
+ { name: "release deprecate", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseStatusChange(ctx, "deprecate") },
1988
+ { name: "release yank", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseStatusChange(ctx, "yank") },
1989
+ { name: "release restore", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseStatusChange(ctx, "restore") },
2042
1990
  { name: "release export", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseExport(ctx) },
2043
1991
  { name: "release compile", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/release.js")).runReleaseCompile(ctx) },
2044
1992
  // #3188 — the grouped plan summary of a change-set document. Reads one file; imported on first use.
@@ -117,6 +117,7 @@ const BOOLEAN_FLAGS = new Set([
117
117
  "--push",
118
118
  "--only",
119
119
  "--reset",
120
+ "--one-release",
120
121
  ]);
121
122
  /**
122
123
  * Parse command line arguments
@@ -608,6 +609,13 @@ export function parseArgs(args) {
608
609
  throw new Error("--pin needs a member and a release: --pin <member>=<label|digest>");
609
610
  (result.pins ?? (result.pins = [])).push(value);
610
611
  }
612
+ else if (arg === "--train") {
613
+ // `chant release stamp <label> --train <id|digest>` (#5155): the train whose labels the workspace ranges take.
614
+ const value = args[++i];
615
+ if (!value || value.startsWith("-"))
616
+ throw new Error("--train needs a train id or digest: --train <id|digest>");
617
+ result.train = value;
618
+ }
611
619
  else if (arg === "--from-affected") {
612
620
  result.fromAffected = args[++i];
613
621
  }
@@ -723,6 +731,12 @@ export function parseArgs(args) {
723
731
  if (!result.channel || !/^[A-Za-z][A-Za-z0-9._-]*$/.test(result.channel))
724
732
  throw new Error(`--channel needs a channel name, such as next or hotfix: got "${result.channel ?? ""}"`);
725
733
  }
734
+ else if (arg === "--pre") {
735
+ // `chant release next --pre <id>` (#5159): the next label is a prerelease, such as 1.5.0-rc.0.
736
+ result.pre = args[++i];
737
+ if (!result.pre || result.pre.startsWith("-"))
738
+ throw new Error("--pre needs a prerelease id, such as rc or beta");
739
+ }
726
740
  else if (arg === "--forge") {
727
741
  result.forge = args[++i];
728
742
  if (!result.forge || result.forge.startsWith("-"))
@@ -816,6 +830,19 @@ export function parseArgs(args) {
816
830
  // `chant release cut --override-green` (#4693): cut a commit that is not green under a person's override.
817
831
  result.overrideGreen = true;
818
832
  }
833
+ else if (arg === "--replacement") {
834
+ // `chant release deprecate|yank --replacement <label>` (#5163).
835
+ result.replacement = args[++i];
836
+ if (!result.replacement || result.replacement.startsWith("-"))
837
+ throw new Error("--replacement needs the release to use instead: --replacement <label>");
838
+ }
839
+ else if (arg === "--forge-release") {
840
+ // `chant release yank --forge-release prerelease|draft|delete` (#5163).
841
+ const value = args[++i];
842
+ if (value !== "prerelease" && value !== "draft" && value !== "delete")
843
+ throw new Error(`--forge-release takes prerelease, draft or delete: got "${value ?? ""}"`);
844
+ result.forgeRelease = value;
845
+ }
819
846
  else if (arg === "--allow-unsigned") {
820
847
  // `chant release publish --allow-unsigned` (#4049).
821
848
  result.allowUnsigned = true;
@@ -824,6 +851,16 @@ export function parseArgs(args) {
824
851
  // `chant release publish --require-provenance` (#4049).
825
852
  result.requireProvenance = true;
826
853
  }
854
+ else if (arg === "--sigstore") {
855
+ // `chant release verify --sigstore` (#5164): check the Sigstore signatures the publish recorded.
856
+ result.sigstore = true;
857
+ }
858
+ else if (arg === "--assets") {
859
+ // `chant release verify --sigstore --assets <dir>` (#5164): where the forge release's assets were downloaded.
860
+ result.assets = args[++i];
861
+ if (!result.assets || result.assets.startsWith("-"))
862
+ throw new Error("--assets needs a directory: --assets dist/release");
863
+ }
827
864
  else if (arg === "--pr-loop") {
828
865
  result.prLoop = true;
829
866
  }
@@ -1032,6 +1069,20 @@ export function parseArgs(args) {
1032
1069
  // `chant workspace graph --intent ... --follow-squash` and `chant workspace runs --follow-squash` (#3035)
1033
1070
  result.followSquash = true;
1034
1071
  }
1072
+ else if (arg === "--levels") {
1073
+ // `chant workspace train cut <env> --levels "<level|member=level|auto> ..."` (#5154).
1074
+ const value = args[++i];
1075
+ if (value === undefined)
1076
+ throw new Error("--levels needs the levels: --levels auto, --levels minor, or --levels \"core=minor web=patch\"");
1077
+ result.levels = value;
1078
+ }
1079
+ else if (arg === "--bump-member") {
1080
+ // `chant release changed --bump-member <member>=<level>` (#5134) is repeatable.
1081
+ const value = args[++i];
1082
+ if (!value || value.startsWith("-"))
1083
+ throw new Error("--bump-member needs a member and a level: --bump-member <member>=major|minor|patch");
1084
+ (result.bumpMember ?? (result.bumpMember = [])).push(value);
1085
+ }
1035
1086
  else if (arg === "--forge-issues") {
1036
1087
  // `chant release candidates --forge-issues` and `chant workspace graph --intent ... --forge-issues` (#4649)
1037
1088
  result.forgeIssues = true;
@@ -1673,6 +1724,10 @@ export function parseArgs(args) {
1673
1724
  if (!result.ciJob || result.ciJob.startsWith("-"))
1674
1725
  throw new Error("--job needs the job as JSON or @<file>: --job @job.json");
1675
1726
  }
1727
+ else if (arg === "--one-release") {
1728
+ // `chant release init --one-release` (#5154): a workspace's packages released together, not as a train.
1729
+ result.oneRelease = true;
1730
+ }
1676
1731
  else if (arg === "--no-push") {
1677
1732
  // `chant ci run --no-push` (#4156): keep the run record on the local chant/lifecycle.
1678
1733
  result.noPush = true;
@@ -182,6 +182,10 @@ export interface ParsedArgs {
182
182
  allowUnsigned?: boolean;
183
183
  /** `chant release publish --require-provenance` (#4049): refuse a run with no OIDC token, where it warns. */
184
184
  requireProvenance?: boolean;
185
+ /** `chant release verify --sigstore` (#5164): check the Sigstore signatures and SLSA provenance the publish recorded. */
186
+ sigstore?: boolean;
187
+ /** `chant release verify --sigstore --assets <dir>` (#5164): the directory holding the forge release's downloaded assets. */
188
+ assets?: string;
185
189
  /** `chant workspace upgrade --source <repo>[#<member>]` (#2551): move the scope to another template. */
186
190
  source?: string;
187
191
  /** `chant workspace adopt-lineage --tags <glob>` and `hash-index --tags` (#2551): the tags to compare. */
@@ -306,6 +310,8 @@ export interface ParsedArgs {
306
310
  crossRoot?: boolean;
307
311
  /** `chant workspace train <env> --pin <member>=<label|digest>` (#2554), repeatable: the release a train pins for that member instead of its newest. */
308
312
  pins?: string[];
313
+ /** `chant release stamp <label> --train <id|digest>` (#5155): stamp each workspace dependency's range with the label this train gives its package, under `release.version.ranges: "train"`. */
314
+ train?: string;
309
315
  /**
310
316
  * `chant components fan-out --from-affected <file>` (#2420) — read the
311
317
  * stack-level change signal from the JSON `chant lifecycle affected --json`
@@ -398,6 +404,12 @@ export interface ParsedArgs {
398
404
  prs?: number[];
399
405
  /** `chant release cut --channel <tag>` (#4168 4.3): the tag a publish of the release moves in place of `latest`. */
400
406
  channel?: string;
407
+ /** `chant release next --pre <id>` and `chant release cut auto --pre <id>` (#5159): the next label is a prerelease of the computed version, `<version>-<id>.<n>`. */
408
+ pre?: string;
409
+ /** `chant release deprecate|yank --replacement <label>` (#5163): the release to move to instead. */
410
+ replacement?: string;
411
+ /** `chant release yank --forge-release prerelease|draft|delete` (#5163): how a yank leaves the forge release. */
412
+ forgeRelease?: "prerelease" | "draft" | "delete";
401
413
  /** `chant release cut --override-green` (#4693): cut a commit that is not green under a person's override on the override ledger. */
402
414
  overrideGreen?: boolean;
403
415
  /**
@@ -666,6 +678,10 @@ export interface ParsedArgs {
666
678
  intent?: string;
667
679
  /** `chant workspace graph --intent` and `chant workspace runs` (#3035): follow squash merges to their pull requests' original commits, fetching missing pull request refs. */
668
680
  followSquash?: boolean;
681
+ /** `chant workspace train cut <env> --levels <levels>` (#5154): `auto`, a level for every member, `<member>=<level>`, separated by spaces or commas. */
682
+ levels?: string;
683
+ /** `chant release changed --bump-member <member>=<level>` (#5134) — repeatable. */
684
+ bumpMember?: string[];
669
685
  /** `chant release candidates --forge-issues` and `chant workspace graph --intent --forge-issues` (#4649): ask the forge which issues each squash-merged pull request closes, once per pull request. */
670
686
  forgeIssues?: boolean;
671
687
  /** `chant workspace graph --intent --record <id>`: walk one decision record over every entry its constrains lists. */
@@ -770,6 +786,8 @@ export interface ParsedArgs {
770
786
  ciJob?: string;
771
787
  /** `chant ci run --no-push` (#4156): write the run record on the local chant/lifecycle and push nothing. */
772
788
  noPush?: boolean;
789
+ /** `chant release init --one-release` (#5154): every package of a workspace in one release, not a train. */
790
+ oneRelease?: boolean;
773
791
  /** `chant ci serve|run --setup-key --trust --principal <name>` (#4099): the principal the runner key is listed for. */
774
792
  ciPrincipal?: string;
775
793
  /** `chant workspace trust runner add <principal> --class runner|service` (#3510): the runner entry's class. */
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release artifacts`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const artifactsCommand: ReleaseCommandDoc;
@@ -0,0 +1,14 @@
1
+ /** `chant release artifacts`: its entry in `chant --help` and the `release` usage line. */
2
+ export const artifactsCommand = {
3
+ name: "artifacts",
4
+ helpOrder: 80,
5
+ help: [
6
+ " release artifacts <label|digest> [--no-build] [--from <dir>] [-o <dir>] [--json]",
7
+ " Build the files release.artifacts declares again from",
8
+ " the release's commit, or check those on disk",
9
+ " (--no-build) or copied from <dir> (--from), and",
10
+ " refuse one whose digest is not the recorded one. -o",
11
+ " stages the checked files in <dir> for the next job.",
12
+ ],
13
+ usage: { order: 60, text: "release artifacts <label|digest> [--no-build] [--from <dir>] [-o <dir>] [--json]" },
14
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release candidates`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const candidatesCommand: ReleaseCommandDoc;
@@ -0,0 +1,16 @@
1
+ /** `chant release candidates`: its entry in `chant --help` and the `release` usage line. */
2
+ export const candidatesCommand = {
3
+ name: "candidates",
4
+ helpOrder: 30,
5
+ help: [
6
+ " release candidates [--env <env>] [--lane <name>] [--forge-issues] [--json]",
7
+ " The green commits of trunk a release can be cut from,",
8
+ " newest first, each with the commits, work items, pull",
9
+ " requests and flags it would ship, and what each",
10
+ " environment runs. --lane reads a lane's green tags,",
11
+ " as release cut --lane checks them. --forge-issues asks",
12
+ " the forge which issues each pull request closes, once",
13
+ " per pull request",
14
+ ],
15
+ usage: { order: 90, text: "release candidates [--env <env>] [--lane <name>] [--forge-issues] [--json]" },
16
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release changed`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const changedCommand: ReleaseCommandDoc;
@@ -0,0 +1,14 @@
1
+ /** `chant release changed`: its entry in `chant --help` and the `release` usage line. */
2
+ export const changedCommand = {
3
+ name: "changed",
4
+ helpOrder: 140,
5
+ help: [
6
+ " release changed [--at <sha>] [--bump-member <member>=<level>]... [--json]",
7
+ " The members to release at a commit, in publish order,",
8
+ " each with why: changed, needed-by <member>,",
9
+ " range-broken-by <member> or intent-pending, and the",
10
+ " bump the commits and intent files give, unless",
11
+ " --bump-member sets it. Reads local refs only",
12
+ ],
13
+ usage: { order: 80, text: "release changed [--at <sha>] [--bump-member <member>=<level>]... [--json]" },
14
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release compose`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const composeCommand: ReleaseCommandDoc;
@@ -0,0 +1,16 @@
1
+ /** `chant release compose`: its entry in `chant --help` and the `release` usage line. */
2
+ export const composeCommand = {
3
+ name: "compose",
4
+ helpOrder: 20,
5
+ help: [
6
+ " release compose <name> [--base <label|sha>] (--pr <n> | --work <id>)...",
7
+ " [--yes] [--json]",
8
+ " Cherry-pick the chosen trunk changes, in trunk order,",
9
+ " onto the base, each with a Chant-Composed-From",
10
+ " trailer, on chant/compose/<name>. Appends to a branch",
11
+ " that exists; stops on a conflict, naming the change",
12
+ " and files, and writes nothing. A dry run unless --yes,",
13
+ " which moves the branch and pushes it.",
14
+ ],
15
+ usage: { order: 100, text: "release compose <name> [--base <label|sha>] (--pr <n> | --work <id>)... [--yes] [--json]" },
16
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release cut`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const cutCommand: ReleaseCommandDoc;
@@ -0,0 +1,49 @@
1
+ /** `chant release cut`: its entry in `chant --help` and the `release` usage line. */
2
+ export const cutCommand = {
3
+ name: "cut",
4
+ helpOrder: 10,
5
+ help: [
6
+ " release cut [<label>|auto] [--pre <id>] [--at <sha>] [--yes] [--build <command>] [--param <k=v>]",
7
+ " [--params-file <file>] [--src <dir>] [-o <file>] [--lexicon <name>]",
8
+ " [--actor <name>] [--sign [<key file>]] [--channel <tag>]",
9
+ " [--lane <name>] [--override-green]",
10
+ " [--image <component>=<repository>@sha256:<hex>] [--json]",
11
+ " A dry run of a cut of this member from HEAD, which",
12
+ " must be clean, on trunk and pushed, and carry a",
13
+ " ci/green tag: compile every environment in the",
14
+ " config's environments and print what the cut would",
15
+ " build, record and tag, and what publishes where.",
16
+ " --yes cuts: builds the artifacts once, stores the",
17
+ " release on chant/lifecycle under its digest, records",
18
+ " the actor and run id, tags the commit with the tag",
19
+ " release.tag names (default release/<label>) here,",
20
+ " and prints the next command.",
21
+ " --build runs before each environment's templates are",
22
+ " read, with CHANT_ENV set; {env} in --params-file is",
23
+ " replaced by the environment. --sign signs the cut with",
24
+ " the actor's ssh key; an identity.gates release entry",
25
+ " requires it. A project with no components releases",
26
+ " what chant build --env <env> writes: --src <dir> is",
27
+ " the build root, -o <file> the output (dist/build.yaml),",
28
+ " --lexicon narrows it. --at <sha> cuts that commit of",
29
+ " trunk from a temporary worktree instead of HEAD, so",
30
+ " the checkout need not be clean. The label reaches",
31
+ " every compile and build as CHANT_RELEASE_LABEL.",
32
+ " --image, repeatable, hands the cut a component's image",
33
+ " built elsewhere, by digest: the release records it and",
34
+ " the cut builds nothing for that component (#4694).",
35
+ " A green commit of a pushed chant/compose/<name>",
36
+ " branch is cut too, recording its base and sources.",
37
+ " --channel <tag> records the tag a publish moves in",
38
+ " place of latest. --lane <name> (or release.lane in",
39
+ " chant.config.ts) checks a ci.green lane's tag,",
40
+ " ci/green-<lane>/<sha>, in place of ci/green.",
41
+ " --override-green cuts a commit that is not green",
42
+ " under a person's override, recorded with chant",
43
+ " approve policy-override release-<sha12>; the cut",
44
+ " spends it and records who and why.",
45
+ " auto cuts the label release next computes, and every",
46
+ " labelled cut records the intent files it consumed.",
47
+ ],
48
+ usage: { order: 10, text: "release cut [<label>|auto [--pre <id>]] [--at <sha>] [--yes] [--build <command>] [--param <k=v>] [--image <component>=<repository>@sha256:<hex>] [--params-file <file>] [--src <dir>] [-o <file>] [--lexicon <name>] [--actor <name>] [--sign [<key file>]] [--channel <tag>] [--lane <name>] [--override-green] [--json]" },
49
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release doctor`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const doctorCommand: ReleaseCommandDoc;
@@ -0,0 +1,14 @@
1
+ /** `chant release doctor`: its entry in `chant --help` and the `release` usage line. */
2
+ export const doctorCommand = {
3
+ name: "doctor",
4
+ helpOrder: 70,
5
+ help: [
6
+ " release doctor [--json]",
7
+ " Before a cut, ask each release.publish target whether",
8
+ " a publish from here can succeed: credentials, OIDC,",
9
+ " npm trusted publishers and dist-tags, registry and",
10
+ " forge access. Says what it can't observe from here.",
11
+ " Exits 1 when a check fails.",
12
+ ],
13
+ usage: { order: 40, text: "release doctor [--json]" },
14
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release export`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const exportCommand: ReleaseCommandDoc;
@@ -0,0 +1,12 @@
1
+ /** `chant release export`: its entry in `chant --help` and the `release` usage line. */
2
+ export const exportCommand = {
3
+ name: "export",
4
+ helpOrder: 160,
5
+ help: [
6
+ " release export <label|digest> --env <env> [-o <dir>] [--json]",
7
+ " Write the files the release recorded for <env>, each",
8
+ " checked against its digest, at their recorded paths",
9
+ " under <dir> (default: here), for a deploy to read.",
10
+ ],
11
+ usage: { order: 140, text: "release export <label|digest> --env <env> [-o <dir>] [--json]" },
12
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release images`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const imagesCommand: ReleaseCommandDoc;
@@ -0,0 +1,13 @@
1
+ /** `chant release images`: its entry in `chant --help` and the `release` usage line. */
2
+ export const imagesCommand = {
3
+ name: "images",
4
+ helpOrder: 60,
5
+ help: [
6
+ " release images <label|digest> [--no-build] [-o <file>] [--json]",
7
+ " Build the images release.images declares again from",
8
+ " the release's commit, refuse one whose digest is not",
9
+ " the recorded one, and write the recorded digests to",
10
+ " the file CHANT_RELEASE_DIGESTS names for the build.",
11
+ ],
12
+ usage: { order: 50, text: "release images <label|digest> [--no-build] [-o <file>] [--json]" },
13
+ };
@@ -0,0 +1,8 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ export type { ReleaseCommandDoc } from "./types.js";
3
+ /** Every subcommand, alphabetically by file. */
4
+ export declare const RELEASE_COMMANDS: readonly ReleaseCommandDoc[];
5
+ /** The usage line `chant release` prints with a refusal: every subcommand's form, in usage order, after `chant `. */
6
+ export declare function releaseUsage(commands?: readonly ReleaseCommandDoc[]): string;
7
+ /** The Releases section's entries of `chant --help`, in help order, without a trailing newline. */
8
+ export declare function releaseHelp(commands?: readonly ReleaseCommandDoc[]): string;