Prompt-to-Video (compose_video)

What to say

How it works

1. uv run scripts/cg.py make "<topic>" or --script talk.md
2. Dry run first with --dry-run
3. Verify with cg verify

Example input (examples/compose_video.json)

{
  "language": "en",
  "title": "Why Cats Hate Water (and 3 That Don't)",
  "topic": "Why do most cats hate water while a few breeds love it? Make it hooky and retention-driven.",
  "audience": "Curious cat owners who enjoy fast, evidence-backed animal facts",
  "objective": "educate",
  "cta": "Save this before your cat's next bath.",
  "target_duration_seconds": 30,
  "style": "explainer",
  "voice": "en-US-AndrewNeural",
  "rate": "-4%",
  "sources": [
    {
      "id": "britannica-water",
      "title": "Why Do Cats Hate Water?",
      "url": "https://www.britannica.com/story/why-do-cats-hate-water",
      "publisher": "Encyclopaedia Britannica",
      "source_type": "reference",
      "accessed_at": "2026-09-07",
      "notes": "Explains wet-fur discomfort, dry-climate ancestry, swimming big cats, and water-tolerant domestic breeds."
    },
    {
      "id": "petmd-water",
      "title": "Why Do Some Cats Hate Water?",
      "url": "https://www.petmd.com/cat/general-health/why-do-some-cats-hate-water",
      "publisher": "PetMD",
      "published_at": "2026-01-05",
      "accessed_at": "2026-09-07",
      "source_type": "reputable_secondary",
      "notes": "Veterinarian-reviewed overview covering individual variation, prior experiences, wet-fur discomfort, and safe handling."
    }
  ],
  "quality": {
    "mode": "strict",
    "min_score": 85,
    "require_sources": true
  },
  "scenes": [
    {
      "hook": "Your cat fears the tub — but a tiger doesn't",
      "narration": "Most cats act like water is lava. Yet their wild cousins swim for fun. What gives?",
      "broll_query": "cat avoiding water",
      "visual_intent": "Contrast a house cat backing away from a bath with a tiger confidently swimming.",
      "source_ids": ["britannica-water", "petmd-water"],
      "lower_third": "The curiosity gap"
    },
...