claude-faf-mcp 5.6.2 → 5.7.0

package/CHANGELOG.md

@@ -1,5 +1,5 @@
 <!-- faf: claude-faf-mcp | TypeScript | mcp-server | FAF MCP server for Claude Desktop — persistent project context, 32 tools -->
-<!-- faf: doc=changelog | latest=v5.6.2 | canonical=project.faf | family=FAF -->
+<!-- faf: doc=changelog | latest=v5.7.0 | canonical=project.faf | family=FAF -->
 
 # Changelog
 
@@ -9,6 +9,32 @@ 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).
 
 
+## [5.7.0] - 2026-06-09 — The Canonical Edition
+
+The original FAF MCP, made canonical: the registry remote now hits the live
+Cloudflare edge directly (no Vercel/SSE redirect), the redundant `faf_chat` shim
+is retired (the host is your chat) — consolidated into 32 must-have tools.
+
+### Fixed
+
+- **`server.json` `remotes`** — `sse → claude-faf-mcp.vercel.app/sse` →
+  `streamable-http → https://mcpaas.live/claude/mcp/v1`. The Vercel/SSE URL only
+  308-redirected to the edge; strict SSE health-checks could choke on the
+  redirect-to-streamable-http. Now points at the canonical edge directly (same
+  fix grok-faf-mcp carried in 1.5.1).
+
+### Changed
+
+- **`faf_chat` retired** (was a stranded branch) — un-advertised from `tools/list`;
+  the host (Claude Desktop / Claude Code) *is* the chat, and the old body shelled
+  `faf chat` which faf-cli no longer ships. Kept as a deprecation **stub** (still
+  callable → clear "retired" notice, never "unknown tool"). **Tool count 33 → 32.**
+  Mirrors grok-faf-mcp's fleet retire.
+- **CI: `faf-taf-git` → v2.2.0** (was a stranded branch) — dropped the bun→jest
+  shim in `.github/workflows/ci.yml`.
+
+No breaking changes; `faf_chat` callers get a graceful deprecation notice.
+
 ## [5.6.2] - 2026-06-08
 
 MCP capability completeness — the stdio server now answers every capability it

package/CLAUDE.md

@@ -11,7 +11,7 @@ Universal FAF MCP Server for Claude Desktop - AI Context Intelligence
 
 - **Language:** TypeScript
 - **Backend:** MCP SDK (TS)
-- **Api Type:** MCP (stdio/SSE)
+- **Api Type:** MCP (stdio + Streamable HTTP)
 - **Runtime:** Node.js
 - **Hosting:** npm/Claude Desktop
 - **Build:** esbuild
@@ -20,12 +20,12 @@ Universal FAF MCP Server for Claude Desktop - AI Context Intelligence
 ## Context
 
 - **Who:** Claude Desktop users who want persistent AI project context
-- **What:** MCP server — 33 FAF tools for project DNA, scoring, and context sync
+- **What:** MCP server — 32 FAF tools for project DNA, scoring, and context sync
 - **Why:** Zero project re-explaining across AI sessions — define once, remember forever
 - **Where:** npm, Claude Desktop, MCP Registry (io.github.Wolfe-Jam/claude-faf-mcp)
-- **When:** v5.3.0, April 2026
+- **When:** v5.7.0 (The Canonical Edition), June 2026
 - **How:** npm install -g claude-faf-mcp
 
 ---
 
-*STATUS: BI-SYNC ACTIVE — 2026-05-25T01:11:33.544Z*
+*STATUS: BI-SYNC ACTIVE — 2026-06-09T12:52:07.994Z*

package/README.md

@@ -1,21 +1,21 @@
-<!-- faf: claude-faf-mcp | TypeScript | mcp-server | FAF MCP server for Claude — persistent project context, 33 tools -->
+<!-- faf: claude-faf-mcp | TypeScript | mcp-server | FAF MCP server for Claude — persistent project context, 32 tools -->
 <!-- faf: doc=readme | canonical=project.faf | score=100 | family=FAF -->
 
