@stigmer/cli 3.12.9 → 3.13.0

package/local/runtime/node.js

@@ -1,4 +1,5 @@
-// Resolution of the Node.js runtime used to launch the runner subprocess.
+// Resolution of the Node.js runtime used to launch the runner and TS-server
+// subprocesses.
 //
 // We reuse the very Node that is running the CLI (process.execPath). The CLI is
 // itself an npm package with `engines: node >= 22.13`, so a suitable Node is
@@ -8,16 +9,26 @@
 // (`spawn(process.execPath, ...)`). An explicit STIGMER_NODE_BIN override is
 // honored and capability-checked for advanced/multi-runtime setups.
 //
-// The gate is a CAPABILITY probe, not a version check. The runner's durable
-// local checkpointer imports Node's built-in `node:sqlite`, available unflagged
-// from 22.13 in the 22.x line and only from 23.4 in the 23.x line — a gap
-// (23.0–23.3) that a previous version-table gate here missed, letting those
-// Nodes through to crash at runner boot with a raw ERR_UNKNOWN_BUILTIN_MODULE.
-// Probing "can this binary provide node:sqlite?" directly cannot drift; the
-// version floors survive only in the error message, where staleness is
-// harmless. The runner performs the same probe on its own boot (see
-// backend/services/runner/src/preflight.ts) — this one exists to fail at
-// resolve time with CLI-appropriate guidance instead of a subprocess crash.
+// The gates are CAPABILITY probes, not version checks. Two probes, because the
+// two children need different sqlite capabilities:
+//
+// - The RUNNER's durable local checkpointer imports Node's built-in
+//   `node:sqlite`, available unflagged from 22.13 in the 22.x line and only
+//   from 23.4 in the 23.x line — a gap (23.0–23.3) that a previous
+//   version-table gate here missed, letting those Nodes through to crash at
+//   runner boot with a raw ERR_UNKNOWN_BUILTIN_MODULE.
+// - The SERVER additionally needs `node:sqlite` compiled WITH FTS5 (its
+//   search index; migration v3 creates an fts5 virtual table at boot). Node
+//   23.4 PROVIDES node:sqlite but its sqlite build LACKS FTS5 — found by
+//   D4 #14 and the reason the module-presence probe alone is insufficient
+//   for the server. Probing "can this binary create an fts5 table?" directly
+//   cannot drift; the version floors survive only in the error messages,
+//   where staleness is harmless.
+//
+// The runner performs the module-presence probe on its own boot (see
+// backend/services/runner/src/preflight.ts); the server fails at migration
+// time. Both probes here exist to fail at resolve time with CLI-appropriate
+// guidance instead of a subprocess crash.
 import { execFileSync } from "node:child_process";
 import { CliExitError } from "../../errors/cli-exit-error.js";
 import { ExitCode } from "../../errors/exit-codes.js";
@@ -35,6 +46,14 @@ import { ExitCode } from "../../errors/exit-codes.js";
 //   own runtime: `getBuiltinModule` loads the module, which on 22.x emits an
 //   `ExperimentalWarning` on stderr that must not leak into the CLI's output.
 const NODE_SQLITE_PROBE = "process.exit(process.getBuiltinModule?.('node:sqlite') === undefined ? 1 : 0)";
