Wolfe-Jam/claude-faf-mcp

[5.5.2] - 2026-05-03

Added

• Postinstall star CTA — runs once on npm install -g claude-faf-mcp after the success confirmation. Quiet, no throws, no spam.

Changed

• displayName standardized to .faf 🐘 — pairs the constant elephant family mark with each surface's modifier in MCP client lists (matches grok-faf-mcp's .faf 🐘⚡️ for Grok pattern).
• Package description aligned to "Persistent project context for AI" — the canonical positioning across the FAF family. npm and MCP Registry catalogs both pick this up.
• Branding pass — README scoring table now uses geometric tier symbols (★ ◆ ◇ ● ○ ♡) matching faf-cli/src/core/tiers.ts. 🏆 is the only emoji marker; decorative emojis stripped from CLI surfaces.
• manifest.json description sharpened to "Persistent project context that survives sessions, works across AI tools, and eliminates re-explaining" — strengthens the user-facing pitch in Claude Desktop's Extensions catalog.

Fixed

• vercel.json restored — fixes the "No Output Directory" deploy error that surfaced after a prior cleanup pass. claude-faf-mcp.vercel.app builds cleanly again.
• MCP Registry hygiene — server.json metadata pass for cleaner Registry listing.

Internal

• CI Performance Check job is now non-gating — perf tests report but don't block main CI. Restores red-means-real signal integrity.
• Perf-check fake-fail eliminated — test:performance now overrides testPathIgnorePatterns so Jest actually picks up tests/performance.test.ts. Workflow had been silently exit-1'ing on "No tests found" for months, painting a fake red X on every commit. Real perf gate restored: 10/10 perf tests pass in 14s ("Championship Performance Achieved").
• Removed npm publish from CI workflow (#50). /pubpro is the single source of truth for shipping; CI validates only.
• Removed publish-mcp.yml auto-publisher. Same doctrine: CI validates, pubpro publishes — never both.
• Weekly npm audit auto-fix kept current.

Notes

• Docs + branding + CI hygiene patch — no MCP protocol changes, no breaking changes for tool users. Safe upgrade for all consumers.
• First release after the FAF Foundation alignment sweep (.faf 🐘 family mark, "Persistent project context" tagline, three-reader tree).

381 / 381 tests passing · TTT: PASS · MCP Registry: schema 2025-12-11

FAF defines. MD instructs. AI codes.

The Extension Edition

Desktop Extension (.mcpb) — one-click install for Claude Desktop. No JSON config, no terminal, no path debugging. Drag and click.

What's New

• Desktop Extension (.mcpb) — one-click install, 6.2MB bundle
• destructiveHint annotations on all 32 tools — Anthropic Connectors Directory compliant
• faf_read/faf_write tilde fix — all tools now handle ~/ paths consistently
• examples/test-project/ — sample project for reviewer testing
• pack:mcpb build script — repeatable .mcpb packaging

Security

• Removed behavioral-instruction.ts (unused prompt instruction wrapper)
• Updated PRIVACY.md — discloses GitHub API for faf_git
• npm audit: 0 vulnerabilities

Cleanup

• 27 junk files removed (test debris, Python artifacts, old reports)
• servers/ submodule removed (28MB)
• SECURITY.md updated to v5.x/4.x

Testing

• 118 tests, 0 code failures
• WJTTC v5.5.0: 67/67 Championship Grade
• Adversarial security suite: 25/25 (path traversal, resource exhaustion, prompt injection)
• 391 Jest tests passing

FAF defines. MD instructs. AI codes.

The Relentless Edition

FAF is relentless in its pursuit of 100% persistent project context — one source of truth that every AI and every MD can benefit from.

Added

• /faf MCP Prompt — type /faf in Claude Desktop. Check → Score → Improve → Sync → Lock 🏆
  • Relentlessly seeks 100%. Does not stop until the score is Trophy.
  • Syncs .faf ↔ CLAUDE.md ↔ MEMORY.md on completion.
  • "Claude is now optimized for [project name]. FAF defines. MD instructs. AI codes."
• Prompts capability added to MCP server

Changed

• Removed faf_what — 32 tools, zero redundancy
• tri-sync free for all developers (from v5.3.1)

Numbers

• 391/391 tests passing
• 32 tools + 1 prompt
• 50k+ downloads across npm, PyPI, crates.io

FAF defines. MD instructs. AI codes. 🏎️