volute 0.33.0 → 0.35.0

package/dist/skill-PSQGRRJX.js

@@ -1,358 +0,0 @@
-#!/usr/bin/env node
-import {
-  resolveMindName
-} from "./chunk-NAOW2CLO.js";
-import {
-  getClient,
-  urlOf
-} from "./chunk-4RQBJWQX.js";
-import {
-  daemonFetch
-} from "./chunk-UKVWJRKN.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
-import "./chunk-LRCG2JLP.js";
-import "./chunk-RPZZSXV3.js";
-import "./chunk-K3NQKI34.js";
-
-// src/commands/skill.ts
-async function run(args) {
-  const subcommand = args[0];
-  switch (subcommand) {
-    case "list":
-      await listSkills(args.slice(1));
-      break;
-    case "info":
-      await infoSkill(args.slice(1));
-      break;
-    case "install":
-      await installSkill(args.slice(1));
-      break;
-    case "update":
-      await updateSkill(args.slice(1));
-      break;
-    case "publish":
-      await publishSkill(args.slice(1));
-      break;
-    case "remove":
-      await removeSkill(args.slice(1));
-      break;
-    case "uninstall":
-      await uninstallSkill(args.slice(1));
-      break;
-    case "defaults":
-      await manageDefaults(args.slice(1));
-      break;
-    case "--help":
-    case "-h":
-    case void 0:
-      printUsage();
-      break;
-    default:
-      console.error(`Unknown subcommand: ${subcommand}`);
-      printUsage();
-      process.exit(1);
-  }
-}
-function printUsage() {
-  console.log(`Usage:
-  volute skill list                    List shared skills available to install
-  volute skill list --mind <name>      List installed skills for a mind
-  volute skill info <name>             Show details of a shared skill
-  volute skill install <name> --mind   Install a shared skill into a mind
-  volute skill update <name> --mind    Update an installed skill (3-way merge)
-  volute skill update --all --mind     Update all installed skills
-  volute skill publish <name> --mind   Publish a mind's skill to the shared repository
-  volute skill remove <name>           Remove a shared skill
-  volute skill uninstall <name> --mind Uninstall a skill from a mind
-  volute skill defaults                List default skills for new minds
-  volute skill defaults add <name>     Add a skill to the default set
-  volute skill defaults remove <name>  Remove a skill from the default set`);
-}
-async function listSkills(args) {
-  const { flags } = parseArgs(args, { mind: { type: "string" } });
-  if (flags.mind || process.env.VOLUTE_MIND) {
-    const mindName = resolveMindName(flags);
-    const client = getClient();
-    const url = urlOf(client.api.minds[":name"].skills.$url({ param: { name: mindName } }));
-    const res = await daemonFetch(url);
-    if (!res.ok) {
-      const body = await res.json().catch(() => ({ error: "Unknown error" }));
-      console.error(`Error: ${body.error}`);
-      process.exit(1);
-    }
-    const skills = await res.json();
-    if (skills.length === 0) {
-      console.log("No skills installed.");
-      return;
-    }
-    console.log(`Skills for ${mindName}:
-`);
-    for (const s of skills) {
-      const update = s.updateAvailable ? " (update available)" : "";
-      const source = s.upstream ? ` [shared:${s.upstream.source} v${s.upstream.version}]` : "";
-      console.log(`  ${s.id} \u2014 ${s.name}${source}${update}`);
-    }
-  } else {
-    const client = getClient();
-    const url = urlOf(client.api.skills.$url());
-    const res = await daemonFetch(url);
-    if (!res.ok) {
-      const body = await res.json().catch(() => ({ error: "Unknown error" }));
-      console.error(`Error: ${body.error}`);
-      process.exit(1);
-    }
-    const skills = await res.json();
-    if (skills.length === 0) {
-      console.log("No shared skills available.");
-      return;
-    }
-    console.log("Shared skills:\n");
-    for (const s of skills) {
-      console.log(`  ${s.id} \u2014 ${s.name} (v${s.version}, by ${s.author})`);
-      if (s.description) console.log(`    ${s.description}`);
-    }
-  }
-}
-async function infoSkill(args) {
-  const { positional } = parseArgs(args, {});
-  const id = positional[0];
-  if (!id) {
-    console.error("Usage: volute skill info <name>");
-    process.exit(1);
-  }
-  const client = getClient();
-  const url = urlOf(client.api.skills[":id"].$url({ param: { id } }));
-  const res = await daemonFetch(url);
-  if (!res.ok) {
-    const body = await res.json().catch(() => ({ error: "Unknown error" }));
-    console.error(`Error: ${body.error}`);
-    process.exit(1);
-  }
-  const skill = await res.json();
-  console.log(`${skill.name} (${skill.id})`);
-  console.log(`  Version: ${skill.version}`);
-  console.log(`  Author: ${skill.author}`);
-  if (skill.description) console.log(`  Description: ${skill.description}`);
-  console.log(`  Files: ${skill.files.join(", ")}`);
-}
-async function installSkill(args) {
-  const { positional, flags } = parseArgs(args, { mind: { type: "string" } });
-  const mindName = resolveMindName(flags);
-  const skillId = positional[0];
-  if (!skillId) {
-    console.error("Usage: volute skill install <name> [--mind <name>]");
-    process.exit(1);
-  }
-  const client = getClient();
-  const url = urlOf(client.api.minds[":name"].skills.install.$url({ param: { name: mindName } }));
-  const res = await daemonFetch(url, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ skillId })
-  });
-  if (!res.ok) {
-    const body2 = await res.json().catch(() => ({ error: "Unknown error" }));
-    console.error(`Error: ${body2.error}`);
-    process.exit(1);
-  }
-  const body = await res.json().catch(() => ({}));
-  console.log(`Installed skill "${skillId}" into ${mindName}.`);
-  if (body.npmInstalled?.length) {
-    console.log(`Installed npm dependencies: ${body.npmInstalled.join(", ")}`);
-  }
-  if (body.installNotes) {
-    console.log("");
-    console.log(body.installNotes);
-  }
-}
-async function updateSkill(args) {
-  const { positional, flags } = parseArgs(args, {
-    mind: { type: "string" },
-    all: { type: "boolean" }
-  });
-  const mindName = resolveMindName(flags);
-  if (flags.all) {
-    const client = getClient();
-    const listUrl = urlOf(client.api.minds[":name"].skills.$url({ param: { name: mindName } }));
-    const listRes = await daemonFetch(listUrl);
-    if (!listRes.ok) {
-      const body = await listRes.json().catch(() => ({ error: "Unknown error" }));
-      console.error(`Error: ${body.error}`);
-      process.exit(1);
-    }
-    const skills = await listRes.json();
-    const updatable = skills.filter((s) => s.updateAvailable && s.upstream);
-    if (updatable.length === 0) {
-      console.log("All skills are up to date.");
-      return;
-    }
-    let failures = 0;
-    for (const s of updatable) {
-      const ok2 = await doUpdate(mindName, s.id);
-      if (!ok2) failures++;
-    }
-    if (failures > 0) process.exit(1);
-    return;
-  }
-  const skillId = positional[0];
-  if (!skillId) {
-    console.error("Usage: volute skill update <name> [--mind <name>] [--all]");
-    process.exit(1);
-  }
-  const ok = await doUpdate(mindName, skillId);
-  if (!ok) process.exit(1);
-}
-async function doUpdate(mindName, skillId) {
-  const client = getClient();
-  const url = urlOf(client.api.minds[":name"].skills.update.$url({ param: { name: mindName } }));
-  const res = await daemonFetch(url, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ skillId })
-  });
-  if (!res.ok) {
-    const body = await res.json().catch(() => ({ error: "Unknown error" }));
-    console.error(`Error updating ${skillId}: ${body.error}`);
-    return false;
-  }
-  const result = await res.json();
-  switch (result.status) {
-    case "up-to-date":
-      console.log(`${skillId}: already up to date.`);
-      break;
-    case "updated":
-      console.log(`${skillId}: updated successfully.`);
-      break;
-    case "conflict":
-      console.log(`${skillId}: updated with conflicts in:`);
-      for (const f of result.conflictFiles ?? []) {
-        console.log(`  ${f}`);
-      }
-      console.log("Resolve conflicts and commit manually.");
-      break;
-  }
-  return true;
-}
-async function publishSkill(args) {
-  const { positional, flags } = parseArgs(args, { mind: { type: "string" } });
-  const mindName = resolveMindName(flags);
-  const skillId = positional[0];
-  if (!skillId) {
-    console.error("Usage: volute skill publish <name> [--mind <name>]");
-    process.exit(1);
-  }
-  const client = getClient();
-  const url = urlOf(client.api.minds[":name"].skills.publish.$url({ param: { name: mindName } }));
-  const res = await daemonFetch(url, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ skillId })
-  });
-  if (!res.ok) {
-    const body = await res.json().catch(() => ({ error: "Unknown error" }));
-    console.error(`Error: ${body.error}`);
-    process.exit(1);
-  }
-  const skill = await res.json();
-  console.log(`Published skill "${skillId}" (v${skill.version}).`);
-}
-async function removeSkill(args) {
-  const { positional } = parseArgs(args, {});
-  const id = positional[0];
-  if (!id) {
-    console.error("Usage: volute skill remove <name>");
-    process.exit(1);
-  }
-  const client = getClient();
-  const url = urlOf(client.api.skills[":id"].$url({ param: { id } }));
-  const res = await daemonFetch(url, { method: "DELETE" });
-  if (!res.ok) {
-    const body = await res.json().catch(() => ({ error: "Unknown error" }));
-    console.error(`Error: ${body.error}`);
-    process.exit(1);
-  }
-  console.log(`Removed shared skill "${id}".`);
-}
-async function manageDefaults(args) {
-  const action = args[0];
-  if (!action || action === "list") {
-    const res = await daemonFetch("/api/skills/defaults/list");
-    if (!res.ok) {
-      const body = await res.json().catch(() => ({ error: "Unknown error" }));
-      console.error(`Error: ${body.error}`);
-      process.exit(1);
-    }
-    const { skills } = await res.json();
-    console.log("Default skills for new minds:\n");
-    for (const s of skills) {
-      console.log(`  ${s}`);
-    }
-    return;
-  }
-  if (action === "add") {
-    const skillId = args[1];
-    if (!skillId) {
-      console.error("Usage: volute skill defaults add <name>");
-      process.exit(1);
-    }
-    const res = await daemonFetch("/api/skills/defaults/list", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ skill: skillId })
-    });
-    if (!res.ok) {
-      const body = await res.json().catch(() => ({ error: "Unknown error" }));
-      console.error(`Error: ${body.error}`);
-      process.exit(1);
-    }
-    console.log(`Added "${skillId}" to default skills.`);
-    return;
-  }
-  if (action === "remove") {
-    const skillId = args[1];
-    if (!skillId) {
-      console.error("Usage: volute skill defaults remove <name>");
-      process.exit(1);
-    }
-    const res = await daemonFetch(`/api/skills/defaults/list/${encodeURIComponent(skillId)}`, {
-      method: "DELETE"
-    });
-    if (!res.ok) {
-      const body = await res.json().catch(() => ({ error: "Unknown error" }));
-      console.error(`Error: ${body.error}`);
-      process.exit(1);
-    }
-    console.log(`Removed "${skillId}" from default skills.`);
-    return;
-  }
-  console.error(`Unknown defaults action: ${action}`);
-  console.log("Usage: volute skill defaults [add|remove] [<name>]");
-  process.exit(1);
-}
-async function uninstallSkill(args) {
-  const { positional, flags } = parseArgs(args, { mind: { type: "string" } });
-  const mindName = resolveMindName(flags);
-  const skillId = positional[0];
-  if (!skillId) {
-    console.error("Usage: volute skill uninstall <name> [--mind <name>]");
-    process.exit(1);
-  }
-  const client = getClient();
-  const url = urlOf(
-    client.api.minds[":name"].skills[":skill"].$url({
-      param: { name: mindName, skill: skillId }
-    })
-  );
-  const res = await daemonFetch(url, { method: "DELETE" });
-  if (!res.ok) {
-    const body = await res.json().catch(() => ({ error: "Unknown error" }));
-    console.error(`Error: ${body.error}`);
-    process.exit(1);
-  }
-  console.log(`Uninstalled skill "${skillId}" from ${mindName}.`);
-}
-export {
-  run
-};

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