+// Exits 0 when the binary's `node:sqlite` can create an FTS5 virtual table,
+// 1 otherwise. Strictly stronger than NODE_SQLITE_PROBE: it exercises the
+// exact operation the server's migration v3 performs, in memory. The
+// try/catch covers both failure shapes — module absent (TypeError on the
+// undefined module) and FTS5 absent (the exec throws "no such module: fts5").
+const NODE_SQLITE_FTS5_PROBE = "try{const{DatabaseSync}=process.getBuiltinModule('node:sqlite');" +
+    "new DatabaseSync(':memory:').exec('CREATE VIRTUAL TABLE t USING fts5(x)');" +
+    "process.exit(0)}catch{process.exit(1)}";
 /**
  * Resolve the Node binary to launch the runner with. Honors STIGMER_NODE_BIN;
  * otherwise returns the current runtime. Either way the binary is probed for
@@ -43,11 +62,47 @@ const NODE_SQLITE_PROBE = "process.exit(process.getBuiltinModule?.('node:sqlite'
  * runner-launch paths only (ensureRunner), never on ordinary CLI commands.
  */
 export function resolveNode() {
-    const override = process.env.STIGMER_NODE_BIN;
-    const bin = override !== undefined && override !== "" ? override : process.execPath;
-    assertProvidesNodeSqlite(bin);
+    const bin = nodeCandidate();
+    assertCapability(bin, NODE_SQLITE_PROBE, {
+        subject: "the runner",
+        capability: "the built-in node:sqlite module",
+        floor: "Node >= 22.13 (>= 23.4 in the 23.x line)",
+        detail: [
+            "The runner's durable checkpointer requires node:sqlite, which is available",
+            "unflagged from Node 22.13 (22.x line) and 23.4 (23.x and later) — note that",
+            "23.0-23.3 lack it.",
+        ],
+    });
     return bin;
 }
