@theholocron/cli 5.0.0-alpha.107 → 5.0.0-alpha.109

package/README.md

@@ -296,6 +296,23 @@ job execute the same thing — at a turbo root both are
 `turbo run test -- --coverage` (the registry's org-default flags flow through
 turbo's `--`).
 
+### `holocron deploy-on-release`
+
+```bash
+holocron deploy-on-release [--channel <alpha|main>] [--from <commit>] [--to <commit>] [--dry-run]
+```
+
+Deploys every workspace package whose own `holocron.config` declares
+`{ name: "delivery.deploy", with: { on: "release" } }` (holocron#930), when the
+release (`--channel`: its prerelease identifier, or `main`/empty for a stable
+release) is on the task's `channel` (default `main`, the stable release) and changes the package or one of its
+`workspace:*` dependencies between `--from` (the previous release's commit,
+omitted when there is none) and `--to` (default `HEAD`). It waits for npm to
+serve the release's new dependency versions, then runs `pnpm --filter <pkg>
+delivery.deploy`. A package that doesn't apply is skipped; a failed deploy
+exits non-zero. The shared `delivery.publish` workflow runs it as its own
+`deploy` job after the release job (opt in with `deploy-on-release: true`).
+
 ### `holocron ci`
 
 ```bash

package/dist/cli.mjs

@@ -3,7 +3,7 @@ import { createRequire } from "node:module";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import path, { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { checkbox, input, select } from "@inquirer/prompts";
-import { KNOWN_WORKFLOWS, createAstromech, extractPreviewConfig, readWorkspacePackages, reusableTemplates } from "@theholocron/astromech";
+import { KNOWN_WORKFLOWS, createAstromech, deployOnRelease, extractPreviewConfig, readWorkspacePackages, reusableTemplates } from "@theholocron/astromech";
 import { loadTasksConfig } from "@theholocron/astromech/config";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -1225,6 +1225,7 @@ const COMMAND_CONTEXTS = {
 	"lint commit-msg": "global",
 	run: "repo-aware",
 	ci: "repo-aware",
+	"deploy-on-release": "repo-aware",
 	"config show": "repo-aware",
 	"sync-readme": "repo-aware",
 	doctor: "workspace",
@@ -8845,6 +8846,25 @@ try {
 			scope: argv.all ? "all" : "required",
 			...argv.filter ? { filter: argv.filter } : {}
 		}).status === "fail") process.exitCode = 1;
+	}).command("deploy-on-release", "Deploy every workspace package whose delivery.deploy task is `on: release` — run by the delivery.publish workflow's deploy job", (y) => y.option("channel", {
+		type: "string",
+		default: "",
+		describe: "The release's channel: its prerelease identifier (`alpha`); empty or `main` for a stable release."
+	}).option("from", {
+		type: "string",
+		describe: "The previous release's commit, to diff against. Omit when there is none."
+	}).option("to", {
+		type: "string",
+		describe: "The release commit. Default HEAD."
+	}), async (argv) => {
+		if ((await deployOnRelease({
+			cwd: argv.cwd,
+			channel: argv.channel,
+			...argv.from ? { from: argv.from } : {},
+			...argv.to ? { to: argv.to } : {},
+			dryRun: argv.dryRun,
+			print: (line) => console.log(line)
+		})).status === "fail") process.exitCode = 1;
 	}).command("lint", "Lint content locally against the org's shared rules", (y) => y.command("commit-msg <file>", "Lint a commit message file — matches `commitlint --edit`'s own contract, for use from .husky/commit-msg", (yy) => yy.positional("file", {
 		type: "string",
 		demandOption: true,