@pennyfarthing/cyclist 10.2.0 → 10.3.0

package/dist/notification-sound.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Notification Sound Service (Story MSSCI-14191)
+ *
+ * Provides audio notifications for workflow events using Web Audio API.
+ * Different tones for different event types:
+ * - HANDOFF: Low tone (agent transition)
+ * - QUESTION: Higher tone (user input needed)
+ * - COMPLETION: Chord (workflow complete)
+ *
+ * State is managed in-memory but can sync with settings via loadNotificationSoundSetting().
+ */
+/**
+ * Notification event types that trigger sounds
+ */
+export declare const NotificationEvent: {
+    readonly HANDOFF: "handoff";
+    readonly QUESTION: "question";
+    readonly COMPLETION: "completion";
+};
+export type NotificationEventType = (typeof NotificationEvent)[keyof typeof NotificationEvent];
+/**
+ * Service class for notification sounds (exported for type checking)
+ */
+export declare class NotificationSound {
+    static isEnabled(): boolean;
+    static setEnabled(enabled: boolean): void;
+    static play(event: NotificationEventType): Promise<void>;
+}
+/**
+ * Check if notification sounds are enabled
+ */
+export declare function isNotificationSoundEnabled(): boolean;
+/**
+ * Enable or disable notification sounds
+ */
+export declare function setNotificationSoundEnabled(enabled: boolean): void;
+/**
+ * Load notification sound setting from REST API
+ */
+export declare function loadNotificationSoundSetting(): Promise<void>;
+/**
+ * Check if audio playback is permitted (handles autoplay restrictions)
+ * Returns true if audio can play, false if user gesture is required
+ */
+export declare function checkAudioPermission(): Promise<boolean>;
+/**
+ * Play a notification sound for the given event type
+ */
+export declare function playNotificationSound(event: NotificationEventType): Promise<void>;
+/**
+ * Reset state (for testing)
+ */
+export declare function resetNotificationSoundState(): void;
+/**
+ * Inject a custom AudioContext class (for testing)
+ * Pass null to use the default detection
+ */
+export declare function setAudioContextClass(cls: (new () => AudioContext) | null): void;
+//# sourceMappingURL=notification-sound.d.ts.map

package/dist/notification-sound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-sound.d.ts","sourceRoot":"","sources":["../src/notification-sound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AA0B/F;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,SAAS,IAAI,OAAO;IAI3B,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;WAI5B,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC,CAUlE;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAa7D;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BvF;AA6ED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAUlD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,CAAC,UAAU,YAAY,CAAC,GAAG,IAAI,GAAG,IAAI,CAI/E"}

package/dist/notification-sound.js

