faf-cli 6.3.3 → 6.4.0
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 +30 -17
- package/dist/cli.js +177 -177
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
1
|
<div style="display: flex; align-items: center; gap: 12px;">
|
|
2
2
|
<img src="https://www.faf.one/orange-smiley.svg" alt="FAF" width="40" />
|
|
3
3
|
<div>
|
|
4
|
-
<h1 style="margin: 0; color: #000000;">faf-cli</h1>
|
|
5
|
-
<p style="margin:
|
|
4
|
+
<h1 style="margin: 0; color: #000000;">faf-cli v6.4</h1>
|
|
5
|
+
<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>
|
|
6
|
+
<p style="margin: 6px 0 0 0;"><strong>Persistent Project Context for AI.</strong></p>
|
|
7
|
+
<p style="margin: 0;"><strong>Define once. Run anywhere.</strong></p>
|
|
6
8
|
</div>
|
|
7
9
|
</div>
|
|
8
10
|
|
|
@@ -22,12 +24,13 @@
|
|
|
22
24
|
project/
|
|
23
25
|
├── package.json ← npm reads this
|
|
24
26
|
├── project.faf ← AI reads this
|
|
27
|
+
├── README.md ← humans read this
|
|
25
28
|
└── src/
|
|
26
29
|
```
|
|
27
30
|
|
|
28
|
-
> **Every building requires a foundation.
|
|
31
|
+
> **Every building requires a foundation. FAF is AI's foundational layer.**
|
|
29
32
|
>
|
|
30
|
-
> You have a `package.json`.
|
|
33
|
+
> You have a `package.json`. AI needs you to add a `project.faf`. Done.
|
|
31
34
|
|
|
32
35
|
**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.
|
|
33
36
|
|
|
@@ -36,11 +39,13 @@ project/
|
|
|
36
39
|
## Install
|
|
37
40
|
|
|
38
41
|
```bash
|
|
39
|
-
bunx faf
|
|
40
|
-
npx faf
|
|
41
|
-
brew install faf-cli && faf
|
|
42
|
+
bunx faf # Bun — zero install, fastest path
|
|
43
|
+
npx faf # npm — works everywhere
|
|
44
|
+
brew install faf-cli && faf # Homebrew
|
|
42
45
|
```
|
|
43
46
|
|
|
47
|
+
> `faf` is shorthand for `faf-cli auto` — same behavior, fewer keystrokes.
|
|
48
|
+
|
|
44
49
|
---
|
|
45
50
|
|
|
46
51
|
## Nelly Never Forgets
|
|
@@ -63,9 +68,9 @@ v6 is a ground-up rewrite. All-in on Bun — same toolchain as Claude Code.
|
|
|
63
68
|
| **Language** | TypeScript | TypeScript |
|
|
64
69
|
| **Compile** | Bun bytecode | `bun build --compile` |
|
|
65
70
|
|
|
66
|
-
|
|
71
|
+
408 tests in ~13s. 296KB bundle in 2.4s. Single portable binary, 4 platforms. npx backward-compatible.
|
|
67
72
|
|
|
68
|
-
26 commands.
|
|
73
|
+
26 commands. 408 tests. WJTTC-tested. 93% smaller than v5.
|
|
69
74
|
|
|
70
75
|
```
|
|
71
76
|
commands → interop → core → wasm
|
|
@@ -128,12 +133,14 @@ bunx faf-cli go # Interactive interview to gold code
|
|
|
128
133
|
|
|
129
134
|
| Tier | Score | Status |
|
|
130
135
|
|------|-------|--------|
|
|
131
|
-
| 🏆 Trophy | 100% | AI Optimized — Gold Code |
|
|
132
|
-
|
|
|
133
|
-
|
|
|
134
|
-
|
|
|
135
|
-
|
|
|
136
|
-
|
|
|
136
|
+
| 🏆 **Trophy** | 100% | AI Optimized — Gold Code |
|
|
137
|
+
| ★ **Gold** | 99%+ | Near-perfect |
|
|
138
|
+
| ◆ **Silver** | 95%+ | Excellent |
|
|
139
|
+
| ◇ **Bronze** | 85%+ | Production ready |
|
|
140
|
+
| ● **Green** | 70%+ | Solid foundation |
|
|
141
|
+
| ● **Yellow** | 55%+ | AI flipping coins |
|
|
142
|
+
| ○ **Red** | <55% | AI working blind |
|
|
143
|
+
| **♡** **White** | 0% | No context at all |
|
|
137
144
|
|
|
138
145
|
---
|
|
139
146
|
|
|
@@ -178,11 +185,17 @@ src/
|
|
|
178
185
|
|
|
179
186
|
## Testing
|
|
180
187
|
|
|
188
|
+
> **Robust. Reliable. Next-level WJTTC tested.** — The Foundation Edition.
|
|
189
|
+
|
|
181
190
|
```bash
|
|
182
|
-
bun test #
|
|
191
|
+
bun test # 408 tests, 42 files, ~13s
|
|
183
192
|
```
|
|
184
193
|
|
|
185
|
-
|
|
194
|
+
- **WJTTC Build Resilience** (13) — every regression class locked.
|
|
195
|
+
- **WJTTC Kernel Stress** (19) — WASM kernel boundary tests.
|
|
196
|
+
- **e2e lifecycle** — every command in sequence.
|
|
197
|
+
|
|
198
|
+
Test reports in `reports/`.
|
|
186
199
|
|
|
187
200
|
---
|
|
188
201
|
|