claude-faf-mcp 3.0.4 → 3.1.3

package/CHANGELOG.md

@@ -5,6 +5,39 @@ All notable changes to claude-faf-mcp will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.5] - 2025-11-07
+
+### Added
+- **Discord Release Automation** - Automatic Discord announcements for new releases
+- **MCP Mission Statement** - Clarified .faf's position as universal Context layer for Model Context Protocol
+
+### Changed
+- **Documentation Polish** - Updated README from beta messaging to stable v3.0.4+ docs
+- **Code Cleanup** - Post-release refactoring and optimization
+
+### Fixed
+- **File Utils** - Simplified file handling logic
+- **FAF File Finder** - Improved project.faf detection with better fallback logic
+
+## [3.0.4] - 2025-11-06
+
+🏎️ **100% Standalone Achievement - Championship Complete**
+
+### Added
+- **faf_quick** - Lightning-fast project.faf creation (3ms average)
+- **faf_enhance** - Intelligent enhancement with auto-detection (63ms)
+
+### Changed
+- **Mk3 Complete** - 14/14 bundled commands (was 12/14)
+- **100% Standalone** - Zero CLI dependencies across all 50 tools
+- **16.2x Speedup** - Average performance improvement over CLI versions
+- **19ms Average** - Execution time across all bundled commands
+
+### Performance
+- 50/50 MCP tools operational (100% success rate)
+- Fastest command: 1ms (formats)
+- Unmeasurable: 0ms (migrate - too fast!)
+
 ## [3.0.3] - 2025-11-06
 
 ### Added

package/CLAUDE.md

@@ -1,4 +1,5 @@
 # 🏎️ CLAUDE.md - claude-faf-mcp Persistent Context & Intelligence
+**.faf format | project.faf**
 
 ## PROJECT STATE: ACTIVE 🚀
 **Current Position:** Provide FAF context tools directly in Claude Desktop via MCP
@@ -13,6 +14,23 @@
 - **Stack:** Node.js/TypeScript
 - **Quality:** F1-INSPIRED (Championship Performance)
 
+### Our Mission - The .faf Position in MCP
+
+**This is who we are. This is where we live:**
+
+```
+Model        Context          Protocol
+─────        ───────          ────────
+Claude   →   .faf        →    MCP
+Gemini   →   .faf        →    MCP
+Codex    →   .faf        →    MCP
+Any LLM  →   IANA Format →    Open Protocol
+```
+
+**.faf is the foundational, universal base layer** for any Model using the MCP Protocol.
+
+.FAF provides the standardized Context that makes the Model Context Protocol work for everyone.
+
 ### Technical Architecture
 - **What Building:** Universal FAF MCP Server for Claude Desktop - AI Context Intelligence
 - **Main Language:** TypeScript

package/README.md

@@ -1,20 +1,46 @@
-# claude-faf-mcp
+<div align="left">
+  <img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/logos/orange-smiley.svg" alt="FAF" width="40" align="left" style="margin-right: 12px;" />
+  <h1> claude-faf-mcp</h1>
+  <p><strong>IANA-Registered Format for AI Context</strong> · <code>application/vnd.faf+yaml</code></p>
+</div>
+<br clear="left"/>
 
-> **🏆 IANA-Registered Format** - .FAF is now an Internet-standard format.
-> MCP server for creating official `application/vnd.faf+yaml` files in Claude Desktop
 > Official MCP server for FAF (Foundational AI-context Format) with 50+ tools -
 > Persistent project context that integrates seamlessly with Claude Desktop workflows
 
