faf-cli 6.16.0 → 7.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +20 -4
- package/dist/cli.js +260 -230
- package/dist/cli.js.map +13 -9
- package/dist/index.js +74 -74
- package/dist/index.js.map +5 -5
- package/dist/interop/faf.d.ts +15 -0
- package/dist/interop/servercard.d.ts +9 -0
- package/package.json +1 -1
- package/project.faf +9 -1
package/README.md
CHANGED
|
@@ -4,9 +4,9 @@
|
|
|
4
4
|
<div style="display: flex; align-items: center; gap: 12px;">
|
|
5
5
|
<img src="https://www.faf.one/orange-smiley.svg" alt="FAF" width="40" />
|
|
6
6
|
<div>
|
|
7
|
-
<h1 style="margin: 0; color: #000000;">faf-cli —
|
|
8
|
-
<p style="margin: 2px 0 0 0; font-size: 0.85em; letter-spacing: 0.12em; opacity: 0.7; text-transform: uppercase;"><strong>
|
|
9
|
-
<p style="margin: 6px 0 0 0;"><strong>
|
|
7
|
+
<h1 style="margin: 0; color: #000000;">faf-cli — The GIT Version</h1>
|
|
8
|
+
<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>
|
|
9
|
+
<p style="margin: 6px 0 0 0;"><strong>FAF is to Context what Git is to Versions.</strong></p>
|
|
10
10
|
<p style="margin: 0;"><strong>Define once. Run anywhere.</strong></p>
|
|
11
11
|
</div>
|
|
12
12
|
</div>
|
|
@@ -63,6 +63,20 @@ Run `faf` with no arguments:
|
|
|
63
63
|
|
|
64
64
|
---
|
|
65
65
|
|
|
66
|
+
## v7.0 — The GIT Version
|
|
67
|
+
|
|
68
|
+
**FAF is to Context what Git is to Versions.**
|
|
69
|
+
|
|
70
|
+
Git gave your *code* diff, log, blame, hooks, CI. v7.0 gives your *context* the same — `project.faf` is now a git-native artifact:
|
|
71
|
+
|
|
72
|
+
- **`faf diff`** — semantic context diff + score delta between any two refs (`85% ● → 100% 🏆`)
|
|
73
|
+
- **`git diff` speaks .faf** — `faf diff --install-driver` makes native `git diff` / `log -p` / `show` render the delta
|
|
74
|
+
- **`faf log`** — the score timeline across history (Proof-Over-Time)
|
|
75
|
+
- **`faf hooks --install`** — pre-commit guard: warn, or `--strict` block, on a context regression
|
|
76
|
+
- **`faf git owner/repo --ref <tag>`** — instant, *versioned*, scored context from any repo
|
|
77
|
+
|
|
78
|
+
Purely additive — a safe upgrade. (One change: `faf git` now refuses to overwrite an existing `project.faf` — pass `--force`.)
|
|
79
|
+
|
|
66
80
|
## v6.16 — Know Your Stack
|
|
67
81
|
|
|
68
82
|
**FAF knows your stack — and now labels it identically in every file it writes: CLAUDE.md, AGENTS.md, copilot-instructions.md, GEMINI.md, .cursorrules.**
|
|
@@ -295,7 +309,7 @@ bunx faf-cli go # Interactive interview to gold code
|
|
|
295
309
|
|
|
296
310
|
| Tier | Score | Status |
|
|
297
311
|
|------|-------|--------|
|
|
298
|
-
| 🏆 **Trophy** | 100% | AI never has to guess |
|
|
312
|
+
| 🏆 / ✪ **Trophy** | 100% | AI never has to guess |
|
|
299
313
|
| ★ **Gold** | 99%+ | 1 slot from Trophy |
|
|
300
314
|
| ◆ **Silver** | 95%+ | Close — keep going |
|
|
301
315
|
| ◇ **Bronze** | 85%+ | Interim — keep going |
|
|
@@ -304,6 +318,8 @@ bunx faf-cli go # Interactive interview to gold code
|
|
|
304
318
|
| ○ **Red** | <55% | AI working blind |
|
|
305
319
|
| ♡ **White** | 0% | No context at all |
|
|
306
320
|
|
|
321
|
+
**🏆 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.
|
|
322
|
+
|
|
307
323
|
---
|
|
308
324
|
|
|
309
325
|
## Sync
|