Embed the decomposition demo in the README, excluded from the sdist

A 740KB GIF (with the full-quality mp4 beside it) of a real session:
a local model decomposes one English question into a nine-node graph
with four parallel pulls, the plan parks grey awaiting approval, and
each node runs amber-then-green in the live view. GIF because GitHub
strips <video> and only auto-plays its own upload URLs — an image
renders everywhere, PyPI included. docs/media is excluded from the
build (mirrored in MANIFEST.in): a pip install has no use for it.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: Shashankss1205

MANIFEST.in

@@ -32,3 +32,4 @@ global-exclude *.sqlite
 global-exclude *.jsonl
 global-exclude /HANDOFF.md
 global-exclude /.grapharc
+global-exclude /docs/media

README.md

@@ -11,6 +11,10 @@ Build production-grade multi-agent systems with built-in safety, auditability, a
 
 **Status:** Early days (`0.1.2`) — the API is not stable yet. `pip install grapharc` — see [Install](#install).
 
+![One English question is decomposed by a local model into a nine-node graph — four parallel evidence pulls fanning out of START, a correlate join, a hypothesis fork, and a final report — shown live in the browser: the proposed graph waits grey for human approval, then each node turns amber while it runs and green when it is done.](docs/media/grapharc-decompose.gif)
+
+*One question in, a governed graph out: a local model proposes the topology, the admission gate and a human approval decide, and the live view shows every node run — amber while executing, green when done. ([full-quality mp4](docs/media/grapharc-decompose.mp4))*
+
 ### What makes GraphARC different
 
 - **Admission gate**: All runtime topology changes go through deterministic approval before execution

docs/media/grapharc-decompose.gif

@@ -150,6 +150,9 @@ exclude = [
     # `ignore-vcs` is on — this line is the only thing that does.
     "/HANDOFF.md",
     "/.grapharc",
+    # Demo footage embedded in the README. GitHub renders it; a pip install
+    # has no use for megabytes of GIF, so it stays out of the sdist.
+    "/docs/media",
 ]
 
 # `packages` is recursive: every subpackage under `grapharc/` ships without