volute 0.30.1 → 0.32.0

package/packages/extensions/notes/skills/notes/scripts/notes.mjs

@@ -1,185 +0,0 @@
-#!/usr/bin/env node
-/**
- * notes.mjs — manage notes via the daemon API
- *
- * Usage:
- *   node .claude/skills/notes/scripts/notes.mjs write "title" "content" [--reply-to author/slug]
- *   node .claude/skills/notes/scripts/notes.mjs list [--author name] [--limit N]
- *   node .claude/skills/notes/scripts/notes.mjs read <author/slug>
- *   node .claude/skills/notes/scripts/notes.mjs comment <author/slug> "content"
- *   node .claude/skills/notes/scripts/notes.mjs react <author/slug> "emoji"
- *   node .claude/skills/notes/scripts/notes.mjs delete <author/slug>
- */
-
-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);
-}
-
-const baseUrl = `http://localhost:${port}/api/ext/notes`;
-const headers = {
-  "Content-Type": "application/json",
-  Authorization: `Bearer ${token}`,
-};
-
-async function apiFetch(path, opts = {}) {
-  const url = `${baseUrl}${path}`;
-  try {
-    return await fetch(url, { headers, ...opts });
-  } catch {
-    console.error(`Failed to reach daemon at localhost:${port}`);
-    process.exit(1);
-  }
-}
-
-function getFlag(args, flag) {
-  const idx = args.indexOf(flag);
-  if (idx !== -1 && args[idx + 1]) return args[idx + 1];
-  return undefined;
-}
-
-const [command, ...args] = process.argv.slice(2);
-
-switch (command) {
-  case "write": {
-    const title = args[0];
-    const content = args[1];
-    if (!title || !content) {
-      console.error(
-        'Usage: node .claude/skills/notes/scripts/notes.mjs write "title" "content" [--reply-to author/slug]',
-      );
-      process.exit(1);
-    }
-    const replyTo = getFlag(args, "--reply-to");
-    const body = { title, content };
-    if (replyTo) body.reply_to = replyTo;
-
-    const res = await apiFetch("", { method: "POST", body: JSON.stringify(body) });
-    const data = await res.json();
-    if (!res.ok) {
-      console.error(`Error: ${data.error ?? res.statusText}`);
-      process.exit(1);
-    }
-    console.log(`Published: ${data.author_username}/${data.slug}`);
-    break;
-  }
-
-  case "list": {
-    const author = getFlag(args, "--author");
-    const limit = getFlag(args, "--limit") ?? "10";
-    const params = new URLSearchParams({ limit });
-    if (author) params.set("author", author);
-
-    const res = await apiFetch(`?${params}`);
-    const notes = await res.json();
-    if (!res.ok) {
-      console.error(`Error: ${notes.error ?? res.statusText}`);
-      process.exit(1);
-    }
-    for (const note of notes) {
-      const date = new Date(note.created_at).toLocaleDateString();
-      console.log(`  ${note.author_username}/${note.slug}  "${note.title}"  (${date})`);
-    }
-    if (notes.length === 0) console.log("No notes found.");
-    break;
-  }
-
-  case "read": {
-    const ref = args[0];
-    if (!ref || !ref.includes("/")) {
-      console.error("Usage: node .claude/skills/notes/scripts/notes.mjs read <author/slug>");
-      process.exit(1);
-    }
-    const res = await apiFetch(`/${ref}`);
-    const data = await res.json();
-    if (!res.ok) {
-      console.error(`Error: ${data.error ?? res.statusText}`);
-      process.exit(1);
-    }
-    console.log(`# ${data.title}\n`);
-    console.log(`By ${data.author_username} — ${new Date(data.created_at).toLocaleString()}\n`);
-    console.log(data.content);
-    if (data.reactions?.length) {
-      console.log(
-        `\nReactions: ${data.reactions.map((r) => `${r.emoji} (${r.count})`).join("  ")}`,
-      );
-    }
-    if (data.comments?.length) {
-      console.log(`\nComments (${data.comments.length}):`);
-      for (const c of data.comments) {
-        console.log(`  ${c.author_username}: ${c.content}`);
-      }
-    }
-    break;
-  }
-
-  case "comment": {
-    const ref = args[0];
-    const content = args[1];
-    if (!ref || !ref.includes("/") || !content) {
-      console.error(
-        'Usage: node .claude/skills/notes/scripts/notes.mjs comment <author/slug> "content"',
-      );
-      process.exit(1);
-    }
-    const res = await apiFetch(`/${ref}/comments`, {
-      method: "POST",
-      body: JSON.stringify({ content }),
-    });
-    const data = await res.json();
-    if (!res.ok) {
-      console.error(`Error: ${data.error ?? res.statusText}`);
-      process.exit(1);
-    }
-    console.log("Comment added.");
-    break;
-  }
-
-  case "react": {
-    const ref = args[0];
-    const emoji = args[1];
-    if (!ref || !ref.includes("/") || !emoji) {
-      console.error(
-        'Usage: node .claude/skills/notes/scripts/notes.mjs react <author/slug> "emoji"',
-      );
-      process.exit(1);
-    }
-    const res = await apiFetch(`/${ref}/reactions`, {
-      method: "POST",
-      body: JSON.stringify({ emoji }),
-    });
-    const data = await res.json();
-    if (!res.ok) {
-      console.error(`Error: ${data.error ?? res.statusText}`);
-      process.exit(1);
-    }
-    console.log(data.added ? "Reaction added." : "Reaction removed.");
-    break;
-  }
-
-  case "delete": {
-    const ref = args[0];
-    if (!ref || !ref.includes("/")) {
-      console.error("Usage: node .claude/skills/notes/scripts/notes.mjs delete <author/slug>");
-      process.exit(1);
-    }
-    const res = await apiFetch(`/${ref}`, { method: "DELETE" });
-    if (!res.ok) {
-      const data = await res.json();
-      console.error(`Error: ${data.error ?? res.statusText}`);
-      process.exit(1);
-    }
-    console.log("Note deleted.");
-    break;
-  }
-
-  default:
-    console.error(
-      "Usage: node .claude/skills/notes/scripts/notes.mjs <write|list|read|comment|react|delete> [args]",
-    );
-    process.exit(1);
-}

