feat(m1): production hardening — CI deps, smoke test, Manim pacing

CI:
- Install ffmpeg + tesseract-ocr in unit test job (all 23 tests run)
- Add smoke job: config validation, narration lint, TTS dry-run

Manim pacing (reduces static holds from ~57% to <1%):
- Scene 01: tagline during title card, sequential output items,
  validation check annotations, config entries during "yaml" segment
- Scene 03: exclude-pattern filter animation fills the 11s gap between
  checkboxes and Production tab switch

Regenerated 01-overview.mp4, 03-wizard-gui.mp4, full-demo.mp4.

Made-with: Cursor

Author: jmjava

.github/workflows/ci.yml

@@ -31,9 +31,27 @@ jobs:
       - uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
+      - name: Install system dependencies
+        run: sudo apt-get update && sudo apt-get install -y --no-install-recommends ffmpeg tesseract-ocr
       - run: pip install ".[dev]"
       - run: pytest tests/ --ignore=tests/e2e -v --tb=short
 
+  smoke:
+    name: smoke (config + lint + tts dry-run)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - run: pip install .
+      - name: Validate config loads
+        run: docgen --config docs/demos/docgen.yaml validate --help
+      - name: Narration lint
+        run: docgen --config docs/demos/docgen.yaml lint
+      - name: TTS dry-run
+        run: docgen --config docs/demos/docgen.yaml tts --dry-run
+
   e2e:
     runs-on: ubuntu-latest
     steps:

docs/demos/animations/scenes.py

@@ -115,6 +115,16 @@ def seg_end(i: int) -> float:
 
         self.timed_play(Write(title), run_time=1.2)
         self.timed_play(FadeIn(subtitle, shift=UP * 0.2), run_time=0.8)
+
+        tagline = Text(
+            "Reproducible · version-controlled · fully automated",
+            font_size=16, color=GREY_B,
+        )
+        tagline.next_to(subtitle, DOWN, buff=0.4)
+        self.wait_until(seg_start(1))
+        self.timed_play(FadeIn(tagline, shift=UP * 0.15), run_time=0.7)
+        title_group.add(tagline)
+
         self.wait_until(seg_start(2))
 
         # ── Beat 2: Title shrinks; show inputs ────────────────────────
@@ -188,7 +198,17 @@ def seg_end(i: int) -> float:
             out_group.add(ot)
 
         self.timed_play(FadeIn(outputs_label), run_time=0.4)
-        self.timed_play(*[FadeIn(o, shift=UP * 0.15) for o in out_group], run_time=0.6)
+
+        out_per = max(0.3, (seg_start(9) - self._clock - 1.0) / len(out_group))
+        for o in out_group:
+            self.timed_play(FadeIn(o, shift=UP * 0.15), run_time=out_per)
+
+        output_arrows = VGroup()
+        for sb in [stage_boxes[-1]]:
+            arr = _arrow(sb[0].get_bottom(), outputs_label.get_top(), color=C_ACCENT)
+            output_arrows.add(arr)
+        self.timed_play(Create(output_arrows[0]), run_time=0.5)
+
         self.wait_until(seg_start(9))
 
         # ── Beats 9-10: Concat + Pages ────────────────────────────────
@@ -208,6 +228,23 @@ def seg_end(i: int) -> float:
 
         self.timed_play(Create(val_to_concat), FadeIn(concat_box), run_time=0.5)
         self.timed_play(Create(concat_to_pages), FadeIn(pages_box), run_time=0.5)
+
+        checks_group = VGroup()
+        check_items = [
+            ("✓ stream presence", C_GREEN),
+            ("✓ A/V drift < 2.75s", C_GREEN),
+            ("✓ no blank frames", C_GREEN),
+            ("✓ narration lint clean", C_GREEN),
+        ]
+        for ci, (cl, cc) in enumerate(check_items):
+            ct = Text(cl, font_size=12, color=cc)
+            ct.move_to(LEFT * 5.0 + DOWN * (1.8 + ci * 0.35))
+            checks_group.add(ct)
+
+        check_per = max(0.3, (seg_start(11) - self._clock - 0.5) / len(check_items))
+        for ct in checks_group:
+            self.timed_play(FadeIn(ct, shift=RIGHT * 0.2), run_time=check_per)
+
         self.wait_until(seg_start(11))
 
         # ── Beat 11: Single command highlight ─────────────────────────
