feat: v0.4.0 -- saar stats, saar init, saar scan (3 new commands)

saar stats ./repo
  Quality score 0-100 for your AGENTS.md. Shareable.
  Size (20pts): optimal 50-100 lines
  Freshness (20pts): based on saar diff snapshot age
  Coverage (40pts): 6 sections checked -- verify, never-do, auth, exceptions, tribal, stack
  Precision (20pts): penalises generic filler lines + emojis
  Grade: A+/A/B/C/D/F
  Tips: specific actionable improvements

saar init ./new-project
  Bootstrap AGENTS.md before you have any code
  6 stack presets: FastAPI, Next.js, Django, Express, Flask, React
  5 quick questions -- project purpose, stack, verify command, never-do, team size
  Team section auto-added for team > solo
  Tribal knowledge placeholder always included
  Student play: run this before git commit on any new project

saar scan https://github.com/tiangolo/fastapi
  Shallow clone + extract + show detection summary + quality score
  Works on any public GitHub URL
  Great for demo + exploring unknown codebases
  --index flag to also index into OCI

New modules: saar/scorer.py, saar/init_wizard.py
Tests: tests/test_new_commands.py (40 tests, 40/40 passing)
Total: 426 tests

Author: DevanshuNEU

docs/saar-add.tape

@@ -0,0 +1,30 @@
+# saar-add.tape -- Tribal knowledge correction GIF
+# Usage: vhs docs/saar-add.tape
+
+Output docs/saar-add.gif
+Set FontSize 13
+Set Width 880
+Set Height 300
+Set Theme "Catppuccin Mocha"
+Set Padding 20
+Set TypingSpeed 45ms
+Set Shell "zsh"
+Set Framerate 24
+Env PATH "/Users/devanshu/.local/bin:/opt/homebrew/bin:/usr/bin:/bin"
+
+Hide
+Type "cd /tmp/studymate-demo && clear"
+Enter
+Show
+
+Sleep 500ms
+Type `saar add "Never use npm. This project uses bun only"`
+Enter
+Sleep 1500ms
+Type `saar add --off-limits "billing/ frozen until Q3"`
+Enter
+Sleep 1500ms
+Type `saar add --domain "Workspace means tenant not directory"`
+Enter
+Sleep 1500ms
+Sleep 2s

docs/saar-demo.gif

@@ -0,0 +1,32 @@
+# saar-demo.tape -- Core demo GIF
+# Usage: vhs docs/saar-demo.tape
+
+Output docs/saar-demo.gif
+Set FontSize 13
+Set Width 880
+Set Height 460
+Set Theme "Catppuccin Mocha"
+Set Padding 20
+Set TypingSpeed 45ms
+Set Shell "zsh"
+Set Framerate 24
+Env PATH "/Users/devanshu/.local/bin:/opt/homebrew/bin:/usr/bin:/bin"
+
+Hide
+Type "cd /tmp/studymate-demo && clear"
+Enter
+Show
+
+Sleep 500ms
+Type "ls"
+Enter
+Sleep 1200ms
+
+Ctrl+L
+Sleep 300ms
+
+Type "saar extract . --no-interview"
+Enter
+Sleep 12s
+
+Sleep 4s

docs/saar-demo.tape

@@ -0,0 +1,27 @@
+# saar-diff.tape -- Staleness detection GIF
+# Usage: vhs docs/saar-diff.tape
+
+Output docs/saar-diff.gif
+Set FontSize 13
+Set Width 880
+Set Height 360
+Set Theme "Catppuccin Mocha"
+Set Padding 20
+Set TypingSpeed 45ms
+Set Shell "zsh"
+Set Framerate 24
+Env PATH "/Users/devanshu/.local/bin:/opt/homebrew/bin:/usr/bin:/bin"
+
+Hide
+Type "cd /tmp/studymate-demo && clear"
+Enter
+Show
+
+Sleep 500ms
+Type "# 2 weeks later. did anything change?"
+Enter
+Sleep 1000ms
+Type "saar diff ."
+Enter
+Sleep 10s
+Sleep 3s

docs/saar-diff.gif

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "saar"
-version = "0.3.7"
+version = "0.4.0"
 description = "Extract the essence of your codebase. Auto-generate AGENTS.md, CLAUDE.md, .cursorrules and more."
 readme = "README.md"
 license = "MIT"

docs/saar-diff.tape

@@ -1,3 +1,3 @@
 """Saar -- extract the essence of your codebase."""
 
-__version__ = "0.3.7"
+__version__ = "0.4.0"