@stacksjs/buddy 0.70.258 → 0.70.260

package/dist/commands/dev.js

@@ -1,1083 +1,6 @@
-import { execSync } from "node:child_process";
-import { existsSync, readdirSync, readFileSync } from "node:fs";
-import readline from "node:readline";
-import process from "node:process";
-import { bold, cyan, dim, green, intro, log, onUnknownSubcommand, outro, prompts, runCommand, yellow } from "@stacksjs/cli";
-import { homedir } from "node:os";
-import { dirname, join, relative } from "node:path";
-import { fileURLToPath } from "node:url";
-import { Action } from "@stacksjs/enums";
-import { libsPath, projectPath, stxPath } from "@stacksjs/path";
-import { ExitCode } from "@stacksjs/types";
-import { version } from "../../package.json";
-const DEV_BOOT_STARTING_LINE_COUNT = 3;
-function eraseDevBootStartingLines() {
-  if (!process.stdout.isTTY)
-    return;
-  for (let i = 0;i < DEV_BOOT_STARTING_LINE_COUNT; i++) {
-    readline.moveCursor(process.stdout, 0, -1);
-    readline.clearLine(process.stdout, 0);
-  }
-}
-let developmentRpx;
-function resolveRpxEntryPath() {
-  return [
-    projectPath("node_modules/@stacksjs/rpx/dist/index.js"),
-    join(homedir(), "Code/Tools/rpx/packages/rpx/dist/index.js"),
-    projectPath("pantry/@stacksjs/rpx/dist/src/index.js")
-  ].find((entry) => existsSync(entry)) ?? null;
-}
-async function importDevelopmentRpx() {
-  if (developmentRpx)
-    return developmentRpx;
-  const entry = resolveRpxEntryPath();
-  developmentRpx = entry ? await import(entry) : await import("@stacksjs/rpx");
-  return developmentRpx;
-}
-const activeRpxRegistryIds = [];
-let _actions;
-async function actions() {
-  if (!_actions)
-    _actions = await import("@stacksjs/actions");
-  return _actions;
-}
-export const interactiveDevChoices = [
-  { value: "all", title: "All" },
-  { value: "frontend", title: "Frontend" },
-  { value: "api", title: "Backend" },
-  { value: "dashboard", title: "Dashboard" },
-  { value: "desktop", title: "Desktop" },
-  { value: "native", title: "Native App" },
-  { value: "components", title: "Components" },
-  { value: "docs", title: "Documentation" }
-];
-export async function dispatchInteractiveDevSelection(selection, runners) {
-  if (!Object.hasOwn(runners, selection))
-    return !1;
-  await runners[selection]();
-  return !0;
-}
-export function resolvePrettyDevDomain(appUrl, nativeMode = !1) {
-  if (!appUrl || nativeMode)
-    return null;
-  try {
-    const hostname = new URL(/^https?:\/\//i.test(appUrl) ? appUrl : `https://${appUrl}`).hostname.toLowerCase();
-    if (hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1" || hostname === "0.0.0.0")
-      return null;
-    return hostname;
-  } catch {
-    return null;
-  }
-}
-export function shouldUsePrettyDevUrls(input) {
-  return input.domain !== null && !input.localhostOnly && (input.proxyManagedExternally || input.systemAuthorized);
-}
-const APPLICATION_VIEW_CANDIDATES = [
-  "app/index",
-  "app",
-  "dashboard/index",
-  "dashboard",
-  "home/index",
-  "home",
-  "composer",
-  "workspace/index",
-  "workspace",
-  "feed",
-  "portal",
-  "admin",
-  "account/index",
-  "account",
-  "profile/index",
-  "profile"
-], SITE_LAYOUT_NAMES = new Set(["default", "guest", "marketing", "site"]);
-export function normalizeDevelopmentEntryPath(path) {
-  const value = path?.trim();
-  if (!value || value === "/")
-    return "/";
-  try {
-    const parsed = new URL(value, "http://stacks.localhost");
-    return `${parsed.pathname}${parsed.search}${parsed.hash}`;
-  } catch {
-    return "/";
-  }
-}
-function configuredApplicationPath(root) {
-  if (process.env.APP_PATH)
-    return process.env.APP_PATH;
-  try {
-    return readFileSync(join(root, "config/app.ts"), "utf8").match(/^[ \t]*appPath\s*:\s*(['"`])([^'"`]+)\1/m)?.[2];
-  } catch {
-    return;
-  }
-}
-function configuredDevelopmentLaunch(root) {
-  const environmentValue = process.env.STACKS_DEV_LAUNCH?.trim().toLowerCase();
-  if (environmentValue === "browser" || environmentValue === "native")
-    return environmentValue;
-  try {
-    const value = readFileSync(join(root, "config/app.ts"), "utf8").match(/\bdevLaunch\s*:\s*(['"`])(browser|native)\1/)?.[2];
-    return value === "browser" || value === "native" ? value : void 0;
-  } catch {
-    return;
-  }
-}
-export function resolveDevelopmentLaunch(input = {}) {
-  if (input.browser || input.site)
-    return "browser";
-  if (input.native)
-    return "native";
-  const root = input.root ?? projectPath();
-  return input.configuredLaunch ?? configuredDevelopmentLaunch(root) ?? "browser";
-}
-function viewSource(root, route) {
-  const base = join(root, "resources/views", route);
-  for (const extension of ["stx", "vue", "html"]) {
-    const path = `${base}.${extension}`;
-    if (existsSync(path))
-      try {
-        return readFileSync(path, "utf8");
-      } catch {
-        return "";
-      }
-  }
-  return;
-}
-function usesApplicationLayout(source) {
-  const layout = source.match(/@extends\(\s*['"]layouts\/([^'"]+)['"]\s*\)/)?.[1] ?? source.match(/@layout\(\s*['"]layouts\/([^'"]+)['"]\s*\)/)?.[1];
-  if (!layout)
-    return !1;
-  return !SITE_LAYOUT_NAMES.has(layout.split("/").at(-1) ?? layout);
-}
-export function resolveDevelopmentEntryPath(input = {}) {
-  if (input.site)
-    return "/";
-  const root = input.root ?? projectPath(), configuredPath = input.configuredPath ?? configuredApplicationPath(root);
-  if (configuredPath)
-    return normalizeDevelopmentEntryPath(configuredPath);
-  const loginExists = viewSource(root, "login") !== void 0 || viewSource(root, "auth/login") !== void 0, candidates = APPLICATION_VIEW_CANDIDATES.map((route) => ({ route, source: viewSource(root, route) })).filter((candidate) => candidate.source !== void 0), appCandidate = candidates.find((candidate) => usesApplicationLayout(candidate.source)) ?? (loginExists ? candidates[0] : void 0);
-  if (appCandidate)
-    return normalizeDevelopmentEntryPath(`/${appCandidate.route.replace(/\/index$/, "")}`);
-  return loginExists ? "/login" : "/";
-}
-export function developmentUrl(baseUrl, entryPath) {
-  const normalized = normalizeDevelopmentEntryPath(entryPath);
-  if (normalized === "/")
-    return baseUrl.replace(/\/$/, "");
-  return new URL(normalized, `${baseUrl.replace(/\/$/, "")}/`).toString();
-}
-export function developmentBrowserCommand(url, platform = process.platform) {
-  if (platform === "darwin")
-    return ["open", url];
-  if (platform === "win32")
-    return ["cmd", "/c", "start", "", url];
-  return ["xdg-open", url];
-}
-function openDevelopmentBrowser(url) {
-  if (!process.stdout.isTTY || process.env.CI || process.env.STACKS_DEV_NO_OPEN === "1")
-    return;
-  try {
-    Bun.spawn(developmentBrowserCommand(url), {
-      stdin: "ignore",
-      stdout: "ignore",
-      stderr: "ignore"
-    }).unref();
-  } catch {}
-}
-async function canStartPrettyDevProxy() {
-  if (await waitForHttpsProxy(443, 150))
-    return !0;
-  try {
-    const { authorizeSystemAccess } = await importDevelopmentRpx();
-    return authorizeSystemAccess({ interactive: !1 });
-  } catch {
-    return !1;
-  }
-}
-export function dev(buddy) {
-  const descriptions = {
-    dev: "Start development server",
-    frontend: "Start the frontend development server",
-    components: "Start the Components development server",
-    desktop: "Start the Desktop App development server",
-    native: "Start the app in a native Craft window",
-    dashboard: "Start the Dashboard development server",
-    api: "Start the local API development server",
-    docs: "Start the Documentation development server",
-    systemTray: "Start the System Tray development server",
-    interactive: "Get asked which development server to start",
-    select: "Which development server are you trying to start?",
-    withLocalhost: "Include the localhost URL in the output",
-    browser: "Open the application in a browser instead of its configured native window",
-    site: "Open the marketing site instead of the application",
-    project: "Target a specific project",
-    verbose: "Enable verbose output"
-  };
-  buddy.command("dev [server]", descriptions.dev).option("-f, --frontend", descriptions.frontend).option("-a, --api", descriptions.api).option("-c, --components", descriptions.components).option("-d, --dashboard", descriptions.dashboard).option("-k, --desktop", descriptions.desktop).option("-n, --native", descriptions.native).option("-o, --docs", descriptions.docs).option("-s, --system-tray", descriptions.systemTray).option("-i, --interactive", descriptions.interactive, { default: !1 }).option("-l, --with-localhost", descriptions.withLocalhost, { default: !1 }).option("--browser", descriptions.browser, { default: !1 }).option("--site", descriptions.site, { default: !1 }).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (server, options) => {
-    const perf = Bun.nanoseconds();
-    process.env.STACKS_DEV_ENTRY_PATH = resolveDevelopmentEntryPath({ site: options.site });
-    const target = server || (options.frontend ? "frontend" : void 0) || (options.api ? "api" : void 0) || (options.components ? "components" : void 0) || (options.dashboard ? "dashboard" : void 0) || (options.desktop ? "desktop" : void 0) || (options.native ? "native" : void 0) || (options.systemTray || options["system-tray"] ? "system-tray" : void 0) || (options.docs ? "docs" : void 0);
-    if (target) {
-      const serverOptions = { ...options }, a = await actions();
-      switch (target) {
-        case "native":
-          await startDevelopmentServer({ ...serverOptions, native: !0 }, perf);
-          break;
-        case "frontend":
-          await a.runFrontendDevServer(serverOptions);
-          break;
-        case "api":
-          await a.runApiDevServer(serverOptions);
-          break;
-        case "components":
-          await a.runComponentsDevServer(serverOptions);
-          break;
-        case "dashboard":
-          await a.runDashboardDevServer(serverOptions);
-          break;
-        case "desktop":
-          await startDevelopmentServer({ ...serverOptions, native: !0 }, perf);
-          break;
-        case "system-tray":
-          await a.runSystemTrayDevServer(serverOptions);
-          break;
-        case "docs":
-          await a.runDocsDevServer(serverOptions);
-          break;
-        default:
-          log.error(`Unknown server: ${target}`);
-          process.exit(ExitCode.InvalidArgument);
-      }
-    } else if (wantsInteractive(options)) {
-      const selectedValue = (await prompts({
-        type: "select",
-        name: "value",
-        message: descriptions.select,
-        choices: interactiveDevChoices
-      })).value, a = await actions();
-      if (!await dispatchInteractiveDevSelection(selectedValue, {
-        all: () => startDevelopmentServer(options, perf),
-        frontend: () => a.runFrontendDevServer(options),
-        api: () => a.runApiDevServer(options),
-        dashboard: () => a.runDashboardDevServer(options),
-        desktop: () => startDevelopmentServer({ ...options, native: !0 }, perf),
-        native: () => startDevelopmentServer({ ...options, native: !0 }, perf),
-        components: () => a.runComponentsDevServer(options),
-        docs: () => a.runDocsDevServer(options)
-      })) {
-        log.error("Invalid option during interactive mode");
-        process.exit(ExitCode.InvalidArgument);
-      }
-    } else
-      await startDevelopmentServer(options, perf);
-    outro("Exited", { startTime: perf, useSeconds: !0 });
-    process.exit(ExitCode.Success);
-  });
-  buddy.command("dev:components", descriptions.components).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    const perf = await intro("buddy dev:components"), result = await runCommand("bun run dev", {
-      cwd: libsPath("components/stx")
-    });
-    if (options.verbose)
-      log.info("buddy dev:components result", result);
-    if (result.isErr) {
-      await outro("While running the dev:components command, there was an issue", { startTime: perf, useSeconds: !0 }, result.error);
-      process.exit(ExitCode.FatalError);
-    }
-    console.log("");
-    await outro("Exited", { startTime: perf, useSeconds: !0 });
-    process.exit(ExitCode.Success);
-  });
-  buddy.command("dev:docs", descriptions.docs).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    const perf = await intro("buddy dev:docs"), result = await (await actions()).runAction(Action.DevDocs, options);
-    if (result.isErr) {
-      await outro("While running the dev:docs command, there was an issue", { startTime: perf, useSeconds: !0 }, result.error);
-      process.exit(ExitCode.FatalError);
-    }
-    console.log("");
-    await outro("Exited", { startTime: perf, useSeconds: !0 });
-    process.exit(ExitCode.Success);
-  });
-  buddy.command("dev:native", descriptions.native).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    const perf = await intro("buddy dev:native");
-    await startDevelopmentServer({ ...options, native: !0 }, perf);
-  });
-  buddy.command("dev:desktop", descriptions.desktop).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    const perf = await intro("buddy dev:desktop");
-    await startDevelopmentServer({ ...options, native: !0 }, perf);
-  });
-  buddy.command("dev:api", descriptions.api).option("-p, --project [project]", descriptions.project, { default: !1 }).option("--no-watch-types", "Skip the model/config type-regeneration watcher", { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    const a = await actions();
-    if (options.watchTypes !== !1)
-      a.watchTypes(options).catch((err) => {
-        log.warn("[dev:api] type watcher exited:", err);
-      });
-    await a.runApiDevServer(options);
-  });
-  buddy.command("dev:frontend", descriptions.frontend).alias("dev:pages").alias("dev:views").option("-p, --project [project]", descriptions.project, { default: !1 }).option("--site", descriptions.site, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    process.env.STACKS_DEV_ENTRY_PATH = resolveDevelopmentEntryPath({ site: options.site });
-    await (await actions()).runFrontendDevServer(options);
-  });
-  buddy.command("dev:dashboard", descriptions.dashboard).alias("dev:admin").option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    await (await actions()).runDashboardDevServer(options);
-  });
-  buddy.command("dev:system-tray", descriptions.systemTray).alias("dev:tray").option("-p, --project [project]", descriptions.project, { default: !1 }).option("--verbose", descriptions.verbose, { default: !1 }).action(async (options) => {
-    await (await actions()).runSystemTrayDevServer(options);
-  });
-  onUnknownSubcommand(buddy, "dev");
-}
-export async function startDevelopmentServer(_options, _startTime) {
-  const options = _options, startedAt = _startTime, appUrl = process.env.APP_URL ?? "stacks.localhost", nativeMode = resolveDevelopmentLaunch({
-    browser: options.browser,
-    native: options.native,
-    site: options.site
-  }) === "native", entryPath = resolveDevelopmentEntryPath({ site: options.site });
-  process.env.STACKS_DEV_ENTRY_PATH = entryPath;
-  const proxyManagedExternally = process.env.STACKS_PROXY_MANAGED === "1", preferredFrontendPort = Number(process.env.PORT) || 3000, preferredApiPort = Number(process.env.PORT_API) || 3008, preferredDocsPort = Number(process.env.PORT_DOCS) || 3006, preferredDashboardPort = Number(process.env.PORT_ADMIN) || 3002;
-  if (process.env.STACKS_DEV_NO_KILL !== "1")
-    await cleanupStaleDevProcesses([
-      preferredFrontendPort,
-      preferredApiPort,
-      preferredDocsPort,
-      preferredDashboardPort
-    ]);
-  const portShifts = [], claimPort = async (label, preferred) => {
-    if (proxyManagedExternally)
-      return preferred;
-    const port = await findAvailablePort(preferred);
-    if (port !== preferred)
-      portShifts.push(`${label} :${preferred} \u2192 :${port}`);
-    return port;
-  }, frontendPort = await claimPort("Frontend", preferredFrontendPort), apiPort = await claimPort("API", preferredApiPort), docsPort = await claimPort("Docs", preferredDocsPort), dashboardPort = await claimPort("Dashboard", preferredDashboardPort);
-  process.env.PORT = String(frontendPort);
-  process.env.PORT_API = String(apiPort);
-  process.env.PORT_DOCS = String(docsPort);
-  process.env.PORT_ADMIN = String(dashboardPort);
-  const includeDashboard = process.env.STACKS_DEV_DASHBOARD === "1", domain = resolvePrettyDevDomain(appUrl, nativeMode), appLooksCustom = domain !== null, localhostOnly = process.env.STACKS_DEV_LOCALHOST === "1", prettyUrlsRequested = appLooksCustom && !localhostOnly, systemAuthorized = !prettyUrlsRequested || proxyManagedExternally ? !0 : await canStartPrettyDevProxy(), usePrettyUrls = shouldUsePrettyDevUrls({
-    domain,
-    localhostOnly,
-    proxyManagedExternally,
-    systemAuthorized
-  }), prettySetupRequired = prettyUrlsRequested && !usePrettyUrls, hasCustomDomain = usePrettyUrls && !proxyManagedExternally, displayedDomain = usePrettyUrls ? domain : null, dashboardDomain = displayedDomain ? `dashboard.${displayedDomain}` : null, frontendBaseUrl = displayedDomain ? `https://${displayedDomain}` : `http://localhost:${frontendPort}`, frontendUrl = developmentUrl(frontendBaseUrl, entryPath), apiUrl = displayedDomain ? `https://${displayedDomain}/api` : `http://localhost:${apiPort}`, docsUrl = displayedDomain ? `https://${displayedDomain}/docs` : `http://localhost:${docsPort}`, dashboardUrl = dashboardDomain ? `https://${dashboardDomain}` : `http://localhost:${dashboardPort}`;
-  process.env.STACKS_PROXY_MANAGED = "1";
-  process.env.STACKS_DEV_QUIET = "1";
-  console.log();
-  if (prettySetupRequired) {
-    console.log(`  ${yellow("\u26A0")}  ${yellow("Pretty URL setup required")} ${dim("- using localhost for this session")}`);
-    console.log(`  ${dim("    ")}${dim("Run `./buddy setup:ssl` once, then restart `./buddy dev`.")}`);
-    console.log();
-  }
-  if (portShifts.length > 0) {
-    console.log(`  ${yellow("\u26A0")}  ${yellow("Ports in use by another process")} ${dim(`- ${portShifts.join(", ")}`)}`);
-    console.log();
-  }
-  console.log(`  ${bold(cyan("stacks"))} ${dim(`v${version}`)}  ${dim("starting\u2026")}`);
-  console.log();
-  const rpxTlsPreflight = hasCustomDomain && domain ? prepareRpxTlsForDev({ domain, includeDashboard, options }) : Promise.resolve();
-  if (localhostOnly && domain && !proxyManagedExternally)
-    removeStalePublicDomainOverrides(domain, includeDashboard, options.verbose ?? !1).catch(() => {});
-  rpxTlsPreflight.catch(() => {});
-  let isExiting = !1, closeNativeApp;
-  const SHUTDOWN_GRACE_MS = 1500, cleanup = () => {
-    if (isExiting)
-      return;
-    isExiting = !0;
-    closeNativeApp?.();
-    const rpxTeardown = (async () => {
-      try {
-        await unregisterRpxProxies(activeRpxRegistryIds);
-        activeRpxRegistryIds.length = 0;
-        if (hasCustomDomain && domain)
-          await removeStalePublicDomainOverrides(domain, includeDashboard, options.verbose ?? !1);
-      } catch {}
-    })(), teardownDeadline = new Promise((resolve) => setTimeout(resolve, SHUTDOWN_GRACE_MS));
-    Promise.race([rpxTeardown, teardownDeadline]).finally(() => {
-      try {
-        process.kill(-process.pid, "SIGTERM");
-      } catch {
-        try {
-          process.kill(0, "SIGTERM");
-        } catch {}
-      }
-      setTimeout(() => {
-        try {
-          process.kill(0, "SIGKILL");
-        } catch {
-          process.exit(1);
-        }
-      }, SHUTDOWN_GRACE_MS).unref();
-    });
-  };
-  process.on("SIGINT", cleanup);
-  process.on("SIGTERM", cleanup);
-  process.on("SIGHUP", cleanup);
-  const quietOpts = { ...options, quiet: !0 }, a = await actions(), ports = [
-    { name: "API", port: apiPort }
-  ], readinessTimeoutMs = 30000;
-  let readyAnnounced = !1;
-  const nativeUrl = developmentUrl(`http://localhost:${frontendPort}`, entryPath), nativeWindowReady = nativeMode ? waitForPort(frontendPort, readinessTimeoutMs).then(async (ready) => {
-    if (!ready) {
-      log.warn(`Native window skipped because the frontend did not answer within ${readinessTimeoutMs / 1000}s`);
-      return;
-    }
-    closeNativeApp = await launchNativeAppWindow(nativeUrl, options);
-  }) : Promise.resolve();
-  Promise.all(ports.map((p) => waitForPort(p.port, readinessTimeoutMs))).then(async (results) => {
-    if (readyAnnounced)
-      return;
-    readyAnnounced = !0;
-    const failed = results.map((ok, i) => ok ? null : ports[i]?.name ?? null).filter((x) => x !== null);
-    let proxyReachable = !1;
-    if (hasCustomDomain && domain) {
-      (async () => {
-        try {
-          await rpxTlsPreflight;
-          await registerRpxProxiesForDomain({
-            domain,
-            frontendPort,
-            apiPort,
-            docsPort,
-            dashboardPort,
-            includeDashboard,
-            options
-          });
-        } catch {}
-      })();
-      proxyReachable = await waitForHttpsProxy(443, 16000);
-      if (!proxyReachable) {
-        console.log(`  ${yellow("\u26A0")}  ${yellow("HTTPS proxy not reachable on :443")} \u2014 serving ${cyan(`http://localhost:${frontendPort}`)} instead`);
-        console.log(`  ${dim("    ")}${dim("rpx needs a valid SUDO_PASSWORD in .env to bind :443; trust the local CA, then restart `./buddy dev`.")}`);
-        if (options.verbose)
-          console.log(`  ${dim("    ")}${dim(`Trust CA: sh ${join(RPX_SSL_DIR, "trust-rpx-cert.sh")}`)}`);
-      }
-    }
-    eraseDevBootStartingLines();
-    printDevReadyBanner({
-      options,
-      nativeMode,
-      hasCustomDomain: !!appLooksCustom && !localhostOnly,
-      proxyReachable: proxyManagedExternally ? !0 : proxyReachable,
-      frontendUrl,
-      frontendBaseUrl,
-      entryPath,
-      apiUrl,
-      docsUrl,
-      dashboardUrl,
-      frontendPort,
-      apiPort,
-      docsPort,
-      includeDashboard,
-      domain,
-      dashboardPort,
-      dashboardDomain
-    });
-    if (!nativeMode) {
-      const browserUrl = hasCustomDomain && (proxyManagedExternally || proxyReachable) ? frontendUrl : developmentUrl(`http://localhost:${frontendPort}`, entryPath);
-      openDevelopmentBrowser(browserUrl);
-    }
-    if (startedAt) {
-      const elapsedMs = (Bun.nanoseconds() - startedAt) / 1e6, summary = failed.length ? `ready in ${(elapsedMs / 1000).toFixed(1)}s \u2014 ${failed.join(", ")} did not bind within ${readinessTimeoutMs / 1000}s` : `ready in ${(elapsedMs / 1000).toFixed(1)}s`;
-      console.log(`  ${dim(summary)}`);
-      console.log();
-      printDevEngineNotes();
-      console.log();
-    }
-    if (process.env.STACKS_PRINT_ROUTES === "1")
-      await printRegisteredRoutes(apiPort).catch(() => {});
-  }).catch(() => {});
-  await Promise.all([
-    a.runFrontendDevServer(quietOpts).catch((error) => {
-      if (options.verbose)
-        log.error(`Frontend: ${error}`);
-    }),
-    a.runApiDevServer(quietOpts).catch((error) => {
-      if (options.verbose)
-        log.error(`API: ${error}`);
-    }),
-    a.runDocsDevServer(quietOpts).catch((error) => {
-      if (options.verbose)
-        log.error(`Docs: ${error}`);
-    }),
-    includeDashboard ? a.runDashboardDevServer(quietOpts).catch((error) => {
-      if (options.verbose)
-        log.error(`Dashboard: ${error}`);
-    }) : Promise.resolve(),
-    nativeWindowReady.catch((error) => {
-      if (options.verbose)
-        log.warn(`Native window: ${error}`);
-    })
-  ]);
-}
-function isComingSoonMode() {
-  if (existsSync(projectPath("storage/framework/coming-soon")))
-    return !0;
-  try {
-    const idx = projectPath("resources/views/index.stx");
-    return existsSync(idx) && /siteMode\s*=\s*['"]coming-soon['"]/.test(readFileSync(idx, "utf8"));
-  } catch {
-    return !1;
-  }
-}
-function blogIsConfigured() {
-  try {
-    const dir = projectPath("content/blog");
-    return existsSync(dir) && readdirSync(dir).some((f) => f.endsWith(".md"));
-  } catch {
-    return !1;
-  }
-}
-function printDevReadyBanner(input) {
-  const {
-    options,
-    nativeMode,
-    hasCustomDomain,
-    proxyReachable,
-    frontendUrl,
-    frontendBaseUrl,
-    entryPath,
-    apiUrl,
-    docsUrl,
-    dashboardUrl,
-    frontendPort,
-    apiPort,
-    docsPort,
-    includeDashboard,
-    domain,
-    dashboardPort,
-    dashboardDomain
-  } = input, verbose = options.verbose ?? !1, useProxy = hasCustomDomain && proxyReachable, feUrl = useProxy ? frontendUrl : developmentUrl(`http://localhost:${frontendPort}`, entryPath), feBaseUrl = useProxy ? frontendBaseUrl : `http://localhost:${frontendPort}`, apUrl = useProxy ? apiUrl : `http://localhost:${apiPort}`, dcUrl = useProxy ? docsUrl : `http://localhost:${docsPort}`, dbUrl = useProxy ? dashboardUrl : `http://localhost:${dashboardPort}`, blogUrl = `${feBaseUrl}/blog`;
-  console.log();
-  const frontendLabel = entryPath === "/" ? "Site" : "App";
-  console.log(`  ${green("\u279C")}  ${bold(frontendLabel.padEnd(8))}:    ${cyan(feUrl)}`);
-  if (entryPath !== "/")
-    console.log(`  ${dim("\u279C")}  ${dim("Site")}:        ${dim(feBaseUrl)}`);
-  if (nativeMode)
-    console.log(`  ${green("\u279C")}  ${bold("Native")}:      ${cyan(`Craft \u2192 ${feUrl}`)}`);
-  console.log(`  ${green("\u279C")}  ${bold("API")}:         ${cyan(apUrl)}`);
-  console.log(`  ${green("\u279C")}  ${bold("Docs")}:        ${cyan(dcUrl)}`);
-  if (blogIsConfigured())
-    console.log(`  ${green("\u279C")}  ${bold("Blog")}:        ${cyan(blogUrl)}`);
-  if (includeDashboard)
-    console.log(`  ${green("\u279C")}  ${bold("Dashboard")}:   ${cyan(dbUrl)}`);
-  if (useProxy) {
-    console.log(`  ${dim("\u279C")}  ${dim("Direct")}:      ${dim(`${developmentUrl(`http://localhost:${frontendPort}`, entryPath)} (bypasses the proxy)`)}`);
-    if (includeDashboard && dashboardDomain)
-      console.log(`  ${dim("\u279C")}  ${dim("Direct")}:      ${dim(`http://localhost:${dashboardPort} (dashboard, bypasses the proxy)`)}`);
-  }
-  if (isComingSoonMode()) {
-    console.log();
-    console.log(`  ${yellow("\u25CF")}  ${bold(yellow("Coming soon mode"))} ${dim("\u2014 visitors see the holding page; bypass with the coming-soon secret.")}`);
-  }
-  if (verbose && domain) {
-    console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`localhost:${frontendPort} \u2192 ${domain}`)}`);
-    console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`${frontendBaseUrl}/api \u2192 localhost:${apiPort}`)}`);
-    console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`${frontendBaseUrl}/docs \u2192 localhost:${docsPort}`)}`);
-    if (includeDashboard)
-      console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`localhost:${dashboardPort} \u2192 ${dashboardDomain}`)}`);
-  }
-  console.log();
-}
-function printDevEngineNotes() {
-  const routesFile = stxPath("routes.ts"), routesLabel = relative(projectPath(), routesFile), crosswindConfig = join(projectPath(), "config/crosswind.ts");
-  if (existsSync(crosswindConfig) || existsSync(join(projectPath(), "crosswind.config.ts")))
-    console.log(`  ${green("[Crosswind]")} ${dim("CSS engine loaded")}`);
-  if (existsSync(routesFile))
-    try {
-      const routeCount = (readFileSync(routesFile, "utf8").match(/pattern:/g) ?? []).length;
-      if (routeCount > 0)
-        console.log(`  ${green("[stx]")} ${dim(`Generated ${routeCount} routes \u2192 ${routesLabel}`)}`);
-    } catch {
-      console.log(`  ${green("[stx]")} ${dim(`Routes manifest \u2192 ${routesLabel}`)}`);
-    }
-}
-async function launchNativeAppWindow(url, options) {
-  let createApp;
-  try {
-    createApp = (await importCraftSdk()).createApp;
-  } catch (error) {
-    if (options.verbose)
-      log.warn(`Native window unavailable: ${error}`);
-    console.log(`  ${dim("Native window unavailable. Install craft-native or set CRAFT_BIN to a Craft binary.")}
-`);
-    return;
-  }
-  if (!createApp) {
-    console.log(`  ${dim("Native window unavailable. The Craft SDK did not export createApp.")}
-`);
-    return;
-  }
-  const craftBinaryPath = resolveCraftBinaryPath();
-  if (!craftBinaryPath) {
-    console.log(`  ${dim("Native window unavailable. Set CRAFT_BIN to a Craft binary, or install Craft in ~/Code/Tools/craft.")}
-`);
-    return;
-  }
-  const appIconPath = resolveNativeAppIconPath(), app = createApp({
-    url,
-    quiet: !options.verbose,
-    craftPath: craftBinaryPath,
-    window: {
-      title: await resolveNativeAppTitle(),
-      width: 1280,
-      height: 860,
-      titlebarHidden: !0,
-      webSidebarMaterial: !0,
-      webSidebarWidth: 286,
-      webSidebarMaterialOpacity: 0.78,
-      ...appIconPath && { icon: appIconPath }
-    }
-  });
-  app.show().catch((error) => {
-    if (options.verbose)
-      log.warn(`Native window exited: ${error}`);
-  });
-  return () => app.close();
-}
-async function importCraftSdk() {
-  const localCraftSdk = process.env.HOME ? `${process.env.HOME}/Code/Tools/craft/packages/typescript/src/index.ts` : void 0;
-  if (localCraftSdk && existsSync(localCraftSdk))
-    return await import(localCraftSdk);
-  const packageNames = ["craft-native", "@craft-native/craft", "@stacksjs/ts-craft"];
-  let primaryError;
-  for (const packageName of packageNames)
-    try {
-      return await import(packageName);
-    } catch (error) {
-      primaryError ??= error;
-    }
-  throw primaryError;
-}
-async function cleanupStaleDevProcesses(ports) {
-  const projectRoot = projectPath(), actionDevPath = projectPath("storage/framework/core/actions/src/dev/"), pids = new Set;
-  for (const port of ports)
-    for (const pid of await listenerPids(port)) {
-      if (pid === process.pid)
-        continue;
-      const command = await commandForPid(pid);
-      if (!command.includes(projectRoot))
-        continue;
-      if (command.includes("storage/framework/core/buddy/src/cli.ts dev") || command.includes("storage/framework/core/actions/src/dev/") || command.includes(actionDevPath))
-        pids.add(pid);
-    }
-  if (pids.size === 0)
-    return;
-  for (const pid of pids)
-    try {
-      process.kill(pid, "SIGTERM");
-    } catch {}
-  await new Promise((r) => setTimeout(r, 250));
-  for (const pid of pids)
-    try {
-      process.kill(pid, "SIGKILL");
-    } catch {}
-  await new Promise((r) => setTimeout(r, 150));
-}
-async function listenerPids(port) {
-  try {
-    const proc = Bun.spawn(["lsof", "-nP", `-iTCP:${port}`, "-sTCP:LISTEN", "-t"], {
-      stdout: "pipe",
-      stderr: "ignore"
-    }), output = await new Response(proc.stdout).text();
-    await proc.exited;
-    return output.split(/\s+/).map((value) => Number(value)).filter((pid) => Number.isInteger(pid) && pid > 0);
-  } catch {
-    return [];
-  }
-}
-async function commandForPid(pid) {
-  try {
-    const proc = Bun.spawn(["ps", "-p", String(pid), "-o", "command="], {
-      stdout: "pipe",
-      stderr: "ignore"
-    }), output = await new Response(proc.stdout).text();
-    await proc.exited;
-    return output.trim();
-  } catch {
-    return "";
-  }
-}
-function resolveCraftBinaryPath() {
-  const home = process.env.HOME;
-  return [
-    process.env.CRAFT_BIN,
-    home ? `${home}/Code/Tools/craft/craft` : void 0,
-    home ? `${home}/Code/Tools/craft/bin/craft` : void 0,
-    home ? `${home}/Code/Tools/craft/packages/zig/zig-out/bin/craft` : void 0,
-    home ? `${home}/Documents/Projects/craft/packages/zig/zig-out/bin/craft` : void 0
-  ].filter((candidate) => Boolean(candidate)).find((candidate) => existsSync(candidate));
-}
-function resolveNativeAppIconPath() {
-  return [
-    projectPath("resources/assets/images/app-icon.png"),
-    projectPath("resources/assets/images/icon.png"),
-    projectPath("public/icon.png")
-  ].find((candidate) => existsSync(candidate));
-}
-async function resolveNativeAppTitle() {
-  try {
-    const pkg = await Bun.file(projectPath("package.json")).json(), name = typeof pkg.productName === "string" ? pkg.productName : pkg.name;
-    if (typeof name === "string" && name.length > 0)
-      return name.split(/[-_\s]+/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
-  } catch {}
-  return "Stacks App";
-}
-const METHOD_COLORS = {
-  GET: cyan,
-  POST: green,
-  PUT: cyan,
-  PATCH: cyan,
-  DELETE: cyan,
-  OPTIONS: dim
-};
-async function printRegisteredRoutes(apiPort) {
-  try {
-    const ac = new AbortController, t = setTimeout(() => ac.abort(), 1500), res = await fetch(`http://127.0.0.1:${apiPort}/__routes`, { signal: ac.signal }).catch(() => null);
-    clearTimeout(t);
-    if (!res || !res.ok)
-      return;
-    const routes = await res.json();
-    if (!Array.isArray(routes) || routes.length === 0)
-      return;
-    const sorted = [...routes].sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method)), longestPath = Math.max(...sorted.map((r) => r.path.length));
-    console.log(`  ${dim("Registered routes")}
-`);
-    for (const r of sorted) {
-      const method = (METHOD_COLORS[r.method.toUpperCase()] ?? dim)(r.method.toUpperCase().padEnd(6)), path = r.path.padEnd(longestPath), named = r.name ? `  ${dim(`(${r.name})`)}` : "";
-      console.log(`  ${method}  ${path}${named}`);
-    }
-    console.log();
-  } catch {}
-}
-async function probeDevServerHttp(port) {
-  for (const path of ["/__health", "/"])
-    if (await new Promise((resolve) => {
-      const ac = new AbortController, t = setTimeout(() => ac.abort(), path === "/" ? 8000 : 800);
-      fetch(`http://127.0.0.1:${port}${path}`, { signal: ac.signal, redirect: "manual" }).then(() => {
-        clearTimeout(t);
-        resolve(!0);
-      }).catch(() => {
-        clearTimeout(t);
-        resolve(!1);
-      });
-    }))
-      return !0;
-  return !1;
-}
-async function findAvailablePort(preferred, attempts = 20) {
-  for (let port = preferred;port < preferred + attempts; port++)
-    if (await portIsFree(port))
-      return port;
-  return preferred;
-}
-async function portIsFree(port) {
-  for (const host of ["127.0.0.1", "::1"])
-    if (await someoneIsListening(port, host))
-      return !1;
-  let server;
-  try {
-    server = Bun.serve({ port, hostname: "0.0.0.0", reusePort: !1, fetch: () => new Response });
-  } catch {
-    return !1;
-  }
-  server.stop(!0);
-  return !0;
-}
-async function someoneIsListening(port, host) {
-  const { connect } = await import("node:net");
-  return new Promise((resolve) => {
-    const socket = connect({ port, host }), finish = (listening) => {
-      socket.destroy();
-      resolve(listening);
-    };
-    socket.setTimeout(300, () => finish(!1));
-    socket.once("connect", () => finish(!0));
-    socket.once("error", () => finish(!1));
-  });
-}
-async function waitForPort(port, timeoutMs) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    if (await probeDevServerHttp(port))
-      return !0;
-    await new Promise((r) => setTimeout(r, 50));
-  }
-  return !1;
-}
-async function waitForHttpsProxy(port, timeoutMs) {
-  const { connect } = await import("node:net"), deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    if (await new Promise((resolve) => {
-      const socket = connect({ port, host: "127.0.0.1" }), finish = (v) => {
-        try {
-          socket.destroy();
-        } catch {}
-        resolve(v);
-      };
-      socket.once("connect", () => finish(!0));
-      socket.once("error", () => finish(!1));
-      setTimeout(() => finish(!1), 800).unref?.();
-    }))
-      return !0;
-    await new Promise((r) => setTimeout(r, 200));
-  }
-  return !1;
-}
-const RPX_SSL_DIR = join(homedir(), ".stacks", "ssl"), RPX_ROOT_CA_PATH = join(RPX_SSL_DIR, "rpx-root-ca.crt"), RPX_HOST_CERT_PATH = join(RPX_SSL_DIR, "rpx.localhost.crt");
-function buildDevelopmentTlsHostnames(domain, includeDashboard) {
-  return [
-    domain,
-    ...includeDashboard ? [`dashboard.${domain}`] : [],
-    "rpx.localhost"
-  ];
-}
-async function ensureRpxDevelopmentHttps(domain, options, includeDashboard, trustCertificate = !0) {
-  const verbose = options.verbose ?? !1, {
-    buildRegistryTlsProxyOptions,
-    certIncludesSanHostnames,
-    checkExistingCertificates,
-    clearSslConfigCache,
-    forceTrustCertificate,
-    generateCertificate,
-    getRegistryDir,
-    isDaemonRunning,
-    isRootCaTrustedForSsl,
-    readAll,
-    readCertCommonName,
-    stopDaemon,
-    trustRootCaForBrowsers,
-    verifyHttpsChain
-  } = await importDevelopmentRpx(), hostnames = buildDevelopmentTlsHostnames(domain, includeDashboard), entries = await readAll(getRegistryDir(), !1).catch(() => []);
-  for (const entry of entries) {
-    const host = entry.to?.trim();
-    if (host && !hostnames.includes(host))
-      hostnames.push(host);
-  }
-  const tlsOptions = buildRegistryTlsProxyOptions(hostnames, domain, verbose), hostnameInCert = certIncludesSanHostnames(RPX_HOST_CERT_PATH, hostnames), cnMatchesApp = readCertCommonName(RPX_HOST_CERT_PATH) === domain;
-  let certRegenerated = !1;
-  if (!await checkExistingCertificates(tlsOptions) || !hostnameInCert || !cnMatchesApp) {
-    clearSslConfigCache();
-    await generateCertificate({ ...tlsOptions, forceRegenerate: !0 });
-    certRegenerated = !0;
-  }
-  let trusted = isRootCaTrustedForSsl(RPX_ROOT_CA_PATH, domain, { verbose });
-  if (!trusted && trustCertificate) {
-    trusted = trustRootCaForBrowsers(RPX_ROOT_CA_PATH, { serverName: domain, verbose }) || await forceTrustCertificate(RPX_ROOT_CA_PATH, { serverName: domain, verbose }) || isRootCaTrustedForSsl(RPX_ROOT_CA_PATH, domain, { verbose });
-    if (trusted)
-      console.log(`  ${green("\u2713")}  ${dim("HTTPS")}:         ${dim("Local CA trusted \u2014 reload the browser if you still see a warning")}`);
-    else
-      console.log(`  ${yellow("\u26A0")}  ${yellow("HTTPS")}:         ${yellow(`Local CA not trusted \u2014 run: sh ${join(RPX_SSL_DIR, "trust-rpx-cert.sh")}`)}`);
-  } else if (verbose)
-    console.log(`  ${green("\u2713")}  ${dim("HTTPS")}:         ${dim("Local certificate trusted for SSL")}`);
-  const chainOk = existsSync(RPX_ROOT_CA_PATH) ? await verifyHttpsChain(domain, RPX_ROOT_CA_PATH) : !1;
-  if ((certRegenerated || !hostnameInCert || !cnMatchesApp) && await isDaemonRunning()) {
-    await stopDaemon({ timeoutMs: 8000 }).catch(() => {});
-    if (verbose)
-      log.info("Restarting rpx daemon to load TLS certificates for this app");
-  } else if (!chainOk && verbose)
-    console.log(`  ${dim("    ")}${dim("HTTPS chain not yet valid on :443 \u2014 daemon will (re)start after backends are ready")}`);
-}
-function resolveRpxDaemonSpawnCwd() {
-  const fromEnv = process.env.RPX_BIN || process.env.STACKS_RPX_BIN;
-  if (fromEnv && existsSync(fromEnv))
-    return dirname(fromEnv);
-  const bootstrap = join(dirname(fileURLToPath(import.meta.url)), "../../scripts/rpx-daemon-bootstrap.js");
-  if (existsSync(bootstrap))
-    return dirname(bootstrap);
-  return homedir();
-}
-async function resolveRpxDaemonSpawnCommand() {
-  const bootstrap = join(dirname(fileURLToPath(import.meta.url)), "../../scripts/rpx-daemon-bootstrap.js");
-  if (existsSync(bootstrap))
-    return [process.execPath, bootstrap];
-  const fromEnv = process.env.RPX_BIN || process.env.STACKS_RPX_BIN;
-  if (fromEnv && existsSync(fromEnv))
-    return [fromEnv, "daemon:start"];
-  const pkgUrl = import.meta.resolve("@stacksjs/rpx/package.json"), cli = join(dirname(fileURLToPath(pkgUrl)), "dist/bin/cli.js");
-  return [process.execPath, cli, "daemon:start"];
-}
-function buildRpxProxySpecs(input) {
-  const { domain, frontendPort, apiPort, docsPort, dashboardPort, includeDashboard } = input, dashboardDomain = `dashboard.${domain}`;
-  return [
-    {
-      id: `${domain}-frontend`,
-      from: `localhost:${frontendPort}`,
-      to: domain,
-      pathRewrites: [
-        { from: "/api", to: `localhost:${apiPort}`, stripPrefix: !1 },
-        { from: "/docs", to: `localhost:${docsPort}`, stripPrefix: !0 }
-      ]
-    },
-    ...includeDashboard ? [{ id: `${domain}-dashboard`, from: `localhost:${dashboardPort}`, to: dashboardDomain }] : []
-  ];
-}
-async function unregisterRpxProxies(ids) {
-  if (ids.length === 0)
-    return;
-  try {
-    const { removeEntry } = await importDevelopmentRpx();
-    for (const id of ids)
-      await removeEntry(id).catch(() => {});
-  } catch {}
-}
-async function removeStalePublicDomainOverrides(domain, includeDashboard, verbose) {
-  const { checkHosts, removeHosts, resolverFilePath, contentLooksLikeRpxResolver } = await importDevelopmentRpx(), hosts = [domain, ...includeDashboard ? [`dashboard.${domain}`] : []], present = await checkHosts(hosts, verbose).catch(() => hosts.map(() => !1)), staleHosts = hosts.filter((_, i) => present[i] === !0);
-  if (staleHosts.length > 0) {
-    await removeHosts(staleHosts, verbose).catch(() => {});
-    if ((await checkHosts(staleHosts, verbose).catch(() => staleHosts.map(() => !0))).some(Boolean))
-      log.warn(`Stale /etc/hosts entries still point ${staleHosts.join(", ")} at loopback. Remove them with: sudo nano /etc/hosts`);
-    else
-      log.info(`Removed stale /etc/hosts entries for ${staleHosts.join(", ")} (left by a previous dev session)`);
-  }
-  if (process.platform !== "darwin")
-    return;
-  const labels = domain.split("."), basename = labels.length >= 2 ? labels.slice(-2).join(".") : domain, resolverPath = resolverFilePath(basename);
-  let isRpxManaged = !1;
-  try {
-    isRpxManaged = contentLooksLikeRpxResolver(readFileSync(resolverPath, "utf8"));
-  } catch {}
-  if (!isRpxManaged)
-    return;
-  const quotedPath = `'${resolverPath.replace(/'/g, "'\\''")}'`, rm = process.env.SUDO_PASSWORD ? `printf '%s
-' "$SUDO_PASSWORD" | sudo -S rm -f ${quotedPath}` : `sudo -n rm -f ${quotedPath}`;
-  try {
-    execSync(rm, { stdio: ["pipe", "ignore", "ignore"] });
-    log.info(`Removed stale rpx DNS resolver ${resolverPath} (left by a previous dev session)`);
-    execSync("sudo -n dscacheutil -flushcache; sudo -n killall -HUP mDNSResponder; true", { stdio: ["pipe", "ignore", "ignore"] });
-  } catch {
-    log.warn(`A stale rpx DNS resolver still hijacks ${domain}. Remove it with: sudo rm ${resolverPath}`);
-  }
-}
-async function prepareRpxTlsForDev(input) {
-  const { domain, includeDashboard, options, skipHosts = !1, trustCertificate = !0 } = input, verbose = options.verbose ?? !1, hosts = [
-    domain,
-    ...includeDashboard ? [`dashboard.${domain}`] : []
-  ], hostsNeedingFile = hosts.filter((host) => {
-    const h = host.trim().toLowerCase();
-    return h !== "localhost" && !h.endsWith(".localhost") && !h.endsWith(".localhost.");
-  }), { addHosts, setupDevelopmentDns } = await importDevelopmentRpx(), dnsDomains = !skipHosts && hostsNeedingFile.length > 0 ? hosts : [];
-  if (dnsDomains.length > 0) {
-    if (!await setupDevelopmentDns({ domains: dnsDomains, verbose }).catch(() => !1) && verbose)
-      log.warn(`Dev DNS not configured for ${dnsDomains.join(", ")} \u2014 falling back to /etc/hosts`);
-  }
-  if (!skipHosts && hostsNeedingFile.length > 0)
-    await addHosts(hostsNeedingFile, verbose).catch((err) => {
-      log.warn(`Could not update /etc/hosts for ${hostsNeedingFile.join(", ")}: ${err.message}`);
-      log.warn("Add 127.0.0.1 entries manually or set SUDO_PASSWORD in .env");
-    });
-  await ensureRpxDevelopmentHttps(domain, options, includeDashboard, trustCertificate);
-}
-export async function setupPrettyDevEnvironment(input) {
-  const domain = resolvePrettyDevDomain(input.domain ?? process.env.APP_URL ?? "stacks.localhost");
-  if (!domain) {
-    log.info("APP_URL already uses localhost; no pretty URL setup is needed");
-    return !0;
-  }
-  const rpx = await importDevelopmentRpx();
-  if (!rpx.authorizeSystemAccess({ interactive: process.stdin.isTTY === !0 && process.stdout.isTTY === !0 })) {
-    log.error("Pretty URL setup needs administrator authorization to bind ports 80 and 443 and trust the local CA");
-    return !1;
-  }
-  await prepareRpxTlsForDev({
-    domain,
-    includeDashboard: process.env.STACKS_DEV_DASHBOARD === "1",
-    options: { verbose: input.verbose },
-    skipHosts: input.skipHosts,
-    trustCertificate: !input.skipTrust
-  });
-  const spawnEnv = {};
-  if (process.env.SUDO_PASSWORD)
-    spawnEnv.SUDO_PASSWORD = process.env.SUDO_PASSWORD;
-  if (input.verbose)
-    spawnEnv.RPX_VERBOSE = "1";
-  const rpxEntry = resolveRpxEntryPath();
-  if (rpxEntry)
-    spawnEnv.RPX_MODULE = rpxEntry;
-  await startRpxDaemonIfNeeded({
-    spawnCommand: await resolveRpxDaemonSpawnCommand(),
-    spawnEnv,
-    verbose: input.verbose ?? !1,
-    stopRpx: rpx.stopDaemon
-  });
-  const ready = await waitForHttpsProxy(443, 5000);
-  if (ready)
-    log.success(`Pretty URLs are ready at https://${domain}`);
-  else
-    log.error("rpx did not become reachable on port 443");
-  return ready;
-}
-async function startRpxDaemonIfNeeded(input) {
-  const { ensureDaemonRunning, isDaemonRunning: isRpxUp } = await importDevelopmentRpx();
-  if (await isRpxUp()) {
-    if (await waitForHttpsProxy(443, 1500))
-      return;
-    await input.stopRpx({ timeoutMs: 5000 }).catch(() => {});
-  }
-  const spawnOpts = {
-    spawnCommand: input.spawnCommand,
-    spawnCwd: resolveRpxDaemonSpawnCwd(),
-    startupTimeoutMs: 45000,
-    spawnEnv: input.spawnEnv,
-    verbose: input.verbose
-  };
-  try {
-    await ensureDaemonRunning(spawnOpts);
-  } catch (firstError) {
-    await input.stopRpx({ timeoutMs: 5000 }).catch(() => {});
-    await ensureDaemonRunning(spawnOpts).catch(() => {
-      throw firstError;
-    });
-  }
-}
-async function registerRpxProxiesForDomain(input) {
-  const { domain, frontendPort, apiPort, docsPort, dashboardPort, includeDashboard, options } = input, verbose = options.verbose ?? !1, proxies = buildRpxProxySpecs({ domain, frontendPort, apiPort, docsPort, dashboardPort, includeDashboard });
-  await unregisterRpxProxies([`${domain}-api`, `${domain}-docs`]);
-  const {
-    getRegistryDir,
-    readAll,
-    stopDaemon: stopRpx,
-    syncDevelopmentDnsFromRegistry,
-    writeEntry
-  } = await importDevelopmentRpx(), spawnCommand = await resolveRpxDaemonSpawnCommand(), spawnEnv = {};
-  if (process.env.SUDO_PASSWORD)
-    spawnEnv.SUDO_PASSWORD = process.env.SUDO_PASSWORD;
-  if (verbose)
-    spawnEnv.RPX_VERBOSE = "1";
-  const rpxEntry = resolveRpxEntryPath();
-  if (rpxEntry)
-    spawnEnv.RPX_MODULE = rpxEntry;
-  try {
-    await startRpxDaemonIfNeeded({ spawnCommand, spawnEnv, verbose, stopRpx });
-  } catch (error) {
-    const { isDaemonRunning } = await importDevelopmentRpx();
-    if (!await isDaemonRunning())
-      throw error;
-    if (verbose) {
-      const message = error instanceof Error ? error.message : String(error);
-      console.log(`  ${dim("    ")}${dim(`rpx daemon spawn skipped (${message}); reusing existing daemon`)}`);
-    }
-  }
-  const createdAt = new Date().toISOString();
-  for (const proxy of proxies) {
-    await writeEntry({
-      id: proxy.id,
-      from: proxy.from,
-      to: proxy.to,
-      cwd: process.cwd(),
-      createdAt,
-      pid: process.pid,
-      pathRewrites: proxy.pathRewrites
-    }, void 0, verbose);
-    if (!activeRpxRegistryIds.includes(proxy.id))
-      activeRpxRegistryIds.push(proxy.id);
-    if (verbose)
-      console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`https://${proxy.to} \u2192 ${proxy.from}`)}`);
-  }
-  const registryDir = getRegistryDir(), entries = await readAll(registryDir, verbose).catch(() => []);
-  await syncDevelopmentDnsFromRegistry(entries, { verbose, ownerPid: process.pid }).catch((err) => {
-    if (verbose) {
-      const message = err instanceof Error ? err.message : String(err);
-      console.log(`  ${dim("    ")}${dim(`Dev DNS sync: ${message}`)}`);
-    }
-  });
-}
-function wantsInteractive(options) {
-  return options.interactive;
-}
+import{execSync}from"node:child_process";import{existsSync,readdirSync,readFileSync}from"node:fs";import readline from"node:readline";import process from"node:process";import{bold,cyan,dim,green,intro,log,onUnknownSubcommand,outro,prompts,runCommand,yellow}from"@stacksjs/cli";import{homedir}from"node:os";import{dirname,join,relative}from"node:path";import{fileURLToPath}from"node:url";import{Action}from"@stacksjs/enums";import{libsPath,projectPath,stxPath}from"@stacksjs/path";import{ExitCode}from"@stacksjs/types";import{version}from"../../package.json";const DEV_BOOT_STARTING_LINE_COUNT=3;function eraseDevBootStartingLines(){if(!process.stdout.isTTY)return;for(let i=0;i<DEV_BOOT_STARTING_LINE_COUNT;i++){readline.moveCursor(process.stdout,0,-1);readline.clearLine(process.stdout,0)}}let developmentRpx;function resolveRpxEntryPath(){return[projectPath("node_modules/@stacksjs/rpx/dist/index.js"),join(homedir(),"Code/Tools/rpx/packages/rpx/dist/index.js"),projectPath("pantry/@stacksjs/rpx/dist/src/index.js")].find((entry)=>existsSync(entry))??null}async function importDevelopmentRpx(){if(developmentRpx)return developmentRpx;const entry=resolveRpxEntryPath();developmentRpx=entry?await import(entry):await import("@stacksjs/rpx");return developmentRpx}const activeRpxRegistryIds=[];let _actions;async function actions(){if(!_actions)_actions=await import("@stacksjs/actions");return _actions}export const interactiveDevChoices=[{value:"all",title:"All"},{value:"frontend",title:"Frontend"},{value:"api",title:"Backend"},{value:"dashboard",title:"Dashboard"},{value:"desktop",title:"Desktop"},{value:"native",title:"Native App"},{value:"components",title:"Components"},{value:"docs",title:"Documentation"}];export async function dispatchInteractiveDevSelection(selection,runners){if(!Object.hasOwn(runners,selection))return!1;await runners[selection]();return!0}export function resolvePrettyDevDomain(appUrl,nativeMode=!1){if(!appUrl||nativeMode)return null;try{const hostname=new URL(/^https?:\/\//i.test(appUrl)?appUrl:`https://${appUrl}`).hostname.toLowerCase();if(hostname==="localhost"||hostname==="127.0.0.1"||hostname==="::1"||hostname==="0.0.0.0")return null;return hostname}catch{return null}}export function shouldUsePrettyDevUrls(input){return input.domain!==null&&!input.localhostOnly&&(input.proxyManagedExternally||input.systemAuthorized)}const APPLICATION_VIEW_CANDIDATES=["app/index","app","dashboard/index","dashboard","home/index","home","composer","workspace/index","workspace","feed","portal","admin","account/index","account","profile/index","profile"],SITE_LAYOUT_NAMES=new Set(["default","guest","marketing","site"]);export function normalizeDevelopmentEntryPath(path){const value=path?.trim();if(!value||value==="/")return"/";try{const parsed=new URL(value,"http://stacks.localhost");return`${parsed.pathname}${parsed.search}${parsed.hash}`}catch{return"/"}}function configuredApplicationPath(root){if(process.env.APP_PATH)return process.env.APP_PATH;try{return readFileSync(join(root,"config/app.ts"),"utf8").match(/^[ \t]*appPath\s*:\s*(['"`])([^'"`]+)\1/m)?.[2]}catch{return}}function configuredDevelopmentLaunch(root){const environmentValue=process.env.STACKS_DEV_LAUNCH?.trim().toLowerCase();if(environmentValue==="browser"||environmentValue==="native")return environmentValue;try{const value=readFileSync(join(root,"config/app.ts"),"utf8").match(/\bdevLaunch\s*:\s*(['"`])(browser|native)\1/)?.[2];return value==="browser"||value==="native"?value:void 0}catch{return}}export function resolveDevelopmentLaunch(input={}){if(input.browser||input.site)return"browser";if(input.native)return"native";const root=input.root??projectPath();return input.configuredLaunch??configuredDevelopmentLaunch(root)??"browser"}function viewSource(root,route){const base=join(root,"resources/views",route);for(const extension of["stx","vue","html"]){const path=`${base}.${extension}`;if(existsSync(path))try{return readFileSync(path,"utf8")}catch{return""}}return}function usesApplicationLayout(source){const layout=source.match(/@extends\(\s*['"]layouts\/([^'"]+)['"]\s*\)/)?.[1]??source.match(/@layout\(\s*['"]layouts\/([^'"]+)['"]\s*\)/)?.[1];if(!layout)return!1;return!SITE_LAYOUT_NAMES.has(layout.split("/").at(-1)??layout)}export function resolveDevelopmentEntryPath(input={}){if(input.site)return"/";const root=input.root??projectPath(),configuredPath=input.configuredPath??configuredApplicationPath(root);if(configuredPath)return normalizeDevelopmentEntryPath(configuredPath);const loginExists=viewSource(root,"login")!==void 0||viewSource(root,"auth/login")!==void 0,candidates=APPLICATION_VIEW_CANDIDATES.map((route)=>({route,source:viewSource(root,route)})).filter((candidate)=>candidate.source!==void 0),appCandidate=candidates.find((candidate)=>usesApplicationLayout(candidate.source))??(loginExists?candidates[0]:void 0);if(appCandidate)return normalizeDevelopmentEntryPath(`/${appCandidate.route.replace(/\/index$/,"")}`);return loginExists?"/login":"/"}export function developmentUrl(baseUrl,entryPath){const normalized=normalizeDevelopmentEntryPath(entryPath);if(normalized==="/")return baseUrl.replace(/\/$/,"");return new URL(normalized,`${baseUrl.replace(/\/$/,"")}/`).toString()}export function developmentBrowserCommand(url,platform=process.platform){if(platform==="darwin")return["open",url];if(platform==="win32")return["cmd","/c","start","",url];return["xdg-open",url]}function openDevelopmentBrowser(url){if(!process.stdout.isTTY||process.env.CI||process.env.STACKS_DEV_NO_OPEN==="1")return;try{Bun.spawn(developmentBrowserCommand(url),{stdin:"ignore",stdout:"ignore",stderr:"ignore"}).unref()}catch{}}async function canStartPrettyDevProxy(){if(await waitForHttpsProxy(443,150))return!0;try{const{authorizeSystemAccess}=await importDevelopmentRpx();return authorizeSystemAccess({interactive:!1})}catch{return!1}}export function dev(buddy){const descriptions={dev:"Start development server",frontend:"Start the frontend development server",components:"Start the Components development server",desktop:"Start the Desktop App development server",native:"Start the app in a native Craft window",dashboard:"Start the Dashboard development server",api:"Start the local API development server",docs:"Start the Documentation development server",systemTray:"Start the System Tray development server",interactive:"Get asked which development server to start",select:"Which development server are you trying to start?",withLocalhost:"Include the localhost URL in the output",browser:"Open the application in a browser instead of its configured native window",site:"Open the marketing site instead of the application",project:"Target a specific project",verbose:"Enable verbose output"};buddy.command("dev [server]",descriptions.dev).option("-f, --frontend",descriptions.frontend).option("-a, --api",descriptions.api).option("-c, --components",descriptions.components).option("-d, --dashboard",descriptions.dashboard).option("-k, --desktop",descriptions.desktop).option("-n, --native",descriptions.native).option("-o, --docs",descriptions.docs).option("-s, --system-tray",descriptions.systemTray).option("-i, --interactive",descriptions.interactive,{default:!1}).option("-l, --with-localhost",descriptions.withLocalhost,{default:!1}).option("--browser",descriptions.browser,{default:!1}).option("--site",descriptions.site,{default:!1}).option("-p, --project [project]",descriptions.project,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(server,options)=>{const perf=Bun.nanoseconds();process.env.STACKS_DEV_ENTRY_PATH=resolveDevelopmentEntryPath({site:options.site});const target=server||(options.frontend?"frontend":void 0)||(options.api?"api":void 0)||(options.components?"components":void 0)||(options.dashboard?"dashboard":void 0)||(options.desktop?"desktop":void 0)||(options.native?"native":void 0)||(options.systemTray||options["system-tray"]?"system-tray":void 0)||(options.docs?"docs":void 0);if(target){const serverOptions={...options},a=await actions();switch(target){case"native":await startDevelopmentServer({...serverOptions,native:!0},perf);break;case"frontend":await a.runFrontendDevServer(serverOptions);break;case"api":await a.runApiDevServer(serverOptions);break;case"components":await a.runComponentsDevServer(serverOptions);break;case"dashboard":await a.runDashboardDevServer(serverOptions);break;case"desktop":await startDevelopmentServer({...serverOptions,native:!0},perf);break;case"system-tray":await a.runSystemTrayDevServer(serverOptions);break;case"docs":await a.runDocsDevServer(serverOptions);break;default:log.error(`Unknown server: ${target}`);process.exit(ExitCode.InvalidArgument)}}else if(wantsInteractive(options)){const selectedValue=(await prompts({type:"select",name:"value",message:descriptions.select,choices:interactiveDevChoices})).value,a=await actions();if(!await dispatchInteractiveDevSelection(selectedValue,{all:()=>startDevelopmentServer(options,perf),frontend:()=>a.runFrontendDevServer(options),api:()=>a.runApiDevServer(options),dashboard:()=>a.runDashboardDevServer(options),desktop:()=>startDevelopmentServer({...options,native:!0},perf),native:()=>startDevelopmentServer({...options,native:!0},perf),components:()=>a.runComponentsDevServer(options),docs:()=>a.runDocsDevServer(options)})){log.error("Invalid option during interactive mode");process.exit(ExitCode.InvalidArgument)}}else await startDevelopmentServer(options,perf);outro("Exited",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)});buddy.command("dev:components",descriptions.components).option("-p, --project [project]",descriptions.project,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{const perf=await intro("buddy dev:components"),result=await runCommand("bun run dev",{cwd:libsPath("components/stx")});if(options.verbose)log.info("buddy dev:components result",result);if(result.isErr){await outro("While running the dev:components command, there was an issue",{startTime:perf,useSeconds:!0},result.error);process.exit(ExitCode.FatalError)}console.log("");await outro("Exited",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)});buddy.command("dev:docs",descriptions.docs).option("-p, --project [project]",descriptions.project,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{const perf=await intro("buddy dev:docs"),result=await(await actions()).runAction(Action.DevDocs,options);if(result.isErr){await outro("While running the dev:docs command, there was an issue",{startTime:perf,useSeconds:!0},result.error);process.exit(ExitCode.FatalError)}console.log("");await outro("Exited",{startTime:perf,useSeconds:!0});process.exit(ExitCode.Success)});buddy.command("dev:native",descriptions.native).option("-p, --project [project]",descriptions.project,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{const perf=await intro("buddy dev:native");await startDevelopmentServer({...options,native:!0},perf)});buddy.command("dev:desktop",descriptions.desktop).option("-p, --project [project]",descriptions.project,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{const perf=await intro("buddy dev:desktop");await startDevelopmentServer({...options,native:!0},perf)});buddy.command("dev:api",descriptions.api).option("-p, --project [project]",descriptions.project,{default:!1}).option("--no-watch-types","Skip the model/config type-regeneration watcher",{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{const a=await actions();if(options.watchTypes!==!1)a.watchTypes(options).catch((err)=>{log.warn("[dev:api] type watcher exited:",err)});await a.runApiDevServer(options)});buddy.command("dev:frontend",descriptions.frontend).alias("dev:pages").alias("dev:views").option("-p, --project [project]",descriptions.project,{default:!1}).option("--site",descriptions.site,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{process.env.STACKS_DEV_ENTRY_PATH=resolveDevelopmentEntryPath({site:options.site});await(await actions()).runFrontendDevServer(options)});buddy.command("dev:dashboard",descriptions.dashboard).alias("dev:admin").option("-p, --project [project]",descriptions.project,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{await(await actions()).runDashboardDevServer(options)});buddy.command("dev:system-tray",descriptions.systemTray).alias("dev:tray").option("-p, --project [project]",descriptions.project,{default:!1}).option("--verbose",descriptions.verbose,{default:!1}).action(async(options)=>{await(await actions()).runSystemTrayDevServer(options)});onUnknownSubcommand(buddy,"dev")}export async function startDevelopmentServer(_options,_startTime){const options=_options,startedAt=_startTime,appUrl=process.env.APP_URL??"stacks.localhost",nativeMode=resolveDevelopmentLaunch({browser:options.browser,native:options.native,site:options.site})==="native",entryPath=resolveDevelopmentEntryPath({site:options.site});process.env.STACKS_DEV_ENTRY_PATH=entryPath;const proxyManagedExternally=process.env.STACKS_PROXY_MANAGED==="1",preferredFrontendPort=Number(process.env.PORT)||3000,preferredApiPort=Number(process.env.PORT_API)||3008,preferredDocsPort=Number(process.env.PORT_DOCS)||3006,preferredDashboardPort=Number(process.env.PORT_ADMIN)||3002;if(process.env.STACKS_DEV_NO_KILL!=="1")await cleanupStaleDevProcesses([preferredFrontendPort,preferredApiPort,preferredDocsPort,preferredDashboardPort]);const portShifts=[],claimPort=async(label,preferred)=>{if(proxyManagedExternally)return preferred;const port=await findAvailablePort(preferred);if(port!==preferred)portShifts.push(`${label} :${preferred} \u2192 :${port}`);return port},frontendPort=await claimPort("Frontend",preferredFrontendPort),apiPort=await claimPort("API",preferredApiPort),docsPort=await claimPort("Docs",preferredDocsPort),dashboardPort=await claimPort("Dashboard",preferredDashboardPort);process.env.PORT=String(frontendPort);process.env.PORT_API=String(apiPort);process.env.PORT_DOCS=String(docsPort);process.env.PORT_ADMIN=String(dashboardPort);const includeDashboard=process.env.STACKS_DEV_DASHBOARD==="1",domain=resolvePrettyDevDomain(appUrl,nativeMode),appLooksCustom=domain!==null,localhostOnly=process.env.STACKS_DEV_LOCALHOST==="1",prettyUrlsRequested=appLooksCustom&&!localhostOnly,systemAuthorized=!prettyUrlsRequested||proxyManagedExternally?!0:await canStartPrettyDevProxy(),usePrettyUrls=shouldUsePrettyDevUrls({domain,localhostOnly,proxyManagedExternally,systemAuthorized}),prettySetupRequired=prettyUrlsRequested&&!usePrettyUrls,hasCustomDomain=usePrettyUrls&&!proxyManagedExternally,displayedDomain=usePrettyUrls?domain:null,dashboardDomain=displayedDomain?`dashboard.${displayedDomain}`:null,frontendBaseUrl=displayedDomain?`https://${displayedDomain}`:`http://localhost:${frontendPort}`,frontendUrl=developmentUrl(frontendBaseUrl,entryPath),apiUrl=displayedDomain?`https://${displayedDomain}/api`:`http://localhost:${apiPort}`,docsUrl=displayedDomain?`https://${displayedDomain}/docs`:`http://localhost:${docsPort}`,dashboardUrl=dashboardDomain?`https://${dashboardDomain}`:`http://localhost:${dashboardPort}`;process.env.STACKS_PROXY_MANAGED="1";process.env.STACKS_DEV_QUIET="1";console.log();if(prettySetupRequired){console.log(`  ${yellow("\u26A0")}  ${yellow("Pretty URL setup required")} ${dim("- using localhost for this session")}`);console.log(`  ${dim("    ")}${dim("Run `./buddy setup:ssl` once, then restart `./buddy dev`.")}`);console.log()}if(portShifts.length>0){console.log(`  ${yellow("\u26A0")}  ${yellow("Ports in use by another process")} ${dim(`- ${portShifts.join(", ")}`)}`);console.log()}console.log(`  ${bold(cyan("stacks"))} ${dim(`v${version}`)}  ${dim("starting\u2026")}`);console.log();const rpxTlsPreflight=hasCustomDomain&&domain?prepareRpxTlsForDev({domain,includeDashboard,options}):Promise.resolve();if(localhostOnly&&domain&&!proxyManagedExternally)removeStalePublicDomainOverrides(domain,includeDashboard,options.verbose??!1).catch(()=>{});rpxTlsPreflight.catch(()=>{});let isExiting=!1,closeNativeApp;const SHUTDOWN_GRACE_MS=1500,cleanup=()=>{if(isExiting)return;isExiting=!0;closeNativeApp?.();const rpxTeardown=(async()=>{try{await unregisterRpxProxies(activeRpxRegistryIds);activeRpxRegistryIds.length=0;if(hasCustomDomain&&domain)await removeStalePublicDomainOverrides(domain,includeDashboard,options.verbose??!1)}catch{}})(),teardownDeadline=new Promise((resolve)=>setTimeout(resolve,SHUTDOWN_GRACE_MS));Promise.race([rpxTeardown,teardownDeadline]).finally(()=>{try{process.kill(-process.pid,"SIGTERM")}catch{try{process.kill(0,"SIGTERM")}catch{}}setTimeout(()=>{try{process.kill(0,"SIGKILL")}catch{process.exit(1)}},SHUTDOWN_GRACE_MS).unref()})};process.on("SIGINT",cleanup);process.on("SIGTERM",cleanup);process.on("SIGHUP",cleanup);const quietOpts={...options,quiet:!0},a=await actions(),ports=[{name:"API",port:apiPort}],readinessTimeoutMs=30000;let readyAnnounced=!1;const nativeUrl=developmentUrl(`http://localhost:${frontendPort}`,entryPath),nativeWindowReady=nativeMode?waitForPort(frontendPort,readinessTimeoutMs).then(async(ready)=>{if(!ready){log.warn(`Native window skipped because the frontend did not answer within ${readinessTimeoutMs/1000}s`);return}closeNativeApp=await launchNativeAppWindow(nativeUrl,options)}):Promise.resolve();Promise.all(ports.map((p)=>waitForPort(p.port,readinessTimeoutMs))).then(async(results)=>{if(readyAnnounced)return;readyAnnounced=!0;const failed=results.map((ok,i)=>ok?null:ports[i]?.name??null).filter((x)=>x!==null);let proxyReachable=!1;if(hasCustomDomain&&domain){(async()=>{try{await rpxTlsPreflight;await registerRpxProxiesForDomain({domain,frontendPort,apiPort,docsPort,dashboardPort,includeDashboard,options})}catch{}})();proxyReachable=await waitForHttpsProxy(443,16000);if(!proxyReachable){console.log(`  ${yellow("\u26A0")}  ${yellow("HTTPS proxy not reachable on :443")} \u2014 serving ${cyan(`http://localhost:${frontendPort}`)} instead`);console.log(`  ${dim("    ")}${dim("rpx needs a valid SUDO_PASSWORD in .env to bind :443; trust the local CA, then restart `./buddy dev`.")}`);if(options.verbose)console.log(`  ${dim("    ")}${dim(`Trust CA: sh ${join(RPX_SSL_DIR,"trust-rpx-cert.sh")}`)}`)}}eraseDevBootStartingLines();printDevReadyBanner({options,nativeMode,hasCustomDomain:!!appLooksCustom&&!localhostOnly,proxyReachable:proxyManagedExternally?!0:proxyReachable,frontendUrl,frontendBaseUrl,entryPath,apiUrl,docsUrl,dashboardUrl,frontendPort,apiPort,docsPort,includeDashboard,domain,dashboardPort,dashboardDomain});if(!nativeMode){const browserUrl=hasCustomDomain&&(proxyManagedExternally||proxyReachable)?frontendUrl:developmentUrl(`http://localhost:${frontendPort}`,entryPath);openDevelopmentBrowser(browserUrl)}if(startedAt){const elapsedMs=(Bun.nanoseconds()-startedAt)/1e6,summary=failed.length?`ready in ${(elapsedMs/1000).toFixed(1)}s \u2014 ${failed.join(", ")} did not bind within ${readinessTimeoutMs/1000}s`:`ready in ${(elapsedMs/1000).toFixed(1)}s`;console.log(`  ${dim(summary)}`);console.log();printDevEngineNotes();console.log()}if(process.env.STACKS_PRINT_ROUTES==="1")await printRegisteredRoutes(apiPort).catch(()=>{})}).catch(()=>{});await Promise.all([a.runFrontendDevServer(quietOpts).catch((error)=>{if(options.verbose)log.error(`Frontend: ${error}`)}),a.runApiDevServer(quietOpts).catch((error)=>{if(options.verbose)log.error(`API: ${error}`)}),a.runDocsDevServer(quietOpts).catch((error)=>{if(options.verbose)log.error(`Docs: ${error}`)}),includeDashboard?a.runDashboardDevServer(quietOpts).catch((error)=>{if(options.verbose)log.error(`Dashboard: ${error}`)}):Promise.resolve(),nativeWindowReady.catch((error)=>{if(options.verbose)log.warn(`Native window: ${error}`)})])}function isComingSoonMode(){if(existsSync(projectPath("storage/framework/coming-soon")))return!0;try{const idx=projectPath("resources/views/index.stx");return existsSync(idx)&&/siteMode\s*=\s*['"]coming-soon['"]/.test(readFileSync(idx,"utf8"))}catch{return!1}}function blogIsConfigured(){try{const dir=projectPath("content/blog");return existsSync(dir)&&readdirSync(dir).some((f)=>f.endsWith(".md"))}catch{return!1}}function printDevReadyBanner(input){const{options,nativeMode,hasCustomDomain,proxyReachable,frontendUrl,frontendBaseUrl,entryPath,apiUrl,docsUrl,dashboardUrl,frontendPort,apiPort,docsPort,includeDashboard,domain,dashboardPort,dashboardDomain}=input,verbose=options.verbose??!1,useProxy=hasCustomDomain&&proxyReachable,feUrl=useProxy?frontendUrl:developmentUrl(`http://localhost:${frontendPort}`,entryPath),feBaseUrl=useProxy?frontendBaseUrl:`http://localhost:${frontendPort}`,apUrl=useProxy?apiUrl:`http://localhost:${apiPort}`,dcUrl=useProxy?docsUrl:`http://localhost:${docsPort}`,dbUrl=useProxy?dashboardUrl:`http://localhost:${dashboardPort}`,blogUrl=`${feBaseUrl}/blog`;console.log();const frontendLabel=entryPath==="/"?"Site":"App";console.log(`  ${green("\u279C")}  ${bold(frontendLabel.padEnd(8))}:    ${cyan(feUrl)}`);if(entryPath!=="/")console.log(`  ${dim("\u279C")}  ${dim("Site")}:        ${dim(feBaseUrl)}`);if(nativeMode)console.log(`  ${green("\u279C")}  ${bold("Native")}:      ${cyan(`Craft \u2192 ${feUrl}`)}`);console.log(`  ${green("\u279C")}  ${bold("API")}:         ${cyan(apUrl)}`);console.log(`  ${green("\u279C")}  ${bold("Docs")}:        ${cyan(dcUrl)}`);if(blogIsConfigured())console.log(`  ${green("\u279C")}  ${bold("Blog")}:        ${cyan(blogUrl)}`);if(includeDashboard)console.log(`  ${green("\u279C")}  ${bold("Dashboard")}:   ${cyan(dbUrl)}`);if(useProxy){console.log(`  ${dim("\u279C")}  ${dim("Direct")}:      ${dim(`${developmentUrl(`http://localhost:${frontendPort}`,entryPath)} (bypasses the proxy)`)}`);if(includeDashboard&&dashboardDomain)console.log(`  ${dim("\u279C")}  ${dim("Direct")}:      ${dim(`http://localhost:${dashboardPort} (dashboard, bypasses the proxy)`)}`)}if(isComingSoonMode()){console.log();console.log(`  ${yellow("\u25CF")}  ${bold(yellow("Coming soon mode"))} ${dim("\u2014 visitors see the holding page; bypass with the coming-soon secret.")}`)}if(verbose&&domain){console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`localhost:${frontendPort} \u2192 ${domain}`)}`);console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`${frontendBaseUrl}/api \u2192 localhost:${apiPort}`)}`);console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`${frontendBaseUrl}/docs \u2192 localhost:${docsPort}`)}`);if(includeDashboard)console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`localhost:${dashboardPort} \u2192 ${dashboardDomain}`)}`)}console.log()}function printDevEngineNotes(){const routesFile=stxPath("routes.ts"),routesLabel=relative(projectPath(),routesFile),crosswindConfig=join(projectPath(),"config/crosswind.ts");if(existsSync(crosswindConfig)||existsSync(join(projectPath(),"crosswind.config.ts")))console.log(`  ${green("[Crosswind]")} ${dim("CSS engine loaded")}`);if(existsSync(routesFile))try{const routeCount=(readFileSync(routesFile,"utf8").match(/pattern:/g)??[]).length;if(routeCount>0)console.log(`  ${green("[stx]")} ${dim(`Generated ${routeCount} routes \u2192 ${routesLabel}`)}`)}catch{console.log(`  ${green("[stx]")} ${dim(`Routes manifest \u2192 ${routesLabel}`)}`)}}async function launchNativeAppWindow(url,options){let createApp;try{createApp=(await importCraftSdk()).createApp}catch(error){if(options.verbose)log.warn(`Native window unavailable: ${error}`);console.log(`  ${dim("Native window unavailable. Install craft-native or set CRAFT_BIN to a Craft binary.")}
+`);return}if(!createApp){console.log(`  ${dim("Native window unavailable. The Craft SDK did not export createApp.")}
+`);return}const craftBinaryPath=resolveCraftBinaryPath();if(!craftBinaryPath){console.log(`  ${dim("Native window unavailable. Set CRAFT_BIN to a Craft binary, or install Craft in ~/Code/Tools/craft.")}
+`);return}const appIconPath=resolveNativeAppIconPath(),app=createApp({url,quiet:!options.verbose,craftPath:craftBinaryPath,window:{title:await resolveNativeAppTitle(),width:1280,height:860,titlebarHidden:!0,webSidebarMaterial:!0,webSidebarWidth:286,webSidebarMaterialOpacity:0.78,...appIconPath&&{icon:appIconPath}}});app.show().catch((error)=>{if(options.verbose)log.warn(`Native window exited: ${error}`)});return()=>app.close()}async function importCraftSdk(){const localCraftSdk=process.env.HOME?`${process.env.HOME}/Code/Tools/craft/packages/typescript/src/index.ts`:void 0;if(localCraftSdk&&existsSync(localCraftSdk))return await import(localCraftSdk);const packageNames=["craft-native","@craft-native/craft","@stacksjs/ts-craft"];let primaryError;for(const packageName of packageNames)try{return await import(packageName)}catch(error){primaryError??=error}throw primaryError}async function cleanupStaleDevProcesses(ports){const projectRoot=projectPath(),actionDevPath=projectPath("storage/framework/core/actions/src/dev/"),pids=new Set;for(const port of ports)for(const pid of await listenerPids(port)){if(pid===process.pid)continue;const command=await commandForPid(pid);if(!command.includes(projectRoot))continue;if(command.includes("storage/framework/core/buddy/src/cli.ts dev")||command.includes("storage/framework/core/actions/src/dev/")||command.includes(actionDevPath))pids.add(pid)}if(pids.size===0)return;for(const pid of pids)try{process.kill(pid,"SIGTERM")}catch{}await new Promise((r)=>setTimeout(r,250));for(const pid of pids)try{process.kill(pid,"SIGKILL")}catch{}await new Promise((r)=>setTimeout(r,150))}async function listenerPids(port){try{const proc=Bun.spawn(["lsof","-nP",`-iTCP:${port}`,"-sTCP:LISTEN","-t"],{stdout:"pipe",stderr:"ignore"}),output=await new Response(proc.stdout).text();await proc.exited;return output.split(/\s+/).map((value)=>Number(value)).filter((pid)=>Number.isInteger(pid)&&pid>0)}catch{return[]}}async function commandForPid(pid){try{const proc=Bun.spawn(["ps","-p",String(pid),"-o","command="],{stdout:"pipe",stderr:"ignore"}),output=await new Response(proc.stdout).text();await proc.exited;return output.trim()}catch{return""}}function resolveCraftBinaryPath(){const home=process.env.HOME;return[process.env.CRAFT_BIN,home?`${home}/Code/Tools/craft/craft`:void 0,home?`${home}/Code/Tools/craft/bin/craft`:void 0,home?`${home}/Code/Tools/craft/packages/zig/zig-out/bin/craft`:void 0,home?`${home}/Documents/Projects/craft/packages/zig/zig-out/bin/craft`:void 0].filter((candidate)=>Boolean(candidate)).find((candidate)=>existsSync(candidate))}function resolveNativeAppIconPath(){return[projectPath("resources/assets/images/app-icon.png"),projectPath("resources/assets/images/icon.png"),projectPath("public/icon.png")].find((candidate)=>existsSync(candidate))}async function resolveNativeAppTitle(){try{const pkg=await Bun.file(projectPath("package.json")).json(),name=typeof pkg.productName==="string"?pkg.productName:pkg.name;if(typeof name==="string"&&name.length>0)return name.split(/[-_\s]+/).filter(Boolean).map((part)=>part.charAt(0).toUpperCase()+part.slice(1)).join(" ")}catch{}return"Stacks App"}const METHOD_COLORS={GET:cyan,POST:green,PUT:cyan,PATCH:cyan,DELETE:cyan,OPTIONS:dim};async function printRegisteredRoutes(apiPort){try{const ac=new AbortController,t=setTimeout(()=>ac.abort(),1500),res=await fetch(`http://127.0.0.1:${apiPort}/__routes`,{signal:ac.signal}).catch(()=>null);clearTimeout(t);if(!res||!res.ok)return;const routes=await res.json();if(!Array.isArray(routes)||routes.length===0)return;const sorted=[...routes].sort((a,b)=>a.path.localeCompare(b.path)||a.method.localeCompare(b.method)),longestPath=Math.max(...sorted.map((r)=>r.path.length));console.log(`  ${dim("Registered routes")}
+`);for(const r of sorted){const method=(METHOD_COLORS[r.method.toUpperCase()]??dim)(r.method.toUpperCase().padEnd(6)),path=r.path.padEnd(longestPath),named=r.name?`  ${dim(`(${r.name})`)}`:"";console.log(`  ${method}  ${path}${named}`)}console.log()}catch{}}async function probeDevServerHttp(port){for(const path of["/__health","/"])if(await new Promise((resolve)=>{const ac=new AbortController,t=setTimeout(()=>ac.abort(),path==="/"?8000:800);fetch(`http://127.0.0.1:${port}${path}`,{signal:ac.signal,redirect:"manual"}).then(()=>{clearTimeout(t);resolve(!0)}).catch(()=>{clearTimeout(t);resolve(!1)})}))return!0;return!1}async function findAvailablePort(preferred,attempts=20){for(let port=preferred;port<preferred+attempts;port++)if(await portIsFree(port))return port;return preferred}async function portIsFree(port){for(const host of["127.0.0.1","::1"])if(await someoneIsListening(port,host))return!1;let server;try{server=Bun.serve({port,hostname:"0.0.0.0",reusePort:!1,fetch:()=>new Response})}catch{return!1}server.stop(!0);return!0}async function someoneIsListening(port,host){const{connect}=await import("node:net");return new Promise((resolve)=>{const socket=connect({port,host}),finish=(listening)=>{socket.destroy();resolve(listening)};socket.setTimeout(300,()=>finish(!1));socket.once("connect",()=>finish(!0));socket.once("error",()=>finish(!1))})}async function waitForPort(port,timeoutMs){const deadline=Date.now()+timeoutMs;while(Date.now()<deadline){if(await probeDevServerHttp(port))return!0;await new Promise((r)=>setTimeout(r,50))}return!1}async function waitForHttpsProxy(port,timeoutMs){const{connect}=await import("node:net"),deadline=Date.now()+timeoutMs;while(Date.now()<deadline){if(await new Promise((resolve)=>{const socket=connect({port,host:"127.0.0.1"}),finish=(v)=>{try{socket.destroy()}catch{}resolve(v)};socket.once("connect",()=>finish(!0));socket.once("error",()=>finish(!1));setTimeout(()=>finish(!1),800).unref?.()}))return!0;await new Promise((r)=>setTimeout(r,200))}return!1}const RPX_SSL_DIR=join(homedir(),".stacks","ssl"),RPX_ROOT_CA_PATH=join(RPX_SSL_DIR,"rpx-root-ca.crt"),RPX_HOST_CERT_PATH=join(RPX_SSL_DIR,"rpx.localhost.crt");function buildDevelopmentTlsHostnames(domain,includeDashboard){return[domain,...includeDashboard?[`dashboard.${domain}`]:[],"rpx.localhost"]}async function ensureRpxDevelopmentHttps(domain,options,includeDashboard,trustCertificate=!0){const verbose=options.verbose??!1,{buildRegistryTlsProxyOptions,certIncludesSanHostnames,checkExistingCertificates,clearSslConfigCache,forceTrustCertificate,generateCertificate,getRegistryDir,isDaemonRunning,isRootCaTrustedForSsl,readAll,readCertCommonName,stopDaemon,trustRootCaForBrowsers,verifyHttpsChain}=await importDevelopmentRpx(),hostnames=buildDevelopmentTlsHostnames(domain,includeDashboard),entries=await readAll(getRegistryDir(),!1).catch(()=>[]);for(const entry of entries){const host=entry.to?.trim();if(host&&!hostnames.includes(host))hostnames.push(host)}const tlsOptions=buildRegistryTlsProxyOptions(hostnames,domain,verbose),hostnameInCert=certIncludesSanHostnames(RPX_HOST_CERT_PATH,hostnames),cnMatchesApp=readCertCommonName(RPX_HOST_CERT_PATH)===domain;let certRegenerated=!1;if(!await checkExistingCertificates(tlsOptions)||!hostnameInCert||!cnMatchesApp){clearSslConfigCache();await generateCertificate({...tlsOptions,forceRegenerate:!0});certRegenerated=!0}let trusted=isRootCaTrustedForSsl(RPX_ROOT_CA_PATH,domain,{verbose});if(!trusted&&trustCertificate){trusted=trustRootCaForBrowsers(RPX_ROOT_CA_PATH,{serverName:domain,verbose})||await forceTrustCertificate(RPX_ROOT_CA_PATH,{serverName:domain,verbose})||isRootCaTrustedForSsl(RPX_ROOT_CA_PATH,domain,{verbose});if(trusted)console.log(`  ${green("\u2713")}  ${dim("HTTPS")}:         ${dim("Local CA trusted \u2014 reload the browser if you still see a warning")}`);else console.log(`  ${yellow("\u26A0")}  ${yellow("HTTPS")}:         ${yellow(`Local CA not trusted \u2014 run: sh ${join(RPX_SSL_DIR,"trust-rpx-cert.sh")}`)}`)}else if(verbose)console.log(`  ${green("\u2713")}  ${dim("HTTPS")}:         ${dim("Local certificate trusted for SSL")}`);const chainOk=existsSync(RPX_ROOT_CA_PATH)?await verifyHttpsChain(domain,RPX_ROOT_CA_PATH):!1;if((certRegenerated||!hostnameInCert||!cnMatchesApp)&&await isDaemonRunning()){await stopDaemon({timeoutMs:8000}).catch(()=>{});if(verbose)log.info("Restarting rpx daemon to load TLS certificates for this app")}else if(!chainOk&&verbose)console.log(`  ${dim("    ")}${dim("HTTPS chain not yet valid on :443 \u2014 daemon will (re)start after backends are ready")}`)}function resolveRpxDaemonSpawnCwd(){const fromEnv=process.env.RPX_BIN||process.env.STACKS_RPX_BIN;if(fromEnv&&existsSync(fromEnv))return dirname(fromEnv);const bootstrap=join(dirname(fileURLToPath(import.meta.url)),"../../scripts/rpx-daemon-bootstrap.js");if(existsSync(bootstrap))return dirname(bootstrap);return homedir()}async function resolveRpxDaemonSpawnCommand(){const bootstrap=join(dirname(fileURLToPath(import.meta.url)),"../../scripts/rpx-daemon-bootstrap.js");if(existsSync(bootstrap))return[process.execPath,bootstrap];const fromEnv=process.env.RPX_BIN||process.env.STACKS_RPX_BIN;if(fromEnv&&existsSync(fromEnv))return[fromEnv,"daemon:start"];const pkgUrl=import.meta.resolve("@stacksjs/rpx/package.json"),cli=join(dirname(fileURLToPath(pkgUrl)),"dist/bin/cli.js");return[process.execPath,cli,"daemon:start"]}function buildRpxProxySpecs(input){const{domain,frontendPort,apiPort,docsPort,dashboardPort,includeDashboard}=input,dashboardDomain=`dashboard.${domain}`;return[{id:`${domain}-frontend`,from:`localhost:${frontendPort}`,to:domain,pathRewrites:[{from:"/api",to:`localhost:${apiPort}`,stripPrefix:!1},{from:"/docs",to:`localhost:${docsPort}`,stripPrefix:!0}]},...includeDashboard?[{id:`${domain}-dashboard`,from:`localhost:${dashboardPort}`,to:dashboardDomain}]:[]]}async function unregisterRpxProxies(ids){if(ids.length===0)return;try{const{removeEntry}=await importDevelopmentRpx();for(const id of ids)await removeEntry(id).catch(()=>{})}catch{}}async function removeStalePublicDomainOverrides(domain,includeDashboard,verbose){const{checkHosts,removeHosts,resolverFilePath,contentLooksLikeRpxResolver}=await importDevelopmentRpx(),hosts=[domain,...includeDashboard?[`dashboard.${domain}`]:[]],present=await checkHosts(hosts,verbose).catch(()=>hosts.map(()=>!1)),staleHosts=hosts.filter((_,i)=>present[i]===!0);if(staleHosts.length>0){await removeHosts(staleHosts,verbose).catch(()=>{});if((await checkHosts(staleHosts,verbose).catch(()=>staleHosts.map(()=>!0))).some(Boolean))log.warn(`Stale /etc/hosts entries still point ${staleHosts.join(", ")} at loopback. Remove them with: sudo nano /etc/hosts`);else log.info(`Removed stale /etc/hosts entries for ${staleHosts.join(", ")} (left by a previous dev session)`)}if(process.platform!=="darwin")return;const labels=domain.split("."),basename=labels.length>=2?labels.slice(-2).join("."):domain,resolverPath=resolverFilePath(basename);let isRpxManaged=!1;try{isRpxManaged=contentLooksLikeRpxResolver(readFileSync(resolverPath,"utf8"))}catch{}if(!isRpxManaged)return;const quotedPath=`'${resolverPath.replace(/'/g,"'\\''")}'`,rm=process.env.SUDO_PASSWORD?`printf '%s
+' "$SUDO_PASSWORD" | sudo -S rm -f ${quotedPath}`:`sudo -n rm -f ${quotedPath}`;try{execSync(rm,{stdio:["pipe","ignore","ignore"]});log.info(`Removed stale rpx DNS resolver ${resolverPath} (left by a previous dev session)`);execSync("sudo -n dscacheutil -flushcache; sudo -n killall -HUP mDNSResponder; true",{stdio:["pipe","ignore","ignore"]})}catch{log.warn(`A stale rpx DNS resolver still hijacks ${domain}. Remove it with: sudo rm ${resolverPath}`)}}async function prepareRpxTlsForDev(input){const{domain,includeDashboard,options,skipHosts=!1,trustCertificate=!0}=input,verbose=options.verbose??!1,hosts=[domain,...includeDashboard?[`dashboard.${domain}`]:[]],hostsNeedingFile=hosts.filter((host)=>{const h=host.trim().toLowerCase();return h!=="localhost"&&!h.endsWith(".localhost")&&!h.endsWith(".localhost.")}),{addHosts,setupDevelopmentDns}=await importDevelopmentRpx(),dnsDomains=!skipHosts&&hostsNeedingFile.length>0?hosts:[];if(dnsDomains.length>0){if(!await setupDevelopmentDns({domains:dnsDomains,verbose}).catch(()=>!1)&&verbose)log.warn(`Dev DNS not configured for ${dnsDomains.join(", ")} \u2014 falling back to /etc/hosts`)}if(!skipHosts&&hostsNeedingFile.length>0)await addHosts(hostsNeedingFile,verbose).catch((err)=>{log.warn(`Could not update /etc/hosts for ${hostsNeedingFile.join(", ")}: ${err.message}`);log.warn("Add 127.0.0.1 entries manually or set SUDO_PASSWORD in .env")});await ensureRpxDevelopmentHttps(domain,options,includeDashboard,trustCertificate)}export async function setupPrettyDevEnvironment(input){const domain=resolvePrettyDevDomain(input.domain??process.env.APP_URL??"stacks.localhost");if(!domain){log.info("APP_URL already uses localhost; no pretty URL setup is needed");return!0}const rpx=await importDevelopmentRpx();if(!rpx.authorizeSystemAccess({interactive:process.stdin.isTTY===!0&&process.stdout.isTTY===!0})){log.error("Pretty URL setup needs administrator authorization to bind ports 80 and 443 and trust the local CA");return!1}await prepareRpxTlsForDev({domain,includeDashboard:process.env.STACKS_DEV_DASHBOARD==="1",options:{verbose:input.verbose},skipHosts:input.skipHosts,trustCertificate:!input.skipTrust});const spawnEnv={};if(process.env.SUDO_PASSWORD)spawnEnv.SUDO_PASSWORD=process.env.SUDO_PASSWORD;if(input.verbose)spawnEnv.RPX_VERBOSE="1";const rpxEntry=resolveRpxEntryPath();if(rpxEntry)spawnEnv.RPX_MODULE=rpxEntry;await startRpxDaemonIfNeeded({spawnCommand:await resolveRpxDaemonSpawnCommand(),spawnEnv,verbose:input.verbose??!1,stopRpx:rpx.stopDaemon});const ready=await waitForHttpsProxy(443,5000);if(ready)log.success(`Pretty URLs are ready at https://${domain}`);else log.error("rpx did not become reachable on port 443");return ready}async function startRpxDaemonIfNeeded(input){const{ensureDaemonRunning,isDaemonRunning:isRpxUp}=await importDevelopmentRpx();if(await isRpxUp()){if(await waitForHttpsProxy(443,1500))return;await input.stopRpx({timeoutMs:5000}).catch(()=>{})}const spawnOpts={spawnCommand:input.spawnCommand,spawnCwd:resolveRpxDaemonSpawnCwd(),startupTimeoutMs:45000,spawnEnv:input.spawnEnv,verbose:input.verbose};try{await ensureDaemonRunning(spawnOpts)}catch(firstError){await input.stopRpx({timeoutMs:5000}).catch(()=>{});await ensureDaemonRunning(spawnOpts).catch(()=>{throw firstError})}}async function registerRpxProxiesForDomain(input){const{domain,frontendPort,apiPort,docsPort,dashboardPort,includeDashboard,options}=input,verbose=options.verbose??!1,proxies=buildRpxProxySpecs({domain,frontendPort,apiPort,docsPort,dashboardPort,includeDashboard});await unregisterRpxProxies([`${domain}-api`,`${domain}-docs`]);const{getRegistryDir,readAll,stopDaemon:stopRpx,syncDevelopmentDnsFromRegistry,writeEntry}=await importDevelopmentRpx(),spawnCommand=await resolveRpxDaemonSpawnCommand(),spawnEnv={};if(process.env.SUDO_PASSWORD)spawnEnv.SUDO_PASSWORD=process.env.SUDO_PASSWORD;if(verbose)spawnEnv.RPX_VERBOSE="1";const rpxEntry=resolveRpxEntryPath();if(rpxEntry)spawnEnv.RPX_MODULE=rpxEntry;try{await startRpxDaemonIfNeeded({spawnCommand,spawnEnv,verbose,stopRpx})}catch(error){const{isDaemonRunning}=await importDevelopmentRpx();if(!await isDaemonRunning())throw error;if(verbose){const message=error instanceof Error?error.message:String(error);console.log(`  ${dim("    ")}${dim(`rpx daemon spawn skipped (${message}); reusing existing daemon`)}`)}}const createdAt=new Date().toISOString();for(const proxy of proxies){await writeEntry({id:proxy.id,from:proxy.from,to:proxy.to,cwd:process.cwd(),createdAt,pid:process.pid,pathRewrites:proxy.pathRewrites},void 0,verbose);if(!activeRpxRegistryIds.includes(proxy.id))activeRpxRegistryIds.push(proxy.id);if(verbose)console.log(`  ${dim("\u279C")}  ${dim("Proxy")}:       ${dim(`https://${proxy.to} \u2192 ${proxy.from}`)}`)}const registryDir=getRegistryDir(),entries=await readAll(registryDir,verbose).catch(()=>[]);await syncDevelopmentDnsFromRegistry(entries,{verbose,ownerPid:process.pid}).catch((err)=>{if(verbose){const message=err instanceof Error?err.message:String(err);console.log(`  ${dim("    ")}${dim(`Dev DNS sync: ${message}`)}`)}})}function wantsInteractive(options){return options.interactive}