faf-cli 6.3.0 → 6.4.0

package/README.md

@@ -1,11 +1,15 @@
 <div style="display: flex; align-items: center; gap: 12px;">
   <img src="https://www.faf.one/orange-smiley.svg" alt="FAF" width="40" />
   <div>
-    <h1 style="margin: 0; color: #000000;">faf-cli</h1>
-    <p style="margin: 4px 0 0 0;"><strong>The package.json for AI Context</strong></p>
+    <h1 style="margin: 0; color: #000000;">faf-cli v6.4</h1>
+    <p style="margin: 2px 0 0 0; font-size: 0.85em; letter-spacing: 0.12em; opacity: 0.7; text-transform: uppercase;"><strong>The Foundation Edition</strong></p>
+    <p style="margin: 6px 0 0 0;"><strong>Persistent Project Context for AI.</strong></p>
+    <p style="margin: 0;"><strong>Define once. Run anywhere.</strong></p>
   </div>
 </div>
 
+**FAF defines. MD instructs. AI codes.**
+
 [![TAF](./badge.svg)](https://github.com/Wolfe-Jam/faf-taf-git)
 [![CI](https://github.com/Wolfe-Jam/faf-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Wolfe-Jam/faf-cli/actions/workflows/ci.yml)
 [![NPM Downloads](https://img.shields.io/npm/dt/faf-cli?label=total%20downloads&color=00CCFF)](https://www.npmjs.com/package/faf-cli)
@@ -16,41 +20,31 @@
 [![Built with Bun](https://img.shields.io/badge/Built_with-Bun-f9f1e1?logo=bun)](https://bun.sh)
 [![project.faf](https://img.shields.io/badge/project.faf-inside-00D4D4)](https://github.com/Wolfe-Jam/faf)
 
-**FAF defines. MD instructs. AI codes.**
-
-> 🐘 **tri-sync now free for all builders** — `.faf` ↔ `CLAUDE.md` ↔ `MEMORY.md` in one command. Pro feature. Now free.
-
-> **51,582+ downloads** | **Claude Code Skills** | **Homebrew AI Tools** | **Championship-grade developer productivity**
-
 ```
 project/
 ├── package.json     ← npm reads this
 ├── project.faf      ← AI reads this
+├── README.md        ← humans read this
 └── src/
 ```
 
-> **Every building requires a foundation. `project.faf` is AI's foundation.**
+> **Every building requires a foundation. FAF is AI's foundational layer.**
 >
-> You have a `package.json`. Add a `project.faf`. Done.
+> You have a `package.json`. AI needs you to add a `project.faf`. Done.
 
 **Git-Native.** `project.faf` versions with your code — every clone, every fork, every checkout gets full AI context. No setup, no drift, no re-explaining.
 
-10 lines of structured YAML gives AI more context than 550 lines of prose. [Read why →](https://faf.one/blog/sunset-edition)
-
 ---
 
 ## Install
 
 ```bash
-bunx faf                           # That's it. FAF is all you need.
-npx faf                            # Also works.
-brew install faf-cli && faf        # Homebrew
+bunx faf                      # Bun — zero install, fastest path
+npx faf                       # npm — works everywhere
+brew install faf-cli && faf   # Homebrew
 ```
 
-Three letters. Auto-detects your project, creates `.faf`, scores it, tells you what's next.
-
-**Before:** `bunx faf-cli auto` — 18 characters, you had to know the command.
-**Now:** `bunx faf` — 8 characters, does everything automatically.
+> `faf` is shorthand for `faf-cli auto` — same behavior, fewer keystrokes.
 
 ---
 
@@ -74,15 +68,15 @@ v6 is a ground-up rewrite. All-in on Bun — same toolchain as Claude Code.
 | **Language** | TypeScript | TypeScript |
 | **Compile** | Bun bytecode | `bun build --compile` |
 
-409 tests in ~20s. 128 kB package. Single portable binary, 4 platforms. npx backward-compatible.
+408 tests in ~13s. 296KB bundle in 2.4s. Single portable binary, 4 platforms. npx backward-compatible.
 
-26 commands. 409 tests. 3,182 lines. 94% smaller than v5.
+26 commands. 408 tests. WJTTC-tested. 93% smaller than v5.
 
 ```
 commands → interop → core → wasm
 ```
 
-The WASM scoring kernel (`faf-scoring-kernel`) does the math. Bun does the delivery.
+The WASM scoring kernel (`faf-scoring-kernel` 2.0.0) does the math. Bun does the delivery.
 
 ---
 
@@ -91,9 +85,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 — README enriched, `--keep` to stay |
+| 2 | `faf git <url>` | Instant `.faf` from any GitHub repo — no clone |
 | 3 | `faf auto` | Zero to 100% in one command |
-| 4 | `faf go` | One sentence in. Review. Sign off. 🏆 |
+| 4 | `faf go` | Guided interview to gold code |
 | 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 +124,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                # One sentence in. Review. Sign off.
+bunx faf-cli go                # Interactive interview to gold code
 ```
 
 ---
@@ -139,47 +133,14 @@ bunx faf-cli go                # One sentence in. Review. Sign off.
 
 | Tier | Score | Status |
 |------|-------|--------|
-| 🏆 Trophy | 100% | AI Optimized — Gold Code |
-| ★ Gold | 99%+ | Near-perfect |
-| ◆ Silver | 95%+ | Excellent |
-| ◇ Bronze | 85%+ | Production ready |
-| ● Green | 70%+ | Solid foundation |
-| ● Yellow | 55%+ | AI flipping coins |
-| ○ Red | <55% | AI working blind |
-| ♡ White | 0% | No context |
-
----
-
-## Project Types
-
-faf-cli auto-detects your project type and activates the right slots:
-
-| Type | Detection | Active Slots |
-|------|-----------|-------------|
-| **mcp** | `@modelcontextprotocol/sdk`, `fastmcp`, `mcp`, `rmcp` | project + backend + universal + human |
-| **fullstack** | Next.js, Nuxt, frontend + backend | project + frontend + backend + universal + human |
-| **svelte** | SvelteKit / Svelte | project + frontend + backend + universal + human |
-| **backend** | FastAPI, Express, Django, Flask | project + backend + universal + human |
-| **frontend** | React, Vue, Angular (no backend) | project + frontend + human |
-| **cli** | `bin` field in package.json | project + human |
-| **library** | No framework signals | project + human |
-
-### MCP Server Detection
-
-10 MCP frameworks supported. Your MCP server gets the right type, backend, and framework sub-type automatically:
-
-```yaml
-project:
-  type: mcp
-  framework: fastmcp       # or: mcp-sdk-ts, mcp-sdk-py, rmcp
-stack:
-  backend: FastMCP          # auto-filled from MCP SDK
-  api_type: MCP (stdio/SSE) # auto-filled
-```
-
-### Python & Rust Support
-
-Project name and description read from `pyproject.toml` and `Cargo.toml` — not just `package.json`. Python deps (FastAPI, SQLAlchemy, Django) and Rust deps (rmcp, tokio) detected from manifests.
+| 🏆 **Trophy** | 100% | AI Optimized — Gold Code |
+| ★ **Gold** | 99%+ | Near-perfect |
+| ◆ **Silver** | 95%+ | Excellent |
+| ◇ **Bronze** | 85%+ | Production ready |
+| ● **Green** | 70%+ | Solid foundation |
+| ● **Yellow** | 55%+ | AI flipping coins |
+| ○ **Red** | <55% | AI working blind |
+| **♡** **White** | 0% | No context at all |
 
 ---
 
@@ -187,11 +148,9 @@ Project name and description read from `pyproject.toml` and `Cargo.toml` — not
 
 ```
 bi-sync:   .faf  ←── 8ms ──→  CLAUDE.md                (free forever)
-tri-sync:  .faf  ←── 8ms ──→  CLAUDE.md ↔ MEMORY.md    (free for devs 🐘)
+tri-sync:  .faf  ←── 8ms ──→  CLAUDE.md ↔ MEMORY.md    (Pro)
 ```
 
-Nelly never forgets — and now she's free for all builders 🐘 Teams & Enterprise: [faf.one/pro](https://faf.one/pro) (plans)
-
 ---
 
 ## Compiled Binaries
@@ -226,33 +185,17 @@ src/
 
 ## Testing
 
-```bash
-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:
+> **Robust. Reliable. Next-level WJTTC tested.** — The Foundation Edition.
 
 ```bash
-brew install terminal-notifier
+bun test                       # 408 tests, 42 files, ~13s
 ```
 
-Then in System Settings → Notifications → **terminal-notifier** → switch to **Alerts**. faf-cli detects `terminal-notifier` automatically and routes through it on macOS.
+- **WJTTC Build Resilience** (13) — every regression class locked.
+- **WJTTC Kernel Stress** (19) — WASM kernel boundary tests.
+- **e2e lifecycle** — every command in sequence.
+
+Test reports in `reports/`.
 
 ---