@intentius/chant 0.124.100 → 0.124.102

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 (270) hide show
  1. package/dist/action-pins.d.ts +2 -0
  2. package/dist/action-pins.js +3 -0
  3. package/dist/ci-detect.d.ts +13 -0
  4. package/dist/ci-detect.js +12 -0
  5. package/dist/ci-evidence-claims.d.ts +12 -0
  6. package/dist/ci-evidence-claims.js +12 -0
  7. package/dist/ci-system.d.ts +66 -0
  8. package/dist/ci-system.js +61 -0
  9. package/dist/cli/handlers/build.js +27 -0
  10. package/dist/cli/handlers/release-doctor.d.ts +12 -0
  11. package/dist/cli/handlers/release-doctor.js +118 -0
  12. package/dist/cli/handlers/release-init.d.ts +10 -0
  13. package/dist/cli/handlers/release-init.js +374 -0
  14. package/dist/cli/handlers/release.d.ts +43 -2
  15. package/dist/cli/handlers/release.js +667 -39
  16. package/dist/cli/handlers/run-generate.js +11 -0
  17. package/dist/cli/main.d.ts +2 -0
  18. package/dist/cli/main.js +44 -101
  19. package/dist/cli/parse-args.js +48 -0
  20. package/dist/cli/registry.d.ts +16 -0
  21. package/dist/cli/release-commands/artifacts.d.ts +3 -0
  22. package/dist/cli/release-commands/artifacts.js +14 -0
  23. package/dist/cli/release-commands/candidates.d.ts +3 -0
  24. package/dist/cli/release-commands/candidates.js +16 -0
  25. package/dist/cli/release-commands/changed.d.ts +3 -0
  26. package/dist/cli/release-commands/changed.js +14 -0
  27. package/dist/cli/release-commands/compose.d.ts +3 -0
  28. package/dist/cli/release-commands/compose.js +16 -0
  29. package/dist/cli/release-commands/cut.d.ts +3 -0
  30. package/dist/cli/release-commands/cut.js +50 -0
  31. package/dist/cli/release-commands/doctor.d.ts +3 -0
  32. package/dist/cli/release-commands/doctor.js +14 -0
  33. package/dist/cli/release-commands/export.d.ts +3 -0
  34. package/dist/cli/release-commands/export.js +12 -0
  35. package/dist/cli/release-commands/images.d.ts +3 -0
  36. package/dist/cli/release-commands/images.js +13 -0
  37. package/dist/cli/release-commands/index.d.ts +8 -0
  38. package/dist/cli/release-commands/index.js +52 -0
  39. package/dist/cli/release-commands/init.d.ts +3 -0
  40. package/dist/cli/release-commands/init.js +19 -0
  41. package/dist/cli/release-commands/list.d.ts +3 -0
  42. package/dist/cli/release-commands/list.js +10 -0
  43. package/dist/cli/release-commands/next.d.ts +3 -0
  44. package/dist/cli/release-commands/next.js +13 -0
  45. package/dist/cli/release-commands/publish.d.ts +3 -0
  46. package/dist/cli/release-commands/publish.js +22 -0
  47. package/dist/cli/release-commands/stamp.d.ts +3 -0
  48. package/dist/cli/release-commands/stamp.js +15 -0
  49. package/dist/cli/release-commands/status.d.ts +3 -0
  50. package/dist/cli/release-commands/status.js +17 -0
  51. package/dist/cli/release-commands/tag.d.ts +3 -0
  52. package/dist/cli/release-commands/tag.js +12 -0
  53. package/dist/cli/release-commands/types.d.ts +20 -0
  54. package/dist/cli/release-commands/types.js +1 -0
  55. package/dist/cli/release-commands/verify.d.ts +3 -0
  56. package/dist/cli/release-commands/verify.js +15 -0
  57. package/dist/cli/release-commands/workflow.d.ts +3 -0
  58. package/dist/cli/release-commands/workflow.js +15 -0
  59. package/dist/cloud-lister/index.d.ts +4 -1
  60. package/dist/cloud-lister/index.js +2 -1
  61. package/dist/cloud-lister/kubernetes-components.d.ts +56 -0
  62. package/dist/cloud-lister/kubernetes-components.js +642 -0
  63. package/dist/cloud-lister/kubernetes.d.ts +18 -0
  64. package/dist/cloud-lister/kubernetes.js +26 -1
  65. package/dist/cloud-lister/mask.d.ts +5 -1
  66. package/dist/cloud-lister/mask.js +14 -5
  67. package/dist/components/cli-support.d.ts +1 -1
  68. package/dist/components/cli-support.js +1 -1
  69. package/dist/config-environments.d.ts +8 -1
  70. package/dist/config-environments.js +2 -0
  71. package/dist/config-import.d.ts +1 -1
  72. package/dist/config-import.js +6 -2
  73. package/dist/config-sandbox.d.ts +1 -1
  74. package/dist/config-sandbox.js +3 -3
  75. package/dist/config.d.ts +369 -10
  76. package/dist/config.js +127 -7
  77. package/dist/deep-observation.js +9 -3
  78. package/dist/floor-table.data.js +21 -1
  79. package/dist/forge-remote.d.ts +13 -0
  80. package/dist/forge-remote.js +15 -0
  81. package/dist/lexicon.d.ts +45 -4
  82. package/dist/lifecycle/__fixtures__/package-files.d.ts +32 -0
  83. package/dist/lifecycle/__fixtures__/package-files.js +72 -0
  84. package/dist/lifecycle/__fixtures__/publish-fakes.d.ts +62 -0
  85. package/dist/lifecycle/__fixtures__/publish-fakes.js +275 -3
  86. package/dist/lifecycle/publish-attachments.d.ts +2 -1
  87. package/dist/lifecycle/publish-attachments.js +19 -2
  88. package/dist/lifecycle/publish-cargo.d.ts +99 -0
  89. package/dist/lifecycle/publish-cargo.js +412 -0
  90. package/dist/lifecycle/publish-credentials.d.ts +1 -1
  91. package/dist/lifecycle/publish-credentials.js +13 -0
  92. package/dist/lifecycle/publish-declaration.d.ts +322 -4
  93. package/dist/lifecycle/publish-declaration.js +340 -9
  94. package/dist/lifecycle/publish-forge.d.ts +45 -2
  95. package/dist/lifecycle/publish-forge.js +434 -34
  96. package/dist/lifecycle/publish-git-ssh.d.ts +15 -0
  97. package/dist/lifecycle/publish-git-ssh.js +30 -4
  98. package/dist/lifecycle/publish-github.d.ts +40 -2
  99. package/dist/lifecycle/publish-github.js +100 -3
  100. package/dist/lifecycle/publish-helm.d.ts +83 -0
  101. package/dist/lifecycle/publish-helm.js +452 -0
  102. package/dist/lifecycle/publish-homebrew.d.ts +7 -9
  103. package/dist/lifecycle/publish-homebrew.js +34 -197
  104. package/dist/lifecycle/publish-index.d.ts +141 -0
  105. package/dist/lifecycle/publish-index.js +719 -0
  106. package/dist/lifecycle/publish-marketplace.js +77 -0
  107. package/dist/lifecycle/publish-maven.d.ts +79 -0
  108. package/dist/lifecycle/publish-maven.js +364 -0
  109. package/dist/lifecycle/publish-mcp-registry.d.ts +66 -0
  110. package/dist/lifecycle/publish-mcp-registry.js +305 -0
  111. package/dist/lifecycle/publish-npm.d.ts +27 -1
  112. package/dist/lifecycle/publish-npm.js +216 -3
  113. package/dist/lifecycle/publish-nuget.d.ts +93 -0
  114. package/dist/lifecycle/publish-nuget.js +377 -0
  115. package/dist/lifecycle/publish-oci.d.ts +91 -2
  116. package/dist/lifecycle/publish-oci.js +247 -8
  117. package/dist/lifecycle/publish-package-files.d.ts +16 -0
  118. package/dist/lifecycle/publish-package-files.js +39 -0
  119. package/dist/lifecycle/publish-pypi.d.ts +138 -0
  120. package/dist/lifecycle/publish-pypi.js +657 -0
  121. package/dist/lifecycle/publish-record.d.ts +6 -3
  122. package/dist/lifecycle/publish-record.js +6 -3
  123. package/dist/lifecycle/publish-rubygems.d.ts +84 -0
  124. package/dist/lifecycle/publish-rubygems.js +366 -0
  125. package/dist/lifecycle/publish-signing.d.ts +147 -0
  126. package/dist/lifecycle/publish-signing.js +257 -0
  127. package/dist/lifecycle/publish-targets.d.ts +37 -1
  128. package/dist/lifecycle/publish-targets.js +102 -0
  129. package/dist/lifecycle/publish-tauri.js +43 -0
  130. package/dist/lifecycle/publish-train-names.d.ts +57 -0
  131. package/dist/lifecycle/publish-train-names.js +123 -0
  132. package/dist/lifecycle/publish-verify.d.ts +121 -0
  133. package/dist/lifecycle/publish-verify.js +130 -0
  134. package/dist/lifecycle/query.js +8 -0
  135. package/dist/lifecycle/release-artifacts.d.ts +290 -0
  136. package/dist/lifecycle/release-artifacts.js +808 -0
  137. package/dist/lifecycle/release-changelog.d.ts +13 -1
  138. package/dist/lifecycle/release-changelog.js +35 -2
  139. package/dist/lifecycle/release-cut.d.ts +64 -4
  140. package/dist/lifecycle/release-cut.js +147 -34
  141. package/dist/lifecycle/release-doctor.d.ts +113 -0
  142. package/dist/lifecycle/release-doctor.js +1198 -0
  143. package/dist/lifecycle/release-green.d.ts +86 -0
  144. package/dist/lifecycle/release-green.js +286 -0
  145. package/dist/lifecycle/release-init-registries.d.ts +48 -0
  146. package/dist/lifecycle/release-init-registries.js +97 -0
  147. package/dist/lifecycle/release-init.d.ts +275 -0
  148. package/dist/lifecycle/release-init.js +984 -0
  149. package/dist/lifecycle/release-intents.d.ts +73 -0
  150. package/dist/lifecycle/release-intents.js +128 -0
  151. package/dist/lifecycle/release-next.d.ts +111 -0
  152. package/dist/lifecycle/release-next.js +251 -0
  153. package/dist/lifecycle/release-prerelease.d.ts +19 -0
  154. package/dist/lifecycle/release-prerelease.js +30 -0
  155. package/dist/lifecycle/release-publish.d.ts +256 -10
  156. package/dist/lifecycle/release-publish.js +247 -35
  157. package/dist/lifecycle/release-status-change.d.ts +226 -0
  158. package/dist/lifecycle/release-status-change.js +478 -0
  159. package/dist/lifecycle/release-status.d.ts +11 -0
  160. package/dist/lifecycle/release-status.js +1 -1
  161. package/dist/lifecycle/release-store.d.ts +73 -2
  162. package/dist/lifecycle/release-store.js +32 -1
  163. package/dist/lifecycle/release-tag.d.ts +142 -0
  164. package/dist/lifecycle/release-tag.js +322 -0
  165. package/dist/lifecycle/release-verify.d.ts +73 -1
  166. package/dist/lifecycle/release-verify.js +117 -2
  167. package/dist/lifecycle/release-version-formats.d.ts +73 -0
  168. package/dist/lifecycle/release-version-formats.js +570 -0
  169. package/dist/lifecycle/release-version.d.ts +58 -10
  170. package/dist/lifecycle/release-version.js +164 -36
  171. package/dist/lifecycle/release-workstation.d.ts +3 -2
  172. package/dist/lifecycle/release-workstation.js +3 -2
  173. package/dist/op/generate-pipeline.js +1 -1
  174. package/dist/op/local-executor.d.ts +1 -1
  175. package/dist/op/local-executor.js +2 -2
  176. package/dist/op/op-waves-evidence.js +9 -2
  177. package/dist/pr-forge-base.js +4 -2
  178. package/dist/pr-forge.d.ts +20 -2
  179. package/dist/pr-forge.js +46 -10
  180. package/dist/release-floors.d.ts +8 -1
  181. package/dist/release-floors.js +9 -2
  182. package/dist/sensitive-key.d.ts +12 -0
  183. package/dist/sensitive-key.js +52 -0
  184. package/dist/tool-pins.d.ts +40 -0
  185. package/dist/tool-pins.js +66 -0
  186. package/dist/ts-loader.d.ts +8 -0
  187. package/dist/ts-loader.js +19 -0
  188. package/dist/wave-runtime.mjs +345 -342
  189. package/dist/workspace/ci-forge.d.ts +17 -0
  190. package/dist/workspace/ci-forge.js +17 -0
  191. package/dist/workspace/ci-init.js +1 -1
  192. package/dist/workspace/composites.schema.json +1 -0
  193. package/dist/workspace/declaration.d.ts +8 -0
  194. package/dist/workspace/declaration.js +12 -0
  195. package/dist/workspace/declaration.schema.json +8 -0
  196. package/dist/workspace/environments.d.ts +2 -0
  197. package/dist/workspace/environments.js +1 -1
  198. package/dist/workspace/identity-gate-rule.d.ts +61 -5
  199. package/dist/workspace/identity-gate-rule.js +81 -12
  200. package/dist/workspace/lexicon-outputs.d.ts +1 -1
  201. package/dist/workspace/lexicon-outputs.js +1 -1
  202. package/dist/workspace/member-pipeline.d.ts +2 -1
  203. package/dist/workspace/member-pipeline.js +5 -2
  204. package/dist/workspace/reason-codes.d.ts +2 -0
  205. package/dist/workspace/reason-codes.js +3 -1
  206. package/dist/workspace/release-changed.d.ts +75 -4
  207. package/dist/workspace/release-changed.js +205 -34
  208. package/dist/workspace/release-changed.schema.json +20 -2
  209. package/dist/workspace/release-steps/artifacts.d.ts +7 -0
  210. package/dist/workspace/release-steps/artifacts.js +45 -0
  211. package/dist/workspace/release-steps/builds.d.ts +12 -0
  212. package/dist/workspace/release-steps/builds.js +38 -0
  213. package/dist/workspace/release-steps/doctor.d.ts +8 -0
  214. package/dist/workspace/release-steps/doctor.js +14 -0
  215. package/dist/workspace/release-steps/goreleaser.d.ts +16 -0
  216. package/dist/workspace/release-steps/goreleaser.js +36 -0
  217. package/dist/workspace/release-steps/green.d.ts +3 -0
  218. package/dist/workspace/release-steps/green.js +6 -0
  219. package/dist/workspace/release-steps/images.d.ts +22 -0
  220. package/dist/workspace/release-steps/images.js +59 -0
  221. package/dist/workspace/release-steps/index.d.ts +9 -0
  222. package/dist/workspace/release-steps/index.js +50 -0
  223. package/dist/workspace/release-steps/nfpm.d.ts +13 -0
  224. package/dist/workspace/release-steps/nfpm.js +29 -0
  225. package/dist/workspace/release-steps/nuget.d.ts +14 -0
  226. package/dist/workspace/release-steps/nuget.js +16 -0
  227. package/dist/workspace/release-steps/pypi.d.ts +15 -0
  228. package/dist/workspace/release-steps/pypi.js +21 -0
  229. package/dist/workspace/release-steps/qemu.d.ts +21 -0
  230. package/dist/workspace/release-steps/qemu.js +35 -0
  231. package/dist/workspace/release-steps/signing.d.ts +18 -0
  232. package/dist/workspace/release-steps/signing.js +30 -0
  233. package/dist/workspace/release-steps/stamp.d.ts +3 -0
  234. package/dist/workspace/release-steps/stamp.js +4 -0
  235. package/dist/workspace/release-steps/targets.d.ts +31 -0
  236. package/dist/workspace/release-steps/targets.js +40 -0
  237. package/dist/workspace/release-steps/types.d.ts +104 -0
  238. package/dist/workspace/release-steps/types.js +2 -0
  239. package/dist/workspace/release-steps/verify.d.ts +3 -0
  240. package/dist/workspace/release-steps/verify.js +4 -0
  241. package/dist/workspace/release-toolchains.d.ts +59 -0
  242. package/dist/workspace/release-toolchains.js +133 -0
  243. package/dist/workspace/release-train-workflow.d.ts +36 -0
  244. package/dist/workspace/release-train-workflow.js +121 -0
  245. package/dist/workspace/release-train.d.ts +3 -1
  246. package/dist/workspace/release-train.js +20 -3
  247. package/dist/workspace/release-workflow.d.ts +183 -59
  248. package/dist/workspace/release-workflow.js +570 -201
  249. package/dist/workspace/releases.schema.json +70 -1
  250. package/dist/workspace/search-contract.d.ts +1 -1
  251. package/dist/workspace/security.js +9 -2
  252. package/dist/workspace/train-cut.d.ts +182 -0
  253. package/dist/workspace/train-cut.js +504 -0
  254. package/dist/workspace/train-prepare.d.ts +64 -0
  255. package/dist/workspace/train-prepare.js +313 -0
  256. package/dist/workspace/train-publish.d.ts +177 -0
  257. package/dist/workspace/train-publish.js +574 -0
  258. package/dist/workspace/train-range-labels.d.ts +33 -0
  259. package/dist/workspace/train-range-labels.js +109 -0
  260. package/dist/workspace/train-shell.d.ts +5 -0
  261. package/dist/workspace/train-shell.js +17 -0
  262. package/dist/workspace/trust/check-evidence-report.d.ts +3 -7
  263. package/dist/workspace/trust/check-evidence-report.js +3 -7
  264. package/dist/workspace/trust/seal.d.ts +13 -3
  265. package/dist/workspace/trust/seal.js +14 -4
  266. package/dist/workspace/work-cli.d.ts +3 -2
  267. package/dist/workspace/work-cli.js +3 -2
  268. package/dist/workspace/workspace-ledger.d.ts +14 -1
  269. package/dist/workspace/workspace-ledger.js +33 -7
  270. package/package.json +1 -1
