faf-mcp 4.0.0 → 4.0.1

package/CHANGELOG.md

@@ -1,5 +1,5 @@
 <!-- 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: doc=changelog | latest=v4.0.0 | canonical=project.faf | family=FAF -->
+<!-- faf: doc=changelog | latest=v4.0.1 | canonical=project.faf | family=FAF -->
 
 # Changelog
 
@@ -8,9 +8,16 @@ All notable changes to faf-mcp will be documented in this file.
 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).
 
+## [4.0.1] - 2026-10-16
+
+**`faf-mcp --version` and `--help` answer and exit. Before, both started the server.** 407 tests pass, 0 fail.
+
+### Fixed
+- `--version` / `-v` / `-V` prints `faf-mcp 4.0.1` and exits 0; `--help` / `-h` prints usage and a client config and exits 0. Both used to start the server on stdio and print nothing. Any other argument still starts the server, so client configs don't change. New `tests/cli-flags.test.ts` runs each flag with stdin closed and a time limit. Closes #94.
+
 ## [4.0.0] - 2026-09-26 — The Always33 Edition
 
-**One engine, one number: faf-mcp 4 scores all 33 slots with faf-cli 8's always-33 kernel — the same score faf-cli, claude-faf-mcp 7 and faf-kernel give.** 402 tests.
+**One engine, one number: faf-mcp 4 scores with faf-cli 8's always-33 kernel — the same score faf-cli, claude-faf-mcp 7 and faf-kernel give.** 402 tests.
 
 **4.0.0 is a major release because scores can move.** A `.faf` without the 12 enterprise `slotignored` markers now counts them as empty (21 filled = 64%). Run `faf_auto` — it writes the markers and the score returns (a v3-era mcp-context-card file: 56% → 100%). Anything that gates on `faf_score` should re-check its threshold.
 

package/CLAUDE.md

@@ -25,12 +25,12 @@ The Interop MCP for Context — the Cursor / IDE Edition. Persistent context for
 - **What:** The Cursor / IDE Edition — persistent context for Cursor, VS Code, and every MCP-compatible IDE — 29 MCP tools (15 essential shown by default), 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 · any MCP-compatible IDE — people get it how they wish
-- **When:** Production/Stable — v4.0.0 The Always33 Edition, WJTTC certified
+- **When:** Production/Stable — v4.0.1 The Always33 Edition, WJTTC certified
 - **How:** npx faf-mcp or npm install -g faf-mcp, then add to your MCP config
 
 ---
 
-*STATUS: SYNC ACTIVE — 2026-09-26T17:54:17.189Z*
+*STATUS: SYNC ACTIVE — 2026-10-16T16:57:57.556Z*
 <!-- faf:end -->
 
 ## Working here

package/README.md

