@akanjs/cli 3.0.0-beta.2 → 3.0.0-beta.20

package/{index-v0qh106m.js → index-ww4z397j.js}

@@ -1,178 +1,74 @@
 // @bun
+import {
+  ApplicationBuildReporter,
+  BUILDER_MIN_RSS_RECYCLE_INTERVAL_MS,
+  SOURCE_EXTS,
+  shouldRestartBackendByDevPlan,
+  shouldRestartBuilderByDevPlan,
+  shouldAbandonBackendRecovery,
+  normalizeBackendReportedGeneration,
+  shouldRestartDevHostByDevPlan,
+  devHostStateOf,
+  isLegacyBackendFallbackFile,
+  shouldMarkBuildPhaseRecovered,
+  createBackendBuildStatus,
+  backendRestartReasonFromMessage,
+  mergeBackendRestartReasons,
+  shouldReplaceLastGoodMessage,
+  shouldQueueBuildStatusReplay,
+  hasBuildFailureForGeneration,
+  decideBuilderRssRecycle,
+  decideBuilderRssSettle,
+  decideIdleSuspend,
+  resolveIdleSuspendMs,
+  hasAnyBuildFailure,
+  shouldRefreshConfigOnIdleWake,
+  shouldHoldForReturningBuilder,
+  shouldWarnBuilderRssCeilingTight,
+  isRssCeilingUnreachable,
+  shouldRelayRecycledFrontendState,
+  mergeInvalidateMessages,
+  buildStatusReplaySequence,
+  filesChangedSince,
+  HmrWatcher,
+  WatchRootResolver
+} from "./index-khpfpcsd.js";
 import {
   runner,
   script
-} from "./index-mak3cd28.js";
+} from "./index-w2zdcw3k.js";
 import {
   WorkspaceExecutor,
   AppExecutor,
   LibExecutor,
   PkgExecutor
-} from "./index-2tv3fdx4.js";
+} from "./index-9d9bgcx4.js";
 import {
   LibraryScript
-} from "./index-259dsnz3.js";
+} from "./index-5pc1qrbv.js";
 import {
-  HmrWatcher,
-  WatchRootResolver
-} from "./index-hwkygn9s.js";
+  stripAnsi
+} from "./index-7md2g9vw.js";
 import {
   SlicePlanner,
   formatSlicePlan
-} from "./index-j9yhg404.js";
+} from "./index-xqjwd384.js";
 import {
   resolveMobileTargets
-} from "./index-47pj3aee.js";
-
-// pkgs/@akanjs/cli/openBrowser.ts
-import { spawn } from "child_process";
-function openBrowser(url) {
-  const command = process.platform === "darwin" ? ["open", url] : process.platform === "win32" ? ["cmd", "/c", "start", "", url] : ["xdg-open", url];
-  const child = spawn(command[0], command.slice(1), { detached: true, stdio: "ignore" });
-  child.on("error", () => {});
-  child.unref();
-  return Promise.resolve();
-}
-
-// pkgs/@akanjs/cli/application/devLogBuffer.ts
-var ansi = new RegExp(`${String.fromCharCode(27)}(?:[@-Z\\\\-_]|\\[[\\s\\S]*?[@-~])`, "g");
-var stripAnsi = (text) => text.replace(ansi, "");
-var plainTextOf = (lines, { withApp = false } = {}) => {
-  const width = withApp ? lines.reduce((max, line) => Math.max(max, line.app.length), 0) : 0;
-  return lines.map((line) => `${withApp ? `${line.app.padEnd(width)} \u2502 ` : ""}${stripAnsi(line.text)}`).join(`
-`);
-};
-var HOST_SOURCE = "host";
-var childPrefix = /^\[child:(\d+) ([a-z-]+)\] \[(?:stdout|stderr)\] /;
-var sourceOf = (text) => {
-  const match = childPrefix.exec(text);
-  return match ? `#${match[1]} ${match[2]}` : HOST_SOURCE;
-};
-
-class DevLogBuffer {
-  static defaultLimit = 5000;
-  #limit;
-  #lines = [];
-  #partial = new Map;
-  #sources = new Map;
-  #seq = 0;
-  constructor({ limit = DevLogBuffer.defaultLimit } = {}) {
-    this.#limit = Math.max(1, limit);
-  }
-  get size() {
-    return this.#lines.length;
-  }
-  sourcesOf(app) {
-    return [...this.#sources.get(app) ?? []];
-  }
-  push(app, kind, chunk) {
-    const key = `${app}:${kind}`;
-    const parts = `${this.#partial.get(key) ?? ""}${chunk}`.split(`
-`);
-    this.#partial.set(key, parts.pop() ?? "");
-    return this.#append(app, kind, parts);
-  }
-  flushPartials() {
-    const flushed = [];
-    for (const [key, remainder] of [...this.#partial]) {
-      this.#partial.set(key, "");
-      if (!remainder)
-        continue;
-      const split = key.lastIndexOf(":");
-      const app = key.slice(0, split);
-      const kind = key.slice(split + 1) === "stderr" ? "stderr" : "stdout";
-      flushed.push(...this.#append(app, kind, [remainder]));
-    }
-    return flushed;
-  }
-  select({ app = null, source = null, grep, errorsOnly = false } = {}) {
-    const needle = grep?.trim().toLowerCase();
-    return this.#lines.filter((line) => {
-      if (app !== null && line.app !== app)
-        return false;
-      if (source !== null && line.source !== source)
-        return false;
-      if (errorsOnly && line.kind !== "stderr")
-        return false;
-      if (needle && !stripAnsi(line.text).toLowerCase().includes(needle))
-        return false;
-      return true;
-    });
-  }
-  clear(app = null) {
-    const kept = app === null ? [] : this.#lines.filter((line) => line.app !== app);
-    this.#lines.length = 0;
-    this.#lines.push(...kept);
-  }
-  #append(app, kind, texts) {
-    const known = this.#sources.get(app) ?? new Set;
-    this.#sources.set(app, known);
-    const added = texts.map((text) => {
-      const source = sourceOf(text);
-      known.add(source);
-      return { seq: ++this.#seq, app, source, kind, text };
-    });
-    this.#lines.push(...added);
-    if (this.#lines.length > this.#limit)
-      this.#lines.splice(0, this.#lines.length - this.#limit);
-    return added;
-  }
-}
-
-// pkgs/@akanjs/devkit/applicationBuildReporter.ts
-import { Logger } from "akanjs/common";
-
-class ApplicationBuildReporter {
-  static create() {
-    return {
-      phaseDone: (phase) => Logger.rawLog(ApplicationBuildReporter.formatPhaseLine(phase))
-    };
-  }
-  static printSummary(result) {
-    Logger.rawLog("");
-    Logger.rawLog(`Route artifacts: ${result.artifactDir}`);
-    Logger.rawLog(`Server output: ${result.outputDir}`);
-    Logger.rawLog(`Done in ${ApplicationBuildReporter.formatDuration(result.durationMs)}`);
-  }
-  static formatError(error) {
-    if (error instanceof AggregateError) {
-      const nestedMessages = error.errors.map((nestedError, index) => ApplicationBuildReporter.formatError(nestedError).trim() || `Unknown error ${index + 1}`).map((message) => message.replace(/^/gm, "  ")).join(`
-`);
-      return nestedMessages ? `${error.message}
-${nestedMessages}` : error.message;
-    }
-    if (error instanceof Error) {
-      const causeMessage = error.cause ? `
-Caused by: ${ApplicationBuildReporter.formatError(error.cause)}` : "";
-      return `${error.message}${causeMessage}`;
-    }
-    if (typeof error === "object" && error !== null && "message" in error)
-      return String(error.message);
-    return String(error);
-  }
-  static formatDuration(ms) {
-    if (ms < 1000)
-      return `${ms}ms`;
-    if (ms < 60000)
-      return `${Math.round(ms / 100) / 10}s`;
-    const seconds = Math.floor(ms / 1000);
-    return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
-  }
-  static formatPhaseLine(phase) {
-    const summary = phase.summary ? `: ${phase.summary}` : "";
-    return `\u2713 ${phase.label}${summary} (${ApplicationBuildReporter.formatDuration(phase.durationMs)})`;
-  }
-}
+} from "./index-5e0n4hqx.js";
+import {
+  openBrowser
+} from "./index-9dp031by.js";
 
 // pkgs/@akanjs/cli/application/application.script.ts
 import { confirm } from "@inquirer/prompts";
 import { Logger as Logger6 } from "akanjs/common";
 
 // pkgs/@akanjs/cli/application/application.runner.ts
-import path5 from "path";
+import path4 from "path";
 
 // pkgs/@akanjs/devkit/akanApp/akanApp.host.ts
-import { Logger as Logger3 } from "akanjs/common";
+import { Logger as Logger2 } from "akanjs/common";
 
 // pkgs/@akanjs/devkit/sshTunnel.ts
 import { Client } from "ssh2";
@@ -261,7 +157,7 @@ var createSshTunnel = async (options) => {
       for (const socket of sockets)
         closeSocket(socket, error);
       closeQuietly(() => client.end());
-      closeBunServer(server);
+      server.stop();
     };
     client.once("error", (error) => closeTunnel(error));
     client.once("close", () => closeTunnel());
@@ -281,22 +177,10 @@ var closeBunSocket = (socket, error) => {
     socket.data.stream?.end();
   closeQuietly(() => socket.end());
 };
-var closeBunServer = (server) => {
-  server.stop();
-};
 
 // pkgs/@akanjs/devkit/createTunnel.ts
-var getSshTunnelOptions = (app, environment) => {
-  const { serveDomain, repoName } = WorkspaceExecutor.getBaseDevEnv();
-  return {
-    host: `${app.name}-${environment}.${serveDomain}`,
-    port: process.env.SSH_TUNNEL_PORT ? parseInt(process.env.SSH_TUNNEL_PORT) : 32767,
-    username: process.env.SSH_TUNNEL_USERNAME ?? "root",
-    password: process.env.SSH_TUNNEL_PASSWORD ?? repoName
-  };
-};
 var createTunnel = async (service, { app, environment, port = service === "postgres" ? 5432 : 6379 }) => {
-  const sshOptions = getSshTunnelOptions(app, environment);
+  const { serveDomain, repoName } = WorkspaceExecutor.getBaseDevEnv();
   await createSshTunnel({
     localHost: "0.0.0.0",
     localPort: port,
@@ -304,13 +188,18 @@ var createTunnel = async (service, { app, environment, port = service === "postg
     srcPort: port,
     dstHost: `${service}-0.${service}-svc.${app.name}-${environment}.svc.cluster.local`,
     dstPort: service === "postgres" ? 5432 : 6379,
-    sshOptions
+    sshOptions: {
+      host: `${app.name}-${environment}.${serveDomain}`,
+      port: process.env.SSH_TUNNEL_PORT ? parseInt(process.env.SSH_TUNNEL_PORT) : 32767,
+      username: process.env.SSH_TUNNEL_USERNAME ?? "root",
+      password: process.env.SSH_TUNNEL_PASSWORD ?? repoName
+    }
   });
   return `localhost:${port}`;
 };
 // pkgs/@akanjs/devkit/incrementalBuilder/incrementalBuilder.host.ts
 import path from "path";
-import { Logger as Logger2 } from "akanjs/common";
+import { Logger } from "akanjs/common";
 import { MemoryLimit } from "akanjs/server/memoryLimit";
 var builderMsgTypeSet = new Set([
   "build-route-res",
@@ -328,7 +217,7 @@ class IncrementalBuilderHost {
   static #restartMaxDelayMs = 30000;
   static #recycleDrainTimeoutMs = 30000;
   static #devMaxRssBytes = 1200 * 1024 * 1024;
-  logger = new Logger2("IncrementalBuilderHost");
+  logger = new Logger("IncrementalBuilderHost");
   entry;
   env;
   app;
@@ -518,12 +407,8 @@ class IncrementalBuilderHost {
     const lost = [...this.#inFlight];
     this.#inFlight.clear();
     this.logger.warn(`failing ${lost.length} unanswered builder request(s): ${reason}`);
-    for (const [id, type] of lost) {
-      if (type === "build-route")
-        this.#onMessage({ type: "build-route-res", id, ok: false, error: reason });
-      else
-        this.#onMessage({ type: "build-csr-res", id, ok: false, error: reason });
-    }
+    for (const [id, type] of lost)
+      this.#onMessage({ type: `${type}-res`, id, ok: false, error: reason });
   }
   stop() {
     this.#manualStop = true;
@@ -592,211 +477,7 @@ class BuilderRequestRouter {
 
 // pkgs/@akanjs/devkit/akanApp/BackendImportGraph.ts
 import { stat } from "fs/promises";
-import path3 from "path";
-
-// pkgs/@akanjs/devkit/akanApp/devHostPolicy.ts
 import path2 from "path";
-var BACKEND_RECOVERY_MAX_ATTEMPTS = 5;
-var HELD_BUILDER_REQUEST_LIMIT = 64;
-var BUILDER_MIN_RSS_RECYCLE_INTERVAL_MS = 30000;
-var BUILDER_TIGHT_RSS_REPORT_LIMIT = 2;
-var BUILDER_RSS_HARD_MULTIPLE = 1.5;
-var DEV_IDLE_SUSPEND_MS = 300000;
-var DEV_IDLE_MIN_UPTIME_MS = 30000;
-var SOURCE_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
-var SERVER_SUFFIXES = [".service.ts", ".document.ts"];
-var SHARED_SUFFIXES = [".constant.ts", ".dictionary.ts", ".signal.ts"];
-var RUNTIME_METADATA_BASENAMES = new Set(["dict.ts", "sig.ts", "useClient.ts", "useServer.ts"]);
-var shouldRestartBackendByDevPlan = (message) => {
-  if (!message.devPlan)
-    return null;
-  if (message.devPlan.actions.includes("report-error"))
-    return false;
-  if (message.devPlan.actions.includes("restart-builder"))
-    return false;
-  return message.devPlan.actions.includes("restart-backend");
-};
-var shouldRestartBuilderByDevPlan = (message) => message.devPlan?.actions.includes("restart-builder") ?? false;
-var shouldAbandonBackendRecovery = (attempts, maxAttempts = BACKEND_RECOVERY_MAX_ATTEMPTS) => attempts >= maxAttempts;
-var normalizeBackendReportedGeneration = (generation) => generation >= 0 ? generation : undefined;
-var shouldRestartDevHostByDevPlan = (message) => message.devPlan?.actions.includes("restart-dev-host") ?? message.kinds.includes("config");
-var devHostStateByBackendState = {
-  starting: "starting",
-  ready: "ready",
-  "restart-pending": "restarting",
-  recovering: "recovering",
-  stopping: "stopped",
-  stopped: "stopped"
-};
-var devHostStateOf = (state, gaveUp) => state === "stopped" && gaveUp ? "failed" : devHostStateByBackendState[state];
-var RESTART_ROLE_ORDER = ["server", "shared", "barrel", "config"];
-var generationValue = (generation) => generation ?? -1;
-var isLegacyBackendFallbackFile = (file, workspaceRoot) => {
-  const abs = path2.resolve(file);
-  const ext = path2.extname(abs).toLowerCase();
-  if (!SOURCE_EXTS.has(ext))
-    return false;
-  const rel = path2.relative(path2.resolve(workspaceRoot), abs);
-  if (!rel || rel.startsWith("..") || path2.isAbsolute(rel))
-    return false;
-  const parts = rel.split(path2.sep).filter(Boolean);
-  const [scope] = parts;
-  if (scope !== "apps" && scope !== "libs" && scope !== "pkgs")
-    return false;
-  const base = path2.basename(abs);
-  return parts.includes("srvkit") || parts.includes("common") || SERVER_SUFFIXES.some((suffix) => base.endsWith(suffix)) || SHARED_SUFFIXES.some((suffix) => base.endsWith(suffix)) || RUNTIME_METADATA_BASENAMES.has(base) || base === "main.ts" || base === "server.ts";
-};
-var shouldMarkBuildPhaseRecovered = (previousByPhase, status) => {
-  const previous = previousByPhase.get(status.phase);
-  return Boolean(previous && status.ok && !previous.ok && generationValue(status.generation) >= previous.generation);
-};
-var createBackendBuildStatus = ({
-  generation,
-  ok,
-  files = [],
-  message
-}) => ({
-  generation,
-  phase: "backend",
-  ok,
-  files,
-  message
-});
-var backendRestartReasonFromMessage = (message) => {
-  const roleSet = new Set;
-  for (const role of message.devPlan?.roles ?? []) {
-    if (role === "server" || role === "shared" || role === "barrel" || role === "config")
-      roleSet.add(role);
-  }
-  return {
-    generation: message.devPlan?.generation ?? message.generation,
-    files: [...new Set(message.files)].sort(),
-    roles: RESTART_ROLE_ORDER.filter((role) => roleSet.has(role))
-  };
-};
-var mergeBackendRestartReasons = (current, next) => ({
-  generation: generationValue(next.generation) >= generationValue(current?.generation) ? next.generation : current?.generation,
-  files: [...new Set([...current?.files ?? [], ...next.files])].sort(),
-  roles: RESTART_ROLE_ORDER.filter((role) => current?.roles.includes(role) || next.roles.includes(role))
-});
-var shouldReplaceLastGoodMessage = (current, next) => !current || generationValue(next.data.generation) >= generationValue(current.data.generation);
-var shouldQueueBuildStatusReplay = (backendReady, pendingReplayCount) => !backendReady || pendingReplayCount > 0;
-var hasBuildFailureForGeneration = (statusByPhase, generation) => {
-  if (typeof generation !== "number")
-    return false;
-  for (const status of statusByPhase.values()) {
-    if (!status.ok && status.generation === generation)
-      return true;
-  }
-  return false;
-};
-var decideBuilderRssRecycle = ({
-  rssBytes,
-  ceilingBytes,
-  buildFailed,
-  msSinceLastRecycle,
-  minIntervalMs = BUILDER_MIN_RSS_RECYCLE_INTERVAL_MS
-}) => {
-  if (!ceilingBytes)
-    return "unbounded";
-  if (rssBytes < ceilingBytes)
-    return "below-ceiling";
-  if (buildFailed)
-    return "build-failed";
-  if (msSinceLastRecycle !== null && msSinceLastRecycle < minIntervalMs)
-    return "too-soon";
-  return "recycle";
-};
-var decideBuilderRssSettle = ({
-  rssBytes,
-  ceilingBytes,
-  hardMultiple = BUILDER_RSS_HARD_MULTIPLE
-}) => rssBytes >= ceilingBytes * hardMultiple ? "recycle-now" : "wait-and-recheck";
-var decideIdleSuspend = ({
-  enabled,
-  suspended,
-  builderReady,
-  backendReady,
-  buildFailed,
-  restartPending,
-  msSinceWake,
-  minUptimeMs = DEV_IDLE_MIN_UPTIME_MS
-}) => {
-  if (!enabled)
-    return "disabled";
-  if (suspended)
-    return "already-suspended";
-  if (!builderReady)
-    return "builder-not-ready";
-  if (!backendReady)
-    return "backend-not-ready";
-  if (buildFailed)
-    return "build-failed";
-  if (restartPending)
-    return "restart-pending";
-  if (msSinceWake !== null && msSinceWake < minUptimeMs)
-    return "too-soon";
-  return "suspend";
-};
-var resolveIdleSuspendMs = (raw) => {
-  if (raw === undefined || raw === "")
-    return DEV_IDLE_SUSPEND_MS;
-  const parsed = Number(raw);
-  if (!Number.isFinite(parsed) || parsed <= 0)
-    return null;
-  return Math.round(parsed);
-};
-var hasAnyBuildFailure = (statusByPhase) => [...statusByPhase.values()].some((status) => !status.ok);
-var shouldRefreshConfigOnIdleWake = (batch) => !!batch && batch.kinds.has("config");
-var RETURNING_BUILDER_STATUSES = new Set(["starting", "recycling", "restarting"]);
-var shouldHoldForReturningBuilder = ({
-  status,
-  heldCount,
-  limit = HELD_BUILDER_REQUEST_LIMIT
-}) => RETURNING_BUILDER_STATUSES.has(status) && heldCount < limit;
-var shouldWarnBuilderRssCeilingTight = (reportsSinceRecycle, limit = BUILDER_TIGHT_RSS_REPORT_LIMIT) => reportsSinceRecycle >= limit;
-var isRssCeilingUnreachable = (freshRssBytes, ceilingBytes) => freshRssBytes !== null && ceilingBytes !== null && freshRssBytes >= ceilingBytes;
-var shouldRelayRecycledFrontendState = (current, next) => {
-  if (!current || current.type !== next.type)
-    return true;
-  if (current.type === "pages-updated" && next.type === "pages-updated")
-    return current.data.bundlePath !== next.data.bundlePath;
-  if (current.type === "css-updated" && next.type === "css-updated")
-    return JSON.stringify(current.data.cssAssets) !== JSON.stringify(next.data.cssAssets);
-  return true;
-};
-var mergeDevPlans = (current, next) => {
-  if (!current)
-    return next;
-  if (!next)
-    return current;
-  const reasonByFile = { ...current.reasonByFile };
-  for (const [file, reasons] of Object.entries(next.reasonByFile)) {
-    reasonByFile[file] = [...new Set([...reasonByFile[file] ?? [], ...reasons])].sort();
-  }
-  return {
-    generation: Math.max(current.generation, next.generation),
-    files: [...new Set([...current.files, ...next.files])].sort(),
-    generatedFiles: [...new Set([...current.generatedFiles, ...next.generatedFiles])].sort(),
-    roles: [...new Set([...current.roles, ...next.roles])].sort(),
-    actions: [...new Set([...current.actions, ...next.actions])].sort(),
-    reasonByFile
-  };
-};
-var mergeInvalidateMessages = (current, next) => {
-  const generation = Math.max(generationValue(current.generation), generationValue(next.generation));
-  return {
-    type: "invalidate",
-    kinds: [...new Set([...current.kinds, ...next.kinds])].sort(),
-    files: [...new Set([...current.files, ...next.files])].sort(),
-    generation: generation >= 0 ? generation : undefined,
-    devPlan: mergeDevPlans(current.devPlan, next.devPlan)
-  };
-};
-var buildStatusReplaySequence = (pendingReplay, latestByPhase) => [...pendingReplay, ...latestByPhase.values()];
-var filesChangedSince = (before, after) => [...before].filter(([file, stamp]) => after.get(file) !== stamp).map(([file]) => file);
-
-// pkgs/@akanjs/devkit/akanApp/BackendImportGraph.ts
 var NON_SOURCE_EXT_RE = /\.(css|scss|sass|less|json|svg|png|jpe?g|webp|gif|avif|ico|woff2?|ttf|otf|mp3|mp4|wav|html)$/i;
 var GRAPH_IMPORT_KINDS = new Set([
   "import-statement",
@@ -827,7 +508,7 @@ class BackendImportGraph {
     return this.#lastRefreshSucceeded;
   }
   has(file) {
-    return this.#files.has(path3.resolve(file));
+    return this.#files.has(path2.resolve(file));
   }
   async fingerprint() {
     const stamps = await Promise.all([...this.#files].map(async (file) => {
@@ -855,9 +536,9 @@ class BackendImportGraph {
     const roots = await this.#entrypoints();
     const files = new Set;
     const queue = [...roots];
-    const workspaceRoot = path3.resolve(this.#app.workspace.workspaceRoot);
+    const workspaceRoot = path2.resolve(this.#app.workspace.workspaceRoot);
     while (queue.length > 0) {
-      const current = path3.resolve(queue.pop());
+      const current = path2.resolve(queue.pop());
       if (files.has(current))
         continue;
       if (!this.#isWorkspaceSource(current, workspaceRoot))
@@ -866,7 +547,7 @@ class BackendImportGraph {
       if (!imports)
         continue;
       files.add(current);
-      const importerDir = path3.dirname(current);
+      const importerDir = path2.dirname(current);
       for (const imp of imports) {
         if (!GRAPH_IMPORT_KINDS.has(imp.kind) || !imp.path || NON_SOURCE_EXT_RE.test(imp.path))
           continue;
@@ -897,7 +578,7 @@ class BackendImportGraph {
     const roots = [`${this.#app.cwdPath}/main.ts`, `${this.#app.cwdPath}/server.ts`];
     const existing = [];
     for (const root of roots) {
-      const abs = path3.resolve(root);
+      const abs = path2.resolve(root);
       if (await Bun.file(abs).exists())
         existing.push(abs);
     }
@@ -906,25 +587,25 @@ class BackendImportGraph {
   #resolve(specifier, importerDir) {
     try {
       const resolved = Bun.resolveSync(specifier, importerDir);
-      if (!path3.isAbsolute(resolved))
+      if (!path2.isAbsolute(resolved))
         return null;
-      if (!SOURCE_EXTS.has(path3.extname(resolved).toLowerCase()))
+      if (!SOURCE_EXTS.has(path2.extname(resolved).toLowerCase()))
         return null;
-      return path3.resolve(resolved);
+      return path2.resolve(resolved);
     } catch {
       return null;
     }
   }
   #isWorkspaceSource(file, workspaceRoot) {
-    const rel = path3.relative(workspaceRoot, file);
-    if (rel.startsWith("..") || path3.isAbsolute(rel))
+    const rel = path2.relative(workspaceRoot, file);
+    if (rel.startsWith("..") || path2.isAbsolute(rel))
       return false;
-    if (rel.includes(`${path3.sep}node_modules${path3.sep}`) || rel.includes(`${path3.sep}.akan${path3.sep}`))
+    if (rel.includes(`${path2.sep}node_modules${path2.sep}`) || rel.includes(`${path2.sep}.akan${path2.sep}`))
       return false;
-    return SOURCE_EXTS.has(path3.extname(file).toLowerCase());
+    return SOURCE_EXTS.has(path2.extname(file).toLowerCase());
   }
   #scanImports(file, source) {
-    const ext = path3.extname(file).toLowerCase();
+    const ext = path2.extname(file).toLowerCase();
     if (ext === ".tsx")
       return this.#tsxTranspiler.scanImports(source);
     if (ext === ".jsx")
@@ -937,6 +618,7 @@ class BackendImportGraph {
 
 // pkgs/@akanjs/devkit/akanApp/akanApp.host.ts
 var backendMsgTypeSet = new Set(["build-route", "build-csr"]);
+var asMib = (bytes) => Math.round(bytes / 1024 / 1024);
 var BACKEND_RESTART_DEBOUNCE_MS = 120;
 var BACKEND_GRACEFUL_TIMEOUT_MS = 8000;
 var BACKEND_RECOVERY_BASE_DELAY_MS = 1000;
@@ -952,7 +634,7 @@ var BUILDER_RECOVERY_MAX_DELAY_MS = 60000;
 
 class AkanAppHost {
   app;
-  logger = new Logger3("AkanAppHost");
+  logger = new Logger2("AkanAppHost");
   stdio;
   env;
   #onDevEvent;
@@ -1030,23 +712,18 @@ class AkanAppHost {
   async stop() {
     this.#cancelIdleSuspend();
     this.#stopIdleWatcher();
-    if (this.#restartTimer) {
-      clearTimeout(this.#restartTimer);
-      this.#restartTimer = null;
-    }
-    if (this.#backendRecoveryTimer) {
-      clearTimeout(this.#backendRecoveryTimer);
-      this.#backendRecoveryTimer = null;
-    }
-    if (this.#builderRecoveryTimer) {
-      clearTimeout(this.#builderRecoveryTimer);
-      this.#builderRecoveryTimer = null;
-    }
+    this.#clearRestartTimers();
     this.#failPendingBuilderMessages("dev server is shutting down");
     await this.#stopBackend();
     this.#stopBuilder();
     return this;
   }
+  #clearRestartTimers() {
+    for (const timer of [this.#restartTimer, this.#backendRecoveryTimer, this.#builderRecoveryTimer])
+      if (timer)
+        clearTimeout(timer);
+    this.#restartTimer = this.#backendRecoveryTimer = this.#builderRecoveryTimer = null;
+  }
   kill() {
     this.stop();
   }
@@ -1342,7 +1019,6 @@ ${this.#backendStderrTail.join(`
     if (this.#rssCeilingAbandoned)
       return;
     const ceilingBytes = IncrementalBuilderHost.maxRssBytes();
-    const asMib = (bytes) => Math.round(bytes / 1024 / 1024);
     const decision = decideBuilderRssRecycle({
       rssBytes: metrics.rssBytes,
       ceilingBytes,
@@ -1380,7 +1056,6 @@ ${this.#backendStderrTail.join(`
     if (!isRssCeilingUnreachable(freshRssBytes, ceilingBytes))
       return;
     this.#rssCeilingAbandoned = true;
-    const asMib = (bytes) => Math.round(bytes / 1024 / 1024);
     this.logger.error(`[builder-recycle] a freshly recycled builder is already at ${asMib(freshRssBytes ?? 0)}MiB with nothing built on demand, so the ${asMib(ceilingBytes)}MiB ceiling cannot be met for this app; no longer enforcing it this session. Raise AKAN_BUILDER_MAX_RSS_MB, or set it to 0 to leave the builder unbounded.`);
   }
   #armRssRecycle(reason, over) {
@@ -1407,7 +1082,6 @@ ${this.#backendStderrTail.join(`
     }, BUILDER_RSS_RECYCLE_QUIET_MS);
   }
   async#recycleBuilderForRssWhenStillOver(reason, { rssBytes, ceilingBytes }) {
-    const asMib = (bytes) => Math.round(bytes / 1024 / 1024);
     if (decideBuilderRssSettle({ rssBytes, ceilingBytes }) === "recycle-now") {
       this.#recycleBuilderForRss(reason);
       return;
@@ -1433,16 +1107,18 @@ ${this.#backendStderrTail.join(`
     this.#recycleBuilderForRss(settledBytes === null ? reason : `${reason}; still ${asMib(settledBytes)}MiB after settling`);
   }
   static async readProcessRssBytes(pid) {
+    if (process.platform === "win32")
+      return await AkanAppHost.#readRssKbVia(["tasklist", "/FI", `PID eq ${pid}`, "/FO", "CSV", "/NH"], AkanAppHost.#tasklistRssKb);
     const status = await Bun.file(`/proc/${pid}/status`).text().catch(() => null);
     const vmRssKb = status === null ? null : /VmRSS:\s+(\d+) kB/.exec(status)?.[1];
     if (vmRssKb)
       return Number(vmRssKb) * 1024;
-    return await AkanAppHost.#readRssViaPs(pid);
+    return await AkanAppHost.#readRssKbVia(["ps", "-o", "rss=", "-p", String(pid)], (output) => Number(output.trim()));
   }
-  static async#readRssViaPs(pid, timeoutMs = PS_RSS_TIMEOUT_MS) {
+  static async#readRssKbVia(command, parseKb, timeoutMs = PS_RSS_TIMEOUT_MS) {
     let proc;
     try {
-      proc = Bun.spawn(["ps", "-o", "rss=", "-p", String(pid)], { stdio: ["ignore", "pipe", "ignore"] });
+      proc = Bun.spawn(command, { stdio: ["ignore", "pipe", "ignore"] });
     } catch {
       return null;
     }
@@ -1450,7 +1126,7 @@ ${this.#backendStderrTail.join(`
     try {
       const output = await new Response(proc.stdout).text();
       await proc.exited;
-      const rssKb = Number(output.trim());
+      const rssKb = parseKb(output);
       return Number.isFinite(rssKb) && rssKb > 0 ? rssKb * 1024 : null;
     } catch {
       return null;
@@ -1458,6 +1134,10 @@ ${this.#backendStderrTail.join(`
       clearTimeout(killer);
     }
   }
+  static #tasklistRssKb(output) {
+    const memUsage = /"([^"]*)"\s*$/m.exec(output)?.[1];
+    return memUsage ? Number(memUsage.replace(/\D/g, "")) : Number.NaN;
+  }
   #cancelRssRecycle() {
     this.#rssRecycleReason = null;
     this.#rssRecycleOver = null;
@@ -1593,7 +1273,7 @@ ${this.#backendStderrTail.join(`
       await this.#backendGraph.refresh();
     await this.#startBuilder({ announceBootState: true });
     const missed = await this.#takeBuilderGapChanges();
-    const backendFiles = [...new Set([...files.filter((file) => this.#isBackendFile(file)), ...missed])];
+    const backendFiles = [...new Set([...files.filter((file) => this.#backendGraph.has(file)), ...missed])];
     if (backendFiles.length === 0)
       return;
     this.logger.verbose(`[idle-suspend] ${backendFiles.length} backend file(s) changed while suspended`);
@@ -1648,10 +1328,6 @@ ${this.#backendStderrTail.join(`
     for (const message of pending)
       this.#sendToBuilder(message);
   }
-  #holdUntilBuilderReady(message) {
-    this.#pendingBuilderMessages.push(message);
-    this.logger.verbose(`[builder] holding ${message.type} until the builder is ready (${this.#pendingBuilderMessages.length} waiting)`);
-  }
   #discardPendingBuilderMessages(reason) {
     const held = this.#pendingBuilderMessages.splice(0);
     if (held.length === 0)
@@ -1663,12 +1339,17 @@ ${this.#backendStderrTail.join(`
     if (held.length === 0)
       return;
     this.logger.warn(`failing ${held.length} held builder request(s): ${reason}`);
-    for (const message of held) {
-      if (message.type === "build-route")
-        this.#sendToBackend({ type: "build-route-res", id: message.id, ok: false, error: reason });
-      else if (message.type === "build-csr")
-        this.#sendToBackend({ type: "build-csr-res", id: message.id, ok: false, error: reason });
-    }
+    for (const message of held)
+      this.#failBuilderRequest(message, reason);
+  }
+  #failBuilderRequest(message, error) {
+    if (message.type === "build-route")
+      this.#sendToBackend({ type: "build-route-res", id: message.id, ok: false, error });
+    else if (message.type === "build-csr")
+      this.#sendToBackend({ type: "build-csr-res", id: message.id, ok: false, error });
+    else
+      return false;
+    return true;
   }
   #recycleBuilderForRss(reason) {
     if (this.#pendingRecycle || this.#restartTimer) {
@@ -1789,18 +1470,7 @@ ${this.#backendStderrTail.join(`
   }
   async#recycleDevChildren(message, { refreshConfig = false } = {}) {
     const generation = message.devPlan?.generation ?? message.generation;
-    if (this.#restartTimer) {
-      clearTimeout(this.#restartTimer);
-      this.#restartTimer = null;
-    }
-    if (this.#backendRecoveryTimer) {
-      clearTimeout(this.#backendRecoveryTimer);
-      this.#backendRecoveryTimer = null;
-    }
-    if (this.#builderRecoveryTimer) {
-      clearTimeout(this.#builderRecoveryTimer);
-      this.#builderRecoveryTimer = null;
-    }
+    this.#clearRestartTimers();
     this.#builderRecoveryAttempts = 0;
     this.#pendingRestartReason = null;
     this.#lastGoodFrontend = {};
@@ -1890,7 +1560,7 @@ ${this.#backendStderrTail.join(`
     }
     if (message.kinds.includes("code"))
       await this.#backendGraph.refresh();
-    if (message.files.some((file) => this.#isBackendFile(file)))
+    if (message.files.some((file) => this.#backendGraph.has(file)))
       return true;
     if (!this.#backendGraph.lastRefreshSucceeded) {
       const fallbackFiles = message.files.filter((file) => isLegacyBackendFallbackFile(file, this.app.workspace.workspaceRoot));
@@ -1901,9 +1571,6 @@ ${this.#backendStderrTail.join(`
     }
     return false;
   }
-  #isBackendFile(file) {
-    return this.#backendGraph.has(file);
-  }
   async#startBuilder({
     announceBootState = false
   } = {}) {
@@ -1989,27 +1656,12 @@ ${this.#backendStderrTail.join(`
       return;
     const status = this.#builder?.status ?? "stopped";
     if (shouldHoldForReturningBuilder({ status, heldCount: this.#pendingBuilderMessages.length })) {
-      this.#holdUntilBuilderReady(message);
-      return;
-    }
-    if (message.type === "build-route") {
-      this.#sendToBackend({
-        type: "build-route-res",
-        id: message.id,
-        ok: false,
-        error: `builder is ${status}; reload after the builder is ready`
-      });
+      this.#pendingBuilderMessages.push(message);
+      this.logger.verbose(`[builder] holding ${message.type} until the builder is ready (${this.#pendingBuilderMessages.length} waiting)`);
       return;
     }
-    if (message.type === "build-csr") {
-      this.#sendToBackend({
-        type: "build-csr-res",
-        id: message.id,
-        ok: false,
-        error: `builder is ${status}; reload after the builder is ready`
-      });
+    if (this.#failBuilderRequest(message, `builder is ${status}; reload after the builder is ready`))
       return;
-    }
     this.logger.warn("akanAppHost builder is not running");
   }
   #stopBuilder() {
@@ -2021,25 +1673,20 @@ ${this.#backendStderrTail.join(`
   }
 }
 // pkgs/@akanjs/devkit/applicationTestPreload.ts
-import path4 from "path";
+import path3 from "path";
 var SIGNAL_TEST_PRELOAD_PATH = "test/signalTest.preload.ts";
 async function resolveSignalTestPreloadPath(target) {
   const candidates = [];
-  const addResolvedPackageCandidate = (basePath) => {
+  for (const basePath of [target.cwdPath, process.cwd(), path3.dirname(Bun.main), import.meta.dir]) {
     try {
-      candidates.push(path4.join(path4.dirname(Bun.resolveSync("akanjs/package.json", basePath)), SIGNAL_TEST_PRELOAD_PATH));
+      candidates.push(path3.join(path3.dirname(Bun.resolveSync("akanjs/package.json", basePath)), SIGNAL_TEST_PRELOAD_PATH));
     } catch {}
-  };
-  addResolvedPackageCandidate(target.cwdPath);
-  addResolvedPackageCandidate(process.cwd());
-  addResolvedPackageCandidate(path4.dirname(Bun.main));
-  addResolvedPackageCandidate(import.meta.dir);
-  candidates.push(path4.join(target.cwdPath, "../../node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH), path4.join(target.cwdPath, "../../pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH), path4.join(process.cwd(), "node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH), path4.join(process.cwd(), "pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH), path4.join(path4.dirname(Bun.main), "../../akanjs", SIGNAL_TEST_PRELOAD_PATH), path4.resolve(import.meta.dir, "../../akanjs", SIGNAL_TEST_PRELOAD_PATH));
+  }
+  candidates.push(path3.join(target.cwdPath, "../../node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH), path3.join(target.cwdPath, "../../pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH), path3.join(process.cwd(), "node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH), path3.join(process.cwd(), "pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH), path3.join(path3.dirname(Bun.main), "../../akanjs", SIGNAL_TEST_PRELOAD_PATH), path3.resolve(import.meta.dir, "../../akanjs", SIGNAL_TEST_PRELOAD_PATH));
   const uniqueCandidates = [...new Set(candidates)];
-  for (const candidate of uniqueCandidates) {
+  for (const candidate of uniqueCandidates)
     if (await Bun.file(candidate).exists())
       return candidate;
-  }
   throw new Error(`Failed to locate ${SIGNAL_TEST_PRELOAD_PATH} from ${target.cwdPath}.
 Probed paths:
 ${uniqueCandidates.map((candidate) => `  - ${candidate}`).join(`
@@ -2047,12 +1694,10 @@ ${uniqueCandidates.map((candidate) => `  - ${candidate}`).join(`
 }
 
 // pkgs/@akanjs/cli/application/application.runner.ts
-import { Logger as Logger4 } from "akanjs/common";
-import ora from "ora";
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-kxwbssgn.js")).ApplicationBuildRunner;
-var loadReleasePackager = async () => (await import("./applicationReleasePackager-4yasxwv9.js")).ApplicationReleasePackager;
-var loadCapacitorApp = async () => (await import("./capacitorApp-36rbr858.js")).CapacitorApp;
-var loadAbstractCompactor = async () => (await import("./abstractCompactor-mjh5ppsq.js")).AbstractCompactor;
+import { Logger as Logger3 } from "akanjs/common";
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-ybyp97pv.js")).ApplicationBuildRunner;
+var loadReleasePackager = async () => (await import("./applicationReleasePackager-esnrphw8.js")).ApplicationReleasePackager;
+var loadCapacitorApp = async () => (await import("./capacitorApp-1synz4en.js")).CapacitorApp;
 var loadPrompts = async () => await import("@inquirer/prompts");
 
 class ApplicationRunner extends runner("application") {
@@ -2071,9 +1716,6 @@ class ApplicationRunner extends runner("application") {
   async removeApplication(app) {
     await app.workspace.removeDir(`apps/${app.name}`);
   }
-  async getConfig(app) {
-    return await app.getConfig();
-  }
   async getScriptFilename(app) {
     if (!await app.exists("script")) {
       await app.mkdir("script");
@@ -2095,12 +1737,12 @@ class ApplicationRunner extends runner("application") {
     if (!await app.exists(scriptPath))
       throw new Error(`Script file not found: apps/${app.name}/${scriptPath}`);
     await app.spawn("bun", [scriptPath], {
-      env: app.getCommandEnv({ AKAN_COMMAND_TYPE: "script" }),
+      env: app.getCommandEnv({ AKAN_COMMAND_TYPE: "script", ...await app.getDatabaseModeEnv() }),
       stdio: "inherit"
     });
   }
   #runtimeDirOf(app, override) {
-    return path5.resolve(override ?? process.env.AKAN_RUNTIME_DIR ?? path5.join(app.workspace.workspaceRoot, "local", "apps", app.name, "runtime"));
+    return path4.resolve(override ?? process.env.AKAN_RUNTIME_DIR ?? path4.join(app.workspace.workspaceRoot, "local", "apps", app.name, "runtime"));
   }
   async runLogs(app, options) {
     const { LogControlUnavailableError, LogTailClient } = await import("akanjs/server/logging/logTailClient");
@@ -2110,13 +1752,10 @@ class ApplicationRunner extends runner("application") {
     const { level, grep, endpoint, trace, child, role, origin, since } = options;
     const query = Object.fromEntries(Object.entries({ level, grep, endpoint, trace, child, role, origin, since }).filter(([, value]) => value !== undefined && value !== null && value !== ""));
     const print = (record) => process.stdout.write(options.json ? `${JSON.stringify(record)}
-` : Logger4.render(record));
+` : Logger3.render(record));
     const note = (text) => process.stderr.write(`[akan logs] ${text}
 `);
-    let finish = null;
-    const closed = new Promise((resolve) => {
-      finish = resolve;
-    });
+    const { promise: closed, resolve: finish } = Promise.withResolvers();
     let client;
     try {
       client = await LogTailClient.connect(socketPath, {
@@ -2125,11 +1764,11 @@ class ApplicationRunner extends runner("application") {
           if (response.type === "dropped")
             note(`${response.count} records dropped (reader too slow)`);
         },
-        onClose: () => finish?.()
+        onClose: () => finish()
       });
     } catch (error) {
       if (error instanceof LogControlUnavailableError)
-        throw new Error(`${app.name} is not running (no ${path5.basename(socketPath)} in ${runtimeDir}). Start it with \`akan start ${app.name}\`, or pass --runtime-dir for a built app.`);
+        throw new Error(`${app.name} is not running (no ${path4.basename(socketPath)} in ${runtimeDir}). Start it with \`akan start ${app.name}\`, or pass --runtime-dir for a built app.`);
       throw error;
     }
     const sinceMs = since ? LogQueryMatcher.parseSince(since) : undefined;
@@ -2167,7 +1806,7 @@ const serverModule = await import(${JSON.stringify(serverPath)});
 const { assertAkanConsoleAllowed, startAkanConsole } = await import("akanjs/server");
 const server = serverModule.server;
 if (!server?.start) throw new Error("server.ts must export server with start()");
-assertAkanConsoleAllowed(server.env);
+assertAkanConsoleAllowed();
 await server.start({ listen: false, web: false });
 try {
   await startAkanConsole(server, {
@@ -2186,17 +1825,35 @@ try {
 }
 `;
     await app.spawn("bun", ["-e", code], {
-      env: app.getCommandEnv({ AKAN_COMMAND_TYPE: "console" }),
+      env: app.getCommandEnv({ AKAN_COMMAND_TYPE: "console", ...await app.getDatabaseModeEnv() }),
+      stdio: "inherit"
+    });
+  }
+  async transferDatabase(app, direction, dir) {
+    const serverPath = `${app.cwdPath}/server.ts`;
+    if (!await app.exists("server.ts"))
+      throw new Error(`Server file not found: apps/${app.name}/server.ts`);
+    const target = path4.resolve(app.workspace.workspaceRoot, dir);
+    const code = `
+const { server } = await import(${JSON.stringify(serverPath)});
+const { DatabaseAdaptorRole, DocumentTransfer } = await import("akanjs/service");
+await server.start({ listen: false, web: false });
+try {
+  const transfer = new DocumentTransfer(server.get(DatabaseAdaptorRole));
+  const reports = await transfer.${direction === "export" ? "exportTo" : "importFrom"}(${JSON.stringify(target)});
+  for (const { table, rows } of reports) console.info(\`${direction === "export" ? "exported" : "imported"} \${table}: \${rows} rows\`);
+} finally {
+  await server.stop();
+}
+`;
+    await app.spawn("bun", ["-e", code], {
+      env: app.getCommandEnv({ AKAN_COMMAND_TYPE: "script", ...await app.getDatabaseModeEnv() }),
       stdio: "inherit"
     });
   }
   async typecheck(app, options = {}) {
     await new (await loadBuildRunner())(app).typecheck(options);
   }
-  async compact(sys, { module, minLines, interactive } = {}) {
-    const compactor = new (await loadAbstractCompactor())(sys, { minLines, interactive });
-    return await compactor.compactAll({ module });
-  }
   async test(exec) {
     const isSignalTarget = exec instanceof AppExecutor || exec instanceof LibExecutor;
     const preloadPath = isSignalTarget ? await resolveSignalTestPreloadPath(exec) : null;
@@ -2272,13 +1929,7 @@ try {
       await new (await loadCapacitorApp())(app, mobileTarget.config).buildAndroid("apk", { env, regenerate });
     });
   }
-  async startAndroid(app, {
-    open = false,
-    operation = "local",
-    env = "local",
-    target,
-    regenerate = false
-  } = {}) {
+  async startAndroid(app, { open = false, operation = "local", env = "local", target, regenerate = false } = {}) {
     const targets = await resolveMobileTargets(app, target);
     if (operation === "release")
       await this.#buildMobileCsr(app, env);
@@ -2335,24 +1986,34 @@ try {
       return;
     for (const failure of failures) {
       const message = failure.error instanceof Error ? failure.error.message : String(failure.error);
-      Logger4.rawLog(`Mobile target ${failure.target} failed: ${message}`, undefined, "error");
+      Logger3.rawLog(`Mobile target ${failure.target} failed: ${message}`, undefined, "error");
     }
     throw new Error(`${failures.length}/${results.length} mobile targets failed`);
   }
-  async codepush(app, os) {
+  async codepush(app) {
+    throw new Error(`akan codepush is still in development and deploys nothing yet, so ${app.name} was not updated. To release the app's source with OTA update support, run \`akan release-source ${app.name}\`.`);
+  }
+  async#initCapacitorApp(app) {
     const [target] = await resolveMobileTargets(app, undefined);
     if (!target)
       throw new Error(`No mobile target configured for ${app.name}`);
     const capacitorApp = new (await loadCapacitorApp())(app, target.config);
     await capacitorApp.init();
+    return capacitorApp;
   }
   #getLocalDatabaseServices(mode) {
     if (mode === "single")
       return [];
     if (mode === "multiple")
-      return ["redis", "libsql"];
+      return ["redis"];
     return ["redis", "postgres"];
   }
+  async#assertComposeHas(workspace, services) {
+    const compose = Bun.YAML.parse(await Bun.file(`${workspace.workspaceRoot}/local/docker-compose.yaml`).text());
+    const missing = services.filter((service) => !compose?.services?.[service]);
+    if (missing.length)
+      throw new Error(`local/docker-compose.yaml declares no ${missing.join(" or ")} service. Add it, or move the file aside so the next akan dbup writes the current template.`);
+  }
   async#isLocalDatabaseUp(workspace, mode) {
     const requiredServices = this.#getLocalDatabaseServices(mode);
     if (!requiredServices.length)
@@ -2366,16 +2027,18 @@ try {
   async dbup(workspace, mode = "multiple") {
     if (mode === "single")
       return true;
+    const services = this.#getLocalDatabaseServices(mode);
+    await workspace.applyTemplate({
+      basePath: "local",
+      template: "localDev",
+      dict: { repoName: workspace.repoName },
+      overwrite: false
+    });
+    await this.#assertComposeHas(workspace, services);
     try {
-      await workspace.applyTemplate({
-        basePath: "local",
-        template: "localDev",
-        dict: { repoName: workspace.repoName },
-        overwrite: false
-      });
       const wasAlreadyUp = await this.#isLocalDatabaseUp(workspace, mode);
       if (!wasAlreadyUp)
-        await workspace.spawn(`docker`, ["compose", "up", "-d", ...this.#getLocalDatabaseServices(mode)], {
+        await workspace.spawn(`docker`, ["compose", "up", "-d", ...services], {
           cwd: `${workspace.workspaceRoot}/local`
         });
       return wasAlreadyUp;
@@ -2394,11 +2057,7 @@ ${detail}`
     await workspace.spawn(`docker`, ["compose", "down"], { cwd: `${workspace.workspaceRoot}/local` });
   }
   async configureApp(app) {
-    const [target] = await resolveMobileTargets(app, undefined);
-    if (!target)
-      throw new Error(`No mobile target configured for ${app.name}`);
-    const capacitorApp = new (await loadCapacitorApp())(app, target.config);
-    await capacitorApp.init();
+    const capacitorApp = await this.#initCapacitorApp(app);
     if (await (await loadPrompts()).confirm({ message: "want to add camera permission?" }))
       await capacitorApp.addCamera();
     if (await (await loadPrompts()).confirm({ message: "want to add contact permission?" }))
@@ -2408,59 +2067,187 @@ ${detail}`
     await capacitorApp.save();
   }
   async releaseSource(app, { rebuild, buildNum = 0, environment = "debug", local = true } = {}) {
-    await new (await loadReleasePackager())(app, { build: () => this.build(app).then(() => {
+    const packager = new (await loadReleasePackager())(app, { build: () => this.build(app).then(() => {
       return;
-    }) }).releaseSource({
-      rebuild,
-      buildNum,
-      environment,
-      local
-    });
-    return;
+    }) });
+    await packager.releaseSource({ rebuild, buildNum, environment, local });
   }
-  async createApplicationTemplate(workspace, appName) {
-    await workspace.applyTemplate({ basePath: `apps/${appName}`, template: "appRoot", dict: { appName } });
+}
+
+// pkgs/@akanjs/cli/application/hostProcessProbe.ts
+import { readdirSync, readFileSync, readlinkSync } from "fs";
+
+class HostProcessProbe {
+  static timeoutMs = 3000;
+  static win32TimeoutMs = 20000;
+  static #procTcpListen = "0A";
+  static #win32ProcessQuery = "[Console]::OutputEncoding=[Text.Encoding]::UTF8; Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId,CommandLine,CreationDate | ConvertTo-Json -Compress";
+  platform;
+  #win32Table = null;
+  constructor(platform = process.platform) {
+    this.platform = platform;
+  }
+  async listenersOn(port) {
+    if (this.platform === "win32")
+      return HostProcessProbe.parseNetstat(await HostProcessProbe.run(["netstat", "-ano"]), port);
+    if (this.platform === "linux")
+      return HostProcessProbe.#procListenersOn(port);
+    const output = await HostProcessProbe.run(["lsof", "-ti", `tcp:${port}`, "-sTCP:LISTEN"]);
+    return [
+      ...new Set(output.split(`
+`).map((line) => Number(line.trim())).filter((pid) => Number.isInteger(pid) && pid > 0))
+    ];
   }
-  async compressProjectFiles(app, { rebuild, buildNum = 0, environment = "debug", local = true } = {}) {
-    await new (await loadReleasePackager())(app, {
-      build: () => this.build(app).then(() => {
-        return;
-      })
-    }).compressProjectFiles({
-      rebuild,
-      buildNum,
-      environment,
-      local
-    });
-    return;
+  async parentOf(pid) {
+    if (this.platform === "win32") {
+      const child = await this.#win32Process(pid);
+      const parent = child ? await this.#win32Process(child.ppid) : null;
+      return child && parent ? HostProcessProbe.parentPidOf(child, parent) : null;
+    }
+    if (this.platform === "linux") {
+      const stat = HostProcessProbe.#readProc(pid, "stat");
+      return stat === null ? null : HostProcessProbe.parseProcStatPpid(stat);
+    }
+    const parsed = Number((await HostProcessProbe.run(["ps", "-p", String(pid), "-o", "ppid="])).trim());
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : null;
   }
-  async generateApplicationTemplate(app) {
-    const openAIApiKey = process.env.OPENAI_API_KEY;
-    if (!openAIApiKey)
-      throw new Error("OPENAI_API_KEY is not set");
-    const [{ StringOutputParser }, { PromptTemplate }, { RunnableSequence }, { ChatOpenAI }, prompts] = await Promise.all([
-      import("@langchain/core/output_parsers"),
-      import("@langchain/core/prompts"),
-      import("@langchain/core/runnables"),
-      import("@langchain/openai"),
-      loadPrompts()
-    ]);
-    const chatModel = new ChatOpenAI({ modelName: "gpt-4o", openAIApiKey });
-    const projectName = await prompts.input({ message: "please enter project name." });
-    const projectDesc = await prompts.input({
-      message: "please enter project description. (40 ~ 60 characters)"
-    });
-    const spinner = ora("Gerating project files...");
-    const mainPrompt = PromptTemplate.fromTemplate(`prompt.requestApplication()`);
-    const chain = RunnableSequence.from([mainPrompt, chatModel, new StringOutputParser]);
-    await chain.invoke({ projectName, projectDesc });
-    spinner.succeed("Loading complete!");
+  async commandOf(pid) {
+    if (this.platform === "win32")
+      return (await this.#win32Process(pid))?.command ?? null;
+    if (this.platform === "linux") {
+      const cmdline = HostProcessProbe.#readProc(pid, "cmdline");
+      return cmdline?.split("\x00").filter(Boolean).join(" ") || null;
+    }
+    return (await HostProcessProbe.run(["ps", "-ww", "-p", String(pid), "-o", "command="])).trim() || null;
+  }
+  static parentPidOf(child, parent) {
+    if (child.ppid !== parent.pid)
+      return null;
+    if (parent.startedAt !== null && child.startedAt !== null && parent.startedAt > child.startedAt)
+      return null;
+    return parent.pid;
+  }
+  static parseNetstat(output, port) {
+    const pids = new Set;
+    for (const line of output.split(/\r?\n/)) {
+      const fields = line.trim().split(/\s+/);
+      if (fields[0] !== "TCP" || fields.length < 5)
+        continue;
+      const [, local, remote] = fields;
+      if (!local?.endsWith(`:${port}`) || !remote?.endsWith(":0"))
+        continue;
+      const pid = Number(fields.at(-1));
+      if (Number.isInteger(pid) && pid > 0)
+        pids.add(pid);
+    }
+    return [...pids];
+  }
+  static parseProcNetTcp(text, port) {
+    const inodes = [];
+    for (const line of text.split(`
+`).slice(1)) {
+      const fields = line.trim().split(/\s+/);
+      const [, local, , state, , , , , , inode] = fields;
+      if (!local || !inode || state !== HostProcessProbe.#procTcpListen || inode === "0")
+        continue;
+      if (Number.parseInt(local.slice(local.lastIndexOf(":") + 1), 16) === port)
+        inodes.push(inode);
+    }
+    return inodes;
+  }
+  static parseProcStatPpid(stat) {
+    const ppid = Number(stat.slice(stat.lastIndexOf(")") + 2).split(" ")[1]);
+    return Number.isInteger(ppid) && ppid > 0 ? ppid : null;
+  }
+  static parseWin32Processes(json) {
+    const table = new Map;
+    let parsed;
+    try {
+      parsed = JSON.parse(json.trim() || "[]");
+    } catch {
+      return table;
+    }
+    const rows = Array.isArray(parsed) ? parsed : [parsed];
+    for (const row of rows) {
+      if (typeof row?.ProcessId !== "number")
+        continue;
+      table.set(row.ProcessId, {
+        pid: row.ProcessId,
+        ppid: row.ParentProcessId ?? 0,
+        command: row.CommandLine?.trim() || null,
+        startedAt: HostProcessProbe.#parseCimDate(row.CreationDate)
+      });
+    }
+    return table;
+  }
+  static async run(command, timeoutMs = HostProcessProbe.timeoutMs) {
+    let proc;
+    try {
+      proc = Bun.spawn(command, { stdio: ["ignore", "pipe", "ignore"], windowsHide: true });
+    } catch {
+      return "";
+    }
+    const timer = setTimeout(() => proc.kill("SIGKILL"), timeoutMs);
+    try {
+      return await new Response(proc.stdout).text();
+    } catch {
+      return "";
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async#win32Process(pid) {
+    this.#win32Table ??= await HostProcessProbe.#queryWin32Processes();
+    if (!this.#win32Table.has(pid))
+      this.#win32Table = await HostProcessProbe.#queryWin32Processes();
+    return this.#win32Table.get(pid) ?? null;
+  }
+  static async#queryWin32Processes() {
+    const output = await HostProcessProbe.run(["powershell", "-NoProfile", "-NonInteractive", "-Command", HostProcessProbe.#win32ProcessQuery], HostProcessProbe.win32TimeoutMs);
+    return HostProcessProbe.parseWin32Processes(output);
+  }
+  static #parseCimDate(value) {
+    if (!value)
+      return null;
+    const legacy = /\/Date\((\d+)/.exec(value)?.[1];
+    const ms = legacy ? Number(legacy) : Date.parse(value);
+    return Number.isFinite(ms) ? ms : null;
+  }
+  static #procListenersOn(port) {
+    const inodes = new Set(["tcp", "tcp6"].flatMap((table) => HostProcessProbe.parseProcNetTcp(HostProcessProbe.#readProc("net", table) ?? "", port)));
+    if (!inodes.size)
+      return [];
+    const pids = [];
+    for (const entry of HostProcessProbe.#listDir("/proc")) {
+      if (!/^\d+$/.test(entry))
+        continue;
+      const holds = HostProcessProbe.#listDir(`/proc/${entry}/fd`).some((fd) => {
+        const link = HostProcessProbe.#orElse(() => readlinkSync(`/proc/${entry}/fd/${fd}`), "");
+        const inode = /^socket:\[(\d+)\]$/.exec(link)?.[1];
+        return !!inode && inodes.has(inode);
+      });
+      if (holds)
+        pids.push(Number(entry));
+    }
+    return pids;
+  }
+  static #readProc(pid, file) {
+    return HostProcessProbe.#orElse(() => readFileSync(`/proc/${pid}/${file}`, "utf8"), null);
+  }
+  static #listDir(dir) {
+    return HostProcessProbe.#orElse(() => readdirSync(dir), []);
+  }
+  static #orElse(read, fallback) {
+    try {
+      return read();
+    } catch {
+      return fallback;
+    }
   }
 }
 
 // pkgs/@akanjs/cli/application/devPortReclaimer.ts
 class DevPortReclaimer {
-  static lsofTimeoutMs = 3000;
   static releaseTimeoutMs = 8000;
   static maxAncestorDepth = 8;
   static #releasePollMs = 100;
@@ -2469,7 +2256,12 @@ class DevPortReclaimer {
     return [...new Set(ports.flatMap((port) => [port, port + DevPortReclaimer.wsPortOffset]))].sort((left, right) => left - right);
   }
   static isAkanCommand(command) {
-    return /(^|\/)akan(\s|$)/.test(command) || command.includes("@akanjs/cli") || command.includes("akanjs/server") || /\bapps\/[^/\s]+\/main\.ts\b/.test(command) || command.includes("incrementalBuilder.proc") || command.includes("rscWorker");
+    const normalized = command.replaceAll("\\", "/");
+    return /(^|\/)akan(\.exe)?"?(\s|$)/.test(normalized) || normalized.includes("@akanjs/cli") || normalized.includes("akanjs/server") || /\bapps\/[^/\s]+\/main\.ts\b/.test(normalized) || normalized.includes("incrementalBuilder.proc") || normalized.includes("rscWorker");
+  }
+  #probe;
+  constructor(probe = new HostProcessProbe) {
+    this.#probe = probe;
   }
   async reclaim(ports) {
     const killed = [];
@@ -2494,10 +2286,10 @@ class DevPortReclaimer {
   }
   async holdersOf(port) {
     const holders = [];
-    for (const listenerPid of await this.#pidsOn(port)) {
+    for (const listenerPid of await this.#probe.listenersOn(port)) {
       if (listenerPid === process.pid || listenerPid === process.ppid)
         continue;
-      const command = await this.#commandOf(listenerPid);
+      const command = await this.#probe.commandOf(listenerPid);
       if (!command)
         continue;
       if (!DevPortReclaimer.isAkanCommand(command)) {
@@ -2512,44 +2304,37 @@ class DevPortReclaimer {
   async#akanRootOf(pid, command) {
     let root = { pid, command };
     for (let depth = 0;depth < DevPortReclaimer.maxAncestorDepth; depth += 1) {
-      const parentPid = await this.#ppidOf(root.pid);
+      const parentPid = await this.#probe.parentOf(root.pid);
       if (parentPid === null || parentPid <= 1 || parentPid === process.pid || parentPid === process.ppid)
         break;
-      const parentCommand = await this.#commandOf(parentPid);
+      const parentCommand = await this.#probe.commandOf(parentPid);
       if (!parentCommand || !DevPortReclaimer.isAkanCommand(parentCommand))
         break;
       root = { pid: parentPid, command: parentCommand };
     }
     return root;
   }
-  async#ppidOf(pid) {
-    const output = await this.#run(["ps", "-p", String(pid), "-o", "ppid="]);
-    const parsed = Number(output.trim());
-    return Number.isInteger(parsed) && parsed > 0 ? parsed : null;
-  }
-  async#pidsOn(port) {
-    const output = await this.#run(["lsof", "-ti", `tcp:${port}`, "-sTCP:LISTEN"]);
-    return [
-      ...new Set(output.split(`
-`).map((line) => Number(line.trim())).filter((pid) => Number.isInteger(pid) && pid > 0))
-    ];
-  }
-  async#commandOf(pid) {
-    const output = await this.#run(["ps", "-p", String(pid), "-o", "command="]);
-    return output.trim() || null;
-  }
   async#terminate(pid) {
+    if (this.#probe.platform === "win32") {
+      await HostProcessProbe.run(["taskkill", "/PID", String(pid), "/T", "/F"]);
+      return await this.#released(pid);
+    }
     if (!this.#signal(pid, "SIGTERM"))
       return !this.#alive(pid);
+    if (await this.#released(pid))
+      return true;
+    this.#signal(pid, "SIGKILL");
+    await Bun.sleep(DevPortReclaimer.#releasePollMs);
+    return !this.#alive(pid);
+  }
+  async#released(pid) {
     const deadline = Date.now() + DevPortReclaimer.releaseTimeoutMs;
     while (Date.now() < deadline) {
       if (!this.#alive(pid))
         return true;
       await Bun.sleep(DevPortReclaimer.#releasePollMs);
     }
-    this.#signal(pid, "SIGKILL");
-    await Bun.sleep(DevPortReclaimer.#releasePollMs);
-    return !this.#alive(pid);
+    return false;
   }
   #signal(pid, signal) {
     try {
@@ -2567,26 +2352,15 @@ class DevPortReclaimer {
       return error.code === "EPERM";
     }
   }
-  async#run(command) {
-    const proc = Bun.spawn(command, { stdio: ["ignore", "pipe", "ignore"] });
-    const timer = setTimeout(() => proc.kill("SIGKILL"), DevPortReclaimer.lsofTimeoutMs);
-    try {
-      return await new Response(proc.stdout).text();
-    } catch {
-      return "";
-    } finally {
-      clearTimeout(timer);
-    }
-  }
 }
 
 // pkgs/@akanjs/cli/application/devStreamView.ts
-import { Logger as Logger5 } from "akanjs/common";
+import { Logger as Logger4 } from "akanjs/common";
 import chalk from "chalk";
 var appColors = ["cyan", "magenta", "yellow", "green", "blue", "red"];
 
 class DevStreamView {
-  #logger = new Logger5("akan start");
+  #logger = new Logger4("akan start");
   #partial = new Map;
   #lastState = new Map;
   #color = new Map;
@@ -2690,8 +2464,9 @@ class DevBootConcurrency {
 
 // pkgs/@akanjs/cli/application/devSessionLog.ts
 import { mkdir, rename } from "fs/promises";
-import path6 from "path";
+import path5 from "path";
 import dayjs from "dayjs";
+
 class DevSessionLog {
   static fileName = "dev.log";
   static previousFileName = "dev.prev.log";
@@ -2713,19 +2488,19 @@ class DevSessionLog {
     return [...this.#appNames];
   }
   pathOf(app) {
-    return path6.join(this.#runtimeDirOf(app), DevSessionLog.fileName);
+    return path5.join(this.#runtimeDirOf(app), DevSessionLog.fileName);
   }
   previousPathOf(app) {
-    return path6.join(this.#runtimeDirOf(app), DevSessionLog.previousFileName);
+    return path5.join(this.#runtimeDirOf(app), DevSessionLog.previousFileName);
   }
   relativePathOf(app) {
-    return path6.relative(this.#workspaceRoot, this.pathOf(app));
+    return path5.relative(this.#workspaceRoot, this.pathOf(app));
   }
   async open() {
     const stamp = dayjs(this.#now()).format("YYYY-MM-DD HH:mm:ss");
     for (const app of this.#appNames) {
       const file = this.pathOf(app);
-      await mkdir(path6.dirname(file), { recursive: true });
+      await mkdir(path5.dirname(file), { recursive: true });
       await rename(file, this.previousPathOf(app)).catch(() => {
         return;
       });
@@ -2769,7 +2544,7 @@ class DevSessionLog {
     this.#writers.clear();
   }
   #runtimeDirOf(app) {
-    return path6.join(this.#workspaceRoot, "local", "apps", app, "runtime");
+    return path5.join(this.#workspaceRoot, "local", "apps", app, "runtime");
   }
   #writeLine(app, text) {
     const writer = this.#writers.get(app);
@@ -2792,6 +2567,16 @@ class DevSessionLog {
 
 // pkgs/@akanjs/cli/application/devSupervisor.ts
 class DevSupervisor {
+  static resolveDevUi(plain, {
+    isTty = !!process.stdout.isTTY,
+    columns = process.stdout.columns ?? 0
+  } = {}) {
+    if (plain)
+      return { mode: "stream", downgraded: false };
+    if (!isTty || columns <= 0)
+      return { mode: "stream", downgraded: true };
+    return { mode: "tui", downgraded: false };
+  }
   static supervisedEnvKey = "AKAN_DEV_SUPERVISED";
   static childHooks() {
     if (process.env[DevSupervisor.supervisedEnvKey] !== "1" || !process.send)
@@ -2855,16 +2640,14 @@ class DevSupervisor {
     return ports;
   }
   #makeChild(app, port) {
-    let markReady;
-    const ready = new Promise((resolve) => {
-      markReady = resolve;
-    });
+    const { promise: ready, resolve: markReady } = Promise.withResolvers();
     return {
       status: {
         app,
         name: app.name,
         port,
         url: `http://localhost:${port}`,
+        shareUrl: this.#options.shares?.get(app.name) ?? null,
         state: "starting",
         detail: "queued",
         exitCode: null
@@ -2894,16 +2677,18 @@ class DevSupervisor {
     }
   }
   async#waitForReady(child) {
-    let timer = null;
+    if (await DevSupervisor.timesOut(child.ready, DevSupervisor.readyTimeoutMs))
+      this.#note(`${child.status.name} has not reported ready after ${Math.round(DevSupervisor.readyTimeoutMs / 1000)}s; starting the next app anyway`, "warn");
+  }
+  static async timesOut(work, ms) {
+    let timer;
     const expired = new Promise((resolve) => {
-      timer = setTimeout(() => resolve("expired"), DevSupervisor.readyTimeoutMs);
+      timer = setTimeout(() => resolve(true), ms);
     });
     try {
-      if (await Promise.race([child.ready.then(() => "ready"), expired]) === "expired")
-        this.#note(`${child.status.name} has not reported ready after ${Math.round(DevSupervisor.readyTimeoutMs / 1000)}s; starting the next app anyway`, "warn");
+      return await Promise.race([work.then(() => false), expired]);
     } finally {
-      if (timer)
-        clearTimeout(timer);
+      clearTimeout(timer);
     }
   }
   static childArgs(name, { write = true } = {}) {
@@ -3025,44 +2810,68 @@ class DevSupervisor {
     for (const child of running)
       child.proc.kill("SIGTERM");
     const exited = Promise.all(running.map(async (child) => await child.proc.exited));
-    let timer = null;
-    const expired = new Promise((resolve) => {
-      timer = setTimeout(() => resolve("expired"), DevSupervisor.shutdownGraceMs);
-    });
-    try {
-      if (await Promise.race([exited.then(() => "exited"), expired]) === "expired") {
-        for (const child of running) {
-          if (!child.proc.killed) {
-            this.#note(`${child.status.name} did not exit in time; killing it`, "warn");
-            child.proc.kill("SIGKILL");
-          }
-        }
-      }
-    } finally {
-      if (timer)
-        clearTimeout(timer);
+    if (!await DevSupervisor.timesOut(exited, DevSupervisor.shutdownGraceMs))
+      return;
+    for (const child of running) {
+      if (child.proc.killed)
+        continue;
+      this.#note(`${child.status.name} did not exit in time; killing it`, "warn");
+      child.proc.kill("SIGKILL");
     }
   }
 }
 
-// pkgs/@akanjs/cli/application/devUiMode.ts
-var resolveDevUi = (plain, { isTty = !!process.stdout.isTTY, columns = process.stdout.columns ?? 0 } = {}) => {
-  if (plain)
-    return { mode: "stream", downgraded: false };
-  if (!isTty || columns <= 0)
-    return { mode: "stream", downgraded: true };
-  return { mode: "tui", downgraded: false };
-};
+// pkgs/@akanjs/cli/application/interruptTeardown.ts
+import { Logger as Logger5 } from "akanjs/common";
+
+class InterruptTeardown {
+  #teardowns = [];
+  #exit;
+  #listen;
+  #report;
+  #interrupted = false;
+  ownsExit = true;
+  constructor({ exit, listen, report } = {}) {
+    this.#exit = exit ?? ((code) => process.exit(code));
+    this.#listen = listen ?? ((onSignal) => {
+      process.on("SIGINT", onSignal);
+    });
+    this.#report = report ?? ((message) => Logger5.rawLog(message, undefined, "error"));
+  }
+  add(run, abandoned) {
+    this.#teardowns.push({ run, abandoned, running: false });
+    if (this.#teardowns.length === 1)
+      this.#listen(() => this.#onSignal());
+  }
+  #onSignal() {
+    if (this.#interrupted) {
+      for (const one of this.#teardowns)
+        if (one.running)
+          this.#report(one.abandoned);
+      this.#exit(130);
+      return;
+    }
+    this.#interrupted = true;
+    Promise.all(this.#teardowns.map(async (one) => {
+      one.running = true;
+      await one.run().catch(() => {
+        return;
+      });
+      one.running = false;
+    })).finally(() => {
+      if (this.ownsExit)
+        this.#exit(0);
+    });
+  }
+}
 
 // pkgs/@akanjs/cli/application/application.script.ts
 class ApplicationScript extends script("application", [ApplicationRunner, LibraryScript]) {
   static dbShutdownTimeoutMs = 20000;
+  #interrupt = new InterruptTeardown;
   async confirmDatabaseModeDependencyInstall(databaseMode, installSpecs) {
     return await confirm({
-      message: [
-        `Database mode '${databaseMode}' requires missing dependencies: ${installSpecs.join(", ")}.`,
-        "Install them now?"
-      ].join(" "),
+      message: `Database mode '${databaseMode}' requires missing dependencies: ${installSpecs.join(", ")}. Install them now?`,
       default: true
     });
   }
@@ -3073,21 +2882,11 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     const shouldInstall = await this.confirmDatabaseModeDependencyInstall(databaseMode, installSpecs);
     if (!shouldInstall)
       throw new Error(`Database mode '${databaseMode}' requires missing dependencies: ${installSpecs.join(", ")}.`);
-    const spinner = app.workspace.spinning(`Installing database dependencies for ${databaseMode} mode...`);
-    try {
-      await app.workspace.spawn("bun", ["add", ...installSpecs], {
-        stdio: "inherit"
-      });
-      await app.workspace.getPackageJson({ refresh: true });
-      spinner.succeed(`Installed database dependencies for ${databaseMode} mode`);
-    } catch (error) {
-      spinner.fail(`Failed to install database dependencies for ${databaseMode} mode`);
-      throw error;
-    }
+    await this.#addDependencies(app, installSpecs, `database dependencies for ${databaseMode} mode`);
   }
   async confirmMobileDependencyInstall(installSpecs) {
     return await confirm({
-      message: [`Mobile builds require missing dependencies: ${installSpecs.join(", ")}.`, "Install them now?"].join(" "),
+      message: `Mobile builds require missing dependencies: ${installSpecs.join(", ")}. Install them now?`,
       default: true
     });
   }
@@ -3098,15 +2897,16 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     const shouldInstall = await this.confirmMobileDependencyInstall(installSpecs);
     if (!shouldInstall)
       throw new Error(`Mobile builds require missing dependencies: ${installSpecs.join(", ")}.`);
-    const spinner = app.workspace.spinning("Installing mobile dependencies...");
+    await this.#addDependencies(app, installSpecs, "mobile dependencies");
+  }
+  async#addDependencies(app, installSpecs, what) {
+    const spinner = app.workspace.spinning(`Installing ${what}...`);
     try {
-      await app.workspace.spawn("bun", ["add", ...installSpecs], {
-        stdio: "inherit"
-      });
+      await app.workspace.spawn("bun", ["add", ...installSpecs], { stdio: "inherit" });
       await app.workspace.getPackageJson({ refresh: true });
-      spinner.succeed("Installed mobile dependencies");
+      spinner.succeed(`Installed ${what}`);
     } catch (error) {
-      spinner.fail("Failed to install mobile dependencies");
+      spinner.fail(`Failed to install ${what}`);
       throw error;
     }
   }
@@ -3156,17 +2956,6 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     else
       await this.libraryScript.syncLibrary(sys);
   }
-  async compact(sys, { module = null, minLines, interactive = false } = {}) {
-    const { scanned, reports } = await this.applicationRunner.compact(sys, { module, minLines, interactive });
-    if (!reports.length) {
-      Logger6.rawLog(`No abstract file long enough to compact in ${sys.name} (${scanned} scanned)`);
-      return;
-    }
-    for (const report of reports)
-      Logger6.rawLog(`${report.status}: ${report.path} (${report.beforeLines} -> ${report.afterLines} lines)`);
-    const compactedNum = reports.filter((report) => report.status === "compacted").length;
-    Logger6.rawLog(`Compacted ${compactedNum}/${reports.length} abstract files in ${sys.name}`);
-  }
   async script(app, filename) {
     const scriptFilename = filename ?? await this.applicationRunner.getScriptFilename(app);
     await app.scanSync();
@@ -3184,10 +2973,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     if (!quiet)
       Logger6.rawLog(`Creating an optimized production build for ${app.name}...`);
     try {
-      const result = await this.applicationRunner.build(app, {
-        fast,
-        spinner: !quiet
-      });
+      const result = await this.applicationRunner.build(app, { fast, spinner: !quiet });
       Logger6.rawLog(`${app.name} built in dist/apps/${app.name}`);
       if (!quiet)
         ApplicationBuildReporter.printSummary(result);
@@ -3212,8 +2998,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
   async test(exec, { write = true } = {}) {
     if (exec instanceof LibExecutor) {
       await this.libraryScript.syncLibrary(exec);
-      const spinner = exec.spinning(`Preparing ${exec.name}...`);
-      spinner.succeed(`${exec.name} prepared`);
+      exec.spinning(`Preparing ${exec.name}...`).succeed(`${exec.name} prepared`);
       await this.applicationRunner.test(exec);
       return;
     }
@@ -3230,23 +3015,33 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     }
     await this.applicationRunner.test(exec);
   }
-  async start(apps, { open = false, dbup = true, write = true, plain = false, kill = false, concurrency = null } = {}) {
+  async start(apps, {
+    open = false,
+    dbup = true,
+    write = true,
+    plain = false,
+    kill = false,
+    share = false,
+    concurrency = null
+  } = {}) {
     const first = apps[0];
     if (!first)
       throw new Error("No app selected to start");
-    const { mode, downgraded } = resolveDevUi(plain);
+    const { mode, downgraded } = DevSupervisor.resolveDevUi(plain);
     if (downgraded)
       first.workspace.log("no sized terminal to draw on; printing prefixed lines instead");
     if (kill)
       await this.reclaimDevPorts(apps);
+    const shares = share ? await this.#shareOnInterrupt(apps) : null;
     if (mode === "stream" && apps.length === 1)
       return await this.startOne(first, { open, dbup, write, ...DevSupervisor.childHooks() });
-    await this.#startMany(apps, { open, dbup, write, mode, concurrency });
+    this.#interrupt.ownsExit = false;
+    await this.#startMany(apps, { open, dbup, write, mode, concurrency, shares });
   }
   async startOne(app, { open = false, dbup = true, stdio = "inherit", write = true, onDevEvent } = {}) {
     await app.scanSync({ write });
     const akanConfig = await app.getConfig();
-    const databaseMode = process.env.AKAN_DATABASE_MODE ?? akanConfig.defaultDatabaseMode ?? "single";
+    const databaseMode = akanConfig.resolveDatabaseMode();
     await this.syncDatabaseModeDependencies(app, akanConfig, databaseMode);
     if (app.getEnv() === "local" && dbup && databaseMode !== "single") {
       const wasDbAlreadyUp = await this.dbup(app.workspace, databaseMode);
@@ -3254,15 +3049,12 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
         this.#stopDatabaseOnInterrupt(app.workspace);
     }
     const spinner = app.spinning("Preparing backend...");
-    const akanAppHost = await this.applicationRunner.start(app, {
+    return await this.applicationRunner.start(app, {
       open,
-      onStart: () => {
-        spinner.succeed(`${app.name} prepared, ready to start`);
-      },
+      onStart: () => spinner.succeed(`${app.name} prepared, ready to start`),
       onDevEvent,
       stdio
     });
-    return akanAppHost;
   }
   async reclaimDevPorts(apps) {
     const workspace = apps[0]?.workspace;
@@ -3277,13 +3069,20 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     if (killed.length === 0 && foreign.length === 0)
       workspace.log("dev ports are free; nothing to kill");
   }
-  async#startMany(apps, { open, dbup, write, mode, concurrency }) {
+  async#startMany(apps, {
+    open,
+    dbup,
+    write,
+    mode,
+    concurrency,
+    shares
+  }) {
     const workspace = apps[0]?.workspace;
     if (!workspace)
       throw new Error("No app selected to start");
     const startedDatabase = dbup ? await this.#prepareSharedDatabase(apps) : false;
-    const supervisor = new DevSupervisor({ apps, mode, concurrency, open, write });
-    const view = mode === "tui" ? await (await import("./devTuiView-c08ccbat.js")).createDevTuiView(supervisor) : new DevStreamView(apps.map((app) => app.name));
+    const supervisor = new DevSupervisor({ apps, mode, concurrency, open, write, shares });
+    const view = mode === "tui" ? new (await import("./devTui-q7k7bakd.js")).DevTui(supervisor) : new DevStreamView(apps.map((app) => app.name));
     await supervisor.run(view);
     if (startedDatabase)
       await this.#stopDatabase(workspace);
@@ -3297,7 +3096,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
       if (app.getEnv() !== "local")
         continue;
       const akanConfig = await app.getConfig();
-      const mode = process.env.AKAN_DATABASE_MODE ?? akanConfig.defaultDatabaseMode ?? "single";
+      const mode = akanConfig.resolveDatabaseMode();
       await this.syncDatabaseModeDependencies(app, akanConfig, mode);
       if (mode !== "single")
         modes.add(mode);
@@ -3358,23 +3157,13 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     const akanConfig = await app.getConfig();
     await this.syncMobileDependencies(app, akanConfig);
     await this.syncMobileAppCapacitorPlugins(app, akanConfig);
-    await this.applicationRunner.startAndroid(app, {
-      open,
-      operation,
-      env,
-      target,
-      regenerate
-    });
+    await this.applicationRunner.startAndroid(app, { open, operation, env, target, regenerate });
   }
   async releaseAndroid(app, assembleType, { write = true, target, env = "main", regenerate = false, allowLocalRelease = false } = {}) {
     await app.scanSync({ write });
     if (env === "local" && !allowLocalRelease)
       throw new Error("releaseAndroid --env local is blocked. Pass allowLocalRelease only for explicit local release testing.");
-    await this.applicationRunner.releaseAndroid(app, assembleType, {
-      target,
-      env,
-      regenerate
-    });
+    await this.applicationRunner.releaseAndroid(app, assembleType, { target, env, regenerate });
   }
   async configureApp(app) {
     await this.applicationRunner.configureApp(app);
@@ -3382,8 +3171,21 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
   async releaseSource(app, options) {
     await this.applicationRunner.releaseSource(app, options);
   }
-  async codepush(app, os) {
-    await this.applicationRunner.codepush(app, os);
+  async codepush(app) {
+    await this.applicationRunner.codepush(app);
+  }
+  async transferDatabase(app, direction, dir) {
+    await this.applicationRunner.transferDatabase(app, direction, dir);
+  }
+  async dbupDeclared(workspace, mode) {
+    const declared = mode ? [mode] : await Promise.all((await workspace.getApps()).map(async (appName) => (await AppExecutor.from(workspace, appName).getConfig()).database.modes)).then((modes) => [...new Set(modes.flat())]);
+    const needing = declared.filter((each) => each !== "single");
+    if (!needing.length) {
+      workspace.log("No app here declares a database mode that runs on local services; single needs none.");
+      return;
+    }
+    for (const each of needing)
+      await this.dbup(workspace, each);
   }
   async dbup(workspace, mode = "multiple") {
     const spinner = workspace.spinning(`Starting local database (${mode})...`);
@@ -3401,34 +3203,36 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     }
     spinner.succeed("Local database (/local/docker-compose.yaml) is down");
   }
-  #stopDatabaseOnInterrupt(workspace) {
-    let stopping = false;
-    process.on("SIGINT", () => {
-      if (stopping) {
-        Logger6.rawLog("Abandoning the local database teardown; containers are left running.", undefined, "error");
-        process.exit(130);
-      }
-      stopping = true;
-      this.#stopDatabase(workspace).finally(() => process.exit(0));
+  async#shareOnInterrupt(apps) {
+    const shares = [];
+    const urls = new Map;
+    this.#interrupt.add(async () => {
+      await Promise.all(shares.map(async (share) => await share.close()));
+    }, "Abandoning the tunnel release; the shares expire on their own.");
+    await Promise.all(apps.map(async (app) => {
+      const { TunnelShare } = await import("./TunnelShare-scf4e4pd.js");
+      const share = await TunnelShare.open(app, { workspace: app.workspace });
+      shares.push(share);
+      urls.set(app.name, share.url);
+      Logger6.rawLog(`${app.name} is shared at ${share.url}`);
+    })).catch((error) => {
+      Logger6.rawLog(`Could not open the tunnel: ${error instanceof Error ? error.message : String(error)}`, undefined, "error");
     });
+    return urls;
+  }
+  #stopDatabaseOnInterrupt(workspace) {
+    this.#interrupt.add(async () => {
+      await this.#stopDatabase(workspace);
+    }, "Abandoning the local database teardown; containers are left running.");
   }
   async#stopDatabase(workspace) {
-    let timer = null;
-    const timeout = new Promise((resolve) => {
-      timer = setTimeout(() => resolve("timeout"), ApplicationScript.dbShutdownTimeoutMs);
+    const stopped = this.dbdown(workspace).catch(() => {
+      return;
     });
-    try {
-      const result = await Promise.race([this.dbdown(workspace).catch(() => {
-        return;
-      }), timeout]);
-      if (result !== "timeout")
-        return;
-      Logger6.rawLog(`Local database did not stop within ${ApplicationScript.dbShutdownTimeoutMs}ms; run \`akan dbdown\` once Docker responds.`, undefined, "error");
-    } finally {
-      if (timer)
-        clearTimeout(timer);
-    }
+    if (!await DevSupervisor.timesOut(stopped, ApplicationScript.dbShutdownTimeoutMs))
+      return;
+    Logger6.rawLog(`Local database did not stop within ${ApplicationScript.dbShutdownTimeoutMs}ms; run \`akan dbdown\` once Docker responds.`, undefined, "error");
   }
 }
 
-export { openBrowser, plainTextOf, HOST_SOURCE, DevLogBuffer, ApplicationScript };
+export { ApplicationScript };