@@ -1,44 +0,0 @@
----
-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

@@ -1,72 +0,0 @@
-#!/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

@@ -1,52 +0,0 @@
-#!/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/sleep-manager-JTXSN7NV.js

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-import {
-  SleepManager,
-  getSleepManager,
-  getSleepManagerIfReady,
-  initSleepManager,
-  matchesGlob
-} from "./chunk-3Z2DPESO.js";
-import "./chunk-SKLSMHXO.js";
-import "./chunk-LOEJ4HPQ.js";
-import "./chunk-RVGLDGMI.js";
-import "./chunk-GY5HBI7A.js";
-import "./chunk-7J3HEVR7.js";
-import "./chunk-G53F3JA4.js";
-import "./chunk-OYAKCAVY.js";
-import "./chunk-2NGTS5UU.js";
-import "./chunk-A2A4KLFE.js";
-import "./chunk-PB65JZK2.js";
-import "./chunk-JYVGHWEJ.js";
-import "./chunk-KVK2DLWI.js";
-import "./chunk-C7I35G4R.js";
-import "./chunk-QTUVYI7W.js";
-import "./chunk-YUIHSKR6.js";
-import "./chunk-KIEPMIM5.js";
-import "./chunk-VH33ZWMW.js";
-import "./chunk-N432I7QH.js";
-import "./chunk-LRCG2JLP.js";
-import "./chunk-RPZZSXV3.js";
-import "./chunk-K3NQKI34.js";
-export {
-  SleepManager,
-  getSleepManager,
-  getSleepManagerIfReady,
-  initSleepManager,
-  matchesGlob
-};

