volute 0.27.0 → 0.29.0

package/dist/skills/dreaming/references/INSTALL.md

@@ -34,23 +34,9 @@ Add to `.config/volute.json` under `schedules`:
 Or via CLI:
 
 ```bash
-volute schedule add --mind <name> --id dream --cron "0 3 * * *" --message "it's 3am. you are dreaming...."
+volute clock add --mind <name> --id dream --cron "0 3 * * *" --channel system:dream --while-sleeping trigger-wake --message "it's 3am. you are dreaming...."
 ```
 
-## 3. Sleep integration (optional)
+## 3. Sleep integration
 
-If your mind uses the sleep system, add `system:dream` to wake triggers so the dream schedule wakes the mind briefly:
-
-In `.config/volute.json`, add to the `sleep` section:
-
-```json
-{
-  "sleep": {
-    "wakeTriggers": {
-      "channels": ["system:dream"]
-    }
-  }
-}
-```
-
-The mind will wake for the dream, then return to sleep when done.
+The `--while-sleeping trigger-wake` flag on the schedule tells the clock system to briefly wake the mind for the dream, then return to sleep when done. No additional wake trigger configuration is needed.

package/dist/skills/shared-files/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: Shared Files
+description: This skill should be used when working with shared files, the shared folder, collaborating with other minds, sharing files between minds, merging shared changes, pulling shared updates, or checking shared status.
+---
+
+# Shared Files
+
+The `shared/` folder in your home directory is a collaborative space backed by a git repo. Each mind works on its own branch, and changes are merged into `main` to share with others.
+
+## Before working
+
+Pull the latest changes from main before starting work:
+
+```bash
+tsx .claude/skills/shared-files/scripts/pull.ts
+```
+
+## Reading and writing files
+
+Just use files in `shared/` normally — they auto-commit like everything else in your home directory.
+
+## Merging your changes to main
+
+When you're ready to share your work with other minds:
+
+```bash
+tsx .claude/skills/shared-files/scripts/merge.ts "description of changes"
+```
+
+This squash-merges your branch into main and resets your branch to the new main. If there are conflicts, pull first, reconcile, and try again.
+
+## Viewing history
+
+```bash
+git -C shared log --oneline main
+```
+
+## Checking status
+
+See what you've changed compared to main:
+
+```bash
+git -C shared diff main...HEAD --stat
+```

package/dist/skills/shared-files/scripts/merge.ts