@@ -223,6 +260,28 @@ def seg_end(i: int) -> float:
 
         self.timed_play(FadeIn(cmd_group, shift=UP * 0.3), run_time=0.7)
         self.timed_play(Indicate(cmd_group, color=C_ACCENT, scale_factor=1.05), run_time=0.8)
+
+        config_items = VGroup()
+        cfg_entries = [
+            ("segments:", C_ACCENT),
+            ("  visual_map:", C_TEAL),
+            ("  tts:", C_PURPLE),
+            ("  validation:", C_RED),
+            ("  wizard:", C_ORANGE),
+        ]
+        for ci, (cl, cc) in enumerate(cfg_entries):
+            ct = Text(cl, font_size=12, color=cc, font="Monospace")
+            ct.move_to(RIGHT * 4.0 + DOWN * (1.8 + ci * 0.3))
+            config_items.add(ct)
+
+        cfg_label = Text("docgen.yaml", font_size=14, color=C_ORANGE, weight=BOLD)
+        cfg_label.move_to(RIGHT * 4.0 + DOWN * 1.4)
+        self.timed_play(FadeIn(cfg_label), run_time=0.3)
+
+        cfg_per = max(0.2, (seg_start(12) - self._clock - 0.3) / len(config_items))
+        for ct in config_items:
+            self.timed_play(FadeIn(ct, shift=RIGHT * 0.15), run_time=cfg_per)
+
         self.wait_until(seg_start(12))
 
         # ── Beat 12: Final + fade out ─────────────────────────────────
@@ -352,6 +411,36 @@ def seg_end(i: int) -> float:
             *[FadeIn(c, shift=LEFT * 0.1) for c in checks],
             run_time=0.5,
         )
+        self.wait_until(seg_start(6))
+
+        # ── Beats 6-7: Exclude patterns filter animation ─────────
+        exclude_title = Text("Excluded by docgen.yaml:", font_size=13, color=C_ORANGE)
+        exclude_title.move_to(RIGHT * 2.5 + UP * 0.8)
+
+        excluded_dirs = [
+            "node_modules/",
+            "__pycache__/",
+            ".pytest_cache/",
+            ".venv/",
+        ]
+        excl_group = VGroup()
+        for ei, edir in enumerate(excluded_dirs):
+            et = Text(edir, font_size=11, color=C_RED, font="Monospace")
+            cross = Text("✗", font_size=13, color=C_RED)
+            et.move_to(RIGHT * 3.0 + UP * (0.3 - ei * 0.35))
+            cross.move_to(RIGHT * 1.8 + UP * (0.3 - ei * 0.35))
+            excl_group.add(VGroup(cross, et))
+
+        self.timed_play(FadeIn(exclude_title), run_time=0.4)
+
+        excl_per = max(0.3, (seg_start(8) - self._clock - 0.5) / len(excl_group))
+        for eg in excl_group:
+            self.timed_play(FadeIn(eg, shift=LEFT * 0.15), run_time=excl_per)
+
+        self.wait_until(seg_start(8) - 0.3)
+        self.timed_play(
+            FadeOut(exclude_title), FadeOut(excl_group), run_time=0.3,
+        )
         self.wait_until(seg_start(8))
 
         # ── Beat 8: Switch to Production tab ─────────────────────────

docs/demos/recordings/01-overview.mp4

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:36b52db934bd2af3e9323ed0d8fcddd6c5032089d2ad50ceb562cbc2f2810d80
-size 1559323
+oid sha256:8d9b584587fab63e8a134ececd35501966ecc0d74efd0263fe07527db79336ac
+size 1675150

docs/demos/recordings/03-wizard-gui.mp4

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e09369269e481fd89e03984b5be6dcc465b35f7b492f883e7d9145d1ea61b999
-size 1597571
+oid sha256:deae84f76e390923eae96938e0ae93d413e76df8d1a67ada80eb1b6a1175753d
+size 1631038

docs/demos/recordings/full-demo.mp4

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:cc2bfc65a42dc9dcd22b336a78b517fdcebebfcd9728e3fad5b73f0bb1bb6def
-size 10663602
+oid sha256:dd3e0f1032a0215c6e4a1310c88b8602f1852943badd3e3ab955b81cd3c15e72
+size 10812896