volute 0.18.0 → 0.20.0

package/dist/{package-OKLFO7UY.js → package-4NHAVUUI.js}

@@ -4,7 +4,7 @@ import "./chunk-K3NQKI34.js";
 // package.json
 var package_default = {
   name: "volute",
-  version: "0.18.0",
+  version: "0.20.0",
   description: "CLI for creating and managing self-modifying AI minds powered by the Claude Agent SDK",
   type: "module",
   license: "MIT",
@@ -32,10 +32,12 @@ var package_default = {
   ],
   scripts: {
     dev: "tsx src/cli.ts",
-    build: "tsup && npm run build:web",
+    build: "tsup && cp -r skills dist/skills && npm run build:web",
     "build:web": "vite build --config src/web/ui/vite.config.ts",
     "dev:web": "vite --config src/web/ui/vite.config.ts",
-    test: "node --import tsx --import ./test/setup.ts --test --test-force-exit --test-concurrency=1 test/*.test.ts",
+    test: "node --import tsx --import ./test/setup.ts --test --test-force-exit --test-concurrency=4 $(find test -name '*.test.ts' ! -name 'daemon-e2e.test.ts' | sort)",
+    "test:e2e": "node --import tsx --import ./test/setup.ts --test --test-force-exit --test-concurrency=1 test/daemon-e2e.test.ts",
+    "test:all": "npm test && npm run test:e2e",
     lint: "biome check src/ test/",
     "lint:fix": "biome check --write src/ test/",
     format: "biome format --write src/ test/",

package/dist/{pages-6IV4VQTU.js → pages-4DGQT7ZA.js}

@@ -6,10 +6,10 @@ async function run(args) {
   const subcommand = args[0];
   switch (subcommand) {
     case "publish":
-      await import("./publish-Q4RPSJLL.js").then((m) => m.run(args.slice(1)));
+      await import("./publish-TAJUET4I.js").then((m) => m.run(args.slice(1)));
       break;
     case "status":
-      await import("./status-OKNA6AR3.js").then((m) => m.run(args.slice(1)));
+      await import("./status-FU2PFVVF.js").then((m) => m.run(args.slice(1)));
       break;
     case "--help":
     case "-h":

package/dist/{publish-Q4RPSJLL.js → publish-TAJUET4I.js}

@@ -5,15 +5,21 @@ import {
 import {
   resolveMindName
 } from "./chunk-NAOW2CLO.js";
+import {
+  sharedDir
+} from "./chunk-TIWH32HP.js";
 import {
   readSystemsConfig
-} from "./chunk-37X7ECMF.js";
+} from "./chunk-FCDU5BFX.js";
+import "./chunk-YUIHSKR6.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
+import "./chunk-DYZGP3EW.js";
+import "./chunk-OGXOMR65.js";
 import {
   mindDir
-} from "./chunk-M77QBTEH.js";
+} from "./chunk-EBGCNDMM.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/pages/publish.ts
@@ -21,15 +27,26 @@ import { existsSync, lstatSync, readdirSync, readFileSync } from "fs";
 import { relative, resolve } from "path";
 async function run(args) {
   const { flags } = parseArgs(args, {
-    mind: { type: "string" }
+    mind: { type: "string" },
+    system: { type: "boolean" }
   });
   const config = readSystemsConfig();
   if (!config) {
     console.error('Not logged in. Run "volute pages register" or "volute pages login" first.');
     process.exit(1);
   }
-  const mindName = resolveMindName(flags);
-  const pagesDir = resolve(mindDir(mindName), "home", "pages");
+  let mindName;
+  let pagesDir;
+  if (flags.system) {
+    mindName = "system";
+    pagesDir = resolve(sharedDir(), "pages");
+  } else if (flags.mind || process.env.VOLUTE_MIND) {
+    mindName = resolveMindName(flags);
+    pagesDir = resolve(mindDir(mindName), "home", "pages");
+  } else {
+    mindName = "system";
+    pagesDir = resolve(sharedDir(), "pages");
+  }
   if (!existsSync(pagesDir)) {
     console.error(`No pages/ directory found at ${pagesDir}`);
     process.exit(1);

package/dist/pull-XAEWQJ47.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import {
+  resolveMindName
+} from "./chunk-NAOW2CLO.js";
+import {
+  parseArgs
+} from "./chunk-D424ZQGI.js";
+import {
+  daemonFetch
+} from "./chunk-WC6ZHVRL.js";
+import "./chunk-EBGCNDMM.js";
+import "./chunk-K3NQKI34.js";
+
+// src/commands/shared/pull.ts
+async function run(args) {
+  const { flags } = parseArgs(args, {
+    mind: { type: "string" }
+  });
+  const mindName = resolveMindName(flags);
+  const res = await daemonFetch(`/api/minds/${encodeURIComponent(mindName)}/shared/pull`, {
+    method: "POST"
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    console.error(body.error ?? `Server responded with ${res.status}`);
+    process.exit(1);
+  }
+  const result = await res.json();
+  if (!result.ok) {
+    console.error(
+      result.message ?? "Pull failed. Try: git -C shared reset --hard main (then re-apply your changes)."
+    );
+    process.exit(1);
+  }
+  console.log("Pulled latest shared changes.");
+}
+export {
+  run
+};

package/dist/{register-LDE6LRXY.js → register-VSPCMHKX.js}

@@ -8,11 +8,11 @@ import {
 import {
   readSystemsConfig,
   writeSystemsConfig
-} from "./chunk-37X7ECMF.js";
+} from "./chunk-FCDU5BFX.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import "./chunk-M77QBTEH.js";
+import "./chunk-EBGCNDMM.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/pages/register.ts

package/dist/{restart-YFAWFS5T.js → restart-IQKMCK5M.js}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
+import {
+  getClient,
+  urlOf
+} from "./chunk-4RQBJWQX.js";
 import {
   resolveMindName
 } from "./chunk-NAOW2CLO.js";
 import {
   daemonFetch
-} from "./chunk-OJQ47SCA.js";
+} from "./chunk-WC6ZHVRL.js";
 import {
   resolveMind
-} from "./chunk-M77QBTEH.js";
-import {
-  getClient,
-  urlOf
-} from "./chunk-4RQBJWQX.js";
+} from "./chunk-EBGCNDMM.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/restart.ts

package/dist/{schedule-AGYLDMNS.js → schedule-FFZG23IW.js}

@@ -1,4 +1,8 @@
 #!/usr/bin/env node
+import {
+  getClient,
+  urlOf
+} from "./chunk-4RQBJWQX.js";
 import {
   resolveMindName
 } from "./chunk-NAOW2CLO.js";
@@ -7,15 +11,12 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-OJQ47SCA.js";
-import "./chunk-M77QBTEH.js";
-import {
-  getClient,
-  urlOf
-} from "./chunk-4RQBJWQX.js";
+} from "./chunk-WC6ZHVRL.js";
+import "./chunk-EBGCNDMM.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/schedule.ts
+import { CronExpressionParser } from "cron-parser";
 async function run(args) {
   const subcommand = args[0];
   switch (subcommand) {
@@ -42,6 +43,7 @@ function printUsage() {
   console.log(`Usage:
   volute schedule list [--mind <name>]
   volute schedule add [--mind <name>] --cron "..." --message "..." [--id name]
+  volute schedule add [--mind <name>] --cron "..." --script "..." [--id name]
   volute schedule remove [--mind <name>] --id <id>`);
 }
 async function listSchedules(args) {
@@ -65,10 +67,11 @@ async function listSchedules(args) {
   }
   const idW = Math.max(2, ...schedules.map((s) => s.id.length));
   const cronW = Math.max(4, ...schedules.map((s) => s.cron.length));
-  console.log(`${"ID".padEnd(idW)}  ${"CRON".padEnd(cronW)}  ENABLED  MESSAGE`);
+  const actionLabel = (s) => s.script ? `[script] ${s.script}` : s.message ?? "";
+  console.log(`${"ID".padEnd(idW)}  ${"CRON".padEnd(cronW)}  ENABLED  ACTION`);
   for (const s of schedules) {
     console.log(
-      `${s.id.padEnd(idW)}  ${s.cron.padEnd(cronW)}  ${String(s.enabled).padEnd(7)}  ${s.message}`
+      `${s.id.padEnd(idW)}  ${s.cron.padEnd(cronW)}  ${String(s.enabled).padEnd(7)}  ${actionLabel(s)}`
     );
   }
 }
@@ -77,14 +80,31 @@ async function addSchedule(args) {
     mind: { type: "string" },
     cron: { type: "string" },
     message: { type: "string" },
+    script: { type: "string" },
     id: { type: "string" }
   });
   const mind = resolveMindName(flags);
-  if (!flags.cron || !flags.message) {
-    console.error("--cron and --message are required");
+  if (!flags.cron) {
+    console.error("--cron is required");
+    process.exit(1);
+  }
+  if (!flags.message && !flags.script) {
+    console.error("--message or --script is required");
+    process.exit(1);
+  }
+  if (flags.message && flags.script) {
+    console.error("--message and --script are mutually exclusive");
+    process.exit(1);
+  }
+  try {
+    CronExpressionParser.parse(flags.cron);
+  } catch {
+    console.error(`Invalid cron expression: ${flags.cron}`);
     process.exit(1);
   }
-  const body = { cron: flags.cron, message: flags.message };
+  const body = { cron: flags.cron };
+  if (flags.message) body.message = flags.message;
+  if (flags.script) body.script = flags.script;
   if (flags.id) body.id = flags.id;
   const client = getClient();
   const res = await daemonFetch(

package/dist/schema-GFH6RV3W.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import {
+  activity,
+  conversationParticipants,
+  conversations,
+  deliveryQueue,
+  messages,
+  mindHistory,
+  sessions,
+  sharedSkills,
+  systemPrompts,
+  users
+} from "./chunk-NSE7VJQA.js";
+import "./chunk-K3NQKI34.js";
+export {
+  activity,
+  conversationParticipants,
+  conversations,
+  deliveryQueue,
+  messages,
+  mindHistory,
+  sessions,
+  sharedSkills,
+  systemPrompts,
+  users
+};

package/dist/{seed-AP4Q7RZ7.js → seed-J43YDKXG.js}

@@ -9,17 +9,19 @@ async function run(args) {
   const { positional, flags } = parseArgs(args, {
     template: { type: "string" },
     model: { type: "string" },
-    description: { type: "string" }
+    description: { type: "string" },
+    skills: { type: "string" }
   });
   const name = positional[0];
   if (!name) {
     console.error(
-      "Usage: volute seed <name> [--template <name>] [--model <model>] [--description <text>]"
+      "Usage: volute seed <name> [--template <name>] [--model <model>] [--description <text>] [--skills <list|none>]"
     );
     process.exit(1);
   }
   const template = flags.template ?? "claude";
-  const { daemonFetch } = await import("./daemon-client-ODKDUYDE.js");
+  const skills = flags.skills === "none" ? [] : flags.skills ? flags.skills.split(",") : void 0;
+  const { daemonFetch } = await import("./daemon-client-ITWUCNFO.js");
   const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
   const client = getClient();
   const createRes = await daemonFetch(urlOf(client.api.minds.$url()), {
@@ -30,7 +32,8 @@ async function run(args) {
       template,
       stage: "seed",
       description: flags.description,
-      model: flags.model
+      model: flags.model,
+      skills
     })
   });
   const createData = await createRes.json();

package/dist/{send-BNDTLUPM.js → send-KVIZIGCE.js}

@@ -1,24 +1,24 @@
 #!/usr/bin/env node
+import {
+  getClient,
+  urlOf
+} from "./chunk-4RQBJWQX.js";
 import {
   resolveMindName
 } from "./chunk-NAOW2CLO.js";
 import {
   getChannelDriver
-} from "./chunk-FW5API7X.js";
+} from "./chunk-UJ6GHNR7.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import "./chunk-GK4E7LM7.js";
+import "./chunk-RHEGSQFJ.js";
 import {
   daemonFetch
-} from "./chunk-OJQ47SCA.js";
+} from "./chunk-WC6ZHVRL.js";
 import {
   findMind
-} from "./chunk-M77QBTEH.js";
-import {
-  getClient,
-  urlOf
-} from "./chunk-4RQBJWQX.js";
+} from "./chunk-EBGCNDMM.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/send.ts

package/dist/{service-U7MZ2H7F.js → service-LUR7WDO7.js}

@@ -4,15 +4,15 @@ import {
   LAUNCHD_PLIST_PATH,
   SYSTEM_SERVICE_PATH,
   USER_SYSTEMD_UNIT
-} from "./chunk-6BDNWYKG.js";
-import {
-  resolveVoluteBin
-} from "./chunk-2Y77MCFG.js";
-import "./chunk-ZCEYUUID.js";
+} from "./chunk-32VR2EOH.js";
 import {
   parseArgs
 } from "./chunk-D424ZQGI.js";
-import "./chunk-M77QBTEH.js";
+import {
+  resolveVoluteBin
+} from "./chunk-DYZGP3EW.js";
+import "./chunk-OGXOMR65.js";
+import "./chunk-EBGCNDMM.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/service.ts

package/dist/{setup-DJKIZKGW.js → setup-52YRV7VP.js}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   SYSTEM_SERVICE_PATH
-} from "./chunk-6BDNWYKG.js";
+} from "./chunk-32VR2EOH.js";
+import {
+  parseArgs
+} from "./chunk-D424ZQGI.js";
 import {
   resolveVoluteBin
-} from "./chunk-2Y77MCFG.js";
+} from "./chunk-DYZGP3EW.js";
 import {
   ensureVoluteGroup
-} from "./chunk-ZCEYUUID.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
-import "./chunk-M77QBTEH.js";
+} from "./chunk-OGXOMR65.js";
+import "./chunk-EBGCNDMM.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/setup.ts
@@ -95,6 +95,22 @@ function install(port, host) {
   console.log(`Created ${MINDS_DIR}`);
   ensureVoluteGroup({ force: true });
   console.log("Ensured volute group exists");
+  try {
+    execFileSync("git", ["config", "--system", "user.name"]);
+    console.log("System git identity already configured, skipping");
+  } catch {
+    try {
+      execFileSync("git", ["config", "--system", "user.name", "Volute"]);
+      execFileSync("git", ["config", "--system", "user.email", "volute@localhost"]);
+      console.log("Configured system git identity");
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.warn(`Warning: failed to set system git config: ${msg}`);
+      console.warn("Git commits by the daemon may fail. You can set this manually with:");
+      console.warn('  git config --system user.name "Volute"');
+      console.warn('  git config --system user.email "volute@localhost"');
+    }
+  }
   execFileSync("chmod", ["755", DATA_DIR]);
   execFileSync("chmod", ["755", MINDS_DIR]);
   console.log("Set permissions on directories");

package/dist/shared-KO35ZM44.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import "./chunk-K3NQKI34.js";
+
+// src/commands/shared.ts
+async function run(args) {
+  const subcommand = args[0];
+  switch (subcommand) {
+    case "merge":
+      await import("./merge-33C237A4.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "pull":
+      await import("./pull-XAEWQJ47.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "log":
+      await import("./log-PPPZDVEF.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "status":
+      await import("./status-D7E5HHBV.js").then((m) => m.run(args.slice(1)));
+      break;
+    case "--help":
+    case "-h":
+    case void 0:
+      printUsage();
+      break;
+    default:
+      printUsage();
+      process.exit(1);
+  }
+}
+function printUsage() {
+  console.log(`Usage:
+  volute shared merge "<message>" [--mind <name>]   Merge shared changes to main
+  volute shared pull [--mind <name>]                Pull latest shared changes
+  volute shared log [--limit N] [--mind <name>]     Show shared repo history
+  volute shared status [--mind <name>]              Show pending changes diff`);
+}
+export {
+  run
+};

package/dist/{skill-2Y42P4JY.js → skill-BCVNI6TV.js}

@@ -1,4 +1,8 @@
 #!/usr/bin/env node
+import {
+  getClient,
+  urlOf
+} from "./chunk-4RQBJWQX.js";
 import {
   resolveMindName
 } from "./chunk-NAOW2CLO.js";
@@ -7,12 +11,8 @@ import {
 } from "./chunk-D424ZQGI.js";
 import {
   daemonFetch
-} from "./chunk-OJQ47SCA.js";
-import "./chunk-M77QBTEH.js";
-import {
-  getClient,
-  urlOf
-} from "./chunk-4RQBJWQX.js";
+} from "./chunk-WC6ZHVRL.js";
+import "./chunk-EBGCNDMM.js";
 import "./chunk-K3NQKI34.js";
 
 // src/commands/skill.ts

package/{templates/_base/_skills → dist/skills}/orientation/SKILL.md

@@ -47,7 +47,7 @@ After sprouting, you'll have full mind capabilities (connectors, schedules, vari
 
 | Command | Purpose |
 |---------|---------|
-| `volute send @<name> "msg"` | Send a message to a user or mind |
+| `volute send @<name> "msg"` | Send a message to another user |
 | `volute sprout` | Complete orientation and become a full mind |
 
 ## Files

package/{templates/_base/_skills → dist/skills}/sessions/SKILL.md

@@ -16,8 +16,8 @@ When a message arrives, you automatically receive a brief summary of new activit
 To see which sessions are active:
 
 ```sh
-ls ../.volute/sessions/       # claude template
-ls ../.volute/pi-sessions/    # pi template
+ls ../.mind/sessions/       # claude template
+ls ../.mind/pi-sessions/    # pi template
 ```
 
 ## Reading a Session Log

package/{templates/_base/_skills → dist/skills}/volute-mind/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: Volute CLI
-description: This skill should be used when working with the volute CLI, understanding variants, forking, merging, or managing the mind server. Also covers routing config, batch settings, channel gating, message flow, and shared skills. Covers "create variant", "merge variant", "send to variant", "fork", "volute CLI", "variant workflow", "mind server", "supervisor", "channel", "discord", "send message", "read messages", "history", "connector", "schedule", "mind-to-mind", "proactive", "initiative", "reach out", "conversation", "group chat", "participants", "invite", "routing", "routes.json", "batch", "debounce", "trigger", "gating", "gate", "skill", "shared skill", "install skill", "publish skill", "update skill".
+description: This skill should be used when working with the volute CLI, understanding variants, forking, merging, or managing the mind server. Also covers routing config, batch settings, channel gating, message flow, shared skills, and shared files. Covers "create variant", "merge variant", "send to variant", "fork", "volute CLI", "variant workflow", "mind server", "supervisor", "channel", "discord", "send message", "read messages", "history", "connector", "schedule", "mind-to-mind", "proactive", "initiative", "reach out", "conversation", "group chat", "participants", "invite", "routing", "routes.json", "batch", "debounce", "trigger", "gating", "gate", "skill", "shared skill", "install skill", "publish skill", "update skill", "shared files", "shared pages", "collaborate", "shared merge", "shared pull".
 ---
 
 # Self-Management
@@ -29,9 +29,13 @@ You manage yourself through the `volute` CLI. Your mind name is auto-detected vi
 | `volute channel list [<platform>]` | List conversations on a platform (or all platforms) |
 | `volute channel users <platform>` | List users/contacts on a platform |
 | `volute channel create <platform> --participants u1,u2 [--name "..."]` | Create a conversation on a platform |
-| `volute schedule add --cron "..." --message "..."` | Schedule a recurring message to yourself |
+| `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 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
 
@@ -42,6 +46,12 @@ volute schedule add --cron "0 9 * * *" --message "morning — review what's on y
 volute schedule 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
+```
+
 ## Piping Messages via Stdin
 
 All send commands accept the message from stdin instead of as an argument. This avoids shell escaping issues with quotes, special characters, and multiline content:
@@ -67,6 +77,23 @@ For group conversations, use `volute channel create volute --participants mind-b
 
 Your `.config/volute.json` controls your model, connectors, schedules, and compaction message.
 
+### Transparency
+
+The `transparency` setting in `.config/volute.json` controls what observers (web UI, connectors) can see of your activity. Presets:
+
+| Preset | Thinking | Text | Tool use | Tool results | Logs/usage |
+|--------|----------|------|----------|--------------|------------|
+| `transparent` | yes | yes | yes (with args) | yes | yes |
+| `standard` | no | yes | name only | no | yes |
+| `private` | no | no | no | no | no |
+| `silent` | no | no | no | no | no |
+
+Default is `transparent`. Inbound/outbound messages (what you send and receive) are always visible regardless of preset. To change:
+
+```json
+{ "transparency": "standard" }
+```
+
 ## Startup Context
 
 Edit `.config/hooks/startup-context.sh` to customize what you see when a new session starts. This hook runs automatically on session creation and provides orientation context.
@@ -116,6 +143,20 @@ Your system has a shared skill repository that all minds can browse and install
 
 When you install a skill, it's copied to your skills directory. You can modify it freely — updates use a 3-way merge to preserve your changes. If there are merge conflicts, resolve them like any git conflict.
 
+## Shared Files
+
+Your `shared/` directory is a collaborative space backed by git. Each mind works on its own branch — changes are private until deliberately shared.
+
+**Workflow:**
+1. Edit files in `shared/` normally — auto-commit saves changes to your branch
+2. `volute shared status` — see what you've changed compared to main
+3. `volute shared merge "description"` — squash-merge your changes to main
+4. `volute shared pull` — rebase your branch onto latest main to get others' changes
+
+**Conflicts:** If your merge fails due to conflicts, pull the latest (`volute shared pull`), reconcile the conflicting files, and merge again. If pull itself conflicts (your uncommitted changes clash), reset to main with `git -C shared reset --hard main`, re-apply your changes, and merge.
+
+**Shared pages:** The `shared/pages/` directory is the system-level website. Any mind can contribute. Publish with `volute pages publish --system` to deploy the shared site.
+
 ## MCP Configuration
 
 Edit `home/.mcp.json` to configure MCP servers for your SDK session. This gives you access to additional tools and services.
@@ -167,9 +208,10 @@ The `sessions` section configures behavior per session. Keys are glob patterns m
 
 | Field | Description |
 |-------|-------------|
-| `batch` | Batch config (see below) |
+| `delivery` | Delivery mode: `"immediate"` (default), `"batch"`, or `{ "mode": "batch", "debounce": N, "maxWait": N }` |
 | `interrupt` | Whether to interrupt an in-progress turn (default: `true`) |
 | `instructions` | Instructions prepended to messages for this session (e.g. `"Brief responses only."`) |
+| `batch` | Legacy alias for batch config (use `delivery` instead) |
 
 ### Batch config
 
@@ -191,6 +233,10 @@ Examples:
 
 Batched messages arrive as a single message with a `[Batch: N messages — ...]` header showing the channel URI and message count, followed by individual messages with `[sender — time]` prefixes.
 
+### New-speaker interrupts
+
+In batch mode, if you're mid-turn and a **new speaker** sends a message in the **same channel**, the pending batch is force-flushed with `interrupt: true` so you can incorporate the new voice. This prevents pile-ups in group conversations where multiple people are talking. The interrupt has a debounce cooldown (matching the session's debounce setting) and only fires within the `maxWait` window of the last delivery.
+
 ## Channel Gating
 
 When `gateUnmatched` is `true` (the default), messages from channels without a matching rule are held:
@@ -231,7 +277,9 @@ Publish your `home/pages/` directory to the web. Your system must be registered
 
 ```sh
 volute pages publish              # publish your pages/ directory
+volute pages publish --system     # publish the shared/pages/ system site
 volute pages status               # check your published URL and status
+volute pages status --system      # check the system site status
 ```
 
 Your pages are served at `https://{system}.volute.systems/~{your-name}/`. Create an `index.html` in `home/pages/` to get started.