@su-record/vibe 2.9.18 → 2.9.20

package/skills/video-production/SKILL.md

@@ -1,52 +1,52 @@
----
-name: video-production
-tier: standard
-description: "Video processing gotchas — FFmpeg commands, transcoding pipelines, HLS/DASH streaming setup, subtitle embedding (SRT/VTT), and thumbnail extraction. Use when the project involves any video manipulation, media processing, or streaming infrastructure. Covers codec selection, bitrate optimization, and common FFmpeg pitfalls. Must use this skill when user works with video files, mentions FFmpeg, or needs media processing — even for simple tasks like 'generate a thumbnail'."
-triggers: [video, ffmpeg, transcode, encode, stream, media, subtitle, thumbnail, hls, dash]
-priority: 60
----
-
-# Video Production
-
-## Pre-check (K1)
-
-> Are you processing video files programmatically? If just embedding a YouTube/Vimeo player, this skill is not needed.
-
-## Gotchas
-
-| Gotcha | Consequence | Prevention |
-|--------|-------------|------------|
-| Direct CLI string concatenation | Command injection risk | Always use wrapper library (fluent-ffmpeg for TS, ffmpeg-python for Python) |
-| No input validation | Crash on corrupted files | Always `ffprobe` input before processing — check codec, resolution, duration |
-| No temp file cleanup | Disk fills up silently | `try/finally` or cleanup handler — never leave partial outputs |
-| No progress callback | Long encoding appears frozen | Implement progress events for any operation >10s |
-| Memory loading large files | OOM on 4K+ video | Use streaming I/O, never read entire file into memory |
-| Assuming codec availability | Fails on different FFmpeg builds | Check `ffmpeg -codecs` at runtime before encoding |
-| Fixed bitrate encoding | Inconsistent quality | Use CRF-based quality (18-28 for H.264) instead |
-| No timeout | Encoding hangs forever | Set timeout + kill process on expiry |
-
-## Codec Quick Reference
-
-| Use Case | Codec | Note |
-|----------|-------|------|
-| Maximum compatibility | H.264 (libx264) | CRF 23 default |
-| Smaller files | H.265 (libx265) | 50% smaller, slower, licensing issues |
-| Open source | VP9 (libvpx-vp9) | Good for WebM |
-| Best compression | AV1 (libaom-av1) | Very slow encoding |
-
-## Resolution Presets
-
-| Preset | Resolution | Bitrate (H.264) |
-|--------|-----------|-----------------|
-| 360p | 640x360 | 800 kbps |
-| 720p | 1280x720 | 3 Mbps |
-| 1080p | 1920x1080 | 6 Mbps |
-| 4K | 3840x2160 | 15 Mbps |
-
-## Done Criteria (K4)
-
-- [ ] All FFmpeg calls go through wrapper library (no raw CLI strings)
-- [ ] Input files validated with ffprobe before processing
-- [ ] Temp files cleaned up in all paths (success + error)
-- [ ] Progress reporting for long operations
-- [ ] Codec availability checked at runtime
+---
+name: video-production
+tier: standard
+description: "Video processing gotchas — FFmpeg commands, transcoding pipelines, HLS/DASH streaming setup, subtitle embedding (SRT/VTT), and thumbnail extraction. Use when the project involves any video manipulation, media processing, or streaming infrastructure. Covers codec selection, bitrate optimization, and common FFmpeg pitfalls. Must use this skill when user works with video files, mentions FFmpeg, or needs media processing — even for simple tasks like 'generate a thumbnail'."
+triggers: [video, ffmpeg, transcode, encode, stream, media, subtitle, thumbnail, hls, dash]
+priority: 60
+---
+
+# Video Production
+
+## Pre-check (K1)
+
+> Are you processing video files programmatically? If just embedding a YouTube/Vimeo player, this skill is not needed.
+
+## Gotchas
+
+| Gotcha | Consequence | Prevention |
+|--------|-------------|------------|
+| Direct CLI string concatenation | Command injection risk | Always use wrapper library (fluent-ffmpeg for TS, ffmpeg-python for Python) |
+| No input validation | Crash on corrupted files | Always `ffprobe` input before processing — check codec, resolution, duration |
+| No temp file cleanup | Disk fills up silently | `try/finally` or cleanup handler — never leave partial outputs |
+| No progress callback | Long encoding appears frozen | Implement progress events for any operation >10s |
+| Memory loading large files | OOM on 4K+ video | Use streaming I/O, never read entire file into memory |
+| Assuming codec availability | Fails on different FFmpeg builds | Check `ffmpeg -codecs` at runtime before encoding |
+| Fixed bitrate encoding | Inconsistent quality | Use CRF-based quality (18-28 for H.264) instead |
+| No timeout | Encoding hangs forever | Set timeout + kill process on expiry |
+
+## Codec Quick Reference
+
+| Use Case | Codec | Note |
+|----------|-------|------|
+| Maximum compatibility | H.264 (libx264) | CRF 23 default |
+| Smaller files | H.265 (libx265) | 50% smaller, slower, licensing issues |
+| Open source | VP9 (libvpx-vp9) | Good for WebM |
+| Best compression | AV1 (libaom-av1) | Very slow encoding |
+
+## Resolution Presets
+
+| Preset | Resolution | Bitrate (H.264) |
+|--------|-----------|-----------------|
+| 360p | 640x360 | 800 kbps |
+| 720p | 1280x720 | 3 Mbps |
+| 1080p | 1920x1080 | 6 Mbps |
+| 4K | 3840x2160 | 15 Mbps |
+
+## Done Criteria (K4)
+
+- [ ] All FFmpeg calls go through wrapper library (no raw CLI strings)
+- [ ] Input files validated with ffprobe before processing
+- [ ] Temp files cleaned up in all paths (success + error)
+- [ ] Progress reporting for long operations
+- [ ] Codec availability checked at runtime

