@su-record/vibe 2.9.22 → 2.9.23

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": []
+  }
 }