+/**
+ * Resolve the Node binary to launch the TS server with. Same
+ * STIGMER_NODE_BIN/execPath resolution as {@link resolveNode}, but probes for
+ * `node:sqlite` WITH FTS5 — the server's search index needs it and some Node
+ * builds (e.g. 23.4) ship node:sqlite without it. Runs on server-launch paths
+ * only (ensureServer).
+ */
+export function resolveServerNode() {
+    const bin = nodeCandidate();
+    assertCapability(bin, NODE_SQLITE_FTS5_PROBE, {
+        subject: "the stigmer server",
+        capability: "the built-in node:sqlite module with FTS5",
+        floor: "Node 22.13+ in the 22.x line (23.x builds lack FTS5)",
+        detail: [
+            "The server's search index requires node:sqlite compiled with FTS5.",
+            "The 22.x line from 22.13 is known-good; 23.x builds ship node:sqlite",
+            "WITHOUT FTS5 and cannot run the server. Newer majors work if their",
+            "sqlite build includes FTS5 — this probe is the authority.",
+        ],
+    });
+    return bin;
+}
+function nodeCandidate() {
+    const override = process.env.STIGMER_NODE_BIN;
+    return override !== undefined && override !== ""
+        ? override
+        : process.execPath;
+}
 /** Best-effort `--version` for error messages only; null when the spawn fails. */
 function probeNodeVersion(bin) {
     try {
@@ -61,10 +116,10 @@ function probeNodeVersion(bin) {
         return null;
     }
 }
-function assertProvidesNodeSqlite(bin) {
+function assertCapability(bin, probe, copy) {
     let exitStatus;
     try {
-        execFileSync(bin, ["-e", NODE_SQLITE_PROBE], { stdio: "ignore" });
+        execFileSync(bin, ["-e", probe], { stdio: "ignore" });
         return;
     }
     catch (err) {
@@ -73,15 +128,11 @@ function assertProvidesNodeSqlite(bin) {
         exitStatus = err.status ?? null;
     }
     if (exitStatus === null) {
-        throw new CliExitError(`could not run ${bin} to verify the runner's Node requirements`, ExitCode.General, [
-            `Ensure ${bin} is a working Node >= 22.13 runtime (>= 23.4 in the 23.x line).`,
-        ]);
+        throw new CliExitError(`could not run ${bin} to verify ${copy.subject}'s Node requirements`, ExitCode.General, [`Ensure ${bin} is a working ${copy.floor} runtime.`]);
     }
     const version = probeNodeVersion(bin) ?? "unknown version";
-    throw new CliExitError(`Node at ${bin} (${version}) cannot run the runner: it does not provide the built-in node:sqlite module`, ExitCode.General, [
-        "The runner's durable checkpointer requires node:sqlite, which is available",
-        "unflagged from Node 22.13 (22.x line) and 23.4 (23.x and later) — note that",
-        "23.0-23.3 lack it.",
+    throw new CliExitError(`Node at ${bin} (${version}) cannot run ${copy.subject}: it does not provide ${copy.capability}`, ExitCode.General, [
+        ...copy.detail,
         "Upgrade Node, or point STIGMER_NODE_BIN at a suitable runtime.",
     ]);
 }

package/local/runtime/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/local/runtime/node.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,0EAA0E;AAC1E,iFAAiF;AACjF,yEAAyE;AACzE,6EAA6E;AAC7E,oEAAoE;AACpE,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,0EAA0E;AAC1E,4EAA4E;AAC5E,+EAA+E;AAC/E,4EAA4E;AAC5E,uEAAuE;AACvE,oEAAoE;AACpE,yEAAyE;AACzE,4EAA4E;AAE5E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,+DAA+D;AAC/D,EAAE;AACF,wEAAwE;AACxE,uEAAuE;AACvE,+EAA+E;AAC/E,2EAA2E;AAC3E,4CAA4C;AAC5C,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,MAAM,iBAAiB,GACrB,+EAA+E,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC9C,MAAM,GAAG,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACpF,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kFAAkF;AAClF,SAAS,gBAAgB,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE;YAC3C,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAW;IAC3C,IAAI,UAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oEAAoE;QACpE,qDAAqD;QACrD,UAAU,GAAI,GAAkC,CAAC,MAAM,IAAI,IAAI,CAAC;IAClE,CAAC;IAED,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,YAAY,CAAC,iBAAiB,GAAG,2CAA2C,EAAE,QAAQ,CAAC,OAAO,EAAE;YACxG,UAAU,GAAG,iEAAiE;SAC/E,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC;IAC3D,MAAM,IAAI,YAAY,CACpB,WAAW,GAAG,KAAK,OAAO,8EAA8E,EACxG,QAAQ,CAAC,OAAO,EAChB;QACE,4EAA4E;QAC5E,6EAA6E;QAC7E,oBAAoB;QACpB,gEAAgE;KACjE,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/local/runtime/node.ts"],"names":[],"mappings":"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"}

package/local/runtime/runner.d.ts

@@ -1,3 +1,4 @@
+import { type NpmInstall } from "./runtimes-install.js";
 /** Everything needed to spawn the runner subprocess. */
 export interface RunnerResolution {
     /** Node binary to launch with. */
@@ -14,7 +15,7 @@ export interface EnsureRunnerOptions {
     /** Node resolver (injectable for tests). */
     node?: () => string;
     /** npm install implementation (injectable for tests). */
-    install?: (installDir: string, spec: string) => void;
+    install?: NpmInstall;
 }
 /**
  * Ensure a launchable runner, acquiring `@stigmer/runner-slim` on demand if no

package/local/runtime/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/local/runtime/runner.ts"],"names":[],"mappings":"AAiCA,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;IACpB,yDAAyD;IACzD,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,gBAAgB,CAK7E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAM,MAAoB,GAAG,gBAAgB,GAAG,IAAI,CAiBvF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,mBAAwB,GAAG,gBAAgB,CAmC9E"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/local/runtime/runner.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAmE,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIzH,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;IACpB,yDAAyD;IACzD,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,gBAAgB,CAK7E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAM,MAAoB,GAAG,gBAAgB,GAAG,IAAI,CAiBvF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,mBAAwB,GAAG,gBAAgB,CA6B9E"}

package/local/runtime/runner.js

@@ -16,8 +16,7 @@
 // optionalDependencies/os/cpu — ~85 MB instead of the full ~508 MB install. The
 // launch contract (`node main.js`) is identical to the repo-tree runner, so the
 // daemon spawns either the same way.
-import { execFileSync } from "node:child_process";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -27,6 +26,7 @@ import { log } from "../../logger.js";
 import { VERSION } from "../../version.js";
 import { runtimesDir } from "../paths.js";
 import { resolveNode } from "./node.js";
+import { ensureRuntimesRoot, isAcquirableRelease, npmInstallIntoRuntimes } from "./runtimes-install.js";
 const SLIM_PACKAGE = "@stigmer/runner-slim";
 /**
  * Ensure a launchable runner, acquiring `@stigmer/runner-slim` on demand if no
@@ -85,11 +85,8 @@ export function acquireRunner(opts = {}) {
     const entryPath = join(installDir, "node_modules", "@stigmer", "runner-slim", "main.js");
     if (!existsSync(entryPath)) {
         log.info(`acquiring ${SLIM_PACKAGE}`, { version, dir: installDir });
-        mkdirSync(installDir, { recursive: true });
-        // A stable package.json root makes the install deterministic and records the
-        // pinned dependency rather than letting npm synthesize an ad-hoc root.
-        writeFileSync(join(installDir, "package.json"), `${JSON.stringify({ name: "stigmer-runtime", private: true, version: "0.0.0" }, null, 2)}\n`);
-        const install = opts.install ?? installRunnerSlim;
+        ensureRuntimesRoot(installDir);
+        const install = opts.install ?? npmInstallIntoRuntimes;
         install(installDir, `${SLIM_PACKAGE}@${version}`);
     }
     if (!existsSync(entryPath)) {
@@ -100,24 +97,6 @@ export function acquireRunner(opts = {}) {
     }
     return { nodeBin: node(), entryPath, appDir: dirname(entryPath) };
 }
-// Install the slim package (plus its platform-native optional dependency) into an
-// isolated prefix. `--omit=dev` drops devDependencies while keeping the optional
-// native package npm selects by os/cpu; output is inherited so the user sees the
-// one-time download progress.
-function installRunnerSlim(installDir, spec) {
-    try {
-        execFileSync("npm", ["install", spec, "--prefix", installDir, "--omit=dev", "--no-audit", "--no-fund"], {
-            stdio: "inherit",
-        });
-    }
-    catch (err) {
-        throw new CliExitError(`failed to install ${spec}`, ExitCode.General, [
-            `Command: npm install ${spec} --prefix ${installDir}`,
-            "Ensure npm is on PATH and the network is reachable.",
-            String(err),
-        ]);
-    }
-}
 function resolveBuiltRunner(appDir, node) {
     const entryPath = join(appDir, "dist", "main.js");
     if (!existsSync(entryPath)) {
@@ -129,12 +108,6 @@ function resolveBuiltRunner(appDir, node) {
     }
     return { nodeBin: node(), entryPath, appDir };
 }
-// A source build reports "0.0.0-dev" and the dev npm channel stamps "<v>-dev.<stamp>"
-// versions; neither publishes a matching @stigmer/runner-slim, so they are not
-// acquirable. Release and rc/next versions are.
-function isAcquirableRelease(version) {
-    return !version.includes("-dev");
-}
 function hasPackageJson(dir) {
     return existsSync(join(dir, "package.json"));
 }

package/local/runtime/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/local/runtime/runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/local/runtime/runner.ts"],"names":[],"mappings":"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"}

package/local/runtime/runtimes-install.d.ts

@@ -0,0 +1,13 @@
+/** The install implementation, injectable for tests. */
+export type NpmInstall = (installDir: string, spec: string) => void;
+/**
+ * Ensure the per-version install root exists with a stable package.json.
+ * A stable root makes installs deterministic and records the pinned
+ * dependencies rather than letting npm synthesize an ad-hoc root; both the
+ * runner and the server packages install into this one root, so the file is
+ * written once and shared.
+ */
+export declare function ensureRuntimesRoot(installDir: string): void;
+export declare function npmInstallIntoRuntimes(installDir: string, spec: string): void;
+export declare function isAcquirableRelease(version: string): boolean;
+//# sourceMappingURL=runtimes-install.d.ts.map

package/local/runtime/runtimes-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimes-install.d.ts","sourceRoot":"","sources":["../../../src/local/runtime/runtimes-install.ts"],"names":[],"mappings":"AAYA,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAS3D;AAMD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA2B7E;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/local/runtime/runtimes-install.js

@@ -0,0 +1,60 @@
+// Shared npm-install mechanics for on-demand-acquired runtime packages
+// (~/.stigmer/runtimes/<version>/). Extracted when the TS server became the
+// second consumer (D4 #24) — the runner and the server acquire different
+// packages into the SAME per-version install root, so the root bootstrap and
+// the install invocation must not drift between them.
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliExitError } from "../../errors/cli-exit-error.js";
+import { ExitCode } from "../../errors/exit-codes.js";
+/**
+ * Ensure the per-version install root exists with a stable package.json.
+ * A stable root makes installs deterministic and records the pinned
+ * dependencies rather than letting npm synthesize an ad-hoc root; both the
+ * runner and the server packages install into this one root, so the file is
+ * written once and shared.
+ */
+export function ensureRuntimesRoot(installDir) {
+    mkdirSync(installDir, { recursive: true });
+    const rootManifest = join(installDir, "package.json");
+    if (!existsSync(rootManifest)) {
+        writeFileSync(rootManifest, `${JSON.stringify({ name: "stigmer-runtime", private: true, version: "0.0.0" }, null, 2)}\n`);
+    }
+}
+// Install a package (plus its platform-native optional dependency) into an
+// isolated prefix. `--omit=dev` drops devDependencies while keeping the
+// optional native package npm selects by os/cpu; output is inherited so the
+// user sees the one-time download progress.
+export function npmInstallIntoRuntimes(installDir, spec) {
+    try {
+        execFileSync("npm", [
+            "install",
+            spec,
+            "--prefix",
+            installDir,
+            "--omit=dev",
+            "--no-audit",
+            "--no-fund",
+        ], {
+            stdio: "inherit",
+        });
+    }
+    catch (err) {
+        throw new CliExitError(`failed to install ${spec}`, ExitCode.General, [
+            `Command: npm install ${spec} --prefix ${installDir}`,
+            "Ensure npm is on PATH and the network is reachable.",
+            "If npm reported EBADENGINE, this Node line is outside the package's",
+            "supported range. If a previous install was interrupted, remove",
+            `${installDir} and retry.`,
+            String(err),
+        ]);
+    }
+}
+// A source build reports "0.0.0-dev" and the dev npm channel stamps
+// "<v>-dev.<stamp>" versions; neither publishes matching runtime packages,
+// so they are not acquirable. Release and rc/next versions are.
+export function isAcquirableRelease(version) {
+    return !version.includes("-dev");
+}
+//# sourceMappingURL=runtimes-install.js.map

package/local/runtime/runtimes-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimes-install.js","sourceRoot":"","sources":["../../../src/local/runtime/runtimes-install.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,4EAA4E;AAC5E,yEAAyE;AACzE,6EAA6E;AAC7E,sDAAsD;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAKtD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,aAAa,CACX,YAAY,EACZ,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,wEAAwE;AACxE,4EAA4E;AAC5E,4CAA4C;AAC5C,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,IAAY;IACrE,IAAI,CAAC;QACH,YAAY,CACV,KAAK,EACL;YACE,SAAS;YACT,IAAI;YACJ,UAAU;YACV,UAAU;YACV,YAAY;YACZ,YAAY;YACZ,WAAW;SACZ,EACD;YACE,KAAK,EAAE,SAAS;SACjB,CACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CAAC,qBAAqB,IAAI,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE;YACpE,wBAAwB,IAAI,aAAa,UAAU,EAAE;YACrD,qDAAqD;YACrD,qEAAqE;YACrE,gEAAgE;YAChE,GAAG,UAAU,aAAa;YAC1B,MAAM,CAAC,GAAG,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,2EAA2E;AAC3E,gEAAgE;AAChE,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/local/runtime/server.d.ts

@@ -1,39 +1,35 @@
-/**
- * Find an already-present `stigmer-server` binary, or null. Pure: never
- * downloads. `home` is injectable for tests.
- */
-export declare function resolveServerBinary(home?: string): string | null;
+import type { ServerLaunch } from "../daemon/env.js";
+import { type NpmInstall } from "./runtimes-install.js";
 export interface EnsureServerOptions {
     home?: string;
-    /** Release version to download if needed (defaults to the CLI's own version). */
+    /** Release version of the slim server to acquire (defaults to the CLI version). */
     version?: string;
-    /** Override the fetch implementation (tests). */
-    fetchImpl?: typeof fetch;
+    /** Node resolver (injectable for tests). */
+    node?: () => string;
+    /** npm install implementation (injectable for tests). */
+    install?: NpmInstall;
 }
 /**
- * Ensure a `stigmer-server` binary is available, returning its path. Reuses an
- * existing binary if found; otherwise downloads the pinned release asset into
- * ~/.stigmer/bin (checksum-verified). Throws actionable guidance when no binary
- * exists and a download is not possible (a source/dev build, or an unsupported
- * platform).
+ * Resolve what the daemon launches as `stigmer-server`: the explicit
+ * STIGMER_SERVER_DIR override, then the repo tree, then acquiring the
+ * published slim package. Throws actionable guidance on a missing build, an
+ * invalid override, or a non-release CLI build with nothing local.
  */
-export declare function ensureServerBinary(opts?: EnsureServerOptions): Promise<string>;
-export interface ServerDownloadTarget {
-    /** Release version, e.g. "0.5.0" or "0.5.0-rc.1" (with or without a leading "v"). */
-    version: string;
-    /** Absolute path to write the extracted `stigmer-server` binary to. */
-    binPath: string;
-    /** Node platform (defaults to process.platform). */
-    platform?: NodeJS.Platform;
-    /** Node arch (defaults to process.arch). */
-    arch?: string;
-    /** Override the fetch implementation (tests). */
-    fetchImpl?: typeof fetch;
-}
+export declare function ensureServer(opts?: EnsureServerOptions): ServerLaunch;
+/**
+ * Resolve a repo-tree TS server (dev) or an explicit STIGMER_SERVER_DIR, or
+ * null when neither is present (the caller then acquires the slim package).
+ * Throws when an override is set but invalid, or when a found server is not
+ * built — both are actionable user-facing conditions, not a reason to
+ * silently download. `node` is injectable for tests.
+ */
+export declare function resolveServerTs(node?: () => string): ServerLaunch | null;
 /**
- * Download, checksum-verify, and install the standalone `stigmer-server` release
- * asset. Throws a {@link CliExitError} on an unsupported platform or any
- * network/checksum/extraction failure.
+ * Acquire the published `@stigmer/server-slim@<version>` into
+ * ~/.stigmer/runtimes/<version>/ (idempotent: reuses a prior install; shares
+ * the install root with the runner's package) and resolve its `main.js`
+ * entry. The version is pinned to the CLI's own version so the server's
+ * protos and behavior stay in lockstep with the CLI and the runner.
  */
-export declare function downloadServerBinary(target: ServerDownloadTarget): Promise<void>;
+export declare function acquireServer(opts?: EnsureServerOptions): ServerLaunch;
 //# sourceMappingURL=server.d.ts.map

package/local/runtime/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/local/runtime/server.ts"],"names":[],"mappings":"AAsCA;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,GAAG,IAAI,CAK3E;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxF;AAED,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBtF"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/local/runtime/server.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;IACpB,yDAAyD;IACzD,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,mBAAwB,GAAG,YAAY,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,IAAI,GAAE,MAAM,MAA0B,GACrC,YAAY,GAAG,IAAI,CAqBrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,mBAAwB,GAAG,YAAY,CAmD1E"}