@@ -0,0 +1,219 @@
+/**
+ * Notification Sound Service (Story MSSCI-14191)
+ *
+ * Provides audio notifications for workflow events using Web Audio API.
+ * Different tones for different event types:
+ * - HANDOFF: Low tone (agent transition)
+ * - QUESTION: Higher tone (user input needed)
+ * - COMPLETION: Chord (workflow complete)
+ *
+ * State is managed in-memory but can sync with settings via loadNotificationSoundSetting().
+ */
+// =============================================================================
+// Types
+// =============================================================================
+/**
+ * Notification event types that trigger sounds
+ */
+export const NotificationEvent = {
+    HANDOFF: 'handoff', // Agent handoff / phase transition
+    QUESTION: 'question', // User input required
+    COMPLETION: 'completion', // Workflow completion
+};
+/**
+ * Frequency configurations for each event type (in Hz)
+ */
+const EVENT_FREQUENCIES = {
+    [NotificationEvent.HANDOFF]: [330], // E4 - single low tone
+    [NotificationEvent.QUESTION]: [523], // C5 - higher, attention-grabbing
+    [NotificationEvent.COMPLETION]: [523, 659, 784], // C5-E5-G5 major chord
+};
+// =============================================================================
+// State
+// =============================================================================
+let soundEnabled = false;
+let audioContext = null;
+// For testing: injectable AudioContext constructor
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let _audioContextClass = null;
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Service class for notification sounds (exported for type checking)
+ */
+export class NotificationSound {
+    static isEnabled() {
+        return isNotificationSoundEnabled();
+    }
+    static setEnabled(enabled) {
+        setNotificationSoundEnabled(enabled);
+    }
+    static async play(event) {
+        return playNotificationSound(event);
+    }
+}
+/**
+ * Check if notification sounds are enabled
+ */
+export function isNotificationSoundEnabled() {
+    return soundEnabled;
+}
+/**
+ * Enable or disable notification sounds
+ */
+export function setNotificationSoundEnabled(enabled) {
+    soundEnabled = enabled;
+}
+/**
+ * Load notification sound setting from REST API
+ */
+export async function loadNotificationSoundSetting() {
+    try {
+        const response = await fetch('/api/settings');
+        if (response.ok) {
+            const settings = await response.json();
+            soundEnabled = settings?.notifications?.sound ?? false;
+        }
+    }
+    catch {
+        // Silently fail - keep current state
+    }
+}
+/**
+ * Check if audio playback is permitted (handles autoplay restrictions)
+ * Returns true if audio can play, false if user gesture is required
+ */
+export async function checkAudioPermission() {
+    try {
+        const ctx = getOrCreateAudioContext();
+        if (!ctx)
+            return false;
+        if (ctx.state === 'suspended') {
+            await ctx.resume();
+        }
+        return ctx.state === 'running';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Play a notification sound for the given event type
+ */
+export async function playNotificationSound(event) {
+    // Exit early if disabled
+    if (!soundEnabled) {
+        return;
+    }
+    try {
+        const ctx = getOrCreateAudioContext();
+        if (!ctx) {
+            return;
+        }
+        // Handle suspended state (autoplay restrictions)
+        if (ctx.state === 'suspended') {
+            await ctx.resume();
+        }
+        const frequencies = EVENT_FREQUENCIES[event] || EVENT_FREQUENCIES[NotificationEvent.HANDOFF];
+        // Play each frequency in the pattern
+        for (let i = 0; i < frequencies.length; i++) {
+            const freq = frequencies[i];
+            const startTime = ctx.currentTime + i * 0.1; // Slight offset for chord/arpeggio effect
+            playTone(ctx, freq, startTime, 0.2);
+        }
+    }
+    catch {
+        // Silently fail - audio is optional
+    }
+}
+// =============================================================================
+// Internal Helpers
+// =============================================================================
+/**
+ * Get the AudioContext constructor (allows for mocking in tests)
+ * Checks multiple locations to support different environments and test mocking
+ */
+function getAudioContextClass() {
+    // Check if a test-injected class is set
+    if (_audioContextClass !== null) {
+        return _audioContextClass;
+    }
+    // Check various locations where AudioContext might be defined
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const g = globalThis;
+    if (g.AudioContext) {
+        return g.AudioContext;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    if (typeof window !== 'undefined' && window.AudioContext) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return window.AudioContext;
+    }
+    // webkitAudioContext for Safari
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    if (typeof window !== 'undefined' && window.webkitAudioContext) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return window.webkitAudioContext;
+    }
+    return null;
+}
+/**
+ * Get or create the shared AudioContext
+ */
+function getOrCreateAudioContext() {
+    const AudioContextClass = getAudioContextClass();
+    if (!AudioContextClass) {
+        return null;
+    }
+    if (!audioContext) {
+        try {
+            audioContext = new AudioContextClass();
+        }
+        catch {
+            return null;
+        }
+    }
+    return audioContext;
+}
+/**
+ * Play a single tone using Web Audio API
+ */
+function playTone(ctx, frequency, startTime, duration) {
+    const oscillator = ctx.createOscillator();
+    const gainNode = ctx.createGain();
+    oscillator.connect(gainNode);
+    gainNode.connect(ctx.destination);
+    oscillator.type = 'sine';
+    oscillator.frequency.setValueAtTime(frequency, startTime);
+    // Envelope: quick attack, gradual decay
+    gainNode.gain.setValueAtTime(0.3, startTime);
+    gainNode.gain.exponentialRampToValueAtTime(0.01, startTime + duration);
+    oscillator.start(startTime);
+    oscillator.stop(startTime + duration);
+}
+/**
+ * Reset state (for testing)
+ */
+export function resetNotificationSoundState() {
+    soundEnabled = false;
+    if (audioContext) {
+        try {
+            audioContext.close().catch(() => { });
+        }
+        catch {
+            // Ignore errors closing mock audio context
+        }
+        audioContext = null;
+    }
+}
+/**
+ * Inject a custom AudioContext class (for testing)
+ * Pass null to use the default detection
+ */
+export function setAudioContextClass(cls) {
+    _audioContextClass = cls;
+    // Reset the existing context so the new class is used
+    audioContext = null;
+}
+//# sourceMappingURL=notification-sound.js.map

package/dist/notification-sound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-sound.js","sourceRoot":"","sources":["../src/notification-sound.ts"],"names":[],"mappings":"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"}

package/dist/plugin-loader.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tests for Story 93-6: Plugin Router Loader for Cyclist
+ *
+ * Tests the dynamic discovery and mounting of API routers from installed
+ * @pennyfarthing/* plugin packages. The loader uses the plugin discovery
+ * system (93-3) to find plugins and mount their Express routers.
+ *
+ * Test categories:
+ * 1. initPluginRouters() - Core loading behavior
+ * 2. Plugin with API router - Benchmark plugin integration
+ * 3. Graceful degradation - Missing packages, failed imports
+ * 4. Cyclist starts without plugins - Empty state
+ *
+ * Run with: cd packages/cyclist && pnpm test
+ */
+export {};
+//# sourceMappingURL=plugin-loader.test.d.ts.map

package/dist/plugin-loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.test.d.ts","sourceRoot":"","sources":["../src/plugin-loader.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}