faf-cli 6.2.0 → 6.3.3

package/README.md

@@ -2,10 +2,12 @@
   <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>
+    <p style="margin: 4px 0 0 0;"><strong>Persistent Project Context for AI. 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,12 +18,6 @@
 [![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
@@ -35,23 +31,16 @@ project/
 
 **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-cli auto                  # Bun — zero install, fastest path
+npx faf-cli auto                   # npm — works everywhere
+brew install faf-cli && faf auto   # 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.
-
 ---
 
 ## Nelly Never Forgets
@@ -74,15 +63,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` |
 
-375 tests in ~19s. 95KB package in 1s. Single portable binary, 4 platforms. npx backward-compatible.
+312 tests in ~10s. 290KB bundle in 2.4s. Single portable binary, 4 platforms. npx backward-compatible.
 
-26 commands. 375 tests. 3,182 lines. 94% smaller than v5.
+26 commands. 312 tests. 5,292 lines. 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.
 
 ---
 
@@ -140,46 +129,11 @@ bunx faf-cli go                # Interactive interview to gold code
 | 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.
+| 🥇 Gold | 99%+ | Near-perfect |
+| 🥈 Silver | 95%+ | Excellent |
+| 🥉 Bronze | 85%+ | Production ready |
+| 🟡 Yellow | 55%+ | AI flipping coins |
+| 🔴 Red | <55% | AI working blind |
 
 ---
 
@@ -187,11 +141,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
@@ -227,7 +179,7 @@ src/
 ## Testing
 
 ```bash
-bun test                       # 375 tests, 41 files, ~19s
+bun test                       # 312 tests, 39 files, ~12s
 ```
 
 Full e2e lifecycle test runs every command in sequence: init → auto → score → edit → sync → export → compile → decompile → taf → recover → check. Test reports in `reports/`.