devflare 1.0.0-next.46 → 1.0.0-next.48

package/README.md

@@ -188,6 +188,7 @@ for examples with file paths.
 | `devflare productions` | inspect or manage production Worker versions |
 | `devflare remote` | manage remote test mode |
 | `devflare secrets` | manage local Secrets Store values |
+| `devflare tail` | stream live logs from a deployed Worker |
 | `devflare tokens` | create and manage Devflare-scoped API tokens |
 | `devflare types` | generate `env.d.ts` |
 | `devflare version` | print the installed version |

package/dist/_chunks/{cli-Ba6JBLOz.js → cli-Btoe8xx4.js}

@@ -20,6 +20,7 @@ const COMMANDS = [
 	"worker",
 	"tokens",
 	"secrets",
+	"tail",
 	"ai",
 	"remote",
 	"help",
@@ -260,6 +261,7 @@ const CORE_HELP_PAGES = [
 			entry("worker", "Rename and manage Worker control-plane operations"),
 			entry("tokens", "Manage Devflare-managed Cloudflare API tokens"),
 			entry("secrets", "Manage local Secrets Store values"),
+			entry("tail", "Stream live logs from a deployed Worker"),
 			entry("ai", "View Workers AI pricing information"),
 			entry("remote", "Manage remote test mode for paid Cloudflare features"),
 			entry("help", "Show command overview or a command-specific help page"),
@@ -346,6 +348,7 @@ const CORE_HELP_PAGES = [
 			"devflare deploy --production [--config <path>] [--build <path>] [--message <text>] [--tag <text>] [--debug]",
 			"devflare deploy --preview <name> [--config <path>] [--build <path>] [--message <text>] [--tag <text>]",
 			"devflare deploy --preview [--config <path>] [--build <path>] [--branch-name <branch>] [--message <text>] [--tag <text>]",
+			"devflare deploy --prod --percentage <n> [--version <current-version-id>] [--config <path>] [--message <text>]",
 			"devflare deploy --prod --dry-run [--config <path>]",
 			"devflare deploy --preview <name> --dry-run [--config <path>]",
 			"devflare deploy --preview --dry-run [--config <path>]"
@@ -367,6 +370,8 @@ const CORE_HELP_PAGES = [
 			entry("--branch-name <branch>", "Provide explicit branch metadata for preview-aware naming when your workflow needs it"),
 			entry("--message <text>", "Attach an explicit Wrangler deployment/version message"),
 			entry("--tag <text>", "Attach an explicit Wrangler version tag"),
+			entry("--percentage <n>", "Production gradual rollout: upload a new version and route n% (0-100) of traffic to it via `wrangler versions deploy`"),
+			entry("--version <id>", "With --percentage, the currently-live version id that keeps the remaining traffic (otherwise Wrangler distributes it)"),
 			entry("--debug", "Print stack traces when deployment orchestration fails")
 		],
 		examples: [
@@ -376,10 +381,12 @@ const CORE_HELP_PAGES = [
 			entry("devflare deploy --preview next", "Deploy the named `next` preview scope and provision preview-scoped resources automatically"),
 			entry("devflare deploy --preview pr-1", "Deploy the named `pr-1` preview scope directly"),
 			entry("devflare deploy --preview --branch-name feature-branch", "Upload a same-worker preview version with explicit branch metadata"),
-			entry("devflare deploy --preview next --dry-run", "Inspect the generated named-preview Wrangler config without deploying")
+			entry("devflare deploy --preview next --dry-run", "Inspect the generated named-preview Wrangler config without deploying"),
+			entry("devflare deploy --prod --percentage 10", "Upload a new version and route 10% of production traffic to it (canary)")
 		],
 		notes: [
 			"`devflare deploy` without an explicit target is rejected from the CLI so production and preview destinations stay unmistakable.",
+			"`--percentage <n>` performs a Cloudflare gradual deployment: Devflare runs `wrangler versions upload` (no traffic shift) and then `wrangler versions deploy <new-version-id>@<n> --yes`, routing n% of production traffic to the new version. Pass `--version <id>` to keep the remaining traffic on a specific currently-live version; otherwise Wrangler distributes the rest. To advance an existing rollout (e.g. 10% → 50% → 100%) without re-uploading, drive `wrangler versions deploy` directly. `--percentage` is production-only and rejected with `--preview`.",
 			"`--prod` / `--production` clear preview-scope environment overrides such as `DEVFLARE_PREVIEW_BRANCH` so production deploys stay pointed at stable Worker names.",
 			"Named preview deploys automatically provision preview-scoped resources before building and deploying.",
 			"When a build artifact still contains name-based bindings, deploy resolves or provisions the concrete Cloudflare resources and rewrites the generated Wrangler config with the IDs Wrangler requires.",
@@ -563,6 +570,25 @@ const MISC_HELP_PAGES = [
 		],
 		notes: ["Created tokens include the selected account resource and all zones in that account so deploys can manage Worker routes and custom-domain route state.", "Cloudflare only returns token secrets once for create and roll operations, so store them immediately."]
 	},
+	{
+		path: ["tail"],
+		summary: "Stream live logs from a deployed Worker",
+		usage: ["devflare tail [worker] [--worker <name>] [--format <pretty|json>] [--account <id>] [--config <path>]"],
+		description: ["Streams live request logs and exceptions from a Worker that is already deployed to Cloudflare, using Cloudflare’s Workers Trace (tail) API.", "This command is inherently remote: it opens a real tail session against your live Worker. There is no local emulation of deployed traffic — use `devflare dev` and `cf.tail.trigger()` for local/offline tail-handler testing."],
+		arguments: [entry("[worker]", "Worker name to tail (defaults to --worker, then the config `name`)")],
+		options: [
+			entry("--worker <name>", "Worker name to tail instead of the configured `name`"),
+			entry("--format <pretty|json>", "Output format: human-readable lines (default) or raw JSON events"),
+			entry("--account <id>", "Use a specific Cloudflare account instead of the resolved default"),
+			entry("--config <path>", "Use a specific devflare config file to resolve the Worker name/account")
+		],
+		examples: [
+			entry("devflare tail", "Stream logs from the Worker named in the current config"),
+			entry("devflare tail my-worker", "Stream logs from an explicitly named Worker"),
+			entry("devflare tail --format json", "Stream raw JSON tail events for piping into other tools")
+		],
+		notes: ["Requires Cloudflare authentication (`devflare login` or CLOUDFLARE_API_TOKEN) and a resolvable account id.", "Press Ctrl-C to stop; Devflare deletes the tail session and closes the WebSocket on exit. Cloudflare also expires idle tail sessions on its own."]
+	},
 	{
 		path: ["ai"],
 		summary: "Show Workers AI pricing information",
@@ -1050,6 +1076,7 @@ async function runCli(argv, options = {}) {
 		case "worker": return runWorker(parsed, logger, options);
 		case "tokens": return runToken(parsed, logger, options);
 		case "secrets": return runSecrets(parsed, logger, options);
+		case "tail": return runTail(parsed, logger, options);
 		case "ai": return runAI();
 		case "remote": return runRemote(parsed, logger, options);
 		default:
@@ -1070,14 +1097,14 @@ async function runBuild(parsed, logger, options) {
 	return runBuildCommand(parsed, logger, options);
 }
 async function runDeploy(parsed, logger, options) {
-	const { runDeployCommand } = await import("./deploy-0w_38g8h.js");
+	const { runDeployCommand } = await import("./deploy-B0l0VWNl.js");
 	return runDeployCommand(parsed, logger, {
 		...options,
 		requireExplicitDeployTarget: true
 	});
 }
 async function runTypes(parsed, logger, options) {
-	const { runTypesCommand } = await import("./types-Zn9vyUGA.js");
+	const { runTypesCommand } = await import("./types-BWLYVp3B.js");
 	return runTypesCommand(parsed, logger, options);
 }
 async function runDoctor(parsed, logger, options) {
@@ -1105,17 +1132,21 @@ async function runProductions(parsed, logger, options) {
 	return runProductionsCommand(parsed, logger, options);
 }
 async function runWorker(parsed, logger, options) {
-	const { runWorkerCommand } = await import("./worker-rL5udcl9.js");
+	const { runWorkerCommand } = await import("./worker-BUGz2bVG.js");
 	return runWorkerCommand(parsed, logger, options);
 }
 async function runToken(parsed, logger, options) {
-	const { runTokenCommand } = await import("./token-kguIDmej.js");
+	const { runTokenCommand } = await import("./token-Dmi0KXyX.js");
 	return runTokenCommand(parsed, logger, options);
 }
 async function runSecrets(parsed, logger, options) {
 	const { runSecretsCommand } = await import("./secrets-DIpJGe6C.js");
 	return runSecretsCommand(parsed, logger, options);
 }
+async function runTail(parsed, logger, options) {
+	const { runTailCommand } = await import("./tail-BKLtjVi4.js");
+	return runTailCommand(parsed, logger, options);
+}
 async function runAI() {
 	const { runAICommand } = await import("./ai-CBEuLdoP.js");
 	return runAICommand();

package/dist/_chunks/{deploy-0w_38g8h.js → deploy-B0l0VWNl.js}

@@ -147,6 +147,68 @@ async function withTemporaryEnvironment(overrides, operation) {
 	}
 }
 //#endregion
+//#region src/cli/gradual-deploy.ts
+/**
+* Parse and validate the `--percentage` CLI option.
+*
+* Returns `undefined` when the flag is absent (a normal full deploy). Throws a
+* clear error when the value is present but not an integer in `[0, 100]` — the
+* same bounds Wrangler enforces — so a typo never silently becomes a full
+* deploy.
+*/
+function parseDeployPercentage(value) {
+	if (value === void 0) return;
+	if (value === true || value === false) throw new Error("--percentage requires a value between 0 and 100, e.g. `--percentage 10`.");
+	const trimmed = value.trim();
+	if (!/^\d+$/.test(trimmed)) throw new Error(`--percentage must be a whole number between 0 and 100, received "${value}".`);
+	const parsed = Number.parseInt(trimmed, 10);
+	if (!Number.isInteger(parsed) || parsed < 0 || parsed > 100) throw new Error(`--percentage must be a whole number between 0 and 100, received "${value}".`);
+	return parsed;
+}
+/**
+* Build the positional `<version-id>@<percentage>` version specs for a rollout.
+*
+* Wrangler's `versions deploy` consumes traffic splits as positional specs (see
+* `wrangler versions deploy --help`: "Shorthand notation to deploy Worker
+* Version(s) [<version-id>@<percentage>..]"). When a distinct previous version
+* id is provided, the remaining percentage is routed to it so the split is
+* fully specified and Wrangler never has to prompt; otherwise only the new
+* version is named and Wrangler distributes the rest.
+*/
+function buildVersionSpecs(spec) {
+	const specs = [`${spec.versionId}@${spec.percentage}`];
+	const remaining = 100 - spec.percentage;
+	if (spec.previousVersionId && spec.previousVersionId !== spec.versionId && remaining > 0) specs.push(`${spec.previousVersionId}@${remaining}`);
+	return specs;
+}
+/**
+* Build the full `wrangler versions deploy` invocation for a gradual rollout.
+*
+* `localWranglerExecutable` mirrors the deploy command's resolution: when a
+* local `wrangler/bin/wrangler.js` exists it is run under `node`; otherwise the
+* invocation falls back to `bunx wrangler …`.
+*/
+function buildGradualDeployInvocation(spec, localWranglerExecutable) {
+	const command = localWranglerExecutable ? "node" : "bunx";
+	const args = localWranglerExecutable ? [
+		localWranglerExecutable,
+		"versions",
+		"deploy"
+	] : [
+		"wrangler",
+		"versions",
+		"deploy"
+	];
+	args.push(...buildVersionSpecs(spec));
+	args.push("--name", spec.workerName);
+	if (spec.message?.trim()) args.push("--message", spec.message.trim());
+	args.push("--yes");
+	return {
+		command,
+		args
+	};
+}
+//#endregion
 //#region src/cli/preview.ts
 function matchNamedValue(output, patterns) {
 	for (const pattern of patterns) {
@@ -555,6 +617,8 @@ async function runDeployCommand(parsed, logger, options) {
 	let deployMessage;
 	let deployTag;
 	let previewScopeName;
+	let rolloutPercentage;
+	let rolloutPreviousVersionId;
 	let requireFreshProductionDeployment = false;
 	let resolvedPreviewScopeName = process.env.DEVFLARE_PREVIEW_BRANCH?.trim() || void 0;
 	const theme = createCliTheme(parsed.options);
@@ -570,6 +634,9 @@ async function runDeployCommand(parsed, logger, options) {
 		branchName = resolvedParsed.options["branch-name"];
 		deployMessage = resolvedParsed.options.message;
 		deployTag = resolvedParsed.options.tag;
+		rolloutPercentage = parseDeployPercentage(resolvedParsed.options.percentage);
+		rolloutPreviousVersionId = typeof resolvedParsed.options.version === "string" ? resolvedParsed.options.version.trim() || void 0 : void 0;
+		if (rolloutPercentage !== void 0 && deployTarget.mode !== "production") throw new Error("--percentage is a production gradual rollout and is only valid with an explicit production target. Run `devflare deploy --prod --percentage <n>` (it cannot be combined with --preview or a named/branch preview deploy).");
 		previewScopeName = branchName?.trim() || deployTarget.previewScopeRaw || void 0;
 		resolvedPreviewScopeName = previewScopeName || process.env.DEVFLARE_PREVIEW_BRANCH?.trim() || void 0;
 		requireFreshProductionDeployment = !preview && shouldRequireFreshProductionDeployment();
@@ -591,6 +658,7 @@ async function runDeployCommand(parsed, logger, options) {
 				});
 				const wranglerConfig = compileBuildConfig(deploymentStrategy.config, void 0, { alreadyResolved: true });
 				logLine(logger, `${yellow("dry run", theme)} ${dim("Skipping actual deployment", theme)}`);
+				if (rolloutPercentage !== void 0) logLine(logger, dim(`Would upload a new Worker version and route ${rolloutPercentage}% of production traffic to it via \`wrangler versions deploy\`${rolloutPreviousVersionId ? `, keeping ${100 - rolloutPercentage}% on version ${rolloutPreviousVersionId}` : ""}.`, theme));
 				const deploymentStrategyMessage = describeDeploymentStrategy(deploymentStrategy);
 				if (deploymentStrategyMessage) logLine(logger, dim(deploymentStrategyMessage, theme));
 				logLine(logger, dim("Would deploy with wrangler config:", theme));
@@ -647,13 +715,15 @@ async function runDeployCommand(parsed, logger, options) {
 				if (prepared.config.bindings?.durableObjects && Object.keys(prepared.config.bindings.durableObjects).length > 0) logger.warn("Cloudflare does not currently generate preview URLs for Workers that implement Durable Objects.");
 				if (prepared.config.migrations && prepared.config.migrations.length > 0) logger.warn("Cloudflare versions upload does not currently support Durable Object migrations.");
 			}
-			logLine(logger, dim(preview ? "Uploading preview version with Wrangler…" : "Deploying with Wrangler…", theme));
+			const usePercentageRollout = !preview && !isBranchScopedPreviewDeployment && rolloutPercentage !== void 0;
+			const uploadVersionOnly = preview || usePercentageRollout;
+			logLine(logger, dim(preview ? "Uploading preview version with Wrangler…" : usePercentageRollout ? "Uploading new Worker version with Wrangler…" : "Deploying with Wrangler…", theme));
 			const deployStartedAt = /* @__PURE__ */ new Date();
 			const wranglerOutputDirectory = join(cwd, ".devflare");
 			const wranglerOutputFilePath = join(wranglerOutputDirectory, `wrangler-output-${Date.now()}-${process.pid}.ndjson`);
 			await deps.fs.mkdir(wranglerOutputDirectory, { recursive: true });
 			const wranglerCommand = localWranglerExecutable ? "node" : "bunx";
-			const wranglerArgs = preview ? localWranglerExecutable ? [
+			const wranglerArgs = uploadVersionOnly ? localWranglerExecutable ? [
 				localWranglerExecutable,
 				"versions",
 				"upload"
@@ -766,7 +836,7 @@ async function runDeployCommand(parsed, logger, options) {
 				const message = error instanceof Error ? error.message : String(error);
 				versionRecoveryDiagnostics.push(`deployment lookup: ${message}`);
 			}
-			if (!preview && !isBranchScopedPreviewDeployment && !resolvedVersionId && resolvedAccountId) try {
+			if (!preview && !isBranchScopedPreviewDeployment && !usePercentageRollout && !resolvedVersionId && resolvedAccountId) try {
 				const fallbackDeployment = await resolveVersionIdFromLatestProductionDeployment({
 					accountId: resolvedAccountId,
 					workerName: prepared.config.name,
@@ -780,7 +850,7 @@ async function runDeployCommand(parsed, logger, options) {
 				const message = error instanceof Error ? error.message : String(error);
 				versionRecoveryDiagnostics.push(`deployment lookup: ${message}`);
 			}
-			if (!preview && !isBranchScopedPreviewDeployment && !resolvedVersionId && resolvedAccountId) try {
+			if (!preview && !isBranchScopedPreviewDeployment && !usePercentageRollout && !resolvedVersionId && resolvedAccountId) try {
 				const currentDeployment = await resolveVersionIdFromCurrentProductionDeployment({
 					accountId: resolvedAccountId,
 					workerName: prepared.config.name
@@ -845,7 +915,7 @@ async function runDeployCommand(parsed, logger, options) {
 						accountId: resolvedAccountId,
 						workerName: prepared.config.name,
 						versionId: resolvedVersionId,
-						preview,
+						preview: preview || usePercentageRollout,
 						logger,
 						theme
 					});
@@ -863,6 +933,52 @@ async function runDeployCommand(parsed, logger, options) {
 					};
 				}
 			}
+			if (usePercentageRollout) {
+				if (!resolvedVersionId) {
+					const recoveryDetails = versionRecoveryDiagnostics.length > 0 ? ` Cloudflare fallback checks also failed: ${versionRecoveryDiagnostics.join(" | ")}` : "";
+					const rolloutError = `A new Worker version was uploaded, but Devflare could not resolve its version id, so it could not start the ${rolloutPercentage}% gradual rollout. Re-run \`devflare deploy --prod --percentage ${rolloutPercentage}\`, or split traffic manually with \`wrangler versions deploy\`.${recoveryDetails}`;
+					await persistDeployMetadata({
+						status: "failure",
+						exitCode: 1,
+						error: rolloutError
+					});
+					logger.error(rolloutError);
+					return {
+						exitCode: 1,
+						output: structuredOutput
+					};
+				}
+				const rolloutInvocation = buildGradualDeployInvocation({
+					versionId: resolvedVersionId,
+					percentage: rolloutPercentage,
+					previousVersionId: rolloutPreviousVersionId,
+					workerName: prepared.config.name,
+					message: deployMessage?.trim() || void 0
+				}, localWranglerExecutable);
+				logLine(logger, dim(`Routing ${rolloutPercentage}% of production traffic to the new version with Wrangler…`, theme));
+				const rolloutProc = await deps.exec.exec(rolloutInvocation.command, rolloutInvocation.args, {
+					cwd,
+					stdio: "inherit",
+					env: {
+						...process.env,
+						FORCE_COLOR: process.env.FORCE_COLOR ?? "0"
+					}
+				});
+				if (rolloutProc.exitCode !== 0) {
+					const rolloutError = `The new Worker version ${resolvedVersionId} was uploaded, but \`wrangler versions deploy\` failed to route ${rolloutPercentage}% of production traffic to it. Re-run the rollout, or split traffic manually with \`wrangler versions deploy\`.`;
+					await persistDeployMetadata({
+						status: "failure",
+						exitCode: 1,
+						error: rolloutProc.stderr || rolloutProc.stdout || rolloutError
+					});
+					logger.error(rolloutError);
+					return {
+						exitCode: 1,
+						output: structuredOutput
+					};
+				}
+				logger.success(`Routed ${rolloutPercentage}% of production traffic to version ${resolvedVersionId}`);
+			}
 			if (resolvedAccountId) {
 				const previewRegistryScope = isBranchScopedPreviewDeployment ? deployTarget.previewScope : void 0;
 				const previewRegistryUrl = preview || isBranchScopedPreviewDeployment ? resolvedPreviewUrl : void 0;

package/dist/_chunks/tail-BKLtjVi4.js

@@ -0,0 +1,239 @@
+import { r as loadConfig } from "./loader-RZhqzsRJ.js";
+import { p as getApiToken } from "./api-TzdliH-6.js";
+import { d as green, f as logLine, g as yellow, h as whiteDim, m as red, o as dim, r as createCliTheme } from "./ui-BUoZApvE.js";
+import { r as resolveCloudflareAccountId, t as asOptionalString } from "./command-utils-C48hJMln.js";
+//#region src/cli/commands/tail.ts
+const CLOUDFLARE_API_BASE = "https://api.cloudflare.com/client/v4";
+const TAIL_SUBPROTOCOL = "trace-v1";
+function parseTailFormat(value) {
+	const normalized = asOptionalString(value)?.toLowerCase();
+	if (normalized === void 0 || normalized === "pretty") return "pretty";
+	if (normalized === "json") return "json";
+	throw new Error(`--format must be "pretty" or "json", received "${String(value)}".`);
+}
+function formatTimestamp(timestamp) {
+	if (typeof timestamp !== "number" || !Number.isFinite(timestamp)) return (/* @__PURE__ */ new Date()).toISOString();
+	return new Date(timestamp).toISOString();
+}
+function describeTriggerEvent(event) {
+	if (!event) return "event";
+	if (event.request?.url) return `${event.request.method ?? "GET"} ${event.request.url}`;
+	if (event.cron) return `cron ${event.cron}`;
+	if (event.queue) return `queue ${event.queue}`;
+	if (event.mailFrom) return `email from ${event.mailFrom}`;
+	if (event.rpcMethod) return `rpc ${event.rpcMethod}`;
+	return "event";
+}
+function stringifyLogMessage(message) {
+	if (typeof message === "string") return message;
+	if (Array.isArray(message)) return message.map((part) => stringifyLogMessage(part)).join(" ");
+	if (message === void 0) return "";
+	try {
+		return JSON.stringify(message);
+	} catch {
+		return String(message);
+	}
+}
+/**
+* Render one trace event as the lines `devflare tail` prints in pretty mode.
+* Returns an ordered list of `{ level, text }` so the caller can route each
+* line to the matching logger method (and tests can assert content without
+* ANSI noise).
+*/
+function formatTailEventLines(event) {
+	const lines = [];
+	const timestamp = formatTimestamp(event.eventTimestamp);
+	const outcome = event.outcome ?? "unknown";
+	const trigger = describeTriggerEvent(event.event);
+	const scriptName = event.scriptName ? ` ${event.scriptName}` : "";
+	lines.push({
+		level: outcome === "ok" ? "info" : "error",
+		text: `[${timestamp}]${scriptName} ${trigger} — ${outcome}`
+	});
+	for (const log of event.logs ?? []) {
+		const level = log.level ?? "log";
+		const text = stringifyLogMessage(log.message);
+		lines.push({
+			level: level === "error" || level === "warn" ? level : "info",
+			text: `  ${level}: ${text}`
+		});
+	}
+	for (const exception of event.exceptions ?? []) {
+		const name = exception.name ?? "Error";
+		const message = exception.message ?? "";
+		lines.push({
+			level: "error",
+			text: `  exception ${name}: ${message}`
+		});
+	}
+	return lines;
+}
+async function readEnvelope(response, endpoint) {
+	const text = await response.text();
+	let parsed;
+	try {
+		parsed = JSON.parse(text);
+	} catch {
+		throw new Error(`Cloudflare ${endpoint} returned an invalid response (status ${response.status}).`);
+	}
+	if (!parsed.success) {
+		const first = parsed.errors?.[0];
+		throw new Error(first ? `Cloudflare ${endpoint} failed (${first.code}): ${first.message}` : `Cloudflare ${endpoint} failed (status ${response.status}).`);
+	}
+	return parsed.result;
+}
+async function createTail(accountId, workerName, token) {
+	const result = await readEnvelope(await fetch(`${CLOUDFLARE_API_BASE}/accounts/${accountId}/workers/scripts/${encodeURIComponent(workerName)}/tails`, {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${token}`,
+			"Content-Type": "application/json"
+		}
+	}), `create tail for ${workerName}`);
+	return {
+		id: result.id,
+		url: result.url,
+		expiresAt: result.expires_at
+	};
+}
+async function deleteTail(accountId, workerName, tailId, token) {
+	const response = await fetch(`${CLOUDFLARE_API_BASE}/accounts/${accountId}/workers/scripts/${encodeURIComponent(workerName)}/tails/${encodeURIComponent(tailId)}`, {
+		method: "DELETE",
+		headers: { Authorization: `Bearer ${token}` }
+	});
+	if (!response.ok) await readEnvelope(response, `delete tail ${tailId}`);
+}
+function parseTailMessage(raw) {
+	const parsed = JSON.parse(raw);
+	if (Array.isArray(parsed)) return parsed;
+	return [parsed];
+}
+async function resolveWorkerName(parsed, cwd, configFile, fallbackArg) {
+	const explicit = asOptionalString(parsed.options.worker) ?? fallbackArg;
+	if (explicit) return explicit;
+	try {
+		return (await loadConfig({
+			cwd,
+			configFile
+		})).name;
+	} catch {
+		return;
+	}
+}
+async function runTailCommand(parsed, logger, options) {
+	const theme = createCliTheme(parsed.options);
+	const cwd = options.cwd ?? process.cwd();
+	const configFile = asOptionalString(parsed.options.config);
+	let format;
+	try {
+		format = parseTailFormat(parsed.options.format);
+	} catch (error) {
+		logger.error(error instanceof Error ? error.message : String(error));
+		return { exitCode: 1 };
+	}
+	const fallbackArg = parsed.args[0];
+	const workerName = await resolveWorkerName(parsed, cwd, configFile, fallbackArg);
+	if (!workerName) {
+		logger.error("No Worker name could be resolved.");
+		logLine(logger, dim("Pass a Worker name (`devflare tail <worker>`), --worker <name>, or run inside a configured package.", theme));
+		return { exitCode: 1 };
+	}
+	const token = await getApiToken();
+	if (!token) {
+		logger.error("Not authenticated with Cloudflare.");
+		logLine(logger, dim("Run `devflare login` first, or set CLOUDFLARE_API_TOKEN.", theme));
+		return { exitCode: 1 };
+	}
+	let configuredAccountId;
+	try {
+		configuredAccountId = (await loadConfig({
+			cwd,
+			configFile
+		})).accountId;
+	} catch {
+		configuredAccountId = void 0;
+	}
+	const accountId = await resolveCloudflareAccountId({
+		explicitAccountId: asOptionalString(parsed.options.account),
+		configuredAccountId
+	});
+	if (!accountId) {
+		logger.error("No Cloudflare account could be resolved.");
+		logLine(logger, dim("Use --account <id> or set accountId in devflare.config.* / CLOUDFLARE_ACCOUNT_ID.", theme));
+		return { exitCode: 1 };
+	}
+	logLine(logger);
+	logLine(logger, `${yellow("tail", theme)} ${dim("Streaming live logs from Cloudflare", theme)}`);
+	logLine(logger, `${dim("worker", theme)} ${green(workerName, theme)}`);
+	logLine(logger, `${dim("account", theme)} ${whiteDim(accountId, theme)}`);
+	let createdTail;
+	try {
+		createdTail = await createTail(accountId, workerName, token);
+	} catch (error) {
+		logger.error(error instanceof Error ? error.message : String(error));
+		return { exitCode: 1 };
+	}
+	logLine(logger, dim(`Connected to tail ${createdTail.id}${createdTail.expiresAt ? ` (expires ${createdTail.expiresAt})` : ""}. Press Ctrl-C to stop.`, theme));
+	const { WebSocket: WsWebSocket } = await import("ws");
+	return new Promise((resolve) => {
+		let settled = false;
+		const socket = new WsWebSocket(createdTail.url, TAIL_SUBPROTOCOL, { headers: {
+			Authorization: `Bearer ${token}`,
+			"User-Agent": "devflare"
+		} });
+		const cleanup = async (exitCode) => {
+			if (settled) return;
+			settled = true;
+			try {
+				socket.close();
+			} catch {}
+			process.off("SIGINT", onSigint);
+			try {
+				await deleteTail(accountId, workerName, createdTail.id, token);
+			} catch (error) {
+				logger.warn(`Could not delete the tail session ${createdTail.id}; it will expire on its own. ${error instanceof Error ? error.message : String(error)}`);
+			}
+			resolve({ exitCode });
+		};
+		const onSigint = () => {
+			logLine(logger);
+			logLine(logger, dim("Stopping tail…", theme));
+			cleanup(0);
+		};
+		process.on("SIGINT", onSigint);
+		socket.on("open", () => {
+			logger.success("Tail stream open");
+		});
+		socket.on("message", (data) => {
+			const raw = typeof data === "string" ? data : String(data);
+			let events;
+			try {
+				events = parseTailMessage(raw);
+			} catch {
+				logger.warn(`Received a non-JSON tail message: ${raw.slice(0, 200)}`);
+				return;
+			}
+			for (const event of events) {
+				if (format === "json") {
+					logger.log(JSON.stringify(event));
+					continue;
+				}
+				for (const line of formatTailEventLines(event)) if (line.level === "error") logLine(logger, red(line.text, theme));
+				else if (line.level === "warn") logLine(logger, yellow(line.text, theme));
+				else logLine(logger, line.text);
+			}
+		});
+		socket.on("error", (error) => {
+			logger.error(`Tail stream error: ${error.message}`);
+			cleanup(1);
+		});
+		socket.on("close", () => {
+			if (!settled) {
+				logLine(logger, dim("Tail stream closed.", theme));
+				cleanup(0);
+			}
+		});
+	});
+}
+//#endregion
+export { runTailCommand };

package/dist/cli/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAoB9C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AA2BjE,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,CAAC,CA8hBpB"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/deploy.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAqB9C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AA2BjE,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,CAAC,CA0pBpB"}

package/dist/cli/commands/tail.d.ts

@@ -0,0 +1,44 @@
+import type { ConsolaInstance } from 'consola';
+import type { CliOptions, CliResult, ParsedArgs } from '../index.js';
+export type TailFormat = 'pretty' | 'json';
+export interface TailTraceLog {
+    level?: string;
+    message?: unknown;
+    timestamp?: number;
+}
+export interface TailTraceException {
+    name?: string;
+    message?: string;
+    timestamp?: number;
+}
+export interface TailTraceEvent {
+    scriptName?: string | null;
+    outcome?: string;
+    eventTimestamp?: number | null;
+    event?: {
+        request?: {
+            method?: string;
+            url?: string;
+        };
+        cron?: string;
+        scheduledTime?: number;
+        queue?: string;
+        mailFrom?: string;
+        rpcMethod?: string;
+    } | null;
+    logs?: TailTraceLog[];
+    exceptions?: TailTraceException[];
+}
+export declare function parseTailFormat(value: string | boolean | undefined): TailFormat;
+/**
+ * Render one trace event as the lines `devflare tail` prints in pretty mode.
+ * Returns an ordered list of `{ level, text }` so the caller can route each
+ * line to the matching logger method (and tests can assert content without
+ * ANSI noise).
+ */
+export declare function formatTailEventLines(event: TailTraceEvent): Array<{
+    level: string;
+    text: string;
+}>;
+export declare function runTailCommand(parsed: ParsedArgs, logger: ConsolaInstance, options: CliOptions): Promise<CliResult>;
+//# sourceMappingURL=tail.d.ts.map

package/dist/cli/commands/tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/tail.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAI9C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAMjE,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAA;AAkB1C,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,KAAK,CAAC,EAAE;QACP,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,SAAS,CAAC,EAAE,MAAM,CAAA;KAClB,GAAG,IAAI,CAAA;IACR,IAAI,CAAC,EAAE,YAAY,EAAE,CAAA;IACrB,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAA;CACjC;AAMD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAW/E;AA0DD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,cAAc,GACnB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA+BxC;AAwHD,wBAAsB,cAAc,CACnC,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,UAAU,GACjB,OAAO,CAAC,SAAS,CAAC,CAiLpB"}

package/dist/cli/gradual-deploy.d.ts

@@ -0,0 +1,49 @@
+export interface GradualDeploySpec {
+    /** Worker version id receiving the rollout percentage. */
+    versionId: string;
+    /** Percentage of production traffic to route to `versionId` (0–100). */
+    percentage: number;
+    /**
+     * The currently-live version id that receives the remaining percentage. When
+     * omitted (or equal to `versionId`) the rollout deploys a single version and
+     * Wrangler distributes the remaining traffic itself.
+     */
+    previousVersionId?: string;
+    /** Worker name (`--name`). */
+    workerName: string;
+    /** Optional deployment message (`--message`). */
+    message?: string;
+}
+export interface ResolvedWranglerInvocation {
+    command: string;
+    args: string[];
+}
+/**
+ * Parse and validate the `--percentage` CLI option.
+ *
+ * Returns `undefined` when the flag is absent (a normal full deploy). Throws a
+ * clear error when the value is present but not an integer in `[0, 100]` — the
+ * same bounds Wrangler enforces — so a typo never silently becomes a full
+ * deploy.
+ */
+export declare function parseDeployPercentage(value: string | boolean | undefined): number | undefined;
+/**
+ * Build the positional `<version-id>@<percentage>` version specs for a rollout.
+ *
+ * Wrangler's `versions deploy` consumes traffic splits as positional specs (see
+ * `wrangler versions deploy --help`: "Shorthand notation to deploy Worker
+ * Version(s) [<version-id>@<percentage>..]"). When a distinct previous version
+ * id is provided, the remaining percentage is routed to it so the split is
+ * fully specified and Wrangler never has to prompt; otherwise only the new
+ * version is named and Wrangler distributes the rest.
+ */
+export declare function buildVersionSpecs(spec: GradualDeploySpec): string[];
+/**
+ * Build the full `wrangler versions deploy` invocation for a gradual rollout.
+ *
+ * `localWranglerExecutable` mirrors the deploy command's resolution: when a
+ * local `wrangler/bin/wrangler.js` exists it is run under `node`; otherwise the
+ * invocation falls back to `bunx wrangler …`.
+ */
+export declare function buildGradualDeployInvocation(spec: GradualDeploySpec, localWranglerExecutable: string | null): ResolvedWranglerInvocation;
+//# sourceMappingURL=gradual-deploy.d.ts.map

package/dist/cli/gradual-deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradual-deploy.d.ts","sourceRoot":"","sources":["../../src/cli/gradual-deploy.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,iBAAiB;IACjC,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,0BAA0B;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAoB7F;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,EAAE,CASnE;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC3C,IAAI,EAAE,iBAAiB,EACvB,uBAAuB,EAAE,MAAM,GAAG,IAAI,GACpC,0BAA0B,CAmB5B"}

package/dist/cli/help-pages/pages/core.d.ts

@@ -1,4 +1,4 @@
 import type { HelpPage } from '../types.js';
 export declare const CORE_HELP_PAGES: HelpPage[];
-export declare const CORE_COMMANDS: readonly ["init", "dev", "build", "deploy", "types", "doctor", "config", "account", "login", "previews", "productions", "worker", "tokens", "secrets", "ai", "remote", "help", "version"];
+export declare const CORE_COMMANDS: readonly ["init", "dev", "build", "deploy", "types", "doctor", "config", "account", "login", "previews", "productions", "worker", "tokens", "secrets", "tail", "ai", "remote", "help", "version"];
 //# sourceMappingURL=core.d.ts.map

package/dist/cli/help-pages/pages/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/help-pages/pages/core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,eAAO,MAAM,eAAe,EAAE,QAAQ,EAgbrC,CAAA;AAED,eAAO,MAAM,aAAa,2LAAW,CAAA"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/help-pages/pages/core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,eAAO,MAAM,eAAe,EAAE,QAAQ,EA+brC,CAAA;AAED,eAAO,MAAM,aAAa,mMAAW,CAAA"}

package/dist/cli/help-pages/pages/misc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../../src/cli/help-pages/pages/misc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,eAAO,MAAM,eAAe,EAAE,QAAQ,EA4KrC,CAAA"}
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../../src/cli/help-pages/pages/misc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,eAAO,MAAM,eAAe,EAAE,QAAQ,EAkNrC,CAAA"}

package/dist/cli/help-pages/shared.d.ts

@@ -1,5 +1,5 @@
 import type { HelpEntry, HelpPage } from './types.js';
-export declare const COMMANDS: readonly ['init', 'dev', 'build', 'deploy', 'types', 'doctor', 'config', 'account', 'login', 'previews', 'productions', 'worker', 'tokens', 'secrets', 'ai', 'remote', 'help', 'version'];
+export declare const COMMANDS: readonly ['init', 'dev', 'build', 'deploy', 'types', 'doctor', 'config', 'account', 'login', 'previews', 'productions', 'worker', 'tokens', 'secrets', 'tail', 'ai', 'remote', 'help', 'version'];
 export type Command = (typeof COMMANDS)[number];
 export declare const COMMAND_ALIASES: Record<string, string>;
 export declare const COMMON_OPTIONS: HelpEntry[];

package/dist/cli/help-pages/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/cli/help-pages/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAElD,eAAO,MAAM,QAAQ,YACpB,MAAM,EACN,KAAK,EACL,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,SAAS,CACA,CAAA;AACV,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,CAAA;AAEzD,eAAO,MAAM,cAAc,EAAE,SAAS,EAgBrC,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,SAG5B,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,SAAS,EAM9C,CAAA;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAErE;AAuBD,KAAK,iCAAiC,GAAG,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,SAAS,EAAE,EACpB,QAAQ,EAAE,SAAS,EAAE,EACrB,KAAK,CAAC,EAAE,MAAM,EAAE,KACZ,QAAQ,CAAA;AAmBb,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACxB,QAAQ,CAaV;AAED,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,QAAQ,EAAE,SAAS,EAAE,EACrB,KAAK,EAAE,MAAM,EAAE,GACb,QAAQ,CAUV;AAED,eAAO,MAAM,2BAA2B,mCAAsD,CAAA;AAE9F,eAAO,MAAM,+BAA+B,mCACW,CAAA"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/cli/help-pages/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAElD,eAAO,MAAM,QAAQ,YACpB,MAAM,EACN,KAAK,EACL,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,UAAU,EACV,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,SAAS,CACA,CAAA;AACV,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,CAAA;AAEzD,eAAO,MAAM,cAAc,EAAE,SAAS,EAgBrC,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,SAG5B,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,SAAS,EAM9C,CAAA;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAErE;AAuBD,KAAK,iCAAiC,GAAG,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,SAAS,EAAE,EACpB,QAAQ,EAAE,SAAS,EAAE,EACrB,KAAK,CAAC,EAAE,MAAM,EAAE,KACZ,QAAQ,CAAA;AAmBb,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACxB,QAAQ,CAaV;AAED,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,QAAQ,EAAE,SAAS,EAAE,EACrB,KAAK,EAAE,MAAM,EAAE,GACb,QAAQ,CAUV;AAED,eAAO,MAAM,2BAA2B,mCAAsD,CAAA;AAE9F,eAAO,MAAM,+BAA+B,mCACW,CAAA"}

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2BAA2B,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAUD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAgEpD;AAMD;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAyGzF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAA;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2BAA2B,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAUD;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAgEpD;AAMD;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CA4GzF"}

package/dist/cli/index.js

@@ -1,2 +1,2 @@
-import { n as runCli, t as parseArgs } from "../_chunks/cli-Ba6JBLOz.js";
+import { n as runCli, t as parseArgs } from "../_chunks/cli-Btoe8xx4.js";
 export { parseArgs, runCli };

package/dist/index.js

@@ -4,6 +4,6 @@ import { a as ConfigResourceResolutionError, d as configSchema, n as ConfigValid
 import { n as compileConfig, s as stringifyConfig } from "./_chunks/compiler-Dc97FkBg.js";
 import { t as workerName } from "./_chunks/workerName-CFJsLZA-.js";
 import { n as getDurableObjectOptions, t as durableObject } from "./_chunks/decorators-QmV57ixr.js";
-import { n as runCli, t as parseArgs } from "./_chunks/cli-Ba6JBLOz.js";
+import { n as runCli, t as parseArgs } from "./_chunks/cli-Btoe8xx4.js";
 import { i as vars, r as env } from "./_chunks/env-S0_nMVz1.js";
 export { ConfigNotFoundError, ConfigResourceResolutionError, ConfigValidationError, compileConfig, configSchema, defineConfig as default, defineConfig, durableObject, env, getDurableObjectOptions, loadConfig, loadResolvedConfig, parseArgs, preview, ref, runCli, stringifyConfig, vars, workerName };

package/dist/test/index.js

@@ -4511,6 +4511,18 @@ function createMockAISearchNamespace(options = {}) {
 //#endregion
 //#region src/test/offline-bindings.ts
 const SUPPORT_MATRIX = {
+	durableObjects: {
+		service: "durableObjects",
+		tier: "offline-native",
+		reason: "Miniflare executes Durable Object classes locally, so createTestContext() runs them fully offline. There is no pure in-memory createMockEnv() mock for a DO (a real instance needs the Miniflare runtime).",
+		recommendation: "Use createTestContext() (Miniflare-backed) to run Durable Objects locally; there is no standalone createMockEnv() DO fixture."
+	},
+	services: {
+		service: "services",
+		tier: "offline-native",
+		reason: "Miniflare resolves service bindings worker-to-worker locally, so createTestContext() runs them fully offline. There is no pure in-memory createMockEnv() mock (a real service binding needs the Miniflare runtime to wire the target Worker).",
+		recommendation: "Use createTestContext() (Miniflare-backed) for worker-to-worker service bindings; there is no standalone createMockEnv() service fixture."
+	},
 	rateLimits: {
 		service: "rateLimits",
 		tier: "offline-native",

package/dist/test/offline-bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"offline-bindings.d.ts","sourceRoot":"","sources":["../../src/test/offline-bindings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"offline-bindings.d.ts","sourceRoot":"","sources":["../../src/test/offline-bindings.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "devflare",
-	"version": "1.0.0-next.46",
+	"version": "1.0.0-next.48",
 	"description": "Devflare is a developer-first toolkit for Cloudflare Workers that sits on top of Miniflare and Wrangler-compatible config",
 	"repository": {
 		"type": "git",