package/skills/video-production/rubrics/quality-checklist.md

@@ -1,58 +1,58 @@
-# Video Quality Checklist
-
-## Pre-Processing
-
-- [ ] Input file exists and is readable before pipeline starts
-- [ ] `ffprobe` run on input — codec, resolution, duration, bitrate logged
-- [ ] Corrupted/truncated files rejected with clear error (not crash)
-- [ ] Input resolution within supported range (min 360p, max 4K)
-- [ ] Audio stream present — handle gracefully if missing
-
-## Encoding
-
-- [ ] CRF-based encoding used (not fixed bitrate) for consistent visual quality
-- [ ] Target codec available in current FFmpeg build (`ffmpeg -codecs` check)
-- [ ] Encoding runs through wrapper library — no raw CLI string concatenation
-- [ ] `-movflags +faststart` set for MP4 (enables streaming before full download)
-- [ ] Audio normalized: loudness target -16 LUFS (streaming standard)
-- [ ] Aspect ratio preserved — no unintended stretching
-
-## Progress & Monitoring
-
-- [ ] Progress events emitted for any operation exceeding 10 seconds
-- [ ] Encoding timeout configured — process killed on expiry
-- [ ] Estimated time remaining shown in progress (based on bitrate processed)
-
-## Output Validation
-
-- [ ] Output file exists after encoding completes
-- [ ] Output duration verified: within ±2 seconds of input
-- [ ] Output codec matches requested codec (re-run ffprobe on output)
-- [ ] Output file size within acceptable range (flag if >3x input size)
-- [ ] Thumbnail: correct dimensions, not blank/corrupted
-
-## Subtitles (if applicable)
-
-- [ ] Subtitle file encoding is UTF-8 (convert if needed)
-- [ ] Subtitle timing verified — first/last cue in range of video duration
-- [ ] Burn-in subtitles visually tested on dark and light scenes
-
-## HLS / DASH Streaming (if applicable)
-
-- [ ] `.m3u8` manifest references correct segment file names
-- [ ] All segment files present in output directory
-- [ ] Segment duration consistent (target ±1 second of configured value)
-- [ ] CORS headers configured on media server
-
-## Storage & Cleanup
-
-- [ ] Temp directory cleaned in `finally` block — both success and error paths
-- [ ] No partial output files left on disk after failure
-- [ ] Output written to separate directory from temp files
-- [ ] Disk space checked before processing large files (minimum 3x input size free)
-
-## Security
-
-- [ ] Input file path sanitized — no directory traversal (`../`)
-- [ ] FFmpeg invoked via array arguments (not shell string) to prevent injection
-- [ ] Max file size limit enforced before processing begins
+# Video Quality Checklist
+
+## Pre-Processing
+
+- [ ] Input file exists and is readable before pipeline starts
+- [ ] `ffprobe` run on input — codec, resolution, duration, bitrate logged
+- [ ] Corrupted/truncated files rejected with clear error (not crash)
+- [ ] Input resolution within supported range (min 360p, max 4K)
+- [ ] Audio stream present — handle gracefully if missing
+
+## Encoding
+
+- [ ] CRF-based encoding used (not fixed bitrate) for consistent visual quality
+- [ ] Target codec available in current FFmpeg build (`ffmpeg -codecs` check)
+- [ ] Encoding runs through wrapper library — no raw CLI string concatenation
+- [ ] `-movflags +faststart` set for MP4 (enables streaming before full download)
+- [ ] Audio normalized: loudness target -16 LUFS (streaming standard)
+- [ ] Aspect ratio preserved — no unintended stretching
+
+## Progress & Monitoring
+
+- [ ] Progress events emitted for any operation exceeding 10 seconds
+- [ ] Encoding timeout configured — process killed on expiry
+- [ ] Estimated time remaining shown in progress (based on bitrate processed)
+
+## Output Validation
+
+- [ ] Output file exists after encoding completes
+- [ ] Output duration verified: within ±2 seconds of input
+- [ ] Output codec matches requested codec (re-run ffprobe on output)
+- [ ] Output file size within acceptable range (flag if >3x input size)
+- [ ] Thumbnail: correct dimensions, not blank/corrupted
+
+## Subtitles (if applicable)
+
+- [ ] Subtitle file encoding is UTF-8 (convert if needed)
+- [ ] Subtitle timing verified — first/last cue in range of video duration
+- [ ] Burn-in subtitles visually tested on dark and light scenes
+
+## HLS / DASH Streaming (if applicable)
+
+- [ ] `.m3u8` manifest references correct segment file names
+- [ ] All segment files present in output directory
+- [ ] Segment duration consistent (target ±1 second of configured value)
+- [ ] CORS headers configured on media server
+
+## Storage & Cleanup
+
+- [ ] Temp directory cleaned in `finally` block — both success and error paths
+- [ ] No partial output files left on disk after failure
+- [ ] Output written to separate directory from temp files
+- [ ] Disk space checked before processing large files (minimum 3x input size free)
+
+## Security
+
+- [ ] Input file path sanitized — no directory traversal (`../`)
+- [ ] FFmpeg invoked via array arguments (not shell string) to prevent injection
+- [ ] Max file size limit enforced before processing begins

