@intentius/chant 0.124.100 → 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.
- 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-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 +342 -0
- package/dist/cli/handlers/release.d.ts +42 -1
- package/dist/cli/handlers/release.js +656 -31
- 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 +49 -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 +16 -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 +13 -0
- 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.d.ts +294 -9
- package/dist/config.js +100 -5
- package/dist/floor-table.data.js +15 -1
- package/dist/forge-remote.d.ts +13 -0
- package/dist/forge-remote.js +15 -0
- package/dist/lexicon.d.ts +41 -2
- package/dist/lifecycle/__fixtures__/publish-fakes.d.ts +62 -0
- package/dist/lifecycle/__fixtures__/publish-fakes.js +270 -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 +8 -0
- package/dist/lifecycle/publish-declaration.d.ts +199 -4
- package/dist/lifecycle/publish-declaration.js +200 -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-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-mcp-registry.d.ts +66 -0
- package/dist/lifecycle/publish-mcp-registry.js +306 -0
- package/dist/lifecycle/publish-npm.js +165 -2
- package/dist/lifecycle/publish-oci.d.ts +34 -1
- package/dist/lifecycle/publish-oci.js +246 -7
- package/dist/lifecycle/publish-pypi.d.ts +136 -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-signing.d.ts +147 -0
- package/dist/lifecycle/publish-signing.js +257 -0
- package/dist/lifecycle/publish-targets.d.ts +27 -1
- package/dist/lifecycle/publish-targets.js +80 -0
- package/dist/lifecycle/publish-tauri.js +43 -0
- package/dist/lifecycle/publish-train-names.d.ts +54 -0
- package/dist/lifecycle/publish-train-names.js +118 -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 +212 -0
- package/dist/lifecycle/release-artifacts.js +571 -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 +58 -3
- package/dist/lifecycle/release-cut.js +132 -34
- package/dist/lifecycle/release-doctor.d.ts +113 -0
- package/dist/lifecycle/release-doctor.js +996 -0
- package/dist/lifecycle/release-green.d.ts +86 -0
- package/dist/lifecycle/release-green.js +286 -0
- package/dist/lifecycle/release-init.d.ts +255 -0
- package/dist/lifecycle/release-init.js +859 -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 +252 -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 +246 -34
- 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 +323 -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/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/tool-pins.d.ts +38 -0
- package/dist/tool-pins.js +54 -0
- package/dist/wave-runtime.mjs +337 -334
- 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/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 +46 -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 +29 -0
- package/dist/workspace/release-train-workflow.js +85 -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 +160 -61
- package/dist/workspace/release-workflow.js +539 -193
- 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 +482 -0
- package/dist/workspace/train-prepare.d.ts +61 -0
- package/dist/workspace/train-prepare.js +267 -0
- package/dist/workspace/train-publish.d.ts +177 -0
- package/dist/workspace/train-publish.js +575 -0
- package/dist/workspace/train-range-labels.d.ts +33 -0
- package/dist/workspace/train-range-labels.js +109 -0
- 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,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,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,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
|
+
};
|
|
@@ -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
|
|
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
|
|
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;
|