v3.0.0 - Automatic Optimization 🚀

🎉 Major Release: Automatic Optimization!

All files are now automatically optimized by default for faster processing and smaller uploads.

⚡ Performance Improvements

Based on real A/B testing with a 2.7GB, 22-minute video:

Method	File Size	Time	Result
Baseline	2767 MB	72s	Standard
Speed (1.2x)	12.8 MB	65.4s	9% faster, 99.5% smaller ✅
Opus	14.3 MB	86.8s	Smaller but slower

Winner: Speed Optimization - Now enabled by default!

🎯 What This Means for You

• 2.7GB video → 12.8MB upload: Upload in 10 seconds instead of 5 minutes
• 9% faster processing: 65s vs 72s
• 99.5% size reduction: Perfect for large video files
• Same cost: Still $0.006/min (charged on original duration)
• ~98% accuracy: Minimal quality impact
• Automatic timestamps: SRT files have correct original timing

🆕 What's New

Automatic Optimization (Breaking Change)

# Now optimized by default
transcribe video.mp4

# Disable with --raw flag
transcribe video.mp4 --raw

A/B Testing Suite

New test/ directory with full testing framework:

• Compare baseline vs optimized methods
• Generate performance reports
• Test new optimization strategies

Cursor Rules

Added .cursor/rules/ for better codebase navigation:

• Architecture overview
• Optimization strategy
• CLI patterns
• Testing framework
• More...

⚠️ Breaking Changes

• Optimization is now default: Files are automatically processed with 1.2x speed
• To use original audio, add --raw flag
• Programmatic API: optimize: true is now the default

📦 Migration Guide

v2.x behavior (original audio):

# Before
transcribe video.mp4

# Now
transcribe video.mp4 --raw

v3.x behavior (optimized audio - new default):

transcribe video.mp4  # Automatically optimized

🔗 Links

• 📦 NPM Package
• 📚 Documentation
• 🧪 A/B Test Results
• 🐛 Report Issues

---

Full Changelog: v2.0.0...v3.0.0