@@ -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,19 @@
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 (chant.config.json when tsx is not",
11
+ " installed). A workflow that runs npm publish becomes",
12
+ " the release workflow, so npm's trusted publisher",
13
+ " keeps naming it. A workspace with several npm packages",
14
+ " gets a release train, a member per package, unless",
15
+ " --one-release. A dry run unless --yes; --force replaces",
16
+ " an existing release block.",
17
+ ],
18
+ usage: { order: 120, text: "release init [--yes] [--force] [--one-release] [--forge github|gitlab|forgejo] [--json]" },
19
+ };
@@ -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,15 @@
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>] [--force]",
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
+ " A file there that chant did not write is replaced",
13
+ " only with --force",
14
+ ],
15
+ };
@@ -29,11 +29,14 @@ export type { AwsTarget } from "./aws.js";
29
29
  export type { AzureTarget } from "./azure.js";
30
30
  export type { GcpTarget } from "./gcp.js";
31
31
  export type { KubernetesTarget } from "./kubernetes.js";
32
- export { kubeTargetFromKubeconfig } from "./kubernetes.js";
32
+ export { kubeTargetFromKubeconfig, workloadStatusView } from "./kubernetes.js";
33
+ export type { WorkloadStatus } from "./kubernetes.js";
33
34
  export { ListerConfigError } from "./credentials.js";
