@moku-labs/worker 0.7.1 → 0.7.3

package/dist/{cli-BBO_YNVC.cjs → cli-DQcpvh2s.cjs}

@@ -1984,8 +1984,9 @@ const runDev = async (ctx, opts, deps) => {
 //#region src/plugins/deploy/infra/plan.ts
 /**
 * Decide whether a single declared resource already exists in the account, recovering its id
-* (kv/d1) when it does. Durable Objects are config-only (they ship with the script), so they are
-* always treated as "missing" — provisioning them is a no-op that just records the binding.
+* (kv/d1) when it does. Durable Objects are config-only — they ship with the Worker (`wrangler
+* deploy` + the auto-derived DO migration create the namespace), never provisioned via the API — so
+* they are treated as already EXISTING, and the plan never re-offers to "create" them each deploy.
 *
 * @param resource - The declared resource descriptor.
 * @param existing - The indexed set of resources already in the account.
@@ -2013,7 +2014,7 @@ const checkExisting = (resource, existing) => {
 		}
 		case "r2": return { exists: existing.r2.has(resource.name) };
 		case "queue": return { exists: existing.queue.has(resource.name) };
-		case "do": return { exists: false };
+		case "do": return { exists: true };
 	}
 };
 /**
@@ -2207,6 +2208,57 @@ const renderProvisionResult = (ui, result) => {
 		}
 	}
 };
+/**
+* Format an elapsed duration compactly: sub-second as `820ms`, otherwise one-decimal seconds (`4.2s`),
+* and minutes once it crosses 60s (`1m04s`) so a long deploy stays readable.
+*
+* @param ms - The elapsed milliseconds.
+* @returns The compact duration string.
+* @example
+* ```ts
+* formatDuration(4234); // "4.2s"
+* ```
+*/
+const formatDuration = (ms) => {
+	if (ms < 1e3) return `${String(ms)}ms`;
+	const seconds = ms / 1e3;
+	if (seconds < 60) return `${seconds.toFixed(1)}s`;
+	const whole = Math.floor(seconds);
+	return `${String(Math.floor(whole / 60))}m${String(whole % 60).padStart(2, "0")}s`;
+};
+/**
+* Render the terminal deploy summary as a branded panel — the headline the user actually wants. The
+* live URL leads on its own line (pink, so it is the first thing the eye lands on), then a dim
+* key/value block: the target stage, the resource tally (with a red `failed` count when non-zero),
+* and the wall-clock time the whole deploy took. Replaces the prior single `deployed → url` line.
+*
+* @param ui - The branded console to render through.
+* @param summary - The deploy summary fields.
+* @param summary.url - The live deployed URL (the panel headline).
+* @param summary.stage - The target stage the worker deployed to.
+* @param summary.created - How many resources were created this run.
+* @param summary.exists - How many resources already existed (skipped).
+* @param summary.failed - How many resources failed to provision.
+* @param summary.elapsedMs - The wall-clock deploy duration in milliseconds.
+* @example
+* ```ts
+* renderDeploySummary(ui, { url, stage: "production", created: 0, exists: 5, failed: 0, elapsedMs: 4234 });
+* ```
+*/
+const renderDeploySummary = (ui, summary) => {
+	const { palette } = ui;
+	const tally = `${String(summary.exists)} exist · ${String(summary.created)} created`;
+	const failedLabel = palette.red(`${String(summary.failed)} failed`);
+	const resources = summary.failed > 0 ? `${tally} · ${failedLabel}` : tally;
+	ui.heading("Deployed");
+	ui.box([
+		palette.pink(summary.url),
+		"",
+		`${palette.dim("stage".padEnd(10))}${summary.stage}`,
+		`${palette.dim("resources".padEnd(10))}${resources}`,
+		`${palette.dim("took".padEnd(10))}${formatDuration(summary.elapsedMs)}`
+	]);
+};
 //#endregion
 //#region src/plugins/deploy/naming.ts
 /**
@@ -3086,6 +3138,34 @@ const guidedUpload = async (ctx, manifest, deps) => {
 	return true;
 };
 /**
+* The final deploy step: confirm the target (guided only), run `wrangler deploy` with interactive
+* retry, then emit deploy:complete. Returns the deployed URL, or undefined when the target gate or a
+* deploy retry is declined (so the caller renders the summary panel only on a real success).
+*
+* @param ctx - The deploy plugin context.
+* @param manifest - The assembled (or caller-supplied) deploy manifest.
+* @param stage - The resolved deploy stage (for the confirm prompt).
+* @param deps - Interactivity + the confirm prompt.
+* @returns The deployed URL once live; undefined when the user declined the gate or a retry (abort).
+* @example
+* ```ts
+* const url = await guidedDeployStep(ctx, manifest, stage, deps);
+* if (url === undefined) return emitAborted(ctx);
+* ```
+*/
+const guidedDeployStep = async (ctx, manifest, stage, deps) => {
+	if (!await deps.confirm(`Deploy "${manifest.name}" to ${stage}?`)) return void 0;
+	ctx.emit("deploy:phase", { phase: "deploy" });
+	const url = await guidedStep(() => runWrangler([
+		"deploy",
+		"--config",
+		ctx.config.configFile
+	]), HINTS.deploy, deps);
+	if (url === ABORTED) return void 0;
+	ctx.emit("deploy:complete", { url });
+	return url;
+};
+/**
 * Create the deploy api. Assembles the manifest from each resource plugin's own deployManifest(),
 * runs an infra preflight (check-before-create + id capture), generates config, uploads, and runs
 * `wrangler deploy`, emitting global deploy events along the way.
@@ -3127,11 +3207,11 @@ const createDeployApi = (ctx) => ({
 		const ci = opts?.ci ?? ctx.config.ci;
 		const stage = opts?.stage ?? ctx.global.stage;
 		const interactive = !ci && stdoutIsTty();
-		const confirm = interactive ? (0, _moku_labs_common_cli.createBrandPrompts)().confirm : async (_question) => true;
 		const deps = {
 			interactive,
-			confirm
+			confirm: interactive ? (0, _moku_labs_common_cli.createBrandPrompts)().confirm : async (_question) => true
 		};
+		const startedAt = Date.now();
 		ctx.emit("deploy:phase", { phase: "auth" });
 		if (!await guidedAuth(ctx, deps)) return emitAborted(ctx);
 		if (!await guidedWebBuild(ctx, opts?.webBuild ?? ctx.config.webBuild, deps)) return emitAborted(ctx);
@@ -3143,15 +3223,16 @@ const createDeployApi = (ctx) => ({
 		ctx.emit("deploy:phase", { phase: "wrangler-config" });
 		await writeWranglerConfig(ctx.config.configFile, manifest, provisioned.ids, wranglerExtra(ctx.config));
 		if (!await guidedUpload(ctx, manifest, deps)) return emitAborted(ctx);
-		if (!await confirm(`Deploy "${manifest.name}" to ${stage}?`)) return emitAborted(ctx);
-		ctx.emit("deploy:phase", { phase: "deploy" });
-		const url = await guidedStep(() => runWrangler([
-			"deploy",
-			"--config",
-			ctx.config.configFile
-		]), HINTS.deploy, deps);
-		if (url === ABORTED) return emitAborted(ctx);
-		ctx.emit("deploy:complete", { url });
+		const url = await guidedDeployStep(ctx, manifest, stage, deps);
+		if (url === void 0) return emitAborted(ctx);
+		renderDeploySummary((0, _moku_labs_common_cli.createBrandConsole)(), {
+			url,
+			stage,
+			created: provisioned.created.length,
+			exists: provisioned.skipped.length,
+			failed: provisioned.failed.length,
+			elapsedMs: Date.now() - startedAt
+		});
 	},
 	/**
 	* Start a long-lived local dev session: cold-build the Moku site, spawn `wrangler dev
@@ -3603,6 +3684,25 @@ const createCliApi = (ctx) => ({
 //#region src/plugins/cli/handlers.ts
 /** Divider drawn before the native `wrangler dev` TUI so the moku preamble reads as one section. */
 const WRANGLER_DIVIDER = `  ── wrangler ${"─".repeat(48)}`;
+/** Deploy phases that are a slow, opaque wait (captured output) — worth a live spinner on a TTY. */
+const SPINNER_PHASES = new Set(["upload", "deploy"]);
+/** Braille spinner glyphs; advance one per tick. */
+const SPINNER_FRAMES = [
+	"⠋",
+	"⠙",
+	"⠹",
+	"⠸",
+	"⠼",
+	"⠴",
+	"⠦",
+	"⠧",
+	"⠇",
+	"⠏"
+];
+/** Spinner tick interval (ms). */
+const SPINNER_TICK_MS = 80;
+/** Carriage-return + blanks + carriage-return that wipes the transient spinner line before settling. */
+const SPINNER_CLEAR = `\r${" ".repeat(72)}\r`;
 /**
 * Builds the hook handlers that turn global deploy events into a live progress TUI.
 * Each logs a clean, prefix-free message via `ctx.log`; the branded log sink (installed
@@ -3617,24 +3717,53 @@ const WRANGLER_DIVIDER = `  ── wrangler ${"─".repeat(48)}`;
 * const hooks = createCliHooks(ctx);
 * hooks["deploy:phase"]({ phase: "detect" }); // logs "detect" → renders "  › detect"
 * hooks["dev:phase"]({ phase: "serve", detail: "http://localhost:8787" }); // "serve · …"
-* hooks["deploy:complete"]({ url: "https://x.workers.dev" }); // "deployed → https://x.workers.dev"
+* hooks["deploy:complete"](); // settles the deploy spinner; the "Deployed" panel renders separately
 * ```
 */
 const createCliHooks = (ctx) => {
 	const ui = (0, _moku_labs_common_cli.createBrandConsole)();
+	const { palette } = ui;
+	let spinnerTimer;
+	let spinnerLabel;
+	const stopSpinner = () => {
+		if (spinnerTimer !== void 0) {
+			clearInterval(spinnerTimer);
+			spinnerTimer = void 0;
+		}
+		if (spinnerLabel !== void 0) {
+			process.stdout.write(SPINNER_CLEAR);
+			ctx.log.info(spinnerLabel);
+			spinnerLabel = void 0;
+		}
+	};
+	const startSpinner = (label) => {
+		spinnerLabel = label;
+		let frame = 0;
+		const text = `${label} …`;
+		spinnerTimer = setInterval(() => {
+			const glyph = SPINNER_FRAMES[frame % SPINNER_FRAMES.length] ?? SPINNER_FRAMES[0];
+			frame += 1;
+			process.stdout.write(`\r  ${palette.pink(glyph)} ${palette.dim(text)}`);
+		}, SPINNER_TICK_MS);
+	};
 	return {
 		/**
-		* Log one clean line per pipeline phase: "phase" or "phase · detail".
+		* Render one pipeline phase. Quick phases print a clean line ("phase" / "phase · detail"); the
+		* slow opaque waits (upload / deploy) animate a branded spinner on a TTY, settling to a line when
+		* the next phase or completion arrives. Off a TTY every phase is a plain line (unchanged).
 		*
 		* @param p - The deploy:phase event payload.
 		* @example
 		* ```ts
 		* handler({ phase: "detect" }); // "detect"
-		* handler({ phase: "upload", detail: "3 files" }); // "upload · 3 files"
+		* handler({ phase: "deploy" }); // spins on a TTY, else "deploy"
 		* ```
 		*/
 		"deploy:phase"(p) {
-			ctx.log.info(p.detail ? `${p.phase} · ${p.detail}` : p.phase);
+			stopSpinner();
+			const label = p.detail ? `${p.phase} · ${p.detail}` : p.phase;
+			if (process.stdout.isTTY === true && SPINNER_PHASES.has(p.phase)) startSpinner(label);
+			else ctx.log.info(label);
 		},
 		/**
 		* Log one dev-session phase: "phase" or "phase · detail".
@@ -3675,16 +3804,16 @@ const createCliHooks = (ctx) => {
 			ctx.log.warn(p.message);
 		},
 		/**
-		* Log the terminal success line with the deployed URL.
+		* Settle the final deploy spinner. The deployed URL + summary now render as a branded panel (the
+		* deploy plugin's renderDeploySummary), so the cli no longer logs a duplicate `deployed → url`.
 		*
-		* @param p - The deploy:complete event payload.
 		* @example
 		* ```ts
-		* handler({ url: "https://my-worker.workers.dev" }); // "deployed → https://my-worker.workers.dev"
+		* handler(); // clears the `deploy` spinner; the "Deployed" panel follows from the deploy plugin
 		* ```
 		*/
-		"deploy:complete"(p) {
-			ctx.log.info(`deployed → ${p.url}`);
+		"deploy:complete"() {
+			stopSpinner();
 		}
 	};
 };

package/dist/{cli-D67ea3Lu.mjs → cli-MICK1cvv.mjs}

@@ -1961,8 +1961,9 @@ const runDev = async (ctx, opts, deps) => {
 //#region src/plugins/deploy/infra/plan.ts
 /**
 * Decide whether a single declared resource already exists in the account, recovering its id
-* (kv/d1) when it does. Durable Objects are config-only (they ship with the script), so they are
-* always treated as "missing" — provisioning them is a no-op that just records the binding.
+* (kv/d1) when it does. Durable Objects are config-only — they ship with the Worker (`wrangler
+* deploy` + the auto-derived DO migration create the namespace), never provisioned via the API — so
+* they are treated as already EXISTING, and the plan never re-offers to "create" them each deploy.
 *
 * @param resource - The declared resource descriptor.
 * @param existing - The indexed set of resources already in the account.
@@ -1990,7 +1991,7 @@ const checkExisting = (resource, existing) => {
 		}
 		case "r2": return { exists: existing.r2.has(resource.name) };
 		case "queue": return { exists: existing.queue.has(resource.name) };
-		case "do": return { exists: false };
+		case "do": return { exists: true };
 	}
 };
 /**
@@ -2184,6 +2185,57 @@ const renderProvisionResult = (ui, result) => {
 		}
 	}
 };
+/**
+* Format an elapsed duration compactly: sub-second as `820ms`, otherwise one-decimal seconds (`4.2s`),
+* and minutes once it crosses 60s (`1m04s`) so a long deploy stays readable.
+*
+* @param ms - The elapsed milliseconds.
+* @returns The compact duration string.
+* @example
+* ```ts
+* formatDuration(4234); // "4.2s"
+* ```
+*/
+const formatDuration = (ms) => {
+	if (ms < 1e3) return `${String(ms)}ms`;
+	const seconds = ms / 1e3;
+	if (seconds < 60) return `${seconds.toFixed(1)}s`;
+	const whole = Math.floor(seconds);
+	return `${String(Math.floor(whole / 60))}m${String(whole % 60).padStart(2, "0")}s`;
+};
+/**
+* Render the terminal deploy summary as a branded panel — the headline the user actually wants. The
+* live URL leads on its own line (pink, so it is the first thing the eye lands on), then a dim
+* key/value block: the target stage, the resource tally (with a red `failed` count when non-zero),
+* and the wall-clock time the whole deploy took. Replaces the prior single `deployed → url` line.
+*
+* @param ui - The branded console to render through.
+* @param summary - The deploy summary fields.
+* @param summary.url - The live deployed URL (the panel headline).
+* @param summary.stage - The target stage the worker deployed to.
+* @param summary.created - How many resources were created this run.
+* @param summary.exists - How many resources already existed (skipped).
+* @param summary.failed - How many resources failed to provision.
+* @param summary.elapsedMs - The wall-clock deploy duration in milliseconds.
+* @example
+* ```ts
+* renderDeploySummary(ui, { url, stage: "production", created: 0, exists: 5, failed: 0, elapsedMs: 4234 });
+* ```
+*/
+const renderDeploySummary = (ui, summary) => {
+	const { palette } = ui;
+	const tally = `${String(summary.exists)} exist · ${String(summary.created)} created`;
+	const failedLabel = palette.red(`${String(summary.failed)} failed`);
+	const resources = summary.failed > 0 ? `${tally} · ${failedLabel}` : tally;
+	ui.heading("Deployed");
+	ui.box([
+		palette.pink(summary.url),
+		"",
+		`${palette.dim("stage".padEnd(10))}${summary.stage}`,
+		`${palette.dim("resources".padEnd(10))}${resources}`,
+		`${palette.dim("took".padEnd(10))}${formatDuration(summary.elapsedMs)}`
+	]);
+};
 //#endregion
 //#region src/plugins/deploy/naming.ts
 /**
@@ -3063,6 +3115,34 @@ const guidedUpload = async (ctx, manifest, deps) => {
 	return true;
 };
 /**
+* The final deploy step: confirm the target (guided only), run `wrangler deploy` with interactive
+* retry, then emit deploy:complete. Returns the deployed URL, or undefined when the target gate or a
+* deploy retry is declined (so the caller renders the summary panel only on a real success).
+*
+* @param ctx - The deploy plugin context.
+* @param manifest - The assembled (or caller-supplied) deploy manifest.
+* @param stage - The resolved deploy stage (for the confirm prompt).
+* @param deps - Interactivity + the confirm prompt.
+* @returns The deployed URL once live; undefined when the user declined the gate or a retry (abort).
+* @example
+* ```ts
+* const url = await guidedDeployStep(ctx, manifest, stage, deps);
+* if (url === undefined) return emitAborted(ctx);
+* ```
+*/
+const guidedDeployStep = async (ctx, manifest, stage, deps) => {
+	if (!await deps.confirm(`Deploy "${manifest.name}" to ${stage}?`)) return void 0;
+	ctx.emit("deploy:phase", { phase: "deploy" });
+	const url = await guidedStep(() => runWrangler([
+		"deploy",
+		"--config",
+		ctx.config.configFile
+	]), HINTS.deploy, deps);
+	if (url === ABORTED) return void 0;
+	ctx.emit("deploy:complete", { url });
+	return url;
+};
+/**
 * Create the deploy api. Assembles the manifest from each resource plugin's own deployManifest(),
 * runs an infra preflight (check-before-create + id capture), generates config, uploads, and runs
 * `wrangler deploy`, emitting global deploy events along the way.
@@ -3104,11 +3184,11 @@ const createDeployApi = (ctx) => ({
 		const ci = opts?.ci ?? ctx.config.ci;
 		const stage = opts?.stage ?? ctx.global.stage;
 		const interactive = !ci && stdoutIsTty();
-		const confirm = interactive ? createBrandPrompts().confirm : async (_question) => true;
 		const deps = {
 			interactive,
-			confirm
+			confirm: interactive ? createBrandPrompts().confirm : async (_question) => true
 		};
+		const startedAt = Date.now();
 		ctx.emit("deploy:phase", { phase: "auth" });
 		if (!await guidedAuth(ctx, deps)) return emitAborted(ctx);
 		if (!await guidedWebBuild(ctx, opts?.webBuild ?? ctx.config.webBuild, deps)) return emitAborted(ctx);
@@ -3120,15 +3200,16 @@ const createDeployApi = (ctx) => ({
 		ctx.emit("deploy:phase", { phase: "wrangler-config" });
 		await writeWranglerConfig(ctx.config.configFile, manifest, provisioned.ids, wranglerExtra(ctx.config));
 		if (!await guidedUpload(ctx, manifest, deps)) return emitAborted(ctx);
-		if (!await confirm(`Deploy "${manifest.name}" to ${stage}?`)) return emitAborted(ctx);
-		ctx.emit("deploy:phase", { phase: "deploy" });
-		const url = await guidedStep(() => runWrangler([
-			"deploy",
-			"--config",
-			ctx.config.configFile
-		]), HINTS.deploy, deps);
-		if (url === ABORTED) return emitAborted(ctx);
-		ctx.emit("deploy:complete", { url });
+		const url = await guidedDeployStep(ctx, manifest, stage, deps);
+		if (url === void 0) return emitAborted(ctx);
+		renderDeploySummary(createBrandConsole(), {
+			url,
+			stage,
+			created: provisioned.created.length,
+			exists: provisioned.skipped.length,
+			failed: provisioned.failed.length,
+			elapsedMs: Date.now() - startedAt
+		});
 	},
 	/**
 	* Start a long-lived local dev session: cold-build the Moku site, spawn `wrangler dev
@@ -3580,6 +3661,25 @@ const createCliApi = (ctx) => ({
 //#region src/plugins/cli/handlers.ts
 /** Divider drawn before the native `wrangler dev` TUI so the moku preamble reads as one section. */
 const WRANGLER_DIVIDER = `  ── wrangler ${"─".repeat(48)}`;
+/** Deploy phases that are a slow, opaque wait (captured output) — worth a live spinner on a TTY. */
+const SPINNER_PHASES = new Set(["upload", "deploy"]);
+/** Braille spinner glyphs; advance one per tick. */
+const SPINNER_FRAMES = [
+	"⠋",
+	"⠙",
+	"⠹",
+	"⠸",
+	"⠼",
+	"⠴",
+	"⠦",
+	"⠧",
+	"⠇",
+	"⠏"
+];
+/** Spinner tick interval (ms). */
+const SPINNER_TICK_MS = 80;
+/** Carriage-return + blanks + carriage-return that wipes the transient spinner line before settling. */
+const SPINNER_CLEAR = `\r${" ".repeat(72)}\r`;
 /**
 * Builds the hook handlers that turn global deploy events into a live progress TUI.
 * Each logs a clean, prefix-free message via `ctx.log`; the branded log sink (installed
@@ -3594,24 +3694,53 @@ const WRANGLER_DIVIDER = `  ── wrangler ${"─".repeat(48)}`;
 * const hooks = createCliHooks(ctx);
 * hooks["deploy:phase"]({ phase: "detect" }); // logs "detect" → renders "  › detect"
 * hooks["dev:phase"]({ phase: "serve", detail: "http://localhost:8787" }); // "serve · …"
-* hooks["deploy:complete"]({ url: "https://x.workers.dev" }); // "deployed → https://x.workers.dev"
+* hooks["deploy:complete"](); // settles the deploy spinner; the "Deployed" panel renders separately
 * ```
 */
 const createCliHooks = (ctx) => {
 	const ui = createBrandConsole();
+	const { palette } = ui;
+	let spinnerTimer;
+	let spinnerLabel;
+	const stopSpinner = () => {
+		if (spinnerTimer !== void 0) {
+			clearInterval(spinnerTimer);
+			spinnerTimer = void 0;
+		}
+		if (spinnerLabel !== void 0) {
+			process.stdout.write(SPINNER_CLEAR);
+			ctx.log.info(spinnerLabel);
+			spinnerLabel = void 0;
+		}
+	};
+	const startSpinner = (label) => {
+		spinnerLabel = label;
+		let frame = 0;
+		const text = `${label} …`;
+		spinnerTimer = setInterval(() => {
+			const glyph = SPINNER_FRAMES[frame % SPINNER_FRAMES.length] ?? SPINNER_FRAMES[0];
+			frame += 1;
+			process.stdout.write(`\r  ${palette.pink(glyph)} ${palette.dim(text)}`);
+		}, SPINNER_TICK_MS);
+	};
 	return {
 		/**
-		* Log one clean line per pipeline phase: "phase" or "phase · detail".
+		* Render one pipeline phase. Quick phases print a clean line ("phase" / "phase · detail"); the
+		* slow opaque waits (upload / deploy) animate a branded spinner on a TTY, settling to a line when
+		* the next phase or completion arrives. Off a TTY every phase is a plain line (unchanged).
 		*
 		* @param p - The deploy:phase event payload.
 		* @example
 		* ```ts
 		* handler({ phase: "detect" }); // "detect"
-		* handler({ phase: "upload", detail: "3 files" }); // "upload · 3 files"
+		* handler({ phase: "deploy" }); // spins on a TTY, else "deploy"
 		* ```
 		*/
 		"deploy:phase"(p) {
-			ctx.log.info(p.detail ? `${p.phase} · ${p.detail}` : p.phase);
+			stopSpinner();
+			const label = p.detail ? `${p.phase} · ${p.detail}` : p.phase;
+			if (process.stdout.isTTY === true && SPINNER_PHASES.has(p.phase)) startSpinner(label);
+			else ctx.log.info(label);
 		},
 		/**
 		* Log one dev-session phase: "phase" or "phase · detail".
@@ -3652,16 +3781,16 @@ const createCliHooks = (ctx) => {
 			ctx.log.warn(p.message);
 		},
 		/**
-		* Log the terminal success line with the deployed URL.
+		* Settle the final deploy spinner. The deployed URL + summary now render as a branded panel (the
+		* deploy plugin's renderDeploySummary), so the cli no longer logs a duplicate `deployed → url`.
 		*
-		* @param p - The deploy:complete event payload.
 		* @example
 		* ```ts
-		* handler({ url: "https://my-worker.workers.dev" }); // "deployed → https://my-worker.workers.dev"
+		* handler(); // clears the `deploy` spinner; the "Deployed" panel follows from the deploy plugin
 		* ```
 		*/
-		"deploy:complete"(p) {
-			ctx.log.info(`deployed → ${p.url}`);
+		"deploy:complete"() {
+			stopSpinner();
 		}
 	};
 };

package/dist/cli.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cli = require("./cli-BBO_YNVC.cjs");
+const require_cli = require("./cli-DQcpvh2s.cjs");
 exports.cliPlugin = require_cli.cliPlugin;
 exports.deployPlugin = require_cli.deployPlugin;

package/dist/cli.d.cts

@@ -1,2 +1,2 @@
-import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-Dse6wZJH.cjs";
+import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-DCweBI9s.cjs";
 export { type ExternalManifest, type ResourceManifest, cliPlugin, deployPlugin };

package/dist/cli.d.mts

@@ -1,2 +1,2 @@
-import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-Dse6wZJH.mjs";
+import { i as ResourceManifest, n as cliPlugin, r as ExternalManifest, t as deployPlugin } from "./index-DCweBI9s.mjs";
 export { type ExternalManifest, type ResourceManifest, cliPlugin, deployPlugin };

package/dist/cli.mjs

@@ -1,2 +1,2 @@
-import { n as deployPlugin, t as cliPlugin } from "./cli-D67ea3Lu.mjs";
+import { n as deployPlugin, t as cliPlugin } from "./cli-MICK1cvv.mjs";
 export { cliPlugin, deployPlugin };

package/dist/{index-Dse6wZJH.d.cts → index-DCweBI9s.d.cts}

@@ -267,17 +267,21 @@ type Api = {
    * when omitted. A failure renders a branded `✗` line and sets a non-zero exit code rather than
    * throwing a raw stack trace.
    *
-   * @param opts - Optional port and web build hook.
+   * @param opts - Optional port, stage, and web build hook.
    * @param opts.port - Local dev port to bind. Defaults to 8787 when omitted.
+   * @param opts.stage - Stage for the generated wrangler config's resource names. Falls back to the
+   *   `--stage` CLI flag, then the app's configured stage. Pass it explicitly from a script for a
+   *   self-documenting `dev({ stage })` instead of relying on the hidden flag.
    * @param opts.webBuild - Rebuild the web site on change (e.g. `() => webApp.cli.build()`).
    * @returns Resolves when the dev session ends.
    * @example
    * ```ts
-   * await app.cli.dev({ port: 7878, webBuild: () => web.cli.build() });
+   * await app.cli.dev({ stage: "dev", port: 7878, webBuild: () => web.cli.build() });
    * ```
    */
   dev(opts?: {
     port?: number;
+    stage?: string;
     webBuild?: WebBuild;
   }): Promise<void>;
   /**
@@ -285,18 +289,22 @@ type Api = {
    * `{ ci: true }` for the automated/non-interactive path (CI). A failure renders a branded `✗`
    * line and sets a non-zero exit code rather than throwing a raw stack trace.
    *
-   * @param opts - Optional ci flag and a web build hook.
+   * @param opts - Optional ci flag, stage, and a web build hook.
    * @param opts.ci - Automated mode: never prompts, auto-confirms. Omit/false → guided on a TTY.
+   * @param opts.stage - Stage for the generated wrangler config's resource names (e.g. "production",
+   *   "staging"). Falls back to the `--stage` CLI flag, then the app's configured stage. Pass it
+   *   explicitly from a script for a self-documenting `deploy({ stage })` instead of the hidden flag.
    * @param opts.webBuild - Build the web site first (e.g. `() => webApp.cli.build()`), before deploy.
    * @returns Resolves once the deploy completes (or after a failure is rendered).
    * @example
    * ```ts
-   * await app.cli.deploy({ webBuild: () => web.cli.build() });           // guided
-   * await app.cli.deploy({ ci: true, webBuild: () => web.cli.build() }); // CI
+   * await app.cli.deploy({ stage: "production", webBuild: () => web.cli.build() }); // guided
+   * await app.cli.deploy({ ci: true, webBuild: () => web.cli.build() });            // CI
    * ```
    */
   deploy(opts?: {
     ci?: boolean;
+    stage?: string;
     webBuild?: WebBuild;
   }): Promise<void>;
   /**

package/dist/{index-Dse6wZJH.d.mts → index-DCweBI9s.d.mts}

@@ -267,17 +267,21 @@ type Api = {
    * when omitted. A failure renders a branded `✗` line and sets a non-zero exit code rather than
    * throwing a raw stack trace.
    *
-   * @param opts - Optional port and web build hook.
+   * @param opts - Optional port, stage, and web build hook.
    * @param opts.port - Local dev port to bind. Defaults to 8787 when omitted.
+   * @param opts.stage - Stage for the generated wrangler config's resource names. Falls back to the
+   *   `--stage` CLI flag, then the app's configured stage. Pass it explicitly from a script for a
+   *   self-documenting `dev({ stage })` instead of relying on the hidden flag.
    * @param opts.webBuild - Rebuild the web site on change (e.g. `() => webApp.cli.build()`).
    * @returns Resolves when the dev session ends.
    * @example
    * ```ts
-   * await app.cli.dev({ port: 7878, webBuild: () => web.cli.build() });
+   * await app.cli.dev({ stage: "dev", port: 7878, webBuild: () => web.cli.build() });
    * ```
    */
   dev(opts?: {
     port?: number;
+    stage?: string;
     webBuild?: WebBuild;
   }): Promise<void>;
   /**
@@ -285,18 +289,22 @@ type Api = {
    * `{ ci: true }` for the automated/non-interactive path (CI). A failure renders a branded `✗`
    * line and sets a non-zero exit code rather than throwing a raw stack trace.
    *
-   * @param opts - Optional ci flag and a web build hook.
+   * @param opts - Optional ci flag, stage, and a web build hook.
    * @param opts.ci - Automated mode: never prompts, auto-confirms. Omit/false → guided on a TTY.
+   * @param opts.stage - Stage for the generated wrangler config's resource names (e.g. "production",
+   *   "staging"). Falls back to the `--stage` CLI flag, then the app's configured stage. Pass it
+   *   explicitly from a script for a self-documenting `deploy({ stage })` instead of the hidden flag.
    * @param opts.webBuild - Build the web site first (e.g. `() => webApp.cli.build()`), before deploy.
    * @returns Resolves once the deploy completes (or after a failure is rendered).
    * @example
    * ```ts
-   * await app.cli.deploy({ webBuild: () => web.cli.build() });           // guided
-   * await app.cli.deploy({ ci: true, webBuild: () => web.cli.build() }); // CI
+   * await app.cli.deploy({ stage: "production", webBuild: () => web.cli.build() }); // guided
+   * await app.cli.deploy({ ci: true, webBuild: () => web.cli.build() });            // CI
    * ```
    */
   deploy(opts?: {
     ci?: boolean;
+    stage?: string;
     webBuild?: WebBuild;
   }): Promise<void>;
   /**

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cli = require("./cli-BBO_YNVC.cjs");
+const require_cli = require("./cli-DQcpvh2s.cjs");
 let _moku_labs_common = require("@moku-labs/common");
 //#region src/env-provider.ts
 /**

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-Dse6wZJH.cjs";
+import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-DCweBI9s.cjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
 import { PluginCtx, PluginCtx as PluginCtx$1, PluginInstance } from "@moku-labs/core";
 

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-Dse6wZJH.mjs";
+import { a as WorkerConfig, c as WorkerPluginCtx, i as ResourceManifest, n as cliPlugin, o as WorkerEnv, r as ExternalManifest, s as WorkerEvents, t as deployPlugin } from "./index-DCweBI9s.mjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
 import { PluginCtx, PluginCtx as PluginCtx$1, PluginInstance } from "@moku-labs/core";
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as kvPlugin, c as d1Plugin, d as createCore, f as createPlugin$1, i as queuesPlugin, l as bindingsPlugin, n as deployPlugin, o as durableObjectsPlugin, p as stagePlugin, r as storagePlugin, s as defineDurableObject, t as cliPlugin, u as coreConfig } from "./cli-D67ea3Lu.mjs";
+import { a as kvPlugin, c as d1Plugin, d as createCore, f as createPlugin$1, i as queuesPlugin, l as bindingsPlugin, n as deployPlugin, o as durableObjectsPlugin, p as stagePlugin, r as storagePlugin, s as defineDurableObject, t as cliPlugin, u as coreConfig } from "./cli-MICK1cvv.mjs";
 import { envPlugin, logPlugin } from "@moku-labs/common";
 //#region src/env-provider.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/worker",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Cloudflare Worker framework for Moku — Durable Objects, Queues, R2, D1, and KV plugins that compose with Moku Web.",
   "repository": {
     "type": "git",