volute 0.8.1 → 0.8.3

package/README.md

@@ -245,7 +245,7 @@ npm install -g volute
 sudo $(which volute) setup --host 0.0.0.0
 ```
 
-> **Note:** If you installed Node via nvm, `sudo volute` won't find the binary. Use `sudo $(which volute)` or `sudo su` then run `volute setup` directly.
+> **Note:** The initial `sudo $(which volute)` is needed because `sudo` resets PATH. After setup completes, a wrapper at `/usr/local/bin/volute` is created so `sudo volute` works normally going forward.
 
 This installs a system-level systemd service with data at `/var/lib/volute` and user isolation enabled. Check status with `systemctl status volute`. Uninstall with `sudo volute setup uninstall --force`.
 

package/dist/{chunk-XSJ27WEM.js → chunk-6RDCTVQK.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-DP2DX4WV.js";
 
 // src/commands/up.ts
-import { spawn } from "child_process";
+import { execFileSync, spawn } from "child_process";
 import { existsSync, mkdirSync, openSync, readFileSync } from "fs";
 import { dirname, resolve } from "path";
 function readGlobalConfig() {
@@ -20,12 +20,27 @@ function readGlobalConfig() {
     process.exit(1);
   }
 }
+function isSystemdServiceEnabled() {
+  try {
+    execFileSync("systemctl", ["is-enabled", "--quiet", "volute"]);
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function run(args) {
   const { flags } = parseArgs(args, {
     port: { type: "number" },
     host: { type: "string" },
     foreground: { type: "boolean" }
   });
+  if (!flags.foreground && isSystemdServiceEnabled()) {
+    console.error("Volute is managed by a systemd service.");
+    console.error("Use: sudo systemctl start volute");
+    console.error("     sudo systemctl restart volute");
+    console.error("     systemctl status volute");
+    process.exit(1);
+  }
   const config = readGlobalConfig();
   const port = flags.port ?? config.port ?? 4200;
   const hostname = flags.host ?? config.hostname ?? "127.0.0.1";

package/dist/{chunk-HZ5LTOEJ.js → chunk-YNNK4QN2.js}

@@ -4,9 +4,21 @@ import {
 } from "./chunk-DP2DX4WV.js";
 
 // src/commands/down.ts
+import { execFileSync } from "child_process";
 import { existsSync, readFileSync, unlinkSync } from "fs";
 import { resolve } from "path";
+function isSystemdServiceEnabled() {
+  try {
+    execFileSync("systemctl", ["is-enabled", "--quiet", "volute"]);
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function stopDaemon() {
+  if (isSystemdServiceEnabled()) {
+    return { stopped: false, reason: "systemd" };
+  }
   const home = voluteHome();
   const pidPath = resolve(home, "daemon.pid");
   if (!existsSync(pidPath)) {
@@ -99,7 +111,10 @@ async function stopDaemon() {
 async function run(_args) {
   const result = await stopDaemon();
   if (result.stopped) return;
-  if (result.reason === "orphan") {
+  if (result.reason === "systemd") {
+    console.error("Volute is managed by a systemd service.");
+    console.error("Use: sudo systemctl stop volute");
+  } else if (result.reason === "orphan") {
     console.error(`Daemon appears to be running on port ${result.port} but PID file is missing.`);
     console.error(`Kill the process manually: lsof -ti :${result.port} | xargs kill`);
   } else if (result.reason === "not-running") {

package/dist/cli.js

@@ -9,7 +9,7 @@ if (!process.env.VOLUTE_HOME) {
 var command = process.argv[2];
 var args = process.argv.slice(3);
 if (command === "--version" || command === "-v") {
-  const { default: pkg } = await import("./package-RJSONENE.js");
+  const { default: pkg } = await import("./package-2S7APQBC.js");
   console.log(pkg.version);
   process.exit(0);
 }
@@ -39,22 +39,22 @@ switch (command) {
     await import("./env-KMNYGVZ2.js").then((m) => m.run(args));
     break;
   case "up":
-    await import("./up-V6EAA7OZ.js").then((m) => m.run(args));
+    await import("./up-RZJMSVQS.js").then((m) => m.run(args));
     break;
   case "down":
-    await import("./down-O4EWZTVA.js").then((m) => m.run(args));
+    await import("./down-4DGRZRJU.js").then((m) => m.run(args));
     break;
   case "restart":
-    await import("./daemon-restart-CPBLMMRI.js").then((m) => m.run(args));
+    await import("./daemon-restart-IMNCBWFV.js").then((m) => m.run(args));
     break;
   case "setup":
-    await import("./setup-32KH5KLN.js").then((m) => m.run(args));
+    await import("./setup-7SPMWF2O.js").then((m) => m.run(args));
     break;
   case "service":
-    await import("./service-XCADRKIS.js").then((m) => m.run(args));
+    await import("./service-56CY4S6Z.js").then((m) => m.run(args));
     break;
   case "update":
-    await import("./update-EUCZ7XGG.js").then((m) => m.run(args));
+    await import("./update-3TGXUTO2.js").then((m) => m.run(args));
     break;
   case "--help":
   case "-h":

package/dist/{daemon-restart-CPBLMMRI.js → daemon-restart-IMNCBWFV.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-XSJ27WEM.js";
+} from "./chunk-6RDCTVQK.js";
 import {
   stopDaemon
-} from "./chunk-HZ5LTOEJ.js";
+} from "./chunk-YNNK4QN2.js";
 import "./chunk-D424ZQGI.js";
 import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
@@ -12,6 +12,11 @@ import "./chunk-K3NQKI34.js";
 // src/commands/daemon-restart.ts
 async function run2(args) {
   const result = await stopDaemon();
+  if (!result.stopped && result.reason === "systemd") {
+    console.error("Volute is managed by a systemd service.");
+    console.error("Use: sudo systemctl restart volute");
+    process.exit(1);
+  }
   if (!result.stopped && result.reason === "kill-failed") {
     console.error("Cannot restart: failed to stop the running daemon.");
     process.exit(1);

package/dist/{down-O4EWZTVA.js → down-4DGRZRJU.js}

@@ -2,7 +2,7 @@
 import {
   run,
   stopDaemon
-} from "./chunk-HZ5LTOEJ.js";
+} from "./chunk-YNNK4QN2.js";
 import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";
 export {

package/dist/{package-RJSONENE.js → package-2S7APQBC.js}

@@ -4,7 +4,7 @@ import "./chunk-K3NQKI34.js";
 // package.json
 var package_default = {
   name: "volute",
-  version: "0.8.1",
+  version: "0.8.3",
   description: "CLI for creating and managing self-modifying AI agents powered by the Claude Agent SDK",
   type: "module",
   license: "MIT",

package/dist/{service-XCADRKIS.js → service-56CY4S6Z.js}

@@ -15,6 +15,7 @@ import { resolve } from "path";
 import { promisify } from "util";
 var execFileAsync = promisify(execFile);
 var HOST_RE = /^[a-zA-Z0-9.:_-]+$/;
+var SYSTEM_SERVICE_PATH = "/etc/systemd/system/volute.service";
 function validateHost(host) {
   if (!HOST_RE.test(host)) {
     throw new Error(`Invalid host: ${host}`);
@@ -82,6 +83,12 @@ async function install(port, host) {
     await execFileAsync("launchctl", ["load", path]);
     console.log("Service installed and loaded. Volute daemon will start on login.");
   } else if (platform === "linux") {
+    if (existsSync(SYSTEM_SERVICE_PATH)) {
+      console.error("A system-level Volute service is already installed (via `volute setup`).");
+      console.error("Use `systemctl status volute` to check its status.");
+      console.error("To remove it first: sudo volute setup uninstall");
+      process.exit(1);
+    }
     if (process.getuid?.() === 0) {
       console.error(
         "Error: `volute service install` uses systemd user services, which don't work as root."
@@ -147,6 +154,23 @@ async function status() {
       console.log("Service installed but not currently loaded.");
     }
   } else if (platform === "linux") {
+    if (existsSync(SYSTEM_SERVICE_PATH)) {
+      try {
+        const { stdout } = await execFileAsync("systemctl", ["status", "volute", "--no-pager"]);
+        console.log(stdout);
+      } catch (err) {
+        const e = err;
+        if (e.stdout) {
+          console.log(e.stdout);
+        } else {
+          console.error("System service installed but could not retrieve status.");
+          if (e.stderr) console.error(e.stderr);
+          else if (e.message) console.error(e.message);
+          console.error("Try running: systemctl status volute");
+        }
+      }
+      return;
+    }
     if (!existsSync(unitPath())) {
       console.log("Service not installed.");
       return;

package/dist/{setup-32KH5KLN.js → setup-7SPMWF2O.js}

@@ -18,6 +18,8 @@ import { homedir } from "os";
 import { dirname } from "path";
 var SERVICE_NAME = "volute.service";
 var SERVICE_PATH = `/etc/systemd/system/${SERVICE_NAME}`;
+var PROFILE_PATH = "/etc/profile.d/volute.sh";
+var WRAPPER_PATH = "/usr/local/bin/volute";
 var DATA_DIR = "/var/lib/volute";
 var AGENTS_DIR = "/agents";
 var HOST_RE = /^[a-zA-Z0-9.:_-]+$/;
@@ -93,6 +95,24 @@ function install(port, host) {
   execFileSync("chmod", ["755", DATA_DIR]);
   execFileSync("chmod", ["755", AGENTS_DIR]);
   console.log("Set permissions on directories");
+  writeFileSync(
+    PROFILE_PATH,
+    `export VOLUTE_HOME=${DATA_DIR}
+export VOLUTE_AGENTS_DIR=${AGENTS_DIR}
+`
+  );
+  console.log(`Wrote ${PROFILE_PATH}`);
+  const binDir = dirname(voluteBin);
+  if (voluteBin !== WRAPPER_PATH && !voluteBin.startsWith("/usr/bin")) {
+    const wrapper = `#!/bin/sh
+export PATH="${binDir}:$PATH"
+export VOLUTE_HOME="${DATA_DIR}"
+export VOLUTE_AGENTS_DIR="${AGENTS_DIR}"
+exec "${voluteBin}" "$@"
+`;
+    writeFileSync(WRAPPER_PATH, wrapper, { mode: 493 });
+    console.log(`Wrote ${WRAPPER_PATH} (wrapper for ${voluteBin})`);
+  }
   writeFileSync(SERVICE_PATH, generateUnit(voluteBin, port, host ?? "0.0.0.0"));
   console.log(`Wrote ${SERVICE_PATH}`);
   try {
@@ -135,6 +155,8 @@ function uninstall(force) {
     console.warn("Warning: failed to disable service (may already be stopped)");
   }
   unlinkSync(SERVICE_PATH);
+  if (existsSync(PROFILE_PATH)) unlinkSync(PROFILE_PATH);
+  if (existsSync(WRAPPER_PATH)) unlinkSync(WRAPPER_PATH);
   try {
     execFileSync("systemctl", ["daemon-reload"]);
   } catch {

package/dist/{up-V6EAA7OZ.js → up-RZJMSVQS.js}

@@ -2,7 +2,7 @@
 import {
   readGlobalConfig,
   run
-} from "./chunk-XSJ27WEM.js";
+} from "./chunk-6RDCTVQK.js";
 import "./chunk-D424ZQGI.js";
 import "./chunk-DP2DX4WV.js";
 import "./chunk-K3NQKI34.js";

package/dist/{update-EUCZ7XGG.js → update-3TGXUTO2.js}

@@ -12,9 +12,19 @@ import {
 import "./chunk-K3NQKI34.js";
 
 // src/commands/update.ts
+import { execFileSync } from "child_process";
 import { existsSync, readFileSync, unlinkSync } from "fs";
 import { resolve } from "path";
 async function run(_args) {
+  try {
+    execFileSync("systemctl", ["is-enabled", "--quiet", "volute"]);
+    console.error("Volute is managed by a systemd service.");
+    console.error("To update, run:");
+    console.error("  sudo npm install -g volute@latest");
+    console.error("  sudo systemctl restart volute");
+    process.exit(1);
+  } catch {
+  }
   const result = await checkForUpdate();
   if (result.checkFailed) {
     console.error("Could not reach npm registry. Check your network connection and try again.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volute",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "CLI for creating and managing self-modifying AI agents powered by the Claude Agent SDK",
   "type": "module",
   "license": "MIT",