@caddis/cli 0.0.0 → 0.2.0

package/bundles/antigravity-plugin-extras/skills/word-cloud/references/shapes.md

@@ -0,0 +1,135 @@
+# Word Cloud — Shape Masking Reference
+
+All shapes are defined as SVG paths normalized to a 200×200 viewBox.
+Scale them to your canvas size using `transform="scale(W/200, H/200)"`.
+
+---
+
+## Circle (default)
+```svg
+<circle cx="100" cy="100" r="95" />
+```
+
+## Speech Bubble
+```svg
+<path d="M10,10 Q10,5 15,5 L185,5 Q190,5 190,10 L190,130 Q190,135 185,135 L120,135 L100,165 L80,135 L15,135 Q10,135 10,130 Z" />
+```
+
+## Star (5-point burst)
+```svg
+<polygon points="100,5 120,68 185,68 133,107 153,170 100,130 47,170 67,107 15,68 80,68" />
+```
+
+## Diamond
+```svg
+<polygon points="100,5 195,100 100,195 5,100" />
+```
+
+## Cloud Silhouette
+```svg
+<path d="M30,140 Q5,140 5,115 Q5,95 20,90 Q15,75 30,65 Q40,50 60,55 Q65,35 85,30 Q105,20 125,35 Q140,20 160,30 Q180,35 185,55 Q200,55 200,75 Q200,95 185,100 Q195,110 195,125 Q195,145 175,148 Q165,160 150,155 Q140,165 125,160 Q115,170 100,165 Q85,170 75,160 Q60,165 50,155 Q35,160 30,148 Z" />
+```
+
+## Heart
+```svg
+<path d="M100,175 L15,90 Q-10,60 20,35 Q50,10 80,40 L100,60 L120,40 Q150,10 180,35 Q210,60 185,90 Z" />
+```
+
+## Arrow (pointing right)
+```svg
+<polygon points="5,70 110,70 110,40 195,100 110,160 110,130 5,130" />
+```
+
+## Hexagon
+```svg
+<polygon points="100,5 185,50 185,150 100,195 15,150 15,50" />
+```
+
+---
+
+## Applying Shapes in React (SVG clipPath)
+
+```tsx
+const SHAPES: Record<string, string> = {
+  circle: 'M100,5 A95,95 0 1,1 99.9,5Z',
+  speech_bubble: 'M10,10 Q10,5 15,5 L185,5 Q190,5 190,10 L190,130 Q190,135 185,135 L120,135 L100,165 L80,135 L15,135 Q10,135 10,130 Z',
+  star: 'M100,5 L120,68 L185,68 L133,107 L153,170 L100,130 L47,170 L67,107 L15,68 L80,68 Z',
+  diamond: 'M100,5 L195,100 L100,195 L5,100 Z',
+  cloud: 'M30,140 Q5,140 5,115 Q5,95 20,90 ...',
+  heart: 'M100,175 L15,90 Q-10,60 20,35 Q50,10 80,40 L100,60 L120,40 Q150,10 180,35 Q210,60 185,90 Z',
+};
+
+// In your SVG:
+<defs>
+  <clipPath id="wc-shape">
+    <path
+      d={SHAPES[shape]}
+      transform={`scale(${dims.width / 200}, ${dims.height / 200})`}
+    />
+  </clipPath>
+</defs>
+<g clipPath="url(#wc-shape)" transform={`translate(${dims.width/2},${dims.height/2})`}>
+  {/* word <text> elements */}
+</g>
+```
+
+---
+
+## Applying Shapes in Python (wordcloud lib)
+
+```python
+from PIL import Image, ImageDraw
+import numpy as np
+
+def create_shape_mask(shape: str, width: int, height: int) -> np.ndarray:
+    """Create a binary mask for the given shape name."""
+    img = Image.new('L', (width, height), 0)  # black = blocked
+    draw = ImageDraw.Draw(img)
+    
+    if shape == 'circle':
+        draw.ellipse([10, 10, width-10, height-10], fill=255)
+    elif shape == 'diamond':
+        cx, cy = width//2, height//2
+        draw.polygon([(cx, 10), (width-10, cy), (cx, height-10), (10, cy)], fill=255)
+    elif shape == 'star':
+        import math
+        cx, cy = width//2, height//2
+        points = []
+        for i in range(10):
+            r = min(cx,cy)*0.9 if i%2==0 else min(cx,cy)*0.4
+            a = math.radians(i*36 - 90)
+            points.append((cx + r*math.cos(a), cy + r*math.sin(a)))
+        draw.polygon(points, fill=255)
+    else:
+        # Default: full rectangle
+        draw.rectangle([0, 0, width, height], fill=255)
+    
+    # wordcloud expects: white = word area, black = empty
+    arr = np.array(img)
+    # Invert: where white (255) → 0 (word area), where black (0) → 255 (no words)
+    return 255 - arr
+
+# Usage:
+mask = create_shape_mask('star', 900, 520)
+wc = WordCloud(mask=mask, background_color=None, mode='RGBA').generate_from_frequencies(freqs)
+```
+
+---
+
+## Custom SVG from User
+
+If the user provides a custom SVG path:
+1. Parse the `<path d="...">` attribute
+2. In React: use directly in `<clipPath>`
+3. In Python: rasterize with `cairosvg` → PIL Image → numpy mask
+
+```python
+import cairosvg
+from io import BytesIO
+
+def svg_path_to_mask(svg_path_d: str, width: int, height: int) -> np.ndarray:
+    svg = f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="{width}" height="{height}"><path d="{svg_path_d}" fill="white"/></svg>'
+    png = cairosvg.svg2png(bytestring=svg.encode())
+    img = Image.open(BytesIO(png)).convert('L')
+    return 255 - np.array(img)
+```

