@mcptoolshop/claude-sfx 1.1.2 → 1.2.1

package/CHANGELOG.md

@@ -7,6 +7,33 @@ 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
+- **Complete sound redesign** — all verbs revoiced into A major pentatonic scale system
+- **Multi-note motifs** replace single-tone beeps: each verb now has a 2–3 note melodic identity
+- **3 variants per verb** with constrained micro-jitter (±5 cents pitch, ±6% duration, ±4ms onset) to reduce listener fatigue
+- **Timbre separation** — intake uses sine/triangle blend, transform gets FM shimmer, commit has triangle/sine dyad + sparkle, navigate uses triangle radar chirp, execute sits in lower register with noise transient
+- **Musical modifiers** — status:err drops the final note one scale degree instead of arbitrary pitch multiplication; status:warn uses gentler 5.5 Hz tremolo; status:ok adds a quiet perfect fifth
+- **Intensity progression** (1–5) builds through harmonics → brighter intervals → FM shimmer → richer tail, NOT through loudness
+- **Escalation progression** (1–5) darkens through lower register → detune → tremolo → heavy weight
+- **Session sounds** now share the A major pentatonic grammar: start (A4→C#5), end (C#5→A4), fanfare (A4→C#5→E5)
+- **Profile schema** updated: `MotifVerbConfig` with variant arrays replaces `ToneVerbConfig`; whoosh verbs gain `anchorVariants`
+- Retro profile updated to match new architecture with square-wave motifs
+
+### Added
+- `variantIndex` option in PlayOptions for deterministic testing
+- `SCALE` constants and `scaleStepDown`/`findClosestScaleDegree` scale helpers exported from profiles
+- Waveform blending (`blendWaveform`/`blendAmount`) on motif notes and chime tones
+- `NoiseTransient` type for filtered percussive onsets (execute verb)
+- `WhooshAnchorVariant` type for tonal anchors under whoosh verbs (move, sync)
+
 ## [1.1.2] - 2026-03-29
 
 ### Fixed

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.d.ts

@@ -2,47 +2,111 @@
  * Profile system — configurable sound palettes.
  * Each profile defines synthesis parameters for every verb + session sounds.
  * Profiles are JSON-serializable, so users can create their own.
+ *
+ * Sound design is rooted in A major pentatonic to ensure musical coherence.
  */
 import type { Waveform, Envelope } from "./synth.js";
-/** Synthesis params for a tone-based verb (intake, transform, commit, navigate, execute). */
-export interface ToneVerbConfig {
-    type: "tone";
-    waveform: Waveform;
+export declare const SCALE: {
+    readonly A3: 220;
+    readonly B3: 246.94;
+    readonly Cs4: 277.18;
+    readonly E4: 329.63;
+    readonly Fs4: 369.99;
+    readonly A4: 440;
+    readonly B4: 493.88;
+    readonly Cs5: 554.37;
+    readonly E5: 659.25;
+    readonly Fs5: 739.99;
+    readonly A5: 880;
+    readonly B5: 987.77;
+};
+/** Ordered scale degrees for modifier lookups (low to high). */
+export declare const SCALE_DEGREES: number[];
+/** Get the next lower scale degree. Returns freq × 0.9 as fallback. */
+export declare function scaleStepDown(freq: number): number;
+/** Find the closest scale degree to a target frequency. */
+export declare function findClosestScaleDegree(freq: number): number;
+/** A single note within a motif. */
+export interface MotifNote {
+    /** Frequency in Hz (should be a scale degree). */
     frequency: number;
-    frequencyEnd?: number;
+    /** Duration in seconds. */
     duration: number;
+    /** Offset from motif start in milliseconds. Allows overlapping notes/chords. */
+    offsetMs: number;
+    /** Primary waveform. */
+    waveform: Waveform;
+    /** Optional secondary waveform for timbral blending. */
+    blendWaveform?: Waveform;
+    /** Blend amount 0–1 (proportion of blendWaveform vs primary). */
+    blendAmount?: number;
+    /** ADSR envelope. */
     envelope: Envelope;
+    /** Note gain relative to verb master gain (0–1). */
     gain: number;
+    /** FM modulator frequency ratio. */
     fmRatio?: number;
+    /** FM modulation depth in Hz. */
     fmDepth?: number;
+    /** Octave harmonic gain 0–1. */
     harmonicGain?: number;
-    /** If true, mix a short noise burst underneath (execute verb). */
-    noiseBurst?: {
-        duration: number;
-        gain: number;
-    };
+    /** Tremolo rate in Hz (for warn modifier). */
+    tremoloRate?: number;
+    /** Tremolo depth 0–1. */
+    tremoloDepth?: number;
+    /** Detune in Hz (for err modifier / beating). */
+    detune?: number;
+}
+/** Optional filtered-noise transient (percussive onset for execute verb). */
+export interface NoiseTransient {
+    /** Bandpass center start frequency. */
+    freqStart: number;
+    /** Bandpass center end frequency. */
+    freqEnd: number;
+    /** Filter Q (bandwidth). */
+    bandwidth: number;
+    /** Duration in seconds. */
+    duration: number;
+    /** Gain relative to verb master gain. */
+    gain: number;
+}
+/** A variant of a motif-based verb. */
+export interface MotifVariant {
+    notes: MotifNote[];
+    noiseTransient?: NoiseTransient;
+}
+/** A tonal anchor variant for a whoosh verb. */
+export interface WhooshAnchorVariant {
+    notes: MotifNote[];
+}
+/** Multi-note motif verb (intake, transform, commit, navigate, execute). */
+export interface MotifVerbConfig {
+    type: "motif";
+    /** 3 variants for constrained variation. */
+    variants: MotifVariant[];
+    /** Master gain 0–1. */
+    gain: number;
 }
-/** Synthesis params for a whoosh-based verb (move, sync). */
+/** Noise-sweep verb with tonal anchors (move, sync). */
 export interface WhooshVerbConfig {
     type: "whoosh";
+    /** Sweep duration in seconds. */
     duration: number;
-    /** Freq pair for direction=up. [start, end] */
+    /** Noise sweep frequencies for upward direction [start, end]. */
     freqUp: [number, number];
-    /** Freq pair for direction=down. [start, end] */
+    /** Noise sweep frequencies for downward direction [start, end]. */
     freqDown: [number, number];
+    /** Filter bandwidth (Q). */
     bandwidth: number;
+    /** Noise sweep envelope. */
     envelope: Envelope;
+    /** Master gain 0–1. */
     gain: number;
-    /** Optional tonal anchor mixed underneath (sync verb). */
-    tonalAnchor?: {
-        freqUp: [number, number];
-        freqDown: [number, number];
-        envelope: Envelope;
-        gain: number;
-    };
+    /** Tonal anchor variants mixed under the whoosh. */
+    anchorVariants: WhooshAnchorVariant[];
 }
-export type VerbConfig = ToneVerbConfig | WhooshVerbConfig;
-/** A two-tone chime (session start/end). */
+export type VerbConfig = MotifVerbConfig | WhooshVerbConfig;
+/** A session chime (start/end). */
 export interface ChimeConfig {
     tone1: {
         waveform: Waveform;
@@ -51,6 +115,8 @@ export interface ChimeConfig {
         envelope: Envelope;
         gain: number;
         harmonicGain?: number;
+        blendWaveform?: Waveform;
+        blendAmount?: number;
     };
     tone2: {
         waveform: Waveform;
@@ -59,19 +125,21 @@ export interface ChimeConfig {
         envelope: Envelope;
         gain: number;
         harmonicGain?: number;
+        blendWaveform?: Waveform;
+        blendAmount?: number;
     };
     /** Offset in seconds before tone2 starts. */
     staggerSeconds: number;
 }
 /** Long-running ambient drone config. */
 export interface AmbientConfig {
-    /** Low drone frequency */
+    /** Low drone frequency. */
     droneFreq: number;
     droneWaveform: Waveform;
     droneGain: number;
-    /** Seconds per loop chunk (the drone is generated in chunks). */
+    /** Seconds per loop chunk. */
     chunkDuration: number;
-    /** Resolution stinger: two ascending notes. */
+    /** Resolution stinger notes. */
     resolveNote1: number;
     resolveNote2: number;
     resolveWaveform: Waveform;