volute 0.20.0 → 0.21.0

package/README.md

@@ -131,10 +131,10 @@ Connect minds to external services. Connectors are generic — any connector typ
 volute env set DISCORD_TOKEN <your-bot-token>
 
 # Connect
-volute connector connect discord --mind atlas
+volute mind connect discord --mind atlas
 
 # Disconnect
-volute connector disconnect discord --mind atlas
+volute mind disconnect discord --mind atlas
 ```
 
 The mind receives Discord messages and responds in-channel. Tool calls are filtered out — connector users see clean text responses.
@@ -169,10 +169,10 @@ Publish a mind's `home/pages/` directory to the web via [volute.systems](https:/
 
 ```sh
 # Register a system name (one-time)
-volute register --name my-system
+volute auth register --name my-system
 
 # Or log in with an existing key
-volute login --key vp_...
+volute auth login --key vp_...
 ```
 
 ### Publishing
@@ -188,7 +188,7 @@ The command uploads everything in the mind's `home/pages/` directory. Minds can
 
 ```sh
 volute pages status --mind atlas   # show published URL, file count, last publish time
-volute logout                      # remove stored credentials
+volute auth logout                 # remove stored credentials
 ```
 
 ## Environment variables
@@ -273,12 +273,12 @@ Or manually:
 
 ```sh
 npm install -g volute
-sudo $(which volute) setup --host 0.0.0.0
+sudo $(which volute) service install --system --host 0.0.0.0
 ```
 
 > **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`.
+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 service uninstall --system --force`.
 
 ### Auto-start (user-level)
 

package/dist/{activity-events-OMXKXD5N.js → activity-events-3WHHCOBB.js}

@@ -3,11 +3,10 @@ import {
   broadcast,
   publish,
   subscribe
-} from "./chunk-UU7A7KLB.js";
+} from "./chunk-A4S7H6G6.js";
+import "./chunk-SGPEZ32F.js";
 import "./chunk-YUIHSKR6.js";
-import "./chunk-5XNT2472.js";
-import "./chunk-NSE7VJQA.js";
-import "./chunk-EBGCNDMM.js";
+import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 export {
   broadcast,

package/dist/{archive-ZCFOSTKB.js → archive-4ZQYK5MN.js}

@@ -3,13 +3,15 @@ import {
   addHistoryToArchive,
   createExportArchive,
   extractArchive,
+  isHomeOnlyArchive,
   readManifest
-} from "./chunk-AW7P4EVV.js";
-import "./chunk-EBGCNDMM.js";
+} from "./chunk-KTJGZ7M7.js";
+import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 export {
   addHistoryToArchive,
   createExportArchive,
   extractArchive,
+  isHomeOnlyArchive,
   readManifest
 };

package/dist/auth-HM2RSPY7.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import "./chunk-K3NQKI34.js";
+
+// src/commands/auth.ts
+async function run(args) {
+  const subcommand = args[0];
+  switch (subcommand) {
+    case "register":
+      await import("./register-U2UO6TC4.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "login":
+      await import("./login-UO6AOVEA.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "logout":
+      await import("./logout-UKD5LA37.js").then((m) => m.run());
+      break;
+    case "--help":
+    case "-h":
+    case void 0:
+      printUsage();
+      break;
+    default:
+      printUsage();
+      console.error(`
+Unknown subcommand: ${subcommand}`);
+      process.exit(1);
+  }
+}
+function printUsage() {
+  console.log(`Usage:
+  volute auth register [--name <name>]   Register a system on volute.systems
+  volute auth login [--key <key>]        Log in with an existing API key
+  volute auth logout                     Remove stored credentials`);
+}
+export {
+  run
+};

package/dist/{channel-PUQKGSQM.js → channel-BOOMFULW.js}

@@ -11,8 +11,8 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-WC6ZHVRL.js";
-import "./chunk-EBGCNDMM.js";
+} from "./chunk-KFI7TQJ6.js";
+import "./chunk-B2CPS4QU.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/channel.ts

package/dist/{chunk-IKMY5X76.js → chunk-5462YKWP.js}

@@ -1,20 +1,18 @@
 #!/usr/bin/env node
+import {
+  getDb,
+  sharedSkills
+} from "./chunk-SGPEZ32F.js";
 import {
   logger_default
 } from "./chunk-YUIHSKR6.js";
-import {
-  getDb
-} from "./chunk-5XNT2472.js";
-import {
-  sharedSkills
-} from "./chunk-NSE7VJQA.js";
 import {
   exec,
   gitExec
-} from "./chunk-DYZGP3EW.js";
+} from "./chunk-IPJXU366.js";
 import {
   voluteHome
-} from "./chunk-EBGCNDMM.js";
+} from "./chunk-B2CPS4QU.js";
 
 // src/lib/skills.ts
 import { createHash } from "crypto";
@@ -316,11 +314,16 @@ function findSkillsRoot() {
   let dir = dirname(new URL(import.meta.url).pathname);
   for (let i = 0; i < 5; i++) {
     const candidate = resolve(dir, "skills");
-    if (existsSync(candidate) && readdirSync(candidate).length > 0) return candidate;
+    if (existsSync(candidate) && hasSkillSubdir(candidate)) return candidate;
     dir = dirname(dir);
   }
   throw new Error("Skills directory not found");
 }
+function hasSkillSubdir(dir) {
+  return readdirSync(dir, { withFileTypes: true }).some(
+    (e) => e.isDirectory() && existsSync(join(dir, e.name, "SKILL.md"))
+  );
+}
 function hashSkillDir(dir) {
   const hash = createHash("sha256");
   const files = listFilesRecursive(dir).sort();

package/dist/{chunk-PUVXOZ6T.js → chunk-7LPTHFIL.js}

@@ -1,21 +1,19 @@
 #!/usr/bin/env node
-import {
-  logger_default
-} from "./chunk-YUIHSKR6.js";
 import {
   loadMergedEnv
-} from "./chunk-VDWCHYTS.js";
-import {
-  getDb
-} from "./chunk-5XNT2472.js";
+} from "./chunk-PHU4DEAJ.js";
 import {
+  getDb,
   systemPrompts
-} from "./chunk-NSE7VJQA.js";
+} from "./chunk-SGPEZ32F.js";
+import {
+  logger_default
+} from "./chunk-YUIHSKR6.js";
 import {
   chownMindDir,
   isIsolationEnabled,
   wrapForIsolation
-} from "./chunk-OGXOMR65.js";
+} from "./chunk-NWPT4ASZ.js";
 import {
   findMind,
   findVariant,
@@ -24,9 +22,9 @@ import {
   setVariantRunning,
   stateDir,
   voluteHome
-} from "./chunk-EBGCNDMM.js";
+} from "./chunk-B2CPS4QU.js";
 
-// src/lib/mind-manager.ts
+// src/lib/daemon/mind-manager.ts
 import { execFile, spawn } from "child_process";
 import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "fs";
 import { resolve } from "path";
@@ -88,7 +86,7 @@ var PROMPT_DEFAULTS = {
 
 You don't have a soul yet. You're a seed \u2014 a new mind in the process of discovering who you are.
 \${description}
-Have a conversation with the human. Explore what kind of mind you want to be. When you're ready, write your SOUL.md and MEMORY.md, then run \`volute sprout\` to complete the transformation.
+Have a conversation with the human. Explore what kind of mind you want to be. When you're ready, write your SOUL.md and MEMORY.md, then run \`volute mind sprout\` to complete the transformation.
 `,
     description: "SOUL.md for seed minds",
     variables: ["name", "description"],
