claude-faf-mcp 3.2.0 → 3.3.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@ 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).
 
+## [3.3.0] - 2025-11-12
+
+### Added
+- **Desktop Extension (.mcpb)** - One-click installation bundle with branded FAF orange icon
+  - Packaged .mcpb format for drag-and-drop installation in Claude Desktop
+  - Orange smiley icon displays in all MCP server views
+  - Available from GitHub releases page
+- **MCP Protocol Icons** - Added full icon set (48x48, 128x128, 256x256, 512x512) to server.json
+  - Icons hosted on GitHub raw URLs for registry display
+  - Proper MIME types and size specifications
+
+### Changed
+- **One-Command Installation** - Moved faf-cli from peerDependencies to dependencies
+  - `npm install -g claude-faf-mcp` now auto-installs both packages
+  - Dual download metrics maintained (both packages counted separately)
+  - Eliminated manual two-step installation process
+- **README Restructure** - Added two installation options
+  - Option 1: npm (one command, no config editing)
+  - Option 2: Desktop Extension (with branded icon)
+  - Clear documentation of path resolution system
+
+### Installation Experience
+This release perfects the installation flow: users get one-command simplicity while we maintain accurate download metrics for both claude-faf-mcp and faf-cli packages.
+
 ## [3.2.0] - 2025-11-10
 
 ### Added

package/CLAUDE.md

@@ -0,0 +1,64 @@
+# 🏎️ CLAUDE.md - claude-faf-mcp Persistent Context & Intelligence
+**.faf format | project.faf**
+
+## PROJECT STATE: ACTIVE 🚀
+**Current Position:** Provide FAF context tools directly in Claude Desktop via MCP
+**Tyre Compound:** ULTRASOFT C5 (Maximum Performance)
+
+---
+
+## 🎨 CORE CONTEXT
+
+### Project Identity
+- **Name:** claude-faf-mcp
+- **Stack:** Node.js/TypeScript
+- **Quality:** F1-INSPIRED (Championship Performance)
+
+### Our Mission - 100% Standalone MCP Server
+
+**v3.0.4 Historic Milestone: ZERO CLI DEPENDENCIES**
+
+```
+claude-faf-mcp: 100% STANDALONE
+├── 50/50 MCP tools operational
+├── 14/14 bundled commands
+├── 16.2x faster than CLI versions
+├── 19ms average execution
+└── Zero external dependencies
+```
+
+**CRITICAL: claude-faf-mcp IS NOT A WRAPPER**
+- ✅ Independent standalone MCP server
+- ✅ 100% operational without any CLI
+- ✅ Own bundled FAF engine
+- ✅ Championship-grade performance
+- ❌ NOT a wrapper, NOT dependent on CLI
+
+**The .faf Position in MCP:**
+
+```
+Model        Context          Protocol
+─────        ───────          ────────
+Claude   →   .faf        →    MCP
+Gemini   →   .faf        →    MCP
+Codex    →   .faf        →    MCP
+Any LLM  →   IANA Format →    Open Protocol
+```
+
+.FAF provides the standardized Context that makes the Model Context Protocol work for everyone.
+
+### Technical Architecture
+- **What Building:** Universal FAF MCP Server for Claude Desktop - AI Context Intelligence
+- **Main Language:** TypeScript
+
+### 📊 Context Quality Status
+- **Overall Assessment:** Good
+- **Last Updated:** 2025-11-06
+
+---
+
+**STATUS: BI-SYNC ACTIVE 🔗 - Synchronized with .faf context!**
+
+*Last Sync: 2025-11-06T13:20:32.280Z*
+*Sync Engine: F1-Inspired Software Engineering*
+*🏎️⚡️_championship_sync*

package/README.md

@@ -22,6 +22,11 @@
 
 At 55% you are building your project with half a blueprint and basically flipping a coin with AI. .FAF defines, and AI becomes optimized for Context with the project.faf file.
 
+<div align="center">
+  <img src="./assets/Project-faf-pckg-json-README.png" alt="project.faf file positioning" width="600" />
+  <p><em>project.faf lives at the project root, between package.json and README.md</em></p>
+</div>
+
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 🏎️  FAF AI-READINESS SCORE: 100/100 — PODIUM EDITION
@@ -47,15 +52,17 @@ At 55% you are building your project with half a blueprint and basically flippin
 
 ## ⚡ Quick Start
 
