@treeseed/core 0.6.17 → 0.6.19

package/dist/dev.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { spawn, spawnSync } from "node:child_process";
 import { createRequire } from "node:module";
 import { dirname, resolve, sep } from "node:path";
@@ -7,10 +7,17 @@ import { setTimeout as delay } from "node:timers/promises";
 import {
   applyTreeseedEnvironmentToProcess,
   assertTreeseedCommandEnvironment,
+  createPersistentDeployTarget,
+  ensureGeneratedWranglerConfig,
   ensureLocalWorkspaceLinks,
   findNearestTreeseedWorkspaceRoot,
-  resolveTreeseedToolBinary
+  packageScriptPath,
+  resolveTreeseedMachineEnvironmentValues,
+  resolveTreeseedToolBinary,
+  resolveWranglerBin,
+  stopKnownMailpitContainers
 } from "@treeseed/sdk/workflow-support";
+import { loadTreeseedDeployConfig } from "@treeseed/sdk/platform/deploy-config";
 import {
   startPollingWatch
 } from "./dev-watch.js";
@@ -21,6 +28,9 @@ const TREESEED_DEFAULT_WEB_PORT = 4321;
 const TREESEED_DEFAULT_API_HOST = "127.0.0.1";
 const TREESEED_DEFAULT_API_PORT = 3e3;
 const TREESEED_DEFAULT_MANAGER_PORT = 3100;
+const TREESEED_DEFAULT_MAILPIT_SMTP_HOST = "127.0.0.1";
+const TREESEED_DEFAULT_MAILPIT_SMTP_PORT = 1025;
+const TREESEED_DEFAULT_MAILPIT_UI_PORT = 8025;
 const DEV_RELOAD_FILE = "public/__treeseed/dev-reload.json";
 const DEFAULT_READINESS_TIMEOUT_MS = 9e4;
 const DEFAULT_PROCESS_READY_GRACE_MS = 1200;
