@absolutejs/absolute 0.19.0-beta.1035 → 0.19.0-beta.1037

package/dist/angular/components/core/streamingSlotRegistrar.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-MABBir/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-DCqFru/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");

package/dist/angular/components/core/streamingSlotRegistry.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-MABBir/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-DCqFru/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");
@@ -48,7 +48,7 @@ var warnMissingStreamingSlotCollector = (primitiveName) => {
   getWarningController()?.maybeWarn(primitiveName);
 };
 
-// .angular-partial-tmp-MABBir/src/core/streamingSlotRegistry.ts
+// .angular-partial-tmp-DCqFru/src/core/streamingSlotRegistry.ts
 var STREAMING_SLOT_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotAsyncLocalStorage");
 var isObjectRecord2 = (value) => Boolean(value) && typeof value === "object";
 var isAsyncLocalStorage = (value) => isObjectRecord2(value) && ("getStore" in value) && typeof value.getStore === "function" && ("run" in value) && typeof value.run === "function";

package/dist/cli/index.js

@@ -817,6 +817,7 @@ var COMPOSE_PATH = "db/docker-compose.db.yml", DEFAULT_SERVER_ENTRY = "src/backe
   console.log(`  \x1B[36mp\x1B[0m / pause    \u2014 Pause/resume ${title}`);
   console.log("  \x1B[36mo\x1B[0m / open     \u2014 Open in browser");
   console.log("  \x1B[36mc\x1B[0m / clear    \u2014 Clear terminal");
+  console.log("  \x1B[36mm\x1B[0m / heap     \u2014 Write a heap snapshot");
   console.log("  \x1B[36mq\x1B[0m / quit     \u2014 Graceful shutdown");
   console.log("  \x1B[36mh\x1B[0m / help     \u2014 Show this help");
   console.log("  \x1B[36m$\x1B[0m            \u2014 Run a shell command");
@@ -169881,7 +169882,7 @@ var isRecord = (value) => typeof value === "object" && value !== null, getIsland
 var init_islands = () => {};
 
 // src/build/islandEntries.ts
