demos: Manim scenes 12–14, M12.2 recordings, docs + video-framework bundle

- Replace panel image hack with RegressionSuiteScene, ManagementGUIArchitectureScene, GUIExtensionScene
- compose.sh / generate-all.sh / segments doc updates
- Regenerated recordings and full-demo-with-m12-2; terminal tapes + narration tweaks
- Regression/testing docs, demos README, AGENTS
- Add documentation-generator/ (example bundle + video-framework templates)

Made-with: Cursor

Author: jmjava

AGENTS.md

@@ -2,6 +2,8 @@
 
 ## Regression — iterate until complete
 
+Full **`run-regression*.sh`** is a **system / integration** suite for this repo (cluster-backed tiers optional). It is **not** the same as “every test on every application pull request” — see [docs/REGRESSION.md](docs/REGRESSION.md) for PR vs platform scope.
+
 Do **not** stop after a single partial test run. Follow **[docs/AGENT-REGRESSION.md](docs/AGENT-REGRESSION.md)**:
 
 - Run **`bash scripts/run-regression-agent.sh`** (or **`run-regression-agent-full.sh`** if Results + DB must pass).

docs/REGRESSION.md

@@ -4,6 +4,17 @@ Single entrypoint: **`scripts/run-regression.sh`** (see `--help`). Run when gree
 
 **Cursor / agents:** follow **[AGENT-REGRESSION.md](AGENT-REGRESSION.md)** — run **`scripts/run-regression-agent.sh`** (or **`run-regression-agent-full.sh`**) and **iterate with fixes until exit 0**, not a single partial run. Repo **[AGENTS.md](../AGENTS.md)** points here.
 
+## Application PR pipeline vs platform (system) regression
+
+Do **not** confuse these:
+
+| Scope | What runs | Typical trigger |
+|-------|-----------|-----------------|
+| **Application PR** (`stack-pr-test` on an **app** repo) | Stack-defined tests only — e.g. that app’s Newman/Playwright/Artillery as declared in `stacks/*.yaml`, against the intercept build. | Every PR on the **application** repository (when webhooks/Tekton are wired). |
+| **Platform regression** (`scripts/run-regression*.sh` on **this** repo) | **System / integration** tiers: Phase 1 + orchestrator + shared libs + GUI pytest, Playwright for **management-gui**, real **`stack-dag-verify`** PipelineRun, Newman against **orchestrator** API, optional Tekton Results, optional Kind E2E. | **Manual**, **scheduled**, **pre-release**, or **agent loop** — **not** “automatically on every pull request” unless *you* add GitHub Actions (or similar) to do so. |
+
+So: **not all tests run on every PR.** The full regression driver is a **system test** bar for the platform; app PRs run a narrower, stack-scoped test stage.
+
 **Streaming / timestamps:** use **`scripts/run-regression-stream.sh`** — same arguments, prefixes each line with `[HH:MM:SS]` and preserves the real exit code (plain `| while read` does not).
 
 **Port-forward prep:** [common.sh](../scripts/common.sh) defines **`free_tcp_port`**. Regression (**[run-regression.sh](../scripts/run-regression.sh)**) runs a **prep** step when `kubectl` works: frees **`ORCHESTRATOR_TEST_PORT`** (default **9091**) and **`RESULTS_API_LOCAL_PORT`** (default **8080**). Set **`REGRESSION_FREE_PORTS=0`** to skip that prep. [run-orchestrator-tests.sh](../scripts/run-orchestrator-tests.sh) also frees the orchestrator local port; [verify-results-in-db.sh](../scripts/verify-results-in-db.sh) frees **8080** (or **`RESULTS_API_LOCAL_PORT`**) before forwarding the Results API.
@@ -77,11 +88,11 @@ Environment:
 - `REGRESSION_DAG_VERIFY=auto|skip|yes`
 - `DAG_VERIFY_TIMEOUT` — seconds passed to `verify-dag-phase2.sh` `--timeout` (default **300** in regression).
 
-## Suggested “complete regression” before doc work
+## Suggested regression cadence (not all on every PR)
 
