@mcptoolshop/claude-sfx 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.2.1] - 2026-03-30
+
+### Fixed
+- **Windows audio playback** — use ffplay (ffmpeg) instead of PowerShell SoundPlayer, which silently failed on short audio clips. Falls back to PowerShell if ffplay is not installed.
+- **Gain levels too low** — boosted all verb master gains from 0.16–0.20 to 0.50–0.60 so sounds are actually audible through system speakers
+
 ## [1.2.0] - 2026-03-30
 
 ### Changed

package/dist/player.js

@@ -22,15 +22,25 @@ function getTempPath() {
 function getPlayCommand(filePath) {
     const platform = process.platform;
     if (platform === "win32") {
-        // PowerShell SoundPlayer — synchronous, reliable, built-in
-        return {
-            command: "powershell",
-            args: [
-                "-NoProfile",
-                "-Command",
-                `(New-Object Media.SoundPlayer '${filePath}').PlaySync()`,
-            ],
-        };
+        // Prefer ffplay (from ffmpeg) — fast, reliable, no UI
+        try {
+            execSync("where ffplay", { stdio: "ignore" });
+            return {
+                command: "ffplay",
+                args: ["-nodisp", "-autoexit", "-loglevel", "quiet", filePath],
+            };
+        }
+        catch {
+            // Fallback: PowerShell SoundPlayer
+            return {
+                command: "powershell",
+                args: [
+                    "-NoProfile",
+                    "-Command",
+                    `(New-Object Media.SoundPlayer '${filePath}').PlaySync()`,
+                ],
+            };
+        }
     }
     if (platform === "darwin") {
         return { command: "afplay", args: [filePath] };

package/dist/profiles.js

@@ -66,7 +66,7 @@ const MINIMAL_PROFILE = {
         // ── intake: light, inviting, curious ───────────────────────────
         intake: {
             type: "motif",
-            gain: 0.18,
+            gain: 0.55,
             variants: [
                 // Variant A: A4 → C#5
                 { notes: [
@@ -88,7 +88,7 @@ const MINIMAL_PROFILE = {
         // ── transform: active, clever, articulate ─────────────────────
         transform: {
             type: "motif",
-            gain: 0.17,
+            gain: 0.52,
             variants: [
                 // Variant A: C#5 → B4 → E5 (3-note)
                 { notes: [
@@ -112,7 +112,7 @@ const MINIMAL_PROFILE = {
         // ── commit: satisfying, settled, rewarding ────────────────────
         commit: {
             type: "motif",
-            gain: 0.20,
+            gain: 0.60,
             variants: [
                 // Variant A: E4+A4 dyad → C#5 sparkle
                 { notes: [
@@ -137,7 +137,7 @@ const MINIMAL_PROFILE = {
         // ── navigate: precise, clean, directional ─────────────────────
         navigate: {
             type: "motif",
-            gain: 0.16,
+            gain: 0.50,
             variants: [
                 // Variant A: B4 → E5
                 { notes: [
@@ -159,7 +159,7 @@ const MINIMAL_PROFILE = {
         // ── execute: grounded, tactile, percussive ────────────────────
         execute: {
             type: "motif",
-            gain: 0.19,
+            gain: 0.58,
             variants: [
                 // Variant A: A3 body + noise click
                 {
@@ -193,7 +193,7 @@ const MINIMAL_PROFILE = {
             freqDown: [2400, 700],
             bandwidth: 0.7,
             envelope: { attack: 0.01, decay: 0.11, sustain: 0.10, release: 0.06 },
-            gain: 0.17,
+            gain: 0.52,
             anchorVariants: [
                 // Variant A: E4 → A4
                 { notes: [
@@ -219,7 +219,7 @@ const MINIMAL_PROFILE = {
             freqDown: [2600, 500],
             bandwidth: 0.65,
             envelope: { attack: 0.008, decay: 0.12, sustain: 0.16, release: 0.09 },
-            gain: 0.19,
+            gain: 0.58,
             anchorVariants: [
                 // Variant A: A3+E4 anchor → C#5 confirmation
                 { notes: [
@@ -250,7 +250,7 @@ const MINIMAL_PROFILE = {
             frequency: S.A4,
             duration: 0.18,
             envelope: { attack: 0.01, decay: 0.08, sustain: 0.25, release: 0.06 },
-            gain: 0.20,
+            gain: 0.60,
             harmonicGain: 0.08,
         },
         tone2: {
@@ -260,7 +260,7 @@ const MINIMAL_PROFILE = {
             frequency: S.Cs5,
             duration: 0.22,
             envelope: { attack: 0.01, decay: 0.10, sustain: 0.25, release: 0.08 },
-            gain: 0.18,
+            gain: 0.55,
             harmonicGain: 0.08,
         },
         staggerSeconds: 0.065,
@@ -273,7 +273,7 @@ const MINIMAL_PROFILE = {
             frequency: S.Cs5,
             duration: 0.15,
             envelope: { attack: 0.01, decay: 0.08, sustain: 0.18, release: 0.04 },
-            gain: 0.18,
+            gain: 0.55,
         },
         tone2: {
             waveform: "sine",
@@ -282,20 +282,20 @@ const MINIMAL_PROFILE = {
             frequency: S.A4,
             duration: 0.25,
             envelope: { attack: 0.01, decay: 0.12, sustain: 0.18, release: 0.10 },
-            gain: 0.16,
+            gain: 0.50,
         },
         staggerSeconds: 0.075,
     },
     ambient: {
         droneFreq: S.A3,
         droneWaveform: "sine",
-        droneGain: 0.10,
+        droneGain: 0.25,
         chunkDuration: 2.0,
         resolveNote1: S.A4,
         resolveNote2: S.E5,
         resolveWaveform: "sine",
         resolveDuration: 0.16,
-        resolveGain: 0.18,
+        resolveGain: 0.55,
     },
 };
 // --- Retro profile: same motifs, square waveform, snappier envelopes ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcptoolshop/claude-sfx",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Procedural audio feedback for Claude Code — UX for agentic coding",
   "type": "module",
   "bin": {

package/profiles/minimal.json

@@ -4,7 +4,7 @@
   "verbs": {
     "intake": {
       "type": "motif",
-      "gain": 0.18,
+      "gain": 0.55,
       "variants": [
         {
           "notes": [
@@ -112,7 +112,7 @@
     },
     "transform": {
       "type": "motif",
-      "gain": 0.17,
+      "gain": 0.52,
       "variants": [
         {
           "notes": [
@@ -266,7 +266,7 @@
     },
     "commit": {
       "type": "motif",
-      "gain": 0.2,
+      "gain": 0.6,
       "variants": [
         {
           "notes": [
@@ -428,7 +428,7 @@
     },
     "navigate": {
       "type": "motif",
-      "gain": 0.16,
+      "gain": 0.5,
       "variants": [
         {
           "notes": [
@@ -542,7 +542,7 @@
     },
     "execute": {
       "type": "motif",
-      "gain": 0.19,
+      "gain": 0.58,
       "variants": [
         {
           "notes": [
@@ -657,7 +657,7 @@
         "sustain": 0.1,
         "release": 0.06
       },
-      "gain": 0.17,
+      "gain": 0.52,
       "anchorVariants": [
         {
           "notes": [
@@ -766,7 +766,7 @@
         "sustain": 0.16,
         "release": 0.09
       },
-      "gain": 0.19,
+      "gain": 0.58,
       "anchorVariants": [
         {
           "notes": [
@@ -916,7 +916,7 @@
         "sustain": 0.25,
         "release": 0.06
       },
-      "gain": 0.2,
+      "gain": 0.6,
       "harmonicGain": 0.08
     },
     "tone2": {
@@ -931,7 +931,7 @@
         "sustain": 0.25,
         "release": 0.08
       },
-      "gain": 0.18,
+      "gain": 0.55,
       "harmonicGain": 0.08
     },
     "staggerSeconds": 0.065
@@ -949,7 +949,7 @@
         "sustain": 0.18,
         "release": 0.04
       },
-      "gain": 0.18
+      "gain": 0.55
     },
     "tone2": {
       "waveform": "sine",
@@ -963,19 +963,19 @@
         "sustain": 0.18,
         "release": 0.1
       },
-      "gain": 0.16
+      "gain": 0.5
     },
     "staggerSeconds": 0.075
   },
   "ambient": {
     "droneFreq": 220,
     "droneWaveform": "sine",
-    "droneGain": 0.1,
+    "droneGain": 0.25,
     "chunkDuration": 2,
     "resolveNote1": 440,
     "resolveNote2": 659.25,
     "resolveWaveform": "sine",
     "resolveDuration": 0.16,
-    "resolveGain": 0.18
+    "resolveGain": 0.55
   }
 }