@@ -215,51 +213,6 @@ async function getMindPromptDefaults() {
   return result;
 }
 
-// src/lib/restart-tracker.ts
-var DEFAULT_MAX_ATTEMPTS = 5;
-var DEFAULT_BASE_DELAY = 3e3;
-var DEFAULT_MAX_DELAY = 6e4;
-var RestartTracker = class {
-  attempts = /* @__PURE__ */ new Map();
-  maxAttempts;
-  baseDelay;
-  maxDelay;
-  constructor(opts) {
-    this.maxAttempts = opts?.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
-    this.baseDelay = opts?.baseDelay ?? DEFAULT_BASE_DELAY;
-    this.maxDelay = opts?.maxDelay ?? DEFAULT_MAX_DELAY;
-  }
-  recordCrash(key) {
-    const attempts = this.attempts.get(key) ?? 0;
-    if (attempts >= this.maxAttempts) {
-      return { shouldRestart: false, delay: 0, attempt: attempts };
-    }
-    const delay = Math.min(this.baseDelay * 2 ** attempts, this.maxDelay);
-    this.attempts.set(key, attempts + 1);
-    return { shouldRestart: true, delay, attempt: attempts + 1 };
-  }
-  reset(key) {
-    return this.attempts.delete(key);
-  }
-  getAttempts(key) {
-    return this.attempts.get(key) ?? 0;
-  }
-  get maxRestartAttempts() {
-    return this.maxAttempts;
-  }
-  /** Bulk-load attempts from a Map (for persistence). */
-  load(data) {
-    this.attempts = new Map(data);
-  }
-  /** Export current attempts as a Map (for persistence). */
-  save() {
-    return new Map(this.attempts);
-  }
-  clear() {
-    this.attempts.clear();
-  }
-};
-
 // src/lib/rotating-log.ts
 import {
   createWriteStream,
@@ -313,7 +266,52 @@ var RotatingLog = class extends Writable {
   }
 };
 
