volute 0.4.0 → 0.6.0

package/dist/{chunk-I6OHXCMV.js → chunk-G6ZNGLUX.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   loadMergedEnv
-} from "./chunk-DNOXHLE5.js";
+} from "./chunk-H7AMDUIA.js";
 import {
   applyIsolation
-} from "./chunk-SOZA2TLP.js";
+} from "./chunk-W76KWE23.js";
 import {
   agentDir,
   findAgent,
@@ -13,11 +13,11 @@ import {
   setVariantRunning,
   validateBranchName,
   voluteHome
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UWHWAPGO.js";
 
 // src/lib/agent-manager.ts
 import { execFile, spawn } from "child_process";
-import { createWriteStream, existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, unlinkSync as unlinkSync2 } from "fs";
+import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync2, unlinkSync as unlinkSync2 } from "fs";
 import { resolve } from "path";
 import { promisify } from "util";
 
@@ -58,6 +58,45 @@ function clearJsonMap(path, map) {
   }
 }
 
+// src/lib/rotating-log.ts
+import { createWriteStream, existsSync as existsSync2, renameSync, statSync } from "fs";
+import { Writable } from "stream";
+var MAX_SIZE = 10 * 1024 * 1024;
+var RotatingLog = class extends Writable {
+  constructor(path, maxSize = MAX_SIZE) {
+    super();
+    this.path = path;
+    this.maxSize = maxSize;
+    this.on("error", () => {
+    });
+    try {
+      this.size = existsSync2(path) ? statSync(path).size : 0;
+    } catch {
+      this.size = 0;
+    }
+    this.stream = createWriteStream(path, { flags: "a" });
+  }
+  stream;
+  size;
+  _write(chunk, _encoding, callback) {
+    this.size += chunk.length;
+    if (this.size > this.maxSize) {
+      try {
+        renameSync(this.path, `${this.path}.1`);
+        const oldStream = this.stream;
+        this.stream = createWriteStream(this.path);
+        this.size = chunk.length;
+        oldStream.end();
+      } catch {
+      }
+    }
+    this.stream.write(chunk, callback);
+  }
+  _final(callback) {
+    this.stream.end(callback);
+  }
+};
+
 // src/lib/agent-manager.ts
 var execFileAsync = promisify(execFile);
 var MAX_RESTART_ATTEMPTS = 5;
@@ -78,7 +117,7 @@ var AgentManager = class {
       return { dir: variant.path, port: variant.port, isVariant: true, baseName, variantName };
     }
     const dir = agentDir(baseName);
