npm - faf-mcp - Versions diffs - 2.2.0 → 2.2.1 - Mend

faf-mcp 2.2.0 → 2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,5 @@
 <!-- faf: faf-mcp | TypeScript | mcp-server | FAF MCP IDE Edition — persistent project context for Cursor, Windsurf, Cline, VS Code -->
-<!-- faf: doc=changelog | latest=v2.2.0 | canonical=project.faf | family=FAF -->
+<!-- faf: doc=changelog | latest=v2.2.1 | canonical=project.faf | family=FAF -->
 # Changelog
@@ -10,6 +10,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
+## [2.2.1] - 2026-06-16
+Patch — inherits The Interop Edition. Honest 31-tool count, now machine-enforced; retired "Universal" language dropped for the Cursor / IDE Edition.
+### Fixed
+- **Tool count is honest and single-sourced — 31.** README, CLAUDE.md, project.faf, and the npm description now state the real runtime count (`listTools()` = 31), replacing drifted 25 / 33 / "36 advanced" claims. A new gate (`tests/tool-count.test.ts`) reads the runtime tool list and refuses any release whose docs disagree — across 5 surfaces, including the npm + MCP-registry descriptions.
+- **Retired "Universal" positioning.** Context surfaces now lead with the **Cursor / IDE Edition** (VS Code included), matching the shipping package and registry copy.
+- **Removed the unwired "core/advanced" tiering from the docs** — it described a visibility split the server doesn't actually apply.
 ## [2.2.0] - 2026-06-16 — The Interop Edition
 faf-mcp now **enhances** your context files instead of replacing them — a structured `.faf` block injected at the top of `.cursorrules`/`AGENTS.md`/`GEMINI.md`/`CLAUDE.md`, your prose preserved, re-runs idempotent. Composes faf-cli's Turbo-Cat + 6Ws engines (forks deleted, single-source), now on the `one.faf` namespace.

package/CLAUDE.md CHANGED Viewed

@@ -1,12 +1,12 @@
 <!-- faf:start -->
-<!-- faf: faf-mcp | TypeScript | mcp | The Interop MCP for Context. Universal .faf MCP server for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible IDEs. IANA-registered application/vnd.faf+yaml. Start with "Use FAF". -->
+<!-- faf: faf-mcp | TypeScript | mcp | The Interop MCP for Context — the Cursor / IDE Edition. Persistent context for Cursor, VS Code, and every MCP-compatible IDE. IANA-registered application/vnd.faf+yaml. Start with "Use FAF". -->
 <!-- faf: claim=project.faf | family=FAF -->
 # CLAUDE.md — faf-mcp
 ## What This Is
-The Interop MCP for Context. Universal .faf MCP server for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible IDEs. IANA-registered application/vnd.faf+yaml. Start with "Use FAF".
+The Interop MCP for Context — the Cursor / IDE Edition. Persistent context for Cursor, VS Code, and every MCP-compatible IDE. IANA-registered application/vnd.faf+yaml. Start with "Use FAF".
 ## Stack
@@ -22,7 +22,7 @@ The Interop MCP for Context. Universal .faf MCP server for Cursor, Windsurf, Cli
 ## Context
 - **Who:** Developers using Claude, Cursor, Windsurf, VS Code, Cline, and any MCP-compatible IDE
-- **What:** Universal MCP server providing .faf context tools — 25 core + 36 advanced, interop with AGENTS.md, .cursorrules, GEMINI.md
+- **What:** The Cursor / IDE Edition — persistent context for Cursor, VS Code, and every MCP-compatible IDE — 31 MCP tools, interop with AGENTS.md, .cursorrules, GEMINI.md
 - **Why:** Eliminate the 20-minute AI context tax — give AI instant project understanding in 30 seconds
 - **Where:** npm · MCP Registry · Cloudflare edge (ide.faf.one/mcp/v1) · any MCP-compatible IDE — people get it how they wish
 - **When:** Production/Stable — v2.0.0 WJTTC certified (309/309 tests, 9 suites)

package/README.md CHANGED Viewed

