@settinghead/voxlert 0.3.10 → 0.3.11

package/README.md

@@ -8,6 +8,9 @@
   <a href="https://github.com/settinghead/voxlert/actions/workflows/cli-integration.yml">
     <img src="https://github.com/settinghead/voxlert/actions/workflows/cli-integration.yml/badge.svg" alt="CLI Integration" />
   </a>
+  <a href="https://fazier.com/launches/voxlert">
+    <img src="https://fazier.com/api/v1//public/badges/launch_badges.svg?badge_type=launched&theme=light" alt="Launched on Fazier" />
+  </a>
 </p>
 
 # Voxlert
@@ -113,12 +116,6 @@ Run tests locally with:
 npm test
 ```
 
-For release-impacting changes, add a changeset before opening a PR:
-
-```bash
-npm run changeset
-```
-
 ## Supported Voices
 
 The `sc1-adjutant` preview below uses the animated in-game portrait GIF from `assets/sc1-adjutant.gif`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@settinghead/voxlert",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "LLM-generated voice notifications for Claude Code, Cursor, OpenAI Codex, pi, and OpenClaw, spoken by game characters like the StarCraft Adjutant, Kerrigan, C&C EVA, SHODAN, and more.",
   "repository": {
     "type": "git",
@@ -28,9 +28,6 @@
   "scripts": {
     "start": "node src/voxlert.js",
     "postinstall": "node src/postinstall.js",
-    "changeset": "changeset",
-    "version": "changeset version",
-    "release": "changeset publish",
     "test": "node --test ./test/*.test.js"
   },
   "publishConfig": {
@@ -43,9 +40,5 @@
     "@inquirer/input": "^4.1.0",
     "@inquirer/select": "^5.1.0",
     "node-notifier": "^10.0.1"
-  },
-  "devDependencies": {
-    "@changesets/changelog-github": "^0.6.0",
-    "@changesets/cli": "^2.30.0"
   }
 }

package/pi-package/extensions/voxlert.ts

@@ -95,15 +95,80 @@ export default function (pi: ExtensionAPI) {
   let available = isVoxlertAvailable();
 
   // ------------------------------------------------------------------
-  // Session start: verify Voxlert is installed, fire SessionStart
+  // Guided setup: install CLI + run setup --yes
+  // ------------------------------------------------------------------
+  async function runGuidedSetup(ctx: any): Promise<boolean> {
+    // Step 1: Install the CLI
+    ctx.ui.notify("Installing @settinghead/voxlert...", "info");
+    const install = await pi.exec("npm", ["install", "-g", "@settinghead/voxlert"], {
+      timeout: 120_000,
+    });
+    if (install.code !== 0) {
+      ctx.ui.notify(
+        `Install failed (exit ${install.code}):\n${install.stderr.slice(0, 300)}`,
+        "error",
+      );
+      return false;
+    }
+
+    // Step 2: Run non-interactive setup (downloads voice packs, detects TTS)
+    ctx.ui.notify("Running voxlert setup (downloading voice packs, detecting TTS)...", "info");
+    const setup = await pi.exec("voxlert", ["setup", "--yes"], { timeout: 120_000 });
+    if (setup.code !== 0) {
+      ctx.ui.notify(
+        `Setup failed (exit ${setup.code}):\n${setup.stderr.slice(0, 300)}`,
+        "error",
+      );
+      return false;
+    }
+
+    // Verify it worked
+    available = isVoxlertAvailable();
+    if (available) {
+      ctx.ui.notify(
+        "Voxlert installed and configured!\n\n" +
+          "Voice notifications will now play when the agent finishes a task.\n" +
+          "Run /voxlert test to hear it, or 'voxlert setup' in a terminal for full interactive config.",
+        "info",
+      );
+      ctx.ui.setStatus("voxlert", "🔊 Voxlert");
+      return true;
+    } else {
+      ctx.ui.notify("Install succeeded but voxlert binary not found in PATH.", "error");
+      return false;
+    }
+  }
+
+  // ------------------------------------------------------------------
+  // Session start: verify Voxlert is installed, offer setup if not
   // ------------------------------------------------------------------
   pi.on("session_start", async (_event, ctx) => {
     available = isVoxlertAvailable();
     if (!available) {
-      ctx.ui.notify(
-        "Voxlert not found. Install with: npm install -g @settinghead/voxlert && voxlert setup",
-        "warning",
+      if (!ctx.hasUI) {
+        // Non-interactive mode (print mode, JSON mode) — just warn
+        return;
+      }
+
+      const install = await ctx.ui.confirm(
+        "Voxlert Setup",
+        "Voxlert CLI not found. Install it now?\n\n" +
+          "This will:\n" +
+          "  • npm install -g @settinghead/voxlert\n" +
+          "  • Download default voice packs (SHODAN, Adjutant, etc.)\n" +
+          "  • Auto-detect your TTS backend\n\n" +
+          "You can run full interactive setup later with: voxlert setup",
       );
+
+      if (install) {
+        await runGuidedSetup(ctx);
+      } else {
+        ctx.ui.notify(
+          "Skipped. Run /voxlert setup anytime, or manually:\n" +
+            "  npm install -g @settinghead/voxlert && voxlert setup",
+          "info",
+        );
+      }
     } else {
       ctx.ui.setStatus("voxlert", "🔊 Voxlert");
     }
@@ -168,9 +233,21 @@ export default function (pi: ExtensionAPI) {
     handler: async (args, ctx) => {
       const sub = (args || "").trim().split(/\s+/)[0];
 
+      if (sub === "setup") {
+        if (available) {
+          const redo = await ctx.ui.confirm(
+            "Voxlert Setup",
+            "Voxlert is already installed. Re-run setup with defaults?",
+          );
+          if (!redo) return;
+        }
+        await runGuidedSetup(ctx);
+        return;
+      }
+
       if (sub === "test") {
         if (!available) {
-          ctx.ui.notify("Voxlert CLI not installed.", "error");
+          ctx.ui.notify("Voxlert CLI not installed. Run /voxlert setup first.", "error");
           return;
         }
         fireVoxlert("Stop", ctx.cwd);
@@ -182,7 +259,7 @@ export default function (pi: ExtensionAPI) {
         ctx.ui.notify(
           available
             ? "Voxlert is active. Voice notifications will play on agent_end, tool errors, compaction, and session end."
-            : "Voxlert CLI not found. Run: npm install -g @settinghead/voxlert && voxlert setup",
+            : "Voxlert CLI not found. Run /voxlert setup to install.",
           available ? "info" : "warning",
         );
         return;
@@ -190,10 +267,11 @@ export default function (pi: ExtensionAPI) {
 
       // Default: show help
       ctx.ui.notify(
-        "Usage: /voxlert [test|status]\n" +
+        "Usage: /voxlert [setup|test|status]\n" +
+          "  setup  — install Voxlert CLI and configure with defaults\n" +
           "  test   — fire a test voice notification\n" +
           "  status — check if Voxlert CLI is available\n" +
-          "\nConfigure voice packs, TTS backend, etc. via: voxlert config",
+          "\nFor full interactive config, run in terminal: voxlert setup",
         "info",
       );
     },

package/src/commands/pack-helpers.js

@@ -5,6 +5,7 @@ import { showOverlay } from "../overlay.js";
 import { listPacks, loadPack } from "../packs.js";
 import { generatePhrase } from "../llm.js";
 import { speakPhrase } from "../audio.js";
+import { resolvePrefix, DEFAULT_PREFIX } from "../prefix.js";
 
 export async function testPipeline(text, pack) {
   if (!text) {
@@ -33,12 +34,19 @@ export async function testPipeline(text, pack) {
     phrase = text;
   }
 
+  // Resolve prefix from config, same as the hook path
+  const prefixTemplate = config.prefix !== undefined ? config.prefix : DEFAULT_PREFIX;
+  const resolvedPrefix = resolvePrefix(prefixTemplate, process.cwd());
+  if (resolvedPrefix) {
+    phrase = `${resolvedPrefix}; ${phrase}`;
+  }
+
   console.log("Sending to TTS...");
   showOverlay(phrase, {
     category: "notification",
     packName: activePack.name,
     packId: activePack.id || (config.active_pack || "sc1-kerrigan-infested"),
-    prefix: "Test",
+    prefix: resolvedPrefix,
     config,
     overlayColors: activePack.overlay_colors,
   });

package/src/prefix.js

@@ -0,0 +1,266 @@
+/**
+ * Prefix resolver — composable template variables for announcement prefixes.
+ *
+ * Template syntax:
+ *   ${dirname}          — basename of cwd
+ *   ${project}          — project name from manifest files (package.json, pyproject.toml, etc.)
+ *   ${project|dirname}  — pipe means "try left, fall back to right"
+ *
+ * Literal text is preserved as-is: "Project ${project|dirname}" → "Project my-app"
+ * Unknown variables and all-null chains resolve to empty string.
+ */
+
+import { basename, join } from "path";
+import { existsSync, readFileSync, readdirSync } from "fs";
+
+/** Default prefix template — project name with dirname fallback. */
+export const DEFAULT_PREFIX = "${project|dirname}";
+
+// ---------------------------------------------------------------------------
+// Resolvers — each is (cwd: string) => string | null
+// ---------------------------------------------------------------------------
+
+const RESOLVERS = {
+  dirname: (cwd) => (cwd ? basename(cwd) : null),
+  project: readProjectName,
+};
+
+// ---------------------------------------------------------------------------
+// Project manifest readers, tried in priority order.
+// Each entry: [filename, extractorFn(contents) => string|null]
+// ---------------------------------------------------------------------------
+
+/** @type {Array<[string, (content: string) => string|null]>} */
+const MANIFEST_READERS = [
+  ["package.json", extractPackageName],
+  ["pyproject.toml", extractPyprojectName],
+  ["Cargo.toml", extractTomlSectionField("package", "name")],
+  ["setup.cfg", extractIniSectionField("metadata", "name")],
+  ["go.mod", extractGoModule],
+  ["composer.json", extractComposerName],
+  ["pubspec.yaml", extractYamlScalar("name")],
+  // gemspec handled separately — requires glob
+];
+
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+
+/**
+ * Resolve a prefix template string against the given working directory.
+ *
+ * @param {string} template - e.g. "${project|dirname}" or "my-app"
+ * @param {string} cwd - Absolute path to the project directory
+ * @returns {string} Resolved prefix (may be empty)
+ */
+export function resolvePrefix(template, cwd) {
+  if (!template) return "";
+  return template.replace(/\$\{([^}]+)\}/g, (_match, expr) => {
+    const candidates = expr.split("|");
+    for (const name of candidates) {
+      const resolver = RESOLVERS[name.trim()];
+      if (!resolver) continue;
+      const value = resolver(cwd);
+      if (value) return value;
+    }
+    return "";
+  });
+}
+
+// ---------------------------------------------------------------------------
+// readProjectName — walks manifests in priority order
+// ---------------------------------------------------------------------------
+
+/**
+ * Read the project name from the first recognized manifest file in cwd.
+ * Returns null if no manifest is found or none yields a name.
+ *
+ * @param {string} cwd
+ * @returns {string|null}
+ */
+function readProjectName(cwd) {
+  if (!cwd) return null;
+
+  // Fixed-name manifests
+  for (const [filename, extractor] of MANIFEST_READERS) {
+    const filepath = join(cwd, filename);
+    const content = readFileSafe(filepath);
+    if (content === null) continue;
+    const name = extractor(content);
+    if (name) return name;
+  }
+
+  // *.gemspec — need a directory listing
+  try {
+    const entries = readdirSync(cwd);
+    const gemspec = entries.find((e) => e.endsWith(".gemspec"));
+    if (gemspec) {
+      const content = readFileSafe(join(cwd, gemspec));
+      if (content) {
+        const name = extractGemspecName(content);
+        if (name) return name;
+      }
+    }
+  } catch {
+    // directory unreadable — skip
+  }
+
+  return null;
+}
+
+// ---------------------------------------------------------------------------
+// Extractors
+// ---------------------------------------------------------------------------
+
+/** JSON field extractor factory. */
+function extractJsonField(field) {
+  return (content) => {
+    try {
+      const obj = JSON.parse(content);
+      const val = obj?.[field];
+      return typeof val === "string" && val.trim() ? val.trim() : null;
+    } catch {
+      return null;
+    }
+  };
+}
+
+/** package.json: strip npm scope (@scope/name → name). */
+function extractPackageName(content) {
+  const name = extractJsonField("name")(content);
+  if (!name) return null;
+  // Strip @scope/ prefix for TTS-friendly output
+  const slashIdx = name.indexOf("/");
+  return slashIdx >= 0 && name.startsWith("@") ? name.slice(slashIdx + 1) : name;
+}
+
+/** composer.json: name is "vendor/package" — return the package segment. */
+function extractComposerName(content) {
+  try {
+    const obj = JSON.parse(content);
+    const val = obj?.name;
+    if (typeof val !== "string" || !val.trim()) return null;
+    const parts = val.split("/");
+    return parts[parts.length - 1].trim() || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * pyproject.toml: check [project].name then [tool.poetry].name.
+ * Lightweight line-based extraction — no full TOML parser.
+ */
+function extractPyprojectName(content) {
+  return (
+    extractTomlSectionField("project", "name")(content) ||
+    extractTomlNestedField("tool.poetry", "name")(content)
+  );
+}
+
+/**
+ * Factory: extract `key = "value"` under a [section] header in TOML.
+ * Handles both `key = "value"` and `key = 'value'`.
+ */
+function extractTomlSectionField(section, key) {
+  // Match [section] exactly (no dots, no sub-tables)
+  const headerRe = new RegExp(`^\\[${escapeRegex(section)}\\]\\s*$`);
+  const fieldRe = new RegExp(`^${escapeRegex(key)}\\s*=\\s*["'](.+?)["']`);
+  return (content) => extractFromSections(content, headerRe, fieldRe);
+}
+
+/**
+ * Factory: extract `key = "value"` under a [dotted.section] header in TOML.
+ * e.g. [tool.poetry] → key = "value"
+ */
+function extractTomlNestedField(dottedSection, key) {
+  const headerRe = new RegExp(`^\\[${escapeRegex(dottedSection)}\\]\\s*$`);
+  const fieldRe = new RegExp(`^${escapeRegex(key)}\\s*=\\s*["'](.+?)["']`);
+  return (content) => extractFromSections(content, headerRe, fieldRe);
+}
+
+/** Shared: scan lines for a section header, then find a field before the next header. */
+function extractFromSections(content, headerRe, fieldRe) {
+  const lines = content.split("\n");
+  let inSection = false;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed.startsWith("[")) {
+      inSection = headerRe.test(trimmed);
+      continue;
+    }
+    if (inSection) {
+      const m = fieldRe.exec(trimmed);
+      if (m) return m[1].trim() || null;
+    }
+  }
+  return null;
+}
+
+/** setup.cfg: INI-style [metadata] section, name = value (no quotes). */
+function extractIniSectionField(section, key) {
+  const headerRe = new RegExp(`^\\[${escapeRegex(section)}\\]\\s*$`, "i");
+  const fieldRe = new RegExp(`^${escapeRegex(key)}\\s*=\\s*(.+)`, "i");
+  return (content) => {
+    const lines = content.split("\n");
+    let inSection = false;
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (trimmed.startsWith("[")) {
+        inSection = headerRe.test(trimmed);
+        continue;
+      }
+      if (inSection) {
+        const m = fieldRe.exec(trimmed);
+        if (m) return m[1].trim() || null;
+      }
+    }
+    return null;
+  };
+}
+
+/** go.mod: `module github.com/user/repo` → "repo" */
+function extractGoModule(content) {
+  const m = /^module\s+(\S+)/m.exec(content);
+  if (!m) return null;
+  const parts = m[1].split("/");
+  return parts[parts.length - 1].trim() || null;
+}
+
+/** *.gemspec: first `spec.name = "value"` or `.name = "value"` */
+function extractGemspecName(content) {
+  const m = /\.name\s*=\s*["'](.+?)["']/.exec(content);
+  return m ? m[1].trim() || null : null;
+}
+
+/** YAML top-level scalar: `name: value` */
+function extractYamlScalar(key) {
+  const re = new RegExp(`^${escapeRegex(key)}:\\s*(.+)`, "m");
+  return (content) => {
+    const m = re.exec(content);
+    if (!m) return null;
+    // Strip surrounding quotes if present
+    let val = m[1].trim();
+    if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+      val = val.slice(1, -1);
+    }
+    return val || null;
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function readFileSafe(filepath) {
+  try {
+    if (!existsSync(filepath)) return null;
+    return readFileSync(filepath, "utf-8");
+  } catch {
+    return null;
+  }
+}
+
+function escapeRegex(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}

package/src/upgrade-check.js

@@ -91,13 +91,9 @@ const ansi = {
   grey: "\x1b[90m",
 };
 
-function stripAnsi(str) {
-  return str.replace(/\x1b\[[0-9;]*m/g, "");
-}
-
 /**
- * Print upgrade notification to stdout, styled like a terminal box:
- * dark background hint, cyan "Update available!", version range, command, release notes link.
+ * Print upgrade notification to stdout, styled with horizontal separator lines:
+ * yellow lines above and below, bold header, version info, install command, changelog link.
  * Only uses colors when stdout is TTY.
  */
 export function printUpgradeNotification(info, options = {}) {
@@ -110,28 +106,16 @@ export function printUpgradeNotification(info, options = {}) {
     releaseNotesUrl ||
     `https://github.com/settinghead/voxlert/releases/latest`;
 
-  const line1 = `${c.yellow}✨${c.reset} ${c.cyan}Update available!${c.reset} ${info.current} -> ${info.latest}`;
-  const line2 = `Run ${installCmd} to update.`;
-  const line3 = "See full release notes:";
-  const line4 = `${c.cyan}${url}${c.reset}`;
-
-  const padding = 2;
-  const maxLen = Math.max(
-    stripAnsi(line1).length,
-    line2.length,
-    line3.length,
-    url.length
-  );
-  const width = maxLen + padding * 2;
-  const border = "─".repeat(width);
-  const pad = (s) => " ".repeat(Math.max(0, width - 2 - stripAnsi(s).length));
+  const rule = `${c.yellow}${"─".repeat(60)}${c.reset}`;
 
   console.log("");
-  console.log(`${c.grey}┌${border}┐${c.reset}`);
-  console.log(`${c.grey}│${c.reset}${" ".repeat(padding)}${line1}${pad(line1)}${c.grey}│${c.reset}`);
-  console.log(`${c.grey}│${c.reset}${" ".repeat(padding)}${line2}${pad(line2)}${c.grey}│${c.reset}`);
-  console.log(`${c.grey}│${c.reset}${" ".repeat(padding)}${line3}${pad(line3)}${c.grey}│${c.reset}`);
-  console.log(`${c.grey}│${c.reset}${" ".repeat(padding)}${line4}${pad(line4)}${c.grey}│${c.reset}`);
-  console.log(`${c.grey}└${border}┘${c.reset}`);
+  console.log(rule);
+  console.log("");
+  console.log(`  ${c.bold}${c.yellow}Update Available${c.reset}`);
+  console.log(`  New version ${c.bold}${info.latest}${c.reset} is available. Run: ${c.cyan}${installCmd}${c.reset}`);
+  console.log(`  Changelog:`);
+  console.log(`  ${c.cyan}${url}${c.reset}`);
+  console.log("");
+  console.log(rule);
   console.log("");
 }

package/src/voxlert.js

@@ -6,7 +6,7 @@
  * speaks them through a local Chatterbox TTS server.
  */
 
-import { basename } from "path";
+import { resolvePrefix, DEFAULT_PREFIX } from "./prefix.js";
 import { appendFileSync, mkdirSync } from "fs";
 import { loadConfig, EVENT_MAP, CONTEXTUAL_EVENTS, FALLBACK_PHRASES } from "./config.js";
 import { extractContext, generatePhrase } from "./llm.js";
@@ -58,7 +58,7 @@ export async function processHookEvent(eventData) {
     llm_backend: config.llm_backend || "",
     tts_backend: config.tts_backend || "",
     overlay: config.overlay === true,
-    prefix: config.prefix !== undefined ? config.prefix : "${dirname}",
+    prefix: config.prefix !== undefined ? config.prefix : DEFAULT_PREFIX,
     task_complete_enabled: config.categories?.["task.complete"] !== false,
     task_error_enabled: config.categories?.["task.error"] !== false,
   });
@@ -91,38 +91,33 @@ export async function processHookEvent(eventData) {
   debugLog("processHookEvent processing", { source, eventName, category });
   // Load active voice pack
   const pack = loadPack(config);
-  const projectName = cwd ? basename(cwd) : "";
-
   // Allow callers to bypass LLM generation entirely with a pre-built phrase
   if (eventData.phrase_override && typeof eventData.phrase_override === "string") {
     const overridePhrase = eventData.phrase_override.trim();
     if (overridePhrase) {
       debugLog("processHookEvent using phrase_override", { source, phrase: overridePhrase.slice(0, 120) });
 
-      // Prepend prefix
-      const prefixTemplate = config.prefix !== undefined ? config.prefix : "${dirname}";
-      let resolvedPrefix = "";
-      if (prefixTemplate !== "") {
-        resolvedPrefix = prefixTemplate.replace(/\$\{dirname\}/g, projectName);
-        if (resolvedPrefix) {
-          const finalPhrase = `${resolvedPrefix}; ${overridePhrase}`;
-          const packId = config.active_pack || "sc1-kerrigan-infested";
-          appendLog(
-            `[${new Date().toISOString()}] source=${source} event=${eventName} category=${category} phrase=${finalPhrase.replace(/\s+/g, " ").slice(0, 120)}`,
-            config,
-          );
-          showOverlay(finalPhrase, {
-            category,
-            packName: pack.name,
-            packId: pack.id || packId,
-            prefix: resolvedPrefix,
-            config,
-            overlayColors: pack.overlay_colors,
-          });
-          await speakPhrase(finalPhrase, config, pack);
-          debugLog("processHookEvent done (phrase_override)", { source });
-          return;
-        }
+      // Resolve prefix
+      const prefixTemplate = config.prefix !== undefined ? config.prefix : DEFAULT_PREFIX;
+      const resolvedPrefix = resolvePrefix(prefixTemplate, cwd);
+      if (resolvedPrefix) {
+        const finalPhrase = `${resolvedPrefix}; ${overridePhrase}`;
+        const packId = config.active_pack || "sc1-kerrigan-infested";
+        appendLog(
+          `[${new Date().toISOString()}] source=${source} event=${eventName} category=${category} phrase=${finalPhrase.replace(/\s+/g, " ").slice(0, 120)}`,
+          config,
+        );
+        showOverlay(finalPhrase, {
+          category,
+          packName: pack.name,
+          packId: pack.id || packId,
+          prefix: resolvedPrefix,
+          config,
+          overlayColors: pack.overlay_colors,
+        });
+        await speakPhrase(finalPhrase, config, pack);
+        debugLog("processHookEvent done (phrase_override)", { source });
+        return;
       }
 
       const packId = config.active_pack || "sc1-kerrigan-infested";
@@ -196,14 +191,11 @@ export async function processHookEvent(eventData) {
     phrase = phrases[Math.floor(Math.random() * phrases.length)];
   }
 
-  // Prepend prefix (supports ${dirname} template variable)
-  const prefixTemplate = config.prefix !== undefined ? config.prefix : "${dirname}";
-  let resolvedPrefix = "";
-  if (prefixTemplate !== "") {
-    resolvedPrefix = prefixTemplate.replace(/\$\{dirname\}/g, projectName);
-    if (resolvedPrefix) {
-      phrase = `${resolvedPrefix}; ${phrase}`;
-    }
+  // Resolve prefix (supports ${project|dirname} template variables)
+  const prefixTemplate = config.prefix !== undefined ? config.prefix : DEFAULT_PREFIX;
+  const resolvedPrefix = resolvePrefix(prefixTemplate, cwd);
+  if (resolvedPrefix) {
+    phrase = `${resolvedPrefix}; ${phrase}`;
   }
 
   const packId = config.active_pack || "sc1-kerrigan-infested";