34
35
  export { MutatingCallRefused, READ_OPERATIONS } from "./guard.js";
35
36
  export { OriginRefused } from "./transport.js";
36
37
  export { listedNodeId, parseListedNodeId } from "./ids.js";
38
+ export { inferK8sComponents, serviceNamesIn, K8S_COMPONENTS_FLOOR } from "./kubernetes-components.js";
39
+ export type { InferredK8sComponents, K8sBoundary, K8sComponentMember, K8sMemberRole, K8sComponentStatus, K8sOutsideName, K8sSharedObject } from "./kubernetes-components.js";
37
40
  /** Where and how to reach the scope's substrate. The variant must match `scope.substrate`. */
38
41
  export type SubstrateTarget = {
39
42
  substrate: "aws";
@@ -24,11 +24,12 @@ import { listGcp } from "./gcp.js";
24
24
  import { listKubernetes } from "./kubernetes.js";
25
25
  import { sdkCredentialChains } from "./credentials.js";
26
26
  import { Transport } from "./transport.js";
27
- export { kubeTargetFromKubeconfig } from "./kubernetes.js";
27
+ export { kubeTargetFromKubeconfig, workloadStatusView } from "./kubernetes.js";
28
28
  export { ListerConfigError } from "./credentials.js";
29
29
  export { MutatingCallRefused, READ_OPERATIONS } from "./guard.js";
30
30
  export { OriginRefused } from "./transport.js";
31
31
  export { listedNodeId, parseListedNodeId } from "./ids.js";
32
+ export { inferK8sComponents, serviceNamesIn, K8S_COMPONENTS_FLOOR } from "./kubernetes-components.js";
32
33
  function sortedUnique(values) {
33
34
  if (values === "*")
34
35
  return "*";
@@ -0,0 +1,56 @@
1
+ import type { GraphIR } from "../graph-ir.js";
2
+ /** The first chant with `inferK8sComponents`, the applications of a live Kubernetes read as a component graph (#5252). */
3
+ export declare const K8S_COMPONENTS_FLOOR = "0.124.102";
4
+ /** What a member is to its application, so a reader can fold without knowing Kubernetes kinds. */
5
+ export type K8sMemberRole = "workload" | "runtime" | "service" | "route" | "policy" | "config" | "storage" | "identity" | "bookkeeping";
6
+ export interface K8sComponentMember {
7
+ /** The node id in the read's graph. */
8
+ id: string;
9
+ role: K8sMemberRole;
10
+ }
11
+ /** A name a member gives for something outside the cluster: a cloud identity or a cloud secret. */
12
+ export interface K8sOutsideName {
13
+ /** The node id that names it. */
14
+ from: string;
15
+ /** Where: an annotation key, or `remoteRef.key`. */
16
+ key: string;
17
+ value: string;
18
+ }
19
+ /** How an application's boundary was drawn. `workload`: no label named a unit, so it is one workload. */
20
+ export interface K8sBoundary {
21
+ by: "part-of" | "argocd" | "helm" | "instance" | "chant" | "workload";
22
+ value: string;
23
+ }
24
+ /**
25
+ * An application's health, from the lister's `workloadStatus` views: ready
26
+ * over desired replicas summed over its workloads (a bare Pod counts as one),
27
+ * absent when none of them has replica counts (a CronJob, a Job), and the
28
+ * restarts summed over every Pod they run.
29
+ */
30
+ export interface K8sComponentStatus {
31
+ readyReplicas?: number;
32
+ desiredReplicas?: number;
33
+ restarts: number;
34
+ }
35
+ /** An object two or more applications use. */
36
+ export interface K8sSharedObject {
37
+ id: string;
38
+ role: K8sMemberRole;
39
+ /** The applications that use it, sorted. */
40
+ usedBy: string[];
41
+ outside?: K8sOutsideName[];
42
+ }
43
+ export interface InferredK8sComponents {
44
+ /** The component graph, in `chant graph --components --format ir`'s shape. */
45
+ ir: GraphIR;
46
+ shared: K8sSharedObject[];
47
+ notes: string[];
48
+ }
49
+ /**
50
+ * The Services a string names: `[namespace, name]` for each cluster DNS name
51
+ * in it, and the bare name in `ns` when the whole string is a name, a
52
+ * `name:port` or a URL whose host is the name. Exported for tests.
53
+ */
54
+ export declare function serviceNamesIn(value: string, ns: string): Array<[string, string]>;
55
+ /** Infer the applications of a live Kubernetes read (an `IndexDocument`'s `graph`). */
56
+ export declare function inferK8sComponents(graph: Pick<GraphIR, "nodes">): InferredK8sComponents;