@@ -9,7 +9,7 @@
   </div>
 </div>
-[![npm](https://img.shields.io/npm/v/faf-mcp?color=008B8B)](https://www.npmjs.com/package/faf-mcp)[![downloads](https://img.shields.io/npm/dt/faf-mcp?color=008B8B&label=downloads)](https://www.npmjs.com/package/faf-mcp)
+[![npm](https://img.shields.io/npm/v/faf-mcp?color=008B8B)](https://www.npmjs.com/package/faf-mcp)[![downloads](https://img.shields.io/npm/dm/faf-mcp?color=008B8B&label=downloads)](https://www.npmjs.com/package/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)
 [![DOI: Context paper](https://img.shields.io/badge/DOI-Context%20paper-FF6B35)](https://doi.org/10.5281/zenodo.18251362)
@@ -106,7 +106,7 @@ faf bi-sync --all
 faf_git { url: "https://github.com/facebook/react" }
 ```
-**25 MCP tools** (with CLI fallback) · **309 tests** (9 suites) · **7 bundled parsers**
+**31 MCP tools** (with CLI fallback) · **309 tests** (9 suites) · **7 bundled parsers**
 ---
@@ -187,7 +187,7 @@ Works on all platforms — stops web search, forces tool usage.
 ---
-## 25 Core MCP Tools
+## 31 MCP Tools
 | Tool | Purpose |
 |------|---------|
@@ -211,7 +211,7 @@ Works on all platforms — stops web search, forces tool usage.
 | `faf_cloud_search` | Search souls |
 | `faf_cloud_share` | Generate share links |
-**Plus 36 advanced tools and CLI fallback** (via faf-cli v5.0.1):
+**Plus CLI fallback** (via faf-cli):
 - `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

package/package.json CHANGED Viewed

@@ -1,8 +1,8 @@
 {
   "name": "faf-mcp",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "mcpName": "one.faf/faf-mcp",
-  "description": "Persistent Project Context for Cursor, IDEs and VS Code. IANA-registered .faf format, 25 MCP tools, 309 tests.",
+  "description": "Persistent Project Context for Cursor, IDEs and VS Code. IANA-registered .faf format, 31 MCP tools, 309 tests.",
   "icon": "./assets/icons/faf-icon-256.png",
   "logo": "./assets/icons/faf-icon-256.png",
   "displayName": ".faf 🐘",
@@ -53,7 +53,7 @@
     "ai-readiness",
     "context-management",
     "persistent-project-context",
-    "universal-context",
+    "ide-context",
     "iana-format",
     "project-intelligence",
     "codebase-understanding",

package/project.faf CHANGED Viewed

@@ -1,7 +1,7 @@
 faf_version: "3.0"
 project:
   name: faf-mcp
-  goal: The Interop MCP for Context. Universal .faf MCP server for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible IDEs. IANA-registered application/vnd.faf+yaml. Start with "Use FAF".
+  goal: The Interop MCP for Context — the Cursor / IDE Edition. Persistent context for Cursor, VS Code, and every MCP-compatible IDE. IANA-registered application/vnd.faf+yaml. Start with "Use FAF".
   main_language: TypeScript
   type: mcp
   framework: MCP SDK (TS)
@@ -28,7 +28,7 @@ stack:
   storage: slotignored
 human_context:
   who: Developers using Claude, Cursor, Windsurf, VS Code, Cline, and any MCP-compatible IDE
-  what: Universal MCP server providing .faf context tools — 25 core + 36 advanced, interop with AGENTS.md, .cursorrules, GEMINI.md
+  what: The Cursor / IDE Edition — persistent context for Cursor, VS Code, and every MCP-compatible IDE — 31 MCP tools, interop with AGENTS.md, .cursorrules, GEMINI.md
   why: Eliminate the 20-minute AI context tax — give AI instant project understanding in 30 seconds
   where: npm · MCP Registry · Cloudflare edge (ide.faf.one/mcp/v1) · any MCP-compatible IDE — people get it how they wish
   when: Production/Stable — v2.0.0 WJTTC certified (309/309 tests, 9 suites)