faf-cli 4.1.0 → 4.2.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.
Files changed (2) hide show
  1. package/README.md +58 -0
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -180,6 +180,64 @@ Run `faf --help` for all 46 commands.
180
180
 
181
181
  ---
182
182
 
183
+ ## Boris-Flow Integration Tests
184
+
185
+ **Boris-Flow** is a 12-test validation suite that ensures faf-cli is demo-ready and safe to publish.
186
+
187
+ Named after Boris (Claude Code creator at Anthropic), these tests validate:
188
+ - Version detection works correctly
189
+ - Type and language detection (CLI, TypeScript, etc.)
190
+ - Claude Code structure detection (agents, skills, commands)
191
+ - Score progression: init → auto → 100%
192
+ - Non-TTY safety (no crashes when stdin is piped)
193
+
194
+ **When to run:**
195
+
196
+ | Scenario | Command |
197
+ |----------|---------|
198
+ | **Before `faf init`** (on your project) | `./tests/boris-flow.test.sh` validates faf-cli works |
199
+ | **After major changes** to your `.faf` | Re-run to ensure structure is valid |
200
+ | **Before publishing** faf-cli updates | Required - ensures no regressions |
201
+ | **Before WJTTC certification** | Validates `.faf` file for Tier 8 |
202
+ | **Team onboarding** | Proves faf-cli installation works |
203
+
204
+ **Run Boris-Flow:**
205
+ ```bash
206
+ # Clone faf-cli repository
207
+ git clone https://github.com/Wolfe-Jam/faf-cli
208
+ cd faf-cli
209
+
210
+ # Run integration tests
211
+ ./tests/boris-flow.test.sh
212
+
213
+ # Expected output:
214
+ # 🏆 BORIS-FLOW: ALL 12 TESTS PASSED
215
+ # ✅ Demo ready
216
+ # ✅ Safe to publish
217
+ # Final score: 100%
218
+ ```
219
+
220
+ **What it tests:**
221
+ ```bash
222
+ ✅ faf --version
223
+ ✅ Created Claude Code 2.1.0 structure
224
+ ✅ faf init created project.faf
225
+ ✅ Detected CLI type
226
+ ✅ Language detected (TypeScript)
227
+ ✅ claude_code section exists
228
+ ✅ Claude Code detected: true
229
+ ✅ Subagents detected (2+)
230
+ ✅ Skills detected (1+)
231
+ ✅ Commands detected (1+)
232
+ ✅ faf auto maintained score
233
+ ✅ human-set commands succeeded
234
+ ✅ Final score is 100%
235
+ ```
236
+
237
+ Boris-Flow validates the FAF file structure that WJTTC Tier 8 tests. Running it before certification helps ensure you'll pass Tier 8.
238
+
239
+ ---
240
+
183
241
  ## Human Context (The 6 Ws)
184
242
 
185
243
  Boost your score by 25-35% with human context — the information only YOU know.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "faf-cli",
3
- "version": "4.1.0",
3
+ "version": "4.2.0",
4
4
  "description": "The Persistent AI Context Standard • Foundation Layer for AI • IANA-Registered • Anthropic-Approved • project.faf = AI's foundation",
5
5
  "icon": "https://faf.one/orange-smiley.svg",
6
6
  "logo": "https://faf.one/orange-smiley.svg",
@@ -132,7 +132,7 @@
132
132
  "@types/node": "^20.11.17",
133
133
  "@typescript-eslint/eslint-plugin": "^8.41.0",
134
134
  "@typescript-eslint/parser": "^8.41.0",
135
- "eslint": "^8.56.0",
135
+ "eslint": "^9.39.2",
136
136
  "jest": "^29.7.0",
137
137
  "prettier": "^3.2.5",
138
138
  "ts-jest": "^29.4.1",