-1. `./scripts/run-regression.sh --local-only` on every commit / PR.
-2. On a cluster with Tekton + orchestrator: **`./scripts/run-regression.sh --cluster --require-dag-verify`** (ensures at least one **Succeeded** `stack-dag-verify` run, not only Newman side-effects).
-3. With Tekton Results: `--with-results-verify` or rely on **auto** when the API exists.
-4. `--kind-e2e` when changing bootstrap, intercepts, or Results integration.
+1. **Often (fast, no cluster):** `./scripts/run-regression.sh --local-only` — Phase 1 + pytest + vitest; good for frequent pushes; safe to wire into lightweight CI.
+2. **System bar (cluster):** **`./scripts/run-regression.sh --cluster --require-dag-verify`** when you need a real **Succeeded** `stack-dag-verify` and orchestrator Newman — treat as **integration / system** work: before releases, after big platform changes, on a schedule, or when agents/docs require proof — **not** as “must pass on every GitHub PR” unless you explicitly configure that.
+3. **With Tekton Results:** `--with-results-verify` or rely on **auto** when the API exists.
+4. **Kind E2E:** `--kind-e2e` when changing bootstrap, intercepts, or Results integration (heavy; occasional).
 
 After the tiers you care about are green, update [milestones/milestone-8.md](../milestones/milestone-8.md) and related testing docs.

docs/TESTING-AND-REGRESSION-OVERVIEW.md

@@ -2,6 +2,8 @@
 
 This document is the **story** behind how tekton-dag is verified end-to-end. Use it for **onboarding**, **release checklists**, and **video voiceover**. Operational detail lives in [REGRESSION.md](REGRESSION.md), [AGENT-REGRESSION.md](AGENT-REGRESSION.md), and [scripts/run-regression.sh](../scripts/run-regression.sh).
 
+**Scope:** An **application PR** only runs that stack’s declared tests inside **stack-pr-test**. The **`run-regression*.sh`** suites are **platform / system** checks (orchestrator, GUI, real PipelineRuns, Newman, Results). They are **not** all expected to run on every GitHub pull request unless you wire CI that way — see [REGRESSION.md](REGRESSION.md) § *Application PR pipeline vs platform (system) regression*.
+
 ## Why regression is more than unit tests
 
 | Layer | What it proves | Typical command / artifact |

docs/demos/README.md

@@ -1,5 +1,7 @@
 # Demo video toolchain (M8 / M12.2)
 
