claude-faf-mcp 2.7.3 → 2.8.0

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to claude-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).
 
+## [2.8.0] - 2025-11-05
+
+### Added
+- Tool Visibility System - Intelligent filtering to reduce cognitive load
+- 21 Core Tools (default) - Essential workflow tools shown by default
+- 30+ Advanced Tools (opt-in) - Expert-level tools via FAF_MCP_SHOW_ADVANCED env var
+- Tool categorization system (workflow, quality, intelligence, sync, ai, help, trust, file, utility, display)
+- Configuration priority system (ENV > config file > default)
+- Support for ~/.fafrc config file (JSON and key=value formats)
+- Claude Code skill (faf-expert) bundled with package
+- Comprehensive visibility test suite (22 new tests)
+
+### Changed
+- Default tool count reduced from 51 to 21 (59% reduction in cognitive load)
+- Tool filtering performance <10ms (5x better than 50ms target)
+- Professional console output (silent operation, no clutter)
+- README updated with v2.8.0 features and Claude Code skill installation
+
+### Performance
+- Sub-10ms tool filtering for 56 tools
+- Zero regressions in existing functionality
+- 79 total tests passing (57 existing + 22 new)
+
+### Testing
+- WJTTC Gold Certified
+- F1-inspired testing standards applied
+- Complete test report available
+
 ## [2.7.3] - 2025-11-02
 
 ### Fixed

package/README.md

@@ -2,7 +2,7 @@
 
 > **🏆 IANA-Registered Format** - .FAF is now an Internet-standard format.
 > MCP server for creating official `application/vnd.faf+yaml` files in Claude Desktop
