volute 0.1.0 → 0.2.1

package/dist/{delete-JNGY7ZFH.js → delete-GDMSOW3U.js}

@@ -7,7 +7,7 @@ import {
   findAgent,
   removeAgent,
   removeAllVariants
-} from "./chunk-5YW4B7CG.js";
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/delete.ts
 import { existsSync, rmSync } from "fs";
@@ -26,7 +26,7 @@ async function run(args) {
     process.exit(1);
   }
   try {
-    const { daemonFetch } = await import("./daemon-client-ZTHW7ROS.js");
+    const { daemonFetch } = await import("./daemon-client-VN24HM5T.js");
     const res = await daemonFetch(`/api/agents/${encodeURIComponent(name)}/stop`, {
       method: "POST"
     });

package/dist/{disconnect-ACVTKTRE.js → disconnect-5JWFZ6RV.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-H5XQARAP.js";
-import "./chunk-5YW4B7CG.js";
+} from "./chunk-4YXYAMFT.js";
+import "./chunk-6UCG6MIX.js";
 
 // src/commands/disconnect.ts
 async function run(args) {

package/dist/{down-FYCUYC5H.js → down-WTF73FE7.js}

@@ -1,15 +1,16 @@
 #!/usr/bin/env node
 import {
-  VOLUTE_HOME
-} from "./chunk-5YW4B7CG.js";
+  voluteHome
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/down.ts
 import { existsSync, readFileSync, unlinkSync } from "fs";
 import { resolve } from "path";
 async function run(_args) {
-  const pidPath = resolve(VOLUTE_HOME, "daemon.pid");
+  const home = voluteHome();
+  const pidPath = resolve(home, "daemon.pid");
   if (!existsSync(pidPath)) {
-    const configPath = resolve(VOLUTE_HOME, "daemon.json");
+    const configPath = resolve(home, "daemon.json");
     let port = 4200;
     if (existsSync(configPath)) {
       try {

package/dist/{env-7SLRN3MG.js → env-YKUJOFHE.js}

@@ -5,13 +5,13 @@ import {
   readEnv,
   sharedEnvPath,
   writeEnv
-} from "./chunk-A5ZJEMHT.js";
+} from "./chunk-KFNNHQK7.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   resolveAgent
-} from "./chunk-5YW4B7CG.js";
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/env.ts
 function getEnvPath(agentName) {
@@ -51,9 +51,14 @@ async function promptValue(key) {
     process.stdin.on("data", onData);
   });
 }
+function maskValue(value) {
+  if (value.length <= 6) return "***";
+  return `${value.slice(0, 3)}...${value.slice(-3)}`;
+}
 async function run(args) {
   const { positional, flags } = parseArgs(args, {
-    agent: { type: "string" }
+    agent: { type: "string" },
+    reveal: { type: "boolean" }
   });
   const subcommand = positional[0];
   switch (subcommand) {
@@ -110,7 +115,8 @@ async function run(args) {
         }
         for (const key of [...allKeys].sort()) {
           const scope = key in agent ? "agent" : "shared";
-          const value = key in agent ? agent[key] : shared[key];
+          const raw = key in agent ? agent[key] : shared[key];
+          const value = flags.reveal ? raw : maskValue(raw);
           console.log(`${key}=${value} [${scope}]`);
         }
       } else {
@@ -121,7 +127,8 @@ async function run(args) {
           return;
         }
         for (const key of keys.sort()) {
-          console.log(`${key}=${env[key]} [shared]`);
+          const value = flags.reveal ? env[key] : maskValue(env[key]);
+          console.log(`${key}=${value} [shared]`);
         }
       }
       break;

package/dist/{fork-BB3DZ426.js → fork-GRSVMBKI.js}

@@ -1,19 +1,20 @@
 #!/usr/bin/env node
-import {
-  spawnServer
-} from "./chunk-N4QN44LC.js";
 import {
   exec,
   execInherit
 } from "./chunk-XZN4WPNC.js";
+import {
+  daemonFetch
+} from "./chunk-4YXYAMFT.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
   addVariant,
+  nextPort,
   resolveAgent,
   validateBranchName
-} from "./chunk-5YW4B7CG.js";
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/fork.ts
 import { existsSync, mkdirSync, writeFileSync } from "fs";
@@ -41,17 +42,17 @@ async function run(args) {
     process.exit(1);
   }
   const { dir: projectRoot } = resolveAgent(agentName);
-  const worktreeDir = resolve(projectRoot, ".worktrees", variantName);
-  if (existsSync(worktreeDir)) {
-    console.error(`Worktree already exists: ${worktreeDir}`);
+  const variantDir = resolve(projectRoot, ".variants", variantName);
+  if (existsSync(variantDir)) {
+    console.error(`Variant directory already exists: ${variantDir}`);
     process.exit(1);
   }
-  const parentDir = resolve(projectRoot, ".worktrees");
+  const parentDir = resolve(projectRoot, ".variants");
   if (!existsSync(parentDir)) {
     mkdirSync(parentDir, { recursive: true });
   }
   try {
-    await exec("git", ["worktree", "add", "-b", variantName, worktreeDir], { cwd: projectRoot });
+    await exec("git", ["worktree", "add", "-b", variantName, variantDir], { cwd: projectRoot });
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
     console.error(`Failed to create worktree: ${msg}`);
@@ -60,9 +61,9 @@ async function run(args) {
   if (!json) console.log("Installing dependencies...");
   try {
     if (json) {
-      await exec("npm", ["install"], { cwd: worktreeDir });
+      await exec("npm", ["install"], { cwd: variantDir });
     } else {
-      await execInherit("npm", ["install"], { cwd: worktreeDir });
+      await execInherit("npm", ["install"], { cwd: variantDir });
     }
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
@@ -70,30 +71,39 @@ async function run(args) {
     process.exit(1);
   }
   if (soul) {
-    writeFileSync(resolve(worktreeDir, "home/SOUL.md"), soul);
-  }
-  let actualPort = null;
-  let pid = null;
-  if (!noStart) {
-    const requestedPort = port ?? 0;
-    if (!json) console.log("Starting server...");
-    const result = await spawnServer(worktreeDir, requestedPort, { detached: true });
-    if (!result) {
-      console.error("Server failed to start within timeout");
-      process.exit(1);
-    }
-    actualPort = result.actualPort;
-    pid = result.child.pid ?? null;
+    writeFileSync(resolve(variantDir, "home/SOUL.md"), soul);
   }
+  const variantPort = port ?? nextPort();
   const variant = {
     name: variantName,
     branch: variantName,
-    path: worktreeDir,
-    port: actualPort ?? port ?? 0,
-    pid,
+    path: variantDir,
+    port: variantPort,
     created: (/* @__PURE__ */ new Date()).toISOString()
   };
   addVariant(agentName, variant);
+  if (!noStart) {
+    if (!json) console.log("Starting variant via daemon...");
+    try {
+      const res = await daemonFetch(
+        `/api/agents/${encodeURIComponent(`${agentName}@${variantName}`)}/start`,
+        {
+          method: "POST"
+        }
+      );
+      if (!res.ok) {
+        const data = await res.json();
+        console.error(data.error ?? "Failed to start variant");
+        process.exit(1);
+      }
+    } catch {
+      console.error("Failed to start variant. Is the daemon running? (volute up)");
+      console.error(
+        `The variant was created but not started. Use: volute start ${agentName}@${variantName}`
+      );
+      process.exit(1);
+    }
+  }
   if (json) {
     console.log(JSON.stringify(variant, null, 2));
   } else {
@@ -101,10 +111,7 @@ async function run(args) {
 Variant created: ${variantName}`);
     console.log(`  Branch: ${variant.branch}`);
     console.log(`  Path:   ${variant.path}`);
-    if (actualPort) {
-      console.log(`  Port:   ${actualPort}`);
-      console.log(`  PID:    ${pid}`);
-    }
+    console.log(`  Port:   ${variantPort}`);
   }
 }
 export {

package/dist/history-7WVVKMUY.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import {
+  daemonFetch
+} from "./chunk-4YXYAMFT.js";
+import {
+  parseArgs
+} from "./chunk-D424ZQGI.js";
+import "./chunk-6UCG6MIX.js";
+
+// src/commands/history.ts
+async function run(args) {
+  const { positional, flags } = parseArgs(args, {
+    channel: { type: "string" },
+    limit: { type: "string" }
+  });
+  const name = positional[0] || process.env.VOLUTE_AGENT;
+  if (!name) {
+    console.error("Usage: volute history [<agent>] [--channel <ch>] [--limit N]");
+    process.exit(1);
+  }
+  const params = new URLSearchParams();
+  if (flags.channel) params.set("channel", flags.channel);
+  if (flags.limit) params.set("limit", flags.limit);
+  const qs = params.toString();
+  const path = `/api/agents/${encodeURIComponent(name)}/history${qs ? `?${qs}` : ""}`;
+  const res = await daemonFetch(path);
+  if (!res.ok) {
+    let errorMsg = `Failed to get history: ${res.status}`;
+    try {
+      const data = await res.json();
+      if (data.error) errorMsg = data.error;
+    } catch {
+    }
+    console.error(errorMsg);
+    process.exit(1);
+  }
+  const rows = await res.json();
+  for (const row of rows.reverse()) {
+    const time = new Date(row.created_at).toLocaleString();
+    const sender = row.sender ?? row.role;
+    console.log(`[${time}] [${row.channel}] ${sender}: ${row.content}`);
+  }
+}
+export {
+  run
+};

package/dist/{import-W2AMTEV5.js → import-42DOLBDT.js}

@@ -16,7 +16,7 @@ import {
   agentDir,
   ensureVoluteHome,
   nextPort
-} from "./chunk-5YW4B7CG.js";
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/import.ts
 import {

package/dist/{logs-BUHRIQ2L.js → logs-SYRQOL6B.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   resolveAgent
-} from "./chunk-5YW4B7CG.js";
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/logs.ts
 import { spawn } from "child_process";

package/dist/{merge-446QTE7Q.js → merge-CSAVLSLY.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   spawnServer
-} from "./chunk-N4QN44LC.js";
+} from "./chunk-MY74SUOL.js";
 import {
   exec,
   execInherit
@@ -15,7 +15,7 @@ import {
   removeVariant,
   resolveAgent,
   validateBranchName
-} from "./chunk-5YW4B7CG.js";
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/merge.ts
 import { existsSync, mkdirSync, writeFileSync } from "fs";
@@ -113,40 +113,30 @@ async function run(args) {
     const status = (await exec("git", ["status", "--porcelain"], { cwd: variant.path })).trim();
     if (status) {
       console.log("Committing uncommitted changes in variant...");
-      await exec("git", ["add", "-A"], { cwd: variant.path });
-      await exec("git", ["commit", "-m", "Auto-commit uncommitted changes before merge"], {
-        cwd: variant.path
-      });
+      try {
+        await exec("git", ["add", "-A"], { cwd: variant.path });
+        await exec("git", ["commit", "-m", "Auto-commit uncommitted changes before merge"], {
+          cwd: variant.path
+        });
+      } catch (err) {
+        console.error("Failed to auto-commit variant changes:", err);
+        console.error("Please commit or stash changes in the variant manually before merging.");
+        process.exit(1);
+      }
     }
   }
   if (!flags["skip-verify"]) {
     console.log("Verifying variant...");
-    let port = variant.port;
-    let tempServerPid;
-    let running = false;
-    if (variant.pid) {
-      try {
-        process.kill(variant.pid, 0);
-        running = true;
-      } catch {
-      }
-    }
-    if (!running) {
-      console.log("Starting temporary server for verification...");
-      const result = await spawnServer(variant.path, 0, { detached: true });
-      if (!result) {
-        console.error("Failed to start server for verification. Use --skip-verify to skip.");
-        process.exit(1);
-      }
-      port = result.actualPort;
-      tempServerPid = result.child.pid;
+    console.log("Starting temporary server for verification...");
+    const result = await spawnServer(variant.path, 0, { detached: true });
+    if (!result) {
+      console.error("Failed to start server for verification. Use --skip-verify to skip.");
+      process.exit(1);
     }
-    const verified = await verify(port);
-    if (tempServerPid) {
-      try {
-        process.kill(tempServerPid);
-      } catch {
-      }
+    const verified = await verify(result.actualPort);
+    try {
+      process.kill(result.child.pid);
+    } catch {
     }
     if (!verified) {
       console.error("Verification failed. Fix issues or use --skip-verify to proceed anyway.");
@@ -154,11 +144,18 @@ async function run(args) {
     }
     console.log("Verification passed.");
   }
-  if (variant.pid) {
+  const mainStatus = (await exec("git", ["status", "--porcelain"], { cwd: projectRoot })).trim();
+  if (mainStatus) {
+    console.log("Committing uncommitted changes in main...");
     try {
-      process.kill(variant.pid);
-      console.log(`Killed server (pid ${variant.pid})`);
-    } catch {
+      await exec("git", ["add", "-A"], { cwd: projectRoot });
+      await exec("git", ["commit", "-m", "Auto-commit uncommitted changes before merge"], {
+        cwd: projectRoot
+      });
+    } catch (err) {
+      console.error("Failed to auto-commit main changes:", err);
+      console.error("Please commit or stash your changes manually before merging.");
+      process.exit(1);
     }
   }
   console.log(`Merging branch: ${variant.branch}`);
@@ -199,7 +196,7 @@ async function run(args) {
   );
   if (process.env.VOLUTE_SUPERVISOR) return;
   try {
-    const { daemonFetch } = await import("./daemon-client-ZTHW7ROS.js");
+    const { daemonFetch } = await import("./daemon-client-VN24HM5T.js");
     console.log("Restarting agent via daemon...");
     const res = await daemonFetch(`/api/agents/${encodeURIComponent(agentName)}/restart`, {
       method: "POST"

package/dist/{schedule-KKSOVUDF.js → schedule-J37XQM6E.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-H5XQARAP.js";
-import "./chunk-5YW4B7CG.js";
+} from "./chunk-4YXYAMFT.js";
+import "./chunk-6UCG6MIX.js";
 
 // src/commands/schedule.ts
 async function run(args) {

package/dist/{send-WQSVSRDD.js → send-PLOYEYER.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   readNdjson
-} from "./chunk-KSMIWOCN.js";
+} from "./chunk-N4YNKR3Q.js";
 import {
   daemonFetch
-} from "./chunk-H5XQARAP.js";
-import "./chunk-5YW4B7CG.js";
+} from "./chunk-4YXYAMFT.js";
+import "./chunk-6UCG6MIX.js";
 
 // src/commands/send.ts
 import { userInfo } from "os";
@@ -16,13 +16,15 @@ async function run(args) {
     console.error('Usage: volute send <name> "<message>"');
     process.exit(1);
   }
-  const sender = userInfo().username;
+  const agentSelf = process.env.VOLUTE_AGENT;
+  const sender = agentSelf || userInfo().username;
+  const channel = agentSelf ? "agent" : "cli";
   const res = await daemonFetch(`/api/agents/${encodeURIComponent(name)}/message`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({
       content: [{ type: "text", text: message }],
-      channel: "cli",
+      channel,
       sender
     })
   });

package/dist/{start-LKMWS6ZE.js → start-AG7QLULK.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-H5XQARAP.js";
+} from "./chunk-4YXYAMFT.js";
 import {
   resolveAgent
-} from "./chunk-5YW4B7CG.js";
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/start.ts
 async function run(args) {

package/dist/{status-CIEKUI3V.js → status-GCNU4M3K.js}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-H5XQARAP.js";
-import "./chunk-5YW4B7CG.js";
+} from "./chunk-4YXYAMFT.js";
+import "./chunk-6UCG6MIX.js";
 
 // src/commands/status.ts
 async function run(args) {
@@ -44,6 +44,13 @@ async function run(args) {
   for (const ch of agent.channels) {
     console.log(`${ch.name}: ${ch.status}`);
   }
+  if (agent.variants && agent.variants.length > 0) {
+    console.log("");
+    console.log("Variants:");
+    for (const v of agent.variants) {
+      console.log(`  ${v.name}  port=${v.port}  ${v.status}`);
+    }
+  }
 }
 export {
   run

package/dist/{stop-YTOAGYE4.js → stop-IL5Q6NER.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   daemonFetch
-} from "./chunk-H5XQARAP.js";
+} from "./chunk-4YXYAMFT.js";
 import {
   resolveAgent
-} from "./chunk-5YW4B7CG.js";
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/stop.ts
 async function run(args) {

package/dist/{up-AJJ4GCXY.js → up-ZC6G6K4K.js}

@@ -3,8 +3,8 @@ import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
 import {
-  VOLUTE_HOME
-} from "./chunk-5YW4B7CG.js";
+  voluteHome
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/up.ts
 import { spawn } from "child_process";
@@ -13,10 +13,13 @@ import { dirname, resolve } from "path";
 async function run(args) {
   const { flags } = parseArgs(args, {
     port: { type: "number" },
+    host: { type: "string" },
     foreground: { type: "boolean" }
   });
   const port = flags.port ?? 4200;
-  const pidPath = resolve(VOLUTE_HOME, "daemon.pid");
+  const hostname = flags.host ?? "127.0.0.1";
+  const home = voluteHome();
+  const pidPath = resolve(home, "daemon.pid");
   if (existsSync(pidPath)) {
     try {
       const pid = parseInt(readFileSync(pidPath, "utf-8").trim(), 10);
@@ -38,44 +41,25 @@ async function run(args) {
   }
   if (flags.foreground) {
     const { startDaemon } = await import("./daemon.js");
-    await startDaemon({ port, foreground: true });
+    await startDaemon({ port, hostname, foreground: true });
     return;
   }
-  let tsxBin = "";
-  let searchDir = dirname(new URL(import.meta.url).pathname);
-  for (let i = 0; i < 5; i++) {
-    const candidate = resolve(searchDir, "node_modules", ".bin", "tsx");
-    if (existsSync(candidate)) {
-      tsxBin = candidate;
-      break;
-    }
-    searchDir = dirname(searchDir);
-  }
-  if (!tsxBin) {
-    console.error("Could not find tsx binary.");
-    process.exit(1);
-  }
-  let daemonModule = "";
-  searchDir = dirname(new URL(import.meta.url).pathname);
-  for (let i = 0; i < 5; i++) {
-    const candidate = resolve(searchDir, "src", "daemon.ts");
-    if (existsSync(candidate)) {
-      daemonModule = candidate;
-      break;
-    }
-    searchDir = dirname(searchDir);
-  }
-  if (!daemonModule) {
-    console.error("Could not find daemon module.");
+  const daemonModule = resolve(dirname(new URL(import.meta.url).pathname), "daemon.js");
+  if (!existsSync(daemonModule)) {
+    console.error("Could not find daemon module. Run `npm run build` first.");
     process.exit(1);
   }
-  mkdirSync(VOLUTE_HOME, { recursive: true });
-  const logFile = resolve(VOLUTE_HOME, "daemon.log");
+  mkdirSync(home, { recursive: true });
+  const logFile = resolve(home, "daemon.log");
   const logFd = openSync(logFile, "a");
-  const child = spawn(tsxBin, [daemonModule, "--port", String(port)], {
-    stdio: ["ignore", logFd, logFd],
-    detached: true
-  });
+  const child = spawn(
+    process.execPath,
+    [daemonModule, "--port", String(port), "--host", hostname],
+    {
+      stdio: ["ignore", logFd, logFd],
+      detached: true
+    }
+  );
   child.unref();
   const url = `http://localhost:${port}/api/health`;
   const maxWait = 3e4;
@@ -84,7 +68,7 @@ async function run(args) {
     try {
       const res = await fetch(url);
       if (res.ok) {
-        console.log(`Volute daemon running on port ${port} (pid ${child.pid})`);
+        console.log(`Volute daemon running on ${hostname}:${port} (pid ${child.pid})`);
         console.log(`Logs: ${logFile}`);
         return;
       }

package/dist/{upgrade-JACA6YMO.js → upgrade-DD5TNJWU.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   spawnServer
-} from "./chunk-N4QN44LC.js";
+} from "./chunk-MY74SUOL.js";
 import {
   composeTemplate,
   copyTemplateToDir,
@@ -17,7 +17,7 @@ import {
 import {
   addVariant,
   resolveAgent
-} from "./chunk-5YW4B7CG.js";
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/upgrade.ts
 import { existsSync, mkdirSync, rmSync } from "fs";
@@ -189,14 +189,12 @@ async function installAndVerify(agentName, worktreeDir) {
     console.error("Server failed to start within timeout");
     process.exit(1);
   }
-  const { actualPort, child } = result;
-  const pid = child.pid ?? null;
+  const { actualPort } = result;
   addVariant(agentName, {
     name: VARIANT_NAME,
     branch: VARIANT_NAME,
     path: worktreeDir,
     port: actualPort,
-    pid,
     created: (/* @__PURE__ */ new Date()).toISOString()
   });
   console.log(`

package/dist/{variants-HPY4DEWU.js → variants-QQIEKT6M.js}

@@ -7,7 +7,7 @@ import {
   readVariants,
   resolveAgent,
   writeVariants
-} from "./chunk-5YW4B7CG.js";
+} from "./chunk-6UCG6MIX.js";
 
 // src/commands/variants.ts
 async function run(args) {
@@ -39,7 +39,7 @@ async function run(args) {
   );
   const updated = results.map(({ status, ...v }) => ({
     ...v,
-    pid: status === "dead" ? null : v.pid
+    running: status === "running"
   }));
   writeVariants(name, updated);
   if (json) {