+**Portable copy** for other repos: [`../../documentation-generator/video-framework/`](../../documentation-generator/video-framework/) (+ [`../../documentation-generator/example-demo-bundle/`](../../documentation-generator/example-demo-bundle/)). Canonical scripts stay here; refresh the copy when the framework changes.
+
 Regenerate narration, animations, terminal recordings, and composed MP4s:
 
 ```bash

docs/demos/animations/scenes.py

@@ -1133,3 +1133,192 @@ def _svc_circle(self, label, color, pos, radius=0.40):
         c = Circle(radius=radius, color=color, fill_opacity=0.12, stroke_width=2.5)
         t = Text(label, font_size=12, color=color)
         return VGroup(c, t).move_to(pos)
+
+
+# ═════════════════════════════════════════════════════════════════════
+# M12.2 — Segment 12: Full regression suite
+# Audio: 12-regression-suite.mp3  (~39.4 s)
+# Beats align with narration/12-regression-suite.md numbered script.
+# ═════════════════════════════════════════════════════════════════════
+class RegressionSuiteScene(Scene):
+    def construct(self):
+        self.camera.background_color = C_BG
+        t = 0.0
+
+        title = Text("Full regression suite", font_size=32, color=WHITE)
+        sub = Text("Verify in layers — unit tests alone are not enough", font_size=15, color=GREY)
+        sub.next_to(title, DOWN, buff=0.32)
+        self.play(FadeIn(title), FadeIn(sub), run_time=1.0)
+        t += 1.0
+        t = _wait_until(self, 8.0, t)
+        self.play(FadeOut(title), FadeOut(sub), run_time=0.45)
+        t += 0.45
+
+        h1 = Text("Without Kubernetes", font_size=14, color=C_GUI)
+        h1.move_to(LEFT * 3.6 + UP * 2.55)
+        h2 = Text("With cluster", font_size=14, color=C_ORCH)
+        h2.move_to(RIGHT * 3.6 + UP * 2.55)
+        self.play(FadeIn(h1), FadeIn(h2), run_time=0.5)
+        t += 0.5
+
+        left_col = VGroup(
+            Text("Phase 1 — stack YAML + registry", font_size=11, color=WHITE),
+            Text("pytest — orchestrator, libs, GUI backend", font_size=11, color=WHITE),
+            Text("vitest — baggage-node", font_size=11, color=WHITE),
+        ).arrange(DOWN, aligned_edge=LEFT, buff=0.22).move_to(LEFT * 3.6 + UP * 0.55)
+
+        right_col = VGroup(
+            Text("stack-dag-verify PipelineRun", font_size=11, color=C_PR),
+            Text("Newman — orchestrator API", font_size=11, color=C_PR),
+            Text("Playwright — management GUI", font_size=11, color=C_PR),
+            Text("Tekton Results (optional)", font_size=10, color=GREY),
+        ).arrange(DOWN, aligned_edge=LEFT, buff=0.18).move_to(RIGHT * 3.6 + UP * 0.35)
+
+        self.play(LaggedStart(FadeIn(left_col), FadeIn(right_col), lag_ratio=0.35), run_time=1.8)
+        t += 1.8
+        t = _wait_until(self, 26.0, t)
+
+        driver = Text("run-regression-agent.sh", font_size=15, color=C_HOOK)
+        driver.move_to(UP * 1.75)
+        hint = Text("Phase 2 passed · regression exit code 0", font_size=13, color=C_PR)
+        hint.next_to(driver, DOWN, buff=0.38)
+        self.play(FadeIn(driver), run_time=0.45)
+        t += 0.45
+        self.play(FadeIn(hint), run_time=0.45)
+        t += 0.45
+        t = _wait_until(self, 35.5, t)
+
+        self.play(*[FadeOut(m) for m in self.mobjects], run_time=0.45)
+        t += 0.45
+        fin = Text("Scripted bar clear — safe for docs / merge", font_size=20, color=C_PR)
+        self.play(FadeIn(fin), run_time=0.7)
+        t += 0.7
+        t = _wait_until(self, 39.5, t)
+
+
+# ═════════════════════════════════════════════════════════════════════
+# M12.2 — Segment 13: Management GUI architecture
+# Audio: 13-management-gui-architecture.mp3  (~53.8 s)
+# ═════════════════════════════════════════════════════════════════════
+class ManagementGUIArchitectureScene(Scene):
+    def construct(self):
+        self.camera.background_color = C_BG
+        t = 0.0
+
+        title = Text("Management GUI architecture", font_size=28, color=C_GUI)
+        self.play(FadeIn(title), run_time=0.75)
+        t += 0.75
+        t = _wait_until(self, 9.5, t)
+        self.play(title.animate.scale(0.42).to_edge(UP, buff=0.18), run_time=0.45)
+        t += 0.45
+
+        cred = Text("Browser never holds cluster credentials", font_size=12, color=C_PR)
+        cred.move_to(UP * 2.35)
+        br = _box("Browser", GREY, w=1.45, h=0.58, fs=12)
+        vu = _box("Vue 3 SPA", C_VUE, w=1.55, h=0.58, fs=12)
+        apilbl = _box("/api/*", C_FLASK, w=1.25, h=0.58, fs=11)
+        fl = _box("Flask", C_FLASK, w=1.2, h=0.58, fs=12)
+        k8 = _box("Kubernetes", C_PIPE, w=1.65, h=0.58, fs=11)
+        row = VGroup(br, vu, apilbl, fl, k8).arrange(RIGHT, buff=0.28).move_to(UP * 0.75)
+        self.play(FadeIn(cred), LaggedStart(*[FadeIn(x) for x in row], lag_ratio=0.12), run_time=1.6)
+        t += 1.6
+        for i in range(len(row) - 1):
+            arr = Arrow(
+                row[i].get_right(), row[i + 1].get_left(), buff=0.06,
+                color=WHITE, stroke_width=2, max_tip_length_to_length_ratio=0.08,
+            )
+            self.play(Create(arr), run_time=0.12)
+            t += 0.12
+        t = _wait_until(self, 22.0, t)
+
+        team = Text("/api/teams/{team}/pipelineruns …", font_size=11, color=C_ORCH)
+        team.move_to(DOWN * 0.35)
+        self.play(FadeIn(team), run_time=0.45)
+        t += 0.45
+        t = _wait_until(self, 32.5, t)
+
+        views = VGroup(
+            _badge("Trigger", C_PR),
+            _badge("Monitor", C_ORCH),
+            _badge("DAG", C_NEO4J),
+        ).arrange(RIGHT, buff=0.45).move_to(DOWN * 1.85)
+        cap = Text("Stack YAML resolved server-side · Vue Flow", font_size=11, color=GREY)
+        cap.next_to(views, DOWN, buff=0.28)
+        self.play(FadeIn(views), run_time=0.6)
+        t += 0.6
+        self.play(FadeIn(cap), run_time=0.35)
+        t += 0.35
+        t = _wait_until(self, 44.0, t)
+
+        helm = Text("Helm: namespace, RBAC, orchestrator endpoints", font_size=12, color=C_HELM)
+        helm.move_to(DOWN * 3.05)
+        self.play(FadeIn(helm), run_time=0.5)
+        t += 0.5
+        t = _wait_until(self, 53.9, t)
+
+
+# ═════════════════════════════════════════════════════════════════════
+# M12.2 — Segment 14: Extending the GUI for Tekton
+# Audio: 14-gui-tekton-extension.mp3  (~59 s)
+# ═════════════════════════════════════════════════════════════════════
+class GUIExtensionScene(Scene):
+    def construct(self):
+        self.camera.background_color = C_BG
+        t = 0.0
+
+        title = Text("Extending the GUI for Tekton", font_size=28, color=WHITE)
+        self.play(FadeIn(title), run_time=0.75)
+        t += 0.75
+        t = _wait_until(self, 8.5, t)
+        self.play(FadeOut(title), run_time=0.4)
+        t += 0.4
+
+        lt = Text("Flask — add JSON route first", font_size=14, color=C_FLASK)
+        lt.move_to(LEFT * 3.6 + UP * 2.75)
+        rt = Text("Vue — Pinia + views", font_size=14, color=C_VUE)
+        rt.move_to(RIGHT * 3.6 + UP * 2.75)
+        self.play(FadeIn(lt), FadeIn(rt), run_time=0.45)
+        t += 0.45
+
+        left_body = VGroup(
+            Text("Wrap kubernetes client", font_size=11, color=GREY),
+            Text("Stable JSON for tables / charts", font_size=12, color=WHITE),
+            Text("pytest + mocks (same style as routes)", font_size=11, color=GREY),
+        ).arrange(DOWN, aligned_edge=LEFT, buff=0.2).move_to(LEFT * 3.6 + UP * 0.95)
+
+        right_body = VGroup(
+            Text("Store: useApi + teamUrl()", font_size=12, color=WHITE),
+            Text("Router + view component", font_size=11, color=GREY),
+            Text("Playwright spec per flow", font_size=11, color=GREY),
+        ).arrange(DOWN, aligned_edge=LEFT, buff=0.2).move_to(RIGHT * 3.6 + UP * 0.95)
+
+        self.play(FadeIn(left_body), run_time=0.85)
+        t += 0.85
+        t = _wait_until(self, 18.0, t)
+        self.play(FadeIn(right_body), run_time=0.85)
+        t += 0.85
+        t = _wait_until(self, 32.0, t)
+
+        bridge = Text("team-scoped reads", font_size=11, color=GREY_B)
+        bridge.move_to(UP * 0.95)
+        self.play(FadeIn(bridge), run_time=0.35)
+        t += 0.35
+        arr = Arrow(LEFT * 1.15 + UP * 0.95, RIGHT * 1.15 + UP * 0.95, buff=0.02, color=GREY_B)
+        self.play(Create(arr), run_time=0.25)
+        t += 0.25
+        t = _wait_until(self, 42.0, t)
+
+        qa = VGroup(
+            Text("pytest — API contracts", font_size=12, color=C_PR),
+            Text("Playwright — UI regressions", font_size=12, color=C_PR),
+            Text("Small PRs: schema, route, store, view, one E2E", font_size=11, color=WHITE),
+        ).arrange(DOWN, aligned_edge=LEFT, buff=0.18).move_to(DOWN * 2.05)
+        self.play(FadeIn(qa), run_time=0.9)
+        t += 0.9
+        t = _wait_until(self, 52.0, t)
+
+        doc = Text("docs/MANAGEMENT-GUI-EXTENSION.md", font_size=12, color=C_HOOK)
+        doc.to_edge(DOWN, buff=0.32)
+        self.play(FadeIn(doc), run_time=0.45)
+        t += 0.45
+        t = _wait_until(self, 59.2, t)