-> Official MCP server for FAF (Foundational AI-context Format) with 33+ tools -
+> Official MCP server for FAF (Foundational AI-context Format) with 50+ tools -
 > Persistent project context that integrates seamlessly with Claude Desktop workflows
 
 [![NPM Version](https://img.shields.io/npm/v/claude-faf-mcp?color=FF4500)](https://www.npmjs.com/package/claude-faf-mcp)
@@ -14,7 +14,7 @@
 
 **Problem:** AI needs persistent project context—not just md docs or tools, but foundational infrastructure.
 
-**Solution:** The .faf format is a structured, machine-readable context layer. This MCP server gives Claude 33+ tools to create, score, and improve your project's persistent context through format-driven architecture.
+**Solution:** The .faf format is a structured, machine-readable context layer. This MCP server gives Claude 50+ tools to create, score, and improve your project's persistent context through format-driven architecture.
 
 **How it works:** Get a score (0-100%) showing how well AI understands your project. Higher scores = AI more in-tune with your codebase. Use tools to improve your score and context quality. Your .faf context persists across sessions.
 
@@ -88,16 +88,59 @@ Published to official Anthropic MCP registry with validation by Anthropic engine
 
 ---
 
-## What's New in v2.7.2 - IANA Registration
+## What's New in v2.8.0 - Tool Visibility System
 
-**v2.7.2 updates documentation with IANA registration achievement.**
+**v2.8.0 introduces intelligent tool filtering to reduce cognitive load.**
 
-On **October 31, 2025**, the Internet Assigned Numbers Authority (IANA) officially registered `.faf` as `application/vnd.faf+yaml` - making it an Internet-standard format alongside PDF, JSON, and XML.
+### New Features
 
-**What this means:**
-- Official Internet media type recognition
-- Proper HTTP Content-Type headers
-- Browser and email client support
+**21 Core Tools (Default)**
+Essential workflow tools shown by default:
+- Workflow: `faf`, `faf_auto`, `faf_init`, `faf_innit`, `faf_status`
+- Quality: `faf_score`, `faf_validate`, `faf_doctor`, `faf_audit`
+- Intelligence: `faf_formats`, `faf_stacks`, `faf_skills`
+- Sync: `faf_sync`, `faf_bi_sync`, `faf_update`, `faf_migrate`
+- AI: `faf_chat`, `faf_enhance`
+- Help: `faf_index`, `faf_faq`, `faf_about`
+
+**30+ Advanced Tools (Opt-in)**
+Expert-level tools available via environment variable:
+- Display variants: `faf_display`, `faf_show`, `faf_check`
+- Trust system: `faf_trust`, `faf_trust_confidence`, `faf_trust_garage`
+- File operations: `faf_read`, `faf_write`, `faf_list`, `faf_exists`
+- DNA tracking: `faf_dna`, `faf_log`, `faf_auth`, `faf_recover`
+- Utilities: `faf_choose`, `faf_clear`, `faf_share`, `faf_credit`
+
+**Enable Advanced Tools:**
+```json
+{
+  "mcpServers": {
+    "claude-faf-mcp": {
+      "command": "claude-faf-mcp",
+      "env": {
+        "FAF_MCP_SHOW_ADVANCED": "true"
+      }
+    }
+  }
+}
+```
+
+**New! Claude Code Skill**
+The `faf-expert` skill is now available - your on-hand 24/7 FAF specialist:
+- Expert guidance on .faf files and project DNA
+- Tool Visibility System documentation
+- MCP server configuration help
+- AI-readiness scoring assistance
+
+### Performance
+- **<10ms tool filtering** (5x better than 50ms championship target)
+- **79 tests passing** (57 existing + 22 new visibility tests)
+- **Zero regressions** - All existing functionality preserved
+- **WJTTC Gold Certified** - F1-inspired testing standards
+
+### Previous: v2.7.2 - IANA Registration
+
+On **October 31, 2025**, IANA officially registered `.faf` as `application/vnd.faf+yaml` - making it an Internet-standard format alongside PDF, JSON, and XML
 - API standardization across platforms
 
 This documentation update adds IANA information throughout the README to reflect this major infrastructure-level achievement.
@@ -205,7 +248,7 @@ Format-driven means the architecture is built on data structure first, not tooli
   - Email client support
   - API standardization across platforms
 
-- **33 MCP Tools** - Complete project context management
+- **50+ MCP Tools** - Complete project context management
   - Project DNA generation and scoring
   - Bi-directional CLAUDE.md sync
   - Format validation and conversion
@@ -297,7 +340,7 @@ Full tool documentation available at https://faf.one/docs/tools.
 1. Drop any project file into Claude Desktop
 2. Type: "Run faf_auto to analyze this project"
 3. Get instant context - Claude understands your codebase
-4. Access 33+ commands naturally in conversation
+4. Access 50+ commands naturally in conversation
 
 The .faf file persists across conversations - no need to re-explain your project each time.
 
@@ -341,9 +384,31 @@ Node.js 18 or later. Claude Desktop (latest version). Operating system: macOS, L
 
 ---
 
+## Claude Code Skill Installation
+
+**NEW**: Install the `faf-expert` skill for enhanced FAF support in Claude Code:
+
+```bash
+# Install from npm package
+mkdir -p ~/.claude/skills/faf-expert
+cp node_modules/claude-faf-mcp/skill/SKILL.md ~/.claude/skills/faf-expert/
+
+# Or download directly
+curl -o ~/.claude/skills/faf-expert/SKILL.md \
+  https://cdn.jsdelivr.net/npm/claude-faf-mcp@latest/skill/SKILL.md
+```
+
+Restart Claude Code to activate. The skill provides:
+- Expert guidance on .faf files and project DNA
+- v2.8.0 Tool Visibility System documentation
+- MCP server configuration help
+- AI-readiness scoring assistance
+
+---
+
 ## The FAF Ecosystem
 
-faf-cli (npm) - Command line tool for local context management. claude-faf-mcp - This MCP server for Claude Desktop integration. faf.one - Documentation and guides. Chrome Extension - Browser integration for context collection.
+faf-cli (npm) - Command line tool for local context management. claude-faf-mcp - This MCP server for Claude Desktop integration. faf.one - Documentation and guides. Chrome Extension - Browser integration for context collection. faf-expert skill - Claude Code integration for FAF expertise.
 
 ---
 

package/dist/src/compiler/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * FAF Compiler Engine MK3
+ * Championship-grade project type detection and scoring
+ */
+export * from './type-detector';
+export * from './slot-validator';
+export * from './scorer';

package/dist/src/compiler/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * FAF Compiler Engine MK3
+ * Championship-grade project type detection and scoring
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./type-detector"), exports);
+__exportStar(require("./slot-validator"), exports);
+__exportStar(require("./scorer"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/compiler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/compiler/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,kDAAgC;AAChC,mDAAiC;AACjC,2CAAyB"}

package/dist/src/compiler/scorer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Compiler Engine Scorer - FAF Compiler Engine MK3
+ * Championship-grade scoring with context-aware metrics
+ */
+export interface ScoringResult {
+    score: number;
+    medal: 'trophy' | 'gold' | 'silver' | 'bronze' | 'red' | 'white';
+    emoji: string;
+    message: string;
+    breakdown: {
+        totalSlots: 21;
+        relevantSlots: number;
+        filledSlots: number;
+        ignoredSlots: number;
+    };
+    nextMilestone: {
+        targetScore: number;
+        medal: string;
+        emoji: string;
+        slotsNeeded: number;
+        message: string;
+    } | null;
+}
+export declare class CompilerEngineScorer {
+    /**
+     * Calculate score with slotignore support
+     */
+    calculateScore(filledSlots: number, relevantSlots: number, slotignore: string[]): ScoringResult;
+    /**
+     * Determine medal from score
+     */
+    private getMedal;
+    /**
+     * Get medal emoji
+     */
+    private getMedalEmoji;
+    /**
+     * Generate contextual message
+     */
+    private getMessage;
+    /**
+     * Calculate next milestone
+     */
+    private getNextMilestone;
+    /**
+     * Format scoring result as human-readable text
+     */
+    formatResult(result: ScoringResult, projectType?: string): string;
+    /**
+     * Generate actionable suggestions based on score
+     */
+    generateSuggestions(score: number, _medal: string, _missingSlots: string[]): string[];
+}

package/dist/src/compiler/scorer.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Compiler Engine Scorer - FAF Compiler Engine MK3
+ * Championship-grade scoring with context-aware metrics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompilerEngineScorer = void 0;
+class CompilerEngineScorer {
+    /**
+     * Calculate score with slotignore support
+     */
+    calculateScore(filledSlots, relevantSlots, slotignore) {
+        // Calculate score: (filled / relevant) * 100
+        const score = Math.round((filledSlots / relevantSlots) * 100);
+        // Determine medal
+        const medal = this.getMedal(score);
+        const emoji = this.getMedalEmoji(medal);
+        // Generate message
+        const message = this.getMessage(score, filledSlots, relevantSlots, medal);
+        // Calculate next milestone
+        const nextMilestone = this.getNextMilestone(score, filledSlots, relevantSlots);
+        return {
+            score,
+            medal,
+            emoji,
+            message,
+            breakdown: {
+                totalSlots: 21,
+                relevantSlots,
+                filledSlots,
+                ignoredSlots: slotignore.length,
+            },
+            nextMilestone,
+        };
+    }
+    /**
+     * Determine medal from score
+     */
+    getMedal(score) {
+        if (score >= 85)
+            return 'trophy'; // Championship grade
+        if (score >= 70)
+            return 'gold'; // Podium grade
+        if (score >= 55)
+            return 'silver'; // Strong
+        if (score >= 40)
+            return 'bronze'; // Decent
+        if (score >= 20)
+            return 'red'; // Needs work
+        return 'white'; // Just started
+    }
+    /**
+     * Get medal emoji
+     */
+    getMedalEmoji(medal) {
+        switch (medal) {
+            case 'trophy': return '🏆';
+            case 'gold': return '🥇';
+            case 'silver': return '🥈';
+            case 'bronze': return '🥉';
+            case 'red': return '🔴';
+            case 'white': return '🤍';
+            default: return '⚪';
+        }
+    }
+    /**
+     * Generate contextual message
+     */
+    getMessage(score, filled, relevant, medal) {
+        if (score === 100) {
+            return `Perfect ${medal === 'trophy' ? 'Championship' : 'Project'} DNA! All ${filled}/${relevant} relevant slots filled.`;
+        }
+        if (score >= 85) {
+            return `Championship grade! ${filled}/${relevant} slots filled. Podium performance!`;
+        }
+        if (score >= 70) {
+            return `Podium grade! ${filled}/${relevant} slots filled. Strong AI context.`;
+        }
+        if (score >= 55) {
+            return `Solid foundation. ${filled}/${relevant} slots filled. Keep going!`;
+        }
+        if (score >= 40) {
+            return `Decent start. ${filled}/${relevant} slots filled. Room for improvement.`;
+        }
+        if (score >= 20) {
+            return `Getting started. ${filled}/${relevant} slots filled. Focus on core context.`;
+        }
+        return `Just beginning. ${filled}/${relevant} slots filled. Add project basics first.`;
+    }
+    /**
+     * Calculate next milestone
+     */
+    getNextMilestone(score, filled, relevant) {
+        // Already at 100%
+        if (score === 100) {
+            return null;
+        }
+        // Define milestones
+        const milestones = [
+            { threshold: 85, name: 'trophy', emoji: '🏆', label: 'Championship Grade' },
+            { threshold: 70, name: 'gold', emoji: '🥇', label: 'Podium Grade' },
+            { threshold: 55, name: 'silver', emoji: '🥈', label: 'Solid Foundation' },
+            { threshold: 40, name: 'bronze', emoji: '🥉', label: 'Decent Start' },
+            { threshold: 20, name: 'red', emoji: '🔴', label: 'Getting Started' },
+        ];
+        // Find next milestone
+        const nextMilestone = milestones.find(m => score < m.threshold);
+        if (!nextMilestone) {
+            // Already above all milestones, aim for 100%
+            const slotsNeeded = relevant - filled;
+            return {
+                targetScore: 100,
+                medal: 'trophy',
+                emoji: '🏆',
+                slotsNeeded,
+                message: `Fill ${slotsNeeded} more slot${slotsNeeded === 1 ? '' : 's'} to reach 100% (Perfect!)`,
+            };
+        }
+        // Calculate slots needed
+        const targetFilled = Math.ceil((nextMilestone.threshold / 100) * relevant);
+        const slotsNeeded = Math.max(1, targetFilled - filled);
+        return {
+            targetScore: nextMilestone.threshold,
+            medal: nextMilestone.name,
+            emoji: nextMilestone.emoji,
+            slotsNeeded,
+            message: `Fill ${slotsNeeded} more slot${slotsNeeded === 1 ? '' : 's'} to reach ${nextMilestone.threshold}% (${nextMilestone.label})`,
+        };
+    }
+    /**
+     * Format scoring result as human-readable text
+     */
+    formatResult(result, projectType) {
+        const lines = [];
+        // Header
+        lines.push(`${result.emoji} Score: ${result.score}%`);
+        lines.push('');
+        // Message
+        lines.push(result.message);
+        lines.push('');
+        // Breakdown
+        lines.push('Breakdown:');
+        lines.push(`  Total Slots: ${result.breakdown.totalSlots}`);
+        if (projectType) {
+            lines.push(`  Project Type: ${projectType}`);
+        }
+        lines.push(`  Relevant Slots: ${result.breakdown.relevantSlots}`);
+        lines.push(`  Filled Slots: ${result.breakdown.filledSlots}`);
+        if (result.breakdown.ignoredSlots > 0) {
+            lines.push(`  Ignored Slots: ${result.breakdown.ignoredSlots} (not applicable to this project type)`);
+        }
+        // Next milestone
+        if (result.nextMilestone) {
+            lines.push('');
+            lines.push('Next Milestone:');
+            lines.push(`  ${result.nextMilestone.emoji} ${result.nextMilestone.message}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Generate actionable suggestions based on score
+     */
+    generateSuggestions(score, _medal, _missingSlots) {
+        const suggestions = [];
+        if (score < 40) {
+            suggestions.push('Start with core slots: project_identity, language, human_context');
+            suggestions.push('Add basic documentation: README.md, CLAUDE.md');
+        }
+        if (score >= 40 && score < 70) {
+            suggestions.push('Fill in your tech stack details (frontend, backend, database)');
+            suggestions.push('Add build and deployment information');
+        }
+        if (score >= 70 && score < 85) {
+            suggestions.push('Complete architecture details (auth, storage, caching)');
+            suggestions.push('Add team workflow and CI/CD information');
+        }
+        if (score >= 85 && score < 100) {
+            suggestions.push('Polish remaining slots for championship grade');
+            suggestions.push('Ensure all documentation is up to date');
+        }
+        if (score === 100) {
+            suggestions.push('Perfect! Consider sharing your .faf with the community');
+            suggestions.push('Keep it updated as your project evolves');
+        }
+        return suggestions;
+    }
+}
+exports.CompilerEngineScorer = CompilerEngineScorer;
+//# sourceMappingURL=scorer.js.map

package/dist/src/compiler/scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.js","sourceRoot":"","sources":["../../../src/compiler/scorer.ts"],"names":[],"mappings":"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"}

package/dist/src/compiler/slot-validator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Slot Validator - FAF Compiler Engine MK3
+ * Championship-grade slot validation with .faf content analysis
+ */
+import { ValidationResult } from '../types/slots';
+import { ProjectType } from '../types/project-types';
+export declare class SlotValidator {
+    /**
+     * Validate all slots against project type
+     */
+    validate(fafContent: any, projectType: ProjectType): ValidationResult;
+    /**
+     * Check if a specific slot is filled in .faf content
+     */
+    private isSlotFilled;
+    /**
+     * Get the value of a slot from .faf content
+     */
+    private getSlotValue;
+    /**
+     * Helper: Check if fafContent has a specific framework
+     */
+    private hasFramework;
+    /**
+     * Determine medal from score
+     */
+    private getMedal;
+    /**
+     * Load and parse .faf file from directory
+     */
+    static loadFafFile(projectPath: string): Promise<any | null>;
+}