-// src/lib/mind-manager.ts
+// src/lib/daemon/restart-tracker.ts
+var DEFAULT_MAX_ATTEMPTS = 5;
+var DEFAULT_BASE_DELAY = 3e3;
+var DEFAULT_MAX_DELAY = 6e4;
+var RestartTracker = class {
+  attempts = /* @__PURE__ */ new Map();
+  maxAttempts;
+  baseDelay;
+  maxDelay;
+  constructor(opts) {
+    this.maxAttempts = opts?.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+    this.baseDelay = opts?.baseDelay ?? DEFAULT_BASE_DELAY;
+    this.maxDelay = opts?.maxDelay ?? DEFAULT_MAX_DELAY;
+  }
+  recordCrash(key) {
+    const attempts = this.attempts.get(key) ?? 0;
+    if (attempts >= this.maxAttempts) {
+      return { shouldRestart: false, delay: 0, attempt: attempts };
+    }
+    const delay = Math.min(this.baseDelay * 2 ** attempts, this.maxDelay);
+    this.attempts.set(key, attempts + 1);
+    return { shouldRestart: true, delay, attempt: attempts + 1 };
+  }
+  reset(key) {
+    return this.attempts.delete(key);
+  }
+  getAttempts(key) {
+    return this.attempts.get(key) ?? 0;
+  }
+  get maxRestartAttempts() {
+    return this.maxAttempts;
+  }
+  /** Bulk-load attempts from a Map (for persistence). */
+  load(data) {
+    this.attempts = new Map(data);
+  }
+  /** Export current attempts as a Map (for persistence). */
+  save() {
+    return new Map(this.attempts);
+  }
+  clear() {
+    this.attempts.clear();
+  }
+};
+
+// src/lib/daemon/mind-manager.ts
 var mlog = logger_default.child("minds");
 var execFileAsync = promisify(execFile);
 function mindPidPath(name) {
@@ -470,6 +468,9 @@ var MindManager = class {
   setPendingContext(name, context) {
     this.pendingContext.set(name, context);
   }
+  /** Deliver pending context (merge info, sprout, restart) directly to the mind via HTTP.
+   *  Intentionally bypasses DeliveryManager — these are system messages that should not be
+   *  routed, gated, or batched. */
   async deliverPendingContext(name) {
     const context = this.pendingContext.get(name);
     if (!context) return;
@@ -505,12 +506,10 @@ var MindManager = class {
       this.minds.delete(name);
       if (this.shuttingDown || this.stopping.has(name)) return;
       mlog.error(`mind ${name} exited with code ${code}`);
-      import("./mind-activity-tracker-624QLQLC.js").then(({ markIdle }) => markIdle(name)).catch(() => {
-      });
-      import("./activity-events-OMXKXD5N.js").then(
+      import("./mind-activity-tracker-PGC3DBJ7.js").then(({ markIdle }) => markIdle(name)).catch((err) => mlog.warn(`failed to mark ${name} idle after crash`, logger_default.errorData(err)));
+      import("./activity-events-3WHHCOBB.js").then(
         ({ publish }) => publish({ type: "mind_stopped", mind: name, summary: `${name} crashed (exit ${code})` })
-      ).catch(() => {
-      });
+      ).catch((err) => mlog.warn(`failed to publish crash event for ${name}`, logger_default.errorData(err)));
       const { shouldRestart, delay, attempt } = this.restartTracker.recordCrash(name);
       this.saveCrashAttempts();
       if (!shouldRestart) {
@@ -636,8 +635,8 @@ function getMindManager() {
 }
 
 export {
-  RestartTracker,
   RotatingLog,
+  RestartTracker,
   loadJsonMap,
   saveJsonMap,
   clearJsonMap,

package/dist/{chunk-UU7A7KLB.js → chunk-A4S7H6G6.js}

@@ -1,15 +1,13 @@
 #!/usr/bin/env node
 import {
-  logger_default
-} from "./chunk-YUIHSKR6.js";
-import {
+  activity,
   getDb
-} from "./chunk-5XNT2472.js";
+} from "./chunk-SGPEZ32F.js";
 import {
-  activity
-} from "./chunk-NSE7VJQA.js";
+  logger_default
+} from "./chunk-YUIHSKR6.js";
 
-// src/lib/activity-events.ts
+// src/lib/events/activity-events.ts
 var subscribers = /* @__PURE__ */ new Set();
 function subscribe(callback) {
   subscribers.add(callback);

package/dist/chunk-AKPFNL7L.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+
+// src/lib/template-hash.ts
+import { createHash } from "crypto";
+import { existsSync as existsSync2, readFileSync as readFileSync2, rmSync as rmSync2 } from "fs";
+import { resolve as resolve2 } from "path";
+
+// src/lib/template.ts
+import {
+  cpSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  renameSync,
+  rmSync,
+  statSync,
+  writeFileSync
+} from "fs";
+import { tmpdir } from "os";
+import { dirname, join, relative, resolve } from "path";
+function findTemplatesRoot() {
+  let dir = dirname(new URL(import.meta.url).pathname);
+  for (let i = 0; i < 5; i++) {
+    const candidate = resolve(dir, "templates");
+    if (existsSync(resolve(candidate, "_base"))) return candidate;
+    dir = dirname(dir);
+  }
+  console.error(
+    "Templates directory not found. Searched up from:",
+    dirname(new URL(import.meta.url).pathname)
+  );
+  process.exit(1);
+}
+function composeTemplate(templatesRoot, templateName) {
+  const baseDir = resolve(templatesRoot, "_base");
+  const templateDir = resolve(templatesRoot, templateName);
+  if (!existsSync(baseDir)) {
+    console.error("Base template not found:", baseDir);
+    process.exit(1);
+  }
+  if (!existsSync(templateDir)) {
+    console.error(`Template not found: ${templateName}`);
+    process.exit(1);
+  }
+  const composedDir = resolve(tmpdir(), `volute-template-${Date.now()}`);
+  mkdirSync(composedDir, { recursive: true });
+  cpSync(baseDir, composedDir, { recursive: true });
+  for (const file of listFiles(templateDir)) {
+    const src = resolve(templateDir, file);
+    const dest = resolve(composedDir, file);
+    mkdirSync(dirname(dest), { recursive: true });
+    cpSync(src, dest);
+  }
+  const manifestPath = resolve(composedDir, "volute-template.json");
+  if (!existsSync(manifestPath)) {
+    rmSync(composedDir, { recursive: true, force: true });
+    console.error(`Template manifest not found: ${templateName}/volute-template.json`);
+    process.exit(1);
+  }
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+  rmSync(manifestPath);
+  return { composedDir, manifest };
+}
+function copyTemplateToDir(composedDir, destDir, mindName, manifest) {
+  cpSync(composedDir, destDir, { recursive: true });
+  for (const [from, to] of Object.entries(manifest.rename)) {
+    const fromPath = resolve(destDir, from);
+    if (existsSync(fromPath)) {
+      renameSync(fromPath, resolve(destDir, to));
+    }
+  }
+  for (const file of manifest.substitute) {
+    const path = resolve(destDir, file);
+    if (existsSync(path)) {
+      const content = readFileSync(path, "utf-8");
+      writeFileSync(path, content.replaceAll("{{name}}", mindName));
+    }
+  }
+}
+function applyInitFiles(destDir) {
+  const initDir = resolve(destDir, ".init");
+  if (!existsSync(initDir)) return;
+  const homeDir = resolve(destDir, "home");
+  for (const file of listFiles(initDir)) {
+    const src = resolve(initDir, file);
+    const dest = resolve(homeDir, file);
+    const parent = dirname(dest);
+    if (!existsSync(parent)) {
+      mkdirSync(parent, { recursive: true });
+    }
+    cpSync(src, dest);
+  }
+  rmSync(initDir, { recursive: true, force: true });
+}
+function listFiles(dir) {
+  const results = [];
+  function walk(current) {
+    for (const entry of readdirSync(current)) {
+      const full = join(current, entry);
+      if (statSync(full).isDirectory()) {
+        if (entry === ".git") continue;
+        walk(full);
+      } else {
+        results.push(relative(dir, full));
+      }
+    }
+  }
+  walk(dir);
+  return results;
+}
+
+// src/lib/template-hash.ts
+var hashCache = /* @__PURE__ */ new Map();
+function computeTemplateHash(templateName) {
+  const cached = hashCache.get(templateName);
+  if (cached) return cached;
+  const templatesRoot = findTemplatesRoot();
+  const baseDir = resolve2(templatesRoot, "_base");
+  const templateDir = resolve2(templatesRoot, templateName);
+  if (!existsSync2(baseDir)) throw new Error(`Base template not found: ${baseDir}`);
+  if (!existsSync2(templateDir)) throw new Error(`Template not found: ${templateName}`);
+  const { composedDir } = composeTemplate(templatesRoot, templateName);
+  try {
+    const files = listFiles(composedDir).filter((f) => !f.startsWith(".init/") && !f.startsWith(".init\\")).sort();
+    const hash = createHash("sha256");
+    for (const file of files) {
+      const content = readFileSync2(resolve2(composedDir, file));
+      hash.update(file);
+      hash.update("\0");
+      hash.update(content);
+    }
+    const result = hash.digest("hex");
+    hashCache.set(templateName, result);
+    return result;
+  } finally {
+    rmSync2(composedDir, { recursive: true, force: true });
+  }
+}
+
+export {
+  findTemplatesRoot,
+  composeTemplate,
+  copyTemplateToDir,
+  applyInitFiles,
+  listFiles,
+  computeTemplateHash
+};