@openscout/scout 0.2.75 → 0.2.78

package/dist/runtime/base-daemon.mjs

@@ -1,6 +1,6 @@
 // @bun
 // packages/runtime/src/base-daemon.ts
-import { spawn as spawn3, spawnSync as spawnSync2 } from "child_process";
+import { spawn as spawn3 } from "child_process";
 import { existsSync as existsSync6, mkdirSync as mkdirSync2, openSync, writeFileSync as writeFileSync2 } from "fs";
 import { homedir as homedir6 } from "os";
 import { dirname as dirname4, join as join6, resolve as resolve3 } from "path";
@@ -81,33 +81,49 @@ function requestBrokerOverUnixSocket(socketPath, baseUrl, path, options) {
     if (body !== undefined) {
       headers["content-length"] = Buffer.byteLength(body).toString();
     }
+    let settled = false;
+    const cleanupAbortListener = () => {
+      options.signal?.removeEventListener("abort", handleAbort);
+    };
+    const rejectOnce = (error) => {
+      if (settled)
+        return;
+      settled = true;
+      cleanupAbortListener();
+      reject(error);
+    };
     const request = httpRequest({
       socketPath,
       path: `${url.pathname}${url.search}`,
       method: options.method ?? (body === undefined ? "GET" : "POST"),
       headers
     }, (response) => {
-      let text = "";
-      response.setEncoding("utf8");
+      const chunks = [];
       response.on("data", (chunk) => {
-        text += String(chunk);
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+      });
+      response.on("aborted", () => {
+        rejectOnce(new Error("Scout broker response aborted"));
       });
+      response.on("error", rejectOnce);
       response.on("end", () => {
-        options.signal?.removeEventListener("abort", handleAbort);
+        if (settled)
+          return;
+        settled = true;
+        cleanupAbortListener();
         resolve({
           ok: Boolean(response.statusCode && response.statusCode >= 200 && response.statusCode < 300),
           status: response.statusCode ?? 0,
-          text
+          text: Buffer.concat(chunks).toString("utf8")
         });
       });
     });
     const handleAbort = () => {
-      request.destroy(options.signal?.reason instanceof Error ? options.signal.reason : new Error("Scout broker request aborted"));
+      const error = options.signal?.reason instanceof Error ? options.signal.reason : new Error("Scout broker request aborted");
+      rejectOnce(error);
+      request.destroy(error);
     };
-    request.on("error", (error) => {
-      options.signal?.removeEventListener("abort", handleAbort);
-      reject(error);
-    });
+    request.on("error", rejectOnce);
     if (options.signal) {
       if (options.signal.aborted) {
         handleAbort();
@@ -184,6 +200,175 @@ async function requestScoutBrokerJsonWithTrace(baseUrl, path, options = {}) {
   return { value: undefined, trace };
 }
 
+// packages/runtime/src/schema-version.ts
+var CONTROL_PLANE_SCHEMA_VERSION = 17;
+
+// packages/runtime/src/sqlite-adapter.ts
+import { createRequire } from "module";
+
+// packages/runtime/src/runtime-adapters.ts
+function detectRuntimeHost(globalScope = globalThis) {
+  return typeof globalScope.Bun === "undefined" ? "node" : "bun";
+}
+function normalizeRuntimeHost(value) {
+  const normalized = value?.trim().toLowerCase();
+  if (normalized === "bun")
+    return "bun";
+  if (normalized === "node")
+    return "node";
+  return null;
+}
+function normalizeRuntimeServiceAdapter(value) {
+  const normalized = value?.trim().toLowerCase().replaceAll("_", "-");
+  if (normalized === "macos-scoutd" || normalized === "macos-launchd")
+    return "macos-scoutd";
+  if (normalized === "linux-systemd-user" || normalized === "systemd-user")
+    return "linux-systemd-user";
+  if (normalized === "headless-foreground" || normalized === "foreground" || normalized === "headless") {
+    return "headless-foreground";
+  }
+  if (normalized === "windows-service")
+    return "windows-service";
+  return null;
+}
+function defaultServiceAdapterForPlatform(platform = process.platform, env = process.env) {
+  const explicit = normalizeRuntimeServiceAdapter(env.OPENSCOUT_SERVICE_ADAPTER);
+  if (explicit)
+    return explicit;
+  if (normalizeRuntimeHost(env.OPENSCOUT_RUNTIME_HOST) === "node") {
+    return "headless-foreground";
+  }
+  if (platform === "darwin")
+    return "macos-scoutd";
+  if (platform === "linux")
+    return "headless-foreground";
+  if (platform === "win32")
+    return "windows-service";
+  return "headless-foreground";
+}
+function planRuntimeAdapters(options = {}) {
+  const env = options.env ?? process.env;
+  const host = options.host ?? normalizeRuntimeHost(env.OPENSCOUT_RUNTIME_HOST) ?? detectRuntimeHost();
+  return {
+    host,
+    database: host === "bun" ? "bun-sqlite" : "node-sqlite",
+    httpServer: host === "bun" ? "bun-serve" : "node-http-ws",
+    files: host === "bun" ? "bun-file" : "node-fs",
+    process: host === "bun" ? "bun-spawn" : "node-child-process",
+    service: defaultServiceAdapterForPlatform(options.platform, env)
+  };
+}
+
+// packages/runtime/src/sqlite-adapter.ts
+var require2 = createRequire(import.meta.url);
+function controlPlaneSqliteAdapterKind() {
+  return planRuntimeAdapters().database;
+}
+function openControlPlaneSqliteDatabase(path, options) {
+  return openRuntimeSqliteDatabase(path, options);
+}
+function openRuntimeSqliteDatabase(path, options) {
+  const adapter = controlPlaneSqliteAdapterKind();
+  if (adapter === "bun-sqlite") {
+    const { Database } = require2("bun:sqlite");
+    return new Database(path, options);
+  }
+  const { DatabaseSync } = require2("node:sqlite");
+  return new NodeSqliteDatabaseAdapter(new DatabaseSync(path, {
+    open: true,
+    readOnly: options?.readonly === true
+  }));
+}
+function prepareNodeSqliteSql(sql) {
+  const numberedParamIndexes = [];
+  const normalizedSql = sql.replace(/\?(\d+)/g, (_match, rawIndex) => {
+    numberedParamIndexes.push(Number.parseInt(rawIndex, 10) - 1);
+    return "?";
+  });
+  return {
+    sql: normalizedSql,
+    numberedParamIndexes: numberedParamIndexes.length > 0 ? numberedParamIndexes : null
+  };
+}
+function bindNodeSqliteParams(numberedParamIndexes, params) {
+  if (!numberedParamIndexes) {
+    return params;
+  }
+  return numberedParamIndexes.map((index) => params[index]);
+}
+
+class NodeSqliteStatementAdapter {
+  statement;
+  numberedParamIndexes;
+  constructor(statement, numberedParamIndexes) {
+    this.statement = statement;
+    this.numberedParamIndexes = numberedParamIndexes;
+  }
+  all(...params) {
+    return this.statement.all(...bindNodeSqliteParams(this.numberedParamIndexes, params));
+  }
+  get(...params) {
+    return this.statement.get(...bindNodeSqliteParams(this.numberedParamIndexes, params)) ?? null;
+  }
+  run(...params) {
+    return this.statement.run(...bindNodeSqliteParams(this.numberedParamIndexes, params));
+  }
+}
+
+class NodeSqliteDatabaseAdapter {
+  database;
+  transactionDepth = 0;
+  savepointId = 0;
+  constructor(database) {
+    this.database = database;
+  }
+  exec(sql) {
+    return this.database.exec(sql);
+  }
+  query(sql) {
+    const prepared = prepareNodeSqliteSql(sql);
+    return new NodeSqliteStatementAdapter(this.database.prepare(prepared.sql), prepared.numberedParamIndexes);
+  }
+  close() {
+    this.database.close();
+  }
+  transaction(callback) {
+    return (...args) => {
+      if (this.transactionDepth > 0) {
+        return this.runSavepoint(callback, args);
+      }
+      this.database.exec("BEGIN IMMEDIATE;");
+      this.transactionDepth += 1;
+      try {
+        const result = callback(...args);
+        this.database.exec("COMMIT;");
+        return result;
+      } catch (error) {
+        this.database.exec("ROLLBACK;");
+        throw error;
+      } finally {
+        this.transactionDepth -= 1;
+      }
+    };
+  }
+  runSavepoint(callback, args) {
+    const savepointName = `openscout_nested_${this.savepointId++}`;
+    this.database.exec(`SAVEPOINT ${savepointName};`);
+    this.transactionDepth += 1;
+    try {
+      const result = callback(...args);
+      this.database.exec(`RELEASE SAVEPOINT ${savepointName};`);
+      return result;
+    } catch (error) {
+      this.database.exec(`ROLLBACK TO SAVEPOINT ${savepointName};`);
+      this.database.exec(`RELEASE SAVEPOINT ${savepointName};`);
+      throw error;
+    } finally {
+      this.transactionDepth -= 1;
+    }
+  }
+}
+
 // packages/runtime/src/support-paths.ts
 import { homedir } from "os";
 import { join } from "path";
@@ -811,7 +996,7 @@ var SCOUT_HOST_PROBE_SCHEMA_VERSIONS = {
   "git.mergeBase": 1,
   "git.logLastCommitUnix": 1,
   "git.worktreeListPorcelain": 1,
-  "tmux.sessions": 1,
+  "tmux.sessions": 2,
   "tmux.panes": 1,
   "zellij.sessions": 1,
   "ps.runtime": 1,
@@ -1570,6 +1755,8 @@ var tailscaleStatusProbe = defineProbe({
 
 // packages/runtime/src/tailscale.ts
 var DEFAULT_TAILSCALE_STATUS_TIMEOUT_MS2 = 1500;
+var SYNC_TAILSCALE_STATUS_CACHE_MS = 30000;
+var syncStatusCache = null;
 function readStatusJsonFromFileSync(filePath) {
   const raw = readFileSync2(filePath, "utf8");
   return parseTailscaleStatusJson(raw);
@@ -1594,6 +1781,15 @@ function readStatusJsonSync(env = process.env) {
   if (!tailscaleBin) {
     return null;
   }
+  const cacheKey = [
+    tailscaleBin,
+    env.OPENSCOUT_TAILSCALE_AUTO_HOSTS ?? "",
+    env.OPENSCOUT_TAILSCALE_STATUS_TIMEOUT_MS ?? ""
+  ].join("\x00");
+  const cached = syncStatusCache;
+  if (env === process.env && cached?.key === cacheKey && Date.now() - cached.at < SYNC_TAILSCALE_STATUS_CACHE_MS) {
+    return cached.value;
+  }
   try {
     const stdout = execFileSync(tailscaleBin, ["status", "--json"], {
       encoding: "utf8",
@@ -1601,8 +1797,13 @@ function readStatusJsonSync(env = process.env) {
       timeout: statusTimeoutMs2(env),
       windowsHide: true
     });
-    return parseTailscaleStatusJson(stdout);
+    const value = parseTailscaleStatusJson(stdout);
+    if (env === process.env)
+      syncStatusCache = { key: cacheKey, at: Date.now(), value };
+    return value;
   } catch {
+    if (env === process.env)
+      syncStatusCache = { key: cacheKey, at: Date.now(), value: null };
     return null;
   }
 }
@@ -1853,44 +2054,6 @@ function findExecutableOnSearchPath(name, env) {
   return null;
 }
 
-// packages/runtime/src/runtime-adapters.ts
-function normalizeRuntimeHost(value) {
-  const normalized = value?.trim().toLowerCase();
-  if (normalized === "bun")
-    return "bun";
-  if (normalized === "node")
-    return "node";
-  return null;
-}
-function normalizeRuntimeServiceAdapter(value) {
-  const normalized = value?.trim().toLowerCase().replaceAll("_", "-");
-  if (normalized === "macos-scoutd" || normalized === "macos-launchd")
-    return "macos-scoutd";
-  if (normalized === "linux-systemd-user" || normalized === "systemd-user")
-    return "linux-systemd-user";
-  if (normalized === "headless-foreground" || normalized === "foreground" || normalized === "headless") {
-    return "headless-foreground";
-  }
-  if (normalized === "windows-service")
-    return "windows-service";
-  return null;
-}
-function defaultServiceAdapterForPlatform(platform = process.platform, env = process.env) {
-  const explicit = normalizeRuntimeServiceAdapter(env.OPENSCOUT_SERVICE_ADAPTER);
-  if (explicit)
-    return explicit;
-  if (normalizeRuntimeHost(env.OPENSCOUT_RUNTIME_HOST) === "node") {
-    return "headless-foreground";
-  }
-  if (platform === "darwin")
-    return "macos-scoutd";
-  if (platform === "linux")
-    return "headless-foreground";
-  if (platform === "win32")
-    return "windows-service";
-  return "headless-foreground";
-}
-
 // packages/runtime/src/broker-process-manager.ts
 function isTmpPath(p) {
   return /^\/(?:private\/)?tmp\//.test(p);
@@ -2066,12 +2229,12 @@ function resolveBrokerServiceLabel(mode) {
   }
   switch (mode) {
     case "prod":
-      return "com.openscout";
+      return "app.openscout";
     case "custom":
-      return "com.openscout.custom";
+      return "app.openscout.custom";
     case "dev":
     default:
-      return "dev.openscout";
+      return "app.openscout";
   }
 }
 function resolveBrokerServiceConfig() {
@@ -2238,13 +2401,16 @@ function readRuntimeFreshness(value) {
     state,
     intentional: readBoolean(value.intentional) ?? false,
     basis,
+    reasonCode: readString2(value.reasonCode) ?? null,
     artifactCommit: readString2(value.artifactCommit) ?? null,
     expectedCommit: readString2(value.expectedCommit) ?? null,
     pin: readString2(value.pin) ?? null,
     pinReason: readString2(value.pinReason) ?? null,
     manifestPath: readString2(value.manifestPath) ?? null,
     version: readString2(value.version) ?? null,
-    builtAt: readString2(value.builtAt) ?? null,
+    actualBuiltAt: readString2(value.actualBuiltAt) ?? readString2(value.builtAt) ?? null,
+    expectedBuiltAt: readString2(value.expectedBuiltAt) ?? null,
+    builtAt: readString2(value.builtAt) ?? readString2(value.actualBuiltAt) ?? null,
     sourceDirty: readBoolean(value.sourceDirty) ?? null,
     detail
   };
@@ -2374,7 +2540,30 @@ function spawnScoutdJson(scoutdPath, command, env, timeoutMs) {
     });
   });
 }
+var SCHEMA_GUARDED_SERVICE_COMMANDS = new Set([
+  "install",
+  "start",
+  "restart"
+]);
+function assertBrokerServiceSchemaCompatible(config) {
+  const databasePath = join5(config.controlHome, "control-plane.sqlite");
+  if (!existsSync5(databasePath))
+    return;
+  const database = openControlPlaneSqliteDatabase(databasePath, { readonly: true });
+  try {
+    const row = database.query("PRAGMA user_version").get();
+    const databaseVersion = row?.user_version ?? 0;
+    if (databaseVersion > CONTROL_PLANE_SCHEMA_VERSION) {
+      throw new Error(`Refusing to change the Scout service: candidate runtime schema v${CONTROL_PLANE_SCHEMA_VERSION} ` + `is older than control-plane database schema v${databaseVersion}. ` + "The existing service was left untouched. Update or rebase this checkout before restarting Scout.");
+    }
+  } finally {
+    database.close?.();
+  }
+}
 async function runScoutdServiceCommand(command, config, timeoutMs = SCOUTD_DEFAULT_TIMEOUT_MS, runScoutdJson = spawnScoutdJson) {
+  if (SCHEMA_GUARDED_SERVICE_COMMANDS.has(command)) {
+    assertBrokerServiceSchemaCompatible(config);
+  }
   const scoutd = resolveScoutdCommand(config);
   if (!scoutd) {
     throw new Error("Unable to locate scoutd for broker service management. Build scoutd with `npm run scoutd:build`, install a package that includes scoutd, or set OPENSCOUT_SCOUTD_BIN.");
@@ -2609,6 +2798,9 @@ function formatBrokerServiceStatus(status) {
   ];
   if (status.runtimeFreshness) {
     lines.push(`runtime freshness detail: ${status.runtimeFreshness.detail}`);
+    if (status.runtimeFreshness.reasonCode) {
+      lines.push(`runtime freshness reason: ${status.runtimeFreshness.reasonCode}`);
+    }
   }
   if (status.health.socketFallbackError) {
     lines.push(`socket fallback: ${status.health.socketFallbackError}`);
@@ -2626,6 +2818,141 @@ if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1] && !pr
   });
 }
 
+// packages/runtime/src/scout-ascii-mark.ts
+var ORB_COLS = 60;
+var ORB_ROWS = 47;
+var ORB_FIELD = "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";
+var ORB_CEIL = 0.83;
+var ORB_GAMMA = 0.72;
+var ORB_GAIN = 1.55;
+var ORB_TONES = 4;
+var ORB_GLYPH = "\u2591";
+var ORB_BAYER = [
+  [0.125, 0.625],
+  [0.875, 0.375]
+];
+var ORB_SHIMMER_AMP = 0.34;
+var ORB_STILL = 0.42;
+var ORB_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function clamp01(v) {
+  return Math.max(0, Math.min(1, v));
+}
+function fieldRaw(x, y) {
+  return ORB_ALPHABET.indexOf(ORB_FIELD[y * ORB_COLS + x]) / 63;
+}
+function isOccupied(raw, x, y) {
+  let base = clamp01(raw) / ORB_CEIL;
+  base = Math.pow(clamp01(base), ORB_GAMMA);
+  return base * ORB_GAIN > ORB_BAYER[y % 2][x % 2];
+}
+function orbShimmer(x, y, t) {
+  const nx = x / (ORB_COLS - 1) * 2 - 1;
+  const ny = y / (ORB_ROWS - 1) * 2 - 1;
+  const a = 120 * Math.PI / 180;
+  const u = nx * Math.cos(a) + ny * Math.sin(a) - t;
+  const c = Math.pow(Math.cos(u * Math.PI * 2) * 0.5 + 0.5, 2.8);
+  return 1 - ORB_SHIMMER_AMP + ORB_SHIMMER_AMP * c * 2;
+}
+function toneFor(raw, x, y, t) {
+  let v = clamp01(raw * orbShimmer(x, y, t)) / ORB_CEIL;
+  v = Math.pow(clamp01(v), ORB_GAMMA);
+  const step = Math.min(ORB_TONES - 1, Math.max(0, Math.floor(v * ORB_TONES)));
+  return Math.round(step * 4 / (ORB_TONES - 1));
+}
+function renderScoutAsciiMarkFrame(t) {
+  const layers = [[], [], [], [], []];
+  for (let y = 0;y < ORB_ROWS; y += 1) {
+    const rows = ["", "", "", "", ""];
+    for (let x = 0;x < ORB_COLS; x += 1) {
+      const raw = fieldRaw(x, y);
+      if (!isOccupied(raw, x, y)) {
+        for (let i = 0;i < 5; i += 1)
+          rows[i] += " ";
+        continue;
+      }
+      const tone = toneFor(raw, x, y, t);
+      for (let i = 0;i < 5; i += 1) {
+        rows[i] += i === tone ? ORB_GLYPH : " ";
+      }
+    }
+    for (let i = 0;i < 5; i += 1)
+      layers[i].push(rows[i]);
+  }
+  return layers.map((rows) => rows.join(`
+`));
+}
+function renderScoutAsciiMarkHtml() {
+  return renderScoutAsciiMarkFrame(ORB_STILL).map((text, i) => `<pre class="orb-l" data-t="${i}">${text}</pre>`).join("");
+}
+function renderScoutAsciiMarkScript() {
+  return `<script>
+(function () {
+  var els = document.querySelectorAll(".orb-l");
+  if (els.length !== 5 || !window.requestAnimationFrame) return;
+  var mq = window.matchMedia("(prefers-reduced-motion: reduce)");
+  var F = "${ORB_FIELD}";
+  var A = "${ORB_ALPHABET}";
+  var COLS = ${ORB_COLS}, ROWS = ${ORB_ROWS};
+  var BAYER = [[0.125, 0.625], [0.875, 0.375]];
+  var CEIL = ${ORB_CEIL}, GAMMA = ${ORB_GAMMA}, GAIN = ${ORB_GAIN};
+  var TONES = ${ORB_TONES}, AMP = ${ORB_SHIMMER_AMP};
+  var STILL = ${ORB_STILL};
+  var raf = 0, last = 0;
+
+  function clamp01(v) { return v < 0 ? 0 : v > 1 ? 1 : v; }
+
+  function occupied(raw, x, y) {
+    var base = Math.pow(clamp01(clamp01(raw) / CEIL), GAMMA);
+    return base * GAIN > BAYER[y % 2][x % 2];
+  }
+
+  function toneOf(raw, x, y, t) {
+    var nx = (x / (COLS - 1)) * 2 - 1;
+    var ny = (y / (ROWS - 1)) * 2 - 1;
+    var u = nx * Math.cos(2.0943951) + ny * Math.sin(2.0943951) - t;
+    var c = Math.pow(Math.cos(u * Math.PI * 2) * 0.5 + 0.5, 2.8);
+    var shimmer = 1 - AMP + AMP * c * 2;
+    var v = Math.pow(clamp01(clamp01(raw * shimmer) / CEIL), GAMMA);
+    var step = Math.min(TONES - 1, Math.max(0, Math.floor(v * TONES)));
+    return Math.round(step * 4 / (TONES - 1));
+  }
+
+  function frame(t) {
+    var out = ["", "", "", "", ""];
+    for (var y = 0; y < ROWS; y++) {
+      for (var x = 0; x < COLS; x++) {
+        var raw = A.indexOf(F.charAt(y * COLS + x)) / 63;
+        if (!occupied(raw, x, y)) {
+          for (var i = 0; i < 5; i++) out[i] += " ";
+        } else {
+          var tone = toneOf(raw, x, y, t);
+          for (var j = 0; j < 5; j++) out[j] += j === tone ? "\\u2591" : " ";
+        }
+      }
+      if (y < ROWS - 1) for (var k = 0; k < 5; k++) out[k] += "\\n";
+    }
+    for (var m = 0; m < 5; m++) els[m].textContent = out[m];
+  }
+
+  function loop(ts) {
+    raf = requestAnimationFrame(loop);
+    if (ts - last < 48) return;
+    last = ts;
+    frame(STILL + (ts / 1000) * 0.38);
+  }
+  function sync() {
+    cancelAnimationFrame(raf);
+    raf = 0;
+    if (mq.matches || document.hidden) frame(STILL);
+    else raf = requestAnimationFrame(loop);
+  }
+  if (mq.addEventListener) mq.addEventListener("change", sync);
+  document.addEventListener("visibilitychange", sync);
+  sync();
+})();
+</script>`;
+}
+
 // packages/runtime/src/local-edge.ts
 function normalizeViteHmrPath(value) {
   const trimmed = value?.trim();
@@ -2719,91 +3046,180 @@ function renderOpenScoutStartPage(config) {
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title>Start Scout</title>
+  <script>
+    (function () {
+      var theme = "dark";
+      try {
+        var query = new URLSearchParams(window.location.search).get("theme");
+        var stored = JSON.parse(window.localStorage.getItem("openscout.theme") || "{}").theme;
+        var preference = query || stored;
+        if (preference === "light") theme = "light";
+        if (preference === "system") {
+          theme = window.matchMedia("(prefers-color-scheme: light)").matches ? "light" : "dark";
+        }
+      } catch {}
+      document.documentElement.dataset.scoutTheme = theme;
+    })();
+  </script>
   <style>
     :root {
       color-scheme: light dark;
-      font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
-      background: #0f1720;
-      color: #f5f7fb;
+      --bg: #080a07;
+      --surface: #10130e;
+      --ink: #f5f1e8;
+      --muted: #aaa69b;
+      --edge: #303729;
+      --accent: #a6e15e;
+      --orb-0: #2a2723;
+      --orb-1: #444038;
+      --orb-2: #6d675a;
+      --orb-3: #9a9181;
+      --orb-4: #d8d0c0;
+      font-family: "Inter Tight", Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+      background: var(--bg);
+      color: var(--ink);
     }
     * { box-sizing: border-box; margin: 0; padding: 0; }
     body {
       min-height: 100vh;
       display: grid;
       place-items: center;
-      padding: 32px;
-      background:
-        radial-gradient(ellipse at 15% 30%, rgba(91, 141, 239, 0.16) 0%, transparent 50%),
-        radial-gradient(ellipse at 85% 70%, rgba(74, 222, 128, 0.06) 0%, transparent 40%),
-        #111827;
+      padding: 32px 28px;
+      background: var(--bg);
     }
     main {
-      width: min(400px, 100%);
-      padding: 28px 30px 26px;
-      border: 1px solid rgba(255, 255, 255, 0.09);
-      border-radius: 10px;
-      background: rgba(15, 23, 32, 0.9);
-      box-shadow: 0 1px 0 rgba(255, 255, 255, 0.04) inset, 0 20px 60px rgba(0, 0, 0, 0.45);
-    }
-    .badge {
-      display: inline-flex;
+      width: min(640px, 100%);
+    }
+    .brand {
+      display: flex;
       align-items: center;
-      gap: 6px;
-      margin-bottom: 18px;
-      font-size: 11px;
-      font-weight: 600;
-      letter-spacing: 0.07em;
+      justify-content: space-between;
+      gap: 16px;
+      padding-bottom: 14px;
+      margin-bottom: 36px;
+      border-bottom: 1px solid color-mix(in srgb, var(--edge) 80%, transparent);
+    }
+    .host {
+      overflow: hidden;
+      color: var(--muted);
+      font: 500 11px/1.2 ui-monospace, "SF Mono", Menlo, monospace;
+      letter-spacing: 0.08em;
+      text-overflow: ellipsis;
       text-transform: uppercase;
-      color: rgba(74, 222, 128, 0.8);
+      white-space: nowrap;
     }
-    @keyframes blink {
-      0%, 100% { opacity: 1; }
-      50% { opacity: 0.2; }
+    .service {
+      color: var(--muted);
+      font-size: 12px;
+      letter-spacing: 0.01em;
+      white-space: nowrap;
     }
-    .badge-dot {
-      width: 6px;
-      height: 6px;
-      border-radius: 50%;
-      background: #4ade80;
-      flex-shrink: 0;
-      animation: blink 2.4s ease-in-out infinite;
+    .hero {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) auto;
+      gap: 24px 36px;
+      align-items: center;
     }
+    /* The mark is a second way into the app, not just decoration \u2014 it is the
+       largest, most inviting thing on the page, so clicking it should do what
+       clicking it looks like it should do. It stays aria-hidden and outside the
+       tab order on purpose: 2820 glyph cells are noise to a screen reader, and
+       the real #start button sits beside it as the accessible, keyboard-
+       reachable path. This is a redundant mouse affordance, never the only one. */
+    .orb {
+      position: relative;
+      justify-self: end;
+      user-select: none;
+      cursor: pointer;
+      transition: transform 160ms ease, filter 160ms ease;
+    }
+    .orb:hover { transform: translateY(-1px); filter: brightness(1.18); }
+    .orb:active { transform: translateY(0); filter: brightness(1.05); }
+    .orb[data-busy="true"] { cursor: progress; }
+    .orb[data-busy="true"]:hover { transform: none; filter: none; }
+    @media (prefers-reduced-motion: reduce) {
+      .orb { transition: none; }
+      .orb:hover, .orb:active { transform: none; }
+    }
+    .orb-l {
+      margin: 0;
+      color: var(--orb-0);
+      font: 400 5px/1 ui-monospace, "SF Mono", Menlo, Consolas, monospace;
+      letter-spacing: 0;
+      white-space: pre;
+      -webkit-font-smoothing: none;
+      -moz-osx-font-smoothing: unset;
+      font-smooth: never;
+      text-rendering: geometricPrecision;
+      font-variant-ligatures: none;
+      font-kerning: none;
+    }
+    .orb-l + .orb-l { position: absolute; inset: 0; }
+    .orb-l[data-t="1"] { color: var(--orb-1); }
+    .orb-l[data-t="2"] { color: var(--orb-2); }
+    .orb-l[data-t="3"] { color: var(--orb-3); }
+    .orb-l[data-t="4"] { color: var(--orb-4); }
     h1 {
-      font-size: 22px;
-      font-weight: 700;
-      line-height: 1.2;
-      margin-bottom: 8px;
-      color: #f5f7fb;
+      margin-bottom: 10px;
+      color: var(--ink);
+      font-size: clamp(24px, 3.6vw, 28px);
+      font-weight: 560;
+      letter-spacing: -0.04em;
+      line-height: 1.12;
     }
     p {
+      max-width: 34ch;
+      color: var(--muted);
       font-size: 14px;
-      color: rgba(245, 247, 251, 0.5);
       line-height: 1.55;
       margin-bottom: 22px;
     }
     button {
-      width: 100%;
       min-height: 44px;
-      border: 0;
-      border-radius: 7px;
-      background: #f4d35e;
-      color: #17202a;
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      gap: 8px;
+      border: 1px solid var(--edge);
+      border-radius: 8px;
+      padding: 0 14px;
+      background: var(--surface);
+      color: var(--ink);
       font: inherit;
-      font-size: 14px;
-      font-weight: 700;
+      font-size: 13px;
+      font-weight: 550;
+      letter-spacing: -0.015em;
       cursor: pointer;
-      transition: background 0.1s, opacity 0.1s;
+      transition: background 120ms ease, border-color 120ms ease, color 120ms ease, opacity 120ms ease;
+    }
+    button:hover:not(:disabled) {
+      border-color: color-mix(in srgb, var(--accent) 42%, var(--edge));
+      background: color-mix(in srgb, var(--surface) 88%, var(--accent));
+    }
+    button:active:not(:disabled) {
+      background: color-mix(in srgb, var(--surface) 78%, var(--accent));
     }
-    button:hover:not(:disabled) { background: #f7dc74; }
-    button:active:not(:disabled) { background: #e8c44a; }
-    button:disabled { cursor: progress; opacity: 0.6; }
+    button:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+    button:disabled { cursor: progress; opacity: 0.55; }
+    .button-arrow {
+      color: var(--accent);
+      font-size: 14px;
+      font-weight: 500;
+      line-height: 1;
+      transition: transform 120ms ease;
+    }
+    button:hover:not(:disabled) .button-arrow { transform: translateX(1px); }
     .progress {
-      height: 2px;
-      margin-top: 14px;
-      border-radius: 2px;
-      background: rgba(255, 255, 255, 0.06);
+      width: min(220px, 100%);
+      height: 1px;
+      margin-top: 18px;
+      border-radius: 1px;
+      background: color-mix(in srgb, var(--edge) 70%, transparent);
       overflow: hidden;
+      opacity: 0;
+      transition: opacity 120ms ease;
     }
+    main.is-waiting .progress { opacity: 1; }
     @keyframes sweep {
       0%   { transform: translateX(-100%); }
       100% { transform: translateX(500%); }
@@ -2811,8 +3227,8 @@ function renderOpenScoutStartPage(config) {
     .progress-bar {
       height: 100%;
       width: 20%;
-      border-radius: 2px;
-      background: rgba(244, 211, 94, 0.7);
+      border-radius: 1px;
+      background: var(--accent);
       transform: translateX(-100%);
     }
     .progress-bar.running {
@@ -2822,36 +3238,82 @@ function renderOpenScoutStartPage(config) {
       display: block;
       min-height: 16px;
       margin-top: 10px;
-      color: rgba(245, 247, 251, 0.38);
+      color: var(--muted);
       font-family: ui-monospace, "SF Mono", Menlo, "Cascadia Code", monospace;
-      font-size: 12px;
+      font-size: 11px;
       line-height: 1.4;
     }
+    :root[data-scout-theme="dark"] { color-scheme: dark; }
+    :root[data-scout-theme="light"] {
+      color-scheme: light;
+      --bg: #f3f1ea;
+      --surface: #fbfaf5;
+      --ink: #171914;
+      --muted: #65655d;
+      --edge: #c6c8ba;
+      --accent: #3a6807;
+      --orb-0: #d2cec4;
+      --orb-1: #a19d94;
+      --orb-2: #717068;
+      --orb-3: #484b44;
+      --orb-4: #1c2019;
+    }
+    @media (max-width: 520px) {
+      body { place-items: start center; padding: 24px 20px; }
+      main { padding-top: 10vh; }
+      .brand { margin-bottom: 28px; }
+      .service { display: none; }
+      .hero { grid-template-columns: 1fr; gap: 28px; }
+      .orb { order: -1; justify-self: start; }
+      .orb-l { font-size: 4.5px; }
+      h1 { font-size: clamp(22px, 6.5vw, 26px); }
+      p { max-width: none; }
+      button { width: 100%; }
+      .progress { width: 100%; }
+    }
+    @media (prefers-reduced-motion: reduce) {
+      button, .button-arrow, .progress { transition: none; }
+      button:hover:not(:disabled) .button-arrow { transform: none; }
+      .progress-bar.running { animation: none; transform: none; width: 100%; }
+    }
   </style>
 </head>
 <body>
-  <main>
-    <div class="badge"><span class="badge-dot"></span>Broker online</div>
-    <h1>Start Scout</h1>
-    <p>The web app is not running yet. Click to start it on this machine.</p>
-    <button id="start" type="button">Start Scout</button>
-    <div class="progress"><div class="progress-bar" id="bar"></div></div>
-    <output id="status" role="status"></output>
+  <main id="shell">
+    <div class="brand">
+      <span class="host" id="host">Scout local</span>
+      <span class="service">Local web service</span>
+    </div>
+    <div class="hero">
+      <section>
+        <h1>Bring Scout online.</h1>
+        <p>The web interface is not running yet. Start it to return to your agents, messages, and activity.</p>
+        <button id="start" type="button"><span>Start Scout</span><span class="button-arrow" aria-hidden="true">\u2192</span></button>
+        <div class="progress"><div class="progress-bar" id="bar"></div></div>
+        <output id="status" role="status"></output>
+      </section>
+      <div class="orb" aria-hidden="true">${renderScoutAsciiMarkHtml()}</div>
+    </div>
   </main>
+  ${renderScoutAsciiMarkScript()}
   <script>
     const config = ${pageConfig};
+    const shell = document.getElementById('shell');
+    const host = document.getElementById('host');
     const button = document.getElementById('start');
     const bar = document.getElementById('bar');
     const status = document.getElementById('status');
     const targetPath = window.location.pathname + window.location.search + window.location.hash;
     const healthUrl = new URL('/api/health', window.location.origin);
     const startUrl = new URL(config.startPath, window.location.origin);
+    host.textContent = window.location.host;
 
     function setStatus(message) {
       status.textContent = message;
     }
 
     function setWaiting(on) {
+      shell.classList.toggle('is-waiting', on);
       bar.classList.toggle('running', on);
     }
 
@@ -2873,8 +3335,14 @@ function renderOpenScoutStartPage(config) {
       return false;
     }
 
-    button.addEventListener('click', async () => {
+    const orb = document.querySelector('.orb');
+
+    async function startScout() {
+      // Both entry points share one guard: the mark can be clicked while the
+      // button is mid-flight, and a second POST would race the first.
+      if (button.disabled) return;
       button.disabled = true;
+      if (orb) orb.dataset.busy = 'true';
       setWaiting(true);
       setStatus('Starting Scout web...');
       try {
@@ -2896,13 +3364,18 @@ function renderOpenScoutStartPage(config) {
           setWaiting(false);
           setStatus('Scout web did not become ready. Try again in a moment.');
           button.disabled = false;
+          if (orb) orb.dataset.busy = 'false';
         }
       } catch (error) {
         setWaiting(false);
         setStatus(error instanceof Error ? error.message : String(error));
         button.disabled = false;
+        if (orb) orb.dataset.busy = 'false';
       }
-    });
+    }
+
+    button.addEventListener('click', startScout);
+    if (orb) orb.addEventListener('click', startScout);
   </script>
 </body>
 </html>`;
@@ -2962,12 +3435,11 @@ var RESTART_MIN_DELAY_MS = 1000;
 var RESTART_MAX_DELAY_MS = 30000;
 var BROKER_HEALTH_TIMEOUT_MS = 30000;
 var BROKER_HEALTH_POLL_MS = 250;
-var CHILD_SHUTDOWN_TIMEOUT_MS = 12000;
+var CHILD_SHUTDOWN_TIMEOUT_MS = 15000;
 var WEB_START_RETRY_MS = 5000;
 var MENU_BUNDLE_ID = "app.openscout.scout.menu";
-var MENU_PROCESS_NAME = "ScoutMenu";
 var PROCESS_NAME = "scout-base";
-var BROKER_LAUNCHER_PROCESS_NAME = "scout-broker-run";
+var BROKER_PROCESS_NAME = "scout-broker";
 var EDGE_PROCESS_NAME = "scout-edge";
 var MDNS_PROCESS_NAME = "scout-mdns";
 process.title = PROCESS_NAME;
@@ -2977,10 +3449,11 @@ var caddyProcess = null;
 var mdnsProcesses = [];
 var brokerRestartDelayMs = RESTART_MIN_DELAY_MS;
 var edgeRestartDelayMs = RESTART_MIN_DELAY_MS;
-var supervisedWebPid = null;
 var baseKeepAlive = null;
 var webStartRetryTimer = null;
 var webStartInFlight = false;
+var parentWatcher = null;
+var parentPid = Number.parseInt(process.env.OPENSCOUT_PARENT_PID ?? "0", 10);
 var config = resolveBrokerServiceConfig();
 var brokerControlUrl = buildLocalBrokerControlUrl(config.brokerHost, config.brokerPort);
 function log(message, details) {
@@ -3049,7 +3522,7 @@ function spawnBroker() {
     runtimeEntrypoint(config),
     "broker"
   ], {
-    argv0: BROKER_LAUNCHER_PROCESS_NAME,
+    argv0: BROKER_PROCESS_NAME,
     cwd: config.runtimePackageDir,
     env: {
       ...process.env,
@@ -3069,7 +3542,6 @@ function spawnBroker() {
   brokerProcess.once("exit", (code, signal) => {
     log("broker exited", { code, signal });
     brokerProcess = null;
-    supervisedWebPid = null;
     if (!shuttingDown) {
       scheduleBrokerRestart();
     }
@@ -3262,13 +3734,12 @@ async function startWebWhenBrokerIsReady() {
         signal: AbortSignal.timeout(15000)
       });
       const body = await response.json();
-      supervisedWebPid = typeof body.pid === "number" ? body.pid : resolvePortListenerPid(Number.parseInt(process.env.OPENSCOUT_WEB_PORT ?? "", 10) || resolveWebPort());
       if (!response.ok || body.ok !== true) {
         warn("web server did not report healthy", body.error ?? response.statusText);
         scheduleWebStartRetry();
         return;
       }
-      log("web server ready", { pid: supervisedWebPid });
+      log("web server ready", { pid: body.pid ?? null });
     } catch (error) {
       warn("web server startup failed", error instanceof Error ? error.message : String(error));
       scheduleWebStartRetry();
@@ -3287,22 +3758,17 @@ function scheduleWebStartRetry() {
   }, WEB_START_RETRY_MS);
   webStartRetryTimer.unref();
 }
-function resolvePortListenerPid(port) {
-  const result = spawnSync2("lsof", ["-nP", `-iTCP:${port}`, "-sTCP:LISTEN", "-t"], {
-    encoding: "utf8"
-  });
-  if ((result.status ?? 1) !== 0) {
-    return null;
-  }
-  const pid = Number.parseInt(result.stdout.trim().split(/\s+/)[0] ?? "", 10);
-  return Number.isFinite(pid) && pid > 0 ? pid : null;
-}
 function findRepoMenuBundle() {
   let current = dirname4(fileURLToPath2(import.meta.url));
   while (true) {
-    const candidate = resolve3(current, "apps", "macos", "dist", "ScoutMenu.app");
-    if (existsSync6(candidate)) {
-      return candidate;
+    const distRoot = resolve3(current, "apps", "macos", "dist");
+    const candidates = [
+      resolve3(distRoot, "Scout.app", "Contents", "Library", "LoginItems", "ScoutMenu.app"),
+      resolve3(distRoot, "ScoutMenu.app")
+    ];
+    for (const candidate of candidates) {
+      if (existsSync6(candidate))
+        return candidate;
     }
     const parent = dirname4(current);
     if (parent === current) {
@@ -3329,12 +3795,6 @@ function startMenuBarApp() {
     warn("menu bar app launch failed", { target: repoBundle ?? MENU_BUNDLE_ID, code });
   });
 }
-function stopMenuBarApp() {
-  if (process.platform !== "darwin" || process.env.OPENSCOUT_BASE_MENU_ENABLED === "0") {
-    return;
-  }
-  spawn3("pkill", ["-x", MENU_PROCESS_NAME], { stdio: "ignore" }).unref();
-}
 function isChildExited(child) {
   return child.exitCode !== null || child.signalCode !== null;
 }
@@ -3373,14 +3833,6 @@ async function terminateChildProcess(child, label, timeoutMs = CHILD_SHUTDOWN_TI
   }
   await waitForChildExit(child, 2000);
 }
-function stopSupervisedWeb() {
-  if (supervisedWebPid && supervisedWebPid > 0) {
-    try {
-      process.kill(supervisedWebPid, "SIGTERM");
-    } catch {}
-  }
-  supervisedWebPid = null;
-}
 async function shutdown(exitCode = 0) {
   if (shuttingDown) {
     return;
@@ -3390,12 +3842,14 @@ async function shutdown(exitCode = 0) {
     clearInterval(baseKeepAlive);
     baseKeepAlive = null;
   }
+  if (parentWatcher) {
+    clearInterval(parentWatcher);
+    parentWatcher = null;
+  }
   if (webStartRetryTimer) {
     clearTimeout(webStartRetryTimer);
     webStartRetryTimer = null;
   }
-  stopSupervisedWeb();
-  stopMenuBarApp();
   const activeCaddyProcess = caddyProcess;
   stopEdgeProcesses();
   await terminateChildProcess(brokerProcess, "broker");
@@ -3421,6 +3875,20 @@ for (const signal of ["SIGINT", "SIGTERM"]) {
     });
   });
 }
+if (Number.isFinite(parentPid) && parentPid > 0 && parentPid !== process.pid) {
+  parentWatcher = setInterval(() => {
+    try {
+      process.kill(parentPid, 0);
+    } catch {
+      log(`parent ${parentPid} is gone, shutting down base`);
+      shutdown(0).catch((error) => {
+        warn("shutdown failed", error instanceof Error ? error.message : String(error));
+        process.exit(1);
+      });
+    }
+  }, 2000);
+  parentWatcher.unref();
+}
 log("starting Scout base service", {
   label: config.label,
   brokerUrl: config.brokerUrl,