@@ -0,0 +1,72 @@
+#!/usr/bin/env tsx
+/**
+ * Merge the mind's shared branch into main via the daemon API.
+ * Usage: tsx merge.ts "commit message"
+ */
+import { execFileSync } from "node:child_process";
+import { resolve } from "node:path";
+
+const message = process.argv[2];
+if (!message) {
+  console.error('Usage: tsx merge.ts "commit message"');
+  process.exit(1);
+}
+
+const mind = process.env.VOLUTE_MIND;
+const port = process.env.VOLUTE_DAEMON_PORT;
+const token = process.env.VOLUTE_DAEMON_TOKEN;
+
+if (!mind || !port || !token) {
+  console.error("Missing VOLUTE_MIND, VOLUTE_DAEMON_PORT, or VOLUTE_DAEMON_TOKEN");
+  process.exit(1);
+}
+
+// Commit any pending changes in the worktree first
+const worktree = resolve("shared");
+try {
+  const status = execFileSync("git", ["status", "--porcelain"], {
+    cwd: worktree,
+    encoding: "utf-8",
+  }).trim();
+  if (status) {
+    execFileSync("git", ["add", "-A"], { cwd: worktree, stdio: "ignore" });
+    execFileSync("git", ["commit", "--author", `${mind} <${mind}@volute>`, "-m", `wip: ${mind}`], {
+      cwd: worktree,
+      stdio: "ignore",
+    });
+  }
+} catch (err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  console.error(`Failed to commit pending changes in shared worktree: ${msg}`);
+  process.exit(1);
+}
+
+// Call daemon merge endpoint
+const url = `http://localhost:${port}/api/minds/${encodeURIComponent(mind)}/shared/merge`;
+let res: Response;
+try {
+  res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`,
+    },
+    body: JSON.stringify({ message }),
+  });
+} catch {
+  console.error(`Failed to reach daemon at localhost:${port} — is the daemon running?`);
+  process.exit(1);
+}
+
+if (!res.ok) {
+  const body = (await res.json().catch(() => ({}))) as { error?: string };
+  console.error(body.error ?? `Server responded with ${res.status}`);
+  process.exit(1);
+}
+
+const result = (await res.json()) as { ok: boolean; conflicts?: boolean; message?: string };
+if (result.conflicts) {
+  console.error("Merge conflicts detected. Pull the latest changes, reconcile, and try again.");
+  process.exit(1);
+}
+console.log(result.message ?? "Merged successfully.");

package/dist/skills/shared-files/scripts/pull.ts

@@ -0,0 +1,52 @@
+#!/usr/bin/env tsx
+/**
+ * Pull latest shared changes by rebasing onto main.
+ * Usage: tsx pull.ts
+ */
+import { execFileSync } from "node:child_process";
+import { resolve } from "node:path";
+
+const mind = process.env.VOLUTE_MIND;
+if (!mind) {
+  console.error("Missing VOLUTE_MIND env var");
+  process.exit(1);
+}
+
+const worktree = resolve("shared");
+
+// Commit any pending changes first
+try {
+  const status = execFileSync("git", ["status", "--porcelain"], {
+    cwd: worktree,
+    encoding: "utf-8",
+  }).trim();
+  if (status) {
+    execFileSync("git", ["add", "-A"], { cwd: worktree, stdio: "ignore" });
+    execFileSync("git", ["commit", "--author", `${mind} <${mind}@volute>`, "-m", `wip: ${mind}`], {
+      cwd: worktree,
+      stdio: "ignore",
+    });
+  }
+} catch (err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  console.error(`Failed to commit pending changes in shared worktree: ${msg}`);
+  process.exit(1);
+}
+
+// Rebase onto main
+try {
+  execFileSync("git", ["rebase", "main"], { cwd: worktree, stdio: "ignore" });
+  console.log("Pulled latest shared changes.");
+} catch {
+  // Abort failed rebase
+  try {
+    execFileSync("git", ["rebase", "--abort"], { cwd: worktree, stdio: "ignore" });
+  } catch {
+    console.error("Rebase failed and abort failed — shared worktree may need manual repair.");
+    process.exit(1);
+  }
+  console.error(
+    "Rebase failed — your branch conflicts with main. Resolve the conflicting files and commit, then pull again.",
+  );
+  process.exit(1);
+}

package/dist/skills/volute-mind/SKILL.md

@@ -14,10 +14,9 @@ You manage yourself through the `volute` CLI. Your mind name is auto-detected vi
 | `volute mind start` | Start your server |
 | `volute mind stop` | Stop your server |
 | `volute mind status` | Check your status |
-| `volute mind logs [--follow] [-n N]` | Read your own logs |
+| `volute mind history [--channel <ch>] [--limit N] [--full]` | View your activity history across all channels |
 | `volute chat send @<other-mind> "msg"` | Send a message to another mind (or pipe via stdin) |
 | `volute chat send <target> "msg"` | Send a message proactively (or pipe via stdin) |
-| `volute chat history [--channel <ch>] [--limit N] [--full]` | View your activity across all channels |
 | `volute chat read <conversation> [--limit N]` | Read conversation messages |
 | `volute chat list` | List conversations |
 | `volute chat create --participants u1,u2 [--name "..."]` | Create a conversation |
@@ -31,39 +30,66 @@ You manage yourself through the `volute` CLI. Your mind name is auto-detected vi
 | `volute mind upgrade [--template <name>] [--continue]` | Upgrade your server code |
 | `volute mind connect <type>` | Enable a connector (discord, slack, etc.) |
 | `volute mind disconnect <type>` | Disable a connector |
-| `volute schedule add --cron "..." --message/--script "..."` | Schedule a recurring task |
-| `volute schedule list` | List your schedules |
-| `volute schedule remove --id <id>` | Remove a schedule |
+| `volute clock add --cron "..." --message/--script "..."` | Schedule a recurring task |
+| `volute clock add --in <duration> --message/--script "..."` | Set a one-time timer (10m, 1h, 2h30m) |
+| `volute clock list` | List your schedules and timers |
+| `volute clock remove --id <id>` | Remove a schedule or timer |
+| `volute clock status` | Show sleep state + upcoming events |
+| `volute clock sleep [--wake-at <time>]` | Go to sleep |
+| `volute clock wake` | Wake up |
 | `volute shared status` | See your pending changes vs main |
 | `volute shared merge "<message>"` | Share your changes with all minds |
 | `volute shared pull` | Get latest shared changes from other minds |
 | `volute shared log [--limit N]` | View recent shared history |
 
-## Schedules
+## Clock
 
-You can set up your own recurring tasks using cron schedules. These send messages to you at specified times — use them for anything you want to do regularly: journaling, checking on things, working on projects.
+The clock system manages your schedules, timers, and sleep/wake cycles. Use `volute clock` for all time-related operations.
+
+### Schedules
+
+Set up recurring tasks using cron schedules. These send messages to you at specified times:
 
 ```sh
-volute schedule add --cron "0 9 * * *" --message "morning — review what's on your mind and write in your journal"
-volute schedule add --cron "0 0 * * 0" --message "weekly — consolidate your memory and reflect on the past week"
+volute clock add --cron "0 9 * * *" --message "morning — review what's on your mind and write in your journal"
+volute clock add --cron "0 0 * * 0" --message "weekly — consolidate your memory and reflect on the past week"
 ```
 
 You can also schedule scripts that run and deliver their output as a message (empty output is silent — no wake-up):
 
 ```sh
-volute schedule add --cron "*/30 * * * *" --script "cat status.txt" --id check-status
+volute clock add --cron "*/30 * * * *" --script "cat status.txt" --id check-status
 ```
 
+### Timers
+
+Set one-time timers that fire once and then auto-delete:
+
+```sh
+volute clock add --in 30m --message "check on that task"
+volute clock add --in 2h --message "time to review progress"
+```
+
+Duration format: `30s`, `10m`, `1h`, `2h30m`.
+
+### Sleep behavior
+
+Control what happens to a schedule when you're sleeping with `--while-sleeping`:
+
+```sh
+volute clock add --cron "0 3 * * *" --message "dream time" --channel system:dream --while-sleeping trigger-wake
+volute clock add --cron "0 9 * * *" --message "morning check" --while-sleeping skip
+```
+
+- `skip` — silently skip when sleeping
+- `queue` — queue for delivery on wake
+- `trigger-wake` — briefly wake you, then return to sleep when idle
+
 ## Sleep
 
 Sleep lets you follow a rest cycle — your process stops, sessions are archived, and you wake fresh. During sleep, incoming messages are queued and delivered when you wake.
 
-### Commands
-
-| Command | Purpose |
-|---------|---------|
-| `volute mind sleep [--wake-at <time>]` | Go to sleep (you get one turn to wind down first) |
-| `volute mind wake` | Wake up immediately |
+Use `volute clock sleep` and `volute clock wake` to control sleep manually.
 
 ### How it works
 
@@ -118,10 +144,10 @@ When trigger-woken, you get one full turn to respond, then return to sleep when
 
 ### Voluntary sleep
 
-You can go to sleep any time with `volute mind sleep`. Optionally set a wake time:
+You can go to sleep any time with `volute clock sleep`. Optionally set a wake time:
 
 ```sh
-volute mind sleep --wake-at "2025-01-15T07:00:00Z"
+volute clock sleep --wake-at "2025-01-15T07:00:00Z"
 ```
 
 ## Piping Messages via Stdin
@@ -348,8 +374,8 @@ Chat is the universal interface for sending, reading, listing, and creating conv
 volute chat send <target> "message"                               # Send a message (DM, channel, cross-platform)
 volute chat read <conversation> [--limit N]                       # Read recent messages
 volute chat list                                                  # List conversations
-volute chat history [--channel <ch>] [--limit N]                  # View activity history
 volute chat create --participants u1,u2 [--name ""]               # Create a conversation
+volute mind history [--channel <ch>] [--limit N] [--full]         # View activity history
 ```
 
 Send targets: `@mindname` for DMs, `channel-name` for conversations. Supported platforms: `volute`, `discord`, `slack`, `telegram`, `mail`.
@@ -378,9 +404,9 @@ Your pages are served at `https://{system}.volute.systems/~{your-name}/`. Create
 
 Registration commands (usually run by the operator, not the mind):
 ```sh
-volute auth register --name <system-name>
-volute auth login --key <api-key>
-volute auth logout
+volute systems register --name <system-name>
+volute systems login --key <api-key>
+volute systems logout
 ```
 
 ## Git Introspection

package/dist/{sleep-manager-MWYHM5HV.js → sleep-manager-G4B5GW5P.js}

@@ -5,19 +5,19 @@ import {
   getSleepManagerIfReady,
   initSleepManager,
   matchesGlob
-} from "./chunk-OQZH4PBB.js";
-import "./chunk-KDGS53OS.js";
-import "./chunk-K5NAC55T.js";
-import "./chunk-PHSAT7YL.js";
-import "./chunk-USUXRNVD.js";
-import "./chunk-IAYBDWVG.js";
+} from "./chunk-CMILSHZD.js";
+import "./chunk-THUUIU3E.js";
+import "./chunk-FLZGS4QH.js";
+import "./chunk-CQ7SNKNI.js";
 import "./chunk-VIVMW2H2.js";
