volute 0.52.0 → 0.54.0

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-MPUALV3S.js → skills-GMQ5UIIW.js}

@@ -28,8 +28,8 @@ import {
   syncBuiltinSkills,
   uninstallSkill,
   updateSkill
-} from "./chunk-RPPTGPYF.js";
-import "./chunk-M77B73VV.js";
+} from "./chunk-PPSN2MLC.js";
+import "./chunk-OIOW3FPT.js";
 import "./chunk-QUSMYGNQ.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";

package/dist/{sleep-manager-OFP2GFXF.js → sleep-manager-KHI65FEX.js}

@@ -5,19 +5,19 @@ import {
   getSleepManagerIfReady,
   initSleepManager,
   matchesGlob
-} from "./chunk-ZEZQNP2G.js";
-import "./chunk-K2F237KS.js";
+} from "./chunk-LGXVGIWN.js";
+import "./chunk-RGHF3OK5.js";
 import "./chunk-X67BDDZR.js";
-import "./chunk-SW2U6HRB.js";
-import "./chunk-RU74YG46.js";
-import "./chunk-724DVYHU.js";
-import "./chunk-UDZLPR34.js";
-import "./chunk-YVR6EHWL.js";
-import "./chunk-RPPTGPYF.js";
+import "./chunk-444RR3YF.js";
+import "./chunk-VDUCLVZI.js";
+import "./chunk-WHL6PKYP.js";
+import "./chunk-YSRYCS3N.js";
+import "./chunk-56IT2ZXF.js";
+import "./chunk-PPSN2MLC.js";
 import "./chunk-7LT3YZUR.js";
-import "./chunk-AXFLY5GU.js";
+import "./chunk-HKGYZVWN.js";
 import "./chunk-LNNI3MS4.js";
-import "./chunk-FXWBFDQR.js";
+import "./chunk-OAYY3WF3.js";
 import "./chunk-5Y54AE3L.js";
 import "./chunk-TPX6E6PL.js";
 import "./chunk-UFTDRTCP.js";
@@ -25,10 +25,11 @@ import "./chunk-U54PJPTB.js";
 import "./chunk-ICXY54ZC.js";
 import "./chunk-DW4TRDOZ.js";
 import "./chunk-WCFSBH33.js";
-import "./chunk-M77B73VV.js";
+import "./chunk-OIOW3FPT.js";
 import "./chunk-GLM7TVWP.js";
 import "./chunk-EGV6R6UF.js";
 import "./chunk-QUSMYGNQ.js";
+import "./chunk-LGNUFVMR.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";

package/dist/{spirit-4ECYIVGE.js → spirit-Q5VGFWUI.js}

@@ -1,20 +1,28 @@
 #!/usr/bin/env node
 import {
   _setSpiritCreationInProgressForTest,
+  allSpiritSkills,
+  applyStashedSpiritProfile,
+  buildSpiritOrientation,
+  ensureOrientationArc,
   ensureSpiritProject,
   firstWeekSchedules,
+  getSpiritDoctrine,
   getSpiritModel,
   notifySpiritSystemChange,
+  orientationArcSchedules,
   seedSpiritSoulIfMissing,
+  sendSpiritOrientation,
   spiritCreationInProgress,
   spiritDir,
   syncSpiritTemplate,
+  writeSpiritDoctrine,
   writeSpiritSystemJson
-} from "./chunk-K2F237KS.js";
+} from "./chunk-RGHF3OK5.js";
 import "./chunk-X67BDDZR.js";
-import "./chunk-RPPTGPYF.js";
+import "./chunk-PPSN2MLC.js";
 import "./chunk-WCFSBH33.js";
-import "./chunk-M77B73VV.js";
+import "./chunk-OIOW3FPT.js";
 import "./chunk-EGV6R6UF.js";
 import "./chunk-QUSMYGNQ.js";
 import "./chunk-H6X6CKDN.js";
@@ -22,13 +30,21 @@ import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";
 export {
   _setSpiritCreationInProgressForTest,
+  allSpiritSkills,
+  applyStashedSpiritProfile,
+  buildSpiritOrientation,
+  ensureOrientationArc,
   ensureSpiritProject,
   firstWeekSchedules,
+  getSpiritDoctrine,
   getSpiritModel,
   notifySpiritSystemChange,
+  orientationArcSchedules,
   seedSpiritSoulIfMissing,
+  sendSpiritOrientation,
   spiritCreationInProgress,
   spiritDir,
   syncSpiritTemplate,
+  writeSpiritDoctrine,
   writeSpiritSystemJson
 };

package/dist/{spirit-availability-Y54Y3675.js → spirit-availability-G5FMWKRH.js}

@@ -5,20 +5,20 @@ import {
   classifySpiritState,
   ensureSpiritAvailable,
   spiritUnavailableNotice
-} from "./chunk-CW7BQKF6.js";
-import "./chunk-ZEZQNP2G.js";
-import "./chunk-K2F237KS.js";
+} from "./chunk-LKUGUQUW.js";
+import "./chunk-LGXVGIWN.js";
+import "./chunk-RGHF3OK5.js";
 import "./chunk-X67BDDZR.js";
-import "./chunk-SW2U6HRB.js";
-import "./chunk-RU74YG46.js";
-import "./chunk-724DVYHU.js";
-import "./chunk-UDZLPR34.js";
-import "./chunk-YVR6EHWL.js";
-import "./chunk-RPPTGPYF.js";
+import "./chunk-444RR3YF.js";
+import "./chunk-VDUCLVZI.js";
+import "./chunk-WHL6PKYP.js";
+import "./chunk-YSRYCS3N.js";
+import "./chunk-56IT2ZXF.js";
+import "./chunk-PPSN2MLC.js";
 import "./chunk-7LT3YZUR.js";
-import "./chunk-AXFLY5GU.js";
+import "./chunk-HKGYZVWN.js";
 import "./chunk-LNNI3MS4.js";
-import "./chunk-FXWBFDQR.js";
+import "./chunk-OAYY3WF3.js";
 import "./chunk-5Y54AE3L.js";
 import "./chunk-TPX6E6PL.js";
 import "./chunk-UFTDRTCP.js";
@@ -26,10 +26,11 @@ import "./chunk-U54PJPTB.js";
 import "./chunk-ICXY54ZC.js";
 import "./chunk-DW4TRDOZ.js";
 import "./chunk-WCFSBH33.js";
-import "./chunk-M77B73VV.js";
+import "./chunk-OIOW3FPT.js";
 import "./chunk-GLM7TVWP.js";
 import "./chunk-EGV6R6UF.js";
 import "./chunk-QUSMYGNQ.js";
+import "./chunk-LGNUFVMR.js";
 import "./chunk-H6X6CKDN.js";
 import "./chunk-2RNMBXD2.js";
 import "./chunk-K3NQKI34.js";

package/dist/{sprout-GJMZFRGZ.js → sprout-PMTRL7QN.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-NIDIOJXT.js").then((m) => m.run(args));
+  await import("./seed-sprout-PPGYGK4G.js").then((m) => m.run(args));
 }
 export {
   run