-```bash
-# Install via npx (recommended - always latest)
-npx @modelcontextprotocol/inspector npx -y claude-faf-mcp
+### Option 1: npm (One Command 🚀)
+
+**One command installs everything:**
 
-# Or install globally
+```bash
 npm install -g claude-faf-mcp
 ```
 
-**Claude Desktop Configuration:**
+That's it! Auto-installs faf-cli + MCP server. Both get download metrics.
+
+**Configure Claude Desktop:**
 ```json
 {
   "mcpServers": {
@@ -67,6 +74,93 @@ npm install -g claude-faf-mcp
 }
 ```
 
+Restart Claude Desktop and you're ready!
+
+---
+
+### Option 2: Desktop Extension (With Icon 🧡)
+
+**Get the FAF orange icon in Claude Desktop!**
+
+**Step 1: Install CLI**
+```bash
+npm install -g faf-cli
+```
+
+**Step 2: Install Desktop Extension**
+1. **Download** the `.mcpb` file:
+   https://github.com/Wolfe-Jam/claude-faf-mcp/releases/latest
+
+2. **Install in Claude Desktop:**
+   - Settings → Extensions → Advanced settings
+   - Click "Install Extension"
+   - Select `claude-faf-mcp-v3.2.1.mcpb`
+   - Restart Claude Desktop
+
+3. **Verify the FAF orange icon** shows in your MCP list!
+
+**Why this is easier:** No config file editing, auto-detects CLI, branded icon everywhere.
+
+
+---
+
+## 📁 Projects Convention
+
+**Default Path Structure:** `~/Projects/[project-name]/project.faf`
+
+The MCP server uses an intelligent path resolution system:
+
+1. **AI Inference** - Automatically detects project name from README titles, package.json, or uploaded files
+2. **User Statement** - Explicit project name provided by user
+3. **Custom Path** - User-provided path always wins
+
+**Example Workflows:**
+
+```bash
+# Upload README titled "Heritage Club Dubai"
+# → Automatically creates: ~/Projects/heritage-club-dubai/project.faf
+
+# Provide project name
+faf_init projectName:"my-app"
+# → Creates: ~/Projects/my-app/project.faf
+
+# Explicit path (always respected)
+faf_init path:"/Users/you/custom/location"
+# → Creates: /Users/you/custom/location/project.faf
+```
+
+**Cross-Platform Support:**
+- macOS: `~/Projects/`
+- Linux: `~/Projects/`
+- Windows: `%USERPROFILE%\Projects\`
+
+**Guide Tool:**
+Run `faf_guide` in Claude Desktop for complete path resolution rules and UX patterns.
+
+---
+
+## 🔧 Troubleshooting
+
+**CLI Not Detected?**
+
+The MCP auto-detects faf-cli in common locations. If detection fails, set the path manually:
+
+```json
+{
+  "mcpServers": {
+    "faf": {
+      "command": "npx",
+      "args": ["-y", "claude-faf-mcp"],
+      "env": {
+        "FAF_CLI_PATH": "/custom/path/to/faf"
+      }
+    }
+  }
+}
+```
+
+Find your CLI path: `which faf`
+
 ---
 
 ## 🎯 What is FAF?
@@ -74,12 +168,12 @@ npm install -g claude-faf-mcp
 **The .FAF Position in the MCP Ecosystem:**
 
 ```
-Model        Context          Protocol
-─────        ───────          ────────
-Claude   →   .faf        →    MCP
-Gemini   →   .faf        →    MCP
-Codex    →   .faf        →    MCP
-Any LLM  →   IANA Format →    Open Protocol
+  Model        Context          Protocol
+  ─────        ───────          ────────
+  LLM       →   IANA Format →    Open Protocol
+  Claude   →   .faf        →    MCP
+  Gemini   →   .faf        →    MCP
+  Codex    →   .faf        →    MCP
 ```
 
 **.FAF is the foundational, universal base layer** for any Model using the MCP Protocol. It provides the standardized Context that makes the Model Context Protocol work for everyone.
@@ -88,7 +182,7 @@ Any LLM  →   IANA Format →    Open Protocol
 
 ## 🛠️ Core Features
 
-### 50 MCP Tools (100% Standalone)
+### 51 MCP Tools (100% Standalone)
 - **faf_quick** - Lightning-fast project.faf creation (3ms avg)
 - **faf_enhance** - Intelligent enhancement with auto-detection
 - **faf_read** - Parse and validate FAF files

package/assets/icons/orange-smiley.svg

@@ -0,0 +1,6 @@
+<svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">
+  <circle cx="50" cy="50" r="40" fill="#FF6B35" />
+  <circle cx="35" cy="40" r="5" fill="black" />
+  <circle cx="65" cy="40" r="5" fill="black" />
+  <path d="M 30 60 Q 50 70 70 60" stroke="black" stroke-width="3" fill="none" />
+</svg>

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>;
+}