faf-mcp 1.3.1 → 2.0.1

package/CHANGELOG.md

@@ -5,6 +5,47 @@ All notable changes to 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).
 
+## [2.0.1] - 2026-03-07
+
+### Fixed
+
+- **README updated** — Rewritten for Cursor/Windsurf/Cline devs: v2.0.0 announcement in hero, "Define once. Sync everywhere." with interop diagram and quick start up front
+- **Windows CRLF** — Normalize `\r\n` in conductor-parser, gemini-parser, and conductor tests (same fix as agents/cursorrules from faf-cli v4.5.0)
+- **CI pipeline** — Fix 3 failures: npm audit fix (hono, express-rate-limit), audit-level downgraded to critical with continue-on-error, MCP Registry duplicate version tolerance
+- **Vercel badge** — Replaced oversized deploy button with shields.io badge
+
+## [2.0.0] - 2026-03-07 — The Interop MCP for Context
+
+**Define once. Sync everywhere.**
+
+### Added
+
+- **AI Format Interop** — 5 new MCP tools for cross-platform AI context
+  - `faf_agents`: Import/export/sync AGENTS.md (OpenAI Codex / Linux Foundation)
+  - `faf_cursor`: Import/export/sync .cursorrules (Cursor IDE)
+  - `faf_gemini`: Import/export/sync GEMINI.md (Google Gemini CLI)
+  - `faf_conductor`: Import/export Conductor directory structure
+  - `faf_git`: Extract .faf context from any public GitHub repo URL
+- **Bi-sync `--all` flag** — Sync project.faf to all formats at once (CLAUDE.md + AGENTS.md + .cursorrules + GEMINI.md)
+- **7 bundled parsers** — All parser logic runs standalone, zero CLI dependency
+  - agents-parser, cursorrules-parser, gemini-parser, conductor-parser
+  - github-extractor, faf-git-generator, slot-counter
+- **WJTTC v2.0.0 Championship Suite** — 73 Brake/Engine/Aero tests
+- **New test suites** — interop-v450, cli-mcp-parity, type-definitions-edge-cases
+
+### Changed
+
+- **Tool count**: 56 → 61 (25 core + 36 advanced)
+- **Tests**: 84 → 309 (9 suites)
+- **MCP SDK**: ^1.26.0 → ^1.27.1
+- Tier system fix: 100 = Trophy max (105 removed)
+- Path resolver: tilde expansion + project discovery
+- Version resolver: multi-path package.json fallback
+
+### Why Major Version
+
+New interop tools change the MCP contract surface. Define once in .faf, sync to every AI platform.
+
 ## [1.3.1] - 2026-02-15
 
 ### Fixed

package/CLAUDE.md

@@ -1,7 +1,7 @@
 # 🏎️ CLAUDE.md - faf-mcp Persistent Context & Intelligence
 
 ## PROJECT STATE: GOOD 🚀
-**Current Position:** Universal MCP server for all platforms
+**Current Position:** USE>FAF™ - IANA-registered format (application/vnd.faf+yaml) • Universal AI context • MCP server for all platforms • Start with 'Use FAF'
 **Tyre Compound:** ULTRASOFT C5 (Maximum Performance)
 
 ---
@@ -10,21 +10,21 @@
 
 ### Project Identity
 - **Name:** faf-mcp
-- **Stack:** Node.js/TypeScript
+- **Stack:** CLI/TypeScript/TypeScript (tsc)/npm registry/Node.js
 - **Quality:** F1-INSPIRED (Championship Performance)
 
 ### Technical Architecture
-- **What Building:** Universal FAF MCP Server - AI Context Intelligence for All Platforms
+- **What Building:** USE>FAF™ - IANA-registered format (application/vnd.faf+yaml) • Universal AI context • MCP server for all platforms • Start with 'Use FAF'
 - **Main Language:** TypeScript
 
 ### 📊 Context Quality Status
 - **Overall Assessment:** Good
-- **Last Updated:** 2025-12-18
+- **Last Updated:** 2026-03-07
 
 ---
 
 **STATUS: BI-SYNC ACTIVE 🔗 - Synchronized with .faf context!**
 
-*Last Sync: 2025-12-18T20:42:35.461Z*
+*Last Sync: 2026-03-07T17:33:41.765Z*
 *Sync Engine: F1-Inspired Software Engineering*
 *🏎️⚡️_championship_sync*

package/README.md

