sootsim 0.1.168 → 0.1.170

package/dist-lib/profiles.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.168 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.170 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.168 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.170 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/scripts/dev-server-scanner.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.168 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.170 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -33,6 +33,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var dev_server_scanner_exports = {};
 __export(dev_server_scanner_exports, {
   __applyManifestForTests: () => __applyManifestForTests,
+  __isSootSelfServerForTests: () => __isSootSelfServerForTests,
   __resetScannerCache: () => __resetScannerCache,
   __shouldReuseScannerCacheEntry: () => __shouldReuseScannerCacheEntry,
   discoverListeningPorts: () => discoverListeningPorts,
@@ -412,12 +413,11 @@ async function probePort(port, buildIconProxyUrl) {
   return null;
 }
 function isSootSelfServer(server) {
-  const projectName = server.projectName?.trim().toLowerCase();
-  if (projectName === "soot" || projectName === "sootsim") return true;
   const bundleId = server.bundleId?.trim().toLowerCase();
-  if (bundleId?.startsWith("dev.soot")) return true;
+  if (bundleId?.startsWith("dev.sootsim.")) return true;
   return false;
 }
+var __isSootSelfServerForTests = isSootSelfServer;
 var portCache = /* @__PURE__ */ new Map();
 var NEGATIVE_CACHE_TTL_MS = 3e4;
 var WEAK_RESULT_CACHE_TTL_MS = 1500;
@@ -507,6 +507,7 @@ async function scanDevServers(opts = {}) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   __applyManifestForTests,
+  __isSootSelfServerForTests,
   __resetScannerCache,
   __shouldReuseScannerCacheEntry,
   discoverListeningPorts,

package/dist-lib/sdk.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.168 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.170 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.168 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.170 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // cli/commands/inspect/core.ts
 function resolveMaxMsFlag(args, fallbackMs) {

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.168 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.170 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -3249,8 +3249,8 @@ var init_registry = __esm({
           {
             range: ">=3.1.0",
             coverage: 0.85,
-            note: "ExpoSpeechRecognition module and Web Speech wrapper backed by browser SpeechRecognition when available",
-            working: "ExpoSpeechRecognitionModule start/stop/abort/state, native event addListener/remove, granted permission helpers, recognition availability, speech services/default-service helpers, supported locales, iOS audio-session getters/setters, ExpoWebSpeechRecognition class, grammar/list classes, constants",
+            note: "native-seam only \u2014 upstream expo-speech-recognition JS (ExpoWebSpeechRecognition, useSpeechRecognitionEvent, constants, and direct module API) runs unchanged from the bundle; SootSim registers only the ExpoSpeechRecognition native module, backed by the host-service SpeechRecognition bridge when available",
+            working: "ExpoSpeechRecognition native module start/stop/abort/state, native event addListener/remove, granted permission helpers, recognition availability, speech services/default-service helpers, supported-locales shape, iOS audio-session getters/setters; upstream ExpoWebSpeechRecognition class, grammar/list classes, hook, and constants stay authoritative",
             missing: "native SFSpeechRecognizer and Android SpeechRecognizer engines, real microphone permission prompts, audioSource transcription, recording persistence, locale installation data, offline model downloads, volume metering"
           }
         ]
@@ -5224,10 +5224,10 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=0.7.0",
-            coverage: 0.9,
-            note: "Node crypto surface for React Native bundles; WebCrypto backs random/RSA/subtle, and audited sync primitives back Node-only synchronous hash/HMAC/AES/PBKDF2 contracts.",
-            working: "subtle/webcrypto forwarding, randomBytes/randomFill/randomInt/randomUUID, createHash/createHmac, pbkdf2 callback/promise form, pbkdf2Sync, AES-CBC/GCM/CTR encrypt/decrypt with auth tags, publicEncrypt/privateDecrypt for RSA-OAEP and RSA_PKCS1_PADDING, conversion helpers, constants used by Node crypto consumers",
-            missing: "non-WebCrypto legacy algorithms such as DES/RC4/ChaCha20 are not implemented."
+            coverage: 0.82,
+            note: "native-seam only \u2014 real react-native-quick-crypto JS runs from the bundle against a SootSim-provided global.__QuickCryptoProxy. The seam implements the synchronous native primitives that can be faithfully backed in the browser (random, hash/HMAC, PBKDF2, AES-CBC/CTR/GCM, AES secret-key handles) and leaves unsupported native-only RSA/sign/keygen paths as explicit unsupported operations.",
+            working: "upstream package JS and export surface, global __QuickCryptoProxy install before module evaluation, random/randomFill/getRandomValues via upstream JS, createHash/createHmac host objects, pbkdf2 callback/promise form and pbkdf2Sync, AES-CBC/GCM/CTR host ciphers, AES WebCrypto secret-key import/export and encrypt/decrypt",
+            missing: "synchronous RSA publicEncrypt/publicDecrypt/privateDecrypt, createSign/createVerify, generateKeyPair, RSA/ECDH WebCrypto key paths, AES-KW, and legacy ciphers such as DES/RC4/ChaCha20."
           }
         ]
       },
@@ -5237,10 +5237,10 @@ var init_registry = __esm({
         versions: [
           {
             range: ">=0.3.0",
-            coverage: 0.9,
-            note: "aliases the WebCrypto-backed react-native-quick-crypto implementation; upstream package is another native Node-crypto surface over Nitro Modules, so the same native crypto contract applies.",
-            working: "same coverage as react-native-quick-crypto: random, sync hash/HMAC, AES-CBC/GCM/CTR, PBKDF2/pbkdf2Sync, RSA-OAEP, RSA PKCS1 v1.5 via the RSA seam, subtle/webcrypto forwarding",
-            missing: "same limitations as react-native-quick-crypto: non-WebCrypto legacy algorithms"
+            coverage: 0.55,
+            note: "small compatibility surface backed by the react-native-quick-crypto native proxy for existing SootSim callers; this is not the quick-crypto package replacement and should be replaced by a native-seam-only Nitro Modules implementation when that package becomes a priority.",
+            working: "createHash plus subtle/webcrypto references for load-safe consumers",
+            missing: "full upstream react-native-nitro-crypto package JS/native contract is not modeled yet"
           }
         ]
       },
@@ -10350,10 +10350,8 @@ async function probePort(port, buildIconProxyUrl) {
   return null;
 }
 function isSootSelfServer(server) {
-  const projectName = server.projectName?.trim().toLowerCase();
-  if (projectName === "soot" || projectName === "sootsim") return true;
   const bundleId = server.bundleId?.trim().toLowerCase();
-  if (bundleId?.startsWith("dev.soot")) return true;
+  if (bundleId?.startsWith("dev.sootsim.")) return true;
   return false;
 }
 function isWeakCachedResult(result) {
@@ -10507,6 +10505,27 @@ function sootsimHomeDir() {
   if (override && override.length > 0) return import_node_path.default.resolve(override);
   return import_node_path.default.join((0, import_node_os.homedir)(), ".sootsim");
 }
+function isSootsimDevCheckout() {
+  if (process.env.SOOTSIM_FORCE_DAEMON_INSTALL === "1") return false;
+  const env = process.env.SOOTSIM_DEV;
+  if (env === "1" || env === "true") return true;
+  if (env === "0" || env === "false") return false;
+  const argv1 = process.argv[1];
+  if (!argv1) return false;
+  try {
+    const real = import_node_fs2.default.realpathSync(argv1);
+    return real.includes(`${import_node_path.default.sep}packages${import_node_path.default.sep}sootsim${import_node_path.default.sep}`);
+  } catch {
+    return false;
+  }
+}
+function isDevWorkstation() {
+  if (process.env.SOOTSIM_FORCE_DAEMON_INSTALL === "1") return false;
+  return process.env.IS_TAMAGUI_DEV === "1";
+}
+function shouldSkipPersistentDaemon() {
+  return isSootsimDevCheckout() || isDevWorkstation();
+}
 function runtimesDir() {
   return import_node_path.default.join(sootsimHomeDir(), "runtimes");
 }
@@ -10531,6 +10550,9 @@ function cacheDir() {
 function daemonLockfilePath() {
   return import_node_path.default.join(sootsimHomeDir(), DAEMON_LOCKFILE);
 }
+function devBridgeLockfilePath() {
+  return import_node_path.default.join(sootsimHomeDir(), DEV_BRIDGE_LOCKFILE);
+}
 function configFilePath() {
   return import_node_path.default.join(sootsimHomeDir(), CONFIG_FILE);
 }
@@ -10636,6 +10658,25 @@ function readDaemonLockfile() {
     return null;
   }
 }
+function readDevBridgeLockfile() {
+  try {
+    const fd = import_node_fs2.default.openSync(devBridgeLockfilePath(), "r");
+    try {
+      const buf = Buffer.alloc(DAEMON_LOCKFILE_MAX_BYTES);
+      const bytesRead = import_node_fs2.default.readSync(fd, buf, 0, DAEMON_LOCKFILE_MAX_BYTES, 0);
+      const raw = buf.subarray(0, bytesRead).toString("utf8");
+      const parsed = JSON.parse(raw);
+      if (parsed && parsed.schema === 1 && parsed.source === "vite-dev" && typeof parsed.pid === "number" && typeof parsed.bridgePort === "number" && typeof parsed.runtimePort === "number" && typeof parsed.cwd === "string" && typeof parsed.startedAt === "number" && typeof parsed.heartbeatAt === "number") {
+        return parsed;
+      }
+      return null;
+    } finally {
+      import_node_fs2.default.closeSync(fd);
+    }
+  } catch {
+    return null;
+  }
+}
 function isDaemonLockfileFresh(lock, now = Date.now()) {
   if (!lock) return false;
   if (now - lock.heartbeatAt > DAEMON_HEARTBEAT_STALE_MS) return false;
@@ -10646,6 +10687,16 @@ function isDaemonLockfileFresh(lock, now = Date.now()) {
     return false;
   }
 }
+function isDevBridgeLockfileFresh(lock, now = Date.now()) {
+  if (!lock) return false;
+  if (now - lock.heartbeatAt > DAEMON_HEARTBEAT_STALE_MS) return false;
+  try {
+    process.kill(lock.pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function writeDaemonLockfile(data) {
   ensureSootsimHome();
   const tmp = `${daemonLockfilePath()}.tmp`;
@@ -10653,6 +10704,13 @@ function writeDaemonLockfile(data) {
 `, "utf8");
   import_node_fs2.default.renameSync(tmp, daemonLockfilePath());
 }
+function writeDevBridgeLockfile(data) {
+  ensureSootsimHome();
+  const tmp = `${devBridgeLockfilePath()}.tmp`;
+  import_node_fs2.default.writeFileSync(tmp, `${JSON.stringify(data, null, 2)}
+`, "utf8");
+  import_node_fs2.default.renameSync(tmp, devBridgeLockfilePath());
+}
 function claimDaemonLockfile(data) {
   ensureSootsimHome();
   const existing = readDaemonLockfile();
@@ -10668,7 +10726,13 @@ function removeDaemonLockfile() {
   } catch {
   }
 }
-var import_node_fs2, import_node_os, import_node_path, SOOTSIM_HOME_ENV, ACTIVE_RUNTIME_FILE, DAEMON_LOCKFILE, CONFIG_FILE, DAEMON_HEARTBEAT_STALE_MS, DAEMON_LOCKFILE_MAX_BYTES;
+function removeDevBridgeLockfile() {
+  try {
+    import_node_fs2.default.unlinkSync(devBridgeLockfilePath());
+  } catch {
+  }
+}
+var import_node_fs2, import_node_os, import_node_path, SOOTSIM_HOME_ENV, ACTIVE_RUNTIME_FILE, DAEMON_LOCKFILE, DEV_BRIDGE_LOCKFILE, CONFIG_FILE, DAEMON_HEARTBEAT_STALE_MS, DAEMON_LOCKFILE_MAX_BYTES;
 var init_home_paths = __esm({
   "src/home-paths.ts"() {
     "use strict";
@@ -10678,6 +10742,7 @@ var init_home_paths = __esm({
     SOOTSIM_HOME_ENV = "SOOTSIM_HOME";
     ACTIVE_RUNTIME_FILE = "active";
     DAEMON_LOCKFILE = "daemon.json";
+    DEV_BRIDGE_LOCKFILE = "dev-bridge.json";
     CONFIG_FILE = "config.json";
     DAEMON_HEARTBEAT_STALE_MS = 3e4;
     DAEMON_LOCKFILE_MAX_BYTES = 16 * 1024;
@@ -12860,10 +12925,12 @@ var init_bridge_host = __esm({
       maxConcurrentAutomationSims;
       automationSimActiveGraceMs;
       shouldWriteLockfile;
+      shouldWriteDevLockfile;
       sootbeanOrigin = null;
       effectivePort = 0;
       startedAt = 0;
       heartbeatTimer = null;
+      devHeartbeatTimer = null;
       // ws-level heartbeat: sims that hang up uncleanly (page navigated, network
       // dropped, sim crashed) leave their server-side WebSocket sitting "open"
       // forever. ping every WS_HEARTBEAT_INTERVAL_MS; if the previous round's
@@ -12890,6 +12957,7 @@ var init_bridge_host = __esm({
         this.preferredPort = opts.port || DEFAULT_SOOTSIM_BRIDGE_PORT;
         this.port = this.preferredPort;
         this.shouldWriteLockfile = opts.writeLockfile === true;
+        this.shouldWriteDevLockfile = opts.writeDevLockfile === true;
         this.portFallbackCount = Math.max(1, opts.portFallbackCount ?? 10);
         this.openUrlHandler = opts.openUrl;
         this.agentHost = new AgentHost({ getExcludePorts: opts.agentScanExcludes });
@@ -13407,7 +13475,7 @@ var init_bridge_host = __esm({
           });
         });
       }
-      /** after a successful bind: start the cli idle sweep, write the daemon
+      /** after a successful bind: start the cli idle sweep, write the daemon/dev
        *  lockfile (if this host owns it), seed the agent host, kick off the
        *  heartbeat loop. idempotent across rebinds because close() tears down
        *  every timer and the lockfile. */
@@ -13449,6 +13517,23 @@ var init_bridge_host = __esm({
           this.heartbeatTimer.unref();
           this.startRuntimeUpdater();
         }
+        if (this.shouldWriteDevLockfile) {
+          try {
+            this.writeDevLockfileSnapshot();
+          } catch (err) {
+            process.stderr.write(
+              `ws bridge failed to write dev bridge lockfile: ${String(err)}
+`
+            );
+          }
+          this.devHeartbeatTimer = setInterval(() => {
+            try {
+              this.writeDevLockfileSnapshot();
+            } catch {
+            }
+          }, DAEMON_HEARTBEAT_INTERVAL_MS);
+          this.devHeartbeatTimer.unref();
+        }
         void this.agentHost.seedOnBoot();
       }
       bootstrapping = true;
@@ -13466,9 +13551,25 @@ var init_bridge_host = __esm({
           bootstrapping: this.bootstrapping
         };
       }
+      buildDevLockfileSnapshot() {
+        return {
+          schema: 1,
+          pid: process.pid,
+          platform: process.platform,
+          bridgePort: this.effectivePort,
+          runtimePort: this.effectivePort,
+          cwd: process.cwd(),
+          startedAt: this.startedAt,
+          heartbeatAt: Date.now(),
+          source: "vite-dev"
+        };
+      }
       writeLockfileSnapshot() {
         writeDaemonLockfile(this.buildLockfileSnapshot());
       }
+      writeDevLockfileSnapshot() {
+        writeDevBridgeLockfile(this.buildDevLockfileSnapshot());
+      }
       refreshActiveRuntime() {
         this.activeRuntimeVersion = readActiveRuntime();
         this.activeRuntimeDirPath = activeRuntimeDir();
@@ -13704,6 +13805,7 @@ var init_bridge_host = __esm({
               bridgePort: this.effectivePort,
               runtimePort: this.effectivePort,
               activeRuntime: this.activeRuntimeVersion,
+              bridgeSource: this.shouldWriteDevLockfile ? "vite-dev" : this.shouldWriteLockfile ? "daemon" : "embedded",
               startedAt: this.startedAt,
               uptimeMs: this.startedAt > 0 ? Date.now() - this.startedAt : 0
             })
@@ -14085,6 +14187,10 @@ var init_bridge_host = __esm({
           clearInterval(this.heartbeatTimer);
           this.heartbeatTimer = null;
         }
+        if (this.devHeartbeatTimer) {
+          clearInterval(this.devHeartbeatTimer);
+          this.devHeartbeatTimer = null;
+        }
         if (this.wsHeartbeatTimer) {
           clearInterval(this.wsHeartbeatTimer);
           this.wsHeartbeatTimer = null;
@@ -14099,6 +14205,12 @@ var init_bridge_host = __esm({
           } catch {
           }
         }
+        if (this.shouldWriteDevLockfile) {
+          try {
+            removeDevBridgeLockfile();
+          } catch {
+          }
+        }
         this.effectivePort = 0;
         this.startedAt = 0;
         this.agentHost.close();
@@ -14708,6 +14820,10 @@ __export(ws_bridge_exports, {
   resolveDefaultBridgePort: () => resolveDefaultBridgePort
 });
 function resolveDefaultBridgePort() {
+  if (shouldSkipPersistentDaemon()) {
+    const dev = readDevBridgeLockfile();
+    if (dev && isDevBridgeLockfileFresh(dev)) return dev.bridgePort;
+  }
   const lock = readDaemonLockfile();
   if (lock && isDaemonLockfileFresh(lock)) return lock.bridgePort;
   return DEFAULT_SOOTSIM_BRIDGE_PORT;
@@ -17986,7 +18102,7 @@ var skill = {
         const { chromium } = await import("playwright");
         const path9 = await import("path");
         const fs9 = await import("fs");
-        const browser = await chromium.launch({ headless: true });
+        const browser = await chromium.launch({ channel: "chrome", headless: true });
         const page = await browser.newPage({ viewport: { width: 500, height: 900 } });
         try {
           await page.goto(context.url, { waitUntil: "networkidle" });
@@ -18161,7 +18277,7 @@ var skill3 = {
         const { chromium } = await import("playwright");
         const path9 = await import("path");
         const fs9 = await import("fs");
-        const browser = await chromium.launch({ headless: true });
+        const browser = await chromium.launch({ channel: "chrome", headless: true });
         const page = await browser.newPage({ viewport: { width: 500, height: 900 } });
         try {
           await page.goto(context.url, { waitUntil: "networkidle" });
@@ -18220,7 +18336,7 @@ var skill4 = {
         const { chromium } = await import("playwright");
         const path9 = await import("path");
         const fs9 = await import("fs");
-        const browser = await chromium.launch({ headless: true });
+        const browser = await chromium.launch({ channel: "chrome", headless: true });
         const page = await browser.newPage({ viewport: { width: 500, height: 900 } });
         try {
           await page.goto(context.url, { waitUntil: "networkidle" });
@@ -18371,7 +18487,7 @@ var skill6 = {
         const { chromium } = await import("playwright");
         const path9 = await import("path");
         const fs9 = await import("fs");
-        const browser = await chromium.launch({ headless: true });
+        const browser = await chromium.launch({ channel: "chrome", headless: true });
         const page = await browser.newPage({ viewport: { width: 500, height: 900 } });
         try {
           await page.goto(context.url, { waitUntil: "networkidle" });

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! sootsim v0.1.168 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! sootsim v0.1.170 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -74,7 +74,7 @@ function readActiveRuntime() {
 var DAEMON_LOCKFILE_MAX_BYTES = 16 * 1024;
 
 // src/runtime-assets.ts
-var SOOTSIM_RUNTIME_MISSING_MESSAGE = "[sootsim] no engine runtime installed \u2014 run `sootsim setup-repo` in your project, or `sootsim runtime install`";
+var SOOTSIM_RUNTIME_MISSING_MESSAGE = "[sootsim] no engine runtime installed \u2014 run `sootsim setup`, or `sootsim runtime install`";
 var MIME_TYPES = {
   ".js": "application/javascript",
   ".mjs": "application/javascript",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sootsim",
-  "version": "0.1.168",
+  "version": "0.1.170",
   "description": "sootsim CLI + vite/metro plugins + skills registry. bridge client for driving the proprietary sootsim-engine over WebSocket.",
   "author": "Tamagui LLC",
   "license": "MIT",
@@ -132,6 +132,7 @@
     "dist-cli/",
     "dist-lib/",
     "src/",
+    "skills/",
     "scripts/dev-server-scanner.ts",
     "scripts/optional-demo-registry.ts",
     "detox/",

package/scripts/dev-server-scanner.ts

@@ -556,15 +556,14 @@ export interface ScanOptions {
 }
 
 function isSootSelfServer(server: DiscoveredServer): boolean {
-  const projectName = server.projectName?.trim().toLowerCase()
-  if (projectName === 'soot' || projectName === 'sootsim') return true
-
   const bundleId = server.bundleId?.trim().toLowerCase()
-  if (bundleId?.startsWith('dev.soot')) return true
+  if (bundleId?.startsWith('dev.sootsim.')) return true
 
   return false
 }
 
+export const __isSootSelfServerForTests = isSootSelfServer
+
 // per-(port, pid) probe cache. as long as the same process still owns the
 // port, its signature endpoints can't have changed, so we return the cached
 // result without issuing any HTTP. negative results (null) are cached too,

package/scripts/postinstall.cjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 // postinstall — best-effort runtime install after `npm i -g sootsim`.
 //
-// runs as a child of npm. failures here are non-fatal: any first invocation
-// of the CLI will retry the install via auto-bootstrap.
+// runs as a child of npm. failures here are non-fatal; setup/open/runtime
+// commands can install the runtime later.
 //
 // skipped when running as root via sudo: $HOME would be /root, but the user
 // who actually wants the runtime probably isn't root. their first sootsim

package/scripts/preuninstall.cjs

@@ -11,8 +11,8 @@
 // reliability: npm preuninstall hooks are best-effort — they don't fire when
 // the package wasn't installed by npm (yarn/bun/pnpm have their own lifecycle
 // rules), and they don't run as part of `npm cache verify` cleanup or manual
-// dir removal. that's why we also document `sootsim daemon uninstall` as the
-// manual fallback and show a hint pointing at it.
+// dir removal. that's why `sootsim daemon uninstall` is also documented as
+// the manual teardown path.
 //
 // strategy: spawn the bundled bin to run `daemon uninstall` (single source of
 // truth — the same logic the user invokes manually). if that fails for any
@@ -73,17 +73,15 @@ function rawCleanup() {
   const home = sootsimHomeDir()
   if (process.platform === 'darwin') {
     safeSpawn('launchctl', ['bootout', `gui/${getuid()}/dev.sootsim.daemon`])
-    safeSpawn('launchctl', ['bootout', `gui/${getuid()}/dev.sootsim.server`])
     safeRemove(path.join(os.homedir(), 'Library/LaunchAgents/dev.sootsim.daemon.plist'))
-    safeRemove(path.join(os.homedir(), 'Library/LaunchAgents/dev.sootsim.server.plist'))
     safeRemove(path.join(os.homedir(), 'Library/Logs/sootsim'), {
       recursive: true,
     })
   } else if (process.platform === 'linux') {
-    safeSpawn('systemctl', ['--user', 'disable', '--now', 'sootsim-server'])
+    safeSpawn('systemctl', ['--user', 'disable', '--now', 'sootsim-daemon'])
     safeSpawn('systemctl', ['--user', 'daemon-reload'])
-    safeSpawn('systemctl', ['--user', 'reset-failed', 'sootsim-server'])
-    safeRemove(path.join(os.homedir(), '.config/systemd/user/sootsim-server.service'))
+    safeSpawn('systemctl', ['--user', 'reset-failed', 'sootsim-daemon'])
+    safeRemove(path.join(os.homedir(), '.config/systemd/user/sootsim-daemon.service'))
     safeRemove(path.join(os.homedir(), '.local/state/sootsim'), { recursive: true })
   }
   // ~/.sootsim is the same on every platform; honor $SOOTSIM_HOME.