deepgram-migration-deep-dive

# Deepgram Migration Deep Dive ## Current State !`npm list @deepgram/sdk 2>/dev/null | grep deepgram || echo 'Not installed'` !`npm list @aws-sdk/client-transcribe 2>/dev/null | grep transcribe || echo 'AWS Transcribe SDK not found'` !`pip show google-cloud-speech 2>/dev/null | grep Version || echo 'Google STT not found'` ## Overview Migrate to Deepgram from AWS Transcribe, Google Cloud Speech-to-Text, Azure Cognitive Services, or OpenAI Whisper. Uses an adapter pattern with a unified interface, parallel running for quality validation, percentage-based traffic shifting, and automated rollback. ## Feature Mapping ### AWS Transcribe -> Deepgram | AWS Transcribe | Deepgram | Notes | |----------------|----------|-------| | `LanguageCode: 'en-US'` | `language: 'en'` | ISO 639-1 (2-letter) | | `ShowSpeakerLabels: true` | `diarize: true` | Same feature, different param | | `VocabularyName: 'custom'` | `keywords: ['term:1.5']` | Inline boosting, no pre-upload | | `ContentRedactionType: 'PII'` | `redact: ['pci', 'ssn']` | Granular PII categories | | `OutputBucketName` | `callback: 'https://...'` | Callback URL, not S3 | | Job polling model | Sync response or callback | No polling needed | ### Google Cloud STT -> Deepgram | Google STT | Deepgram | Notes | |------------|----------|-------| | `RecognitionConfig.encoding` | Auto-detected | Deepgram auto-detects format | | `RecognitionConfig.sampleRateHertz` | `sample_rate` (live only) | REST auto-detects | | `RecognitionConfig.model:...