fix: warm-cache demo recording protocol and precise graphify attribution

Author: rahlk

demo.tape

@@ -1,3 +1,10 @@
+# Render with: vhs demo.tape  → demo.gif
+#
+# RECORDING PROTOCOL: run `cocoa demo` once BEFORE recording so the fixture
+# clone and per-service analysis caches are warm — the recorded run then
+# completes in seconds instead of minutes and the GIF stays tight. Do NOT
+# record a cold run: analysis time varies with toolchain availability and
+# a fixed Sleep will truncate it.
 Output demo.gif
 Set FontSize 15
 Set Width 1200
@@ -6,8 +13,7 @@ Set Theme "Catppuccin Mocha"
 
 Type "cocoa demo"
 Enter
-Sleep 90s
+Sleep 25s
 Type "cocoa blast -p ~/.cocoa/demo/microservices-demo-v0.10.5 --target hipstershop.Money.units --kind proto-field"
 Enter
-Sleep 8s
-Sleep 4s
+Sleep 10s

docs/COMPARISON.md

@@ -8,7 +8,7 @@ thing: **where the edges come from.**
 | | graphify | COCOA |
 |---|---|---|
 | Unit of understanding | a folder of files | a distributed system |
-| Edge derivation | tree-sitter AST + LLM inference | real analyzers (WALA, Jedi, ts-morph, go/types via CLDK) + proto/k8s stitching |
+| Edge derivation | tree-sitter AST for code (deterministic); LLM inference for docs/PDFs/images | real analyzers (WALA, Jedi, ts-morph, go/types via CLDK) + proto/k8s stitching |
 | Edge provenance | `EXTRACTED` / `INFERRED` / `AMBIGUOUS` | `DERIVED-STATIC` / `INFERRED` (labeled fallback only) |
 | Cross-language links | inferred by the model | derived: proto stubs ↔ handlers ↔ k8s wiring, with anchor-exclusivity and boundary-matching to prevent false edges |
 | Databases | absent | first-class: Redis ops, SQL tables, ORM mappings as graph nodes/edges |

test/test_plugin_assets.py

@@ -153,3 +153,9 @@ def test_comparison_is_provenance_led():
     text = (ROOT / "docs" / "COMPARISON.md").read_text()
     assert "graphify" in text.lower()
     assert "AMBIGUOUS" in text and "DERIVED-STATIC" in text
+
+
+def test_demo_tape_mandates_warm_cache_protocol():
+    text = (ROOT / "demo.tape").read_text()
+    assert "RECORDING PROTOCOL" in text
+    assert "cold run" in text