-# claude-faf-mcp v5.6
+# claude-faf-mcp — The Canonical Edition
 
+[![npm version](https://img.shields.io/npm/v/claude-faf-mcp?color=00CCFF)](https://www.npmjs.com/package/claude-faf-mcp)
 [![FAF Trophy 100%](https://img.shields.io/badge/FAF-%F0%9F%8F%86%20100%25-000000?labelColor=FF6B35)](https://faf.one)
 [![IANA: vnd.faf+yaml](https://img.shields.io/badge/IANA-vnd.faf%2Byaml-008B8B)](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml)[![IANA: vnd.fafm+yaml](https://img.shields.io/badge/IANA-vnd.fafm%2Byaml-008B8B)](https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml)
 [![DOI: Context paper](https://img.shields.io/badge/DOI-Context%20paper-FF6B35)](https://doi.org/10.5281/zenodo.18251362)[![DOI: Memory paper](https://img.shields.io/badge/DOI-Memory%20paper-FF6B35)](https://doi.org/10.5281/zenodo.20348942)
 
 **Home:** [faf.one/mcp](https://faf.one/mcp)
-**Live demo:** [claude-faf-mcp.vercel.app](https://claude-faf-mcp.vercel.app)
+**Live demo:** [claude.faf.one](https://claude.faf.one)
 
 **Persistent Project Context for Claude. 30 seconds. 🐘 Nelly Never Forgets.**
 
 [![FAF](https://mcpaas.live/badge/Wolfe-Jam/claude-faf-mcp.svg)](https://builder.faf.one)
 [![Anthropic MCP](https://img.shields.io/badge/Anthropic_MCP-merged_%232759-blueviolet)](https://github.com/modelcontextprotocol/servers/pull/2759)
 [![CI](https://github.com/Wolfe-Jam/claude-faf-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Wolfe-Jam/claude-faf-mcp/actions/workflows/ci.yml)
-[![npm version](https://img.shields.io/npm/v/claude-faf-mcp?color=00CCFF)](https://www.npmjs.com/package/claude-faf-mcp)
 [![NPM Downloads](https://img.shields.io/npm/dt/claude-faf-mcp?label=downloads&color=00CCFF)](https://www.npmjs.com/package/claude-faf-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Chat to FAFA live](https://img.shields.io/badge/Chat_to_FAFA_live-008B8B?style=flat&labelColor=000)](https://faf-voice.vercel.app/agent)
@@ -26,9 +26,9 @@
 
 > ⚡ **New: `/faf` prompt** — type `/faf` in Claude Desktop. It checks your project, scores it, drives it to 100%, and syncs. Relentlessly. One command.
 
-> 🏆 **v5.6.1 — FAF-binary scoring has landed.** `faf_score` now reads faf-cli's real scorer directly. Same number your AI and `faf score` (CLI) see. Truthful, IANA-spec, deterministic.
+> 🏆 **v5.7.0 — The Canonical Edition.** The original FAF MCP, made canonical: the registry remote now hits the live Cloudflare edge directly (no Vercel/SSE redirect), the redundant `faf_chat` shim is retired (the host is your chat) — consolidated into 32 must-have tools.
 
-33 MCP tools. IANA-registered formats (`application/vnd.faf+yaml` · `application/vnd.fafm+yaml`). 2,346 test executions per push.
+32 MCP tools. IANA-registered formats (`application/vnd.faf+yaml` · `application/vnd.fafm+yaml`). 2,538 test executions per push.
 
 ---
 
@@ -84,7 +84,7 @@ Same `.faf`, every surface — Claude, Gemini, Grok, Cursor. **[faf-cli on npm
 
 [**⬇ Download `claude-faf-mcp-5.5.2.mcpb`**](https://github.com/Wolfe-Jam/claude-faf-mcp/releases/latest/download/claude-faf-mcp-5.5.2.mcpb)
 
-Double-click. **No terminal. No JSON config. 33 tools live in 10 seconds.**
+Double-click. **No terminal. No JSON config. 32 tools live in 10 seconds.**
 
 **Copy** — paste-prompt to Claude
 
@@ -146,7 +146,7 @@ At 55%, AI guesses half the time. At 100%, AI knows your project. Same compiler
 
 ---
 
-## 33 MCP Tools
+## 32 MCP Tools
 
 All tools run standalone — zero CLI dependencies, 19ms average execution.
 
@@ -246,7 +246,7 @@ Same `project.faf`. Same scoring. Same result. Different execution layer.
 
 ## Quality
 
-391 tests · 12 suites · 6 platforms (ubuntu/macos/windows × Node 18/20)
+423 tests · 13 suites · 6 platforms (ubuntu/macos/windows × Node 18/20)
 
 **[CI Dashboard →](https://github.com/Wolfe-Jam/claude-faf-mcp/actions/workflows/ci.yml)**
 

package/dist/src/handlers/tools.js

@@ -359,21 +359,9 @@ class FafToolHandler {
                         additionalProperties: false
                     }
                 },
-                {
-                    name: 'faf_chat',
-                    description: '🗣️ Natural language project.faf generation - Ask 6W questions (Who/What/Why/Where/When/How) to build complete human context 🧡⚡️',
-                    annotations: {
-                        title: 'Chat about FAF',
-                        readOnlyHint: true,
-                        destructiveHint: false,
-                        openWorldHint: false
-                    },
-                    inputSchema: {
-                        type: 'object',
-                        properties: {},
-                        additionalProperties: false
-                    }
-                },
+                // faf_chat — DEPRECATED, un-advertised. The host IS the chat (Claude Desktop /
+                // Claude Code); a chat-shim tool is redundant. Dispatch keeps a deprecation
+                // stub (below). Fleet sweep — mirrors grok-faf-mcp's retire.
                 {
                     name: 'faf_friday',
                     description: '🎉 Friday Features - Chrome Extension detection, fuzzy matching & more! 🧡⚡️',
@@ -1359,37 +1347,18 @@ ${debugInfo.permissions.fafError ? `   FAF Error: ${debugInfo.permissions.fafErr
         }
     }
     async handleFafChat(_args) {
-        try {
-            const result = await this.engineAdapter.callEngine('chat');
-            if (!result.success) {
-                return {
-                    content: [{
-                            type: 'text',
-                            text: `Error running faf chat: ${result.error || 'Unknown error'}`
-                        }],
-                    isError: true
-                };
-            }
-            // Format the response text
-            const responseText = typeof result.data === 'string'
-                ? result.data
-                : result.data?.output || JSON.stringify(result.data, null, 2);
-            return {
-                content: [{
-                        type: 'text',
-                        text: responseText
-                    }]
-            };
-        }
-        catch (error) {
-            return {
-                content: [{
-                        type: 'text',
-                        text: `Error running faf chat: ${error instanceof Error ? error.message : String(error)}`
-                    }],
-                isError: true
-            };
-        }
+        // DEPRECATED: the host (Claude Desktop / Claude Code) IS the chat — a chat-shim
+        // MCP tool is redundant. Un-advertised in listTools; this stub stays so anyone
+        // still wired gets a clear signal, not a crash. The old body shelled `faf chat`
+        // via the engine subprocess (a command faf-cli no longer ships) — removing it
+        // ends that dead shell too.
+        return {
+            content: [{
+                    type: 'text',
+                    text: 'faf_chat is retired — the host is your chat, just talk here. ' +
+                        'For FAF: faf_init / faf_score / faf_sync, or "ask questions" to build context.',
+                }],
+        };
     }
     async handleFafFriday(args) {
         const { test } = args || {};

package/dist/src/server.d.ts

@@ -1,6 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 export interface ClaudeFafMcpServerConfig {
-    transport: 'stdio' | 'http-sse';
+    transport: 'stdio';
     port?: number;
     fafEnginePath: string;
     debug?: boolean;
@@ -13,18 +13,16 @@ export declare class ClaudeFafMcpServer {
     private toolHandler;
     private promptHandler;
     private config;
-    private httpServer?;
     constructor(config: ClaudeFafMcpServerConfig);
     /** Expose the raw MCP Server instance (used by Smithery sandbox scanning) */
     getServer(): Server;
     private setupHandlers;
-    private createHttpApp;
     start(): Promise<void>;
     stop(): Promise<void>;
     getServerInfo(): {
         name: string;
         version: string;
-        transport: "stdio" | "http-sse";
+        transport: "stdio";
         port: number | undefined;
         host: string | undefined;
         championship: string;

package/dist/src/server.js

@@ -1,20 +1,15 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClaudeFafMcpServer = void 0;
 const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-const sse_js_1 = require("@modelcontextprotocol/sdk/server/sse.js");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const resources_1 = require("./handlers/resources");
 const tools_1 = require("./handlers/tools");
 const prompts_1 = require("./handlers/prompts");
 const engine_adapter_1 = require("./handlers/engine-adapter");
-const express_1 = __importDefault(require("express"));
-const cors_1 = __importDefault(require("cors"));
 const type_guards_js_1 = require("./utils/type-guards.js");
+const sanitize_output_js_1 = require("./utils/sanitize-output.js");
 const version_1 = require("./version");
 class ClaudeFafMcpServer {
     server;
@@ -22,7 +17,6 @@ class ClaudeFafMcpServer {
     toolHandler;
     promptHandler;
     config;
-    httpServer;
     constructor(config) {
         this.config = {
             port: 3001,
@@ -93,7 +87,7 @@ class ClaudeFafMcpServer {
                     const duration = Date.now() - startTime;
                     console.error(`Tool ${request.params.name} executed in ${duration}ms`);
                 }
-                return result;
+                return (0, sanitize_output_js_1.sanitizeToolResult)(result);
             }
             catch (error) {
                 const errorMessage = (0, type_guards_js_1.isError)(error) ? error.message : 'Unknown error';
@@ -102,92 +96,15 @@ class ClaudeFafMcpServer {
             }
         });
     }
-    createHttpApp() {
-        const app = (0, express_1.default)();
-        // Enable CORS if requested
-        if (this.config.cors) {
-            app.use((0, cors_1.default)({
-                origin: true,
-                credentials: true,
-                methods: ['GET', 'POST', 'OPTIONS'],
-                allowedHeaders: ['Content-Type', 'Authorization', 'Accept']
-            }));
-        }
-        // Health check endpoint
-        app.get('/health', (_req, res) => {
-            res.json({
-                status: 'healthy',
-                server: 'claude-faf-mcp',
-                version: version_1.VERSION,
-                transport: 'http-sse',
-                timestamp: new Date().toISOString(),
-                championship: '32 tools, zero shell execution'
-            });
-        });
-        // Server info endpoint
-        app.get('/info', (_req, res) => {
-            res.json({
-                name: 'claude-faf-mcp',
-                version: version_1.VERSION,
-                description: 'Universal FAF MCP Server for Claude - AI Context Intelligence & Project Enhancement',
-                transport: 'http-sse',
-                capabilities: {
-                    resources: { listChanged: true },
-                    tools: { listChanged: true }
-                },
-                tools: [
-                    'faf_status', 'faf_score', 'faf_init', 'faf_trust',
-                    'faf_sync', 'faf_enhance', 'faf_bi_sync', 'faf_clear', 'faf_debug'
-                ]
-            });
-        });
-        return app;
-    }
     async start() {
-        if (this.config.transport === 'stdio') {
-            const transport = new stdio_js_1.StdioServerTransport();
-            await this.server.connect(transport);
-            if (this.config.debug) {
-                console.error('Claude FAF MCP Server started with stdio transport');
-            }
-        }
-        else if (this.config.transport === 'http-sse') {
-            const app = this.createHttpApp();
-            // Create SSE transport
-            const transport = new sse_js_1.SSEServerTransport('/sse', app);
-            await this.server.connect(transport);
-            // Start HTTP server (ensure port and host are defined)
-            const port = this.config.port ?? 3001;
-            const host = this.config.host ?? '0.0.0.0';
-            this.httpServer = app.listen(port, host, () => {
-                if (this.config.debug) {
-                    console.error(`Claude FAF MCP Server started with HTTP/SSE transport on ${host}:${port}`);
-                    console.error(`SSE endpoint: http://${host}:${port}/sse`);
-                    console.error(`Health check: http://${host}:${port}/health`);
-                }
-            });
-            // Handle server errors
-            this.httpServer.on('error', (error) => {
-                const errorMessage = (0, type_guards_js_1.isError)(error) ? error.message : 'Unknown HTTP server error';
-                console.error('HTTP server error:', errorMessage);
-                throw error;
-            });
-        }
-        else {
-            throw new Error(`Unsupported transport: ${this.config.transport}`);
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        if (this.config.debug) {
+            console.error('Claude FAF MCP Server started with stdio transport');
         }
     }
     async stop() {
-        if (this.httpServer) {
-            return new Promise((resolve) => {
-                this.httpServer.close(() => {
-                    if (this.config.debug) {
-                        console.error('Claude FAF MCP Server HTTP/SSE transport stopped');
-                    }
-                    resolve();
-                });
-            });
-        }
+        // stdio transport requires no teardown beyond process exit.
     }
     getServerInfo() {
         return {

package/dist/src/utils/sanitize-output.d.ts

@@ -0,0 +1,7 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare function stripAnsi(text: string): string;
+/**
+ * Sanitise a CallToolResult in place: strip ANSI from every text content block.
+ * Returns the same object for convenient inline use at the return boundary.
+ */
+export declare function sanitizeToolResult(result: CallToolResult): CallToolResult;

package/dist/src/utils/sanitize-output.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripAnsi = stripAnsi;
+exports.sanitizeToolResult = sanitizeToolResult;
+/**
+ * Strip ANSI escape sequences (SGR colour codes, cursor moves, etc.) from text.
+ *
+ * Terminal colour codes are meaningless over MCP — Claude Desktop and other
+ * GUI clients render them as raw escape bytes (e.g. `[36m`), which looks
+ * like garbage. Tool output must be clean text. This is the single place we
+ * guarantee that, applied to every tool result before it leaves the server.
+ */
+const ESC = String.fromCharCode(27); // 0x1B, the ANSI escape lead byte
+const ANSI_PATTERN = new RegExp(ESC + '\\[[0-9;?]*[ -/]*[@-~]', 'g');
+function stripAnsi(text) {
+    // 1) Remove well-formed CSI sequences (ESC[...final), e.g. colour codes.
+    // 2) Remove any remaining lone ESC bytes — some subprocess output (e.g. the
+    //    faf CLI's colourised stdout) emits bare 0x1B that isn't a valid CSI.
+    //    A raw ESC is never legitimate content over MCP, so strip it outright.
+    return text.replace(ANSI_PATTERN, '').split(ESC).join('');
+}
+/**
+ * Sanitise a CallToolResult in place: strip ANSI from every text content block.
+ * Returns the same object for convenient inline use at the return boundary.
+ */
+function sanitizeToolResult(result) {
+    if (!result || !Array.isArray(result.content))
+        return result;
+    for (const item of result.content) {
+        if (item && item.type === 'text'
+            && typeof item.text === 'string') {
+            item.text = stripAnsi(item.text);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=sanitize-output.js.map

package/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "claude-faf-mcp",
   "display_name": "FAF - Persistent Project Context for AI",
-  "version": "5.5.2",
+  "version": "5.7.0",
   "description": "Persistent project context that survives sessions, works across AI tools, and eliminates re-explaining. IANA-registered format. 32 MCP tools. Desktop Extension.",
   "long_description": "Persistent project context for AI. Tell Claude what you're building, who it's for, and why it matters. 30 seconds. It never forgets.\n\n**What it does:**\n- Scores your project's AI-readiness (0-100%)\n- Creates project.faf — persistent context that survives every session\n- Bi-syncs with CLAUDE.md, AGENTS.md, .cursorrules, GEMINI.md\n- Auto-detects your stack, frameworks, and architecture\n- Extracts context from README or any GitHub repo\n\n**No terminal required.** Tell Claude about your project and FAF handles the rest.\n\n**Example prompts:**\n- \"Set up project context for this codebase\" → creates project.faf, scores AI-readiness\n- \"What's my AI-readiness score?\" → calculates 0-100% with tier (Bronze/Silver/Gold/Trophy)\n- \"Sync my .faf with CLAUDE.md\" → bi-directional sync in 8ms\n- \"Generate a .faf from this GitHub repo: https://github.com/user/repo\" → instant context from any public repo\n- \"Improve my score to Gold\" → guided interview, adds missing context, re-scores\n\n**IANA-registered format (application/vnd.faf+yaml). Merged in Anthropic MCP ecosystem (PR #2759). 36,000+ downloads.**",
   "author": {
@@ -43,6 +43,7 @@
     }
   },
   "tools": [
+    { "name": "faf", "description": "Type faf to start — scores, drives to 100%, syncs everything" },
     { "name": "faf_about", "description": "Learn what .faf format is" },
     { "name": "faf_status", "description": "Check if project has project.faf" },
     { "name": "faf_score", "description": "Calculate AI-readiness score (0-100%)" },
@@ -56,7 +57,6 @@
     { "name": "faf_read", "description": "Read file content" },
     { "name": "faf_write", "description": "Write file content" },
     { "name": "faf_list", "description": "List and discover .faf projects" },
-    { "name": "faf_chat", "description": "Natural language .faf generation" },
     { "name": "faf_friday", "description": "Fun features and fuzzy matching" },
     { "name": "faf_guide", "description": "FAF MCP usage guide" },
     { "name": "faf_readme", "description": "Extract context from README.md" },

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "claude-faf-mcp",
-  "version": "5.6.2",
+  "version": "5.7.0",
   "mcpName": "io.github.Wolfe-Jam/claude-faf-mcp",
-  "description": "Persistent Project Context for Claude. IANA-registered .faf format, 33 MCP tools, 391 tests.",
+  "description": "Persistent Project Context for Claude. IANA-registered .faf format, 32 MCP tools, 423 tests.",
   "icon": "./assets/icons/faf-icon-256.png",
   "logo": "./assets/icons/faf-icon-256.png",
   "displayName": ".faf 🐘",
@@ -127,18 +127,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@upstash/redis": "^1.37.0",
-    "cors": "^2.8.5",
     "esbuild": "^0.27.3",
-    "express": "^4.21.0",
     "faf-cli": "^6.7.1",
     "faf-scoring-kernel": "^2.0.3",
     "yaml": "^2.4.1"
   },
   "devDependencies": {
-    "@types/cors": "^2.8.19",
-    "@types/express": "^5.0.3",
     "@types/jsonwebtoken": "^9.0.5",
     "@types/node": "^20.11.0",
     "@typescript-eslint/eslint-plugin": "^7.0.0",

package/dist/api/index.d.ts

@@ -1,2 +0,0 @@
-declare const app: import("express-serve-static-core").Express;
-export default app;