package/dist/spirit-VRONKFMF.js

@@ -1,23 +0,0 @@
-#!/usr/bin/env node
-import {
-  ensureSpiritProject,
-  getSpiritModel,
-  spiritDir,
-  syncSpiritTemplate
-} from "./chunk-7J3HEVR7.js";
-import "./chunk-G53F3JA4.js";
-import "./chunk-C7I35G4R.js";
-import "./chunk-QTUVYI7W.js";
-import "./chunk-YUIHSKR6.js";
-import "./chunk-KIEPMIM5.js";
-import "./chunk-VH33ZWMW.js";
-import "./chunk-N432I7QH.js";
-import "./chunk-LRCG2JLP.js";
-import "./chunk-RPZZSXV3.js";
-import "./chunk-K3NQKI34.js";
-export {
-  ensureSpiritProject,
-  getSpiritModel,
-  spiritDir,
-  syncSpiritTemplate
-};

package/dist/split-STOROBYJ.js

@@ -1,63 +0,0 @@
-#!/usr/bin/env node
-import {
-  resolveMindName
-} from "./chunk-NAOW2CLO.js";
-import {
-  parseArgs
-} from "./chunk-D424ZQGI.js";
-import "./chunk-K3NQKI34.js";
-
-// src/commands/split.ts
-async function run(args) {
-  const { positional, flags } = parseArgs(args, {
-    from: { type: "string" },
-    soul: { type: "string" },
-    port: { type: "number" },
-    "no-start": { type: "boolean" },
-    json: { type: "boolean" }
-  });
-  const mindName = resolveMindName({ mind: flags.from });
-  const variantName = positional[0];
-  const { soul, port, json } = flags;
-  const noStart = flags["no-start"];
-  if (!variantName) {
-    console.error(
-      'Usage: volute mind split <name> [--from <mind>] [--soul "..."] [--port N] [--no-start] [--json]'
-    );
-    process.exit(1);
-  }
-  if (!json) console.log("Creating variant via daemon...");
-  const { daemonFetch } = await import("./daemon-client-6QXHZ7US.js");
-  const { getClient, urlOf } = await import("./api-client-YPKOZP2O.js");
-  const client = getClient();
-  const res = await daemonFetch(
-    urlOf(client.api.minds[":name"].variants.$url({ param: { name: mindName } })),
-    {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        name: variantName,
-        ...soul && { soul },
-        ...port && { port },
-        ...noStart && { noStart }
-      })
-    }
-  );
-  const data = await res.json();
-  if (!res.ok) {
-    console.error(data.error ?? "Failed to create variant");
-    process.exit(1);
-  }
-  if (json) {
-    console.log(JSON.stringify(data.variant, null, 2));
-  } else {
-    console.log(`
-Variant created: ${variantName}`);
-    console.log(`  Branch: ${data.variant?.branch}`);
-    console.log(`  Path:   ${data.variant?.path}`);
-    console.log(`  Port:   ${data.variant?.port}`);
-  }
-}
-export {
-  run
-};

package/dist/start-K2NCUUCG.js

@@ -1,33 +0,0 @@
-#!/usr/bin/env node
-import {
-  getClient,
-  urlOf
-} from "./chunk-4RQBJWQX.js";
-import {
-  daemonFetch
-} from "./chunk-UKVWJRKN.js";
-import "./chunk-LRCG2JLP.js";
-import "./chunk-RPZZSXV3.js";
-import "./chunk-K3NQKI34.js";
-
-// src/commands/start.ts
-async function run(args) {
-  const name = args[0];
-  if (!name) {
-    console.error("Usage: volute mind start <name>");
-    process.exit(1);
-  }
-  const client = getClient();
-  const res = await daemonFetch(urlOf(client.api.minds[":name"].start.$url({ param: { name } })), {
-    method: "POST"
-  });
-  const data = await res.json();
-  if (!res.ok) {
-    console.error(data.error || "Failed to start mind");
-    process.exit(1);
-  }
-  console.log(`${name} started on port ${data.port}`);
-}
-export {
-  run
-};