@@ -106,12 +116,129 @@ function normalizeFeedbackMode(value) {
 function normalizeOpenMode(value) {
   return value ?? "auto";
 }
+function normalizeLocalRuntimeMode(value) {
+  return value === "provider" || value === "local" ? value : "auto";
+}
+function normalizeProvider(value, fallback = "local") {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : fallback;
+}
+function unsupportedProviderRuntimeMessage(kind, name, provider) {
+  return [
+    `Local provider runtime is not supported for ${kind} "${name}" with provider "${provider}".`,
+    `Set ${kind === "surface" ? "surfaces" : "services"}.${name}.local.runtime to "auto" or "local" in treeseed.site.yaml,`,
+    "or add a provider-local adapter before requiring provider runtime."
+  ].join(" ");
+}
+function fallbackWebProviderFromDeployConfig(deployConfig) {
+  const record = deployConfig && typeof deployConfig === "object" ? deployConfig : {};
+  return normalizeProvider(record.providers?.deploy, "local");
+}
+function selectWebLocalRuntime(surfaceConfig, providerFallback = "local") {
+  const record = surfaceConfig && typeof surfaceConfig === "object" ? surfaceConfig : {};
+  const provider = normalizeProvider(record.provider, providerFallback);
+  const requested = normalizeLocalRuntimeMode(record.local?.runtime);
+  if (provider === "cloudflare" && requested !== "local") {
+    return {
+      requested,
+      provider,
+      selected: "cloudflare-wrangler-local",
+      reason: "Cloudflare web surfaces support local Wrangler runtime."
+    };
+  }
+  if (requested === "provider") {
+    throw new Error(unsupportedProviderRuntimeMessage("surface", "web", provider));
+  }
+  return {
+    requested,
+    provider,
+    selected: "astro-local",
+    reason: requested === "local" ? "Configured to use the full local Astro runtime." : `Provider "${provider}" has no provider-local web runtime; using Astro local.`
+  };
+}
+function selectServiceLocalRuntime(serviceName, serviceConfig) {
+  const record = serviceConfig && typeof serviceConfig === "object" ? serviceConfig : {};
+  const provider = normalizeProvider(record.provider, "railway");
+  const requested = normalizeLocalRuntimeMode(record.local?.runtime);
+  if (requested === "provider") {
+    throw new Error(unsupportedProviderRuntimeMessage("service", serviceName, provider));
+  }
+  return {
+    requested,
+    provider,
+    selected: "node-local",
+    reason: requested === "local" ? "Configured to use the full local Node runtime." : `Provider "${provider}" has no provider-local service runtime; using Node local.`
+  };
+}
+function loadDevDeployConfig(tenantRoot) {
+  try {
+    return loadTreeseedDeployConfig(resolve(tenantRoot, "treeseed.site.yaml"));
+  } catch {
+    return null;
+  }
+}
+function generatedLocalWranglerPath(tenantRoot) {
+  return resolve(tenantRoot, ".treeseed", "generated", "environments", "local", "wrangler.toml");
+}
 function browserHost(host) {
   return host === "0.0.0.0" || host === "::" || host === "[::]" ? "127.0.0.1" : host;
 }
 function webUrlFor(host, port) {
   return `http://${browserHost(host)}:${port}`;
 }
+function dockerComposeIsAvailable(env) {
+  const docker = resolveTreeseedToolBinary("docker", { env });
+  if (!docker) return false;
+  const result = spawnSync(docker, ["compose", "version"], {
+    encoding: "utf8",
+    env
+  });
+  return (result.status ?? 1) === 0;
+}
+function resetActionForPath(id, label, path) {
+  return {
+    id,
+    label,
+    kind: "path",
+    path,
+    status: existsSync(path) ? "planned" : "skipped",
+    detail: existsSync(path) ? void 0 : "Path does not exist."
+  };
+}
+function createTreeseedIntegratedDevResetPlan(options) {
+  if (!options.enabled) {
+    return null;
+  }
+  const tenantRoot = options.tenantRoot;
+  const d1PersistTo = options.env.TREESEED_API_D1_LOCAL_PERSIST_TO?.trim() || resolve(tenantRoot, ".wrangler", "state", "v3", "d1");
+  return {
+    enabled: true,
+    actions: [
+      resetActionForPath("d1-state", "Remove local D1 state", d1PersistTo),
+      {
+        id: "mailpit",
+        label: options.mailpitEnabled ? "Reset Mailpit email runtime" : "Skip Mailpit email runtime",
+        kind: "service",
+        status: options.mailpitEnabled ? "planned" : "skipped",
+        detail: options.mailpitEnabled ? "The Treeseed-managed Mailpit container and inbox will be stopped and removed." : "Docker Compose is unavailable, so Mailpit is disabled for this local dev run."
+      },
+      resetActionForPath("wrangler-tmp", "Remove Wrangler temporary output", resolve(tenantRoot, ".wrangler", "tmp")),
+      resetActionForPath("worker-bundle", "Remove generated local worker bundle", resolve(tenantRoot, ".treeseed", "generated", "worker")),
+      resetActionForPath("dev-reload", "Remove browser reload marker", resolve(tenantRoot, DEV_RELOAD_FILE))
+    ],
+    preserved: [
+      ".env*",
+      "treeseed.site.yaml",
+      "src/env.yaml",
+      ".treeseed/config",
+      ".treeseed/generated/environments",
+      ".treeseed/state",
+      ".treeseed/workflow",
+      ".treeseed/workspace-links.json",
+      "migrations",
+      "node_modules"
+    ]
+  };
+}
 function createWatchEntries(tenantRoot, sdkPackageRoot) {
   const entries = [
     { kind: "tenant", root: resolve(tenantRoot, "src") },
@@ -147,7 +274,7 @@ function createWatchEntries(tenantRoot, sdkPackageRoot) {
 function isSurfaceIncluded(plan, id) {
   return plan.commands.some((command) => command.id === id);
 }
-function createSetupSteps(tenantRoot, setupMode, sdkPackageRoot, planLike, env) {
+function createSetupSteps(tenantRoot, setupMode, sdkPackageRoot, planLike, env, mailpitEnabled, usesCloudflareWebRuntime) {
   if (setupMode === "off") {
     return [
       {
@@ -164,6 +291,15 @@ function createSetupSteps(tenantRoot, setupMode, sdkPackageRoot, planLike, env)
     ["books", "Generate book/public artifacts", "scripts/aggregate-book.ts", "dist/scripts/aggregate-book.js"],
     ["worker-bundle", "Generate local worker bundle", "scripts/build-tenant-worker.ts", "dist/scripts/build-tenant-worker.js"]
   ];
+  const tenantBuild = usesCloudflareWebRuntime ? {
+    command: process.execPath,
+    args: [packageScriptPath("tenant-build")]
+  } : null;
+  const mailpit = resolveOptionalScriptEntrypoint(
+    sdkPackageRoot,
+    "scripts/ensure-mailpit.ts",
+    "dist/scripts/ensure-mailpit.js"
+  );
   const steps = [
     {
       id: "workspace-links",
@@ -174,11 +310,28 @@ function createSetupSteps(tenantRoot, setupMode, sdkPackageRoot, planLike, env)
     {
       id: "wrangler",
       label: "Verify Wrangler executable",
-      required: isSurfaceIncluded(planLike, "api"),
+      required: usesCloudflareWebRuntime || isSurfaceIncluded(planLike, "api"),
       status: "planned",
       detail: resolveTreeseedToolBinary("wrangler", { env }) ?? void 0
     },
-    ...coreScripts.map(([id, label, source, dist]) => {
+    ...usesCloudflareWebRuntime ? [
+      {
+        id: "wrangler-config",
+        label: "Generate local Wrangler config",
+        required: true,
+        status: "planned",
+        detail: generatedLocalWranglerPath(tenantRoot)
+      },
+      {
+        id: "web-build",
+        label: "Build local Cloudflare web runtime",
+        required: true,
+        command: tenantBuild?.command,
+        args: tenantBuild?.args,
+        status: tenantBuild ? "planned" : "failed",
+        detail: tenantBuild ? void 0 : "Unable to resolve the tenant build script."
+      }
+    ] : coreScripts.map(([id, label, source, dist]) => {
       const script = resolveOptionalScriptEntrypoint(packageRoot, source, dist);
       return {
         id,
@@ -192,12 +345,15 @@ function createSetupSteps(tenantRoot, setupMode, sdkPackageRoot, planLike, env)
     }),
     {
       id: "mailpit",
-      label: "Check optional Mailpit email runtime",
-      required: false,
-      status: "planned"
+      label: mailpitEnabled ? "Start Mailpit email runtime" : "Disable Mailpit email runtime",
+      required: mailpitEnabled,
+      command: mailpitEnabled ? mailpit?.command : void 0,
+      args: mailpitEnabled ? mailpit?.args : void 0,
+      status: mailpitEnabled ? mailpit ? "planned" : "failed" : "skipped",
+      detail: mailpitEnabled ? mailpit ? "Mailpit SMTP will listen on 127.0.0.1:1025 and the web UI on http://127.0.0.1:8025." : "Unable to resolve the Mailpit startup script." : "Docker Compose is unavailable, so Mailpit is disabled for this local dev run."
     }
   ];
-  if (isSurfaceIncluded(planLike, "api") && existsSync(resolve(tenantRoot, "migrations"))) {
+  if ((isSurfaceIncluded(planLike, "api") || usesCloudflareWebRuntime) && existsSync(resolve(tenantRoot, "migrations"))) {
     const migrate = resolveOptionalScriptEntrypoint(
       sdkPackageRoot,
       "scripts/tenant-d1-migrate-local.ts",
@@ -228,18 +384,41 @@ function createTreeseedIntegratedDevPlan(options = {}) {
   const apiPort = normalizePort(options.apiPort, TREESEED_DEFAULT_API_PORT);
   const managerPort = normalizePort(options.managerPort, TREESEED_DEFAULT_MANAGER_PORT);
   const includeServices = options.includeServices ?? (surface === "integrated" || surface === "services");
-  const projectId = options.projectId ?? process.env.TREESEED_PROJECT_ID;
-  const teamId = options.teamId ?? process.env.TREESEED_HOSTING_TEAM_ID;
-  const mergedEnv = { ...process.env, ...options.env ?? {} };
+  const machineEnv = resolveLocalMachineEnv(tenantRoot);
+  const mergedEnv = { ...process.env, ...machineEnv, ...options.env ?? {} };
+  const projectId = options.projectId ?? mergedEnv.TREESEED_PROJECT_ID;
+  const teamId = options.teamId ?? mergedEnv.TREESEED_HOSTING_TEAM_ID;
   const apiBaseUrl = options.apiHost != null || options.apiPort != null ? `http://${apiHost}:${apiPort}` : mergedEnv.TREESEED_API_BASE_URL?.trim() || `http://${apiHost}:${apiPort}`;
   const webUrl = surface === "integrated" || surface === "web" ? webUrlFor(webHost, webPort) : null;
   const sdkPackageRoot = resolvePackageRoot("@treeseed/sdk", tenantRoot);
+  const deployConfig = loadDevDeployConfig(tenantRoot);
+  const webLocalRuntime = selectWebLocalRuntime(deployConfig?.surfaces?.web, fallbackWebProviderFromDeployConfig(deployConfig));
+  const serviceLocalRuntimes = {
+    api: selectServiceLocalRuntime("api", deployConfig?.services?.api),
+    manager: selectServiceLocalRuntime("manager", deployConfig?.services?.manager),
+    worker: selectServiceLocalRuntime("worker", deployConfig?.services?.worker)
+  };
+  const usesCloudflareWebRuntime = webLocalRuntime.selected === "cloudflare-wrangler-local";
   const coreRunTsPath = resolve(packageRoot, "scripts", "run-ts.mjs");
   const webEntrypoint = resolveNodeEntrypoint(
     sdkPackageRoot,
     "scripts/tenant-astro-command.ts",
     "dist/scripts/tenant-astro-command.js"
   );
+  const wranglerEntrypoint = {
+    command: process.execPath,
+    args: [
+      resolveWranglerBin(),
+      "dev",
+      "--local",
+      "--config",
+      generatedLocalWranglerPath(tenantRoot),
+      "--ip",
+      webHost,
+      "--port",
+      String(webPort)
+    ]
+  };
   const apiEntrypoint = resolveTenantApiEntrypoint(tenantRoot, coreRunTsPath) ?? resolveNodeEntrypoint(
     packageRoot,
     "src/api/server.ts",
@@ -256,6 +435,8 @@ function createTreeseedIntegratedDevPlan(options = {}) {
     "dist/services/worker.js"
   );
   const watchEntries = watch ? createWatchEntries(tenantRoot, sdkPackageRoot) : [];
+  const mailpitEnabled = dockerComposeIsAvailable(mergedEnv);
+  const resetRequested = options.reset === true;
   const sharedEnv = {
     ...mergedEnv,
     TREESEED_LOCAL_DEV_MODE: mergedEnv.TREESEED_LOCAL_DEV_MODE ?? "cloudflare",
@@ -265,8 +446,22 @@ function createTreeseedIntegratedDevPlan(options = {}) {
     TREESEED_HOSTING_TEAM_ID: teamId ?? mergedEnv.TREESEED_HOSTING_TEAM_ID,
     TREESEED_API_D1_DATABASE_NAME: mergedEnv.TREESEED_API_D1_DATABASE_NAME ?? "SITE_DATA_DB",
     SITE_DATA_DB: mergedEnv.SITE_DATA_DB ?? "SITE_DATA_DB",
-    TREESEED_API_D1_LOCAL_PERSIST_TO: mergedEnv.TREESEED_API_D1_LOCAL_PERSIST_TO ?? resolve(tenantRoot, ".wrangler", "state", "v3", "d1")
+    TREESEED_API_D1_LOCAL_PERSIST_TO: mergedEnv.TREESEED_API_D1_LOCAL_PERSIST_TO ?? (usesCloudflareWebRuntime ? resolve(tenantRoot, ".treeseed", "generated", "environments", "local", ".wrangler", "state", "v3", "d1") : resolve(tenantRoot, ".wrangler", "state", "v3", "d1")),
+    TREESEED_FORM_TOKEN_SECRET: mergedEnv.TREESEED_FORM_TOKEN_SECRET ?? "treeseed-local-form-token-secret",
+    TREESEED_BETTER_AUTH_SECRET: mergedEnv.TREESEED_BETTER_AUTH_SECRET ?? "treeseed-local-better-auth-secret-minimum-32-characters",
+    TREESEED_AUTH_LOCAL_USE_MAILPIT: mailpitEnabled ? mergedEnv.TREESEED_AUTH_LOCAL_USE_MAILPIT ?? "true" : "false",
+    TREESEED_FORMS_LOCAL_USE_MAILPIT: mailpitEnabled ? mergedEnv.TREESEED_FORMS_LOCAL_USE_MAILPIT ?? "true" : "false",
+    TREESEED_MAILPIT_SMTP_HOST: mergedEnv.TREESEED_MAILPIT_SMTP_HOST ?? TREESEED_DEFAULT_MAILPIT_SMTP_HOST,
+    TREESEED_MAILPIT_SMTP_PORT: mergedEnv.TREESEED_MAILPIT_SMTP_PORT ?? String(TREESEED_DEFAULT_MAILPIT_SMTP_PORT),
+    TREESEED_MAILPIT_UI_PORT: mergedEnv.TREESEED_MAILPIT_UI_PORT ?? String(TREESEED_DEFAULT_MAILPIT_UI_PORT),
+    TREESEED_AUTH_EMAIL_FROM: mergedEnv.TREESEED_AUTH_EMAIL_FROM ?? "Treeseed Market <auth@treeseed.local>"
   };
+  const reset = createTreeseedIntegratedDevResetPlan({
+    tenantRoot,
+    env: sharedEnv,
+    mailpitEnabled,
+    enabled: resetRequested
+  });
   if (watch && feedbackMode === "live") {
     sharedEnv.TREESEED_PUBLIC_DEV_WATCH_RELOAD = sharedEnv.TREESEED_PUBLIC_DEV_WATCH_RELOAD || "true";
   }
@@ -274,11 +469,12 @@ function createTreeseedIntegratedDevPlan(options = {}) {
   if (surface === "integrated" || surface === "web") {
     commands.push({
       id: "web",
-      label: "Astro UI",
-      command: webEntrypoint.command,
-      args: [...webEntrypoint.args, "dev", "--host", webHost, "--port", String(webPort)],
+      label: usesCloudflareWebRuntime ? "Cloudflare Wrangler UI" : "Astro UI",
+      command: usesCloudflareWebRuntime ? wranglerEntrypoint.command : webEntrypoint.command,
+      args: usesCloudflareWebRuntime ? wranglerEntrypoint.args : [...webEntrypoint.args, "dev", "--host", webHost, "--port", String(webPort)],
       cwd: tenantRoot,
-      env: sharedEnv
+      env: sharedEnv,
+      localRuntime: webLocalRuntime
     });
   }
   if (surface === "integrated" || surface === "api") {
@@ -291,7 +487,8 @@ function createTreeseedIntegratedDevPlan(options = {}) {
       env: {
         ...sharedEnv,
         PORT: options.apiPort != null ? String(apiPort) : sharedEnv.PORT ?? String(apiPort)
-      }
+      },
+      localRuntime: serviceLocalRuntimes.api
     });
   }
   if (includeServices || surface === "manager") {
@@ -305,7 +502,8 @@ function createTreeseedIntegratedDevPlan(options = {}) {
         ...sharedEnv,
         PORT: options.managerPort != null ? String(managerPort) : sharedEnv.PORT ?? String(managerPort),
         TREESEED_MANAGER_BASE_URL: options.managerPort != null ? `http://${apiHost}:${managerPort}` : sharedEnv.TREESEED_MANAGER_BASE_URL ?? `http://${apiHost}:${managerPort}`
-      }
+      },
+      localRuntime: serviceLocalRuntimes.manager
     });
   }
   if (includeServices || surface === "worker") {
@@ -315,7 +513,8 @@ function createTreeseedIntegratedDevPlan(options = {}) {
       command: workerEntrypoint.command,
       args: workerEntrypoint.args,
       cwd: tenantRoot,
-      env: sharedEnv
+      env: sharedEnv,
+      localRuntime: serviceLocalRuntimes.worker
     });
   }
   const readyChecks = commands.map((command) => {
@@ -344,6 +543,15 @@ function createTreeseedIntegratedDevPlan(options = {}) {
       strategy: "process"
     };
   });
+  if (mailpitEnabled && setupMode !== "off") {
+    readyChecks.push({
+      id: "mailpit",
+      label: "Mailpit",
+      required: true,
+      strategy: "http",
+      url: `http://127.0.0.1:${sharedEnv.TREESEED_MAILPIT_UI_PORT ?? TREESEED_DEFAULT_MAILPIT_UI_PORT}`
+    });
+  }
   return {
     surface,
     setupMode,
@@ -353,10 +561,15 @@ function createTreeseedIntegratedDevPlan(options = {}) {
     tenantRoot,
     apiBaseUrl,
     webUrl,
-    setupSteps: createSetupSteps(tenantRoot, setupMode, sdkPackageRoot, { commands }, sharedEnv),
+    setupSteps: createSetupSteps(tenantRoot, setupMode, sdkPackageRoot, { commands }, sharedEnv, mailpitEnabled, usesCloudflareWebRuntime),
     readyChecks,
     watchEntries,
-    commands
+    commands,
+    localRuntimes: {
+      web: webLocalRuntime,
+      ...serviceLocalRuntimes
+    },
+    reset
   };
 }
 function defaultSignalRegistrar(signal, handler) {
@@ -372,6 +585,9 @@ function defaultPrepareEnvironment(tenantRoot) {
 function defaultKillProcess(pid, signal) {
   process.kill(pid, signal);
 }
+function defaultRemovePath(path) {
+  rmSync(path, { recursive: true, force: true });
+}
 function createManagedDevProcess(command, child) {
   let resolveExit = () => {
   };
@@ -441,6 +657,13 @@ function defaultWrite(line, stream) {
   const target = stream === "stderr" ? process.stderr : process.stdout;
   target.write(line);
 }
+function resolveLocalMachineEnv(tenantRoot) {
+  try {
+    return resolveTreeseedMachineEnvironmentValues(tenantRoot, "local");
+  } catch {
+    return {};
+  }
+}
 function emitEvent(options, write, event, stream = event.type === "error" ? "stderr" : "stdout") {
   if (options.json) {
     write(`${JSON.stringify({ schemaVersion: 1, kind: "treeseed.dev.event", ...event })}
@@ -452,6 +675,83 @@ function emitEvent(options, write, event, stream = event.type === "error" ? "std
   write(`${surface} ${String(message)}
 `, stream);
 }
+function runTreeseedIntegratedDevReset(reset, options, deps) {
+  if (!reset?.enabled) {
+    return null;
+  }
+  const results = reset.actions.map((action) => {
+    if (action.status === "skipped") {
+      emitEvent(options, deps.write, {
+        type: "reset",
+        status: action.status,
+        message: `${action.label}: skipped`,
+        detail: action
+      });
+      return action;
+    }
+    if (action.kind === "service") {
+      const stopped = deps.stopMailpitContainers();
+      const result = {
+        ...action,
+        status: stopped ? "removed" : "failed",
+        detail: stopped ? "Mailpit container state was reset." : "Unable to stop or remove the Treeseed-managed Mailpit container."
+      };
+      emitEvent(options, deps.write, {
+        type: "reset",
+        status: result.status,
+        message: `${result.label}: ${result.status}`,
+        detail: result
+      }, result.status === "failed" ? "stderr" : "stdout");
+      return result;
+    }
+    if (!action.path || !existsSync(action.path)) {
+      const result = {
+        ...action,
+        status: "skipped",
+        detail: action.detail ?? "Path does not exist."
+      };
+      emitEvent(options, deps.write, {
+        type: "reset",
+        status: result.status,
+        message: `${result.label}: skipped`,
+        detail: result
+      });
+      return result;
+    }
+    try {
+      deps.removePath(action.path);
+      const result = {
+        ...action,
+        status: "removed",
+        detail: action.path
+      };
+      emitEvent(options, deps.write, {
+        type: "reset",
+        status: result.status,
+        message: `${result.label}: removed`,
+        detail: result
+      });
+      return result;
+    } catch (error) {
+      const result = {
+        ...action,
+        status: "failed",
+        detail: error instanceof Error ? error.message : String(error)
+      };
+      emitEvent(options, deps.write, {
+        type: "reset",
+        status: result.status,
+        message: `${result.label}: failed`,
+        detail: result
+      }, "stderr");
+      return result;
+    }
+  });
+  return {
+    ...reset,
+    actions: results
+  };
+}
 function writePlan(plan, options, write) {
   if (options.json) {
     write(`${JSON.stringify({ schemaVersion: 1, kind: "treeseed.dev.plan", ok: true, payload: plan }, null, 2)}
@@ -466,12 +766,24 @@ function writePlan(plan, options, write) {
 `, "stdout");
   write(`feedback: ${plan.feedbackMode}
 `, "stdout");
+  if (plan.reset) {
+    write(`reset: enabled
+`, "stdout");
+    for (const action of plan.reset.actions) {
+      write(`- reset ${action.id}: ${action.status}${action.path ? ` ${action.path}` : ""}
+`, "stdout");
+    }
+  }
   if (plan.webUrl) {
     write(`web: ${plan.webUrl}
 `, "stdout");
   }
   write(`api: ${plan.apiBaseUrl}
 `, "stdout");
+  for (const [name, runtime] of Object.entries(plan.localRuntimes)) {
+    write(`runtime ${name}: ${runtime.selected} (${runtime.provider}, requested ${runtime.requested})${runtime.reason ? ` - ${runtime.reason}` : ""}
+`, "stdout");
+  }
   for (const command of plan.commands) {
     write(`- ${command.id}: ${command.command} ${command.args.join(" ")}
 `, "stdout");
@@ -582,9 +894,24 @@ function runLocalSetup(plan, options, deps) {
         status: step.required ? "failed" : "degraded",
         detail: "Wrangler was not found. Run `npx trsd install --json` and retry `npx trsd dev`."
       };
-    } else if (step.id === "mailpit") {
-      const docker = resolveTreeseedToolBinary("docker", { env: { ...process.env, ...plan.commands[0]?.env } });
-      result = docker ? { ...step, status: "completed", detail: `Docker detected at ${docker}; Mailpit remains optional for local dev.` } : { ...step, status: "degraded", detail: "Docker is unavailable, so Mailpit email previews are disabled." };
+    } else if (step.id === "wrangler-config") {
+      if (plan.setupMode === "check") {
+        result = { ...step, status: "skipped", detail: "Local Wrangler config generation was checked in non-mutating mode." };
+      } else {
+        try {
+          const { wranglerPath } = ensureGeneratedWranglerConfig(plan.tenantRoot, {
+            target: createPersistentDeployTarget("local"),
+            env: plan.commands[0]?.env
+          });
+          result = { ...step, status: "completed", detail: wranglerPath };
+        } catch (error) {
+          result = {
+            ...step,
+            status: "failed",
+            detail: error instanceof Error ? error.message : String(error)
+          };
+        }
+      }
     } else if (plan.setupMode === "check") {
       result = { ...step, status: step.status === "failed" ? "failed" : "skipped", detail: step.detail ?? "Skipped in setup check mode." };
     } else {
@@ -661,6 +988,8 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
   const openBrowser = deps.openBrowser ?? defaultOpenBrowser;
   const startWatch = deps.startWatch ?? startPollingWatch;
   const prepareEnvironment = deps.prepareEnvironment ?? defaultPrepareEnvironment;
+  const removePath = deps.removePath ?? defaultRemovePath;
+  const stopMailpit = deps.stopMailpitContainers ?? stopKnownMailpitContainers;
   prepareEnvironment(tenantRoot);
   const plan = createTreeseedIntegratedDevPlan({
     ...options,
@@ -674,6 +1003,20 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
     writePlan(plan, options, write);
     return 0;
   }
+  const resetResults = runTreeseedIntegratedDevReset(plan.reset, options, {
+    write,
+    removePath,
+    stopMailpitContainers: stopMailpit
+  });
+  const failedReset = resetResults?.actions.find((action) => action.status === "failed");
+  if (failedReset) {
+    emitEvent(options, write, {
+      type: "error",
+      message: `${failedReset.label} failed during dev reset.`,
+      detail: failedReset
+    });
+    return 1;
+  }
   const setupResults = runLocalSetup(plan, options, { spawnSync: spawnSyncProcess, write });
   const failedSetup = setupResults.find((step) => step.status === "failed" && step.required);
   if (failedSetup) {
@@ -753,7 +1096,7 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
         }
         const exitCode = signal === "SIGINT" ? 130 : signal === "SIGTERM" ? 143 : code ?? 0;
         const required = requiredSurfaceIds.has(command.id);
-        if (!readinessComplete || required) {
+        if (required) {
           emitEvent(options, write, {
             type: "error",
             surface: command.id,
@@ -764,14 +1107,15 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
           finalize(exitCode === 0 ? 1 : exitCode);
           return;
         }
+        const status = exitCode === 0 ? "idle" : "degraded";
         emitEvent(options, write, {
           type: "error",
           surface: command.id,
           exitCode,
           signal,
-          status: "degraded",
-          message: `${command.label} exited with ${signal ?? exitCode}; continuing because it is not a required surface.`
-        }, "stderr");
+          status,
+          message: readinessComplete ? `${command.label} exited with ${signal ?? exitCode}; continuing because it is not a required surface.` : `${command.label} exited during startup with ${signal ?? exitCode}; continuing because it is not a required surface.`
+        }, status === "idle" ? "stdout" : "stderr");
         void stopManagedProcess(managed, "SIGTERM", killProcess, 0).finally(() => {
           children.delete(command.id);
         });
@@ -821,6 +1165,22 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
                 sdkChanged: change.sdkChanged
               }
             });
+            if (commandsById.get("web")?.localRuntime?.selected === "cloudflare-wrangler-local" && (change.tenantChanged || change.packageChanged || change.sdkChanged)) {
+              const web = children.get("web");
+              if (web) {
+                await stopManagedProcess(web, "SIGTERM", killProcess, Math.min(shutdownGraceMs, 500));
+                children.delete("web");
+                exited.delete("web");
+              }
+              const setupResults2 = runLocalSetup(plan, options, { spawnSync: spawnSyncProcess, write });
+              const failedSetup2 = setupResults2.find((step) => step.status === "failed" && step.required);
+              if (failedSetup2) {
+                emitEvent(options, write, { type: "error", message: failedSetupMessage(failedSetup2), detail: failedSetup2 });
+                finalize(1);
+                return;
+              }
+              await restartCommand("web");
+            }
             if (change.packageChanged || change.sdkChanged) {
               await Promise.all([
                 restartCommand("api"),
@@ -853,8 +1213,9 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
         if (check.strategy === "http" && check.url) {
           ready = await waitForHttpReady(fetchFn, check.url, readinessTimeoutMs);
         } else {
+          const commandId = check.id;
           await delay(processReadyGraceMs);
-          ready = !exited.has(check.id) && children.has(check.id);
+          ready = !exited.has(commandId) && children.has(commandId);
         }
         if (settled) {
           return;
@@ -913,9 +1274,14 @@ async function runTreeseedIntegratedDev(options = {}, deps = {}) {
 export {
   TREESEED_DEFAULT_API_HOST,
   TREESEED_DEFAULT_API_PORT,
+  TREESEED_DEFAULT_MAILPIT_SMTP_HOST,
+  TREESEED_DEFAULT_MAILPIT_SMTP_PORT,
+  TREESEED_DEFAULT_MAILPIT_UI_PORT,
   TREESEED_DEFAULT_MANAGER_PORT,
   TREESEED_DEFAULT_WEB_HOST,
   TREESEED_DEFAULT_WEB_PORT,
   createTreeseedIntegratedDevPlan,
-  runTreeseedIntegratedDev
+  createTreeseedIntegratedDevResetPlan,
+  runTreeseedIntegratedDev,
+  runTreeseedIntegratedDevReset
 };

package/dist/env.yaml

@@ -120,6 +120,7 @@ entries:
     sensitivity: secret
     targets:
       - local-runtime
+      - github-secret
       - railway-secret
     scopes:
       - staging