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
  1. package/CHANGELOG.md +11 -1
  2. package/CLAUDE.md +3 -3
  3. package/README.md +4 -4
  4. package/package.json +3 -3
  5. package/project.faf +2 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <!-- faf: faf-mcp | TypeScript | mcp-server | FAF MCP IDE Edition — persistent project context for Cursor, Windsurf, Cline, VS Code -->
2
- <!-- faf: doc=changelog | latest=v2.2.0 | canonical=project.faf | family=FAF -->
2
+ <!-- faf: doc=changelog | latest=v2.2.1 | canonical=project.faf | family=FAF -->
3
3
 
4
4
  # Changelog
5
5
 
@@ -10,6 +10,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
10
10
 
11
11
  ## [Unreleased]
12
12
 
13
+ ## [2.2.1] - 2026-06-16
14
+
15
+ Patch — inherits The Interop Edition. Honest 31-tool count, now machine-enforced; retired "Universal" language dropped for the Cursor / IDE Edition.
16
+
17
+ ### Fixed
18
+
19
+ - **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.
20
+ - **Retired "Universal" positioning.** Context surfaces now lead with the **Cursor / IDE Edition** (VS Code included), matching the shipping package and registry copy.
21
+ - **Removed the unwired "core/advanced" tiering from the docs** — it described a visibility split the server doesn't actually apply.
22
+
13
23
  ## [2.2.0] - 2026-06-16 — The Interop Edition
14
24
 
15
25
  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
@@ -1,12 +1,12 @@
1
1
  <!-- faf:start -->
2
- <!-- 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". -->
2
+ <!-- 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". -->
3
3
  <!-- faf: claim=project.faf | family=FAF -->
4
4
 
5
5
  # CLAUDE.md — faf-mcp
6
6
 
7
7
  ## What This Is
8
8
 
9
- 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".
9
+ 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".
10
10
 
11
11
  ## Stack
12
12
 
@@ -22,7 +22,7 @@ The Interop MCP for Context. Universal .faf MCP server for Cursor, Windsurf, Cli
22
22
  ## Context
23
23
 
24
24
  - **Who:** Developers using Claude, Cursor, Windsurf, VS Code, Cline, and any MCP-compatible IDE
25
- - **What:** Universal MCP server providing .faf context tools — 25 core + 36 advanced, interop with AGENTS.md, .cursorrules, GEMINI.md
25
+ - **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
26
26
  - **Why:** Eliminate the 20-minute AI context tax — give AI instant project understanding in 30 seconds
27
27
  - **Where:** npm · MCP Registry · Cloudflare edge (ide.faf.one/mcp/v1) · any MCP-compatible IDE — people get it how they wish
28
28
  - **When:** Production/Stable — v2.0.0 WJTTC certified (309/309 tests, 9 suites)
package/README.md CHANGED
@@ -9,7 +9,7 @@
9
9
  </div>
10
10
  </div>
11
11
 
12
- [![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)
12
+ [![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)
13
13
  [![FAF Trophy 100%](https://img.shields.io/badge/FAF-%F0%9F%8F%86%20100%25-000000?labelColor=FF6B35)](https://faf.one)
14
14
  [![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)
15
15
  [![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
106
106
  faf_git { url: "https://github.com/facebook/react" }
107
107
  ```
108
108
 
109
- **25 MCP tools** (with CLI fallback) · **309 tests** (9 suites) · **7 bundled parsers**
109
+ **31 MCP tools** (with CLI fallback) · **309 tests** (9 suites) · **7 bundled parsers**
110
110
 
111
111
  ---
112
112
 
@@ -187,7 +187,7 @@ Works on all platforms — stops web search, forces tool usage.
187
187
 
188
188
  ---
189
189
 
190
- ## 25 Core MCP Tools
190
+ ## 31 MCP Tools
191
191
 
192
192
  | Tool | Purpose |
193
193
  |------|---------|
@@ -211,7 +211,7 @@ Works on all platforms — stops web search, forces tool usage.
211
211
  | `faf_cloud_search` | Search souls |
212
212
  | `faf_cloud_share` | Generate share links |
213
213
 
214
- **Plus 36 advanced tools and CLI fallback** (via faf-cli v5.0.1):
214
+ **Plus CLI fallback** (via faf-cli):
215
215
  - `faf readme` - Extract 6 Ws from README (+25-35% boost)
216
216
  - `faf human-add` - Non-interactive YAML merge (6Ws Builder)
217
217
  - `faf git` - GitHub repo analysis without cloning
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "faf-mcp",
3
- "version": "2.2.0",
3
+ "version": "2.2.1",
4
4
  "mcpName": "one.faf/faf-mcp",
5
- "description": "Persistent Project Context for Cursor, IDEs and VS Code. IANA-registered .faf format, 25 MCP tools, 309 tests.",
5
+ "description": "Persistent Project Context for Cursor, IDEs and VS Code. IANA-registered .faf format, 31 MCP tools, 309 tests.",
6
6
  "icon": "./assets/icons/faf-icon-256.png",
7
7
  "logo": "./assets/icons/faf-icon-256.png",
8
8
  "displayName": ".faf 🐘",
@@ -53,7 +53,7 @@
53
53
  "ai-readiness",
54
54
  "context-management",
55
55
  "persistent-project-context",
56
- "universal-context",
56
+ "ide-context",
57
57
  "iana-format",
58
58
  "project-intelligence",
59
59
  "codebase-understanding",
package/project.faf CHANGED
@@ -1,7 +1,7 @@
1
1
  faf_version: "3.0"
2
2
  project:
3
3
  name: faf-mcp
4
- 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".
4
+ 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".
5
5
  main_language: TypeScript
6
6
  type: mcp
7
7
  framework: MCP SDK (TS)
@@ -28,7 +28,7 @@ stack:
28
28
  storage: slotignored
29
29
  human_context:
30
30
  who: Developers using Claude, Cursor, Windsurf, VS Code, Cline, and any MCP-compatible IDE
31
- what: Universal MCP server providing .faf context tools — 25 core + 36 advanced, interop with AGENTS.md, .cursorrules, GEMINI.md
31
+ 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
32
32
  why: Eliminate the 20-minute AI context tax — give AI instant project understanding in 30 seconds
33
33
  where: npm · MCP Registry · Cloudflare edge (ide.faf.one/mcp/v1) · any MCP-compatible IDE — people get it how they wish
34
34
  when: Production/Stable — v2.0.0 WJTTC certified (309/309 tests, 9 suites)