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