faf-mcp 4.1.0 → 4.1.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 (7) hide show
  1. package/CHANGELOG.md +8 -1
  2. package/CLAUDE.md +2 -2
  3. package/README.md +7 -1
  4. package/dist/src/instructions.js +1 -1
  5. package/dist/src/instructions.js.map +1 -1
  6. package/package.json +1 -1
  7. package/project.faf +2 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <!-- 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". -->
2
- <!-- faf: doc=changelog | latest=v4.1.0 | canonical=project.faf | family=FAF -->
2
+ <!-- faf: doc=changelog | latest=v4.1.1 | canonical=project.faf | family=FAF -->
3
3
 
4
4
  # Changelog
5
5
 
@@ -8,6 +8,13 @@ All notable changes to faf-mcp will be documented in this file.
8
8
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
9
9
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
10
10
 
11
+ ## [4.1.1] - 2026-10-28 — The Instructions Edition
12
+
13
+ **One rule for project questions: read project.faf first.**
14
+
15
+ ### Changed
16
+ - **Server instructions: a rule for project questions.** Line 2 now reads "For questions about the project (stack, goal, commands), read project.faf first and answer from it. faf_score shows what is missing; faf_doctor says why." It replaces "Start with faf_doctor or faf_score…", which models read as a hint: in a 3-run pilot on a repo where project.faf and package.json disagree, Claude Code and Grok Build read package.json first 3 of 3 with the old line, and project.faf first 3 of 3 (Claude) and 2 of 3 (Grok) with the new one. 712 characters.
17
+
11
18
  ## [4.1.0] - 2026-10-27 — The Instructions Edition
12
19
 
13
20
  **faf-mcp now tells the model how its tools fit together: server instructions in initialize (642 characters), plus faf-cli 8.5.0, which knows a skills repo when it sees one.** 413 tests pass, 0 fail.
package/CLAUDE.md CHANGED
@@ -25,12 +25,12 @@ The Interop MCP for Context — the Cursor / IDE Edition. Persistent context for
25
25
  - **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
26
26
  - **Why:** Eliminate the 20-minute AI context tax — give AI instant project understanding in 30 seconds
27
27
  - **Where:** npm · MCP Registry · any MCP-compatible IDE — people get it how they wish
28
- - **When:** Production/Stable — v4.1.0 The Instructions Edition, WJTTC certified
28
+ - **When:** Production/Stable — v4.1.1 The Instructions Edition, WJTTC certified
29
29
  - **How:** npx faf-mcp or npm install -g faf-mcp, then add to your MCP config
30
30
 
31
31
  ---
32
32
 
33
- *STATUS: SYNC ACTIVE — 2026-10-27T21:01:01.358Z*
33
+ *STATUS: SYNC ACTIVE — 2026-10-29T02:09:48.329Z*
34
34
  <!-- faf:end -->
35
35
 
36
36
  ## Working here
package/README.md CHANGED
@@ -28,7 +28,13 @@
28
28
 
29
29
  ---
30
30
 
31
- ## What's New in 4.1.0 — The Instructions Edition
31
+ ## What's New in 4.1.1 — The Instructions Edition
32
+
33
+ **One rule for project questions: read project.faf first.**
34
+
35
+ - **Server instructions, line 2.** "For questions about the project (stack, goal, commands), read project.faf first and answer from it. faf_score shows what is missing; faf_doctor says why." It replaces "start with `faf_doctor` or `faf_score`", which agents read as a hint. In a 3-run pilot on a repo where project.faf and package.json disagree, Claude Code read project.faf first 3 of 3 and Grok Build 2 of 3 with the new line, against 0 of 3 for both with the old one. 712 characters.
36
+
37
+ ## 4.1.0 — The Instructions Edition
32
38
 
33
39
  **faf-mcp now tells the model how its tools fit together: server instructions in initialize (642 characters), plus faf-cli 8.5.0, which knows a skills repo when it sees one.**
34
40
 
package/dist/src/instructions.js CHANGED
@@ -11,7 +11,7 @@ exports.SERVER_INSTRUCTIONS = void 0;
11
11
  const skills_1 = require("./handlers/skills");
12
12
  exports.SERVER_INSTRUCTIONS = [
13
13
  'Works on one project at a time: faf_context sets or shows it; tools without a path use it.',
14
- 'Start with faf_doctor or faf_score to see what project.faf has and what is missing.',
14
+ 'For questions about the project (stack, goal, commands), read project.faf first and answer from it. faf_score shows what is missing; faf_doctor says why.',
15
15
  "No project.faf yet: faf_auto creates it; faf_git drafts one from a public GitHub repo. Human fields come from the user through faf_go or faf_check: ask, don't invent answers.",
16
16
  "project.faf is the source: faf_claude, faf_agents, faf_cursor and faf_gemini write CLAUDE.md, AGENTS.md, .cursorrules and GEMINI.md from it (or import them). faf_sync refreshes project.faf from the repo's manifests.",
17
17
  `Skill guide: ${skills_1.FAF_IDE_SKILL_URI}, through skills/get or resources/read.`,
package/dist/src/instructions.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/instructions.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,8CAAsD;AAEzC,QAAA,mBAAmB,GAAG;IACjC,4FAA4F;IAC5F,qFAAqF;IACrF,gLAAgL;IAChL,yNAAyN;IACzN,gBAAgB,0BAAiB,yCAAyC;CAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}
1
+ {"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/instructions.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,8CAAsD;AAEzC,QAAA,mBAAmB,GAAG;IACjC,4FAA4F;IAC5F,2JAA2J;IAC3J,gLAAgL;IAChL,yNAAyN;IACzN,gBAAgB,0BAAiB,yCAAyC;CAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "faf-mcp",
3
- "version": "4.1.0",
3
+ "version": "4.1.1",
4
4
  "mcpName": "one.faf/faf-mcp",
5
5
  "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.",
6
6
  "icon": "./assets/icons/faf-icon-256.png",
package/project.faf CHANGED
@@ -2,7 +2,7 @@ faf_version: "3.0"
2
2
  project:
3
3
  name: faf-mcp
4
4
  title: .FAF Context
5
- version: 4.1.0
5
+ version: 4.1.1
6
6
  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".
7
7
  main_language: TypeScript
8
8
  type: mcp
@@ -33,7 +33,7 @@ human_context:
33
33
  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
34
34
  why: Eliminate the 20-minute AI context tax — give AI instant project understanding in 30 seconds
35
35
  where: npm · MCP Registry · any MCP-compatible IDE — people get it how they wish
36
- when: Production/Stable — v4.1.0 The Instructions Edition, WJTTC certified
36
+ when: Production/Stable — v4.1.1 The Instructions Edition, WJTTC certified
37
37
  how: npx faf-mcp or npm install -g faf-mcp, then add to your MCP config
38
38
  monorepo:
39
39
  packages_count: slotignored