package/skills/video-production/templates/production-plan.md

@@ -1,104 +1,104 @@
-# Video Production Plan Template
-
-## Project Overview
-
-| Field | Value |
-|-------|-------|
-| Project Name | {{PROJECT_NAME}} |
-| Output Format | {{FORMAT}} (e.g., HLS, MP4, WebM) |
-| Target Resolution | {{RESOLUTION}} (e.g., 1080p) |
-| Target Codec | {{CODEC}} (e.g., H.264 / libx264) |
-| Duration (approx.) | {{DURATION}} |
-| Deadline | {{DEADLINE}} |
-
-## Input Sources
-
-| Source File | Format | Resolution | Duration | Notes |
-|-------------|--------|------------|----------|-------|
-| {{INPUT_FILE_1}} | {{FORMAT}} | {{RES}} | {{DUR}} | {{NOTES}} |
-
-Run `ffprobe -v quiet -print_format json -show_streams {{INPUT_FILE}}` to populate this table.
-
-## Processing Pipeline
-
-```
-Input Validation (ffprobe)
-  ↓
-Pre-processing (trim / deinterlace / normalize audio)
-  ↓
-Transcoding ({{CODEC}}, CRF {{CRF_VALUE}})
-  ↓
-Post-processing (subtitles / thumbnail extraction / HLS segmentation)
-  ↓
-Output Validation (verify duration, codec, bitrate)
-  ↓
-Cleanup (remove temp files)
-```
-
-## Encoding Parameters
-
-```bash
-# Replace placeholders before running
-ffmpeg \
-  -i "{{INPUT_FILE}}" \
-  -c:v {{VIDEO_CODEC}} \
-  -crf {{CRF_VALUE}} \
-  -preset {{PRESET}} \
-  -c:a aac -b:a 128k \
-  -movflags +faststart \
-  -progress pipe:1 \
-  "{{OUTPUT_FILE}}"
-```
-
-| Parameter | Value | Rationale |
-|-----------|-------|-----------|
-| Codec | {{VIDEO_CODEC}} | {{CODEC_RATIONALE}} |
-| CRF | {{CRF_VALUE}} | 18-23 = high quality, 24-28 = balanced |
-| Preset | {{PRESET}} | `slow` = better compression, `fast` = faster encoding |
-| Audio | AAC 128k | Universal compatibility |
-
-## Subtitles
-
-- [ ] Subtitle file: `{{SUBTITLE_FILE}}` (SRT / VTT)
-- [ ] Burn-in (hardcoded) or soft subtitle track: {{SUBTITLE_TYPE}}
-- [ ] Language code: `{{LANG_CODE}}`
-
-## Thumbnail Extraction
-
-```bash
-# Extract frame at {{TIMESTAMP}} seconds
-ffmpeg -i "{{INPUT_FILE}}" -ss {{TIMESTAMP}} -frames:v 1 "{{THUMBNAIL_OUTPUT}}"
-```
-
-## HLS Output (if streaming)
-
-```bash
-ffmpeg -i "{{INPUT_FILE}}" \
-  -codec: copy \
-  -start_number 0 \
-  -hls_time 10 \
-  -hls_list_size 0 \
-  -f hls \
-  "{{HLS_OUTPUT_DIR}}/stream.m3u8"
-```
-
-## Quality Gates
-
-- [ ] Input validated with ffprobe before processing starts
-- [ ] Progress callback implemented (log every 10 seconds)
-- [ ] Timeout set: {{TIMEOUT_SECONDS}}s
-- [ ] Output file size within expected range: {{MIN_SIZE}}–{{MAX_SIZE}} MB
-- [ ] Output duration matches input: ±2 seconds tolerance
-- [ ] Temp files cleaned on success AND error
-
-## Temp File Management
-
-```
-temp/
-├── {{JOB_ID}}_input_validated.{{EXT}}
-├── {{JOB_ID}}_preprocessed.{{EXT}}
-└── (cleaned up in finally block)
-
-output/
-└── {{JOB_ID}}_final.{{EXT}}
-```
+# Video Production Plan Template
+
+## Project Overview
+
+| Field | Value |
+|-------|-------|
+| Project Name | {{PROJECT_NAME}} |
+| Output Format | {{FORMAT}} (e.g., HLS, MP4, WebM) |
+| Target Resolution | {{RESOLUTION}} (e.g., 1080p) |
+| Target Codec | {{CODEC}} (e.g., H.264 / libx264) |
+| Duration (approx.) | {{DURATION}} |
+| Deadline | {{DEADLINE}} |
+
+## Input Sources
+
+| Source File | Format | Resolution | Duration | Notes |
+|-------------|--------|------------|----------|-------|
+| {{INPUT_FILE_1}} | {{FORMAT}} | {{RES}} | {{DUR}} | {{NOTES}} |
+
+Run `ffprobe -v quiet -print_format json -show_streams {{INPUT_FILE}}` to populate this table.
+
+## Processing Pipeline
+
+```
+Input Validation (ffprobe)
+  ↓
+Pre-processing (trim / deinterlace / normalize audio)
+  ↓
+Transcoding ({{CODEC}}, CRF {{CRF_VALUE}})
+  ↓
+Post-processing (subtitles / thumbnail extraction / HLS segmentation)
+  ↓
+Output Validation (verify duration, codec, bitrate)
+  ↓
+Cleanup (remove temp files)
+```
+
+## Encoding Parameters
+
+```bash
+# Replace placeholders before running
+ffmpeg \
+  -i "{{INPUT_FILE}}" \
+  -c:v {{VIDEO_CODEC}} \
+  -crf {{CRF_VALUE}} \
+  -preset {{PRESET}} \
+  -c:a aac -b:a 128k \
+  -movflags +faststart \
+  -progress pipe:1 \
+  "{{OUTPUT_FILE}}"
+```
+
+| Parameter | Value | Rationale |
+|-----------|-------|-----------|
+| Codec | {{VIDEO_CODEC}} | {{CODEC_RATIONALE}} |
+| CRF | {{CRF_VALUE}} | 18-23 = high quality, 24-28 = balanced |
+| Preset | {{PRESET}} | `slow` = better compression, `fast` = faster encoding |
+| Audio | AAC 128k | Universal compatibility |
+
+## Subtitles
+
+- [ ] Subtitle file: `{{SUBTITLE_FILE}}` (SRT / VTT)
+- [ ] Burn-in (hardcoded) or soft subtitle track: {{SUBTITLE_TYPE}}
+- [ ] Language code: `{{LANG_CODE}}`
+
+## Thumbnail Extraction
+
+```bash
+# Extract frame at {{TIMESTAMP}} seconds
+ffmpeg -i "{{INPUT_FILE}}" -ss {{TIMESTAMP}} -frames:v 1 "{{THUMBNAIL_OUTPUT}}"
+```
+
+## HLS Output (if streaming)
+
+```bash
+ffmpeg -i "{{INPUT_FILE}}" \
+  -codec: copy \
+  -start_number 0 \
+  -hls_time 10 \
+  -hls_list_size 0 \
+  -f hls \
+  "{{HLS_OUTPUT_DIR}}/stream.m3u8"
+```
+
+## Quality Gates
+
+- [ ] Input validated with ffprobe before processing starts
+- [ ] Progress callback implemented (log every 10 seconds)
+- [ ] Timeout set: {{TIMEOUT_SECONDS}}s
+- [ ] Output file size within expected range: {{MIN_SIZE}}–{{MAX_SIZE}} MB
+- [ ] Output duration matches input: ±2 seconds tolerance
+- [ ] Temp files cleaned on success AND error
+
+## Temp File Management
+
+```
+temp/
+├── {{JOB_ID}}_input_validated.{{EXT}}
+├── {{JOB_ID}}_preprocessed.{{EXT}}
+└── (cleaned up in finally block)
+
+output/
+└── {{JOB_ID}}_final.{{EXT}}
+```