package/bundles/antigravity-plugin-extras/skills/word-cloud/references/stopwords.md

@@ -0,0 +1,115 @@
+# Stopwords — Word Cloud Reference
+
+Words that should be filtered out before computing frequencies.
+This list covers common English stopwords plus common document/presentation filler words.
+
+## JavaScript Set
+
+```js
+const STOPWORDS = new Set([
+  // Articles & prepositions
+  'a','an','the','of','in','on','at','to','for','by','with','from','into',
+  'through','during','before','after','above','below','between','out','off',
+  'over','under','again','then','once','here','there','when','where','why',
+  'how','all','both','each','few','more','most','other','some','such','no',
+  'nor','not','only','own','same','so','than','too','very','just','because',
+  'as','until','while','about','against','among','throughout','despite',
+  'towards','upon','concerning','regarding',
+  
+  // Conjunctions & pronouns
+  'and','but','or','nor','if','unless','since','although','though',
+  'however','therefore','thus','hence','whereas','meanwhile',
+  'i','me','my','myself','we','our','ours','ourselves','you','your',
+  'yours','yourself','he','him','his','himself','she','her','hers',
+  'herself','it','its','itself','they','them','their','theirs',
+  'themselves','what','which','who','whom','this','that','these','those',
+  
+  // Common verbs (auxiliary + linking)
+  'am','is','are','was','were','be','been','being',
+  'have','has','had','having','do','does','did','doing',
+  'will','would','could','should','shall','may','might','must','can',
+  'need','dare','ought','used',
+  
+  // Common adverbs & filler
+  'also','already','always','never','often','sometimes','usually','still',
+  'even','ever','now','then','soon','later','today','yesterday','tomorrow',
+  'here','there','away','back','forward','up','down','well','much','many',
+  'any','every','another','either','neither','whether','quite','rather',
+  'almost','enough','yet','else','instead','perhaps','maybe','certainly',
+  'simply','actually','really','truly','however','therefore','although',
+  'though','despite','whereas','meanwhile','since','unless','until',
+  
+  // Numbers (spelled out)
+  'one','two','three','four','five','six','seven','eight','nine','ten',
+  'first','second','third','fourth','fifth','last','next','previous',
+  
+  // Business/presentation filler
+  'slide','page','section','chapter','figure','table','example','note',
+  'please','thank','thanks','dear','regards','sincerely','best',
+  'company','companies','organization','team','teams','group','groups',
+  'year','years','month','months','day','days','time','times','date',
+  'etc','ie','eg','vs','per','new','old','said','says','see','get','got',
+  'make','made','take','took','use','used','come','came','go','went',
+  'know','knew','think','thought','want','wanted','need','needed',
+  'feel','felt','look','looks','looking','put','puts','set','sets',
+  'keep','kept','give','gave','given','show','shows','shown',
+]);
+```
+
+---
+
+## Python Set
+
+```python
+STOPWORDS_EN = {
+    # Articles & prepositions
+    'a','an','the','of','in','on','at','to','for','by','with','from','into',
+    'through','during','before','after','above','below','between','out','off',
+    'over','under','again','then','once','here','there','when','where','why',
+    'how','all','both','each','few','more','most','other','some','such','no',
+    'nor','not','only','own','same','so','than','too','very','just','because',
+    'as','until','while','about','against','among',
+    # Pronouns
+    'i','me','my','we','our','you','your','he','him','his','she','her',
+    'it','its','they','them','their','who','what','which','this','that',
+    'these','those','myself','yourself','himself','herself','itself',
+    'ourselves','themselves',
+    # Auxiliaries
+    'am','is','are','was','were','be','been','being',
+    'have','has','had','do','does','did','will','would','could','should',
+    'shall','may','might','must','can','need','ought',
+    # Common filler
+    'also','always','never','often','still','even','now','well','much',
+    'many','any','every','another','quite','rather','almost','enough',
+    'yet','else','perhaps','maybe','simply','actually','really','truly',
+    # Numbers
+    'one','two','three','four','five','six','seven','eight','nine','ten',
+    'first','second','third','fourth','fifth','last','next',
+    # Business filler
+    'slide','page','section','chapter','figure','table','example','note',
+    'please','thank','thanks','company','team','year','month','day','time',
+    'etc','new','old','said','see','get','make','take','use','come','go',
+    'know','think','want','need','feel','look','put','set','keep','give','show',
+}
+
+# Combine with wordcloud's built-in stopwords:
+from wordcloud import STOPWORDS as WC_STOPS
+ALL_STOPS = STOPWORDS_EN | WC_STOPS
+```
+
+---
+
+## Custom Domain Stopwords
+
+For specific document types, extend with domain words:
+
+```js
+// Legal documents
+const LEGAL_STOPS = new Set(['shall','herein','thereof','pursuant','whereas','hereby']);
+
+// Financial reports
+const FINANCE_STOPS = new Set(['quarter','fiscal','annual','report','million','billion','percent']);
+
+// Technical docs
+const TECH_STOPS = new Set(['click','select','navigate','following','below','above','shown']);
+```