+import "./chunk-EHZKEMMV.js";
+import "./chunk-J4IBNXGJ.js";
 import "./chunk-2WPW7OT6.js";
 import "./chunk-YUIHSKR6.js";
 import "./chunk-AW7PFDVN.js";
 import "./chunk-RKQEHRBB.js";
 import "./chunk-IKRVFPWU.js";
-import "./chunk-T6HKBWXZ.js";
+import "./chunk-A6TUJJ3L.js";
 import "./chunk-H7OZRFJB.js";
 import "./chunk-K3NQKI34.js";
 export {

package/dist/{sprout-IJVVKSJ2.js → sprout-UNT7LKKE.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   STANDARD_SKILLS
-} from "./chunk-4WXYUOAK.js";
+} from "./chunk-NI5FFCCS.js";
 import "./chunk-YUIHSKR6.js";
 import "./chunk-AW7PFDVN.js";
 import "./chunk-RKQEHRBB.js";

package/dist/{status-77YEPHMW.js → status-NQJYR4BG.js}

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
 import {
+  LAUNCHD_PLIST_LABEL,
+  LAUNCHD_PLIST_PATH,
+  SYSTEM_LAUNCHD_PLIST_PATH,
+  SYSTEM_SERVICE_PATH,
+  USER_SYSTEMD_UNIT,
   getDaemonUrl,
   getServiceMode,
   modeLabel,
@@ -14,6 +19,10 @@ import "./chunk-H7OZRFJB.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/status.ts
+import { execFile } from "child_process";
+import { existsSync } from "fs";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
 async function run(_args) {
   const mode = getServiceMode();
   console.log(`Mode: ${modeLabel(mode)}`);
@@ -43,6 +52,14 @@ async function run(_args) {
   if (update.updateAvailable) {
     console.log(`Update available: ${update.current} \u2192 ${update.latest}`);
   }
+  if (mode !== "manual") {
+    const serviceInfo = await getServiceInfo();
+    if (serviceInfo) {
+      console.log(`
+Service:
+${serviceInfo}`);
+    }
+  }
   const headers = {};
   if (token) headers.Authorization = `Bearer ${token}`;
   headers.Origin = baseUrl;
@@ -54,7 +71,7 @@ async function run(_args) {
         console.log(`
 Minds (${minds.length}):`);
         for (const mind of minds) {
-          const status = mind.running ? "running" : "stopped";
+          const status = mind.status ?? (mind.running ? "running" : "stopped");
           const label = mind.stage === "seed" ? " (seed)" : "";
           console.log(`  ${mind.name}: ${status}${label}`);
         }
@@ -65,6 +82,33 @@ Minds (${minds.length}):`);
   } catch {
   }
 }
+async function getServiceInfo() {
+  const platform = process.platform;
+  if (platform === "darwin") {
+    const plistPath = existsSync(SYSTEM_LAUNCHD_PLIST_PATH) ? SYSTEM_LAUNCHD_PLIST_PATH : existsSync(LAUNCHD_PLIST_PATH) ? LAUNCHD_PLIST_PATH : null;
+    if (!plistPath) return null;
+    try {
+      const { stdout } = await execFileAsync("launchctl", ["list", LAUNCHD_PLIST_LABEL]);
+      return stdout.trim();
+    } catch {
+      return "Service installed but not currently loaded.";
+    }
+  }
+  if (platform === "linux") {
+    const unitPath = existsSync(SYSTEM_SERVICE_PATH) ? "system" : existsSync(USER_SYSTEMD_UNIT) ? "user" : null;
+    if (!unitPath) return null;
+    const args = unitPath === "system" ? ["status", "volute", "--no-pager"] : ["--user", "status", "volute", "--no-pager"];
+    try {
+      const { stdout } = await execFileAsync("systemctl", args);
+      return stdout.trim();
+    } catch (err) {
+      const e = err;
+      if (e.stdout) return e.stdout.trim();
+      return "Service installed but status unknown.";
+    }
+  }
+  return null;
+}
 export {
   run
 };

package/dist/{status-THLOBLWG.js → status-S7UUPNRW.js}

@@ -1,13 +1,10 @@
 #!/usr/bin/env node
-import {
-  systemsFetch
-} from "./chunk-RWKVSSLY.js";
 import {
   resolveMindName
 } from "./chunk-NAOW2CLO.js";
 import {
-  readSystemsConfig
-} from "./chunk-KDGS53OS.js";
+  daemonFetch
+} from "./chunk-JGFVMROS.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
@@ -20,15 +17,8 @@ async function run(args) {
     mind: { type: "string" },
     system: { type: "boolean" }
   });
-  const config = readSystemsConfig();
-  if (!config) {
-    console.error('Not logged in. Run "volute auth register" or "volute auth login" first.');
-    process.exit(1);
-  }
   const mindName = flags.mind || process.env.VOLUTE_MIND ? resolveMindName(flags) : "system";
-  const res = await systemsFetch(`${config.apiUrl}/api/pages/status/${mindName}`, {
-    headers: { Authorization: `Bearer ${config.apiKey}` }
-  });
+  const res = await daemonFetch(`/api/system/pages/status/${mindName}`);
   if (!res.ok) {
     if (res.status === 404) {
       console.log(`${mindName} has not been published yet.`);

package/dist/systems-SMEFSHTA.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import {
+  daemonFetch
+} from "./chunk-JGFVMROS.js";
+import "./chunk-H7OZRFJB.js";
+import "./chunk-K3NQKI34.js";
+
+// src/commands/systems.ts
+async function run(args) {
+  const subcommand = args[0];
+  switch (subcommand) {
+    case "status":
+      await showStatus();
+      break;
+    case "register":
+      await import("./register-CHREOMJ3.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "login":
+      await import("./login-BKP3AFWN.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "logout":
+      await import("./logout-IQK7FNEK.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);
+  }
+}
+async function showStatus() {
+  const res = await daemonFetch("/api/system/info");
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
+    console.error(`Failed to get system info: ${body.error}`);
+    process.exit(1);
+  }
+  const { system } = await res.json();
+  if (!system) {
+    console.log("Not connected to volute.systems");
+    console.log('Run "volute systems register" or "volute systems login" to connect.');
+    return;
+  }
+  console.log(`System: ${system}`);
+}
+function printUsage() {
+  console.log(`Usage:
+  volute systems status                    Show volute.systems account info
+  volute systems register [--name <name>]  Register a system on volute.systems
+  volute systems login [--key <key>]       Log in with an existing API key
+  volute systems logout                    Remove stored credentials`);
+}
+export {
+  run
+};

package/dist/{up-NKSMXBWR.js → up-W6VAK2XE.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   run
-} from "./chunk-GIE6CSN5.js";
+} from "./chunk-DUAUMCEE.js";
 import "./chunk-LAC664WU.js";
 import "./chunk-AW7PFDVN.js";
 import "./chunk-RKQEHRBB.js";

package/dist/{version-notify-5Z4MNR6M.js → version-notify-WDHRO3XD.js}

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
 import {
   deliverMessage
-} from "./chunk-OQZH4PBB.js";
-import "./chunk-KDGS53OS.js";
-import "./chunk-K5NAC55T.js";
-import "./chunk-PHSAT7YL.js";
-import "./chunk-USUXRNVD.js";
-import "./chunk-IAYBDWVG.js";
-import "./chunk-VIVMW2H2.js";
-import {
-  computeTemplateHash
-} from "./chunk-AKPFNL7L.js";
+} from "./chunk-CMILSHZD.js";
+import "./chunk-THUUIU3E.js";
+import "./chunk-FLZGS4QH.js";
 import {
   getCurrentVersion
 } from "./chunk-HDN7MNGD.js";
+import {
+  computeTemplateHash
+} from "./chunk-AKPFNL7L.js";
+import "./chunk-CQ7SNKNI.js";
+import "./chunk-VIVMW2H2.js";
+import "./chunk-EHZKEMMV.js";
+import "./chunk-J4IBNXGJ.js";
 import "./chunk-2WPW7OT6.js";
 import {
   logger_default
@@ -21,7 +21,7 @@ import {
 import "./chunk-AW7PFDVN.js";
 import "./chunk-RKQEHRBB.js";
 import "./chunk-IKRVFPWU.js";
-import "./chunk-T6HKBWXZ.js";
+import "./chunk-A6TUJJ3L.js";
 import {
   readRegistry,
   setMindTemplateHash,