Merge branch 'develop' (VHS demo 0.9.x)

Author: hrodrig

README.md

@@ -23,7 +23,7 @@
 </p>
 
 <p align="center">
-  <img src="docs/demo.gif" alt="groot terminal demo: help, version, sample config" width="92%" />
+  <img src="docs/demo.gif" alt="groot terminal demo: help, version, validate, completion, sample config" width="92%" />
 </p>
 
 <p align="center"><sub>Terminal demo recorded with <a href="https://github.com/charmbracelet/vhs">VHS</a>. Regenerate: <code>make install && bash -c "vhs docs/demo.tape"</code> · <a href="docs/demo.tape"><code>docs/demo.tape</code></a></sub></p>

docs/demo.gif

@@ -2,22 +2,22 @@
 #   make install && bash -c "vhs docs/demo.tape"
 # Use bash -c (not bare `vhs` from zsh) so the recorder does not inherit zsh/Oh My Zsh prompts.
 # Recorded output reflects the binary built with VERSION via make install / make build.
-# After a VERSION bump, regenerate docs/demo.gif so the embedded recording matches the release.
+# After a VERSION bump or CLI UX change (0.9.x: validate, inspect, completion), regenerate docs/demo.gif.
 
 Output docs/demo.gif
 
 Require groot
 
 Set Shell "bash"
 Set FontSize 14
-Set Width 920
-Set Height 520
+Set Width 960
+Set Height 560
 Set Padding 20
 
 Enter
 Sleep 300ms
 
-# Root help
+# Root help — 0.9.x subcommands (validate, inspect, completion)
 Type "groot -h"
 Enter
 Sleep 2s
@@ -27,8 +27,18 @@ Type "groot --version"
 Enter
 Sleep 1s
 
+# Preflight subcommand (help only; no cluster required)
+Type "groot validate -h"
+Enter
+Sleep 1500ms
+
+# Shell completion snippet
+Type "groot completion bash 2>/dev/null | head -n 12"
+Enter
+Sleep 1500ms
+
 # Sample config (truncated for a short GIF)
-Type "groot --print-sample-config 2>&1 | head -n 28"
+Type "groot --print-sample-config 2>&1 | head -n 22"
 Enter
 Sleep 2s