-import { dirname as dirname3, extname, join as join7, relative, resolve as resolve6 } from "path";
+import { dirname as dirname3, extname, join as join8, relative, resolve as resolve6 } from "path";
 var import_typescript, frameworks, isRecord2 = (value) => typeof value === "object" && value !== null, resolveRegistryExport = (mod) => {
   if (isRecord2(mod.islandRegistry))
     return mod.islandRegistry;
@@ -170281,7 +170282,7 @@ __export(exports_prerender, {
   PRERENDER_BYPASS_HEADER: () => PRERENDER_BYPASS_HEADER
 });
 import { mkdirSync as mkdirSync5, readFileSync as readFileSync10 } from "fs";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 var SERVER_OUTPUT_LIMIT = 4000, STARTUP_POLL_INTERVAL_MS = 100, DEFAULT_STARTUP_TIMEOUT_MS = 30000, PRERENDER_BYPASS_HEADER = "X-Absolute-Prerender-Bypass", routeToFilename = (route) => route === "/" ? "index.html" : `${route.slice(1).replace(/\//g, "-")}.html`, writeTimestamp = async (htmlPath) => {
   const metaPath = htmlPath.replace(/\.html$/, ".meta");
   await Bun.write(metaPath, String(Date.now()));
@@ -170347,7 +170348,7 @@ var SERVER_OUTPUT_LIMIT = 4000, STARTUP_POLL_INTERVAL_MS = 100, DEFAULT_STARTUP_
       return false;
     const html = await res.text();
     const fileName = routeToFilename(route);
-    const filePath = join8(prerenderDir, fileName);
+    const filePath = join9(prerenderDir, fileName);
     await Bun.write(filePath, html);
     await writeTimestamp(filePath);
     return true;
@@ -170373,13 +170374,13 @@ var SERVER_OUTPUT_LIMIT = 4000, STARTUP_POLL_INTERVAL_MS = 100, DEFAULT_STARTUP_
   }
   const html = await res.text();
   const fileName = routeToFilename(route);
-  const filePath = join8(prerenderDir, fileName);
+  const filePath = join9(prerenderDir, fileName);
   await Bun.write(filePath, html);
   await writeTimestamp(filePath);
   result.routes.set(route, filePath);
   log?.(`  Pre-rendered ${route} \u2192 ${fileName} (${html.length} bytes)`);
 }, prerender = async (port, outDir, staticConfig, log) => {
-  const prerenderDir = join8(outDir, "_prerendered");
+  const prerenderDir = join9(outDir, "_prerendered");
   mkdirSync5(prerenderDir, { recursive: true });
   const baseUrl = `http://localhost:${port}`;
   let routes;
@@ -170536,7 +170537,7 @@ var init_nativeRewrite = __esm(() => {
 
 // src/build/rewriteImportsPlugin.ts
 import { readdir } from "fs/promises";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 var escapeRegex = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), jsRewriteImports = (content, replacements) => {
   let result = content;
   for (const [specifier, webPath] of replacements) {
@@ -170614,7 +170615,7 @@ ${content}`;
       const entries = await readdir(dir);
       for (const entry of entries) {
         if (entry.endsWith(".js"))
-          allFiles.push(join9(dir, entry));
+          allFiles.push(join10(dir, entry));
       }
     } catch {}
   }
@@ -170922,7 +170923,7 @@ __export(exports_ls, {
   runLs: () => runLs
 });
 import { existsSync as existsSync11, readFileSync as readFileSync13, statSync } from "fs";
-import { basename as basename5, extname as extname2, join as join11, relative as relative2 } from "path";
+import { basename as basename5, extname as extname2, join as join12, relative as relative2 } from "path";
 var DEFAULT_BUILD_DIR = "build", LABEL_ORDER, ARTIFACT_SUFFIXES, FRAMEWORK_FIELDS, readStringField = (source, key) => {
   const value = Reflect.get(source, key);
   return typeof value === "string" ? value : undefined;
@@ -170944,13 +170945,13 @@ var DEFAULT_BUILD_DIR = "build", LABEL_ORDER, ARTIFACT_SUFFIXES, FRAMEWORK_FIELD
   const dir = readStringField(source, framework.field);
   return dir === undefined ? [] : [
     {
-      dir: join11(baseDir, dir),
+      dir: join12(baseDir, dir),
       label: framework.label,
       pattern: framework.pattern
     }
   ];
 }), scanFramework = async (spec) => {
-  const { pageFiles } = await scanConventions(join11(spec.dir, "pages"), spec.pattern);
+  const { pageFiles } = await scanConventions(join12(spec.dir, "pages"), spec.pattern);
   if (pageFiles.length === 0)
     return null;
   const pages = pageFiles.map((file) => ({
@@ -170974,10 +170975,10 @@ var DEFAULT_BUILD_DIR = "build", LABEL_ORDER, ARTIFACT_SUFFIXES, FRAMEWORK_FIELD
 }, resolveDiskPath = (buildDir, value) => {
   if (existsSync11(value))
     return value;
-  const underBuild = join11(buildDir, value);
+  const underBuild = join12(buildDir, value);
   if (existsSync11(underBuild))
     return underBuild;
-  return join11(process.cwd(), value);
+  return join12(process.cwd(), value);
 }, fileSize = (diskPath) => {
   try {
     return statSync(diskPath).size;
@@ -170985,7 +170986,7 @@ var DEFAULT_BUILD_DIR = "build", LABEL_ORDER, ARTIFACT_SUFFIXES, FRAMEWORK_FIELD
     return 0;
   }
 }, readManifestSizes = (manifestDir) => {
-  const manifest = JSON.parse(readFileSync13(join11(manifestDir, "manifest.json"), "utf-8"));
+  const manifest = JSON.parse(readFileSync13(join12(manifestDir, "manifest.json"), "utf-8"));
   const sizes = new Map;
   Object.entries(manifest).forEach(([key, value]) => {
     sizes.set(key, fileSize(resolveDiskPath(manifestDir, value)));
@@ -171004,7 +171005,7 @@ var DEFAULT_BUILD_DIR = "build", LABEL_ORDER, ARTIFACT_SUFFIXES, FRAMEWORK_FIELD
   }))
 })), manifestAge = (manifestPath) => getDurationString(Date.now() - statSync(manifestPath).mtimeMs), firstBuildDir = (candidates) => candidates.map((candidate) => {
   const dir = readStringField(candidate.source, "buildDirectory");
-  return dir === undefined ? undefined : join11(candidate.baseDir, dir);
+  return dir === undefined ? undefined : join12(candidate.baseDir, dir);
 }).find((dir) => dir !== undefined), resolveSizesDir = (args, candidates) => parseFlagValue(args, "--outdir") ?? firstBuildDir(candidates) ?? DEFAULT_BUILD_DIR, formatSize = (bytes) => {
   if (bytes === null || bytes === 0)
     return "-";
@@ -171083,7 +171084,7 @@ ${colors.dim}${frameworkCount} ${frameworkCount === 1 ? "framework" : "framework
     return;
   }
   const sizesDir = resolveSizesDir(args, candidates);
-  const manifestPath = join11(sizesDir, "manifest.json");
+  const manifestPath = join12(sizesDir, "manifest.json");
   if (!existsSync11(manifestPath)) {
     printDim(`No build at ${relativeOrSelf(manifestPath)}. Run \`absolute build\` first, or pass \`--outdir <dir>\`.`);
     return;
@@ -171127,7 +171128,10 @@ var formatBytes = (bytes) => {
   const kilobytes = bytes / BYTES_PER_KILOBYTE;
   if (kilobytes < BYTES_PER_KILOBYTE)
     return `${Math.round(kilobytes)} KB`;
-  return `${(kilobytes / BYTES_PER_KILOBYTE).toFixed(1)} MB`;
+  const megabytes = kilobytes / BYTES_PER_KILOBYTE;
+  if (megabytes < BYTES_PER_KILOBYTE)
+    return `${megabytes.toFixed(1)} MB`;
+  return `${(megabytes / BYTES_PER_KILOBYTE).toFixed(1)} GB`;
 };
 var init_formatBytes = __esm(() => {
   init_constants();
@@ -171261,7 +171265,7 @@ __export(exports_psTui, {
 });
 import { spawn } from "child_process";
 import { closeSync, fstatSync, openSync as openSync3, readSync } from "fs";
-var TUI_HEADERS, STATUS_INDEX = 6, URL_INDEX = 7, helpLines2, statusLevelColor = (level) => {
+var TUI_HEADERS, STATUS_INDEX = 8, URL_INDEX = 9, MEM_HISTORY_MAX = 12, SPARK_CHARS = "\u2581\u2582\u2583\u2584\u2585\u2586\u2587\u2588", helpLines2, statusLevelColor = (level) => {
   if (level === "error")
     return colors.red;
   if (level === "warn")
@@ -171275,16 +171279,17 @@ var TUI_HEADERS, STATUS_INDEX = 6, URL_INDEX = 7, helpLines2, statusLevelColor =
   if (status2 === "starting")
     return colors.yellow;
   return colors.dim;
-}, instanceRowCells = (instance) => [
-  instance.name,
-  instance.source,
-  instance.port === null ? "-" : String(instance.port),
-  String(instance.pid),
-  getDurationString(instance.uptimeMs),
-  formatBytes(instance.memoryBytes),
-  instance.status,
-  instance.url ?? "-"
-], columnWidths2 = (allCells) => TUI_HEADERS.map((header, index) => Math.max(visibleLength(header), ...allCells.map((cells) => visibleLength(cells[index] ?? "")))), layoutWidths = (allCells, width) => {
+}, sparkline = (samples) => {
+  if (samples.length === 0)
+    return "";
+  const max = Math.max(...samples);
+  const min = Math.min(...samples);
+  const range = max - min;
+  return samples.map((value) => {
+    const level = range === 0 ? 0 : Math.round((value - min) / range * (SPARK_CHARS.length - 1));
+    return SPARK_CHARS[level] ?? SPARK_CHARS[0];
+  }).join("");
+}, columnWidths2 = (allCells) => TUI_HEADERS.map((header, index) => Math.max(visibleLength(header), ...allCells.map((cells) => visibleLength(cells[index] ?? "")))), layoutWidths = (allCells, width) => {
   const natural = columnWidths2(allCells);
   const gaps = (TUI_HEADERS.length - 1) * LIST_TUI_COLUMN_GAP;
   const available = width - LIST_TUI_MARKER_WIDTH - gaps;
@@ -171317,6 +171322,7 @@ var TUI_HEADERS, STATUS_INDEX = 6, URL_INDEX = 7, helpLines2, statusLevelColor =
 }, driveListTui = async (terminal) => {
   const { promise, resolve: resolveExit } = Promise.withResolvers();
   let instances = [];
+  const memoryHistory = new Map;
   let selectedIndex = 0;
   let mode = "list";
   let helpVisible = false;
@@ -171350,9 +171356,24 @@ var TUI_HEADERS, STATUS_INDEX = 6, URL_INDEX = 7, helpLines2, statusLevelColor =
     }, LIST_TUI_STATUS_MESSAGE_TIMEOUT_MS);
     scheduleRender();
   };
+  const recordMemory = () => {
+    const livePids = new Set(instances.map((entry) => entry.pid));
+    instances.forEach((entry) => {
+      const samples = memoryHistory.get(entry.pid) ?? [];
+      samples.push(entry.memoryBytes ?? 0);
+      if (samples.length > MEM_HISTORY_MAX)
+        samples.shift();
+      memoryHistory.set(entry.pid, samples);
+    });
+    [...memoryHistory.keys()].forEach((pid) => {
+      if (!livePids.has(pid))
+        memoryHistory.delete(pid);
+    });
+  };
   const refresh = async () => {
     const previousPid = selectedInstance()?.pid;
     instances = await enrichInstances(await discoverInstances());
+    recordMemory();
     const foundIndex = previousPid === undefined ? 0 : instances.findIndex((instance) => instance.pid === previousPid);
     selectedIndex = foundIndex >= 0 ? foundIndex : Math.min(selectedIndex, Math.max(0, instances.length - 1));
     scheduleRender();
@@ -171649,8 +171670,24 @@ var TUI_HEADERS, STATUS_INDEX = 6, URL_INDEX = 7, helpLines2, statusLevelColor =
     }
     return padded;
   };
+  const cellsFor = (instance) => {
+    const history = memoryHistory.get(instance.pid) ?? [];
+    const peak = history.length > 0 ? Math.max(...history) : instance.memoryBytes ?? 0;
+    return [
+      instance.name,
+      instance.source,
+      instance.port === null ? "-" : String(instance.port),
+      String(instance.pid),
+      getDurationString(instance.uptimeMs),
+      formatBytes(instance.memoryBytes),
+      formatBytes(peak),
+      sparkline(history),
+      instance.status,
+      instance.url ?? "-"
+    ];
+  };
   const renderInstanceRow = (instance, widths, isSelected) => {
-    const body = instanceRowCells(instance).map((cell, index) => colorizeCell(cell, index, instance.status, isSelected, widths)).join(" ".repeat(LIST_TUI_COLUMN_GAP));
+    const body = cellsFor(instance).map((cell, index) => colorizeCell(cell, index, instance.status, isSelected, widths)).join(" ".repeat(LIST_TUI_COLUMN_GAP));
     const marker = isSelected ? `${colors.cyan}\u276F${colors.reset}` : " ";
     return `${marker} ${body}`;
   };
@@ -171659,7 +171696,7 @@ var TUI_HEADERS, STATUS_INDEX = 6, URL_INDEX = 7, helpLines2, statusLevelColor =
       rows.push(padLine(`${colors.dim}No running servers found. Start one with \`absolute dev\`, \`start\`, or \`workspace dev\`.${colors.reset}`, width));
       return;
     }
-    const allCells = instances.map(instanceRowCells);
+    const allCells = instances.map(cellsFor);
     const widths = layoutWidths(allCells, width);
     const header = TUI_HEADERS.map((label, index) => padLine(label, widths[index] ?? 0)).join(" ".repeat(LIST_TUI_COLUMN_GAP));
     rows.push(padLine(`  ${colors.dim}${header}${colors.reset}`, width));
@@ -171769,6 +171806,8 @@ var init_psTui = __esm(() => {
     "PID",
     "UPTIME",
     "MEM",
+    "PEAK",
+    "TREND",
     "STATUS",
     "URL"
   ];
@@ -171882,9 +171921,353 @@ var init_ps = __esm(() => {
   ];
 });
 
+// src/cli/scripts/mem.ts
+var exports_mem = {};
+__export(exports_mem, {
+  runMem: () => runMem
+});
+import { freemem, totalmem as totalmem2 } from "os";
+var BAR_WIDTH = 12, PERCENT = 100, HEADERS, sumMemory = (instances) => instances.reduce((total, instance) => total + (instance.memoryBytes ?? 0), 0), memBar = (fraction) => {
+  const filled = Math.max(0, Math.min(BAR_WIDTH, Math.round(fraction * BAR_WIDTH)));
+  return `${"\u2588".repeat(filled)}${colors.dim}${"\u2591".repeat(BAR_WIDTH - filled)}${colors.reset}`;
+}, instanceCells2 = (instance, systemTotal) => {
+  const rss = instance.memoryBytes ?? 0;
+  const fraction = systemTotal > 0 ? rss / systemTotal : 0;
+  return [
+    instance.name,
+    instance.source,
+    instance.port === null ? "-" : String(instance.port),
+    formatBytes(instance.memoryBytes),
+    `${memBar(fraction)} ${(fraction * PERCENT).toFixed(1)}%`
+  ];
+}, columnWidths4 = (rows) => HEADERS.map((header, index) => Math.max(visibleLength(header), ...rows.map((cells) => visibleLength(cells[index] ?? "")))), renderRow2 = (cells, widths) => cells.map((cell, index) => padLine(cell, widths[index] ?? 0)).join(" ".repeat(LIST_TUI_COLUMN_GAP)), printReport = (instances) => {
+  const systemTotal = totalmem2();
+  const used = systemTotal - freemem();
+  const rows = instances.map((instance) => instanceCells2(instance, systemTotal));
+  const widths = columnWidths4(rows);
+  const count = instances.length;
+  const lines = [
+    `${colors.dim}${renderRow2(HEADERS, widths)}${colors.reset}`,
+    ...rows.map((cells) => renderRow2(cells, widths)),
+    "",
+    `${colors.dim}${count} server${count === 1 ? "" : "s"} \xB7 ${formatBytes(sumMemory(instances))} resident total${colors.reset}`,
+    `${colors.dim}system  ${formatBytes(used)} / ${formatBytes(systemTotal)} used \xB7 ${formatBytes(freemem())} free${colors.reset}`
+  ];
+  process.stdout.write(`${lines.join(`
+`)}
+`);
+}, runMem = async (args) => {
+  const instances = (await enrichInstances(await discoverInstances())).sort((left, right) => (right.memoryBytes ?? 0) - (left.memoryBytes ?? 0));
+  if (args.includes("--json")) {
+    process.stdout.write(`${JSON.stringify({
+      instances,
+      system: {
+        freeBytes: freemem(),
+        totalBytes: totalmem2(),
+        usedBytes: totalmem2() - freemem()
+      }
+    }, null, 2)}
+`);
+    return;
+  }
+  if (instances.length === 0) {
+    process.stdout.write(`${colors.dim}No running servers found.${colors.reset}
+`);
+    return;
+  }
+  printReport(instances);
+};
+var init_mem = __esm(() => {
+  init_constants();
+  init_formatBytes();
+  init_discoverInstances();
+  init_instanceStatus();
+  init_tuiPrimitives();
+  HEADERS = ["NAME", "SOURCE", "PORT", "RSS", "% SYS"];
+});
+
+// src/cli/scripts/env.ts
+var exports_env = {};
+__export(exports_env, {
+  scanEnvUsage: () => scanEnvUsage,
+  runEnv: () => runEnv,
+  collectEnvVars: () => collectEnvVars
+});
+import { existsSync as existsSync12, readFileSync as readFileSync14 } from "fs";
+import { join as join13 } from "path";
+var {env: env3, Glob: Glob3 } = globalThis.Bun;
+var EXTENSIONS = "ts,tsx,js,jsx,mjs,cjs,svelte,vue", STATUS_WIDTH, keysInFile = (text) => [...text.matchAll(/getEnv\(\s*['"]([^'"]+)['"]\s*\)/g)].map((match) => match[1]).filter((key) => key !== undefined), scanPatterns = () => existsSync12(join13(process.cwd(), "src")) ? [`src/**/*.{${EXTENSIONS}}`] : [`*.{${EXTENSIONS}}`], scanEnvUsage = async () => {
+  const scans = scanPatterns().map((pattern) => Array.fromAsync(new Glob3(pattern).scan({ cwd: process.cwd() })));
+  const files = (await Promise.all(scans)).flat();
+  const usage = new Map;
+  files.forEach((file) => {
+    keysInFile(readFileSync14(file, "utf-8")).forEach((key) => {
+      usage.set(key, [...usage.get(key) ?? [], file]);
+    });
+  });
+  return usage;
+}, isSet = (key) => typeof env3[key] === "string" && env3[key] !== "", collectEnvVars = async () => {
+  const usage = await scanEnvUsage();
+  return [...usage.keys()].sort().map((key) => ({
+    files: usage.get(key) ?? [],
+    key,
+    set: isSet(key)
+  }));
+}, printTable = (vars) => {
+  const keyWidth = Math.max(...vars.map((entry) => entry.key.length));
+  const lines = vars.map((entry) => {
+    const mark = entry.set ? `${colors.green}\u2713${colors.reset}` : `${colors.red}\u2717${colors.reset}`;
+    const status2 = entry.set ? "set" : `${colors.red}missing${colors.reset}`;
+    const count = `${colors.dim}${entry.files.length} file${entry.files.length === 1 ? "" : "s"}${colors.reset}`;
+    return `  ${mark} ${padLine(entry.key, keyWidth)}${" ".repeat(LIST_TUI_COLUMN_GAP)}${padLine(status2, STATUS_WIDTH)}${" ".repeat(LIST_TUI_COLUMN_GAP)}${count}`;
+  });
+  process.stdout.write(`${lines.join(`
+`)}
+`);
+}, runEnv = async (args) => {
+  const vars = await collectEnvVars();
+  if (vars.length === 0) {
+    process.stdout.write(`${colors.dim}No getEnv() usage found under src/.${colors.reset}
+`);
+    return;
+  }
+  const missing = vars.filter((entry) => !entry.set);
+  if (args.includes("--json")) {
+    process.stdout.write(`${JSON.stringify({ missing, vars }, null, 2)}
+`);
+    return;
+  }
+  printTable(vars);
+  const summary = missing.length === 0 ? `${colors.green}all ${vars.length} set${colors.reset}` : `${colors.red}${missing.length} missing${colors.reset}`;
+  process.stdout.write(`
+${colors.dim}${vars.length} referenced \xB7 ${colors.reset}${summary}
+`);
+  if (args.includes("--check") && missing.length > 0) {
+    process.exitCode = 1;
+  }
+};
+var init_env = __esm(() => {
+  init_constants();
+  init_tuiPrimitives();
+  STATUS_WIDTH = "missing".length;
+});
+
+// src/cli/scripts/logs.ts
+var exports_logs = {};
+__export(exports_logs, {
+  runLogs: () => runLogs
+});
+import {
+  closeSync as closeSync2,
+  existsSync as existsSync13,
+  openSync as openSync4,
+  readSync as readSync2,
+  statSync as statSync2,
+  watchFile
+} from "fs";
+var DEFAULT_LINES = 40, POLL_MS = 250, LINES_FLAG_SPAN = 2, readFrom = (path, start2, length) => {
+  if (length <= 0)
+    return "";
+  const descriptor = openSync4(path, "r");
+  try {
+    const buffer = Buffer.alloc(length);
+    readSync2(descriptor, buffer, 0, length, start2);
+    return buffer.toString("utf-8");
+  } finally {
+    closeSync2(descriptor);
+  }
+}, tailLines = (path, maxLines) => {
+  const { size } = statSync2(path);
+  const start2 = Math.max(0, size - LIST_LOG_TAIL_MAX_BYTES);
+  const lines = readFrom(path, start2, size - start2).split(`
+`);
+  return lines.slice(Math.max(0, lines.length - maxLines)).join(`
+`);
+}, parseLines = (args) => {
+  const index = args.findIndex((arg) => arg === "-n" || arg === "--lines");
+  if (index === UNFOUND_INDEX)
+    return DEFAULT_LINES;
+  const value = Number(args[index + 1]);
+  return Number.isInteger(value) && value > 0 ? value : DEFAULT_LINES;
+}, targetName = (args) => {
+  const index = args.findIndex((arg) => arg === "-n" || arg === "--lines");
+  const cleaned = index === UNFOUND_INDEX ? args : [...args.slice(0, index), ...args.slice(index + LINES_FLAG_SPAN)];
+  return cleaned.find((arg) => !arg.startsWith("-"));
+}, followFile = (path) => {
+  let offset = statSync2(path).size;
+  watchFile(path, { interval: POLL_MS }, (current) => {
+    if (current.size > offset) {
+      process.stdout.write(readFrom(path, offset, current.size - offset));
+    }
+    offset = current.size;
+  });
+}, printDim2 = (message) => {
+  process.stdout.write(`${colors.dim}${message}${colors.reset}
+`);
+}, printAvailable = (instances) => {
+  const named = instances.filter((instance) => instance.logFile !== null);
+  if (named.length === 0) {
+    printDim2("No running servers have a captured log.");
+    return;
+  }
+  printDim2("Servers with logs:");
+  named.forEach((instance) => printDim2(`  ${instance.name}`));
+}, runLogs = async (args) => {
+  const instances = await enrichInstances(await discoverInstances());
+  const name = targetName(args);
+  if (name === undefined) {
+    printDim2("Usage: absolute logs <name> [-f] [-n <lines>]");
+    printAvailable(instances);
+    return;
+  }
+  const match = instances.find((instance) => instance.name === name);
+  if (!match) {
+    printDim2(`No running server named "${name}".`);
+    printAvailable(instances);
+    return;
+  }
+  if (match.logFile === null || !existsSync13(match.logFile)) {
+    printDim2(`"${name}" has no captured log (untracked, or started outside the CLI).`);
+    return;
+  }
+  process.stdout.write(`${tailLines(match.logFile, parseLines(args))}
+`);
+  if (args.includes("-f") || args.includes("--follow")) {
+    printDim2(`\u2014 following ${match.name} \xB7 ctrl+c to stop \u2014`);
+    followFile(match.logFile);
+  }
+};
+var init_logs = __esm(() => {
+  init_constants();
+  init_discoverInstances();
+  init_instanceStatus();
+  init_tuiPrimitives();
+});
+
+// src/cli/scripts/doctor.ts
+var exports_doctor = {};
+__export(exports_doctor, {
+  runDoctor: () => runDoctor
+});
+import { existsSync as existsSync14 } from "fs";
+import { createRequire } from "module";
+import { arch as arch4, platform as platform5 } from "os";
+import { join as join14 } from "path";
+var FRAMEWORK_FIELDS2, projectRequire, check = (status2, label, detail) => ({
+  detail,
+  label,
+  status: status2
+}), readString = (source, key) => {
+  const value = Reflect.get(source, key);
+  return typeof value === "string" ? value : undefined;
+}, resolveVersion = (specifier) => {
+  try {
+    const pkg = projectRequire(`${specifier}/package.json`);
+    const version2 = pkg && typeof pkg === "object" ? Reflect.get(pkg, "version") : null;
+    return typeof version2 === "string" ? version2 : null;
+  } catch {
+    return null;
+  }
+}, checkBun = () => check("ok", "Bun runtime", `v${Bun.version}`), checkAbsolute = () => {
+  const version2 = resolveVersion("@absolutejs/absolute");
+  return version2 === null ? check("fail", "@absolutejs/absolute", "not resolvable here") : check("ok", "@absolutejs/absolute", `v${version2}`);
+}, checkNative = () => {
+  const target = `@absolutejs/native-${platform5()}-${arch4()}`;
+  const version2 = resolveVersion(target);
+  return version2 === null ? check("warn", "Native binary", `${target} not installed`) : check("ok", "Native binary", `v${version2}`);
+}, loadConfigOrNull = async () => {
+  try {
+    return await loadRawConfig();
+  } catch {
+    return null;
+  }
+}, frameworkChecks = (config) => FRAMEWORK_FIELDS2.flatMap((field) => {
+  const dir = readString(config, field);
+  if (dir === undefined)
+    return [];
+  const label = `${field.replace("Directory", "")} pages`;
+  return [
+    existsSync14(join14(process.cwd(), dir)) ? check("ok", label, dir) : check("fail", label, `${dir} (missing)`)
+  ];
+}), envCheck = async () => {
+  const vars = await collectEnvVars();
+  const missing = vars.filter((entry) => !entry.set);
+  if (vars.length === 0)
+    return check("ok", "Env vars", "no getEnv() usage");
+  if (missing.length === 0) {
+    return check("ok", "Env vars", `all ${vars.length} set`);
+  }
+  return check("fail", "Env vars", `missing ${missing.map((entry) => entry.key).join(", ")}`);
+}, devPort = (config) => {
+  const dev2 = Reflect.get(config, "dev");
+  const port = dev2 && typeof dev2 === "object" ? Reflect.get(dev2, "port") : undefined;
+  return typeof port === "number" ? port : DEFAULT_PORT;
+}, portCheck = async (config) => {
+  const port = devPort(config);
+  const holder = (await scanListeners()).find((listener) => listener.port === port);
+  return holder ? check("warn", "Dev port", `${port} in use by pid ${holder.pid}`) : check("ok", "Dev port", `${port} free`);
+}, STATUS_MARK, renderCheck = (entry, labelWidth) => `  ${STATUS_MARK[entry.status]} ${entry.label.padEnd(labelWidth)}  ${colors.dim}${entry.detail}${colors.reset}`, printReport2 = (checks) => {
+  const labelWidth = Math.max(...checks.map((entry) => entry.label.length));
+  const failed = checks.filter((entry) => entry.status === "fail").length;
+  const warned = checks.filter((entry) => entry.status === "warn").length;
+  const summary = failed > 0 ? `${colors.red}${failed} failed${colors.reset}` : `${colors.green}all good${colors.reset}`;
+  const lines = checks.map((entry) => renderCheck(entry, labelWidth));
+  process.stdout.write(`${lines.join(`
+`)}
+
+${colors.dim}${checks.length} checks \xB7 ${colors.reset}${summary}${colors.dim} \xB7 ${warned} warning${warned === 1 ? "" : "s"}${colors.reset}
+`);
+}, runDoctor = async (args) => {
+  const config = await loadConfigOrNull();
+  const configCheck = config === null ? check("fail", "Config", "absolute.config.ts not found or invalid") : check("ok", "Config", "absolute.config.ts loaded");
+  const [env4, port] = await Promise.all([
+    envCheck(),
+    config === null ? check("warn", "Dev port", "skipped (no config)") : portCheck(config)
+  ]);
+  const checks = [
+    checkBun(),
+    checkAbsolute(),
+    checkNative(),
+    configCheck,
+    ...config === null ? [] : frameworkChecks(config),
+    env4,
+    port
+  ];
+  if (args.includes("--json")) {
+    process.stdout.write(`${JSON.stringify(checks, null, 2)}
+`);
+  } else {
+    printReport2(checks);
+  }
+  if (checks.some((entry) => entry.status === "fail")) {
+    process.exitCode = 1;
+  }
+};
+var init_doctor = __esm(() => {
+  init_constants();
+  init_loadConfig();
+  init_portScan();
+  init_tuiPrimitives();
+  init_env();
+  FRAMEWORK_FIELDS2 = [
+    "reactDirectory",
+    "vueDirectory",
+    "svelteDirectory",
+    "angularDirectory",
+    "htmlDirectory",
+    "htmxDirectory"
+  ];
+  projectRequire = createRequire(join14(process.cwd(), "package.json"));
+  STATUS_MARK = {
+    fail: `${colors.red}\u2717${colors.reset}`,
+    ok: `${colors.green}\u2713${colors.reset}`,
+    warn: `${colors.yellow}\u26A0${colors.reset}`
+  };
+});
+
 // src/build/externalAssetPlugin.ts
-import { copyFileSync as copyFileSync2, existsSync as existsSync12, mkdirSync as mkdirSync7, statSync as statSync2 } from "fs";
-import { basename as basename6, dirname as dirname4, join as join12, resolve as resolve11 } from "path";
+import { copyFileSync as copyFileSync2, existsSync as existsSync15, mkdirSync as mkdirSync7, statSync as statSync3 } from "fs";
+import { basename as basename6, dirname as dirname4, join as join15, resolve as resolve11 } from "path";
 var createExternalAssetPlugin = (outDir, userSourceRoots = []) => ({
   name: "absolute-external-asset",
   setup(bld) {
@@ -171905,12 +172288,12 @@ var createExternalAssetPlugin = (outDir, userSourceRoots = []) => ({
         if (!relPath)
           continue;
         const assetPath = resolve11(sourceDir, relPath);
-        if (!existsSync12(assetPath))
+        if (!existsSync15(assetPath))
           continue;
-        if (!statSync2(assetPath).isFile())
+        if (!statSync3(assetPath).isFile())
           continue;
-        const targetPath = join12(outDir, basename6(assetPath));
-        if (existsSync12(targetPath))
+        const targetPath = join15(outDir, basename6(assetPath));
+        if (existsSync15(targetPath))
           continue;
         mkdirSync7(dirname4(targetPath), { recursive: true });
         copyFileSync2(assetPath, targetPath);
@@ -171927,19 +172310,19 @@ __export(exports_compile, {
   shouldEmbedCompiledAsset: () => shouldEmbedCompiledAsset,
   compile: () => compile
 });
-var {env: env3 } = globalThis.Bun;
+var {env: env4 } = globalThis.Bun;
 import {
   cpSync,
-  existsSync as existsSync13,
+  existsSync as existsSync16,
   mkdirSync as mkdirSync8,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync14,
-  rmSync as rmSync4,
-  statSync as statSync3,
+  readFileSync as readFileSync15,
+  rmSync as rmSync5,
+  statSync as statSync4,
   unlinkSync as unlinkSync4,
-  writeFileSync as writeFileSync5
+  writeFileSync as writeFileSync6
 } from "fs";
-import { basename as basename7, dirname as dirname5, join as join13, relative as relative3, resolve as resolve12 } from "path";
+import { basename as basename7, dirname as dirname5, join as join16, relative as relative3, resolve as resolve12 } from "path";
 var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[cli]\x1B[0m ${color}${message}\x1B[0m`, compileBanner = (version2) => {
   const resolvedVersion = version2 || "unknown";
   console.log("");
@@ -171952,7 +172335,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
     const entry = pending.pop();
     if (!entry)
       continue;
-    const fullPath = join13(entry.parentPath, entry.name);
+    const fullPath = join16(entry.parentPath, entry.name);
     if (entry.isDirectory())
       pending = pending.concat(readdirSync3(fullPath, { withFileTypes: true }));
     else
@@ -171972,7 +172355,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
     const entry = pending.pop();
     if (!entry)
       continue;
-    const fullPath = join13(entry.parentPath, entry.name);
+    const fullPath = join16(entry.parentPath, entry.name);
     if (entry.isDirectory()) {
       if (SERVER_RUNTIME_SCAN_SKIP_DIRS.has(entry.name))
         continue;
@@ -171987,7 +172370,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   const normalizedOutdir = resolve12(outdir);
   const copyReference = (filePath, relPath) => {
     const assetSource = resolve12(dirname5(filePath), relPath);
-    if (!existsSync13(assetSource) || !statSync3(assetSource).isFile())
+    if (!existsSync16(assetSource) || !statSync4(assetSource).isFile())
       return;
     const assetTarget = resolve12(normalizedOutdir, relPath.replace(/^\.\//, ""));
     if (assetTarget !== normalizedOutdir && !assetTarget.startsWith(`${normalizedOutdir}/`))
@@ -171999,7 +172382,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
     cpSync(assetSource, assetTarget, { force: true });
   };
   for (const filePath of collectProjectSourceFiles(process.cwd())) {
-    const source = readFileSync14(filePath, "utf-8");
+    const source = readFileSync15(filePath, "utf-8");
     SERVER_RUNTIME_ASSET_RE.lastIndex = 0;
     let match;
     while ((match = SERVER_RUNTIME_ASSET_RE.exec(source)) !== null) {
@@ -172028,7 +172411,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   }
 }, readPackageVersion4 = (candidate) => {
   try {
-    const pkg = JSON.parse(readFileSync14(candidate, "utf-8"));
+    const pkg = JSON.parse(readFileSync15(candidate, "utf-8"));
     if (pkg.name !== "@absolutejs/absolute")
       return null;
     const ver = pkg.version;
@@ -172071,7 +172454,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
     resolve12(import.meta.dir, "..", "..", "..", "src", "react", "jsxDevRuntimeCompat.ts")
   ];
   for (const candidate of candidates) {
-    if (existsSync13(candidate))
+    if (existsSync16(candidate))
       return candidate;
   }
   return resolve12(import.meta.dir, "..", "..", "react", "jsxDevRuntimeCompat.js");
@@ -172087,7 +172470,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   return true;
 }, tryReadNodePackageJson = (packageDir) => {
   try {
-    return JSON.parse(readFileSync14(join13(packageDir, "package.json"), "utf-8"));
+    return JSON.parse(readFileSync15(join16(packageDir, "package.json"), "utf-8"));
   } catch {
     return null;
   }
@@ -172099,8 +172482,8 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   if (!pkg)
     return;
   seen.add(specifier);
-  const destDir = join13(outdir, "node_modules", ...specifier.split("/"));
-  rmSync4(destDir, { force: true, recursive: true });
+  const destDir = join16(outdir, "node_modules", ...specifier.split("/"));
+  rmSync5(destDir, { force: true, recursive: true });
   cpSync(srcDir, destDir, {
     force: true,
     recursive: true,
@@ -172122,7 +172505,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   if (!buildConfig.angularDirectory)
     return;
   const angularScopeDir = resolve12(process.cwd(), "node_modules", "@angular");
-  const angularPackages = existsSync13(angularScopeDir) ? readdirSync3(angularScopeDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).filter((entry) => entry.name !== "compiler-cli").map((entry) => `@angular/${entry.name}`) : [];
+  const angularPackages = existsSync16(angularScopeDir) ? readdirSync3(angularScopeDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).filter((entry) => entry.name !== "compiler-cli").map((entry) => `@angular/${entry.name}`) : [];
   const roots = new Set([...angularPackages, "rxjs", "tslib", "typescript"]);
   const seen = new Set;
   for (const specifier of roots) {
@@ -172139,15 +172522,15 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   }
   copyAngularRuntimePackages(buildConfig, outdir);
 }, collectRuntimePackageSpecifiers = (distDir) => {
-  const nodeModulesDir = join13(distDir, "node_modules");
-  if (!existsSync13(nodeModulesDir))
+  const nodeModulesDir = join16(distDir, "node_modules");
+  if (!existsSync16(nodeModulesDir))
     return [];
   const specifiers = [];
   for (const entry of readdirSync3(nodeModulesDir, { withFileTypes: true })) {
     if (!entry.isDirectory())
       continue;
     if (entry.name.startsWith("@")) {
-      const scopeDir = join13(nodeModulesDir, entry.name);
+      const scopeDir = join16(nodeModulesDir, entry.name);
       for (const scopedEntry of readdirSync3(scopeDir, {
         withFileTypes: true
       })) {
@@ -172179,21 +172562,21 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   const packageSpecifier = packageSpecifiers.find((root) => specifier === root || specifier.startsWith(`${root}/`));
   if (!packageSpecifier)
     return null;
-  const packageDir = join13(distDir, "node_modules", ...packageSpecifier.split("/"));
+  const packageDir = join16(distDir, "node_modules", ...packageSpecifier.split("/"));
   const subpath = specifier.slice(packageSpecifier.length);
-  const subPackageDir = subpath ? join13(packageDir, ...subpath.slice(1).split("/")) : null;
-  const resolvedPackageDir = subPackageDir && existsSync13(join13(subPackageDir, "package.json")) ? subPackageDir : packageDir;
-  const packageJsonPath = join13(resolvedPackageDir, "package.json");
-  if (!existsSync13(packageJsonPath))
+  const subPackageDir = subpath ? join16(packageDir, ...subpath.slice(1).split("/")) : null;
+  const resolvedPackageDir = subPackageDir && existsSync16(join16(subPackageDir, "package.json")) ? subPackageDir : packageDir;
+  const packageJsonPath = join16(resolvedPackageDir, "package.json");
+  if (!existsSync16(packageJsonPath))
     return null;
-  const pkg = JSON.parse(readFileSync14(packageJsonPath, "utf-8"));
+  const pkg = JSON.parse(readFileSync15(packageJsonPath, "utf-8"));
   const exportKey = resolvedPackageDir !== subPackageDir && subpath ? `.${subpath}` : ".";
   const rootExport = pkg.exports?.[exportKey];
   const entry = pickExportEntry(rootExport) ?? (resolvedPackageDir === subPackageDir || !subpath ? pkg.module ?? pkg.main ?? "index.js" : `.${subpath}`);
-  return join13(resolvedPackageDir, entry);
+  return join16(resolvedPackageDir, entry);
 }, RUNTIME_JS_EXTENSIONS, MODULE_SPECIFIER_RE, isRuntimeJsFile = (filePath) => RUNTIME_JS_EXTENSIONS.some((extension) => filePath.endsWith(extension)), isNodeModulesPath = (filePath) => filePath.split(/[\\/]/).includes("node_modules"), isFile = (filePath) => {
   try {
-    return statSync3(filePath).isFile();
+    return statSync4(filePath).isFile();
   } catch {
     return false;
   }
@@ -172203,13 +172586,13 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   const candidates = [
     candidate,
     ...RUNTIME_JS_EXTENSIONS.map((extension) => `${candidate}${extension}`),
-    ...RUNTIME_JS_EXTENSIONS.map((extension) => join13(candidate, `index${extension}`))
+    ...RUNTIME_JS_EXTENSIONS.map((extension) => join16(candidate, `index${extension}`))
   ];
   return candidates.find((filePath) => isRuntimeJsFile(filePath) && isFile(filePath)) ?? null;
 }, findContainingRuntimePackageDir = (filePath) => {
   let dir = dirname5(filePath);
   while (dir !== dirname5(dir)) {
-    if (isNodeModulesPath(dir) && existsSync13(join13(dir, "package.json"))) {
+    if (isNodeModulesPath(dir) && existsSync16(join16(dir, "package.json"))) {
       return dir;
     }
     dir = dirname5(dir);
@@ -172225,7 +172608,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
   const entry = pickExportEntry(pkg?.imports?.[specifier]);
   if (!entry)
     return null;
-  return join13(packageDir, entry);
+  return join16(packageDir, entry);
 }, collectRuntimeRewriteRoots = (distDir) => collectFiles2(distDir).filter((filePath) => isRuntimeJsFile(filePath) && !isNodeModulesPath(filePath)), rewriteRuntimeModuleSpecifiers = (distDir) => {
   const packageSpecifiers = collectRuntimePackageSpecifiers(distDir);
   if (packageSpecifiers.length === 0)
@@ -172244,7 +172627,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
     if (!filePath || seen.has(filePath))
       continue;
     seen.add(filePath);
-    const source = readFileSync14(filePath, "utf-8");
+    const source = readFileSync15(filePath, "utf-8");
     const rewritten = source.replace(MODULE_SPECIFIER_RE, (match, prefix, quote, specifier) => {
       if (typeof specifier === "string" && specifier.startsWith(".")) {
         enqueue(resolveRuntimeJsFile(resolve12(dirname5(filePath), specifier)));
@@ -172262,7 +172645,7 @@ var cliTag4 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[c
       return `${prefix}${quote}${ensureRelativeModuleSpecifier(filePath, target)}${quote}`;
     });
     if (rewritten !== source) {
-      writeFileSync5(filePath, rewritten);
+      writeFileSync6(filePath, rewritten);
     }
   }
 }, generateEntrypoint = (distDir, serverEntry, prerenderMap, version2, buildConfig) => {
@@ -172717,7 +173100,7 @@ console.log(\`
   const resolvedOutdir = resolve12(outdir ?? "dist");
   await withBuildDirectoryLock(resolvedOutdir, () => compileUnlocked(serverEntry, resolvedOutdir, outfile, configPath2));
 }, compileUnlocked = async (serverEntry, resolvedOutdir, outfile, configPath2) => {
-  const prerenderPort = Number(env3.COMPILE_PORT) || Number(env3.PORT) || DEFAULT_PORT + 1;
+  const prerenderPort = Number(env4.COMPILE_PORT) || Number(env4.PORT) || DEFAULT_PORT + 1;
   killStaleProcesses(prerenderPort);
   const entryName = basename7(serverEntry).replace(/\.[^.]+$/, "");
   const resolvedOutfile = resolve12(outfile ?? "compiled-server");
@@ -172782,11 +173165,11 @@ console.log(\`
     process.exit(1);
   }
   const outputPath = resolve12(resolvedOutdir, `${entryName}.js`);
-  if (!existsSync13(outputPath)) {
+  if (!existsSync16(outputPath)) {
     console.error(cliTag4("\x1B[31m", `Expected output not found: ${outputPath}`));
     process.exit(1);
   }
-  if (existsSync13(resolve12(resolvedOutdir, "angular", "vendor", "server"))) {
+  if (existsSync16(resolve12(resolvedOutdir, "angular", "vendor", "server"))) {
     const vendorDir = resolve12(resolvedOutdir, "angular", "vendor", "server");
     const vendorEntries = readdirSync3(vendorDir).filter((f) => f.endsWith(".js"));
     const angularServerVendorPaths = {};
@@ -172808,7 +173191,7 @@ console.log(\`
   copyServerRuntimeAssetReferences(resolvedOutdir);
   const prerenderStart = performance.now();
   process.stdout.write(cliTag4("\x1B[36m", "Pre-rendering pages"));
-  rmSync4(join13(resolvedOutdir, "_prerendered"), {
+  rmSync5(join16(resolvedOutdir, "_prerendered"), {
     force: true,
     recursive: true
   });
@@ -172827,7 +173210,7 @@ console.log(\`
   const compileStart = performance.now();
   process.stdout.write(cliTag4("\x1B[36m", "Compiling standalone executable"));
   const entrypointCode = generateEntrypoint(resolvedOutdir, serverEntry, prerenderMap, absoluteVersion, buildConfig);
-  const entrypointPath = join13(resolvedOutdir, "_compile_entrypoint.ts");
+  const entrypointPath = join16(resolvedOutdir, "_compile_entrypoint.ts");
   await Bun.write(entrypointPath, entrypointCode);
   mkdirSync8(dirname5(resolvedOutfile), { recursive: true });
   const result = await Bun.build({
@@ -172923,11 +173306,11 @@ var exports_typecheck = {};
 __export(exports_typecheck, {
   typecheck: () => typecheck
 });
-import { resolve as resolve13, join as join14 } from "path";
-import { existsSync as existsSync14, readFileSync as readFileSync15 } from "fs";
+import { resolve as resolve13, join as join17 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync16 } from "fs";
 import { mkdir as mkdir2, writeFile } from "fs/promises";
 var isCommandService3 = (service) => service.kind === "command" || Array.isArray(service.command), resolveConfigPath = (configPath2) => resolve13(configPath2 ?? process.env.ABSOLUTE_CONFIG ?? "absolute.config.ts"), getTypecheckTargets = async (configPath2) => {
-  if (!existsSync14(resolveConfigPath(configPath2))) {
+  if (!existsSync17(resolveConfigPath(configPath2))) {
     return [{}];
   }
   const rawConfig = await loadRawConfig(configPath2);
@@ -172948,7 +173331,7 @@ var isCommandService3 = (service) => service.kind === "command" || Array.isArray
   return { exitCode, name, output: (stdout + stderr).trim() };
 }, shellEscape = (value) => `'${value.replaceAll("'", "'\\''")}'`, runShell = async (name, command) => run(name, ["/bin/bash", "-lc", command]), findBin = (name) => {
   const local = resolve13("node_modules", ".bin", name);
-  return existsSync14(local) ? local : null;
+  return existsSync17(local) ? local : null;
 }, ANSI_COLOR_REGEX, ANSI_PURPLE_REGEX, ANSI_CYAN_REGEX, ANSI_TOKEN_END_REGEX, stripAnsi3 = (str) => str.replace(ANSI_COLOR_REGEX, ""), formatSvelteOutput = (output) => {
   const cwd = `${process.cwd()}/`;
   const summaryMatch = stripAnsi3(output).match(/svelte-check found (\d+) error/);
@@ -173000,10 +173383,10 @@ Found ${errorCount} error${suffix}.`;
     resolve13(import.meta.dir, "../../types", fileName),
     resolve13(import.meta.dir, "../../../types", fileName)
   ];
-  return candidates.find((candidate) => existsSync14(candidate)) ?? candidates[0];
+  return candidates.find((candidate) => existsSync17(candidate)) ?? candidates[0];
 }, ABSOLUTE_TYPECHECK_FILES, readProjectTsconfig = () => {
   try {
-    return JSON.parse(readFileSync15(resolve13("tsconfig.json"), "utf-8"));
+    return JSON.parse(readFileSync16(resolve13("tsconfig.json"), "utf-8"));
   } catch {
     return {};
   }
@@ -173031,7 +173414,7 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m vue-tsc is required for Vue type checking. Install it: bun add -d vue-tsc");
     process.exit(1);
   }
-  const vueTsconfigPath = join14(cacheDir, "tsconfig.vue-check.json");
+  const vueTsconfigPath = join17(cacheDir, "tsconfig.vue-check.json");
   return writeFile(vueTsconfigPath, JSON.stringify({
     compilerOptions: {
       rootDir: ".."
@@ -173046,7 +173429,7 @@ Found ${errorCount} error${suffix}.`;
     resolve13(vueTsconfigPath),
     "--incremental",
     "--tsBuildInfoFile",
-    join14(cacheDir, "vue-tsc.tsbuildinfo"),
+    join17(cacheDir, "vue-tsc.tsbuildinfo"),
     "--pretty"
   ]));
 }, buildAngularCheck = async (cacheDir, angularDir) => {
@@ -173055,7 +173438,7 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m @angular/compiler-cli is required for Angular type checking. Install it: bun add -d @angular/compiler-cli");
     process.exit(1);
   }
-  const angularTsconfigPath = join14(cacheDir, "tsconfig.angular-check.json");
+  const angularTsconfigPath = join17(cacheDir, "tsconfig.angular-check.json");
   await writeFile(angularTsconfigPath, JSON.stringify({
     angularCompilerOptions: {
       strictTemplates: true
@@ -173075,7 +173458,7 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m typescript is required for type checking. Install it: bun add -d typescript");
     process.exit(1);
   }
-  const tscConfigPath = join14(cacheDir, "tsconfig.typecheck.json");
+  const tscConfigPath = join17(cacheDir, "tsconfig.typecheck.json");
   return writeFile(tscConfigPath, JSON.stringify({
     compilerOptions: {
       rootDir: ".."
@@ -173090,7 +173473,7 @@ Found ${errorCount} error${suffix}.`;
     resolve13(tscConfigPath),
     "--incremental",
     "--tsBuildInfoFile",
-    join14(cacheDir, "tsc.tsbuildinfo"),
+    join17(cacheDir, "tsc.tsbuildinfo"),
     "--pretty"
   ]));
 }, buildSvelteCheck = async (cacheDir, svelteDir) => {
@@ -173099,7 +173482,7 @@ Found ${errorCount} error${suffix}.`;
     console.error("\x1B[31m\u2717\x1B[0m svelte-check is required for Svelte type checking. Install it: bun add -d svelte-check");
     process.exit(1);
   }
-  const svelteTsconfigPath = join14(cacheDir, "tsconfig.svelte-check.json");
+  const svelteTsconfigPath = join17(cacheDir, "tsconfig.svelte-check.json");
   await writeFile(svelteTsconfigPath, JSON.stringify({
     extends: resolve13("tsconfig.json"),
     files: ABSOLUTE_TYPECHECK_FILES,
@@ -173343,8 +173726,15 @@ var init_tunnelRelay = __esm(() => {
 init_constants();
 var {$: $3, env } = globalThis.Bun;
 import { spawn as nodeSpawn } from "child_process";
-import { createWriteStream, existsSync as existsSync5, readFileSync as readFileSync7 } from "fs";
-import { resolve as resolve3 } from "path";
+import {
+  createWriteStream,
+  existsSync as existsSync5,
+  readFileSync as readFileSync7,
+  rmSync as rmSync2,
+  writeFileSync as writeFileSync4
+} from "fs";
+import { tmpdir } from "os";
+import { join as join6, resolve as resolve3 } from "path";
 
 // src/dev/tunnel/client.ts
 var RECONNECT_DELAY_MS = 2000;
@@ -173509,6 +173899,7 @@ import { ReadStream } from "tty";
 var SHORTCUTS = {
   c: "clear",
   h: "help",
+  m: "heapSnapshot",
   o: "open",
   p: "pause",
   q: "quit",
@@ -173516,12 +173907,14 @@ var SHORTCUTS = {
 };
 var WORD_COMMANDS = {
   clear: "clear",
+  heap: "heapSnapshot",
   help: "help",
   open: "open",
   pause: "pause",
   quit: "quit",
   restart: "restart",
-  resume: "pause"
+  resume: "pause",
+  snapshot: "heapSnapshot"
 };
 var trySetRawMode = () => {
   if (typeof process.stdin.setRawMode !== "function") {
@@ -173816,6 +174209,16 @@ var resolveDevPort = async (requestedPort, options = {}) => {
 init_utils();
 var cliTag = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[cli]\x1B[0m ${color}${message}\x1B[0m`;
 var DEFAULT_PORT_RANGE = 10;
+var HEAP_SNAPSHOT_PRELOAD = `process.on('SIGUSR2', () => {
+	try {
+		const file = 'heap-' + process.pid + '-' + Date.now() + '.heapsnapshot';
+		Bun.write(file, Bun.generateHeapSnapshot('v8'));
+		console.log('[absolute] heap snapshot written: ' + file + ' (open in DevTools Memory tab)');
+	} catch (error) {
+		console.error('[absolute] heap snapshot failed:', error);
+	}
+});
+`;
 var ANSI_LOG_REGEX = new RegExp(`${String.fromCharCode(ANSI_ESCAPE_CODE)}\\[[0-?]*[ -/]*[@-~]`, "g");
 var confirmPrompt = (message, defaultYes = true) => {
   const { promise, resolve: resolvePrompt } = Promise.withResolvers();
@@ -174078,9 +174481,29 @@ var dev = async (serverEntry, configPath2) => {
     }
     return merged;
   };
+  const heapPreloadPath = join6(tmpdir(), `absolute-heap-${process.pid}.ts`);
+  let heapSnapshotEnabled = false;
+  try {
+    writeFileSync4(heapPreloadPath, HEAP_SNAPSHOT_PRELOAD);
+    heapSnapshotEnabled = true;
+  } catch {
+    heapSnapshotEnabled = false;
+  }
+  const removeHeapPreload = () => {
+    if (!heapSnapshotEnabled)
+      return;
+    try {
+      rmSync2(heapPreloadPath, { force: true });
+    } catch {}
+  };
   const spawnServer = async () => {
     await refreshDevConfigForSpawn();
-    const proc = nodeSpawn("bun", ["--hot", "--no-clear-screen", serverEntry], {
+    const proc = nodeSpawn("bun", [
+      "--hot",
+      "--no-clear-screen",
+      ...heapSnapshotEnabled ? ["--preload", heapPreloadPath] : [],
+      serverEntry
+    ], {
       cwd: process.cwd(),
       detached: true,
       env: {
@@ -174129,7 +174552,7 @@ var dev = async (serverEntry, configPath2) => {
   };
   try {
     const { watch } = await import("fs");
-    const { dirname: dirname3, join: join6 } = await import("path");
+    const { dirname: dirname3, join: join7 } = await import("path");
     const absServerEntry = resolve3(serverEntry);
     const serverEntryDir = dirname3(absServerEntry);
     const ROOT_RESTART_DENY = new Set([
@@ -174162,7 +174585,7 @@ var dev = async (serverEntry, configPath2) => {
       if (now - last < 100)
         return;
       recentlyHandled.set(filename, now);
-      scheduleServerRestart(join6(serverEntryDir, filename));
+      scheduleServerRestart(join7(serverEntryDir, filename));
     };
     const recoveryScan = async () => {
       let entries;
@@ -174181,7 +174604,7 @@ var dev = async (serverEntry, configPath2) => {
           continue;
         let st;
         try {
-          st = statSync(join6(serverEntryDir, entry.name));
+          st = statSync(join7(serverEntryDir, entry.name));
         } catch {
           continue;
         }
@@ -174268,6 +174691,7 @@ var dev = async (serverEntry, configPath2) => {
       instanceLog.end();
     } catch {}
     deregisterInstance(instancePid);
+    removeHeapPreload();
     process.exit(exitCode);
   };
   const restartServer = async () => {
@@ -174352,11 +174776,29 @@ var dev = async (serverEntry, configPath2) => {
       console.log(cliTag("\x1B[33m", `Could not open browser. Visit ${url}`));
     }
   };
+  const triggerHeapSnapshot = () => {
+    if (!heapSnapshotEnabled) {
+      console.log(cliTag("\x1B[33m", "Heap snapshot unavailable (no preload)."));
+      return;
+    }
+    const childPid = serverProcess.pid;
+    if (childPid === undefined)
+      return;
+    try {
+      process.kill(childPid, "SIGUSR2");
+      console.log(cliTag("\x1B[36m", "Capturing heap snapshot..."));
+    } catch {
+      console.log(cliTag("\x1B[33m", "Could not signal the server for a snapshot."));
+    }
+  };
   interactive = createInteractiveHandler({
     shell: runShellCommand2,
     clear: () => {
       process.stdout.write("\x1Bc");
     },
+    heapSnapshot: () => {
+      triggerHeapSnapshot();
+    },
     help: () => {
       printHelp();
     },
@@ -174446,7 +174888,7 @@ var dev = async (serverEntry, configPath2) => {
 };
 
 // src/cli/scripts/eslint.ts
-import { existsSync as existsSync6, readFileSync as readFileSync8, rmSync as rmSync2 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync8, rmSync as rmSync3 } from "fs";
 import { resolve as resolve4 } from "path";
 var DEFAULT_CACHE_LOCATION = ".absolutejs/eslint-cache";
 var getCacheLocation = () => process.env.ABSOLUTE_ESLINT_CACHE?.trim() || DEFAULT_CACHE_LOCATION;
@@ -174644,7 +175086,7 @@ var formatDuration = (ms) => {
 };
 var handleClearCache = (cacheLocation) => {
   try {
-    rmSync2(cacheLocation, { force: true });
+    rmSync3(cacheLocation, { force: true });
     console.log(`\x1B[32m\u2713\x1B[0m Cleared cache: ${cacheLocation}`);
   } catch (err) {
     console.error(`\x1B[31m\u2717\x1B[0m Failed to clear cache at ${cacheLocation}:`, err);
@@ -174838,7 +175280,7 @@ var info = () => {
 // src/cli/cache.ts
 init_constants();
 import { mkdir } from "fs/promises";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 var {Glob } = globalThis.Bun;
 var CACHE_DIR = ".absolutejs";
 var MAX_FILES_PER_BATCH = 200;
@@ -174890,7 +175332,7 @@ var hashFiles = async (paths) => {
 };
 var loadCache = async (tool) => {
   try {
-    const path = join6(CACHE_DIR, `${tool}.cache.json`);
+    const path = join7(CACHE_DIR, `${tool}.cache.json`);
     const data = await Bun.file(path).json();
     const result = data;
     return result;
@@ -174937,7 +175379,7 @@ var runTool = async (adapter, args) => {
 };
 var saveCache = async (tool, data) => {
   await mkdir(CACHE_DIR, { recursive: true });
-  const path = join6(CACHE_DIR, `${tool}.cache.json`);
+  const path = join7(CACHE_DIR, `${tool}.cache.json`);
   await Bun.write(path, JSON.stringify(data, null, "\t"));
 };
 
@@ -174982,8 +175424,8 @@ init_startupBanner();
 init_telemetryEvent();
 init_utils();
 var {env: env2 } = globalThis.Bun;
-import { existsSync as existsSync8, readFileSync as readFileSync11, rmSync as rmSync3 } from "fs";
-import { basename as basename3, join as join10, resolve as resolve8 } from "path";
+import { existsSync as existsSync8, readFileSync as readFileSync11, rmSync as rmSync4 } from "fs";
+import { basename as basename3, join as join11, resolve as resolve8 } from "path";
 var cliTag2 = (color, message) => `\x1B[2m${formatTimestamp()}\x1B[0m ${color}[cli]\x1B[0m ${color}${message}\x1B[0m`;
 var resolvePackageVersion = (candidates) => {
   for (const candidate of candidates) {
@@ -175103,7 +175545,7 @@ var start = async (serverEntry, outdir, configPath2) => {
     if (!build)
       throw new Error("Could not locate build module");
     await build(buildConfig);
-    rmSync3(join10(resolvedOutdir, "_prerendered"), {
+    rmSync4(join11(resolvedOutdir, "_prerendered"), {
       force: true,
       recursive: true
     });
@@ -175346,7 +175788,7 @@ import {
   readdirSync as readdirSync2,
   readFileSync as readFileSync12,
   unlinkSync as unlinkSync3,
-  writeFileSync as writeFileSync4
+  writeFileSync as writeFileSync5
 } from "fs";
 import { createConnection } from "net";
 import { resolve as resolve9 } from "path";
@@ -175913,8 +176355,8 @@ var createWorkspaceLogSink = (appendLog) => {
   const logDirectory = resolve9(".absolutejs", "workspace", "logs");
   mkdirSync6(logDirectory, { recursive: true });
   readdirSync2(logDirectory).filter((file) => file.endsWith(".log")).forEach((file) => unlinkSync3(resolve9(logDirectory, file)));
-  writeFileSync4(resolve9(logDirectory, "all.log"), "");
-  writeFileSync4(resolve9(logDirectory, "workspace.log"), "");
+  writeFileSync5(resolve9(logDirectory, "all.log"), "");
+  writeFileSync5(resolve9(logDirectory, "workspace.log"), "");
   const initializedSources = new Set(["workspace"]);
   const writeLog = (source, message, level) => {
     const cleanMessage = stripAnsi2(message).trimEnd();
@@ -175926,7 +176368,7 @@ var createWorkspaceLogSink = (appendLog) => {
 `;
     const sourceFile = resolve9(logDirectory, `${sanitizeLogFileName(source)}.log`);
     if (!initializedSources.has(source)) {
-      writeFileSync4(sourceFile, "");
+      writeFileSync5(sourceFile, "");
       initializedSources.add(source);
     }
     appendFileSync(sourceFile, line);
@@ -176743,6 +177185,22 @@ if (command === "dev") {
   sendTelemetryEvent("cli:command", { command: "ps" });
   const { runPs: runPs2 } = await Promise.resolve().then(() => (init_ps(), exports_ps));
   await runPs2(args);
+} else if (command === "mem") {
+  sendTelemetryEvent("cli:command", { command: "mem" });
+  const { runMem: runMem2 } = await Promise.resolve().then(() => (init_mem(), exports_mem));
+  await runMem2(args);
+} else if (command === "env") {
+  sendTelemetryEvent("cli:command", { command: "env" });
+  const { runEnv: runEnv2 } = await Promise.resolve().then(() => (init_env(), exports_env));
+  await runEnv2(args);
+} else if (command === "logs") {
+  sendTelemetryEvent("cli:command", { command: "logs" });
+  const { runLogs: runLogs2 } = await Promise.resolve().then(() => (init_logs(), exports_logs));
+  await runLogs2(args);
+} else if (command === "doctor") {
+  sendTelemetryEvent("cli:command", { command: "doctor" });
+  const { runDoctor: runDoctor2 } = await Promise.resolve().then(() => (init_doctor(), exports_doctor));
+  await runDoctor2(args);
 } else if (command === "info") {
   sendTelemetryEvent("cli:command", { command });
   info();
@@ -176782,9 +177240,13 @@ if (command === "dev") {
   console.error("  start [entry] [--outdir dir] Start production server");
   console.error("  compile [entry] [--outdir dir] [--outfile path] Compile standalone executable");
   console.error("  config [--port n] Open the unified config UI (ESLint, tsconfig, Prettier)");
+  console.error("  doctor [--json] Diagnose the project (bun, config, framework dirs, env, port)");
+  console.error("  env [--check] [--json] Report env vars the app reads (getEnv) and which are missing");
   console.error("  eslint        Run ESLint (cached)");
   console.error("  info          Print system info for bug reports");
-  console.error("  ls [--all] [--json] List the project's built pages, islands, and assets");
+  console.error("  logs <name> [-f] [-n <lines>] Tail a running server's log by name");
+  console.error("  ls [--sizes] [--json] List the project's pages by framework (from source)");
+  console.error("  mem [--json]  Memory report (RSS) for running servers, plus system usage");
   console.error("  ps [--watch] [--json] [--kill <pid|port>] [--kill-all] List/manage running servers");
   console.error("  prettier      Run Prettier check (cached)");
   console.error("  typecheck     Run type checkers for all frameworks");

package/dist/src/cli/scripts/doctor.d.ts

@@ -0,0 +1 @@
+export declare const runDoctor: (args: string[]) => Promise<void>;

package/dist/src/cli/scripts/env.d.ts

@@ -0,0 +1,7 @@
+export declare const scanEnvUsage: () => Promise<Map<string, string[]>>;
+export declare const collectEnvVars: () => Promise<{
+    files: string[];
+    key: string;
+    set: boolean;
+}[]>;
+export declare const runEnv: (args: string[]) => Promise<void>;

package/dist/src/cli/scripts/logs.d.ts

@@ -0,0 +1 @@
+export declare const runLogs: (args: string[]) => Promise<void>;

package/dist/src/cli/scripts/mem.d.ts

@@ -0,0 +1 @@
+export declare const runMem: (args: string[]) => Promise<void>;

package/dist/types/cli.d.ts

@@ -1,6 +1,7 @@
 export type Action = () => void | Promise<void>;
 export type Actions = {
     clear: Action;
+    heapSnapshot: Action;
     help: Action;
     open: Action;
     pause: Action;

package/package.json

@@ -411,7 +411,7 @@
 			]
 		}
 	},
-	"version": "0.19.0-beta.1035",
+	"version": "0.19.0-beta.1037",
 	"workspaces": [
 		"tests/fixtures/*",
 		"tests/fixtures/_packages/*"