@mediamonks/canopy-cli 0.7.0 → 0.7.1

package/dist/docs/staging.md

@@ -51,6 +51,14 @@ canopy promote               # the same migrations replay against live, then v g
 A migration that fails on staging costs you nothing — live never saw it. See
 [Schema migrations](https://docs.canopy.website/guides/migrations) for the migration system itself.
 
+## Staging an older version
+
+Any version in the deploy history can be pointed at the staging channel —
+from the dashboard's deploy list (the **Stage** action, next to Rollback) or
+with `canopy staging use v3`. Like rollback, it's a pointer move: nothing is
+rebuilt, and live is untouched. Handy for comparing an old build against the
+staging data, or re-testing a version before promoting it.
+
 ## Keeping staging fresh
 
 Staging data drifts as you test. Re-clone it from live anytime:

package/dist/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as version } from "./package-CDB-uxy3.mjs";
+import { t as version } from "./package-WhBa4V15.mjs";
 import { r as siteHeaderLine, t as setInvocationProfile } from "./site-BUlQR117.mjs";
 import { i as runRefresh, r as notifyOfUpdate } from "./version-check-Cuh6HaLX.mjs";
 import { defineCommand, runMain } from "citty";
@@ -83,7 +83,7 @@ const main = defineCommand({
 		dev: () => import("./dev-CvtoGFW0.mjs").then((m) => m.devCommand),
 		deploy: () => import("./deploy-BcczXlSQ.mjs").then((m) => m.deployCommand),
 		promote: () => import("./deploy-BcczXlSQ.mjs").then((m) => m.promoteCommand),
-		staging: () => import("./staging-CfF2-pHs.mjs").then((m) => m.stagingCommand),
+		staging: () => import("./staging-9bvgl2B5.mjs").then((m) => m.stagingCommand),
 		rollback: () => import("./deploy-BcczXlSQ.mjs").then((m) => m.rollbackCommand),
 		download: () => import("./deploy-BcczXlSQ.mjs").then((m) => m.downloadCommand),
 		token: () => import("./token-nieJV1w7.mjs").then((m) => m.tokenCommand),
@@ -91,8 +91,8 @@ const main = defineCommand({
 		usage: () => import("./usage-qqPtkDtT.mjs").then((m) => m.usageCommand),
 		open: () => import("./open-DD9oa-Ho.mjs").then((m) => m.openCommand),
 		docs: () => import("./docs-2cUEug69.mjs").then((m) => m.docsCommand),
-		skill: () => import("./skill-DrWzmUMv.mjs").then((m) => m.skillCommand),
-		upgrade: () => import("./upgrade-CH_jHkc7.mjs").then((m) => m.upgradeCommand),
+		skill: () => import("./skill-Di9GQYYx.mjs").then((m) => m.skillCommand),
+		upgrade: () => import("./upgrade-CZwo05Tz.mjs").then((m) => m.upgradeCommand),
 		logs: planned("logs", "Tail worker logs", "2")
 	}
 });

package/dist/{package-CDB-uxy3.mjs → package-WhBa4V15.mjs}

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.7.0";
+var version = "0.7.1";
 //#endregion
 export { version as t };

package/dist/{skill-DrWzmUMv.mjs → skill-Di9GQYYx.mjs}

@@ -1,4 +1,4 @@
-import { t as version } from "./package-CDB-uxy3.mjs";
+import { t as version } from "./package-WhBa4V15.mjs";
 import { n as reportErrors } from "./ui-D8HxX0Ng.mjs";
 import { defineCommand } from "citty";
 import { cpSync, existsSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";

package/dist/{staging-CfF2-pHs.mjs → staging-9bvgl2B5.mjs}

@@ -13,7 +13,7 @@ const fetchStatus = (slug) => apiRequest("GET", `/projects/${slug}/staging`);
 const stagingCommand = defineCommand({
 	meta: {
 		name: "staging",
-		description: "Staging channel: status, sync, destroy"
+		description: "Staging channel: status, use, sync, destroy"
 	},
 	subCommands: {
 		status: defineCommand({
@@ -35,6 +35,48 @@ const stagingCommand = defineCommand({
 				if (staging.version !== null && staging.version !== staging.live) console.log(`  \`canopy promote\` makes v${staging.version} live`);
 			})
 		}),
+		use: defineCommand({
+			meta: {
+				name: "use",
+				description: "Serve an existing version on the staging channel (pick from history)"
+			},
+			args: {
+				version: {
+					type: "positional",
+					description: "Version to stage, e.g. v3 (picked from a list when omitted)",
+					required: false
+				},
+				...projectFlagArgs
+			},
+			run: reportErrors("staging use", async ({ args }) => {
+				const { slug } = resolveProject(args);
+				let target;
+				if (args.version !== void 0) {
+					if (!/^v?\d+$/.test(args.version)) throw new Error(`Invalid version "${args.version}" — expected a number like 3 or v3.`);
+					target = Number(args.version.replace(/^v/, ""));
+				} else {
+					requireTty("pass a version, e.g. `canopy staging use v3`.");
+					const { deploys, live, staging: staged } = await apiRequest("GET", `/projects/${slug}/deploys`);
+					if (deploys.length === 0) throw new Error("This project has no deploys yet.");
+					target = unwrap(await p.select({
+						message: "Version to serve on staging",
+						options: deploys.map((deploy) => ({
+							value: deploy.version,
+							label: `v${deploy.version}  ${deploy.created_at}  (${deploy.source})`,
+							hint: deploy.version === staged ? "staged" : deploy.version === live ? "live" : void 0
+						}))
+					}));
+				}
+				const { staging: result } = await withContext(apiRequest("POST", `/projects/${slug}/deploys/${target}/stage`), {
+					action: `stage "${slug}" v${target}`,
+					fixes: {
+						staging_not_provisioned: "This project has no staging channel yet — create one in the dashboard's Settings, or with `canopy deploy --staging`.",
+						already_staged: `v${target} is already the staged version.`
+					}
+				});
+				console.log(`Staging: ${stagingUrl(slug)} (v${result.version}, was v${result.previous ?? "—"})`);
+			})
+		}),
 		sync: defineCommand({
 			meta: {
 				name: "sync",

package/dist/{upgrade-CH_jHkc7.mjs → upgrade-CZwo05Tz.mjs}

@@ -112,7 +112,7 @@ const upgradeCommand = defineCommand({
 		const spec = `${PACKAGE_NAME}@${args.version ?? "latest"}`;
 		const command = pmCommand(pm);
 		const cmd = installArgs(pm, spec);
-		const { skillInstalled } = await import("./skill-DrWzmUMv.mjs");
+		const { skillInstalled } = await import("./skill-Di9GQYYx.mjs");
 		const refreshSkill = skillInstalled(process.cwd());
 		console.log(`Upgrading via ${command}: ${command} ${cmd.join(" ")}`);
 		await run(command, cmd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mediamonks/canopy-cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Canopy CLI — create, develop and deploy Canopy projects.",
   "bin": {
     "canopy": "./dist/index.mjs"