@camstack/agent 1.1.49 → 1.1.51

package/dist/cli.mjs

@@ -2,8 +2,8 @@
 import { createRequire as __cr } from 'node:module'; const require = globalThis.require ?? __cr(import.meta.url);
 import {
   startAgent
-} from "./chunk-P6AJ6S7H.mjs";
-import "./chunk-Y6BUFOWG.mjs";
+} from "./chunk-67UOSAWB.mjs";
+import "./chunk-KPUXW5YX.mjs";
 
 // src/cli.ts
 import { existsSync } from "fs";
@@ -122,23 +122,35 @@ if (args.statusPort && !process.env["CAMSTACK_STATUS_PORT"]) {
   process.env["CAMSTACK_STATUS_PORT"] = args.statusPort;
 }
 if (!process.env["CAMSTACK_FRAMEWORK_DIR"]) {
-  const scriptPath = process.argv[1];
-  if (scriptPath) {
-    const frameworkDir = path.resolve(path.dirname(scriptPath), "..", "..");
+  const isFrameworkDir = (dir) => existsSync(path.join(dir, "node_modules", "@camstack", "shm-ring")) && existsSync(path.join(dir, "node_modules", "@camstack", "system"));
+  const discoverFrameworkDir = () => {
+    const activeRoot = process.env["CAMSTACK_AGENT_ACTIVE_ROOT"];
+    if (activeRoot && isFrameworkDir(activeRoot)) return activeRoot;
+    const scriptPath = process.argv[1];
+    if (!scriptPath) return null;
+    let dir = path.dirname(scriptPath);
+    for (let depth = 0; depth < 8; depth++) {
+      if (isFrameworkDir(dir)) return dir;
+      const parent = path.dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+    return null;
+  };
+  const frameworkDir = discoverFrameworkDir();
+  if (frameworkDir) {
     const frameworkModules = path.join(frameworkDir, "node_modules");
-    if (existsSync(path.join(frameworkModules, "@camstack", "shm-ring"))) {
-      process.env["CAMSTACK_FRAMEWORK_DIR"] = frameworkDir;
-      const existingNodePath = process.env["NODE_PATH"];
-      process.env["NODE_PATH"] = existingNodePath ? `${frameworkModules}${path.delimiter}${existingNodePath}` : frameworkModules;
-      nodeModule._initPaths();
-      console.log(
-        `[Agent] Self-contained framework detected \u2014 CAMSTACK_FRAMEWORK_DIR=${frameworkDir}`
-      );
-      if (!process.env["CAMSTACK_BUNDLED_ADDONS_DIR"]) {
-        const bundledAddons = path.join(frameworkDir, "addons");
-        if (existsSync(bundledAddons)) {
-          process.env["CAMSTACK_BUNDLED_ADDONS_DIR"] = bundledAddons;
-        }
+    process.env["CAMSTACK_FRAMEWORK_DIR"] = frameworkDir;
+    const existingNodePath = process.env["NODE_PATH"];
+    process.env["NODE_PATH"] = existingNodePath ? `${frameworkModules}${path.delimiter}${existingNodePath}` : frameworkModules;
+    nodeModule._initPaths();
+    console.log(
+      `[Agent] Self-contained framework detected \u2014 CAMSTACK_FRAMEWORK_DIR=${frameworkDir}`
+    );
+    if (!process.env["CAMSTACK_BUNDLED_ADDONS_DIR"]) {
+      const bundledAddons = path.join(frameworkDir, "addons");
+      if (existsSync(bundledAddons)) {
+        process.env["CAMSTACK_BUNDLED_ADDONS_DIR"] = bundledAddons;
       }
     }
   }

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CamStack Agent CLI — starts a remote agent node that connects to a hub.\n *\n * Usage:\n *   camstack-agent --hub 192.168.1.100\n *   camstack-agent --hub 192.168.1.100 --name gpu-box --data ./agent-data\n *   CAMSTACK_HUB_ADDRESS=192.168.1.100 camstack-agent\n */\nimport { existsSync } from 'node:fs'\nimport { Module as nodeModule } from 'node:module'\nimport * as os from 'node:os'\nimport * as path from 'node:path'\nimport { startAgent } from './agent-bootstrap.js'\n\n// `Module._initPaths()` re-derives the CJS search paths from a NODE_PATH set\n// after process start. It's a stable Node internal backing NODE_PATH support\n// but is absent from @types/node — declare it via merging (no cast).\ndeclare module 'node:module' {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace Module {\n    function _initPaths(): void\n  }\n}\n\ninterface CliArgs {\n  hub?: string\n  name?: string\n  data?: string\n  logLevel?: string\n  secret?: string\n  statusPort?: string\n  help?: boolean\n}\n\nfunction parseArgs(argv: readonly string[]): CliArgs {\n  const args: CliArgs = {}\n  for (let i = 2; i < argv.length; i++) {\n    const arg = argv[i]!\n    const next = argv[i + 1]\n    switch (arg) {\n      case '--hub':\n      case '-h':\n        if (arg === '-h' && !next?.match(/^[\\d.]+/)) {\n          args.help = true\n          break\n        }\n        args.hub = next\n        i++\n        break\n      case '--name':\n      case '-n':\n        args.name = next\n        i++\n        break\n      case '--data':\n      case '-d':\n        args.data = next\n        i++\n        break\n      case '--log-level':\n      case '-l':\n        args.logLevel = next\n        i++\n        break\n      case '--secret':\n      case '-s':\n        args.secret = next\n        i++\n        break\n      case '--status-port':\n      case '-p':\n        args.statusPort = next\n        i++\n        break\n      case '--help':\n        args.help = true\n        break\n      default:\n        if (!arg.startsWith('-') && !args.hub) {\n          args.hub = arg\n          break\n        }\n        console.error(`Unknown argument: ${arg}`)\n        args.help = true\n    }\n  }\n  return args\n}\n\nfunction printHelp(): void {\n  console.log(\n    `\ncamstack-agent — CamStack remote agent node\n\nUsage:\n  camstack-agent --hub <hub-address> [options]\n  camstack-agent <hub-address> [options]\n\nOptions:\n  --hub, -h <address>     Hub address (IP or hostname, e.g. 192.168.1.100)\n  --name, -n <name>       Node name (default: hostname)\n  --data, -d <path>       Data directory (default: ./camstack-data)\n  --log-level, -l <level> Log level: trace|debug|info|warn|error (default: info)\n  --secret, -s <secret>   Cluster secret (nodes must share the same secret)\n  --help                  Show this help\n\nEnvironment variables (override CLI args):\n  CAMSTACK_NODE_ID          Node identifier\n  CAMSTACK_HUB_ADDRESS      Hub address\n  CAMSTACK_DATA_DIR         Data directory path\n  CAMSTACK_LOG_LEVEL        Log level\n  CAMSTACK_CLUSTER_SECRET   Cluster secret\n  CAMSTACK_HUB_URL          Derived automatically from the hub address; set\n                            only to override the cross-node stream/recording\n                            pull host\n\nExamples:\n  camstack-agent --hub 192.168.1.100\n  camstack-agent --hub 192.168.1.100 --name gpu-box --log-level debug\n  CAMSTACK_HUB_ADDRESS=192.168.1.100 camstack-agent\n`.trim(),\n  )\n}\n\nconst args = parseArgs(process.argv)\n\nif (args.help) {\n  printHelp()\n  process.exit(0)\n}\n\n// CLI args → env vars (env vars set externally take precedence via agent-config.ts)\nif (args.hub && !process.env['CAMSTACK_HUB_ADDRESS']) {\n  process.env['CAMSTACK_HUB_ADDRESS'] = args.hub\n}\nif (args.name && !process.env['CAMSTACK_NODE_ID']) {\n  process.env['CAMSTACK_NODE_ID'] = args.name\n}\nif (args.data && !process.env['CAMSTACK_DATA_DIR']) {\n  process.env['CAMSTACK_DATA_DIR'] = args.data\n}\nif (args.logLevel && !process.env['CAMSTACK_LOG_LEVEL']) {\n  process.env['CAMSTACK_LOG_LEVEL'] = args.logLevel\n}\nif (args.secret && !process.env['CAMSTACK_CLUSTER_SECRET']) {\n  process.env['CAMSTACK_CLUSTER_SECRET'] = args.secret\n}\nif (args.statusPort && !process.env['CAMSTACK_STATUS_PORT']) {\n  process.env['CAMSTACK_STATUS_PORT'] = args.statusPort\n}\n\n// Packaged-app framework resolution. In a self-contained build (e.g. the\n// Electron `.app`, where this CLI lives at `<root>/agent/dist/cli.js` and the\n// host-provided package closure at `<root>/node_modules`), addons installed\n// under the data dir cannot walk up to the framework's node_modules. Mirror the\n// Docker image's setup: point the addon-runner's resolver hook at the framework\n// (CAMSTACK_FRAMEWORK_DIR, for ESM imports) AND seed NODE_PATH (for CJS\n// `require`) so host externals (@camstack/shm-ring, sharp, node-av, …) resolve.\n// No-op in dev (workspace symlinks resolve the framework) and when an operator\n// or the Docker image has already set CAMSTACK_FRAMEWORK_DIR.\nif (!process.env['CAMSTACK_FRAMEWORK_DIR']) {\n  const scriptPath = process.argv[1]\n  if (scriptPath) {\n    const frameworkDir = path.resolve(path.dirname(scriptPath), '..', '..')\n    const frameworkModules = path.join(frameworkDir, 'node_modules')\n    // Sentinel: a host-provided native package present in the framework's\n    // node_modules confirms the self-contained layout (absent in dev).\n    if (existsSync(path.join(frameworkModules, '@camstack', 'shm-ring'))) {\n      process.env['CAMSTACK_FRAMEWORK_DIR'] = frameworkDir\n      const existingNodePath = process.env['NODE_PATH']\n      process.env['NODE_PATH'] = existingNodePath\n        ? `${frameworkModules}${path.delimiter}${existingNodePath}`\n        : frameworkModules\n      // Node reads NODE_PATH once at startup into the CJS module search paths;\n      // setting it now (post-start) only reaches CHILD processes that inherit\n      // it at spawn (the forked addon-runners). The agent's OWN main process —\n      // where bootCoreAddons imports the in-process infra builtins (storage /\n      // settings / metrics from @camstack/system) — must re-derive its search\n      // paths or those addons' host-dep requires (@camstack/types, …) fail with\n      // \"Cannot find module\" and the agent boots with NO infrastructure.\n      nodeModule._initPaths()\n      console.log(\n        `[Agent] Self-contained framework detected — CAMSTACK_FRAMEWORK_DIR=${frameworkDir}`,\n      )\n      // Also point the bootstrap installer at the bundled addons so a fresh\n      // (empty) data dir gets seeded with the agent's required packages\n      // (@camstack/system — platform-probe/storage/settings/metrics builtins —\n      // plus the bundled addons). Without this, bootCoreAddons finds no addon\n      // packages and the agent runs with NO infrastructure (no platform-probe →\n      // detection engine can't auto-pick the node's accelerator, no storage,\n      // etc.). Mirrors the Docker image's CAMSTACK_BUNDLED_ADDONS_DIR.\n      if (!process.env['CAMSTACK_BUNDLED_ADDONS_DIR']) {\n        const bundledAddons = path.join(frameworkDir, 'addons')\n        if (existsSync(bundledAddons)) {\n          process.env['CAMSTACK_BUNDLED_ADDONS_DIR'] = bundledAddons\n        }\n      }\n    }\n  }\n}\n\n// Default node name to hostname if not set\nif (!process.env['CAMSTACK_NODE_ID']) {\n  process.env['CAMSTACK_NODE_ID'] = os.hostname()\n}\n\n// Hub address is optional — agent starts in discovery mode without it.\n// The agent UI on :4444 lets the user configure the hub connection.\nif (!process.env['CAMSTACK_HUB_ADDRESS']) {\n  console.log('[Agent] No hub address specified — starting in discovery mode')\n  console.log('[Agent] Configure hub connection at http://localhost:4444')\n}\n\nstartAgent().catch((err: unknown) => {\n  console.error('[Agent] Fatal error:', err)\n  process.exit(1)\n})\n"],"mappings":"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","names":["args"]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CamStack Agent CLI — starts a remote agent node that connects to a hub.\n *\n * Usage:\n *   camstack-agent --hub 192.168.1.100\n *   camstack-agent --hub 192.168.1.100 --name gpu-box --data ./agent-data\n *   CAMSTACK_HUB_ADDRESS=192.168.1.100 camstack-agent\n */\nimport { existsSync } from 'node:fs'\nimport { Module as nodeModule } from 'node:module'\nimport * as os from 'node:os'\nimport * as path from 'node:path'\nimport { startAgent } from './agent-bootstrap.js'\n\n// `Module._initPaths()` re-derives the CJS search paths from a NODE_PATH set\n// after process start. It's a stable Node internal backing NODE_PATH support\n// but is absent from @types/node — declare it via merging (no cast).\ndeclare module 'node:module' {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace Module {\n    function _initPaths(): void\n  }\n}\n\ninterface CliArgs {\n  hub?: string\n  name?: string\n  data?: string\n  logLevel?: string\n  secret?: string\n  statusPort?: string\n  help?: boolean\n}\n\nfunction parseArgs(argv: readonly string[]): CliArgs {\n  const args: CliArgs = {}\n  for (let i = 2; i < argv.length; i++) {\n    const arg = argv[i]!\n    const next = argv[i + 1]\n    switch (arg) {\n      case '--hub':\n      case '-h':\n        if (arg === '-h' && !next?.match(/^[\\d.]+/)) {\n          args.help = true\n          break\n        }\n        args.hub = next\n        i++\n        break\n      case '--name':\n      case '-n':\n        args.name = next\n        i++\n        break\n      case '--data':\n      case '-d':\n        args.data = next\n        i++\n        break\n      case '--log-level':\n      case '-l':\n        args.logLevel = next\n        i++\n        break\n      case '--secret':\n      case '-s':\n        args.secret = next\n        i++\n        break\n      case '--status-port':\n      case '-p':\n        args.statusPort = next\n        i++\n        break\n      case '--help':\n        args.help = true\n        break\n      default:\n        if (!arg.startsWith('-') && !args.hub) {\n          args.hub = arg\n          break\n        }\n        console.error(`Unknown argument: ${arg}`)\n        args.help = true\n    }\n  }\n  return args\n}\n\nfunction printHelp(): void {\n  console.log(\n    `\ncamstack-agent — CamStack remote agent node\n\nUsage:\n  camstack-agent --hub <hub-address> [options]\n  camstack-agent <hub-address> [options]\n\nOptions:\n  --hub, -h <address>     Hub address (IP or hostname, e.g. 192.168.1.100)\n  --name, -n <name>       Node name (default: hostname)\n  --data, -d <path>       Data directory (default: ./camstack-data)\n  --log-level, -l <level> Log level: trace|debug|info|warn|error (default: info)\n  --secret, -s <secret>   Cluster secret (nodes must share the same secret)\n  --help                  Show this help\n\nEnvironment variables (override CLI args):\n  CAMSTACK_NODE_ID          Node identifier\n  CAMSTACK_HUB_ADDRESS      Hub address\n  CAMSTACK_DATA_DIR         Data directory path\n  CAMSTACK_LOG_LEVEL        Log level\n  CAMSTACK_CLUSTER_SECRET   Cluster secret\n  CAMSTACK_HUB_URL          Derived automatically from the hub address; set\n                            only to override the cross-node stream/recording\n                            pull host\n\nExamples:\n  camstack-agent --hub 192.168.1.100\n  camstack-agent --hub 192.168.1.100 --name gpu-box --log-level debug\n  CAMSTACK_HUB_ADDRESS=192.168.1.100 camstack-agent\n`.trim(),\n  )\n}\n\nconst args = parseArgs(process.argv)\n\nif (args.help) {\n  printHelp()\n  process.exit(0)\n}\n\n// CLI args → env vars (env vars set externally take precedence via agent-config.ts)\nif (args.hub && !process.env['CAMSTACK_HUB_ADDRESS']) {\n  process.env['CAMSTACK_HUB_ADDRESS'] = args.hub\n}\nif (args.name && !process.env['CAMSTACK_NODE_ID']) {\n  process.env['CAMSTACK_NODE_ID'] = args.name\n}\nif (args.data && !process.env['CAMSTACK_DATA_DIR']) {\n  process.env['CAMSTACK_DATA_DIR'] = args.data\n}\nif (args.logLevel && !process.env['CAMSTACK_LOG_LEVEL']) {\n  process.env['CAMSTACK_LOG_LEVEL'] = args.logLevel\n}\nif (args.secret && !process.env['CAMSTACK_CLUSTER_SECRET']) {\n  process.env['CAMSTACK_CLUSTER_SECRET'] = args.secret\n}\nif (args.statusPort && !process.env['CAMSTACK_STATUS_PORT']) {\n  process.env['CAMSTACK_STATUS_PORT'] = args.statusPort\n}\n\n// Packaged-app framework resolution. In a self-contained build (e.g. the\n// Electron `.app`, where this CLI lives at `<root>/agent/dist/cli.js` and the\n// host-provided package closure at `<root>/node_modules`), addons installed\n// under the data dir cannot walk up to the framework's node_modules. Mirror the\n// Docker image's setup: point the addon-runner's resolver hook at the framework\n// (CAMSTACK_FRAMEWORK_DIR, for ESM imports) AND seed NODE_PATH (for CJS\n// `require`) so host externals (@camstack/shm-ring, sharp, node-av, …) resolve.\n// No-op in dev (workspace symlinks resolve the framework) and when an operator\n// or the Docker image has already set CAMSTACK_FRAMEWORK_DIR.\n//\n// Framework-dir discovery order:\n//   1. An active data-root (CAMSTACK_AGENT_ACTIVE_ROOT, set by the starter) —\n//      its node_modules IS the closure the entry was loaded from.\n//   2. Bounded walk-up from the entry script. The old fixed `../..` only\n//      matched the Docker layout (`<root>/agent/dist/cli.js`); npm-installed\n//      layouts (the Electron seed: `<root>/node_modules/@camstack/agent/dist/\n//      cli.js`) put the closure THREE levels further up, so every addon\n//      needing a host external (@camstack/shm-ring, …) crashed at import and\n//      the node dropped out of the placement pool (Mac mini, 2026-07-16).\nif (!process.env['CAMSTACK_FRAMEWORK_DIR']) {\n  const isFrameworkDir = (dir: string): boolean =>\n    existsSync(path.join(dir, 'node_modules', '@camstack', 'shm-ring')) &&\n    existsSync(path.join(dir, 'node_modules', '@camstack', 'system'))\n  const discoverFrameworkDir = (): string | null => {\n    const activeRoot = process.env['CAMSTACK_AGENT_ACTIVE_ROOT']\n    if (activeRoot && isFrameworkDir(activeRoot)) return activeRoot\n    const scriptPath = process.argv[1]\n    if (!scriptPath) return null\n    let dir = path.dirname(scriptPath)\n    for (let depth = 0; depth < 8; depth++) {\n      if (isFrameworkDir(dir)) return dir\n      const parent = path.dirname(dir)\n      if (parent === dir) break\n      dir = parent\n    }\n    return null\n  }\n  const frameworkDir = discoverFrameworkDir()\n  if (frameworkDir) {\n    const frameworkModules = path.join(frameworkDir, 'node_modules')\n    process.env['CAMSTACK_FRAMEWORK_DIR'] = frameworkDir\n    const existingNodePath = process.env['NODE_PATH']\n    process.env['NODE_PATH'] = existingNodePath\n      ? `${frameworkModules}${path.delimiter}${existingNodePath}`\n      : frameworkModules\n    // Node reads NODE_PATH once at startup into the CJS module search paths;\n    // setting it now (post-start) only reaches CHILD processes that inherit\n    // it at spawn (the forked addon-runners). The agent's OWN main process —\n    // where bootCoreAddons imports the in-process infra builtins (storage /\n    // settings / metrics from @camstack/system) — must re-derive its search\n    // paths or those addons' host-dep requires (@camstack/types, …) fail with\n    // \"Cannot find module\" and the agent boots with NO infrastructure.\n    nodeModule._initPaths()\n    console.log(\n      `[Agent] Self-contained framework detected — CAMSTACK_FRAMEWORK_DIR=${frameworkDir}`,\n    )\n    // Also point the bootstrap installer at the bundled addons so a fresh\n    // (empty) data dir gets seeded with the agent's required packages\n    // (@camstack/system — platform-probe/storage/settings/metrics builtins —\n    // plus the bundled addons). Without this, bootCoreAddons finds no addon\n    // packages and the agent runs with NO infrastructure (no platform-probe →\n    // detection engine can't auto-pick the node's accelerator, no storage,\n    // etc.). Mirrors the Docker image's CAMSTACK_BUNDLED_ADDONS_DIR.\n    if (!process.env['CAMSTACK_BUNDLED_ADDONS_DIR']) {\n      const bundledAddons = path.join(frameworkDir, 'addons')\n      if (existsSync(bundledAddons)) {\n        process.env['CAMSTACK_BUNDLED_ADDONS_DIR'] = bundledAddons\n      }\n    }\n  }\n}\n\n// Default node name to hostname if not set\nif (!process.env['CAMSTACK_NODE_ID']) {\n  process.env['CAMSTACK_NODE_ID'] = os.hostname()\n}\n\n// Hub address is optional — agent starts in discovery mode without it.\n// The agent UI on :4444 lets the user configure the hub connection.\nif (!process.env['CAMSTACK_HUB_ADDRESS']) {\n  console.log('[Agent] No hub address specified — starting in discovery mode')\n  console.log('[Agent] Configure hub connection at http://localhost:4444')\n}\n\nstartAgent().catch((err: unknown) => {\n  console.error('[Agent] Fatal error:', err)\n  process.exit(1)\n})\n"],"mappings":"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","names":["args"]}

package/dist/index.js

@@ -88,6 +88,7 @@ var require_dist = __commonJS({
       planBoot: () => planBoot,
       readDevUploadManifest: () => readDevUploadManifest,
       readRestartIntentMarker: () => readRestartIntentMarker,
+      readSeedVersion: () => readSeedVersion,
       readServerRootState: () => readServerRootState,
       registerActiveRootResolver: () => registerActiveRootResolver,
       restartIntentMarkerPath: () => restartIntentMarkerPath,
@@ -299,7 +300,34 @@ var require_dist = __commonJS({
       }
       return null;
     }
-    function planBoot(state, isValidVersion, now) {
+    function parse(version) {
+      const dashIdx = version.indexOf("-");
+      const base = dashIdx === -1 ? version : version.slice(0, dashIdx);
+      const prerelease = dashIdx === -1 ? null : version.slice(dashIdx + 1);
+      const nums = base.split(".").map((seg) => {
+        const n = Number.parseInt(seg, 10);
+        return Number.isNaN(n) ? 0 : n;
+      });
+      return { nums, prerelease };
+    }
+    function compareSemver(a, b) {
+      const pa = parse(a);
+      const pb = parse(b);
+      const len = Math.max(pa.nums.length, pb.nums.length);
+      for (let i = 0; i < len; i++) {
+        const na = pa.nums[i] ?? 0;
+        const nb = pb.nums[i] ?? 0;
+        if (na < nb) return -1;
+        if (na > nb) return 1;
+      }
+      if (pa.prerelease === null && pb.prerelease === null) return 0;
+      if (pa.prerelease === null) return 1;
+      if (pb.prerelease === null) return -1;
+      if (pa.prerelease < pb.prerelease) return -1;
+      if (pa.prerelease > pb.prerelease) return 1;
+      return 0;
+    }
+    function planBoot(state, isValidVersion, now, seedVersion = null) {
       if (state === null) {
         return { kind: "baked", reason: "no server-root state", stateToWrite: null };
       }
@@ -345,6 +373,19 @@ var require_dist = __commonJS({
       }
       if (next.currentVersion !== null) {
         if (isValidVersion(next.currentVersion)) {
+          if (!changed && seedVersion !== null && compareSemver(seedVersion, next.currentVersion) > 0) {
+            return {
+              kind: "baked",
+              reason: `baked seed ${seedVersion} is newer than active data-root ${next.currentVersion} \u2014 adopting the image seed`,
+              stateToWrite: {
+                ...next,
+                currentVersion: null,
+                previousVersion: null,
+                pendingBoot: null,
+                rolledBack: null
+              }
+            };
+          }
           return {
             kind: "data-root",
             version: next.currentVersion,
@@ -393,33 +434,6 @@ var require_dist = __commonJS({
         stateToWrite: changed ? next : null
       };
     }
-    function parse(version) {
-      const dashIdx = version.indexOf("-");
-      const base = dashIdx === -1 ? version : version.slice(0, dashIdx);
-      const prerelease = dashIdx === -1 ? null : version.slice(dashIdx + 1);
-      const nums = base.split(".").map((seg) => {
-        const n = Number.parseInt(seg, 10);
-        return Number.isNaN(n) ? 0 : n;
-      });
-      return { nums, prerelease };
-    }
-    function compareSemver(a, b) {
-      const pa = parse(a);
-      const pb = parse(b);
-      const len = Math.max(pa.nums.length, pb.nums.length);
-      for (let i = 0; i < len; i++) {
-        const na = pa.nums[i] ?? 0;
-        const nb = pb.nums[i] ?? 0;
-        if (na < nb) return -1;
-        if (na > nb) return 1;
-      }
-      if (pa.prerelease === null && pb.prerelease === null) return 0;
-      if (pa.prerelease === null) return 1;
-      if (pb.prerelease === null) return -1;
-      if (pa.prerelease < pb.prerelease) return -1;
-      if (pa.prerelease > pb.prerelease) return 1;
-      return 0;
-    }
     var fs32 = __toESM2(require("fs"));
     var path32 = __toESM2(require("path"));
     function detectWorkspaceRoot(fromDir) {
@@ -438,6 +452,7 @@ var require_dist = __commonJS({
         dir = parent;
       }
     }
+    var fs42 = __toESM2(require("fs"));
     var path42 = __toESM2(require("path"));
     var import_node_url = require("url");
     var HOST_EXTERNAL_SPECIFIERS = [
@@ -481,6 +496,19 @@ var require_dist = __commonJS({
       };
       registerHooks(hooks);
     }
+    function readSeedVersion(seedEntry) {
+      try {
+        const pkgJsonPath = path42.join(path42.dirname(seedEntry), "..", "package.json");
+        const raw = JSON.parse(fs42.readFileSync(pkgJsonPath, "utf-8"));
+        if (typeof raw === "object" && raw !== null) {
+          const version = raw["version"];
+          if (typeof version === "string") return version;
+        }
+        return null;
+      } catch {
+        return null;
+      }
+    }
     function runNodeStarter(options) {
       const env = options.env ?? process.env;
       const now = options.now ?? Date.now;
@@ -509,7 +537,8 @@ var require_dist = __commonJS({
         if (reason !== null) console.warn(`[starter] version ${version} invalid: ${reason}`);
         return reason === null;
       };
-      const plan = planBoot(state, isValidVersion, now);
+      const seedVersion = readSeedVersion(options.seedEntry);
+      const plan = planBoot(state, isValidVersion, now, seedVersion);
       if (plan.stateToWrite !== null) {
         try {
           writeServerRootState(rootDir, plan.stateToWrite);
@@ -544,7 +573,7 @@ var require_dist = __commonJS({
       options.loadEntry(options.seedEntry);
     }
     var import_node_child_process = require("child_process");
-    var fs42 = __toESM2(require("fs"));
+    var fs52 = __toESM2(require("fs"));
     var path52 = __toESM2(require("path"));
     var import_node_util = require("util");
     var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
@@ -557,7 +586,7 @@ var require_dist = __commonJS({
     var RESTART_REASON_PREFIX = "server-update";
     function readPackageVersion(pkgJsonPath) {
       try {
-        const raw = JSON.parse(fs42.readFileSync(pkgJsonPath, "utf-8"));
+        const raw = JSON.parse(fs52.readFileSync(pkgJsonPath, "utf-8"));
         if (typeof raw === "object" && raw !== null) {
           const version = raw["version"];
           if (typeof version === "string") return version;
@@ -631,7 +660,7 @@ var require_dist = __commonJS({
         const rootDir = this.rootDir();
         const raw = readServerRootState(rootDir);
         if (raw !== null) return { state: raw, corrupt: false };
-        return { state: emptyServerRootState(), corrupt: fs42.existsSync(stateFilePath(rootDir)) };
+        return { state: emptyServerRootState(), corrupt: fs52.existsSync(stateFilePath(rootDir)) };
       }
       updateState(state) {
         if (this.inFlight === "checking") return "checking";
@@ -773,7 +802,7 @@ var require_dist = __commonJS({
         }
         if (isDevChannelVersion(target)) {
           const uploadsDir = devUploadVersionDir(this.rootDir(), target);
-          if (!fs42.existsSync(uploadsDir)) {
+          if (!fs52.existsSync(uploadsDir)) {
             return {
               accepted: false,
               targetVersion: target,
@@ -828,15 +857,15 @@ var require_dist = __commonJS({
       async stageAndActivate(target) {
         const rootDir = this.rootDir();
         const vDir = versionsDir(rootDir);
-        fs42.mkdirSync(vDir, { recursive: true });
+        fs52.mkdirSync(vDir, { recursive: true });
         const stagingDir = path52.join(vDir, `.staging-${target}-${process.pid}-${this.now()}`);
-        fs42.mkdirSync(stagingDir, { recursive: true });
+        fs52.mkdirSync(stagingDir, { recursive: true });
         try {
           const devDir = devUploadVersionDir(rootDir, target);
           const registry = this.env["CAMSTACK_NPM_REGISTRY"];
           const installArgs = ["install", "--omit=dev", "--no-audit", "--no-fund", "--loglevel=error"];
-          if (fs42.existsSync(devDir)) {
-            fs42.writeFileSync(
+          if (fs52.existsSync(devDir)) {
+            fs52.writeFileSync(
               path52.join(stagingDir, "package.json"),
               JSON.stringify(this.buildDevUploadsPackageJson(devDir, target), null, 2),
               "utf-8"
@@ -846,7 +875,7 @@ var require_dist = __commonJS({
               timeoutMs: NPM_INSTALL_TIMEOUT_MS
             });
           } else {
-            fs42.writeFileSync(
+            fs52.writeFileSync(
               path52.join(stagingDir, "package.json"),
               JSON.stringify({ name: "camstack-node-root", private: true }, null, 2),
               "utf-8"
@@ -857,7 +886,7 @@ var require_dist = __commonJS({
             );
           }
           const entry = rootEntryPath(stagingDir, this.spec);
-          if (!fs42.existsSync(entry)) {
+          if (!fs52.existsSync(entry)) {
             throw new Error(`staged closure is missing the root entry (${entry})`);
           }
           const stagedVersion = readPackageVersion(
@@ -869,14 +898,14 @@ var require_dist = __commonJS({
             );
           }
           const dest = versionDir(rootDir, target);
-          if (fs42.existsSync(dest)) {
+          if (fs52.existsSync(dest)) {
             const aside = `${dest}.evicted-${this.now()}`;
-            await fs42.promises.rename(dest, aside);
-            await fs42.promises.rm(aside, { recursive: true, force: true }).catch(() => void 0);
+            await fs52.promises.rename(dest, aside);
+            await fs52.promises.rm(aside, { recursive: true, force: true }).catch(() => void 0);
           }
-          await fs42.promises.rename(stagingDir, dest);
+          await fs52.promises.rename(stagingDir, dest);
         } catch (err) {
-          await fs42.promises.rm(stagingDir, { recursive: true, force: true }).catch(() => void 0);
+          await fs52.promises.rm(stagingDir, { recursive: true, force: true }).catch(() => void 0);
           throw err;
         }
       }
@@ -907,7 +936,7 @@ var require_dist = __commonJS({
         }
         const fileRef = (filename) => {
           const abs = path52.join(devDir, filename);
-          if (!fs42.existsSync(abs)) {
+          if (!fs52.existsSync(abs)) {
             throw new Error(`dev-uploads tarball listed in the manifest is missing: ${abs}`);
           }
           return `file:${abs}`;
@@ -1077,7 +1106,7 @@ var require_dist = __commonJS({
         const vDir = versionsDir(this.rootDir());
         let entries;
         try {
-          entries = fs42.readdirSync(vDir);
+          entries = fs52.readdirSync(vDir);
         } catch {
           return;
         }
@@ -1086,14 +1115,14 @@ var require_dist = __commonJS({
           const full = path52.join(vDir, entry);
           if (entry.startsWith(".")) {
             try {
-              const ageMs = this.now() - fs42.statSync(full).mtimeMs;
+              const ageMs = this.now() - fs52.statSync(full).mtimeMs;
               if (ageMs < _RootUpdateService.STALE_TRANSIENT_MS) continue;
             } catch {
               continue;
             }
           }
           try {
-            fs42.rmSync(full, { recursive: true, force: true });
+            fs52.rmSync(full, { recursive: true, force: true });
             this.logger.debug("pruned server-root version dir", { meta: { entry } });
           } catch (err) {
             this.logger.warn("failed to prune server-root version dir", {
@@ -1114,15 +1143,15 @@ var require_dist = __commonJS({
         const dir = devUploadsDir(this.rootDir());
         let entries;
         try {
-          entries = fs42.readdirSync(dir);
+          entries = fs52.readdirSync(dir);
         } catch {
           return;
         }
         const graveyard = path52.join(dir, ".sweeping");
         try {
-          for (const residue of fs42.readdirSync(graveyard)) {
+          for (const residue of fs52.readdirSync(graveyard)) {
             try {
-              fs42.rmSync(path52.join(graveyard, residue), { recursive: true, force: true });
+              fs52.rmSync(path52.join(graveyard, residue), { recursive: true, force: true });
             } catch {
             }
           }
@@ -1134,11 +1163,11 @@ var require_dist = __commonJS({
         );
         const doomed = byNewestFirst.slice(keepCount);
         if (doomed.length === 0) return;
-        fs42.mkdirSync(graveyard, { recursive: true });
+        fs52.mkdirSync(graveyard, { recursive: true });
         for (const entry of doomed) {
           const aside = path52.join(graveyard, `${entry}-${this.now()}`);
           try {
-            fs42.renameSync(path52.join(dir, entry), aside);
+            fs52.renameSync(path52.join(dir, entry), aside);
           } catch (err) {
             this.logger.warn("failed to move dev-uploads entry aside for sweep", {
               meta: { entry, error: err instanceof Error ? err.message : String(err) }
@@ -1146,7 +1175,7 @@ var require_dist = __commonJS({
             continue;
           }
           try {
-            fs42.rmSync(aside, { recursive: true, force: true });
+            fs52.rmSync(aside, { recursive: true, force: true });
             this.logger.debug("swept dev-uploads entry", { meta: { entry } });
           } catch {
           }