@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.
- package/dist/action-pins.d.ts +2 -0
- package/dist/action-pins.js +3 -0
- package/dist/ci-detect.d.ts +13 -0
- package/dist/ci-detect.js +12 -0
- package/dist/ci-evidence-claims.d.ts +12 -0
- package/dist/ci-evidence-claims.js +12 -0
- package/dist/ci-system.d.ts +66 -0
- package/dist/ci-system.js +61 -0
- package/dist/cli/handlers/build.js +27 -0
- package/dist/cli/handlers/release-doctor.d.ts +12 -0
- package/dist/cli/handlers/release-doctor.js +118 -0
- package/dist/cli/handlers/release-init.d.ts +10 -0
- package/dist/cli/handlers/release-init.js +374 -0
- package/dist/cli/handlers/release.d.ts +43 -2
- package/dist/cli/handlers/release.js +667 -39
- package/dist/cli/handlers/run-generate.js +11 -0
- package/dist/cli/main.d.ts +2 -0
- package/dist/cli/main.js +44 -101
- package/dist/cli/parse-args.js +48 -0
- package/dist/cli/registry.d.ts +16 -0
- package/dist/cli/release-commands/artifacts.d.ts +3 -0
- package/dist/cli/release-commands/artifacts.js +14 -0
- package/dist/cli/release-commands/candidates.d.ts +3 -0
- package/dist/cli/release-commands/candidates.js +16 -0
- package/dist/cli/release-commands/changed.d.ts +3 -0
- package/dist/cli/release-commands/changed.js +14 -0
- package/dist/cli/release-commands/compose.d.ts +3 -0
- package/dist/cli/release-commands/compose.js +16 -0
- package/dist/cli/release-commands/cut.d.ts +3 -0
- package/dist/cli/release-commands/cut.js +50 -0
- package/dist/cli/release-commands/doctor.d.ts +3 -0
- package/dist/cli/release-commands/doctor.js +14 -0
- package/dist/cli/release-commands/export.d.ts +3 -0
- package/dist/cli/release-commands/export.js +12 -0
- package/dist/cli/release-commands/images.d.ts +3 -0
- package/dist/cli/release-commands/images.js +13 -0
- package/dist/cli/release-commands/index.d.ts +8 -0
- package/dist/cli/release-commands/index.js +52 -0
- package/dist/cli/release-commands/init.d.ts +3 -0
- package/dist/cli/release-commands/init.js +19 -0
- package/dist/cli/release-commands/list.d.ts +3 -0
- package/dist/cli/release-commands/list.js +10 -0
- package/dist/cli/release-commands/next.d.ts +3 -0
- package/dist/cli/release-commands/next.js +13 -0
- package/dist/cli/release-commands/publish.d.ts +3 -0
- package/dist/cli/release-commands/publish.js +22 -0
- package/dist/cli/release-commands/stamp.d.ts +3 -0
- package/dist/cli/release-commands/stamp.js +15 -0
- package/dist/cli/release-commands/status.d.ts +3 -0
- package/dist/cli/release-commands/status.js +17 -0
- package/dist/cli/release-commands/tag.d.ts +3 -0
- package/dist/cli/release-commands/tag.js +12 -0
- package/dist/cli/release-commands/types.d.ts +20 -0
- package/dist/cli/release-commands/types.js +1 -0
- package/dist/cli/release-commands/verify.d.ts +3 -0
- package/dist/cli/release-commands/verify.js +15 -0
- package/dist/cli/release-commands/workflow.d.ts +3 -0
- package/dist/cli/release-commands/workflow.js +15 -0
- package/dist/cloud-lister/index.d.ts +4 -1
- package/dist/cloud-lister/index.js +2 -1
- package/dist/cloud-lister/kubernetes-components.d.ts +56 -0
- package/dist/cloud-lister/kubernetes-components.js +642 -0
- package/dist/cloud-lister/kubernetes.d.ts +18 -0
- package/dist/cloud-lister/kubernetes.js +26 -1
- package/dist/cloud-lister/mask.d.ts +5 -1
- package/dist/cloud-lister/mask.js +14 -5
- package/dist/components/cli-support.d.ts +1 -1
- package/dist/components/cli-support.js +1 -1
- package/dist/config-environments.d.ts +8 -1
- package/dist/config-environments.js +2 -0
- package/dist/config-import.d.ts +1 -1
- package/dist/config-import.js +6 -2
- package/dist/config-sandbox.d.ts +1 -1
- package/dist/config-sandbox.js +3 -3
- package/dist/config.d.ts +369 -10
- package/dist/config.js +127 -7
- package/dist/deep-observation.js +9 -3
- package/dist/floor-table.data.js +21 -1
- package/dist/forge-remote.d.ts +13 -0
- package/dist/forge-remote.js +15 -0
- package/dist/lexicon.d.ts +45 -4
- package/dist/lifecycle/__fixtures__/package-files.d.ts +32 -0
- package/dist/lifecycle/__fixtures__/package-files.js +72 -0
- package/dist/lifecycle/__fixtures__/publish-fakes.d.ts +62 -0
- package/dist/lifecycle/__fixtures__/publish-fakes.js +275 -3
- package/dist/lifecycle/publish-attachments.d.ts +2 -1
- package/dist/lifecycle/publish-attachments.js +19 -2
- package/dist/lifecycle/publish-cargo.d.ts +99 -0
- package/dist/lifecycle/publish-cargo.js +412 -0
- package/dist/lifecycle/publish-credentials.d.ts +1 -1
- package/dist/lifecycle/publish-credentials.js +13 -0
- package/dist/lifecycle/publish-declaration.d.ts +322 -4
- package/dist/lifecycle/publish-declaration.js +340 -9
- package/dist/lifecycle/publish-forge.d.ts +45 -2
- package/dist/lifecycle/publish-forge.js +434 -34
- package/dist/lifecycle/publish-git-ssh.d.ts +15 -0
- package/dist/lifecycle/publish-git-ssh.js +30 -4
- package/dist/lifecycle/publish-github.d.ts +40 -2
- package/dist/lifecycle/publish-github.js +100 -3
- package/dist/lifecycle/publish-helm.d.ts +83 -0
- package/dist/lifecycle/publish-helm.js +452 -0
- package/dist/lifecycle/publish-homebrew.d.ts +7 -9
- package/dist/lifecycle/publish-homebrew.js +34 -197
- package/dist/lifecycle/publish-index.d.ts +141 -0
- package/dist/lifecycle/publish-index.js +719 -0
- package/dist/lifecycle/publish-marketplace.js +77 -0
- package/dist/lifecycle/publish-maven.d.ts +79 -0
- package/dist/lifecycle/publish-maven.js +364 -0
- package/dist/lifecycle/publish-mcp-registry.d.ts +66 -0
- package/dist/lifecycle/publish-mcp-registry.js +305 -0
- package/dist/lifecycle/publish-npm.d.ts +27 -1
- package/dist/lifecycle/publish-npm.js +216 -3
- package/dist/lifecycle/publish-nuget.d.ts +93 -0
- package/dist/lifecycle/publish-nuget.js +377 -0
- package/dist/lifecycle/publish-oci.d.ts +91 -2
- package/dist/lifecycle/publish-oci.js +247 -8
- package/dist/lifecycle/publish-package-files.d.ts +16 -0
- package/dist/lifecycle/publish-package-files.js +39 -0
- package/dist/lifecycle/publish-pypi.d.ts +138 -0
- package/dist/lifecycle/publish-pypi.js +657 -0
- package/dist/lifecycle/publish-record.d.ts +6 -3
- package/dist/lifecycle/publish-record.js +6 -3
- package/dist/lifecycle/publish-rubygems.d.ts +84 -0
- package/dist/lifecycle/publish-rubygems.js +366 -0
- package/dist/lifecycle/publish-signing.d.ts +147 -0
- package/dist/lifecycle/publish-signing.js +257 -0
- package/dist/lifecycle/publish-targets.d.ts +37 -1
- package/dist/lifecycle/publish-targets.js +102 -0
- package/dist/lifecycle/publish-tauri.js +43 -0
- package/dist/lifecycle/publish-train-names.d.ts +57 -0
- package/dist/lifecycle/publish-train-names.js +123 -0
- package/dist/lifecycle/publish-verify.d.ts +121 -0
- package/dist/lifecycle/publish-verify.js +130 -0
- package/dist/lifecycle/query.js +8 -0
- package/dist/lifecycle/release-artifacts.d.ts +290 -0
- package/dist/lifecycle/release-artifacts.js +808 -0
- package/dist/lifecycle/release-changelog.d.ts +13 -1
- package/dist/lifecycle/release-changelog.js +35 -2
- package/dist/lifecycle/release-cut.d.ts +64 -4
- package/dist/lifecycle/release-cut.js +147 -34
- package/dist/lifecycle/release-doctor.d.ts +113 -0
- package/dist/lifecycle/release-doctor.js +1198 -0
- package/dist/lifecycle/release-green.d.ts +86 -0
- package/dist/lifecycle/release-green.js +286 -0
- package/dist/lifecycle/release-init-registries.d.ts +48 -0
- package/dist/lifecycle/release-init-registries.js +97 -0
- package/dist/lifecycle/release-init.d.ts +275 -0
- package/dist/lifecycle/release-init.js +984 -0
- package/dist/lifecycle/release-intents.d.ts +73 -0
- package/dist/lifecycle/release-intents.js +128 -0
- package/dist/lifecycle/release-next.d.ts +111 -0
- package/dist/lifecycle/release-next.js +251 -0
- package/dist/lifecycle/release-prerelease.d.ts +19 -0
- package/dist/lifecycle/release-prerelease.js +30 -0
- package/dist/lifecycle/release-publish.d.ts +256 -10
- package/dist/lifecycle/release-publish.js +247 -35
- package/dist/lifecycle/release-status-change.d.ts +226 -0
- package/dist/lifecycle/release-status-change.js +478 -0
- package/dist/lifecycle/release-status.d.ts +11 -0
- package/dist/lifecycle/release-status.js +1 -1
- package/dist/lifecycle/release-store.d.ts +73 -2
- package/dist/lifecycle/release-store.js +32 -1
- package/dist/lifecycle/release-tag.d.ts +142 -0
- package/dist/lifecycle/release-tag.js +322 -0
- package/dist/lifecycle/release-verify.d.ts +73 -1
- package/dist/lifecycle/release-verify.js +117 -2
- package/dist/lifecycle/release-version-formats.d.ts +73 -0
- package/dist/lifecycle/release-version-formats.js +570 -0
- package/dist/lifecycle/release-version.d.ts +58 -10
- package/dist/lifecycle/release-version.js +164 -36
- package/dist/lifecycle/release-workstation.d.ts +3 -2
- package/dist/lifecycle/release-workstation.js +3 -2
- package/dist/op/generate-pipeline.js +1 -1
- package/dist/op/local-executor.d.ts +1 -1
- package/dist/op/local-executor.js +2 -2
- package/dist/op/op-waves-evidence.js +9 -2
- package/dist/pr-forge-base.js +4 -2
- package/dist/pr-forge.d.ts +20 -2
- package/dist/pr-forge.js +46 -10
- package/dist/release-floors.d.ts +8 -1
- package/dist/release-floors.js +9 -2
- package/dist/sensitive-key.d.ts +12 -0
- package/dist/sensitive-key.js +52 -0
- package/dist/tool-pins.d.ts +40 -0
- package/dist/tool-pins.js +66 -0
- package/dist/ts-loader.d.ts +8 -0
- package/dist/ts-loader.js +19 -0
- package/dist/wave-runtime.mjs +345 -342
- package/dist/workspace/ci-forge.d.ts +17 -0
- package/dist/workspace/ci-forge.js +17 -0
- package/dist/workspace/ci-init.js +1 -1
- package/dist/workspace/composites.schema.json +1 -0
- package/dist/workspace/declaration.d.ts +8 -0
- package/dist/workspace/declaration.js +12 -0
- package/dist/workspace/declaration.schema.json +8 -0
- package/dist/workspace/environments.d.ts +2 -0
- package/dist/workspace/environments.js +1 -1
- package/dist/workspace/identity-gate-rule.d.ts +61 -5
- package/dist/workspace/identity-gate-rule.js +81 -12
- package/dist/workspace/lexicon-outputs.d.ts +1 -1
- package/dist/workspace/lexicon-outputs.js +1 -1
- package/dist/workspace/member-pipeline.d.ts +2 -1
- package/dist/workspace/member-pipeline.js +5 -2
- package/dist/workspace/reason-codes.d.ts +2 -0
- package/dist/workspace/reason-codes.js +3 -1
- package/dist/workspace/release-changed.d.ts +75 -4
- package/dist/workspace/release-changed.js +205 -34
- package/dist/workspace/release-changed.schema.json +20 -2
- package/dist/workspace/release-steps/artifacts.d.ts +7 -0
- package/dist/workspace/release-steps/artifacts.js +45 -0
- package/dist/workspace/release-steps/builds.d.ts +12 -0
- package/dist/workspace/release-steps/builds.js +38 -0
- package/dist/workspace/release-steps/doctor.d.ts +8 -0
- package/dist/workspace/release-steps/doctor.js +14 -0
- package/dist/workspace/release-steps/goreleaser.d.ts +16 -0
- package/dist/workspace/release-steps/goreleaser.js +36 -0
- package/dist/workspace/release-steps/green.d.ts +3 -0
- package/dist/workspace/release-steps/green.js +6 -0
- package/dist/workspace/release-steps/images.d.ts +22 -0
- package/dist/workspace/release-steps/images.js +59 -0
- package/dist/workspace/release-steps/index.d.ts +9 -0
- package/dist/workspace/release-steps/index.js +50 -0
- package/dist/workspace/release-steps/nfpm.d.ts +13 -0
- package/dist/workspace/release-steps/nfpm.js +29 -0
- package/dist/workspace/release-steps/nuget.d.ts +14 -0
- package/dist/workspace/release-steps/nuget.js +16 -0
- package/dist/workspace/release-steps/pypi.d.ts +15 -0
- package/dist/workspace/release-steps/pypi.js +21 -0
- package/dist/workspace/release-steps/qemu.d.ts +21 -0
- package/dist/workspace/release-steps/qemu.js +35 -0
- package/dist/workspace/release-steps/signing.d.ts +18 -0
- package/dist/workspace/release-steps/signing.js +30 -0
- package/dist/workspace/release-steps/stamp.d.ts +3 -0
- package/dist/workspace/release-steps/stamp.js +4 -0
- package/dist/workspace/release-steps/targets.d.ts +31 -0
- package/dist/workspace/release-steps/targets.js +40 -0
- package/dist/workspace/release-steps/types.d.ts +104 -0
- package/dist/workspace/release-steps/types.js +2 -0
- package/dist/workspace/release-steps/verify.d.ts +3 -0
- package/dist/workspace/release-steps/verify.js +4 -0
- package/dist/workspace/release-toolchains.d.ts +59 -0
- package/dist/workspace/release-toolchains.js +133 -0
- package/dist/workspace/release-train-workflow.d.ts +36 -0
- package/dist/workspace/release-train-workflow.js +121 -0
- package/dist/workspace/release-train.d.ts +3 -1
- package/dist/workspace/release-train.js +20 -3
- package/dist/workspace/release-workflow.d.ts +183 -59
- package/dist/workspace/release-workflow.js +570 -201
- package/dist/workspace/releases.schema.json +70 -1
- package/dist/workspace/search-contract.d.ts +1 -1
- package/dist/workspace/security.js +9 -2
- package/dist/workspace/train-cut.d.ts +182 -0
- package/dist/workspace/train-cut.js +504 -0
- package/dist/workspace/train-prepare.d.ts +64 -0
- package/dist/workspace/train-prepare.js +313 -0
- package/dist/workspace/train-publish.d.ts +177 -0
- package/dist/workspace/train-publish.js +574 -0
- package/dist/workspace/train-range-labels.d.ts +33 -0
- package/dist/workspace/train-range-labels.js +109 -0
- package/dist/workspace/train-shell.d.ts +5 -0
- package/dist/workspace/train-shell.js +17 -0
- package/dist/workspace/trust/check-evidence-report.d.ts +3 -7
- package/dist/workspace/trust/check-evidence-report.js +3 -7
- package/dist/workspace/trust/seal.d.ts +13 -3
- package/dist/workspace/trust/seal.js +14 -4
- package/dist/workspace/work-cli.d.ts +3 -2
- package/dist/workspace/work-cli.js +3 -2
- package/dist/workspace/workspace-ledger.d.ts +14 -1
- package/dist/workspace/workspace-ledger.js +33 -7
- 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,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,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,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,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,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,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,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,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,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;
|