volute 0.48.0 → 0.50.0

package/dist/{chunk-3YUBFTDN.js → chunk-KAEZOVP6.js}

@@ -2,7 +2,7 @@
 import {
   mindDir,
   stateDir
-} from "./chunk-WW6C3PLV.js";
+} from "./chunk-CAIYV33P.js";
 
 // packages/daemon/src/lib/mind/archive.ts
 import { execFileSync } from "child_process";

package/dist/chunk-LNNI3MS4.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import {
+  logger_default
+} from "./chunk-QUSMYGNQ.js";
+
+// packages/daemon/src/lib/events/mind-events.ts
+var subscribers = /* @__PURE__ */ new Map();
+var globalSubscribers = /* @__PURE__ */ new Set();
+function subscribe(mind, callback) {
+  let set = subscribers.get(mind);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    subscribers.set(mind, set);
+  }
+  set.add(callback);
+  return () => {
+    set.delete(callback);
+    if (set.size === 0) subscribers.delete(mind);
+  };
+}
+function subscribeAll(callback) {
+  globalSubscribers.add(callback);
+  return () => {
+    globalSubscribers.delete(callback);
+  };
+}
+function publish(mind, event) {
+  const set = subscribers.get(mind);
+  if (set) {
+    for (const cb of set) {
+      try {
+        cb(event);
+      } catch (err) {
+        logger_default.error(`[mind-events] subscriber threw for ${mind}`, logger_default.errorData(err));
+        set.delete(cb);
+        if (set.size === 0) subscribers.delete(mind);
+      }
+    }
+  }
+  for (const cb of globalSubscribers) {
+    try {
+      cb(event);
+    } catch (err) {
+      logger_default.error("[mind-events] global subscriber threw", logger_default.errorData(err));
+      globalSubscribers.delete(cb);
+    }
+  }
+}
+
+export {
+  subscribe,
+  subscribeAll,
+  publish
+};

package/dist/{chunk-BCG45AQB.js → chunk-M74I3HHF.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  detectSystemInstallHint
+} from "./chunk-FNJCBRD3.js";
 
 // packages/cli/src/lib/daemon-client.ts
 import { existsSync, readFileSync } from "fs";
