@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
@@ -0,0 +1,52 @@
1
+ /**
2
+ * Every `chant release` subcommand's help entry and usage form (#5196),
3
+ * one file each. The usage line and the Releases section of `chant --help`
4
+ * are built from these, in each entry's order, so adding a subcommand adds a
5
+ * file here and one line to the list below, kept in alphabetical order.
6
+ */
7
+ import { artifactsCommand } from "./artifacts.js";
8
+ import { candidatesCommand } from "./candidates.js";
9
+ import { changedCommand } from "./changed.js";
10
+ import { composeCommand } from "./compose.js";
11
+ import { cutCommand } from "./cut.js";
12
+ import { doctorCommand } from "./doctor.js";
13
+ import { exportCommand } from "./export.js";
14
+ import { imagesCommand } from "./images.js";
15
+ import { initCommand } from "./init.js";
16
+ import { listCommand } from "./list.js";
17
+ import { nextCommand } from "./next.js";
18
+ import { publishCommand } from "./publish.js";
19
+ import { stampCommand } from "./stamp.js";
20
+ import { statusCommand } from "./status.js";
21
+ import { tagCommand } from "./tag.js";
22
+ import { verifyCommand } from "./verify.js";
23
+ import { workflowCommand } from "./workflow.js";
24
+ /** Every subcommand, alphabetically by file. */
25
+ export const RELEASE_COMMANDS = [
26
+ artifactsCommand,
27
+ candidatesCommand,
28
+ changedCommand,
29
+ composeCommand,
30
+ cutCommand,
31
+ doctorCommand,
32
+ exportCommand,
33
+ imagesCommand,
34
+ initCommand,
35
+ listCommand,
36
+ nextCommand,
37
+ publishCommand,
38
+ stampCommand,
39
+ statusCommand,
40
+ tagCommand,
41
+ verifyCommand,
42
+ workflowCommand,
43
+ ];
44
+ /** The usage line `chant release` prints with a refusal: every subcommand's form, in usage order, after `chant `. */
45
+ export function releaseUsage(commands = RELEASE_COMMANDS) {
46
+ const forms = commands.filter((c) => c.usage !== undefined).sort((a, b) => a.usage.order - b.usage.order);
47
+ return `chant ${forms.map((c) => c.usage.text).join(" | ")}`;
48
+ }
49
+ /** The Releases section's entries of `chant --help`, in help order, without a trailing newline. */
50
+ export function releaseHelp(commands = RELEASE_COMMANDS) {
51
+ return [...commands].sort((a, b) => a.helpOrder - b.helpOrder).flatMap((c) => c.help).join("\n");
52
+ }
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release init`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const initCommand: ReleaseCommandDoc;
@@ -0,0 +1,16 @@
1
+ /** `chant release init`: its entry in `chant --help` and the `release` usage line. */
2
+ export const initCommand = {
3
+ name: "init",
4
+ helpOrder: 110,
5
+ help: [
6
+ " release init [--yes] [--force] [--one-release] [--forge github|gitlab|forgejo] [--json]",
7
+ " Set up chant release in a project: detect its packages,",
8
+ " images and tags, write release in chant.config.ts and",
9
+ " the release workflow, and list the registry steps to",
10
+ " take by hand. A workspace with several npm packages",
11
+ " gets a release train, a member per package, unless",
12
+ " --one-release. A dry run unless --yes; --force replaces",
13
+ " an existing release block.",
14
+ ],
15
+ usage: { order: 120, text: "release init [--yes] [--force] [--one-release] [--forge github|gitlab|forgejo] [--json]" },
16
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release list`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const listCommand: ReleaseCommandDoc;
@@ -0,0 +1,10 @@
1
+ /** `chant release list`: its entry in `chant --help` and the `release` usage line. */
2
+ export const listCommand = {
3
+ name: "list",
4
+ helpOrder: 150,
5
+ help: [
6
+ " release list [--json] Every release of this member with its targets, its",
7
+ " cuts and the environments that run it.",
8
+ ],
9
+ usage: { order: 110, text: "release list [--json]" },
10
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release next`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const nextCommand: ReleaseCommandDoc;
@@ -0,0 +1,13 @@
1
+ /** `chant release next`: its entry in `chant --help` and the `release` usage line. */
2
+ export const nextCommand = {
3
+ name: "next",
4
+ helpOrder: 130,
5
+ help: [
6
+ " release next [--at <sha>] [--pre <id>] [--json]",
7
+ " The label of this member's next release, from the",
8
+ " conventional commits since its previous release and",
9
+ " the .chant/release/*.md intent files no cut consumed.",
10
+ " --pre <id> makes it a prerelease, <version>-<id>.<n>.",
11
+ ],
12
+ usage: { order: 70, text: "release next [--at <sha>] [--pre <id>] [--json]" },
13
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release publish`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const publishCommand: ReleaseCommandDoc;
@@ -0,0 +1,22 @@
1
+ /** `chant release publish`: its entry in `chant --help` and the `release` usage line. */
2
+ export const publishCommand = {
3
+ name: "publish",
4
+ helpOrder: 40,
5
+ help: [
6
+ " release publish <label|digest> [--yes] [--allow-unsigned]",
7
+ " [--require-provenance] [--json]",
8
+ " Publish a cut release to the targets release.publish",
9
+ " in chant.config.ts declares (npm, OCI registries,",
10
+ " forge release assets), each with the release's",
11
+ " provenance and an SBOM when it has a source. A dry",
12
+ " run without --yes. Refuses a revoked release, and",
13
+ " with a target a checkout that is not the release's",
14
+ " commit. Under security verified-releases it refuses",
15
+ " one whose signature does not verify against",
16
+ " .chant/allowed_signers unless --allow-unsigned; under",
17
+ " supply-chain it warns when the run has no OIDC token",
18
+ " and refuses a target with no SBOM source.",
19
+ " --require-provenance refuses a run with no OIDC.",
20
+ ],
21
+ usage: { order: 20, text: "release publish <label|digest> [--yes] [--allow-unsigned] [--require-provenance] [--json]" },
22
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release stamp`: its entry in `chant --help`; the `release` usage line leaves it out. */
3
+ export declare const stampCommand: ReleaseCommandDoc;
@@ -0,0 +1,15 @@
1
+ /** `chant release stamp`: its entry in `chant --help`; the `release` usage line leaves it out. */
2
+ export const stampCommand = {
3
+ name: "stamp",
4
+ helpOrder: 90,
5
+ help: [
6
+ " release stamp <label> [--train <id|digest>] [--json]",
7
+ " Write the label as the version of each package.json",
8
+ " release.version names, and the lockfile's entries for",
9
+ " them, as the cut does before its build. The publish",
10
+ " job runs it before its build. With ranges set in",
11
+ " release.version, each workspace dependency's range",
12
+ " takes the label its package has; --train gives the",
13
+ " labels of the other members' packages from a train.",
14
+ ],
15
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release deprecate|yank|restore`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const statusCommand: ReleaseCommandDoc;
@@ -0,0 +1,17 @@
1
+ /** `chant release deprecate|yank|restore`: its entry in `chant --help` and the `release` usage line. */
2
+ export const statusCommand = {
3
+ name: "deprecate|yank|restore",
4
+ helpOrder: 170,
5
+ help: [
6
+ " release deprecate|yank|restore <label|digest> [--yes] [--reason <text>]",
7
+ " [--replacement <label>] [--forge-release prerelease|draft|delete]",
8
+ " [--actor <name>] [--sign [<key file>]] [--json]",
9
+ " Record a status for a published release and act on",
10
+ " each target that can: deprecate warns npm users; yank",
11
+ " also moves npm's dist-tag and the OCI moving tags back",
12
+ " to the previous active release, withdraws the forge",
13
+ " release and reverts a tap's formula; restore undoes",
14
+ " it. A dry run unless --yes; resumes like publish.",
15
+ ],
16
+ usage: { order: 150, text: "release deprecate|yank|restore <label|digest> [--yes] [--reason <text>] [--replacement <label>] [--forge-release prerelease|draft|delete] [--actor <name>] [--sign [<key file>]] [--json]" },
17
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release tag`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const tagCommand: ReleaseCommandDoc;
@@ -0,0 +1,12 @@
1
+ /** `chant release tag`: its entry in `chant --help` and the `release` usage line. */
2
+ export const tagCommand = {
3
+ name: "tag",
4
+ helpOrder: 100,
5
+ help: [
6
+ " release tag <label|digest|tag> [--json]",
7
+ " The tag release.tag gives a release of this member",
8
+ " (default release/<label>), found by its label, its",
9
+ " digest or the tag itself, with its floating tag.",
10
+ ],
11
+ usage: { order: 130, text: "release tag <label|digest|tag> [--json]" },
12
+ };
@@ -0,0 +1,20 @@
1
+ /**
2
+ * One `chant release` subcommand's words (#5196): its entry in the Releases
3
+ * section of `chant --help`, and its form in the usage line `chant release`
4
+ * prints on a mistake. Each subcommand has a file of its own in this
5
+ * directory, listed in ./index.ts, so a new subcommand adds a file and an
6
+ * import rather than editing a shared string.
7
+ */
8
+ export interface ReleaseCommandDoc {
9
+ /** The subcommand as the help names it: `cut`, `deprecate|yank|restore`. */
10
+ name: string;
11
+ /** Where the entry sits in `chant --help`: entries sort by it, lowest first. Leave gaps so a new one fits between two. */
12
+ helpOrder: number;
13
+ /** The entry's lines in `chant --help`, each as printed, indent included. */
14
+ help: readonly string[];
15
+ /** The subcommand's form in the `release` usage line, and where it sits there (lowest first). Absent: the usage line leaves it out. */
16
+ usage?: {
17
+ order: number;
18
+ text: string;
19
+ };
20
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release verify`: its entry in `chant --help` and the `release` usage line. */
3
+ export declare const verifyCommand: ReleaseCommandDoc;
@@ -0,0 +1,15 @@
1
+ /** `chant release verify`: its entry in `chant --help` and the `release` usage line. */
2
+ export const verifyCommand = {
3
+ name: "verify",
4
+ helpOrder: 50,
5
+ help: [
6
+ " release verify <label|digest> [--sigstore [--assets <dir>]] [--json]",
7
+ " Check, offline, that the release was signed by a key",
8
+ " .chant/allowed_signers lists at the release's commit.",
9
+ " --sigstore also checks the Sigstore signatures and",
10
+ " SLSA provenance the publish recorded, with cosign:",
11
+ " an image's in its registry, a forge release's in the",
12
+ " directory --assets names.",
13
+ ],
14
+ usage: { order: 30, text: "release verify <label|digest> [--sigstore [--assets <dir>]] [--json]" },
15
+ };
@@ -0,0 +1,3 @@
1
+ import type { ReleaseCommandDoc } from "./types.js";
2
+ /** `chant release workflow`: its entry in `chant --help`; the `release` usage line leaves it out. */
3
+ export declare const workflowCommand: ReleaseCommandDoc;
@@ -0,0 +1,13 @@
1
+ /** `chant release workflow`: its entry in `chant --help`; the `release` usage line leaves it out. */
2
+ export const workflowCommand = {
3
+ name: "workflow",
4
+ helpOrder: 120,
5
+ help: [
6
+ " release workflow [--forge github|gitlab|forgejo] [--install <command>]",
7
+ " [--build <command>] [--chant <command>] [--output <file>]",
8
+ " Write the publish workflow, run on the tags",
9
+ " release.tag makes (default release/**).",
10
+ " Under supply-chain it passes --require-provenance, and",
11
+ " under verified-releases it runs release verify first",
12
+ ],
13
+ };
@@ -192,7 +192,7 @@ function lexiconEntry(lexiconDir) {
192
192
  rel = root;
193
193
  else if (root && typeof root === "object") {
194
194
  const conds = root;
195
- rel = conds.development ?? conds.default ?? conds.import ?? rel;
195
+ rel = conds["@intentius/chant-source"] ?? conds.default ?? conds.import ?? rel;
196
196
  }
197
197
  if (typeof rel !== "string")
198
198
  return null;
@@ -120,7 +120,7 @@ export declare function isCapabilityPlugin(value: unknown): value is CapabilityP
120
120
  * on every `just release` — the aws plugin shipped `"1.0.0"` from the day it
121
121
  * was extracted from the starter set (#681), and the k8s plugin's authoring-
122
122
  * time `"0.41.0"` was stale one release later. Walking up from the module's
123
- * own URL survives both the `src/` (development condition) and `dist/`
123
+ * own URL survives both the `src/` (@intentius/chant-source condition) and `dist/`
124
124
  * layouts, and an npm install, without any build-time stamping.
125
125
  *
126
126
  * Returns `"0.0.0"` when no versioned `package.json` is found — a visible
@@ -60,7 +60,7 @@ export function isCapabilityPlugin(value) {
60
60
  * on every `just release` — the aws plugin shipped `"1.0.0"` from the day it
61
61
  * was extracted from the starter set (#681), and the k8s plugin's authoring-
62
62
  * time `"0.41.0"` was stale one release later. Walking up from the module's
63
- * own URL survives both the `src/` (development condition) and `dist/`
63
+ * own URL survives both the `src/` (@intentius/chant-source condition) and `dist/`
64
64
  * layouts, and an npm install, without any build-time stamping.
65
65
  *
66
66
  * Returns `"0.0.0"` when no versioned `package.json` is found — a visible
@@ -101,7 +101,7 @@ export interface ComponentGraphResult {
101
101
  }
102
102
  /** Compute the components' dependency graph under `path`, for `chant graph --components`. */
103
103
  export declare function computeComponentGraph(path: string, sandbox?: boolean, buildParams?: BuildParamProvenance[]): Promise<ComponentGraphResult>;
104
- /** A generate-mode target lexicon name — any lexicon whose plugin implements `generateComponentPipeline` (gitlab, github, and forgejo today). */
104
+ /** A generate-mode target lexicon name — any lexicon whose plugin implements `generateComponentPipeline` (gitlab, github, forgejo and prow today). */
105
105
  export type GenerateLexicon = string;
106
106
  /**
107
107
  * The components an "all" run takes, in `discovered` order (chant #1522). A
@@ -200,7 +200,7 @@ buildParams) {
200
200
  if (!plugin?.generateComponentPipeline) {
201
201
  return {
202
202
  success: false,
203
- error: `Lexicon "${lexicon}" does not support generate mode (no generateComponentPipeline). GitLab, GitHub, and Forgejo are supported today.`,
203
+ error: `Lexicon "${lexicon}" does not support generate mode (no generateComponentPipeline). GitLab, GitHub, Forgejo and Prow are supported today.`,
204
204
  };
205
205
  }
206
206
  const result = await discoverComponents(path, { sandbox, buildParams });
@@ -4,6 +4,7 @@
4
4
  * them. They import nothing at runtime, so ./components/pr-environment.ts and
5
5
  * ./live-endpoint.ts use them without bundling the config loader.
6
6
  */
7
+ import type { CiSystem } from "./ci-system.js";
7
8
  import type { ChantConfig } from "./config.js";
8
9
  /**
9
10
  * One project-declared environment (chant #1166). Historically always a bare
@@ -23,7 +24,9 @@ import type { ChantConfig } from "./config.js";
23
24
  * `executor` names the forge and the committed workflow that deploys the
24
25
  * environment (#4402), so a reader such as behold knows a release there runs
25
26
  * through CI rather than a local `chant run`. chant declares and prints it
26
- * (`chant workspace graph --composites`); it never dispatches it.
27
+ * (`chant workspace graph --composites`); it never dispatches it. Its `ci`
28
+ * names the CI system that runs the workflow when that is not the forge's
29
+ * own, such as `prow` for a GitHub repository (#5170).
27
30
  */
28
31
  export type EnvironmentDeclaration = string | {
29
32
  name: string;
@@ -33,9 +36,13 @@ export type EnvironmentDeclaration = string | {
33
36
  };
34
37
  /** The forges an environment's executor can name (#4402). */
35
38
  export declare const EXECUTOR_FORGES: readonly ["github", "gitlab", "forgejo"];
39
+ /** The CI systems an environment's executor can name (#5170), as `CI_SYSTEMS` in ./ci-system.ts lists them. */
40
+ export declare const EXECUTOR_CI_SYSTEMS: readonly ["github", "gitlab", "forgejo", "prow"];
36
41
  /** The forge workflow that deploys one environment (#4402). */
37
42
  export interface EnvironmentExecutor {
38
43
  forge: (typeof EXECUTOR_FORGES)[number];
44
+ /** The CI system that runs `workflow` (#5170). Absent, the forge's own: GitHub Actions, GitLab CI or Forgejo Actions. `prow` runs a GitHub repository's jobs, and `workflow` is then the job config file Prow loads. */
45
+ ci?: CiSystem;
39
46
  /** The committed workflow file the forge runs, such as `deploy-prod.yml` under `.github/workflows/`, or `.gitlab-ci.yml`. */
40
47
  workflow: string;
41
48
  }
@@ -6,6 +6,8 @@
6
6
  */
7
7
  /** The forges an environment's executor can name (#4402). */
8
8
  export const EXECUTOR_FORGES = ["github", "gitlab", "forgejo"];
9
+ /** The CI systems an environment's executor can name (#5170), as `CI_SYSTEMS` in ./ci-system.ts lists them. */
10
+ export const EXECUTOR_CI_SYSTEMS = ["github", "gitlab", "forgejo", "prow"];
9
11
  /** The declared name of one `environments` entry, whichever form it takes. */
10
12
  export function environmentName(entry) {
11
13
  return typeof entry === "string" ? entry : entry.name;