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