@@ -24,12 +24,19 @@
 [![CI](https://github.com/Wolfe-Jam/faf-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Wolfe-Jam/faf-mcp/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![project.faf](https://img.shields.io/badge/project.faf-inside-008B8B)](https://github.com/Wolfe-Jam/faf)
+[![Business card · Get yours →](https://wolfe-jam.github.io/agent-business-card/badge.svg)](https://wolfe-jam.github.io/agent-business-card/?repo=Wolfe-Jam/faf-mcp)
 
 ---
 
-## What's New in 4.0.0 — The Always33 Edition
+## What's New in 4.0.1
 
-**One engine, one number: faf-mcp 4 scores all 33 slots with faf-cli 8's always-33 kernel — the same score faf-cli, claude-faf-mcp 7 and faf-kernel give.**
+**`faf-mcp --version` and `--help` answer and exit. Before, both started the server.**
+
+- `--version` (`-v`) prints the version; `--help` (`-h`) prints usage and a client config. Anything else starts the server as before, so your client config doesn't change.
+
+## 4.0.0 — The Always33 Edition
+
+**One engine, one number: faf-mcp 4 scores with faf-cli 8's always-33 kernel — the same score faf-cli, claude-faf-mcp 7 and faf-kernel give.**
 
 - **The always-33 engine.** Every tool scores with faf-cli 8.0.0 — all 33 Mk4 slots, one Rust kernel, one copy of it. Checked live: faf-python-sdk 56, mcp-context-card 56, faf-cli ✪ 100.
 - **Your 21 slots, and the 12 enterprise slots in view.** The enterprise slots (infra, app, ops) are marked `slotignored` unless your app-type uses them. `faf_score` scores against all 33; `slotignored` slots drop out of the denominator.

package/dist/src/index.js

@@ -2,8 +2,44 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const server_js_1 = require("./server.js");
+const version_js_1 = require("./version.js");
+const HELP = `faf-mcp — MCP server for FAF (project.faf, IANA application/vnd.faf+yaml)
+
+Usage:
+  faf-mcp              Serve MCP over stdio (what MCP clients run)
+  faf-mcp --version    Print the version (-v, -V)
+  faf-mcp --help       Print this help (-h)
+
+Run on its own, it waits silently for an MCP client. That's correct; Ctrl+C to quit.
+
+Add it to a client:
+  claude mcp add faf -- npx -y faf-mcp
+  { "mcpServers": { "faf": { "command": "npx", "args": ["-y", "faf-mcp"] } } }
+
+https://github.com/Wolfe-Jam/faf-mcp`;
+/**
+ * `--version` / `--help` answer and exit before the server starts, so stdout
+ * carries only the answer (#94). Any other argument starts the server as
+ * before, so existing client configs don't change.
+ */
+function handleFlags(argv) {
+    const arg = argv[2];
+    if (arg === '--version' || arg === '-v' || arg === '-V') {
+        console.log(`faf-mcp ${(0, version_js_1.getVersion)()}`);
+        return 0;
+    }
+    if (arg === '--help' || arg === '-h') {
+        console.log(HELP);
+        return 0;
+    }
+    return null;
+}
 // MCP servers run via stdio transport when launched by your MCP host
 async function main() {
+    const code = handleFlags(process.argv);
+    if (code !== null) {
+        process.exit(code);
+    }
     const server = new server_js_1.FafMcpServer({
         transport: 'stdio',
         fafEnginePath: 'faf'

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAEA,2CAA2C;AAE3C,qEAAqE;AACrE,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,wBAAY,CAAC;QAC9B,SAAS,EAAE,OAAO;QAClB,aAAa,EAAE,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAEA,2CAA2C;AAC3C,6CAA0C;AAE1C,MAAM,IAAI,GAAG;;;;;;;;;;;;;qCAawB,CAAC;AAEtC;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAc;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,WAAW,IAAA,uBAAU,GAAE,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qEAAqE;AACrE,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,wBAAY,CAAC;QAC9B,SAAS,EAAE,OAAO;QAClB,aAAa,EAAE,KAAK;KACrB,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-mcp",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "mcpName": "one.faf/faf-mcp",
   "description": ".FAF Context — persistent project context for Cursor, VS Code and every MCP-compatible IDE. IANA-registered .faf format. Curated core tools by default, full set via FAF_TOOLS=all.",
   "icon": "./assets/icons/faf-icon-256.png",
@@ -113,9 +113,9 @@
   },
   "overrides": {
     "hono": ">=4.13.5",
-    "fast-uri": ">=4.1.2",
-    "ip-address": ">=10.3.1",
-    "brace-expansion@1": "1.1.18",
-    "brace-expansion@2": "2.1.4"
+    "fast-uri": ">=4.1.5",
+    "ip-address": ">=10.7.1",
+    "brace-expansion@1": "1.1.21",
+    "brace-expansion@2": "2.1.7"
   }
 }

package/project.faf

@@ -2,7 +2,7 @@ faf_version: "3.0"
 project:
   name: faf-mcp
   title: .FAF Context
-  version: 4.0.0
+  version: 4.0.1
   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
@@ -33,7 +33,7 @@ human_context:
   what: The Cursor / IDE Edition — persistent context for Cursor, VS Code, and every MCP-compatible IDE — 29 MCP tools (15 essential shown by default), 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 · any MCP-compatible IDE — people get it how they wish
-  when: Production/Stable — v4.0.0 The Always33 Edition, WJTTC certified
+  when: Production/Stable — v4.0.1 The Always33 Edition, WJTTC certified
   how: npx faf-mcp or npm install -g faf-mcp, then add to your MCP config
 monorepo:
   packages_count: slotignored