faf-cli 6.15.0 → 7.0.0

package/README.md

@@ -4,9 +4,9 @@
 <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 — The Copilot Edition</h1>
-    <p style="margin: 2px 0 0 0; font-size: 0.85em; letter-spacing: 0.12em; opacity: 0.7; text-transform: uppercase;"><strong>Persistent AI Context Standard</strong></p>
-    <p style="margin: 6px 0 0 0;"><strong>Persistent Project Context for AI.</strong></p>
+    <h1 style="margin: 0; color: #000000;">faf-cli — The GIT Version</h1>
+    <p style="margin: 2px 0 0 0; font-size: 0.85em; letter-spacing: 0.12em; opacity: 0.7; text-transform: uppercase;"><strong>Context, Versioned.</strong></p>
+    <p style="margin: 6px 0 0 0;"><strong>FAF is to Context what Git is to Versions.</strong></p>
     <p style="margin: 0;"><strong>Define once. Run anywhere.</strong></p>
   </div>
 </div>
@@ -63,6 +63,32 @@ Run `faf` with no arguments:
 
 ---
 
+## v7.0 — The GIT Version
+
+**FAF is to Context what Git is to Versions.**
+
+Git gave your *code* diff, log, blame, hooks, CI. v7.0 gives your *context* the same — `project.faf` is now a git-native artifact:
+
+- **`faf diff`** — semantic context diff + score delta between any two refs (`85% ● → 100% 🏆`)
+- **`git diff` speaks .faf** — `faf diff --install-driver` makes native `git diff` / `log -p` / `show` render the delta
+- **`faf log`** — the score timeline across history (Proof-Over-Time)
+- **`faf hooks --install`** — pre-commit guard: warn, or `--strict` block, on a context regression
+- **`faf git owner/repo --ref <tag>`** — instant, *versioned*, scored context from any repo
+
+Purely additive — a safe upgrade. (One change: `faf git` now refuses to overwrite an existing `project.faf` — pass `--force`.)
+
+## v6.16 — Know Your Stack
+
+**FAF knows your stack — and now labels it identically in every file it writes: CLAUDE.md, AGENTS.md, copilot-instructions.md, GEMINI.md, .cursorrules.**
+
+```bash
+faf export --all     # CLAUDE.md · AGENTS.md · copilot-instructions.md · GEMINI.md · .cursorrules
+```
+
+FAF *knows your stack* — all 33 canonical slots now carry their display label in the registry, so `api_type` → **API**, `cicd` → **CI/CD**, `frontend` → **Framework**, the same way in **every** emitted file. GEMINI.md and `.cursorrules` were raw-key dumps; now they read like the rest. And `.github/copilot-instructions.md` gets a ground-up **Copilot-grade** rewrite — a prose overview, a `## Build & run` command section, GitHub-spec framing. Copilot enhancements, and more.
+
+---
+
 ## v6.15 — The Copilot Edition
 
 **FAF now writes the file GitHub Copilot reads.**
@@ -283,7 +309,7 @@ bunx faf-cli go                # Interactive interview to gold code
 
 | Tier | Score | Status |
 |------|-------|--------|
-| 🏆 **Trophy** | 100% | AI never has to guess |
+| 🏆 / ✪ **Trophy** | 100% | AI never has to guess |
 | ★ **Gold** | 99%+ | 1 slot from Trophy |
 | ◆ **Silver** | 95%+ | Close — keep going |
 | ◇ **Bronze** | 85%+ | Interim — keep going |
@@ -292,6 +318,8 @@ bunx faf-cli go                # Interactive interview to gold code
 | ○ **Red** | <55% | AI working blind |
 | ♡ **White** | 0% | No context at all |
 
+**🏆 and ✪ both mean 100%** — the same top score, shown by surface: **✪** (the Proof Seal) on code surfaces — CLI, skills, docs, the hub — and **🏆** on social: posts, blogs, cards. You'll see both around for a while as the ✪ convention settles in.
+
 ---
 
 ## Sync