@jami-studio/core 0.92.11 → 0.92.13

package/corpus/core/src/vite/client.ts

@@ -1898,6 +1898,7 @@ function ssrStubPlugin(packages: string[]): Plugin | null {
     "useCurrentEditor",
     "useEditor",
     "useLocalRuntime",
+    "useMessagePartReasoning",
     "useMessagePartText",
     "useMessageRuntime",
     "useThread",

package/dist/cli/workspace-dev.d.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env tsx
 import { spawn, type ChildProcess } from "node:child_process";
+import fs from "node:fs";
 import http from "node:http";
 import { type WorkspaceAppAudience } from "../shared/workspace-app-audience.js";
 export interface WorkspaceApp {
@@ -25,6 +26,23 @@ export interface WorkspaceApp {
     outputTail?: string;
     installing?: boolean;
     installAttempted?: boolean;
+    /**
+     * Built-mode lifecycle. `devMode` marks an app that has been promoted to
+     * the vite dev server for the rest of the session (source changed, build
+     * failed, or no build could be produced). `building` marks a production
+     * build in flight as the app's prep child. `buildAttempted` prevents
+     * rebuild loops; `buildChecked` caches the once-per-session staleness scan.
+     */
+    devMode?: boolean;
+    building?: boolean;
+    buildAttempted?: boolean;
+    buildChecked?: boolean;
+    /**
+     * Set before an intentional kill (promotion to dev mode) so the exit
+     * handler respawns immediately instead of treating it as a crash.
+     */
+    expectedExit?: boolean;
+    promoteWatcher?: fs.FSWatcher;
     /**
      * Set true once we've successfully connected to the upstream. After that we
      * skip the readiness probe on every request; the child server stays
@@ -55,6 +73,31 @@ export interface WorkspaceDevHandle {
 }
 export declare function isWorkspaceWatcherLimitError(err: Pick<NodeJS.ErrnoException, "code">): boolean;
 export declare function shouldEagerStartWorkspaceApps(args?: string[], env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Mixed-mode gateway: when enabled (--built / WORKSPACE_BUILT=1), each app
+ * boots from its prebuilt production server (`.output/server/index.mjs`,
+ * instant, prod-shaped) instead of a vite dev server. The gateway builds an
+ * app first when no fresh build exists, and automatically promotes an app to
+ * the vite dev server the moment one of its source files changes — so the
+ * app being edited gets hot reload while every other app stays on built
+ * output. Nothing is manual: editing is the switch.
+ */
+export declare function shouldRunBuiltWorkspaceApps(args?: string[], env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Whether a path relative to an app dir counts as "source" for built-mode
+ * staleness checks and dev-server promotion. Excludes build outputs, data,
+ * dependency trees, and every dot-directory/dot-file (`.output`,
+ * `.deploy-tmp`, `.react-router`, `.env`, ...) — an `.env` edit needs a
+ * restart, not a permanent promotion to vite.
+ */
+export declare function isBuiltModeSourcePath(relPath: string): boolean;
+export declare function builtWorkspaceAppServerEntry(appDir: string): string;
+/**
+ * Newest mtime across an app's source files (build outputs, data, and
+ * node_modules excluded). Used once per session per app to decide whether
+ * the prebuilt server is stale and needs a rebuild before serving.
+ */
+export declare function newestBuiltModeSourceMtimeMs(dir: string, relBase?: string): number;
 /**
  * Whether the gateway should spawn the rest of the apps in the background
  * after the default app boots. Lazy spawn already covers correctness — this

package/dist/cli/workspace-dev.d.ts.map

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

package/dist/cli/workspace-dev.js

@@ -40,6 +40,95 @@ export function shouldEagerStartWorkspaceApps(args = [], env = process.env) {
         env.WORKSPACE_EAGER === "1" ||
         env.WORKSPACE_EAGER === "true");
 }
+/**
+ * Mixed-mode gateway: when enabled (--built / WORKSPACE_BUILT=1), each app
+ * boots from its prebuilt production server (`.output/server/index.mjs`,
+ * instant, prod-shaped) instead of a vite dev server. The gateway builds an
+ * app first when no fresh build exists, and automatically promotes an app to
+ * the vite dev server the moment one of its source files changes — so the
+ * app being edited gets hot reload while every other app stays on built
+ * output. Nothing is manual: editing is the switch.
+ */
+export function shouldRunBuiltWorkspaceApps(args = [], env = process.env) {
+    if (args.includes("--no-built"))
+        return false;
+    if (env.WORKSPACE_BUILT === "0" || env.WORKSPACE_BUILT === "false") {
+        return false;
+    }
+    return (args.includes("--built") ||
+        env.WORKSPACE_BUILT === "1" ||
+        env.WORKSPACE_BUILT === "true");
+}
+const BUILT_MODE_IGNORED_SEGMENTS = new Set([
+    "node_modules",
+    "build",
+    "dist",
+    "data",
+    "media",
+    "coverage",
+    "test-results",
+    "playwright-report",
+]);
+const BUILT_MODE_IGNORED_FILE_PATTERN = /\.(log|tmp|db|db-wal|db-shm|sqlite|sqlite-wal|sqlite-shm)$/i;
+/**
+ * Whether a path relative to an app dir counts as "source" for built-mode
+ * staleness checks and dev-server promotion. Excludes build outputs, data,
+ * dependency trees, and every dot-directory/dot-file (`.output`,
+ * `.deploy-tmp`, `.react-router`, `.env`, ...) — an `.env` edit needs a
+ * restart, not a permanent promotion to vite.
+ */
+export function isBuiltModeSourcePath(relPath) {
+    if (!relPath)
+        return false;
+    const segments = relPath.split(/[\\/]/).filter(Boolean);
+    if (segments.length === 0)
+        return false;
+    for (const segment of segments) {
+        if (segment.startsWith("."))
+            return false;
+        if (BUILT_MODE_IGNORED_SEGMENTS.has(segment))
+            return false;
+    }
+    return !BUILT_MODE_IGNORED_FILE_PATTERN.test(relPath);
+}
+export function builtWorkspaceAppServerEntry(appDir) {
+    return path.join(appDir, ".output", "server", "index.mjs");
+}
+/**
+ * Newest mtime across an app's source files (build outputs, data, and
+ * node_modules excluded). Used once per session per app to decide whether
+ * the prebuilt server is stale and needs a rebuild before serving.
+ */
+export function newestBuiltModeSourceMtimeMs(dir, relBase = "") {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return 0;
+    }
+    let newest = 0;
+    for (const entry of entries) {
+        const rel = relBase ? `${relBase}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            if (entry.name.startsWith(".") ||
+                BUILT_MODE_IGNORED_SEGMENTS.has(entry.name)) {
+                continue;
+            }
+            newest = Math.max(newest, newestBuiltModeSourceMtimeMs(path.join(dir, entry.name), rel));
+            continue;
+        }
+        if (!entry.isFile() || !isBuiltModeSourcePath(rel))
+            continue;
+        try {
+            newest = Math.max(newest, fs.statSync(path.join(dir, entry.name)).mtimeMs);
+        }
+        catch {
+            // File vanished mid-scan — ignore.
+        }
+    }
+    return newest;
+}
 /**
  * Whether the gateway should spawn the rest of the apps in the background
  * after the default app boots. Lazy spawn already covers correctness — this
@@ -413,76 +502,78 @@ function renderStartingApp(app) {
         ? `The workspace gateway will retry in ${Math.max(1, Math.ceil((failure.nextRetryAt - Date.now()) / 1_000))}s. Fix the error below or stop the server with Ctrl+C.`
         : app.installing
             ? "The workspace gateway is installing this app's dependencies before starting it."
-            : "The workspace gateway is waking this app's dev server.";
+            : app.building
+                ? "The workspace gateway is building this app's production server before serving it."
+                : "The workspace gateway is waking this app's dev server.";
     const failureOutput = failure?.output.trim();
-    return `<!doctype html>
-<html>
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <meta http-equiv="refresh" content="${refreshSeconds}" />
-    <title>${title}</title>
-    <meta name="color-scheme" content="light dark" />
-    <style>
-      :root { --bg: #fafafa; --fg: #171717; --muted: #737373; --bar-bg: #e5e5e5; --bar-fill: #171717; --danger: #dc2626; --code-bg: #171717; --code-fg: #fafafa; }
-      @media (prefers-color-scheme: dark) { :root { --bg: #0a0a0a; --fg: #fafafa; --muted: #a3a3a3; --bar-bg: #262626; --bar-fill: #fafafa; --danger: #f87171; --code-bg: #171717; --code-fg: #f5f5f5; } }
-      body { min-height: 100vh; margin: 0; display: grid; place-items: center; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: var(--bg); color: var(--fg); }
-      main { width: min(680px, calc(100vw - 48px)); }
-      .bar { height: 3px; overflow: hidden; border-radius: 999px; background: var(--bar-bg); }
-      .bar::before { content: ""; display: block; height: 100%; width: 42%; border-radius: inherit; background: var(--bar-fill); animation: load 1s ease-in-out infinite; }
-      main.failed .bar::before { width: 100%; background: var(--danger); animation: none; }
-      p { color: var(--muted); }
-      pre { max-height: min(46vh, 360px); overflow: auto; margin-top: 20px; padding: 14px 16px; border-radius: 8px; background: var(--code-bg); color: var(--code-fg); font: 12px/1.45 ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace; white-space: pre-wrap; word-break: break-word; }
-      @keyframes load { 0% { transform: translateX(-105%); } 100% { transform: translateX(245%); } }
-    </style>
-    <script>
-      (() => {
-        const reload = () => window.location.reload();
-        setTimeout(reload, ${JSON.stringify(refreshScriptDelay)});
-        setInterval(reload, ${JSON.stringify(Math.max(refreshScriptDelay, 3_000))});
-      })();
-    </script>
-  </head>
-  <body>
-    <main class="${failure ? "failed" : ""}">
-      <div class="bar"></div>
-      <h1>${title}</h1>
-      <p>${escapeHtml(message)}</p>
-      ${failureOutput ? `<pre>${escapeHtml(failureOutput)}</pre>` : ""}
-    </main>
-  </body>
+    return `<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta http-equiv="refresh" content="${refreshSeconds}" />
+    <title>${title}</title>
+    <meta name="color-scheme" content="light dark" />
+    <style>
+      :root { --bg: #fafafa; --fg: #171717; --muted: #737373; --bar-bg: #e5e5e5; --bar-fill: #171717; --danger: #dc2626; --code-bg: #171717; --code-fg: #fafafa; }
+      @media (prefers-color-scheme: dark) { :root { --bg: #0a0a0a; --fg: #fafafa; --muted: #a3a3a3; --bar-bg: #262626; --bar-fill: #fafafa; --danger: #f87171; --code-bg: #171717; --code-fg: #f5f5f5; } }
+      body { min-height: 100vh; margin: 0; display: grid; place-items: center; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: var(--bg); color: var(--fg); }
+      main { width: min(680px, calc(100vw - 48px)); }
+      .bar { height: 3px; overflow: hidden; border-radius: 999px; background: var(--bar-bg); }
+      .bar::before { content: ""; display: block; height: 100%; width: 42%; border-radius: inherit; background: var(--bar-fill); animation: load 1s ease-in-out infinite; }
+      main.failed .bar::before { width: 100%; background: var(--danger); animation: none; }
+      p { color: var(--muted); }
+      pre { max-height: min(46vh, 360px); overflow: auto; margin-top: 20px; padding: 14px 16px; border-radius: 8px; background: var(--code-bg); color: var(--code-fg); font: 12px/1.45 ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace; white-space: pre-wrap; word-break: break-word; }
+      @keyframes load { 0% { transform: translateX(-105%); } 100% { transform: translateX(245%); } }
+    </style>
+    <script>
+      (() => {
+        const reload = () => window.location.reload();
+        setTimeout(reload, ${JSON.stringify(refreshScriptDelay)});
+        setInterval(reload, ${JSON.stringify(Math.max(refreshScriptDelay, 3_000))});
+      })();
+    </script>
+  </head>
+  <body>
+    <main class="${failure ? "failed" : ""}">
+      <div class="bar"></div>
+      <h1>${title}</h1>
+      <p>${escapeHtml(message)}</p>
+      ${failureOutput ? `<pre>${escapeHtml(failureOutput)}</pre>` : ""}
+    </main>
+  </body>
 </html>`;
 }
 function renderIndex(apps) {
-    return `<!doctype html>
-<html>
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>Agent-Native Workspace</title>
-    <meta name="color-scheme" content="light dark" />
-    <style>
-      :root { --bg: #fafafa; --fg: #171717; --muted: #737373; --card-bg: #ffffff; --card-border: #d4d4d4; }
-      @media (prefers-color-scheme: dark) { :root { --bg: #0a0a0a; --fg: #fafafa; --muted: #a3a3a3; --card-bg: #171717; --card-border: #262626; } }
-      body { font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; margin: 0; padding: 32px; background: var(--bg); color: var(--fg); }
-      main { max-width: 760px; margin: 0 auto; }
-      a { color: inherit; text-decoration: none; }
-      .grid { display: grid; gap: 12px; margin-top: 20px; }
-      .card { display: flex; justify-content: space-between; border: 1px solid var(--card-border); border-radius: 8px; padding: 14px 16px; background: var(--card-bg); }
-      .muted { color: var(--muted); }
-    </style>
-  </head>
-  <body>
-    <main>
-      <h1>Agent-Native Workspace</h1>
-      <p class="muted">Open an app below. Dispatch is the workspace control plane when installed.</p>
-      <div class="grid">
+    return `<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Agent-Native Workspace</title>
+    <meta name="color-scheme" content="light dark" />
+    <style>
+      :root { --bg: #fafafa; --fg: #171717; --muted: #737373; --card-bg: #ffffff; --card-border: #d4d4d4; }
+      @media (prefers-color-scheme: dark) { :root { --bg: #0a0a0a; --fg: #fafafa; --muted: #a3a3a3; --card-bg: #171717; --card-border: #262626; } }
+      body { font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; margin: 0; padding: 32px; background: var(--bg); color: var(--fg); }
+      main { max-width: 760px; margin: 0 auto; }
+      a { color: inherit; text-decoration: none; }
+      .grid { display: grid; gap: 12px; margin-top: 20px; }
+      .card { display: flex; justify-content: space-between; border: 1px solid var(--card-border); border-radius: 8px; padding: 14px 16px; background: var(--card-bg); }
+      .muted { color: var(--muted); }
+    </style>
+  </head>
+  <body>
+    <main>
+      <h1>Agent-Native Workspace</h1>
+      <p class="muted">Open an app below. Dispatch is the workspace control plane when installed.</p>
+      <div class="grid">
         ${apps
         .map((app) => `<a class="card" href="/${app.id}"><strong>${escapeHtml(app.name)}</strong><span class="muted">/${escapeHtml(app.id)}</span></a>`)
-        .join("")}
-      </div>
-    </main>
-  </body>
+        .join("")}
+      </div>
+    </main>
+  </body>
 </html>`;
 }
 function hasLocalBin(dir, command) {
@@ -505,6 +596,7 @@ export async function runWorkspaceDev(options = {}) {
     const appPortStart = Number(env.WORKSPACE_APP_PORT_START || DEFAULT_APP_PORT_START);
     const forceVite = env.WORKSPACE_VITE_FORCE === "1";
     const eager = shouldEagerStartWorkspaceApps(args, env);
+    const builtMode = shouldRunBuiltWorkspaceApps(args, env);
     const pollingMode = pollingFileWatcherMode(env, root);
     const usePollingFileWatcher = pollingMode === "enable";
     const proxyReadyTimeoutMs = Number(env.WORKSPACE_PROXY_READY_TIMEOUT_MS ?? 30_000);
@@ -642,9 +734,61 @@ export async function runWorkspaceDev(options = {}) {
         app.outputTail = undefined;
         const basePath = `/${app.id}`;
         const shouldInstall = !app.installAttempted && !hasLocalBin(app.dir, "vite");
-        const childArgs = shouldInstall
-            ? ["--dir", root, "install", "--no-frozen-lockfile", "--prefer-offline"]
-            : [
+        const builtEntry = builtWorkspaceAppServerEntry(app.dir);
+        let shouldBuild = false;
+        let runBuilt = false;
+        if (builtMode && !shouldInstall && !app.devMode) {
+            let hasFreshBuild = false;
+            if (fs.existsSync(builtEntry)) {
+                if (app.buildChecked) {
+                    hasFreshBuild = true;
+                }
+                else {
+                    app.buildChecked = true;
+                    try {
+                        hasFreshBuild =
+                            newestBuiltModeSourceMtimeMs(app.dir) <=
+                                fs.statSync(builtEntry).mtimeMs;
+                    }
+                    catch {
+                        hasFreshBuild = false;
+                    }
+                    if (!hasFreshBuild) {
+                        stdout.write(`[workspace] /${app.id}: production build is stale \u2014 rebuilding before serving\n`);
+                    }
+                }
+            }
+            if (hasFreshBuild) {
+                runBuilt = true;
+            }
+            else if (!app.buildAttempted) {
+                shouldBuild = true;
+            }
+            else {
+                app.devMode = true;
+                stdout.write(`[workspace] /${app.id}: no usable production build \u2014 falling back to the vite dev server\n`);
+            }
+        }
+        let spawnCommand = "pnpm";
+        let childArgs;
+        if (shouldInstall) {
+            childArgs = [
+                "--dir",
+                root,
+                "install",
+                "--no-frozen-lockfile",
+                "--prefer-offline",
+            ];
+        }
+        else if (shouldBuild) {
+            childArgs = ["--dir", app.dir, "run", "build"];
+        }
+        else if (runBuilt) {
+            spawnCommand = process.execPath;
+            childArgs = [builtEntry];
+        }
+        else {
+            childArgs = [
                 "--dir",
                 app.dir,
                 "exec",
@@ -656,10 +800,17 @@ export async function runWorkspaceDev(options = {}) {
                 "--strictPort",
                 ...(forceVite ? ["--force"] : []),
             ];
+        }
         if (shouldInstall) {
             stdout.write(`[workspace] Installing dependencies before starting /${app.id}\n`);
         }
-        const child = spawnProcess("pnpm", childArgs, {
+        else if (shouldBuild) {
+            stdout.write(`[workspace] Building /${app.id} for built-mode serving (one-time; subsequent boots are instant)\n`);
+        }
+        else if (runBuilt) {
+            stdout.write(`[workspace] /${app.id}: serving prebuilt server\n`);
+        }
+        const child = spawnProcess(spawnCommand, childArgs, {
             cwd: root,
             stdio: ["ignore", "pipe", "pipe"],
             env: devWatcherEnv({
@@ -683,10 +834,14 @@ export async function runWorkspaceDev(options = {}) {
                 VITE_WORKSPACE_GATEWAY_URL: gatewayUrl,
                 PORT: String(app.port),
                 WORKSPACE_GATEWAY_URL: gatewayUrl,
+                ...(runBuilt ? { HOST: "127.0.0.1" } : {}),
             }, pollingMode),
         });
         app.process = child;
         app.installing = shouldInstall;
+        app.building = shouldBuild;
+        if (runBuilt)
+            attachPromoteWatcher(app);
         const prefix = `[${app.id}]`;
         const stableTimer = setTimeout(() => {
             app.restartAttempts = 0;
@@ -707,6 +862,7 @@ export async function runWorkspaceDev(options = {}) {
             const wasInstalling = app.installing;
             app.process = undefined;
             app.installing = false;
+            app.building = false;
             app.ready = false;
             app.readinessProbe = undefined;
             if (app.restartTimer || shuttingDown)
@@ -724,21 +880,45 @@ export async function runWorkspaceDev(options = {}) {
         child.on("exit", (code, signal) => {
             clearTimeout(stableTimer);
             const wasInstalling = app.installing;
+            const wasBuilding = app.building;
             app.process = undefined;
             app.installing = false;
+            app.building = false;
             app.ready = false;
             app.readinessProbe = undefined;
+            if (app.expectedExit) {
+                // Intentional kill (promotion to the vite dev server). Respawn
+                // immediately instead of treating it as a crash.
+                app.expectedExit = false;
+                if (!shuttingDown && !app.restartTimer)
+                    startApp(app);
+                return;
+            }
             if (app.restartTimer)
                 return;
             if (code === 0 || shuttingDown) {
-                if (wasInstalling && code === 0 && !shuttingDown) {
-                    app.installAttempted = true;
-                    startApp(app);
+                if (code === 0 && !shuttingDown) {
+                    if (wasInstalling) {
+                        app.installAttempted = true;
+                        startApp(app);
+                    }
+                    else if (wasBuilding) {
+                        app.buildAttempted = true;
+                        startApp(app);
+                    }
                 }
                 return;
             }
             if (wasInstalling)
                 app.installAttempted = false;
+            if (wasBuilding) {
+                // A failed production build must never brick the app — fall back to
+                // the vite dev server, which surfaces the error with hot reload.
+                app.devMode = true;
+                stderr.write(`[${app.id}] production build failed (exit ${code}); falling back to the vite dev server\n`);
+                startApp(app);
+                return;
+            }
             scheduleAppRestart(app, {
                 code,
                 signal,
@@ -748,6 +928,47 @@ export async function runWorkspaceDev(options = {}) {
             });
         });
     }
+    /**
+     * Built-mode promotion: the moment one of an app's source files changes,
+     * swap its prebuilt server for the vite dev server on the same port. The
+     * proxy doesn't care what listens upstream, so the swap is invisible apart
+     * from a brief wake page. Sticky for the rest of the session.
+     */
+    function promoteAppToDevServer(app, changedPath) {
+        if (app.devMode || shuttingDown)
+            return;
+        app.devMode = true;
+        app.promoteWatcher?.close();
+        app.promoteWatcher = undefined;
+        stdout.write(`[workspace] /${app.id}: source changed (${changedPath}) \u2014 promoting to the vite dev server with hot reload\n`);
+        app.ready = false;
+        app.readinessProbe = undefined;
+        if (app.process && !app.process.killed) {
+            app.expectedExit = true;
+            killAppProcessTree(app.process);
+            return;
+        }
+        startApp(app);
+    }
+    function attachPromoteWatcher(app) {
+        if (app.promoteWatcher || app.devMode)
+            return;
+        try {
+            const watcher = fs.watch(app.dir, { recursive: true }, (_event, filename) => {
+                const rel = filename ? String(filename) : "";
+                if (!isBuiltModeSourcePath(rel))
+                    return;
+                promoteAppToDevServer(app, rel);
+            });
+            watcher.on("error", (err) => {
+                handleWatcherError(err);
+            });
+            app.promoteWatcher = watcher;
+        }
+        catch (err) {
+            handleWatcherError(err);
+        }
+    }
     function scheduleAppRestart(app, input) {
         if (shuttingDown || app.restartTimer)
             return;
@@ -772,8 +993,9 @@ export async function runWorkspaceDev(options = {}) {
         app.restartTimer.unref();
     }
     function failAppStartupTimeout(app) {
-        if (app.installing || app.ready || app.restartTimer)
+        if (app.installing || app.building || app.ready || app.restartTimer) {
             return;
+        }
         const timeout = formatProxyReadyTimeout(proxyReadyTimeoutMs);
         const message = `Timed out waiting ${timeout} for /${app.id} to return ` +
             `an HTTP response on 127.0.0.1:${app.port}.`;
@@ -826,8 +1048,9 @@ export async function runWorkspaceDev(options = {}) {
         return false;
     }
     function ensureReadinessProbe(app) {
-        if (app.ready || app.readinessProbe || app.installing)
+        if (app.ready || app.readinessProbe || app.installing || app.building) {
             return;
+        }
         app.readinessProbe = waitForHttpReady(app, Date.now() + proxyReadyTimeoutMs)
             .then((ready) => {
             if (ready) {
@@ -1183,7 +1406,7 @@ export async function runWorkspaceDev(options = {}) {
             stdout.write(`[workspace] Default: ${redirectRootToDefault ? `${gatewayUrl}/${defaultApp}` : gatewayUrl}\n`);
             stdout.write(`[workspace] Gateway: ${gatewayUrl}\n`);
             const prewarming = shouldPrewarmWorkspaceApps(args, env);
-            stdout.write(`[workspace] Mode: ${eager ? "eager" : prewarming ? "lazy+prewarm" : "lazy"}\n`);
+            stdout.write(`[workspace] Mode: ${eager ? "eager" : prewarming ? "lazy+prewarm" : "lazy"}${builtMode ? "+built (prebuilt servers; edits promote to vite)" : ""}\n`);
             for (const app of apps) {
                 stdout.write(`[workspace] ${app.id}: /${app.id} -> 127.0.0.1:${app.port}\n`);
             }
@@ -1203,6 +1426,8 @@ export async function runWorkspaceDev(options = {}) {
         shuttingDown = true;
         server.close();
         for (const app of apps) {
+            app.promoteWatcher?.close();
+            app.promoteWatcher = undefined;
             killAppProcessTree(app.process);
         }
         if (syncTimer)