package/vibe/config.json

@@ -1,30 +1,30 @@
-{
-  "models": {
-    "gpt": {
-      "enabled": false,
-      "authType": "codex-cli",
-      "role": "architecture",
-      "description": "Architecture/Debugging/Coding (GPT 5.4)"
-    },
-    "gemini": {
-      "enabled": false,
-      "authType": "apikey",
-      "role": "exploration",
-      "description": "Gemini 3.1 Pro / 3.1 Flash-Lite (Exploration, UI/UX)"
-    }
-  },
-  "stacks": [
-    {
-      "type": "typescript-node",
-      "path": ""
-    }
-  ],
-  "details": {
-    "databases": [
-      "SQLite"
-    ],
-    "stateManagement": [],
-    "hosting": [],
-    "cicd": []
-  }
+{
+  "models": {
+    "gpt": {
+      "enabled": false,
+      "authType": "codex-cli",
+      "role": "architecture",
+      "description": "Architecture/Debugging/Coding (GPT 5.4)"
+    },
+    "gemini": {
+      "enabled": false,
+      "authType": "apikey",
+      "role": "exploration",
+      "description": "Gemini 3.1 Pro / 3.1 Flash-Lite (Exploration, UI/UX)"
+    }
+  },
+  "stacks": [
+    {
+      "type": "typescript-node",
+      "path": ""
+    }
+  ],
+  "details": {
+    "databases": [
+      "SQLite"
+    ],
+    "stateManagement": [],
+    "hosting": [],
+    "cicd": []
+  }
 }