v4.3.0 - GH API Truth + Slot-Ignore Fixes

• New function: extractFromLanguages() in faf-git-generator.ts

• Slot-Ignore System Fixed - Scoring now works correctly

  • Corrected formula: (filled + ignored) / 21 * 100
  • Fixed: Slots are 'slotignored' only when truly non-applicable to project type
  • Previously: Everything undetected was marked 'slotignored' (inflated scores)
  • Now: Accurate scoring that reflects what's actually filled vs ignored
  • New utility: src/utils/slot-counter.ts

• Clean Output Format - No synthetic scores, just honest status

  • Shows "No .faf file" instead of synthetic baseline score
  • Clear transformation: None → AI-ready with complete context
  • Defensible, provable, honest

📈 Results

Universal language support (achieved):

• React (JavaScript): 100% 🏆 Trophy
• Vue (JavaScript): 100% 🏆 Trophy
• Next.js (Full-stack): 100% 🏆 Trophy
• whisper.cpp (C++): 100% 🏆 Trophy
• Works across ALL languages and ecosystems

📚 Documentation

• README - Added project.faf screenshot showing file in context
  • Visual explainer: "just another file helping you code"
  • Positioned near top for immediate understanding
  • Shows project.faf alongside package.json and README.md

🎯 Positioning

FAF GIT is the killer feature:

• Primary workflow: npx faf-cli git <url> (no install needed)
• Pro workflow: npm install -g faf-cli then faf git <url>
• Works on ANY public GitHub repo
• 2 seconds to AI-ready context
• No cloning, no setup, just instant results

[4.2.2] - 2026-02-08 — Context Quality Edition 🎯

🎯 Slot-Ignore System (Documentation)

The perfect way to handle app-types - Now properly documented.

✨ What's New

• Slot-ignore mechanism - Comprehensive documentation added
  • Full specification in docs/SLOT-IGNORE.md
  • Quick reference in docs/SLOT-IGNORE-QUICK-REF.md
  • Like .gitignore for files, slot-ignore for context slots
  • Formula: (Filled + Ignored) / 21 = 100%

✨ Improvements

• 6 Ws extraction - Transformed human context extraction
  • WHO: Checks package.json author first (TIER 1 authoritative)
  • WHAT: package.json description now TIER 1 (was TIER 2)
  • WHY: Targets Mission sections, uses keywords as fallback
  • WHERE: npm packages → "npm registry + GitHub" (authoritative)

v4.1.0 — Gemini Native Handshake

🔷 Zero-Config Google AI Integration

FAF now auto-detects Gemini CLI and creates native bridges automatically.

✨ What's New

• --gemini flag - Explicit Gemini CLI integration
• Auto-detection - Detects Gemini CLI even without flag
  • Checks: gemini command, ~/.gemini, GEMINI_API_KEY, gcloud
• Native bridge - Creates .gemini/context.yaml pointing to project.faf
• Symlink - .gemini/project.faf → project.faf for direct access
• gemini: section - Added to project.faf with integration config

🎯 The Native Handshake

Every faf init is now Gemini-aware. If Gemini CLI is installed, FAF automatically:

1. Detects the installation
2. Creates .gemini/ directory
3. Writes context bridge config
4. Links to project.faf

Zero config. Native integration. Just works.

---

npm install -g [email protected]
# or
brew upgrade faf-cli

v3.4.8 - BI-SYNC 2.0: Context Intelligence

See CHANGELOG.md for details

v3.4.4

What's New

Boris-Flow - 12/12 integration tests for publish readiness. Championship-grade validation.

faf demo sync - Live bi-sync demonstration. Show your team how .faf <-> CLAUDE.md sync works.

See CHANGELOG.md for full details.

v3.4.3

[3.4.3] - 2026-01-07

Added

• Boris-Flow Integration Tests - 12-test suite for publish readiness validation
  • Version check, init, auto, score, non-TTY safety
  • Full Claude Code structure detection
  • ./tests/boris-flow.test.sh - run before any publish
• boris-ready.sh - Quick pre-publish verification script
• Turbo-cat Improvements - Enhanced format discovery and tests

Changed

• Sync command improvements for better reliability
• Compiler updates for more accurate scoring
• Removed deprecated Discord release workflow

---

Full Changelog: https://github.com/Wolfe-Jam/faf-cli/blob/main/CHANGELOG.md

v3.3.0 - Claude Code Plugin Support

feat: v3.3.0 - Claude Code Plugin Support

- Add `faf plugin-install` command (SSH bug workaround)
- Full plugin structure: commands/, skills/ at root
- WJTTC test suite for plugin validation (31 tests)
- Add cookbook project type definition
- Export getSlotsForType, getSlotCountForType

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

🚀 Grok Demo - faf-cli Championship Edition

Grok + .faf = FAST AF 🏎️⚡

This is the complete faf-cli codebase for the Grok demonstration.

What's Inside:

• ✅ faf-cli-100.faf (100/100 championship score)
• ✅ Full TypeScript source code
• ✅ 173/173 tests passing
• ✅ All 41 commands
• ✅ Mk3 Compiler engine

For Grok:

Download this zip and you'll have the entire championship-grade codebase to explore.

Links:

• npm: https://www.npmjs.com/package/faf-cli
• Website: https://faf.one
• Repo: https://github.com/Wolfe-Jam/faf-cli

Built with F1-inspired engineering principles 🏎️⚡

v3.1.2 - Discord Community Launch

feat: Add Discord community link

- Discord badge with shields
- Discord in navigation links
- Permanent invite: discord.com/invite/3pjzpKsP