feat: Clip Highlights workflow

[walkerfrankenberg]

Overview

Adds a new generateHighlightClips workflow that automatically creates shareable video clips from high-engagement moments. Uses Mux Data API engagement hotspots combined with AI to find optimal clip boundaries, generate compelling metadata (titles, descriptions, keywords), and suggest target platforms. Can create actual clip assets in Mux or run in analysis-only mode.

What was changed

New Workflow Implementation

• src/workflows/highlight-clips.ts (640 lines): Core workflow that:
  • Fetches engagement hotspots from Mux Data API
  • Uses AI to analyze transcript + visuals (storyboard + thumbnails) for context
  • Optimizes clip boundaries around hotspots (respects sentence boundaries, duration constraints)
  • Generates metadata with platform recommendations (YouTube, TikTok, LinkedIn, etc.)
  • Optionally creates clip assets via Mux API

Documentation

• docs/WORKFLOWS.md: Comprehensive guide with usage examples, duration constraints, platform optimization, and edge cases
• docs/API.md: Full API reference for generateHighlightClips function and types
• README.md: Added workflow to main feature table

Supporting Files

• examples/highlight-clips/basic-example.ts: CLI tool demonstrating the workflow with various options
• tests/integration/highlight-clips.test.ts: Integration tests covering dry-run mode, asset creation, and error handling
• src/workflows/index.ts: Export new workflow
• package.json: Updated dependencies

Suggested review order

1. docs/WORKFLOWS.md - Start here to understand what the workflow does and key use cases
2. src/workflows/highlight-clips.ts (lines 1-150) - Review types, schemas, and prompts to understand the data model
3. src/workflows/highlight-clips.ts (lines 150-end) - Core implementation logic
4. examples/highlight-clips/basic-example.ts - See practical usage
5. tests/integration/highlight-clips.test.ts - Verify test coverage
6. docs/API.md - Check API reference completeness
7. README.md - Confirm workflow table entry

[snyk-io]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scanner	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues
✅	Licenses	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.