package/bundles/antigravity-plugin-extras/skills/youtube-transcript/SKILL.md

@@ -0,0 +1,416 @@
+---
+name: youtube-transcript
+context: fork
+description: Download YouTube video transcripts when user provides a YouTube URL or asks to download/get/fetch a transcript from YouTube. Also use when user wants to transcribe or get captions/subtitles from a YouTube video.
+allowed-tools: Bash,Read,Write
+---
+
+# YouTube Transcript Downloader
+
+This skill helps download transcripts (subtitles/captions) from YouTube videos using yt-dlp.
+
+## When to Use This Skill
+
+Activate this skill when the user:
+- Provides a YouTube URL and wants the transcript
+- Asks to "download transcript from YouTube"
+- Wants to "get captions" or "get subtitles" from a video
+- Asks to "transcribe a YouTube video"
+- Needs text content from a YouTube video
+
+## How It Works
+
+### Priority Order:
+1. **Check if yt-dlp is installed** - install if needed
+2. **List available subtitles** - see what's actually available
+3. **Try manual subtitles first** (`--write-sub`) - highest quality
+4. **Fallback to auto-generated** (`--write-auto-sub`) - usually available
+5. **Last resort: Whisper transcription** - if no subtitles exist (requires user confirmation)
+6. **Confirm the download** and show the user where the file is saved
+7. **Optionally clean up** the VTT format if the user wants plain text
+
+## Installation Check
+
+**IMPORTANT**: Always check if yt-dlp is installed first:
+
+```bash
+which yt-dlp || command -v yt-dlp
+```
+
+### If Not Installed
+
+Attempt automatic installation based on the system:
+
+**macOS (Homebrew)**:
+```bash
+brew install yt-dlp
+```
+
+**Linux (apt/Debian/Ubuntu)**:
+```bash
+sudo apt update && sudo apt install -y yt-dlp
+```
+
+**Alternative (pip - works on all systems)**:
+```bash
+pip3 install yt-dlp
+# or
+python3 -m pip install yt-dlp
+```
+
+**If installation fails**: Inform the user they need to install yt-dlp manually and provide them with installation instructions from https://github.com/yt-dlp/yt-dlp#installation
+
+## Check Available Subtitles
+
+**ALWAYS do this first** before attempting to download:
+
+```bash
+yt-dlp --list-subs "YOUTUBE_URL"
+```
+
+This shows what subtitle types are available without downloading anything. Look for:
+- Manual subtitles (better quality)
+- Auto-generated subtitles (usually available)
+- Available languages
+
+## Download Strategy
+
+### Option 1: Manual Subtitles (Preferred)
+
+Try this first - highest quality, human-created:
+
+```bash
+yt-dlp --write-sub --skip-download --output "OUTPUT_NAME" "YOUTUBE_URL"
+```
+
+### Option 2: Auto-Generated Subtitles (Fallback)
+
+If manual subtitles aren't available:
+
+```bash
+yt-dlp --write-auto-sub --skip-download --output "OUTPUT_NAME" "YOUTUBE_URL"
+```
+
+Both commands create a `.vtt` file (WebVTT subtitle format).
+
+## Option 3: Whisper Transcription (Last Resort)
+
+**ONLY use this if both manual and auto-generated subtitles are unavailable.**
+
+### Step 1: Show File Size and Ask for Confirmation
+
+```bash
+# Get audio file size estimate
+yt-dlp --print "%(filesize,filesize_approx)s" -f "bestaudio" "YOUTUBE_URL"
+
+# Or get duration to estimate
+yt-dlp --print "%(duration)s %(title)s" "YOUTUBE_URL"
+```
+
+**IMPORTANT**: Display the file size to the user and ask: "No subtitles are available. I can download the audio (approximately X MB) and transcribe it using Whisper. Would you like to proceed?"
+
+**Wait for user confirmation before continuing.**
+
+### Step 2: Check for Whisper Installation
+
+```bash
+command -v whisper
+```
+
+If not installed, ask user: "Whisper is not installed. Install it with `pip install openai-whisper` (requires ~1-3GB for models)? This is a one-time installation."
+
+**Wait for user confirmation before installing.**
+
+Install if approved:
+```bash
+pip3 install openai-whisper
+```
+
+### Step 3: Download Audio Only
+
+```bash
+yt-dlp -x --audio-format mp3 --output "audio_%(id)s.%(ext)s" "YOUTUBE_URL"
+```
+
+### Step 4: Transcribe with Whisper
+
+```bash
+# Auto-detect language (recommended)
+whisper audio_VIDEO_ID.mp3 --model base --output_format vtt
+
+# Or specify language if known
+whisper audio_VIDEO_ID.mp3 --model base --language en --output_format vtt
+```
+
+**Model Options** (stick to `base` for now):
+- `tiny` - fastest, least accurate (~1GB)
+- `base` - good balance (~1GB) ← **USE THIS**
+- `small` - better accuracy (~2GB)
+- `medium` - very good (~5GB)
+- `large` - best accuracy (~10GB)
+
+### Step 5: Cleanup
+
+After transcription completes, ask user: "Transcription complete! Would you like me to delete the audio file to save space?"
+
+If yes:
+```bash
+rm audio_VIDEO_ID.mp3
+```
+
+## Getting Video Information
+
+### Extract Video Title (for filename)
+
+```bash
+yt-dlp --print "%(title)s" "YOUTUBE_URL"
+```
+
+Use this to create meaningful filenames based on the video title. Clean the title for filesystem compatibility:
+- Replace `/` with `-`
+- Replace special characters that might cause issues
+- Consider using sanitized version: `$(yt-dlp --print "%(title)s" "URL" | tr '/' '-' | tr ':' '-')`
+
+## Post-Processing
+
+### Convert to Plain Text (Recommended)
+
+YouTube's auto-generated VTT files contain **duplicate lines** because captions are shown progressively with overlapping timestamps. Always deduplicate when converting to plain text while preserving the original speaking order.
+
+```bash
+python3 -c "
+import sys, re
+seen = set()
+with open('transcript.en.vtt', 'r') as f:
+    for line in f:
+        line = line.strip()
+        if line and not line.startswith('WEBVTT') and not line.startswith('Kind:') and not line.startswith('Language:') and '-->' not in line:
+            clean = re.sub('<[^>]*>', '', line)
+            clean = clean.replace('&amp;', '&').replace('&gt;', '>').replace('&lt;', '<')
+            if clean and clean not in seen:
+                print(clean)
+                seen.add(clean)
+" > transcript.txt
+```
+
+### Complete Post-Processing with Video Title
+
+```bash
+# Get video title
+VIDEO_TITLE=$(yt-dlp --print "%(title)s" "YOUTUBE_URL" | tr '/' '_' | tr ':' '-' | tr '?' '' | tr '"' '')
+
+# Find the VTT file
+VTT_FILE=$(ls *.vtt | head -n 1)
+
+# Convert with deduplication
+python3 -c "
+import sys, re
+seen = set()
+with open('$VTT_FILE', 'r') as f:
+    for line in f:
+        line = line.strip()
+        if line and not line.startswith('WEBVTT') and not line.startswith('Kind:') and not line.startswith('Language:') and '-->' not in line:
+            clean = re.sub('<[^>]*>', '', line)
+            clean = clean.replace('&amp;', '&').replace('&gt;', '>').replace('&lt;', '<')
+            if clean and clean not in seen:
+                print(clean)
+                seen.add(clean)
+" > "${VIDEO_TITLE}.txt"
+
+echo "✓ Saved to: ${VIDEO_TITLE}.txt"
+
+# Clean up VTT file
+rm "$VTT_FILE"
+echo "✓ Cleaned up temporary VTT file"
+```
+
+## Output Formats
+
+- **VTT format** (`.vtt`): Includes timestamps and formatting, good for video players
+- **Plain text** (`.txt`): Just the text content, good for reading or analysis
+
+## Tips
+
+- The filename will be `{output_name}.{language_code}.vtt` (e.g., `transcript.en.vtt`)
+- Most YouTube videos have auto-generated English subtitles
+- Some videos may have multiple language options
+- If auto-subtitles aren't available, try `--write-sub` instead for manual subtitles
+
+## Complete Workflow Example
+
+```bash
+VIDEO_URL="https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+
+# Get video title for filename
+VIDEO_TITLE=$(yt-dlp --print "%(title)s" "$VIDEO_URL" | tr '/' '_' | tr ':' '-' | tr '?' '' | tr '"' '')
+OUTPUT_NAME="transcript_temp"
+
+# ============================================
+# STEP 1: Check if yt-dlp is installed
+# ============================================
+if ! command -v yt-dlp &> /dev/null; then
+    echo "yt-dlp not found, attempting to install..."
+    if command -v brew &> /dev/null; then
+        brew install yt-dlp
+    elif command -v apt &> /dev/null; then
+        sudo apt update && sudo apt install -y yt-dlp
+    else
+        pip3 install yt-dlp
+    fi
+fi
+
+# ============================================
+# STEP 2: List available subtitles
+# ============================================
+echo "Checking available subtitles..."
+yt-dlp --list-subs "$VIDEO_URL"
+
+# ============================================
+# STEP 3: Try manual subtitles first
+# ============================================
+echo "Attempting to download manual subtitles..."
+if yt-dlp --write-sub --skip-download --output "$OUTPUT_NAME" "$VIDEO_URL" 2>/dev/null; then
+    echo "✓ Manual subtitles downloaded successfully!"
+    ls -lh ${OUTPUT_NAME}.*
+else
+    # ============================================
+    # STEP 4: Fallback to auto-generated
+    # ============================================
+    echo "Manual subtitles not available. Trying auto-generated..."
+    if yt-dlp --write-auto-sub --skip-download --output "$OUTPUT_NAME" "$VIDEO_URL" 2>/dev/null; then
+        echo "✓ Auto-generated subtitles downloaded successfully!"
+        ls -lh ${OUTPUT_NAME}.*
+    else
+        # ============================================
+        # STEP 5: Last resort - Whisper transcription
+        # ============================================
+        echo "⚠ No subtitles available for this video."
+
+        # Get file size
+        FILE_SIZE=$(yt-dlp --print "%(filesize_approx)s" -f "bestaudio" "$VIDEO_URL")
+        DURATION=$(yt-dlp --print "%(duration)s" "$VIDEO_URL")
+        TITLE=$(yt-dlp --print "%(title)s" "$VIDEO_URL")
+
+        echo "Video: $TITLE"
+        echo "Duration: $((DURATION / 60)) minutes"
+        echo "Audio size: ~$((FILE_SIZE / 1024 / 1024)) MB"
+        echo ""
+        echo "Would you like to download and transcribe with Whisper? (y/n)"
+        read -r RESPONSE
+
+        if [[ "$RESPONSE" =~ ^[Yy]$ ]]; then
+            # Check for Whisper
+            if ! command -v whisper &> /dev/null; then
+                echo "Whisper not installed. Install now? (requires ~1-3GB) (y/n)"
+                read -r INSTALL_RESPONSE
+                if [[ "$INSTALL_RESPONSE" =~ ^[Yy]$ ]]; then
+                    pip3 install openai-whisper
+                else
+                    echo "Cannot proceed without Whisper. Exiting."
+                    exit 1
+                fi
+            fi
+
+            # Download audio
+            echo "Downloading audio..."
+            yt-dlp -x --audio-format mp3 --output "audio_%(id)s.%(ext)s" "$VIDEO_URL"
+
+            # Get the actual audio filename
+            AUDIO_FILE=$(ls audio_*.mp3 | head -n 1)
+
+            # Transcribe
+            echo "Transcribing with Whisper (this may take a few minutes)..."
+            whisper "$AUDIO_FILE" --model base --output_format vtt
+
+            # Cleanup
+            echo "Transcription complete! Delete audio file? (y/n)"
+            read -r CLEANUP_RESPONSE
+            if [[ "$CLEANUP_RESPONSE" =~ ^[Yy]$ ]]; then
+                rm "$AUDIO_FILE"
+                echo "Audio file deleted."
+            fi
+
+            ls -lh *.vtt
+        else
+            echo "Transcription cancelled."
+            exit 0
+        fi
+    fi
+fi
+
+# ============================================
+# STEP 6: Convert to readable plain text with deduplication
+# ============================================
+VTT_FILE=$(ls ${OUTPUT_NAME}*.vtt 2>/dev/null || ls *.vtt | head -n 1)
+if [ -f "$VTT_FILE" ]; then
+    echo "Converting to readable format and removing duplicates..."
+    python3 -c "
+import sys, re
+seen = set()
+with open('$VTT_FILE', 'r') as f:
+    for line in f:
+        line = line.strip()
+        if line and not line.startswith('WEBVTT') and not line.startswith('Kind:') and not line.startswith('Language:') and '-->' not in line:
+            clean = re.sub('<[^>]*>', '', line)
+            clean = clean.replace('&amp;', '&').replace('&gt;', '>').replace('&lt;', '<')
+            if clean and clean not in seen:
+                print(clean)
+                seen.add(clean)
+" > "${VIDEO_TITLE}.txt"
+    echo "✓ Saved to: ${VIDEO_TITLE}.txt"
+
+    # Clean up temporary VTT file
+    rm "$VTT_FILE"
+    echo "✓ Cleaned up temporary VTT file"
+else
+    echo "⚠ No VTT file found to convert"
+fi
+
+echo "✓ Complete!"
+```
+
+**Note**: This complete workflow handles all scenarios with proper error checking and user prompts at each decision point.
+
+## Error Handling
+
+### Common Issues and Solutions:
+
+**1. yt-dlp not installed**
+- Attempt automatic installation based on system (Homebrew/apt/pip)
+- If installation fails, provide manual installation link
+- Verify installation before proceeding
+
+**2. No subtitles available**
+- List available subtitles first to confirm
+- Try both `--write-sub` and `--write-auto-sub`
+- If both fail, offer Whisper transcription option
+- Show file size and ask for user confirmation before downloading audio
+
+**3. Invalid or private video**
+- Check if URL is correct format: `https://www.youtube.com/watch?v=VIDEO_ID`
+- Some videos may be private, age-restricted, or geo-blocked
+- Inform user of the specific error from yt-dlp
+
+**4. Whisper installation fails**
+- May require system dependencies (ffmpeg, rust)
+- Provide fallback: "Install manually with: `pip3 install openai-whisper`"
+- Check available disk space (models require 1-10GB depending on size)
+
+**5. Download interrupted or failed**
+- Check internet connection
+- Verify sufficient disk space
+- Try again with `--no-check-certificate` if SSL issues occur
+
+**6. Multiple subtitle languages**
+- By default, yt-dlp downloads all available languages
+- Can specify with `--sub-langs en` for English only
+- List available with `--list-subs` first
+
+### Best Practices:
+
+- ✅ Always check what's available before attempting download (`--list-subs`)
+- ✅ Verify success at each step before proceeding to next
+- ✅ Ask user before large downloads (audio files, Whisper models)
+- ✅ Clean up temporary files after processing
+- ✅ Provide clear feedback about what's happening at each stage
+- ✅ Handle errors gracefully with helpful messages

package/bundles/manifest.json

@@ -0,0 +1,7 @@
+{
+  "poolVersion": "1.3.39",
+  "bundles": {
+    "antigravity-plugin": "1.3.39",
+    "antigravity-plugin-extras": "1.3.13"
+  }
+}