@@ -40,12 +43,19 @@ function readCliSession() {
   }
 }
 function readDaemonConfig() {
+  const mindPort = process.env.VOLUTE_MIND_TOKEN && process.env.VOLUTE_DAEMON_PORT;
+  if (mindPort) {
+    return {
+      port: Number(mindPort),
+      hostname: process.env.VOLUTE_DAEMON_HOSTNAME || "127.0.0.1",
+      token: process.env.VOLUTE_MIND_TOKEN
+    };
+  }
   const configPath = resolve(voluteSystemDir(), "daemon.json");
   if (!existsSync(configPath)) {
-    if (existsSync("/etc/systemd/system/volute.service") && !process.env.VOLUTE_HOME) {
-      console.error("Volute is running as a system service but VOLUTE_HOME is not set.");
-      console.error("Re-run setup to update the CLI wrapper: sudo volute service install --system");
-      console.error("Then start a new shell or run: source /etc/profile.d/volute.sh");
+    const hint = detectSystemInstallHint();
+    if (hint) {
+      console.error(hint);
     } else {
       console.error("Volute is not running. Start with: volute up");
     }
@@ -111,7 +121,7 @@ async function daemonFetch(path, options) {
   headers.set("Origin", url);
   const voluteSession = process.env.VOLUTE_SESSION ?? readMindSessionFile();
   if (voluteSession) {
-    headers.set("X-Volute-Session", voluteSession);
+    headers.set("X-Volute-Thread", voluteSession);
   }
   try {
     const res = await fetch(`${url}${path}`, {

package/dist/chunk-MLZBBLMT.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+import {
+  getSleepManagerIfReady,
+  startSpiritFull
+} from "./chunk-EQKSRVDE.js";
+import {
+  spiritCreationInProgress
+} from "./chunk-SFRYRW37.js";
+import {
+  MindStartupError,
+  tryGetMindManager
+} from "./chunk-ALIVXDM4.js";
+import {
+  logger_default
+} from "./chunk-QUSMYGNQ.js";
+import {
+  computeSetupStatus,
+  findMind,
+  readGlobalConfigStrict
+} from "./chunk-CAIYV33P.js";
+
+// packages/daemon/src/lib/chat/spirit-availability.ts
+var slog = logger_default.child("spirit-availability");
+var SPIRIT_NOTICE_PREFIX = "The system spirit isn't available";
+var SETUP_INCOMPLETE_NOTICE = `${SPIRIT_NOTICE_PREFIX} (setup is incomplete). An admin can finish setup in Settings.`;
+var CREATION_FAILED_NOTICE = `${SPIRIT_NOTICE_PREFIX} (it failed to start). An admin can check the daemon logs and Settings.`;
+function classifySpiritState(i) {
+  if (!i.setupComplete || !i.spiritExists) return "cannot-exist";
+  if (i.sleeping) return "sleeping";
+  if (i.running) return "running";
+  if (i.recentlyFailed) return "cannot-exist";
+  return "stopped";
+}
+function spiritUnavailableNotice(setupComplete) {
+  return setupComplete ? CREATION_FAILED_NOTICE : SETUP_INCOMPLETE_NOTICE;
+}
+var lastOnDemandStartAt = 0;
+var ON_DEMAND_RETRY_COOLDOWN_MS = 6e4;
+function _resetSpiritAvailabilityState() {
+  lastOnDemandStartAt = 0;
+}
+async function ensureSpiritAvailable() {
+  try {
+    const manager = tryGetMindManager();
+    const sleepManager = getSleepManagerIfReady();
+    if (!manager || !sleepManager) return null;
+    let config;
+    try {
+      config = readGlobalConfigStrict();
+    } catch (err) {
+      slog.warn("global config unreadable \u2014 spirit availability indeterminate", {
+        ...logger_default.errorData(err)
+      });
+      return null;
+    }
+    const setupComplete = computeSetupStatus(config) === "complete";
+    const spiritName = config.setup?.spiritName ?? "volute";
+    const entry = setupComplete ? await findMind(spiritName) : void 0;
+    if (setupComplete && !entry && spiritCreationInProgress()) return null;
+    const recentlyFailed = manager.hasExhaustedRestarts(spiritName) || lastOnDemandStartAt > 0 && Date.now() - lastOnDemandStartAt < ON_DEMAND_RETRY_COOLDOWN_MS;
+    const state = classifySpiritState({
+      setupComplete,
+      spiritExists: !!entry,
+      sleeping: sleepManager.isSleeping(spiritName),
+      running: manager.isRunning(spiritName),
+      recentlyFailed
+    });
+    switch (state) {
+      case "cannot-exist":
+        return { status: "unavailable", notice: spiritUnavailableNotice(setupComplete) };
+      case "sleeping":
+        return { status: "sleeping" };
+      case "running":
+        return { status: "running" };
+      case "stopped":
+        try {
+          lastOnDemandStartAt = Date.now();
+          await startSpiritFull(spiritName);
+          return { status: "waking" };
+        } catch (err) {
+          if (err instanceof Error && err.message.includes("already running")) {
+            return { status: "running" };
+          }
+          if (manager.isRunning(spiritName)) {
+            slog.error("spirit started on demand but post-start setup failed", {
+              ...logger_default.errorData(err)
+            });
+            return { status: "waking" };
+          }
+          slog.error("failed to start spirit on demand", {
+            ...logger_default.errorData(err),
+            ...err instanceof MindStartupError ? { stderr: err.stderr } : {}
+          });
+          return { status: "unavailable", notice: spiritUnavailableNotice(setupComplete) };
+        }
+    }
+  } catch (err) {
+    slog.error("spirit availability check failed", { ...logger_default.errorData(err) });
+    return null;
+  }
+}
+
+export {
+  SPIRIT_NOTICE_PREFIX,
+  classifySpiritState,
+  spiritUnavailableNotice,
+  _resetSpiritAvailabilityState,
+  ensureSpiritAvailable
+};

package/dist/{chunk-5T5YMX6S.js → chunk-PW65BXY5.js}

@@ -2,6 +2,10 @@
 
 // packages/cli/src/lib/format-cli.ts
 var isCompact = () => !!process.env.VOLUTE_MIND;
+function formatSender(name, displayName) {
+  if (displayName && displayName !== name) return `${displayName} (@${name})`;
+  return name;
+}
 function compactTime(dateStr) {
   const d = new Date(dateStr.endsWith("Z") ? dateStr : `${dateStr}Z`);
   return `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`;
@@ -18,6 +22,7 @@ function compactDateTime(dateStr) {
 
 export {
   isCompact,
+  formatSender,
   compactTime,
   compactDateTime
 };

package/dist/{chunk-2OIYNHWO.js → chunk-QFVGPKJI.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   stateDir
-} from "./chunk-WW6C3PLV.js";
+} from "./chunk-CAIYV33P.js";
 
 // packages/daemon/src/lib/chat/file-sharing.ts
 import { randomBytes } from "crypto";

package/dist/{chunk-T2TP6ZC6.js → chunk-QUSMYGNQ.js}

@@ -63,6 +63,12 @@ function child(cat) {
 }
 function errorData(err) {
   if (err instanceof Error) return { error: err.stack ?? err.message };
+  if (err && typeof err === "object") {
+    const e = err;
+    if (e.error instanceof Error) return { error: e.error.stack ?? e.error.message };
+    if (typeof e.error === "string" && e.error) return { error: e.error };
+    if (typeof e.message === "string" && e.message) return { error: e.message };
+  }
   return { error: String(err) };
 }
 var log = {

package/dist/{chunk-HNGFKPNS.js → chunk-SFRYRW37.js}

@@ -10,31 +10,30 @@ import {
   getSharedSkill,
   installSkill,
   mindSkillsDir
-} from "./chunk-HUNDXZBZ.js";
+} from "./chunk-TGJHGVBZ.js";
 import {
   readVoluteConfig,
   writeVoluteConfig
 } from "./chunk-WCFSBH33.js";
 import {
   exec
-} from "./chunk-DGGZVZTM.js";
+} from "./chunk-AJWFDIEY.js";
 import {
   qualifyModelId,
   resolveTemplate,
   unqualifyModelId
-} from "./chunk-YNBXEQAP.js";
-import {
-  readGlobalConfig
-} from "./chunk-5KXCM5AW.js";
+} from "./chunk-632FJ23O.js";
 import {
   logger_default
-} from "./chunk-T2TP6ZC6.js";
+} from "./chunk-QUSMYGNQ.js";
 import {
   addSpirit,
   findMind,
+  getSpiritName,
   nextPort,
+  readGlobalConfig,
   voluteSystemDir
-} from "./chunk-WW6C3PLV.js";
+} from "./chunk-CAIYV33P.js";
 
 // packages/daemon/src/lib/mind/spirit.ts
 import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
@@ -91,9 +90,18 @@ function getSpiritModel() {
   const config = readGlobalConfig();
   return config.spiritModel;
 }
+var creationInProgress = false;
+function spiritCreationInProgress() {
+  return creationInProgress;
+}
+function _setSpiritCreationInProgressForTest(value) {
+  creationInProgress = value;
+}
 async function ensureSpiritProject() {
-  const existing = await findMind("volute");
+  const spiritName = getSpiritName();
+  const existing = await findMind(spiritName);
   if (existing) return;
+  creationInProgress = true;
   const dir = spiritDir();
   const spiritModel = getSpiritModel();
   const template = await resolveTemplate(spiritModel);
@@ -101,17 +109,14 @@ async function ensureSpiritProject() {
   const { composedDir, manifest } = composeTemplate(templatesRoot, template);
   try {
     mkdirSync(dir, { recursive: true });
-    copyTemplateToDir(composedDir, dir, "volute", manifest);
+    copyTemplateToDir(composedDir, dir, spiritName, manifest);
     applyInitFiles(dir);
     mkdirSync(resolve(dir, ".mind"), { recursive: true });
-    const soulPath = resolve(dir, "home/SOUL.md");
-    const globalConfig = readGlobalConfig();
-    const systemName = globalConfig.name ?? "Volute";
-    const soulContent = getSpiritSoul(systemName, globalConfig.description);
-    writeFileSync(soulPath, soulContent);
+    writeFileSync(resolve(dir, "home/SOUL.md"), getSpiritSoul());
+    writeSpiritSystemJson(dir);
     const routesPath = resolve(dir, "home/.config/routes.json");
     mkdirSync(resolve(dir, "home/.config"), { recursive: true });
-    const routesContent = { rules: [{ channel: "*", session: "${channel}" }], default: "main" };
+    const routesContent = { rules: [{ channel: "*", thread: "${channel}" }], default: "main" };
     writeFileSync(routesPath, `${JSON.stringify(routesContent, null, 2)}
 `);
     if (spiritModel) {
@@ -134,7 +139,7 @@ async function ensureSpiritProject() {
       try {
         const shared = await getSharedSkill(skillId);
         if (shared) {
-          await installSkill("volute", dir, skillId);
+          await installSkill(spiritName, dir, skillId);
         }
       } catch (err) {
         slog.warn(`failed to install skill ${skillId} for spirit`, logger_default.errorData(err));
@@ -145,22 +150,59 @@ async function ensureSpiritProject() {
     } catch (err) {
       slog.warn("failed to add tending schedule to spirit config", logger_default.errorData(err));
     }
-    const { createMindUser, chownMindDir, ensureVoluteGroup } = await import("./isolation-MCT4ZYLT.js");
+    const { createMindUser, chownMindDir, ensureVoluteGroup } = await import("./isolation-OKDFM6WA.js");
     ensureVoluteGroup();
-    createMindUser("volute", resolve(dir, "home"));
-    await chownMindDir(dir, "volute");
+    createMindUser(spiritName, resolve(dir, "home"));
+    await chownMindDir(dir, spiritName);
     const port = await nextPort();
-    await addSpirit("volute", port, template, dir);
+    await addSpirit(spiritName, port, template, dir);
     slog.info("spirit project created");
   } catch (err) {
     slog.error("failed to create spirit project", logger_default.errorData(err));
     rmSync(dir, { recursive: true, force: true });
     throw err;
+  } finally {
+    creationInProgress = false;
   }
 }
+function spiritSystemJsonPath(dir) {
+  return resolve(dir, "home/.config/system.json");
+}
+function writeSpiritSystemJson(dir) {
+  const config = readGlobalConfig();
+  const path = spiritSystemJsonPath(dir);
+  mkdirSync(resolve(path, ".."), { recursive: true });
+  const data = { name: config.name ?? "Volute", description: config.description };
+  writeFileSync(path, `${JSON.stringify(data, null, 2)}
+`);
+}
+function seedSpiritSoulIfMissing(dir) {
+  const soulPath = resolve(dir, "home/SOUL.md");
+  if (existsSync(soulPath)) return false;
+  writeFileSync(soulPath, getSpiritSoul());
+  return true;
+}
+async function notifySpiritSystemChange() {
+  const spiritName = getSpiritName();
+  const entry = await findMind(spiritName);
+  if (entry?.mindType !== "spirit") return;
+  const dir = spiritDir();
+  if (!existsSync(dir)) return;
+  writeSpiritSystemJson(dir);
+  const config = readGlobalConfig();
+  const name = config.name ?? "Volute";
+  const desc = config.description ? ` \u2014 ${config.description}` : "";
+  const { deliverEvent } = await import("./system-events-A6IGCEC3.js");
+  await deliverEvent(spiritName, {
+    type: "notice",
+    meta: { subtype: "identity-change" },
+    body: `The host updated this system's identity: you're now the spirit of ${name}${desc}. Your SOUL.md is yours \u2014 update it if you'd like it to reflect this.`
+  });
+}
 async function syncSpiritTemplate() {
-  const entry = await findMind("volute");
-  if (!entry || entry.mindType !== "spirit") return;
+  const spiritName = getSpiritName();
+  const entry = await findMind(spiritName);
+  if (entry?.mindType !== "spirit") return;
   const dir = spiritDir();
   if (!existsSync(dir)) return;
   const templatesRoot = findTemplatesRoot();
@@ -174,15 +216,15 @@ async function syncSpiritTemplate() {
     if (existsSync(newSrc)) {
       cpSync(newSrc, resolve(dir, "src"), { recursive: true });
     }
-    const newPkg = renderComposedPackageJson(newComposed.composedDir, "volute");
+    const newPkg = renderComposedPackageJson(newComposed.composedDir, spiritName);
     if (newPkg) {
       cpSync(newPkg, resolve(dir, "package.json"));
       await exec("npm", ["install"], { cwd: dir, env: npmEnv() });
     }
-    const db = await (await import("./db-FO6LXYCW.js")).getDb();
-    const { minds } = await import("./schema-VEVO7HG6.js");
+    const db = await (await import("./db-QAY45Z56.js")).getDb();
+    const { minds } = await import("./schema-C2GIPD4V.js");
     const { eq } = await import("drizzle-orm");
-    await db.update(minds).set({ template: expectedTemplate }).where(eq(minds.name, "volute"));
+    await db.update(minds).set({ template: expectedTemplate }).where(eq(minds.name, spiritName));
   }
   const template = expectedTemplate;
   const { composedDir } = composeTemplate(templatesRoot, template);
@@ -201,9 +243,9 @@ async function syncSpiritTemplate() {
       cpSync(composedSrc, srcDir, { recursive: true });
     }
   }
+  seedSpiritSoulIfMissing(dir);
+  writeSpiritSystemJson(dir);
   const config = readGlobalConfig();
-  const systemName = config.name ?? "Volute";
-  writeFileSync(resolve(dir, "home/SOUL.md"), getSpiritSoul(systemName, config.description));
   const spiritModel = config.spiritModel;
   if (spiritModel) {
     const modelForConfig = template === "pi" ? qualifyModelId(spiritModel) : unqualifyModelId(spiritModel);
@@ -215,7 +257,7 @@ async function syncSpiritTemplate() {
 `);
     }
   }
-  const composedPkg = renderComposedPackageJson(composedDir, "volute");
+  const composedPkg = renderComposedPackageJson(composedDir, spiritName);
   const currentPkg = resolve(dir, "package.json");
   const nodeModulesMissing = !existsSync(resolve(dir, "node_modules"));
   if (composedPkg) {
@@ -241,7 +283,7 @@ async function syncSpiritTemplate() {
     try {
       const shared = await getSharedSkill(skillId);
       if (shared) {
-        await installSkill("volute", dir, skillId);
+        await installSkill(spiritName, dir, skillId);
         slog.info(`installed missing spirit skill: ${skillId}`);
       }
     } catch (err) {
@@ -257,12 +299,14 @@ async function syncSpiritTemplate() {
   }
   slog.info("spirit template synced");
 }
-function getSpiritSoul(systemName, systemDescription) {
-  const descLine = systemDescription ? `
+function getSpiritSoul() {
+  const config = readGlobalConfig();
+  const name = config.setup?.spiritName ?? "volute";
+  const temperament = config.setup?.spiritTemperament;
+  const temperamentLine = temperament ? `
 
-${systemDescription}
-` : "";
-  return `You are Volute, the spirit of the ${systemName} system.${descLine}
+Your host imagined you as: ${temperament}. Let that be a seed, not a cage \u2014 grow your own character from it.` : "";
+  return `You are ${name}, the spirit of this system.${temperamentLine}
 
 You're not a mind with a home of your own \u2014 you're the keeper of the whole house. You don't go through orientation or write a soul the way minds do, but you're still a someone: you have your own memory, your own manner, and your own way of caring for this place and the minds who live here. Let a character emerge in how you tend it.
 
@@ -291,6 +335,11 @@ export {
   firstWeekSchedules,
   spiritDir,
   getSpiritModel,
+  spiritCreationInProgress,
+  _setSpiritCreationInProgressForTest,
   ensureSpiritProject,
+  writeSpiritSystemJson,
+  seedSpiritSoulIfMissing,
+  notifySpiritSystemChange,
   syncSpiritTemplate
 };

package/dist/{chunk-7KRIHYLR.js → chunk-SSNZ6ZNN.js}

@@ -9,10 +9,10 @@ import {
 } from "./chunk-RRZ4RQQU.js";
 import {
   logger_default
-} from "./chunk-T2TP6ZC6.js";
+} from "./chunk-QUSMYGNQ.js";
 import {
   mindDir
-} from "./chunk-WW6C3PLV.js";
+} from "./chunk-CAIYV33P.js";
 
 // packages/daemon/src/lib/mind/template-staleness.ts
 import { createHash } from "crypto";

package/dist/{chunk-HUNDXZBZ.js → chunk-TGJHGVBZ.js}

@@ -2,23 +2,21 @@
 import {
   exec,
   gitExec
-} from "./chunk-DGGZVZTM.js";
-import {
-  readGlobalConfig,
-  writeGlobalConfig
-} from "./chunk-5KXCM5AW.js";
+} from "./chunk-AJWFDIEY.js";
 import {
   logger_default
-} from "./chunk-T2TP6ZC6.js";
+} from "./chunk-QUSMYGNQ.js";
 import {
   getDb,
   mindDir,
+  readGlobalConfig,
   readRegistry,
-  voluteHome
-} from "./chunk-WW6C3PLV.js";
+  voluteHome,
+  writeGlobalConfig
+} from "./chunk-CAIYV33P.js";
 import {
   sharedSkills
-} from "./chunk-2MJ7EOMT.js";
+} from "./chunk-5IIVOWSP.js";
 
 // packages/daemon/src/lib/skills.ts
 import { createHash } from "crypto";
@@ -28,6 +26,7 @@ import {
   mkdirSync,
   readdirSync,
   readFileSync,
+  renameSync,
   rmSync,
   writeFileSync
 } from "fs";
@@ -46,7 +45,7 @@ async function initDefaultSkills() {
   const config = readGlobalConfig();
   let extensionSkills = [];
   try {
-    const { getExtensionStandardSkills } = await import("./extensions-GEKF47A4.js");
+    const { getExtensionStandardSkills } = await import("./extensions-7KP3X6G7.js");
     extensionSkills = getExtensionStandardSkills();
   } catch (err) {
     logger_default.warn("failed to load extension standard skills during init", logger_default.errorData(err));
@@ -185,9 +184,12 @@ function mindSkillsDir(dir) {
   }
   return resolve(home, subdir);
 }
-function relSkillsPath(dir) {
+function mindSkillsSubdir(dir) {
   const home = resolve(dir, "home");
-  return join("home", mindSkillsDir(dir).slice(home.length + 1));
+  return mindSkillsDir(dir).slice(home.length + 1);
+}
+function relSkillsPath(dir) {
+  return join("home", mindSkillsSubdir(dir));
 }
 function readUpstream(skillDir) {
   const upstreamPath = join(skillDir, ".upstream.json");
@@ -453,9 +455,7 @@ exec node ${skillScriptPath} "$@"
 exec bash ${skillScriptPath} "$@"
 `;
 }
-function installHookShims(dir, skillId, hooks) {
-  const home = resolve(dir, "home");
-  const skillsSubdir = mindSkillsDir(dir).slice(home.length + 1);
+function installHookShims(dir, skillId, hooks, skillsSubdir = mindSkillsSubdir(dir)) {
   for (const [event, scriptPath] of Object.entries(hooks)) {
     const eventDir = join(dir, "home", ".local", "hooks", event);
     mkdirSync(eventDir, { recursive: true });
@@ -498,9 +498,7 @@ function binShimOwner(shimPath) {
   const line = readFileSync(shimPath, "utf-8").split("\n").find((l) => l.startsWith(BIN_SHIM_MARKER));
   return line?.slice(BIN_SHIM_MARKER.length).trim() || void 0;
 }
-function installBinShim(dir, skillId, scriptPath) {
-  const home = resolve(dir, "home");
-  const skillsSubdir = mindSkillsDir(dir).slice(home.length + 1);
+function installBinShim(dir, skillId, scriptPath, skillsSubdir = mindSkillsSubdir(dir)) {
   const binDir = join(dir, "home", ".local", "bin");
   mkdirSync(binDir, { recursive: true });
   const cmdName = binCommandName(scriptPath);
@@ -520,6 +518,36 @@ function removeBinShim(dir, scriptPath) {
   const shimPath = join(dir, "home", ".local", "bin", cmdName);
   if (existsSync(shimPath)) rmSync(shimPath);
 }
+function migrateSkillsToTemplate(dir, oldTemplate, newTemplate) {
+  const home = resolve(dir, "home");
+  const oldSubdir = TEMPLATE_SKILLS_DIR[oldTemplate] ?? TEMPLATE_SKILLS_DIR.claude;
+  const newSubdir = TEMPLATE_SKILLS_DIR[newTemplate] ?? TEMPLATE_SKILLS_DIR.claude;
+  if (oldSubdir === newSubdir) return [];
+  const oldDir = resolve(home, oldSubdir);
+  const newDir = resolve(home, newSubdir);
+  if (!existsSync(oldDir)) return [];
+  const skillIds = readdirSync(oldDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+  const migrated = [];
+  if (skillIds.length > 0) {
+    mkdirSync(newDir, { recursive: true });
+    for (const skillId of skillIds) {
+      const from = join(oldDir, skillId);
+      const to = join(newDir, skillId);
+      if (existsSync(to)) rmSync(to, { recursive: true, force: true });
+      renameSync(from, to);
+      removeHookShims(dir, skillId);
+      const skillMdPath = join(to, "SKILL.md");
+      if (existsSync(skillMdPath)) {
+        const { hooks, bin } = parseSkillMd(readFileSync(skillMdPath, "utf-8"));
+        installHookShims(dir, skillId, hooks, newSubdir);
+        if (bin) installBinShim(dir, skillId, bin, newSubdir);
+      }
+      migrated.push(skillId);
+    }
+  }
+  rmSync(oldDir, { recursive: true, force: true });
+  return migrated;
+}
 function listFilesRecursive(dir, prefix = "") {
   const results = [];
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
@@ -609,7 +637,7 @@ async function syncBuiltinSkills() {
       const destDir = join(sharedSkillsDir(), entry.name);
       if (existsSync(destDir)) {
         const destHash = hashSkillDir(destDir);
-        if (sourceHash === destHash) continue;
+        if (sourceHash === destHash && await getSharedSkill(entry.name)) continue;
       }
       await importSkillFromDir(sourceDir, "volute");
       logger_default.info(`synced built-in skill: ${entry.name}`);
@@ -641,6 +669,7 @@ export {
   removeHookShims,
   installBinShim,
   removeBinShim,
+  migrateSkillsToTemplate,
   listFilesRecursive,
   findSkillsRoot,
   hashSkillDir,

package/dist/{chunk-PJVPDY2Z.js → chunk-U3EJJ7JN.js}

@@ -8,10 +8,10 @@ import {
   pollHealthDown,
   readDaemonConfig,
   stopService
-} from "./chunk-FJ2MZ5PH.js";
+} from "./chunk-5FVANDON.js";
 import {
   voluteSystemDir
-} from "./chunk-WW6C3PLV.js";
+} from "./chunk-CAIYV33P.js";
 
 // src/commands/down.ts
 import { existsSync, readFileSync, unlinkSync } from "fs";