@@ -2,94 +2,111 @@
   <img src="https://www.faf.one/orange-smiley.svg" alt="FAF" width="40" />
   <div>
     <h1 style="margin: 0; color: #FF8C00;">faf-mcp</h1>
-    <p style="margin: 4px 0 0 0;"><strong>IANA-Registered Format for AI Context</strong> · <code>application/vnd.faf+yaml</code></p>
+    <p style="margin: 4px 0 0 0;"><strong>v2.0.0 — The Interop MCP for Context</strong></p>
   </div>
 </div>
 
-> **.FAF optimizes AI for your codebase.** At 100% (Gold Code), AI stops guessing and starts knowing. Universal MCP server for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible platforms.
+The MCP you didn't realise you needed, or wanted but didn't know who to ask, is here. Building on 36,000+ downloads across Claude and now Gemini, we bring you faf-mcp v2.0.0 to cure your syncing pain and fuel your chosen AI with optimized context, on-demand.
 
-**Universal version of [claude-faf-mcp](https://github.com/Wolfe-Jam/claude-faf-mcp)** — Anthropic-approved MCP server, now compatible with all platforms.
+**The only IANA-Registered Format for AI Context** · `application/vnd.faf+yaml`
 
 [![CI](https://github.com/Wolfe-Jam/faf-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Wolfe-Jam/faf-mcp/actions/workflows/ci.yml)
 [![NPM Downloads](https://img.shields.io/npm/dt/faf-mcp?label=total%20downloads&color=00CCFF)](https://www.npmjs.com/package/faf-mcp)
 [![npm version](https://img.shields.io/npm/v/faf-mcp?color=00CCFF)](https://www.npmjs.com/package/faf-mcp)
 [![Website](https://img.shields.io/badge/Website-faf.one-orange)](https://faf.one)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![project.faf](https://img.shields.io/badge/project.faf-inside-00D4D4)](https://github.com/Wolfe-Jam/faf)
+[![Deploy](https://img.shields.io/badge/Deploy-Vercel-black)](https://vercel.com/new?repository-url=https://github.com/Wolfe-Jam/faf-mcp)
 
 ---
 
-## The Problem: Context-Drift
+## Define once. Sync everywhere.
 
-AI assistants forget. They misunderstand. They drift.
+You maintain `.cursorrules`. Your teammate uses `AGENTS.md`. Someone on the team just switched to Gemini. Every AI tool wants its own context file — and they all say the same thing in different formats.
 
-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.
+**faf-mcp is the dedicated MCP server for Cursor, Windsurf, Cline, VS Code, and every non-Claude platform.** One `.faf` file in your repo, synced to every format your team needs.
 
-**.FAF fixes this permanently.**
-
----
+```
+                      project.faf
+                           │
+          ┌────────┬───────┴───────┬────────────┐
+          ▼        ▼               ▼            ▼
+      CLAUDE.md  AGENTS.md  .cursorrules  GEMINI.md
+      (Claude)   (Codex)      (Cursor)    (Gemini)
+```
 
-## The Solution: Gold Code
+### Quick Start
 
+```bash
+npx faf-mcp
 ```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🏆  FAF AI-READINESS SCORE: 100/100 — GOLD CODE
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-At 100%, AI is optimized. No more guessing.
-Peak AI performance activated.
+Add to your MCP config:
 
-├─ 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
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```json
+{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}}
 ```
 
+| Platform | Config File |
+|----------|-------------|
+| **Cursor** | `~/.cursor/mcp.json` |
+| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` |
+| **Cline** | Cline MCP settings |
+| **VS Code** | MCP extension config |
+| **Claude Desktop** | Use [claude-faf-mcp](https://github.com/Wolfe-Jam/claude-faf-mcp) |
+
 ---
 
-## 💎 Lifecycle Value
+## Three Ways to Deploy
 
-Setup savings get you started. Lifecycle optimization keeps you ahead.
+| Door | Method | Best For |
+|------|--------|----------|
+| **Hosted** | [mcpaas.live](https://mcpaas.live) | Zero-install, point any MCP client to the URL |
+| **Self-Deploy** | [Deploy to Vercel](https://vercel.com/new?repository-url=https://github.com/Wolfe-Jam/faf-mcp) | Your own instance, full control |
+| **Local** | `npx faf-mcp` | IDE integration via stdio transport |
 
-| 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 |
+### Hosted (mcpaas.live)
 
-**Setup savings: 20 minutes. Lifecycle savings: Infinite.**
+Point your MCP client to `https://mcpaas.live/sse` — no install, no config, no maintenance. Served from 300+ Cloudflare edges with sub-ms cold starts via 2.7KB Zig-WASM engine.
 
----
+### Self-Deploy (Vercel)
 
-## ⚡ Quick Start
+Deploy your own MCP server on Vercel in one click. Once deployed, your server exposes:
+- `/health` — Health check
+- `/info` — Server metadata + tool list
+- `/sse` — MCP Server-Sent Events transport
 
-**1. Install:**
+### Local (npm)
 
 ```bash
-npm install -g faf-mcp
+npx faf-mcp
 ```
 
-**2. Add to your MCP config:**
+---
 
-```json
-{"mcpServers": {"faf": {"command": "npx", "args": ["-y", "faf-mcp"]}}}
-```
+## 🔄 Interop Tools
 
-### Platform-Specific Setup
+| Tool | Platform | Action |
+|------|----------|--------|
+| `faf_agents` | OpenAI Codex | Import/export/sync AGENTS.md |
+| `faf_cursor` | Cursor IDE | Import/export/sync .cursorrules |
+| `faf_gemini` | Google Gemini | Import/export/sync GEMINI.md |
+| `faf_conductor` | Conductor | Import/export directory structure |
+| `faf_git` | GitHub | Generate .faf from any repo URL |
 
-| Platform | Config File |
-|----------|-------------|
-| **Cursor** | `~/.cursor/mcp.json` |
-| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` |
-| **Cline** | Cline MCP settings |
-| **VS Code** | MCP extension config |
-| **Claude Desktop** | Use [claude-faf-mcp](https://github.com/Wolfe-Jam/claude-faf-mcp) |
+```bash
+# Sync to all formats at once
+faf bi-sync --all
+
+# Generate .faf from any GitHub repo
+faf_git { url: "https://github.com/facebook/react" }
+```
+
+**61 tools** (25 core + 36 advanced) · **309 tests** (9 suites) · **7 bundled parsers**
 
 ---
 
-## ☁️ Cloud Sync (NEW in v1.3.0)
+## ☁️ Cloud Sync
 
 Share your FAF context globally via [mcpaas.live](https://mcpaas.live):
 
@@ -118,18 +135,19 @@ faf_cloud_fetch { soul_name: "my-project" }
 
 ## 🔄 Eternal Bi-Sync
 
-The magic: `.faf` ↔ `CLAUDE.md` stay synchronized in milliseconds.
+Your `.faf` file and your platform context files stay synchronized in milliseconds.
 
 ```
-project.faf  ←──── 8ms ────→  CLAUDE.md
-     │                            │
-     └── Single source of truth ──┘
+project.faf  ←── 8ms ──→  .cursorrules / AGENTS.md / CLAUDE.md / GEMINI.md
+                    Single source of truth
 ```
 
-- Update either file → both stay aligned
+- Update either side → both stay aligned
+- `--all` flag syncs to all four formats at once
 - Zero manual maintenance
 - Works across teams, branches, sessions
-- **Context never goes stale**
+
+AI assistants forget. They drift. Every new session, AI starts guessing again. Bi-sync means **context never goes stale**.
 
 ---
 
@@ -165,7 +183,7 @@ Works on all platforms — stops web search, forces tool usage.
 
 ---
 
-## 🛠️ 22 Native MCP Tools
+## 🛠️ 25 Core MCP Tools
 
 | Tool | Purpose |
 |------|---------|
@@ -176,14 +194,20 @@ Works on all platforms — stops web search, forces tool usage.
 | `faf_enhance` | Intelligent enhancement |
 | `faf_read` | Parse and validate FAF files |
 | `faf_write` | Create/update FAF with validation |
-| **☁️ Cloud Tools** | **(NEW in v1.3.0)** |
+| **🔄 Interop Tools** | |
+| `faf_agents` | Import/export/sync AGENTS.md |
+| `faf_cursor` | Import/export/sync .cursorrules |
+| `faf_gemini` | Import/export/sync GEMINI.md |
+| `faf_conductor` | Import/export directory structure |
+| `faf_git` | Generate .faf from GitHub repo URL |
+| **☁️ Cloud Tools** | |
 | `faf_cloud_publish` | Upload to mcpaas.live |
 | `faf_cloud_fetch` | Pull from cloud |
 | `faf_cloud_list` | List souls |
 | `faf_cloud_search` | Search souls |
 | `faf_cloud_share` | Generate share links |
 
-**Plus CLI fallback with 40+ commands** (via faf-cli v4.3.0):
+**Plus 36 advanced tools and CLI fallback** (via faf-cli v5.0.1):
 - `faf readme` - Extract 6 Ws from README (+25-35% boost)
 - `faf human-add` - Non-interactive YAML merge (6Ws Builder)
 - `faf git` - GitHub repo analysis without cloning
@@ -191,27 +215,10 @@ Works on all platforms — stops web search, forces tool usage.
 
 ---
 
-## 🎯 The .FAF Position
-
-```
-  Platform      Context          Protocol
-  ────────      ───────          ────────
-  Cursor     →   .faf        →    MCP
-  Windsurf   →   .faf        →    MCP
-  Cline      →   .faf        →    MCP
-  VS Code    →   .faf        →    MCP
-  Claude     →   .faf        →    MCP
-  Any IDE    →   .faf        →    MCP
-```
-
-**.FAF is the foundational layer.** Universal context format. IANA-registered. Works everywhere.
-
----
-
 ## 📦 Ecosystem
 
-- **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** — Claude Desktop (52 tools)
-- **[faf-cli](https://npmjs.com/package/faf-cli)** — Terminal CLI (18k+ downloads)
+- **[claude-faf-mcp](https://npmjs.com/package/claude-faf-mcp)** — Claude Desktop (33 tools)
+- **[faf-cli](https://npmjs.com/package/faf-cli)** — Terminal CLI
 - **[faf-wasm](https://www.npmjs.com/package/faf-wasm)** — WASM SDK (<5ms scoring)
 - **[faf.one](https://faf.one)** — Official website
 

package/dist/src/faf-core/commands/agents.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Agents Command - v4.5.0 Interop Edition
+ *
+ * Import/Export/Sync between AGENTS.md and project.faf
+ * Bundled command — no CLI dependency required.
+ */
+export interface AgentsCommandResult {
+    success: boolean;
+    action: 'import' | 'export' | 'sync';
+    message: string;
+    data?: any;
+    warnings?: string[];
+}
+/**
+ * Import AGENTS.md into project.faf
+ */
+export declare function agentsImportCommand(projectPath: string, options?: {
+    merge?: boolean;
+}): Promise<AgentsCommandResult>;
+/**
+ * Export project.faf to AGENTS.md
+ */
+export declare function agentsExportCommand(projectPath: string, options?: {
+    force?: boolean;
+}): Promise<AgentsCommandResult>;
+/**
+ * Sync AGENTS.md <-> project.faf (FAF is source of truth by default)
+ */
+export declare function agentsSyncCommand(projectPath: string): Promise<AgentsCommandResult>;

package/dist/src/faf-core/commands/agents.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * Agents Command - v4.5.0 Interop Edition
+ *
+ * Import/Export/Sync between AGENTS.md and project.faf
+ * Bundled command — no CLI dependency required.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentsImportCommand = agentsImportCommand;
+exports.agentsExportCommand = agentsExportCommand;
+exports.agentsSyncCommand = agentsSyncCommand;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+const file_utils_js_1 = require("../utils/file-utils.js");
+const yaml_js_1 = require("../fix-once/yaml.js");
+const agents_parser_js_1 = require("../parsers/agents-parser.js");
+/**
+ * Import AGENTS.md into project.faf
+ */
+async function agentsImportCommand(projectPath, options = {}) {
+    const agentsPath = await (0, agents_parser_js_1.detectAgentsMd)(projectPath);
+    if (!agentsPath) {
+        return {
+            success: false,
+            action: 'import',
+            message: 'No AGENTS.md found in project directory',
+        };
+    }
+    const result = await (0, agents_parser_js_1.agentsImport)(agentsPath);
+    if (!result.success) {
+        return {
+            success: false,
+            action: 'import',
+            message: result.warnings.join(', '),
+            warnings: result.warnings,
+        };
+    }
+    // If merge mode, read existing .faf and merge
+    if (options.merge) {
+        const fafPath = await (0, file_utils_js_1.findFafFile)(projectPath);
+        if (fafPath) {
+            try {
+                const existingContent = await fs_1.promises.readFile(fafPath, 'utf-8');
+                const existingFaf = (0, yaml_js_1.parse)(existingContent);
+                // Merge: spread existing + overlay imported fields
+                const merged = {
+                    ...existingFaf,
+                    project: {
+                        ...(existingFaf.project || {}),
+                        rules: [
+                            ...(existingFaf.project?.rules || []),
+                            ...result.faf.project.rules,
+                        ],
+                        guidelines: [
+                            ...(existingFaf.project?.guidelines || []),
+                            ...result.faf.project.guidelines,
+                        ],
+                        codingStyle: [
+                            ...(existingFaf.project?.codingStyle || []),
+                            ...result.faf.project.codingStyle,
+                        ],
+                    },
+                };
+                const yamlContent = (0, yaml_js_1.stringify)(merged);
+                await fs_1.promises.writeFile(fafPath, yamlContent);
+                return {
+                    success: true,
+                    action: 'import',
+                    message: `Merged AGENTS.md into existing .faf (${result.sectionsFound.length} sections)`,
+                    data: { sectionsFound: result.sectionsFound, merged: true },
+                    warnings: result.warnings,
+                };
+            }
+            catch {
+                // Fall through to create new
+            }
+        }
+    }
+    return {
+        success: true,
+        action: 'import',
+        message: `Imported AGENTS.md (${result.sectionsFound.length} sections found)`,
+        data: { faf: result.faf, sectionsFound: result.sectionsFound },
+        warnings: result.warnings,
+    };
+}
+/**
+ * Export project.faf to AGENTS.md
+ */
+async function agentsExportCommand(projectPath, options = {}) {
+    // Check for existing .faf
+    const fafPath = await (0, file_utils_js_1.findFafFile)(projectPath);
+    if (!fafPath) {
+        return {
+            success: false,
+            action: 'export',
+            message: 'No .faf file found. Run faf init first.',
+        };
+    }
+    // Check if AGENTS.md already exists
+    const outputPath = path_1.default.join(projectPath, 'AGENTS.md');
+    if (!options.force) {
+        try {
+            await fs_1.promises.access(outputPath);
+            return {
+                success: false,
+                action: 'export',
+                message: 'AGENTS.md already exists. Use force: true to overwrite.',
+            };
+        }
+        catch {
+            // File doesn't exist, proceed
+        }
+    }
+    // Read and parse .faf
+    const fafContent = await fs_1.promises.readFile(fafPath, 'utf-8');
+    const fafData = (0, yaml_js_1.parse)(fafContent);
+    // Export
+    const result = await (0, agents_parser_js_1.agentsExport)(fafData, outputPath);
+    return {
+        success: result.success,
+        action: 'export',
+        message: result.success
+            ? `Exported project.faf to AGENTS.md`
+            : 'Export failed',
+        data: { filePath: result.filePath },
+        warnings: result.warnings,
+    };
+}
+/**
+ * Sync AGENTS.md <-> project.faf (FAF is source of truth by default)
+ */
+async function agentsSyncCommand(projectPath) {
+    // FAF is always source of truth in MCP context
+    return await agentsExportCommand(projectPath, { force: true });
+}
+//# sourceMappingURL=agents.js.map

package/dist/src/faf-core/commands/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../../src/faf-core/commands/agents.ts"],"names":[],"mappings":"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"}

package/dist/src/faf-core/commands/bi-sync.d.ts

@@ -1,13 +1,17 @@
 /**
  * 🔗 Bi-Sync Engine - Mk3 Bundled Edition
  * Revolutionary project.faf ↔ CLAUDE.md Synchronization
+ * v4.5.0: Added agents/cursor/gemini/all flags for multi-format sync
  */
 export interface BiSyncOptions {
     auto?: boolean;
     watch?: boolean;
     force?: boolean;
     json?: boolean;
-    target?: 'auto' | '.clinerules' | '.cursorrules' | '.windsurfrules' | 'CLAUDE.md' | 'all';
+    agents?: boolean;
+    cursor?: boolean;
+    gemini?: boolean;
+    all?: boolean;
 }
 export interface BiSyncResult {
     success: boolean;
@@ -18,10 +22,10 @@ export interface BiSyncResult {
     message: string;
 }
 /**
- * 🔄 Convert project.faf YAML content to platform-specific format
+ * 🔄 Convert project.faf YAML content to CLAUDE.md Markdown format
  */
-export declare function fafToPlatformFormat(fafContent: string, targetPlatform: string): string;
+export declare function fafToClaudeMd(fafContent: string): string;
 /**
- * 🔗 Main Bi-Sync function - Platform-Aware
+ * 🔗 Main Bi-Sync function
  */
-export declare function syncBiDirectional(projectPath?: string, options?: BiSyncOptions): Promise<BiSyncResult>;
+export declare function syncBiDirectional(projectPath?: string, _options?: BiSyncOptions): Promise<BiSyncResult>;