faf-cli 6.2.0 → 6.3.0

package/README.md

@@ -74,9 +74,9 @@ v6 is a ground-up rewrite. All-in on Bun — same toolchain as Claude Code.
 | **Language** | TypeScript | TypeScript |
 | **Compile** | Bun bytecode | `bun build --compile` |
 
-375 tests in ~19s. 95KB package in 1s. Single portable binary, 4 platforms. npx backward-compatible.
+409 tests in ~20s. 128 kB package. Single portable binary, 4 platforms. npx backward-compatible.
 
-26 commands. 375 tests. 3,182 lines. 94% smaller than v5.
+26 commands. 409 tests. 3,182 lines. 94% smaller than v5.
 
 ```
 commands → interop → core → wasm
@@ -91,9 +91,9 @@ The WASM scoring kernel (`faf-scoring-kernel`) does the math. Bun does the deliv
 | # | Command | One-liner |
 |---|---------|-----------|
 | 1 | `faf init` | Create `.faf` from your local project |
-| 2 | `faf git <url>` | Instant `.faf` from any GitHub repo — no clone |
+| 2 | `faf git <url>` | Instant `.faf` from any GitHub repo — README enriched, `--keep` to stay |
 | 3 | `faf auto` | Zero to 100% in one command |
-| 4 | `faf go` | Guided interview to gold code |
+| 4 | `faf go` | One sentence in. Review. Sign off. 🏆 |
 | 5 | `faf score` | Check AI-readiness (0-100%) |
 | 6 | `faf sync` | `.faf` ↔ CLAUDE.md (bi-sync, mtime auto-direction) |
 | 7 | `faf compile` | `.faf` → `.fafb` binary — sealed, portable, deterministic |
@@ -130,7 +130,7 @@ bunx faf-cli git https://github.com/facebook/react
 # Your own project
 bunx faf-cli init              # Create .faf
 bunx faf-cli auto              # Zero to 100% in one command
-bunx faf-cli go                # Interactive interview to gold code
+bunx faf-cli go                # One sentence in. Review. Sign off.
 ```
 
 ---
@@ -227,13 +227,35 @@ src/
 ## Testing
 
 ```bash
-bun test                       # 375 tests, 41 files, ~19s
+bun test                       # 409 tests, 45 files, ~20s
 ```
 
 Full e2e lifecycle test runs every command in sequence: init → auto → score → edit → sync → export → compile → decompile → taf → recover → check. Test reports in `reports/`.
 
 ---
 
+## Environment Variables
+
+| Variable | Effect |
+|----------|--------|
+| `FAF_NO_NOTIFY=1` | Disable desktop notifications (Trophy unlocks, long-running command completion). |
+| `FAF_PRO=1` | Enable Pro features (reserved for Teams/Enterprise; tri-sync is free for all developers). |
+| `ANTHROPIC_API_KEY` | Used by `faf go` to interpret the project opener via Claude. Falls back to keyword extraction if unset. |
+
+### Click-to-dismiss notifications (macOS)
+
+Notifications use OSC 9 by default — emitted on Ghostty / iTerm2 / Wezterm / Kitty, silently ignored elsewhere. macOS auto-dismisses these after a few seconds.
+
+For sticky **click-to-dismiss** notifications:
+
+```bash
+brew install terminal-notifier
+```
+
+Then in System Settings → Notifications → **terminal-notifier** → switch to **Alerts**. faf-cli detects `terminal-notifier` automatically and routes through it on macOS.
+
+---
+
 ## Support
 
 - **[GitHub Discussions](https://github.com/Wolfe-Jam/faf-cli/discussions)** — Questions, ideas, community