-    if (!existsSync2(dir)) throw new Error(`Agent directory missing: ${dir}`);
+    if (!existsSync3(dir)) throw new Error(`Agent directory missing: ${dir}`);
     return { dir, port: entry.port, isVariant: false, baseName };
   }
   async startAgent(name) {
@@ -100,9 +139,7 @@ var AgentManager = class {
     const voluteDir = resolve(dir, ".volute");
     const logsDir = resolve(voluteDir, "logs");
     mkdirSync(logsDir, { recursive: true });
-    const logStream = createWriteStream(resolve(logsDir, "agent.log"), {
-      flags: "a"
-    });
+    const logStream = new RotatingLog(resolve(logsDir, "agent.log"));
     const agentEnv = loadMergedEnv(dir);
     const { VOLUTE_DAEMON_TOKEN: _, ...parentEnv } = process.env;
     const env = { ...parentEnv, ...agentEnv, VOLUTE_AGENT: name };
@@ -198,7 +235,7 @@ var AgentManager = class {
   }
   async handleRestart(name, dir) {
     const restartPath = resolve(dir, ".volute", "restart.json");
-    if (!existsSync2(restartPath)) return false;
+    if (!existsSync3(restartPath)) return false;
     try {
       const signal = JSON.parse(readFileSync2(restartPath, "utf-8"));
       unlinkSync2(restartPath);
@@ -326,6 +363,7 @@ export {
   loadJsonMap,
   saveJsonMap,
   clearJsonMap,
+  RotatingLog,
   AgentManager,
   initAgentManager,
   getAgentManager

package/dist/{chunk-DNOXHLE5.js → chunk-H7AMDUIA.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UWHWAPGO.js";
 
 // src/lib/env.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";

package/dist/{chunk-YGFIWIOF.js → chunk-JR4UXCTO.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   voluteHome
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UWHWAPGO.js";
 
 // src/lib/daemon-client.ts
 import { existsSync, readFileSync } from "fs";

package/dist/{chunk-3C2XR4IY.js → chunk-UWHWAPGO.js}

@@ -1,27 +1,137 @@
 #!/usr/bin/env node
 
 // src/lib/variants.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { resolve as resolve2 } from "path";
+
+// src/lib/registry.ts
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "fs";
 import { homedir } from "os";
-import { resolve } from "path";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
 function voluteHome() {
-  return process.env.VOLUTE_HOME || resolve(homedir(), ".volute");
+  if (process.env.VOLUTE_HOME) return process.env.VOLUTE_HOME;
+  const dir = dirname(fileURLToPath(import.meta.url));
+  if (dir.endsWith("/src/lib")) {
+    throw new Error(
+      'VOLUTE_HOME must be set when running from source. For tests, run via "npm test" or add "--import ./test/setup.ts".'
+    );
+  }
+  return resolve(homedir(), ".volute");
+}
+function ensureVoluteHome() {
+  mkdirSync(resolve(voluteHome(), "agents"), { recursive: true });
+}
+function readRegistry() {
+  const registryPath = resolve(voluteHome(), "agents.json");
+  if (!existsSync(registryPath)) return [];
+  try {
+    const entries = JSON.parse(readFileSync(registryPath, "utf-8"));
+    return entries.map((e) => ({ ...e, running: e.running ?? false }));
+  } catch {
+    return [];
+  }
+}
+function writeRegistry(entries) {
+  ensureVoluteHome();
+  const registryPath = resolve(voluteHome(), "agents.json");
+  const tmpPath = `${registryPath}.tmp`;
+  writeFileSync(tmpPath, `${JSON.stringify(entries, null, 2)}
+`);
+  renameSync(tmpPath, registryPath);
+}
+var AGENT_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+var AGENT_NAME_MAX = 64;
+function validateAgentName(name) {
+  if (!name) return "Agent name is required";
+  if (name.length > AGENT_NAME_MAX)
+    return `Agent name must be at most ${AGENT_NAME_MAX} characters`;
+  if (!AGENT_NAME_RE.test(name)) {
+    return "Agent name must start with alphanumeric and contain only alphanumeric, dots, dashes, or underscores";
+  }
+  return null;
+}
+function addAgent(name, port) {
+  const err = validateAgentName(name);
+  if (err) throw new Error(err);
+  const entries = readRegistry();
+  const filtered = entries.filter((e) => e.name !== name);
+  filtered.push({ name, port, created: (/* @__PURE__ */ new Date()).toISOString(), running: false });
+  writeRegistry(filtered);
+}
+function removeAgent(name) {
+  const entries = readRegistry();
+  writeRegistry(entries.filter((e) => e.name !== name));
+}
+function setAgentRunning(name, running) {
+  const entries = readRegistry();
+  const entry = entries.find((e) => e.name === name);
+  if (entry) {
+    entry.running = running;
+    writeRegistry(entries);
+  }
+}
+function findAgent(name) {
+  return readRegistry().find((e) => e.name === name);
+}
+function agentDir(name) {
+  return resolve(voluteHome(), "agents", name);
+}
+function nextPort() {
+  const entries = readRegistry();
+  const usedPorts = new Set(entries.map((e) => e.port));
+  for (const entry of entries) {
+    for (const v of readVariants(entry.name)) {
+      if (v.port) usedPorts.add(v.port);
+    }
+  }
+  let port = 4100;
+  while (usedPorts.has(port)) port++;
+  if (port > 65535) throw new Error("No available ports \u2014 all ports 4100-65535 are allocated");
+  return port;
+}
+function daemonLoopback() {
+  const host = process.env.VOLUTE_DAEMON_HOSTNAME || "127.0.0.1";
+  if (host === "0.0.0.0") return "127.0.0.1";
+  if (host === "::") return "[::1]";
+  return host;
+}
+function resolveAgent(name) {
+  const [baseName, variantName] = name.split("@", 2);
+  const entry = findAgent(baseName);
+  if (!entry) {
+    throw new Error(`Unknown agent: ${baseName}`);
+  }
+  const dir = agentDir(baseName);
+  if (!existsSync(dir)) {
+    throw new Error(`Agent directory missing: ${dir}`);
+  }
+  if (variantName) {
+    const variant = findVariant(baseName, variantName);
+    if (!variant) {
+      throw new Error(`Unknown variant: ${variantName} (agent: ${baseName})`);
+    }
+    return { entry: { ...entry, port: variant.port }, dir: variant.path };
+  }
+  return { entry, dir };
 }
+
+// src/lib/variants.ts
 function variantsPath() {
-  return resolve(voluteHome(), "variants.json");
+  return resolve2(voluteHome(), "variants.json");
 }
 function readAllVariants() {
   const path = variantsPath();
-  if (!existsSync(path)) return {};
+  if (!existsSync2(path)) return {};
   try {
-    return JSON.parse(readFileSync(path, "utf-8"));
+    return JSON.parse(readFileSync2(path, "utf-8"));
   } catch {
     return {};
   }
 }
 function writeAllVariants(all) {
-  mkdirSync(voluteHome(), { recursive: true });
-  writeFileSync(variantsPath(), `${JSON.stringify(all, null, 2)}
+  mkdirSync2(voluteHome(), { recursive: true });
+  writeFileSync2(variantsPath(), `${JSON.stringify(all, null, 2)}
 `);
 }
 function readVariants(agentName) {
@@ -102,104 +212,6 @@ function validateBranchName(branch) {
   return null;
 }
 
-// src/lib/registry.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, renameSync, writeFileSync as writeFileSync2 } from "fs";
-import { homedir as homedir2 } from "os";
-import { resolve as resolve2 } from "path";
-function voluteHome2() {
-  return process.env.VOLUTE_HOME || resolve2(homedir2(), ".volute");
-}
-function ensureVoluteHome() {
-  mkdirSync2(resolve2(voluteHome2(), "agents"), { recursive: true });
-}
-function readRegistry() {
-  const registryPath = resolve2(voluteHome2(), "agents.json");
-  if (!existsSync2(registryPath)) return [];
-  try {
-    const entries = JSON.parse(readFileSync2(registryPath, "utf-8"));
-    return entries.map((e) => ({ ...e, running: e.running ?? false }));
-  } catch {
-    return [];
-  }
-}
-function writeRegistry(entries) {
-  ensureVoluteHome();
-  const registryPath = resolve2(voluteHome2(), "agents.json");
-  const tmpPath = `${registryPath}.tmp`;
-  writeFileSync2(tmpPath, `${JSON.stringify(entries, null, 2)}
-`);
-  renameSync(tmpPath, registryPath);
-}
-var AGENT_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
-var AGENT_NAME_MAX = 64;
-function validateAgentName(name) {
-  if (!name) return "Agent name is required";
-  if (name.length > AGENT_NAME_MAX)
-    return `Agent name must be at most ${AGENT_NAME_MAX} characters`;
-  if (!AGENT_NAME_RE.test(name)) {
-    return "Agent name must start with alphanumeric and contain only alphanumeric, dots, dashes, or underscores";
-  }
-  return null;
-}
-function addAgent(name, port) {
-  const err = validateAgentName(name);
-  if (err) throw new Error(err);
-  const entries = readRegistry();
-  const filtered = entries.filter((e) => e.name !== name);
-  filtered.push({ name, port, created: (/* @__PURE__ */ new Date()).toISOString(), running: false });
-  writeRegistry(filtered);
-}
-function removeAgent(name) {
-  const entries = readRegistry();
-  writeRegistry(entries.filter((e) => e.name !== name));
-}
-function setAgentRunning(name, running) {
-  const entries = readRegistry();
-  const entry = entries.find((e) => e.name === name);
-  if (entry) {
-    entry.running = running;
-    writeRegistry(entries);
-  }
-}
-function findAgent(name) {
-  return readRegistry().find((e) => e.name === name);
-}
-function agentDir(name) {
-  return resolve2(voluteHome2(), "agents", name);
-}
-function nextPort() {
-  const entries = readRegistry();
-  const usedPorts = new Set(entries.map((e) => e.port));
-  for (const entry of entries) {
-    for (const v of readVariants(entry.name)) {
-      if (v.port) usedPorts.add(v.port);
-    }
-  }
-  let port = 4100;
-  while (usedPorts.has(port)) port++;
-  if (port > 65535) throw new Error("No available ports \u2014 all ports 4100-65535 are allocated");
-  return port;
-}
-function resolveAgent(name) {
-  const [baseName, variantName] = name.split("@", 2);
-  const entry = findAgent(baseName);
-  if (!entry) {
-    throw new Error(`Unknown agent: ${baseName}`);
-  }
-  const dir = agentDir(baseName);
-  if (!existsSync2(dir)) {
-    throw new Error(`Agent directory missing: ${dir}`);
-  }
-  if (variantName) {
-    const variant = findVariant(baseName, variantName);
-    if (!variant) {
-      throw new Error(`Unknown variant: ${variantName} (agent: ${baseName})`);
-    }
-    return { entry: { ...entry, port: variant.port }, dir: variant.path };
-  }
-  return { entry, dir };
-}
-
 export {
   readVariants,
   writeVariants,
@@ -211,7 +223,7 @@ export {
   removeAllVariants,
   checkHealth,
   validateBranchName,
-  voluteHome2 as voluteHome,
+  voluteHome,
   ensureVoluteHome,
   readRegistry,
   validateAgentName,
@@ -221,5 +233,6 @@ export {
   findAgent,
   agentDir,
   nextPort,
+  daemonLoopback,
   resolveAgent
 };

package/dist/{chunk-SOZA2TLP.js → chunk-W76KWE23.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   validateAgentName
-} from "./chunk-3C2XR4IY.js";
+} from "./chunk-UWHWAPGO.js";
 
 // src/lib/isolation.ts
 import { execFile, execFileSync } from "child_process";

package/dist/{chunk-GSPKUPKU.js → chunk-XUA3JUFK.js}

@@ -116,5 +116,6 @@ export {
   findTemplatesRoot,
   composeTemplate,
   copyTemplateToDir,
-  applyInitFiles
+  applyInitFiles,
+  listFiles
 };

package/dist/chunk-ZYGKG6VC.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+// src/lib/read-stdin.ts
+import { isatty } from "tty";
+async function readStdin() {
+  if (isatty(0)) return void 0;
+  const chunks = [];
+  try {
+    for await (const chunk of process.stdin) {
+      chunks.push(chunk);
+    }
+  } catch (err) {
+    console.error(`Failed to read from stdin: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+  const text = Buffer.concat(chunks).toString().replace(/\r?\n$/, "");
+  return text || void 0;
+}
+
+export {
+  readStdin
+};