Wolfe-Jam/faf-mcp

v2.1.1 Feature

This release adds 2 notable features for engineering teams evaluating rollout.

Published 8d MCP Developer Tools

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agents-md ai ai-context claude cline cursor

+14 more

developer-tools faf gemini grok mcp mcp-server model-context-protocol nodejs npm project-dna typescript vscode warp windsurf

Summary

AI summary

faf_score now uses faf-cli's IANA-spec scorer and handles invalid .faf files gracefully.

Changes in this release

Type	Severity	Summary	CVE
Bugfix
Bugfix	Medium	`faf_score` now calls faf-cli's `scoreFafYaml` IANA-spec scorer, retiring legacy pseudo-score. `faf_score` now calls faf-cli's `scoreFafYaml` IANA-spec scorer, retiring legacy pseudo-score. Source: llm_adapter@2026-05-26 Confidence: high	—
Bugfix	Medium	Graceful handling of invalid or missing .faf files returns clear diagnostic messages without crashes. Graceful handling of invalid or missing .faf files returns clear diagnostic messages without crashes. Source: llm_adapter@2026-05-26 Confidence: high	—
Bugfix	Low	Added dynamic-import bridge for Node 18 ESM‑from‑CJS compatibility with faf-cli's broken `bun` exports condition. Added dynamic-import bridge for Node 18 ESM‑from‑CJS compatibility with faf-cli's broken `bun` exports condition. Source: llm_adapter@2026-05-26 Confidence: high	—

Full changelog

🛡️ The shield loop closes — truthful score lands for users

v2.1.0 shipped the single-source scoreFafYaml fix in ChampionshipToolHandler, but server.ts still wired the legacy FafToolHandler with the 40+30+15+14 pseudo-score. WJTTC AERO Phase 2 caught it. v2.1.1 closes the loop — faf_score now calls faf-cli's real, IANA-spec scorer directly.

Fixed

faf_score — now calls faf-cli's scoreFafYaml (IANA-spec scorer). Legacy file-presence pseudo-score retired on the live handler. Output reformatted: FAF SCORE: <n>/100 (<n>%) ● TIER + canonical Unicode tier glyphs + progress bar + populated/total slots + next-tier hint. Banned medal/colored-circle ladder dead on this surface too.
Graceful invalid-.faf handling — 0/100 (0%) ○ INVALID / ○ UNREADABLE / ♡ no .faf with diagnostics. No fake numbers, no crashes.
Node 18 ESM-from-CJS compat — dynamic-import bridge (temp workaround for faf-cli's broken bun exports condition).

Tests

WJTTC AERO Phase 2 — score-parity assertion tightened to TRUE parity: MCP faf_score numeric == faf-cli scoreFafYaml(...).score on the same YAML.
341 pass / 1 todo / 0 fail / 1336 expects — CI green across ubuntu/macOS/windows + Node 18+20.

FAF defines. MD instructs. AI codes.

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track Wolfe-Jam/faf-mcp

Get notified when new releases ship.

About Wolfe-Jam/faf-mcp

Universal persistent project context for Cursor, Windsurf, Cline, VS Code, and all MCP-compatible platforms (including Claude Desktop). IANA-registered format (application/vnd.faf+yaml). 17 native tools, AI-readiness scoring.

All releases →