| name | plotloom-stitch-deliver |
| description | Stitches selected Plotloom clips into `final.mp4` and prepares delivery. Use when the user asks to stitch clips, assemble an episode, concat selected videos, make final.mp4, probe media, or deliver a verified Plotloom episode to Feishu/Lark after `episodes/epXXX/videos/clip-*/selected.mp4` files exist. |
Plotloom Stitch and Deliver
When to Use
Use after all required episodes/epXXX/videos/clip-*/selected.mp4 files exist.
Inputs
selected.mp4 clips under episodes/epXXX/videos/clip-*/- Target episode id.
- Optional delivery request via nova-lark / lark-cli.
Outputs
episodes/epXXX/videos/final.mp4- Optional delivery note and Feishu/Lark delivery message or uploaded file.
Read These Resources When...
- Read
references/ffmpeg.md before probing or stitching.
- Use
templates/delivery-note.md after final verification or delivery.
- Use
plotloom --repo <repo> media probe <path> and plotloom --repo <repo> stitch --episode <episode> for deterministic work.
Workflow
- Find selected clips in episode clip order.
- Stop if any required selected clip is missing.
- Use
plotloom media probe to inspect each input.
- Use
plotloom stitch to stitch selected clips; use --normalize only when the target media behavior is understood.
- Save
episodes/epXXX/videos/final.mp4.
- Verify final file exists, is probeable, has nonzero duration, and matches expected clip count/order.
- Deliver via nova-lark / lark-cli when requested.
- Keep Feishu as delivery, not state center.
Final Verification Checklist
final.mp4 exists.ffprobe returns success.- duration is nonzero.
- source clip order is correct.
- no prompts/candidates/selection notes were mutated during stitch.
Stop Conditions
Stop after final probe and optional delivery. Do not mutate prompts, candidates, or selection notes.
Failure Modes
- Missing selected clip: report exact missing path.
- ffprobe failure: report incompatible/unreadable media.
- ffmpeg failure: report stderr/command failure clearly; do not hide errors.
- Delivery failure: final file remains canonical in repo; Feishu is not state center.
