demo: reproducible VHS terminal demo (tape + gif + mp4); engine default output is table-only

Author: karanb192

README.md

@@ -17,6 +17,10 @@ curl -fsSL https://raw.githubusercontent.com/karanb192/itr-wala/main/install.sh
 
 Prefer not to pipe curl into bash? Good instinct. Clone the repo, read `install.sh` (~80 lines), then run it.
 
+![itr-wala demo: golden tests pass, income validates against document totals, both regimes computed — ₹42,811 found](demo/demo.gif)
+
+*Even the demo is deterministic: it's a [VHS](https://github.com/charmbracelet/vhs) tape ([`demo/demo.tape`](demo/demo.tape)) replaying the bundled fictional example — re-render it yourself with `vhs demo/demo.tape`.*
+
 Then open your agent and say **"file my ITR"**. Hand it your Form 16 and AIS. It does the rest — except the three things only you should ever do: **pay, submit, e-verify**.
 
 ## Why this exists
@@ -82,7 +86,7 @@ Income-tax computation — FY 2025-26 (AY 2026-27)
   RECOMMENDED: NEW regime (saves Rs. 42,811)
 ```
 
-<!-- TODO before launch tweet: replace with a 20-second terminal GIF/asciinema of a full session -->
+(An MP4 of the same demo is generated alongside the GIF — `demo/demo.mp4` — for X/LinkedIn posts.)
 
 ## Privacy, honestly
 

demo/demo.gif

@@ -0,0 +1,41 @@
+# itr-wala demo — the demo is code, like everything else here.
+# Re-render any time from the repo root:  vhs demo/demo.tape
+# Requires: vhs (brew install vhs) and python3. Every number shown is
+# reproducible from the bundled fictional example — nothing is staged.
+
+Output demo/demo.gif
+Output demo/demo.mp4
+
+Set Shell "bash"
+Set FontSize 15
+Set Width 920
+Set Height 900
+Set Padding 24
+Set Theme "Catppuccin Mocha"
+Set TypingSpeed 35ms
+
+Hide
+Type "cd skills/itr-wala && export PS1='$ ' && clear"
+Enter
+Show
+
+Type "# never trust a tax tool that can't prove its math:"
+Enter
+Sleep 400ms
+Type "python3 scripts/test_tax_engine.py"
+Enter
+Sleep 2.5s
+
+Type "# validate extracted income against Form 16 / 26AS / AIS totals:"
+Enter
+Sleep 400ms
+Type "python3 scripts/validate_income.py assets/example-income.json"
+Enter
+Sleep 3s
+
+Type "# compute both regimes — every rupee from tested code:"
+Enter
+Sleep 400ms
+Type "python3 scripts/tax_engine.py assets/example-income.json"
+Enter
+Sleep 9s

demo/demo.mp4

@@ -10,8 +10,8 @@
 Zero dependencies (Python 3.9+ stdlib). All amounts are rupees (int/float).
 
 Usage:
-    python3 tax_engine.py input.json            # full computation, both regimes
-    python3 tax_engine.py input.json --json     # machine-readable output only
+    python3 tax_engine.py input.json            # computation table, both regimes
+    python3 tax_engine.py input.json --json     # machine-readable JSON
     echo '{...}' | python3 tax_engine.py -
 
 The LLM driving this skill must NEVER do tax arithmetic itself. It prepares
@@ -631,8 +631,6 @@ def main(argv):
         print(json.dumps(result, indent=2))
     else:
         print(render_table(result))
-        print("\n--- machine-readable ---")
-        print(json.dumps(result, indent=2))
     return 0