claude-faf-mcp 2.2.8 → 2.2.9

package/README.md

@@ -1,116 +1,70 @@
-# 🏎️⚡️ Claude .faf MCP Server
-## .faf The JPEG for AI is here
+# 🏎️⚡️ claude-faf-mcp
 
-> **🏆 MCP READY - The JPEG for AI is REAL! 🏆**
+## .faf The JPEG for AI™ - Universal AI Context Management
 
-> **🏁 Testing Center: [faf.one/testing](https://faf.one/testing) 🏁**
+> **MCP Compatible | Zero Dependencies | Production Ready**
 
+Transform your projects into AI-optimized collaboration spaces with championship-grade performance.
 
-> **Claude .faf MCP Server | AI-Context on-demand management with bi-sync for Claude Users of all levels, with C.O.R.E performance faf-engine-Mk1**
-
-Transform your projects into AI-optimized collaboration spaces with **C.O.R.E (Comprehensive, Optimized, Relentless, Empirical) performance** powered by the **faf-engine-Mk1** architecture.
-
-[![MCP Compatible](https://img.shields.io/badge/MCP-✅%20Protocol%20Compatible-green)](https://modelcontextprotocol.io)
 [![NPM Version](https://img.shields.io/npm/v/claude-faf-mcp)](https://www.npmjs.com/package/claude-faf-mcp)
-[![Claude Desktop](https://img.shields.io/badge/Claude-Desktop%20Ready-purple)](https://claude.ai)
-[![AI Readiness](https://img.shields.io/badge/AI%20Readiness-99%25-orange)](https://faf.one)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Strict%20Mode-blue)](https://www.typescriptlang.org/)
-[![F1-Inspired](https://img.shields.io/badge/Philosophy-F1--Inspired-red)](https://github.com/faf-dev/claude-faf-mcp)
+[![Downloads](https://img.shields.io/npm/dt/claude-faf-mcp)](https://www.npmjs.com/package/claude-faf-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ## 🚨 ZERO DEPENDENCIES, ZERO FAFF™
-**11,000+ tests run** • **240+ npm downloads** • **<50ms operations**
-
-## 🍊 ZERO .faf | .fafLESS AI
 
-**We ARE the C in MCP.** Vitamin Context for healthy AI. I⚡🍊
+**Production v2.2.8** • **11,000+ tests run** • **<50ms operations** • **1 dependency only**
 
-## 🚀 Quick Install (2 Commands!)
+## 🚀 Quick Install
 
 ```bash
-# Step 1: Install globally
+# Install globally
 npm install -g claude-faf-mcp
 
-# Step 2: Add to Claude Desktop
+# Add to Claude Desktop
 echo '{"mcpServers":{"claude-faf-mcp":{"command":"claude-faf-mcp","args":[],"env":{}}}}' > ~/Library/Application\ Support/Claude/claude_desktop_config.json
 ```
 
-**Step 3:** Restart Claude Desktop - DONE! 🏁
-
-**Test:** Drop any package.json into Claude and watch the magic!
-
-## 🤖 What is Claude FAF MCP?
-
-The **Claude FAF MCP Server** provides 33 honest file operations for Claude Desktop. **ENJOY this in Desktop - FAF CLI will be right behind it!**
-
-Currently delivers:
-- ✅ Native file operations (read, write, list, etc.)
-- ✅ <50ms performance guaranteed
-- ✅ Works WITHOUT external dependencies
-- 🔜 Full FAF CLI integration coming soon for scoring & enhancement
-
-### 💡 PRO TIP: The Perfect Workflow
-
-**Drop a project file → Instant context!** Here's the flow:
-1. Drop your `package.json`, `requirements.txt`, or `README.md` into Claude
-2. Claude instantly knows what you're working on
-3. For new projects: Claude creates `claude.md`, you create `.faf`
-4. The AI-Context becomes **permanent glue** - your project understanding persists!
-
-*"Once you drop that first file, the context sticks. No more explaining your project every chat!"*
-
-### Key Benefits
-
-- 🧠 **Intelligent Context**: Automatically analyzes and optimizes your project for AI collaboration
-- ⚡ **Real-time Sync**: Bi-directional synchronization between `.faf` context and `claude.md` 
-- 📈 **AI Scoring**: Get detailed metrics on your project's AI-readiness
-- 🎯 **Claude-Optimized**: Specially tuned for optimal Claude performance
-- 🌐 **Universal**: Works with Claude Desktop, Claude Web, and Claude API
+Restart Claude Desktop - Done! 🏁
 
-## 💭 The World's First AI-Validated Developer Tool?
+## 🤖 What is claude-faf-mcp?
 
-### What the BIG-3 AI's themselves Say:
+The MCP server that brings .faf format power to Claude Desktop. Drop any project file into Claude and get instant AI understanding.
 
-| Platform | Score | Verdict |
-|----------|-------|---------|
-| **Claude (Anthropic)** | 9.5/10 | *"Should become the standard"* |
-| **OpenAI Codex** | 9/10 | *"Every project should have one"* |
-| **Google Gemini** | 9.5/10 | *"README evolution for AI era"* |
+### Key Features
 
-> **"its so logical [.faf] if it didn't exist, AI would have built it itself"** - Claude Code
+- ✅ **Zero Configuration** - Works instantly
+- ✅ **33+ Tools** - Complete file operations
+- ✅ **<50ms Performance** - F1-inspired speed
+- ✅ **Bi-directional Sync** - .faf ↔ claude.md
+- ✅ **99% AI Readiness** - Guaranteed understanding
 
-> **"package.json gives me a list of dependencies, .faf shows me what to do with them"** - Claude Code
-
-> **"package.json wasn't built for this, .faf was"** - .faf Inventor
-
-## 🏁 Testing & Development
-
-**🧪 Test Scripts: Available in `/tests/scripts/`**
-**🏆 11,000+ tests run and counting**
-
-### Quick Test Commands
-```bash
-# Test the MCP server
-npm test
-
-# Build the project
-npm run build
-```
+## 🛠️ Available Tools
 
-## 🚀 Quick Start
+### Core Tools
+- `faf_init` - Initialize .faf context
+- `faf_score` - Calculate AI readiness score
+- `faf_status` - Get project status
 
-### Prerequisites
+### Enhancement Tools
+- `faf_enhance` - Claude-optimized enhancement
+- `faf_sync` - Sync .faf with claude.md
+- `faf_bi_sync` - Real-time bidirectional sync
 
-- Node.js 18+
+### Management Tools
+- `faf_trust` - Validate context integrity
+- `faf_clear` - Clear caches
+- `faf_debug` - Debug connectivity
 
-### Installation
+## 📖 Usage
 
-```bash
-npm install -g claude-faf-mcp
-```
+1. **Drop a file** - Drop package.json, README, or any project file into Claude
+2. **Instant context** - Claude immediately understands your project
+3. **Use tools** - Type "faf" to see available commands
+4. **Stay synced** - Context persists across conversations
 
-### Configuration
+## ⚙️ Configuration
 
-Add to your Claude Desktop configuration (`claude_desktop_config.json`):
+Add to Claude Desktop configuration:
 
 ```json
 {
@@ -123,187 +77,50 @@ Add to your Claude Desktop configuration (`claude_desktop_config.json`):
 }
 ```
 
-Or for development with a local FAF build:
-
-```json
-{
-  "mcpServers": {
-    "claude-faf": {
-      "command": "claude-faf-mcp", 
-      "args": [
-        "--transport", "stdio",
-        "--faf-engine", "/path/to/your/faf/cli"
-      ]
-    }
-  }
-}
-```
-
-## 🛠️ Available Tools
-
-The server provides 9 powerful tools for AI-enhanced development:
-
-### Core Analysis
-- **`faf_status`** - Get comprehensive project status and AI readiness metrics
-- **`faf_score`** - Calculate AI collaboration score with detailed breakdown
-- **`faf_debug`** - Debug server environment and FAF CLI connectivity
-
-### Project Management  
-- **`faf_init`** - Initialize FAF context with intelligent stack detection
-- **`faf_trust`** - Validate context integrity and trust metrics
-- **`faf_clear`** - Clear caches and reset state
-
-### Context Optimization
-- **`faf_enhance`** - Claude-optimized AI enhancement with multi-model support
-- **`faf_sync`** - Synchronize .faf context with claude.md
-- **`faf_bi_sync`** - Bi-directional sync with real-time watching
-
-## 📖 Usage Examples
-
-### Initialize a New Project
-
-```
-Use the faf_init tool to set up FAF context for your project.
-```
-
-### Check Project Health
+## 📊 Real Metrics
 
 ```
-Use faf_status to see your project's AI collaboration metrics:
-- Context quality score
-- AI readiness level  
-- Performance metrics
-- Claude compatibility rating
+📈 Status: PRODUCTION
+├─ 💎 Version: 2.2.8
+├─ 🚀 Performance: <50ms
+├─ 📦 Dependencies: 1 (MCP SDK only)
+├─ 🧪 Tests Run: 11,000+
+└─ 🏆 AI Readiness: 99%
 ```
 
-### Optimize for Claude
+## 🏁 Development
 
-```
-Use faf_enhance with model="claude" and focus="claude-optimal" 
-to get the best possible Claude collaboration experience.
-```
-
-### Sync with Claude.md
-
-```
-Use faf_bi_sync to maintain automatic synchronization between 
-your .faf context and claude.md file for seamless collaboration.
-```
-
-## ⚙️ Configuration Options
-
-The server accepts several command-line options:
-
-- `--transport <stdio|http-sse>` - Transport protocol (default: stdio)
-- `--port <number>` - Port for HTTP-SSE transport (default: 3001) 
-- `--faf-engine <path>` - Path to FAF CLI (default: 'faf' global command)
-- `--debug` - Enable debug logging
-
-## 🏗️ Development Setup
-
-### Local Development
-
-1. Clone and install dependencies:
 ```bash
-git clone https://github.com/faf-dev/claude-faf-mcp.git
+# Clone repo
+git clone https://github.com/wolfejam/claude-faf-mcp.git
 cd claude-faf-mcp
-npm install
-```
 
-2. Build the project:
-```bash
+# Install & build
+npm install
 npm run build
-```
-
-3. Test locally:
-```bash
-npm run dev:stdio
-```
 
-4. Add to Claude config with local path:
-```json
-{
-  "mcpServers": {
-    "claude-faf-dev": {
-      "command": "npx",
-      "args": ["ts-node", "src/cli.ts", "--transport", "stdio"],
-      "cwd": "/path/to/claude-faf-mcp"
-    }
-  }
-}
-```
-
-### Testing
-
-Run the test suite:
-```bash
+# Test
 npm test
 ```
 
-Test MCP protocol compliance:
-```bash
-npm run test:mcp
-```
-
 ## 📋 Requirements
 
-- **Node.js**: Version 18 or higher
-- **FAF CLI**: Installed and accessible in PATH
-- **Claude Desktop**: Latest version with MCP support
-- **Operating System**: macOS, Linux, or Windows
-
-## 📊 Real Performance Metrics
-
-```
-📈 Project Status: CHAMPION
-├─ 💎 Context Quality: 100% 
-├─ 🤖 AI Readiness: Universal
-├─ ⚡ Performance: 38ms average
-├─ 🧡 Community: Growing daily
-└─ 📈 Enterprise Ready: Day One
-```
-
-## 🏁 The F1-Inspired Philosophy
-
-We build software with F1-Inspired principles:
-
-1. **Precision Engineering** - Every line purposeful
-2. **Performance Obsession** - Milliseconds matter
-3. **Continuous Innovation** - Always improving
-4. **Championship Standards** - Only the best survives
-
-*Created by 🏎️⚡️wolfejam, F1-fanatic and inventor of .faf*
-
-## 🤝 Contributing
-
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
-
-1. Fork the repository
-2. Create a feature branch: `git checkout -b feature/amazing-feature`
-3. Commit your changes: `git commit -m 'Add amazing feature'`
-4. Push to the branch: `git push origin feature/amazing-feature`
-5. Open a Pull Request
+- Node.js 18+
+- Claude Desktop (latest)
+- macOS, Linux, or Windows
 
 ## 📄 License
 
-MIT License - see the [LICENSE](LICENSE) file for details.
-
-**Note: ASK FOR ACCESS - SOME FEATURES**: The .faf-Engine(s) are proprietary and available under license.
+MIT License - see LICENSE file
 
-## 🙋 Support
+**Note**: The .faf-Engine(s) are proprietary and available under license.
 
-- **GitHub Issues**: [Report bugs or request features](https://github.com/Wolfe-Jam/claude-faf-mcp/issues)
-- **Documentation**: [Full documentation](https://faf.dev/docs/claude-mcp)
-- **Community**: [Join our Discord](https://discord.gg/faf-dev)
+## 🔗 Links
 
-## 🔗 Related Projects
-
-- **[FAF CLI](https://www.npmjs.com/package/faf-cli)** - The core FAF engine
-- **[Claude Desktop](https://claude.ai/download)** - Anthropic's desktop application  
-- **[MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk)** - Model Context Protocol SDK
+- **NPM**: [claude-faf-mcp](https://www.npmjs.com/package/claude-faf-mcp)
+- **Website**: [faf.one](https://faf.one)
+- **Support**: support@faf.one
 
 ---
 
-**Made with ❤️ for the Claude community**
-
-Transform your projects into AI-collaboration powerhouses with Claude FAF MCP Server!
+**Made with 🧡 by wolfejam** | **ZERO DEPENDENCIES, ZERO FAFF™**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-faf-mcp",
-  "version": "2.2.8",
+  "version": "2.2.9",
   "description": ".faf The JPEG for AI is here. The C in MCP is .faf - Foundational AI-context Format. Universal AI context management with 33+ tools for Claude Desktop. Every command shows AI-Readiness score. Drop file → Type 'faf' → 99% ready!",
   "main": "dist/server.js",
   "bin": {