-[![NPM Version](https://img.shields.io/npm/v/claude-faf-mcp?color=FF4500)](https://www.npmjs.com/package/claude-faf-mcp)
-[![Downloads](https://img.shields.io/npm/dt/claude-faf-mcp?color=00CCFF)](https://www.npmjs.com/package/claude-faf-mcp)
+[![GitHub stars](https://img.shields.io/github/stars/Wolfe-Jam/claude-faf-mcp?style=social)](https://github.com/Wolfe-Jam/claude-faf-mcp)
+[![NPM Downloads](https://img.shields.io/npm/dt/claude-faf-mcp?label=total%20downloads&color=00CCFF)](https://www.npmjs.com/package/claude-faf-mcp)
+[![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?logo=discord&logoColor=white)](https://discord.com/invite/3pjzpKsP)
+[![Chrome Web Store](https://img.shields.io/badge/Chrome-Extension-4285F4?logo=googlechrome&logoColor=white)](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)
+[![Website](https://img.shields.io/badge/Website-faf.one-orange)](https://faf.one)
+[![Spec Version](https://img.shields.io/badge/Spec-v1.1.0-green)](https://github.com/Wolfe-Jam/faf/blob/main/SPECIFICATION.md)
 [![IANA Registered](https://img.shields.io/badge/IANA-application%2Fvnd.faf%2Byaml-blue)](https://faf.one/blog/iana-registration)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ---
 
-## 🏎️ v3.0.4 - 100% Standalone Achievement
+## Understanding MCP - Our Mission
+
+**The .FAF Position in the MCP Ecosystem:**
 
-### What's New in v3.0.4
+```
+Model        Context          Protocol
+─────        ───────          ────────
+Claude   →   .faf        →    MCP
+Gemini   →   .faf        →    MCP
+Codex    →   .faf        →    MCP
+Any LLM  →   IANA Format →    Open Protocol
+```
+
+**.FAF is the foundational, universal base layer** for any Model using the MCP Protocol.
+
+.FAF provides the standardized Context that makes the Model Context Protocol work for everyone.
+
+---
+
+## 🏎️ v3.0.5 - 100% Standalone Achievement
+
+### What's New in v3.0.5
 
 **100% STANDALONE OPERATION** - Zero CLI dependencies across all 50 MCP tools.
 
@@ -65,7 +91,7 @@ faf migrate
 ### Installation
 
 ```bash
-# Install/upgrade to v3.0.4
+# Install/upgrade to v3.0.5
 npm install -g claude-faf-mcp
 
 # Or via npx (always gets latest)
@@ -138,22 +164,28 @@ brew install wolfe-jam/faf/claude-faf-mcp
 }
 ```
 
-**CLI vs MCP clarity**
-- **faf-cli** ([npm](https://www.npmjs.com/package/faf-cli)): Runs on your machine locally in a terminal
-- **claude-faf-mcp** (this): Runs through Claude Desktop as a tool
+## Using Other AI Tools?
 
-Same .faf, different way to use. Same Project DNA and scoring. Same capabilities (create, score, improve). Different execution layer.
+This MCP server is for **Claude Desktop**. If you also use **Claude Code**, **Cursor**, **Windsurf**, **Gemini CLI**, **OpenAI Codex**, **Warp**, or any terminal-based AI:
+
+**Get faf-cli for universal AI context:**
+```bash
+npm install -g faf-cli
+# or
+brew install faf-cli
+```
 
-Use CLI for raw speed and local development; use MCP for AI-integrated workflows. No feature gaps between them - pick based on your flow.
+Same `project.faf` format (lives right next to package.json and README.md).
+Works with every AI tool. **[faf-cli on npm →](https://www.npmjs.com/package/faf-cli)**
 
-[Website](https://faf.one) | [GitHub](https://github.com/Wolfe-Jam/claude-faf-mcp) | [Discussions](https://github.com/Wolfe-Jam/claude-faf-mcp/discussions)
+**[Website](https://faf.one)** • **[Discord](https://discord.com/invite/3pjzpKsP)** • **[GitHub](https://github.com/Wolfe-Jam/claude-faf-mcp)** • **[Discussions](https://github.com/Wolfe-Jam/claude-faf-mcp/discussions)**
 
 ---
 
 ### 📸 See It In Action
 
 <div align="center">
-<img src="https://cdn.jsdelivr.net/npm/claude-faf-mcp@latest/assets/project-faf-screenshot.png" alt="project.faf sits between package.json and README.md" width="500" />
+<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/screenshots/package-json-project-faf.png" alt="project.faf sits between package.json and README.md" width="500" />
 
 **`project.faf` sits right between `package.json` and `README.md`** - exactly where it belongs.
 
@@ -248,7 +280,7 @@ This documentation update adds IANA information throughout the README to reflect
 
 **v2.7.0 introduces `project.faf` as the new standard for every repository.**
 
-![project.faf in file structure](https://cdn.jsdelivr.net/npm/claude-faf-mcp@latest/assets/project-faf-screenshot.png)
+![project.faf in file structure](https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/screenshots/package-json-project-faf.png)
 
 **`package.json` for AI.**
 
@@ -404,7 +436,7 @@ Restart Claude Desktop to load the server.
 
 This is what persistent project context looks like in action. When you run `faf_auto`, Claude scores your project's AI-readiness with a visual breakdown showing exactly where you stand and what to improve next.
 
-![FAF Scoring Dashboard](https://cdn.jsdelivr.net/npm/claude-faf-mcp@latest/assets/faf-championship-scorecard.png)
+![FAF Scoring Dashboard](https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/demos/faf-championship-scorecard.png)
 
 Live in Claude Desktop. Persistent across sessions. Your foundational context layer, measured and actionable.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-faf-mcp",
-  "version": "3.0.4",
+  "version": "3.1.3",
   "mcpName": "io.github.Wolfe-Jam/claude-faf-mcp",
   "description": "IANA-registered format (application/vnd.faf+yaml) • Persistent project context • MCP server for Claude Desktop • MIT License",
   "icon": "./assets/icons/faf-icon-64.png",

package/.faf

@@ -1,10 +0,0 @@
-project:
-  name: claude-faf-mcp
-  goal: Provide FAF context tools directly in Claude Desktop via MCP
-instant_context:
-  tech_stack: Node.js/TypeScript
-  main_language: TypeScript
-  what_building: Universal FAF MCP Server for Claude Desktop - AI Context Intelligence
-metadata:
-  last_claude_sync: 2025-11-06T12:54:27.846Z
-  bi_sync: active