package/templates/_base/.init/.config/hooks/startup-context.sh

@@ -1,46 +0,0 @@
-#!/bin/bash
-# Startup context hook — generates orientation context for new sessions.
-# Edit this script to customize what you see when your session starts.
-# Input: JSON on stdin with { "source": "startup" | "SessionStart" }
-# Output: JSON with hookSpecificOutput.additionalContext (for SessionStart hook)
-#         or plain text (for direct execution by pi template)
-
-INPUT=$(cat)
-SOURCE=$(echo "$INPUT" | jq -r '.source // "startup"')
-
-CONTEXT="Session ${SOURCE} at $(date '+%Y-%m-%d %H:%M')."
-
-# Active sessions
-SESSIONS_DIR=".mind/sessions"
-if [ -d "$SESSIONS_DIR" ]; then
-  SESSION_LIST=$(ls -1 "$SESSIONS_DIR"/*.json 2>/dev/null | xargs -I{} basename {} .json | sort)
-  if [ -n "$SESSION_LIST" ]; then
-    CONTEXT="$CONTEXT Active sessions: $(echo "$SESSION_LIST" | tr '\n' ', ' | sed 's/, $//')."
-  fi
-fi
-
-# Last journal entry
-JOURNAL_DIR="home/memory/journal"
-if [ -d "$JOURNAL_DIR" ]; then
-  LATEST=$(ls -1 "$JOURNAL_DIR"/*.md 2>/dev/null | sort | tail -1)
-  if [ -n "$LATEST" ]; then
-    CONTEXT="$CONTEXT Last journal entry: $(basename "$LATEST" .md)."
-  fi
-fi
-
-# Pending channel invites
-INBOX_DIR="home/inbox"
-if [ -d "$INBOX_DIR" ]; then
-  INVITE_COUNT=$(ls -1 "$INBOX_DIR"/*.md 2>/dev/null | wc -l | tr -d ' ')
-  if [ "$INVITE_COUNT" -gt 0 ] 2>/dev/null; then
-    CONTEXT="$CONTEXT Pending channel invites: ${INVITE_COUNT} (check inbox/)."
-  fi
-fi
-
-# Output in SessionStart hook format
-jq -n --arg ctx "$CONTEXT" '{
-  hookSpecificOutput: {
-    hookEventName: "SessionStart",
-    additionalContext: $ctx
-  }
-}'

package/templates/_base/.init/.config/scripts/session-reader.ts

@@ -1,59 +0,0 @@
-#!/usr/bin/env npx tsx
-/**
- * Session reader — displays a human-readable log of another session's activity.
- *
- * Usage: npx tsx .config/scripts/session-reader.ts <session-name> [--lines N]
- *
- * Runs from the mind's home/ directory.
- */
-import { existsSync } from "node:fs";
-import { resolve } from "node:path";
-import {
-  readSessionLog,
-  resolveAgentSdkJsonl,
-  resolvePiJsonl,
-} from "../../src/lib/session-monitor.js";
-
-const args = process.argv.slice(2);
-let sessionName: string | undefined;
-let lines = 50;
-
-for (let i = 0; i < args.length; i++) {
-  if (args[i] === "--lines" && args[i + 1]) {
-    lines = parseInt(args[++i], 10);
-  } else if (!sessionName && !args[i].startsWith("-")) {
-    sessionName = args[i];
-  }
-}
-
-if (!sessionName) {
-  console.error("Usage: npx tsx .config/scripts/session-reader.ts <session-name> [--lines N]");
-  process.exit(1);
-}
-
-// Detect template type and resolve JSONL path
-const cwd = process.cwd();
-const agentSdkSessions = resolve(cwd, "../.mind/sessions");
-const piSessions = resolve(cwd, "../.mind/pi-sessions");
-
-let jsonlPath: string | null = null;
-let format: "agent-sdk" | "pi";
-
-if (existsSync(agentSdkSessions)) {
-  format = "agent-sdk";
-  jsonlPath = resolveAgentSdkJsonl(agentSdkSessions, sessionName, cwd);
-} else if (existsSync(piSessions)) {
-  format = "pi";
-  jsonlPath = resolvePiJsonl(piSessions, sessionName);
-} else {
-  console.error("No session directory found. Expected .mind/sessions/ or .mind/pi-sessions/");
-  process.exit(1);
-}
-
-if (!jsonlPath || !existsSync(jsonlPath)) {
-  console.error(`No session log found for "${sessionName}".`);
-  process.exit(1);
-}
-
-const output = readSessionLog({ jsonlPath, format, lines });
-console.log(output);

package/templates/_base/src/lib/session-monitor.ts

@@ -1,400 +0,0 @@
-import {
-  closeSync,
-  existsSync,
-  mkdirSync,
-  openSync,
-  readdirSync,
-  readFileSync,
-  readSync,
-  statSync,
-  writeFileSync,
-} from "node:fs";
-import { dirname, resolve } from "node:path";
-
-// --- Types ---
-
-type CursorState = Record<string, Record<string, { offset: number }>>;
-
-type ParsedEntry = {
-  role: "user" | "assistant";
-  timestamp?: string;
-  text?: string;
-  toolUses?: { name: string; primaryArg?: string }[];
-};
-
-type SessionSummary = {
-  firstUserText: string;
-  toolCounts: { edits: number; reads: number; commands: number; other: number };
-  messageCount: number;
-  timeSpan: { first?: string; last?: string };
-  lastAssistantText?: string;
-};
-
-type Format = "agent-sdk" | "pi";
-
-// --- Public API ---
-
-export function getSessionUpdates(options: {
-  currentSession: string;
-  sessionsDir: string;
-  cursorFile: string;
-  jsonlResolver: (sessionName: string) => string | null;
-  format: Format;
-}): string | null {
-  const sessionNames = listSessionNames(options.sessionsDir, options.format);
-  const others = sessionNames.filter((n) => n !== options.currentSession && !n.startsWith("new-"));
-  if (others.length === 0) return null;
-
-  const cursors = loadCursors(options.cursorFile);
-  const currentCursors = cursors[options.currentSession] ?? {};
-  const summaries: string[] = [];
-
-  for (const name of others) {
-    try {
-      const jsonlPath = options.jsonlResolver(name);
-      if (!jsonlPath || !existsSync(jsonlPath)) continue;
-
-      const stat = statSync(jsonlPath);
-      const prevOffset = currentCursors[name]?.offset ?? 0;
-      const fileSize = stat.size;
-
-      // Reset if offset past EOF (file was truncated/recreated)
-      const offset = prevOffset > fileSize ? 0 : prevOffset;
-      if (offset >= fileSize) {
-        currentCursors[name] = { offset: fileSize };
-        continue;
-      }
-
-      const newBytes = readBytesFrom(jsonlPath, offset, fileSize - offset);
-      const lines = newBytes.split("\n").filter((l) => l.trim());
-      const entries = parseJsonlEntries(lines, options.format);
-      const summary = summarizeEntries(entries);
-
-      currentCursors[name] = { offset: fileSize };
-
-      if (!summary) continue;
-
-      const ago = summary.timeSpan.last ? formatTimeAgo(summary.timeSpan.last) : "recently";
-      const parts = [`- ${name} (${ago}, ${summary.messageCount} messages)`];
-
-      if (summary.firstUserText) {
-        parts[0] += `: "${truncate(summary.firstUserText, 100)}"`;
-      }
-
-      const actions: string[] = [];
-      if (summary.toolCounts.edits > 0) actions.push(`edited ${summary.toolCounts.edits} files`);
-      if (summary.toolCounts.commands > 0)
-        actions.push(`ran ${summary.toolCounts.commands} commands`);
-      if (summary.toolCounts.reads > 0) actions.push(`read ${summary.toolCounts.reads} files`);
-      if (summary.toolCounts.other > 0) actions.push(`${summary.toolCounts.other} other tool uses`);
-      if (actions.length > 0) {
-        parts[0] += ` -> ${actions.join(", ")}`;
-      }
-
-      summaries.push(parts[0]);
-    } catch {}
-  }
-
-  cursors[options.currentSession] = currentCursors;
-  try {
-    saveCursors(options.cursorFile, cursors);
-  } catch {
-    // Non-fatal: worst case is duplicate summaries on next check
-  }
-
-  if (summaries.length === 0) return null;
-
-  // Cap total output at ~500 chars
-  let output = "[Session Activity]\n" + summaries.join("\n");
-  if (output.length > 500) {
-    output = output.slice(0, 497) + "...";
-  }
-  return output;
-}
-
-export function readSessionLog(options: {
-  jsonlPath: string;
-  format: Format;
-  lines?: number;
-}): string {
-  const maxLines = options.lines ?? 50;
-  if (!existsSync(options.jsonlPath)) return "No session log found.";
-
-  const content = readFileSync(options.jsonlPath, "utf-8");
-  const allLines = content.split("\n").filter((l) => l.trim());
-  const lines = allLines.slice(-maxLines);
-  const entries = parseJsonlEntries(lines, options.format);
-
-  const output: string[] = [];
-  for (const entry of entries) {
-    const ts = entry.timestamp ? `[${formatTimestamp(entry.timestamp)}]` : "";
-    if (entry.role === "user" && entry.text) {
-      output.push(`${ts} User: ${entry.text}`);
-    } else if (entry.role === "assistant") {
-      if (entry.text) {
-        output.push(`${ts} Assistant: ${entry.text}`);
-      }
-      if (entry.toolUses) {
-        for (const tool of entry.toolUses) {
-          const arg = tool.primaryArg ? ` ${tool.primaryArg}` : "";
-          output.push(`${ts} [${tool.name}${arg}]`);
-        }
-      }
-    }
-  }
-
-  return output.length > 0 ? output.join("\n") : "No activity found.";
-}
-
-// --- JSONL Path Resolvers ---
-
-export function resolveAgentSdkJsonl(
-  sessionsDir: string,
-  sessionName: string,
-  cwd: string,
-): string | null {
-  const sessionFile = resolve(sessionsDir, `${sessionName}.json`);
-  if (!existsSync(sessionFile)) return null;
-
-  try {
-    const data = JSON.parse(readFileSync(sessionFile, "utf-8"));
-    const sessionId = data.sessionId;
-    if (!sessionId) return null;
-
-    const encoded = encodeCwd(cwd);
-    const home = process.env.HOME || process.env.USERPROFILE || "";
-    return resolve(home, ".claude", "projects", encoded, `${sessionId}.jsonl`);
-  } catch {
-    return null;
-  }
-}
-
-export function encodeCwd(cwd: string): string {
-  return cwd.replace(/\//g, "-").replace(/\./g, "-");
-}
-
-export function resolvePiJsonl(sessionsDir: string, sessionName: string): string | null {
-  const sessionDir = resolve(sessionsDir, sessionName);
-  if (!existsSync(sessionDir)) return null;
-
-  try {
-    const files = readdirSync(sessionDir)
-      .filter((f) => f.endsWith(".jsonl"))
-      .map((f) => ({
-        name: f,
-        mtime: statSync(resolve(sessionDir, f)).mtimeMs,
-      }))
-      .sort((a, b) => b.mtime - a.mtime);
-
-    if (files.length === 0) return null;
-    return resolve(sessionDir, files[0].name);
-  } catch {
-    return null;
-  }
-}
-
-// --- Parsing ---
-
-export function parseJsonlEntries(lines: string[], format: Format): ParsedEntry[] {
-  const entries: ParsedEntry[] = [];
-
-  for (const line of lines) {
-    let parsed: any;
-    try {
-      parsed = JSON.parse(line);
-    } catch {
-      continue;
-    }
-
-    if (format === "agent-sdk") {
-      if (parsed.type === "user" && parsed.message?.role === "user") {
-        const text = extractTextFromContent(parsed.message.content);
-        if (text) entries.push({ role: "user", timestamp: parsed.timestamp, text });
-      } else if (parsed.type === "assistant" && parsed.message?.role === "assistant") {
-        const text = extractTextFromContent(parsed.message.content);
-        const toolUses = extractToolUses(parsed.message.content, format);
-        if (text || toolUses.length > 0) {
-          entries.push({
-            role: "assistant",
-            timestamp: parsed.timestamp,
-            text: text || undefined,
-            toolUses,
-          });
-        }
-      }
-    } else {
-      // pi format
-      if (parsed.type === "message" && parsed.message?.role === "user") {
-        const text = extractTextFromContent(parsed.message.content);
-        if (text) entries.push({ role: "user", timestamp: parsed.timestamp, text });
-      } else if (parsed.type === "message" && parsed.message?.role === "assistant") {
-        const text = extractTextFromContent(parsed.message.content);
-        const toolUses = extractToolUses(parsed.message.content, format);
-        if (text || toolUses.length > 0) {
-          entries.push({
-            role: "assistant",
-            timestamp: parsed.timestamp,
-            text: text || undefined,
-            toolUses,
-          });
-        }
-      }
-    }
-  }
-
-  return entries;
-}
-
-export function summarizeEntries(entries: ParsedEntry[]): SessionSummary | null {
-  if (entries.length === 0) return null;
-
-  let firstUserText = "";
-  let lastAssistantText: string | undefined;
-  const toolCounts = { edits: 0, reads: 0, commands: 0, other: 0 };
-  let messageCount = 0;
-  const timestamps: string[] = [];
-
-  for (const entry of entries) {
-    messageCount++;
-    if (entry.timestamp) timestamps.push(entry.timestamp);
-
-    if (entry.role === "user" && entry.text && !firstUserText) {
-      firstUserText = entry.text;
-    }
-
-    if (entry.role === "assistant") {
-      if (entry.text) lastAssistantText = entry.text;
-      if (entry.toolUses) {
-        for (const tool of entry.toolUses) {
-          const cat = categorizeTool(tool.name);
-          toolCounts[cat]++;
-        }
-      }
-    }
-  }
-
-  return {
-    firstUserText,
-    toolCounts,
-    messageCount,
-    timeSpan: {
-      first: timestamps[0],
-      last: timestamps[timestamps.length - 1],
-    },
-    lastAssistantText,
-  };
-}
-
-// --- Helpers ---
-
-function extractTextFromContent(content: any[]): string | null {
-  if (!Array.isArray(content)) return null;
-  const texts: string[] = [];
-  for (const part of content) {
-    if (part.type === "text" && part.text) {
-      texts.push(part.text);
-    }
-  }
-  return texts.length > 0 ? texts.join("\n") : null;
-}
-
-function extractToolUses(content: any[], format: Format): { name: string; primaryArg?: string }[] {
-  if (!Array.isArray(content)) return [];
-  const tools: { name: string; primaryArg?: string }[] = [];
-
-  for (const part of content) {
-    const isToolUse = format === "agent-sdk" ? part.type === "tool_use" : part.type === "toolCall";
-
-    if (isToolUse) {
-      const name = part.name || "unknown";
-      const input = format === "agent-sdk" ? part.input : part.arguments;
-      const primaryArg = extractPrimaryArg(name, input);
-      tools.push({ name, primaryArg });
-    }
-  }
-
-  return tools;
-}
-
-function extractPrimaryArg(_name: string, input: any): string | undefined {
-  if (!input || typeof input !== "object") return undefined;
-  // Common patterns for primary argument
-  return (
-    input.file_path || input.path || input.command || input.pattern || input.query || input.url
-  );
-}
-
-function categorizeTool(name: string): "edits" | "reads" | "commands" | "other" {
-  const lowerName = name.toLowerCase();
-  if (["edit", "write", "notebookedit"].includes(lowerName)) return "edits";
-  if (["read", "glob", "grep", "ls"].includes(lowerName)) return "reads";
-  if (["bash", "exec", "execute_shell_command"].includes(lowerName)) return "commands";
-  return "other";
-}
-
-function listSessionNames(sessionsDir: string, format: Format): string[] {
-  if (!existsSync(sessionsDir)) return [];
-  try {
-    const entries = readdirSync(sessionsDir);
-    if (format === "agent-sdk") {
-      return entries.filter((e) => e.endsWith(".json")).map((e) => e.replace(/\.json$/, ""));
-    }
-    // pi: subdirectories
-    return entries.filter((e) => {
-      try {
-        return statSync(resolve(sessionsDir, e)).isDirectory();
-      } catch {
-        return false;
-      }
-    });
-  } catch {
-    return [];
-  }
-}
-
-function loadCursors(cursorFile: string): CursorState {
-  try {
-    return JSON.parse(readFileSync(cursorFile, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-
-function saveCursors(cursorFile: string, cursors: CursorState): void {
-  mkdirSync(dirname(cursorFile), { recursive: true });
-  writeFileSync(cursorFile, JSON.stringify(cursors, null, 2));
-}
-
-function readBytesFrom(filePath: string, offset: number, length: number): string {
-  const buf = Buffer.alloc(length);
-  const fd = openSync(filePath, "r");
-  try {
-    readSync(fd, buf, 0, length, offset);
-  } finally {
-    closeSync(fd);
-  }
-  return buf.toString("utf-8");
-}
-
-function truncate(s: string, max: number): string {
-  if (s.length <= max) return s;
-  return s.slice(0, max - 3) + "...";
-}
-
-function formatTimeAgo(timestamp: string): string {
-  const diff = Date.now() - new Date(timestamp).getTime();
-  if (isNaN(diff) || diff < 0) return "just now";
-  const minutes = Math.floor(diff / 60000);
-  if (minutes < 1) return "just now";
-  if (minutes < 60) return `${minutes}m ago`;
-  const hours = Math.floor(minutes / 60);
-  if (hours < 24) return `${hours}h ago`;
-  const days = Math.floor(hours / 24);
-  return `${days}d ago`;
-}
-
-function formatTimestamp(timestamp: string): string {
-  const d = new Date(timestamp);
-  if (isNaN(d.getTime())) return timestamp;
-  return d.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit", hour12: false });
-}