faf-cli 3.1.4 → 3.1.5
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 +80 -998
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +34 -0
- package/dist/commands/init.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,19 +1,28 @@
|
|
|
1
|
-
<div
|
|
2
|
-
<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/logos/orange-smiley.svg" alt="FAF" width="40"
|
|
3
|
-
<
|
|
4
|
-
|
|
1
|
+
<div style="display: flex; align-items: center; gap: 12px;">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/logos/orange-smiley.svg" alt="FAF" width="40" />
|
|
3
|
+
<div>
|
|
4
|
+
<h1 style="margin: 0; color: #000000;">faf-cli</h1>
|
|
5
|
+
<p style="margin: 4px 0 0 0;"><strong>IANA-Registered Format for AI Context</strong> · <code>application/vnd.faf+yaml</code></p>
|
|
6
|
+
</div>
|
|
5
7
|
</div>
|
|
6
|
-
<br clear="left"/>
|
|
7
8
|
|
|
8
|
-
> Universal CLI for FAF (Foundational AI-context Format)
|
|
9
|
-
|
|
9
|
+
> Universal CLI for FAF (Foundational AI-context Format) - Terminal-based tooling for creating, scoring, and improving project.faf files that provide persistent AI context
|
|
10
|
+
|
|
11
|
+
[](https://www.npmjs.com/package/faf-cli)
|
|
12
|
+
[](https://discord.com/invite/3pjzpKsP)
|
|
13
|
+
[](https://github.com/Wolfe-Jam/homebrew-faf)
|
|
14
|
+
[](https://faf.one)
|
|
15
|
+
[](https://opensource.org/licenses/MIT)
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
10
19
|
## TL;DR
|
|
11
20
|
|
|
12
21
|
**Problem:** AI needs persistent project context to work at its best.
|
|
13
22
|
|
|
14
23
|
**Solution:** The .faf format provides that context. This CLI creates, scores, and improves .faf files from your codebase in the IANA-registered format.
|
|
15
24
|
|
|
16
|
-
**How it works:** Run `faf init` to create your .faf file. Get a score (0-100%) showing context quality. Higher scores = AI more in-tune with your project. Use `faf auto` and other commands to improve your score quickly.
|
|
25
|
+
**How it works:** Run `faf init` to create your .faf file. Get a score (0-100%) showing context quality. Higher scores = AI more in-tune with your project. Use `faf auto` and other commands to improve your score quickly.
|
|
17
26
|
|
|
18
27
|
**Install:**
|
|
19
28
|
```bash
|
|
@@ -27,492 +36,37 @@ brew install faf-cli
|
|
|
27
36
|
**Quick start:**
|
|
28
37
|
```bash
|
|
29
38
|
cd your-project
|
|
30
|
-
faf init # Creates .faf file
|
|
39
|
+
faf init # Creates project.faf file
|
|
31
40
|
faf score # Check AI-readiness (0-100%)
|
|
32
41
|
```
|
|
33
42
|
|
|
34
|
-
**CLI vs MCP clarity
|
|
35
|
-
- **faf-cli** (this):
|
|
36
|
-
- **claude-faf-mcp** ([npm](https://www.npmjs.com/package/claude-faf-mcp)):
|
|
43
|
+
**CLI vs MCP clarity:**
|
|
44
|
+
- **faf-cli** (this): Terminal-based tool for scripts, automation, and local development
|
|
45
|
+
- **claude-faf-mcp** ([npm](https://www.npmjs.com/package/claude-faf-mcp)): MCP server for Claude Desktop via protocol integration
|
|
37
46
|
|
|
38
|
-
Same .faf, different
|
|
39
|
-
|
|
40
|
-
Use CLI for raw speed and local development; use MCP for AI-integrated workflows. No feature gaps between them - pick based on your flow.
|
|
47
|
+
Same .faf format, different execution layers. Same Project DNA and scoring. Same capabilities (create, score, improve). Choose based on your workflow.
|
|
41
48
|
|
|
42
49
|
[Website](https://faf.one) | [GitHub](https://github.com/Wolfe-Jam/faf-cli) | [Discussions](https://github.com/Wolfe-Jam/faf-cli/discussions)
|
|
43
50
|
|
|
44
51
|
---
|
|
45
52
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
<div align="center">
|
|
49
|
-
<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/screenshots/package-json-project-faf.png" alt="project.faf sits between package.json and README.md" width="500" />
|
|
50
|
-
|
|
51
|
-
**`project.faf` sits right between `package.json` and `README.md`** - exactly where it belongs.
|
|
52
|
-
|
|
53
|
-
Visible. Discoverable. Universal.
|
|
54
|
-
</div>
|
|
55
|
-
|
|
56
|
-
---
|
|
57
|
-
|
|
58
|
-
## 📚 Complete Documentation
|
|
59
|
-
|
|
60
|
-
**For developers who want the full story**, here's everything about FAF's architecture, testing, and championship engineering standards.
|
|
61
|
-
|
|
62
|
-
<div align="center">
|
|
63
|
-
|
|
64
|
-
<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/logos/orange-smiley.svg" alt="FAF Logo" width="64" />
|
|
65
|
-
|
|
66
|
-
**Free and Open Source** • **Project DNA for any AI** • **Zero Faff™**
|
|
67
|
-
|
|
68
|
-
[](https://github.com/Wolfe-Jam/faf-cli)
|
|
69
|
-
[](https://www.npmjs.com/package/faf-cli)
|
|
70
|
-
[](https://discord.com/invite/3pjzpKsP)
|
|
71
|
-
[](https://github.com/Wolfe-Jam/homebrew-faf)
|
|
72
|
-
[](https://faf.one)
|
|
73
|
-
[](https://github.com/Wolfe-Jam/faf/blob/main/SPECIFICATION.md)
|
|
74
|
-
[](https://faf.one/blog/iana-registration)
|
|
75
|
-
[](https://opensource.org/licenses/MIT)
|
|
76
|
-
|
|
77
|
-
**[Website](https://faf.one)** • **[Discord](https://discord.com/invite/3pjzpKsP)** • **[GitHub](https://github.com/Wolfe-Jam/faf-cli)** • **[Discussions](https://github.com/Wolfe-Jam/faf-cli/discussions)**
|
|
78
|
-
|
|
79
|
-
</div>
|
|
80
|
-
|
|
81
|
-
---
|
|
82
|
-
|
|
83
|
-
**AI-Context Quality:** Most projects score 0-55% (insufficient context). With .faf: 85-99% (AI fully understands your project).
|
|
84
|
-
|
|
85
|
-
**Built on Championship TypeScript** - The same strict-mode code that powers [claude-faf-mcp](https://www.npmjs.com/package/claude-faf-mcp), the official MCP server in the Anthropic registry ([PR #2759](https://github.com/modelcontextprotocol/servers/pull/2759) merged).
|
|
86
|
-
|
|
87
|
-
## Installation
|
|
88
|
-
|
|
89
|
-
```bash
|
|
90
|
-
# Install via npm (works everywhere)
|
|
91
|
-
npm install -g faf-cli
|
|
92
|
-
|
|
93
|
-
# Or via Homebrew (macOS/Linux)
|
|
94
|
-
brew install faf-cli
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
**One command. Zero configuration. Production-ready.**
|
|
98
|
-
|
|
99
|
-
### Using Claude Desktop?
|
|
100
|
-
|
|
101
|
-
Install the MCP server too for integrated workflows:
|
|
102
|
-
|
|
103
|
-
```bash
|
|
104
|
-
npm install -g claude-faf-mcp
|
|
105
|
-
# or
|
|
106
|
-
brew install wolfe-jam/faf/claude-faf-mcp
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
Add to `claude_desktop_config.json`:
|
|
110
|
-
```json
|
|
111
|
-
{
|
|
112
|
-
"mcpServers": {
|
|
113
|
-
"claude-faf-mcp": {
|
|
114
|
-
"command": "claude-faf-mcp"
|
|
115
|
-
}
|
|
116
|
-
}
|
|
117
|
-
}
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
**[claude-faf-mcp on npm →](https://www.npmjs.com/package/claude-faf-mcp)**
|
|
121
|
-
|
|
122
|
-
---
|
|
123
|
-
|
|
124
|
-
## 🎉 What's New in v3.1.2 - Discord Community Launch
|
|
125
|
-
|
|
126
|
-
**The FAF community is now live!** Join us at [discord.com/invite/3pjzpKsP](https://discord.com/invite/3pjzpKsP)
|
|
127
|
-
|
|
128
|
-
### 🎉 Community & Automation
|
|
129
|
-
- **Official Discord Server** - 6 focused channels (announcements, general, showcase, help, integrations, w3c-and-standards)
|
|
130
|
-
- **GitHub Actions Automation** - Automated release announcements to Discord
|
|
131
|
-
- **Low Maintenance Design** - Open community structure with auto-moderation
|
|
132
|
-
|
|
133
|
-
### 🏆 Enhanced Reliability - We are Enterprise ready
|
|
134
|
-
- **Enterprise-Grade Testing** - Stress tested for large repositories and monorepos
|
|
135
|
-
- **Improved Stability** - Enhanced test infrastructure for championship performance
|
|
136
|
-
|
|
137
|
-
**Join the community:** [discord.com/invite/3pjzpKsP](https://discord.com/invite/3pjzpKsP)
|
|
138
|
-
|
|
139
|
-
---
|
|
140
|
-
|
|
141
|
-
## 🎉 What's New in v3.1.1 - IANA Registration
|
|
142
|
-
|
|
143
|
-
**v3.1.1 updates documentation with IANA registration achievement.**
|
|
144
|
-
|
|
145
|
-
On **October 31, 2025**, the Internet Assigned Numbers Authority (IANA) officially registered `.faf` as `application/vnd.faf+yaml` - making it an Internet-standard format alongside PDF, JSON, and XML.
|
|
146
|
-
|
|
147
|
-
**What this means:**
|
|
148
|
-
- faf-cli now creates official Internet-standard files
|
|
149
|
-
- Proper HTTP Content-Type headers (`application/vnd.faf+yaml`)
|
|
150
|
-
- Browser and email client support for `.faf` files
|
|
151
|
-
- API standardization across platforms
|
|
152
|
-
- Infrastructure-level legitimacy
|
|
153
|
-
|
|
154
|
-
This documentation update adds IANA information throughout the README to reflect this major achievement for the format.
|
|
155
|
-
|
|
156
|
-
---
|
|
157
|
-
|
|
158
|
-
## 🎉 What's New in v3.1.0
|
|
159
|
-
|
|
160
|
-
### 🔥 THE VISIBILITY REVOLUTION 🔥
|
|
161
|
-
|
|
162
|
-
**AI context just became UNIVERSAL. project.faf is here.**
|
|
163
|
-
|
|
164
|
-
For too long, `.faf` lived in the shadows - hidden, invisible, forgotten. **NOT ANYMORE.**
|
|
165
|
-
|
|
166
|
-
### 📂 Introducing: `project.faf`
|
|
167
|
-
|
|
168
|
-
## **`package.json` for AI**
|
|
169
|
-
|
|
170
|
-
**Just like `package.json` tells npm what your project needs...**
|
|
171
|
-
**`project.faf` tells AI what your project IS.**
|
|
172
|
-
|
|
173
|
-
| File | Purpose | Who Reads It |
|
|
174
|
-
|------|---------|--------------|
|
|
175
|
-
| `package.json` | Dependencies, scripts, metadata | npm, Node.js, developers |
|
|
176
|
-
| `project.faf` | **Context, architecture, purpose** | **AI, Claude, Cursor, any AI tool** |
|
|
177
|
-
|
|
178
|
-
**Same pattern. Same universality. Same necessity.**
|
|
179
|
-
|
|
180
|
-
**VISIBLE. DISCOVERABLE. UNIVERSAL.**
|
|
181
|
-
|
|
182
|
-
```bash
|
|
183
|
-
# The old way (hidden like .env)
|
|
184
|
-
ls -la
|
|
185
|
-
.env # 🔒 Hidden (secrets - SHOULD be hidden)
|
|
186
|
-
.faf # 👻 Hidden (AI context - SHOULD be visible!)
|
|
187
|
-
|
|
188
|
-
# The NEW WAY (visible like package.json)
|
|
189
|
-
ls
|
|
190
|
-
package.json # ✅ Visible (dependencies - everyone needs to see)
|
|
191
|
-
project.faf # ✅ Visible (AI context - AI needs to find this!)
|
|
192
|
-
.env # 🔒 Still hidden (secrets stay secret)
|
|
193
|
-
```
|
|
194
|
-
|
|
195
|
-
**`.env` hides secrets. `project.faf` shares context.**
|
|
196
|
-
|
|
197
|
-
**`.faf` was hiding in the wrong category. `project.faf` fixes that.**
|
|
198
|
-
|
|
199
|
-
### 🚀 Why This Changes Everything
|
|
200
|
-
|
|
201
|
-
**Before:**
|
|
202
|
-
- Hidden `.faf` files easily forgotten
|
|
203
|
-
- Hard to discover in new projects
|
|
204
|
-
- "Wait, does this project have AI context?"
|
|
205
|
-
- Invisible to Git UIs, IDEs, file managers
|
|
206
|
-
|
|
207
|
-
**After:**
|
|
208
|
-
- `project.faf` sits next to `package.json`
|
|
209
|
-
- **IMPOSSIBLE TO MISS**
|
|
210
|
-
- Universal pattern developers already know
|
|
211
|
-
- Every project SHOWS its AI-readiness
|
|
212
|
-
|
|
213
|
-
### 🔺 The Golden Triangle
|
|
214
|
-
|
|
215
|
-
**Three sides. Closed loop. Complete accountability.**
|
|
216
|
-
|
|
217
|
-
```
|
|
218
|
-
project.faf
|
|
219
|
-
(WHAT IT IS)
|
|
220
|
-
/ \
|
|
221
|
-
/ \
|
|
222
|
-
/ \
|
|
223
|
-
repo ←→ .taf
|
|
224
|
-
(CODE) (PROOF IT WORKS)
|
|
225
|
-
```
|
|
226
|
-
|
|
227
|
-
Every project needs three things:
|
|
228
|
-
- **Code that works** (repo)
|
|
229
|
-
- **Context for AI** (project.faf)
|
|
230
|
-
- **Proof it works** (.taf - git-tracked testing timeline)
|
|
231
|
-
|
|
232
|
-
**TAF** (Testing Audit File) format tracks every test run in git. On-the-fly CI/CD updates. Permanent audit trail. Unheard of in CI/CD.
|
|
233
|
-
|
|
234
|
-
**Traditional CI/CD:** Tests run → Results disappear → No permanent record
|
|
235
|
-
**TAF:** Tests run → .taf updates → Git commits → Permanent timeline
|
|
236
|
-
|
|
237
|
-
Format defined in **faf-taf-git** (GitHub Actions native support).
|
|
238
|
-
|
|
239
|
-
### ✨ The Essential Trio
|
|
240
|
-
|
|
241
|
-
```bash
|
|
242
|
-
your-project/
|
|
243
|
-
├── package.json # What your project NEEDS (dependencies)
|
|
244
|
-
├── project.faf # What your project IS (context for AI)
|
|
245
|
-
└── tsconfig.json # How your project BUILDS (TypeScript config)
|
|
246
|
-
```
|
|
247
|
-
|
|
248
|
-
**`package.json`** → Tells npm: "Install these dependencies"
|
|
249
|
-
**`project.faf`** → Tells AI: "This is what I am, this is my purpose"
|
|
250
|
-
**`tsconfig.json`** → Tells TypeScript: "Compile with these settings"
|
|
251
|
-
|
|
252
|
-
**All visible. All universal. All essential.**
|
|
253
|
-
|
|
254
|
-
**You wouldn't skip `package.json`. Don't skip `project.faf`.**
|
|
255
|
-
|
|
256
|
-
### 🔥 New Commands
|
|
257
|
-
|
|
258
|
-
**1. `faf migrate` - Instant Upgrade**
|
|
259
|
-
```bash
|
|
260
|
-
faf migrate
|
|
261
|
-
# .faf → project.faf (27ms)
|
|
262
|
-
```
|
|
263
|
-
|
|
264
|
-
**2. `faf rename` - Bulk Power**
|
|
265
|
-
```bash
|
|
266
|
-
faf rename
|
|
267
|
-
# Recursively migrates ENTIRE monorepo tree
|
|
268
|
-
# Found 147 .faf files? ✅ Migrated in 420ms
|
|
269
|
-
```
|
|
270
|
-
|
|
271
|
-
**3. Auto-Magic for New Projects**
|
|
272
|
-
```bash
|
|
273
|
-
faf init # Creates project.faf (not .faf)
|
|
274
|
-
faf auto # Creates project.faf
|
|
275
|
-
```
|
|
276
|
-
|
|
277
|
-
### 🎯 Championship Detection Upgrade
|
|
278
|
-
|
|
279
|
-
**TSA Engine Integration** - "We're INSPECTORS, not trash collectors"
|
|
280
|
-
|
|
281
|
-
**Before (naive):**
|
|
282
|
-
```
|
|
283
|
-
Has 'commander' in package.json? → Maybe CLI
|
|
284
|
-
```
|
|
285
|
-
|
|
286
|
-
**After (championship):**
|
|
287
|
-
```
|
|
288
|
-
'commander' imported 10+ times? → DEFINITELY CLI
|
|
289
|
-
Analyzes CORE dependencies (actual usage)
|
|
290
|
-
95% accuracy vs 70% accuracy
|
|
291
|
-
```
|
|
292
|
-
|
|
293
|
-
### ⚡ Performance
|
|
294
|
-
|
|
295
|
-
- **migrate:** 27ms (54% faster than 50ms target)
|
|
296
|
-
- **rename:** 27ms for 3 files (73% faster than target)
|
|
297
|
-
- **championship grade** across all operations
|
|
298
|
-
|
|
299
|
-
### 🏆 WJTTC GOLD Certification
|
|
300
|
-
|
|
301
|
-
**97/100 Championship Score**
|
|
302
|
-
- Project Understanding: 20/20
|
|
303
|
-
- TURBO-CAT Knowledge: 20/20
|
|
304
|
-
- Architecture Understanding: 20/20
|
|
305
|
-
|
|
306
|
-
Full report: 194KB comprehensive test suite
|
|
307
|
-
|
|
308
|
-
### 🔙 100% Backward Compatible
|
|
309
|
-
|
|
310
|
-
**Still works with `.faf` files** - graceful transition, no breaking changes.
|
|
311
|
-
|
|
312
|
-
Your old `.faf` files keep working. Migrate when ready.
|
|
313
|
-
|
|
314
|
-
### 🌍 The Vision
|
|
315
|
-
|
|
316
|
-
**Every project with a `package.json` should have a `project.faf`**
|
|
317
|
-
|
|
318
|
-
Just like every TypeScript project has `tsconfig.json`, every Rust project has `Cargo.toml`, every Python project has `requirements.txt`...
|
|
319
|
-
|
|
320
|
-
**Every AI-augmented project has `project.faf`**
|
|
321
|
-
|
|
322
|
-
**This is the new universal standard for AI context.**
|
|
323
|
-
|
|
324
|
-
---
|
|
325
|
-
|
|
326
|
-
## 🎉 What's New in v3.0.0
|
|
327
|
-
|
|
328
|
-
### The Podium Release
|
|
329
|
-
|
|
330
|
-
**The biggest release yet:**
|
|
331
|
-
|
|
332
|
-
- 🆓 **FREE FOREVER .faf Core-Engine** - 41 championship commands, always free, open source, MIT License
|
|
333
|
-
- 💨 **TURBO Model Introduced** - Like VS Code + Copilot, Spotify Free + Premium, Zoom Basic + Pro
|
|
334
|
-
- 😽 **TURBO-CAT™ Format Discovery** - Introduced in v2.0.0, now purring at full power in v3.0.0 - 153 validated formats organized in a perfect pyramid
|
|
335
|
-
- 🧬 **Birth DNA Lifecycle** - Track your project's evolution from birth to championship
|
|
336
|
-
- 🏆 **7-Tier Podium Scoring** - 🏆 🥇 🥈 🥉 🟢 🟡 🔴 🤍 - From Lonely Heart to Podium Champion
|
|
337
|
-
- ⚖️ **AI | HUMAN Balance** - 50|50 system = Optimal Context for championship performance
|
|
338
|
-
- 🔗 **Context-Mirroring w/Bi-Sync** - Bidirectional .faf ↔ CLAUDE.md synchronization
|
|
339
|
-
- ⚡ **Podium Speed** - 8ms bi-sync, <50ms all commands, 18ms avg, 0ms operations achieved
|
|
340
|
-
- 🏁 **WJTTC GOLD Certified** - 1,000+ comprehensive tests, unique test suite
|
|
341
|
-
- 🤖 **BIG-3 AI Validation** - Verified by Google Gemini, Anthropic Claude, OpenAI Codex
|
|
342
|
-
- 🌐 **Universal AI Support** - Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor, Warp, Copilot, Windsurf, ALL AI coding assistants
|
|
343
|
-
- 🤖 **AI-Automation Ready** - Reads n8n workflows, OpenAI Builder schemas, Google Opal, Make.com - Project DNA for automation platforms
|
|
344
|
-
|
|
345
|
-
---
|
|
346
|
-
|
|
347
|
-
## 🤖 What The AIs Said (During Verified Testing)
|
|
348
|
-
|
|
349
|
-
### The BIG-3 Validation
|
|
350
|
-
|
|
351
|
-
**Google Gemini CLI**
|
|
352
|
-
> "README evolution for AI era"
|
|
353
|
-
|
|
354
|
-
— *9.5/10 Rating during verified testing*
|
|
355
|
-
|
|
356
|
-
**Claude Code (Anthropic)**
|
|
357
|
-
> "Should become the standard"
|
|
358
|
-
|
|
359
|
-
— *9.5/10 Rating during verified testing*
|
|
360
|
-
|
|
361
|
-
**OpenAI Codex CLI**
|
|
362
|
-
> "Every project should have one"
|
|
363
|
-
|
|
364
|
-
— *9/10 Rating during verified testing*
|
|
365
|
-
|
|
366
|
-
---
|
|
367
|
-
|
|
368
|
-
### The Context Problem, Solved
|
|
369
|
-
|
|
370
|
-
**— .faf Inventor**
|
|
371
|
-
> "package.json wasn't built for this, .faf was"
|
|
372
|
-
|
|
373
|
-
**— Claude Code (Anthropic)**
|
|
374
|
-
> "package.json gives me a list of dependencies,
|
|
375
|
-
> .faf shows me how to use them"
|
|
376
|
-
|
|
377
|
-
**— Claude**
|
|
378
|
-
> "It's so logical if it didn't exist,
|
|
379
|
-
> AI would have built it itself"
|
|
380
|
-
|
|
381
|
-
---
|
|
382
|
-
|
|
383
|
-
**100% verified. Real AI responses. Not marketing copy.**
|
|
384
|
-
|
|
385
|
-
---
|
|
386
|
-
|
|
387
|
-
## 😽 TURBO-CAT™ - Full Official Launch
|
|
388
|
-
|
|
389
|
-
**The Rapid Catalytic Converter - Now Purring at Full Power**
|
|
390
|
-
|
|
391
|
-
Introduced in v2.0.0, TURBO-CAT reaches full championship form in v3.0.0. This format discovery engine knows 153 validated formats organized in a perfect pyramid structure. From `.faf` at the apex to infrastructure configs at the base, it rapidly converts raw project formats into AI-ready intelligence at championship speed.
|
|
392
|
-
|
|
393
|
-
Like a catalytic converter in an exhaust system, TURBO-CAT transforms digital waste into clean, usable output.
|
|
394
|
-
Now fully unleashed and purring. 😽💨
|
|
395
|
-
|
|
396
|
-
```bash
|
|
397
|
-
faf formats
|
|
398
|
-
```
|
|
399
|
-
|
|
400
|
-
```
|
|
401
|
-
😽 TURBO-CAT™ v3.0.0 - Now Purring at Full Power
|
|
402
|
-
(Introduced v2.0.0, Perfected v3.0.0)
|
|
403
|
-
═══════════════════════════════════
|
|
404
|
-
|
|
405
|
-
⚡️ Scanning project...
|
|
406
|
-
|
|
407
|
-
✅ Found 10 formats in 68ms!
|
|
408
|
-
|
|
409
|
-
📋 Discovered Formats (A-Z):
|
|
410
|
-
✅ package.json
|
|
411
|
-
✅ tsconfig.json
|
|
412
|
-
✅ Dockerfile
|
|
413
|
-
✅ .github/workflows
|
|
414
|
-
✅ jest.config.js
|
|
415
|
-
... and 5 more
|
|
416
|
-
|
|
417
|
-
💡 Stack Signature: typescript
|
|
418
|
-
🏆 Intelligence Score: 225
|
|
419
|
-
|
|
420
|
-
────────────────────────────────────────
|
|
421
|
-
😽 TURBO-CAT™: "Detection that'll make your stack PURRR!"
|
|
422
|
-
────────────────────────────────────────
|
|
423
|
-
```
|
|
424
|
-
|
|
425
|
-
**The Pyramid:** 153 formats across 17 levels. Each level unlocks new intelligence. **TURBO** reveals what TURBO-CAT really knows... 🤫
|
|
426
|
-
|
|
427
|
-
---
|
|
428
|
-
|
|
429
|
-
## 💨 FAF TURBO - World-Class Automation Intelligence
|
|
430
|
-
|
|
431
|
-
### Like **VS Code + Copilot** • Same model that works!
|
|
53
|
+
## Project DNA Positioning
|
|
432
54
|
|
|
433
55
|
<div align="center">
|
|
434
|
-
|
|
435
|
-
<
|
|
436
|
-
<tr>
|
|
437
|
-
<td width="50%" valign="top">
|
|
438
|
-
|
|
439
|
-
### **FAF v3.0.3 (FREE FOR ALL DEVS)** 🆓
|
|
440
|
-
|
|
441
|
-
✅ **41 Podium Commands**
|
|
442
|
-
- Project initialization & auto-detection
|
|
443
|
-
- TURBO-CAT format discovery (153 formats)
|
|
444
|
-
- Birth DNA lifecycle tracking
|
|
445
|
-
- AI readiness scoring (0-100%)
|
|
446
|
-
- Context-mirroring (bi-sync)
|
|
447
|
-
- Health checks & diagnostics
|
|
448
|
-
|
|
449
|
-
✅ **Performance**
|
|
450
|
-
- <50ms command execution
|
|
451
|
-
- 8ms bi-sync (championship speed)
|
|
452
|
-
- F1-inspired engineering
|
|
453
|
-
- 0ms operations achieved
|
|
454
|
-
|
|
455
|
-
✅ **Universal Compatibility**
|
|
456
|
-
- Works with Claude, Codex CLI, Gemini CLI, Cursor
|
|
457
|
-
- Mac, Linux, Windows support
|
|
458
|
-
- Open source, MIT licensed
|
|
459
|
-
- Growing developer community
|
|
460
|
-
|
|
461
|
-
```bash
|
|
462
|
-
# Install via npm (works everywhere)
|
|
463
|
-
npm install -g faf-cli
|
|
464
|
-
|
|
465
|
-
# Or via Homebrew (macOS/Linux)
|
|
466
|
-
brew install faf-cli
|
|
467
|
-
```
|
|
468
|
-
|
|
469
|
-
</td>
|
|
470
|
-
<td width="50%" valign="top">
|
|
471
|
-
|
|
472
|
-
### **FAF v3.0.3 TURBO** 💨
|
|
473
|
-
|
|
474
|
-
✅ **Everything in FREE, Plus:**
|
|
475
|
-
|
|
476
|
-
🧬 **Deep Format Intelligence**
|
|
477
|
-
- Pyramid-level insights (17 levels deep)
|
|
478
|
-
- Cross-format relationship analysis
|
|
479
|
-
- Stack health diagnostics
|
|
480
|
-
- Migration path recommendations
|
|
481
|
-
|
|
482
|
-
🤖 **Universal Automation Intelligence**
|
|
483
|
-
- **n8n workflow parsing** - RAG, ETL, Multi-Agent patterns
|
|
484
|
-
- **OpenAI Assistants** - GPT Actions & function schemas
|
|
485
|
-
- **Google Opal** - Visual mini-app workflows
|
|
486
|
-
- **Make.com scenarios** - Module & integration analysis
|
|
487
|
-
- **FOUNDATIONAL FIRST** - ONE pattern for ALL platforms
|
|
488
|
-
|
|
489
|
-
🏆 **Premium Features**
|
|
490
|
-
- Priority support & service plans
|
|
491
|
-
- Advanced TURBO-CAT capabilities
|
|
492
|
-
- Enterprise integrations
|
|
493
|
-
- Early access to new features
|
|
494
|
-
|
|
495
|
-
```bash
|
|
496
|
-
Learn more: faf.one/turbo
|
|
497
|
-
```
|
|
498
|
-
|
|
499
|
-
</td>
|
|
500
|
-
</tr>
|
|
501
|
-
</table>
|
|
502
|
-
|
|
56
|
+
<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/Project-faf-pckg-json-README.png" alt="project.faf file positioning" width="600" />
|
|
57
|
+
<p><em>project.faf lives at the project root, between package.json and README.md</em></p>
|
|
503
58
|
</div>
|
|
504
59
|
|
|
505
|
-
|
|
506
|
-
**Foundational first, universal by default.**
|
|
60
|
+
At 55% you are building your project with half a blueprint and basically flipping a coin with AI. .FAF defines, and AI becomes optimized for Context with the project.faf file.
|
|
507
61
|
|
|
508
62
|
---
|
|
509
63
|
|
|
510
|
-
##
|
|
64
|
+
## Quick Start
|
|
511
65
|
|
|
512
66
|
### Installation
|
|
513
67
|
|
|
514
68
|
```bash
|
|
515
|
-
# npm (
|
|
69
|
+
# npm (works everywhere)
|
|
516
70
|
npm install -g faf-cli
|
|
517
71
|
|
|
518
72
|
# Homebrew (macOS/Linux)
|
|
@@ -530,10 +84,10 @@ faf init
|
|
|
530
84
|
```
|
|
531
85
|
|
|
532
86
|
**What just happened:**
|
|
533
|
-
-
|
|
534
|
-
-
|
|
535
|
-
-
|
|
536
|
-
-
|
|
87
|
+
- Created project.faf file (IANA-registered format)
|
|
88
|
+
- Generated project DNA (architecture, dependencies, quality score)
|
|
89
|
+
- Ready for any AI (Claude Code, Gemini, Cursor, Codex, Warp, etc.)
|
|
90
|
+
- Official Internet standard format
|
|
537
91
|
|
|
538
92
|
### More Commands
|
|
539
93
|
|
|
@@ -551,451 +105,78 @@ faf formats
|
|
|
551
105
|
faf bi-sync
|
|
552
106
|
```
|
|
553
107
|
|
|
554
|
-
**That's it!** Your AI now has perfect context.
|
|
108
|
+
**That's it!** Your AI now has perfect context.
|
|
555
109
|
|
|
556
110
|
---
|
|
557
111
|
|
|
558
|
-
##
|
|
112
|
+
## Core Features
|
|
559
113
|
|
|
560
|
-
|
|
114
|
+
### 41 Championship Commands
|
|
115
|
+
- **faf auto** - Zero to Podium in one command
|
|
116
|
+
- **faf init** - Create project.faf from your project
|
|
117
|
+
- **faf enhance** - Real AI analysis and improvements
|
|
118
|
+
- **faf score** - AI-readiness scoring (0-100%)
|
|
119
|
+
- **faf formats** - 153 formats across 17-level pyramid
|
|
120
|
+
- **faf bi-sync** - Bidirectional .faf ↔ CLAUDE.md (8ms!)
|
|
121
|
+
- **faf dna** - Evolution journey tracking
|
|
561
122
|
|
|
562
|
-
|
|
123
|
+
Run `faf --help` for complete command reference
|
|
563
124
|
|
|
564
|
-
###
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
125
|
+
### IANA-Registered Standard
|
|
126
|
+
- Official MIME type: `application/vnd.faf+yaml`
|
|
127
|
+
- Recognized at Internet scale (same as PDF, JSON, XML)
|
|
128
|
+
- Proper HTTP Content-Type headers
|
|
129
|
+
- Browser and email client support
|
|
130
|
+
- Universal format for AI context
|
|
570
131
|
|
|
571
|
-
|
|
132
|
+
### Championship Performance
|
|
133
|
+
- **<50ms** all commands target
|
|
134
|
+
- **18ms** average execution
|
|
135
|
+
- **8ms** bi-sync achieved
|
|
136
|
+
- **0ms** operations possible (unmeasurable speed!)
|
|
137
|
+
- F1-grade engineering
|
|
572
138
|
|
|
573
|
-
###
|
|
574
|
-
|
|
575
|
-
<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/demos/faf-init-demo.gif" alt="Running faf init - 344ms" width="700" />
|
|
576
|
-
</div>
|
|
139
|
+
### Universal AI Support
|
|
140
|
+
Works with Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor, Warp, Copilot, Windsurf, and all AI coding assistants.
|
|
577
141
|
|
|
578
|
-
|
|
142
|
+
**PLUS:** AI-Automation platforms (n8n, OpenAI Builder, Google Opal, Make.com)
|
|
579
143
|
|
|
580
144
|
---
|
|
581
145
|
|
|
582
|
-
|
|
583
|
-
<div align="center">
|
|
584
|
-
<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/demos/growth-to-89-percent.png" alt="FAF CLI after .faf: 89% context score" width="700" />
|
|
585
|
-
</div>
|
|
146
|
+
## Documentation
|
|
586
147
|
|
|
587
|
-
**
|
|
588
|
-
|
|
589
|
-
|
|
148
|
+
- **[CHANGELOG](./CHANGELOG.md)** - Version history and release notes
|
|
149
|
+
- **[FAQ](./docs/FAQ.md)** - Common questions
|
|
150
|
+
- **[Commands Reference](https://faf.one/docs/commands)** - All 41 commands
|
|
151
|
+
- **[Website](https://faf.one)** - Complete guide and documentation
|
|
152
|
+
- **[Discord Community](https://discord.com/invite/3pjzpKsP)** - Join the discussion
|
|
590
153
|
|
|
591
154
|
---
|
|
592
155
|
|
|
593
|
-
##
|
|
594
|
-
|
|
595
|
-
**`.faf` = Project DNA ✨ for AI**
|
|
596
|
-
|
|
597
|
-
Universal, shareable AI context that works with **Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor** - regardless of your stack, size, or setup.
|
|
598
|
-
|
|
599
|
-
## Why IANA Registration Matters
|
|
600
|
-
|
|
601
|
-
On **October 31, 2025**, the Internet Assigned Numbers Authority (IANA) officially registered `.faf` as `application/vnd.faf+yaml`.
|
|
602
|
-
|
|
603
|
-
This means `.faf` is now:
|
|
604
|
-
|
|
605
|
-
✅ **Recognized at Internet scale** - Same legitimacy as PDF, JSON, XML
|
|
606
|
-
✅ **Properly handled by browsers** - Correct MIME type detection
|
|
607
|
-
✅ **Supported in HTTP headers** - `Content-Type: application/vnd.faf+yaml`
|
|
608
|
-
✅ **Email client compatible** - Attachments handled correctly
|
|
609
|
-
✅ **API standardized** - Universal format for AI context exchange
|
|
610
|
-
|
|
611
|
-
**faf-cli creates these official IANA-registered files.**
|
|
612
|
-
|
|
613
|
-
### The Journey to IANA
|
|
614
|
-
|
|
615
|
-
- **Aug 8, 2024** - Format specification created
|
|
616
|
-
- **Sep 2025** - Google Chrome approvals (2x)
|
|
617
|
-
- **Oct 17, 2025** - Anthropic MCP Registry merger
|
|
618
|
-
- **Oct 31, 2025** - **IANA Registration** 🏆
|
|
619
|
-
|
|
620
|
-
From concept to Internet standard in 15 months.
|
|
621
|
-
|
|
622
|
-
### Why Context Quality Matters
|
|
156
|
+
## Why FAF CLI?
|
|
623
157
|
|
|
624
|
-
|
|
158
|
+
> "README for the AI era" — Gemini CLI
|
|
625
159
|
|
|
626
|
-
**
|
|
160
|
+
**Persistent Context** - Your project's DNA lives in `project.faf`, readable by any AI or human
|
|
627
161
|
|
|
628
|
-
|
|
162
|
+
**Universal Format** - IANA-registered standard works across Claude, Gemini, Codex, any LLM
|
|
629
163
|
|
|
630
|
-
|
|
164
|
+
**Terminal-Native** - Built for scripts, automation, and developer workflows
|
|
631
165
|
|
|
632
|
-
**
|
|
633
|
-
|
|
634
|
-
Running projects on LOW AI context leads to:
|
|
635
|
-
- ❌ **Project death** (worst case)
|
|
636
|
-
- ❌ **Delays, costs, stress, heartache, disappointment**
|
|
637
|
-
- ❌ **Wasted time, resources, and money**
|
|
638
|
-
- ❌ **Poor outcomes for stakeholders and users**
|
|
639
|
-
- ❌ **Burnout from constant re-explaining**
|
|
640
|
-
|
|
641
|
-
**It's not a one-time config. It's a relationship.**
|
|
642
|
-
|
|
643
|
-
A healthy Human + AI collaboration requires **high-quality, persistent context**. Without it, every interaction is a gamble. Every decision is questionable. Every suggestion needs verification.
|
|
644
|
-
|
|
645
|
-
**Ignoring poor context on your project is like not brushing your child's teeth.**
|
|
646
|
-
|
|
647
|
-
You're gonna end up with a **CAVITY**.
|
|
648
|
-
|
|
649
|
-
### The Solution: Project DNA
|
|
650
|
-
|
|
651
|
-
- ✅ **Podium context** (85-99% quality scores)
|
|
652
|
-
- ✅ **Persistent intelligence** - AI remembers your project perfectly
|
|
653
|
-
- ✅ **Seamless collaboration** - Human + AI working together optimally
|
|
654
|
-
- ✅ **Project health monitoring** - Track context quality over time
|
|
655
|
-
- ✅ **Works with every AI** - Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor, all of them
|
|
656
|
-
- ✅ **Team alignment** - Everyone (human AND AI) on the same page
|
|
166
|
+
**Championship Engineering** - F1-inspired performance with strict TypeScript, zero runtime errors
|
|
657
167
|
|
|
658
168
|
---
|
|
659
169
|
|
|
660
|
-
##
|
|
661
|
-
|
|
662
|
-
### 🏎️ Power Commands
|
|
663
|
-
```bash
|
|
664
|
-
faf auto # ONE COMMAND TO RULE THEM ALL - Zero to Podium
|
|
665
|
-
faf init # Create .faf from your project
|
|
666
|
-
faf enhance # Real AI analysis & improvements
|
|
667
|
-
faf analyze # Claude-first intelligence
|
|
668
|
-
```
|
|
669
|
-
|
|
670
|
-
### 😽 TURBO-CAT Commands
|
|
671
|
-
```bash
|
|
672
|
-
faf formats # 153 formats across 17-level pyramid
|
|
673
|
-
faf stacks # Technology stack signatures
|
|
674
|
-
faf vibe # Detect development platform
|
|
675
|
-
```
|
|
170
|
+
## Ecosystem
|
|
676
171
|
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
faf
|
|
681
|
-
faf update # Save checkpoint
|
|
682
|
-
faf recover # Disaster recovery
|
|
683
|
-
faf auth # Birth certificate authentication
|
|
684
|
-
```
|
|
685
|
-
|
|
686
|
-
### 🏆 Scoring & Trust
|
|
687
|
-
```bash
|
|
688
|
-
faf score # Rate completeness (0-100%)
|
|
689
|
-
faf trust # Unified trust dashboard
|
|
690
|
-
faf credit # Technical credit dashboard
|
|
691
|
-
faf check # Comprehensive validation
|
|
692
|
-
faf validate # Structure validation
|
|
693
|
-
faf audit # Freshness check
|
|
694
|
-
```
|
|
695
|
-
|
|
696
|
-
### ⚡ Creative & Quick
|
|
697
|
-
```bash
|
|
698
|
-
faf chat # Natural language generation (terminal only)
|
|
699
|
-
faf quick # One-liner instant context
|
|
700
|
-
```
|
|
701
|
-
|
|
702
|
-
### 🎸 Skills & Integration
|
|
703
|
-
```bash
|
|
704
|
-
faf skills # List Claude Code skills from .faf file
|
|
705
|
-
```
|
|
706
|
-
|
|
707
|
-
### 🔍 Discovery & Verification
|
|
708
|
-
```bash
|
|
709
|
-
faf verify # Test with Claude Code, OpenAI Codex CLI, Gemini CLI
|
|
710
|
-
faf doctor # Diagnose & fix issues
|
|
711
|
-
faf search # Content search with highlighting
|
|
712
|
-
```
|
|
713
|
-
|
|
714
|
-
### 🔗 Sync & Mirror
|
|
715
|
-
```bash
|
|
716
|
-
faf bi-sync # Bidirectional .faf ↔ CLAUDE.md (8ms!)
|
|
717
|
-
faf sync # Dependency updates
|
|
718
|
-
faf tsa # Inspect dependencies
|
|
719
|
-
```
|
|
720
|
-
|
|
721
|
-
### 📝 Editing & Management
|
|
722
|
-
```bash
|
|
723
|
-
faf edit # Interactive editor
|
|
724
|
-
faf convert # YAML to Markdown/Text
|
|
725
|
-
faf to-txt # Quick text conversion
|
|
726
|
-
faf share # Secure sharing with auto-sanitization
|
|
727
|
-
```
|
|
728
|
-
|
|
729
|
-
### 📊 Information & Help
|
|
730
|
-
```bash
|
|
731
|
-
faf show # Display stats
|
|
732
|
-
faf status # Quick health status
|
|
733
|
-
faf version # Show version (with ASCII art!)
|
|
734
|
-
faf index # Universal A-Z reference
|
|
735
|
-
faf faq # Frequently asked questions
|
|
736
|
-
faf welcome # Welcome guide
|
|
737
|
-
```
|
|
738
|
-
|
|
739
|
-
### 🧹 Utilities
|
|
740
|
-
```bash
|
|
741
|
-
faf clear # Clear caches & reset state
|
|
742
|
-
faf todo # Claude-inspired todo system
|
|
743
|
-
faf analytics # Usage analytics & telemetry
|
|
744
|
-
faf notifications # Email notifications
|
|
745
|
-
faf lint # Fix formatting issues
|
|
746
|
-
```
|
|
747
|
-
|
|
748
|
-
**Run `faf --help` for complete command reference**
|
|
749
|
-
|
|
750
|
-
---
|
|
751
|
-
|
|
752
|
-
## 🤖 Works with AI Assistants
|
|
753
|
-
|
|
754
|
-
FAF v3.0.3 fully supports **Claude Code, Warp, Cursor, Copilot, Windsurf, OpenAI Codex CLI, Gemini CLI** and ALL AI coding assistants.
|
|
755
|
-
|
|
756
|
-
**PLUS AI-Automation platforms:** n8n, OpenAI Builder, Google Opal, Make.com
|
|
757
|
-
|
|
758
|
-
### ✅ These Commands Work Everywhere
|
|
759
|
-
```bash
|
|
760
|
-
faf init # Create .faf file
|
|
761
|
-
faf auto # Auto-enhance context
|
|
762
|
-
faf enhance # Improve programmatically
|
|
763
|
-
faf score # Check readiness
|
|
764
|
-
faf bi-sync # Sync .faf ↔ CLAUDE.md
|
|
765
|
-
faf formats # Format discovery
|
|
766
|
-
```
|
|
767
|
-
|
|
768
|
-
### 💡 Avoid in AI Assistants
|
|
769
|
-
```bash
|
|
770
|
-
faf chat # Requires interactive terminal
|
|
771
|
-
faf # Interactive menu (use faf auto instead)
|
|
772
|
-
```
|
|
773
|
-
|
|
774
|
-
**Why?** Interactive commands use `inquirer` for beautiful CLI menus. These work in regular terminals but AI assistants can't forward keyboard input. **This is expected behavior.**
|
|
775
|
-
|
|
776
|
-
**Solution:** Use `faf auto` - it's designed for AI assistants! ⚡
|
|
777
|
-
|
|
778
|
-
---
|
|
779
|
-
|
|
780
|
-
## 🏆 Podium Scoring
|
|
781
|
-
|
|
782
|
-
Track your project's AI-readiness with F1-inspired tiers:
|
|
783
|
-
|
|
784
|
-
```
|
|
785
|
-
🏆 Trophy (100%) - Podium - Perfect 50|50 AI|HUMAN balance
|
|
786
|
-
🥇 Gold (99%) - Gold standard
|
|
787
|
-
🥈 Silver (95-98%) - Excellence
|
|
788
|
-
🥉 Bronze (85-94%) - Production ready
|
|
789
|
-
🟢 Green (70-84%) - Good foundation
|
|
790
|
-
🟡 Yellow (55-69%) - Getting there
|
|
791
|
-
🔴 Red (0-54%) - Needs attention
|
|
792
|
-
🤍 Heart 0% - Starting Good Luck!
|
|
793
|
-
```
|
|
794
|
-
|
|
795
|
-
**Live output:**
|
|
796
|
-
|
|
797
|
-
```bash
|
|
798
|
-
faf score
|
|
799
|
-
```
|
|
800
|
-
|
|
801
|
-
```
|
|
802
|
-
🥉 Score: 89/100
|
|
803
|
-
█████████████████████░░░ 89%
|
|
804
|
-
Status: Bronze - Production Ready
|
|
805
|
-
|
|
806
|
-
Next milestone: 95% 🥈 Silver (6 points to go!)
|
|
807
|
-
|
|
808
|
-
🏎️ FAF Podium Status
|
|
809
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
810
|
-
Initial DNA: 12% (born 2025-10-03)
|
|
811
|
-
Growth: +77% over 4 days
|
|
812
|
-
Next Milestone: 95% 🥈 Silver (6% to go!)
|
|
813
|
-
```
|
|
814
|
-
|
|
815
|
-
---
|
|
816
|
-
|
|
817
|
-
## ⚖️ AI | HUMAN Balance - The 50|50 Podium System
|
|
818
|
-
|
|
819
|
-
**NEW in v3.0.0:** Track the perfect balance between AI-readable and human-readable content.
|
|
820
|
-
|
|
821
|
-
### Normal Balance (Any Ratio)
|
|
822
|
-
<div align="center">
|
|
823
|
-
<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/demos/ai-human-balance-50-50.png" alt="AI|HUMAN Balance at 50/50" width="700" />
|
|
824
|
-
</div>
|
|
825
|
-
|
|
826
|
-
**AI 50% | HUMAN 50%** — Working toward optimal context
|
|
172
|
+
- **[FAF Format Spec](https://github.com/Wolfe-Jam/faf)** - Official IANA specification
|
|
173
|
+
- **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** - MCP server for Claude Desktop
|
|
174
|
+
- **[Chrome Extension](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)** - Browser integration
|
|
175
|
+
- **[faf.one](https://faf.one)** - Official website and documentation
|
|
827
176
|
|
|
828
177
|
---
|
|
829
178
|
|
|
830
|
-
|
|
831
|
-
<div align="center">
|
|
832
|
-
<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/demos/prd-balance-perfect-green.png" alt="PRD Balance - Perfect 50/50 goes GREEN" width="700" />
|
|
833
|
-
</div>
|
|
834
|
-
|
|
835
|
-
**⚖️ PERFECT BALANCE!** — When you hit exactly 50|50, the balance bar turns **GREEN 💚** signaling championship-level context optimization. This is the sweet spot where AI and human readers both get exactly what they need.
|
|
836
|
-
|
|
837
|
-
**PRD Balance = Production-Ready Balance** 🏆
|
|
838
|
-
|
|
839
|
-
---
|
|
840
|
-
|
|
841
|
-
## 💡 Usage Examples
|
|
842
|
-
|
|
843
|
-
```bash
|
|
844
|
-
# Quick setup for new project
|
|
845
|
-
faf quick "my-app, react, typescript, vercel"
|
|
846
|
-
|
|
847
|
-
# Auto-detect existing project
|
|
848
|
-
faf auto
|
|
849
|
-
|
|
850
|
-
# Discover your formats
|
|
851
|
-
faf formats
|
|
852
|
-
|
|
853
|
-
# Check score with details
|
|
854
|
-
faf score --details
|
|
855
|
-
|
|
856
|
-
# Bidirectional sync with CLAUDE.md
|
|
857
|
-
faf bi-sync
|
|
858
|
-
|
|
859
|
-
# Track your evolution
|
|
860
|
-
faf dna
|
|
861
|
-
faf log
|
|
862
|
-
|
|
863
|
-
# Fix issues
|
|
864
|
-
faf doctor
|
|
865
|
-
|
|
866
|
-
# Optimize scoring
|
|
867
|
-
faf enhance
|
|
868
|
-
|
|
869
|
-
# Quiet mode (for AI assistants)
|
|
870
|
-
faf init -q
|
|
871
|
-
faf auto -q
|
|
872
|
-
```
|
|
873
|
-
|
|
874
|
-
---
|
|
875
|
-
|
|
876
|
-
## 📊 Technical Specs
|
|
877
|
-
|
|
878
|
-
```yaml
|
|
879
|
-
Performance: <50ms all commands, 18ms avg, 8ms bi-sync, 0ms operations achieved
|
|
880
|
-
Engine: FAF-Engine-Mk3
|
|
881
|
-
TURBO-CAT: Full Power (153 validated formats)
|
|
882
|
-
TypeScript: 100% strict mode
|
|
883
|
-
Dependencies: 2 (inquirer, yaml)
|
|
884
|
-
Testing: WJTTC GOLD Certified (12,500+ test iterations)
|
|
885
|
-
Certification: https://faf.one/wjttc
|
|
886
|
-
Platform: Mac, Linux, Windows
|
|
887
|
-
AI Support: Universal - Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor, Warp, Copilot, Windsurf, ALL AI coding assistants
|
|
888
|
-
Automation: n8n workflows, OpenAI Builder, Google Opal, Make.com - AI-Automation platforms
|
|
889
|
-
```
|
|
890
|
-
|
|
891
|
-
---
|
|
892
|
-
|
|
893
|
-
## 🏎️ The .faf Pattern
|
|
894
|
-
|
|
895
|
-
### Why .faf vs RAG?
|
|
896
|
-
|
|
897
|
-
**.faf is pre-indexed intelligence.** Do the work once, use it forever.
|
|
898
|
-
|
|
899
|
-
| Aspect | RAG Approach | .faf Approach |
|
|
900
|
-
|--------|-------------|---------------|
|
|
901
|
-
| **Indexing** | Runtime embedding (slow, $) | One-time at creation (fast, free) |
|
|
902
|
-
| **Retrieval** | Vector search per query ($) | Instant file read (free) |
|
|
903
|
-
| **Quality** | Probabilistic, incomplete | Structured, validated, scored |
|
|
904
|
-
| **Latency** | Seconds (embedding + search) | Milliseconds (<50ms) |
|
|
905
|
-
| **Cost** | Per-query fees | Zero runtime cost |
|
|
906
|
-
| **Versioning** | Difficult | Git-friendly YAML |
|
|
907
|
-
|
|
908
|
-
**.faf is RAG's output—captured once, reused infinitely.** Podium efficiency.
|
|
909
|
-
|
|
910
|
-
### Universal Pattern
|
|
911
|
-
|
|
912
|
-
Every source follows the same pattern:
|
|
913
|
-
|
|
914
|
-
```
|
|
915
|
-
interrogation → extraction → filtering → generation → .faf
|
|
916
|
-
```
|
|
917
|
-
|
|
918
|
-
**In FREE CLI:** Code projects → .faf (all languages, frameworks, stacks)
|
|
919
|
-
|
|
920
|
-
**In TURBO:** Automation platforms → .faf (n8n, OpenAI Assistants, Opal, Make.com)
|
|
921
|
-
|
|
922
|
-
Same pattern. Same output. Universal by design.
|
|
923
|
-
|
|
924
|
-
---
|
|
925
|
-
|
|
926
|
-
## 🏆 WJTTC Podium Testing
|
|
927
|
-
|
|
928
|
-
**FAF CLI v3.0.3 is WJTTC GOLD Certified** - tested to F1-grade standards.
|
|
929
|
-
|
|
930
|
-
### What is WJTTC?
|
|
931
|
-
**WolfeJam Technical & Testing Center** - F1-inspired testing methodology ensuring championship-grade reliability.
|
|
932
|
-
|
|
933
|
-
### Certification: 🥇 GOLD (92/100)
|
|
934
|
-
|
|
935
|
-
**Battle-tested with 12,500+ test iterations across 5 testing tiers:**
|
|
936
|
-
- ✅ **BIG-3 AI Validation** (11,200 iterations - Claude, ChatGPT/Codex, Gemini)
|
|
937
|
-
- ✅ **287 Automated Tests** (191 Jest unit + 66 Podium Safety + 30 YOLO torture)
|
|
938
|
-
- ✅ **730 Empirical C.O.R.E Tests** (100% MCP protocol compliance)
|
|
939
|
-
- ✅ **301 Context-On-Demand Tests** (Torture testing, edge cases, stress scenarios)
|
|
940
|
-
- ✅ **35+ Test Documents** (Comprehensive validation reports)
|
|
941
|
-
|
|
942
|
-
**Performance Validated:**
|
|
943
|
-
- ⚡ **0ms operations** achieved (unmeasurable speed!)
|
|
944
|
-
- ⚡ **8ms bi-sync** verified (championship speed)
|
|
945
|
-
- ⚡ **Sub-10ms** for 68% of all operations
|
|
946
|
-
|
|
947
|
-
**Safety Tested:**
|
|
948
|
-
- 🛡️ **7 production-breaking bugs** fixed before release
|
|
949
|
-
- 🛡️ **3 security vulnerabilities** patched proactively
|
|
950
|
-
- 🛡️ **Zero critical failures** in production systems
|
|
951
|
-
|
|
952
|
-
**Platform Verified:**
|
|
953
|
-
- ✅ Mac, Linux, Windows
|
|
954
|
-
- ✅ Claude Code, Cursor, AI Assistants
|
|
955
|
-
- ✅ Big-3 AI Compatible (Claude Code, OpenAI Codex CLI, Gemini CLI)
|
|
956
|
-
|
|
957
|
-
---
|
|
958
|
-
|
|
959
|
-
## 🔬 Context-Mirroring (Bi-Sync)
|
|
960
|
-
|
|
961
|
-
Keep `.faf` (structured data) and `CLAUDE.md` (human-readable) in perfect sync automatically.
|
|
962
|
-
|
|
963
|
-
### Features
|
|
964
|
-
- **As fast as 8ms** (typical 10-15ms, 95% under 50ms)
|
|
965
|
-
- **Bidirectional:** `.faf` ↔ `CLAUDE.md`
|
|
966
|
-
- **Zero-slippage:** Atomic file operations design
|
|
967
|
-
- **Cross-platform:** Mac + Windows verified
|
|
968
|
-
- **Universal:** Works with any Tool.md format
|
|
969
|
-
|
|
970
|
-
### Live Output
|
|
971
|
-
|
|
972
|
-
```
|
|
973
|
-
🔗 C-MIRROR LIVE
|
|
974
|
-
━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
975
|
-
├─ Syncing ← claude-to-faf...
|
|
976
|
-
├─ ██░░░░░░░░░░░░░░░░░░░░░░ 10% - Parsing CLAUDE.md...
|
|
977
|
-
├─ █████████░░░░░░░░░░░░░░░ 40% - Merging updates...
|
|
978
|
-
├─ ████████████████░░░░░░░░ 70% - Updating metadata...
|
|
979
|
-
├─ █████████████████████░░░ 90% - Generating YAML...
|
|
980
|
-
└─ 🎉 Synchronized in 8ms 🏎️⚡️
|
|
981
|
-
|
|
982
|
-
✅ Integrity: PERFECT
|
|
983
|
-
💎 Technical Credit +1
|
|
984
|
-
```
|
|
985
|
-
|
|
986
|
-
---
|
|
987
|
-
|
|
988
|
-
## 🔗 The FAF Ecosystem
|
|
989
|
-
|
|
990
|
-
- 🩵 **[faf-cli](https://github.com/Wolfe-Jam/faf-cli)** - This command-line tool (FREE FOREVER)
|
|
991
|
-
- 🧡 **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** - MCP server for Claude Desktop
|
|
992
|
-
- 💚 **[faf.one](https://faf.one)** - Documentation & guides
|
|
993
|
-
- 🖥️ **[Chrome Extension](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)** - Browser integration
|
|
994
|
-
- 💨 **FAF TURBO** - Premium features - Launched 😸
|
|
995
|
-
|
|
996
|
-
---
|
|
997
|
-
|
|
998
|
-
## 🏗️ Development
|
|
179
|
+
## Development
|
|
999
180
|
|
|
1000
181
|
```bash
|
|
1001
182
|
# Clone
|
|
@@ -1015,111 +196,12 @@ npm link
|
|
|
1015
196
|
|
|
1016
197
|
---
|
|
1017
198
|
|
|
1018
|
-
##
|
|
1019
|
-
|
|
1020
|
-
- **Node.js** 18+
|
|
1021
|
-
- **OS:** macOS, Linux, or Windows
|
|
1022
|
-
- **AI Tools:** Works with Claude, Codex, Gemini, Cursor, Warp etc.
|
|
1023
|
-
|
|
1024
|
-
---
|
|
1025
|
-
|
|
1026
|
-
## 🤝 Contributing
|
|
1027
|
-
|
|
1028
|
-
We welcome contributions! Join our [community discussions](https://github.com/Wolfe-Jam/faf-cli/discussions) or submit issues/PRs.
|
|
1029
|
-
|
|
1030
|
-
**Join our growing community** using `.faf` to accelerate their AI workflows:
|
|
1031
|
-
- Share your projects
|
|
1032
|
-
- Get help from the community
|
|
1033
|
-
- Request features
|
|
1034
|
-
- Learn best practices
|
|
1035
|
-
|
|
1036
|
-
---
|
|
1037
|
-
|
|
1038
|
-
## 💎 Strategic Sponsorship Opportunities
|
|
1039
|
-
|
|
1040
|
-
**Position your brand alongside the universal AI context standard.**
|
|
1041
|
-
|
|
1042
|
-
FAF CLI is defining a new category: **Universal AI Context Infrastructure**. With BIG-3 AI validation (Google, Anthropic, OpenAI) and adoption by leading AI development tools, FAF is becoming foundational infrastructure for the AI development ecosystem.
|
|
1043
|
-
|
|
1044
|
-
### 📈 Growth Momentum
|
|
1045
|
-
|
|
1046
|
-
- **Rapid adoption** - See live stats on npm
|
|
1047
|
-
- **Category leader** - First universal AI context standard
|
|
1048
|
-
- **Enterprise traction** - Infrastructure-level adoption
|
|
1049
|
-
- **BIG-3 validated** - Tested and endorsed by Google Gemini, Anthropic Claude, OpenAI Codex
|
|
1050
|
-
|
|
1051
|
-
### 🏆 Strategic Partnership Opportunities
|
|
1052
|
-
|
|
1053
|
-
**Infrastructure Sponsor** - Align your brand with foundational AI developer tooling
|
|
1054
|
-
**Category Leadership** - Be recognized as supporting the universal AI context standard
|
|
1055
|
-
**Enterprise Integration** - Deep integrations with your platform
|
|
1056
|
-
|
|
1057
|
-
**Target sponsors:** Companies building AI development tools, deployment platforms, terminals, IDEs, and AI infrastructure.
|
|
1058
|
-
|
|
1059
|
-
**Examples:** Vercel, Warp, Anthropic, Cursor, Windsurf, n8n, and other AI-first platforms.
|
|
1060
|
-
|
|
1061
|
-
### 🤝 Let's Talk
|
|
1062
|
-
|
|
1063
|
-
**[💼 Enterprise Sponsorship Inquiry](https://github.com/Wolfe-Jam/faf-cli/discussions)** - Strategic partnerships for category-defining infrastructure
|
|
1064
|
-
|
|
1065
|
-
FAF CLI is **FREE FOREVER** and open source (MIT). Sponsorship accelerates development, expands integrations, and positions your brand alongside the future of AI development.
|
|
1066
|
-
|
|
1067
|
-
---
|
|
1068
|
-
|
|
1069
|
-
## 👤 Author
|
|
1070
|
-
|
|
1071
|
-
**James Wolfe (Wolfe-Jam)**
|
|
1072
|
-
Creator, .faf Format
|
|
1073
|
-
ORCID: [0009-0007-0801-3841](https://orcid.org/0009-0007-0801-3841)
|
|
1074
|
-
|
|
1075
|
-
---
|
|
1076
|
-
|
|
1077
|
-
## 📄 License
|
|
1078
|
-
|
|
1079
|
-
MIT License - See [LICENSE](./LICENSE) file
|
|
1080
|
-
|
|
1081
|
-
---
|
|
1082
|
-
|
|
1083
|
-
## 🏁 The Race Track is Open
|
|
1084
|
-
|
|
1085
|
-
**Category-defining. Format-first development. Foundational.**
|
|
1086
|
-
|
|
1087
|
-
AI's biggest issue addressed head-on. Agnostic. Universal.
|
|
1088
|
-
|
|
1089
|
-
AI has Claude/tool.md - they need `.faf` to be Universal.
|
|
1090
|
-
|
|
1091
|
-
AI needed a README, its package.json - **it got one.**
|
|
1092
|
-
|
|
1093
|
-
### **SPEED. SECURITY. UNIVERSAL. FREE. OPEN-SOURCE.**
|
|
1094
|
-
|
|
1095
|
-
Copy cats? Why bother.
|
|
1096
|
-
|
|
1097
|
-
**Build your best, let's RACE 🏁**
|
|
1098
|
-
|
|
1099
|
-
**See you at the Track! 🏎️⚡️**
|
|
1100
|
-
|
|
1101
|
-
---
|
|
1102
|
-
|
|
1103
|
-
<div align="center">
|
|
1104
|
-
|
|
1105
|
-
## 🏁 Powered by Anthropic-Approved MCP Claude Desktop code
|
|
1106
|
-
|
|
1107
|
-
Developed for you, with love, for free.
|
|
199
|
+
## License
|
|
1108
200
|
|
|
1109
|
-
|
|
1110
|
-
|
|
1111
|
-
We hope you reap the benefits of using the **project.faf** format and write some beautiful apps!
|
|
1112
|
-
|
|
1113
|
-
Made with 🧡 by **[wolfejam](https://github.com/Wolfe-Jam)**
|
|
1114
|
-
|
|
1115
|
-
**100% Open Source** • **Zero Faff™** • **F1-Inspired Engineering**
|
|
1116
|
-
|
|
1117
|
-
[⭐ Star on GitHub](https://github.com/Wolfe-Jam/faf-cli) • [📦 View on NPM](https://www.npmjs.com/package/faf-cli) • [💬 Join Discussions](https://github.com/Wolfe-Jam/faf-cli/discussions)
|
|
201
|
+
MIT License - Free and open source
|
|
1118
202
|
|
|
1119
203
|
---
|
|
1120
204
|
|
|
1121
|
-
|
|
1122
|
-
|
|
1123
|
-
Love it? **TURBO** for advanced features, ready for once you've kicked the tires! 😽💨
|
|
205
|
+
**Built with F1-inspired engineering principles**
|
|
1124
206
|
|
|
1125
|
-
|
|
207
|
+
*"It's so logical if it didn't exist, AI would have built it itself" — Claude*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,
|
|
1
|
+
{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,iBAgQ1B"}
|
package/dist/commands/init.js
CHANGED
|
@@ -75,6 +75,40 @@ async function initFafFile(projectPath, options = {}) {
|
|
|
75
75
|
});
|
|
76
76
|
// Write .faf file
|
|
77
77
|
await fs_1.promises.writeFile(outputPath, fafContent, "utf-8");
|
|
78
|
+
// 🏎️ AUTO-UPDATE package.json "files" array for npm packages
|
|
79
|
+
const packageJsonPath = path_1.default.join(projectRoot, 'package.json');
|
|
80
|
+
if (await (0, file_utils_1.fileExists)(packageJsonPath)) {
|
|
81
|
+
try {
|
|
82
|
+
const packageJsonContent = await fs_1.promises.readFile(packageJsonPath, 'utf-8');
|
|
83
|
+
const packageJson = JSON.parse(packageJsonContent);
|
|
84
|
+
// Only update if there's a "files" array (explicit npm publishing config)
|
|
85
|
+
// If no "files" array exists, npm uses default behavior - don't interfere
|
|
86
|
+
if (packageJson.files && Array.isArray(packageJson.files)) {
|
|
87
|
+
const fafFileName = path_1.default.basename(outputPath); // Either 'project.faf' or '.faf'
|
|
88
|
+
const hasProjectFaf = packageJson.files.includes('project.faf');
|
|
89
|
+
const hasDotFaf = packageJson.files.includes('.faf');
|
|
90
|
+
const hasCurrentFile = packageJson.files.includes(fafFileName);
|
|
91
|
+
// Add the file we just created if it's not already there (in any form)
|
|
92
|
+
if (!hasProjectFaf && !hasDotFaf && !hasCurrentFile) {
|
|
93
|
+
packageJson.files.push(fafFileName);
|
|
94
|
+
await fs_1.promises.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n', 'utf-8');
|
|
95
|
+
console.log(colors_1.chalk.green(` ☑️ Updated package.json to include ${fafFileName} in published files`));
|
|
96
|
+
}
|
|
97
|
+
else if (hasProjectFaf || hasDotFaf || hasCurrentFile) {
|
|
98
|
+
console.log(colors_1.chalk.gray(` ℹ️ package.json already includes FAF file in published files`));
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
else if (packageJson.files !== undefined) {
|
|
102
|
+
// "files" exists but is not an array - warn user
|
|
103
|
+
console.log(colors_1.chalk.yellow(` ⚠️ package.json "files" field is not an array - please add "${path_1.default.basename(outputPath)}" manually`));
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
catch (error) {
|
|
107
|
+
// Silent fail - not critical if package.json update fails
|
|
108
|
+
// Could be malformed JSON, permission issue, etc.
|
|
109
|
+
console.log(colors_1.chalk.gray(' ℹ️ Could not auto-update package.json (manual edit may be needed)'));
|
|
110
|
+
}
|
|
111
|
+
}
|
|
78
112
|
const elapsedTime = Date.now() - startTime;
|
|
79
113
|
console.log(colors_1.chalk.green(`☑️ Created ${outputPath}`));
|
|
80
114
|
console.log();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAqCH,
|
|
1
|
+
{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "faf-cli",
|
|
3
|
-
"version": "3.1.
|
|
3
|
+
"version": "3.1.5",
|
|
4
4
|
"description": "Anthropic-Approved codebase that powers claude-faf-mcp • Persistent project context, on-demand • Format-driven CLI • Open Source Universal Standard • MIT License",
|
|
5
5
|
"icon": "https://faf.one/orange-smiley.svg",
|
|
6
6
|
"logo": "https://faf.one/orange-smiley.svg",
|