faf-cli 3.4.3 → 3.4.5

package/README.md

@@ -6,7 +6,7 @@
   </div>
 </div>
 
-> Universal CLI for FAF (Foundational AI-context Format) - Terminal-based tooling for creating, scoring, and improving project.faf files that provide persistent AI context
+> **.FAF optimizes AI for your codebase.** At 100% (Gold Code), AI stops guessing and starts knowing. Live bi-sync between `.faf` ↔ `CLAUDE.md` means zero context-drift — your project DNA stays aligned with AI, forever.
 
 [![NPM Downloads](https://img.shields.io/npm/dt/faf-cli?label=total%20downloads&color=00CCFF)](https://www.npmjs.com/package/faf-cli)
 [![Homebrew](https://img.shields.io/badge/Homebrew-faf--cli-orange)](https://github.com/Wolfe-Jam/homebrew-faf)
@@ -15,324 +15,192 @@
 
 ---
 
-## What's New in v3.4.2
+## The Problem: Context-Drift
 
-**Claude Code Detection** - FAF now detects and captures Claude Code structures for complete AI context handoff.
+AI assistants forget. They misunderstand. They drift.
 
-```bash
-faf init
-# Detects: .claude/agents/, .claude/commands/, CLAUDE.md, .mcp.json
-# Output includes claude_code: section with subagents, commands, permissions, mcp_servers
-```
+Every new session, every new file, every new developer — AI starts guessing again. Your codebase context leaks away. Yesterday's perfect assistant becomes today's confused intern.
 
-Also: Bun runtime detection (`bun.lockb`), WJTTC test suite with 29 Claude Code tests, `faf enhance` non-TTY fix.
+**.FAF fixes this permanently.**
 
 ---
 
-## TL;DR
-
-**Problem:** AI needs persistent project context to work at its best.
-
-**Solution:** The .faf format provides that context. This CLI creates, scores, and improves .faf files from your codebase in the IANA-registered format.
-
-**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.
-
-**Install:**
-```bash
-# npm (works everywhere)
-npm install -g faf-cli
-
-# Homebrew (macOS/Linux)
-brew install faf-cli
-```
+## The Solution: Gold Code
 
-**Quick start:**
-```bash
-cd your-project
-faf init        # Creates project.faf file
-faf score       # Check AI-readiness (0-100%)
 ```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🏆  FAF AI-READINESS SCORE: 100/100 — GOLD CODE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-**CLI vs MCP clarity:**
-- **faf-cli** (this): Terminal-based tool for scripts, automation, and local development
-- **claude-faf-mcp** ([npm](https://www.npmjs.com/package/claude-faf-mcp)): MCP server for Claude Desktop via protocol integration
-
-Same .faf format, different execution layers. Same Project DNA and scoring. Same capabilities (create, score, improve). Choose based on your workflow.
+At 100%, AI is optimized. No more guessing.
+Peak AI performance activated.
 
-[Website](https://faf.one) | [GitHub](https://github.com/Wolfe-Jam/faf-cli) | [Discussions](https://github.com/Wolfe-Jam/faf-cli/discussions)
-
----
+├─ Project DNA locked in        ├─ Zero context-drift
+├─ Architecture understood      ├─ Eternal bi-sync active
+├─ Domain model captured        ├─ Team alignment permanent
+└─ Every session starts smart   └─ AI works WITH you, not around you
 
-## Project DNA Positioning
-
-<div align="center">
-  <img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/Project-faf-pckg-json-README.png" alt="project.faf file positioning" width="600" />
-  <p><em>project.faf lives at the project root, between package.json and README.md</em></p>
-</div>
-
-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.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
 
 ---
 
-## Quick Start
+## 💎 Lifecycle Value
 
-### Installation
+Setup savings get you started. Lifecycle optimization keeps you ahead.
 
-```bash
-# npm (works everywhere)
-npm install -g faf-cli
-
-# Homebrew (macOS/Linux)
-brew install faf-cli
-```
+| When | Without FAF | With FAF |
+|------|-------------|----------|
+| **Day 1** | 20 min setup per dev | 0 min — instant context |
+| **Month 1** | AI forgets between sessions | AI remembers everything |
+| **Year 1** | New devs re-explain everything | New devs inherit full context |
+| **Year 3+** | Institutional knowledge lost | Project DNA preserved forever |
 
-### Generate Your First .faf File
-
-```bash
-# Initialize with IANA-registered format
-faf init
+**Setup savings: 20 minutes. Lifecycle savings: Infinite.**
 
-# Output: project.faf with official media type
-# Content-Type: application/vnd.faf+yaml
-```
-
-**What just happened:**
-- Created project.faf file (IANA-registered format)
-- Generated project DNA (architecture, dependencies, quality score)
-- Ready for any AI (Claude Code, Gemini, Cursor, Codex, Warp, etc.)
-- Official Internet standard format
+---
 
-### More Commands
+## ⚡ Quick Start
 
 ```bash
-# Auto-detect and enhance
-faf auto
+# Install
+npm install -g faf-cli    # or: brew install faf-cli
 
-# Check your AI readiness
-faf score
+# Initialize
+cd your-project
+faf init                  # Creates project.faf
 
-# Discover your stack's formats
-faf formats
+# Check your score
+faf score                 # 0-100% AI-readiness
 
-# Sync with CLAUDE.md
-faf bi-sync
+# Reach Gold Code
+faf auto                  # Auto-enhance to 100%
 ```
 
-**That's it!** Your AI now has perfect context.
-
 ---
 
-## Human Context (The 6 Ws)
-
-Boost your score by 25-35% with human context - the information only YOU know about your project.
+## What's New in v3.4.5
 
-### Auto-Extract from README
-
-```bash
-# Preview what can be extracted
-faf readme
-
-# Apply extracted content to empty slots
-faf readme --apply
-
-# Overwrite all slots (even filled ones)
-faf readme --apply --force
-```
+**Claude Code 2.1.0 Support** — Now detects `.claude/skills/`, `.claude/commands/`, and YAML-style `allowed-tools`.
 
-### Manual Entry
+**Boris-Flow 14/14** — Integration tests updated for Claude Code 2.1.0 validation.
 
 ```bash
-# Non-interactive (works in Claude Code)
-faf human-set who "Frontend team at Acme Corp"
-faf human-set what "Customer dashboard with real-time analytics"
-faf human-set why "10x faster than previous solution"
-
-# Interactive mode (terminal only)
-faf human
+./tests/boris-flow.test.sh
+# Validates: version, init, auto, score, skills, commands, subagents
 ```
 
-### Quality Check & Protection
+**`faf demo sync`** — Live bi-sync demonstration.
 
 ```bash
-# Inspect quality of human_context fields
-faf check
-
-# Output shows quality levels:
-#   empty     - Not filled
-#   generic   - Placeholder or too short
-#   good      - Quality content
-#   excellent - High-value content
-
-# Lock good content from being overwritten
-faf check --protect
-
-# Remove all protections
-faf check --unlock
+faf demo sync           # Run the demo
+faf demo sync --fast    # Speed run
 ```
 
-Protected fields are skipped by `faf readme` and `faf auto`, preventing accidental overwrites of quality content.
-
----
-
-## Core Features
-
-### 44 Championship Commands
-- **faf auto** - Zero to Podium in one command
-- **faf init** - Create project.faf from your project
-- **faf readme** - Smart 6 Ws extraction from README.md
-- **faf human** - Interactive human context entry
-- **faf human-set** - Non-interactive field setting (Claude Code compatible)
-- **faf check** - Quality inspection + field protection
-- **faf enhance** - Real AI analysis and improvements
-- **faf score** - AI-readiness scoring (0-100%)
-- **faf formats** - 153 formats across 17-level pyramid
-- **faf bi-sync** - Bidirectional .faf ↔ CLAUDE.md (8ms!)
-- **faf dna** - Evolution journey tracking
-
-Run `faf --help` for complete command reference
-
-### IANA-Registered Standard
-- Official MIME type: `application/vnd.faf+yaml`
-- Recognized at Internet scale (same as PDF, JSON, XML)
-- Proper HTTP Content-Type headers
-- Browser and email client support
-- Universal format for AI context
-
-### Championship Performance
-- **<50ms** all commands target
-- **18ms** average execution
-- **8ms** bi-sync achieved
-- **0ms** operations possible (unmeasurable speed!)
-- F1-grade engineering
-
-### Universal AI Support
-Works with Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor, Warp, Copilot, Windsurf, and all AI coding assistants.
-
-**PLUS:** AI-Automation platforms (n8n, OpenAI Builder, Google Opal, Make.com)
-
 ---
 
-## Project Types (94 Supported)
+## 🔄 Eternal Bi-Sync
 
-FAF now understands your project type and scores accordingly. CLI projects don't need frontend slots. Fullstack projects need everything.
+The magic: `.faf` ↔ `CLAUDE.md` stay synchronized in milliseconds.
 
-### How It Works
+```
+project.faf  ←──── 8ms ────→  CLAUDE.md
+     │                            │
+     └── Single source of truth ──┘
+```
 
-Set your project type in `.faf`:
-```yaml
-project:
-  type: cli          # 9 slots (project + human)
-  type: frontend     # 16 slots (+ frontend + universal)
-  type: backend-api  # 17 slots (+ backend + universal)
-  type: fullstack    # 21 slots (all categories)
+```bash
+faf bi-sync              # Sync once
+faf bi-sync --watch      # Continuous sync
 ```
 
-### Supported Types
+---
 
-**9-Slot Types** (Project + Human):
-`cli` `library` `npm-package` `pip-package` `crate` `gem` `chrome-extension` `firefox-extension` `safari-extension` `terraform` `kubernetes` `docker` `ansible` `github-action` `embedded` `arduino` `wasm` `jupyter` `smart-contract` `e2e-tests`
+## Tier System: From Blind to Optimized
 
-**13-Slot Types** (+ Frontend):
-`mobile` `react-native` `flutter` `ios` `android` `desktop` `electron` `tauri` `game` `unity` `dapp`
+| Tier | Score | Status |
+|------|-------|--------|
+| 🏆 **Trophy** | 100% | **AI Optimized** — Gold Code |
+| 🥇 **Gold** | 99%+ | Near-perfect context |
+| 🥈 **Silver** | 95%+ | Excellent |
+| 🥉 **Bronze** | 85%+ | Production ready |
+| 🟢 **Green** | 70%+ | Solid foundation |
+| 🟡 **Yellow** | 55%+ | AI flipping coins |
+| 🔴 **Red** | <55% | AI working blind |
+| 🤍 **White** | 0% | No context at all |
 
-**14-Slot Types** (+ Backend):
-`mcp-server` `data-science` `ml-model` `data-pipeline` `n8n-workflow` `python-app`
+**At 55%, AI is guessing half the time.** At 100%, AI is optimized.
 
-**16-Slot Types** (+ Frontend + Universal):
-`frontend` `svelte` `react` `vue` `angular` `astro`
+---
 
-**17-Slot Types** (+ Backend + Universal):
-`backend-api` `node-api` `python-api` `go-api` `rust-api` `graphql` `microservice` `strapi`
+## Core Commands
 
-**21-Slot Types** (All Categories):
-`fullstack` `nextjs` `remix` `t3` `mern` `mean` `django` `rails` `laravel` `wordpress` `monorepo` `turborepo` `nx` `lerna` `pnpm-workspace` `yarn-workspace`
+| Command | Purpose |
+|---------|---------|
+| `faf init` | Create project.faf from your codebase |
+| `faf score` | Check AI-readiness (0-100%) |
+| `faf auto` | Auto-enhance to Gold Code |
+| `faf bi-sync` | Sync .faf ↔ CLAUDE.md (8ms) |
+| `faf readme` | Extract 6 Ws from README (+25-35% boost) |
+| `faf human` | Interactive human context entry |
+| `faf human-set` | Non-interactive field setting |
+| `faf formats` | Show 153 detected formats |
+| `faf demo sync` | Live bi-sync demonstration |
 
-### Type Aliases (38 shortcuts)
+Run `faf --help` for all 44 commands.
 
-Use intuitive names - FAF maps them automatically:
+---
 
-| Alias | Maps To | Alias | Maps To |
-|-------|---------|-------|---------|
-| `api` | backend-api | `k8s` | kubernetes |
-| `cli-tool` | cli | `rn` | react-native |
-| `flask` | python-api | `expo` | react-native |
-| `fastapi` | python-api | `turbo` | turborepo |
-| `express` | node-api | `next` | nextjs |
-| `tf` | terraform | `gha` | github-action |
+## Human Context (The 6 Ws)
 
-### slot_ignore Escape Hatch
+Boost your score by 25-35% with human context — the information only YOU know.
 
-Override type defaults for your specific project:
+```bash
+# Auto-extract from README
+faf readme --apply
 
-```yaml
-project:
-  type: cli
-slot_ignore: [stack.hosting, stack.cicd]  # These won't count
+# Manual entry
+faf human-set who "Frontend team at Acme Corp"
+faf human-set what "Customer dashboard with real-time analytics"
+faf human-set why "10x faster than previous solution"
 ```
 
-Formats: array `[a, b]`, string `"a, b"`, or shorthand `hosting` → `stack.hosting`
-
----
-
-## Documentation
-
-- **[CHANGELOG](./CHANGELOG.md)** - Version history and release notes
-- **[FAQ](./docs/FAQ.md)** - Common questions
-- **[Commands Reference](https://faf.one/docs/commands)** - All 41 commands
-- **[Website](https://faf.one)** - Complete guide and documentation
-- **[Discord Community](https://discord.com/invite/56fPBUJKfk)** - Join the discussion
-
 ---
 
-## Why FAF CLI?
-
-> "README for the AI era" — Gemini CLI
-
-**Persistent Context** - Your project's DNA lives in `project.faf`, readable by any AI or human
+## CLI vs MCP
 
-**Universal Format** - IANA-registered standard works across Claude, Gemini, Codex, any LLM
+| Tool | Use Case |
+|------|----------|
+| **faf-cli** (this) | Terminal, scripts, CI/CD, automation |
+| **claude-faf-mcp** | Claude Desktop via MCP protocol |
 
-**Terminal-Native** - Built for scripts, automation, and developer workflows
-
-**Championship Engineering** - F1-inspired performance with strict TypeScript, zero runtime errors
+Same .faf format. Same scoring. Same Gold Code. Different execution layer.
 
 ---
 
-## Ecosystem
+## 📦 Ecosystem
 
-- **[FAF Format Spec](https://github.com/Wolfe-Jam/faf)** - Official IANA specification
-- **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** - MCP server for Claude Desktop
-- **[Chrome Extension](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)** - Browser integration
-- **[faf.one](https://faf.one)** - Official website and documentation
+- **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** — MCP server (52 tools)
+- **[faf-wasm](https://www.npmjs.com/package/faf-wasm)** — WASM SDK (<5ms scoring)
+- **[Chrome Extension](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)** — Browser integration
+- **[faf.one](https://faf.one)** — Official website
 
 ---
 
-## Development
+## 📚 Documentation
 
-```bash
-# Clone
-git clone https://github.com/Wolfe-Jam/faf-cli.git
-cd faf-cli
-
-# Install & Build
-npm install
-npm run build
-
-# Test
-npm test
-
-# Link locally
-npm link
-```
+- **[CHANGELOG](./CHANGELOG.md)** — Version history
+- **[Website](https://faf.one)** — Complete guide
+- **[Discord](https://discord.com/invite/56fPBUJKfk)** — Community
 
 ---
 
-## License
+## 📄 License
 
-MIT License - Free and open source
+MIT License — Free and open source
 
 ---
 
-**Built with F1-inspired engineering principles**
+**Zero drift. Eternal sync. AI optimized.** 🏆
 
 *"It's so logical if it didn't exist, AI would have built it itself" — Claude*

package/dist/big-orange/compare.js

@@ -145,10 +145,10 @@ function getChampionshipEmoji(score) {
     if (score >= 55) {
         return '🟡';
     } // Yellow (Caution)
-    if (score >= 10) {
+    if (score > 0) {
         return '🔴';
-    } // Red (Pit Stop)
-    return '🤍'; // White (empty)
+    } // Red <55%
+    return '🤍'; // White 0%
 }
 /**
  * Calculate delta metrics between two responses

package/dist/big-orange/compare.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/big-orange/compare.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/big-orange/compare.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAykD/C,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA4lD/C,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -78,6 +78,7 @@ const chat_1 = require("./commands/chat");
 const convert_1 = require("./commands/convert");
 const notifications_1 = require("./commands/notifications");
 const skills_1 = require("./commands/skills");
+const demo_1 = require("./commands/demo");
 const drift_1 = require("./commands/drift");
 const git_1 = require("./commands/git");
 const taf_1 = require("./commands/taf");
@@ -1079,6 +1080,23 @@ Claude Code Consistency:
   • Fresh start for .faf system
   • Removes temporary files and cached data`)
     .action((options) => (0, clear_1.clearCommand)(options));
+// 🎬 faf demo - Live Demonstrations
+commander_1.program
+    .command('demo [subcommand]')
+    .description('Live demonstrations of FAF capabilities')
+    .option('--speed <speed>', 'Demo pacing: fast, normal, slow (default: normal)')
+    .option('--no-cleanup', 'Keep demo changes in files')
+    .addHelpText('after', `
+Examples:
+  $ faf demo              # Show available demos
+  $ faf demo sync         # Live bi-sync demonstration
+  $ faf demo sync --fast  # Speed up the demo
+  $ faf demo sync --slow  # Slow down for presentations
+
+Available demos:
+  sync    Live .faf <-> CLAUDE.md synchronization
+          Shows real-time bidirectional sync with timestamps`)
+    .action(withAnalyticsTracking('demo', (subcommand, options) => (0, demo_1.demoCommand)(subcommand, options)));
 // 🍊 faf drift - Context-Drift Analyzer
 commander_1.program
     .command('drift')