feat: add voice transcription as nanorepo skill (#326)

Add voice transcription skill package at
.claude/skills/add-voice-transcription/ so it can be applied via the
skills engine. Skill adds src/transcription.ts (OpenAI Whisper), modifies
whatsapp.ts to detect/transcribe voice notes, and includes intent files,
3 test cases, and 8 skill validation tests.

Also fixes skills engine runNpmInstall() to use --legacy-peer-deps,
needed for any skill adding deps with Zod v3 peer requirements.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

.claude/skills/add-voice-transcription/tests/voice-transcription.test.ts

@@ -0,0 +1,123 @@
+import { describe, expect, it } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+
+describe('voice-transcription skill package', () => {
+  const skillDir = path.resolve(__dirname, '..');
+
+  it('has a valid manifest', () => {
+    const manifestPath = path.join(skillDir, 'manifest.yaml');
+    expect(fs.existsSync(manifestPath)).toBe(true);
+
+    const content = fs.readFileSync(manifestPath, 'utf-8');
+    expect(content).toContain('skill: voice-transcription');
+    expect(content).toContain('version: 1.0.0');
+    expect(content).toContain('openai');
+    expect(content).toContain('OPENAI_API_KEY');
+  });
+
+  it('has all files declared in adds', () => {
+    const transcriptionFile = path.join(skillDir, 'add', 'src', 'transcription.ts');
+    expect(fs.existsSync(transcriptionFile)).toBe(true);
+
+    const content = fs.readFileSync(transcriptionFile, 'utf-8');
+    expect(content).toContain('transcribeAudioMessage');
+    expect(content).toContain('isVoiceMessage');
+    expect(content).toContain('transcribeWithOpenAI');
+    expect(content).toContain('downloadMediaMessage');
+    expect(content).toContain('readEnvFile');
+  });
+
+  it('has all files declared in modifies', () => {
+    const whatsappFile = path.join(skillDir, 'modify', 'src', 'channels', 'whatsapp.ts');
+    const whatsappTestFile = path.join(skillDir, 'modify', 'src', 'channels', 'whatsapp.test.ts');
+
+    expect(fs.existsSync(whatsappFile)).toBe(true);
+    expect(fs.existsSync(whatsappTestFile)).toBe(true);
+  });
+
+  it('has intent files for modified files', () => {
+    expect(fs.existsSync(path.join(skillDir, 'modify', 'src', 'channels', 'whatsapp.ts.intent.md'))).toBe(true);
+    expect(fs.existsSync(path.join(skillDir, 'modify', 'src', 'channels', 'whatsapp.test.ts.intent.md'))).toBe(true);
+  });
+
+  it('modified whatsapp.ts preserves core structure', () => {
+    const content = fs.readFileSync(
+      path.join(skillDir, 'modify', 'src', 'channels', 'whatsapp.ts'),
+      'utf-8',
+    );
+
+    // Core class and methods preserved
+    expect(content).toContain('class WhatsAppChannel');
+    expect(content).toContain('implements Channel');
+    expect(content).toContain('async connect()');
+    expect(content).toContain('async sendMessage(');
+    expect(content).toContain('isConnected()');
+    expect(content).toContain('ownsJid(');
+    expect(content).toContain('async disconnect()');
+    expect(content).toContain('async setTyping(');
+    expect(content).toContain('async syncGroupMetadata(');
+    expect(content).toContain('private async translateJid(');
+    expect(content).toContain('private async flushOutgoingQueue(');
+
+    // Core imports preserved
+    expect(content).toContain('ASSISTANT_HAS_OWN_NUMBER');
+    expect(content).toContain('ASSISTANT_NAME');
+    expect(content).toContain('STORE_DIR');
+  });
+
+  it('modified whatsapp.ts includes transcription integration', () => {
+    const content = fs.readFileSync(
+      path.join(skillDir, 'modify', 'src', 'channels', 'whatsapp.ts'),
+      'utf-8',
+    );
+
+    // Transcription imports
+    expect(content).toContain("import { isVoiceMessage, transcribeAudioMessage } from '../transcription.js'");
+
+    // Voice message handling
+    expect(content).toContain('isVoiceMessage(msg)');
+    expect(content).toContain('transcribeAudioMessage(msg, this.sock)');
+    expect(content).toContain('finalContent');
+    expect(content).toContain('[Voice:');
+    expect(content).toContain('[Voice Message - transcription unavailable]');
+    expect(content).toContain('[Voice Message - transcription failed]');
+  });
+
+  it('modified whatsapp.test.ts includes transcription mock and tests', () => {
+    const content = fs.readFileSync(
+      path.join(skillDir, 'modify', 'src', 'channels', 'whatsapp.test.ts'),
+      'utf-8',
+    );
+
+    // Transcription mock
+    expect(content).toContain("vi.mock('../transcription.js'");
+    expect(content).toContain('isVoiceMessage');
+    expect(content).toContain('transcribeAudioMessage');
+
+    // Voice transcription test cases
+    expect(content).toContain('transcribes voice messages');
+    expect(content).toContain('falls back when transcription returns null');
+    expect(content).toContain('falls back when transcription throws');
+    expect(content).toContain('[Voice: Hello this is a voice message]');
+  });
+
+  it('modified whatsapp.test.ts preserves all existing test sections', () => {
+    const content = fs.readFileSync(
+      path.join(skillDir, 'modify', 'src', 'channels', 'whatsapp.test.ts'),
+      'utf-8',
+    );
+
+    // All existing test describe blocks preserved
+    expect(content).toContain("describe('connection lifecycle'");
+    expect(content).toContain("describe('authentication'");
+    expect(content).toContain("describe('reconnection'");
+    expect(content).toContain("describe('message handling'");
+    expect(content).toContain("describe('LID to JID translation'");
+    expect(content).toContain("describe('outgoing message queue'");
+    expect(content).toContain("describe('group metadata sync'");
+    expect(content).toContain("describe('ownsJid'");
+    expect(content).toContain("describe('setTyping'");
+    expect(content).toContain("describe('channel properties'");
+  });
+});