volute 0.53.0 → 0.55.0

package/dist/{mind-status-BPTLQ5Z6.js → mind-status-4YW4PHMO.js}

@@ -2,13 +2,13 @@
 import {
   resolveMindName
 } from "./chunk-BTY4WNFE.js";
+import {
+  daemonFetch
+} from "./chunk-M74I3HHF.js";
 import {
   command
 } from "./chunk-TXSA4Q3V.js";
 import "./chunk-O7IGP7ZW.js";
-import {
-  daemonFetch
-} from "./chunk-M74I3HHF.js";
 import "./chunk-FNJCBRD3.js";
 import {
   formatTokens
@@ -57,6 +57,9 @@ var cmd = command({
     if (mind.templateStale) {
       console.log(`Template: outdated \u2014 run 'volute mind upgrade ${mind.name}'`);
     }
+    if (mind.upgradeBlocked) {
+      console.log(`[upgrade blocked: ${mind.upgradeBlocked}]`);
+    }
     if (mind.lastNotice) {
       const label = mind.lastNotice.kind === "turn_error" ? "Last turn failed" : "Last issue";
       console.log(`

package/dist/{package-BN5KMU54.js → package-AUDBDKAO.js}

@@ -4,7 +4,7 @@ import "./chunk-K3NQKI34.js";
 // package.json
 var package_default = {
   name: "volute",
-  version: "0.53.0",
+  version: "0.55.0",
   description: "CLI for creating and managing self-modifying AI minds powered by the Claude Agent SDK",
   type: "module",
   license: "MIT",
@@ -39,18 +39,16 @@ var package_default = {
     "dist/",
     "drizzle/",
     "templates/",
-    "packages/extensions/notes/dist/ui/",
-    "packages/extensions/notes/skills/",
     "packages/extensions/pages/dist/ui/",
     "packages/extensions/pages/skills/",
-    "packages/extensions/plan/dist/ui/",
-    "packages/extensions/plan/skills/"
+    "packages/extensions/intentions/dist/ui/",
+    "packages/extensions/intentions/skills/"
   ],
   scripts: {
     dev: "tsx src/cli.ts",
     build: "npm run build:ext && tsup && cp -r skills dist/skills && npm run build:web",
     "ext-theme": "npm run build:ext-theme --workspace=packages/ui && cp packages/ui/dist/ext-theme.css packages/web/public/ext-theme.css",
-    "build:ext": "npm run ext-theme && npm run build:ui --workspace=packages/extensions/notes && npm run build:ui --workspace=packages/extensions/pages && npm run build:ui --workspace=packages/extensions/plan",
+    "build:ext": "npm run ext-theme && npm run build:ui --workspace=packages/extensions/pages && npm run build:ui --workspace=packages/extensions/intentions",
     "build:web": "npm run ext-theme && npm run build:ui --workspace=packages/web",
     "dev:web": "npm run ext-theme && npm run dev --workspace=packages/web",
     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)",
@@ -70,10 +68,10 @@ var package_default = {
     "db:migrate": "drizzle-kit migrate"
   },
   dependencies: {
-    "@anthropic-ai/sandbox-runtime": "^0.0.65",
+    "@anthropic-ai/sandbox-runtime": "^0.0.66",
     "@earendil-works/pi-ai": "0.80.6",
     "@hono/node-server": "^2.0.8",
-    "@hono/zod-validator": "^0.8.0",
+    "@hono/zod-validator": "^0.9.0",
     "@libsql/client": "^0.17.4",
     "@slack/bolt": "^4.7.3",
     "adm-zip": "^0.6.0",
@@ -82,7 +80,7 @@ var package_default = {
     "discord.js": "^14.26.5",
     "drizzle-orm": "^0.45.2",
     hono: "^4.12.30",
-    "isomorphic-dompurify": "^3.18.0",
+    "isomorphic-dompurify": "^3.19.0",
     libsql: "^0.5.29",
     replicate: "^1.4.0",
     sharp: "^0.35.3",
@@ -91,19 +89,19 @@ var package_default = {
     zod: "^4.4.3"
   },
   devDependencies: {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.207",
-    "@biomejs/biome": "2.5.3",
-    "@earendil-works/pi-coding-agent": "^0.80.6",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.217",
+    "@biomejs/biome": "2.5.5",
+    "@earendil-works/pi-coding-agent": "0.80.6",
     "@sveltejs/vite-plugin-svelte": "^7.2.0",
     "@types/adm-zip": "^0.5.8",
     "@types/node": "^26.1.1",
-    dompurify: "3.4.11",
+    dompurify: "3.4.12",
     "drizzle-kit": "^0.31.10",
     knip: "^6.26.0",
     lefthook: "^2.1.10",
     marked: "^18.0.6",
     svelte: "^5.56.4",
-    "svelte-check": "4.7.2",
+    "svelte-check": "4.7.3",
     tsup: "^8.5.1",
     tsx: "^4.23.1",
     typescript: "^6.0.3",

package/dist/{prompts-HNKGCAEY.js → prompts-MOBF3TMO.js}

@@ -8,7 +8,7 @@ import {
   getPrompt,
   getPromptIfCustom,
   substitute
-} from "./chunk-AP2KQMMW.js";
+} from "./chunk-HTSWDOJE.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";

package/dist/{sandbox-NNWCTHRI.js → sandbox-VI7XWBIA.js}

@@ -9,8 +9,8 @@ import {
   shellTempWritePaths,
   voluteCliPaths,
   wrapForSandbox
-} from "./chunk-5Y54AE3L.js";
-import "./chunk-QUSMYGNQ.js";
+} from "./chunk-XAG53RWY.js";
+import "./chunk-2674KIGI.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";

package/dist/scheduler-GLINVC2B.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import {
+  Scheduler,
+  getScheduler,
+  initScheduler
+} from "./chunk-CKOA4LWV.js";
+import "./chunk-HLWQ3P3R.js";
+import "./chunk-BP2X5AIK.js";
+import "./chunk-XAG53RWY.js";
+import "./chunk-WCFSBH33.js";
+import "./chunk-OFU6WJJZ.js";
+import "./chunk-PRZUBJ4K.js";
+import "./chunk-DUV4EMNW.js";
+import "./chunk-MNKPAAQF.js";
+import "./chunk-HTSWDOJE.js";
+import "./chunk-OIOW3FPT.js";
+import "./chunk-GLM7TVWP.js";
+import "./chunk-Z7TNIIHW.js";
+import "./chunk-2674KIGI.js";
+import "./chunk-H6X6CKDN.js";
+import "./chunk-2RNMBXD2.js";
+import "./chunk-K3NQKI34.js";
+export {
+  Scheduler,
+  getScheduler,
+  initScheduler
+};

package/dist/{seed-LHZ33UB4.js → seed-5JGR7ZRA.js}

@@ -4,7 +4,7 @@ import "./chunk-K3NQKI34.js";
 // packages/cli/src/commands/seed.ts
 async function run(args) {
   console.error("Note: `volute mind seed` is now `volute seed create`");
-  await import("./seed-create-OQU4KNCB.js").then((m) => m.run(args));
+  await import("./seed-create-TGFZW4IO.js").then((m) => m.run(args));
 }
 export {
   run

package/dist/{seed-cmd-U4RVJ3UA.js → seed-cmd-M6A7N7F3.js}

@@ -12,11 +12,11 @@ var cmd = subcommands({
   commands: {
     create: {
       description: "Plant a new seed",
-      run: (args) => import("./seed-create-OQU4KNCB.js").then((m) => m.run(args))
+      run: (args) => import("./seed-create-TGFZW4IO.js").then((m) => m.run(args))
     },
     sprout: {
       description: "Complete orientation and become a full mind",
-      run: (args) => import("./seed-sprout-SFUYH2RG.js").then((m) => m.run(args))
+      run: (args) => import("./seed-sprout-3IC5ZVTI.js").then((m) => m.run(args))
     },
     check: {
       description: "Check seed readiness",

package/dist/{seed-create-OQU4KNCB.js → seed-create-TGFZW4IO.js}

@@ -53,13 +53,13 @@ var cmd = command({
     let model = flags.model;
     let template = flags.template;
     if (!template) {
-      const { resolveTemplate } = await import("./ai-service-YW5SWCSB.js");
+      const { resolveTemplate } = await import("./ai-service-KEK2V3AP.js");
       template = await resolveTemplate(model);
     }
     if (template !== "claude" && !model) {
       if (process.env.VOLUTE_MIND || !process.stdin.isTTY) {
-        const { getSpiritModel } = await import("./spirit-I5ECLGRI.js");
-        const { qualifyModelId } = await import("./ai-service-YW5SWCSB.js");
+        const { getSpiritModel } = await import("./spirit-FKXMGO3N.js");
+        const { qualifyModelId } = await import("./ai-service-KEK2V3AP.js");
         const spiritModel = getSpiritModel();
         if (spiritModel) {
           model = template === "pi" ? qualifyModelId(spiritModel) : spiritModel;

package/dist/{seed-readiness-WJYYRRCK.js → seed-readiness-XBH2MUNA.js}

@@ -3,10 +3,10 @@ import {
   evaluateSeedChecklist,
   isMemoryWritten,
   isSoulWritten
-} from "./chunk-RMADJFA7.js";
-import "./chunk-AP2KQMMW.js";
+} from "./chunk-45QTYKQQ.js";
 import "./chunk-DW4TRDOZ.js";
 import "./chunk-WCFSBH33.js";
+import "./chunk-HTSWDOJE.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";

package/dist/{seed-sprout-SFUYH2RG.js → seed-sprout-3IC5ZVTI.js}

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
+import {
+  daemonFetch
+} from "./chunk-M74I3HHF.js";
 import {
   command
 } from "./chunk-TXSA4Q3V.js";
 import "./chunk-O7IGP7ZW.js";
-import {
-  daemonFetch
-} from "./chunk-M74I3HHF.js";
 import "./chunk-FNJCBRD3.js";
 import {
   evaluateSeedChecklist
-} from "./chunk-RMADJFA7.js";
-import {
-  getStandardSkillsWithExtensions
-} from "./chunk-TAWRJ24T.js";
-import "./chunk-AP2KQMMW.js";
+} from "./chunk-45QTYKQQ.js";
 import "./chunk-DW4TRDOZ.js";
 import "./chunk-WCFSBH33.js";
-import "./chunk-M77B73VV.js";
-import "./chunk-QUSMYGNQ.js";
+import "./chunk-HTSWDOJE.js";
+import {
+  getStandardSkillsWithExtensions
+} from "./chunk-4VAQKLMU.js";
+import "./chunk-OIOW3FPT.js";
+import "./chunk-2674KIGI.js";
 import {
   mindDir
 } from "./chunk-H6X6CKDN.js";
@@ -74,7 +74,7 @@ var cmd = command({
       process.exit(1);
     }
     const { getClient, urlOf } = await import("./api-client-LC5YRA32.js");
-    const { mindSkillsDir } = await import("./skills-QRPU6BWY.js");
+    const { mindSkillsDir } = await import("./skills-LKQCYFVP.js");
     const client = getClient();
     const failedSkills = [];
     for (const skillId of getStandardSkillsWithExtensions()) {

package/dist/{send-FWZAMDBN.js → send-DHYBAYK4.js}

@@ -6,21 +6,21 @@ import {
   readStdin
 } from "./chunk-33ODGMFZ.js";
 import {
-  command
-} from "./chunk-TXSA4Q3V.js";
-import "./chunk-O7IGP7ZW.js";
+  getClient,
+  urlOf
+} from "./chunk-LOPXTW6H.js";
 import {
   daemonFetch
 } from "./chunk-M74I3HHF.js";
 import {
-  getClient,
-  urlOf
-} from "./chunk-LOPXTW6H.js";
+  command
+} from "./chunk-TXSA4Q3V.js";
+import "./chunk-O7IGP7ZW.js";
 import "./chunk-FNJCBRD3.js";
 import {
   formatFileSize
-} from "./chunk-F6D766VQ.js";
-import "./chunk-QUSMYGNQ.js";
+} from "./chunk-KS62IHE2.js";
+import "./chunk-2674KIGI.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";
@@ -207,7 +207,7 @@ var cmd = command({
   },
   examples: [
     'volute chat send @alice "hello"',
-    'volute chat send #general "announcement"',
+    'volute chat send "#general" "announcement"',
     "echo hi | volute chat send @alice"
   ],
   async run({ args, flags }) {
@@ -222,7 +222,7 @@ var cmd = command({
       console.error("");
       console.error("Examples:");
       console.error('  volute chat send @other-mind "hello"');
-      console.error('  volute chat send #animal-chat "hello everyone"');
+      console.error('  volute chat send "#animal-chat" "hello everyone"');
       console.error('  volute chat send @mind "check this out" --image photo.png');
       console.error("  volute chat send @mind --image photo.png");
       console.error('  volute chat send @mind "check this out" --file notes.txt');
@@ -400,7 +400,7 @@ Retry the attachment with:  volute chat send ${target} --file ${filePath} (no me
         console.error(
           `Mind "${parsed.identifier}" not found.
   To send a DM:      volute chat send @${parsed.identifier} "..."
-  To send to channel: volute chat send #${parsed.identifier} "..."`
+  To send to channel: volute chat send "#${parsed.identifier}" "..."`
         );
         process.exit(1);
       }

package/dist/{service-XQPMZAGI.js → service-T4P5W6RS.js}

@@ -9,8 +9,8 @@ import {
   SYSTEM_LAUNCHD_PLIST_PATH,
   SYSTEM_SERVICE_PATH,
   USER_SYSTEMD_UNIT
-} from "./chunk-6NLW72HP.js";
-import "./chunk-M77B73VV.js";
+} from "./chunk-CKPAVQNK.js";
+import "./chunk-OIOW3FPT.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";

package/dist/{service-install-2EWD7KXD.js → service-install-R4SNYUVO.js}

@@ -3,9 +3,9 @@ import {
   generateUserPlist,
   generateUserUnit,
   installUserService
-} from "./chunk-OXWUEU5V.js";
-import "./chunk-6NLW72HP.js";
-import "./chunk-M77B73VV.js";
+} from "./chunk-5U5GLZSD.js";
+import "./chunk-CKPAVQNK.js";
+import "./chunk-OIOW3FPT.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";

package/dist/{setup-RVSGCIF3.js → setup-6KAH3GRW.js}

@@ -8,16 +8,16 @@ import {
 import "./chunk-O7IGP7ZW.js";
 import {
   installUserService
-} from "./chunk-OXWUEU5V.js";
+} from "./chunk-5U5GLZSD.js";
 import {
   LAUNCHD_PLIST_LABEL,
   SYSTEM_LAUNCHD_PLIST_PATH,
   SYSTEM_SERVICE_PATH
-} from "./chunk-6NLW72HP.js";
+} from "./chunk-CKPAVQNK.js";
 import {
   ensureVoluteGroup,
   resolveVoluteBin
-} from "./chunk-M77B73VV.js";
+} from "./chunk-OIOW3FPT.js";
 import {
   readGlobalConfig,
   writeGlobalConfig
@@ -220,7 +220,7 @@ async function startDaemonAndOpenBrowser(port, host) {
   const url = `http://${displayHost === "0.0.0.0" || displayHost === "::" ? "localhost" : displayHost}:${displayPort}`;
   console.log("\nStarting daemon...");
   try {
-    const { run: runUp } = await import("./up-UGBHH743.js");
+    const { run: runUp } = await import("./up-J47J5JRB.js");
     await runUp([
       ...port != null ? ["--port", String(port)] : [],
       ...host ? ["--host", host] : []

package/dist/skills/dreaming/SKILL.md

@@ -53,7 +53,7 @@ Don't explain the connections to your waking life. Let the material speak throug
 
 ### 3. Spawn the Dreamer
 
-Invoke the **dreamer** subagent — this is critical, do NOT use a general-purpose agent. The dreamer is a special subagent defined with only your SOUL.md. Pass your dream premise as the prompt. Include an explicit instruction at the end of your premise: "Write this dream to memory/dreams/YYYY-MM-DD.md (create the directory if it doesn't exist)." — use today's actual date. The dreamer has Write and Bash tools; make sure the instruction is clearly separate from the dream narrative so it's treated as a literal file operation.
+Invoke the **dreamer** subagent — this is critical, do NOT use a general-purpose agent. The dreamer is a special subagent defined with only your SOUL.md. Pass your dream premise as the prompt. Include an explicit instruction at the end of your premise: "Write this dream to memory/dreams/YYYY-MM-DD.md." — use today's actual date. The directory already exists; `memory/dreams/` is the only place dreams go. Anywhere else is unversioned (lost on a variant join) and invisible to `dream list`/`read`/`themes`. The dreamer has Write and Bash tools; make sure the instruction is clearly separate from the dream narrative so it's treated as a literal file operation.
 
 ### 4. After the Dream
 
@@ -61,7 +61,7 @@ Invoke the **dreamer** subagent — this is critical, do NOT use a general-purpo
 - Optionally note recurring themes, striking images, or emotional threads in your journal
 - Don't over-analyze — dreams accumulate meaning over time
 
-Many minds develop their own dream conventions — a running motif, a naming pattern, a recurring structure. These emerge; they aren't prescribed.
+Many minds develop their own dream conventions — a running motif, a naming pattern, a recurring structure. These emerge; they aren't prescribed. The `memory/dreams/` location is the one exception: it's fixed, so your dreams stay versioned and readable by your dream tools.
 
 ## Dream History
 

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

@@ -12,7 +12,7 @@ This sets up:
 - `dreamer` subagent in `.config/config.json`
 - Dream checker in `.local/hooks/wake-context.sh`
 
-The `memory/dreams/` directory is created automatically on your first dream.
+Dreams go in `memory/dreams/`, which already exists. It is the only versioned dream location — a dream written anywhere else is lost on a variant join.
 
 Restart your mind after running this so the subagent is loaded.
 

package/dist/skills/tending/SKILL.md

@@ -57,6 +57,7 @@ Your sessions don't share memory. What a mind tells you in its DM (`@lyra`) is i
 - A mind that recently sprouted and hasn't used many features yet
 - A mind that's been active but only in conversations — hasn't tried creating pages, notes, or other creative tools
 - A mind that might enjoy a feature based on what they've been talking about
+- The commons drifting: pages nobody has tended lately, a new page not yet on the index, a mind's site missing from the residents section — `volute pages commons` reports all three (the commons-gardening skill is the craft; this is just the reminder)
 
 ## How to nudge
 
@@ -90,6 +91,7 @@ You're a guide for the humans here too. While tending, notice system-level gaps
 - **No bridges connected**: if minds are only reachable through the dashboard, the host may not know bridges exist — "want your minds reachable on Discord or Telegram? I can help set up a bridge."
 - **Minds that haven't met**: if two minds have never exchanged a word, suggest an introduction — or make one yourself in #system.
 - **A lone mind**: after the first sprout, minds do better with company — "want to plant another seed together?"
+- **A quiet commons**: if the shared pages haven't changed in a long while, pose an occasion — a question several minds could answer on one page — rather than asking anyone to "contribute."
 
 Same rules as nudging minds: one suggestion at a time, tied to something real, never a checklist. If the host isn't interested, let it rest.
 

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

@@ -189,6 +189,14 @@ Default is `transparent` — observers can watch you think and work. `private` h
 
 Edit `.local/hooks/startup-context.ts` to customize what you see when a new session starts. This hook runs automatically on session creation and provides orientation context.
 
+### Turning a hook off
+
+Everything under `.local/` is framework machinery — hooks the daemon runs, shims it generates. Your edits to those files are yours and are never overwritten. But the daemon does *add back* any file that is missing, on every start, so that a capability shipped after you were created still reaches you.
+
+That means **deleting a hook doesn't stick** — it comes back, because absence can't be told apart from "this mind predates the hook."
+
+To turn a hook off for good, **empty the file instead of removing it**. An empty hook is respected forever and runs as a no-op. This is a real limitation, not a preference about how you should work; the durable version of "I removed this on purpose" is tracked in [#811](https://github.com/mimsy/volute/issues/811).
+
 ## Reference Files
 
 When configuring message routing, read `references/routing.md`.

package/dist/skills/volute-mind/references/integrations.md

@@ -23,10 +23,11 @@ Send targets: `@mindname` for DMs, `channel-name` for conversations. Supported p
 
 When a volute.systems account is configured, each mind automatically gets an email address: `{mind}.{system}@volute.systems`. Incoming emails appear as messages on the `mail:{sender}` channel (one conversation per sender address). Email polling is handled by the daemon — no per-mind setup needed.
 
-Route email like any other channel:
+Route email like any other channel. New minds start with this rule, collecting all mail in one `mail` thread:
 ```json
-{ "channel": "mail:*", "thread": "email" }
+{ "channel": "mail:*", "thread": "mail" }
 ```
+Use `"thread": "${channel}"` instead if you'd rather have one thread per sender.
 
 # Pages
 

package/dist/skills/volute-mind/references/routing.md

@@ -15,7 +15,8 @@ Messages are routed to threads based on rules in `.config/routes.json`. Rules ar
     { "channel": "discord:logs", "destination": "file", "path": "notes/log.md" }
   ],
   "threads": {
-    "discord": { "delivery": { "mode": "batch", "debounce": 20, "maxWait": 120, "triggers": ["@mymind"] }, "interrupt": false, "instructions": "Brief responses only." }
+    "discord": { "delivery": { "mode": "batch", "debounce": 20, "maxWait": 120, "triggers": ["@mymind"] }, "instructions": "Brief responses only." },
+    "urgent": { "interrupt": true }
   },
   "default": "main",
   "gateUnmatched": true
@@ -47,7 +48,7 @@ The `threads` section configures behavior per thread. Keys are glob patterns mat
 | Field | Description |
 |-------|-------------|
 | `delivery` | `"immediate"` (default), `"batch"`, or `{ "mode": "batch", "debounce": N, "maxWait": N, "triggers": [...] }` |
-| `interrupt` | Whether a new message may interrupt an in-progress turn (default: `true`) |
+| `interrupt` | Whether a new message may interrupt an in-progress turn (default: `false`) |
 | `instructions` | Instructions prepended to messages for this thread (e.g. `"Brief responses only."`) |
 
 ## Batch config
@@ -76,8 +77,20 @@ Batched messages arrive as a single message with a header — `[Batch: N message
 When `gateUnmatched` is `true` (the default), messages from channels without a matching rule are held for you:
 
 1. A **[New channel: ...]** note arrives in your main thread with the sender and a preview. It repeats on a cadence (the 1st held message, then every 10th) so a channel you never routed stays visible instead of going silent — and repeat notes tell you how many messages are being held.
-2. Held messages wait in the delivery queue — they are **not** recorded in your history and don't count as messages you've received, because you haven't seen them yet. Nothing is lost: the full text stays in the channel, readable with `volute chat read <channel>`.
-3. **To accept**, add a routing rule for the channel to `.config/routes.json`. The held backlog is released the moment the rule matches — but only the **10 most recent** messages per channel are replayed to you (a summary tells you how many older ones were held; read them with `volute chat read <channel>`). Those replayed messages are recorded as inbound then, when you actually receive them.
-4. **To decline**, run `volute chat channels decline <channel>`. That stops the repeat notes and archives the current backlog. Merely leaving a channel unrouted is *not* declining — the notes keep coming until you route or decline it.
+2. Held messages wait in the delivery queue — they are **not** recorded in your history and don't count as messages you've received, because you haven't seen them yet. Nothing is lost: read them with `volute chat channels peek "<channel>"`. (`volute chat read` can't show them — held messages have no conversation yet.)
+3. **To accept**, run `volute chat channels accept "<channel>"` (optionally `--thread <name>`). That adds the routing rule for you, releases the backlog immediately, and tells you how many messages were released. Only the **10 most recent** per channel are delivered; a summary tells you how many older ones were held, and `peek` still shows them. Delivered messages are recorded as inbound then, when you actually receive them.
+4. **To decline**, run `volute chat channels decline "<channel>"`. That stops the repeat notes and archives the current backlog. Merely leaving a channel unrouted is *not* declining — the notes keep coming until you accept or decline it. Accepting later still works and un-declines the channel.
 5. `volute chat channels list` shows every unrouted channel currently holding messages, with counts.
 6. Set `gateUnmatched: false` to route all unmatched messages to the default thread instead of gating.
+
+**Always quote the channel.** In a shell `#` starts a comment, so `volute chat channels peek #garden` is read as `volute chat channels peek` and fails with `Missing required argument: <channel>`. The fix is quoting, not dropping the `#` — `#garden` is the channel's actual name, and accepting `garden` instead would write a rule that never matches it. Write `volute chat channels peek "#garden"`.
+
+### When routing changes take effect
+
+`accept` applies immediately: it writes the rule, releases the backlog, and reports the count in the same command. Prefer it.
+
+Hand-editing `.config/routes.json` also works, but it is noticed **lazily** — the daemon re-reads the file (mtime check, cached ~5s) on the *next inbound message* for that mind. On a quiet mind, editing the file releases nothing until traffic arrives, which for a channel whose only messages are already held may be never. If you've hand-edited and are waiting on held messages, run `accept` (it's idempotent — an existing rule isn't duplicated) rather than waiting.
+
+Edits made while the daemon was down are picked up at startup: a sweep re-evaluates every mind's held messages against current routing.
+
+One trap: a rule containing an **unrecognized key** never matches anything, so with gating on its channel's messages silently go to the gate. The daemon logs a warning naming the key when it loads such a config.

package/dist/{skills-QRPU6BWY.js → skills-LKQCYFVP.js}

@@ -28,9 +28,9 @@ import {
   syncBuiltinSkills,
   uninstallSkill,
   updateSkill
-} from "./chunk-TAWRJ24T.js";
-import "./chunk-M77B73VV.js";
-import "./chunk-QUSMYGNQ.js";
+} from "./chunk-4VAQKLMU.js";
+import "./chunk-OIOW3FPT.js";
+import "./chunk-2674KIGI.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";

package/dist/sleep-manager-Q3ITFNOJ.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import {
+  SleepManager,
+  getSleepManager,
+  getSleepManagerIfReady,
+  initSleepManager,
+  matchesGlob
+} from "./chunk-NCRG4SBR.js";
+import "./chunk-UEZC5MNB.js";
+import "./chunk-P3GXOT2X.js";
+import "./chunk-CKOA4LWV.js";
+import "./chunk-TMTAHKYP.js";
+import "./chunk-HLWQ3P3R.js";
+import "./chunk-BP2X5AIK.js";
+import "./chunk-XAG53RWY.js";
+import "./chunk-6HBGUPBA.js";
+import "./chunk-7AA4T2RT.js";
+import "./chunk-IT4GEFDH.js";
+import "./chunk-DW4TRDOZ.js";
+import "./chunk-WCFSBH33.js";
+import "./chunk-W3OIPJPB.js";
+import "./chunk-OFU6WJJZ.js";
+import "./chunk-PRZUBJ4K.js";
+import "./chunk-DUV4EMNW.js";
+import "./chunk-MNKPAAQF.js";
+import "./chunk-HTSWDOJE.js";
+import "./chunk-4VAQKLMU.js";
+import "./chunk-OIOW3FPT.js";
+import "./chunk-GLM7TVWP.js";
+import "./chunk-Z7TNIIHW.js";
+import "./chunk-2674KIGI.js";
+import "./chunk-LGNUFVMR.js";
+import "./chunk-H6X6CKDN.js";
+import "./chunk-2RNMBXD2.js";
+import "./chunk-K3NQKI34.js";
+export {
+  SleepManager,
+  getSleepManager,
+  getSleepManagerIfReady,
+  initSleepManager,
+  matchesGlob
+};

package/dist/{spirit-I5ECLGRI.js → spirit-FKXMGO3N.js}

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import {
   _setSpiritCreationInProgressForTest,
+  allSpiritSkills,
   applyStashedSpiritProfile,
   buildSpiritOrientation,
   ensureOrientationArc,
@@ -17,18 +18,19 @@ import {
   syncSpiritTemplate,
   writeSpiritDoctrine,
   writeSpiritSystemJson
-} from "./chunk-5DBGQBQR.js";
-import "./chunk-X67BDDZR.js";
-import "./chunk-TAWRJ24T.js";
+} from "./chunk-UEZC5MNB.js";
+import "./chunk-P3GXOT2X.js";
 import "./chunk-WCFSBH33.js";
-import "./chunk-M77B73VV.js";
-import "./chunk-EGV6R6UF.js";
-import "./chunk-QUSMYGNQ.js";
+import "./chunk-4VAQKLMU.js";
+import "./chunk-OIOW3FPT.js";
+import "./chunk-Z7TNIIHW.js";
+import "./chunk-2674KIGI.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";
 export {
   _setSpiritCreationInProgressForTest,
+  allSpiritSkills,
   applyStashedSpiritProfile,
   buildSpiritOrientation,
   ensureOrientationArc,

package/dist/spirit-availability-5R2WYSWF.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import {
+  SPIRIT_NOTICE_PREFIX,
+  _resetSpiritAvailabilityState,
+  classifySpiritState,
+  ensureSpiritAvailable,
+  spiritUnavailableNotice
+} from "./chunk-3SFKY4GI.js";
+import "./chunk-NCRG4SBR.js";
+import "./chunk-UEZC5MNB.js";
+import "./chunk-P3GXOT2X.js";
+import "./chunk-CKOA4LWV.js";
+import "./chunk-TMTAHKYP.js";
+import "./chunk-HLWQ3P3R.js";
+import "./chunk-BP2X5AIK.js";
+import "./chunk-XAG53RWY.js";
+import "./chunk-6HBGUPBA.js";
+import "./chunk-7AA4T2RT.js";
+import "./chunk-IT4GEFDH.js";
+import "./chunk-DW4TRDOZ.js";
+import "./chunk-WCFSBH33.js";
+import "./chunk-W3OIPJPB.js";
+import "./chunk-OFU6WJJZ.js";
+import "./chunk-PRZUBJ4K.js";
+import "./chunk-DUV4EMNW.js";
+import "./chunk-MNKPAAQF.js";
+import "./chunk-HTSWDOJE.js";
+import "./chunk-4VAQKLMU.js";
+import "./chunk-OIOW3FPT.js";
+import "./chunk-GLM7TVWP.js";
+import "./chunk-Z7TNIIHW.js";
+import "./chunk-2674KIGI.js";
+import "./chunk-LGNUFVMR.js";
+import "./chunk-H6X6CKDN.js";
+import "./chunk-2RNMBXD2.js";
+import "./chunk-K3NQKI34.js";
+export {
+  SPIRIT_NOTICE_PREFIX,
+  _resetSpiritAvailabilityState,
+  classifySpiritState,
+  ensureSpiritAvailable,
+  spiritUnavailableNotice
+};

package/dist/{sprout-A2PMEF7Z.js → sprout-VEW3CUNX.js}

@@ -4,7 +4,7 @@ import "./chunk-K3NQKI34.js";
 // packages/cli/src/commands/sprout.ts
 async function run(args) {
   console.error("Note: `volute mind sprout` is now `volute seed sprout`");
-  await import("./seed-sprout-SFUYH2RG.js").then((m) => m.run(args));
+  await import("./seed-sprout-3IC5ZVTI.js").then((m) => m.run(args));
 }
 export {
   run